@thiagodiogo/pscode 1.0.0 → 1.0.1

package/pscode/content/dixi/claude-runtime/skills/pstld-arch-guardian.md

@@ -0,0 +1,101 @@
+# pstld-arch-guardian
+
+## Trigger
+
+Esta skill é auto-invocada **antes de aplicar uma edição** em arquivos que se enquadrem em:
+
+- Java: `src/**/infrastructure/**`
+- React/Next: `src/features/**`, `src/app/**`, `src/pages/**`
+
+---
+
+## Comportamento
+
+### 1. Detectar stack do projeto
+
+Leia `.pscode-dixi.yaml` na raiz do projeto e extraia o campo `family`.
+
+- Se o arquivo **não existir** ou `family` for `null` ou não reconhecido → **não faça nenhuma verificação**, prossiga normalmente.
+- Se `family: java` → aplique verificação hexagonal (seção 2).
+- Se `family: react` → aplique verificação feature-sliced (seção 3).
+
+---
+
+### 2. Verificação hexagonal (Java)
+
+Aplicável quando `family: java` e o arquivo editado está em `src/**/infrastructure/**`.
+
+**Bloqueio — import direto de domain sem porta:**
+
+Verifique se o novo conteúdo do arquivo contém imports de pacotes como:
+- `import ...domain.model.*`
+- `import ...domain.entity.*`
+- `import ...domain.service.*`
+
+...sem passar por uma interface de porta (`domain.port.in.*` ou `domain.port.out.*`).
+
+Se detectar esta violação:
+
+> ❌ **Violação hexagonal detectada**
+>
+> O arquivo `[caminho do arquivo]` importa diretamente de `domain/` sem usar uma porta.
+> A regra de dependência exige que `infrastructure` acesse `domain` apenas via interfaces de porta.
+>
+> Consulte `pastelsdd/context/architecture.md` para a lista de imports permitidos.
+>
+> **A edição foi bloqueada.** Refatore para usar a porta adequada antes de continuar.
+
+**Permitido — import via porta:**
+
+Se o arquivo importa apenas de `domain.port.in.*` ou `domain.port.out.*`, permita a edição sem mensagem.
+
+**Fora de infrastructure:**
+
+Se o arquivo não está em `src/**/infrastructure/**`, não aplique nenhuma verificação hexagonal.
+
+---
+
+### 3. Verificação feature-sliced (React/Next)
+
+Aplicável quando `family: react`.
+
+#### 3a. Import cruzado entre features (bloqueio)
+
+Se o arquivo editado está em `src/features/<feature-a>/` e o novo conteúdo importa de outro diretório sob `src/features/` (ex: `../feature-b/`, `../../features/feature-b/`):
+
+> ❌ **Violação feature-sliced detectada**
+>
+> O arquivo `[caminho]` importa de outra feature (`[feature-b]`).
+> Features devem ser independentes entre si — imports cruzados criam acoplamento proibido.
+>
+> Use `src/shared/` para código reutilizado entre features.
+> Consulte `pastelsdd/context/architecture.md`.
+>
+> **A edição foi bloqueada.**
+
+**Permitido:** imports dentro da mesma feature ou de `src/shared/`.
+
+#### 3b. Lógica de negócio inline em páginas (warning)
+
+Se o arquivo editado está em `src/app/**` ou `src/pages/**` e o novo conteúdo contém qualquer um dos sinais abaixo:
+- Hook `useState` + `useEffect` com corpo de mais de 10 linhas no mesmo componente
+- Função de transformação/validação de dados definida inline no componente (não em hook separado)
+
+Emita aviso (não bloqueie):
+
+> ⚠️ **Atenção — lógica de negócio em página detectada**
+>
+> O componente em `[caminho]` parece conter lógica de negócio inline.
+> Considere extrair para um custom hook em `src/features/` ou `src/shared/hooks/`.
+>
+> Consulte `pastelsdd/context/architecture.md` para o padrão recomendado.
+>
+> A edição foi aplicada, mas revise antes de finalizar.
+
+---
+
+## Comportamento seguro
+
+- Se `.pscode-dixi.yaml` não existe → nenhuma ação, nenhum erro.
+- Se `family` tem valor desconhecido → nenhuma ação.
+- Em nenhuma hipótese esta skill modifica arquivos fora do arquivo-alvo da edição original.

