npm - @mocoto/mahoraga - Versions diffs - 0.14.0 → 0.14.1 - Mend

@mocoto/mahoraga 0.14.0 → 0.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4994) hide show

package/dist/core/messages/pt/core/plugin-messages.js CHANGED Viewed

@@ -1,3 +1,17 @@
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable seguranca vulnerabilidade-seguranca
+/**
+* Mensagens dos Analistas de Plugins
+*
+* Centraliza todas as mensagens dos plugins:
+* - React
+* - React Hooks
+* - Tailwind
+* - CSS
+* - HTML
+* - Python
+*/
+// ─── MENSAGENS REACT ──────────────────────────────────────────
 export const ReactMensagens = {
     linkTargetBlank: 'Link com target="_blank" sem rel="noreferrer"/"noopener".',
     dangerouslySetInnerHTML: 'Uso de dangerouslySetInnerHTML encontrado; valide a necessidade.',
@@ -11,11 +25,13 @@ export const ReactMensagens = {
     deprecatedLifecycleMethod: (name) => `Método de ciclo de vida obsoleto: ${name}. Use componentDidMount, componentDidUpdate ou hooks.`,
     complexInlineStyles: 'Estilos inline complexos detectados. Considere usar CSS modules ou styled-components para melhor performance e organização.'
 };
+// ─── MENSAGENS REACT HOOKS ────────────────────────────────────
 export const ReactHooksMensagens = {
     useEffectNoDeps: 'useEffect sem array de dependências (avalie deps para evitar loops).',
     memoCallbackNoDeps: 'Hook sem array de dependências (useMemo/useCallback).',
     hookInConditional: 'Hook declarado dentro de condicional (quebra Rules of Hooks).'
 };
+// ─── MENSAGENS TAILWIND ───────────────────────────────────────
 export const TailwindMensagens = {
     conflictingClasses: (key, tokens) => `Possível conflito ${key} (${tokens.slice(0, 4).join(', ')}). Verifique duplicidades.`,
     repeatedClass: (token) => `Classe repetida detectada (${token}). Considere remover redundância.`,
@@ -24,6 +40,7 @@ export const TailwindMensagens = {
     dangerousArbitraryValue: (token) => `Valor arbitrário com url potencialmente perigosa (${token}). Evite javascript:/data:text/html.`,
     arbitraryValue: (token) => `Classe com valor arbitrário (${token}). Confirme se está alinhada ao design.`
 };
+// ─── MENSAGENS CSS ────────────────────────────────────────────
 export const CssMensagens = {
     duplicatePropertySame: (prop) => `Propriedade duplicada com valor idêntico (${prop}): erro detectado.`,
     duplicatePropertyDifferent: (prop, prev, curr) => `Propriedade duplicada (${prop}) com valores diferentes. Possível erro: "${prev}" vs "${curr}".`,
@@ -38,33 +55,43 @@ export const CssMensagens = {
     vendorPrefixDeprecated: (prop) => `Prefixo vendor deprecated (${prop}). Use propriedades padrão quando suportadas.`,
     cssHackDetected: (hack) => `Hack CSS detectado (${hack}). Considere abordagens modernas ou feature queries.`
 };
+// ─── MENSAGENS HTML ───────────────────────────────────────────
 export const HtmlMensagens = {
+    // Estrutura
     doctype: 'Documento sem <!DOCTYPE html> declarado.',
     htmlLang: 'Elemento <html> sem atributo lang (acessibilidade).',
     metaCharset: 'Falta <meta charset="utf-8"> no documento.',
     viewport: 'Falta meta viewport para responsividade.',
     title: 'Documento sem <title> definido.',
+    // Links
     linkTargetBlank: 'Link com target="_blank" sem rel="noreferrer"/"noopener".',
     linkNoHref: 'Link sem href válido ou sem handler (UX). Use <button> ou role="button".',
+    // Imagens
     imgWithoutAlt: 'Imagem sem atributo alt ou acessibilidade (WCAG 2.1).',
     imgWithoutLoading: 'Imagem sem atributo loading (performance). Considere loading="lazy".',
     imgWithoutDimensions: 'Imagem sem width/height (layout shift). Defina dimensões para evitar CLS.',
+    // Formulários
     formWithoutMethod: 'Formulário sem method especificado (GET/POST).',
     formWithoutAction: 'Formulário sem action ou data-attribute para processamento.',
     inputWithoutLabel: 'Input sem name, id ou aria-label (acessibilidade/usabilidade).',
     passwordWithoutAutocomplete: 'Campo password sem autocomplete especificado (segurança).',
     inputWithoutType: 'Input sem type especificado (assume text, mas seja explícito).',
+    // Handlers
     inlineHandler: 'Handler inline detectado (on*). Prefira listeners externos ou data-attributes com JS.',
+    // Scripts/Styles
     inlineScript: 'Script inline detectado. Prefira arquivos externos para melhor cache e CSP.',
     inlineStyle: 'Style inline detectado. Prefira arquivos CSS externos para melhor cache.',
     scriptWithoutDefer: 'Script sem defer/async. Pode bloquear renderização; considere defer.',
+    // Acessibilidade
     headingSkipped: (current, expected) => `Cabeçalho pulado: h${current} sem h${expected} precedente (estrutura semântica).`,
     buttonWithoutText: 'Botão sem texto ou aria-label (acessibilidade).',
     tableWithoutCaption: 'Tabela sem <caption> ou aria-label (acessibilidade).',
     iframeWithoutTitle: 'Iframe sem title (acessibilidade).',
+    // Performance
     largeInlineScript: 'Script inline muito grande. Mova para arquivo externo.',
     multipleH1: 'Múltiplos <h1> detectados. Use apenas um por página para SEO/acessibilidade.'
 };
+// ─── MENSAGENS XML ────────────────────────────────────────────
 export const XmlMensagens = {
     xmlPrologAusente: 'XML sem declaração <?xml ...?> (opcional, mas melhora compatibilidade).',
     doctypeDetectado: 'XML contém <!DOCTYPE>. Atenção a vetores de XXE (entidades externas).',
@@ -94,15 +121,18 @@ export const XmlMensagens = {
     oversizedXml: 'XML muito grande - considere processamento por streaming.',
     deprecatedXmlConstruct: 'Constructo XML obsoleto/depreciado detectado.'
 };
+// ─── MENSAGENS FORMATADOR (MIN) ───────────────────────────────
 export const FormatadorMensagens = {
     naoFormatado: (parser, detalhes) => {
         const base = `Arquivo parece não estar formatado (parser: ${parser}). Considere normalizar com o formatador do Mahoraga.`;
-        if (!detalhes)
+        if (!detalhes) {
             return base;
+        }
         return `${base} (${detalhes})`;
     },
     parseErro: (parser, err) => `Falha ao validar formatação interna (parser: ${parser}): ${err}`
 };
+// ─── MENSAGENS SVG (OTIMIZAÇÃO) ───────────────────────────────
 export const SvgMensagens = {
     naoPareceSvg: 'Arquivo .svg não contém uma tag <svg> válida.',
     semViewBox: 'SVG sem viewBox detectado (pode prejudicar responsividade).',
@@ -111,6 +141,7 @@ export const SvgMensagens = {
     javascriptUrl: 'SVG contém javascript: em URL/href. Risco de segurança.',
     podeOtimizar: (originalBytes, optimizedBytes, mudancas) => `SVG pode ser otimizado (${originalBytes}B → ${optimizedBytes}B). Mudanças: ${mudancas.join(', ')}.`
 };
+// ─── MENSAGENS CSS-IN-JS ──────────────────────────────────────
 export const CssInJsMensagens = {
     detectedStyledComponents: 'Padrões de styled-components detectados (CSS-in-JS).',
     detectedStyledJsx: 'Padrões de styled-jsx detectados (CSS-in-JS em React).',
@@ -143,6 +174,7 @@ export const CssInJsMensagens = {
     taggedTemplateWithoutExpression: 'Template literal sem expressões detectado - use string literal',
     taggedTemplateWithoutExpressionSugestao: 'Use string CSS simples ao invés de tagged template para estilos estáticos'
 };
+// ─── MENSAGENS PONTUAÇÃO CSS-IN-JS ────────────────────────────
 export const CssInJsPontuacaoMensagens = {
     notDetected: 'CSS-in-JS não detectado',
     detected: 'CSS-in-JS detectado',
@@ -157,20 +189,25 @@ export const CssInJsPontuacaoMensagens = {
     themeUsage: 'Uso de theme system',
     noThemeSystem: 'Sem theme system - considere usar ThemeProvider'
 };
+// ─── MENSAGENS CORREÇÃO CSS-IN-JS ──────────────────────────────
 export const CssInJsCorrecaoMensagens = {
     description: 'Correções automáticas para problemas CSS-in-JS',
     correctionSuggested: (tipo) => `Correção sugerida: ${tipo}`,
     sugestaoFormat: (original, sugerido, confianca) => `[ERRO] ${original}\n[OK] ${sugerido}\nConfiança: ${confianca}%`,
     extractGlobalCss: '// Considere mover para um arquivo CSS global separado'
 };
+// ─── MENSAGENS PYTHON ─────────────────────────────────────────
 export const PythonMensagens = {
+    // Imports & Dependencies
     missingTypeHints: 'Função sem type hints detectada; adicione type hints para melhor legibilidade.',
     hardcodedString: (string) => `String hardcoded detectada (${string.slice(0, 30)}...); considere usar constantes.`,
     httpWithoutVerify: 'Requisição HTTP sem verify=True detectada; valide certificados SSL.',
     sqlInjection: 'Possível SQL injection detectada; use prepared statements.',
+    // Code Quality
     broadExcept: 'Exceção genérica (except:) detectada; seja específico.',
     bareRaise: 'raise sem contexto detectada; sempre passe a exceção para manter stack trace.',
     passInExcept: 'pass em except block; implemente tratamento de erro apropriado.',
+    // Best Practices
     printInsteadOfLog: 'print() detectado; prefira logging module para produção.',
     evalUsage: 'eval() detectado; evite usar eval - vulnerabilidade de segurança.',
     execUsage: 'exec() detectado; evite usar exec - vulnerabilidade de segurança.',
@@ -179,13 +216,16 @@ export const PythonMensagens = {
     yamlUnsafeLoad: 'yaml.load sem Loader seguro detectado; prefira yaml.safe_load (evita execução).',
     globalKeyword: 'Uso de global keyword detectado; prefira passar como parâmetro.',
     mutableDefault: 'Argumento com valor padrão mutável (list/dict) detectado; use None como padrão.',
+    // Performance
     listComprehensionOpportunity: 'Loop que poderia ser list comprehension detectado.',
     loopingOverDict: 'Iteração sobre dict sem .items(); considere usar .items().',
+    // ─── Novos: Segurança Aprimorada ──────────────────────────────
     assertUsage: 'assert detectado em código de produção.',
     insecureHashLib: 'Algoritmo de hash inseguro (md5/sha1) detectado.',
     requestWithoutTimeout: 'Requisição HTTP sem timeout.',
     tempfileSecurity: 'Criação de arquivo temporário insegura (mktemp).',
     loggingWithoutException: 'except block sem log da exceção.',
+    // ─── Novos: Qualidade de Código ───────────────────────────────
     typingImportMissing: 'Função usando tipos (List, Dict, Optional, etc.) sem import do typing.',
     commentedCode: 'Código comentado detectado.',
     todoFixme: 'Comentário TODO/FIXME encontrado.',
@@ -197,6 +237,7 @@ export const PythonMensagens = {
     shadowBuiltin: 'Variável sombreia built-in do Python.',
     unusedVariable: 'Variável definida mas nunca usada.',
     redefinedLoopVar: 'Variável de loop sobrescrita no corpo do loop.',
+    // ─── Novos: Performance & Design ──────────────────────────────
     considerEnum: 'Considere usar Enum para grupo de constantes string.',
     dataclassOpportunity: 'Classe poderia ser um dataclass.',
     returnOutsideFunction: 'Return fora de função.',
@@ -204,6 +245,7 @@ export const PythonMensagens = {
     fstringWithoutExpression: 'f-string sem expressão (gasto computacional).',
     dictIteration: 'Iterando dict sem .items() em contexto complexo.'
 };
+// ─── MENSAGENS GO ─────────────────────────────────────────────
 export const GoMensagens = {
     uncheckedError: 'Erro não verificado após chamada de função que pode retornar erro.',
     printWithoutFormat: 'Uso de fmt.Print* sem string de formato; prefira fmt.Printf com formato.',
@@ -223,6 +265,7 @@ export const GoMensagens = {
     incompleteImportPath: (path) => `Caminho de importação '${path}' termina com ponto; caminho possivelmente incompleto.`,
     goodErrorWrapping: 'Boa prática: wrapping de erro com %w em fmt.Errorf'
 };
+// ─── MENSAGENS RUST ───────────────────────────────────────────
 export const RustMensagens = {
     unwrapUsage: 'Uso de .unwrap() detectado; prefira pattern matching com Result/Option.',
     emptyExpect: '.expect() com mensagem vazia; forneça uma mensagem descritiva.',
@@ -246,6 +289,7 @@ export const RustMensagens = {
     redundantReturn: 'return redundante no final da função; Rust usa retorno implícito (última expressão).',
     wildcardImport: (importPath) => `Importação curinga '${importPath}' pode poluir o namespace; prefira imports explícitos.`
 };
+// ─── MENSAGENS JAVA / KOTLIN ──────────────────────────────────
 export const JavaMensagens = {
     sysoutDetected: 'System.out/err.print detectado; use logging framework (SLF4J, Logback).',
     printStackTrace: 'e.printStackTrace() detectado; use logger para registrar exceções.',
@@ -258,6 +302,7 @@ export const JavaMensagens = {
     longMethod: 'Método muito longo; considere extrair métodos menores.',
     lateinitWithoutCheck: 'lateinit var sem verificação ::isInitialized antes do uso.'
 };
+// ─── MENSAGENS PHP ────────────────────────────────────────────
 export const PhpMensagens = {
     sqlInjection: 'Possível SQL injection detectado; use prepared statements (PDO).',
     evalUsage: 'eval() detectado; vulnerabilidade de segurança - evite usar.',
@@ -274,6 +319,7 @@ export const PhpMensagens = {
     longFunction: 'Função muito longa; considere refatorar.',
     debugOutput: 'var_dump/print_r/die detectado em código de produção; remova ou use logger.',
     camelCaseFunction: 'Função em camelCase; considere snake_case para convenção PHP.',
+    // Security
     looseComparison: 'Comparação frouxa (==) em contexto sensível; use ===.',
     insecureFileInclude: 'Inclusão de arquivo com variável; risco de path traversal.',
     xssOutput: 'Saída com echo/print de input não sanitizado; risco de XSS.',
@@ -285,6 +331,7 @@ export const PhpMensagens = {
     weakPasswordHash: 'Hash de senha fraco (md5/sha1) detectado; use password_hash().',
     sessionFixation: 'session_start() sem session_regenerate_id(); risco de fixation.',
     secondOrderInjection: 'Possível injeção de segunda ordem em consulta com dados do usuário.',
+    // Best Practices
     missingStrictTypes: 'Arquivo PHP sem declare(strict_types=1); adicione para tipagem estrita.',
     deprecatedFunction: 'Função obsoleta/deprecada detectada; substitua por alternativa moderna.',
     magicNumber: 'Número mágico detectado; extraia para constante nomeada.',
@@ -295,12 +342,14 @@ export const PhpMensagens = {
     methodNamingConvention: 'Método público/protegido deve usar camelCase (PSR-12).',
     longParameterList: 'Lista de parâmetros muito longa (>5); considere usar um objeto de configuração.'
 };
+// ─── Nivéis de Severidade ─────────────────────────────────────
 export const SeverityNiveis = {
     error: 'erro',
     warning: 'aviso',
     info: 'info',
     suggestion: 'sugestao'
 };
+// ─── Categorias/Tipos de Analistas ────────────────────────────
 export const AnalystTipos = {
     react: 'react/regra',
     reactHooks: 'react-hooks/regra',
@@ -331,4 +380,3 @@ export const AnalystOrigens = {
     rust: 'analista-rust',
     php: 'analista-php'
 };
-//# sourceMappingURL=plugin-messages.js.map

package/dist/core/messages/pt/github/github-app-messages.js CHANGED Viewed

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const GithubAppMensagens = {
     servidorRodando: (port) => `[LANCAMENTO] Servidor rodando na porta ${port}`,
     webhooksEndpoint: (port) => `[APONTAR-DIRETA] Webhooks: http://localhost:${port}/api/github/webhooks`,
@@ -7,4 +8,3 @@ export const GithubAppMensagens = {
     statsEndpoint: (port) => `[APONTAR-DIRETA] Stats: http://localhost:${port}/api/github/stats`,
     erroIniciarServidor: (erro) => `Falha ao iniciar servidor: ${erro}`,
 };
-//# sourceMappingURL=github-app-messages.js.map

package/dist/core/messages/pt/github/github-push-report-messages.js CHANGED Viewed

@@ -1,9 +1,12 @@
+// SPDX-License-Identifier: MIT
 export const GithubPushReportMensagens = {
     scoreLabel: (score) => {
-        if (score >= 80)
+        if (score >= 80) {
             return 'bom';
-        if (score >= 60)
+        }
+        if (score >= 60) {
             return 'atenção';
+        }
         return 'crítico';
     },
     rotuloScoreNome: 'mahoraga: diagnóstico',
@@ -46,6 +49,5 @@ export const GithubDashboardMensagens = {
     jobNaoEncontrado: (jobId) => `Job '${jobId}' não encontrado`,
     installationIdInvalido: 'installation id inválido',
     acessoNegado: 'Acesso não autorizado. Forneça o token de administração (Authorization: Bearer <token>).',
-    tokenNaoConfigurado: 'Token de administração (MAHORAGA_ADMIN_TOKEN) não configurado. Acesso permitido sem autenticação.',
+    tokenNaoConfigurado: 'Token de administração (SUKUNA_ADMIN_TOKEN) não configurado. Acesso permitido sem autenticação.',
 };
-//# sourceMappingURL=github-push-report-messages.js.map

package/dist/core/messages/pt/github/github-repo-downloader-messages.js CHANGED Viewed

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const GithubRepoDownloaderMensagens = {
     falhaBaixarZipball: (status) => `Falha ao baixar zipball: ${status}`,
     respostaInesperada: 'Resposta inesperada ao baixar repositório',
@@ -5,4 +6,3 @@ export const GithubRepoDownloaderMensagens = {
     redirectInvalido: 'URL de redirecionamento inválido ou não autorizado',
     pathTraversalDetectado: 'Tentativa de path traversal detectada no arquivo zip',
 };
-//# sourceMappingURL=github-repo-downloader-messages.js.map

package/dist/core/messages/pt/github/github-webhook-messages.js CHANGED Viewed

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const GithubWebhookMensagens = {
     checkRunTitle: (score) => `Mahoraga: Score ${score}/100`,
     checkRunName: 'Mahoraga GitHub Actions Analyzer',
@@ -22,4 +23,3 @@ export const GithubSetupMensagens = {
     redirectAfterInstall: 'https://github.com/settings/installations/{installation_id}',
     instrucao: 'No painel do GitHub App, defina "Setup URL" como setupUrl. Após instalar, o usuário permanece no GitHub.',
 };
-//# sourceMappingURL=github-webhook-messages.js.map

package/dist/core/messages/pt/github/index.js CHANGED Viewed

@@ -1,5 +1,5 @@
+// SPDX-License-Identifier: MIT
 export * from './github-app-messages.js';
 export * from './github-push-report-messages.js';
 export * from './github-repo-downloader-messages.js';
 export * from './github-webhook-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/pt/guardian/guardian-messages.js CHANGED Viewed

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const GuardianMensagens = {
     gpgChavePrivadaIndisponivel: 'Nenhuma chave privada GPG disponível para assinar. Execute a geração de chaves primeiro.',
     gpgChavePublicaIndisponivel: 'Nenhuma chave pública GPG disponível para verificação.',
@@ -22,4 +23,3 @@ export const GuardianMensagens = {
     reportDriftDetectado: '- [AVISO] Drift de arquétipo detectado - revisar mudanças',
     reportAtualizarBaseline: '- [INFO] Considerar atualizar baseline se mudanças forem intencionais'
 };
-//# sourceMappingURL=guardian-messages.js.map

package/dist/core/messages/pt/guardian/index.js CHANGED Viewed

@@ -1,3 +1,6 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Mensagens Guardian
+ */
 export * from './guardian-messages.js';
 export * from './watcher-hidden-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/pt/guardian/watcher-hidden-messages.js CHANGED Viewed

@@ -1,6 +1,8 @@
+/**
+ * Messages for Vigia Oculta guardian (Portuguese).
+ */
 export const VigiaOcultaMensagens = {
     alteracoesDetectadas: '[LOCK] [VigiaOculta] Alterações detectadas em {total} arquivo(s):',
     itemArquivoCorrompido: '  - {arquivo}',
     registrosRecalibrados: '[CYCLE] Registros recalibrados automaticamente pela Vigia Oculta.\n',
 };
-//# sourceMappingURL=watcher-hidden-messages.js.map

package/dist/core/messages/pt/index.js CHANGED Viewed

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Mensagens em Português (Brasil)
+ */
 export * from './analysts/index.js';
 export * from './caretakers/index.js';
 export * from './cli/index.js';
@@ -9,4 +13,3 @@ export * from './log/index.js';
 export * from './reports/index.js';
 export * from './shared/index.js';
 export * from './ui/index.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/pt/licenses/index.js CHANGED Viewed

@@ -1,2 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Mensagens de Licenças
+ */
 export * from './licenses-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/pt/licenses/licenses-messages.js CHANGED Viewed

@@ -1,3 +1,6 @@
+/**
+ * Messages for license scanning (Portuguese).
+ */
 export const LicensasMensagens = {
     generatedNotices: 'Generated notices:',
     disclaimerInserted: 'Disclaimer inserted into files:',
@@ -19,4 +22,3 @@ export const LicensasMensagens = {
     erroParsearLicencaCorrigida: 'Erro ao parsear licença corrigida em awaitOrFallback: {erro}',
     erroAwaitOrFallback: 'Erro em awaitOrFallback ({valor}): {erro}',
 };
-//# sourceMappingURL=licenses-messages.js.map

package/dist/core/messages/pt/log/index.js CHANGED Viewed

@@ -1,5 +1,8 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Sistema de Logging
+ */
 export * from './log.js';
 export * from './log-engine.js';
 export * from './log-helper.js';
 export * from './log-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/pt/log/log-engine.js CHANGED Viewed

@@ -1,3 +1,8 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Engine de logs adaptativos que se ajusta ao contexto do projeto
+ * Detecta automaticamente complexidade e adapta verbosidade
+ */
 import { config } from '../../../config/index.js';
 import { ICONES_FEEDBACK } from '../../shared/index.js';
 import { isJsonMode } from '../../../../shared/helpers/index.js';
@@ -13,9 +18,13 @@ class LogEngineAdaptativo {
         }
         return LogEngineAdaptativo.instance;
     }
+    /**
+     * Detecta automaticamente o contexto do projeto baseado nos arquivos
+     */
     detectarContexto(fileMap) {
         this.metricas = this.analisarProjeto(fileMap);
         this.isCI = this.detectarCI();
+        // Prioridade: CI > Complexidade > Padrão
         if (this.isCI) {
             this.contextoAtual = 'ci';
             this.log('debug', LogMensagens.contexto.ci_cd, {});
@@ -35,6 +44,7 @@ class LogEngineAdaptativo {
         else {
             this.contextoAtual = 'medio';
         }
+        // Log de detecção do projeto
         this.log('info', LogMensagens.projeto.detectado, {
             tipo: this.contextoAtual,
             confianca: this.calcularConfianca()
@@ -45,14 +55,19 @@ class LogEngineAdaptativo {
         });
         return this.contextoAtual;
     }
+    /**
+     * Analisa métricas do projeto para determinar complexidade
+     */
     analisarProjeto(fileMap) {
         const arquivos = Object.values(fileMap);
         const totalArquivos = arquivos.length;
+        // Detecta linguagens pelos extensions
         const extensoes = new Set(arquivos.map(arquivo => arquivo.relPath.split('.').pop()?.toLowerCase()).filter((ext) => Boolean(ext)));
         const linguagens = Array.from(extensoes).filter(ext => ['js', 'ts', 'jsx', 'tsx', 'html', 'css', 'php', 'py', 'xml'].includes(ext));
+        // Detecta estrutura complexa
         const temSrcFolder = arquivos.some(arquivo => arquivo.relPath.startsWith('src/'));
         const temMultiplosDiretorios = new Set(arquivos.map(arquivo => arquivo.relPath.split('/')[0])).size > 5;
-        const temConfiguracaoArquivos = arquivos.some(arquivo => ['package.json', 'tsconfig.json', 'webpack.config.js', 'vite.config.ts'].includes(arquivo.relPath.split('/').pop() || ''));
+        const temConfiguracaoArquivos = arquivos.some(arquivo => ['package.json', 'tsconfig.json', 'webpack.config.js', 'vite.config.ts'].includes(arquivo.relPath.split('/').pop() ?? ''));
         let estruturaComplexidade = 'simples';
         if (totalArquivos > 100 || temMultiplosDiretorios) {
             estruturaComplexidade = 'complexa';
@@ -69,41 +84,64 @@ class LogEngineAdaptativo {
             temDependencias: arquivos.some(arquivo => arquivo.relPath === 'package.json' || arquivo.relPath === 'requirements.txt')
         };
     }
+    /**
+     * Detecta se está rodando em ambiente CI/CD
+     */
     detectarCI() {
-        return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.JENKINS_URL || config.REPORT_SILENCE_LOGS);
+        return !!((process.env.CI || process.env.GITHUB_ACTIONS || (process.env.GITLAB_CI ?? process.env.JENKINS_URL)) ?? config.REPORT_SILENCE_LOGS);
     }
+    /**
+     * Calcula confiança da detecção de contexto
+     */
     calcularConfianca() {
-        if (!this.metricas)
+        if (!this.metricas) {
             return 50;
-        let confianca = 60;
-        if (this.metricas.totalArquivos > 0)
+        }
+        let confianca = 60; // base
+        // Fatores que aumentam confiança
+        if (this.metricas.totalArquivos > 0) {
             confianca += 10;
-        if (this.metricas.linguagens.length > 0)
+        }
+        if (this.metricas.linguagens.length > 0) {
             confianca += 10;
-        if (this.metricas.temTestes)
+        }
+        if (this.metricas.temTestes) {
             confianca += 10;
-        if (this.metricas.temDependencias)
+        }
+        if (this.metricas.temDependencias) {
             confianca += 10;
+        }
         return Math.min(confianca, 95);
     }
+    /**
+     * Log adaptativo baseado no contexto atual
+     */
     log(level, template, data = {}) {
+        // Quando --json está ativo, o stdout deve conter APENAS JSON.
+        // Suprimimos logs visuais e mantemos apenas erros no stderr.
         if (isJsonMode()) {
-            if (level !== 'erro')
+            if (level !== 'erro') {
                 return;
+            }
             const formattedMensagem = this.formatMessage(template, data, LogContextConfiguracao[this.contextoAtual]);
             console.error(formattedMensagem);
             return;
         }
         const contextoConfiguracao = LogContextConfiguracao[this.contextoAtual];
+        // Em CI, usar formato estruturado
         if (this.isCI && this.contextoAtual === 'ci') {
             this.logEstruturado(level, template, data);
             return;
         }
+        // Log normal com adaptações
         const formattedMensagem = this.formatMessage(template, data, contextoConfiguracao);
         const timestamp = this.formatTimestamp();
         const logMethod = this.getLogMethod(level);
         logMethod(`[${timestamp}] ${formattedMensagem}`);
     }
+    /**
+     * Log estruturado para CI/CD
+     */
     logEstruturado(level, template, data) {
         const logEntrada = {
             timestamp: new Date().toISOString(),
@@ -114,22 +152,30 @@ class LogEngineAdaptativo {
         };
         console.log(JSON.stringify(logEntrada));
     }
+    /**
+     * Formata mensagem baseada no contexto
+     */
     formatMessage(template, data, contextoConfiguracao = LogContextConfiguracao[this.contextoAtual]) {
         const processedData = {
             ...data
         };
+        // Adapta formato de arquivo baseado no contexto
         if (processedData.arquivo && typeof processedData.arquivo === 'string') {
             processedData.arquivo = this.formatarNomeArquivo(processedData.arquivo, contextoConfiguracao.formato_arquivo);
         }
+        // Aplica formatação de template
         return template.replace(/\{(\w+)\}/g, (match, key) => {
             const value = processedData[key];
             return value !== undefined ? String(value) : match;
         });
     }
+    /**
+     * Formata nome do arquivo baseado no contexto
+     */
     formatarNomeArquivo(arquivo, formato) {
         switch (formato) {
             case 'nome_apenas':
-                return arquivo.split('/').pop() || arquivo;
+                return arquivo.split('/').pop() ?? arquivo;
             case 'relativo':
                 return arquivo.length > 50 ? `...${arquivo.slice(-45)}` : arquivo;
             case 'completo':
@@ -140,7 +186,7 @@ class LogEngineAdaptativo {
     }
     formatTimestamp() {
         const now = new Date();
-        return now.toTimeString().slice(0, 8);
+        return now.toTimeString().slice(0, 8); // HH:mm:ss
     }
     getLogMethod(level) {
         switch (level) {
@@ -152,12 +198,18 @@ class LogEngineAdaptativo {
                 return console.log;
         }
     }
+    /**
+     * Getters para uso externo
+     */
     get contexto() {
         return this.contextoAtual;
     }
     get metricas_projeto() {
         return this.metricas;
     }
+    /**
+     * Força um contexto específico (para testes ou override manual)
+     */
     forcarContexto(contexto) {
         this.contextoAtual = contexto;
         this.log('debug', `${ICONES_FEEDBACK.info} Contexto forçado para: ${contexto}`, {});
@@ -165,4 +217,3 @@ class LogEngineAdaptativo {
 }
 export const logEngine = LogEngineAdaptativo.getInstance();
 export { LogEngineAdaptativo };
-//# sourceMappingURL=log-engine.js.map