@mocoto/mahoraga 0.14.8 → 0.15.0

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

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { Command } from 'commander';
 import { chalk, config } from '../../core/config/index.js';
 import { iniciarInquisicao } from '../../core/execution/index.js';
@@ -29,7 +27,6 @@ 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);
@@ -39,8 +36,6 @@ export function comandoPodar(aplicarFlagsGlobais) {
             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
@@ -68,14 +63,11 @@ 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();

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

@@ -1,5 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { Command } from 'commander';
 import { messages } from '../../core/messages/index.js';
 import { mapaReversao } from '../../analysts/corrections/index.js';
@@ -7,13 +5,11 @@ import { ExitCode, sair } from '../helpers/index.js';
 const { log, logAuto, logSistema } = messages;
 export function registrarComandoReverter(program) {
     program.command('reverter').description(messages.CliComandoReverterMensagens.descricao).hook('preAction', async () => {
-        if (process.env.SUKUNA_TEST_FAST === '1') {
+        if (process.env.MAHORAGA_TEST_FAST === '1') {
             try {
                 await mapaReversao.carregar();
             }
             catch (err) {
-                // 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;
                 }

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

@@ -1,5 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { scanSystemIntegrity } from '../../guardian/index.js';
 import { Command } from 'commander';
 import { chalk, config } from '../../core/config/index.js';
@@ -56,7 +54,6 @@ export function comandoAtualizar(aplicarFlagsGlobais) {
             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);
         }
     });

package/dist/cli/commands/commands.js

@@ -19,16 +19,10 @@ 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());
 }

package/dist/cli/commands/index.js

@@ -1,11 +1,3 @@
-// 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';
@@ -24,17 +16,12 @@ export * from './command-perf.js';
 export * from './command-plugins.js';
 export * from './command-prune.js';
 export * from './command-update.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';

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

@@ -1,5 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { config } from '../../core/config/index.js';
 import { messages } from '../../core/messages/index.js';
@@ -107,7 +105,7 @@ export async function executarAutoFixInterno(opts, ocorrenciasFiltradas, fileEnt
                 estatisticas.push('modo conservador (alta confiança apenas)');
             }
             logSistema.autoFixEstatisticas(estatisticas);
-            if (process.env.SUKUNA_ESLINT_VALIDATION !== '0' &&
+            if (process.env.MAHORAGA_ESLINT_VALIDATION !== '0' &&
                 autoCorrecaoConfiguracao.validateAfterFix) {
                 try {
                     log.info(MENSAGENS_AUTOFIX.logs.validacaoEslint);

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

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export function exportarComplianceJson(relatorio) {
     return JSON.stringify(relatorio, null, 2);
 }

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

@@ -1,7 +1,3 @@
-// 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';

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

@@ -1,24 +1,7 @@
-// SPDX-License-Identifier: MIT
-// SPDX-FileCopyrightText: 2025 Mahoraga Contributors
-// @mahoraga-disable ml-deep-nesting
-/**
- * @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,
@@ -26,12 +9,10 @@ export function gerarRelatorioJson(dados, options = {}) {
         compact: options.compact ?? false,
         maxOcorrencias: options.maxOcorrencias
     };
-    // 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 ?? {
             timestamp: new Date().toISOString(),
@@ -40,8 +21,6 @@ export function gerarRelatorioJson(dados, options = {}) {
             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';
                 }
@@ -87,40 +66,28 @@ 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;
@@ -128,16 +95,11 @@ 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();
@@ -166,9 +128,6 @@ function traduzirObjeto(obj, rotulos) {
     }
     return obj;
 }
-/**
- * Valida se uma string JSON está bem formada
- */
 export function validarJson(json) {
     try {
         JSON.parse(json);
@@ -184,10 +143,6 @@ 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(),
@@ -199,9 +154,6 @@ export function criarMetadata(modo, flags, filtros) {
         })
     };
 }
-/**
- * Cria objeto de stats a partir de ocorrências
- */
 export function criarStats(ocorrencias) {
     const porNivel = {
         erro: 0,
@@ -212,16 +164,13 @@ export function criarStats(ocorrencias) {
     const porRegra = {};
     const arquivosSet = new Set();
     for (const ocorrencia of ocorrencias) {
-        // Contar por nível (type-safe)
         const nivel = ocorrencia.nivel ?? 'info';
         if (nivel === 'erro' || nivel === 'aviso' || nivel === 'info') {
             porNivel[nivel] = porNivel[nivel] + 1;
         }
-        // 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);
         }
@@ -236,9 +185,6 @@ 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 {

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

@@ -1,9 +1,3 @@
-// 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,
@@ -18,41 +12,31 @@ 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) {
@@ -91,7 +75,6 @@ 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`;
@@ -101,29 +84,26 @@ 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); // Top 10
+        const categorias = Object.entries(stats.porCategoria).sort((arquivo, base) => base[1] - arquivo[1]).slice(0, 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); // Top 10
+        const extensoes = Object.entries(linguagens.extensoes).sort((arquivo, base) => base[1] - arquivo[1]).slice(0, 10);
         for (const [ext, count] of extensoes) {
             md += `| .${ext} | ${count} |\n`;
         }
@@ -191,7 +171,6 @@ 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);
@@ -254,7 +233,6 @@ 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':
@@ -267,9 +245,6 @@ 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, '\\`');
 }

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

@@ -1,20 +1,7 @@
-// SPDX-License-Identifier: MIT
-// SPDX-FileCopyrightText: 2025 Mahoraga Contributors
-// @mahoraga-disable tipo-literal-inline-complexo ml-deep-nesting
-// 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,
@@ -32,7 +19,6 @@ export function fragmentarRelatorio(dados, options) {
             }
         };
     }
-    // Gerar informações dos shards
     const shards = [];
     for (let indice = 0; indice < numShards; indice++) {
         const inicio = indice * options.ocorrenciasPorShard;
@@ -62,10 +48,6 @@ export 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) {
@@ -73,9 +55,6 @@ 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;
@@ -86,18 +65,12 @@ 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({
@@ -112,7 +85,6 @@ 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';
@@ -125,10 +97,6 @@ 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) {
@@ -148,9 +116,6 @@ export function validarOptionsSharding(options) {
         erros
     };
 }
-/**
- * Cria options padrão para fragmentação
- */
 export function criarOptionsShardingPadrao(overrides = {}) {
     return {
         formato: 'json',

package/dist/cli/diagnostic/exporters/svg-optimization-exporter.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { otimizarSvgLikeSvgo, shouldSugerirOtimizacaoSvg } from '../../../shared/formatters/index.js';
 function formatBytes(bytes) {
@@ -15,9 +14,6 @@ function formatBytes(bytes) {
     const mb = kb / 1024;
     return `${mb.toFixed(1)}MB`;
 }
-/**
-* Gera e escreve o relatório de otimização de SVG no diretório de relatórios
-*/
 export async function exportarRelatorioSvgOtimizacao(params) {
     const { entries, relatoriosDir, ts } = params;
     const candidatos = [];