Skip to content

Fix release notes quoting; release HTML to Text as v0.3.0 - #6

Merged
fadeltd merged 1 commit into
mainfrom
fix/release-notes-and-changelog
Sep 25, 2026
Merged

fadeltd merged 1 commit into
mainfrom
fix/release-notes-and-changelog

Conversation

@fadeltd

@fadeltd fadeltd commented Sep 25, 2026

Copy link
Copy Markdown
Owner

Two reasons nothing new has been deployed since v0.2.2.

1. The v0.2.3 Release run failed (run 35978735265)

The "Create the GitHub release" step passed the notes as --notes "${{ steps.cut.outputs.notes }}". GitHub substitutes ${{ }} into the script text before bash parses it. So the backticks in the 0.2.3 notes (`display: flex`, `<code>`) ran as command substitution:

line 1: display:: command not found
command substitution: line 2: syntax error near unexpected token `newline'

The failure came after the changelog commit and the v0.2.3 tag had already been pushed. The result:

  • the tag exists
  • there is no GitHub release
  • Start Deploy never ran, so production is still on v0.2.2

It is also a script-injection hole: any changelog text is executed as shell.

Fix: TAG and NOTES are now passed to that step as env vars, and the script only references "$TAG" / "$NOTES". I reproduced the exact CI error locally with the old form, and confirmed the new form prints the notes unchanged. deploy.yml and ci.yml use ${{ }} only in with: inputs, which bash never parses.

2. Merging #5 released nothing

#5 didn't add anything under [Unreleased] in CHANGELOG.md. An empty [Unreleased] releases nothing, as designed. This PR adds the entry.

Also

tmp/ is now in .gitignore.

What merging this does

scripts/release.ts --dry-run gives bump: minor, 0.2.3 -> 0.3.0. v0.3.0 will be deployed, containing HTML to Text plus the 0.2.3 fixes that never shipped. Its notes contain backticks, so this first run also tests the fix.

v0.2.3 still has no GitHub release entry. It can be backfilled by hand if you want the list complete.

The Release workflow interpolated the notes into the gh command with ${{ }},
so backticks in the changelog ran as command substitution. The v0.2.3 run died
after pushing its tag, leaving no GitHub release and no deploy.

Also records HTML to Text under [Unreleased] (PR #5 shipped without an entry,
so its merge released nothing) and ignores tmp/.
@fadeltd fadeltd self-assigned this Sep 25, 2026
@fadeltd
fadeltd merged commit 4f5ffcf into main Sep 25, 2026
1 check passed
@fadeltd
fadeltd deleted the fix/release-notes-and-changelog branch September 25, 2026 07:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant