OSVauco/docs/HANDOFF.md

# HANDOFF — Vauco OS

**Sist oppdatert:** 2026-06-09
**Skrevet av:** Jason Vauger (via Perplexity)
**Status:** CostGuard OAuth-flyt er verifisert, vauco.no er tonet ned og anonymisert, og Threadstone er satt i lukket pilot med kun @vauco.no-innlogging.

---

## ✅ OQ-15 / CG3 — Status per 2026-06-09

- **CG3a — CostGuard-landing / static-cards:** `static/costguard.html` er opprettet og live.
- **CG3b/c — DNS & Verifisering:** `costguard.oss.vauco.no` er bekreftet å peke mot `osvauco-agent` load balancer og serverer innhold korrekt.
- **CG3d — OAuth-flyt:** Manuell test bekrefter at Google-innlogging fra `costguard.oss.vauco.no` fungerer uten feil.
- **CG3 — CostGuard billing-dashboard (GCP-only):** `static/billing-dashboard.html` er ryddet opp slik at:
  - GCP er eneste provider i UI (AWS-UI er parkert til senere).
  - Demo-data brukes kun hvis kjerne-endepunktene (`/billing/summary`, `/billing/live`, `/billing/anomalies`) feiler.
  - History-endepunktet (`/billing/history`) er best-effort og gir ikke lenger rød feilbanner alene.
  - Layout er strammet inn: nøkkeltall øverst, daglig kostnad + tjenestefordeling, samt kostnad per tjeneste + budsjettstatus.
  - Anomali-visning er flyttet til en enkel topplinje-badge (grønn/gul/rød) i stedet for eget kort.

**Neste steg på CostGuard-siden:**
- **CG3e — Tokenmeter for agenter:** Implementere logging og visning av LLM-tokenbruk i CostGuard-dashboardet.

---

## 🌐 Vauco.no — status

- `vauco.no` er nå en enkel modul-oversiktsside, uten operatørbeskrivelse av Chris:
  - Om-oss-tekst omtaler Vauco som selskap, ikke daglig leder.
  - Faktafeltet viser kun Selskap, Org.nr, Lokasjon (Oslo, Norge).
  - Kontakt går til `contact@vauco.no`, ikke til personlige adresser.
- Nettsiden deployes ved å synce `~/vauco-site` til GCS-bucket `gs://vauco-site-public` og eventuelt invalidere CDN-cache på URL-mappen.

---

## 🧱 Threadstone — status

- `threadstone.vauco.no` er en landingsside i lukket pilot:
  - Hero-badge: "Under utvikling · Lukket pilot for interne brukere".
  - Lead-tekst: Tjenesten er i lukket pilot og kun tilgjengelig for interne Vauco-kontoer.
- Innlogging / kjøp:
  - Google Sign-In aksepterer kun e-poster som slutter på `@vauco.no`.
  - Alle andre domener får tydelig feilmelding om at Threadstone er i lukket pilot.
  - "Kjøp nå"-knapper krever innlogging; uten @vauco.no-konto kommer man ikke til mock-checkout (e-post til Chris).
- Landingsside + priser er offentlig, men hele appen og bestillingsflyten er i praksis kun for interne.

---

## 🏗 Hva er dette prosjektet?

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

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

**OPAX = kommandosenter for ALLE prosjekter** (et prosjekt = en klient — samme ting). OPAX bygger, iscenesetter og publiserer prosjekter. OPAX er ikke bundet til noe enkelt prosjekts region.

**Branding-konvensjon for prosjekter:**
| Subdomene | Type |
|---|---|
| `<prosjekt>.oss.vauco.no` | Staging / demo |
| `<prosjekt>.os.vauco.no` | Live produksjon |

(Klient kan videresende eget domene, men kanonisk merkevare-label er alltid `*.vauco.no`.)

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 |
| PR #15 IAP /health-fix | ✅ Merget til main (commit 7a09871) |
| CI/CD Cloud Build → Cloud Run | ⚠️ IKKE operativt — ingen trigger, siste builds FAILURE. Deploy MANUELT. |
| RAG corpus `osvauco-corpus` | ✅ Populert, `europe-west1` |
| OAuth2 (Google) | ✅ I Secret Manager |
| AI-modell | ✅ `gemini-2.5-pro` via Vertex AI (us-central1) |
| `costguard.oss.vauco.no` | ✅ Live (Cloudflare Pages) |
| `static/costguard.html` | ✅ Første versjon live via `osvauco-agent` |
| `static/billing-dashboard.html` | ✅ Første versjon GCP-only, layout strammet inn, AWS-UI parkert |
| `vauco.no` | ✅ Oppdatert, anonymisert og deployet via `gs://vauco-site-public` |
| `threadstone.vauco.no` | ✅ Landingsside live, satt i lukket pilot m/ @vauco.no-gating |

---

## 📋 Nøkkelinformasjon

| Nøkkel | Verdi |
|---|---|
| GCP Project | `propane-will-491900-m5` |
| Region (OPAX, LÅST) | `us-central1` |
| Vertex AI endpoint | `us-central1` (kjører `GOOGLE_CLOUD_LOCATION=global` i praksis) |
| Artifact Registry | `us-central1-docker.pkg.dev/propane-will-491900-m5/osvauco-repo` |
| 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` |
| Eier / Operatør | Chris Christiansen — `chris.christiansen@vauco.no` |
| Agent-konto | `jason.vauger@vauco.no` |

---

## ⚠️ 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.

---

## 📁 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

---

*Vauco AS · propane-will-491900-m5 · `us-central1` · Powered by Jason, Crafted by Vauco ·*