Improve parallel testing and Testbench package mode

.env.example

@@ -40,6 +40,9 @@
 # REDIS_PORT=6379
 # REDIS_PASSWORD=password
 # REDIS_DB=1
+# REDIS_TEST_DB_MIN=1
+# REDIS_TEST_DB_MAX=14
+# REDIS_TEST_SECONDARY_DB=15
 
 # Meilisearch Integration Tests
 # MEILISEARCH_HOST=127.0.0.1

.github/workflows/redis.yml

@@ -59,6 +59,8 @@ jobs:
         env:
           REDIS_HOST: redis
           REDIS_PORT: 6379
+          REDIS_DB: 0
+          REDIS_TEST_SECONDARY_DB: 1
         run: |
           vendor/bin/phpunit tests/Integration/Auth
           vendor/bin/phpunit tests/Integration/Cache/Redis
@@ -116,6 +118,8 @@ jobs:
         env:
           REDIS_HOST: valkey
           REDIS_PORT: 6379
+          REDIS_DB: 0
+          REDIS_TEST_SECONDARY_DB: 1
         run: |
           vendor/bin/phpunit tests/Integration/Auth
           vendor/bin/phpunit tests/Integration/Cache/Redis

.github/workflows/tests.yml

@@ -45,7 +45,14 @@ jobs:
         run: |
             COMPOSER_MEMORY_LIMIT=-1 composer install --prefer-dist -n -o
 
-      - name: Execute tests
-        run: |
-            PHP_CS_FIXER_IGNORE_ENV=1 vendor/bin/php-cs-fixer fix --dry-run --diff
-            vendor/bin/phpunit -c phpunit.xml.dist
+      - name: Check code style
+        run: PHP_CS_FIXER_IGNORE_ENV=1 vendor/bin/php-cs-fixer fix --dry-run --diff
+
+      - name: Run framework test suite
+        run: vendor/bin/phpunit -c phpunit.xml.dist
+
+      - name: Run Testbench package-mode suite
+        run: php src/testbench/bin/testbench package:test --parallel tests/Testbench
+
+      - name: Run Testbench dogfood package suite
+        run: composer test:dogfood

.gitignore

@@ -16,6 +16,9 @@
 /docs/.vuepress/.cache
 /docs/.vuepress/.temp
 /docs/reviews/
+/dogfood/testbench-package/.phpunit.cache/
+/dogfood/testbench-package/composer.lock
+/dogfood/testbench-package/vendor/
 /node_modules
 /src/*/node_modules
 /src/wayfinder/tests/.generated

.php-cs-fixer.php

@@ -107,6 +107,7 @@
             ->exclude('_archive')
             ->exclude('_tmp')
             ->exclude('bin')
+            ->exclude('dogfood/testbench-package/vendor')
             ->exclude('overrides')
             ->exclude('src/testbench/workbench/bootstrap/cache')
             ->exclude('src/testbench/workbench/runtime')

AGENTS.md

@@ -80,7 +80,11 @@ After porting is complete, run phpstan on the newly ported package and fix error
 
 #### 5. Run the full test suite
 
-**Always use `composer test:parallel`** to run the test suite. This invokes `bin/paratest` via a custom wrapper that configures per-worker isolation. Running `vendor/bin/paratest` directly bypasses this setup and will cause failures.
+**Always use `composer test:parallel`** to run the full components test suite. This runs raw ParaTest with Hypervel's parallel testing flag supplied by `phpunit.xml.dist`.
+
+**Always use `composer test:testbench`** after Testbench changes. This runs the scoped Testbench package-mode contract suite through the real `package:test` command.
+
+ParaTest defaults to the machine CPU count when no process count is specified. Redis integration runs need `REDIS_TEST_DB_MIN` / `REDIS_TEST_DB_MAX` to cover the chosen worker count, or an explicit `--processes` / `-p` value that fits the configured range.
 
 Investigate all failures thoroughly — don't assume a failure is caused by the porting work without confirming it. For straightforward fixes (e.g. a missed namespace update), fix and continue. For anything more complex (behavioral changes, test logic issues, unclear root causes), STOP and explain the cause along with your recommended fix for approval.
 

composer.json

@@ -26,9 +26,6 @@
     },
     "autoload": {
         "psr-4": {
-            "Workbench\\App\\": "src/testbench/workbench/app/",
-            "Workbench\\Database\\Factories\\": "src/testbench/workbench/database/factories/",
-            "Workbench\\Database\\Seeders\\": "src/testbench/workbench/database/seeders/",
             "Hypervel\\ApiClient\\": "src/api-client/src/",
             "Hypervel\\Contracts\\": "src/contracts/src/",
             "Hypervel\\Auth\\": "src/auth/src/",
@@ -121,12 +118,19 @@
             "tests/Database/Fixtures/MigrationCreatorFakeMigration.php"
         ],
         "psr-4": {
+            "Workbench\\App\\": "src/testbench/workbench/app/",
+            "Workbench\\Database\\Factories\\": "src/testbench/workbench/database/factories/",
+            "Workbench\\Database\\Seeders\\": "src/testbench/workbench/database/seeders/",
             "Hypervel\\Tests\\": "tests/"
         },
         "classmap": [
             "tests/Validation/Enums.php"
         ]
     },
+    "bin": [
+        "src/facade-documenter/facade.php",
+        "src/testbench/bin/testbench"
+    ],
     "require": {
         "php": ">=8.4",
         "ext-dom": "*",
@@ -363,7 +367,13 @@
     },
     "scripts": {
         "test": "phpunit",
-        "test:parallel": "php bin/paratest",
+        "test:parallel": "paratest",
+        "test:testbench": "php src/testbench/bin/testbench package:test --parallel tests/Testbench",
+        "test:dogfood": [
+            "Composer\\Config::disableProcessTimeout",
+            "composer --working-dir=dogfood/testbench-package install --prefer-dist -n -o",
+            "composer --working-dir=dogfood/testbench-package test"
+        ],
         "analyse": [
             "phpstan analyse",
             "phpstan analyse -c phpstan.types.neon.dist"
@@ -373,13 +383,17 @@
         "facade": "php -f src/facade-documenter/facade.php --",
         "check": [
             "@test",
+            "@test:testbench",
+            "@test:dogfood",
             "@analyse",
             "@lint"
         ],
         "fix": [
             "@lint:fix",
             "@analyse",
-            "@test:parallel"
+            "@test:parallel",
+            "@test:testbench",
+            "@test:dogfood"
         ]
     },
     "minimum-stability": "dev",