Skip to content

v0.1.0a3 — 2026-04-24

First-fork-ready alpha. The install runbook now walks a fresh operator from pip install to their first autonomous dispatch.

Headline

All four first-fork blockers closed:

  • T0-101 — adapter entry-point discovery. Installed adapter packages auto-register via [project.entry-points."oxi.adapters"]; override with OXI_ADAPTER=pkg:ClassName. No more hand-written registration snippet.
  • T0-102 — oxi v3 plan --dry-run subcommand. Roadmap format is pickier than it looks; dry-run surfaces parse results without touching the DB.
  • T0-103 — first-fork smoke test in CI. Builds the wheel, installs it into a clean venv, runs oxi init, runs a reconciliation-only tick. Catches regressions in the install experience.
  • T0-1 — install runbook at docs/runbooks/install.md. Zero-to-first-tick in under five minutes.

Also:

  • T0-11 — worktree_provision drift repair. If the target slot holds a stale branch, nuke and re-provision rather than failing.
  • T0-2 — rollback runbook at docs/runbooks/rollback.md.
  • T1-12 — auto_recover module for retrying rejected/failed PR dispatches after a cooldown.
  • T1-13 — deep_fix N-strike escalation for repeatedly-stuck tasks.
  • T1-15 — relax success classification when PR exists. Workers often exit non-zero on post-success tails; the dispatcher now upgrades FAILED → SUCCESS when the branch has a commit ahead and a PR is open.

Dogfood evidence

This release was largely built by the engine dispatching against its own repo. 7 dispatches across the session; all but one produced correct code. Total cost: ~$5.20 of the $20 daily cap.

Install

pip install --pre oxi-core       # alpha — --pre is required
# or:
pip install oxi-core==0.1.0a3

Without --pre, pip resolves to the 0.0.0 name-reservation stub. See docs/runbooks/install.md for the full walkthrough.

Yanked

0.1.0a2 stays on PyPI but should not be installed — it doesn't have auto-registration, so oxi status prints "no adapter" after pip install -e.

Tests

From main: 557 passing across oxi-core + adapters (reference, self). First-fork smoke test passes on CI and locally.

Next

0.1.0a4 target: the lower-priority T1 polish (T1-3 status --json, T1-4 ci_issue_filer, T1-5 ANSI colors, T1-6 dashboard event tail, T1-7 oxi v3 kill ergonomics) + T1-14 ledger_events typed constants. All generated via dogfood.