feat: add LLM-generated release notes for GitHub releases

[jdx]

Summary

Adds LLM-generated release notes for GitHub releases while keeping CHANGELOG.md using raw git-cliff output.

Changes

1. New scripts/gen-release-notes.sh: Generates rich user-friendly release notes using Claude Code for GitHub releases
2. Updated tasks/release-plz: Uses raw git-cliff for CHANGELOG.md (no LLM generation)
3. Updated publish-cli.yml:
   • Added fetch-depth: 0 for full git history
   • Calls gen-release-notes for GitHub releases with fallback to CHANGELOG.md
4. PR body: Strips version header since PR title already has version

How it works

1. release-plz generates a release PR with raw git-cliff changelog
2. After merging, when publishing the release, the workflow:
   • Calls gen-release-notes to generate rich LLM notes
   • Falls back to CHANGELOG.md if LLM fails
   • Creates GitHub release with the notes

Error Handling

• Verbose logging before Claude call (version, prev_version, changelog length)
• Stderr captured separately to avoid polluting output
• Non-empty output validation
• Automatic fallback to CHANGELOG.md on any failure

Security

The Claude Code agent is sandboxed with --allowedTools "Read,Grep,Glob" (no Bash, Edit, Write).

Test plan

• Test release-plz dry run
• Test gen-release-notes with a tag range
• Verify workflow generates correct release notes

🤖 Generated with Claude Code

---

Note

Enhances robustness of scripts/gen-release-notes.sh to keep release notes output clean and actionable.

• Captures Claude CLI stderr to a temp file via mktemp and cleans it up with a trap
• Redirects Claude stderr to the file and prints it only on failure or empty output
• Removes noisy error echoing and adds non-empty output validation before emitting notes

^{Written by Cursor Bugbot for commit 05207e1. This will update automatically on new commits. Configure here.}

[Copilot]

Pull request overview

This PR adds LLM-generated release notes for GitHub releases while maintaining the existing raw git-cliff output in CHANGELOG.md. The key change is separating changelog generation for repository history from rich, user-friendly release notes for GitHub releases.

Changes:

• New script gen-release-notes.sh generates enhanced release notes using Claude Code API
• Updated release workflow to generate LLM notes with fallback to CHANGELOG.md
• Modified release-plz task to use raw git-cliff for PR body and strip version headers

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
scripts/gen-release-notes.sh	New script that calls Claude API to generate user-friendly release notes from git-cliff changelog
tasks/release-plz	Updated to use raw git-cliff output and strip version headers from PR body
.github/workflows/publish-cli.yml	Added Claude CLI installation, LLM release notes generation with fallback logic

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The ANTHROPIC_API_KEY secret is only used in the conditional check at line 39 but not passed to the gen-release-notes.sh script execution. The script won't have access to the API key needed for the Claude CLI call. Add the ANTHROPIC_API_KEY to the environment when executing the gen-release-notes.sh script.

[Copilot]

String comparison with command substitution can fail if the command output contains special characters or whitespace. Use -z test with command substitution or check the exit code. Replace with: if ! gh pr list --label release --json number -q '.[0].number' &>/dev/null; then

Suggested change

	if [[ "$(gh pr list --label release)" == "" ]]; then
	if ! gh pr list --label release --json number -q '.[0].number' &>/dev/null; then

[Copilot]

The awk command to extract changelog entries is duplicated. Extract this into a variable or function to improve maintainability and ensure consistency between the fallback and no-API-key paths.

Suggested change

	# Generate rich release notes using LLM
	if [[ -n "${ANTHROPIC_API_KEY:-}" ]]; then
	./scripts/gen-release-notes.sh "$TAG_NAME" "$PREV_TAG" >/tmp/release-notes.txt || {
	echo "LLM generation failed, falling back to CHANGELOG.md"
	awk '/^## \[/{if(found) exit; found=1} found{print}' CHANGELOG.md >/tmp/release-notes.txt
	}
	else
	echo "ANTHROPIC_API_KEY not set, using CHANGELOG.md"
	awk '/^## \[/{if(found) exit; found=1} found{print}' CHANGELOG.md >/tmp/release-notes.txt
	extract_changelog_notes() {
	awk '/^## \[/{if(found) exit; found=1} found{print}' CHANGELOG.md >/tmp/release-notes.txt
	}
	# Generate rich release notes using LLM
	if [[ -n "${ANTHROPIC_API_KEY:-}" ]]; then
	./scripts/gen-release-notes.sh "$TAG_NAME" "$PREV_TAG" >/tmp/release-notes.txt || {
	echo "LLM generation failed, falling back to CHANGELOG.md"
	extract_changelog_notes
	}
	else
	echo "ANTHROPIC_API_KEY not set, using CHANGELOG.md"
	extract_changelog_notes

[Copilot]

The awk command to extract changelog entries is duplicated. Extract this into a variable or function to improve maintainability and ensure consistency between the fallback and no-API-key paths.

Suggested change

	TAG_NAME="${{ github.ref_name }}"
	PREV_TAG="$(git describe --tags --abbrev=0 "$TAG_NAME^" 2>/dev/null || echo "")"
	# Generate rich release notes using LLM
	if [[ -n "${ANTHROPIC_API_KEY:-}" ]]; then
	./scripts/gen-release-notes.sh "$TAG_NAME" "$PREV_TAG" >/tmp/release-notes.txt || {
	echo "LLM generation failed, falling back to CHANGELOG.md"
	awk '/^## \[/{if(found) exit; found=1} found{print}' CHANGELOG.md >/tmp/release-notes.txt
	}
	else
	echo "ANTHROPIC_API_KEY not set, using CHANGELOG.md"
	awk '/^## \[/{if(found) exit; found=1} found{print}' CHANGELOG.md >/tmp/release-notes.txt
	extract_changelog() {
	awk '/^## \[/{if(found) exit; found=1} found{print}' CHANGELOG.md >/tmp/release-notes.txt
	}
	TAG_NAME="${{ github.ref_name }}"
	PREV_TAG="$(git describe --tags --abbrev=0 "$TAG_NAME^" 2>/dev/null || echo "")"
	# Generate rich release notes using LLM
	if [[ -n "${ANTHROPIC_API_KEY:-}" ]]; then
	./scripts/gen-release-notes.sh "$TAG_NAME" "$PREV_TAG" >/tmp/release-notes.txt || {
	echo "LLM generation failed, falling back to CHANGELOG.md"
	extract_changelog
	}
	else
	echo "ANTHROPIC_API_KEY not set, using CHANGELOG.md"
	extract_changelog

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 48.20%. Comparing base (3355a05) to head (05207e1).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #423   +/-   ##
=======================================
  Coverage   48.20%   48.20%           
=======================================
  Files          47       47           
  Lines        6163     6163           
  Branches     6163     6163           
=======================================
  Hits         2971     2971           
  Misses       1557     1557           
  Partials     1635     1635           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.