Release-notes corpus for akm help migrate
This directory holds one .md file per release. Each file is the short,
focused migration note that akm help migrate <version> prints to the
terminal. The longform cross-release guides (e.g. v0.5-to-v0.6.md)
live one level up in docs/migration/.
Available notes
- 0.9.19 —
akm improveplanning only the bundle it writes to (a scheduled run needs one--bundlerun per other bundle),akm proposal reopenand the retire-proposal diff, consolidate's coverage check and content-driven hold on decided promotions, distill's grounding check, and what a downgrade to 0.9.18 undoes - 0.9.17 — consolidate's retire proposals and continuity check,
promotions archiving their source memory, declared links replacing the LLM
entity graph, index layout 26, scheduler rows carrying their own context,
and
akm improvescoped to what retrieval actually returns - 0.9.16 — source-bound scheduler grants, local execution authority, config inheritance's portable-data boundary, and split unsafe overrides
- 0.9.15 — exit-code 75 for lease/state.db contention,
--require-enginesscheduled task templates,--no-probecli-version skip, thinking-control wire forms, embedding re-embed safety and cross-rebuild vector salvage, launcher signal forwarding, a default per-document embedding cap, andextendsconfig inheritance - 0.9.14 — index v22-to-v23 derived-cache rebuild, lexical fragments, and collapse-detector canary re-minting
- 0.9.2 — task source v4 migration, workflow source IR v1 and
durable-v4-family
irVersion: 5, command diagnostics, and strategy judgment migration
Adding notes for a new release
- Create
<version>.mdin this directory (e.g.0.7.0.md). - Write plain text — the content is printed verbatim. Start the body
with a line like
Migration notes for akm v0.7.0, then list the automatic migrations, manual actions, publisher changes, etc. - The file ships with the published package via
package.json→files[]and is resolved at runtime from eithersrc/ordist/, so no code change is required. - Link to the longform guide in the last paragraph if one exists.
Keep each note self-contained: it should tell a user everything they need to upgrade without requiring them to open a browser (the longform guide link is the last resort, not the first).