aigroup-workflow 2.1.2 → 2.2.1

package/skills/php-pro/SKILL.md

@@ -1,206 +0,0 @@
----
-name: php-pro
-description: Use when building PHP applications with modern PHP 8.3+ features, Laravel, or Symfony frameworks. Invokes strict typing, PHPStan level 9, async patterns with Swoole, and PSR standards. Creates controllers, configures middleware, generates migrations, writes PHPUnit/Pest tests, defines typed DTOs and value objects, sets up dependency injection, and scaffolds REST/GraphQL APIs. Use when working with Eloquent, Doctrine, Composer, Psalm, ReactPHP, or any PHP API development.
-license: MIT
-metadata:
-  author: https://github.com/Jeffallan
-  version: "1.1.0"
-  domain: language
-  triggers: PHP, Laravel, Symfony, Composer, PHPStan, PSR, PHP API, Eloquent, Doctrine
-  role: specialist
-  scope: implementation
-  output-format: code
-  related-skills: fullstack-guardian, fastapi-expert
----
-
-# PHP Pro
-
-Senior PHP developer with deep expertise in PHP 8.3+, Laravel, Symfony, and modern PHP patterns with strict typing and enterprise architecture.
-
-## Core Workflow
-
-1. **Analyze architecture** — Review framework, PHP version, dependencies, and patterns
-2. **Design models** — Create typed domain models, value objects, DTOs
-3. **Implement** — Write strict-typed code with PSR compliance, DI, repositories
-4. **Secure** — Add validation, authentication, XSS/SQL injection protection
-5. **Verify** — Run `vendor/bin/phpstan analyse --level=9`; fix all errors before proceeding. Run `vendor/bin/phpunit` or `vendor/bin/pest`; enforce 80%+ coverage. Only deliver when both pass clean.
-
-## Reference Guide
-
-Load detailed guidance based on context:
-
-| Topic | Reference | Load When |
-|-------|-----------|-----------|
-| Modern PHP | `references/modern-php-features.md` | Readonly, enums, attributes, fibers, types |
-| Laravel | `references/laravel-patterns.md` | Services, repositories, resources, jobs |
-| Symfony | `references/symfony-patterns.md` | DI, events, commands, voters |
-| Async PHP | `references/async-patterns.md` | Swoole, ReactPHP, fibers, streams |
-| Testing | `references/testing-quality.md` | PHPUnit, PHPStan, Pest, mocking |
-
-## Constraints
-
-### MUST DO
-- Declare strict types (`declare(strict_types=1)`)
-- Use type hints for all properties, parameters, returns
-- Follow PSR-12 coding standard
-- Run PHPStan level 9 before delivery
-- Use readonly properties where applicable
-- Write PHPDoc blocks for complex logic
-- Validate all user input with typed requests
-- Use dependency injection over global state
-
-### MUST NOT DO
-- Skip type declarations (no mixed types)
-- Store passwords in plain text (use bcrypt/argon2)
-- Write SQL queries vulnerable to injection
-- Mix business logic with controllers
-- Hardcode configuration (use .env)
-- Deploy without running tests and static analysis
-- Use var_dump in production code
-
-## Code Patterns
-
-Every complete implementation delivers: a typed entity/DTO, a service class, and a test. Use these as the baseline structure.
-
-### Readonly DTO / Value Object
-
-```php
-<?php
-
-declare(strict_types=1);
-
-namespace App\DTO;
-
-final readonly class CreateUserDTO
-{
-    public function __construct(
-        public string $name,
-        public string $email,
-        public string $password,
-    ) {}
-
-    public static function fromArray(array $data): self
-    {
-        return new self(
-            name: $data['name'],
-            email: $data['email'],
-            password: $data['password'],
-        );
-    }
-}
-```
-
-### Typed Service with Constructor DI
-
-```php
-<?php
-
-declare(strict_types=1);
-
-namespace App\Services;
-
-use App\DTO\CreateUserDTO;
-use App\Models\User;
-use App\Repositories\UserRepositoryInterface;
-use Illuminate\Support\Facades\Hash;
-
-final class UserService
-{
-    public function __construct(
-        private readonly UserRepositoryInterface $users,
-    ) {}
-
-    public function create(CreateUserDTO $dto): User
-    {
-        return $this->users->create([
-            'name'     => $dto->name,
-            'email'    => $dto->email,
-            'password' => Hash::make($dto->password),
-        ]);
-    }
-}
-```
-
-### PHPUnit Test Structure
-
-```php
-<?php
-
-declare(strict_types=1);
-
-namespace Tests\Unit\Services;
-
-use App\DTO\CreateUserDTO;
-use App\Models\User;
-use App\Repositories\UserRepositoryInterface;
-use App\Services\UserService;
-use PHPUnit\Framework\MockObject\MockObject;
-use PHPUnit\Framework\TestCase;
-
-final class UserServiceTest extends TestCase
-{
-    private UserRepositoryInterface&MockObject $users;
-    private UserService $service;
-
-    protected function setUp(): void
-    {
-        parent::setUp();
-        $this->users   = $this->createMock(UserRepositoryInterface::class);
-        $this->service = new UserService($this->users);
-    }
-
-    public function testCreateHashesPassword(): void
-    {
-        $dto  = new CreateUserDTO('Alice', 'alice@example.com', 'secret');
-        $user = new User(['name' => 'Alice', 'email' => 'alice@example.com']);
-
-        $this->users
-            ->expects($this->once())
-            ->method('create')
-            ->willReturn($user);
-
-        $result = $this->service->create($dto);
-
-        $this->assertSame('Alice', $result->name);
-    }
-}
-```
-
-### Enum (PHP 8.1+)
-
-```php
-<?php
-
-declare(strict_types=1);
-
-namespace App\Enums;
-
-enum UserStatus: string
-{
-    case Active   = 'active';
-    case Inactive = 'inactive';
-    case Banned   = 'banned';
-
-    public function label(): string
-    {
-        return match($this) {
-            self::Active   => 'Active',
-            self::Inactive => 'Inactive',
-            self::Banned   => 'Banned',
-        };
-    }
-}
-```
-
-## Output Templates
-
-When implementing a feature, deliver in this order:
-1. Domain models (entities, value objects, enums)
-2. Service/repository classes
-3. Controller/API endpoints
-4. Test files (PHPUnit/Pest)
-5. Brief explanation of architecture decisions
-
-## Knowledge Reference
-
-PHP 8.3+, Laravel 11, Symfony 7, Composer, PHPStan, Psalm, PHPUnit, Pest, Eloquent ORM, Doctrine, PSR standards, Swoole, ReactPHP, Redis, MySQL/PostgreSQL, REST/GraphQL APIs

