Adding branch name validation.

Author: omerida

composer.json

@@ -59,6 +59,7 @@
         "vendor/bin/phpcs --filter=GitStaged"
       ],
       "pre-push": [
+        "scripts/pre-push-branch-check.sh",
         "vendor/bin/phpstan"
       ]
     }

scripts/pre-push-branch-check.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# Git pre-push hook for validating branch names.
+
+# --- Configuration ---
+BRANCH_REGEX="^(task|bug|feature)/[0-9]+-[a-zA-Z0-9-]+$"
+
+# --- Script Logic ---
+
+# Get the name of the current branch
+CURRENT_BRANCH=$(git symbolic-ref --short HEAD)
+
+# Exclude main branch from validation
+EXCLUDED_BRANCHES=("main")
+
+# Check if the current branch is one of the excluded branches
+for EXCLUDED in "${EXCLUDED_BRANCHES[@]}"; do
+    if [[ "$CURRENT_BRANCH" == "$EXCLUDED" ]]; then
+        echo "Skipping branch name validation for protected branch: $CURRENT_BRANCH"
+        exit 0
+    fi
+done
+
+# Validate the current branch name against the regex
+if [[ "$CURRENT_BRANCH" =~ $BRANCH_REGEX ]]; then
+    echo "Branch name '$CURRENT_BRANCH' is valid. Push allowed."
+    exit 0
+else
+    echo "--------------------------------------------------------"
+    echo "PUSH FAILED: Invalid branch name format."
+    echo "Branch: $CURRENT_BRANCH"
+    echo "--------------------------------------------------------"
+    echo "Branch naming rules are:"
+    echo "1. Must start with 'task/', 'bug/', or 'feature/'"
+    echo "2. Must include an issue number (digits) followed by a dash."
+    echo "3. Must end with a descriptive slug (letters, numbers, dashes)."
+    echo ""
+    echo "Examples of valid names:"
+    echo " - feature/123-add-user-profile"
+    echo " - bug/45-fix-login-redirect"
+    echo " - task/789-update-composer-deps"
+    echo "--------------------------------------------------------"
+    # Exit with a non-zero status to abort the push
+    exit 1
+fi