@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/reports/filter-smart.js

@@ -1,7 +1,19 @@
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-literal-inline-complexo
+// Justificativa: tipos locais para filtragem de relatórios
+// Sistema inteligente de filtragem e priorização de relatórios
+// Agrupa problemas similares e prioriza por impacto para evitar sobrecarga de informação
 import { getMessages } from '../core/messages/index.js';
+// Prefixos de diretórios de infraestrutura própria — ocorrências nestes caminhos
+// são inerentemente menos relevantes (complexidade esperada da ferramenta)
 const INFRA_PREFIXES = ['src/analistas/', 'src/core/messages/', 'src/bin/', 'src/cli/', 'src/shared/', 'extensions/', 'vitest.config.ts', 'THIRD-PARTY'];
 const { AGRUPAMENTOS_MENSAGEM, PRIORIDADES, RelatorioMensagens } = getMessages();
+/**
+ * Processa e filtra ocorrências para gerar um relatório resumido inteligente
+ */
 export function processarRelatorioResumo(ocorrencias, limitePrioridade = 30) {
+    // --- Pré-filtragem: identifica e colapsa ocorrências de infraestrutura própria ---
+    // Ex: dezenas de "ml-alta-probabilidade-bugs" em src/analistas/ são ruído esperado
     const ocorrenciasFiltradas = [];
     const contagemInfra = new Map();
     for (const ocorrencia of ocorrencias) {
@@ -9,7 +21,9 @@ export function processarRelatorioResumo(ocorrencias, limitePrioridade = 30) {
         const isInfraPath = INFRA_PREFIXES.some(prefix => relPath.startsWith(prefix));
         if (isInfraPath) {
             const chave = `${ocorrencia.tipo}::infra`;
-            contagemInfra.set(chave, (contagemInfra.get(chave) || 0) + 1);
+            contagemInfra.set(chave, (contagemInfra.get(chave) ?? 0) + 1);
+            // Só inclui a primeira ocorrência de cada tipo em infraestrutura
+            // para evitar poluir o relatório — as demais são colapsadas
             if (contagemInfra.get(chave) === 1) {
                 ocorrenciasFiltradas.push(ocorrencia);
             }
@@ -17,6 +31,7 @@ export function processarRelatorioResumo(ocorrencias, limitePrioridade = 30) {
         }
         ocorrenciasFiltradas.push(ocorrencia);
     }
+    // Adiciona itens colapsados como ocorrência única agregada
     for (const [chave, total] of contagemInfra) {
         const tipo = chave.split('::')[0];
         if (total > 1) {
@@ -30,11 +45,13 @@ export function processarRelatorioResumo(ocorrencias, limitePrioridade = 30) {
             });
         }
         else if (total === 1) {
+            // A única ocorrência já foi incluída individualmente
         }
     }
     const effectiveOcorrencias = ocorrenciasFiltradas.length > 0 ? ocorrenciasFiltradas : ocorrencias;
     const { gruposPorTipo, gruposPorMensagem } = agruparOcorrencias(effectiveOcorrencias);
     const problemasAgrupados = converterGruposEmProblemas(gruposPorTipo, gruposPorMensagem);
+    // Ordenar por prioridade e quantidade
     problemasAgrupados.sort((arquivo, base) => {
         const prioridadeOrdem = {
             critica: 0,
@@ -44,13 +61,16 @@ export function processarRelatorioResumo(ocorrencias, limitePrioridade = 30) {
         };
         const prioA = prioridadeOrdem[arquivo.prioridade];
         const prioB = prioridadeOrdem[base.prioridade];
-        if (prioA !== prioB)
+        if (prioA !== prioB) {
             return prioA - prioB;
-        return base.quantidade - arquivo.quantidade;
+        }
+        return base.quantidade - arquivo.quantidade; // Mais ocorrências primeiro
     });
+    // Separar por níveis de prioridade
     const problemasCriticos = problemasAgrupados.filter(caminho => caminho.prioridade === 'critica');
     const problemasAltos = problemasAgrupados.filter(caminho => caminho.prioridade === 'alta');
     const problemasOutros = problemasAgrupados.filter(caminho => ['media', 'baixa'].includes(caminho.prioridade));
+    // Calcular estatísticas
     const arquivosAfetados = new Set(effectiveOcorrencias.map(ocorrencia => ocorrencia.relPath).filter(path => path && path !== 'undefined')).size;
     const problemasPrioritarios = problemasCriticos.length + problemasAltos.length;
     return {
@@ -69,7 +89,7 @@ function agruparOcorrencias(ocorrencias) {
     const gruposPorTipo = new Map();
     const gruposPorMensagem = new Map();
     for (const ocorrencia of ocorrencias) {
-        const tipo = String(ocorrencia.tipo || 'OUTROS');
+        const tipo = (ocorrencia.tipo ?? 'OUTROS');
         if (!gruposPorTipo.has(tipo)) {
             gruposPorTipo.set(tipo, []);
         }
@@ -79,7 +99,7 @@ function agruparOcorrencias(ocorrencias) {
         }
     }
     for (const ocorrencia of ocorrencias) {
-        const mensagem = String(ocorrencia.mensagem || '');
+        const mensagem = (ocorrencia.mensagem || '');
         let agrupado = false;
         for (const grupo of AGRUPAMENTOS_MENSAGEM) {
             if (grupo.padrao.test(mensagem)) {
@@ -95,7 +115,7 @@ function agruparOcorrencias(ocorrencias) {
             }
         }
         if (!agrupado) {
-            const tipo = String(ocorrencia.tipo || 'OUTROS');
+            const tipo = (ocorrencia.tipo ?? 'OUTROS');
             if (!gruposPorMensagem.has(tipo)) {
                 gruposPorMensagem.set(tipo, []);
             }
@@ -110,12 +130,9 @@ function agruparOcorrencias(ocorrencias) {
 function converterGruposEmProblemas(gruposPorTipo, gruposPorMensagem) {
     const problemasAgrupados = [];
     for (const [tipo, ocorrenciasTipo] of gruposPorTipo) {
-        const config = PRIORIDADES[tipo] || {
-            prioridade: 'baixa',
-            icone: '??'
-        };
+        const config = PRIORIDADES[tipo];
         const jaAgrupado = Array.from(gruposPorMensagem.keys()).some(categoria => {
-            const ocorrenciasGrupo = gruposPorMensagem.get(categoria) || [];
+            const ocorrenciasGrupo = gruposPorMensagem.get(categoria) ?? [];
             return ocorrenciasGrupo.some(ocorrencia => ocorrencia.tipo === tipo);
         });
         if (!jaAgrupado && ocorrenciasTipo.length > 0) {
@@ -131,7 +148,7 @@ function converterGruposEmProblemas(gruposPorTipo, gruposPorMensagem) {
         }
     }
     for (const agrupamento of AGRUPAMENTOS_MENSAGEM) {
-        const ocorrenciasGrupo = gruposPorMensagem.get(agrupamento.categoria) || [];
+        const ocorrenciasGrupo = gruposPorMensagem.get(agrupamento.categoria) ?? [];
         if (ocorrenciasGrupo.length > 0) {
             problemasAgrupados.push({
                 categoria: agrupamento.categoria,
@@ -147,6 +164,9 @@ function converterGruposEmProblemas(gruposPorTipo, gruposPorMensagem) {
     }
     return problemasAgrupados;
 }
+/**
+ * Formata o título do tipo de problema para exibição
+ */
 function formatarTituloTipo(tipo) {
     const titulos = {
         PROBLEMA_SEGURANCA: 'Problemas de Segurança',
@@ -170,15 +190,19 @@ function formatarTituloTipo(tipo) {
     };
     return titulos[tipo] || tipo.replace(/_/g, ' ').replace(/\b\w/g, linha => linha.toUpperCase());
 }
+/**
+ * Gera um resumo das ocorrências para exibição
+ */
 function gerarResumoOcorrencias(ocorrencias) {
-    if (ocorrencias.length === 0)
+    if (ocorrencias.length === 0) {
         return 'Nenhuma ocorrência';
+    }
     const arquivos = new Set(ocorrencias.map(ocorrencia => ocorrencia.relPath).filter(Boolean));
     const niveisFrequentes = {};
     for (const nivel of ocorrencias.map(ocorrencia => ocorrencia.nivel).filter((nivel) => Boolean(nivel))) {
         niveisFrequentes[nivel] = (niveisFrequentes[nivel] || 0) + 1;
     }
-    const nivelMaisFrequente = Object.entries(niveisFrequentes).sort(([, arquivo], [, base]) => (base ?? 0) - (arquivo ?? 0))[0]?.[0];
+    const nivelMaisFrequente = Object.entries(niveisFrequentes).sort(([, arquivo], [, base]) => base - arquivo)[0]?.[0];
     let resumo = `${ocorrencias.length} ocorrências`;
     if (arquivos.size > 1) {
         resumo += ` em ${arquivos.size} arquivos`;
@@ -188,13 +212,18 @@ function gerarResumoOcorrencias(ocorrencias) {
     }
     return resumo;
 }
+/**
+ * Gera relatório Markdown resumido
+ */
 export async function gerarRelatorioMarkdownResumo(relatorioResumo, outputCaminho) {
     const { problemasCriticos, problemasAltos, problemasOutros, estatisticas } = relatorioResumo;
     const linhas = [];
+    // Cabeçalho usando mensagens centralizadas
     linhas.push(`# ${RelatorioMensagens.resumo.titulo}`);
     linhas.push('');
     linhas.push(`> ${RelatorioMensagens.resumo.introducao}`);
     linhas.push('');
+    // Estatisticas usando mensagens centralizadas
     linhas.push(`## ${RelatorioMensagens.resumo.secoes.estatisticas.titulo}`);
     linhas.push('');
     linhas.push(`- **${RelatorioMensagens.resumo.secoes.estatisticas.totalOcorrencias}**: ${estatisticas.totalOcorrencias.toLocaleString()}`);
@@ -205,6 +234,7 @@ export async function gerarRelatorioMarkdownResumo(relatorioResumo, outputCaminh
     escreverSecaoProblemasCriticos(linhas, problemasCriticos);
     escreverSecaoProblemasAltos(linhas, problemasAltos);
     escreverSecaoProblemasOutros(linhas, problemasOutros);
+    // Rodapé
     linhas.push('---');
     linhas.push('');
     linhas.push(RelatorioMensagens.resumo.filtroInteligente.dica);
@@ -220,8 +250,9 @@ export async function gerarRelatorioMarkdownResumo(relatorioResumo, outputCaminh
     }
 }
 function escreverSecaoProblemasCriticos(linhas, problemasCriticos) {
-    if (problemasCriticos.length === 0)
+    if (problemasCriticos.length === 0) {
         return;
+    }
     linhas.push(`## ${RelatorioMensagens.resumo.secoes.criticos.titulo}`);
     linhas.push('');
     for (const problema of problemasCriticos) {
@@ -249,8 +280,9 @@ function escreverSecaoProblemasCriticos(linhas, problemasCriticos) {
     }
 }
 function escreverSecaoProblemasAltos(linhas, problemasAltos) {
-    if (problemasAltos.length === 0)
+    if (problemasAltos.length === 0) {
         return;
+    }
     linhas.push(`## ${RelatorioMensagens.resumo.secoes.altos.titulo}`);
     linhas.push('');
     for (const problema of problemasAltos) {
@@ -264,8 +296,9 @@ function escreverSecaoProblemasAltos(linhas, problemasAltos) {
     }
 }
 function escreverSecaoProblemasOutros(linhas, problemasOutros) {
-    if (problemasOutros.length === 0)
+    if (problemasOutros.length === 0) {
         return;
+    }
     linhas.push(`## ${RelatorioMensagens.resumo.secoes.outros.titulo}`);
     linhas.push('');
     linhas.push('| Categoria | Quantidade | Resumo |');
@@ -275,12 +308,18 @@ function escreverSecaoProblemasOutros(linhas, problemasOutros) {
     }
     linhas.push('');
 }
+/**
+ * Gera resumo executivo mostrando apenas problemas críticos e de alta prioridade
+ * Ideal para tomada de decisão e overview rápido
+ */
 export function gerarResumoExecutivo(ocorrencias) {
     const relatorio = processarRelatorioResumo(ocorrencias);
     const problemasCriticos = relatorio.problemasCriticos.reduce((sum, caminho) => sum + caminho.quantidade, 0);
     const problemasAltos = relatorio.problemasAltos.reduce((sum, caminho) => sum + caminho.quantidade, 0);
+    // Contadores específicos
     const vulnerabilidades = ocorrencias.filter(ocorrencia => ocorrencia.tipo === 'VULNERABILIDADE_SEGURANCA' || ocorrencia.tipo === 'PROBLEMA_SEGURANCA').length;
     const quickFixes = ocorrencias.filter(ocorrencia => ocorrencia.tipo === 'QUICK_FIX_DISPONIVEL').length;
+    // Determina recomendação baseada em prioridade
     let recomendacao;
     let mensagem;
     if (problemasCriticos > 10) {
@@ -305,4 +344,3 @@ export function gerarResumoExecutivo(ocorrencias) {
         detalhes: [...relatorio.problemasCriticos, ...relatorio.problemasAltos]
     };
 }
-//# sourceMappingURL=filter-smart.js.map

package/dist/reports/fragmentation.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para fragmentação de relatórios
+ * Originalmente em: src/shared/data-processing/fragmentar-relatorio.ts
+ */
+export {};

package/dist/reports/generator-report.js

@@ -1,8 +1,11 @@
+// SPDX-License-Identifier: MIT
+// Gerador de relatórios: Markdown e JSON
 import { getMessages } from '../core/messages/index.js';
 export async function gerarRelatorioMarkdown(resultado, outputCaminho, modoBrief = false, options) {
     const { gerarHeaderRelatorio, gerarSecaoGuardian, gerarTabelaOcorrencias, gerarTabelaResumoTipos, RelatorioMensagens } = getMessages();
-    const { totalArquivos = 0, ocorrencias = [], guardian, timestamp = Date.now(), duracaoMs = 0 } = (resultado || {});
+    const { totalArquivos, ocorrencias, guardian, timestamp, duracaoMs } = resultado;
     const dataISO = new Date(timestamp).toISOString();
+    // Se modo brief, usar filtro inteligente
     if (modoBrief) {
         const { processarRelatorioResumo, gerarRelatorioMarkdownResumo } = await import('./index.js');
         const relatorioResumo = processarRelatorioResumo(ocorrencias);
@@ -10,15 +13,17 @@ export async function gerarRelatorioMarkdown(resultado, outputCaminho, modoBrief
         return;
     }
     const ocorrenciasOrdenadas = [...ocorrencias].sort((arquivo, base) => {
-        const ra = String(arquivo.relPath ?? '');
-        const rb = String(base.relPath ?? '');
+        const ra = arquivo.relPath;
+        const rb = base.relPath;
         const cmp = ra.localeCompare(rb);
-        if (cmp !== 0)
+        if (cmp !== 0) {
             return cmp;
+        }
         const la = typeof arquivo.linha === 'number' ? arquivo.linha : Number.MAX_SAFE_INTEGER;
         const lb = typeof base.linha === 'number' ? base.linha : Number.MAX_SAFE_INTEGER;
         return la - lb;
     });
+    // Extrair dados do Guardian
     const guardianData = guardian && typeof guardian === 'object' ? {
         status: 'status' in guardian ? String(guardian.status) : 'não executada',
         timestamp: 'timestamp' in guardian ? String(guardian.timestamp) : '-',
@@ -28,6 +33,7 @@ export async function gerarRelatorioMarkdown(resultado, outputCaminho, modoBrief
         timestamp: '-',
         totalArquivos: '-'
     };
+    // Montar o header usando template centralizado
     const lines = [];
     lines.push(...gerarHeaderRelatorio({
         dataISO,
@@ -35,7 +41,8 @@ export async function gerarRelatorioMarkdown(resultado, outputCaminho, modoBrief
         totalArquivos,
         totalOcorrencias: ocorrencias.length
     }));
-    if (options && options.manifestFile && options.relatoriosDir) {
+    // Se houver manifest, adiciona link e sumário rápido
+    if (options?.manifestFile && options.relatoriosDir) {
         const relPath = options.manifestFile;
         lines.push(`**${RelatorioMensagens.principal.secoes.metadados.arquivoManifest}:** \`${relPath}\`  `);
         lines.push('');
@@ -44,13 +51,16 @@ export async function gerarRelatorioMarkdown(resultado, outputCaminho, modoBrief
         lines.push('---');
         lines.push('');
     }
+    // Seção Guardian usando template
     lines.push(...gerarSecaoGuardian(guardianData));
+    // Sumário das ocorrências por tipo usando template
     const tiposContagem = {};
     for (const ocorrencia of ocorrencias) {
-        const tipo = ocorrencia && ocorrencia.tipo || 'desconhecido';
-        tiposContagem[String(tipo)] = (tiposContagem[String(tipo)] || 0) + 1;
+        const tipo = ocorrencia.tipo ?? 'desconhecido';
+        tiposContagem[tipo] = (tiposContagem[tipo] || 0) + 1;
     }
     lines.push(...gerarTabelaResumoTipos(tiposContagem, 10));
+    // Tabela com ocorrências usando template
     lines.push('---');
     lines.push('');
     lines.push(`## ${RelatorioMensagens.principal.secoes.ocorrencias.titulo} (amostra)`);
@@ -66,9 +76,10 @@ export async function gerarRelatorioMarkdown(resultado, outputCaminho, modoBrief
     await salvarEstado(outputCaminho, lines.join('\n'));
 }
 export async function gerarRelatorioJson(resultado, outputCaminho) {
+    // Importar sistema de versionamento
     const { criarRelatorioComVersao } = await import('../core/schema/index.js');
+    // Criar relatório versionado (mantemos metadados, mas salvamos os dados brutos para compatibilidade)
     const relatorioVersionado = criarRelatorioComVersao(resultado, undefined, 'Relatório completo de diagnóstico do Mahoraga');
     const { salvarEstado } = await import('../shared/persistence/index.js');
-    await salvarEstado(outputCaminho, relatorioVersionado.dados ?? resultado);
+    await salvarEstado(outputCaminho, relatorioVersionado.dados);
 }
-//# sourceMappingURL=generator-report.js.map

package/dist/reports/index.js

@@ -1,12 +1,25 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Report generation and analysis
+ */
+export * from './advisor.js';
 export * from './advisor-mahoraga.js';
+export * from './advisor-sukuna.js';
 export * from './analise-async-patterns.js';
+export * from './async-analysis.js';
+export * from './compliance.js';
 export * from './compliance/index.js';
 export * from './filter-smart.js';
+export * from './fragmentation.js';
 export * from './generator-report.js';
+export * from './processing.js';
+export * from './reader.js';
 export * from './report-archetypes.js';
 export * from './report-caretaker-health.js';
 export * from './report-patterns-usage.js';
 export * from './report-pruning.js';
 export * from './report-structure.js';
+export {} from './report-type-definitions.js';
+export * from './streaming.js';
 export * from './streaming-report.js';
-//# sourceMappingURL=index.js.map
+export * from './structure.js';

package/dist/reports/processing.js

@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Type guard para verificar se objeto é uma pendência processável
+ */
+export function isPendenciaProcessavel(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'arquivo' in obj &&
+        'motivo' in obj &&
+        typeof obj.arquivo === 'string' &&
+        typeof obj.motivo === 'string');
+}

package/dist/reports/reader.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para leitura de relatórios versionados
+ * Originalmente em: src/shared/helpers/leitor-relatorio.ts
+ */
+export {};

package/dist/reports/report-archetypes.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { messages } from '../core/messages/index.js';
 import { lerArquivoTexto, salvarEstado } from '../shared/persistence/index.js';
@@ -5,29 +6,37 @@ const { RelatorioMensagens, log } = messages;
 export async function exportarRelatorioArquetiposMarkdown(destino, candidatos, contexto, detalhado = false) {
     const linhas = [];
     linhas.push(`# ${RelatorioMensagens.arquetipos.titulo}`);
-    if (contexto?.origem)
+    if (contexto?.origem) {
         linhas.push(`*Origem: ${contexto.origem}*`);
+    }
     linhas.push('');
     const cols = RelatorioMensagens.arquetipos.secoes.candidatos;
     linhas.push(`| ${cols.nome} | ${cols.confianca} | ${cols.score} | Explicação | Sugestão |`);
     linhas.push('|---|---|---|---|---|');
     for (const elem of candidatos) {
         if (!detalhado) {
-            const missing = elem.missingRequired?.slice(0, 3) || [];
-            const forbidden = elem.forbiddenPresent?.slice(0, 3) || [];
-            const dependFalt = elem.dependencyMatches?.length === 0 && elem.dependencyMatches !== undefined ? elem.dependencyMatches : [];
+            // Relatório compacto
+            const missing = elem.missingRequired.slice(0, 3);
+            const forbidden = elem.forbiddenPresent.slice(0, 3);
+            const dependFalt = elem.dependencyMatches.length === 0 ? elem.dependencyMatches : [];
             let resumo = '';
-            if (missing.length)
+            if (missing.length) {
                 resumo += `Faltam pastas: ${missing.join(', ')}. `;
-            if (forbidden.length)
+            }
+            if (forbidden.length) {
                 resumo += `Estruturas proibidas: ${forbidden.join(', ')}. `;
-            if (dependFalt.length)
+            }
+            if (dependFalt.length) {
                 resumo += `Dependências ausentes: ${dependFalt.join(', ')}. `;
-            if (elem.sugestaoPadronizacao)
+            }
+            if (elem.sugestaoPadronizacao) {
                 resumo += elem.sugestaoPadronizacao.replace(/\n/g, ' ');
-            if (!resumo)
+            }
+            if (!resumo) {
                 resumo = 'Estrutura próxima do ideal.';
-            const explicacao = (elem.explicacaoSimilaridade || '').split('\n').slice(0, 2).join(' ');
+            }
+            // Compacta explicação
+            const explicacao = (elem.explicacaoSimilaridade ?? '').split('\n').slice(0, 2).join(' ');
             linhas.push(`| ${elem.nome} | ${elem.confidence} | ${elem.score} | ${explicacao} | ${resumo} |`);
         }
         else {
@@ -45,22 +54,27 @@ async function escreverSecaoDetalhadaArquetipo(linhas, elem) {
     linhas.push(`Confiança: ${elem.confidence} | Score: ${elem.score}`);
     linhas.push(`Explicação: ${elem.explicacaoSimilaridade?.replace(/\n/g, ' ')}`);
     linhas.push(`Sugestão: ${elem.sugestaoPadronizacao?.replace(/\n/g, ' ')}`);
-    if (elem.missingRequired?.length)
+    if (elem.missingRequired.length) {
         linhas.push(`Pastas faltantes (gravidade: crítico): ${elem.missingRequired.map(caminho => `${caminho} [mkdir ${caminho}]`).join(', ')}`);
-    if (elem.forbiddenPresent?.length)
+    }
+    if (elem.forbiddenPresent.length) {
         linhas.push(`Estruturas proibidas (gravidade: risco): ${elem.forbiddenPresent.join(', ')}`);
-    if (elem.dependencyMatches?.length)
+    }
+    if (elem.dependencyMatches.length) {
         linhas.push(`Dependências detectadas: ${elem.dependencyMatches.join(', ')}`);
-    if (elem.filePadraoMatches?.length)
+    }
+    if (elem.filePadraoMatches.length) {
         linhas.push(`Padrões de arquivos: ${elem.filePadraoMatches.join(', ')}`);
-    if (elem.anomalias?.length)
+    }
+    if (elem.anomalias.length) {
         linhas.push(`Anomalias: ${elem.anomalias.map(arquivo => `${arquivo.path} (${arquivo.motivo})`).join(', ')}`);
-    if (elem.missingRequired?.length) {
+    }
+    if (elem.missingRequired.length) {
         linhas.push('Sugestão de comandos:');
         elem.missingRequired.forEach(caminho => linhas.push(`  mkdir ${caminho}`));
     }
-    if (elem.dependencyMatches && Array.isArray(elem.dependencyMatches)) {
-        const ausentes = elem.dependencyMatches.length === 0 && elem.dependencyMatches !== undefined ? elem.dependencyMatches : [];
+    if (Array.isArray(elem.dependencyMatches)) {
+        const ausentes = elem.dependencyMatches.length === 0 ? elem.dependencyMatches : [];
         if (ausentes.length) {
             linhas.push('Sugestão de comandos para dependências:');
             ausentes.forEach(dep => linhas.push(`  npm install ${dep}`));
@@ -74,10 +88,11 @@ async function escreverSecaoDetalhadaArquetipo(linhas, elem) {
             cli: 'https://nodejs.org/api/cli.html',
             lib: 'https://www.typescriptlang.org/docs/'
         };
-        if (docLinks[elem.nome])
+        if (docLinks[elem.nome]) {
             linhas.push(`Documentação oficial: ${docLinks[elem.nome]}`);
+        }
     }
-    if (elem.dependencyMatches?.length) {
+    if (elem.dependencyMatches.length) {
         const fwLinks = {
             express: 'https://expressjs.com/pt-br/',
             react: 'https://react.dev/',
@@ -87,8 +102,9 @@ async function escreverSecaoDetalhadaArquetipo(linhas, elem) {
             telegraf: 'https://telegraf.js.org/'
         };
         elem.dependencyMatches.forEach(dep => {
-            if (fwLinks[dep])
+            if (fwLinks[dep]) {
                 linhas.push(`Doc ${dep}: ${fwLinks[dep]}`);
+            }
         });
     }
     if (elem.explicacaoSimilaridade && /função longa|require dinâmico|import misto|eval/.test(elem.explicacaoSimilaridade)) {
@@ -102,11 +118,13 @@ async function analisarDependenciasPackageJson(linhas) {
     try {
         const pkgCaminho = path.resolve(process.cwd(), 'package.json');
         const raw = await lerArquivoTexto(pkgCaminho);
-        if (!raw)
+        if (!raw) {
             return;
+        }
         const pkg = JSON.parse(raw);
-        if (!pkg || typeof pkg !== 'object' || !pkg.dependencies)
+        if (typeof pkg !== 'object' || !pkg.dependencies) {
             return;
+        }
         const deps = pkg.dependencies;
         for (const dep in deps) {
             if (/^0\./.test(deps[dep]) || /^\^0\./.test(deps[dep])) {
@@ -148,34 +166,42 @@ export async function exportarRelatorioArquetiposJson(destino, candidatos, conte
         origem: contexto?.origem ?? null,
         candidatos: candidatos.map(elem => {
             if (!detalhado) {
-                const missing = elem.missingRequired?.slice(0, 3) || [];
-                const forbidden = elem.forbiddenPresent?.slice(0, 3) || [];
-                const dependFalt = elem.dependencyMatches?.length === 0 && elem.dependencyMatches !== undefined ? elem.dependencyMatches : [];
+                // Compacto
+                const missing = elem.missingRequired.slice(0, 3);
+                const forbidden = elem.forbiddenPresent.slice(0, 3);
+                const dependFalt = elem.dependencyMatches.length === 0 ? elem.dependencyMatches : [];
                 let resumo = '';
-                if (missing.length)
+                if (missing.length) {
                     resumo += `Faltam pastas: ${missing.join(', ')}. `;
-                if (forbidden.length)
+                }
+                if (forbidden.length) {
                     resumo += `Estruturas proibidas: ${forbidden.join(', ')}. `;
-                if (dependFalt.length)
+                }
+                if (dependFalt.length) {
                     resumo += `Dependências ausentes: ${dependFalt.join(', ')}. `;
-                if (elem.sugestaoPadronizacao)
+                }
+                if (elem.sugestaoPadronizacao) {
                     resumo += elem.sugestaoPadronizacao.replace(/\n/g, ' ');
-                if (!resumo)
+                }
+                if (!resumo) {
                     resumo = 'Estrutura próxima do ideal.';
-                const explicacao = (elem.explicacaoSimilaridade || '').split('\n').slice(0, 2).join(' ');
+                }
+                // Compacta explicação
+                const explicacao = (elem.explicacaoSimilaridade ?? '').split('\n').slice(0, 2).join(' ');
                 return {
                     nome: elem.nome,
                     confidence: elem.confidence,
                     score: elem.score,
                     explicacao,
                     resumo,
-                    matchedRequired: elem.matchedRequired?.slice(0, 3) || [],
+                    matchedRequired: elem.matchedRequired.slice(0, 3),
                     missingRequired: missing,
                     forbiddenPresent: forbidden,
                     descricao: elem.descricao
                 };
             }
             else {
+                // Detalhado
                 return {
                     nome: elem.nome,
                     confidence: elem.confidence,
@@ -194,7 +220,9 @@ export async function exportarRelatorioArquetiposJson(destino, candidatos, conte
             }
         })
     };
-    const relatorioVersionado = criarRelatorioComVersao(relatorio, undefined, 'Relatório de detecção de arquétipos estruturais');
+    // Criar relatório com versão
+    const relatorioVersionado = criarRelatorioComVersao(relatorio, undefined, 
+    // usar versão atual
+    'Relatório de detecção de arquétipos estruturais');
     await salvarEstado(destino, relatorioVersionado);
 }
-//# sourceMappingURL=report-archetypes.js.map

package/dist/reports/report-caretaker-health.js

@@ -1,22 +1,29 @@
-import { estatisticasUsoGlobal } from '../analysts/js-ts/analysts/index.js';
+// SPDX-License-Identifier: MIT
 import { chalk, config } from '../core/config/index.js';
 import { getMessages } from '../core/messages/index.js';
+import { estatisticasUsoGlobal } from '../analysts/js-ts/analysts/index.js';
 const { log, logRelatorio, RelatorioMensagens, RelatorioZeladorSaudeMensagens } = getMessages();
+/**
+ * Emite um relatório sobre a saúde do código com base nas estatísticas gerais.
+ */
 export function exibirRelatorioZeladorSaude(ocorrencias) {
+    // Usa o helper centralizado de molduras, com largura fixa para manter bordas alinhadas
     const constsMap = estatisticasUsoGlobal.consts;
     const requiresMap = estatisticasUsoGlobal.requires;
-    const constExcessivas = Object.entries(constsMap || {}).filter(([, node]) => node > 3);
-    const requireRepetidos = Object.entries(requiresMap || {}).filter(([, node]) => node > 3);
+    const constExcessivas = Object.entries(constsMap ?? {}).filter(([, node]) => node > 3);
+    const requireRepetidos = Object.entries(requiresMap ?? {}).filter(([, node]) => node > 3);
     log.info(`\n${RelatorioMensagens.saude.titulo}:\n`);
     if (!process.env.VITEST) {
         imprimirCabecalhoMoldura();
     }
     if (ocorrencias.length > 0) {
         const logAviso = log.aviso;
-        if (typeof logAviso === 'function')
+        if (typeof logAviso === 'function') {
             logAviso('[AVISO] Funções longas encontradas:');
-        else
+        }
+        else {
             logRelatorio.funcoesLongas();
+        }
         const { porArquivo, totalOcorrencias, arquivosAfetados, maiorPorArquivo } = agregarOcorrenciasPorArquivo(ocorrencias);
         const mostrarTabela = config.RELATORIO_SAUDE_TABELA_ENABLED && !config.VERBOSE;
         const temImprimirBloco = typeof log.imprimirBloco === 'function';
@@ -47,6 +54,7 @@ export function exibirRelatorioZeladorSaude(ocorrencias) {
         }
         log.info('');
     }
+    // Rodapé usando mensagens centralizadas
     log.sucesso(RelatorioMensagens.saude.secoes.fim.titulo);
     if (!process.env.VITEST) {
         imprimirRodapeMoldura();
@@ -62,8 +70,8 @@ function imprimirCabecalhoMoldura() {
 function agregarOcorrenciasPorArquivo(ocorrencias) {
     const porArquivo = new Map();
     for (const ocorrencia of ocorrencias) {
-        const key = ocorrencia.relPath || ocorrencia.arquivo || '[desconhecido]';
-        porArquivo.set(key, (porArquivo.get(key) || 0) + 1);
+        const key = ocorrencia.relPath || (ocorrencia.arquivo ?? '[desconhecido]');
+        porArquivo.set(key, (porArquivo.get(key) ?? 0) + 1);
     }
     const totalOcorrencias = ocorrencias.length;
     const arquivosAfetados = porArquivo.size;
@@ -78,7 +86,7 @@ function exibirTabelaComMoldura(totalOcorrencias, arquivosAfetados, maiorPorArqu
     const col1Width = Math.max(header1.length, RelatorioZeladorSaudeMensagens.comFuncaoLonga.length, RelatorioZeladorSaudeMensagens.funcoesLongasTotal.length, RelatorioZeladorSaudeMensagens.maiorPorArquivo.length);
     const col2Width = Math.max(header2.length, String(totalOcorrencias).length, String(arquivosAfetados).length, String(maiorPorArquivo).length);
     const pinta = (node) => chalk.yellow(String(node).padStart(col2Width));
-    linhas.push(`${header1.padEnd(col1Width)}  ${header2.padStart(col2Width)}`, `${'-'.repeat(col1Width)}  ${'-'.repeat(col2Width)}`, `${RelatorioZeladorSaudeMensagens.comFuncaoLonga.padEnd(col1Width)}  ${pinta(arquivosAfetados)}`, `${RelatorioZeladorSaudeMensagens.funcoesLongasTotal.padEnd(col1Width)}  ${pinta(totalOcorrencias)}`, `${RelatorioZeladorSaudeMensagens.maiorPorArquivo.padEnd(col1Width)}  ${pinta(maiorPorArquivo)}`, ''.padEnd(col1Width + col2Width + 2, ' '), `${RelatorioZeladorSaudeMensagens.modoResumido.padStart(Math.floor(col1Width / 2) + 4).padEnd(col1Width + col2Width + 2)}`);
+    linhas.push(`${header1.padEnd(col1Width)}  ${header2.padStart(col2Width)}`, `${'-'.repeat(col1Width)}  ${'-'.repeat(col2Width)}`, `${RelatorioZeladorSaudeMensagens.comFuncaoLonga.padEnd(col1Width)}  ${pinta(arquivosAfetados)}`, `${RelatorioZeladorSaudeMensagens.funcoesLongasTotal.padEnd(col1Width)}  ${pinta(totalOcorrencias)}`, `${RelatorioZeladorSaudeMensagens.maiorPorArquivo.padEnd(col1Width)}  ${pinta(maiorPorArquivo)}`, ''.padEnd(col1Width + col2Width + 2, ' '), RelatorioZeladorSaudeMensagens.modoResumido.padStart(Math.floor(col1Width / 2) + 4).padEnd(col1Width + col2Width + 2));
     logBloco.imprimirBloco(RelatorioZeladorSaudeMensagens.funcoesLongasLabel, linhas, chalk.cyan.bold, logBloco.calcularLargura ? logBloco.calcularLargura(RelatorioZeladorSaudeMensagens.funcoesLongasLabel, linhas, config.COMPACT_MODE ? 84 : 96) : 84);
     log.info(RelatorioMensagens.saude.instrucoes.diagnosticoDetalhado);
     log.info(RelatorioMensagens.saude.instrucoes.tabelasVerbosas);
@@ -100,7 +108,8 @@ function exibirTabelaSimples(totalOcorrencias, arquivosAfetados, maiorPorArquivo
     log.info('');
 }
 function exibirModoVerboso(porArquivo) {
-    const logInfoRaw = (log.infoSemSanitizar || log.info).bind(log);
+    const logAny = log;
+    const logInfoRaw = (logAny.infoSemSanitizar ?? logAny.info).bind(log);
     const titulo = chalk.bold(RelatorioMensagens.saude.secoes.funcoesLongas.titulo);
     log.info(titulo);
     const colLeft = 50;
@@ -111,8 +120,9 @@ function exibirModoVerboso(porArquivo) {
         const numero = chalk.yellow(String(qtd).padStart(3));
         linhasDetalhe.push(`${left.padEnd(colLeft)}  ${numero}`);
     }
-    for (const linha of linhasDetalhe)
+    for (const linha of linhasDetalhe) {
         logInfoRaw(linha);
+    }
     log.info('');
 }
 function imprimirRodapeMoldura() {
@@ -122,4 +132,3 @@ function imprimirRodapeMoldura() {
     const larguraFim = logBloco.calcularLargura ? logBloco.calcularLargura(tituloFim, linhasFim, config.COMPACT_MODE ? 84 : 96) : undefined;
     logBloco.imprimirBloco(tituloFim, linhasFim, chalk.green.bold, typeof larguraFim === 'number' ? larguraFim : config.COMPACT_MODE ? 84 : 96);
 }
-//# sourceMappingURL=report-caretaker-health.js.map