Release Prep

Release Prep

Overview

Follow the code-index-mcp release checklist and use the helper script for quick repo status. Keep this file focused on the high-level workflow; the checklist contains the exact commands.

Workflow

1. Run scripts/run_release_checks.py and review the output.
2. Review changes since the last tag, decide the semver bump, and confirm the target version + branch with the user.
3. Confirm test scope (full vs. -k) and run: uv run pytest.
4. Update version files: pyproject.toml, src/code_index_mcp/__init__.py, uv.lock.
5. Ensure the diff only touches the three version files.
6. Commit with Conventional Commits (e.g., chore(release): vX.Y.Z).
7. Draft release notes focused only on functional changes (exclude technical-only modifications) and confirm the notes with the user before creating the GitHub release.
8. Tag, push branch + tag, and create the GitHub release.
9. Follow up on CI/deploy jobs.

Resources

scripts/

• scripts/run_release_checks.py for repo status, latest tag, and version file presence before editing versions.

references/

• references/release_checklist.md for the exact steps, commands, and files.