@girardelli/architect 2.2.0 → 4.0.0

package/dist/agent-generator/templates/core/skills-generator.js

@@ -0,0 +1,207 @@
+import { getEnriched } from '../template-helpers.js';
+/**
+ * Analisa módulos e detecta padrões recorrentes (adapters, factories, extractors, etc.)
+ */
+function detectPatterns(ctx) {
+    const enriched = getEnriched(ctx);
+    const modules = enriched.modules || [];
+    const patterns = [];
+    // Collect all file/class names from modules
+    const allFiles = [];
+    const allServices = [];
+    const allControllers = [];
+    const allEntities = [];
+    for (const mod of modules) {
+        allServices.push(...mod.services);
+        allControllers.push(...mod.controllers);
+        allEntities.push(...mod.entities);
+        allFiles.push(...mod.testFiles);
+    }
+    const allNames = [...allServices, ...allControllers, ...allEntities, ...allFiles];
+    // Detect Adapter pattern
+    const adapters = allNames.filter(n => /adapter/i.test(n));
+    if (adapters.length > 0) {
+        patterns.push({
+            name: 'Adapter Pattern',
+            description: 'O projeto utiliza o padrão Adapter para abstrair integrações externas e garantir desacoplamento.',
+            examples: adapters.slice(0, 5),
+            howToCreate: `1. Criar interface no domínio: \`I{Nome}Port\`
+2. Implementar adapter: \`{Nome}Adapter implements I{Nome}Port\`
+3. Registrar no container de DI
+4. Escrever testes unitários com mock do adapter
+5. Garantir que o domínio nunca importe o adapter diretamente`,
+        });
+    }
+    // Detect Factory pattern
+    const factories = allNames.filter(n => /factory/i.test(n));
+    if (factories.length > 0) {
+        patterns.push({
+            name: 'Factory Pattern',
+            description: 'Factories são usadas para encapsular a lógica de criação de objetos complexos.',
+            examples: factories.slice(0, 5),
+            howToCreate: `1. Criar classe factory: \`{Nome}Factory\`
+2. Método principal: \`create({params}): {Tipo}\`
+3. Encapsular validações e defaults
+4. Escrever testes para cada variação de criação`,
+        });
+    }
+    // Detect Extractor pattern
+    const extractors = allNames.filter(n => /extractor|parser|reader/i.test(n));
+    if (extractors.length > 0) {
+        patterns.push({
+            name: 'Extractor/Parser Pattern',
+            description: 'Extractors/Parsers são usados para extrair e transformar dados de fontes externas (PDFs, APIs, arquivos).',
+            examples: extractors.slice(0, 5),
+            howToCreate: `1. Criar interface: \`I{Tipo}Extractor\`
+2. Implementar: \`{Tipo}Extractor implements I{Tipo}Extractor\`
+3. Método principal: \`extract(source): ExtractedData\`
+4. Testar com fixtures (dados de exemplo)
+5. Tratar edge cases: dados vazios, formato inválido, timeout`,
+        });
+    }
+    // Detect Repository pattern
+    const repositories = allNames.filter(n => /repository|repo/i.test(n));
+    if (repositories.length > 0) {
+        patterns.push({
+            name: 'Repository Pattern',
+            description: 'Repositories abstraem o acesso a dados, separando lógica de negócio da persistência.',
+            examples: repositories.slice(0, 5),
+            howToCreate: `1. Criar interface: \`I{Entidade}Repository\`
+2. Métodos padrão: findById, findAll, save, delete
+3. Implementar com ORM ou query builder
+4. Testar com banco in-memory ou mock`,
+        });
+    }
+    // Detect Middleware/Guard pattern
+    const middlewares = allNames.filter(n => /middleware|guard|interceptor|pipe/i.test(n));
+    if (middlewares.length > 0) {
+        patterns.push({
+            name: 'Middleware/Guard Pattern',
+            description: 'Middlewares e Guards implementam cross-cutting concerns (auth, logging, validation).',
+            examples: middlewares.slice(0, 5),
+            howToCreate: `1. Criar middleware/guard com interface do framework
+2. Implementar lógica de interceptação
+3. Registrar no pipeline de request
+4. Testar isoladamente com request mocking`,
+        });
+    }
+    // Detect DTO/Schema pattern
+    const dtos = allNames.filter(n => /dto|schema|model|entity/i.test(n));
+    if (dtos.length > 2) { // Only if there are several
+        patterns.push({
+            name: 'DTO/Schema Pattern',
+            description: 'DTOs e Schemas definem contratos de entrada/saída e validações.',
+            examples: dtos.slice(0, 5),
+            howToCreate: `1. Criar DTO/Schema para cada endpoint
+2. Validações no DTO (não no controller)
+3. Separar RequestDTO e ResponseDTO
+4. Documentar campos obrigatórios e opcionais
+5. Usar validação automática do framework`,
+        });
+    }
+    // Detect Service Layer pattern (almost always present)
+    if (allServices.length > 1) {
+        patterns.push({
+            name: 'Service Layer Pattern',
+            description: 'Services encapsulam toda a lógica de negócio, mantendo controllers finos.',
+            examples: allServices.slice(0, 5),
+            howToCreate: `1. Criar service: \`{Domínio}Service\`
+2. Injetar dependências via constructor
+3. Um método por caso de uso (SRP)
+4. Lançar exceções de domínio (não HTTP)
+5. Testar unitariamente com mocks de dependências`,
+        });
+    }
+    return patterns;
+}
+/**
+ * Gera conteúdo do skill principal do projeto
+ */
+export function generateProjectSkills(ctx) {
+    const enriched = getEnriched(ctx);
+    const patterns = detectPatterns(ctx);
+    const stack = 'stack' in ctx ? ctx.stack : undefined;
+    const domain = enriched.domain;
+    if (patterns.length === 0) {
+        return null; // Não gerar se não houver padrões detectados
+    }
+    const langs = stack?.languages.map((l) => l.toLowerCase()) || [];
+    const isPython = langs.includes('python');
+    const isDart = langs.includes('dart');
+    const isGo = langs.includes('go');
+    // Naming convention per language
+    let fileConvention = 'camelCase para arquivos, PascalCase para classes';
+    if (isPython)
+        fileConvention = 'snake_case para arquivos e funções, PascalCase para classes';
+    else if (isDart)
+        fileConvention = 'snake_case para arquivos, camelCase para funções, PascalCase para classes';
+    else if (isGo)
+        fileConvention = 'lowercase para pacotes, PascalCase para exports, camelCase para privados';
+    // Build frameworks label from enriched detectedFrameworks (most accurate) or stack.frameworks
+    const detectedFw = enriched.detectedFrameworks;
+    const frameworksLabel = detectedFw && detectedFw.length > 0
+        ? detectedFw.map(f => f.version ? `${f.name} v${f.version}` : f.name).join(', ')
+        : (stack?.frameworks.length ? stack.frameworks.join(', ') : 'Não detectados');
+    const patternsContent = patterns.map(p => `### ${p.name}
+
+${p.description}
+
+**Exemplos no projeto:**
+${p.examples.map(e => `- \`${e}\``).join('\n')}
+
+**Como criar um novo:**
+${p.howToCreate}
+`).join('\n---\n\n');
+    const domainSection = domain ? `
+---
+
+## Padrões de Domínio: ${domain.domain}${domain.subDomain ? ` / ${domain.subDomain}` : ''}
+
+${domain.businessEntities?.length ? `### Entidades de Negócio
+${domain.businessEntities.map(e => `- **${e.name}**: ${e.fields?.join(', ') || 'campos detectados'}`).join('\n')}` : ''}
+
+${domain.integrations?.length ? `### Integrações
+${domain.integrations.map(i => `- **${i.name}** (${i.type})`).join('\n')}` : ''}
+
+${domain.compliance?.length ? `### Compliance
+${domain.compliance.map(c => `- **${c.name}**: ${c.reason}`).join('\n')}` : ''}
+` : '';
+    return `---
+antigravity:
+  trigger: 'on_demand'
+  description: 'Padrões e convenções específicos do projeto'
+version: 3.1.0
+---
+
+# 📚 Skills: Padrões do Projeto
+
+> Referência rápida dos padrões arquiteturais detectados e como seguí-los.
+
+---
+
+## Convenções
+
+- **Nomenclatura de arquivos:** ${fileConvention}
+- **Stack:** ${stack?.languages.join(', ') || 'Não detectada'}
+- **Frameworks:** ${frameworksLabel}
+
+---
+
+## Padrões Arquiteturais Detectados
+
+${patternsContent}
+${domainSection}
+---
+
+## Checklist para Novo Código
+
+\`\`\`
+□ Segue os padrões acima?
+□ Testes escritos antes do código (TDD)?
+□ Nomenclatura consistente com convenções?
+□ Sem duplicação de lógica existente?
+□ Documentação atualizada (JSDoc/docstring)?
+\`\`\`
+`;
+}
+//# sourceMappingURL=skills-generator.js.map

