chore(php): CorePHP shape skeleton (Phase 1, Mantis #1264)

.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

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

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

app/Providers/AppServiceProvider.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace App\Providers;
 
 use Illuminate\Support\ServiceProvider;

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;

bootstrap/providers.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 return [
     App\Providers\AppServiceProvider::class,
 ];

composer.json

@@ -18,6 +18,7 @@
         "lthn/php-admin": "*"
     },
     "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": [

config/core.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 return [
     /*
     |--------------------------------------------------------------------------

database/seeders/DatabaseSeeder.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Database\Seeders;
 
 use Illuminate\Database\Seeder;

phpstan.neon

@@ -0,0 +1,7 @@
+parameters:
+  level: 5
+  paths:
+    - src
+  excludePaths:
+    - vendor
+    - tests

pint.json

@@ -0,0 +1,6 @@
+{
+    "preset": "laravel",
+    "rules": {
+        "declare_strict_types": true
+    }
+}

public/index.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Http\Request;
 
 define('LARAVEL_START', microtime(true));

routes/api.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Support\Facades\Route;
 
 // API routes are registered via Core modules

routes/console.php

@@ -1,3 +1,5 @@
 <?php
 
+declare(strict_types=1);
+
 // Console commands are registered via Core modules

routes/web.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Support\Facades\Route;
 
 Route::get('/', function () {

src/Routes/admin.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 use Illuminate\Support\Facades\Route;
 
 /*

src/Tests/UseCase/DevToolsBasic.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 /**
  * UseCase: Developer Tools (Basic Flow)
  *

tests/TestCase.php

@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Tests;
 
 use Illuminate\Foundation\Testing\TestCase as BaseTestCase;