[#1192] Added drevops/vortex-tooling codebase.

Author: AlexSkrypnyk

.github/workflows/vortex-test-tooling.yml

@@ -0,0 +1,72 @@
+# This action is used for Vortex maintenance. It will not be used in the scaffolded project.
+name: Vortex - Test tooling
+
+on:
+  push:
+    branches:
+      - develop
+  pull_request:
+    branches:
+      - develop
+      - 'feature/**'
+      - 'bugfix/**'
+
+jobs:
+  vortex-test-tooling:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        php-versions: ['8.3', '8.4', '8.5']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@93cb6efe18208431cddfb8368fd83d5badbf9bfd # v5
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@bf6b4fbd49ca58e4608c9c89fba0b8d90bd2a39f # v2
+        with:
+          php-version: ${{ matrix.php-versions }}
+          coverage: pcov
+          ini-values: pcov.directory=.
+
+      - name: Setup Node.js
+        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6
+        with:
+          node-version: 22.17.1
+
+      - name: Set default branch name
+        run: git config --global init.defaultBranch >/dev/null || git config --global init.defaultBranch "main"
+
+      - name: Install dependencies
+        run: composer install
+        working-directory: .vortex/tooling
+
+      - name: Validate Composer configuration is normalized
+        run: composer normalize --dry-run
+        working-directory: .vortex/tooling
+
+      - name: Check coding standards
+        run: composer lint
+        working-directory: .vortex/tooling
+
+      - name: Run tests
+        run: composer test-coverage
+        working-directory: .vortex/tooling
+        env:
+          GITHUB_TOKEN: ${{ secrets.PACKAGE_TOKEN }}
+
+      - name: Upload coverage reports as an artifact
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        with:
+          name: ${{github.job}}-code-coverage-report-${{ matrix.php-versions }}
+          path: .vortex/tooling/.logs
+          include-hidden-files: true
+          if-no-files-found: error
+
+      - name: Upload coverage report to Codecov
+        uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5
+        with:
+          files: .vortex/tooling/.logs/cobertura.xml
+          fail_ci_if_error: true
+          token: ${{ secrets.CODECOV_TOKEN }}

.vortex/CLAUDE.md

@@ -15,8 +15,10 @@ vortex/
 ├── .vortex/                    # Test harness and development tools
 │   ├── docs/                   # Documentation for Vortex
 │   ├── installer/              # Self-contained Symfony console installer
+│   ├── tooling/                # PHP helpers and notification scripts
+│   │   └── CLAUDE.md           # Tooling documentation (see this for tooling work)
 │   ├── tests/                  # Unit and functional tests
-│   └── CLAUDE.md              # This maintenance guide
+│   └── CLAUDE.md               # This maintenance guide
 └── [root files]                # The actual Drupal template
     └── CLAUDE.md               # Drupal development guide
 ```
@@ -25,7 +27,7 @@ vortex/
 
 ## .vortex Directory Structure
 
-The `.vortex/` directory contains **three distinct subsystems**, each with its own purpose and technology stack:
+The `.vortex/` directory contains **four distinct subsystems**, each with its own purpose and technology stack:
 
 ### 1. .vortex/docs/ - Documentation Website
 
@@ -87,7 +89,22 @@ composer install                    # Install dependencies
 UPDATE_FIXTURES=1 composer test    # Update test fixtures
 ```
 
-### 3. .vortex/tests/ - Template Testing Harness
+### 3. .vortex/tooling/ - Notification & Helper Scripts
+
+**Purpose**: Reusable PHP helper functions and notification scripts for Vortex operations
+
+> **⚠️ ALL TOOLING DOCUMENTATION IS IN `.vortex/tooling/CLAUDE.md`**
+>
+> For ANY work related to:
+>
+> - PHP helper functions (request_get, request_post, output formatters, etc.)
+> - Notification scripts (notify-github, notify-jira, notify-slack, etc.)
+> - Mock system (MockTrait, Self tests)
+> - Tooling tests
+>
+> **→ See `.vortex/tooling/CLAUDE.md` for complete documentation**
+
+### 4. .vortex/tests/ - Template Testing Harness
 
 **Purpose**: Comprehensive testing of the Vortex template itself through functional workflows
 
@@ -121,7 +138,7 @@ cd tests && ./vendor/bin/phpunit      # Run PHPUnit workflow tests
 
 ## Testing Architecture Overview
 
-Vortex uses **four independent testing systems**, each serving different parts of the codebase:
+Vortex uses **five independent testing systems**, each serving different parts of the codebase:
 
 ### 1. Documentation Tests (.vortex/docs/)
 
@@ -161,7 +178,11 @@ Vortex uses **four independent testing systems**, each serving different parts o
 - **Handler tests**: Individual prompt and modification logic
 - **Fixture tests**: Expected vs actual template output
 
-### 3. Template Tests (.vortex/tests/)
+### 3. Tooling Tests (.vortex/tooling/)
+
+> **→ See `.vortex/tooling/CLAUDE.md`** for all tooling test documentation
+
+### 4. Template Tests (.vortex/tests/)
 
 **Scope**: Testing the actual Drupal template functionality
 
@@ -179,7 +200,7 @@ Vortex uses **four independent testing systems**, each serving different parts o
 - **PHPUnit Functional**: End-to-end workflow testing
 - **BATS Unit**: Individual shell script testing with mocking
 
-### 4. Manual Integration Tests (.vortex/tests/manual/)
+### 5. Manual Integration Tests (.vortex/tests/manual/)
 
 **Scope**: Manual verification of notification integrations with real external services
 
@@ -545,12 +566,13 @@ When script output changes, update corresponding test files:
 
 1. **Documentation** (`.vortex/docs/`): Requires Node.js/Yarn
 2. **Installer** (`.vortex/installer/`): Requires PHP/Composer
-3. **Template** (`.vortex/tests/`): Requires PHP/Composer + Node.js + BATS
+3. **Tooling** (`.vortex/tooling/`): Requires PHP/Composer
+4. **Template** (`.vortex/tests/`): Requires PHP/Composer + Node.js + BATS
 
 **Full Setup** (from `.vortex/`):
 
 ```bash
-ahoy install        # Installs dependencies for all three systems
+ahoy install        # Installs dependencies for all four systems
 ```
 
 ## Unified Testing Commands
@@ -559,13 +581,14 @@ For convenience, you can run tests across all systems:
 
 ```bash
 # From .vortex/ root
-ahoy install        # Install all dependencies (docs, installer, template)
+ahoy install        # Install all dependencies (docs, installer, tooling, template)
 ahoy lint           # Code linting across all systems
 ahoy test           # Run all template tests
 
 # Individual system commands
 cd docs && yarn test                    # Documentation tests only
 cd installer && composer test           # Installer tests only
+cd tooling && ./vendor/bin/phpunit     # Tooling tests only
 cd tests && ./vendor/bin/phpunit       # Template PHPUnit tests only
 ahoy test-bats -- tests/bats/          # Template BATS tests only
 ```
@@ -1581,10 +1604,10 @@ throw new \RuntimeException(sprintf(
 ### Cross-System Considerations
 
 - Each system can be modified independently
-- Changes to template (outside `.vortex/`) may require updates across all three systems
+- Changes to template (outside `.vortex/`) may require updates across all four systems
 - Always run system-specific tests after making changes
 - Consider impact on user workflows when modifying any system
 
 ---
 
-*This knowledge base should be updated whenever significant changes are made to any of the three Vortex subsystems or their maintenance procedures.*
+*This knowledge base should be updated whenever significant changes are made to any of the four Vortex subsystems or their maintenance procedures.*

.vortex/tooling/.gitignore

@@ -0,0 +1,3 @@
+vendor
+composer.lock
+.logs