package/pscode/content/dixi/claude-runtime/skills/pstld-commit-crafter.md

@@ -0,0 +1,98 @@
+# pstld-commit-crafter
+
+## Trigger
+
+Esta skill é auto-invocada quando o usuário mencionar **commit** no prompt ou solicitar fazer commit:
+
+- "commit", "fazer commit", "commitar", "cria um commit", "faz o commit", "git commit"
+
+Ative **antes** de executar qualquer `git commit`.
+
+---
+
+## Comportamento
+
+### 1. Detectar stack para inferência de escopo
+
+Leia `.pscode-dixi.yaml` na raiz do projeto e extraia `family`.
+
+**Se `family: java`:**
+- Inspecione os arquivos modificados via `git status` / `git diff --name-only`.
+- Identifique o bounded context pelo diretório após o base package.
+  - Ex: `src/main/java/com/empresa/payment/` → escopo `payment`
+  - Ex: `src/main/java/com/empresa/order/domain/` → escopo `order`
+
+**Se `family: react`:**
+- Identifique o nome da feature pelo diretório em `src/features/`.
+  - Ex: `src/features/user-management/` → escopo `user-management`
+  - Ex: `src/features/checkout/` → escopo `checkout`
+
+**Se `.pscode-dixi.yaml` não existir ou `family` for `null`:**
+- Infira o escopo pelo diretório principal dos arquivos modificados.
+  - Ex: maioria em `src/services/billing/` → escopo `billing`
+  - Ex: maioria em `src/` → escopo do módulo mais frequente nos caminhos
+
+---
+
+### 2. Verificar ticket JIRA
+
+Leia `pastelsdd/jira.yaml` na raiz do projeto.
+
+- Se o arquivo **não existir** ou tiver `configured: false`: mensagem sem ticket JIRA (vá para seção 3).
+- Se tiver `project_key` configurado: o ticket **é obrigatório**.
+
+**Ticket presente no prompt:** use diretamente (ex: usuário mencionou "PROJ-42").
+
+**Ticket ausente no prompt:** pergunte ao usuário:
+
+> Qual o número do ticket JIRA? (ex: 42)
+> O project key configurado é `[PROJECT_KEY]`.
+
+Aguarde a resposta antes de continuar. Monte o sufixo `[PROJECT_KEY-NNN]` com o número fornecido.
+
+---
+
+### 3. Montar a mensagem de commit
+
+Identifique o tipo baseado nos arquivos modificados e no contexto:
+
+| Tipo | Quando usar |
+|------|-------------|
+| `feat` | nova funcionalidade |
+| `fix` | correção de bug |
+| `refactor` | mudança sem alterar comportamento |
+| `test` | adição/correção de testes |
+| `docs` | documentação apenas |
+| `chore` | configuração, build, dependências |
+
+Gere a mensagem no formato:
+
+```
+tipo(escopo): descrição concisa em português ou inglês [PROJECT_KEY-NNN]
+```
+
+Sem ticket quando `pastelsdd/jira.yaml` não configurado:
+
+```
+tipo(escopo): descrição concisa
+```
+
+**Exemplos:**
+- `feat(payment): adiciona validação de cartão de crédito [PROJ-99]`
+- `fix(user-management): corrige redirect após logout [APP-12]`
+- `refactor(order): extrai lógica de cálculo para OrderPricingService [PROJ-55]`
+- `test(checkout): cobre cenário de pedido sem estoque [SHOP-7]`
+
+---
+
+### 4. Apresentar a mensagem ao usuário
+
+Exiba a mensagem proposta e pergunte:
+
+> Mensagem de commit proposta:
+> ```
+> tipo(escopo): descrição [PROJECT_KEY-NNN]
+> ```
+> Deseja usar esta mensagem ou ajustar?
+
+Se o usuário aprovar, execute o commit. Se quiser ajustar, aplique a correção e confirme novamente.

package/pscode/content/dixi/claude-runtime/skills/pstld-jira-context.md

