@mocoto/mahoraga 0.14.7 → 0.14.9

package/dist/analysts/js-ts/detectors/detector-constructions-syntactic.js

@@ -37,7 +37,6 @@ export const analistaConstrucoesSintaticas = {
                             });
                         }
                     }
-                    // Destructuring without defaults
                     for (const declarator of path.node.declarations) {
                         if (textoTitulo.isObjectPattern(declarator.id)) {
                             for (const prop of declarator.id.properties) {
@@ -143,7 +142,6 @@ export const analistaConstrucoesSintaticas = {
                     });
                 },
                 LogicalExpression(path) {
-                    // Nullish coalescing vs OR misuse: detecting if (x || defaultValue) where x could be '' or 0
                     if (path.node.operator === '||') {
                         const left = path.node.left;
                         if (textoTitulo.isMemberExpression(left) || textoTitulo.isIdentifier(left)) {
@@ -154,12 +152,7 @@ export const analistaConstrucoesSintaticas = {
                         }
                     }
                 },
-                // ES2025: Promise.withResolvers
-                // ES2025: RegExp.escape
-                // ES2026: Error.isError
-                // ES2026: Array.fromAsync
                 OptionalMemberExpression(path) {
-                    // Optional chaining where not needed: obj?.prop where obj is always defined
                     if ('optional' in path.node && path.node.optional) {
                         const obj = path.node.object;
                         if (textoTitulo.isIdentifier(obj)) {
@@ -174,7 +167,6 @@ export const analistaConstrucoesSintaticas = {
                     }
                 },
                 SpreadElement(path) {
-                    // Unnecessary object spread: {...obj, prop: val} could be obj.prop = val
                     const parent = path.parentPath;
                     if (textoTitulo.isObjectExpression(parent.node)) {
                         const arg = path.node.argument;
@@ -188,7 +180,6 @@ export const analistaConstrucoesSintaticas = {
                     }
                 },
                 ClassMethod(path) {
-                    // Getter/setter without validation
                     if (path.node.kind === 'set') {
                         const body = path.node.body;
                         if (textoTitulo.isBlockStatement(body)) {
@@ -206,7 +197,6 @@ export const analistaConstrucoesSintaticas = {
                     }
                 }
             });
-            // Text-based detection for ES2025/ES2026 patterns
             const esPatterns = [
                 [/\busing\s+\w+\s*=\s*new\s+/g, 'explicit-resource-management', (linha) => { pushExtra('explicit-resource-management', 'info', 'Explicit Resource Management with "using" (ES2026)', linha); }],
                 [/\bawait\s+using\s+/g, 'explicit-resource-management-async', (linha) => { pushExtra('explicit-resource-management-async', 'info', 'Async Resource Management with "await using" (ES2026)', linha); }],
@@ -228,7 +218,6 @@ export const analistaConstrucoesSintaticas = {
                     }
                 }
             }
-            // Template literal overuse detection via text fallback
             const templateLiteralPadrao = /`([^`]{0,10})`/g;
             let match;
             while ((match = templateLiteralPadrao.exec(src)) !== null) {
@@ -273,11 +262,9 @@ function extrairContexto(path) {
     return 'other';
 }
 function isInStringOrComment(src, position) {
-    // Check if position is inside a string or comment
     const before = src.substring(0, position);
     const lines = before.split('\n');
     const lastLine = lines[lines.length - 1];
-    // Check single-line comments
     if (lastLine.includes('//')) {
         const commentIdx = lastLine.indexOf('//');
         const quoteIdx = Math.max(lastLine.lastIndexOf("'"), lastLine.lastIndexOf('"'), lastLine.lastIndexOf('`'));
@@ -285,13 +272,11 @@ function isInStringOrComment(src, position) {
             return true;
         }
     }
-    // Check multi-line comments
     const openComment = before.lastIndexOf('/*');
     const closeComment = before.lastIndexOf('*/');
     if (openComment > closeComment) {
         return true;
     }
-    // Simple string check (not comprehensive but good enough)
     const singleQuotes = (before.match(/'/g) ?? []).length;
     const doubleQuotes = (before.match(/"/g) ?? []).length;
     const backticks = (before.match(/`/g) ?? []).length;

package/dist/analysts/js-ts/detectors/detector-context-smart.js

@@ -1,21 +1,6 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Sistema Inteligente de Detecção de Arquétipos por Contexto
- *
- * Combina múltiplas evidências para inferir corretamente o tipo de projeto:
- * - Análise de dependências (package.json)
- * - Padrões de código (imports, exports, funcionalidades)
- * - Estrutura de arquivos e nomenclatura
- * - Configurações específicas de tecnologia
- * - Contexto de execução e entry points
- */
 import { config, traverse } from '../../../core/config/index.js';
 import { getMessages } from '../../../core/messages/index.js';
 const { DetectorContextoExtraMensagens } = getMessages();
-/**
- * Padrões específicos de detecção por tecnologia
- */
 const PADROES_TECNOLOGIA = {
     'discord-bot': {
         dependencias: ['discord.js', '@discordjs/builders', '@discordjs/rest'],
@@ -25,14 +10,10 @@ const PADROES_TECNOLOGIA = {
         configs: ['bot.js', 'bot.ts', 'config/bot'],
         scripts: ['start:bot', 'dev:bot'],
         codigoPatterns: [/Client\(\s*\{[\s\S]*intents/i, /\.login\s*\(\s*process\.env/i, /interaction\.reply/i, /message\.reply/i],
-        // Sinais que indicam que NÃO é um bot Discord (é uma CLI)
         antiPatterns: [/new\s+Command\(/i,
-            // Commander.js
             /program\.parse/i,
-            // CLI parsing
             /\.option\s*\(/i,
-            // CLI options
-            /bin\/index\.(js|ts)/i // Binary entry point
+            /bin\/index\.(js|ts)/i
         ]
     },
     'telegram-bot': {
@@ -43,7 +24,6 @@ const PADROES_TECNOLOGIA = {
         configs: ['bot.js', 'bot.ts'],
         scripts: ['start:bot'],
         codigoPatterns: [/new\s+Telegraf/i, /bot\.command/i, /ctx\.reply/i, /\.telegram\.sendMessage/i],
-        // Sinais que indicam que NÃO é um bot Telegram
         antiPatterns: [/new\s+Command\(/i, /program\.parse/i, /\.option\s*\(/i, /bin\/index\.(js|ts)/i]
     },
     'express-api': {
@@ -74,16 +54,11 @@ const PADROES_TECNOLOGIA = {
         configs: ['cli.js', 'cli.ts', 'bin/', 'bin/index.js', 'bin/index.ts'],
         scripts: ['build', 'start', 'dev'],
         codigoPatterns: [/new\s+Command\(/i, /\.command\s*\(/i, /\.option\s*\(/i, /process\.argv/i, /\.parse\s*\(/i, /\.action\s*\(/i, /\.version\s*\(/i, /\.description\s*\(/i],
-        // Sinais que indicam que NÃO é um bot
         antiPatterns: [/Client\(\s*\{[\s\S]*intents/i,
-            // Discord client
             /new\s+Telegraf/i,
-            // Telegram bot
             /bot\.command/i,
-            // Bot commands
             /interaction\.reply/i,
-            // Discord interactions
-            /ctx\.reply/i // Telegram context
+            /ctx\.reply/i
         ]
     },
     'electron-app': {
@@ -104,20 +79,13 @@ const PADROES_TECNOLOGIA = {
         configs: ['next.config.js', 'next.config.ts', 'next.config.mjs', 'next-env.d.ts', 'tailwind.config.js'],
         scripts: ['dev', 'build', 'start', 'lint', 'type-check'],
         codigoPatterns: [/export\s+default\s+function.*Page/i, /getServerSideProps/i, /getStaticProps/i, /getStaticPaths/i, /NextApiRequest/i, /NextApiResponse/i, /useRouter/i, /next\/head/i, /next\/link/i, /export\s+default\s+function\s+Page/i,
-            // App Router
             /export\s+default\s+function\s+Layout/i,
-            // App Router Layout
             /export\s+default\s+function\s+Loading/i,
-            // App Router Loading
             /export\s+default\s+function\s+Error/i,
-            // App Router Error
             /export\s+default\s+function\s+NotFound/i,
-            // App Router Not Found
             /metadata\s*=/i,
-            // App Router metadata
             /generateStaticParams/i,
-            // App Router static generation
-            /generateMetadata/i // App Router metadata generation
+            /generateMetadata/i
         ],
         antiPatterns: []
     },
@@ -304,26 +272,19 @@ function analisarEstrutura(estruturaDetectada) {
     const evidencias = [];
     for (const [tecnologia, padroes] of Object.entries(PADROES_TECNOLOGIA)) {
         for (const estrutura of padroes.estrutura) {
-            // Verificação mais rigorosa para evitar falsos positivos
             const matchExato = estruturaDetectada?.find(dir => {
-                // Match exato do caminho
                 if (dir === estrutura) {
                     return true;
                 }
-                // Match no final do caminho (ex: src/cli/commands matcheia 'commands')
                 if (dir.endsWith(`/${estrutura}`)) {
                     return true;
                 }
-                // Match no início seguido de / (ex: commands/subdir matcheia 'commands')
                 if (dir.startsWith(`${estrutura}/`)) {
                     return true;
                 }
-                // Para padrões que incluem /, verificar match rigoroso de subcaminho
                 if (estrutura.includes('/')) {
-                    // Normalizar separadores para comparação
                     const estruturaNorm = estrutura.replace(/\\/g, '/');
                     const dirNorm = dir.replace(/\\/g, '/');
-                    // Verificar se é subcaminho exato
                     if (dirNorm === estruturaNorm) {
                         return true;
                     }
@@ -367,7 +328,6 @@ function analisarImportsExports(arquivos) {
             },
             ExportDeclaration(path) {
                 const node = path.node;
-                // Analisa exports nomeados e padrão
                 if ('declaration' in node && node.declaration) {
                     if ('id' in node.declaration && node.declaration.id && 'name' in node.declaration.id) {
                         if (typeof node.declaration.id.name === 'string') {
@@ -377,7 +337,6 @@ function analisarImportsExports(arquivos) {
                 }
             }
         });
-        // Verifica evidências nos imports
         for (const [tecnologia, padroes] of Object.entries(PADROES_TECNOLOGIA)) {
             for (const importEsperado of padroes.imports) {
                 if (imports.some(imp => imp.includes(importEsperado))) {
@@ -427,27 +386,22 @@ function analisarPadroesCodigo(arquivos) {
     }
     return evidencias;
 }
-/**
- * Verifica se anti-patterns estão presentes no código
- * Anti-patterns indicam que a tecnologia detectada está INCORRETA
- */
 function verificarAntiPatterns(arquivos, tecnologia) {
     const padraoTecnologia = PADROES_TECNOLOGIA[tecnologia];
     if (padraoTecnologia.antiPatterns.length === 0) {
-        return false; // Sem anti-patterns definidos
+        return false;
     }
     for (const arquivo of arquivos) {
         if (!arquivo.content) {
             continue;
         }
-        // Se encontrar qualquer anti-pattern, retorna true (detecção incorreta)
         for (const antiPadrao of padraoTecnologia.antiPatterns) {
             if (antiPadrao.test(arquivo.content)) {
-                return true; // Anti-pattern encontrado!
+                return true;
             }
         }
     }
-    return false; // Nenhum anti-pattern encontrado
+    return false;
 }
 function gerarSugestoesMelhoria(tecnologia, evidencias) {
     const sugestoes = [];
@@ -504,7 +458,6 @@ function detectarProblemas(tecnologia, evidencias, arquivos) {
     const problemas = [];
     switch (tecnologia) {
         case 'discord-bot':
-            // Verifica se token está hardcoded
             for (const arquivo of arquivos) {
                 if (arquivo.content?.includes('token') && !arquivo.content.includes('process.env')) {
                     problemas.push(`[ALERT] Possível token hardcoded em ${arquivo.relPath}`);
@@ -512,7 +465,6 @@ function detectarProblemas(tecnologia, evidencias, arquivos) {
             }
             break;
         case 'express-api':
-            // Verifica middleware de segurança
             const temHelmet = evidencias.some(erro => erro.valor.includes('helmet'));
             const temCors = evidencias.some(erro => erro.valor.includes('cors'));
             if (!temHelmet) {
@@ -523,7 +475,6 @@ function detectarProblemas(tecnologia, evidencias, arquivos) {
             }
             break;
         case 'electron-app':
-            // Verifica configurações de segurança
             for (const arquivo of arquivos) {
                 if (arquivo.content?.includes('nodeIntegration: true')) {
                     problemas.push(`[ALERT] nodeIntegration habilitado em ${arquivo.relPath} - risco de segurança`);
@@ -559,7 +510,6 @@ function calcularConfiancaTotal(evidencias) {
     return somaPesos > 0 ? somaConfianca / somaPesos : 0;
 }
 export function detectarContextoInteligente(estruturaDetectada, arquivos, packageJson, options) {
-    // DEBUG: Log simples para verificar se está sendo chamado
     if (!options?.quiet && config.VERBOSE) {
         console.log(DetectorContextoExtraMensagens.debugPackageCompleto, JSON.stringify(packageJson, null, 2));
         if (packageJson?.dependencies?.vue) {
@@ -567,7 +517,6 @@ export function detectarContextoInteligente(estruturaDetectada, arquivos, packag
         }
     }
     const todasEvidencias = [...analisarDependencias(packageJson), ...analisarScripts(packageJson), ...analisarEstrutura(estruturaDetectada), ...analisarImportsExports(arquivos), ...analisarPadroesCodigo(arquivos)];
-    // Agrupa evidências por tecnologia
     const evidenciasPorTecnologia = new Map();
     for (const evidencia of todasEvidencias) {
         const tec = evidencia.tecnologia ?? 'desconhecido';
@@ -579,36 +528,28 @@ export function detectarContextoInteligente(estruturaDetectada, arquivos, packag
             tecEvidencias.push(evidencia);
         }
     }
-    // Calcula resultados por tecnologia
     const resultados = [];
     for (const [tecnologia, evidencias] of evidenciasPorTecnologia) {
         let confiancaTotal = calcularConfiancaTotal(evidencias);
-        // Verificação de dependências obrigatórias para evitar falsos positivos
         const padraoTecnologia = PADROES_TECNOLOGIA[tecnologia];
         if (padraoTecnologia.dependencias.length > 0) {
             const temDependenciaObrigatoria = evidencias.some(erro => erro.tipo === 'dependencia' && padraoTecnologia.dependencias.includes(erro.valor));
-            // Se não tem nenhuma dependência obrigatória, penalizar severamente
             if (!temDependenciaObrigatoria) {
-                confiancaTotal *= 0.1; // Reduz confiança para 10%
+                confiancaTotal *= 0.1;
             }
         }
-        // [ALERT] VERIFICAÇÃO DE ANTI-PATTERNS: Se anti-patterns estão presentes, ELIMINAR detecção
         const temAntiPadrao = verificarAntiPatterns(arquivos, tecnologia);
         if (temAntiPadrao) {
-            // Anti-pattern detectado = detecção FALSA, eliminar confiança
             confiancaTotal = 0;
-            // Opcional: Adicionar evidência negativa
             evidencias.push({
                 tipo: 'codigo',
                 valor: 'anti-pattern-detectado',
                 confianca: -1.0,
-                // Negativa
                 tecnologia,
                 localizacao: 'código'
             });
         }
         if (confiancaTotal > 0.3) {
-            // Threshold mínimo para considerar
             resultados.push({
                 tecnologia,
                 confiancaTotal,
@@ -618,7 +559,6 @@ export function detectarContextoInteligente(estruturaDetectada, arquivos, packag
             });
         }
     }
-    // Ordena por confiança decrescente
     return resultados.sort((arquivo, base) => base.confiancaTotal - arquivo.confiancaTotal);
 }
 export function inferirArquetipoInteligente(estruturaDetectada, arquivos, packageJson, options) {
@@ -627,7 +567,6 @@ export function inferirArquetipoInteligente(estruturaDetectada, arquivos, packag
         return 'generico';
     }
     const melhorResultado = resultados[0];
-    // Mapeia tecnologias para arquétipos oficiais
     const mapeamentoArquetipos = {
         'discord-bot': 'bot',
         'telegram-bot': 'bot',