@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/ide/claude/.claude/commands/dare-laravel-api.md

@@ -1,211 +1,211 @@
-# /dare-laravel-api
-
-Padrões DARE para APIs REST em Laravel 11 + PHP 8.3. Strict Types, FormRequests, Services, Resources, Repositories, Eloquent + casts, tratamento global de exceções, testes Pest, PHPStan/Larastan nível 8.
-
-## Como usar
-
-```
-/dare-laravel-api                          # audita projeto Laravel
-/dare-laravel-api scaffold users           # gera CRUD com camadas
-/dare-laravel-api migrate-controllers      # extrai lógica de Controllers para Services
-```
-
-## Stack canônica
-
-- PHP 8.3 com `declare(strict_types=1);` em todo arquivo
-- Laravel 11.x modo API
-- PostgreSQL 16 ou MySQL 8
-- Pest para testes (ou PHPUnit 11)
-- PHPStan + Larastan nível 8
-- Pint para formatação
-- Sanctum para auth
-
-## Layered Design
-
-| Camada | Pasta Laravel |
-|---|---|
-| Handler | `app/Http/Controllers/` |
-| Service | `app/Services/` |
-| Repository | `app/Repositories/` |
-| Model | `app/Models/` |
-| Presenter | `app/Http/Resources/` |
-
-## Controllers (Handler)
-
-```php
-<?php declare(strict_types=1);
-
-namespace App\Http\Controllers;
-
-use App\Http\Requests\StoreUserRequest;
-use App\Http\Resources\UserResource;
-use App\Services\RegisterUser;
-
-final class UserApiController extends Controller
-{
-    public function __construct(private RegisterUser $service) {}
-
-    public function store(StoreUserRequest $request): UserResource
-    {
-        $user = $this->service->execute($request->validated());
-        return new UserResource($user);
-    }
-}
-```
-
-Regras:
-- Apenas: recebe → valida via FormRequest → chama Service → retorna Resource
-- NUNCA: query Eloquent, lógica de negócio, validação inline
-
-## FormRequests
-
-```php
-final class StoreUserRequest extends FormRequest
-{
-    public function authorize(): bool { return $this->user()->can('create', User::class); }
-
-    public function rules(): array {
-        return [
-            'email' => ['required', 'email', 'unique:users,email'],
-            'password' => ['required', 'string', 'min:12'],
-        ];
-    }
-}
-```
-
-## Services
-
-Uma operação por classe:
-
-```php
-final class RegisterUser
-{
-    public function __construct(private UserRepository $users) {}
-
-    public function execute(array $data): User
-    {
-        if ($this->users->existsByEmail($data['email'])) {
-            throw new UserAlreadyExistsException();
-        }
-        return $this->users->create([...$data, 'password' => Hash::make($data['password'])]);
-    }
-}
-```
-
-## Repositories
-
-```php
-final class UserRepository
-{
-    public function existsByEmail(string $email): bool {
-        return User::where('email', $email)->exists();
-    }
-    public function create(array $data): User {
-        return User::create($data);
-    }
-}
-```
-
-## Resources
-
-Nunca retorne Model direto:
-
-```php
-final class UserResource extends JsonResource
-{
-    public function toArray($request): array {
-        return [
-            'id' => $this->id,
-            'email' => $this->email,
-            'createdAt' => $this->created_at?->toIso8601String(),
-        ];
-    }
-}
-```
-
-## Exceções globais (`bootstrap/app.php`)
-
-```php
-->withExceptions(function (Exceptions $exceptions) {
-    $exceptions->render(fn (UserAlreadyExistsException $e) =>
-        response()->json(['error' => 'User exists', 'code' => 'USER_EXISTS'], 409));
-})
-```
-
-## Transações
-
-```php
-DB::transaction(function () use ($data) {
-    $user = User::create($data);
-    UserProfile::create([...]);
-});
-```
-
-## Testes Pest
-
-```php
-it('cria usuário com sucesso', function () {
-    $this->actingAs(User::factory()->admin()->create())
-         ->postJson('/api/users', ['email' => 'jane@example.com', 'name' => 'Jane', 'password' => 'longsecret123'])
-         ->assertCreated();
-});
-
-it('rejeita email duplicado', function () {
-    User::factory()->create(['email' => 'taken@example.com']);
-    $this->actingAs(User::factory()->admin()->create())
-         ->postJson('/api/users', ['email' => 'taken@example.com', ...])
-         ->assertStatus(409);
-});
-```
-
-Cobertura mínima por endpoint: 200/201, 422, 401/403, 404.
-
-## Antipatterns
-
-| AP | Antipattern | Correção |
-|---|---|---|
-| AP-01 | `$request->validate()` no Controller | FormRequest |
-| AP-02 | Query Eloquent no Controller | Repository |
-| AP-03 | Lógica no Controller | Service |
-| AP-04 | Retornar Model direto | JsonResource |
-| AP-05 | `$guarded = []` | `$fillable` explícito |
-| AP-06 | Sem `declare(strict_types=1)` | Adicionar no topo |
-| AP-07 | Múltiplas inserções sem transaction | `DB::transaction()` |
-| AP-08 | `bcrypt()` default cost | `Hash::make($pwd, ['rounds' => 12])` |
-
-## Validação no CI
-
-```bash
-./vendor/bin/phpstan analyse --level=8
-./vendor/bin/pint --test
-./vendor/bin/pest --coverage --min=80
-```
-
-## O que fazer
-
-1. Audit:
-   ```bash
-   grep -rn "request()->validate" app/Http/Controllers/
-   grep -rn "::where\|::find" app/Http/Controllers/
-   ./vendor/bin/phpstan analyse --level=8
-   ```
-2. Para cada `$request->validate(...)` → FormRequest com `php artisan make:request`
-3. Para cada Controller com lógica > 10 linhas → Service
-4. Para cada query Eloquent em Controller → Repository
-5. Substituir `return $user` por `return new UserResource($user)`
-6. Adicionar `declare(strict_types=1);` em todo arquivo
-
-## Segurança (combinar com `/dare-security`)
-
-- Hash com `Hash::make($pwd, ['rounds' => 12])` ou Argon2
-- Sanctum para SPA/mobile
-- `ThrottleRequests` middleware
-- Headers de segurança (HSTS, X-Frame, CSP) em middleware
-- CORS específico, nunca `*` em produção
-- `$fillable` SEMPRE, nunca `$guarded = []`
-
-$ARGUMENTS
-
----
-
-Skill MIT — parte do DARE Method.
+# /dare-laravel-api
+
+Padrões DARE para APIs REST em Laravel 11 + PHP 8.3. Strict Types, FormRequests, Services, Resources, Repositories, Eloquent + casts, tratamento global de exceções, testes Pest, PHPStan/Larastan nível 8.
+
+## Como usar
+
+```
+/dare-laravel-api                          # audita projeto Laravel
+/dare-laravel-api scaffold users           # gera CRUD com camadas
+/dare-laravel-api migrate-controllers      # extrai lógica de Controllers para Services
+```
+
+## Stack canônica
+
+- PHP 8.3 com `declare(strict_types=1);` em todo arquivo
+- Laravel 11.x modo API
+- PostgreSQL 16 ou MySQL 8
+- Pest para testes (ou PHPUnit 11)
+- PHPStan + Larastan nível 8
+- Pint para formatação
+- Sanctum para auth
+
+## Layered Design
+
+| Camada | Pasta Laravel |
+|---|---|
+| Handler | `app/Http/Controllers/` |
+| Service | `app/Services/` |
+| Repository | `app/Repositories/` |
+| Model | `app/Models/` |
+| Presenter | `app/Http/Resources/` |
+
+## Controllers (Handler)
+
+```php
+<?php declare(strict_types=1);
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreUserRequest;
+use App\Http\Resources\UserResource;
+use App\Services\RegisterUser;
+
+final class UserApiController extends Controller
+{
+    public function __construct(private RegisterUser $service) {}
+
+    public function store(StoreUserRequest $request): UserResource
+    {
+        $user = $this->service->execute($request->validated());
+        return new UserResource($user);
+    }
+}
+```
+
+Regras:
+- Apenas: recebe → valida via FormRequest → chama Service → retorna Resource
+- NUNCA: query Eloquent, lógica de negócio, validação inline
+
+## FormRequests
+
+```php
+final class StoreUserRequest extends FormRequest
+{
+    public function authorize(): bool { return $this->user()->can('create', User::class); }
+
+    public function rules(): array {
+        return [
+            'email' => ['required', 'email', 'unique:users,email'],
+            'password' => ['required', 'string', 'min:12'],
+        ];
+    }
+}
+```
+
+## Services
+
+Uma operação por classe:
+
+```php
+final class RegisterUser
+{
+    public function __construct(private UserRepository $users) {}
+
+    public function execute(array $data): User
+    {
+        if ($this->users->existsByEmail($data['email'])) {
+            throw new UserAlreadyExistsException();
+        }
+        return $this->users->create([...$data, 'password' => Hash::make($data['password'])]);
+    }
+}
+```
+
+## Repositories
+
+```php
+final class UserRepository
+{
+    public function existsByEmail(string $email): bool {
+        return User::where('email', $email)->exists();
+    }
+    public function create(array $data): User {
+        return User::create($data);
+    }
+}
+```
+
+## Resources
+
+Nunca retorne Model direto:
+
+```php
+final class UserResource extends JsonResource
+{
+    public function toArray($request): array {
+        return [
+            'id' => $this->id,
+            'email' => $this->email,
+            'createdAt' => $this->created_at?->toIso8601String(),
+        ];
+    }
+}
+```
+
+## Exceções globais (`bootstrap/app.php`)
+
+```php
+->withExceptions(function (Exceptions $exceptions) {
+    $exceptions->render(fn (UserAlreadyExistsException $e) =>
+        response()->json(['error' => 'User exists', 'code' => 'USER_EXISTS'], 409));
+})
+```
+
+## Transações
+
+```php
+DB::transaction(function () use ($data) {
+    $user = User::create($data);
+    UserProfile::create([...]);
+});
+```
+
+## Testes Pest
+
+```php
+it('cria usuário com sucesso', function () {
+    $this->actingAs(User::factory()->admin()->create())
+         ->postJson('/api/users', ['email' => 'jane@example.com', 'name' => 'Jane', 'password' => 'longsecret123'])
+         ->assertCreated();
+});
+
+it('rejeita email duplicado', function () {
+    User::factory()->create(['email' => 'taken@example.com']);
+    $this->actingAs(User::factory()->admin()->create())
+         ->postJson('/api/users', ['email' => 'taken@example.com', ...])
+         ->assertStatus(409);
+});
+```
+
+Cobertura mínima por endpoint: 200/201, 422, 401/403, 404.
+
+## Antipatterns
+
+| AP | Antipattern | Correção |
+|---|---|---|
+| AP-01 | `$request->validate()` no Controller | FormRequest |
+| AP-02 | Query Eloquent no Controller | Repository |
+| AP-03 | Lógica no Controller | Service |
+| AP-04 | Retornar Model direto | JsonResource |
+| AP-05 | `$guarded = []` | `$fillable` explícito |
+| AP-06 | Sem `declare(strict_types=1)` | Adicionar no topo |
+| AP-07 | Múltiplas inserções sem transaction | `DB::transaction()` |
+| AP-08 | `bcrypt()` default cost | `Hash::make($pwd, ['rounds' => 12])` |
+
+## Validação no CI
+
+```bash
+./vendor/bin/phpstan analyse --level=8
+./vendor/bin/pint --test
+./vendor/bin/pest --coverage --min=80
+```
+
+## O que fazer
+
+1. Audit:
+   ```bash
+   grep -rn "request()->validate" app/Http/Controllers/
+   grep -rn "::where\|::find" app/Http/Controllers/
+   ./vendor/bin/phpstan analyse --level=8
+   ```
+2. Para cada `$request->validate(...)` → FormRequest com `php artisan make:request`
+3. Para cada Controller com lógica > 10 linhas → Service
+4. Para cada query Eloquent em Controller → Repository
+5. Substituir `return $user` por `return new UserResource($user)`
+6. Adicionar `declare(strict_types=1);` em todo arquivo
+
+## Segurança (combinar com `/dare-security`)
+
+- Hash com `Hash::make($pwd, ['rounds' => 12])` ou Argon2
+- Sanctum para SPA/mobile
+- `ThrottleRequests` middleware
+- Headers de segurança (HSTS, X-Frame, CSP) em middleware
+- CORS específico, nunca `*` em produção
+- `$fillable` SEMPRE, nunca `$guarded = []`
+
+$ARGUMENTS
+
+---
+
+Skill MIT — parte do DARE Method.

