Hitonabi
54be1fb1f6
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>
40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# 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).
|