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

Author: AlexSkrypnyk

.vortex/CLAUDE.md

@@ -102,8 +102,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
 ```
@@ -112,7 +114,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
 
@@ -174,7 +176,22 @@ composer install                    # Install dependencies
 UPDATE_SNAPSHOTS=1 composer test    # Update test snapshots
 ```
 
-### 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
 
@@ -208,7 +225,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/)
 
@@ -248,7 +265,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
 
@@ -266,7 +287,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
 
@@ -632,12 +653,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
@@ -646,13 +668,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
 ```
@@ -1669,10 +1692,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/CLAUDE.md

@@ -329,6 +329,7 @@ public static function dataProviderMockShellExec(): array {
 This replaces 4 separate test methods with a single parameterized test.
 
 **Documentation**:
+- Data provider method names should start with `dataProvider` prefix (e.g., `dataProviderHttpMethods`, not `providerHttpMethods`)
 - Block comments (PHPDoc /** ... */) are ONLY allowed on test classes, NOT on methods
 - Do NOT add block comments to test methods, data provider methods, or helper methods
 - Inline comments (// ...) are acceptable for explaining logic within method bodies
@@ -485,15 +486,15 @@ The mock API mirrors the actual request function signatures for consistency and
 ```php
 // Mock request() - matches request() signature + $response parameter
 mockRequest(
-  string $deploy_webhook_url,
+  string $url,
   array $options = [],
   array $response = [],
   string $namespace = 'DrevOps\\VortexTooling'
 ): void
 
 // Mock request_get() - matches request_get() signature + $response parameter
 mockRequestGet(
-  string $deploy_webhook_url,
+  string $url,
   array $headers = [],
   int $timeout = 10,
   array $response = [],
@@ -502,7 +503,7 @@ mockRequestGet(
 
 // Mock request_post() - matches request_post() signature + $response parameter
 mockRequestPost(
-  string $deploy_webhook_url,
+  string $url,
   $body = NULL,
   array $headers = [],
   int $timeout = 10,

.vortex/tooling/rector.php

@@ -18,6 +18,7 @@
 use Rector\CodingStyle\Rector\Catch_\CatchExceptionNameMatchingTypeRector;
 use Rector\CodingStyle\Rector\ClassMethod\NewlineBeforeNewAssignSetRector;
 use Rector\CodingStyle\Rector\FuncCall\CountArrayToEmptyArrayComparisonRector;
+use Rector\CodingStyle\Rector\FunctionLike\FunctionLikeToFirstClassCallableRector;
 use Rector\CodingStyle\Rector\Stmt\NewlineAfterStatementRector;
 use Rector\Config\RectorConfig;
 use Rector\DeadCode\Rector\If_\RemoveAlwaysTrueIfConditionRector;
@@ -27,6 +28,7 @@
 use Rector\Naming\Rector\ClassMethod\RenameVariableToMatchNewTypeRector;
 use Rector\Php55\Rector\String_\StringClassNameToClassConstantRector;
 use Rector\Php80\Rector\Switch_\ChangeSwitchToMatchRector;
+use Rector\Php81\Rector\Array_\FirstClassCallableRector;
 use Rector\Privatization\Rector\ClassMethod\PrivatizeFinalClassMethodRector;
 use Rector\Privatization\Rector\MethodCall\PrivatizeLocalGetterToPropertyRector;
 use Rector\Privatization\Rector\Property\PrivatizeFinalClassPropertyRector;
@@ -53,6 +55,8 @@
     CompleteDynamicPropertiesRector::class,
     CountArrayToEmptyArrayComparisonRector::class,
     DisallowedEmptyRuleFixerRector::class,
+    FirstClassCallableRector::class,
+    FunctionLikeToFirstClassCallableRector::class,
     InlineArrayReturnAssignRector::class,
     NewlineAfterStatementRector::class,
     NewlineBeforeNewAssignSetRector::class,