Files
mission-control-v2/SAVEPOINT.md

3.4 KiB

Savepoint — Mission Control 2.0 (MC2)

Stand: 2026-07-05. Zustands-Snapshot für einen externen Code-Review (Antigravity). Zuerst AGENTS.md lesen (Projekt-Regeln), dann diese Datei (wo wir stehen), dann README.md/docs/.

Was das ist (in einem Satz)

MC2 ist die Web-Admin-Konsole einer 100 % lokalen KI-Appliance („die Box", Bosgame M5 / AMD Strix Halo, 128 GB Unified RAM, llama.cpp-Vulkan). Sie verwaltet Engine, Modelle, Gedächtnis, Agenten-Status, Updates & Wartung — und dient teils als Gedächtnis-Oberfläche für die Sprach- Begleiterin „Lucy".

Architektur (Kurzform — Details in AGENTS.md/docs/)

  • Backend backend/ — FastAPI, :9001 als systemd-User-Dienst (reboot-fest, sudo-frei). Router (routers/, dünn) → Logik (services/, Single Source of Truth).
  • Frontend frontend/ — React/Vite/Tailwind/shadcn. frontend/dist ist ABSICHT im git (Box hat kein Node; Backend liefert die gebauten Assets aus).
  • Eingebautes Gateway :9001/v1 (OpenAI-kompatibel) → llama-swap :8080 (Engine, Vulkan/RADV).
  • Sidecars: mem0_service/ (Mem0-Gedächtnis), voice_service/ (STT/TTS für den „Sprechen"-Tab), mcp/ (MCP-Server), hermes/ (Hermes-Agent-Plugin), client/hermes-pc (PC-Executor).

Aktueller Zustand

  • Stabil, in Produktion, „MC2 Final". Ein Neubau („MC3") wurde bewusst VERWORFEN — MC2 wird sauber gehalten und eingefroren, nicht neu erfunden.
  • Autonomie-Ausbau abgeschlossen (Observability-Latenztrace, Fremd-Modell-Kritiker/Härtung, nächtliches „Dreaming" mit Wissens-Vault) — jeweils propose-only, Mensch = Gate.
  • Zuletzt (Commit ff1b9a0, 05.07.): coder-lite (Qwen3-Coder-30B) entfernt; der Verbinden-Tab (services/connect.py) empfiehlt IDEs jetzt die realen Direkt-Modelle coder/heavy/vision statt der virtuellen „coding"-Lane. Davor u. a. Engine-Update-Fix, Hermes-Terminal same-origin.
  • Modelle live: hermes=Qwen3.6-35B-A3B (Agent-Hirn, immer warm) · coder=Qwen3-Coder-Next · heavy=gpt-oss-120b · vision=Qwen3-VL-30B · scout=GLM-4.6V · embed. Warm-Set = hermes+vision+embed.

Nordstern & Randbedingungen (WICHTIG für den Review)

  • Zieht ohne Wartung über JAHRE durch. Robustheit + Einfachheit schlagen Features. Der Betreiber ist kein Entwickler — alles muss reboot-/update-fest und selbsterklärend sein.
  • 100 % lokal, kein Cloud-Zwang (Privatsphäre ist der Sinn). Hardware-Decke: ~124 GB, ein Topf.
  • Lucy ist ein SEPARATES Repo (F:\Coding Stuff\lucy) — nicht Teil dieses Reviews.

Bekannte raue Kanten (Kandidaten — gern bestätigen/erweitern)

  • Doku-Drift möglich: AGENTS.md nennt „Box läuft in UTC" — die Box wurde inzwischen auf Europe/Berlin umgestellt.
  • Alte, disabled v1-System-Unit mission-control.service liegt kosmetisch herum (sudo zum Entfernen).
  • Ein paar frühere Frontend-Monolithen wurden entflochten; Rest-Altlasten möglich.

Was NICHT empfohlen werden soll (bereits entschieden)

Cloud-Migration · Voll-Rewrite · schwere neue Frameworks · Engine-/Modell-Wechsel, die nicht in 124 GB passen · frontend/dist aus git nehmen (Absicht) · Security-Config anfassen. Erwünscht sind Bugs, Fragilität, tote Pfade, Sicherheitslücken, Vereinfachung (KISS/DRY), Wartbarkeit.

Letzter Sicherungspunkt

  • git ff1b9a0 „coder-lite raus + Verbinden-Tab auf echte Direkt-Modelle" (auf main, deployt, live).