package/dist/agent-generator/templates/core/skills-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-generator.js","sourceRoot":"","sources":["../../../../src/agent-generator/templates/core/skills-generator.ts"],"names":[],"mappings":"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"}

package/dist/agent-generator/templates/core/workflow-fix-bug.d.ts

@@ -0,0 +1,7 @@
+import { TemplateContext } from '../../types.js';
+/**
+ * Generates enterprise-grade fix-bug.md workflow.
+ * 10 steps: diagnosis → localization → root cause → RED test → fix → regression → docs.
+ */
+export declare function generateFixBugWorkflow(ctx: TemplateContext): string;
+//# sourceMappingURL=workflow-fix-bug.d.ts.map

package/dist/agent-generator/templates/core/workflow-fix-bug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-fix-bug.d.ts","sourceRoot":"","sources":["../../../../src/agent-generator/templates/core/workflow-fix-bug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAwOnE"}

package/dist/agent-generator/templates/core/workflow-fix-bug.js

@@ -0,0 +1,237 @@
+/**
+ * Generates enterprise-grade fix-bug.md workflow.
+ * 10 steps: diagnosis → localization → root cause → RED test → fix → regression → docs.
+ */
+export function generateFixBugWorkflow(ctx) {
+    const { stack, projectName, config, report } = ctx;
+    return `---
+antigravity:
+  trigger: 'on_demand'
+  description: 'Workflow completo para correção de bug em ${projectName}'
+---
+
+# 🐛 Workflow: Fix Bug
+
+> **Bugs não se corrigem por tentativa e erro.**
+> Diagnóstico rigoroso → reprodução → root cause → teste RED → fix → regressão.
+
+---
+
+## Pré-requisitos
+
+\`\`\`
+□ Li INDEX.md e PREFLIGHT.md
+□ Li LESSONS-LEARNED.md (se existir) — talvez esse bug já aconteceu
+□ Li ERROR-PATTERNS.md (se existir) — talvez é um padrão conhecido
+□ Estou em uma branch fix/ ou hotfix/ (NUNCA main/develop)
+□ Build e testes passando ANTES da minha alteração
+\`\`\`
+
+---
+
+## Step 1: Diagnóstico Inicial
+
+\`\`\`
+Bug: [descrição clara do problema]
+Reportado por: [quem reportou]
+Ambiente: [produção / staging / dev]
+Severidade: [CRITICAL / HIGH / MEDIUM / LOW]
+
+Comportamento atual: [o que acontece]
+Comportamento esperado: [o que deveria acontecer]
+Como reproduzir:
+  1. [passo 1]
+  2. [passo 2]
+  3. [resultado errado]
+\`\`\`
+
+---
+
+## Step 2: Leitura de Contexto
+
+\`\`\`bash
+# Verificar LESSONS-LEARNED para bugs similares
+grep -i "[termo do bug]" LESSONS-LEARNED.md 2>/dev/null
+
+# Verificar ERROR-PATTERNS
+grep -i "[termo do bug]" ERROR-PATTERNS.md 2>/dev/null
+
+# Verificar regras de negócio relevantes
+grep -i "[domínio do bug]" BUSINESS-RULES.md 2>/dev/null
+
+# Histórico de commits na área afetada
+git log --oneline -20 -- [arquivo ou diretório afetado]
+\`\`\`
+
+---
+
+## Step 3: Localização do Problema
+
+\`\`\`bash
+# Buscar no código
+grep -rn "[termo do erro]" --include="*.${stack.primary === 'Python' ? 'py' : stack.primary === 'Dart' ? 'dart' : 'ts'}" src/
+
+# Verificar logs (se disponível)
+# Verificar stack trace
+
+# Mapear o fluxo de dados:
+# Input → [onde entra] → [como transforma] → [onde sai] → Output
+\`\`\`
+
+\`\`\`
+Arquivo(s) suspeito(s): _______________
+Função/método suspeito: _______________
+Linha(s) suspeita(s): _______________
+\`\`\`
+
+---
+
+## Step 4: Root Cause — Identificação da Causa Raiz
+
+\`\`\`
+╔══════════════════════════════════════════════╗
+║  NUNCA corrigir o SINTOMA.                   ║
+║  SEMPRE encontrar a CAUSA RAIZ.              ║
+║                                               ║
+║  Técnica dos 5 Porquês:                      ║
+║  1. Por que o bug acontece? → porque...      ║
+║  2. Por que isso? → porque...                ║
+║  3. Por que isso? → porque...                ║
+║  4. Por que isso? → porque...                ║
+║  5. Por que isso? → CAUSA RAIZ               ║
+╚══════════════════════════════════════════════╝
+\`\`\`
+
+\`\`\`
+Causa raiz: _______________
+Confiança: [ ] Alta (reproduzi) [ ] Média (hipótese forte) [ ] Baixa (preciso investigar mais)
+\`\`\`
+
+> **Se confiança é Baixa → PARAR e investigar mais. Não chutar.**
+
+---
+
+## Step 5: Verificar Testes Existentes
+
+\`\`\`bash
+# Testes que cobrem a área afetada
+grep -rn "[nome da função/classe]" --include="*.test.*" --include="*.spec.*" tests/ src/
+
+# Rodar testes existentes
+${stack.testFramework === 'pytest' ? 'pytest -v -k "[nome do módulo]"' : stack.testFramework === 'flutter_test' ? 'flutter test test/[modulo]_test.dart' : 'npx jest --testPathPattern="[modulo]"'}
+\`\`\`
+
+\`\`\`
+□ Existem testes para a área afetada? [sim/não]
+□ Os testes passam? [sim/não]
+□ Os testes cobrem o cenário do bug? [sim/não — se não, criar no Step 6]
+\`\`\`
+
+---
+
+## Step 6: Criar Teste RED
+
+> **PRIMEIRO criar um teste que FALHA reproduzindo o bug.**
+> Só depois corrigir o código.
+
+\`\`\`
+Teste: [nome descritivo do teste]
+Input: [dados que reproduzem o bug]
+Expected: [resultado correto]
+Actual: [resultado errado — o teste deve FALHAR]
+\`\`\`
+
+\`\`\`bash
+# Rodar e confirmar que FALHA (RED)
+${stack.testFramework === 'pytest' ? 'pytest -v -k "[nome do teste]"' : 'npx jest --testNamePattern="[nome do teste]"'}
+# DEVE FALHAR ❌
+\`\`\`
+
+---
+
+## Step 7: Correção Mínima
+
+\`\`\`
+╔══════════════════════════════════════════════╗
+║  REGRA: Correção MÍNIMA.                     ║
+║                                               ║
+║  ✓ Corrigir APENAS a causa raiz              ║
+║  ✓ Menor quantidade de linhas possível       ║
+║  ✗ NÃO refatorar código adjacente            ║
+║  ✗ NÃO "aproveitar" para melhorar outra coisa║
+║  ✗ NÃO adicionar features junto com o fix    ║
+╚══════════════════════════════════════════════╝
+\`\`\`
+
+Após corrigir:
+\`\`\`bash
+# Rodar o teste do Step 6 — agora deve PASSAR (GREEN)
+${stack.testFramework === 'pytest' ? 'pytest -v -k "[nome do teste]"' : 'npx jest --testNamePattern="[nome do teste]"'}
+# DEVE PASSAR ✅
+\`\`\`
+
+---
+
+## Step 8: Teste de Regressão
+
+\`\`\`bash
+# Rodar TODOS os testes (não só o novo)
+${stack.testFramework === 'pytest' ? 'pytest' : stack.testFramework === 'flutter_test' ? 'flutter test' : 'npm run test'}
+
+# Build completo
+${stack.packageManager === 'npm' ? 'npm run build' : 'make build'}
+
+# Score
+npx @girardelli/architect score .
+\`\`\`
+
+\`\`\`
+□ Teste do bug passa (GREEN) ✓
+□ TODOS os outros testes passam ✓
+□ Build compila ✓
+□ Score não regrediu ✓
+\`\`\`
+
+---
+
+## Step 9: Verificação de Fluxos Existentes
+
+\`\`\`
+□ Verifiquei que features dependentes não foram afetadas
+□ Verifiquei edge cases relacionados
+□ Se o bug era em API → verifiquei clientes da API
+□ Se o bug era em banco → verifiquei migrations e seeds
+\`\`\`
+
+---
+
+## Step 10: Documentação
+
+\`\`\`
+□ Atualizar LESSONS-LEARNED.md:
+  - O que aconteceu
+  - Causa raiz
+  - Como foi corrigido
+  - Como prevenir no futuro
+
+□ Atualizar ERROR-PATTERNS.md (se é um padrão novo):
+  - Padrão do erro
+  - Sintomas
+  - Solução
+
+□ Commit com mensagem semântica:
+  fix: [descrição clara do que foi corrigido]
+
+□ PR criado com:
+  - Descrição do bug
+  - Causa raiz
+  - Solução aplicada
+  - Testes adicionados
+\`\`\`
+
+---
+
+**Gerado por Architect v3.1 · Score: ${report.score.overall}/100 · ${new Date().toISOString().split('T')[0]}**
+`;
+}
+//# sourceMappingURL=workflow-fix-bug.js.map

