CU-86b7kybxx - feat: implement pre-push hook with branch validation and custom command execution

Author: IUribeSwapps

.dev-hooks.example.yml

@@ -0,0 +1,58 @@
+# Dev Tools Hooks Configuration
+# Copy this file to .dev-hooks.yml in your project root
+
+# Pre-push commands
+# These commands run before pushing to remote
+# If any command fails, the push is aborted
+pre-push:
+  # Enable/disable pre-push checks (default: true)
+  enabled: true
+
+  # Skip branch name validation (default: false)
+  skip_branch_validation: false
+
+  # Commands to run before push
+  # Each command runs in sequence, push is aborted if any fails
+  commands:
+    # Example: Run tests
+    - name: "Run Tests"
+      run: "pytest"
+      # Optional: only run for specific branches (regex)
+      # branches: "^(feat|fix)/.*"
+
+    # Example: Run linter
+    - name: "Lint Check"
+      run: "ruff check src/"
+
+    # Example: Type checking
+    - name: "Type Check"
+      run: "mypy src/"
+      # Optional: allow this command to fail without blocking push
+      allow_failure: false
+
+# Docker support
+# If your project runs in Docker, configure it here
+docker:
+  # Enable docker execution (default: false)
+  enabled: false
+
+  # Container name or service name (for docker-compose)
+  container: "app"
+
+  # Use docker-compose instead of docker exec (default: false)
+  compose: true
+
+  # docker-compose file path (default: docker-compose.yml)
+  compose_file: "docker-compose.yml"
+
+# Examples for different project types:
+
+# --- Python Project ---
+# pre-push:
+#   commands:
+#     - name: "Tests"
+#       run: "pytest -v"
+#     - name: "Lint"
+#       run: "ruff check ."
+#     - name: "Types"
+#       run: "mypy src/"

README.md

@@ -4,9 +4,9 @@ Git hooks for development workflow automation.
 
 ## Features
 
-- **commit-msg**: Validates commit messages follow [Conventional Commits](https://www.conventionalcommits.org/) format
+- **commit-msg**: Validates commit messages follow [Conventional Commits](https://www.conventionalcommits.org/) format (with optional ClickUp ID)
 - **pre-commit**: Runs PHPCS code quality checks for Drupal and WordPress projects
-- **pre-push**: Validates branch naming conventions (ClickUp IDs or conventional format)
+- **pre-push**: Validates branch naming + runs custom commands from config file
 
 ## Installation
 
@@ -62,14 +62,16 @@ Validates that commit messages follow Conventional Commits format:
 
 ```
 <type>(<optional-scope>): <description>
+CU-xxxxxxxxx - <type>(<optional-scope>): <description>
 ```
 
 Valid types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`
 
 Examples:
 - `feat: add user authentication`
 - `fix(api): resolve timeout issue`
-- `docs: update installation guide`
+- `CU-86b7kybxx - feat: add git hooks`
+- `CU-86b7kybxx - fix(auth): resolve login bug`
 
 ### pre-commit
 
@@ -80,14 +82,77 @@ For PHP projects (Drupal/WordPress), automatically:
 
 ### pre-push
 
-Validates branch names follow one of these formats:
-- ClickUp ID: `CU-xxxxxxxxx` (9 alphanumeric characters)
-- Conventional: `<type>/<description>` (e.g., `feat/user-login`, `fix/header-bug`)
-- Special branches: `master`, `main`, `develop`, `staging`, `production`
+1. **Branch validation** - Validates branch names follow one of these formats:
+   - ClickUp ID: `CU-xxxxxxxxx`
+   - Conventional: `<type>/<description>` (e.g., `feat/user-login`, `fix/header-bug`)
+   - Special branches: `master`, `main`, `develop`, `staging`, `production`
+
+2. **Custom commands** - Runs commands defined in `.dev-hooks.yml` before pushing
+
+## Configuration File
+
+Create a `.dev-hooks.yml` file in your project root to configure custom pre-push commands.
+
+Copy the example file to get started:
+
+```bash
+cp .dev-hooks.example.yml .dev-hooks.yml
+```
+
+### Example Configuration
+
+```yaml
+# Pre-push commands
+pre-push:
+  enabled: true
+  skip_branch_validation: false
+
+  commands:
+    - name: "Run Tests"
+      run: "pytest"
+
+    - name: "Lint Check"
+      run: "ruff check src/"
+
+    - name: "Type Check"
+      run: "mypy src/"
+
+# Docker support (optional)
+docker:
+  enabled: false
+  compose: true
+  container: "app"
+  compose_file: "docker-compose.yml"
+```
+
+### Docker Support
+
+For dockerized projects, enable docker execution:
+
+```yaml
+docker:
+  enabled: true
+  compose: true
+  container: "php"
+
+pre-push:
+  commands:
+    - name: "PHPUnit"
+      run: "vendor/bin/phpunit"
+```
+
+Commands will be executed inside the container:
+```bash
+docker-compose exec -T php vendor/bin/phpunit
+```
 
 ## Development
 
 ```bash
+# Create virtual environment
+python3 -m venv venv
+source venv/bin/activate
+
 # Install in development mode
 pip install -e .