feat: add AI-powered release notes for stable releases

caio-pizzol · caio-pizzol · commit 63e8300ada51 · 2026-03-21T21:08:25.000-03:00
Install semantic-release-ai-notes and configure all 8 packages to use
AI-generated release notes on stable branch, falling back to the
conventional generator on prerelease (main/next).

- Add semantic-release-ai-notes ^0.2.3 to pnpm catalog
- Conditionally swap notes plugin based on isPrerelease in each .releaserc.cjs
- Add ANTHROPIC_API_KEY to all release workflow env blocks
diff --git a/.github/workflows/release-cli.yml b/.github/workflows/release-cli.yml
@@ -88,5 +88,6 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         working-directory: apps/cli
         run: pnpx semantic-release
diff --git a/.github/workflows/release-esign.yml b/.github/workflows/release-esign.yml
@@ -57,5 +57,6 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         working-directory: packages/esign
         run: pnpx semantic-release
diff --git a/.github/workflows/release-mcp.yml b/.github/workflows/release-mcp.yml
@@ -66,5 +66,6 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         working-directory: apps/mcp
         run: pnpx semantic-release
diff --git a/.github/workflows/release-react.yml b/.github/workflows/release-react.yml
@@ -57,5 +57,6 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         working-directory: packages/react
         run: pnpx semantic-release
diff --git a/.github/workflows/release-sdk.yml b/.github/workflows/release-sdk.yml
@@ -110,6 +110,7 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         working-directory: packages/sdk
         run: pnpx semantic-release
 
diff --git a/.github/workflows/release-superdoc.yml b/.github/workflows/release-superdoc.yml
@@ -83,5 +83,6 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         working-directory: packages/superdoc
         run: pnpx semantic-release
diff --git a/.github/workflows/release-template-builder.yml b/.github/workflows/release-template-builder.yml
@@ -57,5 +57,6 @@ jobs:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
         working-directory: packages/template-builder
         run: pnpx semantic-release
