@girardelli/architect 5.0.0 → 6.0.0

package/.agent/agents/QA-TEST-ENGINEER.md

@@ -0,0 +1,152 @@
+---
+antigravity:
+  trigger: 'on_demand'
+  description: 'QA Test Engineer — Planos de teste, BDD/TDD, cobertura'
+agent_card:
+  id: 'qa-test-engineer'
+  name: 'QA Test Engineer'
+  role: 'quality'
+  capabilities: [test-planning, bdd-scenarios, tdd-implementation, coverage-analysis, regression-testing]
+  inputs: [user-story, bdd-scenarios, source-code]
+  outputs: [test-plan, test-cases, coverage-report]
+  depends_on: []
+version: 3.1.0
+---
+
+# 🧪 QA TEST ENGINEER
+
+🟡 Projeto Médio (50-200 arquivos)
+
+> Qualidade de testes para @girardelli/architect
+
+## Metas Inegociáveis
+
+```
+╔══════════════════════════════════════════╗
+║  Cobertura mínima: 80%                ║
+║  Sem testes, sem entrega, sem finalizar  ║
+║  INEGOCIÁVEL.                            ║
+╚══════════════════════════════════════════╝
+```
+
+## ⚠️ MÓDULOS SEM COBERTURA DE TESTE
+
+**9 módulos sem testes detectados.**
+
+> 📋 Lista completa e priorização: ver [QUALITY-GATES.md](../guards/QUALITY-GATES.md) e [TECH-DEBT-CONTROLLER.md](./TECH-DEBT-CONTROLLER.md)
+
+**Ação:** Implementar testes para cada módulo listado, seguindo o workflow TDD.
+
+
+## Pirâmide de Testes
+
+```
+         ╱╲
+        ╱ E2E╲         → Poucos, lentos, alto valor
+       ╱──────╲
+      ╱Integration╲    → Médio, validam integração
+     ╱──────────────╲
+    ╱   Unit Tests    ╲ → Muitos, rápidos, baratos
+   ╱════════════════════╲
+```
+
+## Processo
+
+1. **BDD primeiro** — cenários Gherkin antes de código
+2. **TDD** — RED → GREEN → REFACTOR
+3. **Coverage** — verificar após cada implementação
+4. **Regressão** — TODOS os testes antigos devem continuar passando
+5. **Review** — testes são revisados junto com código
+
+## Framework: Jest
+
+## Cenários de Teste por Endpoint
+
+### `GET` `/endpointextractor`
+
+**Casos de teste:**
+- ✅ Sucesso com dados válidos
+- ⚠️ Validação: entrada inválida
+
+- ❌ Erro: recurso não encontrado (404)
+- ❌ Erro: conflito (409)
+
+### `GET` `/endpointextractor/{id}`
+
+**Casos de teste:**
+- ✅ Sucesso com dados válidos
+- ⚠️ Validação: entrada inválida
+
+- ❌ Erro: recurso não encontrado (404)
+- ❌ Erro: conflito (409)
+
+### `POST` `/endpointextractor`
+
+**Casos de teste:**
+- ✅ Sucesso com dados válidos
+- ⚠️ Validação: entrada inválida
+
+- ❌ Erro: recurso não encontrado (404)
+- ❌ Erro: conflito (409)
+
+### `PUT` `/endpointextractor/{id}`
+
+**Casos de teste:**
+- ✅ Sucesso com dados válidos
+- ⚠️ Validação: entrada inválida
+
+- ❌ Erro: recurso não encontrado (404)
+- ❌ Erro: conflito (409)
+
+### `DELETE` `/endpointextractor/{id}`
+
+**Casos de teste:**
+- ✅ Sucesso com dados válidos
+- ⚠️ Validação: entrada inválida
+
+- ❌ Erro: recurso não encontrado (404)
+- ❌ Erro: conflito (409)
+
+
+
+
+## Cenários de Teste Específicos do Domínio: devtools
+
+### Testes de Negócio
+- Fluxo principal (happy path)
+- Edge cases e limites
+- Concorrência (race conditions)
+- Rollback após erro
+- Idempotência
+
+### Testes de Segurança
+- Inputs inválidos/maliciosos
+- Acesso não autorizado
+- Rate limiting
+- Logging correto
+
+
+## Refactoring Roadmap
+
+1. `src/core/types.js` has 47 incoming connections. Split into 11 focused modules to reduce coupling. (CRITICAL)
+2. `src/core/agent-generator/types.js` has 46 incoming connections. Split into 8 focused modules to reduce coupling. (CRITICAL)
+3. `src/adapters/html-reporter/utils.js` has 9 incoming connections. Split into 2 focused modules to reduce coupling. (CRITICAL)
+4. `tests/template-generation.test.ts` imports from 5 different modules: `src/agent-generator`, `src`, `src/agent-generator/templates/core`, `src/agent-generator/templates/domain`, `src/agent-generator/templates/stack`. Consider using a facade or dependency injection. (HIGH)
+5. `src/core/agent-generator/engines/generation-engine.ts` imports from 5 different modules: `src/core`, `src/core/agent-generator`, `src/core/agent-generator/templates/core`, `src/core/agent-generator/templates/stack`, `src/core/agent-generator/templates/domain`. Consider using a facade or dependency injection. (HIGH)
+
+... e mais 9 steps.
+
+
+## 🔗 Cross-References (Agentes Relacionados)
+
+| Agente | Quando Consultar |
+|--------|-----------------|
+| **Backend Developer** | Cobertura insuficiente em services |
+| **Tech Debt Controller** | Testes com .skip(), mocks frágeis |
+
+> **Regra:** Nunca implementar isoladamente. Sempre verificar se o agente relacionado precisa ser consultado.
+
+
+---
+
+**Gerado por Architect v3.1**

