mission-control-v2/docs/RUNBOOK.md

RUNBOOK — Die Box in 1 Seite (für Menschen, ohne KI-Hilfe)

Grundsatz: Die Box wartet sich selbst. Du bekommst Telegram-Nachrichten und antwortest höchstens „mach". Dieses Blatt ist NUR für den Fall, dass etwas klemmt.

Was die Telegram-Meldungen bedeuten

Meldung	Bedeutung	Dein Handgriff
„… aktualisiert … grün"	Update eingespielt, alles geprüft	keiner
„… zurückgerollt … GEPINNT"	Update war schlecht, alte Version läuft wieder	keiner (läuft stabil weiter)
„KRITISCH: …"	Update UND Rollback kaputt	siehe „Box tot?" unten
„🛰️ Evolution-Radar …"	monatlicher Chancen-Report	lesen; bei Interesse „mach" antworten
„[Werkstatt] … Vorschlag liegt bereit"	Box hat einen Fix vorbereitet	im Web-UI → Auftragsbuch → Karte ansehen → „Annehmen" oder „Ablehnen" klicken

Box tot / Weboberfläche weg?

1. Strom/Netz prüfen, dann Box einmal neu starten (Power-Knopf). Alles startet von selbst (systemd, reboot-fest). 2–3 Minuten warten, dann http://192.168.178.151:9001 aufrufen.
2. Immer noch tot → per SSH (PC, PowerShell): ssh hitonabi@192.168.178.151 dann: bash ~/mission-control-v2/deploy/restore.sh (nimmt automatisch das letzte Backup, liegt in /srv/models/mc2-backups/, 14 Tage Vorrat, täglich 03:30 Uhr).
3. Totalschaden (neue Platte/Hardware) → docs/DISASTER_RECOVERY.md (Bootstrap von Null).

Lucy (am PC)

• Start: Desktop-Verknüpfung „Lucy" (startet den eingefrorenen Produktiv-Build).
• Hängt? F:\Coding Stuff\lucy\lucy-desktop\Lucy-Neustart.bat doppelklicken.
• Lucy ist EINGEFROREN — Änderungen macht nur die Werkstatt (Telegram-Vorschlag abwarten).

Automatik-Fahrplan (läuft ohne dich)

• Nachts: 03:15 Traum (Wissens-Vault) · 03:30 Backup · 03:50 PBS-Backup · 04:30 Chef-Gutachter (Morgenlage) · 07:15 Selbsttest · 08:00 Daily-Briefing
• Mo 05:15 Release-Radar (Hermes-Neuerungen) · Monatlich 1., 09:00 Monats-Review (Evolution-Radar + Selbstkritik) auf Telegram
• Auto-Update ist BEWUSST AUS (dein Entscheid 04.07.) — Updates kommen als Vorschlag/Knopf

Pinnwand: eine Ebene ist „GEPINNT" — was heißt das?

Ein Update hat den Selbsttest gerissen; die Box bleibt bewusst auf der alten Version. Das ist ein STABILER Dauerzustand, kein Fehler. Pin ansehen / lösen (per SSH):

cat /srv/models/mc2-pins.json
jq 'del(.hermes)' /srv/models/mc2-pins.json > /tmp/p && mv /tmp/p /srv/models/mc2-pins.json
# (statt .hermes: .engine oder .swap) — nächster So-Lauf versucht das Update erneut

Wann Gemini rufen (der Notfall- und Review-Partner)

Seit dem Claude-Abo-Ende ist Gemini (in der Antigravity-App am PC) dein externer Helfer. Du brauchst ihn NUR in zwei Fällen — den Alltag macht die Box selbst:

1. Notfall: Die Box ist kaputt UND die Schritte unter „Box tot?" (oben) haben nicht geholfen — oder Lucy/Telegram melden wiederholt „KRITISCH".
2. Außen-Review: Du willst einen Fremd-Blick auf die Arbeit der Box (z. B. alle paar Monate oder vor einem großen Umbau).

So rufst du ihn: Antigravity öffnen → Projektordner F:\Coding Stuff\mission-control-2 → als erste Nachricht schreiben: „Lies docs/GEMINI_BRIEFING.md und dann [dein Problem]." Für ein Review stattdessen: „Lies docs/GEMINI_BRIEFING.md und führe das Review aus docs/ANTIGRAVITY_REVIEW.md durch."

Grenzen (stehen auch in seinem Briefing): Gemini schlägt vor, DU klickst/entscheidest. Er darf Security-Sachen nur melden, nie ändern. Wenn er etwas über die Box behauptet, darf er es nur nach echtem Test behaupten — im Zweifel nachfragen „hast du das gemessen?".

Einmalige sudo-Session — ✅ erledigt (02.07.2026)

Sudo-Freischaltung für Engine/Router-Updates, unattended-upgrades und v1-Aufräumen sind durch (/etc/sudoers.d/mc2-autonomie liegt). Nichts mehr zu tun.

Nützliche Handgriffe (SSH)

curl -s http://127.0.0.1:9001/api/health          # Gesamtzustand (brain ready?)
bash ~/mission-control-v2/deploy/autoupdate.sh    # Update-Lauf sofort statt Sonntag
bash ~/mission-control-v2/deploy/notify.sh "test" # Meldeweg testen (muss auf Telegram ankommen)
tail ~/mc2-notify.log                             # was wurde zuletzt gemeldet