fix: resolve GitHub Actions workflow version detection and error handling issues (#23)

* fix: correct version bump detection logic in GitHub Actions workflow

- Fix conditional logic that incorrectly detected version bump requirements
- Change from exit code checking to output pattern matching for cz bump --dry-run
- Improve error handling with proper stderr capture (2>&1)
- Add clearer logging messages for version bump decisions
- Handle changelog generation failures gracefully

The previous logic failed because cz bump --dry-run returns non-zero exit code
even when version bump is needed, due to changelog generation errors.
Now we check for 'bump: version' pattern in output instead of exit code.

Fixes the issue where workflow showed 'No version bump needed' while actually
detecting version changes (e.g., 0.2.0 → 0.2.1 PATCH increment).

* fix: add comprehensive error handling and debugging for commitizen workflow

- Add fallback manual tag creation when commitizen bump fails
- Include detailed debugging information for CI environment
- Display commitizen config, git status, tags, and recent commits
- Improve error handling with graceful fallbacks
- Add informative logging with emoji indicators for better readability

This should resolve the 'exit code 16' errors by providing alternative
tag creation methods and better visibility into CI environment state.

* fix: improve error handling for commitizen dry-run failures

- Add conditional error handling for cz bump --dry-run
- Use 'true' fallback to prevent script exit on commitizen errors
- Better logging of exit codes and error conditions
- Ensure version detection continues even if commitizen returns non-zero

This should prevent the workflow from failing due to commitizen exit code 16
while still capturing and processing the version bump information.

* fix: add tag existence check to prevent duplicate tag errors

- Check if tag already exists before manual creation
- Graceful handling when target tag already present
- Prevent 'tag already exists' fatal errors
- Better logging for tag creation status

This resolves the 'fatal: tag already exists' error that occurs
when attempting to create tags that were previously created.

* fix: test version bump calculation from 0.2.0 baseline

This commit should trigger a PATCH version bump from 0.2.0 → 0.2.1

* chore: remove test file used for version bump validation

---------

Signed-off-by: 拐爷&&老拐瘦 <[email protected]>

Author: yfge

.github/workflows/release.yml

@@ -69,7 +69,32 @@ jobs:
           # No pyproject.toml version updates needed - everything is tag-driven
 
           # Check if there are commits that warrant a version bump
-          DRY_RUN_OUTPUT=$(cz bump --dry-run 2>&1)
+
+          echo "🔍 Checking for conventional commits that warrant version bump..."
+          echo "📋 Current commitizen config:"
+          cz info || echo "⚠️ Commitizen info failed"
+
+          echo "📊 Current git status:"
+          git status --porcelain
+
+          echo "🏷️ Current tags:"
+          git tag -l --sort=-version:refname | head -5
+
+          echo "📝 Recent commits:"
+          git log --oneline -5
+
+          # Try commitizen dry-run with error handling
+          if DRY_RUN_OUTPUT=$(cz bump --dry-run 2>&1); then
+            echo "🧪 Commitizen dry-run output:"
+            echo "$DRY_RUN_OUTPUT"
+          else
+            echo "⚠️ Commitizen dry-run failed with exit code $?, trying alternative detection..."
+            DRY_RUN_OUTPUT=$(cz bump --dry-run 2>&1 || true)
+            echo "🧪 Commitizen dry-run output (with errors):"
+            echo "$DRY_RUN_OUTPUT"
+          fi
+
+
           if echo "$DRY_RUN_OUTPUT" | grep -q "bump: version"; then
             echo "bump_needed=true" >> $GITHUB_OUTPUT
             echo "Version bump detected based on conventional commits"
@@ -88,7 +113,23 @@ jobs:
             # Create ONLY git tag - no file modifications needed
             # All version info comes from git tags via dynamic version detection
             echo "Creating git tag..."
-            cz bump --yes
+
+
+            # Try commitizen bump with error handling
+            if ! cz bump --yes; then
+              echo "⚠️ Commitizen bump failed, trying manual tag creation..."
+
+              # Manual tag creation as fallback
+              if git tag -l | grep -q "^v$NEW_VERSION$"; then
+                echo "⚠️ Tag v$NEW_VERSION already exists, skipping tag creation"
+              else
+                git tag "v$NEW_VERSION" -m "bump: version $(git describe --tags --abbrev=0 2>/dev/null || echo '0.0.0') → $NEW_VERSION"
+                echo "✅ Manual tag created: v$NEW_VERSION"
+              fi
+            else
+              echo "✅ Commitizen tag created successfully"
+            fi
+
 
             # Push based on branch protection status
             if [ "${{ steps.branch-protection.outputs.can_push_directly }}" = "true" ]; then