@mocoto/mahoraga 0.14.8 → 0.14.9

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

@@ -1,9 +1,6 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
-// ─── Plugin Registration System ───────────────────────────────────────────────
 const detectoresRegistrados = [];
 export function registrarDetectorShell(detector) {
     detectoresRegistrados.push(detector);
@@ -24,8 +21,6 @@ export const detectorShellSecurity = {
         const linhas = splitLines(src);
         const _srcCompleto = src.toLowerCase();
         const shebang = linhas.length > 0 ? linhas[0] : '';
-        // ── Security ────────────────────────────────────────────────────────────────
-        // Shebang
         if (linhas.length > 0 && !shebang.startsWith('#!')) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-shebang',
@@ -36,7 +31,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingShebangSugestao
             }));
         }
-        // set -e / pipefail
         if (!/set\s+(-e|-o\s+pipefail)/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-set-e',
@@ -47,7 +41,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingSetESugestao
             }));
         }
-        // pipefail only (set -e present, -o pipefail missing)
         if (/set\s+-e/.test(src) && !/set\s+-o\s+pipefail/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-unsafe-pipefail',
@@ -58,7 +51,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.unsafePipefailSugestao
             }));
         }
-        // set -u (treat unset variables as error)
         if (!/set\s+-u/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-set-u',
@@ -69,7 +61,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingSetUSugestao
             }));
         }
-        // IFS=$'\n\t'
         if (!/IFS=/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-ifs',
@@ -80,7 +71,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingIsoSugestao
             }));
         }
-        // Trap handler
         if (!/\btrap\s+/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-trap',
@@ -91,7 +81,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingTrapSugestao
             }));
         }
-        // Main function pattern
         if (!/main\s*\(\s*\)/.test(src) && !/^main\s*\(/m.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-main-fn',
@@ -102,7 +91,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingMainFnSugestao
             }));
         }
-        // Hardcoded paths without command -v
         if (/(\/usr\/bin\/|\/bin\/|\/usr\/local\/bin\/)/.test(src) && !/command\s+-v/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-command-v',
@@ -113,7 +101,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingCommandVSugestao
             }));
         }
-        // DEBUG mode
         if (!/\$\{DEBUG[^}]*\}/.test(src) && !/\$DEBUG\b/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-debug-mode',
@@ -124,7 +111,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingDebugModeSugestao
             }));
         }
-        // Input validation
         if (/\$[0-9@*]/.test(src) && !/\[\[ -z "\$[0-9@*]/.test(src) && !/\[ -z "\$[0-9@*]/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shell-missing-input-validation',
@@ -135,7 +121,6 @@ export const detectorShellSecurity = {
                 sugestao: messages.DetectorShellMensagens.missingInputValidationSugestao
             }));
         }
-        // ShellCheck recommendation (only if script is non-trivial)
         if (linhas.length > 10 && !src.includes('shellcheck')) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'shellcheck-recommended',
@@ -153,7 +138,6 @@ export const detectorShellSecurity = {
             if (linhaTrim.startsWith('#')) {
                 return;
             }
-            // ── Security: eval ──────────────────────────────────────────────────────
             if (/\beval\s+/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-eval-usage',
@@ -164,7 +148,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.evalUsageSugestao
                 }));
             }
-            // ── Security: rm -rf / ───────────────────────────────────────────────────
             if (/\brm\s+-rf\s+\/(\s|$)/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-rm-rf-root',
@@ -175,7 +158,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.rmRfRootSugestao
                 }));
             }
-            // ── Security: curl|sh ──────────────────────────────────────────────────
             if (/(curl|wget).*\|\s*(ba)?sh/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-curl-pipe-sh',
@@ -186,7 +168,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.curlPipeShSugestao
                 }));
             }
-            // ── Security: Hardcoded credentials ────────────────────────────────────
             if (/\b(password|pass|secret|token)\b\s*=\s*['"].*['"]/i.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-hardcoded-password',
@@ -197,7 +178,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.hardcodedPasswordSugestao
                 }));
             }
-            // ── Security: Unquoted variables ────────────────────────────────────────
             if (/\b(echo|ls|cd|rm|cp|mv)\s+.*\$\w+/.test(linha) && !/["'].*\$\w+.*["']/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-unquoted-variable',
@@ -208,7 +188,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.unquotedVariableSugestao
                 }));
             }
-            // ── Security: sudo ──────────────────────────────────────────────────────
             if (/\bsudo\s+/.test(linha) && !relPath.includes('setup') && !relPath.includes('install')) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-sudo-usage',
@@ -219,7 +198,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.sudoUsageSugestao
                 }));
             }
-            // ── Security: cd without check ──────────────────────────────────────────
             if (/^\s*cd\s+\S+/.test(linha) && !/cd\s+\S+\s*(;|&&|\|\|)/.test(linha) && !linha.includes('|| exit') && !linha.includes('|| return') && !linha.includes('|| true')) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-cd-without-check',
@@ -230,7 +208,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.unsafeCdWithoutCheckSugestao
                 }));
             }
-            // ── Security: /tmp without mktemp ───────────────────────────────────────
             if (/["']\/tmp\/\w+\.\w+["']/.test(linha) || />\s*\/tmp\/\w+/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-unsafe-tmp-file',
@@ -241,7 +218,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.unsafeTmpFileSugestao
                 }));
             }
-            // ── Security: Insecure permissions ──────────────────────────────────────
             if (/\bchmod\s+777\b/.test(linha) || /\bumask\s+000\b/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-insecure-permissions',
@@ -252,7 +228,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.insecurePermissionsSugestao
                 }));
             }
-            // ── Security: Dangerous flags ──────────────────────────────────────────
             if (/\bchown\s+-R\s+\//.test(linha) || /\brm\s+-rf\s+\/\*/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-dangerous-flags',
@@ -263,7 +238,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.dangerousFlagsSugestao
                 }));
             }
-            // ── Security: read without -r ──────────────────────────────────────────
             if (/^\s*read\s+(?!-r)/.test(linha) && /^\s*read\s+\w+/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-read-without-r',
@@ -274,9 +248,7 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.unsafeReadWithoutRSugestao
                 }));
             }
-            // ── Best Practices: Missing local in function ────────────────────────────
             if (/^\s*\w+\s*\(\)\s*\{/.test(linha) || (/^\s*function\s+\w+\s*\{/.test(linha) && linhas.slice(index + 1).some(l => /^\s*local\s+\w+/.test(l)))) {
-                // Check if next lines have variables without local
                 const _inFunc = true;
                 let braceCount = 0;
                 for (let j = index + 1; j < Math.min(index + 30, linhas.length); j++) {
@@ -305,7 +277,6 @@ export const detectorShellSecurity = {
                     }
                 }
             }
-            // ── Best Practices: Local var with UPPERCASE ────────────────────────────
             if (/^\s*local\s+[A-Z_]+\w*=/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-uppercase-local-var',
@@ -316,7 +287,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.uppercaseLocalVarSugestao
                 }));
             }
-            // ── Best Practices: Backtick command substitution ──────────────────────
             if (/`[^`]+`/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-backtick-cmd-sub',
@@ -327,7 +297,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.backtickCmdSubSugestao
                 }));
             }
-            // ── Best Practices: [ vs [[ (only in Bash scripts) ─────────────────────
             if (!isSh && /^\s*\[[^\]]+\]/.test(linha) && !/^\s*\[\[/.test(linha) && !linha.includes('"$') && !/\[\s*-[a-z]\s+\S+\s*\]/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-double-bracket-missing',
@@ -338,7 +307,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.doubleBracketMissingSugestao
                 }));
             }
-            // ── Best Practices: let / expr vs $(( )) ────────────────────────────────
             if (/^\s*let\s+/.test(linha) || /^\s*expr\s+/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-unsafe-arithmetic-eval',
@@ -349,7 +317,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.unsafeArithmeticEvalSugestao
                 }));
             }
-            // ── Best Practices: function keyword ────────────────────────────────────
             if (/^\s*function\s+\w+\s*(\{|\(|$)/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-function-decl-style',
@@ -360,7 +327,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.functionDeclStyleSugestao
                 }));
             }
-            // ── Best Practices: Case without default ────────────────────────────────
             if (/^\s*case\s+.+\s+in/.test(linha)) {
                 let hasDefault = false;
                 for (let j = index + 1; j < linhas.length; j++) {
@@ -384,7 +350,6 @@ export const detectorShellSecurity = {
                     }));
                 }
             }
-            // ── Best Practices: Empty then/else block ───────────────────────────────
             if (/\bthen\s*$/.test(linha) || /\belse\s*$/.test(linha)) {
                 let empty = false;
                 for (let j = index + 1; j < Math.min(index + 5, linhas.length); j++) {
@@ -408,7 +373,6 @@ export const detectorShellSecurity = {
                     }));
                 }
             }
-            // ── Portability: Bashism in sh script ──────────────────────────────────
             if (isSh) {
                 if (/^\s*function\s/.test(linha) || /\[\[/.test(linha) || /<\<\</.test(linha) || /\$\{.*\/\/.*\}/.test(linha) || /\$\{.*,.*\}/.test(linha) || /\$\{!/.test(linha) || /shopt\s/.test(linha)) {
                     ocorrencias.push(criarOcorrencia({
@@ -421,7 +385,6 @@ export const detectorShellSecurity = {
                     }));
                 }
             }
-            // ── Portability: Platform-specific path ─────────────────────────────────
             if (/\/(usr\/bin|usr\/local\/bin|bin|sbin)\//.test(linha) && !linha.startsWith('#')) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-platform-specific-path',
@@ -432,7 +395,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.platformSpecificPathSugestao
                 }));
             }
-            // ── Portability: Unquoted array expansion ──────────────────────────────
             if (/\$\{\w+\[@\]\}/.test(linha) && !/["'].*\$\{\w+\[@\]\}.*["']/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-missing-quote-arrays',
@@ -443,7 +405,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.missingQuoteArraysSugestao
                 }));
             }
-            // ── Performance: Useless cat ──────────────────────────────────────────
             if (/\bcat\s+\S+\s*\|\s*/.test(linha) && !/\bcat\s+.*\|cat\b/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-useless-cat',
@@ -454,7 +415,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.uselessCatSugestao
                 }));
             }
-            // ── Performance: Loop over ls ──────────────────────────────────────────
             if (/for\s+\w+\s+in\s+\$\(ls\)/.test(linha) || /for\s+\w+\s+in\s+`ls`/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-loop-over-command-output',
@@ -465,7 +425,6 @@ export const detectorShellSecurity = {
                     sugestao: messages.DetectorShellMensagens.loopOverCommandOutputSugestao
                 }));
             }
-            // ── Performance: Temp file could be pipe ───────────────────────────────
             if (/>\s*\S+\.tmp\b/.test(linha) && /<\s*\S+\.tmp\b/.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'shell-pipe-over-tempfile',
@@ -477,7 +436,6 @@ export const detectorShellSecurity = {
                 }));
             }
         });
-        // Run registered plugin detectors
         for (const detector of detectoresRegistrados) {
             try {
                 const resultado = await detector.testar(src, { relPath, linhas });
@@ -486,7 +444,6 @@ export const detectorShellSecurity = {
                 }
             }
             catch {
-                // Silently skip plugin errors
             }
         }
         return ocorrencias;

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

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

package/dist/analysts/shell/index.js

@@ -1,9 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * [BUSCA] Analistas de Shell Script
- *
- * Analisa scripts Shell em busca de comandos perigosos, insegurança e falta de boas práticas.
- */
 export * from './analysts/analyst-shell.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';

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

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

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

@@ -1,15 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * [GRAFICO] Pontuador de qualidade Shell Script
- *
- * Avalia a qualidade do Shell baseado em:
- * - Segurança
- * - Error handling
- * - Boas práticas
- * - Portabilidade
- * - Performance
- */
 import { splitLines } from '../../../shared/helpers/index.js';
 export function pontuarShell(src, _relPath) {
     let score = 0;
@@ -18,7 +6,6 @@ export function pontuarShell(src, _relPath) {
     const strengths = [];
     const linhas = splitLines(src);
     const srcCompleto = src;
-    // Shebang (10 pontos)
     if (linhas.length > 0 && linhas[0].startsWith('#!')) {
         score += 10;
         strengths.push('Shebang presente');
@@ -26,7 +13,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Shebang ausente');
     }
-    // set -e / pipefail (15 pontos)
     if (/set\s+(-e|-o\s+pipefail)/.test(srcCompleto)) {
         score += 15;
         strengths.push('Error handling configurado');
@@ -34,7 +20,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Sem set -e / pipefail');
     }
-    // set -u (10 pontos)
     if (/set\s+-u/.test(srcCompleto)) {
         score += 10;
         strengths.push('Strict mode (set -u)');
@@ -42,7 +27,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Sem set -u');
     }
-    // IFS (5 pontos)
     if (/IFS=/.test(srcCompleto)) {
         score += 5;
         strengths.push('IFS configurado');
@@ -50,7 +34,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Sem IFS');
     }
-    // trap handler (10 pontos)
     if (/\btrap\s+/.test(srcCompleto)) {
         score += 10;
         strengths.push('Cleanup handler presente');
@@ -58,7 +41,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Sem trap handler');
     }
-    // No eval (15 pontos)
     if (!/\beval\s+/.test(srcCompleto)) {
         score += 15;
         strengths.push('Sem eval');
@@ -66,7 +48,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('eval detectado');
     }
-    // No curl|sh (10 pontos)
     if (!/(curl|wget).*\|\s*(ba)?sh/.test(srcCompleto)) {
         score += 10;
         strengths.push('Sem curl|sh');
@@ -74,7 +55,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('curl|sh detectado');
     }
-    // No hardcoded passwords (10 pontos)
     const hardcodedPasswords = (srcCompleto.match(/\b(password|pass|secret|token)\b\s*=\s*['"]/gi) ?? []).length;
     if (hardcodedPasswords === 0) {
         score += 10;
@@ -83,7 +63,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push(`${hardcodedPasswords} senha(s) hardcoded`);
     }
-    // Quoted variables (10 pontos)
     const unquotedVars = (srcCompleto.match(/\b(echo|ls|cd|rm|cp|mv)\s+.*\$\w+/g) ?? []).filter(linha => !/["'].*\$\w+.*["']/.test(linha)).length;
     if (unquotedVars === 0) {
         score += 10;
@@ -93,7 +72,6 @@ export function pontuarShell(src, _relPath) {
         score += Math.max(0, 10 - unquotedVars * 3);
         issues.push(`${unquotedVars} variável(is) sem aspas`);
     }
-    // No rm -rf / (10 pontos)
     if (!/\brm\s+-rf\s+\/(\s|$)/.test(srcCompleto)) {
         score += 10;
         strengths.push('Sem rm -rf /');
@@ -101,8 +79,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('rm -rf / detectado!');
     }
-    // ── Security (enhanced) ──────────────────────────────────────────────────
-    // cd with check (5 pontos)
     const cds = srcCompleto.match(/^\s*cd\s+\S+/gm) ?? [];
     const cdsChecked = cds.filter(c => /cd\s+\S+\s*(;|&&|\|\|)/.test(c) || c.includes('|| exit') || c.includes('|| return')).length;
     if (cds.length === 0 || cdsChecked === cds.length) {
@@ -112,7 +88,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push(`${cds.length - cdsChecked} cd(s) sem verificação`);
     }
-    // mktemp usage (5 pontos)
     if (/\bmktemp\b/.test(srcCompleto) || !/\/tmp\/\w+\.\w+/.test(srcCompleto)) {
         score += 5;
         strengths.push('Sem arquivos tmp inseguros');
@@ -120,7 +95,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Uso inseguro de /tmp');
     }
-    // Permissions (5 pontos)
     if (!/\bchmod\s+777\b/.test(srcCompleto) && !/\bumask\s+000\b/.test(srcCompleto)) {
         score += 5;
         strengths.push('Permissões seguras');
@@ -128,7 +102,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Permissões inseguras (chmod 777/umask 000)');
     }
-    // read -r (5 pontos)
     const reads = srcCompleto.match(/^\s*read\s+/gm) ?? [];
     const readsWithR = reads.filter(r => /^\s*read\s+-r/.test(r)).length;
     if (reads.length === 0 || readsWithR === reads.length) {
@@ -138,8 +111,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push(`${reads.length - readsWithR} read(s) sem -r`);
     }
-    // ── Best Practices ───────────────────────────────────────────────────────
-    // local variables (10 pontos)
     const functions = (srcCompleto.match(/(\w+)\s*\(\s*\)/g) ?? []).length;
     const locals = (srcCompleto.match(/\blocal\s+/g) ?? []).length;
     if (functions === 0 || locals >= functions) {
@@ -150,7 +121,6 @@ export function pontuarShell(src, _relPath) {
         score += Math.max(0, 10 - (functions - locals) * 3);
         issues.push(`${functions - locals} função(ões) sem local variables`);
     }
-    // No backticks (5 pontos)
     if (!/`[^`]+`/.test(srcCompleto)) {
         score += 5;
         strengths.push('Sem crases');
@@ -158,7 +128,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Substituição com crases');
     }
-    // [[ instead of [ (5 pontos)
     if (!/^\s*\[[^\]]+\]/.test(srcCompleto) || /\[\[/.test(srcCompleto)) {
         score += 5;
         strengths.push('Uso de [[ para testes');
@@ -166,7 +135,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('[ usado em vez de [[');
     }
-    // $(( )) for arithmetic (5 pontos)
     if (!/\blet\s+/.test(srcCompleto) && !/^\s*expr\s+/.test(srcCompleto)) {
         score += 5;
         strengths.push('Uso de $(( )) para aritmética');
@@ -174,7 +142,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('let/expr usado em vez de $(( ))');
     }
-    // POSIX function style (5 pontos)
     if (!/^\s*function\s+\w+\s*\{/.test(srcCompleto)) {
         score += 5;
         strengths.push('Sintaxe POSIX de função');
@@ -182,8 +149,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Palavra-chave function usada');
     }
-    // ── Portability ──────────────────────────────────────────────────────────
-    // No bashisms in sh scripts (10 pontos)
     const shebang = linhas.length > 0 ? linhas[0] : '';
     if (!/\/bin\/sh(\s|$)/.test(shebang) || !/\b(function|\[\[|<<<|shopt)\b/.test(srcCompleto)) {
         score += 10;
@@ -192,7 +157,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Bashisms em script sh');
     }
-    // command -v for paths (5 pontos)
     const hardPaths = (srcCompleto.match(/\/(usr\/bin|usr\/local\/bin|bin|sbin)\//g) ?? []).length;
     if (hardPaths === 0) {
         score += 5;
@@ -202,7 +166,6 @@ export function pontuarShell(src, _relPath) {
         score += Math.max(0, 5 - hardPaths);
         issues.push(`${hardPaths} caminho(s) de plataforma fixos`);
     }
-    // Quoted array expansion (5 pontos)
     if (!/\$\{\w+\[@\]\}/.test(srcCompleto) || /"\$\{\w+\[@\]\}"/.test(srcCompleto)) {
         score += 5;
         strengths.push('Arrays com aspas');
@@ -210,8 +173,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Expansão de array sem aspas');
     }
-    // ── Performance ─────────────────────────────────────────────────────────
-    // No useless cat (5 pontos)
     if (!/\bcat\s+\S+\s*\|\s*/.test(srcCompleto)) {
         score += 5;
         strengths.push('Sem cat inútil');
@@ -219,7 +180,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('cat | command detectado');
     }
-    // No loop over ls (5 pontos)
     if (!/for\s+\w+\s+in\s+\$\(ls\)/.test(srcCompleto) && !/for\s+\w+\s+in\s+`ls`/.test(srcCompleto)) {
         score += 5;
         strengths.push('Glob em vez de ls');
@@ -227,7 +187,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Loop sobre ls');
     }
-    // Pipes instead of temp files (5 pontos)
     if (/>\s*\S+\.tmp\b/.test(srcCompleto) && /<\s*\S+\.tmp\b/.test(srcCompleto)) {
         issues.push('Arquivo tmp usado em vez de pipe');
     }
@@ -235,7 +194,6 @@ export function pontuarShell(src, _relPath) {
         score += 5;
         strengths.push('Pipes em vez de tmp files');
     }
-    // Sudo score (5 pontos)
     if (!/\bsudo\s+/.test(srcCompleto)) {
         score += 5;
         strengths.push('Sem sudo');
@@ -243,8 +201,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('sudo detectado');
     }
-    // ── Modern Bash (2026) ──────────────────────────────────────────
-    // main function pattern (5 pontos)
     if (/main\s*\(\s*\)/.test(srcCompleto)) {
         score += 5;
         strengths.push('Função main presente');
@@ -252,7 +208,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Sem padrão de função main');
     }
-    // command -v usage (5 pontos)
     if (hardPaths === 0 || /command\s+-v/.test(srcCompleto)) {
         score += 5;
         strengths.push('Uso de command -v');
@@ -260,7 +215,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Caminhos fixos sem command -v');
     }
-    // DEBUG mode (5 pontos)
     if (/\$\{DEBUG[^}]*\}/.test(srcCompleto) || /\$DEBUG\b/.test(srcCompleto)) {
         score += 5;
         strengths.push('Modo debug presente');
@@ -268,7 +222,6 @@ export function pontuarShell(src, _relPath) {
     else {
         issues.push('Sem modo debug');
     }
-    // Input validation (5 pontos)
     if (/\[\[ -z "\$[0-9@*]/.test(srcCompleto) || /\[ -z "\$[0-9@*]/.test(srcCompleto)) {
         score += 5;
         strengths.push('Validação de input');

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

@@ -1,8 +1,4 @@
 import { criarAnalista, criarOcorrencia } from '../../../types/index.js';
-/**
- * Analista de SQL
- * Detecta práticas inseguras, problemas de performance e má organização em arquivos SQL.
- */
 export const analistaSql = criarAnalista({
     nome: 'analista-sql',
     categoria: 'database',
@@ -14,11 +10,9 @@ export const analistaSql = criarAnalista({
         linhas.forEach((linha, index) => {
             const numeroLinha = index + 1;
             const linhaTrim = linha.trim().toLowerCase();
-            // 1. DELETE/UPDATE sem WHERE (Crítico)
             if ((linhaTrim.startsWith('delete ') || linhaTrim.startsWith('update ')) &&
                 !linhaTrim.includes('where') &&
                 !linha.includes('--') && !linha.includes('/*')) {
-                // Verificar se o WHERE está na próxima linha (heurística simples)
                 const proximaLinha = linhas[index + 1]?.trim().toLowerCase() || '';
                 if (!proximaLinha.includes('where')) {
                     ocorrencias.push(criarOcorrencia({
@@ -31,7 +25,6 @@ export const analistaSql = criarAnalista({
                     }));
                 }
             }
-            // 2. SELECT * (Performance/Manutenibilidade)
             if (/\bselect\s+\*\s+from\b/i.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'problema-performance',
@@ -42,7 +35,6 @@ export const analistaSql = criarAnalista({
                     sugestao: 'Liste explicitamente as colunas necessárias.'
                 }));
             }
-            // 3. Senhas ou segredos em scripts (Segurança)
             if (/\b(password|senha|secret|key|token|credential)\b\s*[:=]\s*['"].*['"]/i.test(linha) ||
                 /identified\s+by\s+['"].*['"]/i.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
@@ -54,7 +46,6 @@ export const analistaSql = criarAnalista({
                     sugestao: 'Utilize variáveis de ambiente ou sistemas de gerenciamento de segredos.'
                 }));
             }
-            // 4. Injeção de SQL via strings concatenadas (se for template ou arquivo de migração dinâmico)
             if (/\s\+\s*['"`].*['"`]/.test(linha) && /select|insert|update|delete/i.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'sql-injection',
@@ -65,7 +56,6 @@ export const analistaSql = criarAnalista({
                     sugestao: 'Utilize consultas parametrizadas ou placeholders.'
                 }));
             }
-            // 5. Tabelas temporárias ou globais sem DROP prévio (Boas Práticas)
             if (/create\s+(table|procedure|view)\s+\w+/i.test(linha) && !/if\s+not\s+exists/i.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'codigo-fragil',
@@ -76,7 +66,6 @@ export const analistaSql = criarAnalista({
                     sugestao: 'Utilize "CREATE TABLE IF NOT EXISTS ..." para maior idempotência.'
                 }));
             }
-            // 6. TRUNCATE TABLE (Risco)
             if (/\btruncate\s+table\b/i.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'vulnerabilidade-seguranca',
@@ -87,7 +76,6 @@ export const analistaSql = criarAnalista({
                     sugestao: 'Certifique-se de que a limpeza total é intencional e prefira DELETE com WHERE se precisar de reversibilidade.'
                 }));
             }
-            // 7. Uso de tipos obsoletos (ex: VARCHAR sem tamanho, TEXT para colunas pequenas)
             if (/\bvarchar\b\s*(\(|\s|$)/i.test(linha) && !/\bvarchar\(\d+\)/i.test(linha)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'codigo-fragil',

package/dist/analysts/sql/corrections/correction-sql.js

@@ -1,13 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * [CHAVE-INGLESA] Correções automáticas para SQL
- *
- * Fornece correções sugeridas para problemas comuns em SQL:
- * - SELECT * → colunas explícitas
- * - DELETE/UPDATE sem WHERE → adicionar WHERE
- * - VARCHAR sem tamanho → definir tamanho
- */
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';

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

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

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

@@ -1,8 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * [BUSCA] Detector de boas práticas SQL (backward compat)
- *
- * Re-exporta do novo detector abrangente.
- * @deprecated Use './detector-sql.js' diretamente.
- */
 export { detectorSql, detectorSqlBestPractices, obterDetectoresSql, registrarDetectorSql, } from './detector-sql.js';