faceit-mcp: Command for Claude Code

/publish (patch|minor|major)

Cut a release by bumping the package version in pyproject.toml, committing the change, and creating + pushing a vX.Y.Z git tag so the publish.yml workflow runs and uploads to PyPI via trusted publishing (OIDC).

This command takes exactly one argument: patch, minor, or major.

When this command is invoked, do the following in order:

1. Validate the argument is one of patch, minor, major. If not, stop and explain correct usage.

2. Ensure the git working tree is clean and we are on main:

   git status
   git branch --show-current
   

   If there are uncommitted changes, stop and ask the user to commit/stash them. If not on main, stop and ask the user to switch to main.

3. Read the current version from pyproject.toml ([project].version) and bump it according to SemVer:

   • patch: X.Y.(Z+1)
   • minor: X.(Y+1).0
   • major: (X+1).0.0

   Then update pyproject.toml in-place to the new version.

4. Build the distribution locally to catch packaging errors early:

   uv build
   

   If the build fails, stop and report the error.

5. Commit the version bump:

   git add pyproject.toml
   git commit -m "$(cat <<'EOF'
   Release vX.Y.Z
   
   EOF
   )"
   

   Replace vX.Y.Z with the actual new version (prefixed by v).

6. Create an annotated git tag for the release:

   git tag -a "vX.Y.Z" -m "vX.Y.Z"
   

   If the tag already exists, stop and report it.

7. Push the commit and the tag:

   git push origin main
   git push origin "vX.Y.Z"
   

8. Report back:

   • The new version number
   • The tag created
   • That pushing the tag should trigger .github/workflows/publish.yml (tags v*.*.*) and publish to PyPI from the release GitHub Actions environment.