@mocoto/mahoraga 0.14.0 → 0.14.1

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

@@ -1,14 +1,16 @@
+// SPDX-License-Identifier: MIT
 import crypto from 'node:crypto';
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
-import { ExitCode, sair } from '../helpers/index.js';
+import { Command } from 'commander';
 import { config, formatPct } from '../../core/config/index.js';
 import { messages } from '../../core/messages/index.js';
+import { ExitCode, sair } from '../helpers/index.js';
 import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
-import { Command } from 'commander';
 const { log, logSistema } = messages;
 async function obterCommit() {
     try {
+        // usar helper seguro
         const { executarShellSeguro } = await import('../../core/utils/index.js');
         return executarShellSeguro('git rev-parse --short HEAD', {
             stdio: ['ignore', 'pipe', 'ignore']
@@ -19,6 +21,8 @@ async function obterCommit() {
     }
 }
 function calcularHash(snapshot) {
+    // SHA1 usado apenas para fingerprinting de baseline de performance
+    // Não é usado para segurança/criptografia - contexto: identificação rápida de snapshots
     return crypto.createHash('sha1').update(JSON.stringify(snapshot, Object.keys(snapshot).sort())).digest('hex').slice(0, 10);
 }
 async function gerarBaseline(destDir, metricas) {
@@ -59,10 +63,12 @@ async function carregarSnapshots(dir) {
         for (const arquivo of jsons) {
             try {
                 const parsed = await lerEstado(path.join(dir, arquivo));
-                if (parsed && parsed.tipo === 'baseline')
+                if (parsed.tipo === 'baseline') {
                     out.push(parsed);
+                }
             }
             catch {
+                /* ignore */
             }
         }
         return out.sort((arquivo, base) => arquivo.timestamp.localeCompare(base.timestamp));
@@ -72,12 +78,15 @@ async function carregarSnapshots(dir) {
     }
 }
 function diffPercent(arquivo, base) {
-    if (!arquivo && !base)
+    if (!arquivo && !base) {
         return 0;
-    if (!arquivo || !base)
+    }
+    if (!arquivo || !base) {
         return 0;
-    if (arquivo === 0)
+    }
+    if (arquivo === 0) {
         return 0;
+    }
     return (base - arquivo) / arquivo * 100;
 }
 function compararSnapshots(base, atual) {
@@ -99,11 +108,11 @@ function compararSnapshots(base, atual) {
 export function comandoPerf() {
     return new Command('perf').description(messages.CliComandoDesempMensagens.descricao).option('-d, --dir <dir>', 'Diretório de snapshots', config.PERF_SNAPSHOT_DIR).option('-j, --json', 'Saída JSON').option('-l, --limite <n>', 'Limite para regressão (%)', valor => Number(valor), 30).addCommand(new Command('baseline').description(messages.CliComandoDesempMensagens.descricaoBaseline).action(async (opts, cmd) => {
         try {
-            const parent = cmd.parent?.opts?.() || {};
+            const parent = cmd.parent?.opts?.() ?? {};
             const dir = parent.dir ? String(parent.dir) : config.PERF_SNAPSHOT_DIR;
             const globalMetrics = globalThis;
-            const metricas = globalMetrics.__ULTIMAS_METRICAS_MAHORAGA__;
-            const snap = await gerarBaseline(dir, metricas || undefined);
+            const metricas = globalMetrics.__ULTIMAS_METRICAS_SUKUNA__;
+            const snap = await gerarBaseline(dir, metricas ?? undefined);
             if (parent.json) {
                 console.log(JSON.stringify({
                     gerado: true,
@@ -111,16 +120,15 @@ export function comandoPerf() {
                 }, null, 2));
             }
             else {
-                log.sucesso(`Baseline gerada: commit=${snap.commit || 'n/a'} parsing=${snap.tempoParsingMs}ms analise=${snap.tempoAnaliseMs}ms`);
+                log.sucesso(`Baseline gerada: commit=${snap.commit ?? 'n/a'} parsing=${snap.tempoParsingMs}ms analise=${snap.tempoAnaliseMs}ms`);
             }
         }
         catch (err) {
             log.erro(`Falha na geração de baseline: ${err instanceof Error ? err.message : String(err)}`);
             sair(ExitCode.Failure);
-            return;
         }
     })).addCommand(new Command('compare').description(messages.CliComandoDesempMensagens.descricaoCompare).action(async (opts, cmd) => {
-        const parent = cmd.parent?.opts?.() || {};
+        const parent = cmd.parent?.opts?.() ?? {};
         const dir = parent.dir ? String(parent.dir) : config.PERF_SNAPSHOT_DIR;
         const limite = parent.limite;
         let snaps;
@@ -134,12 +142,14 @@ export function comandoPerf() {
         }
         if (snaps.length < 2) {
             const msg = 'Menos de dois snapshots para comparar';
-            if (parent.json)
+            if (parent.json) {
                 console.log(JSON.stringify({
                     erro: msg
                 }));
-            else
+            }
+            else {
                 log.aviso(msg);
+            }
             return;
         }
         const anterior = snaps[snaps.length - 2];
@@ -160,15 +170,15 @@ export function comandoPerf() {
             diffs.forEach(diretorio => {
                 log.info(`  ${diretorio.campo}: ${diretorio.anterior ?? '-'} => ${diretorio.novo ?? '-'} (${formatPct(diretorio.variacaoPct)})`);
             });
-            if (regressao)
+            if (regressao) {
                 logSistema.performanceRegressaoDetectada(limite);
-            else
+            }
+            else {
                 logSistema.performanceSemRegressoes();
+            }
         }
         if (regressao) {
             sair(ExitCode.Failure);
-            return;
         }
     }));
 }
-//# sourceMappingURL=command-perf.js.map

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

@@ -1,9 +1,13 @@
+// SPDX-License-Identifier: MIT
+import { Command } from 'commander';
+import { messages } from '../../core/messages/index.js';
 import { listarAnalistas } from '../../analysts/registry/index.js';
 import { ExitCode, sair } from '../helpers/index.js';
-import { messages } from '../../core/messages/index.js';
-import { Command } from 'commander';
 const log = messages.log;
 const msgs = messages.CliComandoPluginsMensagens;
+/**
+ * Comando para gerenciar plugins do Mahoraga
+ */
 export function comandoPlugins() {
     const plugins = new Command('plugins').description(msgs.descricao);
     plugins.command('list').description(msgs.listDescricao).option('--json', msgs.jsonDescricao).action(opts => {
@@ -27,6 +31,7 @@ export function comandoPlugins() {
     plugins.command('install <pacote>').description(msgs.installDescricao).action(pacote => {
         log.info(msgs.buscandoPacote(pacote));
         log.info(msgs.instalando);
+        // Mock de instalação para v0.5.0
         setTimeout(() => {
             log.sucesso(msgs.pluginInstalado(pacote));
             log.info(msgs.dicaAnalistas);
@@ -43,4 +48,3 @@ export function comandoPlugins() {
     });
     return plugins;
 }
-//# sourceMappingURL=command-plugins.js.map

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

@@ -1,11 +1,12 @@
+// SPDX-License-Identifier: MIT
+import { Command } from 'commander';
+import { chalk, config } from '../../core/config/index.js';
+import { iniciarInquisicao } from '../../core/execution/index.js';
+import { messages } from '../../core/messages/index.js';
 import { removerArquivosOrfaos } from '../../analysts/corrections/index.js';
 import { registroAnalistas } from '../../analysts/registry/index.js';
 import { exportarRelatoriosPoda } from '../handlers/index.js';
 import { ExitCode, expandIncludePatterns, processPatternList, sair } from '../helpers/index.js';
-import { chalk, config } from '../../core/config/index.js';
-import { iniciarInquisicao } from '../../core/execution/index.js';
-import { messages } from '../../core/messages/index.js';
-import { Command } from 'commander';
 import { asTecnicas } from '../../types/index.js';
 const { log, logSistema } = messages;
 export function comandoPodar(aplicarFlagsGlobais) {
@@ -17,7 +18,7 @@ export function comandoPodar(aplicarFlagsGlobais) {
         return prev;
     }, []).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(messages.CliComandoPodarMensagens.erroAplicarFlags(err instanceof Error ? err.message : String(err)));
@@ -27,13 +28,18 @@ export function comandoPodar(aplicarFlagsGlobais) {
         log.info(chalk.bold(messages.CliComandoPodarMensagens.inicio));
         const baseDir = process.cwd();
         try {
+            // Normaliza padrões de include/exclude para sincronizar filtros com o scanner
             const includeListRaw = processPatternList(opts.include);
             const includeList = includeListRaw.length ? expandIncludePatterns(includeListRaw) : [];
             const excludeList = processPatternList(opts.exclude);
-            if (includeList.length)
+            if (includeList.length) {
                 config.CLI_INCLUDE_PATTERNS = includeList;
-            if (excludeList.length)
+            }
+            if (excludeList.length) {
                 config.CLI_EXCLUDE_PATTERNS = excludeList;
+            }
+            // [FOGO] SIMPLIFICADO: sem sync de padrões obsoletos
+            // CLI flags dominam globalExcludeGlob automaticamente
             const tecnicas = asTecnicas(registroAnalistas);
             const { fileEntries } = await iniciarInquisicao(baseDir, {
                 incluirMetadados: false
@@ -61,11 +67,14 @@ export function comandoPodar(aplicarFlagsGlobais) {
                 });
                 const answer = await rl.question(chalk.yellow(messages.CliComandoPodarMensagens.confirmarRemocao));
                 rl.close();
+                // debug removido (usava console.log) - manter somente se modo debug ativo futuramente
                 if (answer.toLowerCase() !== 's') {
                     logSistema.podaCancelada();
                     return;
                 }
             }
+            // Só remove se confirmado
+            // --force: remove direto
             if (opts.force) {
                 await removerArquivosOrfaos(fileEntries);
                 logSistema.podaConcluida();
@@ -86,11 +95,10 @@ export function comandoPodar(aplicarFlagsGlobais) {
         catch (error) {
             const errMsg = typeof error === 'object' && error && 'message' in error ? error.message : String(error);
             log.erro(messages.CliComandoPodarMensagens.erroDurantePoda(errMsg));
-            if (config.DEV_MODE)
+            if (config.DEV_MODE) {
                 console.error(error);
+            }
             sair(ExitCode.Failure);
-            return;
         }
     });
 }
-//# sourceMappingURL=command-prune.js.map

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

@@ -1,17 +1,21 @@
+// SPDX-License-Identifier: MIT
+import { Command } from 'commander';
+import { messages } from '../../core/messages/index.js';
 import { mapaReversao } from '../../analysts/corrections/index.js';
 import { ExitCode, sair } from '../helpers/index.js';
-import { messages } from '../../core/messages/index.js';
-import { Command } from 'commander';
 const { log, logAuto, logSistema } = messages;
 export function registrarComandoReverter(program) {
     program.command('reverter').description(messages.CliComandoReverterMensagens.descricao).hook('preAction', async () => {
-        if (process.env.MAHORAGA_TEST_FAST === '1') {
+        if (process.env.SUKUNA_TEST_FAST === '1') {
             try {
                 await mapaReversao.carregar();
             }
             catch (err) {
-                if (process.env.VITEST === '1')
+                // Em modo de teste rápido, falhas ao carregar o mapa são ignoradas para evitar timeout.
+                // Porém, em outros ambientes, registramos um aviso para reduzir casos de promises 'swallowed'.
+                if (process.env.VITEST === '1') {
                     return;
+                }
                 log.aviso(messages.CliComandoReverterMensagens.avisoFalhaCarregarMapaFastMode(err instanceof Error ? err.message : String(err)));
             }
         }
@@ -40,7 +44,6 @@ export function registrarComandoReverter(program) {
             else {
                 logSistema.reversaoFalha(arquivo);
                 sair(ExitCode.Failure);
-                return;
             }
         }
         catch (err) {
@@ -58,7 +61,6 @@ export function registrarComandoReverter(program) {
             else {
                 logAuto.mapaReversaoFalhaReverterMove(id);
                 sair(ExitCode.Failure);
-                return;
             }
         }
         catch (err) {
@@ -95,4 +97,3 @@ export function registrarComandoReverter(program) {
         }
     }));
 }
-//# sourceMappingURL=command-reverter.js.map

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,17 +33,18 @@ 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 ?? Infinity;
         for (const [arquivo] of correcoesPorArquivo) {
             try {
-                const fileEntrada = fileEntriesComAst?.find(fe => fe.relPath === arquivo || fe.fullCaminho === arquivo);
+                const fileEntrada = fileEntriesComAst.find(fe => fe.relPath === arquivo || fe.fullCaminho === arquivo);
                 if (!fileEntrada || typeof fileEntrada.content !== 'string') {
                     logSistema.autoFixArquivoNaoEncontrado(arquivo);
                     continue;
@@ -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 (!CAMPO_ROTULOS || 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