Skip to content

Local video editor for coding agents: 42 FFmpeg tools with a machine-readable contract and an MCP server, for Claude Code, Cursor and Codex. Cut, captions, reframe, loudness, platform exports. No cloud, no API keys.

fix(release): fold hand-written Unreleased notes into the bump instead of asserting the placeholder (#166)

Shogo Kajiyamaf4311b3e5260
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 7deddc7..dfc86ba 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -166,9 +166,18 @@ jobs:
changelog_path = root / "CHANGELOG.md"
changelog = changelog_path.read_text(encoding="utf-8")
- anchor = "## Unreleased\n\n(nothing yet)\n\n"
- assert anchor in changelog, "CHANGELOG.md's Unreleased anchor not found"
- changelog_path.write_text(changelog.replace(anchor, anchor + section, 1), encoding="utf-8")
+ # Whatever sits under "## Unreleased" (hand-written bullets from the merged PRs, or the
+ # placeholder "(nothing yet)") moves into the new version's section, ahead of the
+ # generated commit-subject bullets, and the placeholder is put back. The anchor used to
+ # be the literal "(nothing yet)" line, so a PR that wrote real notes there broke the
+ # bump step (1.4.1's first run).
+ m = re.search(r"## Unreleased\n(.*?)(?=^## )", changelog, re.S | re.M)
+ assert m, "CHANGELOG.md has no '## Unreleased' section followed by a version heading"
+ unreleased = m.group(1).strip()
+ if unreleased and unreleased != "(nothing yet)":
+ section = section.replace(f"since {old}._\n\n", f"since {old}._\n\n{unreleased}\n", 1)
+ changelog = changelog[:m.start()] + "## Unreleased\n\n(nothing yet)\n\n" + section + changelog[m.end():]
+ changelog_path.write_text(changelog, encoding="utf-8")
PY
git config user.name "github-actions[bot]"
diff --git a/references/process-pitfalls.md b/references/process-pitfalls.md
index b600162..3063128 100644
--- a/references/process-pitfalls.md
+++ b/references/process-pitfalls.md
@@ -158,3 +158,13 @@ inputs (or `Unexpected input(s)` in the first log) before trusting a parameter,
any step whose output decides an irreversible action as something to unit-test with fixed
inputs, not something to confirm by reading its YAML. And watch the first real run's
*effect* (tags, npm), which is how both incidents were actually noticed.
+
+### The release bump step required the literal `(nothing yet)` line under `## Unreleased`
+
+Found on the first run after #163 (2026-09-11). `release.yml`'s auto-bump located the CHANGELOG
+insertion point with `assert "## Unreleased\n\n(nothing yet)\n\n" in changelog`. #163 did the
+natural thing and wrote its notes under Unreleased, so the bump step failed on the assert
+before the push, the tag or the publish -- a clean no-op, but a red run and no release. The
+script now takes whatever sits under Unreleased into the new version's section and puts the
+placeholder back, so hand-written notes are welcome there. Lesson: an anchor that is also
+prose will be edited; anchor on the heading, not on the placeholder text.