feat: implement Anthropic release notes action and auto-release workflow

Author: dkattan

.github/actions/anthropic-release-notes/action.yml

@@ -0,0 +1,24 @@
+name: 'anthropic-release-notes'
+description: 'Generate release notes with Anthropic Claude from commits since the last release'
+author: 'Copilot Breakpoint Debugger'
+inputs:
+  anthropic-api-key:
+    description: 'Anthropic API Key'
+    required: true
+  language:
+    description: 'Language for release notes (default en)'
+    required: false
+    default: 'en'
+  model:
+    description: 'Anthropic model name (default claude-3-5-sonnet-latest)'
+    required: false
+    default: 'claude-3-5-sonnet-latest'
+  token:
+    description: 'GitHub token for API calls'
+    required: true
+  version:
+    description: 'Release version (tag) to create'
+    required: true
+runs:
+  using: 'node20'
+  main: 'index.js'

.github/actions/anthropic-release-notes/index.js

@@ -0,0 +1,124 @@
+const { getInput, setFailed, info, setOutput } = require('@actions/core');
+const { context, getOctokit } = require('@actions/github');
+const { Anthropic } = require('@anthropic-ai/sdk');
+
+function parseInputs() {
+  const anthropicApiKey = getInput('anthropic-api-key');
+  const language = getInput('language');
+  const model = getInput('model');
+  const token = getInput('token');
+  const version = getInput('version');
+  return { anthropicApiKey, language, model, token, version };
+}
+
+async function getPRsFromCommit(octokit, sha) {
+  try {
+    const pr = await octokit.rest.repos.listPullRequestsAssociatedWithCommit({
+      owner: context.repo.owner,
+      repo: context.repo.repo,
+      commit_sha: sha,
+    });
+    return pr.data.map(p => ({ label: `#${p.number}`, url: p.html_url }));
+  } catch (e) {
+    info(`Failed to fetch PRs for commit ${sha}: ${e.message}`);
+    return [];
+  }
+}
+
+function buildPrompt(language, commitsData) {
+  return [
+    'You are a DEV OPS engineer; write a concise changelog for the new software version.',
+    'The changelog lists new features (use verb "Add"), changes/improvements/updates (also start with "Add"), and bug fixes (start lines with "Fix").',
+    'Order sections: features/changes first, then fixes.',
+    'Format exactly as:\n```\n## What\'s Changed\n- Add <feature/change>\n- Fix <bug>\n```',
+    'Do not invent items. Use ONLY the following commit data (message, author, PRs).',
+    'If no features or fixes are present, provide a minimal placeholder like "- Add internal refactors".',
+    `Return output in language: ${language}. Translate commit-derived content.`,
+    'Commit data JSON follows:',
+    JSON.stringify(commitsData, null, 2),
+  ].join('\n');
+}
+
+async function run() {
+  info('Running Anthropic release notes action');
+  const { anthropicApiKey, language, model, token, version } = parseInputs();
+  const octokit = getOctokit(token);
+
+  // Gather commits since last release
+  let latestRelease = null;
+  try {
+    latestRelease = await octokit.rest.repos.getLatestRelease({ owner: context.repo.owner, repo: context.repo.repo });
+  } catch (e) {
+    info(`No previous release found; using all recent commits (${e.message})`);
+  }
+
+  let commits = [];
+  try {
+    if (latestRelease) {
+      const base = latestRelease.data.tag_name;
+      const compare = await octokit.rest.repos.compareCommits({
+        owner: context.repo.owner,
+        repo: context.repo.repo,
+        base,
+        head: context.sha,
+      });
+      commits = compare.data.commits;
+    } else {
+      // fallback: list recent commits (first page)
+      const list = await octokit.rest.repos.listCommits({ owner: context.repo.owner, repo: context.repo.repo, per_page: 100 });
+      commits = list.data;
+    }
+  } catch (error) {
+    return setFailed(`Failed to gather commits: ${error.message || 'unknown error'}`);
+  }
+
+  if (!commits.length) {
+    return setFailed('No commits found to generate release notes');
+  }
+
+  // Build commit data with PR associations
+  const commitsStructured = [];
+  for (const c of commits) {
+    const prs = await getPRsFromCommit(octokit, c.sha);
+    commitsStructured.push({
+      sha: c.sha,
+      message: c.commit?.message,
+      author: c.author?.login || c.commit?.author?.name || 'unknown',
+      authorUrl: c.author?.html_url || null,
+      prs,
+    });
+  }
+
+  const prompt = buildPrompt(language || 'en', commitsStructured);
+
+  try {
+    const anthropic = new Anthropic({ apiKey: anthropicApiKey });
+    const completion = await anthropic.messages.create({
+      model: model || 'claude-3-5-sonnet-latest',
+      max_tokens: 800,
+      messages: [ { role: 'user', content: prompt } ],
+    });
+
+    const contentBlock = completion.content && completion.content[0];
+    const responseText = contentBlock && contentBlock.text ? contentBlock.text : null;
+    if (!responseText) {
+      throw new Error('Anthropic did not return content');
+    }
+
+    // Create release
+    await octokit.rest.repos.createRelease({
+      owner: context.repo.owner,
+      repo: context.repo.repo,
+      tag_name: version,
+      name: version,
+      body: responseText,
+    });
+
+    setOutput('releaseNotes', responseText);
+    info('Release created successfully.');
+  } catch (error) {
+    setFailed(error.message || 'Failed to generate release notes');
+  }
+}
+
+run();

