Conventional Changelog & Semver Bump

Turns Conventional Commits into a changelog and the correct semver bump.

THE SILENT FAILURE. The bump is derived from commit messages, and getting it wrong is invisible until it breaks somebody else's build. A BREAKING CHANGE marker written as a FOOTER in the commit body is missed by naive parsers that only check the subject line's exclamation mark — so a major change ships as a minor, and every downstream caret range picks it up automatically. Nothing fails in your repository. It fails in theirs.

Both the marker and the footer trigger a major bump; missing either is the bug. 0.x handling follows the specification rather than the assumption most tools make, and is documented, since a breaking change before 1.0 does not become 1.0 automatically.

A commit that does not match the specification is reported as UNPARSED, never silently dropped and never guessed into a type. A changelog missing entries looks complete.

The spec rules are cited in comments. Takes the commit list as data rather than shelling out to git, so it is testable offline.

VERIFIED: 65 tests, 10/10 mutations caught. Every mutation was observed FAILING before the source was restored — a test never seen to fail is a decoration.

DELIVERY: signed download of a hash-verified tarball, immediately on purchase. Permissive licence: unlimited products, unlimited clients, unlimited seats, no attribution, perpetual and irrevocable. One restriction, do not republish the source as source.

Interface

What you call, and what comes back. Types and signatures only — the implementation ships with the source.

  export function computeBump( commits: ParseResult[], currentVersion: SemVer, zeroMajorPolicy: ZeroMajorPolicy = "strict" ): BumpResult;
  export function buildChangelog(results: ParseResult[], opts: ChangelogOptions): string;
  export function parseCommit(raw: RawCommit): ParseResult;
  export function parseCommits(raws: RawCommit[]): ParseResult[];
  export function parseSemVer(input: string): SemVer;
  export function formatSemVer(v: SemVer): string;
  export function incrementVersion(current: SemVer, type: ReleaseType): SemVer;

  export type ZeroMajorPolicy = "strict" | "hold-major";
  export type ReleaseType = "major" | "minor" | "patch" | "none";
  export type ParseResult = ParsedCommit | UnparsedCommit;