Surfacenotes generates CHANGELOG.md/RELEASE_NOTES.md from a git commit
range like other changelog tools, but it also parses the package's
public entry file with the real TypeScript compiler at both refs,
structurally diffs the exported API surface, and cross-checks that
against the conventional-commit labels in the same range. A mislabeled
"fix:" that actually removes an export or adds a required parameter
gets a loud warning banner instead of a quiet lie.
Verified against the real git history of the usesend-js SDK
(v1.6.0..v1.7.2, 73 real commits) and against a small synthetic repo
built to prove the breaking-change detector fires correctly.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>