📝 chore(release): regenerate CHANGELOG.md so the drift gate is green again - #108
Open
konih wants to merge 1 commit into
Open
📝 chore(release): regenerate CHANGELOG.md so the drift gate is green again#108konih wants to merge 1 commit into
konih wants to merge 1 commit into
Conversation
…again
The changelog was never re-rendered after the CI docs commit landed on main,
so `hack/release/verify-changelog.sh` saw a fresh `git-cliff` render carrying
one entry CHANGELOG.md did not have:
### Other
- ci(docs): stop uploading the Pages artifact on pull requests
That single drift failed two jobs at once — the `verify` job's changelog drift
gate (AUD-S02 / REQ-AUD-S02-02) and the `release-exitgate` job's `task check`,
which reaches the same `changelog-verify` stage.
This commit is only the regenerated render. Its own subject matches the
`^:memo: chore\(release\):` skip rule in cliff.toml, so it is excluded from the
changelog and does not itself become the next missing entry.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
mainhas been RED since 2026-08-31. This is the fix.Root cause
CHANGELOG.mdwas never re-rendered afterdfdae69's own CI-docs commit landedon
main. A freshgit-cliffrender therefore carries exactly one entry thatthe committed
CHANGELOG.mddoes not have:hack/release/verify-changelog.shcompares the two and exits 1 on that singleline of drift.
Blast radius — one drift, two red jobs
That one missing entry reds both:
verifyjob's changelog drift gate (AUD-S02 — REQ-AUD-S02-02), whichruns
task changelog-verifydirectly; andrelease-exitgatejob's AUD audit exit gate (AUD-S18), whose fulltask checkreaches the samechangelog-verifystage (stage 10).They are two paths into one script, so one regeneration clears both.
The fix
A pure regeneration. One file, 3 insertions / 0 deletions — the missing
### Othersection and its single entry. No script, workflow, or config change.Why the subject line is
:memo: chore(release):cliff.toml:119skips exactly that pattern:and it is ordered before the
^:memo:|^docsDocumentation rule, so the skipwins. That is load-bearing here, not cosmetic: a regeneration commit with any
other subject would itself render into the next changelog and become the new
missing entry, re-creating the very drift it is fixing. This subject makes the
fix a fixed point.
Reviewer note — a green PR here is NOT proof
Both jobs this PR repairs are skipped on the
pull_requestevent:.github/workflows/verify.yaml:153-155guards the drift gate withif: github.event_name != 'pull_request', andrelease-exitgatecarries thesame condition at line 160. This PR will go green whether or not the fix works.
The required checks here are a regression check only. The real proof is the
push-to-
mainrun after merge, where both gates actually execute.Land order
This must land first and alone. Rebasing onto an unchanged
mainkeepsverify-changelog.shat exit 0, but rebasing onto amainadvanced by even onerendering commit puts the gate back to exit 1. Any lane that lands after this
one needs its own
task changelog-writeregeneration on its rebased head.