trading-system-docs/a2

RED QUEEN — A2: Persistent Mission State & State Machine

Phase: A2 (CONTROLLED BUILD) · Status: ABGESCHLOSSEN · Commit dbbbb1d Scope: Persistente Mission-State- und Work-Package-State-Machine. Keine autonome Orchestrierung, keine Loops, kein Heartbeat, kein Cron (A2 §16).

---

1. Architektur (verbindlich, A2 §3/§8)

• Work Packages → native Hermes-Kanban (primärer Task-State) via KanbanMirror (best effort): Dependencies via link, Block via block, Complete via complete, Idempotenz via --idempotency-key. HERMES_KANBAN_DB steuert die (isolierte) DB.
• Mission-Ebene → minimaler Metadata-Layer missions.db (SQLite) als PRIMÄRER State: Mission-States, WP-States, Dependencies, Transition-Evidence, ID-Fortschritt.
• Keine zweite vollständige Task-Queue. Kanban = WP-State; Missions-Layer minimal.
• Priorität: HERMES NATIVE > CONFIG > SKILL > MINIMAL CUSTOM > EXTERNAL.

2. Module

Datei	Rolle
rq_state_machine.py	Deterministische Transition-Tabellen (MISSION + WP), direkt aus MISSION_STATE_MACHINE.md. Keine Persistenz.
rq_mission.py	MissionStore: persistente SQLite-DB, Validierung, Fail-closed, Idempotenz, KanbanMirror.
rq_mission_cli.py	CLI (maschinenlesbar via --json, Exit 2 bei RqError).
test_a2.py	Deterministische Tests (isolierte Temp-DBs). PASS=61 FAIL=0.
MISSION.md.template	Markdown-Metadaten-Template (Goal/Scope/Constraints/AC). Aktiver State nie aus Markdown.
.gitignore	__pycache__/, *.pyc, *.db, *.tmp

3. ID-Schema (§7)

• Mission: RQ-MISSION-YYYYMMDD-NNN (NNN restart-stabil via Max+1 in DB).
• WP: <mission_id>-WP-NNN (innerhalb der Mission eindeutig).

4. State Machines (autoritativ A1)

• Mission: CREATED/PLANNING/READY/RUNNING/REVIEW/COMPLETED + BLOCKED/PAUSED/FAILED/CANCELLED/ESCALATED.
• WP: TODO/READY/IN_PROGRESS/CHECKING/DONE + FAILED/BLOCKED/ESCALATED.
• Verbote: COMPLETED→RUNNING, DONE→IN_PROGRESS ohne Recovery, Mission COMPLETED mit offenen Pflicht-WPs, WP DONE mit offener Dependency → REJECT.
• Fail-closed: unbekannter/korrupter State → STATE_ERROR, keine Mutation.

5. Tests (§18)

python3 test_a2.py → PASS=61 FAIL=0 EXIT=0. Deckt: create/read, valid/invalid transitions, dependency, block, wp/mission complete, idempotency, unknown id/state, RESTART-PERSISTENCE (identisch), state-consistency, STATE_ERROR fail-closed, Kanban-Mirror-Isolation. Isolierte Temp-DBs, produktive /opt/data/kanban.db unangetastet.

6. Rollback (§22)

• Code-/-Docs neu: a2/ (6 Dateien + Template) und README-Abschnitt „Implementierungsstatus".
• Zurückrollen: git reset --hard 3d738e6 (A1-Zustand) oder git revert dbbbb1d 581253c.
• Config/DB-Strukturen erzeugt: nur missions.db zur Laufzeit in einem wählbaren Pfad (Konstruktor-Argument); produktive kanban.db NICHT verändert.
• Testzustand: entsteht nur in tempfile.mkdtemp(); nie im produktiven Bereich.
• Impact: kein Rain/Alice/Trading-System/Forgejo-Infrastruktur-Eingriff.