Skip to content

v0.1.0: headless MVP

Choose a tag to compare

@Pa004 Pa004 released this 26 Sep 01:04
· 99 commits to master since this release

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.