OSVauco/docs/HANDOFF.md
Chris Christiansen 6b8e1d9fd7 docs: LEARNING-016 + IAP backend note + handoff oppdatert
- DNS-OG-INFRASTRUKTUR.md: jason-vauger SA lagt til IAP, korrekt routing
- LEARNINGS.md: LEARNING-016 opax.vauco.no backend-routing
- HANDOFF.md: neste oppgave verifiser full agent-loop
2026-06-17 17:59:23 +00:00

5.0 KiB

HANDOFF — Vauco OS

Sist oppdatert: 2026-06-15 19:46 CEST
Skrevet av: Perplexity (Orchestrator)
Status: Fase B — Gitea er primær Git. GitHub er fasa ut.


⚠️ 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/Gitea.
  • Primær Git: http://34.59.131.162:3000/chris/OSVauco — GitHub er IKKJE lenger i bruk.
  • Git remote på VM: http://chris:<TOKEN>@34.59.131.162:3000/chris/OSVauco.git

Fullført i dag (2026-06-15)

Oppgave Status
agents/tools/opax_mcp_client.py — REST-klient alle 25 tools
agents/tools/mcp_tools.py — X-MCP-Secret fix
Jason deployet til Vertex AI Agent Engine
Jason svarer på norsk og kallar tools automatisk
Gitea installert på VM (34.59.131.162:3000)
Gitea køyrer som systemd-teneste (overlever reboot)
Mirror-repo sletta og erstatta med vanleg repo
2867 commits pusha frå GitHub → Gitea
Gitea API-tokens i Secret Manager
GitHub fasa ut — Gitea er no primær

🏗 Systemstatus

Komponent URL / Referanse Status
osvauco-agent Cloud Run us-central1 Live
opax-mcp Cloud Run https://opax-mcp-zjbqp3prqq-uc.a.run.app Live (25 tools)
Jason Vertex AI Agent Engine reasoningEngines/237959055262351360 Live
Gitea (primær Git) http://34.59.131.162:3000/chris/OSVauco Live + systemd
GitHub OSVauco https://github.com/vauco-saas/OSVauco Fasa ut
opax.vauco.no Live
Emma (Gemma, lokal VM) Neste fase

🔑 Credentials

System Brukar Verdi
Gitea chris OSVauco@Gitea2026!
Gitea API token (jason-token2) Secret Manager: gitea-api-token (278c0b41...)
Gitea API token (admin-token2) 94527a0f5353c4b1db29a007b98f340b5fd1f385
opax-mcp MCP_SECRET Secret Manager: mcp-server-key
Jason Agent Engine reasoningEngines/237959055262351360

🟠 Gjenstår (prioritert)

# Oppgave Notat
1 Oppdater opax_mcp_client.py GitHub-tools → Gitea API Byt api.github.com34.59.131.162:3000/api/v1
2 Cloud Build webhook → Gitea (ikkje GitHub) Trigger på Gitea push
3 DNS git.vauco.no34.59.131.162 Domene for Gitea
4 HTTPS/TLS for Gitea (Caddy) Etter DNS
5 Emma — Gemma lokal på ML-3a GPU VM Eiga fase
6 Sett manglande env-vars på osvauco-agent SENDGRID_API_KEY, TWILIO_*, NOTIFY_*

📌 Neste sesjon — start her

# 1. Verifiser Gitea
curl -s http://34.59.131.162:3000/api/v1/repos/chris/OSVauco \
  -H "Authorization: token 94527a0f5353c4b1db29a007b98f340b5fd1f385" \
  | python3 -c "import sys,json; r=json.load(sys.stdin); print('mirror:', r['mirror'], '| commits OK')"

# 2. Verifiser Jason
cd ~/OSVauco/agents/core-logic && source .venv/bin/activate
python3 - <<'EOF'
import vertexai
from vertexai import agent_engines
vertexai.init(project="propane-will-491900-m5", location="us-central1")
agent = agent_engines.get("projects/357036551735/locations/us-central1/reasoningEngines/237959055262351360")
session = agent.create_session(user_id="chris")
for event in agent.stream_query(user_id="chris", session_id=session["id"], message="Status?"):
    if event.get("content"):
        print(event["content"]["parts"][0].get("text", ""), end="")
EOF

# 3. Neste: oppdater opax_mcp_client.py til Gitea API

🗺 Arkitektur

Chris (naturleg språk)
        ↓
Jason Vauger (Vertex AI Agent Engine — Gemini 2.5 Flash)
  reasoningEngines/237959055262351360
        ↓
opax-mcp (Cloud Run — 25 tools)
  https://opax-mcp-zjbqp3prqq-uc.a.run.app
        ↓
┌─────────────────────────────────┐
│  Gitea  34.59.131.162:3000      │  ← Eigen Git (PRIMÆR)
│  GCP    Cloud Build / Run       │  ← CI/CD + hosting  
│  GitHub — FASA UT              │  ← Ikkje i bruk lenger
└─────────────────────────────────┘

Jason Vauger — han blir den du trenger han til å bli.

NESTE OPPGAVE

Verifiser full agent-loop: Jason mottar spørsmål → kaller opax-mcp → får svar fra opax.vauco.no uten feil.