Hunk uses Changesets for release-note fragments and npm version preparation.

For user-visible changes, add a changeset instead of editing CHANGELOG.md directly:

bun run changeset

Select hunkdiff and choose the semver bump that matches the shipped CLI/package change:

• patch for fixes and small behavior changes
• minor for new user-facing features
• major for breaking changes

package.json intentionally lists "." in workspaces so Changesets can discover the root hunkdiff package. Keep that entry unless Hunk moves the publishable package out of the repository root.

For maintenance-only PRs that should not appear in release notes, create an empty changeset:

bun run changeset -- --empty

Release prep runs:

bun run release:version

That consumes the pending .changeset/*.md files, updates CHANGELOG.md, and bumps package versions for the release commit.

After the tag release publishes npm packages and GitHub release assets, verify Homebrew through Homebrew/homebrew-core. Hunk is on Homebrew's Autobump list, so do not open manual simple version-bump PRs. Wait for the automated hunk <version> PR, confirm it merges, then verify brew install hunk resolves to the released version. Use brew bump-formula-pr hunk --version <version> only if Homebrew maintainers ask for a manual bump or Autobump stalls unexpectedly.