@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/cli/commands/command-update.js

@@ -1,18 +1,19 @@
-import { registroAnalistas } from '../../analysts/registry/index.js';
-import { ExitCode, sair } from '../helpers/index.js';
+// SPDX-License-Identifier: MIT
+import { scanSystemIntegrity } from '../../guardian/index.js';
+import { Command } from 'commander';
 import { chalk, config } from '../../core/config/index.js';
 import { iniciarInquisicao } from '../../core/execution/index.js';
 import { getMessages } from '../../core/messages/index.js';
 import { ICONES_STATUS } from '../../core/messages/shared/index.js';
 import { executarShellSeguro } from '../../core/utils/index.js';
-import { scanSystemIntegrity } from '../../guardian/index.js';
-import { Command } from 'commander';
+import { registroAnalistas } from '../../analysts/registry/index.js';
+import { ExitCode, sair } from '../helpers/index.js';
 import { asTecnicas } from '../../types/index.js';
 const { log, logSistema, CliAtualizarExtraMensagens } = getMessages();
 export function comandoAtualizar(aplicarFlagsGlobais) {
     return new Command('atualizar').description(CliAtualizarExtraMensagens.descricao).option('--global', 'atualiza globalmente via npm i -g').action(async function (opts) {
         try {
-            await aplicarFlagsGlobais(this.parent && typeof this.parent.opts === 'function' ? this.parent.opts() : {});
+            aplicarFlagsGlobais(this.parent && typeof this.parent.opts === 'function' ? this.parent.opts() : {});
         }
         catch (err) {
             log.erro(CliAtualizarExtraMensagens.falhaAplicarFlags.replace('{erro}', err instanceof Error ? err.message : String(err)));
@@ -50,11 +51,11 @@ export function comandoAtualizar(aplicarFlagsGlobais) {
                     logSistema.atualizacaoDetalhes(diretorio);
                 });
             }
-            if (config.DEV_MODE)
+            if (config.DEV_MODE) {
                 log.erro(err instanceof Error ? err.message : String(err));
+            }
+            // Em ambiente de teste (Vitest), n\u00e3o encerre o processo para n\u00e3o derrubar o runner
             sair(ExitCode.Failure);
-            return;
         }
     });
 }
-//# sourceMappingURL=command-update.js.map

package/dist/cli/commands/commands.js

@@ -19,11 +19,16 @@ export function registrarComandos(program, aplicarFlagsGlobais) {
     program.addCommand(comandoGitlabCI());
     program.addCommand(comandoCircleCI());
     program.addCommand(comandoJenkins());
+    // Comando de manutenção de nomes (unificado: --scan para varrer, --apply para renomear)
     program.addCommand(comandoNames(aplicarFlagsGlobais));
+    // Registra comando de reversão
     registrarComandoReverter(program);
+    // Comando de imports e aliases
     program.addCommand(comandoImports());
+    // Comando de barrels
     program.addCommand(comandoBarrels());
+    // Compliance reports
     program.addCommand(comandoCompliance());
+    // Formatters plugin management
     program.addCommand(comandoFormatters());
 }
-//# sourceMappingURL=commands.js.map

package/dist/cli/commands/index.js

@@ -1,3 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Ponto de entrada único para todos os comandos da CLI do Mahoraga.
+ *
+ * Este arquivo centraliza as exportações de todos os comandos disponíveis,
+ * facilitando a manutenção e evitando múltiplas importações espalhadas.
+ */
+// Comandos principais
+export * from '../handlers/command-vulnerabilities.js';
 export * from './command-analysts.js';
 export * from './command-azure.js';
 export * from './command-circleci.js';
@@ -15,14 +24,17 @@ export * from './command-perf.js';
 export * from './command-plugins.js';
 export * from './command-prune.js';
 export * from './command-update.js';
-export * from './command-vulnerabilities.js';
+// Comando de reversão (diferente padrão de export)
 export * from './command-reverter.js';
+// Comando de manutenção de nomes (unificado)
 export * from './command-names.js';
