Repository navigation
v0.1.0: headless MVP
Executable architectural model for safe what-if experimentation. Simulation output always carries assumptions, confidence, and seed — never presented as production measurement.
Quickstart (Python 3.13, uv, no card, offline-capable):
uv python pin 3.13
uv venv
uv sync --group dev
uv run shadowbox import --from examples/checkout/docker-compose.yaml --out model.yaml
uv run shadowbox validate examples/checkout/model.yaml --scenario examples/checkout/scenarios/db-failure.yaml
uv run shadowbox simulate examples/checkout/model.yaml --scenario examples/checkout/scenarios/db-failure.yaml --seed 42 --out report.json
uv run shadowbox compare --a base.json --b report.json
uv run shadowbox serve --port 8000
What is inside: deterministic engine (seeded, golden hash), exact p50/p90/p95/p99, compose importer, 7 chaos cards, FastAPI server with SQLite, static web demo with time-travel replay, 33 tests (unit, golden, property, integration). Benchmarks: 85k events in ~0.05s, 840k in ~0.6s (i7-1255U, SLO 50k events under 2s).
Full changelog: M0 contracts, M1 engine, M2 importer plus cards, M3 compare, M4a API, M4b cloud scaffold, M5a replay, serve command.