- See [Migrating from v0.21](https://github.com/tim-osterhus/millrace/blob/v0.22.0/docs/migrating-from-v0.21.md) and the [v0.22 compatibility guide](https://github.com/tim-osterhus/millrace/blob/v0.22.0/docs/v0.22-compatibility.md) for migration steps.
- Python 3.12 or newer required for the complete bundle; base `millrace-ai` runtime works on Python 3.11 or newer.
- v0.22 does not open, repair, or migrate v0.21 workspaces, state, snapshots, package layouts, or compatibility profiles; a new workspace and re‑import of workflow packages are required.
- Millforge is now the default runner for newly compiled plans.
- Codex remains an explicitly selectable alternative via an operator‑provided wrapper.
- Legacy `millrace-web` sidecar is removed from v0.22.
Full changelog
Millrace v0.22.0
Millrace v0.22.0 is a local runtime for governed, long-running agent workflows.
It compiles workflow packages into immutable selected plans and applies runner
results through durable, validated state transitions.
Install
The complete supported bundle requires Python 3.12 or newer:
python -m pip install "millrace==0.22.1"
millrace --version
The base millrace-ai runtime can be installed separately on Python 3.11 or
newer.
Key Capabilities
- Compiler-validated workflow packages and immutable selected plans.
- Durable local queues, runs, artifacts, waits, interventions, and traces.
- Daemon execution with bounded dispatch, recovery, quarantine, fanout, join,
operator waits, and workflow-defined completion. - Explicit package, plan, queue, status, trace, wait, intervention, health, and
daemon commands for a local operator.
Breaking Change
v0.22 is a clean break from v0.21. It does not open, repair, or migrate v0.21
workspaces, state, snapshots, package layouts, or compatibility profiles.
Create a new workspace and re-import current workflow packages. See
Migrating from v0.21
and the v0.22 compatibility guide.
Package Boundaries
| Package | Responsibility |
| --- | --- |
| millrace-ai | Compiler, kernel, storage, adapters, daemon, and CLI |
| millrace-plus | Official workflow definitions, prompt assets, stage skills, and authoring guides |
| millforge | Independent execution harness providing millforge-base |
| millrace==0.22.1 | Dependency-only bundle pinning millrace-ai==0.22.0, millrace-plus==0.22.0, and millforge==0.1.0 |
The legacy millrace-web sidecar is not included in v0.22.
Supported Runners
Millforge is the default for eligible newly compiled plans. Codex remains an
explicitly selectable alternative through an operator-provided wrapper.
Existing selected plans are never remapped.
