@mocoto/mahoraga 0.14.7 → 0.14.9

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

@@ -1,8 +1,4 @@
 import { criarOcorrencia } from '../../types/index.js';
-/**
- * Analista global que analisa o projeto completo e recomenda
- * a melhor arquitetura (Clean Architecture, Microsserviços, MVC, etc.)
- */
 const CONFIANCA_SIMPLES = 60;
 function adicionarOcorrenciasRecomendacao(ocorrencias, _relPath, sinaisCleanArch, sinaisDistributed, recomendacoes, arquiteturaRecomendada, confianca) {
     ocorrencias.push(criarOcorrencia({
@@ -53,10 +49,8 @@ export const analistaRecomendacaoArquitetura = {
         const ocorrencias = [];
         const caminhos = contexto.arquivos.map(a => a.relPath.toLowerCase());
         const conteudos = contexto.arquivos.map(a => a.content?.toLowerCase() ?? '');
-        // === SINAIS PARA CLEAN ARCHITECTURE ===
         let scoreCleanArch = 0;
         const sinaisCleanArch = [];
-        // Domain layer
         const temEntities = caminhos.some(c => 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 temDomainServices = caminhos.some(c => c.includes('/domain/') && c.includes('service'));
@@ -77,7 +71,6 @@ export const analistaRecomendacaoArquitetura = {
             scoreCleanArch += 10;
             sinaisCleanArch.push('Eventos de domínio');
         }
-        // Application layer
         const temUseCases = caminhos.some(c => c.includes('/use-cases') || c.includes('/usecases') || c.includes('/application/'));
         const temPorts = caminhos.some(c => c.includes('/ports/') || c.includes('/application/port'));
         const temDtos = caminhos.some(c => c.includes('/dto/') || c.endsWith('.dto.ts') || c.endsWith('.dto.js'));
@@ -93,7 +86,6 @@ export const analistaRecomendacaoArquitetura = {
             scoreCleanArch += 10;
             sinaisCleanArch.push('DTOs');
         }
-        // Infrastructure layer
         const temInfra = caminhos.some(c => c.includes('/infrastructure/') || c.includes('/infra/'));
         const temRepositories = caminhos.some(c => c.includes('/repositories/') || c.endsWith('.repository.ts'));
         const temGateways = caminhos.some(c => c.includes('/gateways/'));
@@ -109,7 +101,6 @@ export const analistaRecomendacaoArquitetura = {
             scoreCleanArch += 5;
             sinaisCleanArch.push('Gateways');
         }
-        // Presentation layer
         const temControllers = caminhos.some(c => c.includes('/controllers/') || c.endsWith('.controller.ts'));
         const temPresenters = caminhos.some(c => c.includes('/presenters/') || c.endsWith('.presenter.ts'));
         if (temControllers) {
@@ -120,16 +111,13 @@ export const analistaRecomendacaoArquitetura = {
             scoreCleanArch += 5;
             sinaisCleanArch.push('Presenters');
         }
-        // DI Container
         const temDI = conteudos.some(c => c.includes('tsyringe') || c.includes('inversify') || c.includes('awilix') || c.includes('typedi'));
         if (temDI) {
             scoreCleanArch += 5;
             sinaisCleanArch.push('Container DI');
         }
-        // === SINAIS PARA ARQUITETURA DISTRIBUÍDA ===
         let scoreDistributed = 0;
         const sinaisDistributed = [];
-        // Múltiplos serviços
         const servicosSet = new Set();
         for (const c of caminhos) {
             const match = c.match(/services\/([^/]+)/);
@@ -145,7 +133,6 @@ export const analistaRecomendacaoArquitetura = {
             scoreDistributed += 10;
             sinaisDistributed.push('1 boundary de serviço');
         }
-        // Mensageria
         const temMensageria = caminhos.some(c => c.includes('/events/') || c.includes('/messaging') || c.includes('/queues') ||
             c.includes('/consumers') || c.includes('/producers'));
         const temMensageriaDeps = conteudos.some(c => c.includes('kafkajs') || c.includes('amqplib') || c.includes('ioredis') ||
@@ -154,50 +141,42 @@ export const analistaRecomendacaoArquitetura = {
             scoreDistributed += 15;
             sinaisDistributed.push('Mensageria');
         }
-        // API Gateway
         const temGateway = caminhos.some(c => c.includes('/gateway') || c.includes('/api-gateway'));
         if (temGateway) {
             scoreDistributed += 15;
             sinaisDistributed.push('API Gateway');
         }
-        // Service Discovery
         const temDiscovery = caminhos.some(c => c.includes('/discovery') || c.includes('consul') || c.includes('eureka'));
         if (temDiscovery) {
             scoreDistributed += 10;
             sinaisDistributed.push('Service Discovery');
         }
-        // Docker/Container
         const temDocker = caminhos.some(c => c.endsWith('dockerfile') || c.includes('docker-compose'));
         if (temDocker) {
             scoreDistributed += 10;
             sinaisDistributed.push('Docker');
         }
-        // K8s
         const temK8s = caminhos.some(c => c.includes('kubernetes') || c.includes('k8s/'));
         if (temK8s) {
             scoreDistributed += 10;
             sinaisDistributed.push('Kubernetes');
         }
-        // Event-driven patterns
         const temEventDriven = conteudos.filter(c => c.includes('eventemitter') || c.includes('publish') || c.includes('subscribe') ||
             c.includes('webhook') || c.includes('observable')).length > 3;
         if (temEventDriven) {
             scoreDistributed += 10;
             sinaisDistributed.push('Padrões event-driven');
         }
-        // Monitoring
         const temMonitoring = caminhos.some(c => c.includes('/health') || c.includes('/monitoring') || c.includes('/metrics'));
         if (temMonitoring) {
             scoreDistributed += 10;
             sinaisDistributed.push('Monitoramento');
         }
-        // Shared lib
         const temShared = caminhos.some(c => c.includes('/shared/') || c.includes('/common/'));
         if (temShared) {
             scoreDistributed += 5;
             sinaisDistributed.push('Biblioteca compartilhada');
         }
-        // === DECISÃO DA ARQUITETURA ===
         const totalArquivos = contexto.arquivos.length;
         const complexidadeBaixa = totalArquivos < 30;
         const temFrontend = caminhos.some(c => c.includes('/pages/') || c.includes('/components/') || c.includes('/views/'));
@@ -205,7 +184,6 @@ export const analistaRecomendacaoArquitetura = {
         let melhorScore = 0;
         let confianca = 0;
         const recomendacoes = [];
-        // Clean Architecture é recomendada para projetos com regras de negócio complexas
         if (scoreCleanArch >= 40 || (temEntities && temUseCases)) {
             if (scoreCleanArch > melhorScore) {
                 arquiteturaRecomendada = 'Clean Architecture (Arquitetura Limpa)';
@@ -225,7 +203,6 @@ export const analistaRecomendacaoArquitetura = {
                 recomendacoes.push('Implemente o padrão Repository para abstrair persistência');
             }
         }
-        // Arquitetura Distribuída é recomendada para projetos com múltiplos serviços
         if (scoreDistributed >= 35 && servicosSet.size >= 1) {
             if (scoreDistributed > melhorScore) {
                 arquiteturaRecomendada = 'Arquitetura Distribuída / Microsserviços';
@@ -245,7 +222,6 @@ export const analistaRecomendacaoArquitetura = {
                 recomendacoes.push('Adicione health checks e monitoramento centralizado');
             }
         }
-        // MVC para projetos web tradicionais
         if (temFrontend && temControllers && !temEntities) {
             const scoreMvc = 30;
             if (scoreMvc > melhorScore && !complexidadeBaixa) {
@@ -254,7 +230,6 @@ export const analistaRecomendacaoArquitetura = {
                 confianca = Math.min(80, scoreMvc + 30);
             }
         }
-        // Se ainda não há recomendação clara, sugerir a mais adequada
         if (melhorScore === 0) {
             if (complexidadeBaixa) {
                 arquiteturaRecomendada = 'Arquitetura Simples / Monolítica';
@@ -273,7 +248,6 @@ export const analistaRecomendacaoArquitetura = {
                 recomendacoes.push('Organize o código em camadas (controllers, services, repositories)');
             }
         }
-        // Adicionar recomendações gerais
         if (scoreCleanArch >= 20 && scoreDistributed >= 20) {
             recomendacoes.push('Projeto apresenta características híbridas - considere Clean Architecture com boundaries de microsserviços');
         }

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

@@ -21,20 +21,15 @@ export const analistaSeguranca = {
         });
         const problemas = [];
         try {
-            // Detectar problemas por padrões de texto (mais confiável que AST para alguns casos)
             detectarPadroesPerigosos(src, relPath, problemas);
-            // Detectar problemas via AST quando disponível
             if (ast) {
                 detectarProblemasAST(ast, problemas);
             }
-            // Converter para ocorrências
             const ocorrencias = [];
-            // Agrupar por severidade
             const porSeveridade = agruparPor(problemas, caminho => caminho.severidade);
             for (const [severidade, items] of Object.entries(porSeveridade)) {
                 if (items.length > 0) {
                     const nivel = mapearSeveridadeParaNivel(severidade);
-                    // Ajustar severidade baseado no contexto
                     const nivelAjustado = contextoArquivo.isTest && nivel === 'aviso' ? 'info' : nivel;
                     const resumo = items.slice(0, 3).map(caminho => caminho.tipo).join(', ');
                     ocorrencias.push(criarOcorrencia({
@@ -46,7 +41,6 @@ export const analistaSeguranca = {
                     }));
                 }
             }
-            // Aplicar supressões inline antes de retornar
             return filtrarOcorrenciasSuprimidas(ocorrencias, 'seguranca', src);
         }
         catch (erro) {
@@ -61,7 +55,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
         if (!headerValue) {
             return false;
         }
-        // Header names geralmente são curtos/médios e usam letras/números/hífens.
         if (headerValue.length < 4 || headerValue.length > 80) {
             return false;
         }
@@ -71,7 +64,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
         if (headerValue.startsWith('-') || headerValue.endsWith('-')) {
             return false;
         }
-        // Heurística: costuma ter hífen (ex.: Content-Type) e, muitas vezes, prefixo X-
         if (!/-/.test(headerValue) && !/^X[A-Za-z]?/.test(headerValue)) {
             return false;
         }
@@ -85,10 +77,8 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
         const hasValorProp = /\bvalue\b\s*[:=]/i.test(ctx);
         return hasHeaders && hasValorProp;
     }
-    // Detecção de segredos hardcoded via helper compartilhado
     const segredos = detectarSegredosHardcoded(src, relPath);
     segredos.forEach(string => {
-        // Redução de falsos positivos específica para detector-seguranca: headers HTTP
         if (string.campo === 'key' && isLikelyHttpHeaderName(string.valor) && isHttpHeadersKeyValueContext(string.linha - 1)) {
             return;
         }
@@ -102,10 +92,8 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
     });
     linhas.forEach((linha, index) => {
         const numeroLinha = index + 1;
-        // Ignorar comentários, strings e regex patterns para reduzir falsos positivos
         const linhaSemComentarios = linha.replace(/\/\/.*$/gm, '').replace(/\/\*.*?\*\//gs, '');
         const linhaSemStrings = linhaSemComentarios.replace(/'[^']*'/g, '').replace(/"[^"]*"/g, '').replace(/`[^`]*`/g, '').replace(/\/(?:[^\/\\]|\\.)*\//g, '');
-        // eval() usage - apenas em código real, não em comentários/strings/regex
         if (/\beval\s*\(/.test(linhaSemStrings)) {
             problemas.push({
                 tipo: 'eval-usage',
@@ -115,7 +103,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Use JSON.parse() ou funções específicas ao invés de eval()'
             });
         }
-        // dangerouslySetInnerHTML - React security risk
         if (/dangerouslySetInnerHTML\s*[:=]/.test(linhaSemStrings)) {
             problemas.push({
                 tipo: 'dangerously-set-inner-html',
@@ -125,7 +112,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Use sanitize-html ou DOMPurify para limpar o conteúdo antes de renderizar'
             });
         }
-        // innerHTML com variáveis
         if (/\.(innerHTML|outerHTML)\s*=\s*[^"']/.test(linha)) {
             problemas.push({
                 tipo: 'dangerous-html',
@@ -135,7 +121,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Use textContent ou sanitize o HTML antes de inserir'
             });
         }
-        // document.write usage
         if (/\bdocument\.write(ln)?\s*\(/.test(linhaSemStrings)) {
             problemas.push({
                 tipo: 'xss-vulnerability',
@@ -145,9 +130,7 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Use manipulação de DOM segura (createElement, appendChild, etc.)'
             });
         }
-        // SQL Injection patterns
         if (/\.(query|execute|raw|queryRaw|executeRaw)\s*\(/.test(linha) && (/req\.|params\.|query\.|body\./.test(linha) || /\$\{.*\}/.test(linha) || /\s\+\s/.test(linha))) {
-            // Ignorar se parecer que está usando parâmetros (ex: ?, $1, :name)
             const temParametros = /['"`].*(\?|\$\d|:\w+).*['"`]/.test(linha);
             if (!temParametros) {
                 problemas.push({
@@ -159,7 +142,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 });
             }
         }
-        // Command Injection
         if (/\b(exec|execSync|spawn|spawnSync)\s*\(/.test(linha) && /req\.|params\.|query\.|body\./.test(linha)) {
             problemas.push({
                 tipo: 'command-injection',
@@ -169,7 +151,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Evite executar comandos shell com input do usuário; use APIs específicas ou valide rigorosamente'
             });
         }
-        // Insecure cookie settings
         if (/\.cookie\s*\(/.test(linha) && !/req\.cookie|request\.cookie/.test(linha) && !/httpOnly\s*:\s*true/.test(linha)) {
             problemas.push({
                 tipo: 'insecure-cookie',
@@ -179,7 +160,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Sempre use httpOnly: true para evitar acesso via JavaScript (XSS). Se estiver usando configuração multi-line, o detector AST cuidará da validação.'
             });
         }
-        // Redirecionamentos inseguros
         if (/\.(assign|replace|href)\s*=\s*.*(req\.|params\.|query\.|body\.)/.test(linha)) {
             problemas.push({
                 tipo: 'xss-vulnerability',
@@ -189,7 +169,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Valide a URL de destino contra uma whitelist antes de redirecionar'
             });
         }
-        // Math.random() para criptografia
         if (/Math\.random\(\)/.test(linha) && /crypto|password|token|secret/i.test(linha)) {
             problemas.push({
                 tipo: 'weak-crypto',
@@ -199,7 +178,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Use crypto.randomBytes() ou crypto.getRandomValues()'
             });
         }
-        // Exposure of sensitive environment variables
         if (/\b(console\.log|console\.debug|console\.info|res\.send|res\.json|res\.write|reply\.send)\s*\(.*(process\.env\.(PASSWORD|SECRET|TOKEN|KEY|API|PWD|AUTH|CREDENTIALS|DB|PASS|STRIPE|AWS|PRIVATE))/i.test(linha)) {
             problemas.push({
                 tipo: 'sensitive-env-exposure',
@@ -209,10 +187,8 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Nunca exponha variáveis de ambiente que contenham segredos em logs ou respostas'
             });
         }
-        // Algoritmos de hash fracos
         if (/createHash\s*\(\s*['"`](md5|md4|sha1)['"`]\s*\)/.test(linha)) {
             const algoritmo = /createHash\s*\(\s*['"`](md5|md4|sha1)['"`]\s*\)/.exec(linha)?.[1];
-            // Verificar se há comentário justificando o uso (ex: fingerprinting, não-criptográfico)
             const linhaAnterior = index > 0 ? linhas[index - 1] : '';
             const linha2Atras = index > 1 ? linhas[index - 2] : '';
             const comentarioContexto = linhaAnterior + linha2Atras;
@@ -227,7 +203,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 });
             }
         }
-        // RegExp com input do usuário
         if (/new RegExp\s*\([^)]*\)/.test(linha) && /req\.|params\.|query\.|body\./.test(linha)) {
             problemas.push({
                 tipo: 'unsafe-regex',
@@ -237,13 +212,9 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Valide e escape o input antes de usar em RegExp'
             });
         }
-        // Dangerous literal regex (heuristic for ReDoS)
         const regexLiteralMatch = linha.match(/\/([^\/\\]|\\.)+\/[gimuy]*/);
         if (regexLiteralMatch) {
             const pattern = regexLiteralMatch[0];
-            // Heurística para quantificadores aninhados ou repetitivos que causam backtracking catastrófico
-            // Foca em padrões como (a+)+, (.*)*, (.+)+ e .*.* ou .+ .+
-            // Ignora padrões seguros como [\s\S]*? (usados em parsers)
             const isParserLoop = /[\s\S]*?\//.test(pattern) || /[\s\S]*?/.test(pattern);
             if (!isParserLoop && (/(\([^)]+\+?\)\+|\([^)]+\+?\)\*|(\.\*){2,}|(\.\+){2,}|([a-zA-Z0-9])\+\+)/.test(pattern) || /\[[^\]]+\]\+\+/.test(pattern))) {
                 problemas.push({
@@ -255,7 +226,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 });
             }
         }
-        // __proto__ manipulation - evitar falsos positivos em strings/comentários
         if (/__proto__/.test(linhaSemStrings)) {
             problemas.push({
                 tipo: 'prototype-pollution',
@@ -265,7 +235,6 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
                 sugestao: 'Use Object.create(null) ou Object.setPrototypeOf() com cuidado'
             });
         }
-        // Path traversal patterns
         if (/\.\.\//g.test(linha) && /req\.|params\.|query\./.test(linha)) {
             problemas.push({
                 tipo: 'path-traversal',
@@ -276,39 +245,26 @@ function detectarPadroesPerigosos(src, relPath, problemas) {
             });
         }
     });
-    // Detectar async/await sem try-catch (melhoria exclusiva)
     detectarAsyncSemTryCatch(src, problemas);
 }
-/**
- * Detecta uso de async/await sem tratamento adequado de erro
- */
 function detectarAsyncSemTryCatch(src, problemas) {
     const lines = splitLines(src);
-    // Contexto global do arquivo para detectar padrões do Next.js
     const isNextJsServerComponent = /^['"](use server|use client)['"]/.test(src.trim()) || /export\s+(default\s+)?async\s+function/.test(src);
     const hasDynamicImport = /next\/dynamic|import\s*\(/.test(src);
     for (let indice = 0; indice < lines.length; indice++) {
         const line = lines[indice];
         const trimmedLine = line.trim();
-        // Detectar await sem try-catch
         if (/\bawait\s+/.test(line) && !trimmedLine.startsWith('//')) {
-            // Verificar contexto expandido para detectar event handlers
             const contextLines = lines.slice(Math.max(0, indice - 10), indice);
             const context = contextLines.join(' ');
-            // Detectar se está dentro de event handler (fire-and-forget por design)
             const isEventHandler = /\.on\s*\(/.test(context) || /\.once\s*\(/.test(context) || /addEventListener\s*\(/.test(context) || /collector\.on\s*\(/.test(context) || /emitter\.on\s*\(/.test(context) || /process\.on\s*\(/.test(context);
-            // Verificar se é dynamic import do Next.js (tratamento gerenciado pelo framework)
             const isDynamicImport = hasDynamicImport && (/import\s*\(/.test(line) || /dynamic\s*\(/.test(context));
-            // Server Components do Next.js: tratamento gerenciado pelo framework
             if (isNextJsServerComponent || isDynamicImport) {
                 continue;
             }
-            // Verificar se há try-catch em escopo expandido (100 linhas antes/depois)
             const extendedContext = lines.slice(Math.max(0, indice - 100), Math.min(lines.length, indice + 100));
             const fullContext = extendedContext.join('\n');
-            // Detectar try-catch em escopo pai (bloco que envolve o await)
             const hasErroHandling = /try\s*\{[\s\S]*?\}\s*catch/.test(fullContext) || /\.catch\s*\(/.test(line) || /\.catch\s*\(/.test(lines[indice + 1] || '') ||
-                // Promise encadeada com .then().catch()
                 /\.then\s*\([^)]*\)\s*\.catch/.test(fullContext);
             if (!hasErroHandling) {
                 problemas.push({
@@ -366,7 +322,6 @@ function detectarSQLInjectionAST(callee, args, path, problemas) {
 function detectarProblemasAST(ast, problemas) {
     try {
         traverse(ast.node, {
-            // Detectar Function constructor
             NewExpression(path) {
                 if (path.node.callee.type === 'Identifier' && path.node.callee.name === 'Function') {
                     problemas.push({
@@ -378,11 +333,9 @@ function detectarProblemasAST(ast, problemas) {
                     });
                 }
             },
-            // Detectar chamadas perigosas
             CallExpression(path) {
                 const callee = path.node.callee;
                 const args = path.node.arguments;
-                // 1. setTimeout/setInterval com strings
                 if (callee.type === 'Identifier' && ['setTimeout', 'setInterval'].includes(callee.name) && args[0]?.type === 'StringLiteral') {
                     problemas.push({
                         tipo: 'eval-usage',
@@ -398,7 +351,6 @@ function detectarProblemasAST(ast, problemas) {
         });
     }
     catch {
-        // Ignorar erros de traverse para não quebrar a análise
     }
 }
 function mapearSeveridadeParaNivel(severidade) {

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

@@ -30,10 +30,6 @@ function verificarConvencoesNomesDiretorios(ocorrencias, caminhosNorm) {
         }
     }
 }
-/**
- * Analisa a estrutura do projeto e detecta padrões como monorepo, fullstack, mistura de src/packages, etc.
- * Retorna ocorrências para cada sinal relevante encontrado.
- */
 export const detectorEstrutura = {
     nome: 'detector-estrutura',
     global: true,
@@ -45,11 +41,8 @@ export const detectorEstrutura = {
             return [];
         }
         const caminhos = contexto.arquivos.map(arquivo => arquivo.relPath);
-        // Normaliza separadores para evitar falsos negativos em Windows (\\ vs /)
         const caminhosNorm = caminhos.map(caminho => caminho ? caminho.replace(/\\/g, '/') : '');
-        // Conjuntos para buscas O(1) e deduplicação implícita
         const setCaminhos = new Set(caminhos);
-        // Detecta contexto geral do projeto para análise inteligente
         const arquivoPrincipal = caminhos?.find(caminho => /package\.json$/.test(caminho)) ?? caminhos[0];
         const conteudoPrincipal = contexto.arquivos?.find(arquivo => arquivo.relPath === arquivoPrincipal)?.content ?? '';
         const contextoProjeto = detectarContextoProjeto({
@@ -57,11 +50,9 @@ export const detectorEstrutura = {
             conteudo: conteudoPrincipal,
             relPath: arquivoPrincipal
         });
-        // Se é um projeto pequeno ou de teste, reduz a agressividade das verificações
         const isProjetoPequeno = caminhos.length < 20;
         const isProjetoTeste = contextoProjeto.isTest || caminhos.every(caminho => /(test|spec|mock)/i.test(caminho));
         const sinais = {
-            // Next.js: considerar tanto pages/ quanto app/
             temPages: caminhosNorm.some(caminho => caminho.includes('pages/') || caminho.includes('app/')),
             temApi: caminhosNorm.some(caminho => caminho.includes('api/')),
             temControllers: caminhosNorm.some(caminho => caminho.includes('controllers/')),
@@ -76,7 +67,6 @@ export const detectorEstrutura = {
         const ehMonorepo = !!sinais.temPackages;
         Object.assign(sinaisDetectados, sinais);
         const ocorrencias = [];
-        // Estrutura monorepo
         if (ehMonorepo) {
             ocorrencias.push({
                 tipo: 'estrutura-monorepo',
@@ -86,7 +76,6 @@ export const detectorEstrutura = {
                 relPath: '[raiz do projeto]',
                 linha: 0
             });
-            // Monorepo sem packages
             if (!caminhos.some(caminho => caminho.includes('packages/'))) {
                 ocorrencias.push({
                     tipo: 'estrutura-monorepo-incompleto',
@@ -98,7 +87,6 @@ export const detectorEstrutura = {
                 });
             }
         }
-        // Estrutura fullstack
         if (ehFullstack) {
             ocorrencias.push({
                 tipo: 'estrutura-fullstack',
@@ -110,45 +98,37 @@ export const detectorEstrutura = {
             });
         }
         else if (sinais.temPages && !sinais.temApi && !isProjetoPequeno) {
-            // Só reporta para projetos maiores que realmente deveriam ter API
             ocorrencias.push({
                 tipo: 'estrutura-incompleta',
                 nivel: 'info',
-                // Reduzido de 'aviso' para 'info'
                 mensagem: messages.DetectorEstruturaMensagens.pagesSemApi,
                 origem: 'detector-estrutura',
                 relPath: '[raiz do projeto]',
                 linha: 0
             });
         }
-        // Mistura de padrões: src/ e packages/ juntos - só reporta se não for projeto experimental
         if (sinais.temSrc && sinais.temPackages && !contextoProjeto.isTest) {
             ocorrencias.push({
                 tipo: 'estrutura-mista',
                 nivel: 'info',
-                // Reduzido de 'aviso' para 'info'
                 mensagem: messages.DetectorEstruturaMensagens.estruturaMista,
                 origem: 'detector-estrutura',
                 relPath: '[raiz do projeto]',
                 linha: 0
             });
         }
-        // Muitos arquivos na raiz (considera apenas nível imediato sem subpastas)
         const arquivosRaiz = caminhosNorm.filter(caminho => !caminho.includes('/') && caminho.trim() !== '');
-        const LIMITE_RAIZ = (config.ESTRUTURA_ARQUIVOS_RAIZ_MAX || 15); // Aumentado de 10 para 15
-        // Só reporta se não for projeto pequeno ou de teste
+        const LIMITE_RAIZ = (config.ESTRUTURA_ARQUIVOS_RAIZ_MAX || 15);
         if (arquivosRaiz.length > LIMITE_RAIZ && !isProjetoPequeno && !isProjetoTeste) {
             ocorrencias.push({
                 tipo: 'estrutura-suspeita',
                 nivel: 'info',
-                // Reduzido de 'aviso' para 'info'
                 mensagem: messages.DetectorEstruturaMensagens.muitosArquivosRaiz,
                 origem: 'detector-estrutura',
                 relPath: '[raiz do projeto]',
                 linha: 0
             });
         }
-        // Sinais de backend
         if (sinais.temControllers || sinais.temPrisma || sinais.temApi) {
             ocorrencias.push({
                 tipo: 'estrutura-backend',
@@ -159,7 +139,6 @@ export const detectorEstrutura = {
                 linha: 0
             });
         }
-        // Sinais de frontend
         if (sinais.temComponents || sinais.temPages) {
             ocorrencias.push({
                 tipo: 'estrutura-frontend',
@@ -170,7 +149,6 @@ export const detectorEstrutura = {
                 linha: 0
             });
         }
-        // Arquivos de configuração conhecidos - agrupa em uma única ocorrência para reduzir ruído
         const arquivosConfiguracao = ['package.json', 'tsconfig.json', 'turbo.json', 'pnpm-workspace.yaml'];
         const detectados = arquivosConfiguracao.filter(cfg => setCaminhos.has(cfg));
         if (detectados.length > 0) {
@@ -183,15 +161,12 @@ export const detectorEstrutura = {
                 linha: 1
             });
         }
-        // Múltiplos entrypoints
-        // Lista de entrypoints potencialmente grande em repositórios com dependências; filtra ignorados
         const entrypointsAll = caminhosNorm.filter(caminho => /(^|[\\/])(cli|index|main)\.(ts|js)$/.test(caminho));
         const ignoredDyn = config.INCLUDE_EXCLUDE_RULES.globalExcludeGlob;
         const entrypoints = entrypointsAll.filter(caminho => !micromatch.isMatch(caminho, ignoredDyn)).sort();
         if (entrypoints.length > 1) {
             const MAX_LIST = 20;
             if (entrypoints.length > MAX_LIST) {
-                // Muitos entrypoints: agrega por diretório para reduzir ruído sem perder o sinal
                 const dirCounts = new Map();
                 for (const caminho of entrypoints) {
                     const dir = caminho.includes('/') ? caminho.slice(0, caminho.lastIndexOf('/')) : '.';
@@ -218,7 +193,6 @@ export const detectorEstrutura = {
                 });
             }
             else {
-                // Quantidade moderada: lista direta mantendo ordenação estável
                 const preview = entrypoints.slice(0, MAX_LIST);
                 const resto = entrypoints.length - preview.length;
                 ocorrencias.push({
@@ -231,15 +205,11 @@ export const detectorEstrutura = {
                 });
             }
         }
-        // Ausência de src/ em projetos grandes (verifica realmente se diretório src existe fisicamente)
-        // Só reporta para projetos que realmente deveriam ter src/ baseado no contexto
         const deveriaTerSrc = !contextoProjeto.isTest && !contextoProjeto.isConfiguracao && (contextoProjeto.isLibrary || contextoProjeto.frameworks.length > 0);
         if (!sinais.temSrc && caminhosNorm.length > 50 && deveriaTerSrc) {
-            // Aumentado de 30 para 50
             ocorrencias.push({
                 tipo: 'estrutura-sem-src',
                 nivel: 'info',
-                // Reduzido de 'aviso' para 'info'
                 mensagem: messages.DetectorEstruturaMensagens.projetoGrandeSemSrc,
                 origem: 'detector-estrutura',
                 relPath: '[raiz do projeto]',

package/dist/analysts/detectors/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Detectores core do projeto (genéricos, não ligados a tech específica)
- */
 export * from './detector-architecture.js';
 export * from './detector-bugs-ml.js';
 export * from './detector-code-fragile.js';

package/dist/analysts/github-actions/analysts/analyst-github-actions-security-hardening.js

@@ -1,8 +1,5 @@
 import { YAMLMap } from 'yaml';
 import { registrarDetectorGithubActions } from './analyst-github-actions.js';
-/**
- * Plugin de exemplo para demonstrar o sistema de extensibilidade v0.5.0
- */
 registrarDetectorGithubActions({
     nome: 'security-hardening',
     descricao: 'Regras adicionais de segurança para workflows',
@@ -14,7 +11,6 @@ registrarDetectorGithubActions({
             return problemas;
         }
         for (const [jobId, job] of Object.entries(wf.jobs)) {
-            // Regra: Todo job deve ter permissões explícitas
             if (!job.permissions && !wf.permissions) {
                 problemas.push({
                     tipo: 'security-hardening',