Prepare a Release

When preparing a release:

1. Ensure main is green: all tests pass, CI is clean, no known blocking bugs.
2. Determine the version number based on the changes since the last release (major, minor, or patch).
3. Update the changelog with all user-facing changes, grouped by type (Added, Changed, Fixed, Removed).
4. Update the version number in package.json, version files, or wherever it’s tracked.
5. Create a single release commit: “Release vX.Y.Z”.
6. Tag the commit: git tag -a vX.Y.Z -m "Release vX.Y.Z".
7. Push the commit and tag: git push origin main --tags.
8. Verify the release pipeline runs successfully.