# Releasing 1. Confirm `main` is green: `gh run list --workflow CI --limit 5`. 2. Bump `package.json` to the release version. 3. Build release metadata before tagging: `bun run changelog:build --version ` 4. Review `CHANGELOG.md`. 5. Run release gate locally: `bun run changelog:check --version ` `bun run verify:config-example` `bun run test:fast` `bun run typecheck` 6. Commit release prep. 7. Tag the commit: `git tag v`. 8. Push commit + tag. Notes: - `changelog:check` now rejects tag/package version mismatches. - Do not tag while `changes/*.md` fragments still exist.