Release Rollback

Rollback Failed Release

Rollback a failed release by deleting the release and reverting version changes.

⚠️ This will delete the release and revert version changes.

Current Situation Check

Check recent tags:

git tag -l --sort=-version:refname | head -5

Review which version needs to be rolled back.

Rollback Process

Step 1: Verify Version to Rollback

Confirm with the user:

• What is the version to rollback?
• Is this the correct version to rollback?

Step 2: Run Rollback Script

Execute the rollback command:

npm run release:rollback <version>

Example:

npm run release:rollback 1.5.0-beta.3

Step 3: What the Script Will Do

The rollback script performs:

• Delete local git tag for specified version
• Delete remote git tag for specified version
• Delete GitHub release for specified version
• Revert version changes in all files
• Clean up RELEASE_NOTES files
• Provide next steps

Step 4: After Rollback

Post-rollback verification:

1. Check GitHub to confirm release is deleted
2. Verify tags are removed: git tag -l
3. Fix the issues that caused the failure
4. Run: npm run release:check to validate fixes

Step 5: Create New Release

Once issues are fixed, create new release:

• For beta: Use release-beta skill
• For stable: Use release-stable skill

Common Rollback Scenarios

Build Failed

• Fix build errors
• Run: npm run build to test
• Run: npm run test:smoke
• Re-run validation

Linting/Type Errors

• Run: npm run lint to auto-fix
• Run: npm run type-check to verify
• Fix reported issues
• Re-run validation

Version Mismatch

• Check all version files are synced:
  • package.json
  • manifest.json
  • const.py
• Re-run bump command

Validation Failed

• Run: npm run release:check
• Address all errors and warnings
• Fix issues systematically
• Re-run validation

Usage Example

# Rollback beta release
/release-rollback 2.0.0-beta.3

# Rollback stable release
/release-rollback 1.5.0

This requires the version number to rollback.

Important Notes

• Destructive operation: Cannot be undone easily
• Confirm version: Double-check before proceeding
• Fix root cause: Address the issue that caused failure
• Re-validate: Run all checks before creating new release
• Communication: If release was public, inform users

Rollback Checklist

Before proceeding with rollback:

• Identified the version to rollback
• Confirmed the version is correct
• Understood why the release failed
• Ready to fix the underlying issue

After rollback:

• Verified tag deletion locally and remotely
• Confirmed GitHub release deletion
• Fixed the root cause issue
• Ran validation checks
• Ready for new release attempt