# /release — Create a GitHub Release Creates a tagged release on GitHub with auto-generated release notes from merged PRs. ## Trigger Use when asked to create a release, tag a release, cut a release, or ship a version. ## Arguments Optional: version bump type or explicit version. - `patch` (default) — bump patch: v1.16.14 -> v1.16.15 - `minor` — bump minor: v1.16.14 -> v1.17.0 - `major` — bump major: v1.16.14 -> v2.0.0 - `vX.Y.Z` — explicit version ## Workflow ### 1. Determine Current Version ```bash git fetch --tags origin LATEST=$(git tag --sort=-v:refname | head -1) echo "Latest tag: $LATEST" ``` ### 2. Verify Main is Clean ```bash git checkout main git pull origin main ``` Ensure there are unreleased commits: ```bash git log $LATEST..main --oneline ``` If no new commits, stop and inform the user. ### 3. Compute Next Version Parse the latest tag (format: `vMAJOR.MINOR.PATCH`) and bump based on the argument: - Default (no arg or `patch`): increment PATCH - `minor`: increment MINOR, reset PATCH to 0 - `major`: increment MAJOR, reset MINOR and PATCH to 0 - Explicit `vX.Y.Z`: use as-is Confirm the new version with the user before proceeding. ### 4. Collect Release Notes Get merged PRs since the last release: ```bash gh pr list --state merged --base main \ --search "merged:>$(gh release view $LATEST --json publishedAt -q '.publishedAt' | cut -dT -f1)" \ --json number,title,author \ --jq '.[] | "* \(.title) by @\(.author.login) in #\(.number)"' ``` Format release notes as: ``` ## What's Changed * by @ in https://github.com///pull/ ... **Full Changelog**: https://github.com///compare/... ``` ### 5. Create the Release ```bash gh release create \ --title "" \ --notes "$(cat <<'EOF' EOF )" ``` This creates both the git tag and the GitHub release in one step. ### 6. Verify ```bash gh release view ``` ### 7. Report Return the release URL and a summary of what was included. ## Version Scheme This project uses semantic versioning: `vMAJOR.MINOR.PATCH` - **PATCH**: Bug fixes, small improvements, refactoring, doc updates - **MINOR**: New features, new public APIs, new CLI commands/flags - **MAJOR**: Breaking changes to Go API or Lisp language semantics ## Checklist - [ ] On main branch with latest pulled - [ ] New commits exist since last release - [ ] Version number confirmed with user - [ ] Release notes include all merged PRs - [ ] Release created successfully - [ ] Release URL returned to user

/release — Create a GitHub Release

Scan your own AI components