@mocoto/mahoraga 0.14.8 → 0.14.9

package/dist/analysts/css/detectors/detector-css-best-practices.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';

package/dist/analysts/css/detectors/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './detector-css-best-practices.js';

package/dist/analysts/css/index.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export * from './analysts/analyst-css.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';

package/dist/analysts/css/plugins/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './plugin-registry.js';

package/dist/analysts/css/plugins/plugin-registry.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export class CssPluginRegistry {
     plugins = new Map();
     register(plugin) {

package/dist/analysts/css/scorers/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './scorer-css.js';

package/dist/analysts/css/scorers/scorer-css.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { splitLines } from '../../../shared/helpers/index.js';
 function contarPropriedadesPorBloco(linhas) {
     const props = new Map();

package/dist/analysts/css-in-js/analysts/analyst-css-in-js.js

@@ -1,9 +1,7 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { IMPORTANT_PATTERN } from '../shared.js';
 import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
-const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_CSS_IN_JS === '1';
+const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_CSS_IN_JS === '1';
 function findLine(src, index = 0) {
     return src.slice(0, index).split(/\n/).length;
 }

package/dist/analysts/css-in-js/corrections/correction-css-in-js.js

@@ -1,15 +1,3 @@
-// @mahoraga-disable css-in-js/regra
-// Justificativa: O código-fonte contém padrões CSS-in-JS (como createGlobalStyle e !important)
-// em expressões regulares de detecção, gerando falso positivo em auto-análise.
-// SPDX-License-Identifier: MIT
-/**
- * [CHAVE-INGLESA] Correções automáticas para CSS-in-JS
- *
- * Fornece correções sugeridas para problemas comuns em CSS-in-JS:
- * - Extrair global styles
- * - Remover !important
- * - Unificar abordagem de styling
- */
 import { getMessages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { IMPORTANT_PATTERN, IMPORTANT_WS_GLOBAL } from '../shared.js';

package/dist/analysts/css-in-js/corrections/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './correction-css-in-js.js';

package/dist/analysts/css-in-js/detectors/detector-css-in-js-best-practices.js

@@ -1,7 +1,3 @@
-// @mahoraga-disable css-in-js/regra ml-deep-nesting
-// Justificativa: O código-fonte contém padrões CSS-in-JS (como createGlobalStyle e !important)
-// em expressões regulares de detecção, gerando falso positivo em auto-análise.
-// SPDX-License-Identifier: MIT
 import { getMessages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { IMPORTANT_PATTERN } from '../shared.js';

package/dist/analysts/css-in-js/detectors/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './detector-css-in-js-best-practices.js';

package/dist/analysts/css-in-js/index.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export * from './analysts/analyst-css-in-js.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';

package/dist/analysts/css-in-js/plugins/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './plugin-registry.js';

package/dist/analysts/css-in-js/plugins/plugin-registry.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export class CssInJsPluginRegistry {
     plugins = new Map();
     register(plugin) {

package/dist/analysts/css-in-js/scorers/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './scorer-css-in-js.js';

package/dist/analysts/css-in-js/scorers/scorer-css-in-js.js

@@ -1,7 +1,3 @@
-// @mahoraga-disable css-in-js/regra ml-deep-nesting
-// Justificativa: O código-fonte contém padrões CSS-in-JS (como createGlobalStyle e !important)
-// em expressões regulares de detecção, gerando falso positivo em auto-análise.
-// SPDX-License-Identifier: MIT
 import { getMessages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { IMPORTANT_GLOBAL } from '../shared.js';

package/dist/analysts/css-in-js/shared.js

@@ -1,6 +1,3 @@
-// SPDX-License-Identifier: MIT
-// Padrões compartilhados para detecção CSS-in-JS
-// Usa construção dinâmica para evitar falso positivo em auto-análise
 const IMPORTANT_CHAR = String.fromCharCode(33);
 export const IMPORTANT_PATTERN = new RegExp(`${IMPORTANT_CHAR}important`);
 export const IMPORTANT_GLOBAL = new RegExp(`${IMPORTANT_CHAR}important`, 'g');

package/dist/analysts/detectors/detector-architecture.js

@@ -99,16 +99,13 @@ export const analistaArquitetura = {
             return [];
         }
         try {
-            // Analisar arquivo atual
             const estatisticasArquivo = analisarArquivo(ast, relPath, src);
-            // Analisar todo o contexto para entender a arquitetura
             let analiseCompleta;
             const ocorrencias = [];
             try {
                 analiseCompleta = analisarArquiteturaCompleta(contexto, estatisticasArquivo);
             }
             catch (erro) {
-                // Em caso de falha na análise contextual, registre ocorrência e continue sem travar
                 if (typeof contexto.report === 'function') {
                     contexto.report({
                         code: 'ARQ_ERRO',
@@ -132,7 +129,6 @@ export const analistaArquitetura = {
                         linha: 1
                     })];
             }
-            // Relatório principal da arquitetura
             if (typeof contexto.report === 'function') {
                 contexto.report({
                     code: 'ARQ_PADRAO',
@@ -199,7 +195,6 @@ function analisarArquivo(ast, relPath, _src) {
         ImportDeclaration(path) {
             const origem = path.node.source.value;
             const items = path.node.specifiers.map((spec) => {
-                // Mixed import specifier types
                 if (spec.type === 'ImportDefaultSpecifier') {
                     return 'default';
                 }
@@ -230,8 +225,7 @@ function analisarArquivo(ast, relPath, _src) {
         },
         ExportNamedDeclaration(path) {
             if (path.node.declaration) {
-                // export const/function/class/etc
-                const decl = path.node.declaration; // ExportDeclaration node
+                const decl = path.node.declaration;
                 if ('id' in decl && decl.id && 'name' in decl.id) {
                     exports.push({
                         nome: decl.id.name,
@@ -239,7 +233,6 @@ function analisarArquivo(ast, relPath, _src) {
                     });
                 }
                 else if ('declarations' in decl) {
-                    // export const a = ..., b = ...
                     for (const declarator of decl.declarations) {
                         if ('name' in declarator.id) {
                             exports.push({
@@ -251,9 +244,7 @@ function analisarArquivo(ast, relPath, _src) {
                 }
             }
             else {
-                // export { a, b }
                 for (const spec of path.node.specifiers) {
-                    // ExportSpecifier nodes
                     const name = 'exported' in spec && spec.exported.type === 'Identifier' && 'name' in spec.exported ? spec.exported.name : 'exported';
                     exports.push({
                         nome: name,
@@ -268,7 +259,6 @@ function analisarArquivo(ast, relPath, _src) {
                 tipo: 'default'
             });
         },
-        // Calcular complexidade ciclomática básica
         'IfStatement|WhileStatement|ForStatement|DoWhileStatement|SwitchCase|CatchClause'() {
             complexidade++;
         },
@@ -287,12 +277,9 @@ function analisarArquivo(ast, relPath, _src) {
     };
 }
 function analisarArquiteturaCompleta(contexto, arquivoAtual) {
-    // Analisar todos os arquivos para entender a arquitetura geral
     const todasEstatisticas = [];
     for (const arquivo of contexto.arquivos.slice(0, 50)) {
-        // Limitar para performance
         if (arquivo.ast && arquivo.content && arquivo.relPath.match(/\.(js|jsx|ts|tsx)$/)) {
-            // Verificar se o AST é do tipo correto (NodePath<Node>)
             if ('parent' in arquivo.ast && 'node' in arquivo.ast) {
                 const stats = analisarArquivo(arquivo.ast, arquivo.relPath, arquivo.content);
                 todasEstatisticas.push(stats);
@@ -300,24 +287,17 @@ function analisarArquiteturaCompleta(contexto, arquivoAtual) {
         }
     }
     todasEstatisticas.push(arquivoAtual);
-    // Detectar padrão arquitetural
     const padraoDetectado = detectarPadraoArquitetural(todasEstatisticas);
-    // Detectar Clean Architecture
     const cleanArchResultado = detectarCleanArchitecture(contexto, todasEstatisticas, arquivoAtual);
-    // Detectar Arquitetura Distribuída
     const distributedArchResultado = detectarArquiteturaDistribuida(contexto, todasEstatisticas, arquivoAtual);
-    // Escolher o padrão com maior confiança
     const melhoresPadroes = [
         { tipo: cleanArchResultado.tipo, confianca: cleanArchResultado.confianca },
         { tipo: distributedArchResultado.tipo, confianca: distributedArchResultado.confianca },
         padraoDetectado
     ].sort((a, b) => b.confianca - a.confianca);
     const padraoFinal = melhoresPadroes[0];
-    // Calcular métricas
     const metricas = calcularMetricas(todasEstatisticas);
-    // Detectar violações
     const violacoes = detectarViolacoes(todasEstatisticas, padraoDetectado);
-    // Gerar características (combinadas)
     const caracteristicas = [
         ...gerarCaracteristicas(todasEstatisticas),
         ...cleanArchResultado.caracteristicas,
@@ -348,7 +328,6 @@ function detectarPadraoArquitetural(estatisticas) {
     let temAnalistas = false;
     let temShared = false;
     let temTipos = false;
-    // Analisar uso de aliases
     for (const stats of estatisticas) {
         if (stats.aliases) {
             Object.keys(stats.aliases).forEach(alias => aliases.add(alias));
@@ -366,9 +345,7 @@ function detectarPadraoArquitetural(estatisticas) {
             }
         }
     }
-    // Detectar dependências circulares
     const temDependenciasCirculares = detectarDependenciasCirculares(estatisticas);
-    // Regras de detecção
     if (temNucleo && temAnalistas && !temDependenciasCirculares) {
         if (temShared && temTipos) {
             return {
@@ -413,7 +390,6 @@ function calcularMetricas(estatisticas) {
             complexidadeMedia: 0
         };
     }
-    // Modularidade = uso de aliases / total de imports
     const totalImports = estatisticas.reduce((sum, string) => {
         if (Array.isArray(string.imports)) {
             return sum + string.imports.length;
@@ -430,7 +406,6 @@ function calcularMetricas(estatisticas) {
         return sum;
     }, 0);
     const modularidade = totalImports > 0 ? importsAlias / totalImports : 0;
-    // Acoplamento = dependências externas / total de dependências
     const totalDeps = estatisticas.reduce((sum, string) => {
         const externas = string.dependenciasExternas?.length ?? 0;
         const internas = string.dependenciasInternas?.length ?? 0;
@@ -440,8 +415,6 @@ function calcularMetricas(estatisticas) {
         return sum + (string.dependenciasExternas?.length ?? 0);
     }, 0);
     const acoplamento = totalDeps > 0 ? depsExternas / totalDeps : 0;
-    // Coesão balanceada: penaliza tanto o excesso de exports (módulos "god")
-    // quanto o excesso de imports (módulos "cola"), buscando um equilíbrio saudável.
     const totalExports = estatisticas.reduce((sum, string) => {
         if (Array.isArray(string.exports)) {
             return sum + string.exports.length;
@@ -453,7 +426,6 @@ function calcularMetricas(estatisticas) {
     }, 0);
     const ratio = totalImports > 0 ? totalExports / totalImports : 0;
     const coesao = ratio > 0 ? Math.min(ratio, 1 / ratio) : 0;
-    // Complexidade média
     const complexidadeMedia = estatisticas.reduce((sum, string) => sum + (string.complexidade ?? 0), 0) / estatisticas.length;
     return {
         modularidade: Math.max(0, Math.min(1, modularidade)),
@@ -464,7 +436,6 @@ function calcularMetricas(estatisticas) {
 }
 function detectarViolacoes(estatisticas, _padrao) {
     const violacoes = [];
-    // Detectar imports relativos excessivos
     const totalImports = estatisticas.reduce((sum, string) => {
         if (Array.isArray(string.imports)) {
             return sum + string.imports.length;
@@ -483,7 +454,6 @@ function detectarViolacoes(estatisticas, _padrao) {
     if (totalImports > 0 && importsRelativos / totalImports > 0.3) {
         violacoes.push('Uso excessivo de imports relativos (>30%)');
     }
-    // Detectar arquivos com muitas dependências
     for (const stats of estatisticas) {
         const importsContagem = Array.isArray(stats.imports) ? stats.imports.length : typeof stats.imports === 'number' ? stats.imports : 0;
         if (importsContagem > 20) {
@@ -519,7 +489,6 @@ function gerarCaracteristicas(estatisticas) {
     return caracteristicas;
 }
 function detectarDependenciasCirculares(estatisticas) {
-    // Simplificado: detectar se há imports bidirecionais
     const dependencias = new Map();
     for (const stats of estatisticas) {
         const caminho = stats.caminho ?? 'arquivo-desconhecido';
@@ -529,7 +498,6 @@ function detectarDependenciasCirculares(estatisticas) {
         }
         dependencias.set(caminho, deps);
     }
-    // Verificar ciclos simples (A -> B -> A)
     for (const [arquivo, deps] of dependencias) {
         for (const dep of deps) {
             const depsDoDepdep = dependencias.get(dep);
@@ -540,21 +508,12 @@ function detectarDependenciasCirculares(estatisticas) {
     }
     return false;
 }
-/**
- * Detecta padrões de Clean Architecture no projeto
- * - Domínio: entities, value-objects, domain services, repository interfaces
- * - Aplicação: use-cases, ports, DTOs
- * - Infraestrutura: persistence, repositories (impl), HTTP clients
- * - Apresentação: controllers, presenters, middlewares
- */
 function detectarCleanArchitecture(contexto, _estatisticas, _arquivoAtual) {
     const caracteristicas = [];
     const recomendacoes = [];
     let pontuacao = 0;
     const totalChecagens = 10;
-    // Análise dos caminhos dos arquivos no contexto
     const caminhos = contexto.arquivos.map(a => a.relPath.toLowerCase());
-    // 1. Detecta camada de domínio (entities, value-objects)
     const temEntities = caminhos.some(c => c.includes('/domain/') || c.includes('/entities/') || c.endsWith('entity.ts') || c.endsWith('entity.js'));
     const temValueObjects = caminhos.some(c => c.includes('/value-object') || c.includes('value-object'));
     const temRepoInterfaces = caminhos.some(c => c.includes('/domain/') && (c.includes('repository') || c.includes('port')));
@@ -570,7 +529,6 @@ function detectarCleanArchitecture(contexto, _estatisticas, _arquivoAtual) {
         pontuacao++;
         caracteristicas.push('Interfaces de repositório no domínio');
     }
-    // 2. Detecta camada de aplicação (use-cases, ports, DTOs)
     const temUseCases = caminhos.some(c => c.includes('/use-case') || c.includes('/use-cases/') || c.includes('/application/'));
     const temDtos = caminhos.some(c => c.includes('/dto') || c.endsWith('.dto.ts') || c.endsWith('.dto.js'));
     const temPorts = caminhos.some(c => c.includes('/ports') || c.includes('/application/port'));
@@ -586,7 +544,6 @@ function detectarCleanArchitecture(contexto, _estatisticas, _arquivoAtual) {
         pontuacao++;
         caracteristicas.push('Ports de aplicação detectados');
     }
-    // 3. Detecta camada de infraestrutura
     const temInfra = caminhos.some(c => c.includes('/infrastructure/') || c.includes('/infra/'));
     const temReposImpl = caminhos.some(c => c.includes('/infrastructure/repositories') || c.includes('/infra/repositories'));
     if (temInfra) {
@@ -597,30 +554,26 @@ function detectarCleanArchitecture(contexto, _estatisticas, _arquivoAtual) {
         pontuacao++;
         caracteristicas.push('Implementações de repositórios na infra');
     }
-    // 4. Detecta camada de apresentação
     const temPresentation = caminhos.some(c => c.includes('/presentation/') || c.includes('/presenters/'));
     const temControllers = caminhos.some(c => c.includes('/presentation/controllers') || c.includes('/controllers'));
     if (temPresentation || temControllers) {
         pontuacao++;
         caracteristicas.push('Camada de apresentação/controllers detectada');
     }
-    // 5. Detecta inversão de dependência (domain não importa infra)
     const temDependencyInversion = caminhos.some(c => c.includes('/domain/') && (c.includes('repository') || c.includes('port') || c.includes('interface')));
     if (temDependencyInversion) {
         pontuacao++;
         caracteristicas.push('Princípio de Inversão de Dependência identificado');
     }
-    // 6. Verifica padrão de imports (domain não importa camadas externas)
     for (const stats of _estatisticas) {
         if (stats.caminho?.includes('/domain/') && stats.dependenciasInternas) {
             const importsParaInfra = stats.dependenciasInternas.filter(d => d.includes('infrastructure') || d.includes('infra') || d.includes('presentation'));
             if (importsParaInfra.length > 0) {
-                pontuacao -= 2; // penalidade: domínio importando infra
+                pontuacao -= 2;
                 recomendacoes.push('Domínio não deve importar camadas de infraestrutura (violação da Clean Architecture)');
             }
         }
     }
-    // Recomendações
     if (!temEntities && !temValueObjects) {
         recomendacoes.push('Considere criar uma camada de domínio com entidades e value-objects');
     }
@@ -641,22 +594,13 @@ function detectarCleanArchitecture(contexto, _estatisticas, _arquivoAtual) {
         recomendacoes
     };
 }
-/**
- * Detecta padrões de Arquitetura Distribuída / Microsserviços
- * - Boundaries de serviço
- * - Mensageria / Eventos
- * - API Gateway / Service Discovery
- * - Comunicação assíncrona
- */
 function detectarArquiteturaDistribuida(contexto, _estatisticas, _arquivoAtual) {
     const caracteristicas = [];
     const recomendacoes = [];
     let pontuacao = 0;
     const totalChecagens = 10;
-    // Análise dos caminhos e conteúdo
     const caminhos = contexto.arquivos.map(a => a.relPath.toLowerCase());
     const conteudos = contexto.arquivos.map(a => a.content?.toLowerCase() ?? '');
-    // 1. Detecta boundaries/serviços separados
     const temMultiplosServicos = caminhos.some(c => c.includes('/services/') || c.includes('/service-') || c.includes('/microservice'));
     const temServicosSeparados = new Set(caminhos.filter(c => c.includes('/services/'))
         .map(c => c.split('/services/')[1]?.split('/')[0])
@@ -669,7 +613,6 @@ function detectarArquiteturaDistribuida(contexto, _estatisticas, _arquivoAtual)
         pontuacao++;
         caracteristicas.push(`${temServicosSeparados} boundaries de serviço identificados`);
     }
-    // 2. Detecta mensageria / filas
     const temMensageria = caminhos.some(c => c.includes('message-queue') || c.includes('event-bus') || c.includes('rabbitmq') ||
         c.includes('kafka') || c.includes('nats') || c.includes('sqs') || c.includes('pub-sub'));
     const temMensageriaDeps = conteudos.some(c => c.includes('kafkajs') || c.includes('amqplib') || c.includes('ioredis') ||
@@ -678,19 +621,16 @@ function detectarArquiteturaDistribuida(contexto, _estatisticas, _arquivoAtual)
         pontuacao++;
         caracteristicas.push('Sistema de mensageria/eventos detectado');
     }
-    // 3. Detecta API Gateway
     const temGateway = caminhos.some(c => c.includes('/gateway') || c.includes('/api-gateway') || c.includes('gateway.ts') || c.includes('gateway.js'));
     if (temGateway) {
         pontuacao++;
         caracteristicas.push('API Gateway presente');
     }
-    // 4. Detecta Service Discovery
     const temDiscovery = caminhos.some(c => c.includes('/discovery') || c.includes('service-discovery') || c.includes('consul') || c.includes('eureka'));
     if (temDiscovery) {
         pontuacao++;
         caracteristicas.push('Service Discovery detectado');
     }
-    // 5. Detecta Docker/Kubernetes (orquestração)
     const temDocker = caminhos.some(c => c.endsWith('dockerfile') || c.includes('docker-compose'));
     const temK8s = caminhos.some(c => c.includes('kubernetes') || c.includes('k8s') || c.includes('.yaml') || c.includes('.yml'));
     if (temDocker) {
@@ -701,7 +641,6 @@ function detectarArquiteturaDistribuida(contexto, _estatisticas, _arquivoAtual)
         pontuacao++;
         caracteristicas.push('Kubernetes para orquestração');
     }
-    // 6. Detecta comunicação assíncrona (eventos, callbacks)
     const temEventos = caminhos.some(c => c.includes('/events/') || c.includes('/event-handlers') || c.includes('/handlers/'));
     const temAsyncPatterns = conteudos.filter(c => c.includes('eventemitter') || c.includes('observable') || c.includes('pubsub') ||
         c.includes('publish') || c.includes('subscribe') || c.includes('webhook')).length > 2;
@@ -709,17 +648,15 @@ function detectarArquiteturaDistribuida(contexto, _estatisticas, _arquivoAtual)
         pontuacao++;
         caracteristicas.push('Padrões de comunicação assíncrona detectados');
     }
-    // 7. Detecta shared/monitoring (bibliotecas compartilhadas)
     const temShared = caminhos.some(c => c.includes('/shared/'));
     const temMonitoring = caminhos.some(c => c.includes('/monitoring') || c.includes('/health') || c.includes('/metrics'));
     if (temShared) {
         pontuacao += 0;
-    } // neutro
+    }
     if (temMonitoring) {
         pontuacao++;
         caracteristicas.push('Monitoramento/health checks detectados');
     }
-    // Recomendações
     if (!temMensageria && !temMensageriaDeps && temMultiplosServicos) {
         recomendacoes.push('Considere adicionar mensageria (Kafka, RabbitMQ) para comunicação assíncrona entre serviços');
     }

package/dist/analysts/detectors/detector-bugs-ml.js

@@ -3,7 +3,6 @@ import traverse from '@babel/traverse';
 import * as t from '@babel/types';
 import { getMessages } from '../../core/messages/index.js';
 const MAX_MESSAGE_PREVIEW_LENGTH = 60;
-// Statistical bug patterns with ML-like scoring
 const BUG_PATTERNS = [
     {
         id: 'null-pointer-deref',
@@ -34,12 +33,10 @@ const BUG_PATTERNS = [
             while ((match = optionalChainPattern.exec(content)) !== null) {
                 const [, varName, funcName] = match;
                 const beforeContent = content.slice(Math.max(0, match.index - 120), match.index);
-                // pop() é seguro em qualquer array - retorna undefined se vazio, nunca lança
                 if (funcName === 'pop') {
                     continue;
                 }
                 const line = contarLinhasAtePos(content, match.index);
-                // Verificar se a variável é garantidamente um array (const = [] ou const = [...])
                 const varDeclaration = content.slice(Math.max(0, match.index - 200), match.index);
                 if (new RegExp(`(const|let|var)\\s+${varName}\\s*=\\s*\\[`).test(varDeclaration)) {
                     continue;
@@ -98,8 +95,6 @@ const BUG_PATTERNS = [
         category: 'concurrency',
         weight: 0.9,
         detect(content, _relPath) {
-            // Só reporta race conditions quando Promise.all é usado sem catch
-            // (Node.js é single-threaded, await's sequenciais não causam race)
             const asyncPatterns = [
                 /Promise\.all\s*\([^)]+\)\s*\.\s*then\s*\([^)]+\)\s*(?![^]*catch)/g,
             ];
@@ -181,13 +176,6 @@ const BUG_PATTERNS = [
         category: 'logic',
         weight: 0.7,
         detect(content, relPath) {
-            // Contagem ingênua de todos os `()[]{}` globais gera falso positivo em
-            // bases modernas: aninhamento de JSX (divs aninhadas) e parênteses/colchetes
-            // de expressões inflam a profundidade sem aumentar a complexidade de
-            // decisão. Seguindo feedback.md seção 1.5, contamos apenas o aninhamento
-            // de BLOCOS DE LÓGICA (BlockStatement) via AST — JSX, literais de objeto/
-            // array e parênteses de expressão são ignorados. Arquivos não analisáveis
-            // mantêm o fallback conservador por contagem de colchetes.
             const logic = computeLogicNestingDepth(content, relPath);
             let maxDepth = 0;
             let depthLine = 0;
@@ -214,7 +202,6 @@ const BUG_PATTERNS = [
                     }
                 }
             }
-            // Limiar maior: só sinaliza aninhamento de lógica genuinamente profundo.
             if (maxDepth > 7) {
                 return {
                     confidence: Math.min(0.95, 0.5 + maxDepth * 0.06),
@@ -258,9 +245,6 @@ const BUG_PATTERNS = [
         category: 'security',
         weight: 0.83,
         detect(content, _relPath) {
-            // NOTA: == null e != null são propositais não incluídos —
-            // em JS/TS, x == null é o padrão idiomático para checar
-            // null e undefined simultaneamente (recomendado pelo TypeScript).
             const patterns = [
                 /password\s*===?\s*['"`][^'"`]{0,30}['"`]/gi,
                 /token\s*===?\s*['"`][^'"`]{0,30}['"`]/gi,
@@ -282,7 +266,6 @@ const BUG_PATTERNS = [
         },
     },
 ];
-// Feature extraction for statistical analysis
 function extractFeatures(content, _relPath) {
     const lines = content.split('\n');
     const fileLength = lines.length;
@@ -292,10 +275,8 @@ function extractFeatures(content, _relPath) {
     const callbackCount = (content.match(/=>\s*\{/g) ?? []).length;
     const promiseCount = (content.match(/(?:new\s+Promise|async\s+function|\.then\s*\()/g) ?? []).length;
     const tryCatchCount = (content.match(/(?:try\s*\{|\.catch\s*\()/g) ?? []).length;
-    // Excluir nomes de variáveis (ex: anyChanged) da contagem de tipo 'any'
     const anyTypeCount = (content.match(/:\s*any(?![a-zA-Z0-9_$])/g) ?? []).length;
     const unsafeCastCount = (content.match(/as\s+(?:any|unknown)\b/g) ?? []).length;
-    // Excluir TODOs/FIXMEs em JSDoc ou strings literais
     const todoCount = (content.match(/(?:\/\/|#)\s*(TODO|FIXME|HACK|XXX)/g) ?? []).length;
     const commentCount = (content.match(/\/\//g) ?? []).length;
     const commentRatio = totalChars > 0 ? commentCount / totalChars : 0;
@@ -326,9 +307,6 @@ function extractFeatures(content, _relPath) {
         cyclomaticComplexity,
     };
 }
-// Bayesian-inspired bug probability
-// Files under src/analistas/ are the tool's own analysis infrastructure —
-// their complexity is inherent and expected, not a sign of bugs.
 function isSelfAnalysis(relPath) {
     return /^src[/\\]analistas[/\\]/.test(relPath)
         || /^src[/\\]relatorios[/\\]/.test(relPath)
@@ -340,14 +318,12 @@ function isSelfAnalysis(relPath) {
         || /^src[/\\]cli[/\\]/.test(relPath)
         || /^src[/\\]licencas[/\\]/.test(relPath);
 }
-// Files auto-generated or with predominantly declarative/i18n content
 function isLowRiskFile(relPath) {
     return /^src[/\\]core[/\\]messages[/\\]/.test(relPath)
         || /^(?:src[/\\])?vitest\.config/.test(relPath)
         || /\.config\.[jt]s$/.test(relPath)
         || /\.d\.ts$/.test(relPath);
 }
-// Arquivos cuja complexidade é inerente ao domínio (formatters, parsers, etc.)
 function isHighComplexityDomain(relPath) {
     return /[/\\]formatadores[/\\]/.test(relPath)
         || /[/\\]formatters[/\\]/.test(relPath)
@@ -362,14 +338,11 @@ function isHighComplexityDomain(relPath) {
         || /[/\\]scanners?[/\\]/.test(relPath);
 }
 function calcularProbabilidadeBug(features, relPath) {
-    // Skip statistical analysis for the tool's own infrastructure code
     if (isSelfAnalysis(relPath) || isLowRiskFile(relPath)) {
         return { probability: 0, factors: [], gruposAtivos: 0 };
     }
     const factors = [];
     let gruposAtivos = 0;
-    // Group 1: Complexity factors (correlated — pick at most 2)
-    // Para domínios de alta complexidade inerente, limiares mais altos
     const isHighDomain = isHighComplexityDomain(relPath);
     const complexityThreshold = isHighDomain ? 120 : 50;
     const functionThreshold = isHighDomain ? 60 : 30;
@@ -392,7 +365,6 @@ function calcularProbabilidadeBug(features, relPath) {
         factors.push(...complexityFactors.slice(0, 2));
         gruposAtivos++;
     }
-    // Group 2: Type safety issues (correlated — pick the worst)
     if (features.unsafeCastCount > 3) {
         factors.push(mBug.castsInseguros(features.unsafeCastCount));
         gruposAtivos++;
@@ -401,7 +373,6 @@ function calcularProbabilidadeBug(features, relPath) {
         factors.push(mBug.usoExcessivoAny(features.anyTypeCount));
         gruposAtivos++;
     }
-    // Group 3: Unhandled async - só reporta se realmente há promises sem catch/try
     if (features.promiseCount > 0 && features.tryCatchCount === 0 && !isHighDomain) {
         const asyncContentCheck = features.promiseCount > 2;
         if (asyncContentCheck) {
@@ -409,7 +380,6 @@ function calcularProbabilidadeBug(features, relPath) {
             gruposAtivos++;
         }
     }
-    // Group 4: Technical debt
     if (features.todoCount > 5) {
         factors.push(`${getMessages().BugMlMensagens.muitosTODOs} (${features.todoCount})`);
         gruposAtivos++;
@@ -417,8 +387,6 @@ function calcularProbabilidadeBug(features, relPath) {
     if (factors.length === 0) {
         return { probability: 0, factors: [], gruposAtivos: 0 };
     }
-    // Adjusted Naive Bayes: each independent factor contributes log(0.5)
-    // log(0.5) é menos agressivo que log(0.4) — exige mais evidências
     let logProb = 0;
     for (const _ of factors) {
         logProb += Math.log(0.5);
@@ -463,12 +431,6 @@ function contarLinhasAtePos(content, pos) {
     return content.slice(0, pos).split('\n').length;
 }
 const traverseFn = traverse;
-/**
- * Calcula a profundidade de aninhamento de BLOCOS DE LÓGICA (BlockStatement)
- * via AST, ignorando JSX, literais de objeto/array e parênteses de expressões
- * — que a contagem ingênua de colchetes contava indevidamente (feedback.md 1.5).
- * Retorna `null` quando o arquivo não é JS/TS ou não pôde ser parseado.
- */
 function computeLogicNestingDepth(content, relPath) {
     if (!/\.(tsx?|jsx?|mjs|cjs)$/i.test(relPath)) {
         return null;
@@ -540,13 +502,8 @@ export const detectorBugsMl = {
         if (!src) {
             return [];
         }
-        // 1. Statistical analysis
         const features = extractFeatures(src, relPath);
         const { probability: bugProb, factors, gruposAtivos } = calcularProbabilidadeBug(features, relPath);
-        // Threshold refinado para reduzir falsos positivos:
-        // - Probabilidade > 75%
-        // - Pelo menos 2 grupos diferentes de fatores ativos
-        //   (apenas complexidade alta isoladamente não é suficiente)
         if (bugProb > 0.75 && factors.length > 0 && gruposAtivos >= 2) {
             ocorrencias.push({
                 tipo: 'ml-alta-probabilidade-bugs',