@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/cli/commands/command-fix-types.js

@@ -1,14 +1,18 @@
-import { exportarRelatoriosFixTypes } from '../handlers/index.js';
-import { ExitCode, expandIncludePatterns, processPatternList, sair } from '../helpers/index.js';
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-inseguro-unknown tipo-permissivo-object
+// Justificativa: err: unknown é correto para catch handlers. Object.* são chamadas de API, não tipo.
+import { Command } from 'commander';
 import { config } from '../../core/config/index.js';
 import { getMessages } from '../../core/messages/index.js';
 import { PROJETO_RAIZ } from '../../core/registry/index.js';
-import { Command } from 'commander';
+import { exportarRelatoriosFixTypes } from '../handlers/index.js';
+import { ExitCode, expandIncludePatterns, processPatternList, sair } from '../helpers/index.js';
 import { asTecnicas, extrairMensagemErro } from '../../types/index.js';
 const { CliComandoFixTypesMensagens, DICAS, formatarTipoInseguro, gerarResumoCategoria, ICONES_FIX_TYPES: ICONES, log, MENSAGENS_AUTOFIX, MENSAGENS_CLI_CORRECAO_TIPOS, MENSAGENS_ERRO_FIX_TYPES: MENSAGENS_ERRO, MENSAGENS_INICIO_FIX_TYPES: MENSAGENS_INICIO, MENSAGENS_PROGRESSO_FIX_TYPES: MENSAGENS_PROGRESSO, MENSAGENS_RESUMO, MENSAGENS_SUCESSO_FIX_TYPES: MENSAGENS_SUCESSO, TEMPLATE_RESUMO_FINAL, TEXTOS_CATEGORIZACAO_CORRECAO_TIPOS, } = getMessages();
 function mostrarErroDev(err) {
-    if (!config.DEV_MODE)
+    if (!config.DEV_MODE) {
         return;
+    }
     console.error(extrairMensagemErro(err));
     if (err && typeof err === 'object' && 'stack' in err) {
         const errWithStack = err;
@@ -20,7 +24,7 @@ async function carregarInquisicao() {
     const modInq = await import('../../core/execution/index.js');
     const modReg = await import('../../analysts/registry/index.js');
     registroAnalistasCache = modReg.registroAnalistas;
-    const analistaTiposInseguros = registroAnalistasCache?.find((arquivo) => {
+    const analistaTiposInseguros = registroAnalistasCache.find((arquivo) => {
         return typeof arquivo === 'object' && arquivo !== null && arquivo.nome === 'detector-tipos-inseguros';
     });
     return {
@@ -50,7 +54,7 @@ async function processarCategorizacao(porArquivo, verbose) {
                 stats.corrigir++;
                 stats.totalConfianca += 95;
                 if (verbose) {
-                    log.aviso(MENSAGENS_CLI_CORRECAO_TIPOS.verboseAnyDetectado(arquivo, String(ocorrencia.linha || '?')));
+                    log.aviso(MENSAGENS_CLI_CORRECAO_TIPOS.verboseAnyDetectado(arquivo, String(ocorrencia.linha ?? '?')));
                 }
                 continue;
             }
@@ -65,7 +69,7 @@ async function processarCategorizacao(porArquivo, verbose) {
                 stats.corrigir++;
                 stats.totalConfianca += 100;
                 if (verbose) {
-                    log.erro(MENSAGENS_CLI_CORRECAO_TIPOS.verboseAsAnyCritico(arquivo, String(ocorrencia.linha || '?')));
+                    log.erro(MENSAGENS_CLI_CORRECAO_TIPOS.verboseAsAnyCritico(arquivo, String(ocorrencia.linha ?? '?')));
                 }
                 continue;
             }
@@ -80,7 +84,7 @@ async function processarCategorizacao(porArquivo, verbose) {
                 stats.corrigir++;
                 stats.totalConfianca += 100;
                 if (verbose) {
-                    log.erro(MENSAGENS_CLI_CORRECAO_TIPOS.verboseAngleAnyCritico(arquivo, String(ocorrencia.linha || '?')));
+                    log.erro(MENSAGENS_CLI_CORRECAO_TIPOS.verboseAngleAnyCritico(arquivo, String(ocorrencia.linha ?? '?')));
                 }
                 continue;
             }
@@ -90,7 +94,7 @@ async function processarCategorizacao(porArquivo, verbose) {
                 try {
                     const fullCaminho = path.join(PROJETO_RAIZ, arquivo);
                     const codigo = await fs.readFile(fullCaminho, 'utf-8');
-                    const lineContext = extractLineContext(codigo, (ocorrencia.linha || 1) * 80);
+                    const lineContext = extractLineContext(codigo, (ocorrencia.linha ?? 1) * 80);
                     const categorizacao = categorizarUnknown(codigo, arquivo, lineContext);
                     ocorrenciasCategorizadas.push({
                         ocorrencia,
@@ -101,7 +105,7 @@ async function processarCategorizacao(porArquivo, verbose) {
                     stats.totalConfianca += categorizacao.confianca;
                     if (verbose) {
                         const prefixos = { legitimo: '[SUCESSO]', melhoravel: '[AVISO]', corrigir: '[ERRO]' };
-                        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.verboseUnknownCategoria(prefixos[categorizacao.categoria], arquivo, String(ocorrencia.linha || '?'), categorizacao.categoria, categorizacao.confianca));
+                        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.verboseUnknownCategoria(prefixos[categorizacao.categoria], arquivo, String(ocorrencia.linha ?? '?'), categorizacao.categoria, categorizacao.confianca));
                         log.info(MENSAGENS_CLI_CORRECAO_TIPOS.verboseMotivo(categorizacao.motivo));
                         if (categorizacao.sugestao) {
                             log.info(MENSAGENS_CLI_CORRECAO_TIPOS.verboseSugestao(categorizacao.sugestao));
@@ -151,13 +155,14 @@ function mostrarResumo(stats) {
 }
 function mostrarAltaPrioridade(ocorrenciasCategorizadas) {
     const altaPrioridade = ocorrenciasCategorizadas.filter(elem => elem.categoria === 'corrigir' && elem.confianca >= 85);
-    if (altaPrioridade.length === 0)
+    if (altaPrioridade.length === 0) {
         return;
-    log.fase?.(MENSAGENS_CLI_CORRECAO_TIPOS.altaConfiancaTitulo(altaPrioridade.length));
+    }
+    log.fase(MENSAGENS_CLI_CORRECAO_TIPOS.altaConfiancaTitulo(altaPrioridade.length));
     log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
     for (const item of altaPrioridade.slice(0, 5)) {
-        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.altaConfiancaLinha(item.ocorrencia.relPath, String(item.ocorrencia.linha || '?'), item.confianca));
-        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.altaConfiancaDetalhe(item.sugestao || item.motivo));
+        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.altaConfiancaLinha(item.ocorrencia.relPath, String(item.ocorrencia.linha ?? '?'), item.confianca));
+        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.altaConfiancaDetalhe(item.sugestao ?? item.motivo));
     }
     if (altaPrioridade.length > 5) {
         log.info(MENSAGENS_CLI_CORRECAO_TIPOS.altaConfiancaMais(altaPrioridade.length - 5));
@@ -166,14 +171,15 @@ function mostrarAltaPrioridade(ocorrenciasCategorizadas) {
 }
 function mostrarCasosIncertos(ocorrenciasCategorizadas, verbose) {
     const casosIncertos = ocorrenciasCategorizadas.filter(elem => elem.confianca < 70 && elem.variantes && elem.variantes.length > 0);
-    if (!casosIncertos.length || !verbose)
+    if (!casosIncertos.length || !verbose) {
         return;
-    log.fase?.(MENSAGENS_CLI_CORRECAO_TIPOS.incertosTitulo(casosIncertos.length));
+    }
+    log.fase(MENSAGENS_CLI_CORRECAO_TIPOS.incertosTitulo(casosIncertos.length));
     log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
     log.info(MENSAGENS_CLI_CORRECAO_TIPOS.incertosIntro);
     log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
     for (const item of casosIncertos.slice(0, 3)) {
-        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.incertosLinha(item.ocorrencia.relPath, String(item.ocorrencia.linha || '?'), item.confianca));
+        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.incertosLinha(item.ocorrencia.relPath, String(item.ocorrencia.linha ?? '?'), item.confianca));
         log.info(MENSAGENS_CLI_CORRECAO_TIPOS.verboseMotivo(item.motivo));
         if (item.variantes) {
             log.info(MENSAGENS_CLI_CORRECAO_TIPOS.verboseVariantesTitulo);
@@ -197,7 +203,7 @@ async function aplicarCorrecoesAutomaticas(ocorrenciasCategorizadas, verbose) {
         return;
     }
     console.log();
-    log.fase?.(MENSAGENS_CLI_CORRECAO_TIPOS.aplicandoCorrecoesAuto);
+    log.fase(MENSAGENS_CLI_CORRECAO_TIPOS.aplicandoCorrecoesAuto);
     log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
     try {
         const { aplicarCorrecoesEmLote } = await import('../../analysts/corrections/auto-fix-engine.js');
@@ -212,7 +218,7 @@ async function aplicarCorrecoesAutomaticas(ocorrenciasCategorizadas, verbose) {
         const resultado = await aplicarCorrecoesEmLote(porArquivo, {
             dryRun: false,
             minConfianca: 85,
-            verbose: Boolean(verbose),
+            verbose,
             interactive: false
         });
         console.log();
@@ -244,11 +250,11 @@ async function aplicarCorrecoesAutomaticas(ocorrenciasCategorizadas, verbose) {
     }
 }
 function mostrarExemplosDryRun(tiposInseguros, verbose, minConfidence) {
-    log.fase?.(MENSAGENS_CLI_CORRECAO_TIPOS.exemplosDryRunTitulo);
+    log.fase(MENSAGENS_CLI_CORRECAO_TIPOS.exemplosDryRunTitulo);
     const exemplos = tiposInseguros.slice(0, 10);
     for (const ocorrencia of exemplos) {
         const prefixo = ocorrencia.tipo === 'tipo-inseguro-any' ? '[ERRO]' : '[AVISO]';
-        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.exemploLinha(prefixo, ocorrencia.relPath, String(ocorrencia.linha || '?')));
+        log.info(MENSAGENS_CLI_CORRECAO_TIPOS.exemploLinha(prefixo, ocorrencia.relPath, String(ocorrencia.linha ?? '?')));
         if (ocorrencia.mensagem) {
             log.info(MENSAGENS_CLI_CORRECAO_TIPOS.exemploMensagem(ocorrencia.mensagem));
         }
@@ -300,18 +306,20 @@ export function criarComandoFixTypes() {
     return cmd;
 }
 async function executarFixTypes(options) {
-    const isDryRun = options.dryRun || false;
+    const isDryRun = options.dryRun ?? false;
     const minConfidence = Number(options.confidence) || 85;
-    const target = options.target || 'src';
-    const verbose = options.verbose || false;
-    log.fase?.(MENSAGENS_INICIO.titulo);
+    const target = options.target ?? 'src';
+    const verbose = options.verbose ?? false;
+    log.fase(MENSAGENS_INICIO.titulo);
     const includeListRaw = processPatternList(options.include);
     const includeList = includeListRaw.length ? expandIncludePatterns(includeListRaw) : [];
     const excludeList = processPatternList(options.exclude);
-    if (includeList.length)
+    if (includeList.length) {
         config.CLI_INCLUDE_PATTERNS = includeList;
-    if (excludeList.length)
+    }
+    if (excludeList.length) {
         config.CLI_EXCLUDE_PATTERNS = excludeList;
+    }
     const { iniciarInquisicao, analistaTiposInseguros, tecnicas: tecnicasParaExec } = await carregarInquisicao();
     if (!analistaTiposInseguros) {
         log.erro(MENSAGENS_ERRO.detectorNaoEncontrado);
@@ -342,9 +350,10 @@ async function executarFixTypes(options) {
     }
     log.aviso(MENSAGENS_RESUMO.encontrados(tiposInseguros.length));
     const porTipo = tiposInseguros.reduce((acc, ocorrencia) => {
-        const tipo = ocorrencia.tipo || 'desconhecido';
-        if (!acc[tipo])
+        const tipo = ocorrencia.tipo ?? 'desconhecido';
+        if (!acc[tipo]) {
             acc[tipo] = [];
+        }
         acc[tipo].push(ocorrencia);
         return acc;
     }, {});
@@ -357,7 +366,7 @@ async function executarFixTypes(options) {
         mostrarExemplosDryRun(tiposInseguros, verbose, minConfidence);
         return;
     }
-    log.fase?.(MENSAGENS_CLI_CORRECAO_TIPOS.aplicandoCorrecoesAuto);
+    log.fase(MENSAGENS_CLI_CORRECAO_TIPOS.aplicandoCorrecoesAuto);
     const { fixAnyToProperTipo, fixUnknownToSpecificTipo } = await import('../../analysts/corrections/quick-fixes/index.js');
     if (!fixAnyToProperTipo || !fixUnknownToSpecificTipo) {
         log.erro(MENSAGENS_ERRO.modulosNaoEncontrados);
@@ -366,8 +375,9 @@ async function executarFixTypes(options) {
     }
     const porArquivo = tiposInseguros.reduce((acc, ocorrencia) => {
         const arquivo = ocorrencia.relPath || 'desconhecido';
-        if (!acc[arquivo])
+        if (!acc[arquivo]) {
             acc[arquivo] = [];
+        }
         acc[arquivo].push(ocorrencia);
         return acc;
     }, {});
@@ -375,7 +385,7 @@ async function executarFixTypes(options) {
     log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
     const { ocorrenciasCategorizadas, stats } = await processarCategorizacao(porArquivo, verbose);
     console.log();
-    log.fase?.(MENSAGENS_RESUMO.tituloCategorizacao);
+    log.fase(MENSAGENS_RESUMO.tituloCategorizacao);
     log.info(MENSAGENS_CLI_CORRECAO_TIPOS.linhaEmBranco);
     const mediaConfianca = mostrarResumo(stats);
     await salvarAnaliseDetalhada(ocorrenciasCategorizadas, stats, mediaConfianca, verbose);
@@ -410,17 +420,18 @@ async function executarFixTypes(options) {
             })),
             stats,
             minConfidence,
-            verbose: Boolean(verbose)
+            verbose
         });
     }
-    const temAny = porTipo['tipo-inseguro-any']?.length > 0;
+    const temAny = porTipo['tipo-inseguro-any'].length > 0;
     if (temAny && !isDryRun) {
         sair(ExitCode.Failure);
     }
 }
 async function salvarAnaliseDetalhada(ocorrenciasCategorizadas, stats, mediaConfianca, verbose) {
-    if (!verbose)
+    if (!verbose) {
         return;
+    }
     try {
         const fs = await import('node:fs/promises');
         const path = await import('node:path');
@@ -439,7 +450,7 @@ async function salvarAnaliseDetalhada(ocorrenciasCategorizadas, stats, mediaConf
                 confianca: elem.confianca,
                 motivo: elem.motivo,
                 sugestao: elem.sugestao,
-                variantes: elem.variantes || []
+                variantes: elem.variantes ?? []
             }))
         }, null, 2));
         log.info(MENSAGENS_CLI_CORRECAO_TIPOS.analiseDetalhadaSalva);
@@ -449,4 +460,3 @@ async function salvarAnaliseDetalhada(ocorrenciasCategorizadas, stats, mediaConf
         log.aviso(`Não foi possível salvar análise detalhada: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
-//# sourceMappingURL=command-fix-types.js.map

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

@@ -1,32 +1,36 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
-import { ExitCode, processPatternList, sair } from '../helpers/index.js';
-import { configurarFiltros } from '../processing/index.js';
+import { Command } from 'commander';
+import micromatch from 'micromatch';
 import { chalk, config } from '../../core/config/index.js';
 import { scanRepository } from '../../core/execution/index.js';
 import { getMessages } from '../../core/messages/index.js';
+import { ExitCode, processPatternList, sair } from '../helpers/index.js';
 import { formatarComPrettierProjeto, formatarPrettierMinimo } from '../../shared/formatters/index.js';
 import { salvarEstado } from '../../shared/persistence/index.js';
-import { Command } from 'commander';
-import micromatch from 'micromatch';
+import { configurarFiltros } from '../../types/processing/filters.js';
 const { log, CliFormatarExtraMensagens } = getMessages();
 function isFormatavel(relPath) {
-    const basename = relPath.split('/').pop()?.toLowerCase() || '';
+    const basename = relPath.split('/').pop()?.toLowerCase() ?? '';
     const arquivosIgnorados = ['third-party-notices.txt', 'avisos-de-terceiros.pt-br.txt'];
-    if (arquivosIgnorados.includes(basename))
+    if (arquivosIgnorados.includes(basename)) {
         return false;
+    }
     return /\.(json[c5]?|md|markdown|ya?ml|ts|tsx|js|jsx|mjs|cjs|html?|css|py|xml|php|toml|ini|sql|dockerfile|sh|bash|properties|txt|log|lock|env|gradle|svg|scss|less|go)$/i.test(relPath) || /^(\.gitignore|\.editorconfig|\.npmrc|\.nvmrc)$/i.test(basename);
 }
 function detectaNodeModulesExplicito(includeGroups, includeFlat) {
     const all = [...includeFlat, ...includeGroups.flat()];
-    return all.some(caminho => /(^|\/)node_modules(\/|$)/.test(String(caminho || '')));
+    return all.some(caminho => /(^|\/)node_modules(\/|$)/.test((caminho || '')));
 }
 async function formatarComEngine(src, relPath, baseDir, engine) {
     if (engine === 'auto') {
         const raiz = await formatarComPrettierProjeto({ code: src, relPath, baseDir });
-        if (!raiz.ok)
+        if (!raiz.ok) {
             return raiz;
-        if (raiz.parser !== 'unknown')
+        }
+        if (raiz.parser !== 'unknown') {
             return raiz;
+        }
         return formatarPrettierMinimo({ code: src, relPath });
     }
     if (engine === 'interno') {
@@ -43,13 +47,14 @@ export function comandoFormatar(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() : {});
             const write = Boolean(opts.write);
-            const check = write ? false : Boolean(opts.check ?? true);
-            const engineRaw = String(opts.engine || process.env.MAHORAGA_FORMAT_ENGINE || 'auto').trim();
+            const check = write ? false : (opts.check ?? true);
+            const engineRaw = ((opts.engine ?? process.env.SUKUNA_FORMAT_ENGINE) ?? 'auto').trim();
             const engine = engineRaw === 'interno' || engineRaw === 'prettier' || engineRaw === 'auto' ? engineRaw : 'auto';
             const includeList = processPatternList(opts.include);
             const excludeList = processPatternList(opts.exclude);
+            // Mantém consistência com o pipeline de filtros: aplica defaults de excludes
             const includeGroupsRaw = [];
             const incluiNodeModules = detectaNodeModulesExplicito(includeGroupsRaw, includeList);
             configurarFiltros(includeGroupsRaw, includeList, excludeList, incluiNodeModules);
@@ -68,6 +73,8 @@ export function comandoFormatar(aplicarFlagsGlobais) {
             const fileMap = await scanRepository(baseDir, {
                 includeContent: true,
                 filter: relPath => {
+                    // Se include foi informado, o scanner cuida do grosso; aqui garantimos
+                    // que o comando não tente formatar tipos fora do escopo suportado.
                     return isFormatavel(relPath);
                 }
             });
@@ -75,14 +82,17 @@ export function comandoFormatar(aplicarFlagsGlobais) {
             result.total = entries.length;
             for (const erro of entries) {
                 const relPath = erro.relPath;
+                // Exclude deve funcionar mesmo quando include está ativo (scanner não aplica)
                 if (excludeList.length && micromatch.isMatch(relPath, excludeList)) {
                     continue;
                 }
+                // Include adicional (por segurança/consistência) - aceita match por glob ou caminho exato
                 if (includeList.length) {
                     const matchGlob = micromatch.isMatch(relPath, includeList);
-                    const matchExact = includeList.some(caminho => String(caminho).trim() === relPath);
-                    if (!matchGlob && !matchExact)
+                    const matchExact = includeList.some(caminho => caminho.trim() === relPath);
+                    if (!matchGlob && !matchExact) {
                         continue;
+                    }
                 }
                 const src = typeof erro.content === 'string' ? erro.content : '';
                 const resolved = await formatarComEngine(src, relPath, baseDir, engine);
@@ -120,6 +130,7 @@ export function comandoFormatar(aplicarFlagsGlobais) {
                 sair(ExitCode.Ok);
                 return;
             }
+            // write
             if (result.mudaram > 0) {
                 log.sucesso(CliFormatarExtraMensagens.arquivosFormatados.replace('{total}', String(result.mudaram)));
             }
@@ -134,4 +145,3 @@ export function comandoFormatar(aplicarFlagsGlobais) {
         }
     });
 }
-//# sourceMappingURL=command-format.js.map

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

@@ -1,8 +1,9 @@
+// SPDX-License-Identifier: MIT
 import { accessSync } from 'node:fs';
 import { resolve, sep } from 'node:path';
+import { Command } from 'commander';
 import { listarFormatters, registrarFormatter, removerFormatter } from '../../core/formatters/index.js';
 import { getMessages } from '../../core/messages/index.js';
-import { Command } from 'commander';
 const { log, FormattersMensagens } = getMessages();
 export function comandoFormatters() {
     const cmd = new Command('formatters')
@@ -33,6 +34,7 @@ export function comandoFormatters() {
         .argument('<caminho>', 'Caminho do módulo do formatador')
         .action(async (nome, caminho) => {
         try {
+            // Valida caminho local seguro - apenas arquivos ./, ../, ou absolutos
             if (!caminho.startsWith('./') && !caminho.startsWith('../') && !caminho.startsWith('/') && !caminho.startsWith(`.${sep}`)) {
                 log.erro(FormattersMensagens.moduloInvalido(caminho));
                 return;
@@ -70,4 +72,3 @@ export function comandoFormatters() {
     });
     return cmd;
 }
-//# sourceMappingURL=command-formatters.js.map

package/dist/cli/commands/command-github-actions.js

@@ -1,21 +1,23 @@
-import 'dotenv/config';
+// SPDX-License-Identifier: MIT
 import fs from 'node:fs';
 import path from 'node:path';
-import { analistaGithubActions, analistaGithubActionsGlobal, autofixEngine, gerarRelatorio, obterDetectoresGithubActions, pontuarWorkflow, prepararDadosRelatorio } from '../../analysts/github-actions/index.js';
-import { iniciarServidorApp } from '../../app/github/app/index.js';
-import { ExitCode, sair } from '../helpers/index.js';
-import { aplicarCorrecoes, salvarArquivoCorrigido } from '../../core/execution/index.js';
-import { CliComandoGithubActionsMensagens, messages } from '../../core/messages/index.js';
+import 'dotenv/config';
 import { Command } from 'commander';
 import ora from 'ora';
+import { aplicarCorrecoes, salvarArquivoCorrigido } from '../../core/execution/index.js';
+import { CliComandoGithubActionsMensagens, messages } from '../../core/messages/index.js';
+import { analistaGithubActions, analistaGithubActionsGlobal, autofixEngine, gerarRelatorio, obterDetectoresGithubActions, pontuarWorkflow, prepararDadosRelatorio } from '../../analysts/github-actions/index.js';
+import { ExitCode, sair } from '../helpers/index.js';
+import { iniciarServidorApp } from '../../app/github.js';
 const SCORE_MAX = 100;
 const SCORE_MIN = 0;
 const PENALTY_PER_OCCURRENCE = 5;
 const DEFAULT_GATE_THRESHOLD = 70;
 const log = messages.log;
 function normalizarOcorrencias(result) {
-    if (!result)
+    if (!result) {
         return [];
+    }
     return Array.isArray(result) ? result : [result];
 }
 function lerDiretorioWorkflows(workflowDir) {
@@ -93,7 +95,7 @@ export function comandoGithubActions() {
         .option('--fix', CliComandoGithubActionsMensagens.optFix)
         .option('--dry-run', CliComandoGithubActionsMensagens.optDryRun)
         .action(async (opts) => {
-        const repoPath = path.resolve(opts.path || '.');
+        const repoPath = path.resolve(opts.path ?? '.');
         const workflowDir = path.join(repoPath, '.github', 'workflows');
         const workflowFilesContent = lerDiretorioWorkflows(workflowDir);
         if (workflowFilesContent.length === 0) {
@@ -188,7 +190,7 @@ export function comandoGithubActions() {
             if (todasOcorrencias.length > 0) {
                 log.info(CliComandoGithubActionsMensagens.ocorrenciasTitulo);
                 for (const ocorrencia of todasOcorrencias.slice(0, 20)) {
-                    const nivel = ocorrencia.nivel || 'info';
+                    const nivel = ocorrencia.nivel ?? 'info';
                     const nivelIcon = nivel === 'erro' ? '[RED]' : nivel === 'aviso' ? '[YELLOW]' : '[BLUE]';
                     log.info(CliComandoGithubActionsMensagens.ocorrenciaItem(nivelIcon, ocorrencia.relPath, ocorrencia.linha ?? 0, ocorrencia.mensagem));
                 }
@@ -210,7 +212,7 @@ export function comandoGithubActions() {
         .option('--titulo <titulo>', 'Título do relatório')
         .option('--no-detalhes', CliComandoGithubActionsMensagens.optNoDetalhes)
         .action(async (opts) => {
-        const repoPath = path.resolve(opts.path || '.');
+        const repoPath = path.resolve(opts.path ?? '.');
         const workflowDir = path.join(repoPath, '.github', 'workflows');
         const workflowFiles = lerDiretorioWorkflows(workflowDir);
         if (workflowFiles.length === 0) {
@@ -227,9 +229,9 @@ export function comandoGithubActions() {
         const spinner = ora({ text: 'Gerando relatório...', spinner: 'dots' }).start();
         try {
             const { todasOcorrencias, workflowsInfo, tempoAnalise } = await processarWorkflows(workflowDir, workflowFiles);
-            const output = opts.output || `github-actions-report.${formato === 'markdown' ? 'md' : formato}`;
+            const output = opts.output ?? `github-actions-report.${formato === 'markdown' ? 'md' : formato}`;
             const dados = prepararDadosRelatorio(todasOcorrencias, path.basename(repoPath), tempoAnalise, workflowsInfo);
-            await gerarRelatorio(dados, {
+            gerarRelatorio(dados, {
                 formato,
                 output,
                 titulo: opts.titulo,
@@ -253,9 +255,9 @@ export function comandoGithubActions() {
         .option('-j, --json', 'Saída em JSON para consumo externo')
         .option('--fail-on <nivel>', 'Nível mínimo para falhar (erro, aviso, info)', 'erro')
         .action(async (opts) => {
-        const repoPath = path.resolve(opts.path || '.');
+        const repoPath = path.resolve(opts.path ?? '.');
         const workflowDir = path.join(repoPath, '.github', 'workflows');
-        const threshold = parseInt(opts.threshold || DEFAULT_GATE_THRESHOLD.toString(), 10);
+        const threshold = parseInt(opts.threshold ?? DEFAULT_GATE_THRESHOLD.toString(), 10);
         const workflowFilesContent = lerDiretorioWorkflows(workflowDir);
         if (workflowFilesContent.length === 0) {
             if (opts.json) {
@@ -338,8 +340,9 @@ export function comandoGithubActions() {
                     log.erro(CliComandoGithubActionsMensagens.gateFalhaMotivo(motivo));
                 }
             }
-            if (!passou)
+            if (!passou) {
                 sair(ExitCode.Failure);
+            }
         }
         catch (err) {
             log.erro(err instanceof Error ? err.message : String(err));
@@ -347,7 +350,7 @@ export function comandoGithubActions() {
         }
     });
     cmd.command('app').description(CliComandoGithubActionsMensagens.descricaoApp)
-        .option('-p, --port <number>', 'Porta do servidor', process.env.MAHORAGA_API_PORT || process.env.PORT || '3000')
+        .option('-p, --port <number>', 'Porta do servidor', (process.env.SUKUNA_API_PORT ?? process.env.PORT) ?? '3000')
         .action(async (opts) => {
         const appId = process.env.GITHUB_APP_ID;
         const privateKey = process.env.GITHUB_PRIVATE_KEY;
@@ -374,4 +377,3 @@ export function comandoGithubActions() {
     });
     return cmd;
 }
-//# sourceMappingURL=command-github-actions.js.map

package/dist/cli/commands/command-gitlab-ci.js

@@ -1,21 +1,28 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [BUSCA] Comando para análise de GitLab CI
+ *
+ * mahoraga gitlab-ci scan [opções]
+ */
 import fs from 'node:fs';
 import path from 'node:path';
-import { analistaGitLabCI } from '../../analysts/gitlab-ci/index.js';
-import { ExitCode, sair } from '../helpers/index.js';
-import { messages } from '../../core/messages/index.js';
 import { Command } from 'commander';
 import ora from 'ora';
+import { messages } from '../../core/messages/index.js';
+import { analistaGitLabCI } from '../../analysts/gitlab-ci/index.js';
+import { ExitCode, sair } from '../helpers/index.js';
 const log = messages.log;
 const msgs = messages.CliComandoGitlabCiMensagens;
 function normalizarOcorrencias(result) {
-    if (!result)
+    if (!result) {
         return [];
+    }
     return Array.isArray(result) ? result : [result];
 }
 export function comandoGitlabCI() {
     const cmd = new Command('gitlab-ci').alias('gl').description(msgs.descricaoCmd);
     cmd.command('scan').alias('s').description(msgs.descricaoScan).option('-p, --path <caminho>', msgs.optPath, '.').option('-j, --json', 'Saída em JSON').action(async (opts) => {
-        const repoPath = path.resolve(opts.path || '.');
+        const repoPath = path.resolve(opts.path ?? '.');
         const gitlabFile = path.join(repoPath, '.gitlab-ci.yml');
         let conteudo;
         try {
@@ -63,8 +70,9 @@ export function comandoGitlabCI() {
                     ocorrencias.forEach(ocorrencia => {
                         const prefix = ocorrencia.nivel === 'erro' ? '[RED]' : ocorrencia.nivel === 'aviso' ? '[YELLOW]' : '[BLUE]';
                         log.info(msgs.ocorrencia(prefix, ocorrencia.tipo ?? '', ocorrencia.linha ?? 0, ocorrencia.mensagem ?? ''));
-                        if (ocorrencia.sugestao)
+                        if (ocorrencia.sugestao) {
                             log.info(msgs.sugestao(ocorrencia.sugestao));
+                        }
                     });
                 }
                 else {
@@ -80,4 +88,3 @@ export function comandoGitlabCI() {
     });
     return cmd;
 }
-//# sourceMappingURL=command-gitlab-ci.js.map

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

@@ -1,11 +1,15 @@
-import { registroAnalistas } from '../../analysts/registry/index.js';
-import { executarGuardian as executarGuardianModular } from '../diagnostic/handlers/index.js';
-import { ExitCode, sair } from '../helpers/index.js';
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-literal-inline-complexo tipo-inseguro-unknown
+// Justificativa: tipos inline para opções de comando CLI são locais e não precisam de extração. err em catch handlers é unknown propositalmente.
+// Importar handler modular do Guardian (Sprint 2)
+import { acceptNewBaseline } from '../../guardian/index.js';
+import { Command } from 'commander';
 import { config } from '../../core/config/index.js';
 import { iniciarInquisicao } from '../../core/execution/index.js';
 import { messages } from '../../core/messages/index.js';
-import { acceptNewBaseline } from '../../guardian/index.js';
-import { Command } from 'commander';
+import { registroAnalistas } from '../../analysts/registry/index.js';
+import { executarGuardian as executarGuardianModular } from '../diagnostic/handlers/index.js';
+import { ExitCode, sair } from '../helpers/index.js';
 import { asTecnicas, extrairMensagemErro, IntegridadeStatus } from '../../types/index.js';
 const { log, logGuardian } = messages;
 function getGuardianIgnorePatterns() {
@@ -17,11 +21,12 @@ function setGuardianIgnorePatterns(patterns) {
 }
 function getCacheDiffHits() {
     const globalCache = globalThis;
-    return globalCache.__MAHORAGA_DIFF_CACHE_HITS__ || 0;
+    return globalCache.__SUKUNA_DIFF_CACHE_HITS__ ?? 0;
 }
 function mostrarErroDev(err) {
-    if (!config.DEV_MODE)
+    if (!config.DEV_MODE) {
         return;
+    }
     console.error(extrairMensagemErro(err));
     if (err && typeof err === 'object' && 'stack' in err) {
         console.error(err.stack);
@@ -34,7 +39,7 @@ function converterParaFileEntry(entries) {
         content: entry.content
     }));
 }
-async function executarModoDiff(guardianResultado, opts) {
+function executarModoDiff(guardianResultado, opts) {
     if (guardianResultado.drift && guardianResultado.drift > 0) {
         if (opts.json) {
             console.log(JSON.stringify({ status: 'alteracoes-detectadas', drift: guardianResultado.drift }));
@@ -54,8 +59,8 @@ async function executarModoDiff(guardianResultado, opts) {
         logGuardian.integridadePreservada();
     }
 }
-async function executarModoNormal(guardianResultado, opts) {
-    const statusNorm = guardianResultado.status || IntegridadeStatus.Ok;
+function executarModoNormal(guardianResultado, opts) {
+    const statusNorm = guardianResultado.status ?? IntegridadeStatus.Ok;
     switch (statusNorm) {
         case IntegridadeStatus.Ok:
             if (opts.json) {
@@ -106,7 +111,7 @@ export function comandoGuardian(aplicarFlagsGlobais) {
         .option('--json', 'Saída em JSON estruturado (para CI/integracoes)')
         .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.CliComandoGuardianMensagens.falhaAplicarFlags(err instanceof Error ? err.message : String(err)));
@@ -151,10 +156,10 @@ export function comandoGuardian(aplicarFlagsGlobais) {
                 };
                 const guardianResultado = await executarGuardianModular(converterParaFileEntry(fileEntries), guardianOpts);
                 if (opts.diff) {
-                    await executarModoDiff(guardianResultado, opts);
+                    executarModoDiff(guardianResultado, opts);
                 }
                 else {
-                    await executarModoNormal(guardianResultado, opts);
+                    executarModoNormal(guardianResultado, opts);
                 }
             }
             if (opts.fullScan) {
@@ -171,4 +176,3 @@ export function comandoGuardian(aplicarFlagsGlobais) {
         }
     });
 }
-//# sourceMappingURL=command-guardian.js.map