OSVauco/docs/HANDOFF-LOCAL-LLM-GITEA-MCP.md
chris 02aa0a17a9
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 21:55:06 +00:00

128 lines
4.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 23:54 CEST
### ✅ FASE 05 — FERDIG
### ✅ FASE 6 CPU-optimalisering — FERDIG
### ✅ FASE 6-TILLEGG Boot-warming — FERDIG
### ✅ DNS NS-bytte utført — FERDIG 2026-07-21 23:44 CEST
### ✅ OPAX-MCP GITEA_URL permanent + deploy — FERDIG 2026-07-21 23:53 CEST
---
## LÅST SYSTEMKONFIGURASJON GITEA-CPU-VM (komplett)
### Systemd-dropins
```
override.conf — OLLAMA_HOST=0.0.0.0:11434
max-models.conf — MAX_LOADED_MODELS=2 + KEEP_ALIVE=-1
warmup.conf — ExecStartPost=/usr/local/bin/ollama-warmup.sh
```
### Operative parametere for Emma-kall
```
num_ctx = 2048
num_batch = 256 (Ollama default)
OLLAMA_NUM_THREADS = ikke satt (autodetect)
```
### Ytelsesbudsjett per Emma-turn (varm)
```
3-kall turn: ~23.5s
5-kall turn: ~42.5s
Boot-penalty: ~0s (warmup-skript)
Tok/s: 4.95.0 (gemma3:4b)
```
---
## OPAX-MCP KONFIGURASJON LÅST
### opax-mcp.yaml — nøkkelvariabler (per 2026-07-21)
| Variabel | Verdi |
|---|---|
| `GITEA_URL` | `http://34.67.252.59:3000` |
| `OLLAMA_BASE_URL` | `http://34.67.252.59:11434` |
| `EMMA_MODEL` | `gemma3:4b` |
| `EMMA_FAST_MODEL` | `gemma3:4b` |
| `EMMA_LIGHT_MODEL` | `qwen2.5:3b` |
| `OSVAUCO_AGENT_URL` | `https://osvauco-agent-357036551735.us-central1.run.app` |
Deploy verifisert: `get_connector_status``live`, `gitea: online`, `tool_count: 37`
---
## DNS FULLFØRT 2026-07-21
### NS-bytte
Proisp nameservere byttet til Google Cloud DNS: **2026-07-21 23:44 CEST**
```
ns-cloud-a1.googledomains.com
ns-cloud-a2.googledomains.com
ns-cloud-a3.googledomains.com
ns-cloud-a4.googledomains.com
```
### Cloud DNS-sone `vaucono` — komplett
| Record | Type | Verdi | Status |
|---|---|---|---|
| `vauco.no.` | A | `34.98.77.173` (LB) | ✅ |
| `www.vauco.no.` | A | `34.98.77.173` (LB) | ✅ |
| `opax.vauco.no.` | A | `34.98.77.173` (LB) | ✅ |
| `git.vauco.no.` | A | `34.67.252.59` (gitea-cpu-vm) | ✅ |
| `vauco.no.` | MX | Alle 5 Google MX | ✅ |
| `vauco.no.` | TXT | SPF | ✅ |
| `google._domainkey.vauco.no.` | TXT | DKIM | ✅ |
| `_dmarc.vauco.no.` | TXT | DMARC quarantine | ✅ |
### Verifisering etter propagering
```bash
curl -s "https://dns.google/resolve?name=git.vauco.no&type=A" \
| python3 -c "import json,sys; d=json.load(sys.stdin); ans=d.get('Answer'); print(ans[0]['data'] if ans else 'IKKE PROPAGERT')"
```
Forventet: `34.67.252.59`
---
## ÅPNE PUNKTER
1. `git.vauco.no` propagering — sjekk i morgen tidlig (opp til 24t fra 23:44 CEST)
2. Gitea-commits ikke GPG-signert — vurder ved anledning
## FASTE SANNHETER (uendret)
- Gitea er source of truth
- Lokale modeller er hovedretning
- Gitea-VM (34.67.252.59) er permanent målmaskin
- Denne handoffen overstyrer alt annet
## DEFINITION OF DONE ✅ 100% FULLFØRT
- ✅ 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 — GITEA_URL permanent i repo + deployed
- ✅ dev-snap-oppsettet dokumentert godt nok til blueprinting
- ✅ CPU-optimalisering verifisert på Gitea-VM
- ✅ Boot-warming verifisert
- ✅ DNS migrert til Google Cloud DNS
-`git.vauco.no` live — propagering pagår
## OPPDATERINGSLOGG
| Dato | Handling |
|---|---|
| 2026-07-21 | FASE 4: smoke test grønn |
| 2026-07-21 | FASE 5: Blueprint frosset |
| 2026-07-21 | FASE 6: CPU-optimalisering fullført |
| 2026-07-21 | Boot-warming: ollama-warmup.sh verifisert |
| 2026-07-21 23:44 | DNS: NS-bytte utført hos Proisp |
| 2026-07-21 23:53 | OPAX-MCP: GITEA_URL + OLLAMA_BASE_URL → 34.67.252.59, deployed, connector live |