package/dist/agent-generator/templates/core/workflow-fix-bug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-fix-bug.js","sourceRoot":"","sources":["../../../../src/agent-generator/templates/core/workflow-fix-bug.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAoB;IACzD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAEnD,OAAO;;;4DAGmD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CA8D7B,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDpH,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,KAAK,cAAc,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;EAyBhM,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;EAuBpH,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,8CAA8C;;;;;;;;;;EAUpH,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,KAAK,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc;;;EAGtH,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAoD1B,MAAM,CAAC,KAAK,CAAC,OAAO,UAAU,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1G,CAAC;AACF,CAAC"}

package/dist/agent-generator/templates/core/workflow-new-feature.d.ts

@@ -0,0 +1,8 @@
+import { TemplateContext } from '../../types.js';
+/**
+ * Generates enterprise-grade new-feature.md workflow.
+ * 10 steps with approval gates, mockup-first, backend-first order,
+ * integration doc, coverage gate, user story/task templates.
+ */
+export declare function generateNewFeatureWorkflow(ctx: TemplateContext): string;
+//# sourceMappingURL=workflow-new-feature.d.ts.map

package/dist/agent-generator/templates/core/workflow-new-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-new-feature.d.ts","sourceRoot":"","sources":["../../../../src/agent-generator/templates/core/workflow-new-feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA2TvE"}