feat: enhance release version extraction and hotfix handling in CI wo…

.github/workflows/check-pr-for-release-version.yml

@@ -11,20 +11,31 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Check PR Title or Description
+      - name: Check PR Title, Description, or Hotfix Branch
         run: |
           title="${{ github.event.pull_request.title }}"
           body="${{ github.event.pull_request.body }}"
-          echo "Checking PR title: $title"
-          echo "Checking PR body: $body"
+          head_ref="${{ github.head_ref }}"
 
-          # Regex: Release-x.y.z (case-insensitive, numeric x, y, z of variable length)
+          echo "PR title: $title"
+          echo "PR body: $body"
+          echo "PR source branch: $head_ref"
+
+          # Allow hotfix branches unconditionally
+          if [[ "$head_ref" == hotfix/* ]]; then
+            echo "✅ Hotfix branch detected ($head_ref). Skipping release pattern check."
+            exit 0
+          fi
+
+          # Regex: Release-x.y.z (case-insensitive)
           regex='[Rr][Ee][Ll][Ee][Aa][Ss][Ee]-[0-9]+\.[0-9]+\.[0-9]+'
 
           if [[ "$title" =~ $regex ]] || [[ "$body" =~ $regex ]]; then
             echo "✅ Found valid Release pattern in title or description."
             exit 0
           else
-            echo "❌ Invalid PR. Title or description must contain: Release-x.y.z (e.g., Release-1.2.3)"
+            echo "❌ Invalid PR."
+            echo "   Title or description must contain: Release-x.y.z (e.g., Release-1.2.3)"
+            echo "   OR the branch must start with: hotfix/"
             exit 1
           fi

.github/workflows/create-tag.yml

@@ -22,12 +22,44 @@ jobs:
           fetch-depth: 0
           submodules: recursive
 
-      - name: Extract release version from PR
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.13
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e external/devops
+
+      - name: Extract release version (Release-x.y.z OR hotfix bump)
         id: extract_version
+        shell: bash
         run: |
+          set -euo pipefail
+
           title="${{ github.event.pull_request.title }}"
           body="${{ github.event.pull_request.body }}"
+          head_ref="${{ github.head_ref }}"   # PR source branch name, e.g. hotfix/...
+
+          echo "PR source branch: $head_ref"
+          echo "PR title: $title"
+
+          # Hotfix: version = latest tag + 1 in patch
+          if [[ "$head_ref" == hotfix/* ]]; then
+            echo "✅ Hotfix PR detected. Deducing version from latest tag + patch bump..."
 
+            git fetch --tags --force
+
+            version="$(increase_latest_tag --patch)"
+
+            echo "✅ Hotfix release version: $version"
+            echo "version=$version" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Non-hotfix: expect Release-x.y.z in title/body
           regex='[Rr][Ee][Ll][Ee][Aa][Ss][Ee]-([0-9]+\.[0-9]+\.[0-9]+)'
 
           if [[ "$title" =~ $regex ]]; then
@@ -36,16 +68,18 @@ jobs:
             version="${BASH_REMATCH[1]}"
           else
             echo "❌ No valid release version found in PR title or description."
+            echo "   Expected: Release-x.y.z (e.g., Release-1.2.3)"
+            echo "   Or use a hotfix/* branch to auto-bump patch."
             exit 1
           fi
 
           echo "✅ Found release version: $version"
-          echo "version=$version" >> $GITHUB_OUTPUT
+          echo "version=$version" >> "$GITHUB_OUTPUT"
 
       - name: Update CHANGELOG.md
         run: |
           version="${{ steps.extract_version.outputs.version }}"
-          python3 scripts/update_changelog.py "$version"
+          update_changelog "$version"
 
       - name: Commit and push changelog update
         run: |
@@ -54,16 +88,21 @@ jobs:
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
           git add CHANGELOG.md
-          git commit -m "docs: update changelog for $version"
+          git commit -m "docs: update changelog for $version" || echo "No changes to commit"
           git push origin HEAD:main
 
       - name: Create Git tag
-        id: create_tag
         run: |
           version="${{ steps.extract_version.outputs.version }}"
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
 
+          # Safety: don't fail if tag already exists (e.g., re-runs)
+          if git rev-parse -q --verify "refs/tags/$version" >/dev/null; then
+            echo "Tag $version already exists. Skipping tag creation."
+            exit 0
+          fi
+
           git tag "$version"
           git push origin "$version"
 

CHANGELOG.md

@@ -4,11 +4,11 @@ All notable changes to this project will be documented in this file.
 
 ## Next Release
 
-### DevOps
+### CI
 
 - Add devops python library first version for all kind of custom static code analysis
-- Add "static inline constexpr" as key sequence order cpp rule
-- Add "update_changelog.py" script to update CHANGELOG.md automatically based on version input
+- Add `update_changelog` from devops package to create_tag CI
+- Add hotfix branch release handling to auto increment version patch aka `major.minor.patch`
 
 ### Error Handling