Added

• vrsn --commit — after writing the new version, stages the changed file and creates a commit with the message "bumped version from X to Y" (or "bumped build from X to Y" in --numeric mode); errors if other changes are staged unless --stash is also given
• vrsn --stash — before committing, stashes any other staged changes via git stash --staged, then restores them after; requires --commit
• prepare-release --build-number-key KEY — auto-increments the numeric value at KEY in --file via vrsn -n and appends the result as semver build metadata (+N) in the changelog entry and git tag; supersedes --build-number when both are given
• prepare-release validates that the marketing version was bumped before running, using the changelog as the source of truth (compares the version file against the most recent non-RC section header); errors with an actionable message if the version was not bumped

Changed

• prepare-release no longer accepts patch, minor, or major as arguments and no longer bumps version files internally; version bumping is now the caller's responsibility (e.g. make patch / make minor / make major)
• prepare-release component argument is now optional: pass rc for a release candidate, or omit it for a final release
• prepare-release --key is now optional; when omitted, the version file is treated as a plain VERSION-style file containing only the version string (no KEY = VALUE format required)

Added

• prepare-release rc — create a release candidate tag (<version>-RC<N>) from the [Unreleased] changelog section without bumping the version or migrating the changelog; RC number is auto-detected from existing tags or overridden with --rc-number
• prepare-release --build-number <N> — append semver build metadata (+N) to the changelog entry heading and git tag in both release and RC modes; the version file itself is not affected (mirrors iOS MARKETING_VERSION / CURRENT_PROJECT_VERSION separation)

Changed

• changetag --name now exclusively controls which changelog section to look up; the tag annotation title is always the tag name (previously --name also overrode the annotation title)

Changed

• prepare-release no longer requires --tools-bin; tools are resolved from PATH (Homebrew install)

Added

• prepare-github-release — create GitHub releases from git tags with changelog-derived release notes via gh