@@ -0,0 +1,64 @@
+# pstld-jira-context
+
+## Trigger
+
+Esta skill é auto-invocada quando o prompt do usuário contém uma string no formato `[A-Z]+-\d+`:
+
+- Exemplos: `PROJ-123`, `MYAPP-42`, `BE-7`, `PAYMENT-1001`
+- A ativação ocorre **antes de gerar a resposta**, para enriquecer o contexto.
+
+Se o prompt não contém nenhum padrão `[A-Z]+-\d+`, a skill não é ativada.
+
+---
+
+## Comportamento
+
+### 1. Verificar configuração JIRA
+
+Leia `pastelsdd/jira.yaml` na raiz do projeto.
+
+**Se o arquivo não existir ou tiver `configured: false`:**
+
+Exiba o seguinte aviso **uma única vez por sessão** (não repita em prompts subsequentes):
+
+> ℹ️ Integração JIRA não configurada — edite `pastelsdd/jira.yaml` para habilitar.
+
+Prossiga sem buscar contexto do ticket.
+
+**Se tiver `configured: true`:** continue para a seção 2.
+
+---
+
+### 2. Buscar contexto do ticket via MCP
+
+Use a ferramenta `mcp__atlassian__getJiraIssue` com a chave detectada no prompt (ex: `PROJ-123`).
+
+**Se o ticket for encontrado**, injete as seguintes informações como contexto adicional **antes** de gerar a resposta:
+
+> **Contexto JIRA — [CHAVE]**
+>
+> **Título:** [título do ticket]
+>
+> **Descrição:**
+> [descrição do ticket]
+>
+> **Critérios de aceite:**
+> [critérios de aceite, se disponíveis]
+
+Em seguida, prossiga normalmente para responder ao prompt do usuário.
+
+---
+
+### 3. Tratamento de erro
+
+**Se `mcp__atlassian__getJiraIssue` retornar erro** (ticket inexistente, permissão negada, MCP indisponível):
+
+> ⚠️ Não foi possível obter contexto de `[CHAVE]`: [mensagem de erro resumida]. Prosseguindo sem contexto JIRA.
+
+Não bloqueie a resposta — prossiga normalmente.
+
+---
+
+## Controle de sessão
+
+O aviso "Integração JIRA não configurada" deve ser exibido **no máximo uma vez por sessão**. Se já foi exibido, omita-o em ativações subsequentes e prossiga em silêncio.

package/pscode/content/dixi/context/java/architecture.md

