Stata-MCP Release
Start with the release runbook. Go to the section for the current task to find the commands, expected results, and troubleshooting steps.
- Confirm the release scope. From the repository root, inspect the branch, working tree, and changes since the previous stable release. Base the scope on the commit that will ship from
master. Preserve unrelated uncommitted work. Keep security patches focused on the fixes they ship and leave later features on their branches. Follow the user's authorization for preparation, pushing, and public publication. - Run lint on
master. Follow.github/workflows/lint.yml. Runblack src,black --check src, thenflake8 src --extend-ignore=E501,W291,E203. If Black would reformat many unrelated files, reproduce the CI sequence in a temporary copy and bring back only fixes relevant to the release. Report the working tree and temporary copy results separately. When authorized to commit, commit the lint fixes first in a separate commit. - Prepare the version metadata. Update
CHANGELOG.mdto reflect what ships and synchronize the package version inpyproject.tomlwith the server and PyPI package versions inserver.json. When authorized, commit these three files together. Usetests/test_release_metadata.pyto check consistency and select existing tests based on the changes. - Draft release notes for review. Save them at
releases/v-<major>-<minor>-<patch>.mdin the repository root, for examplereleases/v-1-25-3.md. Follow the template and recent stable releases. Describe user-visible changes, upgrade implications, and relevant settings. Git ignores this directory. Use the draft as the GitHub Release body. If local examples are missing, retrieve recent stable release bodies from GitHub in publication order, exclude drafts and prereleases, and preserve existing files. - Push and publish. Check which commits will be pushed and tell the user. Once the user approves the notes and authorizes publication, confirm that remote
mastercontains the target commit and check for an existing tag or Release. Create the Release with tagv<major>.<minor>.<patch>pointing to the confirmed commit and pass the reviewed notes with--notes-file. If the version already exists, check its status before proceeding.
Publishing the GitHub Release triggers .github/workflows/python-package.yml for PyPI and the MCP Registry and .github/workflows/release-binaries.yml for platform binaries. Report the observed status of each separately.
Reference Files
| Name | Location | Description |
|---|---|---|
| Release Runbook | references/runbook.md |
Steps and commands for preparing, pushing, publishing, and tracking a release |
| Release Notes Template | templates/release-notes.md |
Scaffold for drafting release notes |