From c311387f72caf76ac4a053ec2aa7241a6e7ad2ba Mon Sep 17 00:00:00 2001
From: Lukas Stracke <lukas.stracke@sentry.io>
Date: Tue, 17 Mar 2026 10:46:06 +0100
Subject: [PATCH] chore: Bump `next` entries in changelog when releasing

---
 package.json                        |   2 +
 scripts/bump_attribute_changelog.ts | 105 ++++++++++++++++++++++++++++
 scripts/craft-pre-release.sh        |   8 +++
 3 files changed, 115 insertions(+)
 create mode 100644 scripts/bump_attribute_changelog.ts

diff --git a/package.json b/package.json
index 52d25bc3..8d6b9939 100644
--- a/package.json
+++ b/package.json
@@ -31,6 +31,8 @@
     "generate": "tsx scripts/generate.ts && yarn format",
     "generate:attribute-changelog": "tsx scripts/generate_attribute_changelog.ts",
 
+    "bump:attribute-changelog": "tsx scripts/bump_attribute_changelog.ts",
+
     "clear:attribute-changelog": "tsx scripts/clear_attribute_changelog.ts --all",
     "clear:attribute-changelog:key": "tsx scripts/clear_attribute_changelog.ts --key",
 
diff --git a/scripts/bump_attribute_changelog.ts b/scripts/bump_attribute_changelog.ts
new file mode 100644
index 00000000..58fdf276
--- /dev/null
+++ b/scripts/bump_attribute_changelog.ts
@@ -0,0 +1,105 @@
+/**
+ * Replaces "next" changelog entries in attribute JSON files with a concrete release version.
+ *
+ * - Scans all JSON files under model/attributes/
+ * - Finds changelog entries with version "next" and replaces them with the given version
+ * - Merges PRs and descriptions if an entry for the target version already exists
+ * - Re-sorts the changelog newest-first
+ * - Called by craft-pre-release.sh before `yarn generate`
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import type { AttributeJson } from './types';
+import { getAllJsonFiles, compareVersions, type ChangelogEntry } from './generate_attribute_changelog';
+
+const SEMVER_RE = /^\d+\.\d+\.\d+$/;
+
+type Changelog = NonNullable<AttributeJson['changelog']>;
+
+function mergeEntries(entries: ChangelogEntry[], targetVersion: string): ChangelogEntry {
+  const prs = new Set<number>();
+  let description: string | undefined;
+
+  for (const entry of entries) {
+    if (entry.prs) {
+      for (const pr of entry.prs) {
+        prs.add(pr);
+      }
+    }
+    if (entry.description) {
+      description = entry.description;
+    }
+  }
+
+  const merged: ChangelogEntry = { version: targetVersion };
+  if (prs.size > 0) {
+    merged.prs = Array.from(prs).sort((a, b) => a - b);
+  }
+  if (description) {
+    merged.description = description;
+  }
+  return merged;
+}
+
+function bumpChangelog(changelog: Changelog, targetVersion: string): Changelog | null {
+  const nextEntries = changelog.filter((e) => e.version === 'next');
+  if (nextEntries.length === 0) {
+    return null;
+  }
+
+  const existingTarget = changelog.find((e) => e.version === targetVersion);
+  const entriesToMerge = existingTarget ? [...nextEntries, existingTarget] : nextEntries;
+  const merged = mergeEntries(entriesToMerge, targetVersion);
+
+  const remaining = changelog.filter((e) => e.version !== 'next' && e.version !== targetVersion);
+  remaining.push(merged);
+  remaining.sort((a, b) => compareVersions(b.version, a.version));
+
+  return remaining;
+}
+
+async function bumpNextChangelog(targetVersion: string): Promise<void> {
+  const attributesDir = path.join(__dirname, '..', 'model', 'attributes');
+  const files = await getAllJsonFiles(attributesDir);
+  let updatedCount = 0;
+
+  for (const relativeFile of files) {
+    const filePath = path.join(attributesDir, relativeFile);
+    const content = await fs.promises.readFile(filePath, 'utf-8');
+    const json: AttributeJson = JSON.parse(content);
+
+    if (!json.changelog || !json.changelog.length) {
+      continue;
+    }
+
+    const bumped = bumpChangelog(json.changelog, targetVersion);
+    if (!bumped) {
+      continue;
+    }
+
+    json.changelog = bumped;
+    await fs.promises.writeFile(filePath, `${JSON.stringify(json, null, 2)}\n`, 'utf-8');
+    updatedCount++;
+  }
+
+  console.log(`Bumped "next" to "${targetVersion}" in ${updatedCount} attribute file(s).`);
+}
+
+const targetVersion = process.argv[2];
+
+if (!targetVersion) {
+  console.error('Usage: tsx scripts/bump_attribute_changelog.ts <version>');
+  console.error('Example: tsx scripts/bump_attribute_changelog.ts 0.2.0');
+  process.exit(1);
+}
+
+if (!SEMVER_RE.test(targetVersion)) {
+  console.error(`Invalid version format: "${targetVersion}". Expected X.Y.Z (e.g. 0.2.0)`);
+  process.exit(1);
+}
+
+bumpNextChangelog(targetVersion).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
diff --git a/scripts/craft-pre-release.sh b/scripts/craft-pre-release.sh
index 66d3a4f0..f93cbe2f 100644
--- a/scripts/craft-pre-release.sh
+++ b/scripts/craft-pre-release.sh
@@ -9,6 +9,14 @@ NEW_VERSION="${2}"
 echo "Current version: $OLD_VERSION"
 echo "Bumping to version: $NEW_VERSION"
 
+# ==================== Attribute Changelogs ====================
+
+cd $ROOT_DIR
+
+npx tsx scripts/bump_attribute_changelog.ts "${NEW_VERSION}"
+
+yarn generate
+
 # ==================== JS ====================
 
 cd $ROOT_DIR