session(2026-05-24): operator suite heavy lifts, RAG graceful degrade, docs hardening, RAG secondary project plan

protocols/sessions/2026-05-24_osvauco-rag-operator-suite.md

@@ -0,0 +1,57 @@
+---
+date: 2026-05-24T18:28:00Z
+thread_topic: "OSVauco OPAX – RAG restriction & operator suite heavy lifts"
+trigger: session-close
+context_snapshot: >
+  Dagens arbeid avklarte at Vertex AI RAG Engine i prosjektet propane-will-491900-m5 er effektivt
+  låst i Spanner-modus for nye prosjekter, og at vi ikke klarte å bytte modus via PATCH, SDK eller
+  REST — verken i us-central1 eller europe-west4. Vi behandler RAG som utilgjengelig i dette
+  prosjektet inntil videre og degraderer grasiøst i koden. I stedet bygde vi ut en robust
+  operatorsuite (preflight, cost-lens, region guard, docs hardening) slik at plattformen er trygg
+  og gjennomsiktig uten RAG.
+completed_tasks:
+  - "Identifisert og dokumentert at Vertex AI RAG Engine i propane-will-491900-m5 er underlagt Spanner-restriksjon — ingen PATCH, SDK-fix eller region-fallback løste det."
+  - "Refaktorerte agents/rag/setup_corpus.py og agents/rag/sync_corpus.py til å degradere grasiøst: ingen exceptions, bare tydelig WARN/summary og exit 0."
+  - "Heavy Lift 1: agents/rag/sync_corpus.py — RAG sync & health med multi-region discovery og inkrementell GCS-sync (deaktivert når RAG UNAVAILABLE)."
+  - "Heavy Lift 2: scripts/preflight.sh — OPAX preflight dashboard som sjekker Cloud Run, RAG-status, idle cost risk og kritiske secrets."
+  - "Heavy Lift 3: scripts/cost-lens.sh — Cost-Lens verktøy med 7-dagers kosttrend og --heavy-modus med maskinlesbart YAML-inventar."
+  - "Heavy Lift 4: infrastructure/99-region-guard.sh — region guard + oppdatert 07-rag-setup.sh, 08-memorybank-setup.sh og 05-cloudrun-deploy.sh med DEPLOY_REGION-støtte."
+  - "Phase 4 Docs Hardening: LEARNINGS.md (LEARNING-007 om RAG/Spanner), SECRETS-SETUP.md (alle gjeldende secrets med gcloud-kommandoer), IAP-SETUP.md (nåsituasjon + Phase 5-plan)."
+  - "Fikset $2: unbound variable i scripts/cost-lens.sh — rotårsak var ueskapet dollar-tegn ($2.40) og manglende ${2:-}-guard under set -u."
+  - "Opprettet docs/RAG-SECONDARY-PROJECT-PLAN.md med konkret plan for vauco-rag-lab-01 og cross-project IAM + RAG_PROJECT_ID-konfig."
+open_tasks:
+  - "Opprette sekundært GCP-prosjekt vauco-rag-lab-01 og følge docs/RAG-SECONDARY-PROJECT-PLAN.md."
+  - "Gi OSVauco service account aiplatform.user + storage.objectAdmin i RAG-prosjektet og verifisere setup_corpus/sync_corpus der."
+  - "Wire RAG_PROJECT_ID / RAG_LOCATION inn i agents/rag/*, preflight.sh og ev. agenter når RAG-lab er klar."
+  - "Deploye opax-mcp-core Cloud Run-tjenesten (infrastructure/05-cloudrun-deploy.sh) og gjøre preflight [1] Infrastructure grønn."
+  - "Opprette github-token secret i Secret Manager (se docs/SECRETS-SETUP.md) slik at Security-seksjonen i preflight blir grønn."
+  - "Phase 5: IAP på opax.vauco.no basert på docs/IAP-SETUP.md."
+  - "Hvis Google åpner serverless RAG i dette prosjektet: vurdere å reaktivere lokal RAG Engine."
+decisions:
+  - "RAG Engine behandles som UTILGJENGELIG i propane-will-491900-m5 inntil Google endrer Spanner-restriksjonene eller vi får eksplisitt allowlist. Ingen flere workarounds her."
+  - "Primærprosjektet propane-will-491900-m5 forblir operatør- og OPAX-plattform. RAG-eksperimenter flyttes til vauco-rag-lab-01."
+  - "Operator-opplevelsen skal alltid være robust selv om RAG, Memory Bank eller andre komponenter er nede: preflight.sh og cost-lens.sh er sannheten for daglig helse og kost."
+  - "Dokumentasjon er en førsteborger: alle viktige funn speiles i docs/LEARNINGS.md, SECRETS-SETUP.md og IAP-SETUP.md, ikke bare i chat og kode."
+skills_used:
+  - "Gemini CLI (gemini-3-flash-preview) for agentic utvikling av scripts og docs"
+  - "Vertex AI / RAG Engine feilsøking og REST-baserte kall"
+  - "GCP Cloud Run, Secret Manager og IAM for OPAX-operatørmiljøet"
+  - "Kost- og ressursanalyse via Cost-Lens og eksisterende infra-scripts"
+  - "Dokumentasjonsdesign og sesjonslogging (OPAX/OSVauco-protokoller)"
+  - "Region- og multi-prosjekt-arkitektur (region guard + sekundært RAG-prosjekt)"
+next_action: >
+  Neste sesjon: gjennomgå docs/RAG-SECONDARY-PROJECT-PLAN.md, opprette vauco-rag-lab-01 som
+  dedikert RAG-lab-prosjekt, og teste en første enkel RAG-corpus+sync derfra før vi begynner å
+  wire RAG_PROJECT_ID/RAG_LOCATION inn i OSVauco-koden.
+---
+
+## Sesjonsoversikt
+
+Denne sesjonen fokuserte på å gjøre OSVauco/OPAX robust og operatørvennlig etter å ha konstatert at Vertex AI RAG Engine er effektivt utilgjengelig i prosjektet `propane-will-491900-m5` pga. Spanner-restriksjon for nye prosjekter.
+
+### Nøkkelresultater
+
+- **RAG degradering**: `setup_corpus.py` og `sync_corpus.py` krasjer ikke lenger — de oppdager restriksjonen, logger en tydelig `RAG AVAILABILITY SUMMARY` og avslutter rent.
+- **Operator suite**: Fire heavy lifts levert (`preflight.sh`, `cost-lens.sh`, region guard, sync_corpus) som gir daglig oversikt over helse, kost og secrets.
+- **Docs hardening**: `LEARNINGS.md`, `SECRETS-SETUP.md` og `IAP-SETUP.md` oppdatert til å reflektere nåsituasjonen.
+- **Veien videre**: `docs/RAG-SECONDARY-PROJECT-PLAN.md` beskriver konkret hvordan `vauco-rag-lab-01` kan spinnes opp for RAG-eksperimenter uten å forstyrre primærprosjektet.

protocols/sessions/index.md

@@ -6,3 +6,4 @@
 | 2026-05-22 | osv-startup.ps1 — banner design, farger, prompt og gcloud-fix | [2026-05-22_osv-startup-banner-styling.md](./2026-05-22_osv-startup-banner-styling.md) |
 | 2026-05-24 | OPAX heavy mode + LLM-ruting + RAG re-indeksering | [2026-05-24_opax-heavy-mode-llm-ruting-rag.md](./2026-05-24_opax-heavy-mode-llm-ruting-rag.md) |
 | 2026-05-24 | RAG corpus setup — Vertex AI serverless debugging | [2026-05-24_rag-corpus-setup-vertexai.md](./2026-05-24_rag-corpus-setup-vertexai.md) |
+| 2026-05-24 | RAG restriction + operator suite heavy lifts + docs hardening | [2026-05-24_osvauco-rag-operator-suite.md](./2026-05-24_osvauco-rag-operator-suite.md) |