Files
SWOOSH/docs/ARCHITECTURE.md
anthonyrawlins b41f03f4a0
Some checks failed
ci / validate (push) Has been cancelled
Initial commit: SWOOSH bootstrap with statechart spec, OpenAPI, ADRs, and ops harnesses
2025-10-02 09:59:59 +10:00

15 lines
778 B
Markdown

# Architecture
## Core Concepts
- **Reducer**: Pure function `newState = Reduce(oldState, Transition)`.
- **WAL**: Append-only log of proposed & accepted transitions.
- **Checkpoint**: Periodic snapshot; on restart: `rehydrate = checkpoint + WAL.replay()`.
- **HLC**: Hybrid Logical Clock stamped on every transition for total ordering.
- **Guards**: Pure predicates sourced from policy, BACKBEAT window, health probes, quorum certs.
- **Compensation**: Inverses for PROVISION, ELECT, INDEX, etc.
## Statechart (overview)
Top-level regions: BOOT, PROJECT_LIFECYCLE (parallel: Ingestion, Council, Environment), EXECUTION (PLAN → WORK → REVIEW → REVERB), CONTROL (PAUSED/DEGRADED/RECOVERY), QUARANTINED, TERMINATED.
See `docs/statechart.yaml` for machine-parseable spec.