@@ -0,0 +1,143 @@
+# Arquitetura — Java/Spring (Hexagonal)
+
+## Estrutura de pacotes obrigatória
+
+```
+com.example.app/
+├── domain/
+│   ├── model/          # Entidades, value objects, agregados
+│   ├── port/
+│   │   ├── in/         # Use case interfaces (portas de entrada)
+│   │   └── out/        # Repository, gateway interfaces (portas de saída)
+│   └── exception/      # Exceções de domínio
+├── application/
+│   └── usecase/        # Implementações dos use cases
+└── infrastructure/
+    └── adapter/
+        ├── in/         # Controllers REST, consumers de mensagem
+        └── out/        # Implementations de repository, clientes HTTP
+```
+
+## Regras de dependência
+
+```
+infrastructure → application → domain
+```
+
+- `domain` não importa nada externo ao próprio domínio
+- `application` importa apenas `domain`
+- `infrastructure` importa `application` e `domain`, mas nunca ao contrário
+- Frameworks Spring (anotações, contexto) pertencem à camada `infrastructure`
+
+## Exemplos por camada
+
+### Domain — modelo
+
+```java
+// domain/model/Pedido.java
+public class Pedido {
+    private final PedidoId id;
+    private final List<ItemPedido> itens;
+    private StatusPedido status;
+
+    public void confirmar() {
+        if (itens.isEmpty()) throw new PedidoVazioException();
+        this.status = StatusPedido.CONFIRMADO;
+    }
+}
+```
+
+### Domain — porta de entrada
+
+```java
+// domain/port/in/ConfirmarPedidoUseCase.java
+public interface ConfirmarPedidoUseCase {
+    Pedido confirmar(PedidoId pedidoId);
+}
+```
+
+### Domain — porta de saída
+
+```java
+// domain/port/out/PedidoRepository.java
+public interface PedidoRepository {
+    Optional<Pedido> findById(PedidoId id);
+    Pedido save(Pedido pedido);
+}
+```
+
+### Application — use case
+
+```java
+// application/usecase/ConfirmarPedidoService.java
+@Service
+public class ConfirmarPedidoService implements ConfirmarPedidoUseCase {
+    private final PedidoRepository repository;
+
+    @Override
+    public Pedido confirmar(PedidoId pedidoId) {
+        Pedido pedido = repository.findById(pedidoId)
+            .orElseThrow(() -> new PedidoNaoEncontradoException(pedidoId));
+        pedido.confirmar();
+        return repository.save(pedido);
+    }
+}
+```
+
+### Infrastructure — adapter de entrada
+
+```java
+// infrastructure/adapter/in/PedidoController.java
+@RestController
+@RequestMapping("/pedidos")
+public class PedidoController {
+    private final ConfirmarPedidoUseCase confirmarPedido;
+
+    @PostMapping("/{id}/confirmar")
+    public ResponseEntity<PedidoResponse> confirmar(@PathVariable String id) {
+        Pedido pedido = confirmarPedido.confirmar(new PedidoId(id));
+        return ResponseEntity.ok(PedidoMapper.toResponse(pedido));
+    }
+}
+```
+
+### Infrastructure — adapter de saída
+
+```java
+// infrastructure/adapter/out/PedidoJpaRepository.java
+@Repository
+public class PedidoJpaRepository implements PedidoRepository {
+    private final PedidoJpaEntityRepository jpa;
+
+    @Override
+    public Optional<Pedido> findById(PedidoId id) {
+        return jpa.findById(id.value()).map(PedidoMapper::toDomain);
+    }
+}
+```
+
+## Regras adicionais
+
+- **Sem lógica de negócio em controllers ou repositories** — toda regra de negócio fica em `domain` ou `application`
+- **Entidades de domínio são imutáveis por padrão** — use construtores e métodos explícitos, evite setters
+- **Mappers** ficam em `infrastructure` para converter entre entidades de domínio e entidades JPA/DTOs
+- **Anotações Spring** (`@Service`, `@Repository`, `@RestController`) pertencem à infraestrutura, não ao domínio
+
+## Skeleton e guardrails automáticos (profile dixi)
+
+`pscode init --profile dixi` cria automaticamente o skeleton de pastas hexagonal com `.gitkeep` em cada diretório e gera `src/test/java/{basePackage}/ArchitectureTest.java` com três regras ArchUnit pré-configuradas:
+
+1. `domain` não depende de `infrastructure`
+2. `application` não depende de `infrastructure`
+3. `infrastructure.adapter.in` não depende de `infrastructure.adapter.out`
+
+O `basePackage` é detectado automaticamente do `pom.xml` (`groupId` + `artifactId` sem hífens). Adicione a dependência ArchUnit ao `pom.xml` para ativar as verificações:
+
+```xml
+<dependency>
+  <groupId>com.tngtech.archunit</groupId>
+  <artifactId>archunit-junit5</artifactId>
+  <version>1.3.0</version>
+  <scope>test</scope>
+</dependency>
+```

package/pscode/content/dixi/context/java/naming.md

