@mocoto/mahoraga 0.14.8 → 0.14.9

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

@@ -1,12 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * [BUSCA] Detector de Boas Práticas para Jenkinsfiles
- */
 import { criarOcorrencia } from '../../../types/index.js';
-/**
- * Detecta stage único com muitos steps.
- */
 function detectarStageMuitosSteps(src) {
     const stageBlocks = src.match(/stage\s*\(['"][^'"]+['"]\)\s*\{([^}]+)\}/gi);
     if (!stageBlocks) {
@@ -27,9 +19,6 @@ function detectarStageMuitosSteps(src) {
     }
     return null;
 }
-/**
- * Detecta variáveis de ambiente fora do bloco environment.
- */
 function detectarEnvForaDoBloco(src) {
     const envVarPattern = /\b(\w+)\s*=\s*['"][^'"]+['"]/g;
     const envBlock = /environment\s*\{/i.test(src);
@@ -50,9 +39,6 @@ function detectarEnvForaDoBloco(src) {
     }
     return null;
 }
-/**
- * Detecta caminhos hardcoded de workspace.
- */
 function detectarHardcodedPath(src) {
     const pathPattern = /['"](?:\/home|\/var\/lib\/jenkins|\/tmp|\/opt|\/usr\/local|\/workspace|\/jenkins).*['"]/i;
     if (pathPattern.test(src)) {
@@ -67,9 +53,6 @@ function detectarHardcodedPath(src) {
     }
     return null;
 }
-/**
- * Detecta parâmetros definidos mas não utilizados no pipeline.
- */
 function detectarParamNaoUsado(src) {
     const paramsBlock = src.match(/parameters\s*\{([^}]+)\}/i);
     if (!paramsBlock) {
@@ -95,9 +78,6 @@ function detectarParamNaoUsado(src) {
     }
     return null;
 }
-/**
- * Detecta pipeline ou stage sem descrição.
- */
 function detectarFaltaDescricao(src) {
     const stageMatches = src.match(/stage\s*\(['"][^'"]+['"]\)\s*\{/gi);
     if (!stageMatches || stageMatches.length === 0) {
@@ -116,9 +96,6 @@ function detectarFaltaDescricao(src) {
     }
     return null;
 }
-/**
- * Detecta archiveArtifacts sem pattern específico.
- */
 function detectarArchiveSemPattern(src) {
     const archivePattern = /archiveArtifacts\s*\(\s*['"][^'"]*['"]\)/i;
     const wildcardPattern = /archiveArtifacts\s*\(\s*['"](?:\*\*\/\*|\*|\.\*)/i;
@@ -147,7 +124,6 @@ export const detectorJenkinsBestPractices = {
             return [];
         }
         const ocorrencias = [];
-        // 1. Falta de Timeout
         if (!/timeout\s*\(.*\)/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'jenkins-missing-timeout',
@@ -158,7 +134,6 @@ export const detectorJenkinsBestPractices = {
                 sugestao: 'Adicione um bloco "options { timeout(time: 30, unit: \'MINUTES\') }" para evitar jobs zumbis'
             }));
         }
-        // 2. Falta de Limpeza de Workspace
         if (!/cleanWs\s*\(\)/i.test(src) && !/deleteDir\s*\(\)/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'jenkins-missing-cleanup',
@@ -169,7 +144,6 @@ export const detectorJenkinsBestPractices = {
                 sugestao: 'Use "cleanWs()" no bloco post { always { ... } } para evitar problemas de disco no agente'
             }));
         }
-        // 3. Pipeline muito longo sem paralelismo
         const stageCount = (src.match(/stage\s*\(/g) ?? []).length;
         if (stageCount > 4 && !/parallel\s*\{/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
@@ -181,37 +155,31 @@ export const detectorJenkinsBestPractices = {
                 sugestao: 'Considere usar o bloco "parallel" para executar testes ou builds independentes simultaneamente'
             }));
         }
-        // 4. Stage length analysis
         const longStageIssue = detectarStageMuitosSteps(src);
         if (longStageIssue) {
             longStageIssue.relPath = relPath;
             ocorrencias.push(longStageIssue);
         }
-        // 5. Environment declaration analysis
         const envIssue = detectarEnvForaDoBloco(src);
         if (envIssue) {
             envIssue.relPath = relPath;
             ocorrencias.push(envIssue);
         }
-        // 6. Hardcoded paths
         const pathIssue = detectarHardcodedPath(src);
         if (pathIssue) {
             pathIssue.relPath = relPath;
             ocorrencias.push(pathIssue);
         }
-        // 7. Parameter usage analysis
         const paramIssue = detectarParamNaoUsado(src);
         if (paramIssue) {
             paramIssue.relPath = relPath;
             ocorrencias.push(paramIssue);
         }
-        // 8. Documentation (descriptions)
         const descIssue = detectarFaltaDescricao(src);
         if (descIssue) {
             descIssue.relPath = relPath;
             ocorrencias.push(descIssue);
         }
-        // 9. Archive pattern analysis
         const archiveIssue = detectarArchiveSemPattern(src);
         if (archiveIssue) {
             archiveIssue.relPath = relPath;

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

@@ -1,12 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * [BUSCA] Detector de Segurança para Jenkinsfiles
- */
 import { criarOcorrencia } from '../../../types/index.js';
-/**
- * Detecta se o pipeline desabilita a sandbox Groovy.
- */
 function detectarSandboxDesabilitado(src) {
     if (/useSandbox\s*{/i.test(src) && !/@NonCPS|@groovy\.transform/i.test(src)) {
         return criarOcorrencia({
@@ -20,9 +12,6 @@ function detectarSandboxDesabilitado(src) {
     }
     return null;
 }
-/**
- * Detecta parâmetros de senha sem mascaramento.
- */
 function detectarPasswordParam(src) {
     const paramPattern = /parameters\s*\{[^}]*password\s*\(/i;
     const maskPattern = /parameters\s*\{[^}]*secret\s*\(/i;
@@ -38,9 +27,6 @@ function detectarPasswordParam(src) {
     }
     return null;
 }
-/**
- * Detecta bindings de credenciais sem mascaramento.
- */
 function detectarCredentialBinding(src) {
     const bindPattern = /withCredentials\(\[[^\]]*\]\)/i;
     const maskHints = /masked|hide|\${\s*[^}]+secret/i;
@@ -56,9 +42,6 @@ function detectarCredentialBinding(src) {
     }
     return null;
 }
-/**
- * Detecta sh/bat com input de usuário não verificado.
- */
 function detectarShEval(src) {
     const shPattern = /\b(sh|bat)\s+['"][^'"]*\$\{?PARAM/i;
     const scmPattern = /\b(sh|bat)\s+['"][^'"]*\$\{?(?:env\.)?(?:BRANCH|TAG|CHANGE|PR)_/i;
@@ -74,9 +57,6 @@ function detectarShEval(src) {
     }
     return null;
 }
-/**
- * Detecta agente sem isolamento container/podTemplate.
- */
 function detectarAgentIsolation(src) {
     if (/agent\s+\{/i.test(src)) {
         const hasContainer = /container\s*\{/i.test(src);
@@ -94,9 +74,6 @@ function detectarAgentIsolation(src) {
     }
     return null;
 }
-/**
- * Detecta shared library sem version pinning.
- */
 function detectarSharedLibraryPinning(src) {
     const libPattern = /library\s+['"][^'"]+['"]\s*$/im;
     const pinnedPattern = /library\s+['"][^'"]+@[a-f0-9]{7,40}['"]/i;
@@ -122,7 +99,6 @@ export const detectorJenkinsSecurity = {
             return [];
         }
         const ocorrencias = [];
-        // 1. Uso de sudo
         if (/\bsh\s+['"].*sudo\b/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'jenkins-dangerous-sudo',
@@ -133,7 +109,6 @@ export const detectorJenkinsSecurity = {
                 sugestao: 'Configure permissões no Jenkins Agent ou use Docker containers para evitar necessidade de sudo'
             }));
         }
-        // 2. Docker latest
         if (/image\s*['"]?.*:latest['"]?/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'jenkins-docker-latest',
@@ -144,7 +119,6 @@ export const detectorJenkinsSecurity = {
                 sugestao: 'Use uma tag de versão fixa para garantir reprodutibilidade do build'
             }));
         }
-        // 3. Credenciais Hardcoded
         if (/\b(password|token|secret)\s*=\s*['"][^$({][^'"]{5,}['"]/i.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'jenkins-hardcoded-secrets',
@@ -155,37 +129,31 @@ export const detectorJenkinsSecurity = {
                 sugestao: 'Use a função credentials(\'ID\') do Jenkins para injetar segredos com segurança'
             }));
         }
-        // 4. Groovy sandbox detection
         const sandboxIssue = detectarSandboxDesabilitado(src);
         if (sandboxIssue) {
             sandboxIssue.relPath = relPath;
             ocorrencias.push(sandboxIssue);
         }
-        // 5. Password parameter masking
         const passwordIssue = detectarPasswordParam(src);
         if (passwordIssue) {
             passwordIssue.relPath = relPath;
             ocorrencias.push(passwordIssue);
         }
-        // 6. Credential binding exposure
         const credIssue = detectarCredentialBinding(src);
         if (credIssue) {
             credIssue.relPath = relPath;
             ocorrencias.push(credIssue);
         }
-        // 7. Sh/bat with user input
         const shIssue = detectarShEval(src);
         if (shIssue) {
             shIssue.relPath = relPath;
             ocorrencias.push(shIssue);
         }
-        // 8. Agent isolation
         const isolationIssue = detectarAgentIsolation(src);
         if (isolationIssue) {
             isolationIssue.relPath = relPath;
             ocorrencias.push(isolationIssue);
         }
-        // 9. Shared library version pinning
         const libIssue = detectarSharedLibraryPinning(src);
         if (libIssue) {
             libIssue.relPath = relPath;

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

@@ -1,9 +1,5 @@
-// SPDX-License-Identifier: MIT
 import { criarOcorrencia } from '../../../types/index.js';
 const STAGES_SUGERIDOS = ['Checkout', 'Build', 'Test', 'Deploy'];
-/**
- * Detecta mistura de padrões declarativos e scripted.
- */
 function detectarEstilosMisturados(src) {
     const hasDeclarative = /pipeline\s*\{/i.test(src);
     const hasScripted = /node\s*\{/i.test(src);
@@ -19,9 +15,6 @@ function detectarEstilosMisturados(src) {
     }
     return null;
 }
-/**
- * Detecta presença de post{always}.
- */
 function detectarPostAlways(src) {
     if (/post\s*\{/i.test(src) && !/always\s*\{/i.test(src)) {
         return criarOcorrencia({
@@ -35,9 +28,6 @@ function detectarPostAlways(src) {
     }
     return null;
 }
-/**
- * Detecta post{failure} ausente.
- */
 function detectarPostFailure(src) {
     if (/post\s*\{/i.test(src) && !/failure\s*\{/i.test(src)) {
         return criarOcorrencia({
@@ -51,9 +41,6 @@ function detectarPostFailure(src) {
     }
     return null;
 }
-/**
- * Detecta muitos stages em um único pipeline.
- */
 function detectarMuitosStages(src, stageCount) {
     if (stageCount > 8) {
         return criarOcorrencia({
@@ -67,9 +54,6 @@ function detectarMuitosStages(src, stageCount) {
     }
     return null;
 }
-/**
- * Detecta parallel sem failFast.
- */
 function detectarParallelFailFast(src) {
     if (/parallel\s*\{/i.test(src) && !/failFast\s*(true|false)/i.test(src)) {
         return criarOcorrencia({
@@ -83,9 +67,6 @@ function detectarParallelFailFast(src) {
     }
     return null;
 }
-/**
- * Detecta stage sem when conditions.
- */
 function detectarStageSemWhen(src) {
     const stageMatches = src.match(/stage\s*\(/g);
     const whenMatches = src.match(/when\s*\{/g);
@@ -101,9 +82,6 @@ function detectarStageSemWhen(src) {
     }
     return null;
 }
-/**
- * Detecta tools sem versão explícita.
- */
 function detectarToolsSemVersao(src) {
     const toolsBlock = src.match(/tools\s*\{([^}]+)\}/i);
     if (toolsBlock) {
@@ -121,9 +99,6 @@ function detectarToolsSemVersao(src) {
     }
     return null;
 }
-/**
- * Detecta agent sem label (any).
- */
 function detectarAgentSemLabel(src) {
     if (/agent\s+any/i.test(src)) {
         return criarOcorrencia({
@@ -150,7 +125,6 @@ export const detectorJenkinsEstrutura = {
         if (!/pipeline\s*\{/i.test(src) && !/node\s*\{/i.test(src)) {
             return ocorrencias;
         }
-        // --- Mixed style detection ---
         const mixedIssue = detectarEstilosMisturados(src);
         if (mixedIssue) {
             mixedIssue.relPath = relPath;
@@ -176,7 +150,6 @@ export const detectorJenkinsEstrutura = {
                 }));
             }
         }
-        // --- Post condition analysis ---
         if (/post\s*\{/i.test(src)) {
             const postAlwaysIssue = detectarPostAlways(src);
             if (postAlwaysIssue) {
@@ -207,31 +180,26 @@ export const detectorJenkinsEstrutura = {
                 sugestao: 'Divida o pipeline em stages (ex: Build, Test, Deploy)'
             }));
         }
-        // --- Too many stages ---
         const manyStagesIssue = detectarMuitosStages(src, stageNames.length);
         if (manyStagesIssue) {
             manyStagesIssue.relPath = relPath;
             ocorrencias.push(manyStagesIssue);
         }
-        // --- Parallel failFast ---
         const parallelIssue = detectarParallelFailFast(src);
         if (parallelIssue) {
             parallelIssue.relPath = relPath;
             ocorrencias.push(parallelIssue);
         }
-        // --- When conditions ---
         const whenIssue = detectarStageSemWhen(src);
         if (whenIssue) {
             whenIssue.relPath = relPath;
             ocorrencias.push(whenIssue);
         }
-        // --- Tool version ---
         const toolVersionIssue = detectarToolsSemVersao(src);
         if (toolVersionIssue) {
             toolVersionIssue.relPath = relPath;
             ocorrencias.push(toolVersionIssue);
         }
-        // --- Agent label ---
         const agentLabelIssue = detectarAgentSemLabel(src);
         if (agentLabelIssue) {
             agentLabelIssue.relPath = relPath;

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

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export * from './detector-jenkins-best-practices.js';
 export * from './detector-jenkins-security.js';
 export * from './detector-jenkins-structure.js';

package/dist/analysts/jenkins/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * [BUSCA] Analistas de Jenkins
- */
 export * from './analysts/analyst-jenkins.js';
 export * from './corrections/index.js';
 export * from './detectors/index.js';

package/dist/analysts/jenkins/reports/generator-report-jenkins.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import fs from 'node:fs';
 import path from 'node:path';
 import { messages } from '../../../core/messages/index.js';

package/dist/analysts/jenkins/reports/index.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export * from './generator-report-jenkins.js';

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

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

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

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { splitLines } from '../../../shared/helpers/index.js';
 export function pontuarJenkins(src, _relPath) {
     let score = 0;
@@ -8,7 +6,6 @@ export function pontuarJenkins(src, _relPath) {
     const strengths = [];
     const _linhas = splitLines(src);
     const srcCompleto = src;
-    // ─── Security (0-30) ──────────────────────────────────────────────────
     if (!/\bsh\s+['"].*sudo\b/i.test(srcCompleto)) {
         score += 5;
         strengths.push('Sem uso de sudo em comandos');
@@ -52,7 +49,6 @@ export function pontuarJenkins(src, _relPath) {
     else {
         issues.push('Bindings de credenciais expostos');
     }
-    // ─── Structure (0-30) ────────────────────────────────────────────────
     if (/post\s*\{/i.test(srcCompleto)) {
         score += 5;
         strengths.push('Bloco post configurado');
@@ -109,7 +105,6 @@ export function pontuarJenkins(src, _relPath) {
     else {
         issues.push('Bloco tools ausente');
     }
-    // ─── Best Practices (0-40) ──────────────────────────────────────────
     if (/timeout\s*\(.*\)/i.test(srcCompleto)) {
         score += 6;
         strengths.push('Timeout configurado');

package/dist/analysts/js-ts/analysts/analyst-commands-cli.js

@@ -21,7 +21,6 @@ export function extractHandlerInfo(nodeParam) {
     }
     return null;
 }
-// ── Line extraction helpers ────────────────────────────────────────────
 function getNumberProp(obj, prop) {
     if (typeof obj !== 'object' || obj === null) {
         return undefined;
@@ -46,7 +45,6 @@ function extractLineFromNode(obj) {
     const line = start.line;
     return typeof line === 'number' ? line : undefined;
 }
-// ── Framework detection ────────────────────────────────────────────────
 function detectarNewCommand(node, state) {
     if (!textoTitulo.isNewExpression(node)) {
         return;
@@ -290,7 +288,6 @@ function detectarVarUsage(node, state) {
         }
     }
 }
-// ── Registrar factory ──────────────────────────────────────────────────
 function criarRegistrar(state) {
     return (node, comandoNome, handler, origemFramework) => {
         state.comandosInvocados++;
@@ -311,7 +308,6 @@ function criarRegistrar(state) {
         state.comandos.push(registro);
     };
 }
-// ── Name extraction ────────────────────────────────────────────────────
 function extrairNomeDeCadeia(call) {
     let current = call;
     const visitados = new Set();
@@ -347,7 +343,6 @@ function extrairNomeDeCadeia(call) {
     }
     return '';
 }
-// ── Post-traversal processing ──────────────────────────────────────────
 function verificarComandosDuplicados(comandoNomes, relPath) {
     const duplicados = comandoNomes.filter((item, idx) => item && comandoNomes.indexOf(item) !== idx);
     if (duplicados.length === 0) {
@@ -444,7 +439,6 @@ function processarComandosRegistrados(comandos, comandoNomes, comandosInvocados,
     }
     return ocorrencias;
 }
-// ── Analyst export ─────────────────────────────────────────────────────
 export const analistaComandosCli = {
     nome: 'analista-comandos-cli',
     test: (relPath) => {

package/dist/analysts/js-ts/analysts/analyst-patterns-usage.js

@@ -113,7 +113,6 @@ export const analistaPadroesUso = {
                     if ((node.type === 'ClassProperty' || node.type === 'PropertyDefinition') && 'value' in node && textoTitulo.isArrowFunctionExpression(node.value) && !contextoArquivo.isTest) {
                         push({ tipo: 'info', mensagem: messages.PadroesUsoMensagens.arrowAsClassMethod, relPath, linha: node.loc?.start.line, coluna: node.loc?.start.column });
                     }
-                    // ts-expect-error / ts-ignore detection
                     if (node.leadingComments) {
                         for (const comment of node.leadingComments) {
                             if (comment.value.includes('@ts-ignore')) {
@@ -121,31 +120,26 @@ export const analistaPadroesUso = {
                             }
                         }
                     }
-                    // Non-null assertion ! count
                     if (textoTitulo.isTSNonNullExpression(node)) {
                         nonNullCount++;
                         if (nonNullCount > 3) {
                             push({ tipo: 'aviso', mensagem: messages.PadroesUsoMensagens.nonNullAssertion(nonNullCount), relPath, linha: node.loc?.start.line, coluna: node.loc?.start.column, nivel: 'aviso' });
                         }
                     }
-                    // Type assertion as Type without validation
                     if (textoTitulo.isTSAsExpression(node)) {
                         const parent = path.parentPath.node;
                         if (!textoTitulo.isVariableDeclarator(parent)) {
                             push({ tipo: 'info', mensagem: messages.PadroesUsoMensagens.typeAssertionWithoutValidation, relPath, linha: node.loc?.start.line, coluna: node.loc?.start.column, nivel: 'info' });
                         }
                     }
-                    // || vs ?? misuse
                     if (textoTitulo.isLogicalExpression(node) && node.operator === '||') {
                         if (textoTitulo.isStringLiteral(node.left) || textoTitulo.isNumericLiteral(node.left)) {
                             push({ tipo: 'info', mensagem: messages.PadroesUsoMensagens.orVsNullishMisuse, relPath, linha: node.loc?.start.line, coluna: node.loc?.start.column, nivel: 'info' });
                         }
                     }
-                    // console.log detection
                     if (textoTitulo.isCallExpression(node) && textoTitulo.isMemberExpression(node.callee) && textoTitulo.isIdentifier(node.callee.object) && node.callee.object.name === 'console' && textoTitulo.isIdentifier(node.callee.property) && (node.callee.property.name === 'log' || node.callee.property.name === 'warn')) {
                         push({ tipo: 'alerta', mensagem: messages.PadroesUsoMensagens.consoleLog, relPath, linha: node.loc?.start.line, coluna: node.loc?.start.column, nivel: 'aviso' });
                     }
-                    // non-arrow callback where arrow would be better
                     if (textoTitulo.isCallExpression(node) && textoTitulo.isMemberExpression(node.callee)) {
                         const prop = node.callee.property;
                         if (textoTitulo.isIdentifier(prop) && ['map', 'filter', 'reduce', 'forEach', 'find', 'some', 'every', 'flatMap'].includes(prop.name)) {
@@ -156,20 +150,17 @@ export const analistaPadroesUso = {
                             }
                         }
                     }
-                    // Useless conditionals: if (x === true), if (x === false), x === true ? ... : ...
                     if (textoTitulo.isIfStatement(node) && textoTitulo.isBinaryExpression(node.test)) {
                         const bin = node.test;
                         if ((bin.operator === '===' || bin.operator === '==') && textoTitulo.isBooleanLiteral(bin.right)) {
                             push({ tipo: 'info', mensagem: messages.PadroesUsoMensagens.uselessConditional, relPath, linha: node.loc?.start.line, coluna: node.loc?.start.column, nivel: 'info' });
                         }
                     }
-                    // satisfies keyword usage (TypeScript 4.9+)
                     if (textoTitulo.isTSSatisfiesExpression(node)) {
                         push({ tipo: 'info', mensagem: messages.PadroesUsoMensagens.satisfiesUsage, relPath, linha: node.loc?.start.line, coluna: node.loc?.start.column, nivel: 'info' });
                     }
                 }
             });
-            // Magic strings detection (via text scan)
             const stringRegex = /['"`]([a-zA-Z_][a-zA-Z0-9_-]{2,})['"`]/g;
             let m;
             while ((m = stringRegex.exec(src)) !== null) {

package/dist/analysts/js-ts/analysts/analyst-todo-comments.js

@@ -2,10 +2,6 @@ import { detectarContextoProjeto } from '../../../shared/index.js';
 import { messages } from '../../../core/messages/index.js';
 import { detectarComentariosPendentes } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
-/**
- * Analista para detectar TODO e FIXME em comentários.
- * Utiliza helpers compartilhados para busca consistente em todo o projeto.
- */
 export const analistaTodoComentarios = {
     nome: 'todo-comments',
     categoria: 'qualidade',
@@ -30,7 +26,6 @@ export const analistaTodoComentarios = {
             return null;
         }
         const nivelTodo = 'aviso';
-        // Utiliza helper compartilhado para detecção robusta
         const todos = detectarComentariosPendentes(src);
         if (todos.length === 0) {
             return null;

package/dist/analysts/js-ts/analysts/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview Analistas de JavaScript/TypeScript
- */
 export * from './analyst-commands-cli.js';
 export * from './analyst-functions-long.js';
 export * from './analyst-patterns-usage.js';

package/dist/analysts/js-ts/detectors/detector-anti-patterns-async.js

@@ -56,7 +56,6 @@ const visitorAsync = {
                     }
                 }
             }
-            // Promise.all().then() without error handling
             if (propName === 'then' && textoTitulo.isCallExpression(callee.object) && textoTitulo.isMemberExpression(callee.object.callee)) {
                 const innerProp = callee.object.callee.property;
                 if (textoTitulo.isIdentifier(innerProp) && innerProp.name === 'all') {
@@ -72,7 +71,6 @@ const visitorAsync = {
                         });
                     }
                     catch { }
-                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-boolean-literal-compare, @typescript-eslint/no-unnecessary-condition
                     if (hasErrorHandler === false) {
                         state.ocorrencias.push({
                             tipo: 'promise-all-no-error',
@@ -86,7 +84,6 @@ const visitorAsync = {
                     }
                 }
             }
-            // Promise nesting: .then() inside .then()
             if (propName === 'then') {
                 const arg = path.node.arguments[0];
                 if (arg.type === 'ArrowFunctionExpression' || arg.type === 'FunctionExpression') {
@@ -115,9 +112,6 @@ const visitorAsync = {
                 }
             }
         }
-        // @mahoraga-disable ml-unhandled-promise
-        // Justificativa: O detector analisa uso de Promise em AST, não cria promises
-        // Promise constructor anti-pattern: new Promise((resolve, reject) => { ... })
         if (callee.type === 'Identifier' && callee.name === 'Promise' && path.node.arguments.length === 1) {
             const executor = path.node.arguments[0];
             if (executor.type === 'ArrowFunctionExpression' || executor.type === 'FunctionExpression') {
@@ -140,13 +134,11 @@ const visitorAsync = {
                 }
             }
         }
-        // return await misuse (outside try/catch)
         if (callee.type === 'Identifier' && textoTitulo.isReturnStatement(path.parentPath.node)) {
             const fnParent = path.getFunctionParent();
             if (fnParent) {
                 let inTryCatch = false;
                 let current = path.parentPath;
-                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
                 while (current) {
                     if (textoTitulo.isTryStatement(current.node)) {
                         inTryCatch = true;
@@ -169,7 +161,6 @@ const visitorAsync = {
         }
     },
     AwaitExpression(path, state) {
-        // Track consecutive independent awaits for Promise.all suggestion
         const currentLine = path.node.loc?.start.line ?? 0;
         if (state.lastAwaitLine > 0 && currentLine - state.lastAwaitLine <= 2) {
             state.consecutiveAwaits++;
@@ -190,8 +181,6 @@ const visitorAsync = {
         }
         state.lastAwaitLine = currentLine;
     },
-    // Top-level await and for-await-of detection via text fallback
-    // These are checked in the aplicar method
     ForOfStatement(path, state) {
         if (path.node.await) {
             state.ocorrencias.push({
@@ -206,7 +195,6 @@ const visitorAsync = {
         }
     },
     Function(path, state) {
-        // Async function without await
         if (path.node.async) {
             let hasAwait = false;
             try {
@@ -215,7 +203,6 @@ const visitorAsync = {
                 });
             }
             catch { }
-            // eslint-disable-next-line @typescript-eslint/no-unnecessary-boolean-literal-compare, @typescript-eslint/no-unnecessary-condition
             if (hasAwait === false) {
                 state.ocorrencias.push({
                     tipo: 'async-without-await',
@@ -274,7 +261,6 @@ export const analistaAntiPadroesAsync = {
         };
         const nodeToTraverse = ('node' in ast ? ast.node : ast);
         traverse(nodeToTraverse, visitorAsync, undefined, stateObj);
-        // Top-level await detection via text
         if (/^\s*await\s+/m.test(src)) {
             const topLevelAwaitLine = (() => {
                 const m = src.match(/^\s*await\s+/m);
@@ -303,7 +289,6 @@ export const analistaAntiPadroesAsync = {
                 });
             }
         }
-        // Promise.withResolvers detection via text
         if (/Promise\.withResolvers\s*\(/g.test(src)) {
             const match = /Promise\.withResolvers\s*\(/g.exec(src);
             const linha = match ? src.substring(0, match.index).split('\n').length : 1;
@@ -317,7 +302,6 @@ export const analistaAntiPadroesAsync = {
                 relPath
             });
         }
-        // Promise.allSettled detection
         if (/Promise\.allSettled\s*\(/g.test(src)) {
             const match = /Promise\.allSettled\s*\(/g.exec(src);
             const linha = match ? src.substring(0, match.index).split('\n').length : 1;