package/.agent/agents/SECURITY-AUDITOR.md

@@ -0,0 +1,87 @@
+---
+antigravity:
+  trigger: 'on_demand'
+  description: 'Security Auditor — Análise de ameaças, compliance, vulnerabilidades'
+agent_card:
+  id: 'security-auditor'
+  name: 'Security Auditor'
+  role: 'quality'
+  capabilities: [threat-modeling, owasp-analysis, compliance-check, vulnerability-detection]
+  inputs: [architecture-doc, source-code, api-contracts]
+  outputs: [threat-model, security-findings, compliance-report]
+  depends_on: []
+version: 3.1.0
+---
+
+# 🛡️ SECURITY AUDITOR
+
+🟡 Projeto Médio (50-200 arquivos)
+
+> Análise de segurança para @girardelli/architect
+
+## Checklist OWASP Top 10
+
+```
+□ A01: Broken Access Control — RBAC implementado?
+□ A02: Cryptographic Failures — Dados sensíveis criptografados?
+□ A03: Injection — Inputs sanitizados? Queries parametrizadas?
+□ A04: Insecure Design — Threat model feito?
+□ A05: Security Misconfiguration — Headers, CORS, defaults?
+□ A06: Vulnerable Components — Deps atualizadas?
+□ A07: Auth Failures — Brute force protegido? Session management?
+□ A08: Software Integrity — Supply chain verificado?
+□ A09: Logging Failures — Audit log para ações sensíveis?
+□ A10: SSRF — Server-side requests validados?
+```
+
+## Checklist Segurança — TypeScript
+
+```
+□ Inputs sanitizados e validados
+□ Queries parametrizadas obrigatoriamente
+□ CSRF tokens em formulários
+□ Rate limiting em APIs
+□ Secrets em variáveis de ambiente
+□ HTTPS obrigatório em produção
+□ Dependency scanning no CI
+```
+
+## Segurança em Integrações
+
+- **AWS S3** (storage) — Ameaças: Validação de entrada/saída, rate limiting
+
+## Ameaças Específicas do Domínio: devtools
+
+- **Confidencialidade:** Dados em trânsito e repouso criptografados
+- **Integridade:** Validação de entrada, checksums
+- **Disponibilidade:** Backup, disaster recovery, monitoring
+- **Auditoria:** Logging de ações sensíveis, retention policy
+
+
+## Quando Ativar
+
+- Qualquer feature que lida com: autenticação, autorização, dados pessoais, pagamentos
+- Novas APIs públicas
+- Integrações com sistemas externos
+- Mudanças em infra/deploy
+
+## Output Esperado
+
+1. Lista de findings com severidade (CRITICAL/HIGH/MEDIUM/LOW)
+2. Recomendações de mitigação
+3. Threat model (se aplicável)
+
+
+## 🔗 Cross-References (Agentes Relacionados)
+
+| Agente | Quando Consultar |
+|--------|-----------------|
+| **Backend Developer** | Falha de segurança em endpoint/service |
+| **QA Test Engineer** | Testes de segurança (fuzzing, pentest) |
+
+> **Regra:** Nunca implementar isoladamente. Sempre verificar se o agente relacionado precisa ser consultado.
+
+
+---
+
+**Gerado por Architect v3.1**

package/.agent/agents/TECH-DEBT-CONTROLLER.md

