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. Vcore imports for wowdiag/wowsrc are documented in docs/vcore-adapters-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, resumable package checkpoints and a deterministic generic CaseBuilder. An async LLM gateway and CaseInterpreter provide interpretation and bounded initial hypothesis generation, with durable per-hypothesis budget accounting. Read-only source/database snapshot queries are available. Diagnosis, Change Requests and a continuous analysis worker remain future milestones.

Expected-behavior resolution and the read-only provider contract: expected-behavior-v1.md.

Configurable LLM transport, failover and durable retries: llm-gateway-v1.md, with example configuration.

The first domain LLM phase and its source-reference contracts: case-interpretation-v1.md.

Initial hypotheses, revision-wide creation limits and equal budget allocations: hypothesis-builder-v1.md, with analysis configuration.

Durable investigation budget accounting, configurable costs/rewards and stopping rules: budget-manager-v1.md, with budget configuration.

Case-local asynchronous test requests, confirmed feedback and budget-preserving event-driven resume: async-tests-v1.md. Web UI and external bot/client adapters are future integrations.

Read-only packaged source/database queries and the strict tool allowlist: investigation-tools-v1.md.