Hitonabi
961b003df4
- deploy/idle-radar-feed.sh (Hermes-Cron 03:45): destilliert aus Journal- Fehlermustern (24h) + juengster Traum-Notiz max. 2 belegte Wartungs- Kandidaten und legt sie als rohe Ideen (triage) ins native Kanban. Ehrlichkeits-Gate: Beleg-Zitat wird MECHANISCH gegen das Material geprueft (reproduziert-oder-abgelehnt). Stau-Bremse (>=4 offene Queue- Aufgaben oder >=3 offene Karten -> nichts Neues), Dedup dreifach (State-Datei + Board-Abgleich inkl. archivierter + --idempotency-key), Security/Config/Updates tabu. Analyst gpt-oss-120b, Vertretung GLM. - deploy/idle-radar-prompt.md: versionierter Boten-Auftrag (Lucys Stimme, max 3 Saetze, nichts selbst umsetzen). - deploy.sh: kopiert idle-radar-feed.sh nach ~/.hermes/scripts/ (greift wegen Selbst-Reset-Falle erst ab dem 2. Deploy -> Vorinstallation einmalig von Hand; Cron-Registrierung einmalig: hermes cron create). - Grossbau-Etappen-Regeln (Zielbild-Entscheid 4, 10.07.): werkstatt-SOUL Regel 6 + wartung-/orchestrator-SKILL Scope-Check: Grosses nicht mehr ablehnen, sondern in Etappen bauen - jede Etappe eigener Branch, fuer sich lauffaehig + annehmbar, Folge-Etappen als neue Queue-Aufgaben, NIE auf unangenommene Branches aufbauen. - Doku: AUFTRAGSBUCH.md (Idle-Radar-Abschnitt), wissen/OFFENE-FAEDEN.md. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
109 lines
6.4 KiB
Markdown
109 lines
6.4 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**.
|
|
|
|
## Die Ideen-Queue davor (natives Hermes-Kanban, seit 10.07.2026)
|
|
|
|
Vor dem Auftragsbuch liegt DIE eine Ideen-Queue: das native Hermes-Kanban
|
|
(`hermes kanban`, SQLite-Board, Dispatcher läuft im Gateway). Der Weg einer Idee:
|
|
|
|
1. **Idee rein — Tür egal:** Eingabefeld im Auftragsbuch-Tab (`POST /api/ideen`),
|
|
Telegram/Desktop (natives Tool `kanban_create`, Regel in SOUL.md) oder Lucys
|
|
Sprech-Leitung (`idee_notieren` in `mcp/mcp_voice.py`). Alles landet als
|
|
`triage`-Aufgabe auf demselben Board.
|
|
2. **Die Box arbeitet sie aus:** der Kanban-Specifier macht aus der rohen Idee
|
|
einen sauberen Auftrag und wählt das Worker-Profil (Routing über die
|
|
Profil-Beschreibungen: Code → `werkstatt` [Qwen3-Coder-Next, Leitplanken in
|
|
`deploy/werkstatt-SOUL.md`], Doku/Analyse → `default`).
|
|
3. **Der Worker baut** im isolierten Workspace; Code-Ergebnisse pusht er als
|
|
Vorschlags-Branch auf Gitea — der hier als Karte erscheint. **Das Gate bleibt
|
|
dein Klick.**
|
|
|
|
**Die Queue füttert sich auch selbst — Idle-Radar (S4 „Zündung", 12.07.2026):** ein
|
|
nächtlicher Hermes-Cron (03:45, `deploy/idle-radar-feed.sh`) destilliert aus den
|
|
Journal-Fehlermustern der letzten 24 h und der jüngsten Traum-Notiz bis zu **2 belegte**
|
|
Wartungs-Kandidaten und legt sie als rohe Ideen (`triage`, `created_by=idle-radar`) auf
|
|
dasselbe Board. Leitplanken: jedes Beleg-Zitat wird **mechanisch** gegen das Material
|
|
geprüft (erfundene Belege fliegen raus — reproduziert-oder-abgelehnt), **Stau-Bremse**
|
|
(ab 4 offenen Queue-Aufgaben oder 3 offenen Karten legt er nichts nach), dreifacher
|
|
Dedup (State-Datei `~/.hermes/state/idle-radar-gemeldet.txt`, Board-Abgleich inklusive
|
|
archivierter = verworfener Ideen, `--idempotency-key`), Security/Config/Updates tabu.
|
|
Der Radar legt nur Ideen an — gebaut wird über denselben Kreislauf, dein Klick bleibt
|
|
das Gate.
|
|
|
|
Die Queue-Sicht im Tab (Status, offene Ideen) kommt aus `hermes kanban list --json`
|
|
(`backend/services/ideen.py`); die Morgenlage bekommt `kanban stats` als
|
|
Beweismaterial. Entscheid nativ-vs-Eigenbau (Hermes-first): Probe 10.07.2026 —
|
|
Dispatcher, Specifier, Profil-Modellwahl und Artefakt-Tracking sind nativ E2E
|
|
bewiesen; ein Eigenbau hätte all das nur nachgebaut.
|
|
|
|
## 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. Seit S3
|
|
(lucy-pipeline) aus **zwei Repos**: `mission-control-v2` (Box-Stack) und `lucy`
|
|
(Desktop-App, rosa „Lucy"-Badge auf der Karte).
|
|
- **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`).
|
|
|
|
## Was „Annehmen" bei einer LUCY-Karte macht (deploy/lucy-annahme.sh)
|
|
|
|
Lucy (Electron) lebt auf dem Windows-PC; ihr `dist` liegt nicht im Repo — die Box
|
|
kann sie nicht bauen. Der Lucy-Runner spannt darum den PC ein (PC-Executor :7777,
|
|
Token aus `~/.hermes/config.yaml`):
|
|
|
|
1. **Vorprüfung am PC, VOR dem Merge:** Executor erreichbar? Arbeitskopie
|
|
`F:\Coding Stuff\lucy` auf `main` und sauber? Läuft Lucy gerade? Scheitert etwas,
|
|
bricht der Lauf ab, ohne irgendetwas zu verändern — der PC muss an sein.
|
|
2. Merge des Branches im isolierten Worktree von `~/lucy` → Push nach `main`.
|
|
3. Der PC zieht `main` (ff-only) und startet **detached**
|
|
`deploy/lucy-annahme.ps1` (liegt im Lucy-Repo): ggf. `npm ci` (nur wenn sich
|
|
das Lockfile geändert hat) → `tsc --noEmit`-Gate → dist-Backup → `npm run dist`
|
|
→ Lucy-Neustart **nur, wenn sie vorher lief** (User-Entscheid: Lucy startet
|
|
nur, wenn der Commander sie will) → Stimme-Health (`:8130`).
|
|
4. Die Box pollt die PC-Status-Datei (`.lucy-annahme.json`) und spiegelt den
|
|
Fortschritt live auf die Karte. **Rot ⇒ Merge wird automatisch revertiert**,
|
|
der PC stellt dist aus dem Backup wieder her — die laufende Lucy bleibt die
|
|
alte. Grün ⇒ Branch aufgeräumt, Meldung an Telegram + Chronik.
|
|
|
|
## Bagatellen ohne Klick (mc2-bagatell.timer, 04:10)
|
|
|
|
Einzige Ausnahme vom Klick-Gate (User-Entscheid 10.07.2026, bewusst eng geschnitten):
|
|
`deploy/bagatell-annahme.sh` spielt nachts Vorschlags-Branches ein, deren Diff
|
|
**ausschließlich `.md`-Dateien anlegt oder ändert** — keine Code-Zeile, keine
|
|
Löschungen, keine Renames, keine Skripte. Der Weg ist derselbe Annahme-Runner wie
|
|
beim Klick (Merge → Gate → Deploy → Health → Auto-Revert), maximal 2 pro Nacht und
|
|
nur Branches ohne vorherige Fehl-Läufe. Fangnetz: Nacht-Sicherung 03:30 liegt davor,
|
|
jede Annahme steht in Chronik + Telegram, die Morgenlage 04:30 berichtet. Die Klasse
|
|
erweitert nur der Commander, nie das Skript.
|
|
|
|
## Leitplanken
|
|
|
|
- Propose-only bleibt: **keine Code-Zeile geht ohne Klick live.** Das Gate ist dieses
|
|
Buch; einzige Ausnahme sind die eng geschnittenen Doku-Bagatellen (oben).
|
|
- „Frontend ohne Build"-Warnung (nur mc2): enthält ein Branch `frontend/src` ohne
|
|
frisches `frontend/dist`, bleibt die Oberfläche nach dem Annehmen alt, bis am PC
|
|
gebaut wird. Lucy-Karten brauchen die Warnung nicht — dort baut IMMER der PC.
|
|
- 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).
|