Skip to content

fix: set initial-version so the first release is v0.0.1 - #3

Merged
venkatamutyala merged 1 commit into
mainfrom
fix/initial-release-version
Aug 30, 2026
Merged

venkatamutyala merged 1 commit into
mainfrom
fix/initial-release-version

Conversation

@venkatamutyala

Copy link
Copy Markdown
Collaborator

release-please opened #2 proposing 1.0.0. It should be 0.0.1.

Why it happened

My config set the bump flags but not initial-version. Per the schema:

option description
bump-patch-for-minor-pre-major "Feature changes only bump semver patch if version < 1.0.0"
initial-version "Releases the initial library with a specified version"

The bump flags govern bumping from an existing version — and there isn't one yet. A 0.0.0 entry in .release-please-manifest.json isn't treated as a released version either, so release-please fell back to its default first release of 1.0.0.

I had assumed the manifest plus the bump flags would be enough. They aren't; initial-version is the option that covers a first release.

The fix

".": {
  "release-type": "simple",
  "package-name": "toolbox",
  "initial-version": "0.0.1"
}

The bump flags stay — they're still what keeps later feature releases on 0.0.x rather than jumping to 0.1.0.

After merging

release-please will recompute #2 as chore(main): release 0.0.1. Merging that tags v0.0.1 and the build workflow publishes ghcr.io/glueops/toolbox:0.0.1, :0.0 and :latest, multi-arch.

If #2 doesn't update on its own, closing it will make release-please reopen it on the next push to main.

release-please proposed 1.0.0 for the first release. The bump flags do not apply
to it: bump-patch-for-minor-pre-major is documented as "feature changes only bump
semver patch if version < 1.0.0", so it governs bumping *from* an existing
version - and there is no existing version yet. A 0.0.0 manifest entry is not
treated as a released version either, so release-please fell back to its default
first release of 1.0.0.

initial-version is the option that covers this case: "releases the initial library
with a specified version".

The bump flags stay - they are still what keeps subsequent feature releases on
0.0.x rather than jumping to 0.1.0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NiwgsqcQ4JikhFYj4NHEjM
@venkatamutyala
venkatamutyala merged commit 75d250b into main Aug 30, 2026
3 checks passed
@venkatamutyala
venkatamutyala deleted the fix/initial-release-version branch August 30, 2026 16:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant