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

64 lines
1.9 KiB
TypeScript

/**
* Read this release's section out of its lane's CHANGELOG.md and write it to
* release-notes.md, which the publish workflow uses as the GitHub Release body.
*
* Runs in the publish job, AFTER npm publish. It therefore never exits non-zero:
* failing here would leave the packages published but the tag unpushed. A miss
* is annotated loudly instead, and the workflow's own fallback puts
* `Release <tag>` in the body.
*
* Usage: tsx scripts/release/extract-release-notes.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 {
changelogPathForScope,
extractSection,
readChangelog,
} from "./lib/changelog.js";
function annotate(message: string): void {
console.log(`::error title=Release notes::${message}`);
}
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)) {
annotate(
`extract-release-notes.ts needs <version> <scope>, got "${version}" "${scope}". ` +
`The GitHub Release will fall back to a bodyless "Release <tag>".`,
);
return;
}
let body: string | null = null;
try {
body = extractSection(readChangelog(scope), version);
} catch (error: any) {
annotate(`${error.message} Falling back to a bodyless release.`);
return;
}
if (!body) {
annotate(
`No section for ${version} in ${changelogPathForScope(scope)}. The release PR ` +
`should have added one — the GitHub Release will fall back to a bodyless ` +
`"Release <tag>".`,
);
return;
}
fs.writeFileSync(path.join(ROOT, "release-notes.md"), `${body}\n`);
console.log(
`Release body written to release-notes.md from ${changelogPathForScope(scope)} (${body.length} chars)`,
);
}
main();