fix: pin the changelog preset to a version semantic-release can render - #493
Merged
Conversation
The 3.3.2 release failed at generateNotes with: Missing helper: "conventional-changelog-conventionalcommits requires conventional-changelog-writer@9 or newer" conventional-changelog-conventionalcommits 10.4.0 added a hard guard requiring writer 9, but semantic-release still pins writer 8 all the way up to its latest release-notes-generator, so the preset and the writer can no longer agree. The 10.3.0 we were on before had no such guard, which is why 3.3.1 released and 3.3.2 did not. Pin the preset to 9.3.1, the line the preset's own error points at and the version both sibling SDKs already release from, and stop Renovate reintroducing 10.x until semantic-release moves to writer 9. Verified by rendering the 3.3.2 notes with the installed writer: 10.4.0 throws, 9.3.1 produces the expected changelog entry. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
doistbot
reviewed
Aug 25, 2026
doistbot
left a comment
Member
There was a problem hiding this comment.
This PR updates fix: pin the changelog preset to a version semantic-release can render. No issues were flagged in the reviewed diff.
Contributor
|
🎉 This PR is included in version 3.3.2 🎉 The release is available on: Your semantic-release bot 📦🚀 |
Contributor
|
✅ |
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.
The 3.3.2 release failed, so the transport fix from #492 is merged but unpublished. This unblocks it.
What happened
The release job died at
generateNotes:conventional-changelog-conventionalcommits@10.4.0added a hard guard requiringconventional-changelog-writer@9.semantic-release@25.0.9resolves@semantic-release/release-notes-generator@14.1.1, which pinsconventional-changelog-writer@^8.0.0— and so does its latest release, so there is no version of semantic-release that satisfies the 10.x preset today.Renovate moved us from 10.3.0 to 10.4.0 in #490 yesterday. 10.3.0 carried no such guard, which is exactly why 3.3.1 released and 3.3.2 did not. Nothing in #492 is involved — its lockfile changes do not touch the changelog tooling.
The fix
Pin the preset to
9.3.1— the line the preset's own error message points at ("use an older major version of the preset"), and the version both@doist/todoist-sdkand@doist/comms-sdkalready release from. A Renovate rule keeps 10.x out until semantic-release moves to writer 9.Verification
Rendered the actual 3.3.2 notes through
@semantic-release/release-notes-generatoragainst the installed writer:npx semantic-release --dry-runthen completes with no failed steps.npm test(1878) andnpm run checkstill pass.Chose 9.3.1 over reverting to 10.3.0 because the whole 10.x line has declared it needs writer 9 — going back to 10.3.0 just waits for the next patch bump to break the release again.
After merge
The release aborted before tagging or publishing — npm is still on 3.3.1 and there is no
v3.3.2tag — so merging this re-runs the job and publishes 3.3.2 cleanly, including the transport fix.🤖 Generated with Claude Code