fix: implement automated version management to prevent version mismatches

Fixes #27

## Problem
Version 2.5.5 was displaying as 2.5.0 in the updater because package.json
wasn't updated when the git tag was created.

## Solution
This PR implements a comprehensive automated version management system:

### 1. Version Bump Script (scripts/bump-version.js)
- Automates version updates in package.json
- Creates git commits and tags automatically
- Prevents human error in version management
- Supports semver bumps (major/minor/patch) or specific versions

### 2. Version Validation Workflow (.github/workflows/validate-version.yml)
- Runs automatically on every git tag push
- Validates package.json version matches the git tag
- Fails CI if versions mismatch with clear error messages
- Prevents releases with incorrect versions

### 3. Documentation (RELEASE.md)
- Complete release process guide
- Troubleshooting for version issues
- Release checklist

### 4. Updated package.json
- Fixed current version from 2.5.0 to 2.5.5

## Impact
- ✅ Prevents version mismatch issues from happening again
- ✅ Automates release process
- ✅ CI validation catches manual errors
- ✅ Clear documentation for maintainers
This commit is contained in:
adryserage
2025-12-19 07:52:06 -05:00
parent 01a4eb6bbf
commit cece172df6
5 changed files with 452 additions and 1 deletions
+71
View File
@@ -0,0 +1,71 @@
name: Validate Version
on:
push:
tags:
- 'v*'
jobs:
validate-version:
name: Validate package.json version matches tag
runs-on: ubuntu-latest
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Extract version from tag
id: tag_version
run: |
# Extract version from tag (e.g., v2.5.5 -> 2.5.5)
TAG_VERSION=${GITHUB_REF#refs/tags/v}
echo "version=$TAG_VERSION" >> $GITHUB_OUTPUT
echo "Tag version: $TAG_VERSION"
- name: Extract version from package.json
id: package_version
run: |
# Read version from package.json
PACKAGE_VERSION=$(node -p "require('./auto-claude-ui/package.json').version")
echo "version=$PACKAGE_VERSION" >> $GITHUB_OUTPUT
echo "Package.json version: $PACKAGE_VERSION"
- name: Compare versions
run: |
TAG_VERSION="${{ steps.tag_version.outputs.version }}"
PACKAGE_VERSION="${{ steps.package_version.outputs.version }}"
echo "=========================================="
echo "Version Validation"
echo "=========================================="
echo "Git tag version: v$TAG_VERSION"
echo "package.json version: $PACKAGE_VERSION"
echo "=========================================="
if [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
echo ""
echo "❌ ERROR: Version mismatch detected!"
echo ""
echo "The version in package.json ($PACKAGE_VERSION) does not match"
echo "the git tag version ($TAG_VERSION)."
echo ""
echo "To fix this:"
echo " 1. Delete this tag: git tag -d v$TAG_VERSION"
echo " 2. Update package.json version to $TAG_VERSION"
echo " 3. Commit the change"
echo " 4. Recreate the tag: git tag -a v$TAG_VERSION -m 'Release v$TAG_VERSION'"
echo ""
echo "Or use the automated script:"
echo " node scripts/bump-version.js $TAG_VERSION"
echo ""
exit 1
fi
echo ""
echo "✅ SUCCESS: Versions match!"
echo ""
- name: Version validation result
if: success()
run: |
echo "::notice::Version validation passed - package.json version matches tag v${{ steps.tag_version.outputs.version }}"