Initial commit: SWOOSH bootstrap with statechart spec, OpenAPI, ADRs, and ops harnesses

spec/swoosh.spec.yaml

@@ -0,0 +1,46 @@
+# SpecKit: Product Specification for SWOOSH
+meta:
+  name: SWOOSH
+  tagline: Deterministic state-machine orchestrator for CHORUS
+  owners:
+    - handle: core
+      role: maintainers
+  status: bootstrap
+  roadmap_stage: alpha
+goals:
+  - id: CHORUS-INT-001
+    title: Deterministic orchestration under chaos
+    success_metrics:
+      - invariant_violation_rate == 0 over 10k randomized runs
+      - mean_recovery_time_from_churn < 2 beats
+  - id: CHORUS-INT-002
+    title: Audit-first transitions
+    success_metrics:
+      - 100% transitions WAL-logged with UCXL DR refs
+requirements:
+  functional:
+    - Expose Transition API to propose guarded state advances.
+    - Persist WAL and periodic snapshots; deterministic replay.
+    - Enforce BACKBEAT/pressure windows on time-gated transitions.
+    - Council quorum certificates via HMMM signatures.
+  non_functional:
+    - Idempotent, replay-safe; total-ordered by HLC.
+    - Security: age-encrypted configs; license gating via KACHING.
+interfaces:
+  apis:
+    - name: Transition API
+      file: ../api/openapi.yaml
+artifacts:
+  statechart: ../docs/statechart.yaml
+  architecture: ../docs/ARCHITECTURE.md
+  adr:
+    - ../adr/0001-adopt-statecharts.md
+    - ../adr/0002-transition-api-and-wal.md
+testing:
+  plans:
+    - ../tests/TESTING.md
+ops:
+  runbooks:
+    - ../ops/chaos-harness.md
+    - ../ops/observability.md
+license: MIT