kotadb: Command for Claude Code

/release

Template Category: Action

Create a production release by merging develop → main with automated versioning, validation, and GitHub release creation.

Pre-Release Validation

Before creating a release, the command performs comprehensive checks:

1. Clean Working Tree: Ensure no uncommitted changes (git status --short must be empty)
2. CI Status: Verify all GitHub Actions are passing on develop branch
3. Migration Sync: Run bun run test:validate-migrations to check drift
4. Type Checking: Execute bunx tsc --noEmit for type safety
5. SQLite Schema Validation: Verify database schema is correct
6. Health Checks: Verify API endpoints are responding correctly

Version Bumping

Prompt user for version bump type:

• major: Breaking changes (1.0.0 → 2.0.0)
• minor: New features, backward compatible (1.0.0 → 1.1.0)
• patch: Bug fixes, backward compatible (1.0.0 → 1.0.1)

Updates:

• app/package.json version field
• Creates version bump commit: chore: bump version to X.Y.Z

Release Process

Step 1: Prepare Release Branch

git checkout develop
git pull --rebase origin develop
git checkout -b release/vX.Y.Z

Step 2: Update Version

cd app
# Update package.json version
bun run version <major|minor|patch>
# Commit version change
git add package.json
git commit -m "chore: bump version to X.Y.Z"

Step 3: Generate Changelog

Extract commits from develop since last release:

git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges

Group by type:

• Features: commits starting with feat:
• Bug Fixes: commits starting with fix:
• Chore: commits starting with chore:
• Documentation: commits starting with docs:
• Performance: commits starting with perf:
• Refactor: commits starting with refactor:

Format as markdown for release notes.

Step 4: Create Release PR

git push -u origin release/vX.Y.Z
gh pr create \
  --base main \
  --head release/vX.Y.Z \
  --title "Release vX.Y.Z" \
  --body "$(cat <<'EOF'
## Release vX.Y.Z

### Summary
Brief description of release highlights

### Changelog
<Generated changelog from commits>

### Pre-Release Checklist
- [x] All CI checks passing on develop
- [x] Clean working tree verified
- [x] Migration sync validated
- [x] Type checking passed
- [x] SQLite schema validated
- [x] Health checks passed locally

### Deployment Plan
1. Merge this PR to main
2. Create GitHub release for distribution
3. Monitor logs for errors
4. Verify local health checks pass

### Rollback Plan
If issues arise:
1. Revert merge commit on main
2. Redeploy previous version
3. Create hotfix branch from main for urgent fixes

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"