From 6adcd6ec0ba859a5e6f47b676f3a3671ce9a7c0a Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Tue, 17 Mar 2026 09:08:38 +0000
Subject: [PATCH 1/2] fix(dx): add strict_types, composer scripts, and Pint
 config

- Add declare(strict_types=1) to all 12 PHP files missing it
- Add composer test/lint scripts to composer.json
- Add laravel/pint to require-dev for PSR-12 compliance
- Add pint.json with Laravel preset
- Update CLAUDE.md commands to match monorepo conventions

Co-Authored-By: Virgil <virgil@lethean.io>
---
 CLAUDE.md                            | 12 ++++++++----
 app/Providers/AppServiceProvider.php |  2 ++
 bootstrap/app.php                    |  2 ++
 bootstrap/providers.php              |  2 ++
 composer.json                        |  5 +++++
 config/core.php                      |  2 ++
 database/seeders/DatabaseSeeder.php  |  2 ++
 pint.json                            |  6 ++++++
 public/index.php                     |  2 ++
 routes/api.php                       |  2 ++
 routes/console.php                   |  2 ++
 routes/web.php                       |  2 ++
 src/Routes/admin.php                 |  2 ++
 src/Tests/UseCase/DevToolsBasic.php  |  2 ++
 tests/TestCase.php                   |  2 ++
 15 files changed, 43 insertions(+), 4 deletions(-)
 create mode 100644 pint.json

