nexo312/trading-system-docs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trading-system-docs/a2/README.md

3 KiB
Raw Blame History

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.