# HANDOFF-LOKAL-LLM-GITEA-MCP.md
# EGEN HANDOFF – UFRAVIKELIG STYRINGSDOKUMENT
# GJELDER FRA NÅ OG FREM TIL 100 % FERDIGSTILLELSE

## 0. STATUS OG KOMMANDO
Denne handoffen er det eneste autoritative arbeidsdokumentet for sporet "lokal LLM-fabrikk + OPAX-MCP + Gitea stabilisering + blueprinting til Gitea-VM".

---

## FREMDRIFT – OPPDATERT 2026-07-21 20:54 CEST

### ✅ FASE 0 – Lås situasjonen — FERDIG
- Handoff opprettet som eget dokument
- dev-snap/GPU-VM er aktiv verifikasjonsbase
- Gitea er eneste source of truth
- Lokal LLM-bane er primær retning

### ✅ FASE 1 – Lokale modeller lever — FERDIG
- Ollama kjører på Gitea-CPU-VM (34.67.252.59:11434)
- Modeller tilgjengelig: `gemma3:4b`, `qwen2.5:3b`
- `list_emma_models` via MCP: GRØNN
- Embedding: `nomic-embed-text` på dev-snap

### ✅ FASE 2 – MCP peker korrekt til lokal modellsti — FERDIG
- `OLLAMA_BASE_URL` peker til Gitea-CPU-VM Ollama
- `OSVAUCO_AGENT_URL` fikset til kanonisk URL (commit a171a58)
  - Rotårsak: Cloud Run krever regional URL som audience for identity tokens
  - Feil: `zjbqp3prqq-uc.a.run.app` → Riktig: `osvauco-agent-357036551735.us-central1.run.app`
- 5 filer oppdatert av Gemini-agent: cloudbuild.yaml, infrastructure/cloudbuild.yaml, opax-mcp.yaml, scripts/boot.sh, scripts/smoke-test.sh
- Build SUCCESS: 55182237 (21. juli 18:38)

### ✅ FASE 3 – Gitea read-only grønn — FERDIG
- Rotårsak funnet: `GITEA_URL` var ikke satt i opax-mcp Cloud Run service
- Gitea kjører på: `http://34.67.252.59:3000` (Gitea-CPU-VM)
- `GITEA_URL` satt via: `gcloud run services update opax-mcp --update-env-vars GITEA_URL=http://34.67.252.59:3000`
- Revisjon: opax-mcp-00123-g7d
- Alle 4 read-only tools GRØNNE:
  - ✅ `list_commits`
  - ✅ `get_file`
  - ✅ `get_file_content`
  - ✅ `list_repo_files`
- `get_connector_status`: `gitea_status: online` ✅

### 🔄 FASE 4 – Hel kjede samtidig grønn — PÅGÅR
Minste samlede smoke test gjenstår:
- ✅ `get_connector_status` — live, gitea online, 37 tools
- ✅ `get_health`
- ✅ `get_build_status`
- [ ] `describe_service`
- [ ] `get_workspace_user`
- [ ] `list_workspace_users`
- ✅ `list_emma_models`
- ✅ `list_commits`
- [ ] `get_file_content`
- ✅ `list_repo_files`

### ⏳ FASE 5 – Frys blueprint på dev-snap — VENTER
Kan ikke starte før Fase 4 er fullført.

---

## KJENTE ÅPNE PUNKTER
- `GITEA_URL` i opax-mcp.yaml er nå satt runtime via `gcloud run services update` — bør også legges inn permanent i `opax-mcp.yaml` i repo og rebuildes
- `git.vauco.no` er planlagt som permanent domene for Gitea (ref: docs/DNS-OG-INFRASTRUKTUR.md) — erstatter IP når DNS er oppe
- Gitea-commits er ikke GPG-signert — vurder om dette skal fikses

## FASTE SANNHETER (uendret)
- Gitea er source of truth
- Lokale modeller er hovedretning
- dev-snap/GPU-VM er nåværende verifikasjonsflate
- Gitea-VM er planlagt permanent målmaskin
- Denne handoffen overstyrer alt annet

## DEFINITION OF DONE (uendret)
- Lokale modeller lever og kan brukes lokalt ✅
- OPAX-MCP bruker lokal modellbackend korrekt ✅
- `list_emma_models` er grønn ✅
- Gitea read-only tools er grønne ✅
- GCP/Workspace-kjernen er fortsatt grønn ✅
- Konfigurasjon er konsolidert — delvis
- Ingen skjult API-/agentavhengighet som hovedbane
- dev-snap-oppsettet er dokumentert godt nok til å blueprintes til Gitea-VM ⏳