From ccf1a8f4fefeef584562c4e1443a5923d60acccf Mon Sep 17 00:00:00 2001
From: chrischristiansen-glitch <chris.christiansen@vauco.no>
Date: Sat, 23 May 2026 05:35:28 +0200
Subject: [PATCH] docs(corpus-seed): add OSVauco knowledge base seed document
 for RAG Engine

This document provides an overview of the OSVauco AI-driven operating system, including its architecture, agent details, infrastructure scripts, known issues, cost model, and GCP configuration.
---
 docs/corpus-seed/osvauco-knowledge-base.md | 108 +++++++++++++++++++++
 1 file changed, 108 insertions(+)
 create mode 100644 docs/corpus-seed/osvauco-knowledge-base.md

diff --git a/docs/corpus-seed/osvauco-knowledge-base.md b/docs/corpus-seed/osvauco-knowledge-base.md
new file mode 100644
index 0000000..448fee5
--- /dev/null
+++ b/docs/corpus-seed/osvauco-knowledge-base.md
@@ -0,0 +1,108 @@
+# 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
+```