.github/workflows/auto-release.yml

@@ -0,0 +1,85 @@
+name: Auto Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+concurrency:
+  group: auto-release
+  cancel-in-progress: false
+
+jobs:
+  auto-release:
+    if: ${{ !contains(github.event.head_commit.message, '[skip ci]') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # ensure tags are fetched
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Determine next version
+        id: version
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const latestRelease = await github.rest.repos.getLatestRelease({ owner: context.repo.owner, repo: context.repo.repo }).catch(()=>null);
+            let nextVersion;
+            if (latestRelease) {
+              const prevTagRaw = latestRelease.data.tag_name || '';
+              const prev = prevTagRaw.replace(/^v/, '');
+              const parts = prev.split('.');
+              if (parts.length !== 3 || parts.some(p => isNaN(Number(p)))) {
+                core.setFailed(`Latest release tag '${prevTagRaw}' is not semver x.y.z`);
+                return;
+              }
+              parts[2] = String(Number(parts[2]) + 1);
+              nextVersion = parts.join('.');
+            } else {
+              nextVersion = '0.0.1';
+            }
+            core.info(`Computed next version: ${nextVersion}`);
+            core.setOutput('version', nextVersion);
+
+      - name: Update package.json version
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          node -e "const fs=require('fs'); const pkg=JSON.parse(fs.readFileSync('package.json','utf8')); pkg.version=process.env.VERSION; pkg._versionComment='Version is auto-generated by the CI auto-release workflow. Manual edits are overwritten.'; fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2)+ '\n');"
+          git config user.name "github-actions"
+          git config user.email "[email protected]"
+          git add package.json
+          git commit -m "chore: release ${VERSION} [skip ci]" || echo "No changes to commit"
+
+      - name: Create and push tag
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
+        run: |
+          if git rev-parse ${VERSION} >/dev/null 2>&1; then echo "Tag ${VERSION} already exists"; else git tag ${VERSION}; git push origin ${VERSION}; fi
+          git push origin HEAD:main
+
+      - name: Generate release notes & create release
+        uses: ./.github/actions/anthropic-release-notes
+        with:
+          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          language: en
+          model: claude-3-5-sonnet-latest
+          token: ${{ secrets.GITHUB_TOKEN }}
+          version: ${{ steps.version.outputs.version }}
+
+      - name: Output release notes
+        if: steps.version.outputs.version
+        run: echo "Release notes generated for version ${{ steps.version.outputs.version }}"

.prettierignore

@@ -15,4 +15,6 @@ node_modules/
 package-lock.json
 
 # Generated files
-*.d.ts
+*.d.ts
+
+*.md

eslint.config.mjs

@@ -131,6 +131,6 @@ export default antfu(
   },
   // Ignore large external vendor/source trees not meant for linting in this extension
   {
-    ignores: ['external/**', 'coverage/**', 'out/**'],
+    ignores: ['external/**', 'coverage/**', 'out/**', '.github/workflows/**', '.github/actions/**'],
   }
 );

package.json

@@ -3,6 +3,7 @@
   "name": "copilot-breakpoint-debugger",
   "displayName": "Copilot Breakpoint Debugger",
   "version": "0.0.21",
+  "_versionComment": "Version is auto-generated by the CI auto-release workflow. Manual edits to 'version' will be overwritten.",
   "description": "Use GitHub Copilot to automate starting, inspecting and resuming VS Code debug sessions with conditional breakpoints, exact numeric hit counts (hitCount), logpoints, and capture actions that interpolate variables inside log messages.",
   "preview": true,
   "license": "MIT",
@@ -419,6 +420,7 @@
     "format:check": "prettier --check ."
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.27.3",
     "@vscode/prompt-tsx": "^0.4.0-alpha.5",
     "mocha": "^10.7.3"
   },