Skip to content

Bring gh-release entry fidelity up to commit-range bundling's - #3858

Open
cotti wants to merge 1 commit into
feature/changelog-versions-visibilityfrom
feature/gh-release-extraction-parity
Open

Bring gh-release entry fidelity up to commit-range bundling's#3858
cotti wants to merge 1 commit into
feature/changelog-versions-visibilityfrom
feature/gh-release-extraction-parity

Conversation

@cotti

@cotti cotti commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Why

gh-release mode produced title/link-only entries, a content-fidelity gap against commit-range bundling: products on the On-release GitHub Release path (APM agents, smaller repos) got lower-quality release notes than serverless products (RFC B5, closes #3775).

What

changelog gh-release (and changelog add --release-version) now follows the same fidelity ladder as commit-range bundling for each PR in the release notes:

  1. A checked-in entry from the pool wins — matched by file-name-derived PR numbers (file names survive scrubbing) or prs references, and written verbatim so curated content ships. Pool unavailability degrades to synthesis with a warning, keeping repos that never upload entries working.
  2. Otherwise the entry is synthesized with PR-body extraction: release-note text becomes the description (same path as changelog add, honoring extract.release_notes) and linked issues carry over (extract.issues).
  3. Title/link-only remains the last resort.

The bundle step now selects exactly the files the run created instead of filtering by PR URLs — pool entries whose prs references were scrubbed from public copies could never match a URL filter. Reuses the pool-candidate matching from commit-range bundling (#3848).

Stack: 5/5 (top).

gh-release mode produced title/link-only entries, a fidelity gap against
the git-ref path (B5, #3775). It now follows the
same ladder: a checked-in entry from the pool wins (matched by
file-name-derived PR numbers or prs references, written verbatim so the
curated content ships), otherwise release-note text from the PR body
becomes the description and linked issues carry over, with title-only as
the last resort. The bundle now selects exactly the files the run
created — a PR-URL filter could never match pool entries whose prs
references were scrubbed from public copies.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants