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>
This commit is contained in:
@@ -0,0 +1,39 @@
|
||||
# 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).
|
||||
Reference in New Issue
Block a user