@girardelli/architect 4.0.0 → 5.0.0

package/src/agent-generator/index.ts

@@ -55,7 +55,10 @@ import {
 } from './templates/domain/index.js';
 
 // ── Skills Generator ──
-import { generateProjectSkills } from './templates/core/skills-generator.js';
+import { generateProjectSkills, generateArchitectIntegrationSkill, generateCIPipelineSkill, generateMonorepoGuideSkill } from './templates/core/skills-generator.js';
+
+// ── Hooks Generator ──
+import { generatePreCommitHook, generatePrePushHook, generatePostAnalysisHook } from './templates/core/hooks-generator.js';
 
 // Re-export types for backward compatibility
 export type { StackInfo, AgentAuditFinding, AgentItem, AgentItemStatus, AgentSuggestion, EnrichedTemplateContext, DomainInsights, ModuleDetail, DetectedEndpoint, FrameworkInfo, DetectedToolchain };
@@ -71,6 +74,61 @@ export class AgentGenerator {
   private stackDetector = new StackDetector();
   private contextEnricher = new ContextEnricher();
 
+  /** Max lines for any single generated .agent file */
+  private static readonly MAX_FILE_LINES = 500;
+
+  /** Paths that indicate third-party code — filter from agent context */
+  private static readonly EXCLUDED_SEGMENTS = [
+    'node_modules', '/dist/', '/build/', '/coverage/',
+    '/.next/', '/venv/', '/__pycache__/', '/target/',
+  ];
+
+  /**
+   * Sanitize the report before passing to agent generation.
+   * Removes anti-patterns, dependency nodes, and suggestions
+   * that reference node_modules or build artifacts.
+   */
+  private sanitizeReport(report: AnalysisReport): AnalysisReport {
+    const isProjectPath = (path: string): boolean => {
+      const normalized = path.replace(/\\/g, '/');
+      return !AgentGenerator.EXCLUDED_SEGMENTS.some(seg => normalized.includes(seg));
+    };
+
+    return {
+      ...report,
+      antiPatterns: report.antiPatterns.filter(ap => {
+        if (!isProjectPath(ap.location)) return false;
+        if (ap.affectedFiles?.some(f => !isProjectPath(f))) {
+          // Keep the pattern but clean affected files
+          ap.affectedFiles = ap.affectedFiles.filter(f => isProjectPath(f));
+        }
+        return true;
+      }),
+      dependencyGraph: {
+        nodes: report.dependencyGraph.nodes.filter(n => isProjectPath(n)),
+        edges: report.dependencyGraph.edges.filter(
+          e => isProjectPath(e.from) && isProjectPath(e.to)
+        ),
+      },
+      suggestions: report.suggestions.filter(
+        s => !s.description.includes('node_modules')
+      ),
+    };
+  }
+
+  /**
+   * Cap content to max lines to prevent oversized agent files.
+   */
+  private capContent(content: string): string {
+    const lines = content.split('\n');
+    if (lines.length <= AgentGenerator.MAX_FILE_LINES) return content;
+
+    const truncated = lines.slice(0, AgentGenerator.MAX_FILE_LINES);
+    truncated.push('');
+    truncated.push('<!-- Content truncated at ' + AgentGenerator.MAX_FILE_LINES + ' lines. Run `architect agents` to regenerate. -->');
+    return truncated.join('\n');
+  }
+
   /**
    * Suggest agents without writing files — for unified report.
    */
@@ -79,7 +137,8 @@ export class AgentGenerator {
     plan: RefactoringPlan,
     projectPath: string,
   ): AgentSuggestion {
-    const stack = this.stackDetector.detect(report);
+    const cleanReport = this.sanitizeReport(report);
+    const stack = this.stackDetector.detect(cleanReport);
     const agentDir = join(projectPath, '.agent');
     const isExisting = existsSync(agentDir);
 
@@ -94,7 +153,7 @@ export class AgentGenerator {
       audit = this.auditExisting(agentDir, stack, report, plan);
     }
 
-    const ctx = this.buildContext(report, plan, stack, projectPath);
+    const ctx = this.buildContext(cleanReport, plan, stack, projectPath);
 
     const existingAgents = existingFiles('agents');
     const existingRules = existingFiles('rules');
@@ -125,9 +184,12 @@ export class AgentGenerator {
       desc: `Especialista em ${stack.primary} — APIs, serviços, lógica de negócio, integration docs`,
     });
     if (stack.hasFrontend) {
-      const fw = stack.frameworks.find(f => ['Angular', 'Vue', 'Next.js', 'React'].includes(f)) || 'FRONTEND';
+      const FRONTEND_FWS = ['Angular', 'Vue', 'Vue.js', 'Next.js', 'React', 'Nuxt', 'Svelte', 'Remix'];
+      const detectedFw = ctx.detectedFrameworks?.find(f => FRONTEND_FWS.includes(f.name));
+      const fw = detectedFw?.name ||
+        stack.frameworks.find(f => FRONTEND_FWS.includes(f)) || 'FRONTEND';
       agentDefs.push({
-        name: `${fw.toUpperCase().replace('.', '')}-FRONTEND-DEVELOPER`,
+        name: `${fw.toUpperCase().replace('.', '').replace(/\s/g, '-')}-FRONTEND-DEVELOPER`,
         desc: `Componentes ${fw}, state management, UX responsiva, todos os estados UI`,
       });
     }
@@ -225,17 +287,18 @@ export class AgentGenerator {
     projectPath: string,
     outputDir?: string
   ): { generated: string[]; audit: AgentAuditFinding[] } {
-    const stack = this.stackDetector.detect(report);
+    const cleanReport = this.sanitizeReport(report);
+    const stack = this.stackDetector.detect(cleanReport);
     const agentDir = outputDir || join(projectPath, '.agent');
     const isExisting = existsSync(agentDir);
 
     if (isExisting) {
-      const audit = this.auditExisting(agentDir, stack, report, plan);
-      const generated = this.generateMissing(agentDir, audit, report, plan, stack, projectPath);
+      const audit = this.auditExisting(agentDir, stack, cleanReport, plan);
+      const generated = this.generateMissing(agentDir, audit, cleanReport, plan, stack, projectPath);
       return { generated, audit };
     }
 
-    const generated = this.generateFull(agentDir, report, plan, stack, projectPath);
+    const generated = this.generateFull(agentDir, cleanReport, plan, stack, projectPath);
     return { generated, audit: [] };
   }
 
@@ -291,7 +354,7 @@ export class AgentGenerator {
     const ctx = this.buildContext(report, plan, stack, projectPath);
 
     // Create directories
-    const dirs = ['agents', 'rules', 'guards', 'workflows', 'templates', 'skills'];
+    const dirs = ['agents', 'rules', 'guards', 'workflows', 'templates', 'skills', 'hooks'];
     for (const d of dirs) mkdirSync(join(agentDir, d), { recursive: true });
 
     // ── Core files (Enterprise-Grade) ──
@@ -314,9 +377,11 @@ export class AgentGenerator {
       coreFiles[`agents/${stack.primary.toUpperCase()}-BACKEND-DEVELOPER.md`] = generateBackendAgent(ctx);
     }
     if (stack.hasFrontend) {
-      const fwName = stack.frameworks.find(f =>
-        ['Angular', 'Vue', 'Next.js', 'React'].includes(f)) || 'Frontend';
-      coreFiles[`agents/${fwName.toUpperCase().replace('.', '')}-FRONTEND-DEVELOPER.md`] = generateFrontendAgent(ctx);
+      const FRONTEND_FWS = ['Angular', 'Vue', 'Vue.js', 'Next.js', 'React', 'Nuxt', 'Svelte', 'Remix'];
+      const detectedFw = ctx.detectedFrameworks?.find(f => FRONTEND_FWS.includes(f.name));
+      const fwName = detectedFw?.name ||
+        stack.frameworks.find(f => FRONTEND_FWS.includes(f)) || 'Frontend';
+      coreFiles[`agents/${fwName.toUpperCase().replace('.', '').replace(/\s/g, '-')}-FRONTEND-DEVELOPER.md`] = generateFrontendAgent(ctx);
     }
     if (stack.hasMobile) {
       coreFiles['agents/FLUTTER-UI-DEVELOPER.md'] = generateMobileAgent(ctx);
@@ -348,12 +413,26 @@ export class AgentGenerator {
       coreFiles['skills/PROJECT-PATTERNS.md'] = skillsContent;
     }
 
-    // ── Write all files ──
+    // ── Data-driven Skills (real project data) ──
+    coreFiles['skills/ARCHITECT-INTEGRATION.md'] = generateArchitectIntegrationSkill(ctx);
+    coreFiles['skills/CI-PIPELINE.md'] = generateCIPipelineSkill(ctx);
+
+    const monorepoGuide = generateMonorepoGuideSkill(ctx);
+    if (monorepoGuide) {
+      coreFiles['skills/MONOREPO-GUIDE.md'] = monorepoGuide;
+    }
+
+    // ── Executable Hooks ──
+    coreFiles['hooks/pre-commit.sh'] = generatePreCommitHook(ctx);
+    coreFiles['hooks/pre-push.sh'] = generatePrePushHook(ctx);
+    coreFiles['hooks/post-analysis.sh'] = generatePostAnalysisHook(ctx);
+
+    // ── Write all files (with size cap) ──
     for (const [path, content] of Object.entries(coreFiles)) {
       const fullPath = join(agentDir, path);
       const dir = join(fullPath, '..');
       if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-      writeFileSync(fullPath, content);
+      writeFileSync(fullPath, this.capContent(content));
       generated.push(path);
     }
 

package/src/agent-generator/stack-detector.ts

@@ -3,7 +3,9 @@ import { StackInfo } from './types.js';
 
 /**
  * Detects the technology stack from an AnalysisReport.
- * Extracted from the monolithic AgentGenerator for single-responsibility.
+ *
+ * v5.1: Uses report.projectInfo.frameworks (precise, from scanner v5.0)
+ * instead of naive string-matching on file paths.
  */
 export class StackDetector {
   detect(report: AnalysisReport): StackInfo {
@@ -29,34 +31,44 @@ export class StackDetector {
     if (extensions.has('php')) languages.add('PHP');
     if (extensions.has('cs')) languages.add('C#');
 
-    // ── Framework Detection from file patterns ──
-    const allFiles = files.join(' ');
-    if (allFiles.includes('manage.py') || allFiles.includes('django')) frameworks.add('Django');
-    if (allFiles.includes('flask') || allFiles.includes('app.py')) frameworks.add('Flask');
-    if (allFiles.includes('fastapi')) frameworks.add('FastAPI');
-    if (allFiles.includes('.module.ts') || allFiles.includes('nest')) frameworks.add('NestJS');
-    if (allFiles.includes('.component.ts') || allFiles.includes('angular')) frameworks.add('Angular');
-    if (allFiles.includes('.vue')) frameworks.add('Vue');
-    if (allFiles.includes('.tsx') && allFiles.includes('next')) frameworks.add('Next.js');
-    if (allFiles.includes('.dart')) frameworks.add('Flutter');
-    if (allFiles.includes('go.mod')) frameworks.add('Go Modules');
-    if (allFiles.includes('Cargo.toml')) frameworks.add('Cargo');
-    if (allFiles.includes('pom.xml') || allFiles.includes('build.gradle')) frameworks.add('Spring');
-    if (allFiles.includes('rails') || allFiles.includes('Gemfile')) frameworks.add('Rails');
-    if (allFiles.includes('laravel') || allFiles.includes('artisan')) frameworks.add('Laravel');
+    // ── Framework Detection: Trust report.projectInfo.frameworks ──
+    // These come from scanner v5.0 which reads actual package.json dependencies
+    const reportFrameworks = report.projectInfo?.frameworks || [];
+    for (const fw of reportFrameworks) {
+      frameworks.add(fw);
+    }
 
     // ── Derived Properties ──
     const primary = languages.size > 0 ? [...languages][0] : 'Unknown';
 
-    const hasBackend = languages.has('Python') || languages.has('TypeScript') ||
+    // Frontend frameworks that indicate hasFrontend
+    const FRONTEND_FRAMEWORKS = new Set([
+      'Angular', 'Vue', 'Vue.js', 'Next.js', 'React', 'Nuxt', 'Nuxt.js',
+      'Svelte', 'SvelteKit', 'Remix', 'Gatsby', 'Vite',
+    ]);
+
+    // Backend frameworks that indicate hasBackend (language-based is fallback)
+    const BACKEND_FRAMEWORKS = new Set([
+      'Express', 'Express.js', 'NestJS', 'Fastify', 'Koa', 'Hapi',
+      'Django', 'Flask', 'FastAPI', 'Spring Boot', 'Laravel', 'Rails',
+      'Ruby on Rails', 'Gin', 'Echo', 'Fiber', 'Actix Web', 'Rocket',
+      'Probot', 'MCP SDK',
+    ]);
+
+    const MOBILE_FRAMEWORKS = new Set(['Flutter', 'React Native', 'Expo']);
+
+    const hasBackend = [...frameworks].some(f => BACKEND_FRAMEWORKS.has(f)) ||
+      languages.has('Python') || languages.has('TypeScript') ||
       languages.has('Go') || languages.has('Java/Kotlin') || languages.has('Ruby') ||
       languages.has('PHP') || languages.has('C#') || languages.has('Rust');
 
-    const hasFrontend = frameworks.has('Angular') || frameworks.has('Vue') ||
-      frameworks.has('Next.js') || frameworks.has('React') || extensions.has('html');
+    const hasFrontend = [...frameworks].some(f => FRONTEND_FRAMEWORKS.has(f)) ||
+      extensions.has('tsx') || extensions.has('jsx');
 
-    const hasMobile = languages.has('Dart') || frameworks.has('Flutter');
+    const hasMobile = [...frameworks].some(f => MOBILE_FRAMEWORKS.has(f)) ||
+      languages.has('Dart');
 
+    const allFiles = files.join(' ').toLowerCase();
     const hasDatabase = allFiles.includes('migration') || allFiles.includes('entity') ||
       allFiles.includes('model') || allFiles.includes('schema') ||
       allFiles.includes('prisma') || allFiles.includes('typeorm');

package/src/agent-generator/templates/core/agents.ts

@@ -148,8 +148,11 @@ ${crossRef('backend', ctx)}
 export function generateFrontendAgent(ctx: TemplateContext | EnrichedTemplateContext): string {
   const { stack, projectName, config, report } = ctx;
   const enriched = getEnriched(ctx);
-  const fw = stack.frameworks.find(f =>
-    ['Angular', 'Vue', 'Next.js', 'React'].includes(f)) || 'Frontend';
+  // v5.1: Use enriched primaryFramework or detect from all frameworks
+  const FRONTEND_FWS = ['Angular', 'Vue', 'Vue.js', 'Next.js', 'React', 'Nuxt', 'Svelte', 'Remix'];
+  const detectedFw = enriched.detectedFrameworks?.find(f => FRONTEND_FWS.includes(f.name));
+  const fw = detectedFw?.name ||
+    stack.frameworks.find(f => FRONTEND_FWS.includes(f)) || 'Frontend';
 
   // Build endpoints integration guide if available
   const endpointsGuide = enriched.endpoints && enriched.endpoints.length > 0

package/src/agent-generator/templates/core/hooks-generator.ts

@@ -0,0 +1,242 @@
+import { TemplateContext, EnrichedTemplateContext } from '../../types.js';
+import { getEnriched } from '../template-helpers.js';
+
+/**
+ * Generates executable hook scripts (.sh) for the .agent/hooks/ directory.
+ * These are real, runnable shell scripts tied to git lifecycle events.
+ *
+ * v5.1: Uses project-specific toolchain commands, score thresholds,
+ * and coverage targets from the enriched context.
+ */
+
+/**
+ * Pre-commit hook: lint + build check
+ */
+export function generatePreCommitHook(ctx: TemplateContext | EnrichedTemplateContext): string {
+  const enriched = getEnriched(ctx);
+  const tc = enriched.toolchain;
+  const config = ctx.config;
+  const projectName = ctx.projectName;
+
+  const lintCmd = tc?.lintCmd || 'npx eslint .';
+  const buildCmd = tc?.buildCmd || 'npm run build';
+
+  return `#!/bin/bash
+# ============================================================
+# PRE-COMMIT HOOK — ${projectName}
+# Gerado por Architect v5.1
+#
+# Instalação:
+#   cp .agent/hooks/pre-commit.sh .git/hooks/pre-commit
+#   chmod +x .git/hooks/pre-commit
+# ============================================================
+
+set -e
+
+echo "🔍 [pre-commit] Verificando qualidade do código..."
+
+# ── 1. Branch Safety ──
+BRANCH=$(git branch --show-current)
+if [[ "$BRANCH" == "main" || "$BRANCH" == "master" || "$BRANCH" == "staging" || "$BRANCH" == "develop" ]]; then
+  echo "❌ BLOQUEADO: Commit direto em '$BRANCH' é proibido."
+  echo "   Crie uma branch: git checkout -b feature/<nome>"
+  exit 1
+fi
+
+# ── 2. Secrets Check ──
+echo "🔐 Verificando secrets..."
+SECRETS_PATTERN='(password|secret|api[_-]?key|access[_-]?token|private[_-]?key)\\s*[:=]\\s*["\\'\\x60][^"\\x60]{8,}'
+
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
+if echo "$STAGED_FILES" | xargs grep -ilE "$SECRETS_PATTERN" 2>/dev/null; then
+  echo "❌ BLOQUEADO: Possível secret detectado nos arquivos staged."
+  echo "   Remova o secret e use variáveis de ambiente."
+  exit 1
+fi
+
+# ── 3. File Size Check ──
+echo "📏 Verificando tamanho de arquivos..."
+for file in $STAGED_FILES; do
+  if [ -f "$file" ]; then
+    LINES=$(wc -l < "$file" 2>/dev/null || echo "0")
+    if [ "$LINES" -gt 500 ]; then
+      echo "⚠️  AVISO: $file tem $LINES linhas (limite: 500)"
+    fi
+  fi
+done
+
+# ── 4. Lint ──
+echo "🧹 Executando lint..."
+${lintCmd} --quiet 2>/dev/null || {
+  echo "❌ BLOQUEADO: Lint falhou."
+  echo "   Corrija: ${lintCmd}"
+  exit 1
+}
+
+# ── 5. Build ──
+echo "🔨 Verificando build..."
+${buildCmd} 2>/dev/null || {
+  echo "❌ BLOQUEADO: Build falhou."
+  echo "   Corrija: ${buildCmd}"
+  exit 1
+}
+
+# ── 6. Debug Statements ──
+echo "🐛 Verificando debug statements..."
+if echo "$STAGED_FILES" | xargs grep -n 'console\\.log\\|debugger\\|print(' 2>/dev/null | grep -v 'node_modules' | grep -v '.test.'; then
+  echo "⚠️  AVISO: Debug statements encontrados. Remova antes do merge."
+fi
+
+echo "✅ [pre-commit] Tudo OK — commit liberado."
+exit 0
+`;
+}
+
+/**
+ * Pre-push hook: test + score gate
+ */
+export function generatePrePushHook(ctx: TemplateContext | EnrichedTemplateContext): string {
+  const enriched = getEnriched(ctx);
+  const tc = enriched.toolchain;
+  const config = ctx.config;
+  const projectName = ctx.projectName;
+
+  const testCmd = tc?.testCmd || 'npm test';
+  const coverageCmd = tc?.coverageCmd || 'npm run test -- --coverage';
+
+  return `#!/bin/bash
+# ============================================================
+# PRE-PUSH HOOK — ${projectName}
+# Gerado por Architect v5.1
+#
+# Instalação:
+#   cp .agent/hooks/pre-push.sh .git/hooks/pre-push
+#   chmod +x .git/hooks/pre-push
+# ============================================================
+
+set -e
+
+echo "🚀 [pre-push] Verificação completa antes do push..."
+
+# ── 1. Branch Safety ──
+BRANCH=$(git branch --show-current)
+if [[ "$BRANCH" == "main" || "$BRANCH" == "master" ]]; then
+  echo "❌ BLOQUEADO: Push direto para '$BRANCH' é proibido."
+  echo "   Use Pull Request."
+  exit 1
+fi
+
+# ── 2. Full Test Suite ──
+echo "🧪 Executando testes completos..."
+${testCmd} || {
+  echo "❌ BLOQUEADO: Testes falharam."
+  echo "   Corrija antes de fazer push."
+  exit 1
+}
+
+# ── 3. Coverage Gate ──
+echo "📊 Verificando cobertura (mínimo: ${config.coverageMinimum}%)..."
+COVERAGE_OUTPUT=$(${coverageCmd} 2>&1 || true)
+echo "$COVERAGE_OUTPUT" | tail -5
+
+# Parse coverage percentage (works with Jest/Istanbul output)
+COVERAGE=$(echo "$COVERAGE_OUTPUT" | grep -oP 'All files[^|]*\\|\\s*[\\d.]+' | grep -oP '[\\d.]+$' || echo "0")
+if [ -n "$COVERAGE" ]; then
+  COVERAGE_INT=\${COVERAGE%.*}
+  if [ "$COVERAGE_INT" -lt ${config.coverageMinimum} ] 2>/dev/null; then
+    echo "⚠️  AVISO: Cobertura ($COVERAGE_INT%) abaixo do mínimo (${config.coverageMinimum}%)"
+  fi
+fi
+
+# ── 4. Architecture Score Gate ──
+echo "🏗️ Verificando score de arquitetura (mínimo: ${config.scoreThreshold}/100)..."
+if command -v architect &> /dev/null; then
+  SCORE=$(architect score . --json 2>/dev/null | grep -oP '"overall":\\s*\\K[0-9]+' || echo "N/A")
+  if [ "$SCORE" != "N/A" ] && [ "$SCORE" -lt ${config.scoreThreshold} ] 2>/dev/null; then
+    echo "❌ BLOQUEADO: Score ($SCORE/100) abaixo do mínimo (${config.scoreThreshold}/100)"
+    exit 1
+  fi
+  echo "   Score: $SCORE/100 ✅"
+else
+  echo "   ⏭️  architect não instalado — skip score gate"
+fi
+
+echo "✅ [pre-push] Tudo OK — push liberado."
+exit 0
+`;
+}
+
+/**
+ * Post-analysis hook: remediation actions
+ */
+export function generatePostAnalysisHook(ctx: TemplateContext | EnrichedTemplateContext): string {
+  const enriched = getEnriched(ctx);
+  const projectName = ctx.projectName;
+  const report = ctx.report;
+
+  return `#!/bin/bash
+# ============================================================
+# POST-ANALYSIS HOOK — ${projectName}
+# Gerado por Architect v5.1
+#
+# Executa após 'architect analyze .' para gerar ações
+# de remediação automáticas.
+#
+# Uso:
+#   architect analyze . && bash .agent/hooks/post-analysis.sh
+# ============================================================
+
+set -e
+
+echo "🔧 [post-analysis] Processando resultados da análise..."
+
+REPORT_JSON="architect-report.json"
+REPORT_HTML="architect-report.html"
+
+# ── 1. Score Evolution ──
+CURRENT_SCORE=${report.score.overall}
+echo "📊 Score atual: $CURRENT_SCORE/100"
+echo "   Meta curto prazo: ${Math.min(100, report.score.overall + 5)}/100"
+echo "   Meta médio prazo: ${Math.min(100, report.score.overall + 10)}/100"
+
+# ── 2. Critical Anti-Patterns Alert ──
+CRITICAL_COUNT=$(grep -c '"severity":"CRITICAL"' "$REPORT_JSON" 2>/dev/null || echo "0")
+HIGH_COUNT=$(grep -c '"severity":"HIGH"' "$REPORT_JSON" 2>/dev/null || echo "0")
+
+if [ "$CRITICAL_COUNT" -gt 0 ]; then
+  echo ""
+  echo "🔴 ATENÇÃO: $CRITICAL_COUNT anti-patterns CRÍTICOS detectados!"
+  echo "   Resolva antes do próximo sprint."
+fi
+
+if [ "$HIGH_COUNT" -gt 0 ]; then
+  echo "🟠 $HIGH_COUNT anti-patterns HIGH detectados."
+fi
+
+# ── 3. Generate Summary ──
+echo ""
+echo "📋 Resumo:"
+echo "   Arquivos: ${report.projectInfo.totalFiles}"
+echo "   Linhas: ${report.projectInfo.totalLines.toLocaleString()}"
+echo "   Anti-patterns: ${report.antiPatterns.length}"
+echo ""
+
+# ── 4. Suggestions ──
+if [ -f "$REPORT_JSON" ]; then
+  echo "💡 Top 5 sugestões:"
+  cat "$REPORT_JSON" | python3 -c "
+import json, sys
+data = json.load(sys.stdin)
+for s in data.get('suggestions', [])[:5]:
+    print(f'   → {s.get(\"description\", \"\")}')
+" 2>/dev/null || echo "   (instale python3 para ver sugestões)"
+fi
+
+echo ""
+echo "📄 Report HTML: $REPORT_HTML"
+echo "📦 Report JSON: $REPORT_JSON"
+echo ""
+echo "✅ [post-analysis] Concluído."
+exit 0
+`;
+}