Project-independent foundations for reading, validating and extending ZIP case packages. The authoritative design is docs/architecture.md. The implemented v1 contract is documented in docs/package-format-v1.md. Job state, checkpoints and inbox admission are documented in docs/lifecycle-v1.md. Generic case construction and its input contracts are documented in docs/case-builder-v1.md.

Requires Python 3.11 or newer.

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e ".[test]"
.\.venv\Scripts\python.exe -m pytest

The lifecycle foundation supports one-pass inbox processing and resumable package checkpoints and a deterministic generic CaseBuilder. It includes no analysis worker or LLM, case interpretation, hypothesis generation or investigation tools.