Files
mission-control-v2/docs/AUFTRAGSBUCH.md
T
Hitonabi 54be1fb1f6 Zeitmaschine: kompaktes Snapshot-Datum lesbar anzeigen + Auftragsbuch-Doku
fmtSnap kannte nur Zeitstempel mit Trennzeichen (2026-07-08T...), backup.sh
schreibt aber kompakt (20260708-181136) — Datum erschien roh. Regex tolerant
gemacht. Dazu docs/AUFTRAGSBUCH.md (Funktionsweise + Leitplanken); dieser Branch
ist zugleich die erste echte E2E-Annahme-Probe des Auftragsbuchs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-08 21:43:38 +02:00

2.0 KiB

Auftragsbuch — die Vorschlags-Inbox der Box

Das Auftragsbuch ist das Mensch-Gate des propose-only-Kreislaufs als Klick statt Git-Handarbeit: alles, was die Box von allein baut oder sich ausdenkt, landet hier als Karte — du entscheidest mit Annehmen oder Ablehnen.

Woher die Karten kommen

  • Fertige Patches — Branches auf Gitea (wartung/*, orchestrator/*, doku/*, feature/*), wie die Werkstatt und der Orchestrator sie hinterlassen. Die Karte zeigt Commit-Botschaft, geänderte Dateien und den vollen Diff.
  • Skill-Kandidaten — Ideen des nächtlichen Traum-Crons aus dem Wissens-Vault (~/wissens-vault/skill-kandidaten/). „Beauftragen" schickt sie als Auftrag an die Werkstatt (Orchestrator-Skill); das Ergebnis kommt als neuer Patch zurück.

Was „Annehmen" bei einem Patch macht (deploy/auftrag-annehmen.sh)

  1. Merge des Branches in einem isolierten Worktree (Live-Checkout bleibt unberührt).
  2. py_compile-Gate über die geänderten Python-Dateien.
  3. Push nach main auf Gitea (mit Retry).
  4. Deploy (als /tmp-Kopie von deploy.sh — Selbst-Reset-Falle) — die Zentrale startet dabei kurz neu.
  5. Health-Check mit Geduld. Rot ⇒ automatischer Revert des Merges + Redeploy + Alarm. Grün ⇒ Branch wird aufgeräumt, Meldung an Telegram + Chronik.

Der Lauf ist eine eigene systemd-Unit (detached) — er überlebt den Neustart des Backends, das ihn gestartet hat. Fortschritt steht live auf der Karte (/srv/models/mc2-auftragsbuch.json).

Leitplanken

  • Propose-only bleibt: nichts geht ohne Klick live. Das Gate ist dieses Buch.
  • „Frontend ohne Build"-Warnung: die Box kann kein Frontend bauen (kein Node) — enthält ein Branch frontend/src ohne frisches frontend/dist, bleibt die Oberfläche nach dem Annehmen alt, bis am PC gebaut wird.
  • Ablehnen löscht nur den Remote-Branch; die Historie auf Gitea bleibt.

Diese Datei kam übrigens selbst über das Auftragsbuch ins Repo — als erste echte End-to-End-Annahme (Probe-Branch wartung/annahme-probe, 08.07.2026).