OSVauco/docs/HANDOFF.md

99 lines
3.7 KiB
Markdown

# HANDOFF — Vauco OS
**Sist oppdatert:** 2026-06-15 17:42 CEST
**Skrevet av:** Perplexity (Orchestrator)
**Status:** Fase B — aktiv sesjon
---
## ⚠️ KRITISKE REGLER — les alltid først
- **Hovudapp:** `main.py` i rot — IKKJE `agents/core-logic/app.py`
- **Dockerfile:** `agents/core-logic/Dockerfile` — WORKDIR `/app`, CMD uvicorn main:app
- **Region:** `us-central1` | **Service:** `osvauco-agent` | **Prosjekt:** `propane-will-491900-m5`
- **Test via proxy:** `gcloud run services proxy osvauco-agent --region us-central1 --project propane-will-491900-m5 --port 8181`
- **ALDRI** `--audiences`-flag i smoke-tests
- **Smoke-test:** peker på `/health`
- **Curl mot prod:** alltid identity token — `TOKEN=$(gcloud auth print-identity-token)`
- **Ingen tredjepartsverktøy:** Cursor, Copilot og lignende skal IKKE brukes. Alt eies og kjøres i eget GCP/GitHub.
- **MCP-server** (`opax-mcp/`) er intern binding mellom Jason/Emma og OPAX — ikke en ekstern klientintegrasjon.
---
## ✅ Levert denne sesjonen (2026-06-15)
| SHA | Commit | Hva |
|-----|--------|-----|
| `2b79145` | `feat(CI1): opax-mcp server — full OPAX tool coverage + Dockerfile + cloudbuild` | MCP-server med 20 tools + CI/CD |
| `4f3a802` | `feat(CG5-onboard): token-basert invite-system + offentlig onboard-flow` | Invite-tokens, offentlig onboard, e-post |
| `099c1cc` | `feat(OQ-26): docs/gemma/world.md — Emma boot context` | Emma sin kontekstpakke |
---
## ✅ Lukkede issues denne sesjonen
| ID | Hva | Løsning |
|----|-----|---------|
| OQ-26 | `docs/gemma/world.md` mangler — Emma blokkert | Opprettet ✅ |
| CG5-onboard | Ingen salgsflyt for kunde-onboarding | Token-invite system ✅ |
| CI1 (kode) | `opax-mcp/` var tom | server.py + Dockerfile + cloudbuild.mcp.yaml ✅ |
---
## 🔴 CI1 — Siste steg (manuelt i GCP Console)
`cloudbuild.mcp.yaml` er klar. Trigger må opprettes **av Chris** i GCP Console:
**GCP Console → Cloud Build → Triggers → Create trigger**
| Felt | Verdi |
|------|-------|
| Navn | `opax-mcp-deploy` |
| Repo | `vauco-saas/OSVauco` |
| Branch | `^main$` |
| Build config | `cloudbuild.mcp.yaml` |
| Included files | `opax-mcp/**` |
| Service account | `osvauco-agent-sa@propane-will-491900-m5.iam.gserviceaccount.com` |
Alt kjører i ditt eget GCP — ingen tredjeparter.
---
## 🟠 Gjenstår (prioritert)
| # | Oppgave | Blokkering |
|---|---------|------------|
| 1 | Opprett Cloud Build-trigger for `opax-mcp` (se over) | Manuelt i GCP Console |
| 2 | Sett env-vars som mangler på `osvauco-agent` Cloud Run | GCP Console / gcloud |
| 3 | ML-3a VM — GPU Spot VM for Emma | Planlegging |
| 4 | C4 — Medioteq partnerstrategimøte | Aktiveres nå |
| 5 | CG5c — SMS (Twilio) | Venter på TWILIO_* env-vars |
| 6 | Verifiser Terminal + MD-panel + Docs Browser i nettleser | Manuell test |
---
## 🏗 Systemstatus
| Komponent | Status |
|-----------|--------|
| `osvauco-agent` Cloud Run | ✅ Live `us-central1` |
| `opax.vauco.no` | ✅ Live |
| `opax-mcp/` kode | ✅ Pushet, venter på Cloud Build trigger |
| `docs/gemma/world.md` | ✅ Opprettet |
| Emma boot | ✅ Laster world.md ved oppstart |
| Invite-system | ✅ Live (`/onboard/invite/{token}`) |
| Kreditt | 2911 NOK, utløper 2026-07-10 |
**Env-vars som MANGLER på Cloud Run:**
`SENDGRID_API_KEY`, `TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `TWILIO_FROM_NUMBER`,
`GOOGLE_CREDIT_TOTAL_USD`, `NOTIFY_EMAIL_TO`, `NOTIFY_WEBHOOK_URL`, `VAUCO_INTERNAL_WEBHOOK`
---
## 📌 Neste sesjon — start her
1. GCP Console → Cloud Build → opprett trigger `opax-mcp-deploy`
2. Sett manglende env-vars på `osvauco-agent`
3. Test invite-flow: `POST /onboard/invite` → link → `GET /onboard/invite/{token}`
4. Neste kode: C4-forberedelse eller ML-3a VM