# VAUCO OS — ARCHITECTURE.md
# Eier: PLAN-Claude-Architect
# Sist oppdatert: 2026-05-18 — OPS-Computer-Hub (bootstrap, tom fil)
# Status: STUB — PLAN-Claude-Architect fyller ut ved første boot

---

## Hensikt
Single source of truth for systemarkitektur, komponent-diagram og design-kontrakter.
Ingen andre tråder skriver denne filen. Andre tråder kan foreslå patcher via PR.

---

## Komponent-diagram (ASCII)

```
[Chris / Operatør]
       |
  -----+------+----------+----------+
  |           |          |          |
OPS        EXEC       PLAN       AUDIT
Perplexity Gemini    Claude     Nemotron
Computer   2.5 Pro   Sonnet/    (NMT)
                     Opus
  |           |          |          |
  +-----+-----+----------+----------+
        |
   [GitHub]
   OSVauco (main)
   vauco-bootstrap (main)
        |
   [GCP / Cloud Run]
   project: propane-will-491900-m5
   region: us-central1
        |
   [Gemini API]
   SDK: from google import genai
```

---

## Tråd-kontrakter

| Tråd | Modell | Eid fil | Konnektor |
|---|---|---|---|
| OPS-Computer-Hub | Perplexity Computer | AGENTRLEBOOK.md, LEARNINGS.md, CHANGELOG.md | GitHub web, search |
| EXEC-Gemini-Workstation | Gemini 2.5 Pro | SYSTEM_STATE_AGENT_BOOT.md, TODO.md | shell, gcloud, git |
| PLAN-Claude-Architect | Claude Sonnet/Opus | ARCHITECTURE.md (denne), ROADMAP.md | GitHub UI/API |
| AUDIT-NMT-Critic | Nemotron | RISKREGISTER.md, PLANBOARD.md | read-only alle filer |

Regel: En fil — én eier. Andre tråder foreslår via PR, eier merger.

---

## Dataflyt

```
OPS  --[MD-patch PR]--> PLAN merger
EXEC --[SYSTEM_STATE]--> alle leser
PLAN --[arch-spec PR]--> EXEC implementerer
AUDIT--[PLANBOARD]--> Chris prioriterer

Filer flyter via: GitHub commits på OSVauco/main
Aldri: direkte tråd-til-tråd
```

---

## Avhengigheter

- `OSVauco/main` er canonical branch for dette prosjektet
- Cloud Run avhenger av `vauco-gemini-tui-bridge` og OPAX-MCP-tjenesten
- Bridge avhenger av `bridge/`-kode + GCP service account `vauco-dev`
- Token economy avhenger av `scripts/token_economy.py` (planlagt)
- Pre-commit hook v2 avhenger av `.githooks/pre-commit` (planlagt)

---

## Åpne spørsmål (max 3)

1. **Langsiktig repo-struktur?**
   - A: Behold OSVauco + tjeneste-repoer (nåværende)
   - B: Slå sammen til monorepo
   - C: Splitt ytterligere per tjeneste

2. **Cloud Run min-instances=0 eller 1?**
   - A: 0 — kutter idle-kostnad (anbefalt H0)
   - B: 1 — ingen cold start latency
   - C: Autoscaling med schedule

3. **IAM: vauco-dev service account scope?**
   - A: Minimal — kun Vertex AI + Firestore
   - B: Bred — alle GCP tjenester i prosjektet
   - C: Per-skill separate accounts

---

## STUB-NOTAT
Denne filen er opprettet av OPS-Computer-Hub 2026-05-18 som oppstart for dette prosjektet.
PLAN-Claude-Architect skal senere erstatte innholdet med komplett draft når Claude-tråden starter. Se `plan_claude_architect_prompt.md`.