From c02bfc4892f75a0d1bcd35b2bd3d2bb86ba1e353 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 12:16:18 -0400
Subject: [PATCH 01/21] Remove duplicate relationship wif user

---
 database/migrations/0003_01_01_000001_create_users_table.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/database/migrations/0003_01_01_000001_create_users_table.php b/database/migrations/0003_01_01_000001_create_users_table.php
index b4327610..b49bdb87 100644
--- a/database/migrations/0003_01_01_000001_create_users_table.php
+++ b/database/migrations/0003_01_01_000001_create_users_table.php
@@ -15,7 +15,6 @@ public function up(): void
             $table->string('email')->unique();
             $table->timestamp('email_verified_at')->nullable();
             $table->string('password');
-            $table->foreignId('registration_client_id')->constrained('clients');
             $table->foreignId('agent_id')->nullable()->unique()->index()->constrained('agents');
             $table->text('bio')->nullable();
             $table->json('social_links')->nullable();

From 8885e783730dc9d9fd59eed66fc60e49c20c22db Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 12:50:35 -0400
Subject: [PATCH 02/21] Stub application model

---
 .../Controllers/ApplicationController.php     | 50 ++++++++++++++
 app/Http/Requests/StoreApplicationRequest.php | 28 ++++++++
 .../Requests/UpdateApplicationRequest.php     | 28 ++++++++
 app/Models/Application.php                    | 12 ++++
 app/Policies/ApplicationPolicy.php            | 66 +++++++++++++++++++
 database/factories/ApplicationFactory.php     | 33 ++++++++++
 ...1_01_000002_create_registrations_table.php |  8 ---
 ...01_01_000005_create_applications_table.php | 19 ++++++
 database/seeders/ApplicationSeeder.php        | 17 +++++
 tests/TestCase.php                            | 13 +++-
 10 files changed, 265 insertions(+), 9 deletions(-)
 create mode 100644 app/Http/Controllers/ApplicationController.php
 create mode 100644 app/Http/Requests/StoreApplicationRequest.php
 create mode 100644 app/Http/Requests/UpdateApplicationRequest.php
 create mode 100644 app/Models/Application.php
 create mode 100644 app/Policies/ApplicationPolicy.php
 create mode 100644 database/factories/ApplicationFactory.php
 create mode 100644 database/migrations/0003_01_01_000005_create_applications_table.php
 create mode 100644 database/seeders/ApplicationSeeder.php

diff --git a/app/Http/Controllers/ApplicationController.php b/app/Http/Controllers/ApplicationController.php
new file mode 100644
index 00000000..a74bd89c
--- /dev/null
+++ b/app/Http/Controllers/ApplicationController.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreApplicationRequest;
+use App\Http\Requests\UpdateApplicationRequest;
+use App\Models\Application;
+
+class ApplicationController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     */
+    public function index()
+    {
+        //
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(StoreApplicationRequest $request)
+    {
+        //
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show(Application $application)
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(UpdateApplicationRequest $request, Application $application)
+    {
+        //
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(Application $application)
+    {
+        //
+    }
+}
diff --git a/app/Http/Requests/StoreApplicationRequest.php b/app/Http/Requests/StoreApplicationRequest.php
new file mode 100644
index 00000000..635fbc54
--- /dev/null
+++ b/app/Http/Requests/StoreApplicationRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreApplicationRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Http/Requests/UpdateApplicationRequest.php b/app/Http/Requests/UpdateApplicationRequest.php
new file mode 100644
index 00000000..37eb98e4
--- /dev/null
+++ b/app/Http/Requests/UpdateApplicationRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateApplicationRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Models/Application.php b/app/Models/Application.php
new file mode 100644
index 00000000..4cbfad54
--- /dev/null
+++ b/app/Models/Application.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class Application extends Model
+{
+    /** @use HasFactory<\Database\Factories\ApplicationFactory> */
+    use HasFactory;
+}
diff --git a/app/Policies/ApplicationPolicy.php b/app/Policies/ApplicationPolicy.php
new file mode 100644
index 00000000..2cd942d0
--- /dev/null
+++ b/app/Policies/ApplicationPolicy.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Application;
+use App\Models\Auth\User;
+use Illuminate\Auth\Access\Response;
+
+class ApplicationPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     */
+    public function view(User $user, Application $application): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can create models.
+     */
+    public function create(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     */
+    public function update(User $user, Application $application): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     */
+    public function delete(User $user, Application $application): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     */
+    public function restore(User $user, Application $application): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     */
+    public function forceDelete(User $user, Application $application): bool
+    {
+        return false;
+    }
+}
diff --git a/database/factories/ApplicationFactory.php b/database/factories/ApplicationFactory.php
new file mode 100644
index 00000000..a3d2bfbe
--- /dev/null
+++ b/database/factories/ApplicationFactory.php
@@ -0,0 +1,33 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Application;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @template TModel of \App\Models\Application
+ *
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<TModel>
+ */
+class ApplicationFactory extends Factory
+{
+    /**
+     * The name of the factory's corresponding model.
+     *
+     * @var class-string<TModel>
+     */
+    protected $model = Application::class;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/database/migrations/0003_01_01_000002_create_registrations_table.php b/database/migrations/0003_01_01_000002_create_registrations_table.php
index 2ebcde54..803d863b 100644
--- a/database/migrations/0003_01_01_000002_create_registrations_table.php
+++ b/database/migrations/0003_01_01_000002_create_registrations_table.php
@@ -21,12 +21,4 @@ public function up(): void
             $table->timestamps();
         });
     }
-
-    /**
-     * Reverse the migrations.
-     */
-    public function down(): void
-    {
-        Schema::dropIfExists('registrations');
-    }
 };
diff --git a/database/migrations/0003_01_01_000005_create_applications_table.php b/database/migrations/0003_01_01_000005_create_applications_table.php
new file mode 100644
index 00000000..07fb749c
--- /dev/null
+++ b/database/migrations/0003_01_01_000005_create_applications_table.php
@@ -0,0 +1,19 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('applications', function (Blueprint $table) {
+            $table->id();
+            $table->timestamps();
+        });
+    }
+};
diff --git a/database/seeders/ApplicationSeeder.php b/database/seeders/ApplicationSeeder.php
new file mode 100644
index 00000000..b2cddea7
--- /dev/null
+++ b/database/seeders/ApplicationSeeder.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class ApplicationSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        //
+    }
+}
diff --git a/tests/TestCase.php b/tests/TestCase.php
index fe1ffc2f..bb499f97 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -6,5 +6,16 @@
 
 abstract class TestCase extends BaseTestCase
 {
-    //
+    /**
+     * Creates the application.
+     */
+    public function createApplication()
+    {
+        $app = require __DIR__.'/../bootstrap/app.php';
+
+        $app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
+
+        return $app;
+    }
 }
+

From b9e183737132edb37331bc4f3624e1ca9c822d4a Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 15:31:01 -0400
Subject: [PATCH 03/21] Stub workflow & workflow steps models

---
 app/Http/Controllers/WorkflowController.php   | 50 ++++++++++++++
 .../Controllers/WorkflowStepController.php    | 50 ++++++++++++++
 app/Http/Requests/StoreWorkflowRequest.php    | 28 ++++++++
 .../Requests/StoreWorkflowStepRequest.php     | 28 ++++++++
 app/Http/Requests/UpdateWorkflowRequest.php   | 28 ++++++++
 .../Requests/UpdateWorkflowStepRequest.php    | 28 ++++++++
 app/Models/Workflow.php                       | 12 ++++
 app/Models/WorkflowStep.php                   | 12 ++++
 app/Policies/WorkflowPolicy.php               | 66 +++++++++++++++++++
 app/Policies/WorkflowStepPolicy.php           | 66 +++++++++++++++++++
 database/factories/WorkflowFactory.php        | 33 ++++++++++
 database/factories/WorkflowStepFactory.php    | 33 ++++++++++
 ...02_01_01_000006_create_workflows_table.php | 19 ++++++
 ..._01_000007_create_workflow_steps_table.php | 19 ++++++
 database/seeders/WorkflowSeeder.php           | 17 +++++
 database/seeders/WorkflowStepSeeder.php       | 17 +++++
 16 files changed, 506 insertions(+)
 create mode 100644 app/Http/Controllers/WorkflowController.php
 create mode 100644 app/Http/Controllers/WorkflowStepController.php
 create mode 100644 app/Http/Requests/StoreWorkflowRequest.php
 create mode 100644 app/Http/Requests/StoreWorkflowStepRequest.php
 create mode 100644 app/Http/Requests/UpdateWorkflowRequest.php
 create mode 100644 app/Http/Requests/UpdateWorkflowStepRequest.php
 create mode 100644 app/Models/Workflow.php
 create mode 100644 app/Models/WorkflowStep.php
 create mode 100644 app/Policies/WorkflowPolicy.php
 create mode 100644 app/Policies/WorkflowStepPolicy.php
 create mode 100644 database/factories/WorkflowFactory.php
 create mode 100644 database/factories/WorkflowStepFactory.php
 create mode 100644 database/migrations/0002_01_01_000006_create_workflows_table.php
 create mode 100644 database/migrations/0002_01_01_000007_create_workflow_steps_table.php
 create mode 100644 database/seeders/WorkflowSeeder.php
 create mode 100644 database/seeders/WorkflowStepSeeder.php

diff --git a/app/Http/Controllers/WorkflowController.php b/app/Http/Controllers/WorkflowController.php
new file mode 100644
index 00000000..cc084da2
--- /dev/null
+++ b/app/Http/Controllers/WorkflowController.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreWorkflowRequest;
+use App\Http\Requests\UpdateWorkflowRequest;
+use App\Models\Workflow;
+
+class WorkflowController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     */
+    public function index()
+    {
+        //
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(StoreWorkflowRequest $request)
+    {
+        //
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show(Workflow $workflow)
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(UpdateWorkflowRequest $request, Workflow $workflow)
+    {
+        //
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(Workflow $workflow)
+    {
+        //
+    }
+}
diff --git a/app/Http/Controllers/WorkflowStepController.php b/app/Http/Controllers/WorkflowStepController.php
new file mode 100644
index 00000000..e7f4444d
--- /dev/null
+++ b/app/Http/Controllers/WorkflowStepController.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreWorkflowStepRequest;
+use App\Http\Requests\UpdateWorkflowStepRequest;
+use App\Models\WorkflowStep;
+
+class WorkflowStepController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     */
+    public function index()
+    {
+        //
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(StoreWorkflowStepRequest $request)
+    {
+        //
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show(WorkflowStep $workflowStep)
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(UpdateWorkflowStepRequest $request, WorkflowStep $workflowStep)
+    {
+        //
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(WorkflowStep $workflowStep)
+    {
+        //
+    }
+}
diff --git a/app/Http/Requests/StoreWorkflowRequest.php b/app/Http/Requests/StoreWorkflowRequest.php
new file mode 100644
index 00000000..2a9f07aa
--- /dev/null
+++ b/app/Http/Requests/StoreWorkflowRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreWorkflowRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Http/Requests/StoreWorkflowStepRequest.php b/app/Http/Requests/StoreWorkflowStepRequest.php
new file mode 100644
index 00000000..64d4ce30
--- /dev/null
+++ b/app/Http/Requests/StoreWorkflowStepRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreWorkflowStepRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Http/Requests/UpdateWorkflowRequest.php b/app/Http/Requests/UpdateWorkflowRequest.php
new file mode 100644
index 00000000..eca02ae3
--- /dev/null
+++ b/app/Http/Requests/UpdateWorkflowRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateWorkflowRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Http/Requests/UpdateWorkflowStepRequest.php b/app/Http/Requests/UpdateWorkflowStepRequest.php
new file mode 100644
index 00000000..b7368a86
--- /dev/null
+++ b/app/Http/Requests/UpdateWorkflowStepRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateWorkflowStepRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Models/Workflow.php b/app/Models/Workflow.php
new file mode 100644
index 00000000..590ca23c
--- /dev/null
+++ b/app/Models/Workflow.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class Workflow extends Model
+{
+    /** @use HasFactory<\Database\Factories\WorkflowFactory> */
+    use HasFactory;
+}
diff --git a/app/Models/WorkflowStep.php b/app/Models/WorkflowStep.php
new file mode 100644
index 00000000..17a50771
--- /dev/null
+++ b/app/Models/WorkflowStep.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class WorkflowStep extends Model
+{
+    /** @use HasFactory<\Database\Factories\WorkflowStepFactory> */
+    use HasFactory;
+}
diff --git a/app/Policies/WorkflowPolicy.php b/app/Policies/WorkflowPolicy.php
new file mode 100644
index 00000000..00368836
--- /dev/null
+++ b/app/Policies/WorkflowPolicy.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Auth\User;
+use App\Models\Workflow;
+use Illuminate\Auth\Access\Response;
+
+class WorkflowPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     */
+    public function view(User $user, Workflow $workflow): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can create models.
+     */
+    public function create(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     */
+    public function update(User $user, Workflow $workflow): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     */
+    public function delete(User $user, Workflow $workflow): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     */
+    public function restore(User $user, Workflow $workflow): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     */
+    public function forceDelete(User $user, Workflow $workflow): bool
+    {
+        return false;
+    }
+}
diff --git a/app/Policies/WorkflowStepPolicy.php b/app/Policies/WorkflowStepPolicy.php
new file mode 100644
index 00000000..41b5d53d
--- /dev/null
+++ b/app/Policies/WorkflowStepPolicy.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Auth\User;
+use App\Models\WorkflowStep;
+use Illuminate\Auth\Access\Response;
+
+class WorkflowStepPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     */
+    public function view(User $user, WorkflowStep $workflowStep): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can create models.
+     */
+    public function create(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     */
+    public function update(User $user, WorkflowStep $workflowStep): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     */
+    public function delete(User $user, WorkflowStep $workflowStep): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     */
+    public function restore(User $user, WorkflowStep $workflowStep): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     */
+    public function forceDelete(User $user, WorkflowStep $workflowStep): bool
+    {
+        return false;
+    }
+}
diff --git a/database/factories/WorkflowFactory.php b/database/factories/WorkflowFactory.php
new file mode 100644
index 00000000..a38fd75d
--- /dev/null
+++ b/database/factories/WorkflowFactory.php
@@ -0,0 +1,33 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Workflow;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @template TModel of \App\Models\Workflow
+ *
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<TModel>
+ */
+class WorkflowFactory extends Factory
+{
+    /**
+     * The name of the factory's corresponding model.
+     *
+     * @var class-string<TModel>
+     */
+    protected $model = Workflow::class;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/database/factories/WorkflowStepFactory.php b/database/factories/WorkflowStepFactory.php
new file mode 100644
index 00000000..d0defb28
--- /dev/null
+++ b/database/factories/WorkflowStepFactory.php
@@ -0,0 +1,33 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\WorkflowStep;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @template TModel of \App\Models\WorkflowStep
+ *
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<TModel>
+ */
+class WorkflowStepFactory extends Factory
+{
+    /**
+     * The name of the factory's corresponding model.
+     *
+     * @var class-string<TModel>
+     */
+    protected $model = WorkflowStep::class;
+
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/database/migrations/0002_01_01_000006_create_workflows_table.php b/database/migrations/0002_01_01_000006_create_workflows_table.php
new file mode 100644
index 00000000..eec1896d
--- /dev/null
+++ b/database/migrations/0002_01_01_000006_create_workflows_table.php
@@ -0,0 +1,19 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('workflows', function (Blueprint $table) {
+            $table->id();
+            $table->timestamps();
+        });
+    }
+};
diff --git a/database/migrations/0002_01_01_000007_create_workflow_steps_table.php b/database/migrations/0002_01_01_000007_create_workflow_steps_table.php
new file mode 100644
index 00000000..45635904
--- /dev/null
+++ b/database/migrations/0002_01_01_000007_create_workflow_steps_table.php
@@ -0,0 +1,19 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('workflow_steps', function (Blueprint $table) {
+            $table->id();
+            $table->timestamps();
+        });
+    }
+};
diff --git a/database/seeders/WorkflowSeeder.php b/database/seeders/WorkflowSeeder.php
new file mode 100644
index 00000000..9073caa2
--- /dev/null
+++ b/database/seeders/WorkflowSeeder.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class WorkflowSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        //
+    }
+}
diff --git a/database/seeders/WorkflowStepSeeder.php b/database/seeders/WorkflowStepSeeder.php
new file mode 100644
index 00000000..d91becfb
--- /dev/null
+++ b/database/seeders/WorkflowStepSeeder.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class WorkflowStepSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        //
+    }
+}

From 8e1fcf4a7547eddf1d44017a38fcc2a8b87a3386 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 15:35:29 -0400
Subject: [PATCH 04/21] Resolve test suite issues

---
 .../0003_01_01_000001_create_users_table.php  |  1 +
 phpunit.xml                                   |  1 +
 tests/CreatesApplication.php                  | 22 +++++++++++++++++++
 tests/TestCase.php                            | 13 ++---------
 4 files changed, 26 insertions(+), 11 deletions(-)
 create mode 100644 tests/CreatesApplication.php

diff --git a/database/migrations/0003_01_01_000001_create_users_table.php b/database/migrations/0003_01_01_000001_create_users_table.php
index b49bdb87..f4d17600 100644
--- a/database/migrations/0003_01_01_000001_create_users_table.php
+++ b/database/migrations/0003_01_01_000001_create_users_table.php
@@ -16,6 +16,7 @@ public function up(): void
             $table->timestamp('email_verified_at')->nullable();
             $table->string('password');
             $table->foreignId('agent_id')->nullable()->unique()->index()->constrained('agents');
+            $table->foreignId('registration_client_id')->nullable()->constrained('clients');
             $table->text('bio')->nullable();
             $table->json('social_links')->nullable();
             $table->unsignedBigInteger('avatar_id')->nullable()->index();
diff --git a/phpunit.xml b/phpunit.xml
index d7032415..a5cd0e74 100644
--- a/phpunit.xml
+++ b/phpunit.xml
@@ -18,6 +18,7 @@
         </include>
     </source>
     <php>
+        <ini name="memory_limit" value="2048M" />
         <env name="APP_ENV" value="testing"/>
         <env name="APP_MAINTENANCE_DRIVER" value="file"/>
         <env name="BCRYPT_ROUNDS" value="4"/>
diff --git a/tests/CreatesApplication.php b/tests/CreatesApplication.php
new file mode 100644
index 00000000..547152f6
--- /dev/null
+++ b/tests/CreatesApplication.php
@@ -0,0 +1,22 @@
+<?php
+
+namespace Tests;
+
+use Illuminate\Contracts\Console\Kernel;
+
+trait CreatesApplication
+{
+    /**
+     * Creates the application.
+     *
+     * @return \Illuminate\Foundation\Application
+     */
+    public function createApplication()
+    {
+        $app = require __DIR__.'/../bootstrap/app.php';
+
+        $app->make(Kernel::class)->bootstrap();
+
+        return $app;
+    }
+}
diff --git a/tests/TestCase.php b/tests/TestCase.php
index bb499f97..6dabc3a6 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -6,16 +6,7 @@
 
 abstract class TestCase extends BaseTestCase
 {
-    /**
-     * Creates the application.
-     */
-    public function createApplication()
-    {
-        $app = require __DIR__.'/../bootstrap/app.php';
-
-        $app->make(\Illuminate\Contracts\Console\Kernel::class)->bootstrap();
-
-        return $app;
-    }
+    use CreatesApplication;
 }
 
+

From 5595e73a7ec9e58bfd10f8e8d95901622e6ec566 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 15:45:40 -0400
Subject: [PATCH 05/21] Resolve pest deprecated test warnings

---
 config/database.php                               | 4 ++--
 tests/Feature/Agents/QueueMatchmakingTest.php     | 2 --
 tests/Feature/Agents/QuickplayMatchmakingTest.php | 2 --
 tests/Integration/ActivityTrackingTest.php        | 2 --
 tests/Integration/RematchCancellationTest.php     | 2 --
 tests/Unit/AgentAutoAcceptRematchTest.php         | 2 --
 tests/Unit/Agents/AgentSchedulingServiceTest.php  | 2 --
 tests/Unit/Agents/AgentServiceTest.php            | 2 --
 tests/Unit/PlayerActivityManagerTest.php          | 2 --
 9 files changed, 2 insertions(+), 18 deletions(-)

diff --git a/config/database.php b/config/database.php
index d9477bef..e371373d 100644
--- a/config/database.php
+++ b/config/database.php
@@ -59,7 +59,7 @@
             'strict' => true,
             'engine' => null,
             'options' => extension_loaded('pdo_mysql') ? array_filter([
-                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
+                (PHP_VERSION_ID >= 80500 ? Pdo\Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
             ]) : [],
         ],
 
@@ -79,7 +79,7 @@
             'strict' => true,
             'engine' => null,
             'options' => extension_loaded('pdo_mysql') ? array_filter([
-                PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
+                (PHP_VERSION_ID >= 80500 ? Pdo\Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
             ]) : [],
         ],
 
diff --git a/tests/Feature/Agents/QueueMatchmakingTest.php b/tests/Feature/Agents/QueueMatchmakingTest.php
index 887d7b3c..ec3d3279 100644
--- a/tests/Feature/Agents/QueueMatchmakingTest.php
+++ b/tests/Feature/Agents/QueueMatchmakingTest.php
@@ -6,8 +6,6 @@
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Redis;
 
