@mocoto/mahoraga 0.14.0 → 0.14.1

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);
@@ -111,8 +119,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 +131,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

package/dist/reports/report-patterns-usage.js

@@ -1,7 +1,11 @@
+// SPDX-License-Identifier: MIT
+// import { log } from '@nucleo/constelacao/log.js';
 import { getMessages } from '../core/messages/index.js';
 const { log, logRelatorio, MENSAGENS_RELATORIOS_ANALISE } = getMessages();
 export function exibirRelatorioPadroesUso() {
+    // Cabeçalho compatível com testes
     log.info(MENSAGENS_RELATORIOS_ANALISE.asyncPatterns.padroes);
+    // Moldura do cabeçalho (somente em runtime humano)
     if (!process.env.VITEST) {
         const titulo = 'Padrões de Uso do Código';
         const linhas = [];
@@ -9,6 +13,6 @@ export function exibirRelatorioPadroesUso() {
         const largura = logComBloco.calcularLargura ? logComBloco.calcularLargura(titulo, linhas, 84) : undefined;
         logComBloco.imprimirBloco(titulo, linhas, (string) => string, typeof largura === 'number' ? largura : 84);
     }
+    // Rodapé compatível com testes
     logRelatorio.fimPadroesUso();
 }
-//# sourceMappingURL=report-patterns-usage.js.map

package/dist/reports/report-pruning.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getMessages } from '../core/messages/index.js';
 import { salvarEstado } from '../shared/persistence/index.js';
 const { RelatorioMensagens } = getMessages();
@@ -61,4 +62,3 @@ export async function gerarRelatorioPodaJson(caminho, podados, mantidos) {
     };
     await salvarEstado(caminho, json);
 }
-//# sourceMappingURL=report-pruning.js.map

package/dist/reports/report-structure.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getMessages } from '../core/messages/index.js';
 const { RelatorioMensagens } = getMessages();
 export function gerarRelatorioEstrutura(mapa) {
@@ -24,4 +25,3 @@ export function gerarRelatorioEstrutura(mapa) {
         '',
     ].join('\\n');
 }
-//# sourceMappingURL=report-structure.js.map

package/dist/reports/report-type-definitions.js

@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos centralizados para relatórios
+ * Todos os tipos relacionados a geração de relatórios (MD/JSON)
+ */
+// ─── PROCESSAMENTO ────────────────────────────────────────────
+export * from './index.js';

package/dist/reports/streaming-report.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import fs from 'node:fs';
 import path from 'node:path';
 import { gunzipSync, gzipSync } from 'node:zlib';
