From 25e36de8108addd1431f0401253ef0f183b95cf1 Mon Sep 17 00:00:00 2001 From: chrischristiansen-glitch Date: Sun, 24 May 2026 20:32:29 +0200 Subject: [PATCH] session(2026-05-24): operator suite heavy lifts, RAG graceful degrade, docs hardening, RAG secondary project plan --- .../2026-05-24_osvauco-rag-operator-suite.md | 57 +++++++++++++++++++ protocols/sessions/index.md | 1 + 2 files changed, 58 insertions(+) create mode 100644 protocols/sessions/2026-05-24_osvauco-rag-operator-suite.md diff --git a/protocols/sessions/2026-05-24_osvauco-rag-operator-suite.md b/protocols/sessions/2026-05-24_osvauco-rag-operator-suite.md new file mode 100644 index 0000000..da2127e --- /dev/null +++ b/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. diff --git a/protocols/sessions/index.md b/protocols/sessions/index.md index a434cca..72c935c 100644 --- a/protocols/sessions/index.md +++ b/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) |