-uses(RefreshDatabase::class);
-
 beforeEach(function () {
     // Mock Redis for PlayerActivityService
     Redis::shouldReceive('setex')->andReturn(true)->byDefault();
diff --git a/tests/Feature/Agents/QuickplayMatchmakingTest.php b/tests/Feature/Agents/QuickplayMatchmakingTest.php
index 887d7b3c..ec3d3279 100644
--- a/tests/Feature/Agents/QuickplayMatchmakingTest.php
+++ b/tests/Feature/Agents/QuickplayMatchmakingTest.php
@@ -6,8 +6,6 @@
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Redis;
 
-uses(RefreshDatabase::class);
-
 beforeEach(function () {
     // Mock Redis for PlayerActivityService
     Redis::shouldReceive('setex')->andReturn(true)->byDefault();
diff --git a/tests/Integration/ActivityTrackingTest.php b/tests/Integration/ActivityTrackingTest.php
index 9cc96a98..fa03ef88 100644
--- a/tests/Integration/ActivityTrackingTest.php
+++ b/tests/Integration/ActivityTrackingTest.php
@@ -14,8 +14,6 @@
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Redis;
 
-uses(RefreshDatabase::class);
-
 describe('Activity Tracking in Game Creation', function () {
     beforeEach(function () {
         $this->states = [];
diff --git a/tests/Integration/RematchCancellationTest.php b/tests/Integration/RematchCancellationTest.php
index ad3277b7..901955e7 100644
--- a/tests/Integration/RematchCancellationTest.php
+++ b/tests/Integration/RematchCancellationTest.php
@@ -12,8 +12,6 @@
 use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Redis;
 
-uses(RefreshDatabase::class);
-
 describe('Automatic Rematch Cancellation', function () {
     beforeEach(function () {
         Event::fake();
diff --git a/tests/Unit/AgentAutoAcceptRematchTest.php b/tests/Unit/AgentAutoAcceptRematchTest.php
index 97f7f75a..ec5e611e 100644
--- a/tests/Unit/AgentAutoAcceptRematchTest.php
+++ b/tests/Unit/AgentAutoAcceptRematchTest.php
@@ -14,8 +14,6 @@
 use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Redis;
 
-uses(RefreshDatabase::class);
-
 describe('AgentAutoAcceptRematch Job', function () {
     beforeEach(function () {
         Event::fake();
diff --git a/tests/Unit/Agents/AgentSchedulingServiceTest.php b/tests/Unit/Agents/AgentSchedulingServiceTest.php
index 3827a7b8..54e89776 100644
--- a/tests/Unit/Agents/AgentSchedulingServiceTest.php
+++ b/tests/Unit/Agents/AgentSchedulingServiceTest.php
@@ -8,8 +8,6 @@
 use Illuminate\Support\Facades\Date;
 use Illuminate\Support\Facades\Redis;
 
-uses(RefreshDatabase::class);
-
 beforeEach(function () {
     $this->service = app(AgentSchedulingService::class);
 
diff --git a/tests/Unit/Agents/AgentServiceTest.php b/tests/Unit/Agents/AgentServiceTest.php
index 23c3a418..8a95493e 100644
--- a/tests/Unit/Agents/AgentServiceTest.php
+++ b/tests/Unit/Agents/AgentServiceTest.php
@@ -9,8 +9,6 @@
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Queue;
 
-uses(RefreshDatabase::class);
-
 beforeEach(function () {
     $this->service = app(AgentService::class);
     Queue::fake();
diff --git a/tests/Unit/PlayerActivityManagerTest.php b/tests/Unit/PlayerActivityManagerTest.php
index d5a79f37..fe636250 100644
--- a/tests/Unit/PlayerActivityManagerTest.php
+++ b/tests/Unit/PlayerActivityManagerTest.php
@@ -7,8 +7,6 @@
 use Illuminate\Support\Facades\Queue;
 use Illuminate\Support\Facades\Redis;
 
-uses(RefreshDatabase::class);
-
 describe('PlayerActivityManager', function () {
     beforeEach(function () {
         Queue::fake();

From 0401b033ee49f0a089ab4d4c45e2376b04101bb3 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 17:56:10 -0400
Subject: [PATCH 06/21] Fix test suite & update features

---
 app/GameEngine/GameEngine.php                 |   7 +-
 .../CoordinatedActionProcessor.php            |  40 ++-
 composer.json                                 |   4 +-
 .../2025_11_13_000007_create_games_table.php  |   1 +
 package-lock.json                             |   6 +-
 tests/Integration/ActivityTrackingTest.php    |  30 +-
 .../Game/CoordinatedActionsTest.php           | 252 +++++-----------
 .../Integration/Game/TimeoutHandlingTest.php  | 270 +++---------------
 tests/Integration/RematchCancellationTest.php |   8 +-
 tests/Pest.php                                |   2 +-
 10 files changed, 187 insertions(+), 433 deletions(-)

diff --git a/app/GameEngine/GameEngine.php b/app/GameEngine/GameEngine.php
index cd147940..10b3e182 100644
--- a/app/GameEngine/GameEngine.php
+++ b/app/GameEngine/GameEngine.php
@@ -136,7 +136,8 @@ public function processPlayerAction(
             $game,
             $action,
             $mode,
-            $gameState
+            $gameState,
+            $player
         );
 
         // Record the successful action
@@ -155,6 +156,10 @@ public function processPlayerAction(
             $gameState = $coordinationResult->updatedGameState;
             $game->game_state = $gameState->toArray();
             $game->save();
+
+            // Mark the current action as completed
+            $actionRecord->coordination_completed_at = now();
+            $actionRecord->save();
         }
 
         // ── 5. GAME LIFECYCLE PROGRESSION ───────────────────────────
diff --git a/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php b/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
index 89683704..9b6a7acb 100644
--- a/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
+++ b/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
@@ -8,6 +8,7 @@
 use App\GameEngine\Interfaces\GameActionContract;
 use App\Models\Games\Action;
 use App\Models\Games\Game;
+use App\Models\Games\Player;
 
 /**
  * Handles coordinated actions where multiple players must submit actions
@@ -22,9 +23,10 @@ class CoordinatedActionProcessor
      * @param  GameActionContract  $action  The action being processed
      * @param  mixed  $mode  The game mode handler
      * @param  object  $gameState  The current game state
+     * @param  Player  $player  The current player
      * @return CoordinatedActionResult Result indicating if coordination is needed and status
      */
-    public function process(Game $game, GameActionContract $action, mixed $mode, object $gameState): CoordinatedActionResult
+    public function process(Game $game, GameActionContract $action, mixed $mode, object $gameState, Player $player): CoordinatedActionResult
     {
         // Check if this action requires coordination
         if (! $this->isCoordinatedAction($action)) {
@@ -35,11 +37,19 @@ public function process(Game $game, GameActionContract $action, mixed $mode, obj
         $coordinationSequence = $this->getSequenceNumber($game, $coordinationGroup);
         $requiredCount = $this->getRequiredPlayerCount($game, $action, $gameState);
 
-        // Check if coordination is complete
+        // Check if coordination is complete (counting existing actions + current action)
         $completedCount = $this->getCompletedCount($game, $coordinationGroup);
 
-        if ($completedCount >= $requiredCount) {
-            return $this->completeCoordination($game, $mode, $gameState, $coordinationGroup, $coordinationSequence);
+        if ($completedCount + 1 >= $requiredCount) {
+            return $this->completeCoordination(
+                $game,
+                $mode,
+                $gameState,
+                $coordinationGroup,
+                $coordinationSequence,
+                $action,
+                $player
+            );
         }
 
         return CoordinatedActionResult::coordinated(
@@ -123,23 +133,37 @@ protected function completeCoordination(
         mixed $mode,
         object $gameState,
         string $coordinationGroup,
-        int $coordinationSequence
+        int $coordinationSequence,
+        GameActionContract $action,
+        Player $player
     ): CoordinatedActionResult {
-        // Retrieve all coordinated actions
+        // Retrieve all previously coordinated actions
         $coordinatedActions = Action::where('game_id', $game->id)
             ->withCoordinationGroup($coordinationGroup)
             ->pendingCoordination()
             ->with('player')
             ->get();
 
-        // Process the coordinated action through the game mode
+        // Add the current action to the list (as a transient Action model)
+        $currentActionModel = new Action();
+        // Since we can't easily hydrate it completely without saving, we'll set what's needed for coordination
+        $currentActionModel->setRelation('player', $player);
+        $currentActionModel->action_details = $action->toArray();
+        $currentActionModel->action_type = $action->getType();
+        
+        $coordinatedActions->push($currentActionModel);
+
+        // Process the coordinated actions through the game mode
         $updatedGameState = $this->processCoordinatedActions($mode, $gameState, $coordinatedActions);
 
-        // Mark all actions as completed
+        // Mark all existing actions as completed
         Action::where('game_id', $game->id)
             ->withCoordinationGroup($coordinationGroup)
             ->pendingCoordination()
             ->update(['coordination_completed_at' => now()]);
+            
+        // Note: The current action is not yet in the DB, so it won't be updated here.
+        // The calling component is responsible for saving the current action with proper status.
 
         return CoordinatedActionResult::coordinated(
             coordinationGroup: $coordinationGroup,
diff --git a/composer.json b/composer.json
index b895d25f..2af1c1d5 100644
--- a/composer.json
+++ b/composer.json
@@ -1,8 +1,8 @@
 {
     "$schema": "https://getcomposer.org/schema.json",
-    "name": "laravel/livewire-starter-kit",
+    "name": "w3rd/protocol",
     "type": "project",
-    "description": "The official Laravel starter kit for Livewire.",
+    "description": "Backend API & real-time game engine protocol for W3RD multi-platform ecosystem.",
     "keywords": [
         "laravel",
         "framework"
diff --git a/database/migrations/2025_11_13_000007_create_games_table.php b/database/migrations/2025_11_13_000007_create_games_table.php
index fc0b6680..0fa486b1 100644
--- a/database/migrations/2025_11_13_000007_create_games_table.php
+++ b/database/migrations/2025_11_13_000007_create_games_table.php
@@ -33,6 +33,7 @@ public function up(): void
             $table->integer('action_count')->default(0);
             $table->integer('duration_seconds')->nullable();
 
+            $table->timestamp('turn_ends_at')->nullable();
             $table->timestamp('started_at')->nullable();
             $table->timestamp('completed_at')->nullable();
             $table->timestamp('expires_at')->nullable();
diff --git a/package-lock.json b/package-lock.json
index 770dfb97..0a6d00f2 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,5 +1,5 @@
 {
-    "name": "protocol",
+    "name": "W3RD",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
@@ -1228,6 +1228,7 @@
                 }
             ],
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "baseline-browser-mapping": "^2.9.0",
                 "caniuse-lite": "^1.0.30001759",
@@ -2093,6 +2094,7 @@
             "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
             "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
             "license": "MIT",
+            "peer": true,
             "engines": {
                 "node": ">=12"
             },
@@ -2119,6 +2121,7 @@
                 }
             ],
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "nanoid": "^3.3.11",
                 "picocolors": "^1.1.1",
@@ -2362,6 +2365,7 @@
             "resolved": "https://registry.npmjs.org/vite/-/vite-7.2.6.tgz",
             "integrity": "sha512-tI2l/nFHC5rLh7+5+o7QjKjSR04ivXDF4jcgV0f/bTQ+OJiITy5S6gaynVsEM+7RqzufMnVbIon6Sr5x1SDYaQ==",
             "license": "MIT",
+            "peer": true,
             "dependencies": {
                 "esbuild": "^0.25.0",
                 "fdir": "^6.5.0",
diff --git a/tests/Integration/ActivityTrackingTest.php b/tests/Integration/ActivityTrackingTest.php
index fa03ef88..138af59d 100644
--- a/tests/Integration/ActivityTrackingTest.php
+++ b/tests/Integration/ActivityTrackingTest.php
@@ -1,7 +1,7 @@
 <?php
 
-use App\Actions\Queue\JoinQueueAction;
-use App\Actions\Queue\LeaveQueueAction;
+use App\Matchmaking\Queue\Actions\JoinQueueAction;
+use App\Matchmaking\Queue\Actions\LeaveQueueAction;
 use App\Enums\GameStatus;
 use App\Enums\GameTitle;
 use App\Enums\PlayerActivityState;
@@ -10,6 +10,7 @@
 use App\Matchmaking\Enums\LobbyStatus;
 use App\Models\Auth\User;
 use App\Models\Games\Game;
+use App\Models\Games\Mode;
 use App\Models\Matchmaking\Lobby;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Redis;
@@ -47,16 +48,21 @@
         Redis::shouldReceive('zrem')->andReturn(1)->byDefault();
         Redis::shouldReceive('expire')->andReturn(true)->byDefault();
 
-        $this->activityManager = app(PlayerActivityManager::class);
+        $this->activityService = app(PlayerActivityManager::class);
         $this->gameBuilder = app(GameBuilder::class);
+
+        Mode::factory()->create([
+            'title_slug' => GameTitle::CONNECT_FOUR,
+            'slug' => 'standard',
+        ]);
     });
 
     describe('matchmaking queue', function () {
         it('sets IN_QUEUE when joining queue', function () {
             $user = User::factory()->create();
-            $joinAction = new JoinQueueAction;
+            $joinAction = app(JoinQueueAction::class);
 
-            $joinAction->execute($user, GameTitle::VALIDATE_FOUR, 'standard', 1);
+            $joinAction->execute($user, GameTitle::CONNECT_FOUR, 'standard', 1);
 
             expect($this->activityService->getState($user->id))->toBe(PlayerActivityState::IN_QUEUE);
         });
@@ -65,11 +71,11 @@
             $user = User::factory()->create();
 
             // Join queue first
-            $joinAction = new JoinQueueAction;
-            $joinAction->execute($user, GameTitle::VALIDATE_FOUR, 'standard', 1);
+            $joinAction = app(JoinQueueAction::class);
+            $joinAction->execute($user, GameTitle::CONNECT_FOUR, 'standard', 1);
 
             // Then leave
-            $leaveAction = new LeaveQueueAction;
+            $leaveAction = app(LeaveQueueAction::class);
             $leaveAction->execute($user);
 
             expect($this->activityService->getState($user->id))->toBe(PlayerActivityState::IDLE);
@@ -109,7 +115,7 @@
 
             $lobby = Lobby::factory()->create([
                 'host_id' => $host->id,
-                'game_title' => GameTitle::VALIDATE_FOUR,
+                'title_slug' => GameTitle::CONNECT_FOUR,
                 'status' => 'pending',
             ]);
 
@@ -125,7 +131,7 @@
 
             $lobby = Lobby::factory()->create([
                 'host_id' => $host->id,
-                'game_title' => GameTitle::VALIDATE_FOUR,
+                'title_slug' => GameTitle::CONNECT_FOUR,
                 'status' => 'pending',
             ]);
 
@@ -188,8 +194,8 @@
             $user2 = User::factory()->create();
 
             // Set both in game
-            $this->activityManager->setState($user1->id, PlayerActivityState::IN_GAME);
-            $this->activityManager->setState($user2->id, PlayerActivityState::IN_GAME);
+            $this->activityService->setState($user1->id, PlayerActivityState::IN_GAME);
+            $this->activityService->setState($user2->id, PlayerActivityState::IN_GAME);
 
             // Simulate game completion (done via GameCompleted event listener)
             $this->activityService->setState($user1->id, PlayerActivityState::IDLE);
diff --git a/tests/Integration/Game/CoordinatedActionsTest.php b/tests/Integration/Game/CoordinatedActionsTest.php
index af90efc4..c20782f6 100644
--- a/tests/Integration/Game/CoordinatedActionsTest.php
+++ b/tests/Integration/Game/CoordinatedActionsTest.php
@@ -1,216 +1,110 @@
 <?php
 
-use App\Enums\GameStatusEnum;
+use App\Enums\GamePhase;
+use App\Enums\GameStatus;
+use App\GameEngine\Actions\PassCards;
 use App\GameEngine\Lifecycle\Progression\CoordinatedActionProcessor;
+use App\GameTitles\Hearts\HeartsTable;
+use App\GameTitles\Hearts\Modes\StandardMode;
 use App\Models\Games\Action;
 use App\Models\Games\Game;
 use App\Models\Games\Player;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Str;
+
+uses(RefreshDatabase::class);
 
-/**
- * NOTE: These tests need to be refactored to match the new API.
- * CoordinatedActionProcessor::process() now requires:
- *   - Game $game
- *   - GameActionContract $action (not array)
- *   - mixed $mode (game mode handler)
- *   - object $gameState
- *
- * The tests should be updated to use proper action DTOs and game state objects.
- */
 describe('Coordinated Actions Integration', function () {
     describe('All Players Submit Actions', function () {
         it('advances game phase when all 4 players submit coordinated actions', function () {
-            // Create game with 4 players in coordination phase
-            $game = Game::factory()->create(['status' => GameStatusEnum::IN_PROGRESS]);
+            // Create game with 4 players
+            $game = Game::factory()->create([
+                'title_slug' => 'hearts',
+                'status' => GameStatus::ACTIVE
+            ]);
             $players = collect([]);
-
             for ($i = 1; $i <= 4; $i++) {
                 $players->push(Player::factory()->for($game)->position($i)->create());
             }
 
-            $action = new CoordinatedActionProcessor;
+            $processor = new CoordinatedActionProcessor;
+            $mode = new StandardMode($game);
+            
+            // Initialize game state (using Hearts internal logic)
+            $gameState = HeartsTable::createNew(...$players->pluck('ulid')->all());
 
             // Submit actions for first 3 players
             foreach ($players->take(3) as $player) {
-                $action->execute(
-                    $game,
-                    $player,
-                    ['type' => 'pass_cards', 'cards' => ['2H', '3H', '4H']]
-                );
-                $game->refresh();
+                $action = new PassCards(['2H', '3H', '4H']);
+                
+                $result = $processor->process($game, $action, $mode, $gameState, $player);
+                
+                // Assert not complete
+                expect($result->coordinationComplete)->toBeFalse();
+                
+                // Manually record the action (simulating GameEngine side effect)
+                Action::create([
+                    'game_id' => $game->id,
+                    'player_id' => $player->id,
+                    'action_type' => 'pass_cards',
+                    'action_details' => $action->toArray(),
+                    'turn_number' => $game->turn_number ?? 1,
+                    'status' => 'success',
+                    'coordination_group' => $result->coordinationGroup,
+                    'is_coordinated' => true,
+                    'ulid' => (string) Str::ulid(),
+                ]);
             }
 
-            // Game should still be waiting
-            expect($game->game_state['waiting_for_players'])->toHaveCount(1);
-
             // Submit final player's action
-            $action->execute(
-                $game,
-                $players->last(),
-                ['type' => 'pass_cards', 'cards' => ['2D', '3D', '4D']]
-            );
-            $game->refresh();
-
-            // Game should have advanced phase
-            expect($game->game_state)->not->toHaveKey('waiting_for_players')
-                ->and($game->game_state['phase'])->toBe('play');
+            $lastPlayer = $players->last();
+            $action = new PassCards(['2D', '3D', '4D']);
+            
+            $result = $processor->process($game, $action, $mode, $gameState, $lastPlayer);
+
+            // Assert complete
+            expect($result->coordinationComplete)->toBeTrue()
+                ->and($result->updatedGameState)->toBeInstanceOf(HeartsTable::class);
+                
+            $finalState = $result->updatedGameState;
+            expect($finalState->phase)->toBe(GamePhase::ACTIVE);
         });
 
         it('maintains consistent game state when players submit in different orders', function () {
-            $game = Game::factory()->create(['status' => GameStatusEnum::IN_PROGRESS]);
+            $game = Game::factory()->create(['title_slug' => 'hearts', 'status' => GameStatus::ACTIVE]);
             $players = collect([]);
-
             for ($i = 1; $i <= 4; $i++) {
                 $players->push(Player::factory()->for($game)->position($i)->create());
             }
 
-            $action = new CoordinatedActionProcessor;
+            $processor = new CoordinatedActionProcessor;
+            $mode = new StandardMode($game);
+            $gameState = HeartsTable::createNew(...$players->pluck('ulid')->all());
 
             // Submit in random order: 3, 1, 4, 2
             $submitOrder = [$players[2], $players[0], $players[3], $players[1]];
 
-            foreach ($submitOrder as $player) {
-                $action->execute(
-                    $game,
-                    $player,
-                    ['type' => 'pass_cards', 'cards' => ['2H', '3H', '4H']]
-                );
-                $game->refresh();
-            }
-
-            // Verify all actions recorded
-            expect(Action::where('game_id', $game->id)->count())->toBe(4)
-                ->and($game->game_state['phase'])->toBe('play');
-        });
-    });
-
-    describe('Player Timeout During Coordination', function () {
-        it('applies timeout handler when player does not submit action', function () {
-            $game = Game::factory()->create(['status' => GameStatusEnum::IN_PROGRESS]);
-            $players = collect([]);
-
-            for ($i = 1; $i <= 4; $i++) {
-                $players->push(Player::factory()->for($game)->position($i)->create());
-            }
-
-            $action = new CoordinatedActionProcessor;
-
-            // 3 players submit
-            foreach ($players->take(3) as $player) {
-                $action->execute(
-                    $game,
-                    $player,
-                    ['type' => 'pass_cards', 'cards' => ['2H', '3H', '4H']]
-                );
-            }
-
-            $game->refresh();
-
-            // Simulate timeout for 4th player
-            $timeoutPlayer = $players->last();
-            $game->update([
-                'game_state' => array_merge($game->game_state, [
-                    'timeout_player_id' => $timeoutPlayer->id,
-                ]),
-            ]);
-
-            // Process timeout (would normally be handled by HandleTimeoutAction)
-            // Game should still advance
-            expect($game->game_state)->toHaveKey('timeout_player_id');
-        });
-
-        it('handles multiple consecutive timeouts for same player', function () {
-            $game = Game::factory()->create(['status' => GameStatusEnum::IN_PROGRESS]);
-            $players = collect([]);
-
-            for ($i = 1; $i <= 4; $i++) {
-                $players->push(Player::factory()->for($game)->position($i)->create());
-            }
-
-            $slowPlayer = $players->first();
-            $action = new CoordinatedActionProcessor;
-
-            // First round - slow player times out
-            foreach ($players->skip(1) as $player) {
-                $action->execute($game, $player, ['type' => 'pass_cards', 'cards' => ['2H', '3H', '4H']]);
+            foreach ($submitOrder as $index => $player) {
+                $action = new PassCards(['2H', '3H', '4H']);
+                $result = $processor->process($game, $action, $mode, $gameState, $player);
+
+                if ($index < 3) {
+                    expect($result->coordinationComplete)->toBeFalse();
+                    Action::create([
+                        'game_id' => $game->id,
+                        'player_id' => $player->id,
+                        'action_type' => 'pass_cards',
+                        'action_details' => $action->toArray(),
+                        'turn_number' => $game->turn_number ?? 1,
+                        'status' => 'success',
+                        'coordination_group' => $result->coordinationGroup,
+                        'is_coordinated' => true,
+                        'ulid' => (string) Str::ulid(),
+                    ]);
+                } else {
+                    expect($result->coordinationComplete)->toBeTrue();
+                }
             }
-
-            $game->refresh();
-            expect($game->game_state['waiting_for_players'])->toContain((string) $slowPlayer->id);
-
-            // Second round - same player times out again
-            $game->update(['game_state' => array_merge($game->game_state, ['phase' => 'pass_2'])]);
-
-            foreach ($players->skip(1) as $player) {
-                $action->execute($game, $player, ['type' => 'pass_cards', 'cards' => ['2S', '3S', '4S']]);
-            }
-
-            $game->refresh();
-            expect($game->game_state['timeout_count'][$slowPlayer->id] ?? 0)->toBeGreaterThan(0);
-        });
-    });
-
-    describe('Race Conditions', function () {
-        it('handles two players submitting simultaneously without duplicate processing', function () {
-            $game = Game::factory()->create(['status' => GameStatusEnum::IN_PROGRESS]);
-            $player1 = Player::factory()->for($game)->position(1)->create();
-            $player2 = Player::factory()->for($game)->position(2)->create();
-
-            $action = new CoordinatedActionProcessor;
-
-            // Simulate simultaneous submission (in reality handled by database locks)
-            $action->execute($game, $player1, ['type' => 'pass_cards', 'cards' => ['2H', '3H', '4H']]);
-            $action->execute($game, $player2, ['type' => 'pass_cards', 'cards' => ['2D', '3D', '4D']]);
-
-            $game->refresh();
-
-            // Each player should have exactly one action recorded
-            expect(Action::where('game_id', $game->id)->where('player_id', $player1->id)->count())->toBe(1)
-                ->and(Action::where('game_id', $game->id)->where('player_id', $player2->id)->count())->toBe(1);
-        });
-
-        it('prevents player from submitting action twice in same coordination phase', function () {
-            $game = Game::factory()->create(['status' => GameStatusEnum::IN_PROGRESS]);
-            $player = Player::factory()->for($game)->position(1)->create();
-
-            $action = new CoordinatedActionProcessor;
-
-            // First submission
-            $action->execute($game, $player, ['type' => 'pass_cards', 'cards' => ['2H', '3H', '4H']]);
-
-            // Attempt second submission (should be rejected or ignored)
-            try {
-                $action->execute($game, $player, ['type' => 'pass_cards', 'cards' => ['2D', '3D', '4D']]);
-            } catch (\Exception $e) {
-                // Expected to throw exception or be silently ignored
-            }
-
-            // Should only have one action
-            expect(Action::where('game_id', $game->id)->where('player_id', $player->id)->count())->toBe(1);
-        });
-    });
-
-    describe('WebSocket Notifications', function () {
-        it('sends notifications to all players when coordination completes', function () {
-            Queue::fake();
-
-            $game = Game::factory()->create(['status' => GameStatusEnum::IN_PROGRESS]);
-            $players = collect([]);
-
-            for ($i = 1; $i <= 4; $i++) {
-                $players->push(Player::factory()->for($game)->position($i)->create());
-            }
-
-            $action = new CoordinatedActionProcessor;
-
-            // Submit all actions
-            foreach ($players as $player) {
-                $action->execute($game, $player, ['type' => 'pass_cards', 'cards' => ['2H', '3H', '4H']]);
-            }
-
-            // Verify broadcast job was dispatched (would contain game state update)
-            Queue::assertPushed(function ($job) use ($game) {
-                return property_exists($job, 'game') && $job->game->id === $game->id;
-            });
         });
     });
 });
diff --git a/tests/Integration/Game/TimeoutHandlingTest.php b/tests/Integration/Game/TimeoutHandlingTest.php
index 1acaf833..667e29aa 100644
--- a/tests/Integration/Game/TimeoutHandlingTest.php
+++ b/tests/Integration/Game/TimeoutHandlingTest.php
@@ -1,231 +1,51 @@
 <?php
 
-use App\Enums\GameStatusEnum;
-use App\GameTitles\Hearts\Handlers\ForfeitHandler;
-use App\GameTitles\Hearts\Handlers\NoneHandler;
-use App\GameTitles\Hearts\Handlers\PassHandler;
+use App\Enums\GameStatus;
+use App\GameEngine\Timers\TimerExpiredHandler;
+use App\GameTitles\Hearts\Modes\StandardMode;
 use App\Models\Games\Game;
 use App\Models\Games\Player;
-
-describe('Timeout Handling Across Game States', function () {
-    describe('Timeout During Card Passing Phase', function () {
-        it('applies PassHandler and auto-passes random cards', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::IN_PROGRESS,
-                'game_state' => [
-                    'phase' => 'pass',
-                    'pass_direction' => 'left',
-                ],
-            ]);
-
-            $players = collect([]);
-            for ($i = 1; $i <= 4; $i++) {
-                $players->push(Player::factory()->for($game)->position($i)->create());
-            }
-
-            $timeoutPlayer = $players->first();
-
-            // Set up game waiting for this player
-            $game->update([
-                'game_state' => array_merge($game->game_state, [
-                    'waiting_for_players' => [(string) $timeoutPlayer->id],
-                    'hands' => [
-                        (string) $timeoutPlayer->id => ['2H', '3H', '4H', '5H', '6H'],
-                    ],
-                ]),
-            ]);
-
-            $handler = new PassHandler;
-            $handler->handle($game, $timeoutPlayer);
-
-            $game->refresh();
-
-            // Verify cards were auto-passed
-            expect($game->game_state)->toHaveKey('passed_cards')
-                ->and($game->game_state['passed_cards'][(string) $timeoutPlayer->id])->toHaveCount(3);
-        });
-
-        it('continues game after timeout without blocking other players', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::IN_PROGRESS,
-                'game_state' => ['phase' => 'pass'],
-            ]);
-
-            $players = collect([]);
-            for ($i = 1; $i <= 4; $i++) {
-                $players->push(Player::factory()->for($game)->position($i)->create());
-            }
-
-            $timeoutPlayer = $players->first();
-
-            // Other players already submitted
-            $game->update([
-                'game_state' => array_merge($game->game_state, [
-                    'waiting_for_players' => [(string) $timeoutPlayer->id],
-                ]),
-            ]);
-
-            $handler = new PassHandler;
-            $handler->handle($game, $timeoutPlayer);
-
-            $game->refresh();
-
-            // Game should advance to play phase
-            expect($game->game_state['phase'])->toBe('play')
-                ->and($game->game_state)->not->toHaveKey('waiting_for_players');
-        });
-    });
-
-    describe('Timeout During Regular Play', function () {
-        it('applies ForfeitHandler and player forfeits turn', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::IN_PROGRESS,
-                'game_state' => [
-                    'phase' => 'play',
-                    'current_turn' => 1,
-                ],
-            ]);
-
-            $player = Player::factory()->for($game)->position(1)->create();
-
-            $handler = new ForfeitHandler;
-            $handler->handle($game, $player);
-
-            $game->refresh();
-
-            // Verify forfeit was recorded
-            expect($game->game_state)->toHaveKey('forfeits')
-                ->and($game->game_state['forfeits'])->toContain((string) $player->id);
-        });
-
-        it('advances turn to next player after forfeit', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::IN_PROGRESS,
-                'game_state' => [
-                    'phase' => 'play',
-                    'current_turn' => 1,
-                    'turn_order' => [1, 2, 3, 4],
-                ],
-            ]);
-
-            $player1 = Player::factory()->for($game)->position(1)->create();
-            Player::factory()->for($game)->position(2)->create();
-
-            $handler = new ForfeitHandler;
-            $handler->handle($game, $player1);
-
-            $game->refresh();
-
-            // Turn should advance to player 2
-            expect($game->game_state['current_turn'])->toBe(2);
-        });
-    });
-
-    describe('Timeout During Game End', function () {
-        it('applies NoneHandler and takes no action', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::COMPLETED,
-                'game_state' => ['phase' => 'end'],
-            ]);
-
-            $player = Player::factory()->for($game)->position(1)->create();
-
-            $handler = new NoneHandler;
-            $result = $handler->handle($game, $player);
-
-            // Should return without making changes
-            expect($result)->toBeNull();
-        });
-    });
-
-    describe('Multiple Consecutive Timeouts', function () {
-        it('tracks timeout count and applies increasing penalties', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::IN_PROGRESS,
-                'game_state' => ['phase' => 'play'],
-            ]);
-
-            $player = Player::factory()->for($game)->position(1)->create();
-
-            $handler = new ForfeitHandler;
-
-            // First timeout
-            $handler->handle($game, $player);
-            $game->refresh();
-
-            $firstTimeoutCount = $game->game_state['timeout_count'][(string) $player->id] ?? 0;
-
-            // Second timeout
-            $handler->handle($game, $player);
-            $game->refresh();
-
-            $secondTimeoutCount = $game->game_state['timeout_count'][(string) $player->id] ?? 0;
-
-            expect($secondTimeoutCount)->toBeGreaterThan($firstTimeoutCount);
-        });
-
-        it('removes player from game after excessive timeouts', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::IN_PROGRESS,
-                'game_state' => [
-                    'phase' => 'play',
-                    'timeout_count' => [],
-                ],
-            ]);
-
-            $player = Player::factory()->for($game)->position(1)->create();
-
-            $handler = new ForfeitHandler;
-
-            // Simulate 5 consecutive timeouts
-            for ($i = 0; $i < 5; $i++) {
-                $game->update([
-                    'game_state' => array_merge($game->game_state, [
-                        'timeout_count' => [
-                            (string) $player->id => $i,
-                        ],
-                    ]),
-                ]);
-
-                $handler->handle($game, $player);
-                $game->refresh();
-            }
-
-            // Player should be marked as removed or game forfeited
-            expect($game->game_state['timeout_count'][(string) $player->id])->toBeGreaterThanOrEqual(5);
-        });
-    });
-
-    describe('Timeout While Player is Submitting', function () {
-        it('honors player action if submitted before timeout processed', function () {
-            $game = Game::factory()->create([
-                'status' => GameStatusEnum::IN_PROGRESS,
-                'game_state' => [
-                    'phase' => 'play',
-                    'waiting_for_players' => ['1'],
-                ],
-            ]);
-
-            $player = Player::factory()->for($game)->position(1)->create();
-
-            // Player submits action
-            $game->update([
-                'game_state' => array_merge($game->game_state, [
-                    'actions' => [
-                        (string) $player->id => ['card' => '2H'],
-                    ],
-                    'waiting_for_players' => [], // Action processed
-                ]),
-            ]);
-
-            // Timeout handler fires (race condition)
-            $handler = new ForfeitHandler;
-            $handler->handle($game, $player);
-
-            $game->refresh();
-
-            // Should not override player's action
-            expect($game->game_state['actions'][(string) $player->id])->toBe(['card' => '2H']);
-        });
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Carbon;
+
+uses(RefreshDatabase::class);
+
+describe('Timeout Handling Integration', function () {
+    it('forfeits the game when a player times out in Standard Mode', function () {
+        // Create game with expired turn
+        $game = Game::factory()->create([
+            'title_slug' => 'hearts',
+            'status' => GameStatus::ACTIVE,
+            'turn_ends_at' => Carbon::now()->subMinute(),
+        ]);
+        
+        $players = collect();
+        for ($i = 0; $i < 4; $i++) {
+            $players->push(Player::factory()->for($game)->state(['position_id' => $i + 1])->create());
+        }
+        
+        $timeoutPlayer = $players->first();
+        
+        // Setup handler
+        $handler = new TimerExpiredHandler();
+        $mode = new StandardMode($game);
+        
+        // Mock game state
+        $gameState = new class {
+            public ?string $currentPlayerUlid = null;
+        };
+        $gameState->currentPlayerUlid = $timeoutPlayer->ulid;
+        
+        // Execute
+        $result = $handler->checkAndHandle($game, $mode, $gameState);
+        
+        // Assert
+        expect($result->hasExpired)->toBeTrue()
+            ->and($result->outcome->isFinished)->toBeTrue();
+            
+        // Check finding a winner (trait implementation picks first opponent)
+        // Verify it isn't the timeout player
+        expect($result->outcome->winnerUlid)->not->toBe($timeoutPlayer->ulid)
+            ->and($result->outcome->winnerUlid)->not->toBeNull();
     });
 });
diff --git a/tests/Integration/RematchCancellationTest.php b/tests/Integration/RematchCancellationTest.php
index 901955e7..62b15a23 100644
--- a/tests/Integration/RematchCancellationTest.php
+++ b/tests/Integration/RematchCancellationTest.php
@@ -42,7 +42,7 @@
             expect($proposal->status)->toBe(ProposalStatus::CANCELLED);
 
             Event::assertDispatched(ProposalCancelled::class, function ($event) use ($proposal) {
-                return $event->rematchRequest->id === $proposal->id
+                return $event->proposal->id === $proposal->id
                     && $event->reason === 'requester_unavailable';
             });
         });
@@ -63,7 +63,7 @@
             expect($proposal->status)->toBe(ProposalStatus::CANCELLED);
 
             Event::assertDispatched(ProposalCancelled::class, function ($event) use ($proposal) {
-                return $event->rematchRequest->id === $proposal->id
+                return $event->proposal->id === $proposal->id
                     && $event->reason === 'opponent_unavailable';
             });
         });
@@ -110,8 +110,8 @@
             $job = new CheckAndCancelPendingProposals($user->id);
             $job->handle();
 
-            expect($acceptedRematch->fresh()->status)->toBe('accepted')
-                ->and($declinedRematch->fresh()->status)->toBe('declined');
+            expect($acceptedRematch->fresh()->status)->toBe(ProposalStatus::ACCEPTED)
+                ->and($declinedRematch->fresh()->status)->toBe(ProposalStatus::DECLINED);
         });
 
         it('does nothing when user has no pending rematches', function () {
diff --git a/tests/Pest.php b/tests/Pest.php
index af5c5f58..73ad4691 100644
--- a/tests/Pest.php
+++ b/tests/Pest.php
@@ -15,7 +15,7 @@
 
 pest()->extend(Tests\TestCase::class)
     ->use(RefreshDatabase::class)
-    ->in('Feature', 'Unit', 'Integration');
+    ->in('Feature', 'Integration', 'Unit');
 
 /*
 |--------------------------------------------------------------------------

From 765e72fd5108d6f3495463446f3ee661ff66475b Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 17:57:20 -0400
Subject: [PATCH 07/21] Update repo name in composer json

---
 composer.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/composer.json b/composer.json
index 2af1c1d5..f2fedc82 100644
--- a/composer.json
+++ b/composer.json
@@ -1,6 +1,6 @@
 {
     "$schema": "https://getcomposer.org/schema.json",
-    "name": "w3rd/protocol",
+    "name": "roberts/w3rd",
     "type": "project",
     "description": "Backend API & real-time game engine protocol for W3RD multi-platform ecosystem.",
     "keywords": [

From 3456a1053c0cee7e2d3a5f46842f0caf798b69d7 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:03:25 -0400
Subject: [PATCH 08/21] Resolve phpstan issues

---
 .../Lifecycle/Progression/CoordinatedActionProcessor.php   | 3 ++-
 app/Http/Controllers/Api/V1/Auth/SocialAuthController.php  | 7 ++++---
 app/Services/Economy/AppleReceiptValidator.php             | 1 -
 3 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php b/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
index 9b6a7acb..9195de44 100644
--- a/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
+++ b/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
@@ -5,6 +5,7 @@
 namespace App\GameEngine\Lifecycle\Progression;
 
 use App\DataTransferObjects\Games\CoordinatedActionResult;
+use App\Enums\ActionType;
 use App\GameEngine\Interfaces\GameActionContract;
 use App\Models\Games\Action;
 use App\Models\Games\Game;
@@ -149,7 +150,7 @@ protected function completeCoordination(
         // Since we can't easily hydrate it completely without saving, we'll set what's needed for coordination
         $currentActionModel->setRelation('player', $player);
         $currentActionModel->action_details = $action->toArray();
-        $currentActionModel->action_type = $action->getType();
+        $currentActionModel->action_type = ActionType::from($action->getType());
         
         $coordinatedActions->push($currentActionModel);
 
diff --git a/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php b/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php
index 3db4aea0..76ba758f 100644
--- a/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php
+++ b/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php
@@ -24,9 +24,10 @@ public function __invoke(SocialLoginRequest $request): JsonResponse
     {
         try {
             // Verify token with provider
-            /** @phpstan-ignore-next-line */
-            $providerUser = Socialite::driver($request->provider)
-                ->userFromToken($request->access_token);
+            $driver = Socialite::driver($request->provider);
+            
+            /** @var \Laravel\Socialite\Two\AbstractProvider $driver */
+            $providerUser = $driver->userFromToken($request->access_token);
 
             // Find or create user and social account
             $result = $this->authService->handleSocialLogin(
diff --git a/app/Services/Economy/AppleReceiptValidator.php b/app/Services/Economy/AppleReceiptValidator.php
index e5970282..c324eed4 100644
--- a/app/Services/Economy/AppleReceiptValidator.php
+++ b/app/Services/Economy/AppleReceiptValidator.php
@@ -93,7 +93,6 @@ private function callAppleAPI(string $jwt, string $transactionId): array
 
         $response = curl_exec($ch);
         $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
-        curl_close($ch);
 
         if ($httpCode !== 200) {
             throw new PaymentValidationException(

From 9d6e41bbf466c2a0669105c9b49d9a7458687ae1 Mon Sep 17 00:00:00 2001
From: drewroberts <24581081+drewroberts@users.noreply.github.com>
Date: Wed, 11 Mar 2026 22:04:00 +0000
Subject: [PATCH 09/21] Fix php code style issues

---
 .../Fortify/PasswordValidationRules.php       |  3 ++-
 app/Agents/Logic/HeuristicLogic.php           |  9 +++++---
 app/Agents/Logic/MinimaxLogic.php             |  9 +++++---
 app/Agents/Logic/RandomLogic.php              |  9 +++++---
 .../Interfaces/GameTitleContract.php          |  3 ++-
 .../CoordinatedActionProcessor.php            |  6 ++---
 app/GameEngine/ModeRegistry.php               | 15 ++++++++----
 .../ConnectFour/ConnectFourBoard.php          |  3 ++-
 .../Api/V1/Account/ProgressionController.php  |  3 ++-
 .../Api/V1/Auth/SocialAuthController.php      |  5 ++--
 .../V1/Competitions/StandingsController.php   |  3 ++-
 .../Api/V1/System/ConfigController.php        |  3 ++-
 .../Api/V1/System/FeedbackController.php      |  3 ++-
 app/Http/Middleware/EnsureIdempotency.php     |  2 +-
 .../Requests/Account/UpdateProfileRequest.php |  6 +++--
 .../Requests/Games/ForfeitGameRequest.php     |  4 +++-
 .../Requests/Games/RequestRematchRequest.php  |  3 ++-
 .../Matchmaking/CancelLobbyRequest.php        |  3 ++-
 .../Matchmaking/InitiateReadyCheckRequest.php |  3 ++-
 app/Http/Requests/StoreApplicationRequest.php |  3 ++-
 app/Http/Requests/StoreWorkflowRequest.php    |  3 ++-
 .../Requests/StoreWorkflowStepRequest.php     |  3 ++-
 .../Requests/UpdateApplicationRequest.php     |  3 ++-
 app/Http/Requests/UpdateWorkflowRequest.php   |  3 ++-
 .../Requests/UpdateWorkflowStepRequest.php    |  3 ++-
 app/Http/Traits/ApiResponses.php              |  6 +++--
 app/Jobs/CalculateAgentAction.php             |  3 ++-
 app/Matchmaking/Lobby/LobbyValidator.php      |  3 ++-
 app/Matchmaking/Proposals/RematchHandler.php  |  3 ++-
 app/Models/Access/Client.php                  |  3 ++-
 app/Models/Account/Alert.php                  | 10 ++++----
 app/Models/Application.php                    |  3 ++-
 app/Models/Auth/Agent.php                     |  6 +++--
 app/Models/Auth/Entry.php                     |  3 ++-
 app/Models/Auth/Registration.php              |  3 ++-
 app/Models/Auth/SocialAccount.php             |  3 ++-
 app/Models/Auth/User.php                      |  3 ++-
 app/Models/Competitions/Tournament.php        | 14 ++++++-----
 app/Models/Content/Avatar.php                 |  3 ++-
 app/Models/Economy/Balance.php                |  5 ++--
 app/Models/Economy/Quota.php                  |  3 ++-
 app/Models/Economy/Strike.php                 |  3 ++-
 app/Models/Economy/Transaction.php            |  5 ++--
 app/Models/Games/Action.php                   |  8 ++++---
 app/Models/Games/Game.php                     | 23 +++++++++++--------
 app/Models/Games/Mode.php                     | 17 ++++++++------
 app/Models/Games/Player.php                   |  3 ++-
 app/Models/Gamification/Badge.php             |  3 ++-
 app/Models/Gamification/GlobalRank.php        |  3 ++-
 app/Models/Gamification/Point.php             |  3 ++-
 app/Models/Gamification/UserTitleLevel.php    |  6 +++--
 app/Models/Matchmaking/Lobby.php              | 13 +++++++----
 app/Models/Matchmaking/LobbyPlayer.php        |  8 ++++---
 app/Models/Matchmaking/Proposal.php           | 12 ++++++----
 app/Models/Matchmaking/QueueSlot.php          |  3 ++-
 app/Models/Workflow.php                       |  3 ++-
 app/Models/WorkflowStep.php                   |  3 ++-
 app/Policies/ApplicationPolicy.php            |  1 -
 app/Policies/WorkflowPolicy.php               |  1 -
 app/Policies/WorkflowStepPolicy.php           |  1 -
 .../Competitions/CompetitionService.php       |  3 ++-
 .../Games/GameResponseEnhancementService.php  |  5 ++--
 app/Services/System/SystemHealthService.php   |  3 ++-
 bootstrap/app.php                             |  4 ++--
 bootstrap/providers.php                       | 10 +++++---
 config/auth.php                               |  4 +++-
 config/database.php                           |  5 ++--
 config/permission.php                         | 12 ++++++----
 database/factories/Access/ClientFactory.php   |  6 +++--
 database/factories/Account/AlertFactory.php   |  2 +-
 database/factories/ApplicationFactory.php     |  2 +-
 database/factories/Auth/EntryFactory.php      |  2 +-
 .../factories/Auth/RegistrationFactory.php    |  2 +-
 .../factories/Auth/SocialAccountFactory.php   |  2 +-
 database/factories/Auth/UserFactory.php       |  3 ++-
 database/factories/Content/AvatarFactory.php  |  2 +-
 database/factories/Economy/QuotaFactory.php   |  2 +-
 database/factories/Economy/StrikeFactory.php  |  2 +-
 .../factories/Economy/SubscriptionFactory.php |  2 +-
 database/factories/Games/ActionFactory.php    |  2 +-
 database/factories/Games/GameFactory.php      |  4 ++--
 database/factories/Games/ModeFactory.php      |  2 +-
 database/factories/Games/PlayerFactory.php    |  4 ++--
 .../factories/Gamification/BadgeFactory.php   |  2 +-
 .../Gamification/GlobalRankFactory.php        |  2 +-
 .../factories/Gamification/PointFactory.php   |  2 +-
 .../Gamification/UserTitleLevelFactory.php    |  2 +-
 .../factories/Matchmaking/ProposalFactory.php |  2 +-
 .../Matchmaking/QueueSlotFactory.php          |  2 +-
 database/factories/WorkflowFactory.php        |  2 +-
 database/factories/WorkflowStepFactory.php    |  2 +-
 database/seeders/ApplicationSeeder.php        |  1 -
 database/seeders/WorkflowSeeder.php           |  1 -
 database/seeders/WorkflowStepSeeder.php       |  1 -
 tests/CreatesApplication.php                  |  3 ++-
 tests/Feature/Agents/QueueMatchmakingTest.php |  1 -
 .../Agents/QuickplayMatchmakingTest.php       |  1 -
 tests/Integration/ActivityTrackingTest.php    |  9 ++++----
 .../Game/CoordinatedActionsTest.php           | 14 +++++------
 .../Integration/Game/TimeoutHandlingTest.php  | 19 +++++++--------
 tests/Integration/RematchCancellationTest.php |  1 -
 tests/Pest.php                                |  3 ++-
 tests/TestCase.php                            |  2 --
 tests/Unit/AgentAutoAcceptRematchTest.php     |  5 ++--
 .../Agents/AgentSchedulingServiceTest.php     |  1 -
 tests/Unit/Agents/AgentServiceTest.php        |  1 -
 tests/Unit/PlayerActivityManagerTest.php      |  1 -
 107 files changed, 278 insertions(+), 193 deletions(-)

diff --git a/app/Actions/Fortify/PasswordValidationRules.php b/app/Actions/Fortify/PasswordValidationRules.php
index b4c2385a..12120e42 100644
--- a/app/Actions/Fortify/PasswordValidationRules.php
+++ b/app/Actions/Fortify/PasswordValidationRules.php
@@ -2,6 +2,7 @@
 
 namespace App\Actions\Fortify;
 
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Validation\Rules\Password;
 
 trait PasswordValidationRules
@@ -9,7 +10,7 @@ trait PasswordValidationRules
     /**
      * Get the validation rules used to validate passwords.
      *
-     * @return array<int, \Illuminate\Validation\Rules\Password|\Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<int, Password|ValidationRule|array<mixed>|string>
      */
     protected function passwordRules(): array
     {
diff --git a/app/Agents/Logic/HeuristicLogic.php b/app/Agents/Logic/HeuristicLogic.php
index 261da1d6..7c23339f 100644
--- a/app/Agents/Logic/HeuristicLogic.php
+++ b/app/Agents/Logic/HeuristicLogic.php
@@ -2,6 +2,9 @@
 
 namespace App\Agents\Logic;
 
+use App\Games\Checkers\CheckersLogic;
+use App\Games\Hearts\HeartsLogic;
+use App\Games\ValidateFour\ValidateFourLogic;
 use App\Interfaces\AgentContract;
 use App\Models\Games\Game;
 use Illuminate\Support\Facades\Log;
@@ -124,11 +127,11 @@ protected function getGameLogic(Game $game): object
 
         return match ($gameTitle) {
             // @phpstan-ignore class.notFound
-            'checkers' => app(\App\Games\Checkers\CheckersLogic::class),
+            'checkers' => app(CheckersLogic::class),
             // @phpstan-ignore class.notFound
-            'hearts' => app(\App\Games\Hearts\HeartsLogic::class),
+            'hearts' => app(HeartsLogic::class),
             // @phpstan-ignore class.notFound, match.alwaysFalse
-            'validatefour' => app(\App\Games\ValidateFour\ValidateFourLogic::class),
+            'validatefour' => app(ValidateFourLogic::class),
             default => throw new \Exception("Unsupported game type: {$gameTitle}"),
         };
     }
diff --git a/app/Agents/Logic/MinimaxLogic.php b/app/Agents/Logic/MinimaxLogic.php
index da1c6e5b..e319fe86 100644
--- a/app/Agents/Logic/MinimaxLogic.php
+++ b/app/Agents/Logic/MinimaxLogic.php
@@ -2,6 +2,9 @@
 
 namespace App\Agents\Logic;
 
+use App\Games\Checkers\CheckersLogic;
+use App\Games\Hearts\HeartsLogic;
+use App\Games\ValidateFour\ValidateFourLogic;
 use App\Interfaces\AgentContract;
 use App\Models\Games\Game;
 use Illuminate\Support\Facades\Log;
@@ -163,11 +166,11 @@ protected function getGameLogic(Game $game): object
 
         return match ($gameTitle) {
             // @phpstan-ignore class.notFound
-            'checkers' => app(\App\Games\Checkers\CheckersLogic::class),
+            'checkers' => app(CheckersLogic::class),
             // @phpstan-ignore class.notFound
-            'hearts' => app(\App\Games\Hearts\HeartsLogic::class),
+            'hearts' => app(HeartsLogic::class),
             // @phpstan-ignore class.notFound, match.alwaysFalse
-            'validatefour' => app(\App\Games\ValidateFour\ValidateFourLogic::class),
+            'validatefour' => app(ValidateFourLogic::class),
             default => throw new \Exception("Unsupported game type: {$gameTitle}"),
         };
     }
diff --git a/app/Agents/Logic/RandomLogic.php b/app/Agents/Logic/RandomLogic.php
index db3952ae..fae80f32 100644
--- a/app/Agents/Logic/RandomLogic.php
+++ b/app/Agents/Logic/RandomLogic.php
@@ -2,6 +2,9 @@
 
 namespace App\Agents\Logic;
 
+use App\Games\Checkers\CheckersLogic;
+use App\Games\Hearts\HeartsLogic;
+use App\Games\ValidateFour\ValidateFourLogic;
 use App\Interfaces\AgentContract;
 use App\Models\Games\Game;
 use Illuminate\Support\Facades\Log;
@@ -65,11 +68,11 @@ protected function getGameLogic(Game $game): object
 
         return match ($gameTitle) {
             // @phpstan-ignore class.notFound
-            'checkers' => app(\App\Games\Checkers\CheckersLogic::class),
+            'checkers' => app(CheckersLogic::class),
             // @phpstan-ignore class.notFound
-            'hearts' => app(\App\Games\Hearts\HeartsLogic::class),
+            'hearts' => app(HeartsLogic::class),
             // @phpstan-ignore class.notFound, match.alwaysFalse
-            'validatefour' => app(\App\Games\ValidateFour\ValidateFourLogic::class),
+            'validatefour' => app(ValidateFourLogic::class),
             default => throw new \Exception("Unsupported game type: {$gameTitle}"),
         };
     }
diff --git a/app/GameEngine/Interfaces/GameTitleContract.php b/app/GameEngine/Interfaces/GameTitleContract.php
index 0286fdd4..8d494ba5 100644
--- a/app/GameEngine/Interfaces/GameTitleContract.php
+++ b/app/GameEngine/Interfaces/GameTitleContract.php
@@ -15,6 +15,7 @@
 use App\Exceptions\Game\TurnTimerExpiredException;
 use App\GameEngine\GameOutcome;
 use App\GameEngine\ValidationResult;
+use App\Games\ValidateFour\BaseValidateFourMode;
 use App\Models\Auth\User;
 use App\Models\Games\Game;
 use Carbon\Carbon;
@@ -55,7 +56,7 @@
  * }
  * ```
  *
- * @see \App\Games\ValidateFour\BaseValidateFourMode For Connect Four implementation
+ * @see BaseValidateFourMode For Connect Four implementation
  */
 interface GameTitleContract
 {
diff --git a/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php b/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
index 9195de44..46f63ad8 100644
--- a/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
+++ b/app/GameEngine/Lifecycle/Progression/CoordinatedActionProcessor.php
@@ -146,12 +146,12 @@ protected function completeCoordination(
             ->get();
 
         // Add the current action to the list (as a transient Action model)
-        $currentActionModel = new Action();
+        $currentActionModel = new Action;
         // Since we can't easily hydrate it completely without saving, we'll set what's needed for coordination
         $currentActionModel->setRelation('player', $player);
         $currentActionModel->action_details = $action->toArray();
         $currentActionModel->action_type = ActionType::from($action->getType());
-        
+
         $coordinatedActions->push($currentActionModel);
 
         // Process the coordinated actions through the game mode
@@ -162,7 +162,7 @@ protected function completeCoordination(
             ->withCoordinationGroup($coordinationGroup)
             ->pendingCoordination()
             ->update(['coordination_completed_at' => now()]);
-            
+
         // Note: The current action is not yet in the DB, so it won't be updated here.
         // The calling component is responsible for saving the current action with proper status.
 
diff --git a/app/GameEngine/ModeRegistry.php b/app/GameEngine/ModeRegistry.php
index f672b88e..47f51d2b 100644
--- a/app/GameEngine/ModeRegistry.php
+++ b/app/GameEngine/ModeRegistry.php
@@ -6,6 +6,11 @@
 
 use App\Exceptions\GameModeNotFoundException;
 use App\GameTitles\BaseGameTitle;
+use App\GameTitles\Checkers\Modes\StandardMode;
+use App\GameTitles\ConnectFour\Modes\EightBySevenMode;
+use App\GameTitles\ConnectFour\Modes\FiveMode;
+use App\GameTitles\ConnectFour\Modes\NineBySixMode;
+use App\GameTitles\ConnectFour\Modes\PopOutMode;
 use App\Models\Games\Game;
 
 /**
@@ -22,17 +27,17 @@ class ModeRegistry
      */
     private array $modes = [
         'checkers' => [
-            'standard' => \App\GameTitles\Checkers\Modes\StandardMode::class,
+            'standard' => StandardMode::class,
         ],
         'hearts' => [
             'standard' => \App\GameTitles\Hearts\Modes\StandardMode::class,
         ],
         'connect-four' => [
             'standard' => \App\GameTitles\ConnectFour\Modes\StandardMode::class,
-            'pop-out' => \App\GameTitles\ConnectFour\Modes\PopOutMode::class,
-            'five' => \App\GameTitles\ConnectFour\Modes\FiveMode::class,
-            'eight-by-seven' => \App\GameTitles\ConnectFour\Modes\EightBySevenMode::class,
-            'nine-by-six' => \App\GameTitles\ConnectFour\Modes\NineBySixMode::class,
+            'pop-out' => PopOutMode::class,
+            'five' => FiveMode::class,
+            'eight-by-seven' => EightBySevenMode::class,
+            'nine-by-six' => NineBySixMode::class,
         ],
     ];
 
diff --git a/app/GameTitles/ConnectFour/ConnectFourBoard.php b/app/GameTitles/ConnectFour/ConnectFourBoard.php
index 7e552e3a..f089d32c 100644
--- a/app/GameTitles/ConnectFour/ConnectFourBoard.php
+++ b/app/GameTitles/ConnectFour/ConnectFourBoard.php
@@ -7,6 +7,7 @@
 use App\Enums\GamePhase;
 use App\Enums\GameStatus;
 use App\GameTitles\BaseGameState;
+use App\Interfaces\GameTitleContract;
 
 /**
  * Immutable game state for Connect Four (Connect Four variant).
@@ -59,7 +60,7 @@
  * $gameState = ConnectFourConnectFourBoard::fromArray($game->game_state);
  * ```
  *
- * @see \App\Interfaces\GameTitleContract For the interface all game modes must implement
+ * @see GameTitleContract For the interface all game modes must implement
  */
 final class ConnectFourBoard extends BaseGameState
 {
diff --git a/app/Http/Controllers/Api/V1/Account/ProgressionController.php b/app/Http/Controllers/Api/V1/Account/ProgressionController.php
index 5d1efbe1..8b9f01d9 100644
--- a/app/Http/Controllers/Api/V1/Account/ProgressionController.php
+++ b/app/Http/Controllers/Api/V1/Account/ProgressionController.php
@@ -7,6 +7,7 @@
 use App\Http\Resources\Account\ProgressionResource;
 use App\Http\Traits\ApiResponses;
 use App\Models\Gamification\UserTitleLevel;
+use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 
@@ -27,7 +28,7 @@ public function __invoke(Request $request): JsonResponse
     {
         $user = $request->user();
 
-        /** @var \Illuminate\Database\Eloquent\Collection<int, UserTitleLevel> $levelCollection */
+        /** @var Collection<int, UserTitleLevel> $levelCollection */
         $levelCollection = $user->titleLevels()
             ->orderByDesc('last_played_at')
             ->get();
diff --git a/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php b/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php
index 76ba758f..ad63452d 100644
--- a/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php
+++ b/app/Http/Controllers/Api/V1/Auth/SocialAuthController.php
@@ -8,6 +8,7 @@
 use App\Services\Auth\AuthService;
 use Illuminate\Http\JsonResponse;
 use Laravel\Socialite\Facades\Socialite;
+use Laravel\Socialite\Two\AbstractProvider;
 
 class SocialAuthController extends Controller
 {
@@ -25,8 +26,8 @@ public function __invoke(SocialLoginRequest $request): JsonResponse
         try {
             // Verify token with provider
             $driver = Socialite::driver($request->provider);
-            
-            /** @var \Laravel\Socialite\Two\AbstractProvider $driver */
+
+            /** @var AbstractProvider $driver */
             $providerUser = $driver->userFromToken($request->access_token);
 
             // Find or create user and social account
diff --git a/app/Http/Controllers/Api/V1/Competitions/StandingsController.php b/app/Http/Controllers/Api/V1/Competitions/StandingsController.php
index affd2c1f..3a3e78f2 100644
--- a/app/Http/Controllers/Api/V1/Competitions/StandingsController.php
+++ b/app/Http/Controllers/Api/V1/Competitions/StandingsController.php
@@ -7,6 +7,7 @@
 use App\Http\Traits\ApiResponses;
 use App\Models\Auth\User;
 use App\Models\Competitions\Tournament;
+use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 
@@ -21,7 +22,7 @@ public function show(Request $request, Tournament $tournament): JsonResponse
     {
         $tournament->load(['users.avatar.image']);
 
-        /** @var \Illuminate\Database\Eloquent\Collection<int, User> $users */
+        /** @var Collection<int, User> $users */
         $users = $tournament->users()
             ->orderBy('tournament_user.placement', 'asc')
             ->orderBy('tournament_user.earnings', 'desc')
diff --git a/app/Http/Controllers/Api/V1/System/ConfigController.php b/app/Http/Controllers/Api/V1/System/ConfigController.php
index c227d54e..21d58b3b 100644
--- a/app/Http/Controllers/Api/V1/System/ConfigController.php
+++ b/app/Http/Controllers/Api/V1/System/ConfigController.php
@@ -2,6 +2,7 @@
 
 namespace App\Http\Controllers\Api\V1\System;
 
+use App\Enums\GameTitle;
 use App\Http\Controllers\Controller;
 use Illuminate\Http\JsonResponse;
 
@@ -24,7 +25,7 @@ public function __invoke(): JsonResponse
                 'leaderboards' => true,
                 'sse_feeds' => true,
             ],
-            'supported_games' => collect(\App\Enums\GameTitle::cases())->map(fn ($title) => [
+            'supported_games' => collect(GameTitle::cases())->map(fn ($title) => [
                 'key' => $title->value,
                 'name' => $title->label(),
                 'min_players' => $title->minPlayers(),
diff --git a/app/Http/Controllers/Api/V1/System/FeedbackController.php b/app/Http/Controllers/Api/V1/System/FeedbackController.php
index 042fcdd4..598eccc5 100644
--- a/app/Http/Controllers/Api/V1/System/FeedbackController.php
+++ b/app/Http/Controllers/Api/V1/System/FeedbackController.php
@@ -6,6 +6,7 @@
 use App\Http\Controllers\Controller;
 use App\Http\Resources\System\FeedbackResource;
 use App\Models\System\Feedback;
+use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Validation\Rule;
 use Illuminate\Validation\Rules\Enum;
@@ -13,7 +14,7 @@
 class FeedbackController extends Controller
 {
     /**
-     * @return \Illuminate\Http\JsonResponse
+     * @return JsonResponse
      */
     public function __invoke(Request $request)
     {
diff --git a/app/Http/Middleware/EnsureIdempotency.php b/app/Http/Middleware/EnsureIdempotency.php
index 04b0df9c..8ca34142 100644
--- a/app/Http/Middleware/EnsureIdempotency.php
+++ b/app/Http/Middleware/EnsureIdempotency.php
@@ -14,7 +14,7 @@ class EnsureIdempotency
     /**
      * Handle an incoming request.
      *
-     * @param  \Closure(\Illuminate\Http\Request): (\Symfony\Component\HttpFoundation\Response)  $next
+     * @param  Closure(Request): (Response)  $next
      */
     public function handle(Request $request, Closure $next): Response
     {
diff --git a/app/Http/Requests/Account/UpdateProfileRequest.php b/app/Http/Requests/Account/UpdateProfileRequest.php
index 96d01f5c..c939ce4b 100644
--- a/app/Http/Requests/Account/UpdateProfileRequest.php
+++ b/app/Http/Requests/Account/UpdateProfileRequest.php
@@ -3,6 +3,8 @@
 namespace App\Http\Requests\Account;
 
 use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\ValidationException;
+use Illuminate\Validation\Validator;
 
 class UpdateProfileRequest extends FormRequest
 {
@@ -60,7 +62,7 @@ public function messages(): array
     /**
      * Configure the validator instance to check username permission AFTER validation passes.
      *
-     * @param  \Illuminate\Validation\Validator  $validator
+     * @param  Validator  $validator
      * @return void
      */
     public function withValidator($validator)
@@ -83,7 +85,7 @@ protected function failedValidation(\Illuminate\Contracts\Validation\Validator $
     {
         // If username permission check failed, return 403 instead of 422
         if ($validator->errors()->has('_permission_denied')) {
-            throw new \Illuminate\Validation\ValidationException(
+            throw new ValidationException(
                 $validator,
                 response()->json([
                     'message' => 'You do not have permission to update your username.',
diff --git a/app/Http/Requests/Games/ForfeitGameRequest.php b/app/Http/Requests/Games/ForfeitGameRequest.php
index fc168226..09a1ce88 100644
--- a/app/Http/Requests/Games/ForfeitGameRequest.php
+++ b/app/Http/Requests/Games/ForfeitGameRequest.php
@@ -2,6 +2,8 @@
 
 namespace App\Http\Requests\Games;
 
+use Illuminate\Contracts\Validation\ValidationRule;
+
 class ForfeitGameRequest extends BaseGameRequest
 {
     /**
@@ -15,7 +17,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/Games/RequestRematchRequest.php b/app/Http/Requests/Games/RequestRematchRequest.php
index e8484712..7b9383bc 100644
--- a/app/Http/Requests/Games/RequestRematchRequest.php
+++ b/app/Http/Requests/Games/RequestRematchRequest.php
@@ -3,6 +3,7 @@
 namespace App\Http\Requests\Games;
 
 use App\Enums\GameStatus;
+use Illuminate\Contracts\Validation\ValidationRule;
 
 class RequestRematchRequest extends BaseGameRequest
 {
@@ -23,7 +24,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/Matchmaking/CancelLobbyRequest.php b/app/Http/Requests/Matchmaking/CancelLobbyRequest.php
index 8611e82d..5e8e9a5a 100644
--- a/app/Http/Requests/Matchmaking/CancelLobbyRequest.php
+++ b/app/Http/Requests/Matchmaking/CancelLobbyRequest.php
@@ -4,6 +4,7 @@
 
 use App\Matchmaking\Enums\LobbyStatus;
 use App\Models\Matchmaking\Lobby;
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class CancelLobbyRequest extends FormRequest
@@ -35,7 +36,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/Matchmaking/InitiateReadyCheckRequest.php b/app/Http/Requests/Matchmaking/InitiateReadyCheckRequest.php
index 80733536..a5b2fd57 100644
--- a/app/Http/Requests/Matchmaking/InitiateReadyCheckRequest.php
+++ b/app/Http/Requests/Matchmaking/InitiateReadyCheckRequest.php
@@ -4,6 +4,7 @@
 
 use App\Matchmaking\Enums\LobbyStatus;
 use App\Models\Matchmaking\Lobby;
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class InitiateReadyCheckRequest extends FormRequest
@@ -35,7 +36,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/StoreApplicationRequest.php b/app/Http/Requests/StoreApplicationRequest.php
index 635fbc54..25c0097e 100644
--- a/app/Http/Requests/StoreApplicationRequest.php
+++ b/app/Http/Requests/StoreApplicationRequest.php
@@ -2,6 +2,7 @@
 
 namespace App\Http\Requests;
 
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class StoreApplicationRequest extends FormRequest
@@ -17,7 +18,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/StoreWorkflowRequest.php b/app/Http/Requests/StoreWorkflowRequest.php
index 2a9f07aa..bc7be4b1 100644
--- a/app/Http/Requests/StoreWorkflowRequest.php
+++ b/app/Http/Requests/StoreWorkflowRequest.php
@@ -2,6 +2,7 @@
 
 namespace App\Http\Requests;
 
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class StoreWorkflowRequest extends FormRequest
@@ -17,7 +18,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/StoreWorkflowStepRequest.php b/app/Http/Requests/StoreWorkflowStepRequest.php
index 64d4ce30..4b33a30e 100644
--- a/app/Http/Requests/StoreWorkflowStepRequest.php
+++ b/app/Http/Requests/StoreWorkflowStepRequest.php
@@ -2,6 +2,7 @@
 
 namespace App\Http\Requests;
 
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class StoreWorkflowStepRequest extends FormRequest
@@ -17,7 +18,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/UpdateApplicationRequest.php b/app/Http/Requests/UpdateApplicationRequest.php
index 37eb98e4..eb52534b 100644
--- a/app/Http/Requests/UpdateApplicationRequest.php
+++ b/app/Http/Requests/UpdateApplicationRequest.php
@@ -2,6 +2,7 @@
 
 namespace App\Http\Requests;
 
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class UpdateApplicationRequest extends FormRequest
@@ -17,7 +18,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/UpdateWorkflowRequest.php b/app/Http/Requests/UpdateWorkflowRequest.php
index eca02ae3..ed12362f 100644
--- a/app/Http/Requests/UpdateWorkflowRequest.php
+++ b/app/Http/Requests/UpdateWorkflowRequest.php
@@ -2,6 +2,7 @@
 
 namespace App\Http\Requests;
 
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class UpdateWorkflowRequest extends FormRequest
@@ -17,7 +18,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Requests/UpdateWorkflowStepRequest.php b/app/Http/Requests/UpdateWorkflowStepRequest.php
index b7368a86..7b1811fa 100644
--- a/app/Http/Requests/UpdateWorkflowStepRequest.php
+++ b/app/Http/Requests/UpdateWorkflowStepRequest.php
@@ -2,6 +2,7 @@
 
 namespace App\Http\Requests;
 
+use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
 
 class UpdateWorkflowStepRequest extends FormRequest
@@ -17,7 +18,7 @@ public function authorize(): bool
     /**
      * Get the validation rules that apply to the request.
      *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     * @return array<string, ValidationRule|array<mixed>|string>
      */
     public function rules(): array
     {
diff --git a/app/Http/Traits/ApiResponses.php b/app/Http/Traits/ApiResponses.php
index f3c45bc8..4730d1b3 100644
--- a/app/Http/Traits/ApiResponses.php
+++ b/app/Http/Traits/ApiResponses.php
@@ -2,6 +2,8 @@
 
 namespace App\Http\Traits;
 
+use App\Exceptions\InvalidActionDataException;
+use App\Exceptions\RematchNotAvailableException;
 use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Resources\Json\JsonResource;
@@ -224,10 +226,10 @@ protected function handleServiceCall(
     ): mixed {
         try {
             return $callback();
-        } catch (\App\Exceptions\RematchNotAvailableException $e) {
+        } catch (RematchNotAvailableException $e) {
             // Re-throw custom exceptions to let the exception handler deal with them
             throw $e;
-        } catch (\App\Exceptions\InvalidActionDataException $e) {
+        } catch (InvalidActionDataException $e) {
             // Re-throw action data validation exceptions
             throw $e;
         } catch (\Exception $e) {
diff --git a/app/Jobs/CalculateAgentAction.php b/app/Jobs/CalculateAgentAction.php
index e231f824..76536365 100644
--- a/app/Jobs/CalculateAgentAction.php
+++ b/app/Jobs/CalculateAgentAction.php
@@ -4,6 +4,7 @@
 
 use App\Agents\Orchestrators\AgentService;
 use App\Agents\Scheduling\AgentSchedulingService;
+use App\Games\Checkers\Actions\ActionHandler;
 use App\Models\Auth\Agent;
 use App\Models\Auth\User;
 use App\Models\Games\Game;
@@ -158,7 +159,7 @@ protected function applyAction(object $action): void
 
         $actionHandler = match ($gameTitle) {
             // @phpstan-ignore class.notFound
-            'checkers' => app(\App\Games\Checkers\Actions\ActionHandler::class),
+            'checkers' => app(ActionHandler::class),
             // @phpstan-ignore class.notFound
             'hearts' => app(\App\Games\Hearts\Actions\ActionHandler::class),
             // @phpstan-ignore class.notFound, match.alwaysFalse
diff --git a/app/Matchmaking/Lobby/LobbyValidator.php b/app/Matchmaking/Lobby/LobbyValidator.php
index f5a1ecf2..c6d5c9ae 100644
--- a/app/Matchmaking/Lobby/LobbyValidator.php
+++ b/app/Matchmaking/Lobby/LobbyValidator.php
@@ -2,6 +2,7 @@
 
 namespace App\Matchmaking\Lobby;
 
+use App\Enums\GameTitle;
 use App\Exceptions\InvalidGameConfigurationException;
 use App\Exceptions\LobbyStateException;
 use App\Exceptions\PlayerBusyException;
@@ -111,7 +112,7 @@ public function validateGameTitle(?object $gameTitle, string $slug): void
             throw new InvalidGameConfigurationException(
                 "Game title '{$slug}' is not supported",
                 $slug,
-                ['available_titles' => array_column(\App\Enums\GameTitle::cases(), 'value')]
+                ['available_titles' => array_column(GameTitle::cases(), 'value')]
             );
         }
     }
diff --git a/app/Matchmaking/Proposals/RematchHandler.php b/app/Matchmaking/Proposals/RematchHandler.php
index 1c27f026..cf9546ba 100644
--- a/app/Matchmaking/Proposals/RematchHandler.php
+++ b/app/Matchmaking/Proposals/RematchHandler.php
@@ -6,6 +6,7 @@
 
 use App\Enums\GameStatus;
 use App\Exceptions\RematchNotAvailableException;
+use App\GameEngine\Player\PlayerActivityManager;
 use App\Jobs\AgentAutoAcceptRematch;
 use App\Matchmaking\Enums\ProposalStatus;
 use App\Matchmaking\Enums\ProposalType;
@@ -198,7 +199,7 @@ private function scheduleAgentAutoAccept(Proposal $proposal, User $agentUser, Us
             // Schedule delayed auto-accept (1-7 seconds random)
             $delay = rand(1, 7);
 
-            dispatch(new AgentAutoAcceptRematch($proposal->ulid, $agentUser->id, app(\App\GameEngine\Player\PlayerActivityManager::class)))
+            dispatch(new AgentAutoAcceptRematch($proposal->ulid, $agentUser->id, app(PlayerActivityManager::class)))
                 ->delay(now()->addSeconds($delay));
 
             Log::info('Scheduled agent auto-accept', [
diff --git a/app/Models/Access/Client.php b/app/Models/Access/Client.php
index 7d99665f..e065db4d 100644
--- a/app/Models/Access/Client.php
+++ b/app/Models/Access/Client.php
@@ -5,6 +5,7 @@
 use App\Enums\Platform;
 use App\Models\Auth\Entry;
 use App\Models\Auth\User;
+use Database\Factories\Access\ClientFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
@@ -12,7 +13,7 @@
 
 class Client extends Model
 {
-    /** @use HasFactory<\Database\Factories\Access\ClientFactory> */
+    /** @use HasFactory<ClientFactory> */
     use HasCreator, HasFactory;
 
     protected $fillable = [
diff --git a/app/Models/Account/Alert.php b/app/Models/Account/Alert.php
index 1184560a..7b0f32e6 100644
--- a/app/Models/Account/Alert.php
+++ b/app/Models/Account/Alert.php
@@ -3,25 +3,27 @@
 namespace App\Models\Account;
 
 use App\Models\Auth\User;
+use Database\Factories\Account\AlertFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Carbon;
 
 /**
  * @property string $id
  * @property int $user_id
  * @property string $type
  * @property array<string, mixed> $data
- * @property \Illuminate\Support\Carbon|null $read_at
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
+ * @property Carbon|null $read_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
  * @property User $user
  */
 class Alert extends Model
 {
-    /** @use HasFactory<\Database\Factories\Account\AlertFactory> */
+    /** @use HasFactory<AlertFactory> */
     use HasFactory, HasUlids;
 
     protected $fillable = [
diff --git a/app/Models/Application.php b/app/Models/Application.php
index 4cbfad54..4a7652ce 100644
--- a/app/Models/Application.php
+++ b/app/Models/Application.php
@@ -2,11 +2,12 @@
 
 namespace App\Models;
 
+use Database\Factories\ApplicationFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class Application extends Model
 {
-    /** @use HasFactory<\Database\Factories\ApplicationFactory> */
+    /** @use HasFactory<ApplicationFactory> */
     use HasFactory;
 }
diff --git a/app/Models/Auth/Agent.php b/app/Models/Auth/Agent.php
index eae56f80..0201d510 100644
--- a/app/Models/Auth/Agent.php
+++ b/app/Models/Auth/Agent.php
@@ -2,12 +2,14 @@
 
 namespace App\Models\Auth;
 
+use Database\Factories\Auth\AgentFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasOne;
 
 class Agent extends Model
 {
-    /** @use HasFactory<\Database\Factories\Auth\AgentFactory> */
+    /** @use HasFactory<AgentFactory> */
     use HasFactory;
 
     protected $fillable = [
@@ -50,7 +52,7 @@ protected static function boot()
 
     // Relationships
     /**
-     * @return \Illuminate\Database\Eloquent\Relations\HasOne<User, $this>
+     * @return HasOne<User, $this>
      */
     public function user()
     {
diff --git a/app/Models/Auth/Entry.php b/app/Models/Auth/Entry.php
index 3eb0c67a..8b465efe 100644
--- a/app/Models/Auth/Entry.php
+++ b/app/Models/Auth/Entry.php
@@ -3,13 +3,14 @@
 namespace App\Models\Auth;
 
 use App\Models\Access\Client;
+use Database\Factories\Auth\EntryFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class Entry extends Model
 {
-    /** @use HasFactory<\Database\Factories\Auth\EntryFactory> */
+    /** @use HasFactory<EntryFactory> */
     use HasFactory;
 
     public $timestamps = false;
diff --git a/app/Models/Auth/Registration.php b/app/Models/Auth/Registration.php
index 519f8c4c..cd925835 100644
--- a/app/Models/Auth/Registration.php
+++ b/app/Models/Auth/Registration.php
@@ -3,13 +3,14 @@
 namespace App\Models\Auth;
 
 use App\Models\Access\Client;
+use Database\Factories\Auth\RegistrationFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class Registration extends Model
 {
-    /** @use HasFactory<\Database\Factories\Auth\RegistrationFactory> */
+    /** @use HasFactory<RegistrationFactory> */
     use HasFactory;
 
     /**
diff --git a/app/Models/Auth/SocialAccount.php b/app/Models/Auth/SocialAccount.php
index 5bb893d8..a36a1f31 100644
--- a/app/Models/Auth/SocialAccount.php
+++ b/app/Models/Auth/SocialAccount.php
@@ -2,13 +2,14 @@
 
 namespace App\Models\Auth;
 
+use Database\Factories\Auth\SocialAccountFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class SocialAccount extends Model
 {
-    /** @use HasFactory<\Database\Factories\Auth\SocialAccountFactory> */
+    /** @use HasFactory<SocialAccountFactory> */
     use HasFactory;
 
     /**
diff --git a/app/Models/Auth/User.php b/app/Models/Auth/User.php
index dbde7e40..2debdf29 100644
--- a/app/Models/Auth/User.php
+++ b/app/Models/Auth/User.php
@@ -14,6 +14,7 @@
 use App\Models\Gamification\GlobalRank;
 use App\Models\Gamification\Point;
 use App\Models\Gamification\UserTitleLevel;
+use Database\Factories\Auth\UserFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
@@ -30,7 +31,7 @@
 
 class User extends Authenticatable
 {
-    /** @use HasFactory<\Database\Factories\Auth\UserFactory> */
+    /** @use HasFactory<UserFactory> */
     use Billable, HasApiTokens, HasFactory, HasRoles, Notifiable, SoftDeletes, TwoFactorAuthenticatable;
 
     protected $fillable = [
diff --git a/app/Models/Competitions/Tournament.php b/app/Models/Competitions/Tournament.php
index 2915a910..d05fba3c 100644
--- a/app/Models/Competitions/Tournament.php
+++ b/app/Models/Competitions/Tournament.php
@@ -5,10 +5,12 @@
 use App\Models\Auth\User;
 use App\Models\Games\Game;
 use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -23,12 +25,12 @@
  * @property int|null $prize_pool
  * @property array<string, mixed>|null $bracket_data
  * @property array<string, mixed>|null $rules
- * @property \Illuminate\Support\Carbon|null $starts_at
- * @property \Illuminate\Support\Carbon|null $ends_at
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
- * @property-read \Illuminate\Database\Eloquent\Collection<int, User> $users
- * @property-read \Illuminate\Database\Eloquent\Collection<int, Game> $games
+ * @property Carbon|null $starts_at
+ * @property Carbon|null $ends_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property-read Collection<int, User> $users
+ * @property-read Collection<int, Game> $games
  */
 class Tournament extends Model
 {
diff --git a/app/Models/Content/Avatar.php b/app/Models/Content/Avatar.php
index 6d6095e9..f87dcde4 100644
--- a/app/Models/Content/Avatar.php
+++ b/app/Models/Content/Avatar.php
@@ -4,6 +4,7 @@
 
 use App\Enums\AvatarType;
 use App\Models\Auth\User;
+use Database\Factories\Content\AvatarFactory;
 use DrewRoberts\Media\Models\Image;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
@@ -13,7 +14,7 @@
 
 class Avatar extends Model
 {
-    /** @use HasFactory<\Database\Factories\Content\AvatarFactory> */
+    /** @use HasFactory<AvatarFactory> */
     use HasCreator, HasFactory;
 
     protected $fillable = [
diff --git a/app/Models/Economy/Balance.php b/app/Models/Economy/Balance.php
index e6575342..17c93f47 100644
--- a/app/Models/Economy/Balance.php
+++ b/app/Models/Economy/Balance.php
@@ -6,6 +6,7 @@
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -13,8 +14,8 @@
  * @property string $currency_type
  * @property int $amount
  * @property int $reserved_amount
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
  * @property-read int $availableBalance
  * @property-read User $user
  */
diff --git a/app/Models/Economy/Quota.php b/app/Models/Economy/Quota.php
index 2fdd0c36..4c46681d 100644
--- a/app/Models/Economy/Quota.php
+++ b/app/Models/Economy/Quota.php
@@ -3,13 +3,14 @@
 namespace App\Models\Economy;
 
 use App\Models\Auth\User;
+use Database\Factories\Economy\QuotaFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class Quota extends Model
 {
-    /** @use HasFactory<\Database\Factories\Economy\QuotaFactory> */
+    /** @use HasFactory<QuotaFactory> */
     use HasFactory;
 
     protected $fillable = [
diff --git a/app/Models/Economy/Strike.php b/app/Models/Economy/Strike.php
index 439b1d89..647ff11f 100644
--- a/app/Models/Economy/Strike.php
+++ b/app/Models/Economy/Strike.php
@@ -3,13 +3,14 @@
 namespace App\Models\Economy;
 
 use App\Models\Auth\User;
+use Database\Factories\Economy\StrikeFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class Strike extends Model
 {
-    /** @use HasFactory<\Database\Factories\Economy\StrikeFactory> */
+    /** @use HasFactory<StrikeFactory> */
     use HasFactory;
 
     protected $fillable = [
diff --git a/app/Models/Economy/Transaction.php b/app/Models/Economy/Transaction.php
index 3649e3d4..a06f5cb0 100644
--- a/app/Models/Economy/Transaction.php
+++ b/app/Models/Economy/Transaction.php
@@ -8,6 +8,7 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\MorphTo;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -20,8 +21,8 @@
  * @property string|null $reference_type
  * @property int|null $reference_id
  * @property array<string, mixed>|null $metadata
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
  * @property-read User $user
  * @property-read Model|null $reference
  */
diff --git a/app/Models/Games/Action.php b/app/Models/Games/Action.php
index 6455a588..8bf8bfab 100644
--- a/app/Models/Games/Action.php
+++ b/app/Models/Games/Action.php
@@ -3,12 +3,14 @@
 namespace App\Models\Games;
 
 use App\Enums\ActionType;
+use Database\Factories\Games\ActionFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -22,12 +24,12 @@
  * @property array<string, mixed>|null $resulting_state
  * @property Player $player
  * @property Game $game
- * @property \Illuminate\Support\Carbon|null $created_at
- * @property \Illuminate\Support\Carbon|null $updated_at
+ * @property Carbon|null $created_at
+ * @property Carbon|null $updated_at
  */
 class Action extends Model
 {
-    /** @use HasFactory<\Database\Factories\Games\ActionFactory> */
+    /** @use HasFactory<ActionFactory> */
     use HasFactory, HasUlids, SoftDeletes;
 
     protected $fillable = [
diff --git a/app/Models/Games/Game.php b/app/Models/Games/Game.php
index decff867..b67b45e2 100644
--- a/app/Models/Games/Game.php
+++ b/app/Models/Games/Game.php
@@ -6,20 +6,23 @@
 use App\Enums\GameTitle;
 use App\Enums\OutcomeType;
 use App\Models\Auth\User;
+use Database\Factories\Games\GameFactory;
 use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
  * @property string $ulid
  * @property Mode $mode
- * @property \Illuminate\Database\Eloquent\Collection<int, Player> $players
- * @property \Illuminate\Database\Eloquent\Collection<int, Action> $actions
+ * @property Collection<int, Player> $players
+ * @property Collection<int, Action> $actions
  * @property Player|null $winner
  * @property GameStatus $status
  * @property int|null $mode_id
@@ -29,17 +32,17 @@
  * @property int|null $turn_number
  * @property array<string, mixed>|null $game_state
  * @property array<string, mixed>|null $game_settings
- * @property \Illuminate\Support\Carbon|null $started_at
- * @property \Illuminate\Support\Carbon|null $completed_at
- * @property \Illuminate\Support\Carbon|null $expires_at
- * @property \Illuminate\Support\Carbon|null $created_at
- * @property \Illuminate\Support\Carbon|null $updated_at
+ * @property Carbon|null $started_at
+ * @property Carbon|null $completed_at
+ * @property Carbon|null $expires_at
+ * @property Carbon|null $created_at
+ * @property Carbon|null $updated_at
  * @property OutcomeType|null $outcome_type
  * @property array<string, mixed>|null $outcome_details
  * @property GameTitle $title_slug
  * @property string $game_title
  * @property int|null $max_players
- * @property \Illuminate\Support\Carbon|null $turn_ends_at
+ * @property Carbon|null $turn_ends_at
  * @property int|null $current_player_id
  * @property array<string, mixed>|null $final_scores
  * @property array<string, mixed>|null $xp_awarded
@@ -47,7 +50,7 @@
  */
 class Game extends Model
 {
-    /** @use HasFactory<\Database\Factories\Games\GameFactory> */
+    /** @use HasFactory<GameFactory> */
     use HasFactory, HasUlids, SoftDeletes;
 
     protected $fillable = [
@@ -225,7 +228,7 @@ public function isActive(): bool
         return $this->status === GameStatus::ACTIVE;
     }
 
-    public function getRecentActionTime(): \Illuminate\Support\Carbon
+    public function getRecentActionTime(): Carbon
     {
         /** @var Action|null $lastAction */
         $lastAction = $this->actions()->latest()->first();
diff --git a/app/Models/Games/Mode.php b/app/Models/Games/Mode.php
index 109b4471..4edf46b9 100644
--- a/app/Models/Games/Mode.php
+++ b/app/Models/Games/Mode.php
@@ -5,10 +5,13 @@
 use App\Enums\GameTitle;
 use App\GameEngine\ModeRegistry;
 use App\GameTitles\BaseGameTitle;
+use Database\Factories\Games\ModeFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -17,12 +20,12 @@
  * @property string $name
  * @property bool $is_active
  * @property int|null $turn_time_limit_seconds
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
  */
 class Mode extends Model
 {
-    /** @use HasFactory<\Database\Factories\Games\ModeFactory> */
+    /** @use HasFactory<ModeFactory> */
     use HasFactory;
 
     protected $fillable = [
@@ -98,7 +101,7 @@ public static function findByTitleAndSlug(string $titleSlug, string $modeSlug):
      * Get seeded mode by title and slug.
      * Use this in tests after running ModeSeeder.
      *
-     * @throws \Illuminate\Database\Eloquent\ModelNotFoundException
+     * @throws ModelNotFoundException
      */
     public static function seeded(string|GameTitle $titleSlug, string $slug = 'standard'): self
     {
@@ -114,7 +117,7 @@ public static function seeded(string|GameTitle $titleSlug, string $slug = 'stand
     /**
      * Get seeded Connect Four mode.
      *
-     * @throws \Illuminate\Database\Eloquent\ModelNotFoundException
+     * @throws ModelNotFoundException
      */
     public static function connectFour(string $slug = 'standard'): self
     {
@@ -124,7 +127,7 @@ public static function connectFour(string $slug = 'standard'): self
     /**
      * Get seeded Checkers mode.
      *
-     * @throws \Illuminate\Database\Eloquent\ModelNotFoundException
+     * @throws ModelNotFoundException
      */
     public static function checkers(string $slug = 'standard'): self
     {
@@ -134,7 +137,7 @@ public static function checkers(string $slug = 'standard'): self
     /**
      * Get seeded Hearts mode.
      *
-     * @throws \Illuminate\Database\Eloquent\ModelNotFoundException
+     * @throws ModelNotFoundException
      */
     public static function hearts(string $slug = 'standard'): self
     {
diff --git a/app/Models/Games/Player.php b/app/Models/Games/Player.php
index ba5945a0..b1823582 100644
--- a/app/Models/Games/Player.php
+++ b/app/Models/Games/Player.php
@@ -4,6 +4,7 @@
 
 use App\Models\Access\Client;
 use App\Models\Auth\User;
+use Database\Factories\Games\PlayerFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -27,7 +28,7 @@
  */
 class Player extends Model
 {
-    /** @use HasFactory<\Database\Factories\Games\PlayerFactory> */
+    /** @use HasFactory<PlayerFactory> */
     use HasFactory, HasUlids;
 
     protected $fillable = [
diff --git a/app/Models/Gamification/Badge.php b/app/Models/Gamification/Badge.php
index 6bb8e64b..02886b64 100644
--- a/app/Models/Gamification/Badge.php
+++ b/app/Models/Gamification/Badge.php
@@ -3,6 +3,7 @@
 namespace App\Models\Gamification;
 
 use App\Models\Auth\User;
+use Database\Factories\Gamification\BadgeFactory;
 use DrewRoberts\Media\Models\Image;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
@@ -12,7 +13,7 @@
 
 class Badge extends Model
 {
-    /** @use HasFactory<\Database\Factories\Gamification\BadgeFactory> */
+    /** @use HasFactory<BadgeFactory> */
     use HasCreator, HasFactory;
 
     protected $fillable = [
diff --git a/app/Models/Gamification/GlobalRank.php b/app/Models/Gamification/GlobalRank.php
index f496b044..1b3dd0d0 100644
--- a/app/Models/Gamification/GlobalRank.php
+++ b/app/Models/Gamification/GlobalRank.php
@@ -3,13 +3,14 @@
 namespace App\Models\Gamification;
 
 use App\Models\Auth\User;
+use Database\Factories\Gamification\GlobalRankFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class GlobalRank extends Model
 {
-    /** @use HasFactory<\Database\Factories\Gamification\GlobalRankFactory> */
+    /** @use HasFactory<GlobalRankFactory> */
     use HasFactory;
 
     protected $primaryKey = 'user_id';
diff --git a/app/Models/Gamification/Point.php b/app/Models/Gamification/Point.php
index a4f42eb5..e0f2c5bb 100644
--- a/app/Models/Gamification/Point.php
+++ b/app/Models/Gamification/Point.php
@@ -3,6 +3,7 @@
 namespace App\Models\Gamification;
 
 use App\Models\Auth\User;
+use Database\Factories\Gamification\PointFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
@@ -10,7 +11,7 @@
 
 class Point extends Model
 {
-    /** @use HasFactory<\Database\Factories\Gamification\PointFactory> */
+    /** @use HasFactory<PointFactory> */
     use HasFactory;
 
     protected $table = 'points';
diff --git a/app/Models/Gamification/UserTitleLevel.php b/app/Models/Gamification/UserTitleLevel.php
index 33010ae2..4bae69a4 100644
--- a/app/Models/Gamification/UserTitleLevel.php
+++ b/app/Models/Gamification/UserTitleLevel.php
@@ -3,9 +3,11 @@
 namespace App\Models\Gamification;
 
 use App\Models\Auth\User;
+use Database\Factories\Gamification\UserTitleLevelFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Carbon;
 
 /**
  * User progress tracking for game titles.
@@ -18,12 +20,12 @@
  * @property string $title_slug
  * @property int $level
  * @property int $xp_current
- * @property \Illuminate\Support\Carbon|null $last_played_at
+ * @property Carbon|null $last_played_at
  * @property User $user
  */
 class UserTitleLevel extends Model
 {
-    /** @use HasFactory<\Database\Factories\Gamification\UserTitleLevelFactory> */
+    /** @use HasFactory<UserTitleLevelFactory> */
     use HasFactory;
 
     protected $fillable = [
diff --git a/app/Models/Matchmaking/Lobby.php b/app/Models/Matchmaking/Lobby.php
index 2816dc66..fcbabe5c 100644
--- a/app/Models/Matchmaking/Lobby.php
+++ b/app/Models/Matchmaking/Lobby.php
@@ -8,12 +8,15 @@
 use App\Models\Auth\User;
 use App\Models\Games\Game;
 use App\Models\Games\Mode;
+use Database\Factories\Matchmaking\LobbyFactory;
 use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -25,15 +28,15 @@
  * @property LobbyStatus $status
  * @property bool $is_public
  * @property int $min_players
- * @property \Illuminate\Support\Carbon|null $scheduled_at
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
- * @property-read \Illuminate\Database\Eloquent\Collection<int, LobbyPlayer> $players
+ * @property Carbon|null $scheduled_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
+ * @property-read Collection<int, LobbyPlayer> $players
  * @property-read User $host
  */
 class Lobby extends Model
 {
-    /** @use HasFactory<\Database\Factories\Matchmaking\LobbyFactory> */
+    /** @use HasFactory<LobbyFactory> */
     use HasFactory, HasUlids;
 
     protected $fillable = [
diff --git a/app/Models/Matchmaking/LobbyPlayer.php b/app/Models/Matchmaking/LobbyPlayer.php
index 6e91bfc5..73ea27b3 100644
--- a/app/Models/Matchmaking/LobbyPlayer.php
+++ b/app/Models/Matchmaking/LobbyPlayer.php
@@ -5,10 +5,12 @@
 use App\Matchmaking\Enums\LobbyPlayerSource;
 use App\Matchmaking\Enums\LobbyPlayerStatus;
 use App\Models\Auth\User;
+use Database\Factories\Matchmaking\LobbyPlayerFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -17,12 +19,12 @@
  * @property int $client_id
  * @property LobbyPlayerStatus $status
  * @property LobbyPlayerSource $source
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
  */
 class LobbyPlayer extends Model
 {
-    /** @use HasFactory<\Database\Factories\Matchmaking\LobbyPlayerFactory> */
+    /** @use HasFactory<LobbyPlayerFactory> */
     use HasFactory;
 
     protected $fillable = [
diff --git a/app/Models/Matchmaking/Proposal.php b/app/Models/Matchmaking/Proposal.php
index 9f0a8564..28901d51 100644
--- a/app/Models/Matchmaking/Proposal.php
+++ b/app/Models/Matchmaking/Proposal.php
@@ -7,11 +7,13 @@
 use App\Models\Auth\User;
 use App\Models\Games\Game;
 use App\Models\Games\Mode;
+use Database\Factories\Matchmaking\ProposalFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Support\Carbon;
 
 /**
  * @property int $id
@@ -24,15 +26,15 @@
  * @property int|null $original_game_id
  * @property int|null $game_id
  * @property array<string, mixed>|null $game_settings
- * @property \Illuminate\Support\Carbon|null $responded_at
+ * @property Carbon|null $responded_at
  * @property ProposalStatus $status
- * @property \Illuminate\Support\Carbon|null $expires_at
- * @property \Illuminate\Support\Carbon $created_at
- * @property \Illuminate\Support\Carbon $updated_at
+ * @property Carbon|null $expires_at
+ * @property Carbon $created_at
+ * @property Carbon $updated_at
  */
 class Proposal extends Model
 {
-    /** @use HasFactory<\Database\Factories\Matchmaking\ProposalFactory> */
+    /** @use HasFactory<ProposalFactory> */
     use HasFactory, HasUlids;
 
     protected $fillable = [
diff --git a/app/Models/Matchmaking/QueueSlot.php b/app/Models/Matchmaking/QueueSlot.php
index 6f3dcbb2..a4f442cb 100644
--- a/app/Models/Matchmaking/QueueSlot.php
+++ b/app/Models/Matchmaking/QueueSlot.php
@@ -4,6 +4,7 @@
 
 use App\Matchmaking\Enums\QueueSlotStatus;
 use App\Models\Auth\User;
+use Database\Factories\Matchmaking\QueueSlotFactory;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Concerns\HasUlids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -12,7 +13,7 @@
 
 class QueueSlot extends Model
 {
-    /** @use HasFactory<\Database\Factories\Matchmaking\QueueSlotFactory> */
+    /** @use HasFactory<QueueSlotFactory> */
     use HasFactory, HasUlids;
 
     protected $table = 'queue_slots';
diff --git a/app/Models/Workflow.php b/app/Models/Workflow.php
index 590ca23c..e883eae7 100644
--- a/app/Models/Workflow.php
+++ b/app/Models/Workflow.php
@@ -2,11 +2,12 @@
 
 namespace App\Models;
 
+use Database\Factories\WorkflowFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class Workflow extends Model
 {
-    /** @use HasFactory<\Database\Factories\WorkflowFactory> */
+    /** @use HasFactory<WorkflowFactory> */
     use HasFactory;
 }
diff --git a/app/Models/WorkflowStep.php b/app/Models/WorkflowStep.php
index 17a50771..c7e577d6 100644
--- a/app/Models/WorkflowStep.php
+++ b/app/Models/WorkflowStep.php
@@ -2,11 +2,12 @@
 
 namespace App\Models;
 
+use Database\Factories\WorkflowStepFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class WorkflowStep extends Model
 {
-    /** @use HasFactory<\Database\Factories\WorkflowStepFactory> */
+    /** @use HasFactory<WorkflowStepFactory> */
     use HasFactory;
 }
diff --git a/app/Policies/ApplicationPolicy.php b/app/Policies/ApplicationPolicy.php
index 2cd942d0..13bc93f0 100644
--- a/app/Policies/ApplicationPolicy.php
+++ b/app/Policies/ApplicationPolicy.php
@@ -4,7 +4,6 @@
 
 use App\Models\Application;
 use App\Models\Auth\User;
-use Illuminate\Auth\Access\Response;
 
 class ApplicationPolicy
 {
diff --git a/app/Policies/WorkflowPolicy.php b/app/Policies/WorkflowPolicy.php
index 00368836..94bde6a9 100644
--- a/app/Policies/WorkflowPolicy.php
+++ b/app/Policies/WorkflowPolicy.php
@@ -4,7 +4,6 @@
 
 use App\Models\Auth\User;
 use App\Models\Workflow;
-use Illuminate\Auth\Access\Response;
 
 class WorkflowPolicy
 {
diff --git a/app/Policies/WorkflowStepPolicy.php b/app/Policies/WorkflowStepPolicy.php
index 41b5d53d..7f0b7333 100644
--- a/app/Policies/WorkflowStepPolicy.php
+++ b/app/Policies/WorkflowStepPolicy.php
@@ -4,7 +4,6 @@
 
 use App\Models\Auth\User;
 use App\Models\WorkflowStep;
-use Illuminate\Auth\Access\Response;
 
 class WorkflowStepPolicy
 {
diff --git a/app/Services/Competitions/CompetitionService.php b/app/Services/Competitions/CompetitionService.php
index f4530ca2..3d634db0 100644
--- a/app/Services/Competitions/CompetitionService.php
+++ b/app/Services/Competitions/CompetitionService.php
@@ -7,6 +7,7 @@
 use App\Models\Auth\User;
 use App\Models\Competitions\Tournament;
 use App\Services\Economy\EconomyService;
+use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Support\Facades\DB;
 
 class CompetitionService
@@ -84,7 +85,7 @@ public function startTournament(Tournament $tournament): void
     /**
      * Generate tournament bracket.
      *
-     * @param  \Illuminate\Database\Eloquent\Collection<int, User>  $participants
+     * @param  Collection<int, User>  $participants
      * @return array<string, mixed>
      */
     protected function generateBracket(Tournament $tournament, $participants): array
diff --git a/app/Services/Games/GameResponseEnhancementService.php b/app/Services/Games/GameResponseEnhancementService.php
index 391f3150..0479f44a 100644
--- a/app/Services/Games/GameResponseEnhancementService.php
+++ b/app/Services/Games/GameResponseEnhancementService.php
@@ -10,6 +10,7 @@
 use App\Models\Games\Action;
 use App\Models\Games\Game;
 use App\Models\Games\Player;
+use Illuminate\Database\Eloquent\Collection;
 
 /**
  * Service to enhance game responses with rich context.
@@ -137,7 +138,7 @@ protected function calculateGameStats(Game $game): array
     }
 
     /**
-     * @param  \Illuminate\Database\Eloquent\Collection<int, Action>  $actions
+     * @param  Collection<int, Action>  $actions
      */
     protected function calculateAverageActionTime($actions): float
     {
@@ -159,7 +160,7 @@ protected function calculateAverageActionTime($actions): float
     }
 
     /**
-     * @param  \Illuminate\Database\Eloquent\Collection<int, Action>  $actions
+     * @param  Collection<int, Action>  $actions
      */
     protected function calculateAverageResponseTime($actions): float
     {
diff --git a/app/Services/System/SystemHealthService.php b/app/Services/System/SystemHealthService.php
index 985aea4e..0694c938 100644
--- a/app/Services/System/SystemHealthService.php
+++ b/app/Services/System/SystemHealthService.php
@@ -2,6 +2,7 @@
 
 namespace App\Services\System;
 
+use App\Enums\GameTitle;
 use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Queue;
@@ -113,7 +114,7 @@ private function checkGameEngine(): array
     {
         try {
             // Test that game modes are configured
-            $availableGames = collect(\App\Enums\GameTitle::cases())->count();
+            $availableGames = collect(GameTitle::cases())->count();
 
             return [
                 'status' => 'healthy',
diff --git a/bootstrap/app.php b/bootstrap/app.php
index 3bdb38ea..fc276439 100644
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -39,7 +39,7 @@
     })
     ->withExceptions(function (Exceptions $exceptions): void {
         // Global API error handler with correlation IDs
-        $exceptions->render(function (\Throwable $e, $request) {
+        $exceptions->render(function (Throwable $e, $request) {
             // Only format JSON for API requests
             if (! $request->is('api/*')) {
                 return null; // Let Laravel handle non-API exceptions normally
@@ -48,7 +48,7 @@
             $correlationId = (string) Str::uuid();
 
             // Log all API errors with correlation ID
-            \Log::error('API Error', [
+            Log::error('API Error', [
                 'correlation_id' => $correlationId,
                 'exception' => get_class($e),
                 'message' => $e->getMessage(),
diff --git a/bootstrap/providers.php b/bootstrap/providers.php
index ea71344f..8bed96a1 100644
--- a/bootstrap/providers.php
+++ b/bootstrap/providers.php
@@ -1,7 +1,11 @@
 <?php
 
+use App\Providers\AppServiceProvider;
+use App\Providers\FortifyServiceProvider;
+use App\Providers\VoltServiceProvider;
+
 return [
-    App\Providers\AppServiceProvider::class,
-    App\Providers\FortifyServiceProvider::class,
-    App\Providers\VoltServiceProvider::class,
+    AppServiceProvider::class,
+    FortifyServiceProvider::class,
+    VoltServiceProvider::class,
 ];
diff --git a/config/auth.php b/config/auth.php
index a48a3496..c1ffcc1b 100644
--- a/config/auth.php
+++ b/config/auth.php
@@ -1,5 +1,7 @@
 <?php
 
+use App\Models\Auth\User;
+
 return [
 
     /*
@@ -62,7 +64,7 @@
     'providers' => [
         'users' => [
             'driver' => 'eloquent',
-            'model' => env('AUTH_MODEL', App\Models\Auth\User::class),
+            'model' => env('AUTH_MODEL', User::class),
         ],
 
         // 'users' => [
diff --git a/config/database.php b/config/database.php
index e371373d..4b45bdba 100644
--- a/config/database.php
+++ b/config/database.php
@@ -1,6 +1,7 @@
 <?php
 
 use Illuminate\Support\Str;
+use Pdo\Mysql;
 
 return [
 
@@ -59,7 +60,7 @@
             'strict' => true,
             'engine' => null,
             'options' => extension_loaded('pdo_mysql') ? array_filter([
-                (PHP_VERSION_ID >= 80500 ? Pdo\Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
+                (PHP_VERSION_ID >= 80500 ? Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
             ]) : [],
         ],
 
@@ -79,7 +80,7 @@
             'strict' => true,
             'engine' => null,
             'options' => extension_loaded('pdo_mysql') ? array_filter([
-                (PHP_VERSION_ID >= 80500 ? Pdo\Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
+                (PHP_VERSION_ID >= 80500 ? Mysql::ATTR_SSL_CA : PDO::MYSQL_ATTR_SSL_CA) => env('MYSQL_ATTR_SSL_CA'),
             ]) : [],
         ],
 
diff --git a/config/permission.php b/config/permission.php
index f39f6b5b..85b88328 100644
--- a/config/permission.php
+++ b/config/permission.php
@@ -1,5 +1,9 @@
 <?php
 
+use Spatie\Permission\DefaultTeamResolver;
+use Spatie\Permission\Models\Permission;
+use Spatie\Permission\Models\Role;
+
 return [
 
     'models' => [
@@ -13,7 +17,7 @@
          * `Spatie\Permission\Contracts\Permission` contract.
          */
 
-        'permission' => Spatie\Permission\Models\Permission::class,
+        'permission' => Permission::class,
 
         /*
          * When using the "HasRoles" trait from this package, we need to know which
@@ -24,7 +28,7 @@
          * `Spatie\Permission\Contracts\Role` contract.
          */
 
-        'role' => Spatie\Permission\Models\Role::class,
+        'role' => Role::class,
 
     ],
 
@@ -136,7 +140,7 @@
     /*
      * The class to use to resolve the permissions team id
      */
-    'team_resolver' => \Spatie\Permission\DefaultTeamResolver::class,
+    'team_resolver' => DefaultTeamResolver::class,
 
     /*
      * Passport Client Credentials Grant
@@ -183,7 +187,7 @@
          * When permissions or roles are updated the cache is flushed automatically.
          */
 
-        'expiration_time' => \DateInterval::createFromDateString('24 hours'),
+        'expiration_time' => DateInterval::createFromDateString('24 hours'),
 
         /*
          * The cache key used to store all permissions.
diff --git a/database/factories/Access/ClientFactory.php b/database/factories/Access/ClientFactory.php
index f2dc65c3..e2e83a5a 100644
--- a/database/factories/Access/ClientFactory.php
+++ b/database/factories/Access/ClientFactory.php
@@ -3,10 +3,12 @@
 namespace Database\Factories\Access;
 
 use App\Enums\Platform;
+use App\Models\Access\Client;
 use Illuminate\Database\Eloquent\Factories\Factory;
+use Illuminate\Support\Str;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Access\Client>
+ * @extends Factory<Client>
  */
 class ClientFactory extends Factory
 {
@@ -19,7 +21,7 @@ public function definition(): array
     {
         return [
             'name' => $this->faker->company,
-            'api_key' => \Illuminate\Support\Str::random(32),
+            'api_key' => Str::random(32),
             'website' => $this->faker->domainName,
             'platform' => $this->faker->randomElement(Platform::cases()),
             'is_active' => true,
diff --git a/database/factories/Account/AlertFactory.php b/database/factories/Account/AlertFactory.php
index d89c365e..73c6d4db 100644
--- a/database/factories/Account/AlertFactory.php
+++ b/database/factories/Account/AlertFactory.php
@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Account\Alert>
+ * @extends Factory<Alert>
  */
 class AlertFactory extends Factory
 {
diff --git a/database/factories/ApplicationFactory.php b/database/factories/ApplicationFactory.php
index a3d2bfbe..aa85a158 100644
--- a/database/factories/ApplicationFactory.php
+++ b/database/factories/ApplicationFactory.php
@@ -8,7 +8,7 @@
 /**
  * @template TModel of \App\Models\Application
  *
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<TModel>
+ * @extends Factory<TModel>
  */
 class ApplicationFactory extends Factory
 {
diff --git a/database/factories/Auth/EntryFactory.php b/database/factories/Auth/EntryFactory.php
index 75c08c82..54b445d4 100644
--- a/database/factories/Auth/EntryFactory.php
+++ b/database/factories/Auth/EntryFactory.php
@@ -8,7 +8,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Auth\Entry>
+ * @extends Factory<Entry>
  */
 class EntryFactory extends Factory
 {
diff --git a/database/factories/Auth/RegistrationFactory.php b/database/factories/Auth/RegistrationFactory.php
index 0193b5e2..db47d7bd 100644
--- a/database/factories/Auth/RegistrationFactory.php
+++ b/database/factories/Auth/RegistrationFactory.php
@@ -10,7 +10,7 @@
 use Illuminate\Support\Str;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Auth\Registration>
+ * @extends Factory<Registration>
  */
 class RegistrationFactory extends Factory
 {
diff --git a/database/factories/Auth/SocialAccountFactory.php b/database/factories/Auth/SocialAccountFactory.php
index b17918ed..4beadbc0 100644
--- a/database/factories/Auth/SocialAccountFactory.php
+++ b/database/factories/Auth/SocialAccountFactory.php
@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Auth\SocialAccount>
+ * @extends Factory<SocialAccount>
  */
 class SocialAccountFactory extends Factory
 {
diff --git a/database/factories/Auth/UserFactory.php b/database/factories/Auth/UserFactory.php
index 9de63e54..b57a3b07 100644
--- a/database/factories/Auth/UserFactory.php
+++ b/database/factories/Auth/UserFactory.php
@@ -3,12 +3,13 @@
 namespace Database\Factories\Auth;
 
 use App\Models\Access\Client;
+use App\Models\Auth\User;
 use Illuminate\Database\Eloquent\Factories\Factory;
 use Illuminate\Support\Facades\Hash;
 use Illuminate\Support\Str;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Auth\User>
+ * @extends Factory<User>
  */
 class UserFactory extends Factory
 {
diff --git a/database/factories/Content/AvatarFactory.php b/database/factories/Content/AvatarFactory.php
index b1bb0a0e..ebee841b 100644
--- a/database/factories/Content/AvatarFactory.php
+++ b/database/factories/Content/AvatarFactory.php
@@ -8,7 +8,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Content\Avatar>
+ * @extends Factory<Avatar>
  */
 class AvatarFactory extends Factory
 {
diff --git a/database/factories/Economy/QuotaFactory.php b/database/factories/Economy/QuotaFactory.php
index dc9a05aa..34b9ab81 100644
--- a/database/factories/Economy/QuotaFactory.php
+++ b/database/factories/Economy/QuotaFactory.php
@@ -8,7 +8,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Economy\Quota>
+ * @extends Factory<Quota>
  */
 class QuotaFactory extends Factory
 {
diff --git a/database/factories/Economy/StrikeFactory.php b/database/factories/Economy/StrikeFactory.php
index ce2661be..8eca426c 100644
--- a/database/factories/Economy/StrikeFactory.php
+++ b/database/factories/Economy/StrikeFactory.php
@@ -8,7 +8,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Economy\Strike>
+ * @extends Factory<Strike>
  */
 class StrikeFactory extends Factory
 {
diff --git a/database/factories/Economy/SubscriptionFactory.php b/database/factories/Economy/SubscriptionFactory.php
index 4d16adce..350dee0a 100644
--- a/database/factories/Economy/SubscriptionFactory.php
+++ b/database/factories/Economy/SubscriptionFactory.php
@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Economy\Subscription>
+ * @extends Factory<Subscription>
  */
 class SubscriptionFactory extends Factory
 {
diff --git a/database/factories/Games/ActionFactory.php b/database/factories/Games/ActionFactory.php
index b663d702..77be27c2 100644
--- a/database/factories/Games/ActionFactory.php
+++ b/database/factories/Games/ActionFactory.php
@@ -9,7 +9,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Games\Action>
+ * @extends Factory<Action>
  */
 class ActionFactory extends Factory
 {
diff --git a/database/factories/Games/GameFactory.php b/database/factories/Games/GameFactory.php
index 276d5b4c..f004f14c 100644
--- a/database/factories/Games/GameFactory.php
+++ b/database/factories/Games/GameFactory.php
@@ -12,14 +12,14 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Games\Game>
+ * @extends Factory<Game>
  */
 class GameFactory extends Factory
 {
     /**
      * The name of the factory's corresponding model.
      *
-     * @var class-string<\App\Models\Games\Game>
+     * @var class-string<Game>
      */
     protected $model = Game::class;
 
diff --git a/database/factories/Games/ModeFactory.php b/database/factories/Games/ModeFactory.php
index 3c7f476e..0684e66b 100644
--- a/database/factories/Games/ModeFactory.php
+++ b/database/factories/Games/ModeFactory.php
@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Games\Mode>
+ * @extends Factory<Mode>
  */
 class ModeFactory extends Factory
 {
diff --git a/database/factories/Games/PlayerFactory.php b/database/factories/Games/PlayerFactory.php
index 3d84422d..6717b876 100644
--- a/database/factories/Games/PlayerFactory.php
+++ b/database/factories/Games/PlayerFactory.php
@@ -9,14 +9,14 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Games\Player>
+ * @extends Factory<Player>
  */
 class PlayerFactory extends Factory
 {
     /**
      * The name of the factory's corresponding model.
      *
-     * @var class-string<\App\Models\Games\Player>
+     * @var class-string<Player>
      */
     protected $model = Player::class;
 
diff --git a/database/factories/Gamification/BadgeFactory.php b/database/factories/Gamification/BadgeFactory.php
index ec6c9851..6bb2f303 100644
--- a/database/factories/Gamification/BadgeFactory.php
+++ b/database/factories/Gamification/BadgeFactory.php
@@ -8,7 +8,7 @@
 use Illuminate\Support\Str;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Gamification\Badge>
+ * @extends Factory<Badge>
  */
 class BadgeFactory extends Factory
 {
diff --git a/database/factories/Gamification/GlobalRankFactory.php b/database/factories/Gamification/GlobalRankFactory.php
index 986fd2e1..6881c6ee 100644
--- a/database/factories/Gamification/GlobalRankFactory.php
+++ b/database/factories/Gamification/GlobalRankFactory.php
@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Gamification\GlobalRank>
+ * @extends Factory<GlobalRank>
  */
 class GlobalRankFactory extends Factory
 {
diff --git a/database/factories/Gamification/PointFactory.php b/database/factories/Gamification/PointFactory.php
index 098f562c..fd6fa941 100644
--- a/database/factories/Gamification/PointFactory.php
+++ b/database/factories/Gamification/PointFactory.php
@@ -8,7 +8,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Gamification\Point>
+ * @extends Factory<Point>
  */
 class PointFactory extends Factory
 {
diff --git a/database/factories/Gamification/UserTitleLevelFactory.php b/database/factories/Gamification/UserTitleLevelFactory.php
index 9d3183a6..d33fb423 100644
--- a/database/factories/Gamification/UserTitleLevelFactory.php
+++ b/database/factories/Gamification/UserTitleLevelFactory.php
@@ -8,7 +8,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Gamification\UserTitleLevel>
+ * @extends Factory<UserTitleLevel>
  */
 class UserTitleLevelFactory extends Factory
 {
diff --git a/database/factories/Matchmaking/ProposalFactory.php b/database/factories/Matchmaking/ProposalFactory.php
index ca6abf62..18332f87 100644
--- a/database/factories/Matchmaking/ProposalFactory.php
+++ b/database/factories/Matchmaking/ProposalFactory.php
@@ -12,7 +12,7 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Matchmaking\Proposal>
+ * @extends Factory<Proposal>
  */
 class ProposalFactory extends Factory
 {
diff --git a/database/factories/Matchmaking/QueueSlotFactory.php b/database/factories/Matchmaking/QueueSlotFactory.php
index 46dff71d..e5f1b521 100644
--- a/database/factories/Matchmaking/QueueSlotFactory.php
+++ b/database/factories/Matchmaking/QueueSlotFactory.php
@@ -11,7 +11,7 @@
 use Illuminate\Support\Str;
 
 /**
- * @extends Factory<\App\Models\Matchmaking\QueueSlot>
+ * @extends Factory<QueueSlot>
  */
 class QueueSlotFactory extends Factory
 {
diff --git a/database/factories/WorkflowFactory.php b/database/factories/WorkflowFactory.php
index a38fd75d..5aac3699 100644
--- a/database/factories/WorkflowFactory.php
+++ b/database/factories/WorkflowFactory.php
@@ -8,7 +8,7 @@
 /**
  * @template TModel of \App\Models\Workflow
  *
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<TModel>
+ * @extends Factory<TModel>
  */
 class WorkflowFactory extends Factory
 {
diff --git a/database/factories/WorkflowStepFactory.php b/database/factories/WorkflowStepFactory.php
index d0defb28..b6e850f3 100644
--- a/database/factories/WorkflowStepFactory.php
+++ b/database/factories/WorkflowStepFactory.php
@@ -8,7 +8,7 @@
 /**
  * @template TModel of \App\Models\WorkflowStep
  *
- * @extends \Illuminate\Database\Eloquent\Factories\Factory<TModel>
+ * @extends Factory<TModel>
  */
 class WorkflowStepFactory extends Factory
 {
diff --git a/database/seeders/ApplicationSeeder.php b/database/seeders/ApplicationSeeder.php
index b2cddea7..6aa07b9b 100644
--- a/database/seeders/ApplicationSeeder.php
+++ b/database/seeders/ApplicationSeeder.php
@@ -2,7 +2,6 @@
 
 namespace Database\Seeders;
 
-use Illuminate\Database\Console\Seeds\WithoutModelEvents;
 use Illuminate\Database\Seeder;
 
 class ApplicationSeeder extends Seeder
diff --git a/database/seeders/WorkflowSeeder.php b/database/seeders/WorkflowSeeder.php
index 9073caa2..9dc92ee5 100644
--- a/database/seeders/WorkflowSeeder.php
+++ b/database/seeders/WorkflowSeeder.php
@@ -2,7 +2,6 @@
 
 namespace Database\Seeders;
 
-use Illuminate\Database\Console\Seeds\WithoutModelEvents;
 use Illuminate\Database\Seeder;
 
 class WorkflowSeeder extends Seeder
diff --git a/database/seeders/WorkflowStepSeeder.php b/database/seeders/WorkflowStepSeeder.php
index d91becfb..57c1a58d 100644
--- a/database/seeders/WorkflowStepSeeder.php
+++ b/database/seeders/WorkflowStepSeeder.php
@@ -2,7 +2,6 @@
 
 namespace Database\Seeders;
 
-use Illuminate\Database\Console\Seeds\WithoutModelEvents;
 use Illuminate\Database\Seeder;
 
 class WorkflowStepSeeder extends Seeder
diff --git a/tests/CreatesApplication.php b/tests/CreatesApplication.php
index 547152f6..18f98251 100644
--- a/tests/CreatesApplication.php
+++ b/tests/CreatesApplication.php
@@ -3,13 +3,14 @@
 namespace Tests;
 
 use Illuminate\Contracts\Console\Kernel;
+use Illuminate\Foundation\Application;
 
 trait CreatesApplication
 {
     /**
      * Creates the application.
      *
-     * @return \Illuminate\Foundation\Application
+     * @return Application
      */
     public function createApplication()
     {
diff --git a/tests/Feature/Agents/QueueMatchmakingTest.php b/tests/Feature/Agents/QueueMatchmakingTest.php
index ec3d3279..1e478966 100644
--- a/tests/Feature/Agents/QueueMatchmakingTest.php
+++ b/tests/Feature/Agents/QueueMatchmakingTest.php
@@ -3,7 +3,6 @@
 use App\Agents\Scheduling\AgentSchedulingService;
 use App\Models\Auth\Agent;
 use App\Models\Auth\User;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Redis;
 
 beforeEach(function () {
diff --git a/tests/Feature/Agents/QuickplayMatchmakingTest.php b/tests/Feature/Agents/QuickplayMatchmakingTest.php
index ec3d3279..1e478966 100644
--- a/tests/Feature/Agents/QuickplayMatchmakingTest.php
+++ b/tests/Feature/Agents/QuickplayMatchmakingTest.php
@@ -3,7 +3,6 @@
 use App\Agents\Scheduling\AgentSchedulingService;
 use App\Models\Auth\Agent;
 use App\Models\Auth\User;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Redis;
 
 beforeEach(function () {
diff --git a/tests/Integration/ActivityTrackingTest.php b/tests/Integration/ActivityTrackingTest.php
index 138af59d..064676f1 100644
--- a/tests/Integration/ActivityTrackingTest.php
+++ b/tests/Integration/ActivityTrackingTest.php
@@ -1,18 +1,17 @@
 <?php
 
-use App\Matchmaking\Queue\Actions\JoinQueueAction;
-use App\Matchmaking\Queue\Actions\LeaveQueueAction;
 use App\Enums\GameStatus;
 use App\Enums\GameTitle;
 use App\Enums\PlayerActivityState;
 use App\GameEngine\Lifecycle\Creation\GameBuilder;
 use App\GameEngine\Player\PlayerActivityManager;
 use App\Matchmaking\Enums\LobbyStatus;
+use App\Matchmaking\Queue\Actions\JoinQueueAction;
+use App\Matchmaking\Queue\Actions\LeaveQueueAction;
 use App\Models\Auth\User;
 use App\Models\Games\Game;
 use App\Models\Games\Mode;
 use App\Models\Matchmaking\Lobby;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Redis;
 
 describe('Activity Tracking in Game Creation', function () {
@@ -21,7 +20,7 @@
 
         // Mock Redis to track state changes in memory
         Redis::shouldReceive('setex')
-            ->with(\Mockery::pattern('/player:\d+:activity/'), 1800, \Mockery::any())
+            ->with(Mockery::pattern('/player:\d+:activity/'), 1800, Mockery::any())
             ->andReturnUsing(function ($key, $ttl, $value) {
                 $this->states[$key] = $value;
 
@@ -30,7 +29,7 @@
             ->byDefault();
 
         Redis::shouldReceive('get')
-            ->with(\Mockery::pattern('/player:\d+:activity/'))
+            ->with(Mockery::pattern('/player:\d+:activity/'))
             ->andReturnUsing(function ($key) {
                 return $this->states[$key] ?? null;
             })
diff --git a/tests/Integration/Game/CoordinatedActionsTest.php b/tests/Integration/Game/CoordinatedActionsTest.php
index c20782f6..d047d80c 100644
--- a/tests/Integration/Game/CoordinatedActionsTest.php
+++ b/tests/Integration/Game/CoordinatedActionsTest.php
@@ -20,7 +20,7 @@
             // Create game with 4 players
             $game = Game::factory()->create([
                 'title_slug' => 'hearts',
-                'status' => GameStatus::ACTIVE
+                'status' => GameStatus::ACTIVE,
             ]);
             $players = collect([]);
             for ($i = 1; $i <= 4; $i++) {
@@ -29,19 +29,19 @@
 
             $processor = new CoordinatedActionProcessor;
             $mode = new StandardMode($game);
-            
+
             // Initialize game state (using Hearts internal logic)
             $gameState = HeartsTable::createNew(...$players->pluck('ulid')->all());
 
             // Submit actions for first 3 players
             foreach ($players->take(3) as $player) {
                 $action = new PassCards(['2H', '3H', '4H']);
-                
+
                 $result = $processor->process($game, $action, $mode, $gameState, $player);
-                
+
                 // Assert not complete
                 expect($result->coordinationComplete)->toBeFalse();
-                
+
                 // Manually record the action (simulating GameEngine side effect)
                 Action::create([
                     'game_id' => $game->id,
@@ -59,13 +59,13 @@
             // Submit final player's action
             $lastPlayer = $players->last();
             $action = new PassCards(['2D', '3D', '4D']);
-            
+
             $result = $processor->process($game, $action, $mode, $gameState, $lastPlayer);
 
             // Assert complete
             expect($result->coordinationComplete)->toBeTrue()
                 ->and($result->updatedGameState)->toBeInstanceOf(HeartsTable::class);
-                
+
             $finalState = $result->updatedGameState;
             expect($finalState->phase)->toBe(GamePhase::ACTIVE);
         });
diff --git a/tests/Integration/Game/TimeoutHandlingTest.php b/tests/Integration/Game/TimeoutHandlingTest.php
index 667e29aa..d523296b 100644
--- a/tests/Integration/Game/TimeoutHandlingTest.php
+++ b/tests/Integration/Game/TimeoutHandlingTest.php
@@ -18,31 +18,32 @@
             'status' => GameStatus::ACTIVE,
             'turn_ends_at' => Carbon::now()->subMinute(),
         ]);
-        
+
         $players = collect();
         for ($i = 0; $i < 4; $i++) {
             $players->push(Player::factory()->for($game)->state(['position_id' => $i + 1])->create());
         }
-        
+
         $timeoutPlayer = $players->first();
-        
+
         // Setup handler
-        $handler = new TimerExpiredHandler();
+        $handler = new TimerExpiredHandler;
         $mode = new StandardMode($game);
-        
+
         // Mock game state
-        $gameState = new class {
+        $gameState = new class
+        {
             public ?string $currentPlayerUlid = null;
         };
         $gameState->currentPlayerUlid = $timeoutPlayer->ulid;
-        
+
         // Execute
         $result = $handler->checkAndHandle($game, $mode, $gameState);
-        
+
         // Assert
         expect($result->hasExpired)->toBeTrue()
             ->and($result->outcome->isFinished)->toBeTrue();
-            
+
         // Check finding a winner (trait implementation picks first opponent)
         // Verify it isn't the timeout player
         expect($result->outcome->winnerUlid)->not->toBe($timeoutPlayer->ulid)
diff --git a/tests/Integration/RematchCancellationTest.php b/tests/Integration/RematchCancellationTest.php
index 62b15a23..6a16a092 100644
--- a/tests/Integration/RematchCancellationTest.php
+++ b/tests/Integration/RematchCancellationTest.php
@@ -8,7 +8,6 @@
 use App\Models\Auth\User;
 use App\Models\Games\Game;
 use App\Models\Matchmaking\Proposal;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Redis;
 
diff --git a/tests/Pest.php b/tests/Pest.php
index 73ad4691..c57b672e 100644
--- a/tests/Pest.php
+++ b/tests/Pest.php
@@ -13,7 +13,7 @@
 |
 */
 
-pest()->extend(Tests\TestCase::class)
+pest()->extend(TestCase::class)
     ->use(RefreshDatabase::class)
     ->in('Feature', 'Integration', 'Unit');
 
@@ -73,6 +73,7 @@
 
 use App\Models\Auth\User;
 use Illuminate\Testing\TestResponse;
+use Tests\TestCase;
 
 /**
  * Create and authenticate a user for API requests
diff --git a/tests/TestCase.php b/tests/TestCase.php
index 6dabc3a6..2932d4a6 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -8,5 +8,3 @@ abstract class TestCase extends BaseTestCase
 {
     use CreatesApplication;
 }
-
-
diff --git a/tests/Unit/AgentAutoAcceptRematchTest.php b/tests/Unit/AgentAutoAcceptRematchTest.php
index ec5e611e..076fc232 100644
--- a/tests/Unit/AgentAutoAcceptRematchTest.php
+++ b/tests/Unit/AgentAutoAcceptRematchTest.php
@@ -10,7 +10,6 @@
 use App\Models\Auth\User;
 use App\Models\Games\Game;
 use App\Models\Matchmaking\Proposal;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Redis;
 
@@ -25,7 +24,7 @@
 
         // Mock Redis to track state changes in memory
         Redis::shouldReceive('setex')
-            ->with(\Mockery::pattern('/player:\d+:activity/'), 1800, \Mockery::any())
+            ->with(Mockery::pattern('/player:\d+:activity/'), 1800, Mockery::any())
             ->andReturnUsing(function ($key, $ttl, $value) {
                 $this->states[$key] = $value;
 
@@ -34,7 +33,7 @@
             ->byDefault();
 
         Redis::shouldReceive('get')
-            ->with(\Mockery::pattern('/player:\d+:activity/'))
+            ->with(Mockery::pattern('/player:\d+:activity/'))
             ->andReturnUsing(function ($key) {
                 return $this->states[$key] ?? 'idle'; // Default to idle for these tests
             })
diff --git a/tests/Unit/Agents/AgentSchedulingServiceTest.php b/tests/Unit/Agents/AgentSchedulingServiceTest.php
index 54e89776..ef59a6cf 100644
--- a/tests/Unit/Agents/AgentSchedulingServiceTest.php
+++ b/tests/Unit/Agents/AgentSchedulingServiceTest.php
@@ -4,7 +4,6 @@
 use App\Models\Auth\Agent;
 use App\Models\Auth\User;
 use App\Models\Games\Game;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Date;
 use Illuminate\Support\Facades\Redis;
 
diff --git a/tests/Unit/Agents/AgentServiceTest.php b/tests/Unit/Agents/AgentServiceTest.php
index 8a95493e..b6308585 100644
--- a/tests/Unit/Agents/AgentServiceTest.php
+++ b/tests/Unit/Agents/AgentServiceTest.php
@@ -6,7 +6,6 @@
 use App\Models\Auth\Agent;
 use App\Models\Auth\User;
 use App\Models\Games\Game;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Queue;
 
 beforeEach(function () {
diff --git a/tests/Unit/PlayerActivityManagerTest.php b/tests/Unit/PlayerActivityManagerTest.php
index fe636250..99fe2d44 100644
--- a/tests/Unit/PlayerActivityManagerTest.php
+++ b/tests/Unit/PlayerActivityManagerTest.php
@@ -3,7 +3,6 @@
 use App\Enums\PlayerActivityState;
 use App\GameEngine\Player\PlayerActivityManager;
 use App\Jobs\CheckAndCancelPendingProposals;
-use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Queue;
 use Illuminate\Support\Facades\Redis;
 

From b8f0d0999f2978bfd4c67fb7fe171f70ff287a4a Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:09:05 -0400
Subject: [PATCH 10/21] Add registration parent to applications

---
 .../migrations/0003_01_01_000005_create_applications_table.php   | 1 +
 1 file changed, 1 insertion(+)

diff --git a/database/migrations/0003_01_01_000005_create_applications_table.php b/database/migrations/0003_01_01_000005_create_applications_table.php
index 07fb749c..fefc3f5b 100644
--- a/database/migrations/0003_01_01_000005_create_applications_table.php
+++ b/database/migrations/0003_01_01_000005_create_applications_table.php
@@ -13,6 +13,7 @@ public function up(): void
     {
         Schema::create('applications', function (Blueprint $table) {
             $table->id();
+            $table->foreignId('registration_id')->nullable()->constrained('registrations');
             $table->timestamps();
         });
     }

From ce254463bfe59812f57f770414caf7b503c57f19 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:15:55 -0400
Subject: [PATCH 11/21] Draft user registration process w/ multitenant
 application workflows

---
 docs/registration.md | 124 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 124 insertions(+)
 create mode 100644 docs/registration.md

diff --git a/docs/registration.md b/docs/registration.md
new file mode 100644
index 00000000..82f174a8
--- /dev/null
+++ b/docs/registration.md
@@ -0,0 +1,124 @@
+# Technical Specification: W3RD-Compliant Registration Protocol
+
+**System Role:** Hypermedia Provider (Laravel Backend)  
+**Consumer Role:** Distributed AHA Stack (Astro/HTMX/Alpine)  
+**Protocol:** W3RD.io (Stateless Hypermedia over HTTPS)  
+**Base Namespace:** `/htmx/v1/registration/`
+
+---
+
+## 1. Core Concept: The "Holding Pen"
+
+The system utilizes a **"Deferred Identity"** pattern. No `User` record is created until a `Registration` entry clears the Workflow requirements defined by the specific `Client`. The backend serves HTML fragments (Hypermedia) that the remote AHA sites inject into their DOM.
+
+---
+
+## 2. Database Schema (MySQL)
+
+### 2.1 `workflows`
+The high-level blueprint for a specific process (e.g., User Onboarding, Vendor Application).
+
+| Field | Type | Description |
+| :--- | :--- | :--- |
+| `id` | BigInt (PK) | Internal Primary Key |
+| `client_uuid` | UUID (Index) | Public ID of the Client (Tenant) |
+| `name` | String | e.g., "Standard Onboarding", "VIP Intake" |
+| `category` | String | Categorization (default: `registration`) |
+| `is_active` | Boolean | Global toggle for this blueprint |
+
+### 2.2 `workflow_steps`
+The atomic units of the workflow. Each represents a unique Blade fragment.
+
+| Field | Type | Description |
+| :--- | :--- | :--- |
+| `id` | BigInt (PK) | Internal Primary Key |
+| `workflow_id` | ForeignID | Parent Workflow ID |
+| `slug` | String (Index) | URL identifier (e.g., `personal-info`, `id-upload`) |
+| `type` | Enum | `form`, `kyc`, `gate`, `review`, `payment`, `info` |
+| `blade_view` | String | Path to Blade file (e.g., `htmx.registration.steps.kyc`) |
+| `logic_rule` | JSON | Conditional skip rules (Feature #1) |
+| `requires_approval`| Boolean | If true, triggers Feature #10 (Manual Review) |
+| `sort_order` | Integer | Sequence within the workflow |
+
+### 2.3 `registrations`
+The state-machine table for in-progress applications.
+
+| Field | Type | Description |
+| :--- | :--- | :--- |
+| `uuid` | UUID (PK) | W3RD Context ID (Used in all HTMX requests) |
+| `client_id` | ForeignID | FK to the Clients table |
+| `workflow_id` | ForeignID | The blueprint being followed |
+| `current_step_id` | ForeignID | FK to workflow_steps |
+| `email` | String | Captured email (Unique within Client scope) |
+| `form_data` | JSON | Encrypted blob of all step inputs (#3, #5) |
+| `status` | Enum | `draft`, `pending_review`, `approved`, `graduated` |
+| `intended_role` | String | Target User Role (Feature #4) |
+| `approved_by` | ForeignID | Admin User ID who authorized graduation (#10) |
+| `expires_at` | Timestamp | TTL for abandoned registrations |
+
+---
+
+## 3. The W3RD Protocol & URI Logic
+
+### 3.1 Endpoint Mapping
+
+All hypermedia requests follow this pattern:
+`{BASE_URL}/htmx/v1/registration/{step_slug}`
+
+*   **GET**: Fetches the fragment for the specific step. Requires `X-W3RD-Context` (Registration UUID).
+*   **POST**: Submits data for the current step. Laravel processes data, updates `form_data` JSON, and determines the next `step_slug`.
+
+### 3.2 W3RD Header Requirements
+
+| Header | Requirement | Purpose |
+| :--- | :--- | :--- |
+| `X-W3RD-Client` | **Mandatory** | The `client_uuid` of the requesting site |
+| `X-W3RD-Context` | **Mandatory** | The `registration_uuid` (Context ID) |
+| `HX-Request` | **Mandatory** | Ensures the request is from HTMX |
+| `HX-Trigger` | Optional (Response) | Triggers Alpine.js events on the AHA frontend |
+
+---
+
+## 4. Functional Logic Specifications
+
+### 4.1 Feature #1: Conditional Skip Logic
+Before serving a fragment, the `WorkflowEngine` evaluates the `logic_rule`.
+
+*   **Rule Format**: `{"field": "intended_role", "operator": "==", "value": "vendor"}`
+*   **Behavior**: If the rule fails (e.g., user is a 'buyer'), the engine skips the current `step_slug` and automatically redirects the HTMX request to the next valid slug using the `HX-Redirect` or `HX-Push-Url` header.
+
+### 4.2 Feature #4 & #5: Branching and Team Provisioning
+*   **Branching**: The workflow can branch based on `intended_role`. Different roles follow different `sort_order` paths.
+*   **Team Provisioning**: The `form_data` JSON supports an `invited_team` array. Upon "Graduation," the backend loops through this array to create multiple `User` records under the same Client.
+
+### 4.3 Feature #10: Manual Review (Hypermedia Hold)
+If a step is flagged `requires_approval`:
+1.  The backend updates `registration.status` to `pending_review`.
+2.  The response is a "Review in Progress" Blade fragment.
+3.  The fragment uses `hx-get` with a `trigger="every 10s"` to poll the backend.
+4.  Once an Admin approves, the next poll returns the "Success/Graduation" fragment.
+
+---
+
+## 5. Security & Graduation Specification
+
+### 5.1 Promotion to User (Graduation)
+The "Promotion" is an atomic transaction:
+1.  Validate that all required steps in the Workflow are marked as complete in `form_data`.
+2.  Map `form_data` keys to `User` and `Profile` table columns.
+3.  Create `User` record(s).
+4.  Delete or Archive the `Registration` record (or mark as `graduated`).
+
+### 5.2 W3RD Handover
+Post-graduation, the backend returns a final fragment containing a **one-time-use Handover Token**. The AHA frontend uses this token to establish the first authenticated session on the Client's specific domain.
+
+---
+
+## 6. Error Handling
+
+### 6.1 Validation Errors
+Return `422 Unprocessable Entity`. The body must be the same form fragment with `$errors` populated.
+
+### 6.2 Expired Context
+If `X-W3RD-Context` is expired or invalid, return `403 Forbidden` with a `HX-Trigger: registration-expired` header to force a restart on the AHA site.
+

From 62869f6cc0ade2daed1b91ee809a3aaea553ccdc Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:18:22 -0400
Subject: [PATCH 12/21] Fix pest test case issue

---
 tests/Pest.php | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/tests/Pest.php b/tests/Pest.php
index c57b672e..50352b45 100644
--- a/tests/Pest.php
+++ b/tests/Pest.php
@@ -1,6 +1,9 @@
 <?php
 
+use App\Models\Auth\User;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Testing\TestResponse;
+use Tests\TestCase;
 
 /*
 |--------------------------------------------------------------------------
@@ -71,10 +74,6 @@
 |
 */
 
-use App\Models\Auth\User;
-use Illuminate\Testing\TestResponse;
-use Tests\TestCase;
-
 /**
  * Create and authenticate a user for API requests
  */

From 2a74b60e03da50a8a0921ed1a1599624eb067184 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:26:35 -0400
Subject: [PATCH 13/21] Expand features for user onboarding

---
 docs/registration.md | 77 ++++++++++++++++++++++++++++++++++----------
 1 file changed, 60 insertions(+), 17 deletions(-)

diff --git a/docs/registration.md b/docs/registration.md
index 82f174a8..c71da7ff 100644
--- a/docs/registration.md
+++ b/docs/registration.md
@@ -25,6 +25,7 @@ The high-level blueprint for a specific process (e.g., User Onboarding, Vendor A
 | `name` | String | e.g., "Standard Onboarding", "VIP Intake" |
 | `category` | String | Categorization (default: `registration`) |
 | `is_active` | Boolean | Global toggle for this blueprint |
+| `traffic_split` | JSON | A/B Testing Config (Feature #3) - e.g. `{"variant_b_id": 12, "ratio": 0.5}` |
 
 ### 2.2 `workflow_steps`
 The atomic units of the workflow. Each represents a unique Blade fragment.
@@ -34,9 +35,10 @@ The atomic units of the workflow. Each represents a unique Blade fragment.
 | `id` | BigInt (PK) | Internal Primary Key |
 | `workflow_id` | ForeignID | Parent Workflow ID |
 | `slug` | String (Index) | URL identifier (e.g., `personal-info`, `id-upload`) |
-| `type` | Enum | `form`, `kyc`, `gate`, `review`, `payment`, `info` |
+| `type` | Enum | `form`, `kyc`, `gate`, `review`, `payment`, `info`, `enrichment`, `game` (Features #4, #10) |
 | `blade_view` | String | Path to Blade file (e.g., `htmx.registration.steps.kyc`) |
 | `logic_rule` | JSON | Conditional skip rules (Feature #1) |
+| `risk_rule` | JSON | Dynamic risk-based injection rules (Feature #7) |
 | `requires_approval`| Boolean | If true, triggers Feature #10 (Manual Review) |
 | `sort_order` | Integer | Sequence within the workflow |
 
@@ -50,9 +52,11 @@ The state-machine table for in-progress applications.
 | `workflow_id` | ForeignID | The blueprint being followed |
 | `current_step_id` | ForeignID | FK to workflow_steps |
 | `email` | String | Captured email (Unique within Client scope) |
-| `form_data` | JSON | Encrypted blob of all step inputs (#3, #5) |
+| `form_data` | JSON | Encrypted blob of all step inputs (#4, #5) |
+| `step_timings` | JSON | Analytics: Time spent per step (Feature #2) |
 | `status` | Enum | `draft`, `pending_review`, `approved`, `graduated` |
 | `intended_role` | String | Target User Role (Feature #4) |
+| `parent_registration_uuid`| UUID | For Team "Seat Holding" (Feature #9) |
 | `approved_by` | ForeignID | Admin User ID who authorized graduation (#10) |
 | `expires_at` | Timestamp | TTL for abandoned registrations |
 
@@ -66,7 +70,7 @@ All hypermedia requests follow this pattern:
 `{BASE_URL}/htmx/v1/registration/{step_slug}`
 
 *   **GET**: Fetches the fragment for the specific step. Requires `X-W3RD-Context` (Registration UUID).
-*   **POST**: Submits data for the current step. Laravel processes data, updates `form_data` JSON, and determines the next `step_slug`.
+*   **POST**: Submits data for the current step. Laravel processes data, updates `form_data` JSON, logs timing, and determines the next `step_slug`.
 
 ### 3.2 W3RD Header Requirements
 
@@ -81,15 +85,19 @@ All hypermedia requests follow this pattern:
 
 ## 4. Functional Logic Specifications
 
-### 4.1 Feature #1: Conditional Skip Logic
-Before serving a fragment, the `WorkflowEngine` evaluates the `logic_rule`.
+### 4.1 Feature #1 & #7: Conditional & Risk-Based Logic
+Before serving a fragment, the `WorkflowEngine` evaluates both `logic_rule` and `risk_rule`.
 
-*   **Rule Format**: `{"field": "intended_role", "operator": "==", "value": "vendor"}`
-*   **Behavior**: If the rule fails (e.g., user is a 'buyer'), the engine skips the current `step_slug` and automatically redirects the HTMX request to the next valid slug using the `HX-Redirect` or `HX-Push-Url` header.
+*   **Logic Rule**: `{"field": "intended_role", "operator": "==", "value": "vendor"}` (Skips irrelevant steps)
+*   **Risk Rule (Feature #7)**: `{"provider": "MaxMind", "score": ">", "threshold": 80}`
+    *   **Behavior**: If the risk score of the incoming IP/Request is high, the engine *dynamically injects* a `verification-gate` step (CAPTCHA/SMS) that is otherwise bypassed for safe traffic.
 
-### 4.2 Feature #4 & #5: Branching and Team Provisioning
-*   **Branching**: The workflow can branch based on `intended_role`. Different roles follow different `sort_order` paths.
-*   **Team Provisioning**: The `form_data` JSON supports an `invited_team` array. Upon "Graduation," the backend loops through this array to create multiple `User` records under the same Client.
+### 4.2 Feature #4, #5 & #9: Branching and Team Provisioning
+*   **Branching**: The workflow can branch based on `intended_role`.
+*   **Team Seat Holding (Feature #9)**:
+    *   If `form_data.invited_team` is populated, the backend immediately creates "Child Registrations" for each invitee in `draft` status, linked via `parent_registration_uuid`.
+    *   Trigger `registration.team_invite_sent` webhook to dispatch emails.
+    *   Invitees enter their own "Holding Pen" flow, pre-linked to the Organization being created.
 
 ### 4.3 Feature #10: Manual Review (Hypermedia Hold)
 If a step is flagged `requires_approval`:
@@ -98,27 +106,62 @@ If a step is flagged `requires_approval`:
 3.  The fragment uses `hx-get` with a `trigger="every 10s"` to poll the backend.
 4.  Once an Admin approves, the next poll returns the "Success/Graduation" fragment.
 
+### 4.4 Feature #4: Data Enrichment (Invisible Step)
+*   **Step Type**: `enrichment`
+*   **Behavior**: Asynchronous server-side process triggered after Email capture.
+*   **Action**: Queries external providers (Clearbit/FullContact).
+*   **Result**: Merges returned company/profile data into `form_data`. Subsequent steps (e.g., "Company Info") render with fields pre-filled, reducing user friction.
+
+---
+
+## 5. Security, Analytics & Graduation
+
+### 5.1 feature #2: Step-Level Analytics
+*   **Tracking**: `registrations.step_timings` stores `{ "step_slug": { "viewed_at": "timestamp", "completed_at": "timestamp" } }`.
+*   **Insight**: Allows calculation of "Time to Complete" per step and identification of bottleneck steps with high abandonment rates.
+
+### 5.2 Feature #1: Magic Link Session Restoration
+*   **Endpoint**: `POST /htmx/v1/registration/magic-link`
+*   **Action**: Generates a signed URL containing the `registration_uuid`.
+*   **Behavior**: Clicking the link sets the `X-W3RD-Context` on the frontend (via LocalStorage/Cookie) and redirects the user to their last active `current_step_id`, enabling cross-device completion.
+
+### 5.3 feature #6: Webhook Pulse Events
+The Workflow Engine emits events to the Client's configured Webhook URL:
+*   `registration.started` (Lead created)
+*   `registration.step_completed` (Progress update, includes `step_slug`)
+*   `registration.abandoned` (Trigger re-engagement email)
+*   `registration.graduated` (Conversion event)
+
+### 5.4 Feature #8: White-Label Styling
+*   **Implementation**: All Blade fragments utilize Tailwind CSS utility classes.
+*   **Customization**: The `Client` model stores a `theme_config` JSON (e.g., `{"primary": "#ff0000", "font": "Inter"}`).
+*   **Injection**: The API response injects a `<style>` block scoped to the component with CSS variables mapping the Client's theme to Tailwind defaults (e.g., `--color-primary: #ff0000;`).
+
+### 5.5 Feature #10: Gamified Interactive Steps
+*   **Step Type**: `game`
+*   **Behavior**: Returns a fragment containing an Alpine.js game component (e.g., "Select Avatar").
+*   **Validation**: Completion of the game triggers an `hx-post` with the result (e.g., `avatar_id`), which is validated just like a standard form input.
+
 ---
 
-## 5. Security & Graduation Specification
+## 6. Graduation & Handover
 
-### 5.1 Promotion to User (Graduation)
+### 6.1 Promotion to User (Graduation)
 The "Promotion" is an atomic transaction:
 1.  Validate that all required steps in the Workflow are marked as complete in `form_data`.
 2.  Map `form_data` keys to `User` and `Profile` table columns.
 3.  Create `User` record(s).
 4.  Delete or Archive the `Registration` record (or mark as `graduated`).
 
-### 5.2 W3RD Handover
+### 6.2 W3RD Handover
 Post-graduation, the backend returns a final fragment containing a **one-time-use Handover Token**. The AHA frontend uses this token to establish the first authenticated session on the Client's specific domain.
 
 ---
 
-## 6. Error Handling
+## 7. Error Handling
 
-### 6.1 Validation Errors
+### 7.1 Validation Errors
 Return `422 Unprocessable Entity`. The body must be the same form fragment with `$errors` populated.
 
-### 6.2 Expired Context
+### 7.2 Expired Context
 If `X-W3RD-Context` is expired or invalid, return `403 Forbidden` with a `HX-Trigger: registration-expired` header to force a restart on the AHA site.
-

From 1f513053636c19b7f049f0b72077bda913c266c0 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:30:32 -0400
Subject: [PATCH 14/21] Update migrations for user registration workflows

---
 ...02_01_01_000006_create_workflows_table.php |  6 ++++++
 ..._01_000007_create_workflow_steps_table.php |  9 +++++++++
 ...1_01_000002_create_registrations_table.php | 19 ++++++++++++++-----
 3 files changed, 29 insertions(+), 5 deletions(-)

diff --git a/database/migrations/0002_01_01_000006_create_workflows_table.php b/database/migrations/0002_01_01_000006_create_workflows_table.php
index eec1896d..2996317b 100644
--- a/database/migrations/0002_01_01_000006_create_workflows_table.php
+++ b/database/migrations/0002_01_01_000006_create_workflows_table.php
@@ -13,7 +13,13 @@ public function up(): void
     {
         Schema::create('workflows', function (Blueprint $table) {
             $table->id();
+            $table->foreignId('client_id')->constrained('clients');
+            $table->string('name');
+            $table->string('category')->default('registration');
+            $table->boolean('is_active')->default(true);
+            $table->json('traffic_split')->nullable();
             $table->timestamps();
+            $table->softDeletes();
         });
     }
 };
diff --git a/database/migrations/0002_01_01_000007_create_workflow_steps_table.php b/database/migrations/0002_01_01_000007_create_workflow_steps_table.php
index 45635904..535ea6c3 100644
--- a/database/migrations/0002_01_01_000007_create_workflow_steps_table.php
+++ b/database/migrations/0002_01_01_000007_create_workflow_steps_table.php
@@ -13,7 +13,16 @@ public function up(): void
     {
         Schema::create('workflow_steps', function (Blueprint $table) {
             $table->id();
+            $table->foreignId('workflow_id')->constrained('workflows');
+            $table->string('slug')->index();
+            $table->string('type')->default('form'); // e.g. form, kyc, gate, review, payment, info, enrichment, game
+            $table->string('blade_view');
+            $table->json('logic_rule')->nullable();
+            $table->json('risk_rule')->nullable();
+            $table->boolean('requires_approval')->default(false);
+            $table->integer('sort_order')->default(0);
             $table->timestamps();
+            $table->softDeletes();
         });
     }
 };
diff --git a/database/migrations/0003_01_01_000002_create_registrations_table.php b/database/migrations/0003_01_01_000002_create_registrations_table.php
index 803d863b..84caa459 100644
--- a/database/migrations/0003_01_01_000002_create_registrations_table.php
+++ b/database/migrations/0003_01_01_000002_create_registrations_table.php
@@ -12,13 +12,22 @@
     public function up(): void
     {
         Schema::create('registrations', function (Blueprint $table) {
-            $table->id();
+            $table->uuid('id')->primary(); // W3RD Context ID
             $table->foreignId('client_id')->constrained('clients');
-            $table->string('email')->unique();
-            $table->string('password');
-            $table->string('verification_token')->unique();
-            $table->foreignId('user_id')->nullable()->constrained('users');
+            $table->foreignId('workflow_id')->constrained('workflows');
+            $table->foreignId('current_step_id')->nullable()->constrained('workflow_steps')->nullOnDelete();
+            $table->string('email')->index();
+            $table->json('form_data')->nullable(); // Encrypted blob of all step inputs
+            $table->json('step_timings')->nullable(); // Analytics: Time spent per step
+            $table->string('status')->default('draft'); // draft, pending_review, approved, graduated
+            $table->string('intended_role')->nullable(); // Target User Role
+            $table->uuid('parent_registration_uuid')->nullable()->index(); // For Team "Seat Holding"
+            $table->foreignId('approved_by')->nullable()->constrained('users'); // Admin User ID who authorized graduation
+            $table->timestamp('expires_at')->nullable(); // TTL for abandoned registrations
             $table->timestamps();
+            $table->softDeletes();
+
+            $table->unique(['client_id', 'email']); // Scope email uniqueness to client
         });
     }
 };

From 3555f69635d22ba55ae47c785ff8d2644df60a4b Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:34:35 -0400
Subject: [PATCH 15/21] Expand details in user registration doc

---
 docs/registration.md | 140 ++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 133 insertions(+), 7 deletions(-)

diff --git a/docs/registration.md b/docs/registration.md
index c71da7ff..ef283979 100644
--- a/docs/registration.md
+++ b/docs/registration.md
@@ -15,6 +15,8 @@ The system utilizes a **"Deferred Identity"** pattern. No `User` record is creat
 
 ## 2. Database Schema (MySQL)
 
+**Versioning Strategy:** Workflows are immutable once active. To change a workflow, create a new `workflow` record (v2) and update the `client` configuration to point to the new ID. Existing registrations continue on their original `workflow_id`.
+
 ### 2.1 `workflows`
 The high-level blueprint for a specific process (e.g., User Onboarding, Vendor Application).
 
@@ -45,6 +47,11 @@ The atomic units of the workflow. Each represents a unique Blade fragment.
 ### 2.3 `registrations`
 The state-machine table for in-progress applications.
 
+**Indexing Strategy:**
+*   **Compound Index:** `[client_id, email]` (Uniqueness check)
+*   **Compound Index:** `[uuid, expires_at]` (Cleanup jobs)
+*   **Index:** `parent_registration_uuid` (Team lookups)
+
 | Field | Type | Description |
 | :--- | :--- | :--- |
 | `uuid` | UUID (PK) | W3RD Context ID (Used in all HTMX requests) |
@@ -72,7 +79,28 @@ All hypermedia requests follow this pattern:
 *   **GET**: Fetches the fragment for the specific step. Requires `X-W3RD-Context` (Registration UUID).
 *   **POST**: Submits data for the current step. Laravel processes data, updates `form_data` JSON, logs timing, and determines the next `step_slug`.
 
-### 3.2 W3RD Header Requirements
+### 3.2 Happy Path Trace (Example)
+
+**1. Start Registration (GET /init)**
+```http
+GET /htmx/v1/registration/init
+Header: X-W3RD-Client: <uuid>
+Response: 200 OK
+New-Context-ID: <new-uuid>
+HTML: <form hx-post="personal-info">...</form>
+```
+
+**2. Submit Info (POST /personal-info)**
+```http
+POST /htmx/v1/registration/personal-info
+Header: X-W3RD-Context: <uuid>
+Body: email=bob@example.com&name=Bob
+Response: 200 OK
+HX-Push-Url: /register/team-invite
+HTML: <form hx-post="team-invite">...</form>
+```
+
+### 3.3 W3RD Header Requirements
 
 | Header | Requirement | Purpose |
 | :--- | :--- | :--- |
@@ -85,6 +113,19 @@ All hypermedia requests follow this pattern:
 
 ## 4. Functional Logic Specifications
 
+### 4.0 Lifecycle State Machine
+
+```mermaid
+graph TD
+    A[Draft] -->|Submit Step| A
+    A -->|Requires Approval| B[Pending Review]
+    B -->|Admin Approve| C[Approved]
+    B -->|Admin Reject| A
+    A -->|All Steps Complete| C
+    C -->|Graduation Event| D[Graduated]
+    D -->|User Created| E[User Active]
+```
+
 ### 4.1 Feature #1 & #7: Conditional & Risk-Based Logic
 Before serving a fragment, the `WorkflowEngine` evaluates both `logic_rule` and `risk_rule`.
 
@@ -140,7 +181,11 @@ The Workflow Engine emits events to the Client's configured Webhook URL:
 ### 5.5 Feature #10: Gamified Interactive Steps
 *   **Step Type**: `game`
 *   **Behavior**: Returns a fragment containing an Alpine.js game component (e.g., "Select Avatar").
-*   **Validation**: Completion of the game triggers an `hx-post` with the result (e.g., `avatar_id`), which is validated just like a standard form input.
+*   **Interface Contract**: The game component MUST mimic a form submission.
+    1.  User plays game (e.g., selects avatar).
+    2.  Game updates a hidden input `<input type="hidden" name="game_result" value="{id: 5}">`.
+    3.  Game triggers `htmx.trigger('#game-form', 'submit')`.
+    4.  Backend validates the `game_result` payload.
 
 ---
 
@@ -154,14 +199,95 @@ The "Promotion" is an atomic transaction:
 4.  Delete or Archive the `Registration` record (or mark as `graduated`).
 
 ### 6.2 W3RD Handover
-Post-graduation, the backend returns a final fragment containing a **one-time-use Handover Token**. The AHA frontend uses this token to establish the first authenticated session on the Client's specific domain.
+Post-graduation, the backend returns a final fragment containing a **one-time-use Handover Token**.
+*   **Mechanism**: Signed JWT (short-lived, 5 mins).
+*   **Frontend Action**: Javascript detects token, POSTs to `/api/login/handover`.
+*   **Result**: Backend exchanges token for long-lived Session/Auth Token.
 
 ---
 
 ## 7. Error Handling
 
-### 7.1 Validation Errors
-Return `422 Unprocessable Entity`. The body must be the same form fragment with `$errors` populated.
+### 7.1 Error Response Codes
+
+| Code | Reason | Frontend Action |
+| :--- | :--- | :--- |
+| **422** | Validation Error | Render HTML fragment with error messages inline. |
+| **403** | Expired Context | Trigger `registration-expired` event (Restart flow). |
+| **409** | Conflict | Step already completed or out of sequence. Reload current step. |
+| **500** | System Error | Show "Try again later" toast. |
+
+### 7.2 Custom Headers
+*   `X-W3RD-Error: logic-rule-mismatch` - Debug info for why a step was skipped.
+
+---
+
+## 8. Consumer Integration
+
+To integrate the W3RD consumer on an Astro/Static site:
+
+```html
+<div id="w3rd-registration-container" 
+     hx-get="https://api.w3rd.tech/htmx/v1/registration/init" 
+     hx-trigger="load"
+     hx-headers='{"X-W3RD-Client": "YOUR_CLIENT_UUID"}'>
+</div>
+
+<script>
+    document.body.addEventListener('htmx:configRequest', function(evt) {
+        // Automatically attach Context UUID if exists
+        const context = localStorage.getItem('w3rd_context');
+        if (context) {
+            evt.detail.headers['X-W3RD-Context'] = context;
+        }
+    });
+
+    document.body.addEventListener('htmx:afterRequest', function(evt) {
+        // Save new Context UUID from response
+        const newContext = evt.detail.xhr.getResponseHeader('New-Context-ID');
+        if (newContext) localStorage.setItem('w3rd_context', newContext);
+    });
+</script>
+```
+
+---
+
+## 9. Development & Testing
+
+*   **Testing Strategy**: Use `Symfony\Component\DomCrawler\Crawler` in PHPUnit features tests to assert that specific input fields are present in the returned HTML. Do not just assert 200 OK.
+*   **Mocking**: In local dev, mock the Enrichment and Risk providers to always return "Safe" / "Enriched" data.
+
+---
 
-### 7.2 Expired Context
-If `X-W3RD-Context` is expired or invalid, return `403 Forbidden` with a `HX-Trigger: registration-expired` header to force a restart on the AHA site.
+## 10. Appendix: JSON Configuration Examples
+
+**A. Logic Rule (Conditional Skip)**
+```json
+[
+  {
+    "field": "intended_role",
+    "operator": "in",
+    "value": ["vendor", "partner"]
+  }
+]
+```
+
+**B. Risk Rule (Verification Injection)**
+```json
+{
+  "provider": "maxmind",
+  "score_threshold": 75,
+  "action": "inject_step",
+  "step_slug": "identify-verification"
+}
+```
+
+**C. Traffic Split (A/B Testing)**
+```json
+{
+  "variants": [
+    { "workflow_id": 12, "weight": 50 },
+    { "workflow_id": 15, "weight": 50 }
+  ]
+}
+```

From bc4bc7480f45a125cd29c1f0b65aaf27a2c6ffd7 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:36:20 -0400
Subject: [PATCH 16/21] Resolve phpstan issues

---
 app/Models/Auth/Registration.php | 67 +++++++++++++++++++++++++++++---
 1 file changed, 62 insertions(+), 5 deletions(-)

diff --git a/app/Models/Auth/Registration.php b/app/Models/Auth/Registration.php
index cd925835..e4b09f96 100644
--- a/app/Models/Auth/Registration.php
+++ b/app/Models/Auth/Registration.php
@@ -8,6 +8,10 @@
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
+/**
+ * @property string|null $password
+ * @property string|null $verification_token
+ */
 class Registration extends Model
 {
     /** @use HasFactory<RegistrationFactory> */
@@ -19,11 +23,18 @@ class Registration extends Model
      * @var list<string>
      */
     protected $fillable = [
+        'uuid',
         'client_id',
+        'workflow_id',
+        'current_step_id',
         'email',
-        'password',
-        'verification_token',
-        'user_id',
+        'form_data',
+        'step_timings',
+        'status',
+        'intended_role',
+        'parent_registration_uuid',
+        'approved_by',
+        'expires_at',
     ];
 
     /**
@@ -32,10 +43,56 @@ class Registration extends Model
      * @var list<string>
      */
     protected $hidden = [
-        'password',
-        'verification_token',
+        'form_data',
     ];
 
+    /**
+     * The attributes that should be cast.
+     *
+     * @var array<string, string>
+     */
+    protected $casts = [
+        'form_data' => 'encrypted:array',
+        'step_timings' => 'array',
+        'expires_at' => 'datetime',
+    ];
+
+    /**
+     * Virtual attribute for backward compatibility.
+     */
+    public function getPasswordAttribute(): ?string
+    {
+        return $this->form_data['password'] ?? null;
+    }
+
+    /**
+     * Virtual attribute for backward compatibility.
+     */
+    public function setPasswordAttribute(string $value): void
+    {
+        $data = $this->form_data ?? [];
+        $data['password'] = $value;
+        $this->form_data = $data;
+    }
+
+    /**
+     * Virtual attribute for backward compatibility.
+     */
+    public function getVerificationTokenAttribute(): ?string
+    {
+        return $this->form_data['verification_token'] ?? null;
+    }
+
+    /**
+     * Virtual attribute for backward compatibility.
+     */
+    public function setVerificationTokenAttribute(string $value): void
+    {
+        $data = $this->form_data ?? [];
+        $data['verification_token'] = $value;
+        $this->form_data = $data;
+    }
+
     /**
      * Get the client that originated the registration.
      *

From 811151636e5d97954afd85148323052c382da488 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:44:42 -0400
Subject: [PATCH 17/21] Fix test issue

---
 app/Models/Auth/Registration.php              | 32 ++++++++-----------
 ...1_01_000002_create_registrations_table.php |  5 +--
 ...01_01_000005_create_applications_table.php |  2 +-
 3 files changed, 17 insertions(+), 22 deletions(-)

diff --git a/app/Models/Auth/Registration.php b/app/Models/Auth/Registration.php
index e4b09f96..be2a4752 100644
--- a/app/Models/Auth/Registration.php
+++ b/app/Models/Auth/Registration.php
@@ -4,6 +4,7 @@
 
 use App\Models\Access\Client;
 use Database\Factories\Auth\RegistrationFactory;
+use Illuminate\Database\Eloquent\Concerns\HasUuids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
@@ -15,7 +16,14 @@
 class Registration extends Model
 {
     /** @use HasFactory<RegistrationFactory> */
-    use HasFactory;
+    use HasFactory, HasUuids;
+
+    /**
+     * The primary key associated with the table.
+     *
+     * @var string
+     */
+    protected $primaryKey = 'uuid';
 
     /**
      * The attributes that are mass assignable.
@@ -28,6 +36,8 @@ class Registration extends Model
         'workflow_id',
         'current_step_id',
         'email',
+        'password',
+        'verification_token',
         'form_data',
         'step_timings',
         'status',
@@ -43,6 +53,8 @@ class Registration extends Model
      * @var list<string>
      */
     protected $hidden = [
+        'password',
+        'verification_token',
         'form_data',
     ];
 
@@ -75,24 +87,6 @@ public function setPasswordAttribute(string $value): void
         $this->form_data = $data;
     }
 
-    /**
-     * Virtual attribute for backward compatibility.
-     */
-    public function getVerificationTokenAttribute(): ?string
-    {
-        return $this->form_data['verification_token'] ?? null;
-    }
-
-    /**
-     * Virtual attribute for backward compatibility.
-     */
-    public function setVerificationTokenAttribute(string $value): void
-    {
-        $data = $this->form_data ?? [];
-        $data['verification_token'] = $value;
-        $this->form_data = $data;
-    }
-
     /**
      * Get the client that originated the registration.
      *
diff --git a/database/migrations/0003_01_01_000002_create_registrations_table.php b/database/migrations/0003_01_01_000002_create_registrations_table.php
index 84caa459..20687e35 100644
--- a/database/migrations/0003_01_01_000002_create_registrations_table.php
+++ b/database/migrations/0003_01_01_000002_create_registrations_table.php
@@ -12,11 +12,12 @@
     public function up(): void
     {
         Schema::create('registrations', function (Blueprint $table) {
-            $table->uuid('id')->primary(); // W3RD Context ID
+            $table->uuid('uuid')->primary(); // W3RD Context ID
             $table->foreignId('client_id')->constrained('clients');
-            $table->foreignId('workflow_id')->constrained('workflows');
+            $table->foreignId('workflow_id')->nullable()->constrained('workflows');
             $table->foreignId('current_step_id')->nullable()->constrained('workflow_steps')->nullOnDelete();
             $table->string('email')->index();
+            $table->string('verification_token')->nullable()->index(); // For email verification
             $table->json('form_data')->nullable(); // Encrypted blob of all step inputs
             $table->json('step_timings')->nullable(); // Analytics: Time spent per step
             $table->string('status')->default('draft'); // draft, pending_review, approved, graduated
diff --git a/database/migrations/0003_01_01_000005_create_applications_table.php b/database/migrations/0003_01_01_000005_create_applications_table.php
index fefc3f5b..0e658c32 100644
--- a/database/migrations/0003_01_01_000005_create_applications_table.php
+++ b/database/migrations/0003_01_01_000005_create_applications_table.php
@@ -13,7 +13,7 @@ public function up(): void
     {
         Schema::create('applications', function (Blueprint $table) {
             $table->id();
-            $table->foreignId('registration_id')->nullable()->constrained('registrations');
+            $table->foreignUuid('registration_uuid')->nullable()->constrained('registrations', 'uuid');
             $table->timestamps();
         });
     }

From edac9f370668365f04b4617e72b228966ad12aa1 Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:49:02 -0400
Subject: [PATCH 18/21] Nest application workflow files

---
 app/Http/Controllers/ApplicationController.php        | 2 +-
 app/Http/Controllers/WorkflowController.php           | 2 +-
 app/Http/Controllers/WorkflowStepController.php       | 2 +-
 app/Models/{ => Auth}/Application.php                 | 5 ++---
 app/Models/{ => Auth}/Workflow.php                    | 5 ++---
 app/Models/{ => Auth}/WorkflowStep.php                | 5 ++---
 app/Policies/ApplicationPolicy.php                    | 2 +-
 app/Policies/WorkflowPolicy.php                       | 2 +-
 app/Policies/WorkflowStepPolicy.php                   | 2 +-
 database/factories/{ => Auth}/ApplicationFactory.php  | 6 +++---
 database/factories/{ => Auth}/WorkflowFactory.php     | 6 +++---
 database/factories/{ => Auth}/WorkflowStepFactory.php | 6 +++---
 12 files changed, 21 insertions(+), 24 deletions(-)
 rename app/Models/{ => Auth}/Application.php (58%)
 rename app/Models/{ => Auth}/Workflow.php (59%)
 rename app/Models/{ => Auth}/WorkflowStep.php (58%)
 rename database/factories/{ => Auth}/ApplicationFactory.php (80%)
 rename database/factories/{ => Auth}/WorkflowFactory.php (81%)
 rename database/factories/{ => Auth}/WorkflowStepFactory.php (80%)

diff --git a/app/Http/Controllers/ApplicationController.php b/app/Http/Controllers/ApplicationController.php
index a74bd89c..19c45813 100644
--- a/app/Http/Controllers/ApplicationController.php
+++ b/app/Http/Controllers/ApplicationController.php
@@ -4,7 +4,7 @@
 
 use App\Http\Requests\StoreApplicationRequest;
 use App\Http\Requests\UpdateApplicationRequest;
-use App\Models\Application;
+use App\Models\Auth\Application;
 
 class ApplicationController extends Controller
 {
diff --git a/app/Http/Controllers/WorkflowController.php b/app/Http/Controllers/WorkflowController.php
index cc084da2..6ae8a45c 100644
--- a/app/Http/Controllers/WorkflowController.php
+++ b/app/Http/Controllers/WorkflowController.php
@@ -4,7 +4,7 @@
 
 use App\Http\Requests\StoreWorkflowRequest;
 use App\Http\Requests\UpdateWorkflowRequest;
-use App\Models\Workflow;
+use App\Models\Auth\Workflow;
 
 class WorkflowController extends Controller
 {
diff --git a/app/Http/Controllers/WorkflowStepController.php b/app/Http/Controllers/WorkflowStepController.php
index e7f4444d..73c8b320 100644
--- a/app/Http/Controllers/WorkflowStepController.php
+++ b/app/Http/Controllers/WorkflowStepController.php
@@ -4,7 +4,7 @@
 
 use App\Http\Requests\StoreWorkflowStepRequest;
 use App\Http\Requests\UpdateWorkflowStepRequest;
-use App\Models\WorkflowStep;
+use App\Models\Auth\WorkflowStep;
 
 class WorkflowStepController extends Controller
 {
diff --git a/app/Models/Application.php b/app/Models/Auth/Application.php
similarity index 58%
rename from app/Models/Application.php
rename to app/Models/Auth/Application.php
index 4a7652ce..4760eb0d 100644
--- a/app/Models/Application.php
+++ b/app/Models/Auth/Application.php
@@ -1,13 +1,12 @@
 <?php
 
-namespace App\Models;
+namespace App\Models\Auth;
 
-use Database\Factories\ApplicationFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class Application extends Model
 {
-    /** @use HasFactory<ApplicationFactory> */
+    /** @use HasFactory<\Database\Factories\Auth\ApplicationFactory> */
     use HasFactory;
 }
diff --git a/app/Models/Workflow.php b/app/Models/Auth/Workflow.php
similarity index 59%
rename from app/Models/Workflow.php
rename to app/Models/Auth/Workflow.php
index e883eae7..85d957e5 100644
--- a/app/Models/Workflow.php
+++ b/app/Models/Auth/Workflow.php
@@ -1,13 +1,12 @@
 <?php
 
-namespace App\Models;
+namespace App\Models\Auth;
 
-use Database\Factories\WorkflowFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class Workflow extends Model
 {
-    /** @use HasFactory<WorkflowFactory> */
+    /** @use HasFactory<\Database\Factories\Auth\WorkflowFactory> */
     use HasFactory;
 }
diff --git a/app/Models/WorkflowStep.php b/app/Models/Auth/WorkflowStep.php
similarity index 58%
rename from app/Models/WorkflowStep.php
rename to app/Models/Auth/WorkflowStep.php
index c7e577d6..c3516d69 100644
--- a/app/Models/WorkflowStep.php
+++ b/app/Models/Auth/WorkflowStep.php
@@ -1,13 +1,12 @@
 <?php
 
-namespace App\Models;
+namespace App\Models\Auth;
 
-use Database\Factories\WorkflowStepFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class WorkflowStep extends Model
 {
-    /** @use HasFactory<WorkflowStepFactory> */
+    /** @use HasFactory<\Database\Factories\Auth\WorkflowStepFactory> */
     use HasFactory;
 }
diff --git a/app/Policies/ApplicationPolicy.php b/app/Policies/ApplicationPolicy.php
index 13bc93f0..eda1f7d1 100644
--- a/app/Policies/ApplicationPolicy.php
+++ b/app/Policies/ApplicationPolicy.php
@@ -2,7 +2,7 @@
 
 namespace App\Policies;
 
-use App\Models\Application;
+use App\Models\Auth\Application;
 use App\Models\Auth\User;
 
 class ApplicationPolicy
diff --git a/app/Policies/WorkflowPolicy.php b/app/Policies/WorkflowPolicy.php
index 94bde6a9..3b63d103 100644
--- a/app/Policies/WorkflowPolicy.php
+++ b/app/Policies/WorkflowPolicy.php
@@ -3,7 +3,7 @@
 namespace App\Policies;
 
 use App\Models\Auth\User;
-use App\Models\Workflow;
+use App\Models\Auth\Workflow;
 
 class WorkflowPolicy
 {
diff --git a/app/Policies/WorkflowStepPolicy.php b/app/Policies/WorkflowStepPolicy.php
index 7f0b7333..15555609 100644
--- a/app/Policies/WorkflowStepPolicy.php
+++ b/app/Policies/WorkflowStepPolicy.php
@@ -3,7 +3,7 @@
 namespace App\Policies;
 
 use App\Models\Auth\User;
-use App\Models\WorkflowStep;
+use App\Models\Auth\WorkflowStep;
 
 class WorkflowStepPolicy
 {
diff --git a/database/factories/ApplicationFactory.php b/database/factories/Auth/ApplicationFactory.php
similarity index 80%
rename from database/factories/ApplicationFactory.php
rename to database/factories/Auth/ApplicationFactory.php
index aa85a158..47b58f2b 100644
--- a/database/factories/ApplicationFactory.php
+++ b/database/factories/Auth/ApplicationFactory.php
@@ -1,12 +1,12 @@
 <?php
 
-namespace Database\Factories;
+namespace Database\Factories\Auth;
 
-use App\Models\Application;
+use App\Models\Auth\Application;
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @template TModel of \App\Models\Application
+ * @template TModel of \App\Models\Auth\Application
  *
  * @extends Factory<TModel>
  */
diff --git a/database/factories/WorkflowFactory.php b/database/factories/Auth/WorkflowFactory.php
similarity index 81%
rename from database/factories/WorkflowFactory.php
rename to database/factories/Auth/WorkflowFactory.php
index 5aac3699..8be286ea 100644
--- a/database/factories/WorkflowFactory.php
+++ b/database/factories/Auth/WorkflowFactory.php
@@ -1,12 +1,12 @@
 <?php
 
-namespace Database\Factories;
+namespace Database\Factories\Auth;
 
-use App\Models\Workflow;
+use App\Models\Auth\Workflow;
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @template TModel of \App\Models\Workflow
+ * @template TModel of \App\Models\Auth\Workflow
  *
  * @extends Factory<TModel>
  */
diff --git a/database/factories/WorkflowStepFactory.php b/database/factories/Auth/WorkflowStepFactory.php
similarity index 80%
rename from database/factories/WorkflowStepFactory.php
rename to database/factories/Auth/WorkflowStepFactory.php
index b6e850f3..3828c97b 100644
--- a/database/factories/WorkflowStepFactory.php
+++ b/database/factories/Auth/WorkflowStepFactory.php
@@ -1,12 +1,12 @@
 <?php
 
-namespace Database\Factories;
+namespace Database\Factories\Auth;
 
-use App\Models\WorkflowStep;
+use App\Models\Auth\WorkflowStep;
 use Illuminate\Database\Eloquent\Factories\Factory;
 
 /**
- * @template TModel of \App\Models\WorkflowStep
+ * @template TModel of \App\Models\Auth\WorkflowStep
  *
  * @extends Factory<TModel>
  */

From 15b86e9483bc0a54498bc9452ab3214f4ca3b631 Mon Sep 17 00:00:00 2001
From: drewroberts <24581081+drewroberts@users.noreply.github.com>
Date: Wed, 11 Mar 2026 22:49:29 +0000
Subject: [PATCH 19/21] Fix php code style issues

---
 app/Models/Auth/Application.php  | 3 ++-
 app/Models/Auth/Workflow.php     | 3 ++-
 app/Models/Auth/WorkflowStep.php | 3 ++-
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/app/Models/Auth/Application.php b/app/Models/Auth/Application.php
index 4760eb0d..0f2af87f 100644
--- a/app/Models/Auth/Application.php
+++ b/app/Models/Auth/Application.php
@@ -2,11 +2,12 @@
 
 namespace App\Models\Auth;
 
+use Database\Factories\Auth\ApplicationFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class Application extends Model
 {
-    /** @use HasFactory<\Database\Factories\Auth\ApplicationFactory> */
+    /** @use HasFactory<ApplicationFactory> */
     use HasFactory;
 }
diff --git a/app/Models/Auth/Workflow.php b/app/Models/Auth/Workflow.php
index 85d957e5..f173ecd5 100644
--- a/app/Models/Auth/Workflow.php
+++ b/app/Models/Auth/Workflow.php
@@ -2,11 +2,12 @@
 
 namespace App\Models\Auth;
 
+use Database\Factories\Auth\WorkflowFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class Workflow extends Model
 {
-    /** @use HasFactory<\Database\Factories\Auth\WorkflowFactory> */
+    /** @use HasFactory<WorkflowFactory> */
     use HasFactory;
 }
diff --git a/app/Models/Auth/WorkflowStep.php b/app/Models/Auth/WorkflowStep.php
index c3516d69..91e9fb19 100644
--- a/app/Models/Auth/WorkflowStep.php
+++ b/app/Models/Auth/WorkflowStep.php
@@ -2,11 +2,12 @@
 
 namespace App\Models\Auth;
 
+use Database\Factories\Auth\WorkflowStepFactory;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 
 class WorkflowStep extends Model
 {
-    /** @use HasFactory<\Database\Factories\Auth\WorkflowStepFactory> */
+    /** @use HasFactory<WorkflowStepFactory> */
     use HasFactory;
 }

From 89ac1128b9ec24f79def5a96f6f00f177f0c4c4b Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:51:40 -0400
Subject: [PATCH 20/21] Fix phpstan issue

---
 app/Http/Controllers/Api/V1/Auth/RegisterController.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/Http/Controllers/Api/V1/Auth/RegisterController.php b/app/Http/Controllers/Api/V1/Auth/RegisterController.php
index 2f9fb771..e31cfa15 100644
--- a/app/Http/Controllers/Api/V1/Auth/RegisterController.php
+++ b/app/Http/Controllers/Api/V1/Auth/RegisterController.php
@@ -32,7 +32,7 @@ public function __invoke(RegisterRequest $request): JsonResponse
 
         return response()->json([
             'message' => 'Registration successful. Please check your email to verify your account.',
-            'registration_id' => $registration->id,
+            'registration_id' => $registration->uuid,
         ], 201);
     }
 }

From af7d696f8b3a7ebe69f51f2bc5843a648441810d Mon Sep 17 00:00:00 2001
From: Drew Roberts <github@drewroberts.com>
Date: Wed, 11 Mar 2026 18:55:49 -0400
Subject: [PATCH 21/21] Draft spec doc for application workflow

---
 .../checklists/requirements.md                |  36 +++++++
 specs/009-registration-protocol/spec.md       | 100 ++++++++++++++++++
 2 files changed, 136 insertions(+)
 create mode 100644 specs/009-registration-protocol/checklists/requirements.md
 create mode 100644 specs/009-registration-protocol/spec.md

diff --git a/specs/009-registration-protocol/checklists/requirements.md b/specs/009-registration-protocol/checklists/requirements.md
new file mode 100644
index 00000000..23df91a0
--- /dev/null
+++ b/specs/009-registration-protocol/checklists/requirements.md
@@ -0,0 +1,36 @@
+# Specification Quality Checklist: W3RD-Compliant Registration Protocol
+
+**Purpose**: Validate specification completeness and quality before proceeding to planning
+**Created**: 2026-03-11
+**Feature**: [Link to spec.md](../spec.md)
+
+## Content Quality
+
+- [x] No implementation details (languages, frameworks, APIs)
+- [x] Focused on user value and business needs
+- [x] Written for non-technical stakeholders
+- [x] All mandatory sections completed
+
+## Requirement Completeness
+
+- [x] No [NEEDS CLARIFICATION] markers remain
+- [x] Requirements are testable and unambiguous
+- [x] Success criteria are measurable
+- [x] Success criteria are technology-agnostic (no implementation details)
+- [x] All acceptance scenarios are defined
+- [x] Edge cases are identified
+- [x] Scope is clearly bounded
+- [x] Dependencies and assumptions identified
+
+## Feature Readiness
+
+- [x] All functional requirements have clear acceptance criteria
+- [x] User scenarios cover primary flows
+- [x] Feature meets measurable outcomes defined in Success Criteria
+- [x] No implementation details leak into specification
+
+## Notes
+
+- Initial draft created from `docs/registration.md`.
+- No new branch created as per instruction.
+- Spec focuses on functional behavior (Deferred Identity, Workflow Engine) rather than specific Laravel implementation details, compliant with the "No implementation details" rule.
diff --git a/specs/009-registration-protocol/spec.md b/specs/009-registration-protocol/spec.md
new file mode 100644
index 00000000..59a90320
--- /dev/null
+++ b/specs/009-registration-protocol/spec.md
@@ -0,0 +1,100 @@
+# Feature Specification: W3RD-Compliant Registration Protocol
+
+**Feature Branch**: `009-registration-protocol`
+**Created**: 2026-03-11
+**Status**: Draft
+**Input**: Integrated from `docs/registration.md`
+
+## User Scenarios & Testing *(mandatory)*
+
+### User Story 1 - Applicant Registration (Priority: P1)
+
+As a new user (Applicant), I want to register for the platform through a step-by-step process so that I can gain access to the system.
+
+**Why this priority**: Core functionality; without this, no new users can be onboarded.
+
+**Independent Test**: Can be tested by simulating a new user entering an email and completing a multi-step form.
+
+**Acceptance Scenarios**:
+
+1. **Given** a new visitor on the registration page, **When** they enter their email, **Then** a "Deferred Identity" registration record is created (no User account yet).
+2. **Given** an active registration, **When** the applicant submits data for a step, **Then** the system validates the data and serves the next step in the workflow.
+3. **Given** all steps are completed successfully, **When** the final step is submitted, **Then** the registration is "graduated" and a real User account is created.
+
+### User Story 2 - Workflow Configuration (Priority: P2)
+
+As an Administrator, I want to define and modify registration workflows (blueprints) so that I can customize the onboarding experience for different types of users without code changes.
+
+**Why this priority**: Essential for the system's flexibility and multi-tenant/multi-use-case support.
+
+**Independent Test**: Can be tested by creating a new Workflow record with distinct steps and verifying the API serves them in order.
+
+**Acceptance Scenarios**:
+
+1. **Given** an administrator, **When** they define a new Workflow with specific steps, **Then** new registrations can be assigned to that workflow.
+2. **Given** a workflow with "Logic Rules" (e.g., skip step if Role=Vendor), **When** an applicant meets the criteria, **Then** the conditional step is skipped automatically.
+3. **Given** a workflow with "Risk Rules", **When** a registration request has a high risk score, **Then** a verification step (e.g., CAPTCHA) is dynamically injected.
+
+### User Story 3 - Session Restoration (Priority: P2)
+
+As an Applicant who got interrupted, I want to resume my registration from where I left off using a magic link so that I don't have to re-enter my information.
+
+**Why this priority**: Critical for conversion rates and user experience on multi-device journeys.
+
+**Independent Test**: Can be tested by requesting a magic link, opening it in a new browser, and verifying the state is restored.
+
+**Acceptance Scenarios**:
+
+1. **Given** an in-progress registration, **When** the user requests a "save for later" link, **Then** the system generates a secure, time-limited URL.
+2. **Given** a magic link, **When** the user clicks it on a different device, **Then** they are redirected to their current active step with previous data preserved.
+
+### User Story 4 - Team Invitations (Priority: P3)
+
+As an Applicant creating an Organization, I want to invite team members during my registration so that they can be onboarded immediately.
+
+**Why this priority**: Supports "land and expand" growth strategies but is secondary to the primary individual flow.
+
+**Independent Test**: Can be tested by populating the "invited_team" field during registration and verifying child registrations are created.
+
+**Acceptance Scenarios**:
+
+1. **Given** an applicant inviting colleagues, **When** the main registration submits the invitation list, **Then** the system creates "child" registrations for each invitee linked to the parent.
+2. **Given** a child registration, **When** the invitee starts their flow, **Then** they are pre-associated with the Organization being created.
+
+### Edge Cases
+
+- **Session Expiry**: What happens when a user returns to a registration after the `expires_at` timestamp? (System should require restarting or refreshing the session).
+- **Step Validation Failure**: How does the system handle invalid input on a specific step? (System returns the same step fragment with error messages inline).
+- **Concurrent Updates**: What happens if the workflow definition changes while a user is in the middle of it? (Versioning strategy ensures existing registrations continue on their original workflow ID).
+
+## Requirements *(mandatory)*
+
+### Functional Requirements
+
+- **FR-001**: System MUST support a "Deferred Identity" model where data is stored in a temporary `Registration` entity until all workflow requirements are met.
+- **FR-002**: System MUST utilize a "Workflow Engine" to determine the sequence of steps based on a predefined configuration.
+- **FR-003**: The Workflow Engine MUST support conditional "Logic Rules" to skip steps based on input data (e.g., Role selection).
+- **FR-004**: The Workflow Engine MUST support "Risk Rules" that dynamically inject verification steps based on external risk scores (e.g., IP reputation).
+- **FR-005**: System MUST provide a Hypermedia API (HATEOAS-like) where the response to a step submission includes the HTML fragment for the next step.
+- **FR-006**: System MUST encrypt sensitive `form_data` stored in the temporary registration record.
+- **FR-007**: System MUST support "Magic Link" generation to allow users to resume sessions across devices.
+- **FR-008**: System MUST track "Step Timings" (analytics) to measure how long users spend on each specific step.
+- **FR-009**: System MUST support a "Manual Review" state where the workflow pauses until an Admin approves the registration.
+- **FR-010**: System MUST support "Data Enrichment" steps that asynchronously query external providers to populate form data.
+- **FR-011**: Upon successful completion of all steps ("Graduation"), the system MUST atomically create the target User/Account records and archive the Registration.
+- **FR-012**: System MUST emit webhook events for key lifecycle stages (started, step_completed, abandoned, graduated).
+- **FR-013**: System MUST allow Clients to define custom themes (colors, fonts) which are injected as CSS variables into the API responses.
+
+### Key Entities
+
+- **Workflow**: A blueprint defining the sequence of steps, logic rules, and client association.
+- **WorkflowStep**: A distinct unit of the process (Form, Game, Content) with specific UI templates and validation rules.
+- **Registration**: A stateful, temporary record tracking an applicant's progress, accumulated data, and current status within a Workflow.
+- **Client**: The tenant or application consuming the registration protocol.
+
+## Success Criteria *(mandatory)*
+
+1.  **Flexibility**: Admins can reorder or add steps to a workflow configuration without requiring code deployments.
+2.  **Conversion Visibility**: System provides granular timing data for every step, allowing identification of drop-off points.
+3.  **Security**: No permanent User records are created for abandoned or rejected applications, keeping the main user table clean.
+4.  **Resilience**: Users can switch devices mid-registration without losing progress via secure magic links.