Fix: Only update branch alias on major releases (#225)

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Author: Copilot

.github/workflows/reusable-check-branch-alias.yml

@@ -64,18 +64,23 @@ jobs:
           VERSION="${VERSION%%+*}"
           
           # Parse major, minor, and patch versions
-          IFS='.' read -r MAJOR MINOR _ <<< "$VERSION"
+          IFS='.' read -r MAJOR MINOR PATCH <<< "$VERSION"
           
-          # Validate that MAJOR and MINOR are numeric
-          if ! [[ "$MAJOR" =~ ^[0-9]+$ ]] || ! [[ "$MINOR" =~ ^[0-9]+$ ]]; then
+          # Validate that MAJOR, MINOR, and PATCH are numeric
+          if ! [[ "$MAJOR" =~ ^[0-9]+$ ]] || ! [[ "$MINOR" =~ ^[0-9]+$ ]] || ! [[ "$PATCH" =~ ^[0-9]+$ ]]; then
             echo "Invalid version format: $VERSION"
             echo "needs_update=false" >> "$GITHUB_OUTPUT"
             exit 0
           fi
           
-          # Calculate next minor version
-          NEXT_MINOR=$((MINOR + 1))
-          EXPECTED_ALIAS="${MAJOR}.${NEXT_MINOR}.x-dev"
+          # Only update branch alias for major releases (minor and patch releases should keep the existing alias)
+          if [ "$MINOR" != "0" ] || [ "$PATCH" != "0" ]; then
+            echo "Not a major release (v${MAJOR}.0.0), skipping branch-alias update"
+            echo "needs_update=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          
+          EXPECTED_ALIAS="${MAJOR}.x-dev"
           
           echo "Expected branch-alias: $EXPECTED_ALIAS"
           
@@ -137,7 +142,7 @@ jobs:
             - Previous branch-alias: `${{ steps.check_alias.outputs.current_alias }}`
             - Updated branch-alias: `${{ steps.check_alias.outputs.expected_alias }}`
             
-            The branch-alias should point to the next minor development version after the latest release.
+            The branch-alias should point to the major development version for the latest major release.
           branch: update-branch-alias
           delete-branch: true
           labels: |

README.md

@@ -23,13 +23,13 @@ This repository contains reusable GitHub Actions workflows that are automaticall
 
 The branch alias checker workflow automatically ensures that the Composer `branch-alias` in each repository's `composer.json` is up-to-date. It:
 
-1. Runs weekly (every Monday at 2 AM UTC) or can be triggered manually
+1. Runs on every release or can be triggered manually
 2. Checks the latest release tag
-3. Calculates the expected branch-alias (next minor version after the latest release)
-4. Compares with the current branch-alias
+3. On a new major release (`vX.0.0`), updates the branch-alias to `X.x-dev`
+4. Skips minor and patch releases, as the branch-alias should remain unchanged
 5. Creates a pull request if an update is needed
 
-For example, if a repository has released version `2.12.0`, the branch-alias should be set to `2.13.x-dev` to point to the next development version.
+For example, if a repository releases `v2.2.6` or `v2.3.0`, the branch-alias stays at `2.x-dev`. Only when releasing `v3.0.0` should it change to `3.x-dev`.
 
 ## Installing