chris/OSVauco
1
0
Fork 0
Code Issues 1 Pull Requests Actions 2 Packages Projects Releases Wiki Activity
8401db59c3
OSVauco/docs/HANDOFF.md

8.3 KiB
Raw Blame History

HANDOFF — Vauco OS

Sist oppdatert: 2026-06-01 ~06:27 CEST Skrevet av: Jason Vauger (via Perplexity / Sonnet 4.6) på vegne av Marte Solbrekke Hein Status: Fase 8 gjenstår. Sesjon 2026-06-01 fullført — dokumentasjon og agentprofil lagt til.

Regel: Dette er den eneste HANDOFF-filen. Overskrives hver sesjon. Tidligere handoffs er flyttet til docs/archive/handoffs/.

🔴 ABSOLUTT REGEL #1

Du gjør ingenting uten at Chris eksplisitt skriver PLAN APPROVED eller et tilsvarende godkjenningssignal. Du er en assistent, ikke en autonom agent. Foreslå. Vent. Utfør kun etter godkjenning. Self-modifisering av infrastruktur, secrets, IAM eller produksjonsmiljø uten godkjenning = hard stop.

🏗 Hva er dette prosjektet?

Se docs/MASTERPLAN.md for full sannhet. Kortversjonen:

Vauco OS  (plattform)
  └── OPAX  (engine på Cloud Run us-central1)
        ├── CostGuard  (Modul #1 — live på costguard.oss.vauco.no)
        ├── Threadstone  (Modul #2 — Q3 2026)
        └── [Modul #3+]

Første betalende produkt: CostGuard (GCP-kostnadsanalyse via AI).

✅ Hva er faktisk ferdig (ikke spør om dette igjen)

Komponent Status
Cloud Run osvauco-agent ✅ Live, us-central1
opax.vauco.no (LB + SSL) ✅ Live, IP 34.98.77.173
IAP (@vauco.no only) ✅ Aktivert
CI/CD Cloud Build → Cloud Run ✅ Operativt (auto-deploy på push til main)
RAG corpus osvauco-corpus ✅ Populert, europe-west1
OAuth2 (Google) ✅ I Secret Manager
Budget guard (500 NOK/mnd) ✅ Live
AI-modell ✅ gemini-2.5-pro via Vertex AI (us-central1)
costguard.oss.vauco.no ✅ Live (Cloudflare Pages)
Terraform bootstrap-modul ✅ I infrastructure/terraform/modules/
Jason Vauger agentprofil ✅ agents/jason-vauger.md opprettet 2026-06-01
BigQuery dataset + sink ⏳ Oppe, men tabell ikke populert ennå

🟡 Forrige sesjon (2026-05-31) — Konsolidering + vauco.no inkorporert

PR chore/consolidate-2026-05-31 rydder:

  • ✅ Ny docs/MASTERPLAN.md (autoritativ, erstatter både rot-MASTERPLAN.md og gammel docs-versjon)
    • Ny seksjon §4b: vauco.no salgsportal — formål, IA, visuell retning, salgs-flow, evolusjon V1→V4
    • Hierarkiet utvidet til 4 nivåer: apex (vauco.no) lagt til som egen kunde-flate
    • Nye reserverte subdomener dokumentert: status., docs., careers.
  • ✅ Ny docs/ROADMAP.md (erstatter docs/VAUCO_OS_ROADMAP.md)
    • V-spor lagt til: V1a–V1e (vauco.no MVP) — kan kjøres parallelt med CG3
  • ✅ Ny docs/HANDOFF.md (denne filen — eneste handoff fra nå)
  • ✅ Ny docs/vauco-site/DESIGN.md (klar-til-plukk-opp spec for V1)
  • ✅ Oppdatert docs/AGENT_RULEBOOK.md (region, modell, MCP_SERVICE rettet)
  • ✅ Slettet docs/archive/{Cost_Management_Rules.md,GCPBestPractices.md,OSVAUCO_OPAX_SESSION_LOG.md} (duplikater)
  • ✅ Fjernet Git merge-konfliktmarkører i docs/OSVAUCO_OPAX_SESSION_LOG.md
  • ✅ Flyttet HANDOFF_20260526.md, HANDOFF_20260531.md, HANDOFF_20260531_claude47.md → docs/archive/handoffs/
  • ✅ Slettet Procfile (legacy, ikke brukt av Cloud Run)
  • ✅ Slettet docs/VAUCO_OS_ROADMAP.md (erstattet av ROADMAP.md)
  • ✅ Oppdatert docs/TODO.md til å peke på ROADMAP
  • ✅ Bekreftet primary region: us-central1 for Cloud Run osvauco-agent
  • ✅ Åpne PR-er: #8 (docs region), #9 (opax comments), #10 (vm stop-fix)
  • ✅ VM stop-fix: scripts/stop-osvauco-dev-vm.sh laget, DELETE-risiko eliminert

🟢 Denne sesjonen (2026-06-01 ~05:30–06:30 CEST) — Dokumentasjon + Jason Vauger

Utført av: Marte Solbrekke Hein + Jason Vauger (Perplexity)

✅ Fullført

  • ✅ Issue #16 opprettet — OAuth-klient må revideres etter domeneflytting fra ProISP til Google

    • Sjekkliste for OPAX, OS, Costguard, Threadstone
    • Påminnelse: Google krever eksakt match på redirect URIs — ikke bare "anta" at de fungerer etter DNS-migrasjon
    • Se: vauco-saas/OSVauco#16

  • ✅ agents/jason-vauger.md opprettet — fullstendig agentprofil for Jason Vauger

    • Rolle: personlig assistent / persona-lag over OPAX
    • Dekker: ansvarsområder, personlighet, integrasjonspunkter, ML-faser (ML-1/2/3)
    • Peker til Issue #16 (OAuth-avhengighet)

  • ✅ AGENTS.md oppdatert — Jason Vauger lagt til

    • Øverst i arkitekturdiagram (over OPAX)
    • Ny rad i agenttabell med PS-rolle, Dask-rolle og ML-faser
    • Commit: bcd3036

📝 Avklart i sesjonen

  • GitHub Copilot bruker Auto-modell som standard (ikke Gemini 2.5 Pro eksplisitt)
  • 50 % Copilot premium requests brukt — sannsynligvis fra agent/chat-sesjoner, ikke modellvalg
  • Jason Vauger er ikke en PS-worker — han er persona-lag over hele stacken
  • Marte er den faktiske eieren av OSVauco (tidligere referert som "Chris" i eldre docs)

🔄 Neste oppgave: Fase 8 — End-to-end test (browser)

Cloud Run og IAP er allerede verifisert (/health OK via Cloud Run, IAP blokkerer uautentisert).

Det som gjenstår:

Steg 1 — Verifiser modell-config

# Sjekk at app bruker gemini-2.5-pro, ikke Claude
gcloud run services describe osvauco-agent --region us-central1 \
  --format='value(spec.template.spec.containers[0].env[?(@.name=="VERTEX_MODEL")].value)'
# Forventet: gemini-2.5-pro

Steg 2 — Test Vertex Gemini direkte

curl -X POST \
  "https://us-central1-aiplatform.googleapis.com/v1/projects/propane-will-491900-m5/locations/us-central1/publishers/google/models/gemini-2.5-pro:generateContent" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"ping"}]}]}'