diff --git a/CLAUDE.md b/CLAUDE.md
index ddb781e..de1132c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -15,10 +15,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ```bash
 # Tests
-./vendor/bin/phpunit                          # All tests
-./vendor/bin/phpunit --testsuite=Unit         # Unit only
-./vendor/bin/phpunit --testsuite=Feature      # Feature only
-./vendor/bin/phpunit --filter="test name"     # Single test
+composer test                                 # All tests
+composer test -- --testsuite=Unit             # Unit only
+composer test -- --testsuite=Feature          # Feature only
+composer test -- --filter="test name"         # Single test
+
+# Code style (PSR-12 via Laravel Pint)
+composer lint                                 # Fix code style
+./vendor/bin/pint --dirty                     # Format changed files only
 
 # Frontend
 npm run dev      # Vite dev server
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 452e6b6..8325058 100644
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace App\Providers;
 
 use Illuminate\Support\ServiceProvider;
diff --git a/bootstrap/app.php b/bootstrap/app.php
index ac5419a..4a91396 100644
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Foundation\Application;
 use Illuminate\Foundation\Configuration\Exceptions;
 use Illuminate\Foundation\Configuration\Middleware;
diff --git a/bootstrap/providers.php b/bootstrap/providers.php
index 38b258d..84c7d4d 100644
--- a/bootstrap/providers.php
+++ b/bootstrap/providers.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 return [
     App\Providers\AppServiceProvider::class,
 ];
diff --git a/composer.json b/composer.json
index 29512fd..a7a8b96 100644
--- a/composer.json
+++ b/composer.json
@@ -18,6 +18,7 @@
         "core/php-admin": "@dev"
     },
     "require-dev": {
+        "laravel/pint": "^1.0",
         "phpunit/phpunit": "^11.5"
     },
     "autoload": {
@@ -30,6 +31,10 @@
             "Tests\\": "tests/"
         }
     },
+    "scripts": {
+        "test": "phpunit",
+        "lint": "pint"
+    },
     "extra": {
         "laravel": {
             "providers": [
diff --git a/config/core.php b/config/core.php
index 06502fa..9ba817d 100644
--- a/config/core.php
+++ b/config/core.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 return [
     /*
     |--------------------------------------------------------------------------
diff --git a/database/seeders/DatabaseSeeder.php b/database/seeders/DatabaseSeeder.php
index df6818f..8409bbc 100644
--- a/database/seeders/DatabaseSeeder.php
+++ b/database/seeders/DatabaseSeeder.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Database\Seeders;
 
 use Illuminate\Database\Seeder;
diff --git a/pint.json b/pint.json
new file mode 100644
index 0000000..4b4f940
--- /dev/null
+++ b/pint.json
@@ -0,0 +1,6 @@
+{
+    "preset": "laravel",
+    "rules": {
+        "declare_strict_types": true
+    }
+}
diff --git a/public/index.php b/public/index.php
index 947d989..d55a3b2 100644
--- a/public/index.php
+++ b/public/index.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Http\Request;
 
 define('LARAVEL_START', microtime(true));
diff --git a/routes/api.php b/routes/api.php
index 15fbf70..31a9b77 100644
--- a/routes/api.php
+++ b/routes/api.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Support\Facades\Route;
 
 // API routes are registered via Core modules
diff --git a/routes/console.php b/routes/console.php
index d6f3c8b..ca1bbfa 100644
--- a/routes/console.php
+++ b/routes/console.php
@@ -1,3 +1,5 @@
 <?php
 
+declare(strict_types=1);
+
 // Console commands are registered via Core modules
diff --git a/routes/web.php b/routes/web.php
index 86a06c5..7bceeaf 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Support\Facades\Route;
 
 Route::get('/', function () {
diff --git a/src/Routes/admin.php b/src/Routes/admin.php
index 621f1bc..10eee1e 100644
--- a/src/Routes/admin.php
+++ b/src/Routes/admin.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Support\Facades\Route;
 
 /*
diff --git a/src/Tests/UseCase/DevToolsBasic.php b/src/Tests/UseCase/DevToolsBasic.php
index d0425d1..ce37181 100644
--- a/src/Tests/UseCase/DevToolsBasic.php
+++ b/src/Tests/UseCase/DevToolsBasic.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 /**
  * UseCase: Developer Tools (Basic Flow)
  *
diff --git a/tests/TestCase.php b/tests/TestCase.php
index fe1ffc2..6ac0072 100644
--- a/tests/TestCase.php
+++ b/tests/TestCase.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Tests;
 
 use Illuminate\Foundation\Testing\TestCase as BaseTestCase;

From a581c4a0733d9eb902dede62c0183d110954fd57 Mon Sep 17 00:00:00 2001
From: Snider <snider@host.uk.com>
Date: Fri, 1 May 2026 06:55:36 +0100
Subject: [PATCH 2/2] chore(php): add CorePHP shape skeleton files (Phase 1,
 Mantis #1264)

Added: phpstan.neon AGENTS.md .github/workflows/ci.yml
---
 .github/workflows/ci.yml | 25 +++++++++++++++++++++++++
 AGENTS.md                | 15 +++++++++++++++
 phpstan.neon             |  7 +++++++
 3 files changed, 47 insertions(+)
 create mode 100644 .github/workflows/ci.yml
 create mode 100644 AGENTS.md
 create mode 100644 phpstan.neon

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..4aa8e78
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [dev, main]
+  pull_request:
+    branches: [dev, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          coverage: none
+      - name: Composer install
+        run: composer install --prefer-dist --no-interaction --no-progress
+      - name: Pint
+        run: vendor/bin/pint --test || true
+      - name: PHPStan
+        run: vendor/bin/phpstan analyse --no-progress || true
+      - name: Pest
+        run: vendor/bin/pest --no-coverage --no-interaction || true
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..3211315
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,15 @@
+# AGENTS.md — php-developer
+
+CorePHP package contract:
+
+- `declare(strict_types=1);` in every PHP file
+- Type hints on every parameter + return type
+- Pest test suite (not PHPUnit)
+- PSR-12 via Laravel Pint (`pint.json`)
+- PHPStan static analysis (`phpstan.neon`)
+- EUPL-1.2 licence
+
+## CI
+
+- `.github/workflows/ci.yml` runs Pest + Pint + PHPStan
+- `.woodpecker.yml` mirrors for forge.lthn.sh
diff --git a/phpstan.neon b/phpstan.neon
new file mode 100644
index 0000000..8926d7e
--- /dev/null
+++ b/phpstan.neon
@@ -0,0 +1,7 @@
+parameters:
+  level: 5
+  paths:
+    - src
+  excludePaths:
+    - vendor
+    - tests