quality-screener-mcp-server: Command for Claude Code

Cut a new release for qscreener-mcp. The bump type is $1 (default to patch if empty).

Critical rules

• pyproject.toml and server.json versions MUST stay in sync with each other and with the git tag. The package exposes __version__ via importlib.metadata (see qscreener_mcp/__init__.py), and it is sent to the backend as CLIENT_ID = f"mcp/{__version__}" — a stale pyproject.toml version silently corrupts usage analytics.
• Git tags use a v prefix (e.g. v0.2.0); the version fields in pyproject.toml and server.json do NOT (e.g. 0.2.0).
• Releases are cut directly on main — this repo has no develop branch and main is not protected. Do not open a release PR.
• Never push or tag until the version edits are committed.
• The agent never pushes to main. Commit and tag locally, then stop and hand off — the user runs the actual git push themselves. This mirrors the quality-screener release process, where the agent opens the release PR but leaves merging (and thus the push to main) to the user.

Steps

1. Sync main. (Do this FIRST, before any edits.)

   • git fetch origin --tags
   • git switch main && git pull --ff-only origin main
   • Confirm the working tree is clean (git status --porcelain returns nothing). Abort and tell the user if it is not.

2. Determine the new version.

   • Run git tag --sort=-v:refname | head -5 to find the latest tag.
   • If tags exist: parse the latest semver tag (strip the v prefix) and bump according to $1:
     • patch (default) → X.Y.(Z+1)
     • minor → X.(Y+1).0
     • major → (X+1).0.0
   • If no tags exist (first release): do not bump. Use the version already in pyproject.toml as-is, and say so in the final report.
   • Call the new version NEW (no v) and the tag vNEW.
   • Sanity check that vNEW does not already exist: git rev-parse -q --verify refs/tags/vNEW must fail.

3. Update the version manifests to NEW:

   • Edit version in pyproject.toml ([project] section).
   • Edit version in server.json (top level).
   • Confirm both now read exactly NEW: grep -n '"\?version"\? *[:=]' pyproject.toml server.json.
   • Skip this step if the versions already equal NEW (first-release case).