@girardelli/architect 4.0.0 → 6.0.0

package/{__test_agent_output__ → .agent}/agents/QA-TEST-ENGINEER.md

@@ -15,9 +15,9 @@ version: 3.1.0
 
 # 🧪 QA TEST ENGINEER
 
-🟢 Projeto Pequeno (< 50 arquivos)
+🟡 Projeto Médio (50-200 arquivos)
 
-> Qualidade de testes para test-project
+> Qualidade de testes para @girardelli/architect
 
 ## Metas Inegociáveis
 
@@ -29,6 +29,14 @@ version: 3.1.0
 ╚══════════════════════════════════════════╝
 ```
 
+## ⚠️ 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
 
@@ -54,7 +62,7 @@ version: 3.1.0
 
 ## Cenários de Teste por Endpoint
 
-### `GET` `/app.`
+### `GET` `/endpointextractor`
 
 **Casos de teste:**
 - ✅ Sucesso com dados válidos
@@ -63,7 +71,7 @@ version: 3.1.0
 - ❌ Erro: recurso não encontrado (404)
 - ❌ Erro: conflito (409)
 
-### `GET` `/app./{id}`
+### `GET` `/endpointextractor/{id}`
 
 **Casos de teste:**
 - ✅ Sucesso com dados válidos
@@ -72,7 +80,7 @@ version: 3.1.0
 - ❌ Erro: recurso não encontrado (404)
 - ❌ Erro: conflito (409)
 
-### `POST` `/app.`
+### `POST` `/endpointextractor`
 
 **Casos de teste:**
 - ✅ Sucesso com dados válidos
@@ -81,7 +89,7 @@ version: 3.1.0
 - ❌ Erro: recurso não encontrado (404)
 - ❌ Erro: conflito (409)
 
-### `PUT` `/app./{id}`
+### `PUT` `/endpointextractor/{id}`
 
 **Casos de teste:**
 - ✅ Sucesso com dados válidos
@@ -90,7 +98,7 @@ version: 3.1.0
 - ❌ Erro: recurso não encontrado (404)
 - ❌ Erro: conflito (409)
 
-### `DELETE` `/app./{id}`
+### `DELETE` `/endpointextractor/{id}`
 
 **Casos de teste:**
 - ✅ Sucesso com dados válidos
@@ -102,25 +110,31 @@ version: 3.1.0
 
 
 
-## Cenários de Teste Específicos do Domínio: healthtech
+## Cenários de Teste Específicos do Domínio: devtools
 
 ### Testes de Negócio
-- Criar registro de paciente com LGPD compliance
-- Validar consentimento antes de compartilhar dados
-- Anonimizar dados corretamente
-- Respeitar direito ao esquecimento
-- Auditoria de acesso a dados sensíveis
+- Fluxo principal (happy path)
+- Edge cases e limites
+- Concorrência (race conditions)
+- Rollback após erro
+- Idempotência
 
 ### Testes de Segurança
-- Criptografia end-to-end em repouso
-- Validar 2FA para dados críticos
-- Testar retenção de dados
+- Inputs inválidos/maliciosos
+- Acesso não autorizado
+- Rate limiting
+- Logging correto
 
 
 ## Refactoring Roadmap
 
-1. Split monolith service (HIGH)
+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)

package/{__test_agent_output__ → .agent}/agents/SECURITY-AUDITOR.md

@@ -15,9 +15,9 @@ version: 3.1.0
 
 # 🛡️ SECURITY AUDITOR
 
-🟢 Projeto Pequeno (< 50 arquivos)
+🟡 Projeto Médio (50-200 arquivos)
 
-> Análise de segurança para test-project
+> Análise de segurança para @girardelli/architect
 
 ## Checklist OWASP Top 10
 
@@ -46,34 +46,16 @@ version: 3.1.0
 □ Dependency scanning no CI
 ```
 
-## Requisitos de Compliance Detectados
+## Segurança em Integrações
 
-### HIPAA
-**Motivo:** Handles protected health information (PHI)
+- **AWS S3** (storage) — Ameaças: Validação de entrada/saída, rate limiting
 
-**Verificações Obrigatórias:**
-- □ PHI encryption at rest and in transit
-- □ Access audit logging for all PHI access
-- □ Minimum necessary access principle
-- □ Business Associate Agreements (BAA) tracking
-- □ Breach notification within 60 days
+## Ameaças Específicas do Domínio: devtools
 
-### LGPD-Health
-**Motivo:** Processes sensitive health data under Brazilian law
-
-**Verificações Obrigatórias:**
-- □ Explicit consent for health data processing
-- □ Data anonymization where possible
-- □ Restricted access to health records
-- □ CFM/CRM compliance for medical data
-
-
-## Ameaças Específicas do Domínio: healthtech
-
-- **Vazamento de dados:** Criptografia end-to-end, anonimização
-- **HIPAA/LGPD:** Audit trails, consentimento explícito
-- **Integridade:** Assinatura digital, blockchain se aplicável
-- **Acesso:** RBAC granular, 2FA para dados sensíveis
+- **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
@@ -95,7 +77,6 @@ version: 3.1.0
 | Agente | Quando Consultar |
 |--------|-----------------|
 | **Backend Developer** | Falha de segurança em endpoint/service |
-| **Database Engineer** | Encryption at rest, data masking |
 | **QA Test Engineer** | Testes de segurança (fuzzing, pentest) |
 
 > **Regra:** Nunca implementar isoladamente. Sempre verificar se o agente relacionado precisa ser consultado.

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**