v4.0.0-alpha.60

Breaking changes

Every retired spelling below now exits 2 with the generic parser error. None has an alias or a hint. Every replacement was checked against the parser.

Retired	Use instead	Notes
ak x verify	ak status --refresh=live --only learning,memory-routes,security,aqe,providers,harvest,deja-vu	Named checks run in parallel, each capped at 6 min. ak status --refresh=live alone runs the quick set.
ak x verify all	same as above; add ,mcp for the Codex MCP check	all used to omit mcp
ak x verify learning | security | aqe | providers | harvest | deja-vu | mcp	ak status --refresh=live --only <same name>
ak x verify memory	ak status --refresh=live --only memory-routes	--only memory is the quick round trip, without the route observation
ak status --live	ak status --refresh=live
ak status --deep	ak status, or ak status --refresh to re-probe
ak system --deep	ak system --refresh=machine	add --project-trees to measure project working trees
ak maintain scan	ak maintain --refresh
ak maintain scan --refresh-inventory	ak maintain --refresh
ak maintain scan --deep [--refresh-inventory]	ak maintain --refresh=machine
ak maintain scans start --deep	ak maintain --refresh=machine, then ak maintain scans start
ak maintain plan --deep …	ak maintain --refresh=machine, then ak maintain plan …
ak maintain recipes refresh	none (removed until a recipe registry exists)	recipes list|accept|withdraw remain
POST /api/maintenance/v2/recipes/refresh	none (route removed)
ak host refresh / ak x host refresh	ak host reset-routes / ak x host reset-routes
ak usage prompts --deep	ak usage prompts --show-text
CI: node bin/agentic-kit.mjs x verify <suite>	node bin/agentic-kit.mjs status --refresh=live --only <suite>	memory → memory-routes

Behaviour changes under unchanged spellings:

• Bare ak maintain / ak maintain --json reads the last saved report (verb report); it used to run the provider scan. Add --refresh[=live|machine] to refresh first. --refresh and --project-trees on any other verb, and --only on any maintain verb, are usage errors (exit 2).
• ak status --refresh also refreshes Maintenance evidence and rebuilds the inventory before the local re-check, prints one line per stage, and exits 1 when a stage fails.
• ak system --refresh[=live|machine] runs the same stages and exits 1 on a failed stage.
• ak sync --dry-run performs the online version lookups a real sync performs (network access), records nothing, and uses a temporary npm cache it then removes. Host evidence is still read as last recorded.
• A failed online version lookup keeps the recorded latest version and retries once per TTL window.
• --json failures: a rejected option prints { error, exitCode: 2 } on stdout, with the message and help on stderr (help used to go to stdout). An unreadable kit.json prints { error, exitCode: 1, recovery }.
• ak host pick|off|reset-routes --dry-run preview and write nothing. ak host adapters --dry-run exits 2.
• Live-check evidence is written with source status-refresh-live. Records written by the older live checks still read back, labelled "an earlier live check".
• /api/limits: codexUnavailable.reason can now be host-not-found or host-unconfirmed, meaning Codex was not asked. The field is additive.

(from #263)

What's Changed

• feat(upstream-watch): ledger on an orphan branch, commit-comment notices, on-demand dispatch by @pacphi in #253
• chore(upstream-watch): record the 2026-09-28 closures and replies in the registry by @pacphi in #258
• fix: Branch 9 follow-ups — Discovery restart state, Partial data card, redundant safety copies by @pacphi in #259
• fix: unreliable CLAUDE.md → AGENTS.md prose pointer; issue title standard by @pacphi in #260
• ci: stop every job after 30 minutes by @pacphi in #261
• feat(cli)!: one --refresh[=live|machine] flag for status, system and maintain (ADR-0063) by @pacphi in #263
• docs: one purpose per docs folder, lower-case names, archive point-in-time material by @pacphi in #264
• docs(plans): remediation program v2 — everything left, decisions first by @pacphi in #265
• docs(archive): repair and validate historical links by @pacphi in #266
• chore(deps-dev): bump the npm group across 1 directory with 3 updates by @dependabot[bot] in #251
• fix(ci): bring Windows test matrix under five minutes by @pacphi in #267
• chore(routing): route balanced-tier work to Claude Sonnet 5.5 by @pacphi in #268
• docs: archive completed taxonomy and Sonnet routing plans by @pacphi in #269
• docs(plans): add a Status section convention for in-flight plans by @pacphi in #270

Full Changelog: v4.0.0-alpha.59...v4.0.0-alpha.60