@mocoto/mahoraga 0.14.8 → 0.15.0

package/dist/core/config/auto/auto-fix-config.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-// SPDX-License-Identifier: MIT
-// Merged auto-fix configuration: keep compatibility with both older
-// AUTO_FIX_CONFIG_DEFAULTS and the newer DEFAULT_AUTO_FIX_CONFIG surface.
 import { LIMITES_PADRAO } from '../limites.js';
 export const PADRAO_AUTO_CORRECAO_CONFIGURACAO = {
     mode: 'balanced',
@@ -12,7 +8,6 @@ export const PADRAO_AUTO_CORRECAO_CONFIGURACAO = {
     maxFixesPerArquivo: 5,
     createBackup: true,
     validateAfterFix: true,
-    // backwards compat defaults
     allowMutateFs: false,
     backupSuffix: '.local.bak',
     conservative: true
@@ -32,7 +27,6 @@ export const AGRESSIVA_AUTO_CORRECAO_CONFIGURACAO = {
     maxFixesPerArquivo: 10,
     excludePadroes: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/coverage/**', '**/*.min.js']
 };
-// Backwards compat constant name used elsewhere in the codebase
 export const AUTO_CORRECAO_CONFIGURACAO_PADROES = PADRAO_AUTO_CORRECAO_CONFIGURACAO;
 export function shouldExcludeFile(fileCaminho, config) {
     if (!config.excludePadroes || !Array.isArray(config.excludePadroes)) {
@@ -50,7 +44,6 @@ export function shouldExcludeFunction(functionName, config) {
     return config.excludeFunctionPatterns.some(pattern => new RegExp(pattern, 'i').test(functionName));
 }
 export function isCategoryAllowed(category, config) {
-    // allowedCategories is an array of known category strings - coerce to string[] for safe includes check
     if (!config.allowedCategories || !Array.isArray(config.allowedCategories)) {
         return true;
     }

package/dist/core/config/auto/fix-config.js

@@ -1,7 +1,5 @@
-// SPDX-License-Identifier: MIT
 import { otimizarSvgLikeSvgo, shouldSugerirOtimizacaoSvg } from '../../../shared/formatters/index.js';
 import { hasMinimumConfidence, isCategoryAllowed, shouldExcludeFile } from './auto-fix-config.js';
-// Small textual helpers used by some heuristics
 function _isInComment(match, fullCode) {
     const lines = fullCode.split('\n');
     const matchInicio = typeof match.index === 'number' ? match.index : fullCode.indexOf(match[0]);
@@ -46,20 +44,15 @@ function _isCriticalSystemFile(fullCode) {
     const criticalIndicators = ['SPDX-License-Identifier', '@core/configuracao', 'operario-estrutura', 'corretor-estrutura', 'config.js', 'executor.js', 'quick-fix-registry', 'mapa-reversao', 'persistence/persistencia'];
     return criticalIndicators.some(indice => fullCode.includes(indice));
 }
-// [ALERT] REGISTRY SEGURO - APENAS QUICK FIXES QUE NÃO QUEBRAM CÓDIGO
 export const quickCorrecaoRegistro = [
-    // [OK] Quick fixes reintroduzidos de forma conservadora:
-    // Começamos por SVGs, pois a transformação é determinística e segura.
     {
         id: 'svg-optimize-svgo-like',
         title: 'Otimizar SVG (Mahoraga)',
         description: 'Remove prolog/doctype/comentários/metadata e colapsa whitespace entre tags para reduzir tamanho do SVG.',
-        // Match único do arquivo inteiro
         pattern: /^[\s\S]+$/,
         category: 'performance',
         confidence: 95,
         shouldApply: (_match, fullCode, _lineContext, fileCaminho) => {
-            // Aceita apenas SVGs (por path ou, como fallback, por conteúdo)
             const pareceSvg = /<svg\b/i.test(fullCode);
             const isSvgCaminho = typeof fileCaminho === 'string' ? /\.svg$/i.test(fileCaminho) : false;
             if (!isSvgCaminho && !pareceSvg) {
@@ -98,7 +91,6 @@ export const quickCorrecaoRegistro = [
             if (/\bviewBox\s*=\s*['"][^'"]+['"]/i.test(fullCode)) {
                 return false;
             }
-            // Só aplica quando width/height são numéricos (ou px), evitando %/em/etc.
             const width = fullCode.match(/\bwidth\s*=\s*['"]([^'"]+)['"]/i)?.[1] ?? '';
             const height = fullCode.match(/\bheight\s*=\s*['"]([^'"]+)['"]/i)?.[1] ?? '';
             const parse = (valor) => {
@@ -110,7 +102,6 @@ export const quickCorrecaoRegistro = [
             return dimensaoLargura !== null && hash !== null && dimensaoLargura > 0 && hash > 0;
         },
         fix: (_match, fullCode) => {
-            // Insere viewBox no start tag do SVG
             const tagMatch = /<svg\b[^>]*>/i.exec(fullCode);
             if (!tagMatch) {
                 return fullCode;

package/dist/core/config/auto/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Auto-fix configuration and validation
- */
 export * from './auto-fix-config.js';
 export * from './fix-config.js';
 export * from './validation.js';

package/dist/core/config/auto/validation.js

@@ -1,13 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Sistema de validação para correções automáticas
- * Integra com o sistema existente de detectores do Mahoraga
- */
 import { getMessages } from '../../messages/index.js';
-/**
- * Valida sintaxe usando verificações robustas baseadas nos detectores existentes
- */
 export function validateJavaScriptSyntax(code) {
     const result = {
         isValid: true,
@@ -15,7 +6,6 @@ export function validateJavaScriptSyntax(code) {
         warnings: []
     };
     try {
-        // 1. Verificações básicas de balanceamento
         const braceContagem = (code.match(/{/g) ?? []).length - (code.match(/}/g) ?? []).length;
         const parenContagem = (code.match(/\(/g) ?? []).length - (code.match(/\)/g) ?? []).length;
         const bracketContagem = (code.match(/\[/g) ?? []).length - (code.match(/\]/g) ?? []).length;
@@ -31,22 +21,17 @@ export function validateJavaScriptSyntax(code) {
             result.errors.push(`Colchetes desbalanceados: ${bracketContagem > 0 ? 'faltam' : 'sobram'} ${Math.abs(bracketContagem)} colchete(s)`);
             result.isValid = false;
         }
-        // 2. Usar lógica similar ao detector de segurança para try-catch
         const tryBlocks = (code.match(/try\s*{/g) ?? []).length;
         const catchBlocks = (code.match(/catch\s*\(/g) ?? []).length;
         if (tryBlocks !== catchBlocks) {
             result.errors.push('Blocos try-catch desbalanceados');
             result.isValid = false;
         }
-        // 3. Verificar JSDoc órfãos (seguindo padrão dos detectores)
-        // Nota: Verificação simplificada - JSDoc pode aparecer em classes, interfaces, etc
         const jsdocBlocks = (code.match(/\/\*\*[\s\S]*?\*\//g) ?? []).length;
         const codeStructures = (code.match(/(?:export\s+)?(?:async\s+)?(?:function|class|interface|type)\s+\w+/g) ?? []).length;
-        // Apenas avisar se houver MUITOS JSDoc órfãos (possível geração automática problemática)
         if (jsdocBlocks > codeStructures + 5) {
             result.warnings.push(`Possível poluição de JSDoc: ${jsdocBlocks} blocos para ${codeStructures} estruturas`);
         }
-        // 4. Verificar imports/exports quebrados
         const importLines = code.split('\n').filter(line => line.trim().startsWith('import') || line.trim().startsWith('export'));
         for (const line of importLines) {
             if (!line.trim().endsWith(';') && !line.includes('from') && !line.includes('=')) {
@@ -60,9 +45,6 @@ export function validateJavaScriptSyntax(code) {
     }
     return result;
 }
-/**
- * Valida se a correção não introduz problemas conhecidos
- */
 export function validateQuickFixResult(originalCode, fixedCodigo, fixId) {
     const result = {
         isValid: true,
@@ -70,42 +52,34 @@ export function validateQuickFixResult(originalCode, fixedCodigo, fixId) {
         warnings: []
     };
     try {
-        // Validar sintaxe do código corrigido
         const syntaxValidation = validateJavaScriptSyntax(fixedCodigo);
         result.errors.push(...syntaxValidation.errors);
         result.warnings.push(...syntaxValidation.warnings);
         result.isValid = result.isValid && syntaxValidation.isValid;
-        // Validações específicas por tipo de correção
         switch (fixId) {
             case 'wrap-async-with-try-catch':
-                // Verificar se o try-catch foi adicionado corretamente
                 if (!fixedCodigo.includes('try {') || !fixedCodigo.includes('} catch')) {
                     result.errors.push('Try-catch não foi adicionado corretamente');
                     result.isValid = false;
                 }
-                // Verificar se não criamos try-catch aninhados desnecessários
                 const nestedTryContagem = (fixedCodigo.match(/try\s*{[^}]*try\s*{/g) ?? []).length;
                 if (nestedTryContagem > 0) {
                     result.warnings.push('Possível try-catch aninhado desnecessário');
                 }
                 break;
             case 'remove-console-log':
-                // Verificar se o console.log foi comentado corretamente
                 if (fixedCodigo.includes('console.log(') && !fixedCodigo.includes('// console.log(')) {
                     result.warnings.push('Console.log pode não ter sido comentado corretamente');
                 }
                 break;
             case 'fix-dangerous-html':
-                // Verificar se o innerHTML foi substituído corretamente
                 if (fixedCodigo.includes('innerHTML') && !fixedCodigo.includes('textContent')) {
                     result.warnings.push('innerHTML pode não ter sido substituído corretamente');
                 }
                 break;
         }
-        // Verificação geral: o código não deve ter ficado significativamente maior
         const sizeDiff = fixedCodigo.length - originalCode.length;
         if (sizeDiff > originalCode.length * 0.5) {
-            // Mais de 50% de aumento
             result.warnings.push(`Código aumentou significativamente (${sizeDiff} caracteres)`);
         }
     }
@@ -115,43 +89,30 @@ export function validateQuickFixResult(originalCode, fixedCodigo, fixId) {
     }
     return result;
 }
-/**
- * Valida se é seguro aplicar uma correção específica usando heurísticas dos detectores
- */
 export function isSafeToApplyFix(code, fixId, match) {
     try {
-        // Verificações gerais de segurança
-        // 1. Não aplicar em arquivos muito pequenos (possivelmente incompletos)
         if (code.length < 100) {
             return false;
         }
-        // 2. Não aplicar se o código tem muitos erros de sintaxe
         const validation = validateJavaScriptSyntax(code);
         if (validation.errors.length > 3) {
             return false;
         }
-        // 3. Verificações específicas baseadas nos detectores existentes
         switch (fixId) {
             case 'wrap-async-with-try-catch':
-                // Usar lógica similar ao detector-seguranca.ts para async/await
                 const lines = code.split('\n');
                 const matchLine = match.index ? code.substring(0, match.index).split('\n').length - 1 : 0;
-                // Verificar contexto (mesma lógica do detector de segurança)
                 const contextLines = lines.slice(Math.max(0, matchLine - 5), Math.min(lines.length, matchLine + 5));
                 const context = contextLines.join(' ');
-                // Não aplicar se já tem tratamento de erro próximo
                 if (context.includes('try') || context.includes('catch') || context.includes('.catch')) {
                     return false;
                 }
-                // Não aplicar se está em Promise.allSettled (tratamento próprio)
                 if (context.includes('Promise.allSettled')) {
                     return false;
                 }
                 break;
             case 'remove-console-log':
-                // Usar contexto similar aos detectores para verificar se é debug legítimo
                 const beforeMatch = code.substring(Math.max(0, (match.index ?? 0) - 200), match.index ?? 0);
-                // Não remover se está em contexto de desenvolvimento/debug
                 if (beforeMatch.includes('debug') || beforeMatch.includes('DEV_MODE') || beforeMatch.includes('VERBOSE')) {
                     return false;
                 }

package/dist/core/config/chalk-safe.js

@@ -1,9 +1,3 @@
-// SPDX-License-Identifier: MIT
-// Wrapper para uso seguro de chalk em ESM/CJS e ambientes de bundling/SSR
-// Objetivos:
-// - Fornecer API estável com funções obrigatórias (não opcionais) para evitar 'possibly undefined'.
-// - Suportar encadeamento básico usado no projeto (ex.: chalk.cyan.bold(...)).
-// - Em ambientes sem chalk, aplicar fallback de identidade (retorna a string sem cor/estilo).
 import chalkDefault from 'chalk';
 const ID = (string) => string;
 function getSourceFns(x) {
@@ -39,7 +33,6 @@ function makeChalkLike(src) {
     };
     const attachBoldChain = (colorFn) => {
         const fn = (string) => colorFn(string);
-        // suporte a encadeamento como chalk.cyan.bold(...)
         fn.bold = ((string) => colorFn(base.bold(string)));
         return fn;
     };
@@ -49,10 +42,8 @@ function makeChalkLike(src) {
     const yellow = attachBoldChain(base.yellow);
     const magenta = attachBoldChain(base.magenta);
     const gray = attachBoldChain(base.gray);
-    const dim = (string) => base.dim(string); // dim sem encadeamento usado
-    // bold em si (sem necessidade de cor encadeada no projeto)
+    const dim = (string) => base.dim(string);
     const bold = (string) => base.bold(string);
-    // Opcional: permitir bold.cyan(...), caso apareça futuramente
     bold.cyan = ((string) => base.cyan(base.bold(string)));
     bold.green = ((string) => base.green(base.bold(string)));
     bold.red = ((string) => base.red(base.bold(string)));
@@ -71,10 +62,5 @@ function makeChalkLike(src) {
         dim
     };
 }
-// Preferimos a instância default; se não existir, usamos o namespace (CJS)
 const resolvedUnknown = chalkDefault;
-/**
- * Instância segura de chalk com API estável e suporte a encadeamento.
- * Em ambientes sem chalk nativo, fornece fallback de identidade (sem cores).
- */
 export const chalk = makeChalkLike(getSourceFns(resolvedUnknown));

package/dist/core/config/config.js

@@ -1,39 +1,33 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import fs from 'node:fs';
 import path from 'node:path';
 import { lerArquivoTexto } from '../../shared/persistence/index.js';
-import { SUKUNA_ARQUIVOS, SUKUNA_DIRS } from '../registry/paths.js';
+import { MAHORAGA_ARQUIVOS, MAHORAGA_DIRS } from '../registry/paths.js';
 import { LIMITES_PADRAO } from './limites.js';
-const SUKUNA_ESTADO = SUKUNA_DIRS.STATE;
-const ZELADOR_ABANDONED = path.join(SUKUNA_ESTADO, 'abandonados');
+const MAHORAGA_ESTADO = MAHORAGA_DIRS.STATE;
+const ZELADOR_ABANDONED = path.join(MAHORAGA_ESTADO, 'abandonados');
 export const configPadrao = {
-    // ─── Dev & Debug ──────────────────────────────────────────────
     VERBOSE: false,
     LOG_LEVEL: 'info',
-    DEV_MODE: process.env.NODE_ENV === 'development' || process.env.SUKUNA_DEV === 'true',
+    DEV_MODE: process.env.NODE_ENV === 'development' || process.env.MAHORAGA_DEV === 'true',
     AUTOANALISE_CONCURRENCY: 5,
     COMPACT_MODE: false,
     SCAN_ONLY: false,
     ANALISE_SCAN_ONLY: false,
     LOG_ESTRUTURADO: false,
-    // ─── Segurança ────────────────────────────────────────────────
-    SAFE_MODE: process.env.VITEST ? false : process.env.SUKUNA_SAFE_MODE !== '0',
-    ALLOW_PLUGINS: process.env.SUKUNA_ALLOW_PLUGINS === '1' || false,
-    ALLOW_EXEC: process.env.SUKUNA_ALLOW_EXEC === '1' || false,
+    SAFE_MODE: process.env.VITEST ? false : process.env.MAHORAGA_SAFE_MODE !== '0',
+    ALLOW_PLUGINS: process.env.MAHORAGA_ALLOW_PLUGINS === '1' || false,
+    ALLOW_EXEC: process.env.MAHORAGA_ALLOW_EXEC === '1' || false,
     ALLOW_MUTATE_FS: true,
-    // ─── Guardian ─────────────────────────────────────────────────
     GUARDIAN_ENABLED: true,
     GUARDIAN_ENFORCE_PROTECTION: true,
-    GUARDIAN_BASELINE: SUKUNA_ARQUIVOS.GUARDIAN_BASELINE,
+    GUARDIAN_BASELINE: MAHORAGA_ARQUIVOS.GUARDIAN_BASELINE,
     GUARDIAN_ALLOW_ADDS: false,
     GUARDIAN_ALLOW_CHG: false,
     GUARDIAN_ALLOW_DELS: false,
-    // ─── Relatórios ───────────────────────────────────────────────
     REPORT_SILENCE_LOGS: false,
     SUPPRESS_PARCIAL_LOGS: false,
     REPORT_EXPORT_ENABLED: false,
-    REPORT_OUTPUT_DIR: SUKUNA_DIRS.REPORTS,
+    REPORT_OUTPUT_DIR: MAHORAGA_DIRS.REPORTS,
     REPORT_EXPORT_FULL: false,
     REPORT_FRAGMENT_OCCURRENCES: 2000,
     REPORT_FRAGMENT_FILEENTRIES: 500,
@@ -45,16 +39,14 @@ export const configPadrao = {
     REPORT_STREAM_COMPRESS: true,
     RELATORIO_SAUDE_TABELA_ENABLED: true,
     RELATORIO_SAUDE_DETALHADO_VERBOSE: true,
-    // ─── Zelador ──────────────────────────────────────────────────
-    SUKUNA_STATE_DIR: SUKUNA_ESTADO,
+    MAHORAGA_STATE_DIR: MAHORAGA_ESTADO,
     ZELADOR_ABANDONED_DIR: ZELADOR_ABANDONED,
-    ZELADOR_PENDING_PATH: path.join(SUKUNA_ESTADO, 'pendentes.json'),
-    ZELADOR_REACTIVATE_PATH: path.join(SUKUNA_ESTADO, 'reativar.json'),
-    ZELADOR_HISTORY_PATH: path.join(SUKUNA_ESTADO, 'historico.json'),
-    ZELADOR_REPORT_PATH: path.join(SUKUNA_ESTADO, 'poda-mahoraga.md'),
+    ZELADOR_PENDING_PATH: path.join(MAHORAGA_ESTADO, 'pendentes.json'),
+    ZELADOR_REACTIVATE_PATH: path.join(MAHORAGA_ESTADO, 'reativar.json'),
+    ZELADOR_HISTORY_PATH: path.join(MAHORAGA_ESTADO, 'historico.json'),
+    ZELADOR_REPORT_PATH: path.join(MAHORAGA_ESTADO, 'poda-mahoraga.md'),
     ZELADOR_GHOST_INACTIVITY_DAYS: 30,
     ZELADOR_LINE_THRESHOLD: 20,
-    // ─── Filtros CLI ──────────────────────────────────────────────
     CLI_INCLUDE_PATTERNS: [],
     CLI_INCLUDE_GROUPS: [],
     CLI_EXCLUDE_PATTERNS: [],
@@ -68,7 +60,6 @@ export const configPadrao = {
             '**/.git/**', 'next/**',
         ]
     },
-    // ─── Scanner & Extensões ──────────────────────────────────────
     SCANNER_EXTENSOES_COM_AST: [
         '.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs',
         '.gradle', '.gradle.kts',
@@ -82,7 +73,6 @@ export const configPadrao = {
         '.sh', '.bash', '.zsh', '.fish',
     ],
     VIGIA_TOP_N: 10,
-    // ─── Análise & Limites ────────────────────────────────────────
     ANALISE_LIMITES: {
         FUNCOES_LONGAS: {
             MAX_LINHAS: LIMITES_PADRAO.CODIGO.MAX_LINHAS_FUNCAO,
@@ -98,7 +88,7 @@ export const configPadrao = {
     ANALISE_AST_CACHE_ENABLED: true,
     ANALISE_METRICAS_ENABLED: true,
     ANALISE_TIMEOUT_POR_ANALISTA_MS: 30000,
-    ANALISE_METRICAS_HISTORICO_PATH: path.join(SUKUNA_ESTADO, 'historico-metricas', 'metricas-historico.json'),
+    ANALISE_METRICAS_HISTORICO_PATH: path.join(MAHORAGA_ESTADO, 'historico-metricas', 'metricas-historico.json'),
     ANALISE_METRICAS_HISTORICO_MAX: 200,
     ANALISE_PRIORIZACAO_ENABLED: true,
     ANALISE_PRIORIZACAO_PESOS: {
@@ -106,26 +96,21 @@ export const configPadrao = {
         ocorrencias: 2,
         penalidadeReuso: 0.5
     },
-    // ─── Cache & Incremental ──────────────────────────────────────
     ANALISE_INCREMENTAL_ENABLED: false,
-    ANALISE_INCREMENTAL_STATE_PATH: path.join(SUKUNA_ESTADO, 'incremental-analise.json'),
+    ANALISE_INCREMENTAL_STATE_PATH: path.join(MAHORAGA_ESTADO, 'incremental-analise.json'),
     ANALISE_INCREMENTAL_VERSION: 1,
     ANALISE_CACHE_ENABLED: false,
-    ANALISE_CACHE_STATE_PATH: path.join(SUKUNA_ESTADO, 'analysis-cache.json'),
+    ANALISE_CACHE_STATE_PATH: path.join(MAHORAGA_ESTADO, 'analysis-cache.json'),
     ANALISE_CACHE_VERSION: 1,
     ANALISE_CACHE_TTL_MS: 86400000,
-    // ─── Workers ──────────────────────────────────────────────────
     WORKER_POOL_ENABLED: true,
     WORKER_POOL_MAX_WORKERS: 0,
     WORKER_POOL_BATCH_SIZE: 10,
     WORKER_POOL_AUTO_THRESHOLD: 50,
-    // ─── Parse Errors ─────────────────────────────────────────────
     PARSE_ERRO_AGRUPAR: true,
     PARSE_ERRO_MAX_POR_ARQUIVO: 1,
     PARSE_ERRO_FALHA: false,
-    // ─── Performance ──────────────────────────────────────────────
     PERF_SNAPSHOT_DIR: path.join('docs', 'perf'),
-    // ─── Estrutura do Projeto ─────────────────────────────────────
     ESTRUTURA_TARGETS: {
         TESTS_RAIZ_DIR: 'src',
         SCRIPTS_DIR: path.posix.join('src', 'scripts'),
@@ -173,20 +158,17 @@ export const configPadrao = {
     STRUCTURE_AUTO_FIX: false,
     STRUCTURE_CONCURRENCY: 5,
     ESTRUTURA_CAMADAS: {},
-    STRUCTURE_REVERSE_MAP_PATH: path.join(SUKUNA_ESTADO, 'mapa-reversao.json'),
+    STRUCTURE_REVERSE_MAP_PATH: path.join(MAHORAGA_ESTADO, 'mapa-reversao.json'),
     ESTRUTURA_PLANO_MAX_FILE_SIZE: 256 * 1024,
     ESTRUTURA_ARQUIVOS_RAIZ_MAX: 10,
-    // ─── Legado / Compatibilidade ─────────────────────────────────
-    STATE_DIR: SUKUNA_ESTADO,
-    ZELADOR_STATE_DIR: SUKUNA_ESTADO,
-    // ─── Regras & Testes ──────────────────────────────────────────
+    STATE_DIR: MAHORAGA_ESTADO,
+    ZELADOR_STATE_DIR: MAHORAGA_ESTADO,
     rules: {},
     testPadroes: {
         files: ['**/*.test.*', '**/*.spec.*', 'test/**/*', 'tests/**/*', '**/__tests__/**'],
         excludeFromOrphanCheck: true,
         allowAnyType: false
     },
-    // ─── Internacionalização ──────────────────────────────────────
     LOCALE: 'pt'
 };
 export const config = structuredClone(configPadrao);
@@ -308,7 +290,7 @@ function carregarEnvConfig() {
         const { obj, prefix } = popped;
         for (const chave of Object.keys(obj)) {
             const keyCaminho = prefix ? `${prefix}.${chave}` : chave;
-            const envNome = `SUKUNA_${keyCaminho.replace(/\./g, '_').toUpperCase()}`;
+            const envNome = `MAHORAGA_${keyCaminho.replace(/\./g, '_').toUpperCase()}`;
             const currentVal = obj[chave];
             if (ehObjetoPlano(currentVal)) {
                 stack.push({ obj: currentVal, prefix: keyCaminho });
@@ -374,7 +356,6 @@ async function carregarConfigJSON(nome, diretorio) {
         }
     }
     catch {
-        /* ignore */
     }
     return null;
 }
@@ -388,7 +369,6 @@ function carregarConfigJSONSync(nome) {
         }
     }
     catch {
-        /* ignore sync errors */
     }
     return null;
 }

package/dist/core/config/configuracao-scoring.js

@@ -1,45 +1,26 @@
-// SPDX-License-Identifier: MIT
-/**
- * Configuração centralizada do sistema de pontuação de arquétipos
- * Valores ajustáveis para otimizar detecção e resiliência
- */
-// Configuração padrão - otimizada para resiliência
 export const CONFIGURACAO_PADRAO = {
-    // Constantes base
     PENALIDADE_MISSING_REQUIRED: 20,
     PESO_OPTIONAL: 5,
     PESO_REQUIRED: 10,
     PESO_DEPENDENCIA: 10,
     PESO_PADRAO: 5,
     PENALIDADE_FORBIDDEN: 20,
-    // Fatores adaptativos (máximos)
     FATOR_ESCALA_TAMANHO_MAX: 5,
-    // 5x para projetos muito grandes
     FATOR_COMPLEXIDADE_MAX: 3,
-    // 3x para projetos muito complexos
     FATOR_MATURIDADE_MAX: 3,
-    // 3x para projetos muito maduros
-    // Thresholds de decisão
     THRESHOLD_CONFIANCA_MINIMA: 30,
-    // Mínimo para considerar válido
     THRESHOLD_DIFERENCA_DOMINANTE: 15,
-    // Diferença para considerar dominante
     THRESHOLD_HIBRIDO_REAL: 0.3,
-    // Fração de sobreposição para híbrido
-    // Bônus e penalidades
     BONUS_COMPLETUDE_BASE: 50,
     BONUS_ESPECIFICIDADE_MULTIPLIER: 1.5,
     PENALIDADE_GENERICO_EXTREMA: 1000,
-    // Ajustes por tamanho
     AJUSTE_CONFIANCA_PROJETO_GRANDE: -5,
     AJUSTE_CONFIANCA_PROJETO_PEQUENO: 10,
     LIMITE_ARQUIVOS_GRANDE: 500,
     LIMITE_ARQUIVOS_PEQUENO: 20,
-    // Sistema de maturidade
     LIMITE_FUNCOES_MATURIDADE: 50,
     MULTIPLICADOR_MATURIDADE: 1.2
 };
-// Configuração conservadora - mais rigorosa
 export const CONFIGURACAO_CONSERVADORA = {
     ...CONFIGURACAO_PADRAO,
     THRESHOLD_CONFIANCA_MINIMA: 40,
@@ -47,7 +28,6 @@ export const CONFIGURACAO_CONSERVADORA = {
     PENALIDADE_MISSING_REQUIRED: 25,
     BONUS_COMPLETUDE_BASE: 40
 };
-// Configuração permissiva - mais tolerante
 export const CONFIGURACAO_PERMISSIVA = {
     ...CONFIGURACAO_PADRAO,
     THRESHOLD_CONFIANCA_MINIMA: 20,
@@ -55,9 +35,8 @@ export const CONFIGURACAO_PERMISSIVA = {
     PENALIDADE_MISSING_REQUIRED: 15,
     BONUS_COMPLETUDE_BASE: 60
 };
-// Função para obter a configuração atual baseada na variável de ambiente
 export function obterConfiguracaoAtual() {
-    const modo = process.env.SUKUNA_MODO_PONTUACAO ?? 'padrao';
+    const modo = process.env.MAHORAGA_MODO_PONTUACAO ?? 'padrao';
     switch (modo.toLowerCase()) {
         case 'conservador':
         case 'strict':

package/dist/core/config/conventions.js

@@ -1,9 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Convenções do projeto analisado (paths e utilitários).
- *
- * Objetivo: evitar hardcodes como "src/tipos" espalhados em detectores e correções.
- */
 import path from 'node:path';
 import { config } from './config.js';
 function toPosix(caminho) {
@@ -14,7 +8,6 @@ function trimSlashes(caminho) {
 }
 export function getTypesDirectoryRelPosix() {
     const raw = config;
-    // Prioriza nameConventions (ex: 'types') sobre conventions (ex: 'src/tipos') pois é a nova forma configurável
     const string = typeof raw.nameConventions?.typesDirectory === 'string' && raw.nameConventions.typesDirectory.trim() || typeof raw.conventions?.typesDirectory === 'string' && raw.conventions.typesDirectory.trim() || 'src/tipos';
     return trimSlashes(toPosix(string));
 }
@@ -25,24 +18,17 @@ export function getTypesDirectoryDisplay() {
 export function isInsideTypesDirectory(relPath) {
     const norm = trimSlashes(toPosix(relPath));
     const base = getTypesDirectoryRelPosix();
-    // 1. Verificação direta pelo caminho configurado (que já considera prioridade e fallback)
     if (norm === base || norm.startsWith(`${base}/`)) {
         return true;
     }
-    // 2. Verificação por variantes (ex: reconhecer 'types' se estiver configurado 'tipos' ou vice-versa)
     return isInsideDirectory(relPath, 'typesDirectory');
 }
-/**
- * Verifica se um caminho está dentro de um diretório específico baseado em convenções e variantes.
- */
 export function isInsideDirectory(relPath, key) {
     const norm = trimSlashes(toPosix(relPath));
     const expected = getExpectedDirectoryName(key);
-    // 1. Verificação direta pelo nome configurado
     if (expected && (norm === expected || norm.split('/').some(seg => seg === expected))) {
         return true;
     }
-    // 2. Verificação por variantes (idiomas, abreviações, etc)
     const pattern = getDirVariantPattern(key);
     const segments = norm.split('/');
     return segments.some(seg => pattern.test(seg));
@@ -67,11 +53,6 @@ export function buildTypesRelPathPosix(relInsideTypesDir) {
     const inside = trimSlashes(toPosix(relInsideTypesDir));
     return inside ? `${base}/${inside}` : base;
 }
-/**
- * Constrói um path de filesystem (com separador do SO) para um arquivo dentro do diretório de tipos.
- *
- * Ex.: base 'app/types' + 'shared/user.ts' => 'app/types/shared/user.ts' (join do SO)
- */
 export function buildTypesFsPath(relInsideTypesDir) {
     const relPosix = buildTypesRelPathPosix(relInsideTypesDir);
     return path.join(...relPosix.split('/'));

package/dist/core/config/excludes-padrao.js

@@ -1,26 +1,6 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Configuração centralizada dos padrões de exclusão do Mahoraga
- *
- * Esta configuração define os padrões padrão de exclusão usados pelo sistema
- * de análise quando nenhum outro filtro é especificado.
- *
- * Precedência de configuração:
- * 1. Flags --include/--exclude (mais alta prioridade)
- * 2. mahoraga.config.json (configuração do projeto)
- * 3. Este arquivo (padrões do sistema)
- * 4. Fallback hardcoded (mais baixa prioridade)
- */
 import { getMessages } from '../messages/index.js';
-/**
- * Configuração padrão dos padrões de exclusão
- *
- * Estes são os padrões recomendados pelo Mahoraga para diferentes tipos de projeto.
- * Eles podem ser sobrescritos pelo usuário via mahoraga.config.json
- */
 export const EXCLUDES_PADRAO = {
-    padroesSistema: ['node_modules', '**/node_modules/**', 'dist/**', 'out/**', '**/out/**', '.next/**', '**/.next/**', '**/dist/**', 'build/**', '**/build/**', '**/*.log', '**/*.lock', 'package.json', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', '**/.git/**', '.pnpm/**', 'mahoraga/**', '**/.mahoraga/**', 'preview-mahoraga/**', 'mahoraga/PREVIEW*', 'PREVIEW*', 'tests/fixtures/**', 'THIRD-PARTY-NOTICES.txt', '**/THIRD-PARTY-NOTICES.txt', '**/*LICENSE*', '**/*NOTICE*', '**/*CHANGELOG*', '**/*.min.js', '**/*.min.css', '**/bundle.*', '**/*generated*', '**/*autogenerated*'],
+    padroesSistema: ['node_modules', '**/node_modules/**', 'dist', 'dist/**', '**/dist/**', 'out', 'out/**', '**/out/**', '.next', '.next/**', '**/.next/**', 'build/**', '**/build/**', '**/*.log', '**/*.lock', 'package.json', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', '**/.git/**', '.pnpm/**', 'mahoraga/**', '**/.mahoraga/**', 'preview-mahoraga/**', 'mahoraga/PREVIEW*', 'PREVIEW*', 'tests/fixtures/**', 'THIRD-PARTY-NOTICES.txt', '**/THIRD-PARTY-NOTICES.txt', '**/*LICENSE*', '**/*NOTICE*', '**/*CHANGELOG*', '**/*.min.js', '**/*.min.css', '**/bundle.*', '**/*generated*', '**/*autogenerated*'],
     nodeJs: ['node_modules/**', '**/node_modules/**', 'npm-debug.log*', 'yarn-debug.log*', 'yarn-error.log*', '.npm', '.yarn', 'coverage/**', '**/coverage/**', '.nyc_output', 'dist/**', '**/dist/**', 'build/**', '**/build/**'],
     typeScript: ['dist/**', '**/dist/**', 'build/**', '**/build/**', '*.tsbuildinfo', '**/*.tsbuildinfo', '.tsbuildinfo', 'out/**', '**/out/**'],
     python: ['__pycache__/**', '**/__pycache__/**', '*.pyc', '**/*.pyc', '*.pyo', '**/*.pyo', '*.pyd', '**/*.pyd', '.Python', 'env/**', 'venv/**', '.env/**', 'pip-log.txt', 'pip-delete-this-directory.txt', '.tox/**', '.coverage', 'htmlcov/**', '.pytest_cache/**', '.mypy_cache/**'],
@@ -35,12 +15,6 @@ export const EXCLUDES_PADRAO = {
         descricao: 'Configuração padrão dos padrões de exclusão do Mahoraga'
     }
 };
-/**
- * Função para obter os padrões de exclusão recomendados baseado no tipo de projeto
- *
- * @param tipoProjeto Tipo de projeto detectado ou 'generico' para padrões gerais
- * @returns Array de padrões de exclusão recomendados
- */
 export function getExcludesRecomendados(tipoProjeto = 'generico') {
     const base = [...EXCLUDES_PADRAO.padroesSistema];
     switch (tipoProjeto.toLowerCase()) {
@@ -59,49 +33,23 @@ export function getExcludesRecomendados(tipoProjeto = 'generico') {
             return [...base, ...EXCLUDES_PADRAO.ferramentasDev, ...EXCLUDES_PADRAO.controleVersao, ...EXCLUDES_PADRAO.temporarios];
     }
 }
-/**
- * Função para validar se um padrão de exclusão é seguro
- *
- * @param padrao Padrão a ser validado
- * @returns true se o padrão é considerado seguro
- */
 export function isPadraoExclusaoSeguro(padrao) {
     const padroesPerigosos = ['**/*',
-        // Exclui tudo
         '*',
-        // Exclui tudo no nível atual
         '*/**/*',
-        // Exclui tudo recursivamente
         '**',
-        // Exclui tudo
-        '' // Padrão vazio
+        ''
     ];
-    // Verifica se o padrão contém caracteres perigosos
     if (padroesPerigosos.includes(padrao.trim())) {
         return false;
     }
-    // Verifica se o padrão é muito genérico (muitos asteriscos consecutivos)
     if (padrao.includes('***') || padrao.includes('****')) {
         return false;
     }
     return true;
 }
-/**
- * Função para mesclar configurações de exclusão com precedência
- *
- * Precedência (do mais alto para o mais baixo):
- * 1. Configuração do usuário via mahoraga.config.json
- * 2. Padrões recomendados baseados no tipo de projeto
- * 3. Padrões do sistema
- *
- * @param configUsuario Configuração do usuário (pode ser null/undefined)
- * @param tipoProjeto Tipo de projeto para padrões recomendados
- * @returns Array consolidado de padrões de exclusão
- */
 export function mesclarConfigExcludes(configUsuario, tipoProjeto = 'generico') {
-    // Se o usuário definiu configuração própria, usa ela
     if (configUsuario && Array.isArray(configUsuario) && configUsuario.length > 0) {
-        // Valida os padrões do usuário
         const padroesValidos = configUsuario.filter(isPadraoExclusaoSeguro);
         if (padroesValidos.length !== configUsuario.length) {
             const { SharedCommonMensagens } = getMessages();
@@ -109,6 +57,5 @@ export function mesclarConfigExcludes(configUsuario, tipoProjeto = 'generico') {
         }
         return Array.from(new Set(padroesValidos));
     }
-    // Caso contrário, usa os padrões recomendados
     return getExcludesRecomendados(tipoProjeto);
 }