| name | bump-version |
| description | Version bump and optional PyPI release for goodeye-cli. Use when bumping the version, cutting a release, or pushing a git tag to trigger PyPI publish. |
goodeye-cli Version Bump
Two phases: (1) bump commit, always; (2) tag + push, only on explicit instruction.
Step 1: Determine new version
User override always wins. Accept any of:
- Bump type:
major, minor, patch
- Explicit target:
bump to 1.0.0
- Pre-release (PEP 440):
0.9.0a1, 0.9.0rc1
Without override, inspect commits since the last tag:
git describe --tags --abbrev=0
git log <last-tag>..HEAD --oneline
SemVer rules:
- major: breaking change, removed/renamed command, incompatible flag change
- minor: new subcommand, new flag, new user-visible feature
- patch: bug fix, internal refactor, docs, CI, dependency update, chore
Bias toward patch over minor, minor over major when ambiguous.
Step 2: Edit files
pyproject.toml: one line change:
version = "X.Y.Z"
uv.lock: run from repo root after editing pyproject.toml:
uv lock
Updates only the self-referential [[package]] name = "goodeye" entry. No dependency upgrades occur.
Step 3: Commit
Stage exactly these two files:
git add pyproject.toml uv.lock
Commit message (no body):
chore: bump version to X.Y.Z
Step 4: Tag and push (explicit instruction only)
Only proceed if the user explicitly says to tag, push, release, or publish (e.g. "tag it", "push the tag", "ship it to PyPI").
Verify the tag doesn't already exist, then:
git tag vX.Y.Z
git push origin vX.Y.Z
This triggers publish.yml -> builds wheel -> publishes to PyPI via OIDC trusted publishing. No manual credentials needed. Monitor at github.com/Goodeye-Labs/goodeye-cli/actions.
