Skip to content

fix: close the release.yml changelog race - #35

Merged
ntlaletsi70 merged 1 commit into
developfrom
fix/release-changelog-race
Aug 23, 2026
Merged

ntlaletsi70 merged 1 commit into
developfrom
fix/release-changelog-race

Conversation

@ntlaletsi70

Copy link
Copy Markdown
Collaborator

Summary

  • Same race already fixed in `environments`/`environments-controller`: `release.yml` is triggered asynchronously by the tag push and used to generate `CHANGELOG.md` and commit it to `main` itself, after `finalize-release.yml` had already merged `main` back into `develop` in the same run. `develop` never received that commit.
  • Confirmed happening on the v0.2.4 release just cut: `develop` needed a manual post-hoc sync to pick up the changelog commit.
  • Fix: moved changelog generation into `finalize-release.yml`, synchronously, right after tagging (so git-cliff picks up the new tag correctly) and before merging back into `develop`. `release.yml` no longer touches `main` at all — it just checks out the tip `finalize-release.yml` already updated and reads the already-current `CHANGELOG.md` for its `--latest` release notes.

Test plan

  • YAML syntax validated
  • Exercise on the next real "Finalize Release" run

Same race already fixed in environments/environments-controller:
release.yml is triggered asynchronously by the tag push and used to
generate CHANGELOG.md and commit it to main itself, after
finalize-release.yml had already merged main back into develop --
develop never received that commit. Confirmed happening on the v0.2.4
release: develop needed a manual post-hoc sync.

Moved changelog generation into finalize-release.yml, synchronously,
right after tagging (so git-cliff picks up the new tag) and before
merging back into develop. release.yml no longer touches main -- it
just checks out the tip finalize-release.yml already updated and reads
the already-current CHANGELOG.md for its --latest release notes.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@ntlaletsi70
ntlaletsi70 merged commit 37f100c into develop Aug 23, 2026
1 check passed
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