@mocoto/mahoraga 0.14.0 → 0.14.2

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

@@ -1,3 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+ * [GRAFICO] Pontuador de qualidade SQL
+ *
+ * Avalia a qualidade do SQL baseado em:
+ * - Segurança (40%): injeção, credenciais, WHERE, GRANT, transações
+ * - Performance (30%): SELECT *, índices, funções, N+1, NOT IN, ORs
+ * - Boas Práticas (30%): tipos, constraints, defaults, FK, UNIQUE
+ */
 import { splitLines } from '../../../shared/helpers/index.js';
 export function pontuarSql(src, _relPath) {
     const detalhado = pontuarSqlDetalhado(src, _relPath);
@@ -14,25 +23,29 @@ export function pontuarSqlDetalhado(src, _relPath) {
     const strengths = [];
     const linhas = splitLines(src);
     const srcLower = src.toLowerCase();
+    // ── Segurança (40 pontos) ──────────────────────────────────────────────
     let seguranca = 0;
     const maxSeguranca = 40;
-    const hardcodedCreds = (src.match(/\b(password|senha|secret|key|token)\b\s*[:=]\s*['"]/gi) || []).length;
+    // No hardcoded credentials (8 pts)
+    const hardcodedCreds = (src.match(/\b(password|senha|secret|key|token)\b\s*[:=]\s*['"]/gi) ?? []).length;
     if (hardcodedCreds === 0) {
         seguranca += 8;
     }
     else {
         issues.push(`${hardcodedCreds} credencial(is) hardcoded`);
     }
-    const concatPatterns = (src.match(/\s\+\s*['"`].*?(select|insert|update|delete)/gi) || []).length;
+    // No SQL injection patterns (8 pts)
+    const concatPatterns = (src.match(/\s\+\s*['"`].*?(select|insert|update|delete)/gi) ?? []).length;
     if (concatPatterns === 0) {
         seguranca += 8;
     }
     else {
         issues.push(`${concatPatterns} padrão(ões) de concatenação SQL`);
     }
-    const deletes = (src.match(/\bdelete\s+/gi) || []).length;
-    const updates = (src.match(/\bupdate\s+\w+\s+set/gi) || []).length;
-    const withWhere = (src.match(/\bwhere\b/gi) || []).length;
+    // All DELETE/UPDATE have WHERE (8 pts)
+    const deletes = (src.match(/\bdelete\s+/gi) ?? []).length;
+    const updates = (src.match(/\bupdate\s+\w+\s+set/gi) ?? []).length;
+    const withWhere = (src.match(/\bwhere\b/gi) ?? []).length;
     const totalMutations = deletes + updates;
     if (totalMutations === 0 || withWhere >= totalMutations) {
         seguranca += 8;
@@ -41,12 +54,14 @@ export function pontuarSqlDetalhado(src, _relPath) {
         seguranca += Math.max(0, 8 - (totalMutations - withWhere) * 4);
         issues.push(`${totalMutations - withWhere} operação(ões) sem WHERE`);
     }
+    // No GRANT ALL (6 pts)
     if (!/\bgrant\s+all\s+(privileges\s+)?on\b/i.test(src)) {
         seguranca += 6;
     }
     else {
         issues.push('GRANT ALL PRIVILEGES detectado');
     }
+    // Has transaction wrapping (5 pts)
     if ((srcLower.includes('begin') && srcLower.includes('commit')) ||
         (srcLower.includes('begin transaction') && srcLower.includes('commit'))) {
         seguranca += 5;
@@ -58,16 +73,19 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push('Instruções sem transação');
     }
-    const dynamicPatterns = (src.match(/\$\{.*\}.*(where|order by|limit|offset)/gi) || []).length;
+    // No dynamic WHERE/ORDER BY/LIMIT (5 pts)
+    const dynamicPatterns = (src.match(/\$\{.*\}.*(where|order by|limit|offset)/gi) ?? []).length;
     if (dynamicPatterns === 0) {
         seguranca += 5;
     }
     else {
         issues.push(`${dynamicPatterns} padrão(ões) de SQL dinâmico`);
     }
+    // ── Performance (30 pontos) ────────────────────────────────────────────
     let performance = 0;
     const maxPerformance = 30;
-    const selectStar = (src.match(/\bselect\s+\*\s+from/gi) || []).length;
+    // No SELECT * (8 pts)
+    const selectStar = (src.match(/\bselect\s+\*\s+from/gi) ?? []).length;
     if (selectStar === 0) {
         performance += 8;
     }
@@ -75,26 +93,30 @@ export function pontuarSqlDetalhado(src, _relPath) {
         performance += Math.max(0, 8 - selectStar * 3);
         issues.push(`${selectStar} SELECT * detectado(s)`);
     }
-    const funcOnCol = (src.match(/\b(upper|lower|year|month|day|cast|convert|coalesce|nullif|substr|substring|trim|len|length|abs|round)\s*\(\s*\w+\.?\w*\s*\)\s*(=|<|>|!=)/gi) || []).length;
+    // No function on column in WHERE (6 pts)
+    const funcOnCol = (src.match(/\b(upper|lower|year|month|day|cast|convert|coalesce|nullif|substr|substring|trim|len|length|abs|round)\s*\(\s*\w+\.?\w*\s*\)\s*(=|<|>|!=)/gi) ?? []).length;
     if (funcOnCol === 0) {
         performance += 6;
     }
     else {
         issues.push(`${funcOnCol} função(ões) em coluna no WHERE`);
     }
+    // No NOT IN with subquery (5 pts)
     if (!/\bnot\s+in\s*\(\s*select\b/i.test(src)) {
         performance += 5;
     }
     else {
         issues.push('NOT IN com subconsulta detectado');
     }
-    const linhasComOr = linhas.filter(linha => (linha.match(/\bor\b/gi) || []).length >= 3).length;
+    // No excessive OR (4 pts)
+    const linhasComOr = linhas.filter(linha => (linha.match(/\bor\b/gi) ?? []).length >= 3).length;
     if (linhasComOr === 0) {
         performance += 4;
     }
     else {
         issues.push(`${linhasComOr} linha(s) com múltiplos OR`);
     }
+    // JOINs with index mention (4 pts)
     if (!/\bjoin\b/i.test(src) ||
         /(index|idx_)/i.test(src)) {
         performance += 4;
@@ -102,50 +124,58 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else if (/\bjoin\b/i.test(src)) {
         issues.push('JOIN sem índice mencionado');
     }
-    const selectStatements = (src.match(/\bselect\b/gi) || []).length;
+    // No N+1 pattern (3 pts)
+    const selectStatements = (src.match(/\bselect\b/gi) ?? []).length;
     if (selectStatements <= 5) {
         performance += 3;
     }
     else {
         issues.push(`${selectStatements} consultas SELECT - possível N+1`);
     }
+    // ── Boas Práticas (30 pontos) ──────────────────────────────────────────
     let boasPraticas = 0;
     const maxBoasPraticas = 30;
-    const varcharNoSize = (src.match(/\bvarchar\b\s*(\(|\s|$)/gi) || []).filter(m => !/varchar\(\d+\)/i.test(m)).length;
+    // VARCHAR with size (7 pts)
+    const varcharNoSize = (src.match(/\bvarchar\b\s*(\(|\s|$)/gi) ?? []).filter(m => !/varchar\(\d+\)/i.test(m)).length;
     if (varcharNoSize === 0) {
         boasPraticas += 7;
     }
     else {
         issues.push(`${varcharNoSize} VARCHAR sem tamanho`);
     }
-    const creates = (src.match(/\bcreate\s+(table|procedure|view)\b/gi) || []).length;
-    const ifNotExists = (src.match(/\bif\s+not\s+exists\b/gi) || []).length;
+    // Has IF NOT EXISTS (5 pts)
+    const creates = (src.match(/\bcreate\s+(table|procedure|view)\b/gi) ?? []).length;
+    const ifNotExists = (src.match(/\bif\s+not\s+exists\b/gi) ?? []).length;
     if (creates === 0 || ifNotExists >= creates) {
         boasPraticas += 5;
     }
     else {
         issues.push(`${creates - ifNotExists} CREATE sem IF NOT EXISTS`);
     }
+    // No TRUNCATE (4 pts)
     if (!/\btruncate\s+table\b/i.test(src)) {
         boasPraticas += 4;
     }
     else {
         issues.push('TRUNCATE TABLE detectado');
     }
-    const colDefs = (src.match(/^\s*\w+\s+(int|varchar|text|char|decimal|numeric|float|double|boolean|date|timestamp|blob|json)\b/gi) || []).length;
-    const withNotNull = (src.match(/\bnot\s+null\b/gi) || []).length;
+    // NOT NULL on columns (4 pts)
+    const colDefs = (src.match(/^\s*\w+\s+(int|varchar|text|char|decimal|numeric|float|double|boolean|date|timestamp|blob|json)\b/gi) ?? []).length;
+    const withNotNull = (src.match(/\bnot\s+null\b/gi) ?? []).length;
     if (colDefs === 0 || withNotNull >= colDefs) {
         boasPraticas += 4;
     }
     else {
         issues.push(`${colDefs - withNotNull} coluna(s) sem NOT NULL`);
     }
+    // No FLOAT for currency (4 pts)
     if (!/(preco|price|valor|value|salario|salary|custo|cost|total|amount|money|revenue|receita).*float|float.*(preco|price|valor|value|salario|salary|custo|cost|total|amount|money|revenue|receita)/i.test(src)) {
         boasPraticas += 4;
     }
     else {
         issues.push('FLOAT para valor monetário');
     }
+    // UNIQUE on identifiers (3 pts)
     if (!/\b(cpf|cnpj|email|username|login|slug)\b.*(varchar|char)/i.test(src) ||
         /\bunique\b/i.test(src)) {
         boasPraticas += 3;
@@ -153,6 +183,7 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push('Identificadores sem UNIQUE');
     }
+    // Has FOREIGN KEY (3 pts)
     if (!/\b\w+_id\s+(int|bigint|uuid|varchar)\b/i.test(src) || /\bforeign\s+key\b/i.test(src)) {
         boasPraticas += 3;
     }
@@ -181,4 +212,3 @@ export const pontuadorSql = {
     descricao: 'Pontua qualidade de SQL (segurança 40%, performance 30%, boas práticas 30%)',
     pontuar: pontuarSql,
 };
-//# sourceMappingURL=scorer-sql.js.map

package/dist/analysts/strategists/archetypes-defs.js

@@ -2,12 +2,14 @@ export const ARQUETIPOS = [{
         nome: 'cli-modular',
         descricao: 'CLI modular em TypeScript/JavaScript com comandos organizados e entrada via bin/',
         requiredDirs: ['bin'],
+        // bin/ é OBRIGATÓRIO para CLIs publicáveis
         optionalDirs: ['src/cli', 'src/cli/commands', 'src/commands', 'cli', 'cli/commands', 'src/utils', 'src/lib'],
         filePresencePatterns: ['bin/index.js', 'bin/index.ts', 'bin/cli.js', 'bin/cli.ts', 'cli.ts'],
         dependencyHints: ['commander', 'yargs', 'chalk', 'inquirer', 'ora', 'prompts'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.gitignore', '.prettierrc', 'eslint.config.js', '.lintstagedrc.cjs', '.lintstagedrc.mjs', 'LICENSE', 'CHANGELOG.md'],
+        // Evita colisão com bots e web apps
         forbiddenDirs: ['pages', 'prisma', 'public', 'events', 'scenes'],
-        pesoBase: 1.5
+        pesoBase: 1.5 // AUMENTADO: CLIs com bin/ são muito específicas
     }, {
         nome: 'landing-page',
         descricao: 'Aplicação web simples (frontend) com pages/ e components/',
@@ -15,7 +17,7 @@ export const ARQUETIPOS = [{
         optionalDirs: ['public', 'styles', 'utils'],
         forbiddenDirs: ['prisma', 'api', 'server'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'next.config.js', 'tailwind.config.js'],
-        pesoBase: 1.0
+        pesoBase: 1.0 // Mantido neutro
     }, {
         nome: 'api-rest-express',
         descricao: 'API REST em Express com controllers/ e estrutura backend',
@@ -24,26 +26,30 @@ export const ARQUETIPOS = [{
         dependencyHints: ['express', 'cors', 'helmet', 'joi', 'joi-to-swagger'],
         forbiddenDirs: ['pages', 'components', 'public'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', '.env.example', 'README.md', 'server.js'],
-        pesoBase: 1.3
+        pesoBase: 1.3 // Aumentado pois é um padrão muito específico e maduro
     }, {
         nome: 'fullstack',
         descricao: 'Aplicação fullstack (Next.js) com pages/, api/ e prisma/',
         requiredDirs: ['pages', 'api', 'prisma'],
         optionalDirs: ['components', 'lib', 'styles', 'utils', 'types'],
+        // Em projetos fullstack, normalmente não coexistem workspaces/packages na raiz
+        // pois indicam estrutura de monorepo; penalizamos quando presente.
         forbiddenDirs: ['packages', 'apps', 'server'],
         dependencyHints: ['next', 'react', 'prisma'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'next.config.js', 'tailwind.config.js'],
-        pesoBase: 1.4
+        pesoBase: 1.4 // Aumentado pois combina frontend + backend + banco
     }, {
         nome: 'bot',
         descricao: 'Bot (Discord/Telegram) com handlers de eventos e comandos específicos',
         requiredDirs: ['src/bot'],
+        // OBRIGATÓRIO ter pasta bot/
         optionalDirs: ['src/commands', 'src/events', 'src/utils', 'src/handlers'],
         filePresencePatterns: ['bot.ts', 'bot.js', 'index.ts'],
         dependencyHints: ['telegraf', 'discord.js', 'grammy', '@discordjs/builders'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.env.example'],
+        // Estruturas típicas de frontend/monorepo/CLI não são esperadas em bots
         forbiddenDirs: ['pages', 'prisma', 'packages', 'electron-app', 'public', 'bin', 'cli'],
-        pesoBase: 0.8
+        pesoBase: 0.8 // REDUZIDO: bots são mais simples e podem gerar false positives
     }, {
         nome: 'electron',
         descricao: 'Aplicação Electron com main process e renderer',
@@ -52,8 +58,9 @@ export const ARQUETIPOS = [{
         filePresencePatterns: ['electron.js', 'electron.ts', 'main.js'],
         dependencyHints: ['electron', 'electron-builder'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'electron-builder.json'],
+        // Electron não deve coexistir com pastas típicas de web fullstack/monorepo
         forbiddenDirs: ['pages', 'prisma', 'packages', 'api'],
-        pesoBase: 1.2
+        pesoBase: 1.2 // Aumentado pois tem estrutura específica
     }, {
         nome: 'lib-tsc',
         descricao: 'Biblioteca TypeScript compilada com estrutura organizada',
@@ -61,9 +68,10 @@ export const ARQUETIPOS = [{
         optionalDirs: ['src/lib', 'src/utils', 'src/types', 'examples'],
         filePresencePatterns: ['index.ts', 'lib/index.ts'],
         dependencyHints: [],
+        // Bibliotecas geralmente têm poucas deps de runtime
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'LICENSE', 'rollup.config.js', 'webpack.config.js'],
         forbiddenDirs: ['pages', 'api', 'prisma', 'public', 'server'],
-        pesoBase: 1.0
+        pesoBase: 1.0 // Mantido neutro
     }, {
         nome: 'monorepo-packages',
         descricao: 'Monorepo com packages/ e workspaces (pnpm/npm/yarn)',
@@ -71,8 +79,9 @@ export const ARQUETIPOS = [{
         optionalDirs: ['apps', 'tools', 'packages/shared', 'packages/core'],
         dependencyHints: [],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'turbo.json', 'pnpm-workspace.yaml', 'yarn.lock', 'pnpm-lock.yaml'],
+        // Penaliza estrutura de código na raiz em monorepos (esperado ficar em apps/ ou packages/)
         forbiddenDirs: ['src', 'pages', 'api', 'prisma', 'lib'],
-        pesoBase: 1.5
+        pesoBase: 1.5 // Aumentado pois é uma arquitetura mais complexa
     }, {
         nome: 'vue-spa',
         descricao: 'SPA Vue.js com components/, views/ e estrutura moderna',
@@ -81,7 +90,7 @@ export const ARQUETIPOS = [{
         dependencyHints: ['vue', 'vue-router', 'vuex', 'pinia', '@vue/cli-service'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', 'vue.config.js', 'vue.config.ts', 'babel.config.js', 'tailwind.config.js'],
         forbiddenDirs: ['pages', 'api', 'prisma', 'server', 'packages'],
-        pesoBase: 1.2
+        pesoBase: 1.2 // Estrutura específica mas comum
     }, {
         nome: 'clean-arch',
         descricao: 'Clean Architecture (Arquitetura Limpa) com domínio, aplicação, infraestrutura e apresentação',
@@ -91,7 +100,7 @@ export const ARQUETIPOS = [{
         dependencyHints: ['zod', 'tsyringe', 'inversify', 'awilix', 'typeorm', 'prisma', 'mongoose'],
         forbiddenDirs: ['pages', 'components', 'prisma'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.env.example', 'Dockerfile', 'docker-compose.yml'],
-        pesoBase: 1.5
+        pesoBase: 1.5 // Estrutura sofisticada e específica
     }, {
         nome: 'microservices',
         descricao: 'Arquitetura Distribuída em Microsserviços com boundaries e comunicação assíncrona',
@@ -101,9 +110,8 @@ export const ARQUETIPOS = [{
         dependencyHints: ['kafkajs', 'amqplib', 'ioredis', 'bull', 'bullmq', 'nats', 'grpc', '@grpc/grpc-js', 'express', 'fastify'],
         forbiddenDirs: ['pages', 'components', 'prisma'],
         rootFilesAllowed: ['package.json', 'tsconfig.json', 'README.md', '.env.example', 'Dockerfile', 'docker-compose.yml', 'docker-compose.yaml', 'kubernetes', 'k8s'],
-        pesoBase: 1.6
+        pesoBase: 1.6 // Arquitetura mais complexa e distribuída
     }];
 export function normalizarCaminho(caminho) {
     return caminho.replace(/\\/g, '/');
 }
-//# sourceMappingURL=archetypes-defs.js.map

package/dist/analysts/strategists/index.js

@@ -1,4 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Estrategistas de análise
+ */
 export * from './archetypes-defs.js';
 export * from './operator-structure.js';
 export * from './suggestions-contextuais.js';
-//# sourceMappingURL=index.js.map

package/dist/analysts/strategists/operator-structure.js

@@ -1,10 +1,16 @@
-import { detectarArquetipos, extrairSinaisAvancados, gerarPlanoEstrategico } from '../architects/index.js';
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-literal-inline-complexo
+// Justificativa: tipos locais para operações de estrutura
 import { config } from '../../core/config/index.js';
 import { getMessages } from '../../core/messages/index.js';
+import { detectarArquetipos, extrairSinaisAvancados, gerarPlanoEstrategico } from '../architects/index.js';
 import { corrigirEstrutura } from '../corrections/corrector-structure.js';
 const { log, MENSAGENS_ARQUETIPOS_HANDLER } = getMessages();
 export const OperarioEstrutura = {
     async planejar(baseDir, fileEntriesComAst, opcoes) {
+        // 1) Tenta arquétipos, a menos que forçado estrategista.
+        //    Quando preset='mahoraga', evitamos arquétipos em runtime normal,
+        //    mas permitimos em testes (VITEST) para compatibilidade das suítes.
         const emTeste = !!process.env.VITEST;
         const podeUsarArquetipos = !!opcoes.preset && !opcoes.preferEstrategista && (opcoes.preset !== 'mahoraga' || emTeste);
         if (podeUsarArquetipos) {
@@ -26,13 +32,18 @@ export const OperarioEstrutura = {
             }
             catch (erro) {
                 log.aviso(MENSAGENS_ARQUETIPOS_HANDLER.falha);
-                if (config.DEV_MODE)
+                if (config.DEV_MODE) {
                     console.error(erro);
+                }
             }
         }
+        // 2) Fallback (ou preferido): estrategista
         try {
             try {
-                const sinaisAvancados = extrairSinaisAvancados(fileEntriesComAst, undefined, undefined, baseDir, fileEntriesComAst.map(arquivo => arquivo.relPath));
+                // Extrair sinais avançados para inteligência contextual
+                const sinaisAvancados = extrairSinaisAvancados(fileEntriesComAst, undefined, 
+                // packageJson - será carregado internamente se necessário
+                undefined, baseDir, fileEntriesComAst.map(arquivo => arquivo.relPath));
                 const planoAlt = await gerarPlanoEstrategico({
                     arquivos: fileEntriesComAst,
                     baseDir
@@ -42,18 +53,18 @@ export const OperarioEstrutura = {
                     ...(opcoes.preset ? {
                         preset: opcoes.preset
                     } : {})
-                }, sinaisAvancados);
-                if (planoAlt && Array.isArray(planoAlt.mover)) {
-                    return {
-                        plano: planoAlt,
-                        origem: 'estrategista'
-                    };
-                }
+                }, sinaisAvancados // Passar sinais avançados para inteligência contextual
+                );
+                return {
+                    plano: planoAlt,
+                    origem: 'estrategista'
+                };
             }
             catch (erro) {
                 log.aviso(MENSAGENS_ARQUETIPOS_HANDLER.falhaEstrategista);
-                if (config.DEV_MODE)
+                if (config.DEV_MODE) {
                     console.error(erro);
+                }
             }
             return {
                 plano: undefined,
@@ -62,8 +73,9 @@ export const OperarioEstrutura = {
         }
         catch (erro) {
             log.aviso(MENSAGENS_ARQUETIPOS_HANDLER.falhaGeral);
-            if (config.DEV_MODE)
+            if (config.DEV_MODE) {
                 console.error(erro);
+            }
             return {
                 plano: undefined,
                 origem: 'nenhum'
@@ -71,10 +83,11 @@ export const OperarioEstrutura = {
         }
     },
     toMapaMoves(plano) {
-        if (!plano || !Array.isArray(plano.mover))
+        if (!plano || !Array.isArray(plano.mover)) {
             return [];
+        }
         return plano.mover.map((metrica) => {
-            const para = String(metrica.para || '');
+            const para = (metrica.para || '');
             const idx = para.lastIndexOf('/');
             const ideal = idx > 0 ? para.substring(0, idx) : null;
             return {
@@ -87,12 +100,14 @@ export const OperarioEstrutura = {
     async aplicar(mapaMoves, fileEntriesComAst, baseDir) {
         await corrigirEstrutura(mapaMoves, fileEntriesComAst, baseDir);
     },
+    // Auxiliar: converter ocorrências para mapa de correções (fallback)
     ocorrenciasParaMapa(ocorrencias) {
         const mapa = [];
-        if (!ocorrencias || !ocorrencias.length)
+        if (!ocorrencias?.length) {
             return mapa;
+        }
         for (const occ of ocorrencias) {
-            const rel = occ.relPath ?? occ.arquivo ?? 'arquivo desconhecido';
+            const rel = occ.relPath;
             mapa.push({
                 arquivo: rel,
                 ideal: null,
@@ -102,4 +117,3 @@ export const OperarioEstrutura = {
         return mapa;
     }
 };
-//# sourceMappingURL=operator-structure.js.map

package/dist/analysts/strategists/suggestions-contextuais.js

@@ -1,17 +1,32 @@
-import { detectarContextoInteligente } from '../js-ts/detectors/index.js';
+// SPDX-License-Identifier: MIT
+/**
+ * Analista de Sugestões Contextuais Inteligentes
+ *
+ * Utiliza o sistema de detecção contextual para gerar sugestões específicas
+ * baseadas no tipo real de projeto detectado, considerando:
+ * - Dependências e configurações
+ * - Padrões de código específicos
+ * - Estrutura e nomenclatura
+ * - Melhores práticas por tecnologia
+ */
 import { messages } from '../../core/messages/index.js';
+import { detectarContextoInteligente } from '../js-ts/detectors/index.js';
 const log = messages.log;
 export const analistaSugestoesContextuais = {
     nome: 'sugestoes-contextuais',
     categoria: 'estrategia',
     descricao: 'Gera sugestões específicas baseadas no contexto real do projeto detectado',
     global: true,
-    async aplicar(_src, _relPath, _ast, _fullPath, contexto) {
+    // Analisa contexto global do projeto
+    aplicar(_src, _relPath, _ast, 
+    // AST node path
+    _fullPath, contexto) {
         const ocorrencias = [];
         if (!contexto) {
             return ocorrencias;
         }
         try {
+            // Obter package.json se disponível
             let packageJson;
             try {
                 const pkgArquivo = contexto.arquivos?.find(arquivo => arquivo.relPath === 'package.json');
@@ -20,8 +35,11 @@ export const analistaSugestoesContextuais = {
                 }
             }
             catch {
+                // Ignorar erros de parsing do package.json
             }
+            // Extrair estrutura de diretórios dos arquivos
             const estruturaDetectada = Array.from(new Set(contexto.arquivos.map(arquivo => arquivo.relPath.includes('/') ? arquivo.relPath.split('/')[0] : '').filter(dir => dir && dir !== '.')));
+            // Executar detecção contextual inteligente
             const resultados = detectarContextoInteligente(estruturaDetectada, contexto.arquivos, packageJson);
             if (resultados.length === 0) {
                 ocorrencias.push({
@@ -35,6 +53,7 @@ export const analistaSugestoesContextuais = {
             }
             const melhorResultado = resultados[0];
             const confiancaPercent = Math.round(melhorResultado.confiancaTotal * 100);
+            // Gerar ocorrência principal com identificação
             ocorrencias.push({
                 tipo: 'identificacao_projeto',
                 nivel: 'info',
@@ -47,7 +66,8 @@ export const analistaSugestoesContextuais = {
                     evidencias: melhorResultado.evidencias.length
                 }
             });
-            for (const sugestao of melhorResultado.sugestoesMelhoria || []) {
+            // Gerar sugestões de melhorias
+            for (const sugestao of melhorResultado.sugestoesMelhoria ?? []) {
                 ocorrencias.push({
                     tipo: 'sugestao_melhoria',
                     nivel: 'info',
@@ -60,7 +80,8 @@ export const analistaSugestoesContextuais = {
                     }
                 });
             }
-            for (const problema of melhorResultado.problemasDetectados || []) {
+            // Gerar alertas de problemas
+            for (const problema of melhorResultado.problemasDetectados ?? []) {
                 ocorrencias.push({
                     tipo: 'problema_seguranca',
                     nivel: 'aviso',
@@ -73,7 +94,8 @@ export const analistaSugestoesContextuais = {
                     }
                 });
             }
-            const evidenciasTop = melhorResultado.evidencias.filter(erro => erro.confianca > 0.8).slice(0, 5);
+            // Gerar ocorrências para evidências mais relevantes
+            const evidenciasTop = melhorResultado.evidencias.filter(erro => erro.confianca > 0.8).slice(0, 5); // Top 5 evidências
             for (const evidencia of evidenciasTop) {
                 let mensagem = '';
                 const nivel = 'info';
@@ -90,6 +112,10 @@ export const analistaSugestoesContextuais = {
                     case 'estrutura':
                         mensagem = messages.SugestoesContextuaisMensagens.evidenciaEstrutura(evidencia.valor, melhorResultado.tecnologia);
                         break;
+                    case 'export':
+                    case 'config':
+                    case 'script':
+                        continue;
                     default:
                         continue;
                 }
@@ -97,7 +123,7 @@ export const analistaSugestoesContextuais = {
                     tipo: 'evidencia_contextual',
                     nivel,
                     mensagem,
-                    relPath: evidencia.localizacao || '',
+                    relPath: evidencia.localizacao ?? '',
                     linha: 0,
                     detalhes: {
                         tecnologia: melhorResultado.tecnologia,
@@ -106,6 +132,7 @@ export const analistaSugestoesContextuais = {
                     }
                 });
             }
+            // Se houver múltiplas tecnologias detectadas, mostrar alternativas
             if (resultados.length > 1) {
                 const alternativas = resultados.slice(1, 3).map(raiz => `${raiz.tecnologia} (${Math.round(raiz.confiancaTotal * 100)}%)`).join(', ');
                 ocorrencias.push({
@@ -133,4 +160,3 @@ export const analistaSugestoesContextuais = {
         return ocorrencias;
     }
 };
-//# sourceMappingURL=suggestions-contextuais.js.map

package/dist/analysts/svg/analysts/analyst-svg.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { otimizarSvgLikeSvgo, shouldSugerirOtimizacaoSvg } from '../../../shared/formatters/index.js';
 import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
@@ -8,20 +9,22 @@ export function registrarDetectorSvg(detector) {
 export function obterDetectoresSvg() {
     return [...detectoresRegistrados];
 }
-const disableEnv = process.env.MAHORAGA_DISABLE_PLUGIN_SVG === '1';
+const disableEnv = process.env.SUKUNA_DISABLE_PLUGIN_SVG === '1';
 function findLine(src, index = 0) {
     const safeIndex = Math.max(0, index);
     let line = 1;
     for (let indice = 0; indice < safeIndex && indice < src.length; indice++) {
-        if (src.charCodeAt(indice) === 10)
+        if (src.charCodeAt(indice) === 10) {
             line++;
+        }
     }
     return line;
 }
 function findFirstMatchLine(src, re, fallbackLine = 1) {
     const idx = src.search(re);
-    if (idx < 0)
+    if (idx < 0) {
         return fallbackLine;
+    }
     return findLine(src, idx);
 }
 function msg(message, relPath, nivel = messages.SeverityNiveis.warning, line = 1) {
@@ -41,8 +44,9 @@ export const analistaSvg = criarAnalista({
     global: false,
     test: (relPath) => /\.svg$/i.test(relPath),
     aplicar: async (src, relPath) => {
-        if (disableEnv)
+        if (disableEnv) {
             return null;
+        }
         const ocorrencias = [];
         if (!/<svg\b/i.test(src)) {
             ocorrencias.push(msg(messages.SvgMensagens.naoPareceSvg, relPath, messages.SeverityNiveis.warning, 1));
@@ -53,6 +57,7 @@ export const analistaSvg = criarAnalista({
         const opt = otimizarSvgLikeSvgo({
             svg: src
         });
+        // Segurança
         for (const dimensaoLargura of opt.warnings) {
             if (dimensaoLargura === 'script-inline') {
                 const line = findFirstMatchLine(src, /<script\b/i, linhaSvg);
@@ -67,21 +72,24 @@ export const analistaSvg = criarAnalista({
                 ocorrencias.push(msg(messages.SvgMensagens.javascriptUrl, relPath, messages.SeverityNiveis.error, line));
             }
         }
+        // Boas práticas
         if (!/\bviewBox\s*=\s*['"][^'"]+['"]/i.test(src)) {
             ocorrencias.push(msg(messages.SvgMensagens.semViewBox, relPath, messages.SeverityNiveis.info, linhaSvg));
         }
+        // Otimização (diferença de bytes)
         if (opt.changed && opt.originalBytes > opt.optimizedBytes && shouldSugerirOtimizacaoSvg(opt.originalBytes, opt.optimizedBytes)) {
             ocorrencias.push(msg(messages.SvgMensagens.podeOtimizar(opt.originalBytes, opt.optimizedBytes, opt.mudancas), relPath, messages.SeverityNiveis.info, linhaSvg));
         }
+        // Plugins registrados
         for (const detector of detectoresRegistrados) {
             try {
                 const result = await Promise.resolve(detector.testar(src, relPath));
                 ocorrencias.push(...result);
             }
             catch {
+                // Ignora erros de plugins
             }
         }
         return ocorrencias.length ? ocorrencias : null;
     }
 });
-//# sourceMappingURL=analyst-svg.js.map

package/dist/analysts/svg/analysts/index.js

@@ -1,2 +1 @@
 export * from './analyst-svg.js';
-//# sourceMappingURL=index.js.map