v0.4.2

The CLI-and-federation release: cross-vendor delegation, multi-agent Phases 5-6, durable workflows with a live viewer, the full CLI-parity batch, version centralization, and a docs refresh with an MCP API reference.

Highlights

• Federation Stage 5 — cross-vendor delegation. session_delegate_task / session_delegations + the CLI /handoff command. Hand a task to another CLI/vendor on the same brain, addressed directly or by <clientKind>:next-idle (e.g. codex:next-idle); queued to a durable pending_delegations table when no peer is live.
• CLI multi-agent — Phases 5 & 6. Confidence-scored review fan-out (/review-auto), progressive result handoff, agent-definition packs (/pack), dedicated worker threads (/workers), delegation-aware memory capture, and brain-agent provenance (/brain why).
• Durable workflows. A per-step run.json run engine, a live /workflows [slug] viewer (status + step timeline), and above-prompt notifications when a background run finishes while you're idle (cli.notifyBell).
• Full CLI-parity batch. /review --fix (apply + verify), /simplify, /effort xhigh (alias max), /model --session, cli.fallbackModel, the ! shell escape, /rewind (fork from an earlier turn), and /context (per-skill / per-tool / per-briefing token breakdown).
• Maintenance. Version is now read from each package's own package.json via one version.ts (no more drift); README + BRAINROUTER.md gain an MCP API reference; the brainrouter-docs/ set is current.

Scope

Brain Phases 2-3, the agent transcript debugger, and three 0.4.x infra items (git-worktree isolation, AST-aware chunking, the retrieval benchmark harness) move to 0.4.3 — which leads with fully completing /rewind (file-restore) + /context (context-window header).

Full notes: brainrouter-changelog/0.4.2.md.

Verification

Build clean across all workspaces. Suites green: CLI 858 · brain 365 vitest · 57 node-test, 0 failures. Landed as individually-reviewed PRs #96–#116.

npm packages publish separately.

What's Changed

• docs(roadmap): CLI parity track (0.4.2 → 0.5.0) by @kinqsradio in #95
• feat(0.4.2): cross-vendor delegation (FED-S5) by @kinqsradio in #96
• feat(0.4.2): progressive result handoff (MAS-P5-T2) by @kinqsradio in #97
• feat(0.4.2): delegation-aware memory capture (MAS-P6-T1) by @kinqsradio in #98
• feat(0.4.2): agent-definition packs (MAS-P5-T4) by @kinqsradio in #99
• feat(0.4.2): confidence-scored review fan-out (MAS-P5-T1) by @kinqsradio in #100
• feat(0.4.2): brain provenance + /brain why (MAS-P6-T2) by @kinqsradio in #101
• feat(0.4.2): worker-thread persistence foundation (MAS-P5-T3, part 1) by @kinqsradio in #102
• feat(0.4.2): worker-thread runtime (MAS-P5-T3 part 2) by @kinqsradio in #103
• feat(0.4.2): effort/model parity — xhigh, /model --session, runtime fallback (PARITY-E1/E2/E3) by @kinqsradio in #104
• feat(0.4.2): ! shell escape from the composer (PARITY-B1) by @kinqsradio in #105
• feat(0.4.2): /review --fix + first-class /simplify (PARITY-R1/R2) by @kinqsradio in #106
• feat(0.4.2): durable workflow run engine (PARITY-W1) by @kinqsradio in #107
• feat(0.4.2): /workflows live run viewer (PARITY-W2) by @kinqsradio in #108
• feat(0.4.2): idle background-completion notifications (PARITY-W3) by @kinqsradio in #109
• feat(0.4.2): /effort max as an alias for xhigh by @kinqsradio in #110
• chore(0.4.2): centralize version per package + bump to 0.4.2 by @kinqsradio in #111
• docs(0.4.2): refresh README + BRAINROUTER (with MCP API reference) + brainrouter-docs by @kinqsradio in #112
• feat(0.4.2): /rewind interactive timeline (0.4.x-3) by @kinqsradio in #113
• feat(0.4.2): /context token breakdown (0.4.x-4) by @kinqsradio in #114
• docs(0.4.2): release notes + changelog + roadmap by @kinqsradio in #115
• Release 0.4.2 — Cross-vendor federation + Multi-agent Phases 5-6 + durable workflows + full CLI parity by @kinqsradio in #116

Full Changelog: v0.4.1...v0.4.2