mission-control-v2/docs/STATUS.md

Mission Control 2.0 — Status & Resume-Guide

So machst du jederzeit nahtlos weiter. Der vollständige Architektur-Plan liegt in C:\Users\TobisPC\.claude\plans\piped-cuddling-sloth.md (genehmigt).

Wo das Projekt lebt

• Code: F:\Coding Stuff\mission-control-2 (Windows-Dev-PC) + Gitea-Remote https://git.tobisniceshomelab.ddnsfree.com/Hitonabi/mission-control-v2 (Branch main).
• v1 (F:\Coding Stuff\mission-control) bleibt unangetastet bis zum Cutover.
• Box (Bosgame, 192.168.178.151): noch nicht deployt (Phase 0 step 5 offen).

Phasen-Fortschritt

• Phase 0 — Gerüst: FastAPI (/api/health,/api/models) + React/shadcn-Shell (Cmd+K, Dark, PWA). Verifiziert.
• Phase 1 — Engine + Routing: Compute-Module (fit/caps/sources), Discover (live HF), Engine-Write (register + groups/Ko-Residenz), LiteLLM-Gateway-Config + Service, Frontend Modelle&Routing (Caps-Chips, Fit, Discover-Tab, Routing-View). Lokal verifiziert (Backend-Smoke + Frontend-Build + Browser).
• Phase 2 — System/OS + Connect: System-Status (psutil CPU/RAM/Disk, sysfs GPU/Temp guarded), Wartung (restart/self-update als systemd-USER-Dienst, sudo-frei), Connect-Snippets (Cline/OpenCode/ Zed/Continue/Claude Code/Memory-MCP → Gateway model:auto + LAN-IP-Override). Lokal verifiziert.
• Phase 3 — Memory + MCP: Memory-Service (SQLite/WAL, 5 Kategorien, Dedupe-Kurator), Router (CRUD/export/dedupe), mcp/mcp_memory.py (Guard-Beschreibungen gegen Loop) + mcp/mcp_mc.py NEU (Stack-Management-Tools für Hermes: list/discover/register/route/restart/status). Frontend MemoryView (Add/Filter/Suche/Delete/Aufräumen). Lokal verifiziert (CRUD+Dedupe; MCP syntax-OK).
• Phase 4 — Hermes-Schicht (hermes-webui Dienst, Brain=auto, Tools/MCP verdrahten). Braucht Box.
• Phase 5 — Betrieb/Observability/Politur (Backup, LiteLLM-Traces, Health).
• Phase 6 — Cutover (/opt → v2, v1 aus). Braucht Box.
• Offen aus Phase 0/1: Box-Deploy (Gitea-Repo da; Box-Setup als systemd-USER-Dienst noch offen), LiteLLM Complexity-Auto-Router gegen installierte Version verifizieren.

Lokal entwickeln/verifizieren

# Backend
cd backend && .venv/Scripts/python -m uvicorn app:app --port 9000
# Frontend (Dev)
cd frontend && npm run dev          # http://localhost:5173 (proxyt /api → :9000)
# Frontend (Build → wird vom Backend ausgeliefert, committet)
cd frontend && npm run build

API (Stand Phase 1)

• GET /api/health — Status + engine/gateway reachable
• GET /api/models — installierte Modelle inkl. capabilities
• GET /api/discover[?force=1] — beste Modelle je Kategorie (live HF, Fit, Caps, ⭐recommended)
• GET /api/fit?params_b=&quant=&ctx=&name= — Hardware-Fit-Schätzung
• POST /api/models/register — GGUF als llama-swap-Modell eintragen (cmd + Rolle-Alias, optional jinja)
• GET/PUT /api/groups — llama-swap-groups (Ko-Residenz swap:false)
• GET /api/routing, PUT /api/routing/route — LiteLLM-Gateway-Mapping
• GET /api/system/status — CPU/RAM/GPU/Disk/Temp
• POST /api/system/restart (Whitelist), POST /api/system/self-update — Wartung (Box, sudo-frei)
• GET /api/connect?host= — IDE-/Agent-Snippets (Gateway + Memory-MCP)
• GET/POST/PUT/DELETE /api/memory[...] + /api/memory/export + /api/memory/dedupe — geteiltes Gedächtnis
• mcp/mcp_memory.py (geteiltes Memory) + mcp/mcp_mc.py (Stack-Management für Hermes) — stdio-MCP

Nächster sinnvoller Schritt

Phase 4 (Hermes-Schicht) braucht die Box — hermes-webui als Dienst, Brain=model:auto, Tools/MCP verdrahten (FS/Shell/SSH→Win/Netz + mcp_mc + mcp_memory), LiteLLM-Caveat verifizieren. Vorher sinnvoll: Box-Deploy einrichten (systemd-USER-Dienst, sudo-frei; deploy/deploy.sh auf User-Dienst umstellen, kein /opt/sudo) + LiteLLM-Gateway auf der Box starten und model:auto/Complexity-Router verifizieren. Lokal noch machbar ohne Box: Phase-4-Frontend (Agent-Status/Verdrahtungs-Anzeige + „Hermes öffnen").