package/templates/ide/claude/.claude/commands/dare-layered-design.md

@@ -1,124 +1,124 @@
-# /dare-layered-design
-
-Enforce arquitetura estrita de 4 camadas (Handlers, Services, Repositories, Models) em projetos DARE — independente de linguagem.
-
-## Como usar
-
-```
-/dare-layered-design                        # audita projeto atual
-/dare-layered-design lint                   # roda checks AP-01 a AP-06
-/dare-layered-design scaffold <recurso>     # gera CRUD com camadas corretas
-```
-
-## As 4 camadas
-
-```
-Handler  →  Service  →  Repository  →  Model
-(HTTP)      (negócio)   (I/O)         (domínio)
-```
-
-### Handler
-- Recebe request, valida input, chama um Service, retorna response
-- **Nunca** acessa Repository direto, **nunca** instancia Service com `new`
-
-### Service
-- Implementa uma operação de negócio (`RegisterUser`, `RefundPayment`)
-- Orquestra Repositories
-- **Nunca** sabe sobre HTTP, **nunca** faz SQL inline
-
-### Repository
-- Abstrai persistência (DB, cache, API externa)
-- Retorna Model ou primitivo
-- **Nunca** retorna HTTP status, **nunca** lança exceção de domínio
-
-### Model
-- Entidade pura do domínio
-- **Nunca** importa Repository/Service/Handler
-
-## Métricas obrigatórias
-
-| ID | Métrica |
-|---|---|
-| M-01 | 100% dos Services têm testes unitários (sem DB/HTTP real) |
-| M-02 | 0% de chamadas Handler→Repository direto |
-| M-03 | 100% dos Handlers usam injeção (sem `new Service()`) |
-| M-04 | 100% dos Repositories são agnósticos das camadas superiores |
-
-## Tabela por linguagem
-
-| Camada | Laravel | NestJS | FastAPI | Rails | Rust | Go |
-|---|---|---|---|---|---|---|
-| Handler | `Http/Controllers/` | `*.controller.ts` | `routers/` | `app/controllers/` | `handlers/` | `handlers/` |
-| Service | `Services/` | `*.service.ts` | `services/` | `app/services/` | `services/` | `services/` |
-| Repository | `Repositories/` | `*.repository.ts` | `repositories/` | `app/repositories/` | `repositories/` | `repositories/` |
-| Model | `Models/` | `entities/` | `models/` | `app/models/` | `domain/` | `models/` |
-
-## Antipatterns
-
-| AP | Antipattern | Sinal |
-|---|---|---|
-| AP-01 | Handler→Repository direto | `controller.repo.find()` |
-| AP-02 | Service com SQL inline | `db.query()` em Service |
-| AP-03 | Repository lança exceção de domínio | `throw UserNotFound` |
-| AP-04 | Model importa Service | acoplamento invertido |
-| AP-05 | God Service (>20 métodos) | `UserService.everything()` |
-| AP-06 | Fat Controller (>100 linhas) | lógica em Handler |
-
-## O que fazer
-
-### Passo 1: Mapear camadas existentes
-
-Liste as pastas atuais e classifique cada uma como Handler, Service, Repository, Model ou "indefinido". Indefinido = candidato a refactor.
-
-### Passo 2: Detectar violações com grep
-
-```bash
-# AP-01: Handler→Repository direto
-grep -rn "Repository" src/controllers/    # Laravel/NestJS
-grep -rn "Repository" app/controllers/    # Rails
-
-# AP-02: SQL inline em Service
-grep -rn "SELECT\\|INSERT\\|UPDATE\\|DELETE" src/services/
-
-# AP-03: Exceção de domínio em Repository
-grep -rn "throw.*NotFound\\|raise.*NotFound" src/repositories/
-```
-
-### Passo 3: Quebrar God Service
-
-Para cada Service com >20 métodos, separe em vários services nomeados por operação:
-- `UserService.register()` → `RegisterUser`
-- `UserService.resetPassword()` → `ResetPassword`
-- `UserService.delete()` → `DeleteUser`
-
-### Passo 4: Cobrir Services com testes unitários
-
-Service não depende de DB nem HTTP real — Repository é mockado:
-
-```typescript
-const repo = { findByEmail: jest.fn().mockResolvedValue({id: 1}) };
-const sut = new RegisterUserService(repo as any);
-await expect(sut.execute(...)).rejects.toThrow();
-```
-
-### Passo 5: Adicionar lint no CI
-
-```yaml
-- name: Layered design lint
-  run: |
-    grep -rn "Repository" src/controllers/ && exit 1 || true
-    grep -rn "new .*Service" src/controllers/ && exit 1 || true
-```
-
-## Saída esperada
-
-Reporte numerado por antipattern (AP-01 a AP-06):
-- Quantas violações por arquivo
-- Sugestão concreta de refactor para cada uma
-- Lista de Services sem cobertura unitária
-
-$ARGUMENTS
-
----
-
-Skill MIT — parte do DARE Method. Inspirado em "Layered Design for Ruby on Rails Applications" de Vladimir Dementyev (Evil Martians).
+# /dare-layered-design
+
+Enforce arquitetura estrita de 4 camadas (Handlers, Services, Repositories, Models) em projetos DARE — independente de linguagem.
+
+## Como usar
+
+```
+/dare-layered-design                        # audita projeto atual
+/dare-layered-design lint                   # roda checks AP-01 a AP-06
+/dare-layered-design scaffold <recurso>     # gera CRUD com camadas corretas
+```
+
+## As 4 camadas
+
+```
+Handler  →  Service  →  Repository  →  Model
+(HTTP)      (negócio)   (I/O)         (domínio)
+```
+
+### Handler
+- Recebe request, valida input, chama um Service, retorna response
+- **Nunca** acessa Repository direto, **nunca** instancia Service com `new`
+
+### Service
+- Implementa uma operação de negócio (`RegisterUser`, `RefundPayment`)
+- Orquestra Repositories
+- **Nunca** sabe sobre HTTP, **nunca** faz SQL inline
+
+### Repository
+- Abstrai persistência (DB, cache, API externa)
+- Retorna Model ou primitivo
+- **Nunca** retorna HTTP status, **nunca** lança exceção de domínio
+
+### Model
+- Entidade pura do domínio
+- **Nunca** importa Repository/Service/Handler
+
+## Métricas obrigatórias
+
+| ID | Métrica |
+|---|---|
+| M-01 | 100% dos Services têm testes unitários (sem DB/HTTP real) |
+| M-02 | 0% de chamadas Handler→Repository direto |
+| M-03 | 100% dos Handlers usam injeção (sem `new Service()`) |
+| M-04 | 100% dos Repositories são agnósticos das camadas superiores |
+
+## Tabela por linguagem
+
+| Camada | Laravel | NestJS | FastAPI | Rails | Rust | Go |
+|---|---|---|---|---|---|---|
+| Handler | `Http/Controllers/` | `*.controller.ts` | `routers/` | `app/controllers/` | `handlers/` | `handlers/` |
+| Service | `Services/` | `*.service.ts` | `services/` | `app/services/` | `services/` | `services/` |
+| Repository | `Repositories/` | `*.repository.ts` | `repositories/` | `app/repositories/` | `repositories/` | `repositories/` |
+| Model | `Models/` | `entities/` | `models/` | `app/models/` | `domain/` | `models/` |
+
+## Antipatterns
+
+| AP | Antipattern | Sinal |
+|---|---|---|
+| AP-01 | Handler→Repository direto | `controller.repo.find()` |
+| AP-02 | Service com SQL inline | `db.query()` em Service |
+| AP-03 | Repository lança exceção de domínio | `throw UserNotFound` |
+| AP-04 | Model importa Service | acoplamento invertido |
+| AP-05 | God Service (>20 métodos) | `UserService.everything()` |
+| AP-06 | Fat Controller (>100 linhas) | lógica em Handler |
+
+## O que fazer
+
+### Passo 1: Mapear camadas existentes
+
+Liste as pastas atuais e classifique cada uma como Handler, Service, Repository, Model ou "indefinido". Indefinido = candidato a refactor.
+
+### Passo 2: Detectar violações com grep
+
+```bash
+# AP-01: Handler→Repository direto
+grep -rn "Repository" src/controllers/    # Laravel/NestJS
+grep -rn "Repository" app/controllers/    # Rails
+
+# AP-02: SQL inline em Service
+grep -rn "SELECT\\|INSERT\\|UPDATE\\|DELETE" src/services/
+
+# AP-03: Exceção de domínio em Repository
+grep -rn "throw.*NotFound\\|raise.*NotFound" src/repositories/
+```
+
+### Passo 3: Quebrar God Service
+
+Para cada Service com >20 métodos, separe em vários services nomeados por operação:
+- `UserService.register()` → `RegisterUser`
+- `UserService.resetPassword()` → `ResetPassword`
+- `UserService.delete()` → `DeleteUser`
+
+### Passo 4: Cobrir Services com testes unitários
+
+Service não depende de DB nem HTTP real — Repository é mockado:
+
+```typescript
+const repo = { findByEmail: jest.fn().mockResolvedValue({id: 1}) };
+const sut = new RegisterUserService(repo as any);
+await expect(sut.execute(...)).rejects.toThrow();
+```
+
+### Passo 5: Adicionar lint no CI
+
+```yaml
+- name: Layered design lint
+  run: |
+    grep -rn "Repository" src/controllers/ && exit 1 || true
+    grep -rn "new .*Service" src/controllers/ && exit 1 || true
+```
+
+## Saída esperada
+
+Reporte numerado por antipattern (AP-01 a AP-06):
+- Quantas violações por arquivo
+- Sugestão concreta de refactor para cada uma
+- Lista de Services sem cobertura unitária
+
+$ARGUMENTS
+
+---
+
+Skill MIT — parte do DARE Method. Inspirado em "Layered Design for Ruby on Rails Applications" de Vladimir Dementyev (Evil Martians).