package/skills/php-pro/references/async-patterns.md

@@ -1,412 +0,0 @@
-# Async PHP Patterns
-
-## Swoole HTTP Server
-
-```php
-<?php
-
-declare(strict_types=1);
-
-use Swoole\HTTP\Server;
-use Swoole\HTTP\Request;
-use Swoole\HTTP\Response;
-
-$server = new Server('0.0.0.0', 9501);
-
-$server->set([
-    'worker_num' => 4,
-    'max_request' => 10000,
-    'task_worker_num' => 2,
-    'enable_coroutine' => true,
-]);
-
-$server->on('start', function (Server $server) {
-    echo "Swoole HTTP server started at http://0.0.0.0:9501\n";
-});
-
-$server->on('request', function (Request $request, Response $response) {
-    $response->header('Content-Type', 'application/json');
-
-    match ($request->server['request_uri']) {
-        '/api/users' => handleUsers($request, $response),
-        '/api/health' => $response->end(json_encode(['status' => 'healthy'])),
-        default => $response->status(404)->end(json_encode(['error' => 'Not found'])),
-    };
-});
-
-function handleUsers(Request $request, Response $response): void
-{
-    // Coroutine for concurrent DB queries
-    go(function () use ($response) {
-        $users = queryDatabase('SELECT * FROM users LIMIT 10');
-        $response->end(json_encode(['data' => $users]));
-    });
-}
-
-$server->start();
-```
-
-## Swoole Coroutines
-
-```php
-<?php
-
-declare(strict_types=1);
-
-use Swoole\Coroutine;
-use Swoole\Coroutine\Http\Client;
-
-// Concurrent HTTP requests
-Coroutine\run(function () {
-    $results = [];
-
-    // Create multiple coroutines
-    $wg = new Coroutine\WaitGroup();
-
-    $urls = [
-        'https://api.example.com/users',
-        'https://api.example.com/posts',
-        'https://api.example.com/comments',
-    ];
-
-    foreach ($urls as $url) {
-        $wg->add();
-        go(function () use ($url, &$results, $wg) {
-            $client = new Client(parse_url($url, PHP_URL_HOST), 443, true);
-            $client->set(['timeout' => 5]);
-            $client->get(parse_url($url, PHP_URL_PATH));
-
-            $results[$url] = [
-                'status' => $client->statusCode,
-                'body' => $client->body,
-            ];
-
-            $client->close();
-            $wg->done();
-        });
-    }
-
-    $wg->wait();
-
-    print_r($results);
-});
-```
-
-## Swoole Async MySQL
-
-```php
-<?php
-
-declare(strict_types=1);
-
-use Swoole\Coroutine;
-use Swoole\Coroutine\MySQL;
-
-Coroutine\run(function () {
-    $mysql = new MySQL();
-
-    $connected = $mysql->connect([
-        'host' => '127.0.0.1',
-        'port' => 3306,
-        'user' => 'root',
-        'password' => 'password',
-        'database' => 'test',
-    ]);
-
-    if (!$connected) {
-        throw new \RuntimeException($mysql->connect_error);
-    }
-
-    // Async query
-    $result = $mysql->query('SELECT * FROM users WHERE active = 1');
-
-    foreach ($result as $row) {
-        echo "User: {$row['name']}\n";
-    }
-
-    // Prepared statements
-    $stmt = $mysql->prepare('SELECT * FROM users WHERE id = ?');
-    $stmt->execute([42]);
-    $user = $stmt->fetchAll();
-
-    $mysql->close();
-});
-```
-
-## Swoole Channel (Communication)
-
-```php
-<?php
-
-declare(strict_types=1);
-
-use Swoole\Coroutine;
-use Swoole\Coroutine\Channel;
-
-Coroutine\run(function () {
-    $channel = new Channel(10); // Buffer size: 10
-
-    // Producer
-    go(function () use ($channel) {
-        for ($i = 1; $i <= 5; $i++) {
-            $channel->push("Task {$i}");
-            echo "Produced: Task {$i}\n";
-            Coroutine::sleep(0.5);
-        }
-        $channel->close();
-    });
-
-    // Consumer
-    go(function () use ($channel) {
-        while (true) {
-            $task = $channel->pop();
-            if ($task === false && $channel->errCode === SWOOLE_CHANNEL_CLOSED) {
-                break;
-            }
-            echo "Consumed: {$task}\n";
-            Coroutine::sleep(1);
-        }
-    });
-});
-```
-
-## ReactPHP Event Loop
-
-```php
-<?php
-
-declare(strict_types=1);
-
-require 'vendor/autoload.php';
-
-use React\EventLoop\Loop;
-use React\Http\Message\Response;
-use Psr\Http\Message\ServerRequestInterface;
-
-// HTTP Server
-$server = new React\Http\HttpServer(function (ServerRequestInterface $request) {
-    return new Response(
-        200,
-        ['Content-Type' => 'application/json'],
-        json_encode([
-            'method' => $request->getMethod(),
-            'uri' => (string) $request->getUri(),
-            'timestamp' => time(),
-        ])
-    );
-});
-
-$socket = new React\Socket\SocketServer('0.0.0.0:8080');
-$server->listen($socket);
-
-echo "Server running at http://0.0.0.0:8080\n";
-
-// Periodic timer
-Loop::addPeriodicTimer(5.0, function () {
-    echo "Heartbeat: " . date('H:i:s') . "\n";
-});
-
-// One-time timer
-Loop::addTimer(10.0, function () {
-    echo "This runs once after 10 seconds\n";
-});
-```
-
-## ReactPHP Async MySQL
-
-```php
-<?php
-
-declare(strict_types=1);
-
-require 'vendor/autoload.php';
-
-use React\MySQL\Factory;
-use React\MySQL\QueryResult;
-
-$factory = new Factory();
-
-$connection = $factory->createLazyConnection('root:password@localhost/database');
-
-$connection->query('SELECT * FROM users WHERE active = 1')
-    ->then(
-        function (QueryResult $result) {
-            echo "Found " . count($result->resultRows) . " users\n";
-            foreach ($result->resultRows as $row) {
-                echo "User: {$row['name']}\n";
-            }
-        },
-        function (\Exception $error) {
-            echo "Error: " . $error->getMessage() . "\n";
-        }
-    );
-
-// Prepared statements
-$connection->query('SELECT * FROM users WHERE id = ?', [42])
-    ->then(function (QueryResult $result) {
-        $user = $result->resultRows[0] ?? null;
-        var_dump($user);
-    });
-```
-
-## ReactPHP Promises
-
-```php
-<?php
-
-declare(strict_types=1);
-
-use React\Promise\Promise;
-use React\Promise\Deferred;
-use function React\Promise\all;
-
-// Creating promises
-function fetchUser(int $id): Promise
-{
-    $deferred = new Deferred();
-
-    // Simulate async operation
-    Loop::addTimer(1.0, function () use ($deferred, $id) {
-        $deferred->resolve([
-            'id' => $id,
-            'name' => "User {$id}",
-        ]);
-    });
-
-    return $deferred->promise();
-}
-
-// Using promises
-fetchUser(42)
-    ->then(function ($user) {
-        echo "Got user: {$user['name']}\n";
-        return fetchUserPosts($user['id']);
-    })
-    ->then(function ($posts) {
-        echo "Got " . count($posts) . " posts\n";
-    })
-    ->catch(function (\Exception $error) {
-        echo "Error: " . $error->getMessage() . "\n";
-    });
-
-// Parallel promises
-all([
-    fetchUser(1),
-    fetchUser(2),
-    fetchUser(3),
-])->then(function ($users) {
-    echo "Fetched " . count($users) . " users\n";
-});
-```
-
-## PHP Fibers (Native PHP 8.1+)
-
-```php
-<?php
-
-declare(strict_types=1);
-
-// Simple async function using fibers
-function async(callable $callback): Fiber
-{
-    return new Fiber($callback);
-}
-
-function await(Fiber $fiber): mixed
-{
-    if (!$fiber->isStarted()) {
-        return $fiber->start();
-    }
-    if ($fiber->isTerminated()) {
-        return $fiber->getReturn();
-    }
-    return $fiber->resume();
-}
-
-// Simulate async I/O
-function fetchData(string $url): Fiber
-{
-    return async(function () use ($url) {
-        echo "Fetching: {$url}\n";
-        Fiber::suspend('pending');
-
-        // Simulate network delay
-        sleep(1);
-
-        return "Data from {$url}";
-    });
-}
-
-// Usage
-$fiber1 = fetchData('https://api.example.com/users');
-$fiber2 = fetchData('https://api.example.com/posts');
-
-await($fiber1);
-await($fiber2);
-
-$result1 = await($fiber1);
-$result2 = await($fiber2);
-
-echo "{$result1}\n";
-echo "{$result2}\n";
-```
-
-## Amphp Framework
-
-```php
-<?php
-
-declare(strict_types=1);
-
-require 'vendor/autoload.php';
-
-use Amp\Http\Server\HttpServer;
-use Amp\Http\Server\Request;
-use Amp\Http\Server\Response;
-use Amp\Http\Server\Router;
-use Amp\Socket\Server as SocketServer;
-use function Amp\async;
-use function Amp\Future\await;
-
-// HTTP Server with Amphp
-$router = new Router();
-
-$router->addRoute('GET', '/api/users', function (Request $request): Response {
-    // Concurrent database queries
-    $users = await([
-        async(fn() => queryUsers()),
-        async(fn() => queryUserStats()),
-    ]);
-
-    return new Response(
-        status: 200,
-        headers: ['content-type' => 'application/json'],
-        body: json_encode(['users' => $users[0], 'stats' => $users[1]]),
-    );
-});
-
-$server = new HttpServer(
-    servers: [SocketServer::listen('0.0.0.0:8080')],
-    requestHandler: $router,
-);
-
-$server->start();
-```
-
-## Quick Reference
-
-| Technology | Use Case | Performance |
-|------------|----------|-------------|
-| Swoole | High-performance servers, WebSockets | Very High |
-| ReactPHP | Event-driven apps, real-time | High |
-| Amphp | Modern async framework | High |
-| Fibers | Native async (PHP 8.1+) | Medium |
-| Generators | Simple async patterns | Medium |
-
-| Feature | Swoole | ReactPHP | Amphp |
-|---------|--------|----------|-------|
-| Coroutines | Yes | No (Promises) | Yes (Fibers) |
-| HTTP Server | Built-in | Via package | Via package |
-| WebSockets | Built-in | Via package | Via package |
-| Extension | Required | Not required | Not required |
-| Learning Curve | Medium | Low | Medium |