Skip to content
| Marketplace
Sign in
Visual Studio Code>Linters>Semver Bump Mismatch CompanionNew to Visual Studio Code? Get it now.
Semver Bump Mismatch Companion

Semver Bump Mismatch Companion

Gap Hunter Labs

| (0) | Free
Flags a CHANGELOG.md release that reads as a breaking change but didn't bump MAJOR -- no data leaves your editor.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Semver Bump Mismatch Companion (VS Code)

Flags a CHANGELOG.md release whose own text reads as a breaking change but whose version only bumped MINOR or PATCH — no data leaves your editor.

v0.1, pilot. Part of the Gap Hunter Labs VS Code workstream, ported from the IntelliJ-family semver-bump-mismatch-companion. No VS Code Marketplace equivalent found — existing changelog/version tools handle executing a bump, not verifying whether a past bump's severity actually matched its content.

What it does

Parses a Keep a Changelog-format CHANGELOG.md (## [X.Y.Z] - YYYY-MM-DD headers) and compares each release against the one right before it. A release is flagged when:

  • its body text contains "BREAKING" (case-insensitive — the same marker Conventional Commits uses), or a ### Removed section (removing a feature/API is a breaking change by definition), and
  • its version only bumped MINOR or PATCH versus the previous release, never MAJOR.

[Unreleased] is never checked (no real version to compare against yet), and 0.x.y releases are skipped entirely — SemVer itself treats the whole 0.x line as "anything can break".

Privacy

See PRIVACY.md — zero network calls, everything runs against CHANGELOG.md already open in your editor.

Development

npm install
npm run compile   # or: npm run watch
npm test

To build an installable package without publishing:

npx @vscode/vsce package

License

Apache License 2.0 — see LICENSE.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft