@mocoto/mahoraga 0.14.8 → 0.14.9

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

@@ -1,15 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * [BUSCA] Detector SQL abrangente
- *
- * Detecta problemas em SQL organizados em categorias:
- * - Segurança: SQL injection, credenciais, GRANT ALL, transações
- * - Padrões de Injeção: LIKE sem ESCAPE, ORDER BY dinâmico, LIMIT/OFFSET dinâmico
- * - Performance: índices, funções em colunas, N+1, NOT IN, ORs múltiplos
- * - Boas Práticas: NOT NULL, DEFAULT, AUTO_INCREMENT PK, TEXT vs VARCHAR, UNIQUE, FLOAT moeda, FK
- * - ORM: eager loading, transações grandes
- */
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
@@ -47,26 +35,20 @@ export const detectorSql = {
             const num = index + 1;
             const trim = linha.trim();
             const _lowerTrim = trim.toLowerCase();
-            // ── Security ────────────────────────────────────────────────────────
-            // SQL Injection via string concatenation
             if (/\s\+\s*['"`]/.test(linha) && SQL_KEYWORDS.test(linha)) {
                 adicionar('sql-injection-dynamic', 'erro', messages.DetectorSqlMensagens.sqlInjectionDynamic, messages.DetectorSqlMensagens.sqlInjectionDynamicSugestao, num);
             }
-            // Dynamic WHERE clause with + or ${}
             if (/\bwhere\b/i.test(linha) &&
                 /['"`]\s*\+/.test(linha)) {
                 adicionar('sql-dynamic-where', 'erro', messages.DetectorSqlMensagens.dynamicWhere, messages.DetectorSqlMensagens.dynamicWhereSugestao, num);
             }
-            // Password storing without hash
             if (/\b(password|passwd|senha)\b\s+(varchar|text|char|string)/i.test(linha) &&
                 !/\b(hash|bcrypt|argon2|pbkdf|scrypt)\b/i.test(linha)) {
                 adicionar('sql-password-without-hash', 'erro', messages.DetectorSqlMensagens.passwordStoring, messages.DetectorSqlMensagens.passwordStoringSugestao, num);
             }
-            // GRANT ALL PRIVILEGES
             if (/\bgrant\s+all\s+(privileges\s+)?on\b/i.test(linha)) {
                 adicionar('sql-grant-all', 'erro', messages.DetectorSqlMensagens.grantAllPrivileges, messages.DetectorSqlMensagens.grantAllPrivilegesSugestao, num);
             }
-            // Statements without transaction (multiple INSERT/UPDATE/DELETE in sequence)
             if (/^\s*(insert|update|delete)\s+/i.test(trim) &&
                 index > 0 &&
                 /^\s*(insert|update|delete)\s+/i.test(linhas[index - 1]?.trim() ?? '') &&
@@ -74,99 +56,76 @@ export const detectorSql = {
                 !src.toLowerCase().includes('commit')) {
                 adicionar('sql-without-transaction', 'aviso', messages.DetectorSqlMensagens.sqlWithoutTransaction, messages.DetectorSqlMensagens.sqlWithoutTransactionSugestao, num);
             }
-            // ── Injection Patterns ──────────────────────────────────────────────
-            // Variable interpolation in query ${} or {{ }}
             if (/\$\{.*\}\s*/.test(linha) && SQL_KEYWORDS.test(linha)) {
                 adicionar('sql-unsafe-concat', 'erro', messages.DetectorSqlMensagens.unsafeConcatInQuery, messages.DetectorSqlMensagens.unsafeConcatInQuerySugestao, num);
             }
-            // LIKE without ESCAPE
             if (/\blike\b/i.test(linha) &&
                 !/\bescape\b/i.test(linha)) {
                 adicionar('sql-like-without-escape', 'aviso', messages.DetectorSqlMensagens.likeWithoutEscape, messages.DetectorSqlMensagens.likeWithoutEscapeSugestao, num);
             }
-            // ORDER BY with dynamic column (variable/parameter)
             if (/\border\s+by\b/i.test(linha) &&
                 /\$\{|\+ |concat\(|:coluna|:col/i.test(linha)) {
                 adicionar('sql-order-by-injection', 'erro', messages.DetectorSqlMensagens.orderByInjection, messages.DetectorSqlMensagens.orderByInjectionSugestao, num);
             }
-            // LIMIT/OFFSET with dynamic values
             if (/\blimit\b|\boffset\b/i.test(linha) &&
                 /\$\{|\+ |:limite|:offset/i.test(linha)) {
                 adicionar('sql-limit-offset-injection', 'erro', messages.DetectorSqlMensagens.limitOffsetInjection, messages.DetectorSqlMensagens.limitOffsetInjectionSugestao, num);
             }
-            // ── Performance ─────────────────────────────────────────────────────
-            // Function on column in WHERE (e.g., WHERE YEAR(col) = ...)
             if (/\bwhere\b/i.test(linha) && /\b(upper|lower|year|month|day|date|cast|convert|coalesce|nullif|substr|substring|trim|ltrim|rtrim|len|length|abs|round)\s*\(\s*\w+\.?\w*\s*\)/i.test(linha)) {
                 adicionar('sql-function-on-column', 'aviso', messages.DetectorSqlMensagens.functionOnColumn, messages.DetectorSqlMensagens.functionOnColumnSugestao, num);
             }
-            // NOT IN with subquery
             if (/\bnot\s+in\s*\(/.test(linha) && /\bselect\b/i.test(linha)) {
                 adicionar('sql-not-in-subquery', 'aviso', messages.DetectorSqlMensagens.notInSubquery, messages.DetectorSqlMensagens.notInSubquerySugestao, num);
             }
-            // Multiple OR conditions (3+)
             const orCount = (linha.match(/\bor\b/gi) ?? []).length;
             if (orCount >= 3) {
                 adicionar('sql-multiple-or', 'info', messages.DetectorSqlMensagens.orWithMultipleConditions, messages.DetectorSqlMensagens.orWithMultipleConditionsSugestao, num);
             }
-            // JOIN without index heuristic (multiple JOINs in query)
             if (/join\s+\w+/i.test(linha)) {
                 adicionar('sql-join-without-index', 'info', messages.DetectorSqlMensagens.joinWithoutIndex, messages.DetectorSqlMensagens.joinWithoutIndexSugestao, num);
             }
-            // ── Best Practices ──────────────────────────────────────────────────
-            // Column without NOT NULL
             if (/^\s*\w+\s+(int|varchar|text|char|decimal|numeric|float|double|boolean|date|timestamp|blob|json)\b/i.test(trim) &&
                 !/\bnot\s+null\b/i.test(linha) &&
                 !/^\s*--|^\s*\/\//.test(trim)) {
                 adicionar('sql-missing-not-null', 'info', messages.DetectorSqlMensagens.missingNotNull, messages.DetectorSqlMensagens.missingNotNullSugestao, num);
             }
-            // Column with NULL default (could have explicit default)
             if (/\bdefault\s+null\b/i.test(linha) &&
                 /^\s*\w+\s+(int|varchar|text|char|decimal|numeric|float|double|boolean|date|timestamp)\b/i.test(trim)) {
                 adicionar('sql-missing-default', 'info', messages.DetectorSqlMensagens.missingDefault, messages.DetectorSqlMensagens.missingDefaultSugestao, num);
             }
-            // AUTO_INCREMENT not used as PK
             if (/\bauto_increment\b/i.test(linha) && !/\bprimary\s+key\b/i.test(linha)) {
                 adicionar('sql-auto-increment-without-pk', 'aviso', messages.DetectorSqlMensagens.autoIncrementWithoutPK, messages.DetectorSqlMensagens.autoIncrementWithoutPKSugestao, num);
             }
-            // TEXT where VARCHAR would suffice (TEXT for short columns)
             if (/\btext\b/i.test(linha) && !/^\s*(--|\/\/)/.test(trim)) {
                 adicionar('sql-text-instead-of-varchar', 'info', messages.DetectorSqlMensagens.textInsteadOfVarchar, messages.DetectorSqlMensagens.textInsteadOfVarcharSugestao, num);
             }
-            // FLOAT for currency
             if (/\bfloat\b/i.test(linha) &&
                 /(preco|price|valor|value|salario|salary|custo|cost|total|amount|money|revenue|receita)/i.test(linha)) {
                 adicionar('sql-float-for-currency', 'aviso', messages.DetectorSqlMensagens.floatForCurrency, messages.DetectorSqlMensagens.floatForCurrencySugestao, num);
             }
-            // Missing UNIQUE constraint on likely-identifier columns
             if (/\b(cpf|cnpj|email|username|login|slug|document|documento|rg|passport|uuid)\b/i.test(linha) &&
                 /^\s*\w+\s+(varchar|char|text)\b/i.test(trim) &&
                 !/\bunique\b/i.test(linha)) {
                 adicionar('sql-missing-unique', 'aviso', messages.DetectorSqlMensagens.missingUniqueConstraint, messages.DetectorSqlMensagens.missingUniqueConstraintSugestao, num);
             }
-            // Missing FOREIGN KEY (column named *_id or id_*)
             if (/\b\w+_id\b/i.test(linha) &&
                 /^\s*\w+_id\s+(int|bigint|uuid|varchar)\b/i.test(trim) &&
                 !/\bforeign\s+key\b/i.test(linha) &&
                 !/\breferences\b/i.test(linha)) {
                 adicionar('sql-missing-foreign-key', 'info', messages.DetectorSqlMensagens.missingForeignKey, messages.DetectorSqlMensagens.missingForeignKeySugestao, num);
             }
-            // ── ORM-specific ────────────────────────────────────────────────────
             if (isOrm) {
-                // Lazy load in loop (N+1) — query inside for/forEach/while
                 if (/\b(for|forEach|while)\b/i.test(linha) &&
                     /\b(find|query|select|getOne|findOne|findMany|findAll)\b/i.test(linha)) {
                     adicionar('sql-eager-loading-missing', 'erro', messages.DetectorSqlMensagens.eagerLoadingMissing, messages.DetectorSqlMensagens.eagerLoadingMissingSugestao, num);
                 }
-                // Single transaction with many operations
                 if (/\btransaction|$transaction/i.test(linha) &&
                     /(insert|create|save|update|delete|remove)/i.test(linha)) {
                     adicionar('sql-transaction-too-large', 'aviso', messages.DetectorSqlMensagens.transactionTooLarge, messages.DetectorSqlMensagens.transactionTooLargeSugestao, num);
                 }
             }
         });
-        // ── Cross-line checks ─────────────────────────────────────────────────
         const _srcLower = src.toLowerCase();
-        // Hardcoded credentials
         linhas.forEach((linha, index) => {
             const num = index + 1;
             if (/\b(password|senha|secret|key|token)\b\s*[:=]\s*['"].*['"]/i.test(linha) ||
@@ -174,13 +133,11 @@ export const detectorSql = {
                 adicionar('sql-hardcoded-credential', 'erro', messages.DetectorSqlMensagens.hardcodedCredential, messages.DetectorSqlMensagens.hardcodedCredentialSugestao, num);
             }
         });
-        // SELECT *
         linhas.forEach((linha, index) => {
             if (/\bselect\s+\*\s+from\b/i.test(linha)) {
                 adicionar('sql-select-star', 'aviso', messages.DetectorSqlMensagens.selectStar, messages.DetectorSqlMensagens.selectStarSugestao, index + 1);
             }
         });
-        // DELETE/UPDATE without WHERE
         linhas.forEach((linha, index) => {
             const num = index + 1;
             const lc = linha.trim().toLowerCase();
@@ -192,26 +149,22 @@ export const detectorSql = {
                 }
             }
         });
-        // TRUNCATE
         linhas.forEach((linha, index) => {
             if (/\btruncate\s+table\b/i.test(linha)) {
                 adicionar('sql-truncate', 'aviso', messages.DetectorSqlMensagens.truncate, messages.DetectorSqlMensagens.truncateSugestao, index + 1);
             }
         });
-        // Missing IF NOT EXISTS
         linhas.forEach((linha, index) => {
             if (/create\s+(table|procedure|view)\s+\w+/i.test(linha) &&
                 !/if\s+not\s+exists/i.test(linha)) {
                 adicionar('sql-missing-if-not-exists', 'info', messages.DetectorSqlMensagens.missingIfNotExists, messages.DetectorSqlMensagens.missingIfNotExistsSugestao, index + 1);
             }
         });
-        // VARCHAR without size
         linhas.forEach((linha, index) => {
             if (/\bvarchar\b\s*(\(|\s|$)/i.test(linha) && !/\bvarchar\(\d+\)/i.test(linha)) {
                 adicionar('sql-varchar-without-size', 'info', messages.DetectorSqlMensagens.varcharWithoutSize, messages.DetectorSqlMensagens.varcharWithoutSizeSugestao, index + 1);
             }
         });
-        // N+1 heuristic: many SELECTs in sequence
         let selectCount = 0;
         for (const linha of linhas) {
             if (/\bselect\b/i.test(linha)) {
@@ -224,7 +177,6 @@ export const detectorSql = {
                 adicionar('sql-n-plus-one', 'aviso', messages.DetectorSqlMensagens.selectNPlusOne, messages.DetectorSqlMensagens.selectNPlusOneSugestao, firstSelect + 1);
             }
         }
-        // No-index columns heuristic: columns in WHERE that look like non-PK text fields
         const whereCols = new Set();
         for (const linha of linhas) {
             const whereMatch = linha.match(/\bwhere\s+(.+)/i);
@@ -240,7 +192,6 @@ export const detectorSql = {
                 }
             }
         }
-        // Run registered plugin detectors
         for (const detector of detectoresRegistrados) {
             try {
                 const resultado = detector.testar(src, { relPath, linhas });
@@ -249,11 +200,9 @@ export const detectorSql = {
                 }
             }
             catch {
-                // Silently skip detector errors
             }
         }
         return ocorrencias;
     }
 };
-/** Backward-compat alias */
 export const detectorSqlBestPractices = detectorSql;

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

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

package/dist/analysts/sql/index.js

@@ -1,9 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * [BUSCA] Analistas de SQL
- *
- * Analisa arquivos SQL em busca de injeções, performance ruim e comandos perigosos.
- */
 export * from './analysts/analyst-sql.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';

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

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

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

@@ -1,13 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// 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);
@@ -24,10 +14,8 @@ 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;
-    // 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;
@@ -35,7 +23,6 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push(`${hardcodedCreds} credencial(is) hardcoded`);
     }
-    // No SQL injection patterns (8 pts)
     const concatPatterns = (src.match(/\s\+\s*['"`].*?(select|insert|update|delete)/gi) ?? []).length;
     if (concatPatterns === 0) {
         seguranca += 8;
@@ -43,7 +30,6 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push(`${concatPatterns} padrão(ões) de concatenação SQL`);
     }
-    // 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;
@@ -55,14 +41,12 @@ 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;
@@ -74,7 +58,6 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push('Instruções sem transação');
     }
-    // No dynamic WHERE/ORDER BY/LIMIT (5 pts)
     const dynamicPatterns = (src.match(/\$\{.*\}.*(where|order by|limit|offset)/gi) ?? []).length;
     if (dynamicPatterns === 0) {
         seguranca += 5;
@@ -82,10 +65,8 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push(`${dynamicPatterns} padrão(ões) de SQL dinâmico`);
     }
-    // ── Performance (30 pontos) ────────────────────────────────────────────
     let performance = 0;
     const maxPerformance = 30;
-    // No SELECT * (8 pts)
     const selectStar = (src.match(/\bselect\s+\*\s+from/gi) ?? []).length;
     if (selectStar === 0) {
         performance += 8;
@@ -94,7 +75,6 @@ export function pontuarSqlDetalhado(src, _relPath) {
         performance += Math.max(0, 8 - selectStar * 3);
         issues.push(`${selectStar} SELECT * detectado(s)`);
     }
-    // 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;
@@ -102,14 +82,12 @@ export function pontuarSqlDetalhado(src, _relPath) {
     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');
     }
-    // No excessive OR (4 pts)
     const linhasComOr = linhas.filter(linha => (linha.match(/\bor\b/gi) ?? []).length >= 3).length;
     if (linhasComOr === 0) {
         performance += 4;
@@ -117,7 +95,6 @@ export function pontuarSqlDetalhado(src, _relPath) {
     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;
@@ -125,7 +102,6 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else if (/\bjoin\b/i.test(src)) {
         issues.push('JOIN sem índice mencionado');
     }
-    // No N+1 pattern (3 pts)
     const selectStatements = (src.match(/\bselect\b/gi) ?? []).length;
     if (selectStatements <= 5) {
         performance += 3;
@@ -133,10 +109,8 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push(`${selectStatements} consultas SELECT - possível N+1`);
     }
-    // ── Boas Práticas (30 pontos) ──────────────────────────────────────────
     let boasPraticas = 0;
     const maxBoasPraticas = 30;
-    // 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;
@@ -144,7 +118,6 @@ export function pontuarSqlDetalhado(src, _relPath) {
     else {
         issues.push(`${varcharNoSize} VARCHAR sem tamanho`);
     }
-    // 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) {
@@ -153,14 +126,12 @@ export function pontuarSqlDetalhado(src, _relPath) {
     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');
     }
-    // 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) {
@@ -169,14 +140,12 @@ export function pontuarSqlDetalhado(src, _relPath) {
     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;
@@ -184,7 +153,6 @@ 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;
     }

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

@@ -2,14 +2,12 @@ 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 // AUMENTADO: CLIs com bin/ são muito específicas
+        pesoBase: 1.5
     }, {
         nome: 'landing-page',
         descricao: 'Aplicação web simples (frontend) com pages/ e components/',
@@ -17,7 +15,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 // Mantido neutro
+        pesoBase: 1.0
     }, {
         nome: 'api-rest-express',
         descricao: 'API REST em Express com controllers/ e estrutura backend',
@@ -26,30 +24,26 @@ 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 // Aumentado pois é um padrão muito específico e maduro
+        pesoBase: 1.3
     }, {
         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 // Aumentado pois combina frontend + backend + banco
+        pesoBase: 1.4
     }, {
         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 // REDUZIDO: bots são mais simples e podem gerar false positives
+        pesoBase: 0.8
     }, {
         nome: 'electron',
         descricao: 'Aplicação Electron com main process e renderer',
@@ -58,9 +52,8 @@ 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 // Aumentado pois tem estrutura específica
+        pesoBase: 1.2
     }, {
         nome: 'lib-tsc',
         descricao: 'Biblioteca TypeScript compilada com estrutura organizada',
@@ -68,10 +61,9 @@ 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 // Mantido neutro
+        pesoBase: 1.0
     }, {
         nome: 'monorepo-packages',
         descricao: 'Monorepo com packages/ e workspaces (pnpm/npm/yarn)',
@@ -79,9 +71,8 @@ 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 // Aumentado pois é uma arquitetura mais complexa
+        pesoBase: 1.5
     }, {
         nome: 'vue-spa',
         descricao: 'SPA Vue.js com components/, views/ e estrutura moderna',
@@ -90,7 +81,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 // Estrutura específica mas comum
+        pesoBase: 1.2
     }, {
         nome: 'clean-arch',
         descricao: 'Clean Architecture (Arquitetura Limpa) com domínio, aplicação, infraestrutura e apresentação',
@@ -100,7 +91,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 // Estrutura sofisticada e específica
+        pesoBase: 1.5
     }, {
         nome: 'microservices',
         descricao: 'Arquitetura Distribuída em Microsserviços com boundaries e comunicação assíncrona',
@@ -110,7 +101,7 @@ 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 // Arquitetura mais complexa e distribuída
+        pesoBase: 1.6
     }];
 export function normalizarCaminho(caminho) {
     return caminho.replace(/\\/g, '/');

package/dist/analysts/strategists/index.js

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

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

@@ -1,6 +1,3 @@
-// @mahoraga-disable tipo-literal-inline-complexo ml-deep-nesting
-// SPDX-License-Identifier: MIT
-// 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';
@@ -8,9 +5,6 @@ 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) {
@@ -37,13 +31,9 @@ export const OperarioEstrutura = {
                 }
             }
         }
-        // 2) Fallback (ou preferido): estrategista
         try {
             try {
-                // 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 sinaisAvancados = extrairSinaisAvancados(fileEntriesComAst, undefined, undefined, baseDir, fileEntriesComAst.map(arquivo => arquivo.relPath));
                 const planoAlt = await gerarPlanoEstrategico({
                     arquivos: fileEntriesComAst,
                     baseDir
@@ -53,8 +43,7 @@ export const OperarioEstrutura = {
                     ...(opcoes.preset ? {
                         preset: opcoes.preset
                     } : {})
-                }, sinaisAvancados // Passar sinais avançados para inteligência contextual
-                );
+                }, sinaisAvancados);
                 return {
                     plano: planoAlt,
                     origem: 'estrategista'
@@ -100,7 +89,6 @@ 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?.length) {