fix(#2488): strip leading terminators so changeset bullets survive re-parse (#2492)

* fix(#2488): strip leading terminators so changeset bullets survive re-parse

A fragment body beginning with a line terminator rendered as an empty
`- ` bullet followed by an orphaned paragraph. `parseChangelog` treats a
non-indented line as terminating a bullet, so `github-release-notes.cjs`
silently dropped the entry when re-parsing CHANGELOG.md to build the
GitHub Release body.

Two independent causes, both in scripts/changeset/parse.cjs:

1. `extractDocsExempt` stripped trailing terminators but not leading
   ones. `DOCS_EXEMPT_RE` is `^...$` under /m, so removing a first-line
   `<!-- docs-exempt -->` marker left the `\n` that `$` does not consume.

2. `parseFragment` preserved the post-frontmatter body verbatim, so a
   blank line between the closing `---` and the first content line
   produced the same leading `\n` with no marker involved.

8 of 256 pending fragments were affected, split 4/4 across the two
causes — including the OpenCode MCP binding, the pi extension, and the
EoS adapters, all of which would have vanished from the v1.8.0 release
notes.

Regression tests cover both causes in LF and CRLF form, plus an
end-to-end serializeChangelog -> parseChangelog round-trip that pins the
user-visible defect.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* chore(#2488): regenerate golden install fixtures for parse.cjs

scripts/ ships in the npm package and the installer, so the golden
install-parity fixtures record a content hash for every shipped file.
Editing scripts/changeset/parse.cjs drifts that hash and fails all 18
per-runtime parity tests.

Regenerated via `npm run gen:golden`. The diff is exactly one line per
fixture — the scripts/changeset/parse.cjs hash — with no unrelated drift.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Tom Boucher
2026-07-21 19:32:51 -04:00
committed by GitHub
parent c19d3d7bda
commit 9fe9da9830
20 changed files with 138 additions and 18 deletions

View File

@@ -65,10 +65,23 @@ function extractDocsExempt(body) {
// is CRLF-aware so Windows-authored fragments don't leave residual `\r`
// characters that would shift the `(#NNNN)` PR suffix to a blank line in
// the rendered CHANGELOG.md / GitHub release-notes bullet.
//
// Both leading AND trailing line terminators are stripped. `DOCS_EXEMPT_RE`
// removes the marker's own text but its `$` anchor (multiline mode) does
// not consume the `\n` that terminates the marker's line. When the marker
// is the FIRST line of the body, that leftover `\n` becomes the new first
// character of `body` — serializeChangelog then emits an empty `- ` bullet
// followed by an orphaned continuation paragraph, and parseChangelog's
// bullet-continuation check (which requires a leading `\s`) treats that
// non-indented paragraph as terminating the bullet, silently dropping the
// entry's content on re-parse. Stripping leading terminators here closes
// that gap the same way the trailing strip already does for the opposite
// (marker-last) position.
const cleaned = body
.replace(DOCS_EXEMPT_RE, '')
.replace(/[ \t\r]+$/gm, '') // strip trailing \r/spaces on each line
.replace(/(?:\r?\n){3,}/g, '\n\n') // collapse 3+ blank lines (CRLF-aware)
.replace(/^[\r\n]+/, '') // strip terminators left by a first-line marker
.replace(/[\r\n]+$/, ''); // strip every trailing line terminator
return { docsExempt: reason, body: cleaned };
}
@@ -105,6 +118,19 @@ function parseFragment(src) {
if (body.endsWith('\r\n')) verbatimBody = body.slice(0, -2);
else if (body.endsWith('\n')) verbatimBody = body.slice(0, -1);
else verbatimBody = body;
// Some fragments have a blank line between the closing frontmatter `---`
// and the first line of actual content (purely a stylistic authoring
// choice — the blank line carries no significant content, unlike
// indentation inside a code block). Strip any such leading blank line(s)
// here, mirroring the trailing-terminator strip above. Without this,
// `body` starts with `\n`/`\r\n`, serializeChangelog emits an empty `- `
// bullet followed by an orphaned paragraph, and parseChangelog's
// continuation check (requires a leading `\s` on the line) treats that
// non-indented paragraph as terminating the bullet — silently dropping
// the fragment's content on re-parse. This is the same downstream failure
// mode as a first-line docs-exempt marker (see extractDocsExempt below);
// it just arises from plain authoring whitespace instead of a marker.
verbatimBody = verbatimBody.replace(/^(?:[ \t]*\r?\n)+/, '');
const { docsExempt, body: visibleBody } = extractDocsExempt(verbatimBody);
if (!visibleBody.trim()) return { ok: false, reason: FRAGMENT_ERROR.EMPTY_BODY };