Preview or apply a release version bump
rrt_bumpPreview or apply a version bump across version targets, pins, changelog, lockfiles, generated assets, and release branch/commit, so releases avoid inconsistent hand-edited version strings.
Instructions
Preview or apply a version bump — use instead of editing version strings by hand.
This is the same pipeline as rrt bump (version targets, pins, changelog
promotion, lockfile and generated-asset refresh, release branch + commit), so a
partial hand-edit will diverge. dry_run=True previews everything and writes
nothing. Each result's changed_paths lists every file the bump touched (or
would touch under dry_run), relative to the repo root.
level: major | minor | patch | alpha | beta | rc. dry_run=True by default.
group: restrict the bump to one [tool.rrt] version group; omit to bump every
configured group (one :class:BumpGroupResult per group either way).
base: patch | minor | major | auto — the core an alpha/beta/rc bump targets
when the current version is FINAL. Same as the CLI's rrt bump rc --base.
Omit it to use the group's prerelease_base config, which defaults to the
next patch (1.0.0 -> 1.0.1-rc.1; minor -> 1.1.0-rc.1; major -> 2.0.0-rc.1).
auto reads Conventional Commits since the last final tag: breaking ->
major, feat -> minor, else patch. Ignored once the version is already a
pre-release, so rc.1 -> rc.2 never moves the core.
scheme: semver | pep440 | calver — the grammar the version is read, bumped
and written in. Same as the CLI's rrt bump --scheme. Omit it to use the
group's version_scheme config; unset there, it is inferred from the
primary target (calendar-shaped -> calver, pep621/python_version -> pep440,
else semver).
Runs the SAME pipeline as the rrt bump CLI command (preflight, version
targets, pin targets, changelog promotion/generation, lockfile and generated-asset
refresh, then release-branch checkout + commit) via
:mod:repo_release_tools.commands.bump's shared stage functions, so an MCP bump
and a CLI bump of the same repo produce identical results (fixes defect D9: the
previous MCP bump only rewrote version-target files and skipped pins, changelog,
lockfiles, generated assets, and git branch/commit entirely).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"level": "<level>"
},
"name": "rrt_bump"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| base | No | ||
| group | No | ||
| level | Yes | ||
| scheme | No | ||
| dry_run | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |