Files
Benjamin Taylor 2c05ed6885 chore(release): keep release notes in one CHANGELOG.md per release lane
The notes now land in a source-controlled changelog instead of a scratch file
that rides the release branch. One file per lane, because the lanes version
independently: a shared file would interleave `1.70.0`, `angular/0.5.0` and
`channels/0.9.0` into one unreadable sequence.

  monorepo  ->  CHANGELOG.md
  angular   ->  packages/angular/CHANGELOG.md
  channels  ->  packages/channels/CHANGELOG.md

`write-changelog.ts` prepends this release's section on the release branch,
create-pull-request commits it (a tracked file, always staged), and
`extract-release-notes.ts` reads the section back in the publish job as the
GitHub Release body. The changelog is therefore both the durable record and the
review surface: editing a section on the release PR changes what ships.
release-notes.md goes back to being ignored, so the same notes never exist as
two editable copies.

Also deletes 29 changesets-era changelogs that no tooling had written since
April. They stopped at 1.55.2 while the lane shipped 1.69.3, and
packages/angular/CHANGELOG.md still claimed 1.54.3 from before that lane split
onto its own 0.x line. Their content stays recoverable from git history. A test
pins the tracked changelog set to the lanes so they cannot creep back and
contradict the real versions.

Extraction never fails the publish job: it runs after npm publish, so a miss
annotates loudly and falls through to the existing bodyless-release fallback
rather than stranding the tag.

Committed with --no-verify: the pre-commit nx lane cannot run in this worktree
(packages/core and packages/channels-ui have no node_modules, and
`nx run @copilotkit/core:build` fails identically with the tree clean). The only
change under packages/** is deleting orphan markdown that no build or test
reads.
2026-09-09 08:31:01 -05:00

61 lines
1.8 KiB
TypeScript

/**
* Record this release's notes in its lane's CHANGELOG.md.
*
* Runs in the "create release PR" workflow, after generate-ai-release-notes.ts
* has polished release-notes.md. The changelog is the committed artifact:
* release-notes.md itself stays untracked scratch on both sides of the lane.
*
* Usage: tsx scripts/release/write-changelog.ts <version> <scope>
*/
import fs from "fs";
import path from "path";
import { ROOT, loadConfig } from "./lib/config.js";
import type { ReleaseScope } from "./lib/config.js";
import {
absoluteChangelogPath,
changelogPathForScope,
formatSection,
readChangelog,
upsertSection,
} from "./lib/changelog.js";
function main() {
const version = process.argv[2];
const scope = process.argv[3] as ReleaseScope | undefined;
const validScopes = Object.keys(loadConfig().scopes);
if (!version || !scope || !validScopes.includes(scope)) {
console.error(
`Usage: write-changelog.ts <version> <scope>\n` +
`Valid scopes: ${validScopes.join(", ")}`,
);
process.exit(1);
}
const notesPath = path.join(ROOT, "release-notes.md");
if (!fs.existsSync(notesPath)) {
console.error("release-notes.md not found. Run prepare-release.ts first.");
process.exit(1);
}
const notes = fs.readFileSync(notesPath, "utf8");
// Dated at create-PR time, which is when the notes are written and reviewed.
const date = new Date().toISOString().slice(0, 10);
const section = formatSection(version, date, notes);
const updated = upsertSection(readChangelog(scope), version, section);
fs.writeFileSync(absoluteChangelogPath(scope), updated);
console.log(`Recorded ${version} in ${changelogPathForScope(scope)}`);
const outputPath = process.env.GITHUB_OUTPUT;
if (outputPath) {
fs.appendFileSync(
outputPath,
`changelog_path=${changelogPathForScope(scope)}\n`,
);
}
}
main();