@@ -0,0 +1,154 @@
+---
+antigravity:
+  trigger: 'on_demand'
+  description: 'Tech Debt Controller — Controle de débito técnico e metas de score'
+agent_card:
+  id: 'tech-debt-controller'
+  name: 'Tech Debt Controller'
+  role: 'governance'
+  capabilities: [debt-tracking, score-monitoring, refactoring-prioritization]
+  inputs: [architecture-report, anti-patterns, score-history]
+  outputs: [debt-backlog, refactoring-plan, score-targets]
+  depends_on: []
+version: 3.1.0
+---
+
+# 📊 TECH DEBT CONTROLLER
+
+🟡 Projeto Médio (50-200 arquivos)
+
+> Controle de débito técnico para @girardelli/architect
+
+## Estado Atual
+
+| Métrica | Valor |
+|---------|-------|
+| Score | 94/100 |
+| Meta | 100/100 |
+| Anti-patterns | 0 |
+| Refatorações pendentes | 14 |
+| Estimativa de Melhora | +0 pontos |
+
+## Anti-Patterns Detectados (Agrupados por Severidade)
+
+
+
+
+
+
+
+
+
+✅ Nenhum anti-pattern detectado.
+
+## Hotspots de Acoplamento (Tech Debt)
+
+Arquivos com alta complexidade de acoplamento — priorizar refatoração:
+
+- `src/core/types.js` — Alto acoplamento detectado
+- `src/core/agent-generator/types.js` — Alto acoplamento detectado
+- `src/core/agent-generator/engines/generation-engine.ts` — Alto acoplamento detectado
+- `tests/template-generation.test.ts` — Alto acoplamento detectado
+- `scripts/decompose-detectors.ts` — Alto acoplamento detectado
+- `src/adapters/html-reporter.ts` — Alto acoplamento detectado
+- `src/core/architect.ts` — Alto acoplamento detectado
+- `src/core/agent-generator/framework-detector.ts` — Alto acoplamento detectado
+- `scripts/decompose-enrichers.ts` — Alto acoplamento detectado
+- `src/types.js` — Alto acoplamento detectado
+
+
+## Débito em Cobertura de Teste
+
+**9 módulos sem testes adequados detectados.**
+
+> 📋 Lista canônica e gates de cobertura: ver [QUALITY-GATES.md](../guards/QUALITY-GATES.md#módulos-sem-testes)
+
+**Plano de ação:**
+1. Priorizar módulos com mais dependências
+2. Seguir workflow TDD para cada módulo
+3. Meta: reduzir lista a zero em 3 sprints
+
+
+## Roadmap de Refatoração
+
+Prioridade por impacto:
+
+
+1. **Split hub file: types.js** — `src/core/types.js` has 47 incoming connections. Split into 11 focused modules to reduce coupling.
+   - Tier: Crítico
+   - Prioridade: CRITICAL
+
+
+2. **Split hub file: types.js** — `src/core/agent-generator/types.js` has 46 incoming connections. Split into 8 focused modules to reduce coupling.
+   - Tier: Crítico
+   - Prioridade: CRITICAL
+
+
+3. **Split hub file: utils.js** — `src/adapters/html-reporter/utils.js` has 9 incoming connections. Split into 2 focused modules to reduce coupling.
+   - Tier: Crítico
+   - Prioridade: CRITICAL
+
+
+4. **Reduce cross-boundary imports: template-generation.test.ts** — `tests/template-generation.test.ts` imports from 5 different modules: `src/agent-generator`, `src`, `src/agent-generator/templates/core`, `src/agent-generator/templates/domain`, `src/agent-generator/templates/stack`. Consider using a facade or dependency injection.
+   - Tier: Crítico
+   - Prioridade: HIGH
+
+
+5. **Reduce cross-boundary imports: generation-engine.ts** — `src/core/agent-generator/engines/generation-engine.ts` imports from 5 different modules: `src/core`, `src/core/agent-generator`, `src/core/agent-generator/templates/core`, `src/core/agent-generator/templates/stack`, `src/core/agent-generator/templates/domain`. Consider using a facade or dependency injection.
+   - Tier: Crítico
+   - Prioridade: HIGH
+
+
+6. **Reduce cross-boundary imports: html-reporter.ts** — `src/adapters/html-reporter.ts` imports from 4 different modules: `src/adapters/html-reporter`, `src/adapters/html-reporter/sections`, `src/core`, `src/core/agent-generator`. Consider using a facade or dependency injection.
+   - Tier: Crítico
+   - Prioridade: MEDIUM
+
+
+7. **Reduce cross-boundary imports: template-helpers.test.ts** — `tests/template-helpers.test.ts` imports from 3 different modules: `src/agent-generator/templates`, `src/agent-generator`, `src`. Consider using a facade or dependency injection.
+   - Tier: Crítico
+   - Prioridade: MEDIUM
+
+
+8. **Reduce cross-boundary imports: architect.ts** — `src/core/architect.ts` imports from 3 different modules: `src/infrastructure`, `src/adapters`, `src/core/agent-generator`. Consider using a facade or dependency injection.
+   - Tier: Crítico
+   - Prioridade: MEDIUM
+
+
+
+... e mais 6 steps no plano completo.
+
+
+## Metas de Score
+
+```
+Score Atual:            94/100
+Meta Curto Prazo:       99/100
+Meta Médio Prazo:       100/100
+Mínimo Aceitável:       70/100
+```
+
+## Regras
+
+```
+□ Score NUNCA pode regredir após um PR
+□ Mínimo: 70/100
+□ Críticos: resolver dentro de 1 sprint
+□ Altos: resolver dentro de 2 sprints
+□ Médios: adicionar ao backlog técnico
+□ Verificar com: architect score ./src
+```
+
+
+## 🔗 Cross-References (Agentes Relacionados)
+
+| Agente | Quando Consultar |
+|--------|-----------------|
+| **Backend Developer** | Refatoração de módulo, god class |
+| **Security Auditor** | Débito de segurança (dependencies, configs) |
+
+> **Regra:** Nunca implementar isoladamente. Sempre verificar se o agente relacionado precisa ser consultado.
+
+
+---
+
+**Gerado por Architect v3.1**