feat(changelog): one source file per release, generated outputs

Release notes now live in changelog/<version>.md (front matter with version and date, then ## App and ## VS Code sections grouped into New, Improvements, Fixes, Misc) plus changelog/unreleased.md for what has not shipped. `bun run changelog:build` renders CHANGELOG.md, packages/vscode/CHANGELOG.md, and changelog/index.json from them; `changelog:check` fails when the outputs are behind and runs in CI and in release:prepare. `oc-dev create-release` promotes unreleased.md to the versioned file dated today and rebuilds. The existing history was split mechanically: every bullet kept, sorted into groups by keyword, five hand-typed headers with one-digit days normalised to YYYY-MM-DD (the update dialog matched none of them). The generated files keep today's release headers, which the update dialog, the release workflow, and the website match by regex. Claude-Session: https://claude.ai/code/session_01VqV56Hez25hTxXH4ipJfzH
2026-09-05 15:58:23 +03:00
parent bc2513f410
commit d9b9c8edab
153 changed files with 11977 additions and 700 deletions
@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// Render the changelog outputs from `changelog/*.md`.
+//
+//   node scripts/changelog/build.mjs                 write CHANGELOG.md, packages/vscode/CHANGELOG.md, changelog/index.json
+//   node scripts/changelog/build.mjs --check         exit 1 when any output differs from what is committed
+//   node scripts/changelog/build.mjs --release 1.2.3 [--date YYYY-MM-DD]
+//                                                    move unreleased.md to 1.2.3.md (dated today by default), then write
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { loadReleases, promoteUnreleased, renderOutputs } from './lib.mjs';
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+const changelogDirectory = path.join(repoRoot, 'changelog');
+
+const args = process.argv.slice(2);
+const readFlag = (name) => {
+  const index = args.indexOf(name);
+  return index >= 0 ? args[index + 1] ?? null : null;
+};
+const check = args.includes('--check');
+const releaseVersion = readFlag('--release');
+
+try {
+  if (releaseVersion) {
+    const date = readFlag('--date') ?? new Date().toISOString().slice(0, 10);
+    const created = promoteUnreleased(changelogDirectory, releaseVersion, date);
+    console.log(`Promoted changelog/unreleased.md to ${path.relative(repoRoot, created)}`);
+  }
+
+  const outputs = renderOutputs(loadReleases(changelogDirectory));
+  const stale = [];
+  for (const [relativePath, content] of Object.entries(outputs)) {
+    const target = path.join(repoRoot, relativePath);
+    const current = fs.existsSync(target) ? fs.readFileSync(target, 'utf8') : null;
+    if (current === content) continue;
+    if (check) {
+      stale.push(relativePath);
+      continue;
+    }
+    fs.writeFileSync(target, content);
+    console.log(`Wrote ${relativePath}`);
+  }
+  if (check && stale.length > 0) {
+    console.error(`Generated changelog files are out of date: ${stale.join(', ')}. Run "bun run changelog:build" and commit the result.`);
+    process.exit(1);
+  }
+  if (check) console.log('Changelog outputs are up to date.');
+} catch (error) {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}