Initial commit: SWOOSH bootstrap with statechart spec, OpenAPI, ADRs, and ops harnesses
Some checks failed
ci / validate (push) Has been cancelled

This commit is contained in:
anthonyrawlins
2025-10-02 09:59:59 +10:00
commit b41f03f4a0
19 changed files with 358 additions and 0 deletions

View File

@@ -0,0 +1,11 @@
# ADR 0001: Adopt Deterministic Statecharts
## Decision
Use hierarchical statecharts with pure reducers governing SWOOSH orchestration.
## Rationale
Chaos resilience, auditability, time-gated cadence (BACKBEAT), idempotency, replay.
## Consequences
- Requires WAL + snapshots.
- Transition API becomes the single mutation path.

View File

@@ -0,0 +1,8 @@
# ADR 0002: Transition API & WAL
## Decision
All mutations flow through a signed Transition API. Accepted transitions append to WAL, then mutate state.
## Details
- Store `(state_pre_hash, transition, inputs_hash, signer, idem_key, hlc, window_id)`.
- Emit BUBBLE DR with UCXL backlinks upon accept.