+// Comando de imports
 export * from './command-imports.js';
+// Comando de barrels
 export * from './command-barrels.js';
 export * from './command-jenkins.js';
 export * from './command-marketplace.js';
+// Comandos adicionais
 export * from './command-compliance.js';
 export * from './command-formatters.js';
 export * from './commands.js';
-//# sourceMappingURL=index.js.map

package/dist/cli/diagnostic/auto-fix.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { config } from '../../core/config/index.js';
 import { messages } from '../../core/messages/index.js';
@@ -8,7 +9,7 @@ export async function executarAutoFixInterno(opts, ocorrenciasFiltradas, fileEnt
     }
     try {
         const { findQuickFixes, applyQuickFix, getAutoFixConfig } = await import('../../core/config/auto/index.js');
-        let autoCorrecaoMode = opts.autoCorrecaoMode || 'balanced';
+        let autoCorrecaoMode = opts.autoCorrecaoMode ?? 'balanced';
         if (opts.autoFixConservative) {
             autoCorrecaoMode = 'conservative';
             opts.autoFix = true;
@@ -32,14 +33,15 @@ export async function executarAutoFixInterno(opts, ocorrenciasFiltradas, fileEnt
         const correcoesPorArquivo = new Map();
         for (const fix of quickFixesDisponiveis) {
             const arquivo = fix.relPath || fix.arquivo;
-            if (!arquivo)
+            if (!arquivo) {
                 continue;
+            }
             if (!correcoesPorArquivo.has(arquivo)) {
                 correcoesPorArquivo.set(arquivo, []);
             }
             correcoesPorArquivo.get(arquivo)?.push(fix);
         }
-        const maxFixesPerArquivo = autoCorrecaoConfiguracao?.maxFixesPerArquivo ?? Infinity;
+        const maxFixesPerArquivo = autoCorrecaoConfiguracao.maxFixesPerArquivo;
         for (const [arquivo] of correcoesPorArquivo) {
             try {
                 const fileEntrada = fileEntriesComAst?.find(fe => fe.relPath === arquivo || fe.fullCaminho === arquivo);
@@ -104,7 +106,7 @@ export async function executarAutoFixInterno(opts, ocorrenciasFiltradas, fileEnt
                 estatisticas.push('modo conservador (alta confiança apenas)');
             }
             logSistema.autoFixEstatisticas(estatisticas);
-            if (process.env.MAHORAGA_ESLINT_VALIDATION !== '0' &&
+            if (process.env.SUKUNA_ESLINT_VALIDATION !== '0' &&
                 autoCorrecaoConfiguracao.validateAfterFix) {
                 try {
                     log.info(MENSAGENS_AUTOFIX.logs.validacaoEslint);
@@ -117,7 +119,7 @@ export async function executarAutoFixInterno(opts, ocorrenciasFiltradas, fileEnt
                             stdio: 'pipe',
                         });
                         let stdout = '';
-                        proc.stdout?.on('data', (data) => {
+                        proc.stdout.on('data', (data) => {
                             stdout += data;
                         });
                         const ESLINT_TIMEOUT_MS = 30_000;
@@ -168,4 +170,3 @@ export async function executarAutoFixInterno(opts, ocorrenciasFiltradas, fileEnt
         return { ocorrenciasFiltradas, totalOcorrencias: ocorrenciasFiltradas.length };
     }
 }
-//# sourceMappingURL=auto-fix.js.map

package/dist/cli/diagnostic/exporters/compliance-exporter.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export function exportarComplianceJson(relatorio) {
     return JSON.stringify(relatorio, null, 2);
 }
@@ -50,4 +51,3 @@ export function exportarComplianceMarkdown(relatorio) {
     secoes.push(`---\n*Relatório gerado por Mahoraga em ${new Date().toLocaleString('pt-BR')}*`);
     return secoes.join('\n');
 }
-//# sourceMappingURL=compliance-exporter.js.map

package/dist/cli/diagnostic/exporters/index.js

@@ -1,6 +1,9 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Diagnosis exporters (JSON, Markdown, Sharded, SVG)
+ */
 export * from './compliance-exporter.js';
 export * from './json-exporter.js';
 export * from './markdown-exporter.js';
 export * from './sharded-exporter.js';
 export * from './svg-optimization-exporter.js';
-//# sourceMappingURL=index.js.map

package/dist/cli/diagnostic/exporters/json-exporter.js

@@ -1,7 +1,23 @@
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: 2025 Mahoraga Contributors
+/**
+ * @module cli/diagnostico/exporters/json-exporter
+ * @description Exportador JSON com suporte a ASCII escape e fragmentação
+ * @see docs/REFACTOR-CLI-DIAGNOSTICAR.md - Sprint 2
+ */
 import fs from 'node:fs';
 import path from 'node:path';
 import { getMessages } from '../../../core/messages/index.js';
+// ─── Função Principal ─────────────────────────────────────────
+/**
+ * Gera relatório JSON a partir dos dados do diagnóstico
+ *
+ * @param dados - Dados do diagnóstico
+ * @param options - Opções de exportação
+ * @returns String JSON formatada
+ */
 export function gerarRelatorioJson(dados, options = {}) {
+    // Normalizar options
     const opts = {
         escapeAscii: options.escapeAscii ?? true,
         includeDetails: options.includeDetails ?? true,
@@ -9,20 +25,24 @@ export function gerarRelatorioJson(dados, options = {}) {
         compact: options.compact ?? false,
         maxOcorrencias: options.maxOcorrencias
     };
-    let ocorrencias = dados.ocorrencias || [];
+    // Processar ocorrências
+    let ocorrencias = dados.ocorrencias ?? [];
     if (opts.maxOcorrencias && ocorrencias.length > opts.maxOcorrencias) {
         ocorrencias = ocorrencias.slice(0, opts.maxOcorrencias);
     }
+    // Construir relatório
     const relatorio = {
-        metadata: dados.metadata || {
+        metadata: dados.metadata ?? {
             timestamp: new Date().toISOString(),
             schemaVersion: '1.0.0',
             modo: 'full',
             flags: [],
             mahoragaVersion: (() => {
                 try {
+                    // Evita dependência direta de package.json fora do build
+                    // Em runtime, pode ser enriquecido pela CLI
                     const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
-                    return pkg.version || 'unknown';
+                    return pkg.version ?? 'unknown';
                 }
                 catch {
                     return 'unknown';
@@ -31,14 +51,14 @@ export function gerarRelatorioJson(dados, options = {}) {
             projectNome: (() => {
                 try {
                     const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8'));
-                    return pkg.name || 'unknown';
+                    return pkg.name ?? 'unknown';
                 }
                 catch {
                     return 'unknown';
                 }
             })()
         },
-        stats: dados.stats || {
+        stats: dados.stats ?? {
             arquivosAnalisados: 0,
             arquivosComProblemas: 0,
             totalOcorrencias: 0,
@@ -66,28 +86,40 @@ export function gerarRelatorioJson(dados, options = {}) {
             sugestoes: dados.sugestoes
         })
     };
+    // Serializar para JSON
     const indent = opts.compact ? 0 : 2;
     let json = JSON.stringify(relatorio, null, indent);
+    // Aplicar escape ASCII se solicitado
     if (opts.escapeAscii) {
         json = escapeNonAscii(json);
     }
+    // Aplicar tradução de campos conforme o locale ativo
     json = traduzirRelatorioJson(json);
     return json;
 }
+// ─── Helpers de Escape ────────────────────────────────────────
+/**
+ * Escapa caracteres não-ASCII como \uXXXX
+ * Trata pares substitutos para emojis e caracteres fora do BMP
+ */
 function escapeNonAscii(str) {
     let resultado = '';
     let indice = 0;
     while (indice < str.length) {
         const code = str.charCodeAt(indice);
+        // ASCII básico (0-127) - manter como está
         if (code < 128) {
             resultado += str[indice];
             indice++;
             continue;
         }
+        // High surrogate (início de par substituto)
         if (code >= 0xd800 && code <= 0xdbff) {
+            // Verificar se há low surrogate seguinte
             if (indice + 1 < str.length) {
                 const nextCodigo = str.charCodeAt(indice + 1);
                 if (nextCodigo >= 0xdc00 && nextCodigo <= 0xdfff) {
+                    // Par substituto válido - escapar ambos
                     resultado += `\\u${code.toString(16).padStart(4, '0')}`;
                     resultado += `\\u${nextCodigo.toString(16).padStart(4, '0')}`;
                     indice += 2;
@@ -95,16 +127,22 @@ function escapeNonAscii(str) {
                 }
             }
         }
+        // Caractere BMP não-ASCII ou surrogate isolado
         resultado += `\\u${code.toString(16).padStart(4, '0')}`;
         indice++;
     }
     return resultado;
 }
+/**
+ * Traduz os campos de um JSON de relatório conforme o locale ativo
+ * Usa o CAMPO_ROTULOS do locale para renomear as chaves
+ */
 export function traduzirRelatorioJson(json) {
     try {
         const { CAMPO_ROTULOS } = getMessages();
-        if (!CAMPO_ROTULOS || Object.keys(CAMPO_ROTULOS).length === 0)
+        if (Object.keys(CAMPO_ROTULOS).length === 0) {
             return json;
+        }
         const obj = JSON.parse(json);
         const traduzido = traduzirObjeto(obj, CAMPO_ROTULOS);
         return JSON.stringify(traduzido, null, 2);
@@ -127,6 +165,9 @@ function traduzirObjeto(obj, rotulos) {
     }
     return obj;
 }
+/**
+ * Valida se uma string JSON está bem formada
+ */
 export function validarJson(json) {
     try {
         JSON.parse(json);
@@ -142,6 +183,10 @@ export function validarJson(json) {
         };
     }
 }
+// ─── Helpers de Construção ────────────────────────────────────
+/**
+ * Cria objeto de metadata para o relatório
+ */
 export function criarMetadata(modo, flags, filtros) {
     return {
         timestamp: new Date().toISOString(),
@@ -153,6 +198,9 @@ export function criarMetadata(modo, flags, filtros) {
         })
     };
 }
+/**
+ * Cria objeto de stats a partir de ocorrências
+ */
 export function criarStats(ocorrencias) {
     const porNivel = {
         erro: 0,
@@ -163,13 +211,16 @@ export function criarStats(ocorrencias) {
     const porRegra = {};
     const arquivosSet = new Set();
     for (const ocorrencia of ocorrencias) {
-        const nivel = ocorrencia.nivel || 'info';
+        // Contar por nível (type-safe)
+        const nivel = ocorrencia.nivel ?? 'info';
         if (nivel === 'erro' || nivel === 'aviso' || nivel === 'info') {
             porNivel[nivel] = porNivel[nivel] + 1;
         }
-        const tipo = ocorrencia.tipo || 'outros';
+        // Contar por categoria/tipo
+        const tipo = ocorrencia.tipo ?? 'outros';
         porCategoria[tipo] = (porCategoria[tipo] || 0) + 1;
         porRegra[tipo] = (porRegra[tipo] || 0) + 1;
+        // Rastrear arquivos únicos
         if (ocorrencia.relPath) {
             arquivosSet.add(ocorrencia.relPath);
         }
@@ -184,6 +235,9 @@ export function criarStats(ocorrencias) {
         byRule: porRegra
     };
 }
+/**
+ * Cria objeto de linguagens a partir de extensões
+ */
 export function criarLinguagens(extensoes) {
     const total = Object.values(extensoes).reduce((sum, count) => sum + count, 0);
     return {
@@ -191,4 +245,3 @@ export function criarLinguagens(extensoes) {
         extensoes
     };
 }
-//# sourceMappingURL=json-exporter.js.map

package/dist/cli/diagnostic/exporters/markdown-exporter.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: 2025 Mahoraga Contributors
+// ─── Função Principal ─────────────────────────────────────────
+/**
+ * Gera relatório Markdown formatado
+ */
 export function gerarRelatorioMarkdown(dados, options = {}) {
     const opts = {
         includeToc: options.includeToc ?? true,
@@ -12,31 +18,41 @@ export function gerarRelatorioMarkdown(dados, options = {}) {
         subtitulo: options.subtitulo
     };
     const secoes = [];
+    // Cabeçalho
     secoes.push(gerarCabecalho(opts.titulo ?? 'Relatório de Diagnóstico', opts.subtitulo, dados.metadata));
+    // Índice
     if (opts.includeToc) {
         secoes.push(gerarIndice(opts, dados));
     }
+    // Estatísticas
     if (opts.includeStats && dados.stats) {
         secoes.push(gerarSecaoStats(dados.stats, dados.linguagens));
     }
+    // Guardian
     if (opts.includeGuardian && dados.guardian?.executado) {
         secoes.push(gerarSecaoGuardian(dados.guardian));
     }
+    // Arquetipos
     if (opts.includeArquetipos && dados.arquetipos?.executado) {
         secoes.push(gerarSecaoArquetipos(dados.arquetipos));
     }
+    // Auto-fix
     if (opts.includeAutoFix && dados.autoFix?.executado) {
         secoes.push(gerarSecaoAutoFix(dados.autoFix));
     }
+    // Ocorrências
     if (opts.includeOcorrencias && dados.ocorrencias && dados.ocorrencias.length > 0) {
         secoes.push(gerarSecaoOcorrencias(dados.ocorrencias, opts));
     }
+    // Sugestões
     if (dados.sugestoes && dados.sugestoes.length > 0) {
         secoes.push(gerarSecaoSugestoes(dados.sugestoes));
     }
+    // Rodapé
     secoes.push(gerarRodape());
     return secoes.join('\n\n---\n\n');
 }
+// ─── Seções do Relatório ──────────────────────────────────────
 function gerarCabecalho(titulo, subtitulo, metadata) {
     let md = `# ${titulo}\n\n`;
     if (subtitulo) {
@@ -75,6 +91,7 @@ function gerarIndice(opts, dados) {
 }
 function gerarSecaoStats(stats, linguagens) {
     let md = '## [GRAFICO] Estatísticas\n\n';
+    // Tabela principal
     md += '| Métrica | Valor |\n';
     md += '|---|---|\n';
     md += `| Arquivos analisados | ${stats.arquivosAnalisados} |\n`;
@@ -84,26 +101,29 @@ function gerarSecaoStats(stats, linguagens) {
         const tempoSeg = (stats.tempoExecucao / 1000).toFixed(2);
         md += `| Tempo de execução | ${tempoSeg}s |\n`;
     }
+    // Breakdown por nível
     md += '\n### Por Nível\n\n';
     md += '| Nível | Quantidade |\n';
     md += '|---|---|\n';
     md += `| [ERRO] Erro | ${stats.porNivel.erro} |\n`;
     md += `| [AVISO] Aviso | ${stats.porNivel.aviso} |\n`;
     md += `| [INFO] Info | ${stats.porNivel.info} |\n`;
+    // Breakdown por categoria
     if (Object.keys(stats.porCategoria).length > 0) {
         md += '\n### Por Categoria\n\n';
         md += '| Categoria | Quantidade |\n';
         md += '|---|---|\n';
-        const categorias = Object.entries(stats.porCategoria).sort((arquivo, base) => base[1] - arquivo[1]).slice(0, 10);
+        const categorias = Object.entries(stats.porCategoria).sort((arquivo, base) => base[1] - arquivo[1]).slice(0, 10); // Top 10
         for (const [categoria, count] of categorias) {
             md += `| ${categoria} | ${count} |\n`;
         }
     }
+    // Linguagens
     if (linguagens && Object.keys(linguagens.extensoes).length > 0) {
         md += '\n### Linguagens Detectadas\n\n';
         md += '| Extensão | Arquivos |\n';
         md += '|---|---|\n';
-        const extensoes = Object.entries(linguagens.extensoes).sort((arquivo, base) => base[1] - arquivo[1]).slice(0, 10);
+        const extensoes = Object.entries(linguagens.extensoes).sort((arquivo, base) => base[1] - arquivo[1]).slice(0, 10); // Top 10
         for (const [ext, count] of extensoes) {
             md += `| .${ext} | ${count} |\n`;
         }
@@ -171,6 +191,7 @@ function gerarSecaoAutoFix(autoFix) {
 }
 function gerarSecaoOcorrencias(ocorrencias, opts) {
     let md = '## [BUSCA] Ocorrências\n\n';
+    // Limitar se necessário
     let lista = ocorrencias;
     if (opts.maxOcorrencias && lista.length > opts.maxOcorrencias) {
         lista = lista.slice(0, opts.maxOcorrencias);
@@ -190,8 +211,8 @@ function gerarTabelaOcorrencias(ocorrencias) {
     for (const ocorrencia of ocorrencias) {
         const arquivo = ocorrencia.relPath || 'desconhecido';
         const linha = ocorrencia.linha ?? '-';
-        const nivel = getNivelIcon(ocorrencia.nivel || 'info');
-        const tipo = ocorrencia.tipo || 'outros';
+        const nivel = getNivelIcon(ocorrencia.nivel ?? 'info');
+        const tipo = ocorrencia.tipo ?? 'outros';
         const rawMensagem = ocorrencia.mensagem;
         const mensagemEscapada = rawMensagem.replace(/\\/g, '\\\\').replace(/\|/g, '\\|');
         const mensagem = mensagemEscapada.slice(0, 80);
@@ -215,7 +236,7 @@ function gerarOcorrenciasPorArquivo(ocorrencias) {
     for (const [arquivo, lista] of porArquivo) {
         md += `### [FILE] ${arquivo}\n\n`;
         for (const ocorrencia of lista) {
-            const nivel = getNivelIcon(ocorrencia.nivel || 'info');
+            const nivel = getNivelIcon(ocorrencia.nivel ?? 'info');
             const linha = ocorrencia.linha ? `:${ocorrencia.linha}` : '';
             md += `- ${nivel} **${ocorrencia.tipo}**${linha}: ${ocorrencia.mensagem}\n`;
         }
@@ -233,6 +254,7 @@ function gerarSecaoSugestoes(sugestoes) {
 function gerarRodape() {
     return `---\n\n*Gerado por Mahoraga v0.2.0 em ${new Date().toLocaleString('pt-BR')}*`;
 }
+// ─── Helpers ──────────────────────────────────────────────────
 function getNivelIcon(nivel) {
     switch (nivel) {
         case 'erro':
@@ -245,7 +267,9 @@ function getNivelIcon(nivel) {
             return '•';
     }
 }
+/**
+ * Escapa caracteres especiais do Markdown
+ */
 export function escaparMarkdown(texto) {
     return texto.replace(/\\/g, '\\\\').replace(/\*/g, '\\*').replace(/_/g, '\\_').replace(/\[/g, '\\[').replace(/\]/g, '\\]').replace(/\(/g, '\\(').replace(/\)/g, '\\)').replace(/`/g, '\\`');
 }
-//# sourceMappingURL=markdown-exporter.js.map

package/dist/cli/diagnostic/exporters/sharded-exporter.js

@@ -1,7 +1,20 @@
-export async function fragmentarRelatorio(dados, options) {
-    const ocorrencias = dados.ocorrencias || [];
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: 2025 Mahoraga Contributors
+// @mahoraga-disable tipo-literal-inline-complexo
+// Justificativa: tipos locais para manipulação de shards
+// ─── Função Principal ─────────────────────────────────────────
+/**
+ * Fragmenta relatório em múltiplos arquivos
+ *
+ * Esta função é um placeholder para implementação futura.
+ * Por enquanto, retorna estrutura básica sem criar arquivos reais.
+ */
+export function fragmentarRelatorio(dados, options) {
+    const ocorrencias = dados.ocorrencias ?? [];
     const totalOcorrencias = ocorrencias.length;
+    // Calcular número de shards necessários
     const numShards = Math.ceil(totalOcorrencias / options.ocorrenciasPorShard);
+    // Se não precisa fragmentar, retornar shard único
     if (numShards <= 1) {
         return {
             sucesso: true,
@@ -19,6 +32,7 @@ export async function fragmentarRelatorio(dados, options) {
             }
         };
     }
+    // Gerar informações dos shards
     const shards = [];
     for (let indice = 0; indice < numShards; indice++) {
         const inicio = indice * options.ocorrenciasPorShard;
@@ -48,6 +62,10 @@ export async function fragmentarRelatorio(dados, options) {
         }
     };
 }
+// ─── Helpers de Fragmentação ──────────────────────────────────
+/**
+ * Divide array de ocorrências em chunks
+ */
 export function dividirOcorrencias(ocorrencias, tamanhoChunk) {
     const chunks = [];
     for (let indice = 0; indice < ocorrencias.length; indice += tamanhoChunk) {
@@ -55,6 +73,9 @@ export function dividirOcorrencias(ocorrencias, tamanhoChunk) {
     }
     return chunks;
 }
+/**
+ * Calcula estatísticas de fragmentação
+ */
 export function calcularEstatisticasFragmentacao(ocorrencias, tamanhoShard) {
     const numShards = Math.ceil(ocorrencias.length / tamanhoShard);
     const tamanhoMedio = ocorrencias.length / numShards;
@@ -65,12 +86,18 @@ export function calcularEstatisticasFragmentacao(ocorrencias, tamanhoShard) {
         ultimoShardTamanho
     };
 }
+/**
+ * Gera nome de arquivo para shard
+ */
 export function gerarNomeShard(prefixo, indice, total, formato) {
     const padding = total.toString().length;
     const numeroFormatado = (indice + 1).toString().padStart(padding, '0');
     const extensao = formato === 'json' ? 'json' : 'md';
     return `${prefixo}-parte${numeroFormatado}-de${total}.${extensao}`;
 }
+/**
+ * Gera conteúdo do índice consolidado
+ */
 export function gerarIndiceConsolidado(shards, formato) {
     if (formato === 'json') {
         return JSON.stringify({
@@ -85,6 +112,7 @@ export function gerarIndiceConsolidado(shards, formato) {
             total: shards.reduce((sum, string) => sum + string.ocorrencias, 0)
         }, null, 2);
     }
+    // Markdown
     let md = '# Índice de Relatório Fragmentado\n\n';
     md += `*Gerado em: ${new Date().toLocaleString('pt-BR')}*\n\n`;
     md += '## Fragmentos\n\n';
@@ -97,14 +125,15 @@ export function gerarIndiceConsolidado(shards, formato) {
     md += `\n**Total**: ${shards.reduce((sum, string) => sum + string.ocorrencias, 0)} ocorrências\n`;
     return md;
 }
+// ─── Validação ────────────────────────────────────────────────
+/**
+ * Valida options de fragmentação
+ */
 export function validarOptionsSharding(options) {
     const erros = [];
     if (!options.formato) {
         erros.push('Formato é obrigatório');
     }
-    else if (options.formato !== 'json' && options.formato !== 'markdown') {
-        erros.push('Formato deve ser "json" ou "markdown"');
-    }
     if (!options.ocorrenciasPorShard || options.ocorrenciasPorShard <= 0) {
         erros.push('ocorrenciasPorShard deve ser maior que 0');
     }
@@ -119,6 +148,9 @@ export function validarOptionsSharding(options) {
         erros
     };
 }
+/**
+ * Cria options padrão para fragmentação
+ */
 export function criarOptionsShardingPadrao(overrides = {}) {
     return {
         formato: 'json',
@@ -130,4 +162,3 @@ export function criarOptionsShardingPadrao(overrides = {}) {
         ...overrides
     };
 }
-//# sourceMappingURL=sharded-exporter.js.map