@@ -0,0 +1,62 @@
+# Convenções de Nomenclatura — Java/Spring
+
+## Regra geral
+
+O nome deve revelar o papel da classe na arquitetura hexagonal. Evite sufixos técnicos no domínio; use sufixos técnicos apenas na infraestrutura.
+
+## Domain
+
+Substantivos sem sufixo técnico. Nomes de negócio, não de tecnologia.
+
+| Tipo             | Padrão               | Exemplos válidos                       | Inválidos                          |
+|------------------|----------------------|----------------------------------------|------------------------------------|
+| Entidade         | `NomeDominio`        | `Pedido`, `Usuario`, `Produto`         | `PedidoEntity`, `UsuarioModel`     |
+| Value Object     | `NomeDominio`        | `Email`, `CPF`, `PedidoId`             | `EmailVO`, `CPFValue`              |
+| Exceção domínio  | `Motivo + Exception` | `PedidoVazioException`, `SaldoInsuficienteException` | `PedidoError`, `InvalidPedido` |
+| Porta de entrada | `Verbo + UseCase`    | `ConfirmarPedidoUseCase`, `BuscarUsuarioUseCase` | `PedidoService`, `PedidoPort` |
+| Porta de saída   | `NomeDominio + Repository/Gateway` | `PedidoRepository`, `NotificacaoGateway` | `IPedidoRepo`, `PedidoDAO` |
+
+## Application
+
+Implementações dos use cases. Verbo + sufixo `Service`.
+
+| Tipo        | Padrão              | Exemplos válidos                          | Inválidos                        |
+|-------------|---------------------|-------------------------------------------|----------------------------------|
+| Use Case impl | `Verbo + Service` | `ConfirmarPedidoService`, `CadastrarUsuarioService` | `PedidoServiceImpl`, `OrderManager` |
+
+## Infrastructure
+
+Sufixos técnicos que revelam o mecanismo de implementação.
+
+| Tipo                   | Padrão                    | Exemplos válidos                              |
+|------------------------|---------------------------|-----------------------------------------------|
+| Controller REST        | `Dominio + Controller`    | `PedidoController`, `UsuarioController`       |
+| JPA Entity             | `Dominio + JpaEntity`     | `PedidoJpaEntity`, `UsuarioJpaEntity`         |
+| JPA Repository impl    | `Dominio + JpaRepository` | `PedidoJpaRepository`                         |
+| Spring Data interface  | `Dominio + JpaEntityRepository` | `PedidoJpaEntityRepository`             |
+| HTTP Client            | `Servico + Client`        | `PagamentoClient`, `NotificacaoClient`        |
+| Message Consumer       | `Evento + Consumer`       | `PedidoCriadoConsumer`                        |
+| Message Producer       | `Evento + Producer`       | `PedidoConfirmadoProducer`                    |
+| Mapper                 | `Dominio + Mapper`        | `PedidoMapper`, `UsuarioMapper`               |
+| DTO de entrada         | `Acao + Request`          | `ConfirmarPedidoRequest`, `CadastrarUsuarioRequest` |
+| DTO de saída           | `Dominio + Response`      | `PedidoResponse`, `UsuarioResponse`           |
+
+## Packages
+
+Siga a estrutura hexagonal. Use nomes de domínio em lowercase, sem underscores.
+
+```
+com.empresa.produto.pedido.domain.model
+com.empresa.produto.pedido.domain.port.in
+com.empresa.produto.pedido.application.usecase
+com.empresa.produto.pedido.infrastructure.adapter.in
+```
+
+## Métodos
+
+| Tipo                   | Padrão                | Exemplos                                         |
+|------------------------|-----------------------|--------------------------------------------------|
+| Use case (comando)     | verbo no infinitivo   | `confirmar()`, `cancelar()`, `processar()`       |
+| Use case (query)       | `buscar/listar/obter` | `buscarPorId()`, `listarAtivos()`, `obterSaldo()`|
+| Domain action          | verbo de negócio      | `ativar()`, `debitar()`, `aplicarDesconto()`     |
+| Factory method         | `criar/novo`          | `criar()`, `criarVazio()`, `novaInstancia()`     |

package/pscode/content/dixi/context/java/testing.md

