# OSVauco Knowledge Base

## Hva er OSVauco?

OSVauco er et AI-drevet operativsystem (OPAX) som kjører på Google Cloud.
Du er første kunde. Når det virker for deg → selg det til andre.

Prosjekt: propane-will-491900-m5
Region: us-central1
Primær repo: chrischristiansen-glitch/OSVauco

## Repo-oversikt

| Repo | Hva det er |
|------|------------|
| OSVauco | Regler, GCP-scripts, agenter, docs — KJERNEN |
| vauco-gemini-tui-bridge | TUI-cockpit |
| vauco-os | Det kundene bruker |
| vauco-bootstrap | Onboarding av nye kunder |
| deep-dream | Strategisk visjon — aldri deploy herfra |

## Agentarkitektur

OSVauco bruker Google ADK 2.0 (Agent Development Kit) med Vertex AI / Gemini.

### Agenter

- **root_agent** (gcp-orchestrator): Orkestrerer alle sub-agenter
- **rag_agent**: RAG-søk mot Vertex AI RAG Engine-corpus
- **memory_agent**: Persistent minne via Vertex AI Memory Bank (Agent Engine)
- **tools_agent**: GCP-verktøy (gcloud, Storage, Monitoring)

### Teknologistack

- Runtime: Cloud Run (skaler til 0, ingen idle-kostnad)
- LLM: Gemini 2.0 Flash (orkestrering) + Gemini 2.0 Flash (sub-agenter)
- RAG: Vertex AI RAG Engine (text-embedding-005)
- Minne: Vertex AI Memory Bank / Agent Engine
- CI/CD: Cloud Build + GitHub OAuth
- Observability: Cloud Monitoring + Cloud Logging
- Sikkerhet: IAP (Identity-Aware Proxy) på opax.vauco.no

## Infrastrukturscripts (00–08)

| Script | Hva den gjør |
|--------|---------------|
| 00-authcheck.sh | Verifiser gcloud-innlogging og prosjekt |
| 01-setupenv.sh | Aktiver APIs, opprett SA, sett IAM, budsjettvarsel |
| 02-deploy.sh | Deploy med IAP på eget domene |
| 03-teardown.sh | Riv ned Cloud Run (kjør hver kveld) |
| 04-observability-setup.sh | Cloud Monitoring + alerting |
| 05-cloudrun-deploy.sh | Deploy ADK-agent til Cloud Run |
| 06-cicd-setup.sh | GitHub → Cloud Build CI/CD |
| 07-rag-setup.sh | Opprett RAG Engine corpus + last opp frodi |
| 08-memorybank-setup.sh | Opprett Memory Bank (Agent Engine) |

## Kjente problemstillinger

| ID | Problem | Løsning |
|----|---------|----------|
| OQ-01 | Memory Bank — ingen gcloud CLI | Python SDK only |
| OQ-02 | RAG Engine regional tilgjengelighet | Fallback til us-east1 |
| OQ-03 | CMEK ikke for RAG Engine | VPC-SC only |
| OQ-04 | Cloud Build GitHub OAuth | Manuelt i Console |
| OQ-05 | gcloud alpha monitoring ustabil | Fallback til true |
| OQ-06 | Memory Bank auto-discovery | Eksplisitt env var MEMORY_ENGINE_NAME |
| OQ-07 | Monitoring email flag-format | Teste i dev |
| OQ-08 | VPC connector e2-micro regional | Default us-central1 |

## Kostnadsmodell

| Scenario | Kostnad/mnd |
|----------|-------------|
| Bare deg (dev, teardown daglig) | ~$25-75 |
| 1 betalende kunde (lett prod) | ~$115-280 |
| Medioteq-type (klinisk, compliance) | ~$220-350 |

Breakeven: 1 kunde til $300-500/mnd dekker alle kostnader.
ALTID kjør 03-teardown.sh hver kveld for å unngå 24/7-fakturering.

## GCP-konfigurasjon

```
PROJECT_ID=propane-will-491900-m5
REGION=us-central1
CLOUD_RUN_SERVICE=osvauco-agent
AGENT_SA=osvauco-agent-sa@propane-will-491900-m5.iam.gserviceaccount.com
RAG_CORPUS_DISPLAY_NAME=osvauco-corpus
MEMORY_INSTANCE_DISPLAY_NAME=propane-will-491900-m5-memory-bank
ORCHESTRATOR_MODEL=gemini-2.0-flash-001
SUBAGENT_MODEL=gemini-2.0-flash-001
```

## Fase A — Kjørerekkefølge

```bash
cd ~/OSVauco
source .env
bash infrastructure/00-authcheck.sh
bash infrastructure/01-setupenv.sh
bash infrastructure/07-rag-setup.sh
bash infrastructure/08-memorybank-setup.sh
# Legg MEMORY_ENGINE_NAME i .env
bash infrastructure/05-cloudrun-deploy.sh
bash infrastructure/04-observability-setup.sh
# Om kvelden:
bash infrastructure/03-teardown.sh
```