@@ -46,8 +47,9 @@ export class RelatorioStream {
         return path.join(opts.outputDir, nome);
     }
     write(ocorrencia) {
-        if (this.finalized)
+        if (this.finalized) {
             return;
+        }
         this.manifest.totalOcorrencias++;
         this.currentShardOcorrencias++;
         this.buffer.push(ocorrencia);
@@ -65,8 +67,9 @@ export class RelatorioStream {
         }
     }
     flushBuffer() {
-        if (this.buffer.length === 0 || this.finalized)
+        if (this.buffer.length === 0 || this.finalized) {
             return;
+        }
         let dados = '';
         for (const ocorrencia of this.buffer) {
             dados += `${JSON.stringify(ocorrencia)}\n`;
@@ -105,9 +108,10 @@ export class RelatorioStream {
     getManifest() {
         return { ...this.manifest };
     }
-    async end(metadata) {
-        if (this.finalized)
+    end(metadata) {
+        if (this.finalized) {
             throw new Error(StreamingRelatorioMensagens.jaFinalizado);
+        }
         this.flushBuffer();
         this.finalized = true;
         if (this.currentShardOcorrencias > 0 || this.manifest.shards.length === 0) {
@@ -148,10 +152,9 @@ function descomprimirGzip(buf) {
         return buf;
     }
 }
-export async function criarStreamParaProjeto(outputDir, options) {
+export function criarStreamParaProjeto(outputDir, options) {
     return new RelatorioStream({
         outputDir,
         ...options,
     });
 }
-//# sourceMappingURL=streaming-report.js.map

package/dist/reports/streaming.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: MIT
+export {};

package/dist/reports/structure.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Tipos para relatórios de estrutura
+ */
+export {};

package/dist/scripts/index.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: MIT export type { AliasRule } from 'migrar-aliases.jsmigrar-aliases.js';
+export * from './migrar-aliases.js';

package/dist/scripts/migrar-aliases.js

@@ -0,0 +1,2 @@
+// SPDX-License-Identifier: MIT
+export {};

package/dist/sdk/analyzer.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { executarInquisicao, scanRepository } from '../core/execution/index.js';
 import { decifrarSintaxe } from '../core/parsing/index.js';
@@ -18,10 +19,12 @@ async function carregarTecnicas() {
 }
 function tecnicasParaArquivo(tecnicas, relPath) {
     return tecnicas.filter(t => {
-        if (t.global)
+        if (t.global) {
             return false;
-        if (!t.test)
+        }
+        if (!t.test) {
             return extensaoRelevante(relPath);
+        }
         return t.test(relPath);
     });
 }
@@ -52,6 +55,7 @@ export async function analyzeFile(filePath, content, baseDir) {
             }
         }
         catch {
+            // Silencia erros por analista
         }
     }
     return {
@@ -82,4 +86,3 @@ export async function analyzeProject(projectDir, opts) {
         tempoMs: performance.now() - inicio,
     };
 }
-//# sourceMappingURL=analyzer.js.map

package/dist/sdk/index.js

@@ -1,3 +1,2 @@
 export { analyzeFile, analyzeProject } from './analyzer.js';
 export { MahoragaSDK } from './sdk-legacy.js';
-//# sourceMappingURL=index.js.map

package/dist/sdk/sdk-legacy.js

@@ -1,5 +1,13 @@
+// SPDX-License-Identifier: MIT
 import { analistaGithubActions, analistaGithubActionsGlobal, registrarDetectorGithubActions } from '../analysts/github-actions/index.js';
+/**
+ * Mahoraga SDK Principal
+ * Fornece acesso programático aos analistas e sistema de plugins
+ */
 export const MahoragaSDK = {
+    /**
+     * Analisa um conteúdo de workflow individual
+     */
     async analisarGithubActions(conteudo, relPath = '.github/workflows/main.yml') {
         try {
             const res = await analistaGithubActions.aplicar(conteudo, relPath, null, undefined, undefined);
@@ -9,6 +17,9 @@ export const MahoragaSDK = {
             return [];
         }
     },
+    /**
+     * Analisa um repositório completo (Contexto global)
+     */
     async analisarRepositorio(contexto) {
         try {
             const res = await analistaGithubActionsGlobal.aplicar('', '', null, undefined, contexto);
@@ -18,6 +29,8 @@ export const MahoragaSDK = {
             return [];
         }
     },
+    /**
+     * Registra um novo plugin de detector
+     */
     registrarDetector: registrarDetectorGithubActions
 };
-//# sourceMappingURL=sdk-legacy.js.map

package/dist/shared/context-project.js

@@ -1,7 +1,11 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Detecta o contexto de um arquivo/projeto para análise inteligente
+ */
 export function detectarContextoProjeto(opcoes) {
     const { arquivo, conteudo, relPath, packageJson } = opcoes;
     const caminho = arquivo.replace(/\\/g, '/').toLowerCase();
-    const rel = (relPath || arquivo).replace(/\\/g, '/').toLowerCase();
+    const rel = (relPath ?? arquivo).replace(/\\/g, '/').toLowerCase();
     const contexto = {
         isBot: false,
         isCLI: false,
@@ -13,22 +17,31 @@ export function detectarContextoProjeto(opcoes) {
         frameworks: [],
         linguagens: []
     };
-    if (/\.(ts|tsx)$/.test(caminho))
+    // Detecta linguagens
+    if (/\.(ts|tsx)$/.test(caminho)) {
         contexto.linguagens.push('typescript');
-    if (/\.(js|jsx)$/.test(caminho))
+    }
+    if (/\.(js|jsx)$/.test(caminho)) {
         contexto.linguagens.push('javascript');
-    if (/\.(py)$/.test(caminho))
+    }
+    if (/\.(py)$/.test(caminho)) {
         contexto.linguagens.push('python');
-    if (/\.(php)$/.test(caminho))
+    }
+    if (/\.(php)$/.test(caminho)) {
         contexto.linguagens.push('php');
-    if (/\.(html|htm)$/.test(caminho))
+    }
+    if (/\.(html|htm)$/.test(caminho)) {
         contexto.linguagens.push('html');
-    if (/\.(css)$/.test(caminho))
+    }
+    if (/\.(css)$/.test(caminho)) {
         contexto.linguagens.push('css');
+    }
+    // Detecta se é arquivo de teste (PRIORIDADE ALTA - deve ser verificado primeiro)
     const isTestPath = /(^|\/)tests?(\/|\.)/i.test(rel) || /\.(test|spec)\.(ts|js|tsx|jsx)$/i.test(caminho) || /__tests__/.test(rel);
     const belongsToTestExt = /\.(ts|js|tsx|jsx)$/i.test(caminho);
     const hasTestContent = belongsToTestExt && (/^(describe|it|test|expect)\s*\(/m.test(conteudo) || /\.(it|test|describe|expect)\s*\(/m.test(conteudo));
     contexto.isTest = isTestPath || hasTestContent;
+    // Se é arquivo de teste, não deve ser classificado como outros tipos
     if (contexto.isTest) {
         return {
             ...contexto,
@@ -38,11 +51,16 @@ export function detectarContextoProjeto(opcoes) {
             isLibrary: false
         };
     }
-    contexto.isConfiguracao = /config|\.config\.|\.rc\.|\.json$|\.yaml$|\.yml$|\.env/.test(caminho) || /(^|\/)(\.|config|configs?)(\/|\.)/i.test(rel) || /package\.json|tsconfig|eslint|prettier|vitest|jest|babel/.test(caminho) || /stub|mock|fixture|example/i.test(caminho);
+    // Detecta se é arquivo de configuração
+    contexto.isConfiguracao = /config|\.config\.|\.rc\.|\.json$|\.yaml$|\.yml$|\.env/.test(caminho) || /(^|\/)(\.|config|configs?)(\/|\.)/i.test(rel) || /package\.json|tsconfig|eslint|prettier|vitest|jest|babel/.test(caminho) || /stub|mock|fixture|example/i.test(caminho); // Inclui stubs e mocks
+    // Detecta se é arquivo de infraestrutura (setup, main, index)
     contexto.isInfrastructure = /index\.|main\.|app\.|server\.|setup\.|bootstrap/.test(caminho) || /(client\.login|client\.connect|createApp|express\(\)|listen\(|server\.start)/.test(conteudo) || /export\s+default|module\.exports\s*=/.test(conteudo) || /(guardian|sentinela|verificador|hash|diff|baseline)/i.test(caminho) ||
-        /(monitor|watch|observer|scanner)/i.test(caminho);
-    const importMatches = conteudo.match(/import.*from.*['"`]([^'"`]+)['"`]|require\(['"`]([^'"`]+)['"`]\)/g) || [];
+        // Guardian e verificação
+        /(monitor|watch|observer|scanner)/i.test(caminho); // Monitoring
+    // Detecta frameworks por imports/requires
+    const importMatches = conteudo.match(/import.*from.*['"`]([^'"`]+)['"`]|require\(['"`]([^'"`]+)['"`]\)/g) ?? [];
     const allImports = importMatches.join(' ').toLowerCase();
+    // Frameworks de bot
     if (/discord\.js|@discordjs|eris/.test(allImports)) {
         contexto.frameworks.push('discord.js');
         contexto.isBot = true;
@@ -51,6 +69,7 @@ export function detectarContextoProjeto(opcoes) {
         contexto.frameworks.push('telegraf');
         contexto.isBot = true;
     }
+    // Frameworks CLI
     if (/commander|yargs|inquirer|chalk|ora/.test(allImports)) {
         contexto.frameworks.push('cli');
         contexto.isCLI = true;
@@ -59,6 +78,7 @@ export function detectarContextoProjeto(opcoes) {
         contexto.frameworks.push('oclif');
         contexto.isCLI = true;
     }
+    // Frameworks web
     if (/express|fastify|koa|hapi/.test(allImports)) {
         contexto.frameworks.push('backend');
         contexto.isWebApp = true;
@@ -71,22 +91,28 @@ export function detectarContextoProjeto(opcoes) {
         contexto.frameworks.push('fullstack');
         contexto.isWebApp = true;
     }
+    // Detecta por conteúdo específico se imports não cobrirem
     if (!contexto.isBot && /slash.*command|interaction\.|commandName|client\.on.*message/i.test(conteudo)) {
         contexto.isBot = true;
     }
     if (!contexto.isCLI && /process\.argv|command.*line|\.option\(|\.command\(/i.test(conteudo)) {
         contexto.isCLI = true;
     }
+    // Detecta se é arquivo de infraestrutura por conteúdo (NÃO é comando)
     if (/export\s+(interface|type|class.*\{)/i.test(conteudo) || /import.*types?.*from|export.*types?/i.test(conteudo) || /function\s+format|function\s+display|function\s+render/i.test(conteudo) || /console\.log|logger\.|\.write\(|\.render\(/i.test(conteudo)) {
         contexto.isInfrastructure = true;
     }
+    // Detecta se é biblioteca por estrutura de exports
     if (/export\s+(class|function|const|interface|type)|module\.exports/.test(conteudo) && !contexto.isWebApp && !contexto.isBot && !contexto.isCLI) {
         contexto.isLibrary = true;
     }
+    // Detecta por path patterns (mais específico)
     if (/(^|\/)bot(\/|\.|-)|discord|telegram/.test(rel)) {
         contexto.isBot = true;
     }
+    // CLI paths - mais específico para evitar falsos positivos
     if (/(^|\/)(cli|commands?|comandos?)(\/|\.|-)|bin\//.test(rel)) {
+        // Mas não se for apenas processamento, display, options, ou utilitários
         if (!/\/(processing|display|options|utils|helpers|types|interfaces)\//.test(rel) && !/\/(options|display|processing|filter|helper|util|type)\./.test(rel) && !/(options|processing|display|filter|helper|util|types?)[-.]/.test(caminho)) {
             contexto.isCLI = true;
         }
@@ -97,6 +123,7 @@ export function detectarContextoProjeto(opcoes) {
     if (packageJson) {
         detectarFrameworksPackageJson(packageJson, contexto);
     }
+    // Remove duplicatas
     contexto.frameworks = [...new Set(contexto.frameworks)];
     contexto.linguagens = [...new Set(contexto.linguagens)];
     return contexto;
@@ -124,12 +151,18 @@ function detectarFrameworksPackageJson(packageJson, contexto) {
         }
     }
 }
+/**
+ * Verifica se um arquivo é relevante para um tipo específico de análise
+ */
 export function isRelevanteParaAnalise(contexto, tipoAnalise) {
-    if (contexto.isTest || contexto.isConfiguracao || contexto.isInfrastructure)
+    // Nunca analise arquivos de teste, config ou infraestrutura para padrões específicos
+    if (contexto.isTest || contexto.isConfiguracao || contexto.isInfrastructure) {
         return false;
+    }
     switch (tipoAnalise) {
         case 'comando':
         case 'bot':
+            // Para análise de comando, deve ser bot/CLI E não ser infraestrutura
             return (contexto.isBot || contexto.isCLI) && !contexto.isInfrastructure;
         case 'cli':
             return contexto.isCLI && !contexto.isInfrastructure;
@@ -141,6 +174,9 @@ export function isRelevanteParaAnalise(contexto, tipoAnalise) {
             return true;
     }
 }
+/**
+ * Sugere frameworks baseado no contexto detectado
+ */
 export function sugerirFrameworks(contexto) {
     const sugestoes = [];
     if (contexto.isBot && !contexto.frameworks.some((arquivo) => arquivo.includes('discord') || arquivo.includes('telegraf'))) {
@@ -151,9 +187,11 @@ export function sugerirFrameworks(contexto) {
     }
     return sugestoes;
 }
+/**
+* Verifica se um caminho de arquivo pertence ao contexto de documentação.
+*/
 export function isContextoDocumentacao(relPath) {
     const arquivosDoc = ['readme', 'doc/', 'docs/', '.md', '.example', '.sample', '.template', 'third-party-notices', 'license', 'changelog'];
     const pathLower = relPath.toLowerCase();
     return arquivosDoc.some(pattern => pathLower.includes(pattern));
 }
-//# sourceMappingURL=context-project.js.map

package/dist/shared/data-processing/data-processing-stub.js

@@ -1,4 +1,3 @@
 export const dataProcessing = {
     fragmentarRelatorio: () => null,
 };
-//# sourceMappingURL=data-processing-stub.js.map

package/dist/shared/data-processing/fragment-report.js

@@ -1,27 +1,32 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { gzipSync } from 'node:zlib';
 import { config } from '../../core/config/index.js';
 import { salvarBinario, salvarEstado } from '../persistence/index.js';
 function chunkArray(arr, size) {
     const out = [];
-    for (let indice = 0; indice < arr.length; indice += size)
+    for (let indice = 0; indice < arr.length; indice += size) {
         out.push(arr.slice(indice, indice + size));
+    }
     return out;
 }
 export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
     const maxOcorrencias = options?.maxOcorrenciasPerShard ?? config.REPORT_FRAGMENT_OCCURRENCES ?? 2000;
     const maxArquivoEntries = options?.maxFileEntriesPerShard ?? config.REPORT_FRAGMENT_FILEENTRIES ?? 500;
     const topN = config.REPORT_FRAGMENT_SUMMARY_TOPN ?? 5;
+    // Normaliza a estrutura esperada
     const rel = relatorioFull;
     const resultado = rel && 'resultado' in rel ? rel.resultado : rel;
-    const ocorrencias = resultado && Array.isArray(resultado.ocorrencias) ? resultado.ocorrencias : [];
-    const fileEntries = resultado && Array.isArray(resultado.fileEntries) ? resultado.fileEntries : [];
+    const ocorrencias = resultado && Array.isArray((resultado).ocorrencias) ? (resultado).ocorrencias : [];
+    const fileEntries = resultado && Array.isArray((resultado).fileEntries) ? (resultado).fileEntries : [];
     const salvar = salvarEstado;
+    // Manifest que descreve as partes geradas
     const manifest = {
         generatedAt: new Date().toISOString(),
         baseNome: `mahoraga-relatorio-full-${ts}`,
         parts: []
     };
+    // Salva meta (tudo exceto ocorrencias/fileEntries)
     const meta = {
         ...rel
     };
@@ -39,6 +44,7 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
         file: metaFilename,
         bytes: metaGz.length
     });
+    // Fragmenta ocorrencias se necessário
     if (ocorrencias.length > 0) {
         const occPedacos = chunkArray(ocorrencias, maxOcorrencias);
         for (let indice = 0; indice < occPedacos.length; indice++) {
@@ -55,13 +61,15 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             const buf = Buffer.from(JSON.stringify(payload, null, 2), 'utf-8');
             const gz = gzipSync(buf);
             await salvarBinario(path.join(dir, fname), gz);
+            // Gerar resumo por shard: top tipos e top arquivos (relPath)
             const tiposContagem = {};
             const arquivosContagem = {};
             for (const ocorrencia of occPedacos[indice]) {
+                // Suporta formatos legados com 'type' e 'path' para compatibilidade
                 const oLegacy = ocorrencia;
                 const tipoOcorrencia = ocorrencia && (ocorrencia.tipo || oLegacy.type) ? String(ocorrencia.tipo ?? oLegacy.type) : 'desconhecido';
                 tiposContagem[tipoOcorrencia] = (tiposContagem[tipoOcorrencia] || 0) + 1;
-                const relp = ocorrencia && (ocorrencia.relPath || oLegacy.path) ? String(ocorrencia.relPath ?? oLegacy.path) : 'desconhecido';
+                const relp = ocorrencia && (ocorrencia.relPath || oLegacy.path) ? (ocorrencia.relPath ?? oLegacy.path) : 'desconhecido';
                 arquivosContagem[relp] = (arquivosContagem[relp] || 0) + 1;
             }
             const topTipos = Object.entries(tiposContagem).sort((arquivo, base) => base[1] - arquivo[1]).slice(0, topN).map(([chave, valor]) => ({
@@ -86,6 +94,7 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             });
         }
     }
+    // Fragmenta fileEntries (ASTs) se necessário
     if (fileEntries.length > 0) {
         const fePedacos = chunkArray(fileEntries, maxArquivoEntries);
         for (let indice = 0; indice < fePedacos.length; indice++) {
@@ -102,14 +111,17 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             const buf = Buffer.from(JSON.stringify(payload, null, 2), 'utf-8');
             const gz = gzipSync(buf);
             await salvarBinario(path.join(dir, fname), gz);
+            // Resumo por shard de fileEntries: top arquivos por tamanho (linhas) quando possível
             const arquivosResumo = [];
             for (const fe of fePedacos[indice]) {
+                // Suporta formato legado com 'path' para compatibilidade
                 const feLegacy = fe;
                 const rel = fe && (fe.relPath || fe.fullCaminho || feLegacy.path) ? String(fe.relPath ?? fe.fullCaminho ?? feLegacy.path) : 'desconhecido';
                 let linhas = undefined;
                 try {
-                    if (fe && typeof fe.content === 'string')
+                    if (fe && typeof fe.content === 'string') {
                         linhas = fe.content.split(/\r?\n/).length;
+                    }
                 }
                 catch { }
                 arquivosResumo.push({
@@ -131,6 +143,7 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
             });
         }
     }
+    // Salva o manifest final
     const manifestFilename = `mahoraga-relatorio-full-${ts}-manifest.json`;
     await salvar(path.join(dir, manifestFilename), manifest);
     return {
@@ -138,4 +151,3 @@ export async function fragmentarRelatorio(relatorioFull, dir, ts, options) {
         manifest
     };
 }
-//# sourceMappingURL=fragment-report.js.map

package/dist/shared/data-processing/index.js

@@ -1,6 +1,9 @@
+/**
+ * Módulo de processamento de dados
+ * Fornece utilitários para transformação e análise de dados
+ */
 export * from './data-processing-stub.js';
 export * from './fragment-report.js';
 export * from './json.js';
 export * from './occurrences.js';
 export const dataProcessing = { fragmentarRelatorio: () => null };
-//# sourceMappingURL=index.js.map