chore/post-release-cleanup: Rewrite CHANGELOG for v1.9.12, add workflow_dispatch, fix README#24
Merged
vedanthvdev merged 1 commit intomasterfrom Apr 22, 2026
Merged
Conversation
…ow_dispatch, fix README The v1.10.0 release attempt in PR #23 actually shipped as v1.9.12 because axion-release's markNextVersion creates a marker tag that only influences currentVersion's display output — the release task itself still follows its default patch incrementer unless -Prelease.version=X.Y.Z is passed at release time, which the release workflow did not do. Two stray tags from that attempt have been deleted off the remote (release-1.10.0) and the local clone (v1.10.0-alpha, which never made it to origin). Three paired fixes land here so the same mistake can't repeat and so the repo's written record matches reality: - CHANGELOG.md now documents v1.9.12 as a metadata-and-pipeline release (introducing this file, fixing the README, adding the workflow dispatch). The v2 Phase 1+2 narrative is kept as an aggregated release- history section pointing at GitHub Releases for per-tag detail. - release.yml gains a workflow_dispatch trigger with an optional `version` input. When supplied, the release step passes -Prelease.version=$VERSION to axion-release, cutting the requested tag instead of auto-incrementing the patch. On normal master pushes (empty input), behaviour is identical to before, so the current auto-patch flow is untouched. - README's Versioning table no longer recommends markNextVersion for forcing minor/major bumps (it never worked). The replacement routes operators to Actions → Release → Run workflow with the `version` field, and adds a negative-result note explaining what markNextVersion actually does so a future reader doesn't repeat the misunderstanding. The plugin code itself is untouched — this is a pipeline and docs release.
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.
What happened
PR #23 intended to cut v1.10.0, but axion-release ignored the
release-1.10.0marker tag and cut v1.9.12 (default patch auto-increment). Therelease-1.10.0marker was created by./gradlew markNextVersion -Prelease.version=1.10.0, which is what the README's Versioning table told me to run — except that command only influencescurrentVersion's display output. Thereleasetask itself still followsincrementPatchunless-Prelease.version=X.Y.Zis passed at release time, which the workflow did not do.v1.9.12 is already live on the Gradle Plugin Portal and on GitHub Releases with the intended content (same as what was planned for v1.10.0). Unpublishing from the Portal isn't supported, and publishing both v1.9.12 and v1.10.0 with identical content would be confusing, so this PR accepts v1.9.12 as the release and fixes the three things that actually need fixing.
Three paired fixes
1.
CHANGELOG.mdrewritten to match realityThe v1.10.0 entry is gone. In its place:
2.
release.ymlgains aworkflow_dispatchentry pointThe release step now passes
-Prelease.version=\$RELEASE_VERSION_INPUTonly when that input is non-empty. On every normal master push,inputs.versionis empty and the command reduces to exactly the old form, so the auto-patch flow is untouched. On manual dispatch, the explicit version wins.3. README Versioning table replaced
The old table recommended
./gradlew markNextVersion -Prelease.version=X.Y.0for forcing minor/major bumps. That command does not do what the table claimed. The new table:versionfor minor/major bumps (or thegh workflow runequivalent from a terminal).markNextVersionactually does, so the next reader doesn't repeat the mistake.Stray tag cleanup (not in this diff)
Two stray tags from the failed attempt were removed out-of-band:
release-1.10.0— deleted from remote + local.v1.10.0-alpha— never made it to remote (local-only artifact frommarkNextVersionrunning on a non-master branch whereversionCreatorappends-alpha); deleted locally.Test plan
./gradlew checkgreen with--rerun-tasks(fresh, not cached).release.ymlparses as valid YAML.git ls-remote --tags originshows nov1.10.0-alphaorrelease-*entries.versioninput and confirm it cuts the explicit version. That's the real validation of fix Fix security vulnerabilities and cross-module usage strategy (v1.3.0) #2; it doesn't need to happen in this PR.