akm-cli/docs/migration/release-notes/README.md

akm (Agent Knowledge Manager) — a portable, local-first capability library for AI agents. Discover, load, share, and improve reusable skills, scripts, workflows, and knowledge across any shell-capable coding agent, including Claude Code, OpenCode, and Cur

# 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](0.9.19.md) — `akm improve` planning only the bundle it writes to
  (a scheduled run needs one `--bundle` run per other bundle),
  `akm proposal reopen` and 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](0.9.17.md) — 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 improve` scoped to what retrieval actually returns
- [0.9.16](0.9.16.md) — source-bound scheduler grants, local execution
  authority, config inheritance's portable-data boundary, and split unsafe
  overrides
- [0.9.15](0.9.15.md) — exit-code 75 for lease/state.db contention,
  `--require-engines` scheduled task templates, `--no-probe` cli-version
  skip, thinking-control wire forms, embedding re-embed safety and
  cross-rebuild vector salvage, launcher signal forwarding, a default
  per-document embedding cap, and `extends` config inheritance
- [0.9.14](0.9.14.md) — index v22-to-v23 derived-cache rebuild, lexical
  fragments, and collapse-detector canary re-minting
- [0.9.2](0.9.2.md) — 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

1. Create `<version>.md` in this directory (e.g. `0.7.0.md`).
2. 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.
3. The file ships with the published package via `package.json` →
   `files[]` and is resolved at runtime from either `src/` or `dist/`,
   so no code change is required.
4. 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).