Bump Version

Fails → Stop: "Failed to pull latest code. Please resolve conflicts or network issues first."

Step 3: Determine Target Version

Read package.json → extract version field.

• Argument provided → use as-is
• No argument → parse major.minor.patch, increment patch by 1

Display: "Bumping version: {current} → {target}"

Step 4: Update package.json

Use Edit tool to replace:

• old: "version": "{current}"
• new: "version": "{target}"

Step 5: Quality Checks

bun run lint
bun run format
bunx tsc --noEmit

• lint fails → Stop: "Lint errors found. Please fix them before bumping the version."
• format → Auto-fixes silently.
• tsc fails → Stop: "TypeScript errors found. Please fix them before bumping the version."

Step 6: Run Tests

bunx vitest run

Fails → Stop: "Tests failed. Please fix failing tests before bumping the version."

Step 7: Branch, Commit, Push

git checkout -b chore/bump-version-{target}
git add -A
git commit -m "chore: bump version to {target}"
git push -u origin chore/bump-version-{target}

Step 8: Create PR

gh pr create --base main \
  --title "chore: bump version to {target}" \
  --body "Bump version to {target}"

Display PR URL. Then pause:

"PR created: {URL}. Please notify a team member to merge it, then confirm to continue."

Wait for user confirmation before proceeding.

Step 9: Cleanup After Merge

git checkout main
git pull --rebase origin main
git branch -d chore/bump-version-{target}

Check if remote branch still exists:

git ls-remote --heads origin chore/bump-version-{target}

• Has output → delete remote: git push origin --delete chore/bump-version-{target}
• No output → skip.

Step 10: Create and Push Tag

git tag v{target}
git push origin v{target}

Display: "Tag v{target} created and pushed. Version bump complete!"

Quick Reference

1. Must be on clean main
2. git pull --rebase
3. Determine target version
4. Edit package.json
5. lint + format + tsc
6. vitest run
7. branch chore/bump-version-{target} → commit → push
8. gh pr create → wait for merge
9. checkout main → pull → delete branch
10. git tag v{target} && git push origin v{target}