idx-cli/docs
0xrsydn 809966925e docs: keep a CHANGELOG.md, with one entry file per PR
Release notes were written by hand on GitHub at tag time, so the contents
of a stacked release had to be pieced together from every PR, and output
changes that scripts and agents rely on were easy to miss.

- CHANGELOG.md backfills every published release (0.2.0 to 0.4.0) from its
  GitHub notes, verbatim.
- A PR adds changes/unreleased/<branch-name>.md instead of editing
  CHANGELOG.md, so stacked PRs never conflict. changes/README.md gives the
  sections, including Output Changes for JSON, MCP and error-code changes.
- scripts/changelog.sh: `check` validates entries and CHANGELOG.md,
  `release X.Y.Z` folds the entries into a new section (ordered by PR), and
  `notes X.Y.Z` prints a section as GitHub release notes.
- The release workflow sets the GitHub notes from the tag's section.
- New flake check `changelog` runs scripts/changelog-test.sh; both scripts
  are shellchecked.
- Entries for 0.5.0: #73, #74, #75, #78, #79, #80, #81 and this PR.

Claude-Session: https://claude.ai/code/session_01RqPPVeVDrnLoP7NUZmLRxY
2026-11-04 19:48:58 +07:00
..
ARCHITECTURE.md fix: mark only IDX quotes behind the session; test the wiring 2026-10-19 10:26:09 +00:00
CONVENTIONS.md docs: keep a CHANGELOG.md, with one entry file per PR 2026-11-04 19:48:58 +07:00
DESIGN.md chore: release 0.3.0 with idx-mcp 2026-10-14 19:01:29 +00:00
IDX_NEWS.md docs: news sources research: one publisher, Google News, greencloud test 2026-10-16 09:54:30 +00:00
INSTALL.md chore: release 0.5.0 2026-11-03 14:03:32 +07:00
NPM_DISTRIBUTION.md docs: keep a CHANGELOG.md, with one entry file per PR 2026-11-04 19:48:58 +07:00
OWNERSHIP_PUBLISH.md fix(ownership): update syncs when a same-date snapshot is rebuilt 2026-10-14 18:52:13 +00:00
OWNERSHIP_SYNC.md fix(sync): atomic install, stored-row validation, no local artifacts from remote manifests 2026-10-17 12:23:58 +00:00
SMOKE.md docs: keep a CHANGELOG.md, with one entry file per PR 2026-11-04 19:48:58 +07:00