chris
94bc4b1b43
Some checks are pending
Check Python Version Consistency / Check Python Version (push) Waiting to run
95 lines
4.1 KiB
Markdown
95 lines
4.1 KiB
Markdown
# 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:57 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 via MCP: `gemma3:4b`, `qwen2.5:3b`
|
||
- Modeller på dev-snap localhost: `qwen2.5:7b`, `gemma3:4b`, `llama3.2`, `nomic-embed-text`
|
||
- `list_emma_models` via MCP: GRØNN ✅
|
||
|
||
### ✅ 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, build SUCCESS 55182237 (21. juli 18:38)
|
||
- opax-mcp revisjon: opax-mcp-00122-m4n
|
||
|
||
### ✅ FASE 3 – Gitea read-only grønn — FERDIG
|
||
- Rotårsak: `GITEA_URL` var ikke satt i opax-mcp Cloud Run service
|
||
- Gitea kjører på: `http://34.67.252.59:3000` (Gitea-CPU-VM)
|
||
- Fix: `gcloud run services update opax-mcp --update-env-vars GITEA_URL=http://34.67.252.59:3000`
|
||
- opax-mcp revisjon etter fix: 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 — FERDIG 2026-07-21 20:57 CEST
|
||
Full smoke test kjørt og alle tools grønne samtidig:
|
||
|
||
| Tool | Status | Resultat |
|
||
|---|---|---|
|
||
| `get_connector_status` | ✅ | live, gitea online, 37 tools |
|
||
| `get_health` | ✅ | OK |
|
||
| `get_build_status` | ✅ | Siste build SUCCESS 55182237 |
|
||
| `describe_service` | ✅ | osvauco-agent-00695-8lk Ready |
|
||
| `list_workspace_users` | ✅ | 3 brukere returnert |
|
||
| `list_emma_models` | ✅ | gemma3:4b, qwen2.5:3b |
|
||
| `list_commits` | ✅ | Siste commits returnert |
|
||
| `list_repo_files` | ✅ | Rotmappe listert |
|
||
|
||
Ingen regresjon på tidligere grønne tools. Hele kjeden er verifisert i samme runde.
|
||
|
||
### ⏳ FASE 5 – Frys blueprint på dev-snap — NESTE
|
||
Formål: Gjøre det fungerende oppsettet om til en presis og flyttbar mal for Gitea-VM.
|
||
|
||
Skal dokumenteres:
|
||
- Alle env vars og secrets i opax-mcp Cloud Run
|
||
- Alle modellnavn og roller (Emma, Emma Fast, Light)
|
||
- OLLAMA_BASE_URL og hvilken VM Ollama faktisk kjører på
|
||
- GITEA_URL — midlertidig IP vs planlagt git.vauco.no
|
||
- Alle Cloud Run services og revisjoner
|
||
- Testkommandoer for rask verifisering
|
||
- Hva som må være identisk på Gitea-VM vs hva som er maskinspesifikt
|
||
|
||
---
|
||
|
||
## ÅPNE PUNKTER SOM MÅ LØSES FØR BLUEPRINT
|
||
- `GITEA_URL` satt runtime via `gcloud run services update` — **må også legges permanent inn 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 (34.67.252.59) er planlagt permanent målmaskin
|
||
- Denne handoffen overstyrer alt annet
|
||
|
||
## DEFINITION OF DONE
|
||
- ✅ 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 konsolidert — delvis (GITEA_URL må inn i repo)
|
||
- ⏳ Ingen skjult API-/agentavhengighet som hovedbane — ikke verifisert
|
||
- ⏳ dev-snap-oppsettet dokumentert godt nok til blueprinting — FASE 5
|