4.0.0

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)