@mocoto/mahoraga 0.14.7 → 0.14.9

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);
 }

package/dist/core/config/filters.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};

package/dist/core/config/format.js

@@ -1,10 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Utilitários de formatação padronizada para métricas e valores numéricos
- */
-/**
- * Formata milissegundos em string legível
- */
 export function formatMs(valor) {
     if (valor === null || valor === undefined || Number.isNaN(valor)) {
         return '-';

package/dist/core/config/include-exclude.js

@@ -1,15 +1,9 @@
 import micromatch from 'micromatch';
-/**
- * Avalia se um caminho deve ser incluído conforme config simplificada.
- * Hierarquia: CLI flags > globalExcludeGlob > inclui por padrão
- */
 export function shouldInclude(relPath, entry, config) {
-    // APENAS globalExcludeGlob é considerado - outros campos são ignorados
     if (Array.isArray(config.globalExcludeGlob) &&
         config.globalExcludeGlob.length > 0 &&
         micromatch.isMatch(relPath, config.globalExcludeGlob)) {
         return false;
     }
-    // Default: inclui se não excluído
     return true;
 }

package/dist/core/config/index.js

@@ -1,4 +1,3 @@
-// Default export
 export * from './chalk-safe.js';
 export * from './config.js';
 export * from './config-defaults.js';

package/dist/core/config/limites.js

@@ -1,10 +1,4 @@
-// SPDX-License-Identifier: MIT
-/**
- * Limites e thresholds padrão para análise de código e detectores.
- * Centraliza "números mágicos" para facilitar a configuração e overrides.
- */
 export const LIMITES_PADRAO = {
-    // Limites de código para detector-codigo-fragil e analista-funcoes-longas
     CODIGO: {
         MAX_LINHAS_FUNCAO: 30,
         MAX_PARAMETROS_FUNCAO: 4,
@@ -15,21 +9,17 @@ export const LIMITES_PADRAO = {
         MAX_ANINHAMENTO_IF: 3,
         MAX_LINHAS_ARQUIVO: 300
     },
-    // Limites para detecção de arquivos fantasmas (ghost files)
     GUARDIAN: {
         DIAS_INATIVIDADE_GHOST: 45
     },
-    // Thresholds de segurança e entropia
     SEGURANCA: {
         ENTROPIA_SHANNON_ALTA: 3.5
     },
-    // Configurações de auto-fix
     AUTO_FIX: {
         CONFIANCA_MINIMA: 75,
         TIMEOUT_PADRAO_MS: 60000,
         TIMEOUT_TESTE_MS: 1000
     },
-    // Timeouts globais
     TIMEOUTS: {
         ANALISTA_PADRAO_MS: 30000,
         ARQUETIPO_DETECCAO_MS: 30000

package/dist/core/config/paths.js

@@ -1,20 +1,13 @@
-// SPDX-License-Identifier: MIT
-// Centraliza padrões e utilidades de caminhos para evitar hardcodes dispersos
 export const SRC_RAIZ = 'src';
 export const SRC_GLOB = 'src/**';
-// Diretórios sempre tratados como meta (independente de SRC)
 export const META_DIRS = ['.github', '.vscode', '.mahoraga'];
-// Normaliza para separador POSIX
 export function toPosix(caminho) {
     return (caminho || '').replace(/\\+/g, '/');
 }
-// Caminho relativo (POSIX) está dentro de src?
 export function isInsideSrc(relPath) {
     const raiz = toPosix(relPath);
-    // Considera qualquer segmento que case com src, source ou codigo: (^|/)(src|source|codigo)(/|$)
     return /(?:^|\/)(?:src|source|codigo)(?:\/|$)/i.test(raiz);
 }
-// Heurística de meta: tudo fora de src é meta, além dos diretórios explícitos
 export function isMetaPath(relPath) {
     const raiz = toPosix(relPath);
     if (META_DIRS.some(diretorio => raiz === diretorio || raiz.startsWith(`${diretorio}/`))) {

package/dist/core/config/security.js

@@ -1,11 +1,4 @@
-// SPDX-License-Identifier: MIT
 import path from 'node:path';
-/**
- * Sanitiza um caminho relativo, eliminando tentativas de escape (..),
- * barras duplicadas e separadores inconsistentes.
- * @param rel - Caminho relativo a sanitizar
- * @returns Caminho normalizado e seguro
- */
 export function sanitizarRelPath(rel) {
     if (!rel) {
         return '';
@@ -14,30 +7,15 @@ export function sanitizarRelPath(rel) {
     const norm = safe.replace(/\\+/g, '/');
     const collapsed = path.posix.normalize(norm);
     if (collapsed.startsWith('..')) {
-        // remove todos os prefixos de ../ e ./ e barras iniciais resultantes
         const semDots = collapsed.replace(new RegExp('^(\\.\\.\\/?|\\.\\/)+'), '');
         return semDots.replace(/^\/+/, '');
     }
     return collapsed.replace(/^\/+/, '');
 }
-/**
- * Verifica se um caminho alvo está contido dentro do diretório base.
- * Impede acesso a caminhos fora da raiz do projeto.
- * @param baseDir - Diretório base de referência
- * @param alvo - Caminho absoluto do alvo a verificar
- * @returns `true` se o alvo está dentro do baseDir
- */
 export function estaDentro(baseDir, alvo) {
     const rel = path.relative(baseDir, alvo);
     return !!rel && !rel.startsWith('..') && !path.isAbsolute(rel);
 }
-/**
- * Resolve o caminho de um plugin de forma segura, verificando se está
- * dentro da raiz do projeto e se possui extensão permitida.
- * @param baseDir - Diretório raiz do projeto
- * @param pluginRel - Caminho relativo do plugin
- * @returns Objeto com `caminho` resolvido ou `erro` descritivo
- */
 export function resolverPluginSeguro(baseDir, pluginRel) {
     try {
         if (typeof pluginRel !== 'string' || !pluginRel.trim()) {
@@ -51,7 +29,6 @@ export function resolverPluginSeguro(baseDir, pluginRel) {
                 erro: 'plugin fora da raiz do projeto (bloqueado)'
             };
         }
-        // Restringe extensões para reduzir risco de execução arbitrária
         const permitido = [/\.(c|m)?js$/i, /\.ts$/i];
         if (!permitido.some(raiz => raiz.test(resolvido))) {
             return {
@@ -68,28 +45,16 @@ export function resolverPluginSeguro(baseDir, pluginRel) {
         };
     }
 }
-/**
- * Valida se um padrão glob é seguro para uso, bloqueando
- * padrões excessivamente longos ou com muitos wildcards recursivos.
- * @param padrao - Padrão glob a validar
- * @returns `true` se o padrão é considerado seguro
- */
 export function validarGlobBasico(padrao) {
     if (padrao.length > 300) {
         return false;
     }
-    // Bloqueia mais de 4 ocorrências de '**' mesmo não consecutivas
     const ocorrencias = (padrao.match(/\*\*/g) ?? []).length;
     if (ocorrencias >= 5) {
         return false;
     }
     return true;
 }
-/**
- * Filtra uma lista de padrões glob, retornando apenas os que são seguros.
- * @param padroes - Lista de padrões glob a filtrar
- * @returns Lista contendo apenas os padrões que passaram na validação
- */
 export function filtrarGlobSeguros(padroes) {
     return padroes.filter(caminho => validarGlobBasico(caminho));
 }

package/dist/core/config/traverse.js

@@ -1,7 +1,5 @@
-// SPDX-License-Identifier: MIT
 import traverseModule from '@babel/traverse';
 let _traverseModule = traverseModule;
-// Setter usado apenas em testes para injetar variações do módulo
 export function __setTraverseModule(modulo) {
     _traverseModule = modulo;
 }

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

@@ -1,5 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * Tipos para sistema de quick fixes de configuração automática
- */
 export {};

package/dist/core/execution/ambiente.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};

package/dist/core/execution/analysis-cache.js

@@ -1,20 +1,10 @@
-// SPDX-License-Identifier: MIT
-// Cache de análise persistente entre execuções
 import XXH from 'xxhashjs';
 import { config } from '../config/index.js';
 import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
-/**
- * Cache de análise entre execuções.
- * Armazena resultados de análise por hash de conteúdo de arquivo,
- * permitindo reuso em execuções subsequentes.
- */
 export class AnalysisCache {
     cache = {};
     loaded = false;
     loadingPromise = null;
-    /**
-     * Carrega o cache do disco com proteção contra re-entrância
-     */
     async load() {
         if (this.loaded) {
             return;
@@ -36,16 +26,12 @@ export class AnalysisCache {
             }
         }
         catch {
-            // usa estado vazio
         }
         finally {
             this.loaded = true;
             this.loadingPromise = null;
         }
     }
-    /**
-     * Obtém resultado em cache para um arquivo
-     */
     async get(relPath, conteudo) {
         if (!config.ANALISE_CACHE_ENABLED) {
             return null;
@@ -56,7 +42,6 @@ export class AnalysisCache {
         if (entry?.hash !== hash) {
             return null;
         }
-        // Verifica TTL
         if (config.ANALISE_CACHE_TTL_MS > 0) {
             const idade = Date.now() - entry.timestamp;
             if (idade > config.ANALISE_CACHE_TTL_MS) {
@@ -64,12 +49,8 @@ export class AnalysisCache {
                 return null;
             }
         }
-        // Verifica se o arquivo ainda existe e tem o mesmo tamanho
         return entry.ocorrencias;
     }
-    /**
-     * Armazena resultado de análise no cache
-     */
     async set(relPath, conteudo, ocorrencias) {
         if (!config.ANALISE_CACHE_ENABLED) {
             return;
@@ -82,23 +63,14 @@ export class AnalysisCache {
             count: ocorrencias.length
         };
     }
-    /**
-     * Remove entrada do cache
-     */
     async invalidate(relPath) {
         await this.load();
         Reflect.deleteProperty(this.cache, relPath);
     }
-    /**
-     * Limpa todo o cache
-     */
     async clear() {
         this.cache = {};
         await this.persistir();
     }
-    /**
-     * Salva cache no disco
-     */
     async persistir() {
         if (!config.ANALISE_CACHE_ENABLED) {
             return;
@@ -110,9 +82,6 @@ export class AnalysisCache {
         };
         await salvarEstado(config.ANALISE_CACHE_STATE_PATH, data);
     }
-    /**
-     * Retorna estatísticas do cache
-     */
     estatisticas() {
         const entradas = Object.keys(this.cache);
         const totalOcorrencias = entradas.reduce((acc, key) => acc + this.cache[key].count, 0);
@@ -137,5 +106,4 @@ export class AnalysisCache {
         }
     }
 }
-// Singleton
 export const analysisCache = new AnalysisCache();

package/dist/core/execution/ast-cache.js

@@ -1,18 +1,5 @@
 import { decifrarSintaxe, TEM_PARSER } from '../parsing/parser.js';
 const AST_SENTINEL = {};
-/**
- * Cache de AST com escopo de execução.
- *
- * Compartilha ASTs entre analistas que processam o mesmo arquivo
- * durante uma única execução de análise. Elimina re-parsing
- * desnecessário quando múltiplas técnicas atuam sobre o mesmo arquivo.
- *
- * Funciona em conjunto com o cache global (process-level) mantido
- * pelo inquisidor, mas adiciona uma camada por escopo que:
- * - Garante consistência dentro da mesma execução
- * - Prepara o terreno para parsing lazy (parsear sob demanda)
- * - Coleta métricas granulares por escopo
- */
 export class ScopeAstCache {
     cache = new Map();
     metrics = {
@@ -21,34 +8,25 @@ export class ScopeAstCache {
         parseTimeMs: 0,
         cachedFiles: 0,
     };
-    /**
-     * Obtém ou faz parse do AST para um arquivo.
-     * Primeiro verifica o cache do escopo, depois o cache global
-     * (process-level), e por fim faz o parsing do conteúdo.
-     */
     async getOrParse(entry, ext) {
         const key = entry.relPath;
-        // 1) Cache do escopo atual
         const cached = this.cache.get(key);
         if (cached !== undefined) {
             this.metrics.hits++;
             return cached;
         }
-        // Pula extensões sem parser registrado
         if (!TEM_PARSER(ext)) {
             this.cache.set(key, null);
             return null;
         }
-        // 2) Cache global (process-level) do inquisidor
         const globalStore = globalThis;
-        const globalCache = globalStore.__SUKUNA_AST_CACHE__;
+        const globalCache = globalStore.__MAHORAGA_AST_CACHE__;
         const globalEntry = globalCache?.get(key);
         if (globalEntry?.ast) {
             this.cache.set(key, globalEntry.ast);
             this.metrics.hits++;
             return globalEntry.ast;
         }
-        // 3) Parsing sob demanda
         this.metrics.misses++;
         const inicio = performance.now();
         let ast = null;
@@ -65,21 +43,12 @@ export class ScopeAstCache {
         this.metrics.cachedFiles = this.cache.size;
         return ast;
     }
-    /**
-     * Verifica se um arquivo já está em cache neste escopo
-     */
     has(relPath) {
         return this.cache.has(relPath);
     }
-    /**
-     * Retorna métricas acumuladas do escopo atual
-     */
     getMetrics() {
         return { ...this.metrics };
     }
-    /**
-     * Limpa o cache do escopo
-     */
     clear() {
         this.cache.clear();
         this.metrics = { hits: 0, misses: 0, parseTimeMs: 0, cachedFiles: 0 };