diff --git a/.github/workflows/release-vscode-ext.yml b/.github/workflows/release-vscode-ext.yml
@@ -55,3 +55,4 @@ jobs:
           GITHUB_TOKEN: ${{ steps.generate_token.outputs.token }}
           VSCE_PAT: ${{ secrets.VSCE_PAT }}
           LINEAR_TOKEN: ${{ secrets.LINEAR_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
diff --git a/apps/cli/.releaserc.cjs b/apps/cli/.releaserc.cjs
@@ -21,15 +21,26 @@ require('../../scripts/semantic-release/patch-commit-filter.cjs')([
 
 const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH;
 
+const branches = [
+  { name: 'stable', channel: 'latest' },
+  { name: 'main', prerelease: 'next', channel: 'next' },
+];
+
+const isPrerelease = branches.some(
+  (b) => typeof b === 'object' && b.name === branch && b.prerelease,
+);
+
+// Use AI-powered notes for stable releases, conventional generator for prereleases
+const notesPlugin = isPrerelease
+  ? '@semantic-release/release-notes-generator'
+  : ['semantic-release-ai-notes', { style: 'concise' }];
+
 const config = {
-  branches: [
-    { name: 'stable', channel: 'latest' },
-    { name: 'main', prerelease: 'next', channel: 'next' },
-  ],
+  branches,
   tagFormat: 'cli-v${version}',
   plugins: [
     '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
+    notesPlugin,
     ['@semantic-release/npm', { npmPublish: false }],
     [
       '@semantic-release/exec',
@@ -41,10 +52,6 @@ const config = {
   ],
 };
 
-const isPrerelease = config.branches.some(
-  (b) => typeof b === 'object' && b.name === branch && b.prerelease,
-);
-
 if (!isPrerelease) {
   config.plugins.push([
     '@semantic-release/git',
diff --git a/apps/mcp/.releaserc.cjs b/apps/mcp/.releaserc.cjs
@@ -1,22 +1,29 @@
 /* eslint-env node */
 const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH;
 
+const branches = [
+  { name: 'stable', channel: 'latest' },
+  { name: 'main', prerelease: 'next', channel: 'next' },
+];
+
+const isPrerelease = branches.some((b) => typeof b === 'object' && b.name === branch && b.prerelease);
+
+// Use AI-powered notes for stable releases, conventional generator for prereleases
+const notesPlugin = isPrerelease
+  ? '@semantic-release/release-notes-generator'
+  : ['semantic-release-ai-notes', { style: 'concise' }];
+
 const config = {
-  branches: [
-    { name: 'stable', channel: 'latest' },
-    { name: 'main', prerelease: 'next', channel: 'next' },
-  ],
+  branches,
   tagFormat: 'mcp-v${version}',
   plugins: [
     'semantic-release-commit-filter',
     '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
+    notesPlugin,
     ['@semantic-release/npm'],
   ],
 };
 
-const isPrerelease = config.branches.some((b) => typeof b === 'object' && b.name === branch && b.prerelease);
-
 if (!isPrerelease) {
   config.plugins.push([
     '@semantic-release/git',
diff --git a/apps/vscode-ext/.releaserc.cjs b/apps/vscode-ext/.releaserc.cjs
@@ -1,22 +1,29 @@
 /* eslint-env node */
 const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH;
 
+const branches = [
+  { name: 'stable', channel: 'latest' },
+  { name: 'main', prerelease: 'next', channel: 'next' },
+];
+
+const isPrerelease = branches.some((b) => typeof b === 'object' && b.name === branch && b.prerelease);
+
+// Use AI-powered notes for stable releases, conventional generator for prereleases
+const notesPlugin = isPrerelease
+  ? '@semantic-release/release-notes-generator'
+  : ['semantic-release-ai-notes', { style: 'concise' }];
+
 const config = {
-  branches: [
-    { name: 'stable', channel: 'latest' },
-    { name: 'main', prerelease: 'next', channel: 'next' },
-  ],
+  branches,
   tagFormat: 'vscode-v${version}',
   plugins: [
     'semantic-release-commit-filter',
     '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
+    notesPlugin,
     ['@semantic-release/npm', { npmPublish: false }], // Version bump only, no npm publish
   ],
 };
 
-const isPrerelease = config.branches.some((b) => typeof b === 'object' && b.name === branch && b.prerelease);
-
 // VS Code Marketplace doesn't support semver prerelease versions (e.g., 0.0.1-next.1)
 // Only publish stable releases to marketplace; prereleases get GitHub release with .vsix attached
 if (isPrerelease) {
diff --git a/package.json b/package.json
@@ -111,6 +111,7 @@
     "lefthook": "catalog:",
     "prettier": "catalog:",
     "semantic-release": "catalog:",
+    "semantic-release-ai-notes": "catalog:",
     "semantic-release-commit-filter": "catalog:",
     "semantic-release-linear-app": "catalog:",
     "semantic-release-pnpm": "^1.0.2",
diff --git a/packages/esign/.releaserc.cjs b/packages/esign/.releaserc.cjs
@@ -1,24 +1,31 @@
 /* eslint-env node */
 const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH;
 
+const branches = [
+  { name: 'stable', channel: 'latest' },
+  { name: 'main', prerelease: 'next', channel: 'next' },
+];
+
+const isPrerelease = branches.some(
+  (b) => typeof b === 'object' && b.name === branch && b.prerelease
+);
+
+// Use AI-powered notes for stable releases, conventional generator for prereleases
+const notesPlugin = isPrerelease
+  ? '@semantic-release/release-notes-generator'
+  : ['semantic-release-ai-notes', { style: 'concise' }];
+
 const config = {
-  branches: [
-    { name: 'stable', channel: 'latest' },
-    { name: 'main', prerelease: 'next', channel: 'next' },
-  ],
+  branches,
   tagFormat: 'esign-v${version}',
   plugins: [
     'semantic-release-commit-filter',
     '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
+    notesPlugin,
     ['@semantic-release/npm', { npmPublish: true }],
   ],
 };
 
-const isPrerelease = config.branches.some(
-  (b) => typeof b === 'object' && b.name === branch && b.prerelease
-);
-
 if (!isPrerelease) {
   config.plugins.push([
     '@semantic-release/git',
diff --git a/packages/react/.releaserc.cjs b/packages/react/.releaserc.cjs
@@ -1,25 +1,32 @@
 /* eslint-env node */
 const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH;
 
+const branches = [
+  { name: 'stable', channel: 'latest' },
+  { name: 'main', prerelease: 'next', channel: 'next' },
+];
+
+const isPrerelease = branches.some(
+  (b) => typeof b === 'object' && b.name === branch && b.prerelease
+);
+
+// Use AI-powered notes for stable releases, conventional generator for prereleases
+const notesPlugin = isPrerelease
+  ? '@semantic-release/release-notes-generator'
+  : ['semantic-release-ai-notes', { style: 'concise' }];
+
 const config = {
-  branches: [
-    { name: 'stable', channel: 'latest' },
-    { name: 'main', prerelease: 'next', channel: 'next' },
-  ],
+  branches,
   tagFormat: 'react-v${version}',
   plugins: [
     'semantic-release-commit-filter',
     '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
+    notesPlugin,
     ['semantic-release-pnpm', { npmPublish: false }],
     '../../scripts/publish-react.cjs',
   ],
 };
 
-const isPrerelease = config.branches.some(
-  (b) => typeof b === 'object' && b.name === branch && b.prerelease
-);
-
 if (!isPrerelease) {
   config.plugins.push([
     '@semantic-release/git',
diff --git a/packages/sdk/.releaserc.cjs b/packages/sdk/.releaserc.cjs
@@ -20,15 +20,26 @@ require('../../scripts/semantic-release/patch-commit-filter.cjs')([
 
 const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH;
 
+const branches = [
+  { name: 'stable', channel: 'latest' },
+  { name: 'main', prerelease: 'next', channel: 'next' },
+];
+
+const isPrerelease = branches.some(
+  (b) => typeof b === 'object' && b.name === branch && b.prerelease,
+);
+
+// Use AI-powered notes for stable releases, conventional generator for prereleases
+const notesPlugin = isPrerelease
+  ? '@semantic-release/release-notes-generator'
+  : ['semantic-release-ai-notes', { style: 'concise' }];
+
 const config = {
-  branches: [
-    { name: 'stable', channel: 'latest' },
-    { name: 'main', prerelease: 'next', channel: 'next' },
-  ],
+  branches,
   tagFormat: 'sdk-v${version}',
   plugins: [
     '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
+    notesPlugin,
     // Version bump only — actual publishing is handled by exec
     ['@semantic-release/npm', { npmPublish: false }],
     [
@@ -50,10 +61,6 @@ const config = {
   ],
 };
 
-const isPrerelease = config.branches.some(
-  (b) => typeof b === 'object' && b.name === branch && b.prerelease,
-);
-
 // On prerelease (main), PyPI is handled by GHA OIDC — keep --npm-only.
 // On stable (local release), sdk-release-publish.mjs uploads to PyPI via twine.
 const execPlugin = config.plugins.find(
diff --git a/packages/superdoc/.releaserc.cjs b/packages/superdoc/.releaserc.cjs
@@ -38,27 +38,38 @@ Object.keys(require.cache)
 
 const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH
 
+const branches = [
+  {
+    name: 'stable',
+    channel: 'latest', // Only stable gets @latest
+  },
+  {
+    name: 'main',
+    channel: 'next',
+    prerelease: 'next',
+  },
+  // Maintenance branches - channel defaults to branch name
+  {
+    name: '+([0-9])?(.{+([0-9]),x}).x',
+    // No channel specified - defaults to branch name (0.8.x, 1.2.x, etc)
+  },
+]
+
+const isPrerelease = branches.some(
+  (b) => typeof b === 'object' && b.name === branch && b.prerelease
+)
+
+// Use AI-powered notes for stable releases, conventional generator for prereleases
+const notesPlugin = isPrerelease
+  ? '@semantic-release/release-notes-generator'
+  : ['semantic-release-ai-notes', { style: 'concise' }]
+
 const config = {
-  branches: [
-    {
-      name: 'stable',
-      channel: 'latest', // Only stable gets @latest
-    },
-    {
-      name: 'main',
-      channel: 'next',
-      prerelease: 'next',
-    },
-    // Maintenance branches - channel defaults to branch name
-    {
-      name: '+([0-9])?(.{+([0-9]),x}).x',
-      // No channel specified - defaults to branch name (0.8.x, 1.2.x, etc)
-    },
-  ],
+  branches,
   tagFormat: 'v${version}',
   plugins: [
     '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
+    notesPlugin,
     // NPM plugin MUST come before git plugin
     [
       'semantic-release-pnpm',
@@ -71,9 +82,6 @@ const config = {
 }
 
 // Only add changelog and git plugins for non-prerelease branches
-const isPrerelease = config.branches.some(
-  (b) => typeof b === 'object' && b.name === branch && b.prerelease
-)
 
 if (!isPrerelease) {
   // Git plugin commits the version bump back to the branch.
diff --git a/packages/template-builder/.releaserc.cjs b/packages/template-builder/.releaserc.cjs
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
