feat: streamline release preparation and changelog checks

Exports the release package list so release prep stages the same versioned files as the bump script.
Validates that CHANGELOG.md contains the target release section before preparing a release.
Updates the suggested release steps to commit only release files and push the tag explicitly.
This commit is contained in:
Bohdan Triapitsyn
2026-09-05 01:26:10 +03:00
parent 74a065fd10
commit f742775be4
2 changed files with 46 additions and 25 deletions
+21 -5
View File
@@ -27,6 +27,7 @@ import os from 'node:os';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { cancel, intro, isCancel, log, outro, select, text } from '@clack/prompts';
import { RELEASE_PACKAGE_FILES } from './bump-version.mjs';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
@@ -173,16 +174,30 @@ function step(label, fn) {
return result;
}
const RELEASE_CHANGELOG_FILES = ['CHANGELOG.md', 'packages/vscode/CHANGELOG.md'];
// Same check the release workflow runs before it publishes, so a missing
// section fails here in seconds instead of after the tag is pushed.
function assertChangelogSection(version) {
const changelogPath = path.join(repoRoot, 'CHANGELOG.md');
if (!existsSync(changelogPath)) {
throw new Error('CHANGELOG.md not found; add it before releasing.');
}
const sections = readFileSync(changelogPath, 'utf8').split(/^## /m);
if (!sections.some((section) => section.startsWith(`[${version}]`))) {
throw new Error(`CHANGELOG.md has no "## [${version}] - YYYY-MM-DD" section. Add it before releasing.`);
}
}
function printReleaseNextSteps(version) {
log.success(`Release v${version} prepared locally`);
log.info('Next steps:');
console.log(` git add -A`);
log.info('Next steps (only the release files are staged, unrelated changes stay out):');
console.log(` git add ${[...RELEASE_PACKAGE_FILES, ...RELEASE_CHANGELOG_FILES].join(' ')}`);
console.log(` git commit -m "release v${version}"`);
console.log(` git tag v${version}`);
console.log(` git push origin main --tags`);
console.log(` git push origin main v${version}`);
console.log('');
console.log('This will trigger the GitHub Actions release workflow.');
console.log(`Make sure CHANGELOG.md contains a section like "## [${version}] - YYYY-MM-DD" before pushing.`);
console.log('Pushing the tag is what starts the GitHub Actions release; pushing main alone does not.');
}
function normalizeAction(action = '') {
@@ -598,6 +613,7 @@ async function createRelease(options) {
}
}
if (!/^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?$/.test(version)) throw new Error('Invalid version format. Use semver, e.g. 1.4.7 or 1.4.7-beta.1');
step('Checking changelog', () => assertChangelogSection(version));
step('Validating codebase', () => run('bun', ['run', 'release:prepare']));
step(`Bumping version to ${version}`, () => run('node', ['scripts/bump-version.mjs', version]));
printReleaseNextSteps(version);