OSVauco/docs/HANDOFF-LOCAL-LLM-GITEA-MCP.md
chris be39ea9f6c
Some checks are pending
Check Python Version Consistency / Check Python Version (push) Waiting to run
chore: update docs/HANDOFF-LOCAL-LLM-GITEA-MCP.md via opax-mcp
2026-07-21 18:55:42 +00:00

3.3 KiB
Raw Blame History

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