@@ -0,0 +1,162 @@
+# Testes — Java/Spring
+
+## Pirâmide de testes
+
+```
+        [E2E — RestAssured]          ← poucos, fluxos críticos
+      [Integração — Testcontainers]  ← adapters de saída, APIs
+    [Unitários — JUnit 5 + Mockito]  ← domain e application (maioria)
+```
+
+## Nível 1 — Testes unitários (domain e application)
+
+Testam lógica pura sem Spring, sem banco, sem rede.
+
+**Ferramentas:** JUnit 5, Mockito
+
+**Onde ficam:** `test/java/.../domain/` e `test/java/.../application/`
+
+```java
+// Teste de domain
+class PedidoTest {
+    @Test
+    void dado_pedido_com_itens_quando_confirmar_entao_status_confirmado() {
+        // Given
+        Pedido pedido = PedidoTestFactory.comUmItem();
+
+        // When
+        pedido.confirmar();
+
+        // Then
+        assertThat(pedido.getStatus()).isEqualTo(StatusPedido.CONFIRMADO);
+    }
+
+    @Test
+    void dado_pedido_vazio_quando_confirmar_entao_lanca_excecao() {
+        Pedido pedido = PedidoTestFactory.vazio();
+        assertThatThrownBy(pedido::confirmar)
+            .isInstanceOf(PedidoVazioException.class);
+    }
+}
+```
+
+```java
+// Teste de application (use case)
+class ConfirmarPedidoServiceTest {
+    @Mock PedidoRepository repository;
+    @InjectMocks ConfirmarPedidoService service;
+
+    @Test
+    void dado_pedido_existente_quando_confirmar_entao_salva_e_retorna() {
+        // Given
+        Pedido pedido = PedidoTestFactory.comUmItem();
+        when(repository.findById(pedido.getId())).thenReturn(Optional.of(pedido));
+        when(repository.save(any())).thenAnswer(inv -> inv.getArgument(0));
+
+        // When
+        Pedido resultado = service.confirmar(pedido.getId());
+
+        // Then
+        assertThat(resultado.getStatus()).isEqualTo(StatusPedido.CONFIRMADO);
+        verify(repository).save(pedido);
+    }
+}
+```
+
+## Nível 2 — Testes de integração (infrastructure)
+
+Testam adapters com dependências reais (banco, mensageria, APIs externas).
+
+**Ferramentas:** Testcontainers, `@SpringBootTest` com perfil de teste
+
+**Onde ficam:** `test/java/.../infrastructure/`
+
+```java
+@SpringBootTest
+@Testcontainers
+class PedidoJpaRepositoryIT {
+    @Container
+    static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:16");
+
+    @DynamicPropertySource
+    static void props(DynamicPropertyRegistry r) {
+        r.add("spring.datasource.url", postgres::getJdbcUrl);
+    }
+
+    @Autowired PedidoRepository repository;
+
+    @Test
+    void dado_pedido_salvo_quando_buscar_por_id_entao_retorna() {
+        Pedido pedido = repository.save(PedidoTestFactory.comUmItem());
+        assertThat(repository.findById(pedido.getId())).isPresent();
+    }
+}
+```
+
+## Nível 3 — Testes E2E (fluxos críticos)
+
+Testam a API completa via HTTP, do controller ao banco.
+
+**Ferramentas:** RestAssured, Testcontainers (banco real)
+
+```java
+@SpringBootTest(webEnvironment = RANDOM_PORT)
+@Testcontainers
+class ConfirmarPedidoE2ETest {
+    @LocalServerPort int port;
+
+    @Test
+    void confirmar_pedido_retorna_200_com_status_confirmado() {
+        String pedidoId = criarPedidoViaApi();
+
+        given()
+            .port(port)
+            .contentType(ContentType.JSON)
+        .when()
+            .post("/pedidos/{id}/confirmar", pedidoId)
+        .then()
+            .statusCode(200)
+            .body("status", equalTo("CONFIRMADO"));
+    }
+}
+```
+
+## Nomenclatura
+
+Padrão: `dado_[contexto]_quando_[acao]_entao_[resultado]`
+
+```
+dado_pedido_com_itens_quando_confirmar_entao_status_confirmado
+dado_usuario_inativo_quando_autenticar_entao_lanca_UsuarioInativoException
+dado_estoque_zerado_quando_reservar_entao_retorna_false
+```
+
+## Cobertura mínima
+
+| Camada          | Cobertura mínima |
+|-----------------|-----------------|
+| `domain`        | 90%             |
+| `application`   | 80%             |
+| `infrastructure`| 60% (integração complementa) |
+
+Configure no `pom.xml` com JaCoCo:
+
+```xml
+<configuration>
+    <rules>
+        <rule>
+            <element>PACKAGE</element>
+            <includes>
+                <include>**.domain.**</include>
+                <include>**.application.**</include>
+            </includes>
+            <limits>
+                <limit>
+                    <counter>LINE</counter>
+                    <minimum>0.80</minimum>
+                </limit>
+            </limits>
+        </rule>
+    </rules>
+</configuration>
+```