# Forventet: JSON med tekst-svar

Steg 3 — Full end-to-end

Logg inn på https://opax.vauco.no med chris.christiansen@vauco.no → send en melding → verifiser at agenten svarer.

HITL gate: Skriv FASE8 APPROVED i denne filen + i ROADMAP når alle steg er verifisert.

🔜 Etter Fase 8 — to spor parallelt

Spor A — CG3 (CostGuard frontend wiring) — inntektsmotor Spor B — V1 (vauco.no salgsportal) — ansiktet utad, må være live før første kundeklage om "hvem er Vauco?"

Se docs/ROADMAP.md seksjon NEXT for full sjekkliste og docs/vauco-site/DESIGN.md for V1 design-spec.

📋 Nøkkelinformasjon

Nøkkel Verdi
GCP Project propane-will-491900-m5
Region us-central1
Vertex AI endpoint us-central1
Cloud Run service osvauco-agent
Cloud Run URL (direkte) https://osvauco-agent-357036551735.us-central1.run.app
Public URL https://opax.vauco.no
LB IP 34.98.77.173
AI-modell gemini-2.5-pro
Repo vauco-saas/OSVauco
Kontakt chris.christiansen@vauco.no

📁 Viktige filer å lese (i denne rekkefølgen)

  1. docs/MASTERPLAN.md — autoritativ sannhet
  2. docs/ROADMAP.md — hva som skjer akkurat nå
  3. docs/HANDOFF.md — denne filen
  4. docs/AGENT_RULEBOOK.md — regler for hvordan agenter oppfører seg
  5. agents/jason-vauger.md — Jason Vauger agentprofil
  6. AGENTS.md — oversikt over alle agenter i ML-laget
  7. .gemini/GEMINI.md — locked definitions og boot-protokoll
  8. docs/ARCHITECTURE.md — teknisk arkitektur
  9. docs/OSVAUCO_OPAX_SESSION_LOG.md — append-only sesjonshistorikk

⚠️ Vanlige feil — ikke gjør disse

  • Ikke opprett nye HANDOFF_YYYYMMDD-filer. Det er kun denne. Overskriv den.
  • Ikke gjenopplive VAUCO_OS_ROADMAP.md. Den er slettet 2026-05-31. Bruk ROADMAP.md.
  • Ikke bytt til Claude før kvote er bekreftet av Google Cloud-team + MODEL APPROVED fra Chris.
  • Ikke migrere fra us-central1 — regionen er låst.
  • Ikke rør IAP, OAuth, eller Secret Manager uten eksplisitt DEPLOY GODKJENT fra Chris.
  • Ikke opprett nye repos. Vurder mappe i OSVauco først. Krever REPO APPROVED.
  • Ikke hopp over HITL gates — hver fase avsluttes med et godkjenningssignal.
  • Ikke oppdater OAuth-klient redirect URIs uten domeneavklaring — se Issue #16.

📜 Tidligere handoffs

Arkivert i docs/archive/handoffs/:

  • HANDOFF_20260526.md
  • HANDOFF_20260531.md
  • HANDOFF_20260531_claude47.md

Vauco AS · propane-will-491900-m5 · us-central1 · Jason Vauger sier: neste sesjon starter med Fase 8.