release-version

Release mcp-replay-dota2

release.yml is triggered ONLY by pushing a tag matching v*. It HARD-FAILS the build if the tag version != pyproject.toml [project].version. Get these aligned before pushing or the whole run dies.

Current version is 1.2.0 in BOTH [project].version AND [tool.commitizen].version. The commitizen version_files is a single regex (pyproject.toml:^version) that matches BOTH line-anchored version lines, so cz bump rewrites both at once — keep them aligned.

Workflow

1. Pick the version. For a prerelease use a PEP440 suffix (.dev, aN, bN, rcN) — these route to TestPyPI, NOT PyPI. Stable versions go to PyPI + GitHub release + Docker.
2. Bump with commitizen (preferred — keeps pyproject.toml and CHANGELOG.md in sync and creates the v$version tag):

   uv run cz bump          # auto-detects bump from conventional commits
   # or force: uv run cz bump --increment PATCH|MINOR|MAJOR
   

   commitizen config: cz_conventional_commits, tag_format=v$version, update_changelog_on_bump=true, changelog_file=CHANGELOG.md, incremental. The single version_files regex rewrites both [project].version and [tool.commitizen].version.
3. Verify tag == version (release.yml does exactly this and exits 1 on mismatch):

   uv run python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])"
   git describe --tags --abbrev=0
   

   The two must be identical (tag without the leading v).
4. Run the local CI gate — release.yml re-runs ruff + mypy before building, so failures there waste a tagged run:

   uv run ruff check src/ tests/ dota_match_mcp_server.py
   uv run mypy src/ dota_match_mcp_server.py --ignore-missing-imports
   uv run pytest
   

5. Update docs/changelog.md (Keep-a-Changelog, user-facing) for release notes if not already done. CHANGELOG.md is the commitizen-generated one — let cz bump own it.
6. Push the tag to trigger the release pipeline (only when the user asks to push):

   git push origin master
   git push origin v<version>
   

7. Ad-hoc image only: use the docker-manual.yml workflow (workflow_dispatch, input version) — pushes an image without a full release.