@mocoto/mahoraga 0.14.8 → 0.15.0

package/dist/shared/helpers/ast-visitor-utils.js

@@ -1,7 +1,4 @@
 import { traverse } from '../../core/config/index.js';
-/**
- * Utilitário centralizado para rodar Visitor de AST e coletar resultados sem duplicação
- */
 export class DedupeManager {
     relPath;
     seen = new Set();
@@ -10,7 +7,6 @@ export class DedupeManager {
         this.relPath = relPath;
     }
     add(ocorrencia) {
-        // Chave de deduplicação simples baseada em mensagem, caminho e linha
         const relPath = this.relPath || ocorrencia.relPath || '';
         const linha = ocorrencia.linha ?? 0;
         const key = `${ocorrencia.mensagem}|${relPath}|${linha}`;
@@ -24,9 +20,6 @@ export class DedupeManager {
         return this.occurrences;
     }
 }
-/**
- * Roda o visitor do Babel gerenciando deduplicações
- */
 export function runUniqueVisitor(ast, relPath, visitor, initialState = {}) {
     const manager = new DedupeManager(relPath);
     const state = { ...initialState, manager, relPath };
@@ -41,7 +34,6 @@ export function runUniqueVisitor(ast, relPath, visitor, initialState = {}) {
         traverse(nodeToTraverse, visitor, undefined, state);
     }
     catch {
-        // Ignorar silenciosamente falhas de parser em sub-nós
     }
     return manager.getResults();
 }

package/dist/shared/helpers/context-utils.js

@@ -1,24 +1,12 @@
-// SPDX-License-Identifier: MIT
-/**
- * Verifica se a posição no código está dentro de uma string literal.
- * Trata aspas simples, duplas e template strings (backticks), lidando com caracteres de escape.
- */
 export function isInString(code, position) {
-    // Normaliza line endings para \n (Windows compatibility)
     const normalizedCodigo = code.replace(/\r\n/g, '\n');
     const before = normalizedCodigo.substring(0, position);
-    // Conta aspas simples, duplas e template strings, ignorando aspas escapadas
     const singleQuotesBefore = (before.match(/(?<!\\)'/g) ?? []).length;
     const doubleQuotesBefore = (before.match(/(?<!\\)"/g) ?? []).length;
     const templateQuotesBefore = (before.match(/(?<!\\)`/g) ?? []).length;
-    // Se número ímpar de aspas antes, está dentro de string
     return singleQuotesBefore % 2 === 1 || doubleQuotesBefore % 2 === 1 || templateQuotesBefore % 2 === 1;
 }
-/**
- * Verifica se a posição no código está dentro de um comentário (line ou block).
- */
 export function isInComment(code, position) {
-    // Normaliza line endings para \n (Windows compatibility)
     const normalizedCodigo = code.replace(/\r\n/g, '\n');
     const lines = normalizedCodigo.split('\n');
     let pos = 0;
@@ -27,14 +15,11 @@ export function isInComment(code, position) {
         const lineInicio = pos;
         const lineFim = pos + line.length;
         if (position >= lineInicio && position <= lineFim) {
-            // Verifica comentário inline (//)
             const posInLine = position - lineInicio;
             const commentInicio = line.indexOf('//');
-            // Se há // na linha E a posição está depois do //, está em comentário
             if (commentInicio !== -1 && posInLine >= commentInicio) {
                 return true;
             }
-            // Verifica comentário de bloco (/* */)
             const blockInicio = normalizedCodigo.lastIndexOf('/*', position);
             const blockFim = normalizedCodigo.indexOf('*/', position);
             if (blockInicio !== -1 && (blockFim === -1 || blockFim > position)) {
@@ -42,13 +27,10 @@ export function isInComment(code, position) {
             }
             return false;
         }
-        pos = lineFim + 1; // +1 para o \n
+        pos = lineFim + 1;
     }
     return false;
 }
-/**
- * Verifica se a posição está em string ou comentário.
- */
 export function isInStringOrComment(code, position) {
     return isInString(code, position) || isInComment(code, position);
 }

package/dist/shared/helpers/detectors-common.js

@@ -1,11 +1,5 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { isContextoDocumentacao } from '../index.js';
 import { LIMITES_PADRAO } from '../../core/config/index.js';
-/**
- * Calcula a entropia de Shannon de uma string.
- * Útil para distinguir tokens/chaves reais de strings comuns.
- */
 export function calcularEntropia(str) {
     const frequencias = new Map();
     for (const char of str) {
@@ -18,27 +12,19 @@ export function calcularEntropia(str) {
     }
     return entropia;
 }
-/**
- * Verifica se uma linha parece conter um placeholder seguro.
- */
 export function isPlaceholderSuspeito(linha) {
     const placeholdersComuns = ['<YOUR_', '<FOO>', '<BAR>', 'REPLACE_ME', 'EXAMPLE_', 'PLACEHOLDER', 'your_', 'example', 'sample', 'demo', 'test', 'fake', 'dummy', 'mock'];
     const linhaLower = linha.toLowerCase();
     return placeholdersComuns.some(caminho => linhaLower.includes(caminho.toLowerCase()));
 }
-/**
- * Heurística para detectar segredos hardcoded em linhas de código.
- */
 export function detectarSegredosHardcoded(src, relPath) {
     if (isContextoDocumentacao(relPath)) {
         return [];
     }
     const resultados = [];
     const linhas = src.split('\n');
-    // Whitelist de padrões comuns de nomenclatura (não são secrets)
     const padroesNomenclatura = ['_role_', '_config_', '_key_', '_type_', '_name_', '_prefix_', '_suffix_', 'squad_', 'channel_', 'guild_'];
     linhas.forEach((linha, index) => {
-        // Ignorar variáveis comuns que não são secrets
         const isNonSecretChave = /\b(migration|cache|hash|dedupe|lookup|map|index)key\b/i.test(linha);
         if (isNonSecretChave || isPlaceholderSuspeito(linha)) {
             return;
@@ -48,17 +34,14 @@ export function detectarSegredosHardcoded(src, relPath) {
         if (match) {
             const campo = (match[1] || '').toLowerCase();
             const valor = match[2];
-            // Ignorar template strings dinâmicas
             if (linha.includes('${') || /`[^`]*\$\{[^}]+\}/.test(linha)) {
                 return;
             }
-            // Ignorar se contiver padrões de nomenclatura comuns
             if (padroesNomenclatura.some(caminho => valor.toLowerCase().includes(caminho.toLowerCase()))) {
                 return;
             }
             const entropia = calcularEntropia(valor);
             const temAltaEntropia = entropia > LIMITES_PADRAO.SEGURANCA.ENTROPIA_SHANNON_ALTA;
-            // Heurística de confiança: tokens longos com alta entropia tendem a ser reais
             if (valor.length > 20 && temAltaEntropia) {
                 resultados.push({
                     campo,
@@ -79,9 +62,6 @@ export function detectarSegredosHardcoded(src, relPath) {
     });
     return resultados;
 }
-/**
- * Detecta comentários TODO/FIXME.
- */
 export function detectarComentariosPendentes(src) {
     const resultados = [];
     const linhas = src.split('\n');
@@ -99,9 +79,6 @@ export function detectarComentariosPendentes(src) {
     });
     return resultados;
 }
-/**
- * Detecta console.log e similares.
- */
 export function detectarLogsDebug(src) {
     const resultados = [];
     const linhas = src.split('\n');

package/dist/shared/helpers/framework-detector.js

@@ -1,10 +1,5 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import fs from 'node:fs';
 import path from 'node:path';
-/**
- * Detecta frameworks instalados no projeto via package.json
- */
 export function detectarFrameworks(rootDir) {
     const frameworks = [];
     try {
@@ -17,7 +12,6 @@ export function detectarFrameworks(rootDir) {
         const packageJson = parsedJson;
         const dependencies = packageJson.dependencies ?? {};
         const devDependencies = packageJson.devDependencies ?? {};
-        // Lista de frameworks conhecidos com seus identificadores
         const knownFrameworks = [{
                 pkg: 'discord.js',
                 name: 'Discord.js'
@@ -55,7 +49,6 @@ export function detectarFrameworks(rootDir) {
                 pkg: '@angular/core',
                 name: 'Angular'
             }];
-        // Verificar dependências
         for (const { pkg, name } of knownFrameworks) {
             if (dependencies[pkg]) {
                 frameworks.push({
@@ -72,7 +65,6 @@ export function detectarFrameworks(rootDir) {
                 });
             }
         }
-        // Remover duplicatas (mesma framework em prod e dev)
         const unique = frameworks.reduce((acc, curr) => {
             if (!acc?.find(arquivo => arquivo.name === curr.name)) {
                 acc.push(curr);
@@ -85,9 +77,6 @@ export function detectarFrameworks(rootDir) {
         return frameworks;
     }
 }
-/**
- * Verifica se um framework específico está instalado
- */
 export function hasFramework(rootDir, frameworkName) {
     const frameworks = detectarFrameworks(rootDir);
     return frameworks.some(arquivo => arquivo.name === frameworkName);

package/dist/shared/helpers/fs.js

@@ -1,9 +1,5 @@
-// SPDX-License-Identifier: MIT
 import fs from 'node:fs';
 import path from 'node:path';
-/**
- * Garante que o diretório que contém o arquivo especificado exista.
- */
 export async function ensureDir(filePath) {
     await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
 }

package/dist/shared/helpers/group.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Agrupa itens de um array por uma chave calculada.
- */
 export function agruparPor(items, chave) {
     return items.reduce((acc, item) => {
         const key = chave(item);

package/dist/shared/helpers/helpers-analysts.js

@@ -1,14 +1,6 @@
-// SPDX-License-Identifier: MIT
-// Helpers utilitários para analistas
-/**
- * Incrementa um contador de ocorrências por chave.
- */
 export function incrementar(contador, chave) {
     contador[chave] = (contador[chave] ?? 0) + 1;
 }
-/**
- * Garante que sempre retorna array vazio se valor for null/undefined.
- */
 export function garantirArray(valor) {
     return Array.isArray(valor) ? valor : [];
 }

package/dist/shared/helpers/imports.js

@@ -1,22 +1,8 @@
-// @mahoraga-disable tipo-literal-inline-complexo ml-deep-nesting
-// SPDX-License-Identifier: MIT
-// Justificativa: tipos locais para reescrita de imports
-/**
- * Helper puro para reescrever imports relativos quando um arquivo é movido.
- * Não toca disco; apenas retorna o novo conteúdo.
- */
 import path from 'node:path';
 import { normalizePath } from './path.js';
-/**
- * Normaliza o caminho de import para uma chave consistente (POSIX).
- */
 export function normalizarPosix(caminho) {
     return path.posix.normalize(normalizePath(caminho || ''));
 }
-/**
- * Tenta resolver um caminho de arquivo para um dos arquivos existentes no projeto,
- * lidando com extensões omitidas e o padrão TS ESM (.js -> .ts).
- */
 export function resolverArquivoExistente(caminho, arquivosExistentes) {
     const alvo = normalizarPosix(caminho);
     if (arquivosExistentes.has(alvo)) {
@@ -24,7 +10,6 @@ export function resolverArquivoExistente(caminho, arquivosExistentes) {
     }
     const ext = path.posix.extname(alvo);
     const base = ext ? alvo.slice(0, -ext.length) : alvo;
-    // Padrão TS ESM: importar "./x.js" em .ts, mas o arquivo real é "./x.ts"
     if (ext === '.js' || ext === '.mjs' || ext === '.cjs') {
         const candidates = [`${base}.ts`, `${base}.tsx`, `${base}.js`, `${base}.mjs`, `${base}.cjs`];
         for (const elem of candidates) {
@@ -43,7 +28,6 @@ export function resolverArquivoExistente(caminho, arquivosExistentes) {
             }
         }
     }
-    // Sem extensão: tenta variações comuns e index.*
     if (!ext) {
         const candidates = [`${alvo}.ts`, `${alvo}.tsx`, `${alvo}.js`, `${alvo}.jsx`, `${alvo}.mjs`, `${alvo}.cjs`, `${alvo}.d.ts`, `${alvo}/index.ts`, `${alvo}/index.tsx`, `${alvo}/index.js`, `${alvo}/index.mjs`, `${alvo}/index.cjs`];
         for (const elem of candidates) {
@@ -55,18 +39,13 @@ export function resolverArquivoExistente(caminho, arquivosExistentes) {
     }
     return alvo;
 }
-/**
- * Resolve um módulo (externo, absoluto ou relativo) para uma chave consistente.
- */
 export function resolverModulo(mod, relPath, arquivosExistentes) {
-    // Externo (node_modules / builtin): mantém como está
     if (!mod.startsWith('.') && !mod.startsWith('/')) {
         return {
             key: mod,
             existe: true
         };
     }
-    // Import absoluto: trata como caminho normalizado
     if (mod.startsWith('/')) {
         const absNorm = normalizarPosix(mod);
         if (!arquivosExistentes) {
@@ -81,7 +60,6 @@ export function resolverModulo(mod, relPath, arquivosExistentes) {
             existe: arquivosExistentes.has(resolved)
         };
     }
-    // Relativo
     const fromDir = normalizarPosix(path.posix.dirname(normalizarPosix(relPath)));
     const joined = normalizarPosix(path.posix.join(fromDir, mod));
     if (!arquivosExistentes) {
@@ -97,30 +75,24 @@ export function resolverModulo(mod, relPath, arquivosExistentes) {
     };
 }
 export function reescreverImports(conteudo, arquivoDe, arquivoPara) {
-    // Suporta import/export from e require simples
     const padrao = /(import\s+[^'";]+from\s*['"]([^'"\n]+)['"]\s*;?|export\s+\*?\s*from\s*['"]([^'"\n]+)['"];?|require\(\s*['"]([^'"\n]+)['"]\s*\))/g;
     const norm = (caminho) => path.posix.normalize(normalizePath(caminho));
     const baseDe = path.posix.dirname(norm(arquivoDe));
     const basePara = path.posix.dirname(norm(arquivoPara));
-    // raízes calculadas anteriormente não são usadas; mantemos somente baseDe/basePara
     const reescritos = [];
     const novoConteudo = conteudo.replace(padrao, (full, _i1, gFrom, gExport, gReq) => {
         const spec = (gFrom ?? gExport ?? gReq) ?? '';
         if (!spec) {
             return full;
         }
-        // Só reescreve relativos ou aliases conhecidos do projeto que mapeiam para src/*
         const isRelative = spec.startsWith('./') || spec.startsWith('../');
         const isAliasRaiz = spec.startsWith('@/');
-        // Aliases internos do projeto que queremos normalizar para src/<alias>/...
-        // Mantém @nucleo/* intacto (tratado como pacote/externo nos testes)
         const isProjectAlias = /^@(?:analistas|arquitetos|cli|relatorios|tipos|zeladores)\//.test(spec);
         if (!isAliasRaiz && !isProjectAlias && !spec.includes('/src/') && !isRelative) {
             return full;
         }
         let alvoAntigo;
         if (isAliasRaiz || isProjectAlias || spec.includes('/src/')) {
-            // Normaliza alias para caminho sob 'src/...'
             let specNormalized = spec;
             if (isAliasRaiz) {
                 specNormalized = specNormalized.replace(/^@\//, 'src/');
@@ -128,36 +100,25 @@ export function reescreverImports(conteudo, arquivoDe, arquivoPara) {
             else if (isProjectAlias) {
                 specNormalized = specNormalized.replace(/^@([^/]+)\//, 'src/$1/');
             }
-            // extrai sempre o segmento após a primeira ocorrência de 'src/'
-            // lida com spec que comece com 'src/...', '/src/...', '@/...' (convertido para 'src/...')
             let afterSrc = specNormalized.replace(/^.*src\//, '');
-            // remove extensão .js caso presente para evitar preservá-la nos relativos
             afterSrc = afterSrc.replace(/\.js$/, '');
             alvoAntigo = norm(path.posix.join('src', afterSrc));
-            // Corrige casos onde testes referenciam caminhos improváveis como src/cli/utils/*
-            // Padroniza para src/utils/*, evitando inflar profundidade relativa
             alvoAntigo = alvoAntigo.replace(/^src\/cli\/utils\//, 'src/utils/').replace(/^src\/cli\//, 'src/')
-                // Colapsa o primeiro segmento após src quando for util|utils
                 .replace(/^src\/[^/]+\/(?:util|utils)\//, 'src/utils/');
-            // Evita duplicação utils/utils
             alvoAntigo = alvoAntigo.replace(/\/utils\/utils\//g, '/utils/');
         }
         else {
             alvoAntigo = norm(path.posix.join(baseDe, spec));
         }
         let novoRel = path.posix.relative(basePara, alvoAntigo);
-        // Normaliza separadores e remove duplicações
         novoRel = path.posix.normalize(novoRel);
-        // Garante relativo com ./ ou ../
         if (!novoRel.startsWith('.')) {
             novoRel = `./${novoRel}`;
         }
-        // NodeNext: detecta imports pra diretórios (sem extensão) → precisa de /index
         const originalExt = path.posix.extname(spec);
         if (!originalExt && !path.posix.extname(novoRel) && !novoRel.endsWith('/index')) {
             novoRel += '/index';
         }
-        // NodeNext requer extensão .js em imports relativos
         if (originalExt === '.js' || originalExt === '.mjs' || originalExt === '.cjs') {
             if (!novoRel.endsWith(originalExt)) {
                 novoRel += originalExt;

package/dist/shared/helpers/json-mode.js

@@ -1,34 +1,13 @@
-// SPDX-License-Identifier: MIT
-/**
- * Controle global do modo JSON para suprimir logs visuais.
- *
- * Quando --json está ativo, devemos produzir APENAS JSON puro no stdout,
- * sem logs INFO, SUCESSO, spinners, cores, ou qualquer outra saída visual.
- *
- * Isso é crítico para integração com CI/CD e ferramentas que parsam o JSON.
- */
 let _jsonModeAtivo = false;
-/**
- * Ativa o modo JSON (suprime todos os logs visuais)
- */
 export function ativarModoJson() {
     _jsonModeAtivo = true;
 }
-/**
- * Desativa o modo JSON (restaura logs visuais)
- */
 export function desativarModoJson() {
     _jsonModeAtivo = false;
 }
-/**
- * Verifica se o modo JSON está ativo
- */
 export function isJsonMode() {
     return _jsonModeAtivo;
 }
-/**
- * Reseta o estado (útil para testes)
- */
 export function resetJsonMode() {
     _jsonModeAtivo = false;
 }

package/dist/shared/helpers/json.js

@@ -1,13 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Utilidades de JSON: escape Unicode e stringificação segura para consumidores legados.
- *
- * Regras:
- * - Converte qualquer caractere fora do ASCII básico em sequências \uXXXX.
- * - Para caracteres fora do BMP, emite pares substitutos (dois \uXXXX).
- * - Mantém caracteres ASCII intactos.
- */
-// Constantes Unicode e BMP
 const ASCII_MAX = 0x7f;
 const BMP_MAX = 0xffff;
 const SUPPLEMENTARY_PLANO_DESLOCAMENTO = 0x10000;
@@ -17,9 +7,6 @@ const SURROGATE_DESLOCAMENTO = 10;
 const SURROGATE_MASCARA = 0x3ff;
 const HEX_PAD_LENGTH = 4;
 const JSON_INDENTACAO_PADRAO = 2;
-/**
- * Escapa caracteres não-ASCII para sequências \uXXXX, incluindo pares substitutos.
- */
 export function escapeNonAscii(string) {
     let out = '';
     for (const ch of string) {
@@ -31,7 +18,6 @@ export function escapeNonAscii(string) {
             out += `\\u${cp.toString(16).padStart(HEX_PAD_LENGTH, '0')}`;
         }
         else {
-            // caracteres fora do BMP -> pares substitutos
             const codePointOffset = cp - SUPPLEMENTARY_PLANO_DESLOCAMENTO;
             const highSurrogate = HIGH_SURROGATE_BASE + (codePointOffset >> SURROGATE_DESLOCAMENTO);
             const lowSurrogate = LOW_SURROGATE_BASE + (codePointOffset & SURROGATE_MASCARA);
@@ -41,14 +27,8 @@ export function escapeNonAscii(string) {
     }
     return out;
 }
-/**
- * Stringifica um objeto em JSON aplicando escapeNonAscii em todos os strings do objeto.
- * Normaliza possíveis double-escapes ("\\uXXXX" -> "\uXXXX").
- */
 export function stringifyJsonEscaped(value, space = JSON_INDENTACAO_PADRAO) {
     const replacer = (_key, valor) => typeof valor === 'string' ? escapeNonAscii(valor) : valor;
     const raw = JSON.stringify(value, replacer, space);
-    // JSON.stringify pode escapar as barras invertidas inseridas pelo replacer
-    // (\\u -> \u). Normalizamos para os consumidores que esperam \uXXXX.
     return raw.replace(/\\\\u/g, '\\u');
 }

package/dist/shared/helpers/line-lookup.js

@@ -1,8 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Cria uma função de consulta de linha (1-based) para um índice de string (0-based).
- * Otimiza casos com muitos `matchAll`/índices evitando `slice(0, i).split('\n')`.
- */
 export function createLineLookup(src) {
     const newlineIndexes = [];
     for (let indice = 0; indice < src.length; indice++) {
@@ -15,7 +10,6 @@ export function createLineLookup(src) {
             return 1;
         }
         const clampedIndex = Math.min(src.length, Math.max(0, index));
-        // upper_bound: quantidade de '\n' com pos < i
         let lo = 0;
         let hi = newlineIndexes.length;
         while (lo < hi) {

package/dist/shared/helpers/lines.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Divide o conteúdo de um arquivo em linhas de forma compatível com diferentes sistemas operacionais.
- */
 export function splitLines(src) {
     return src.split(/\r?\n/);
 }

package/dist/shared/helpers/magic-constants-whitelist.js

@@ -1,9 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Discord.js API limits (oficialmente documentados)
- * @see https://discord.com/developers/docs/resources/channel#embed-limits
- * @see https://discord.com/developers/docs/interactions/message-components#select-menus
- */
 export const DISCORD_LIMITES = [{
         value: 10,
         description: 'Máximo de fields em embed'
@@ -32,9 +26,6 @@ export const DISCORD_LIMITES = [{
         value: 6000,
         description: 'Máximo total de caracteres em embed'
     }];
-/**
- * HTTP Status Codes comuns
- */
 export const HTTP_STATUS_CODIGOS = [{
         value: 200,
         description: 'HTTP OK'
@@ -66,9 +57,6 @@ export const HTTP_STATUS_CODIGOS = [{
         value: 503,
         description: 'HTTP Service Unavailable'
     }];
-/**
- * Limites comuns de paginação e performance
- */
 export const COMUM_LIMITES = [{
         value: 20,
         description: 'Paginação padrão (20 items)'
@@ -82,9 +70,6 @@ export const COMUM_LIMITES = [{
         value: 10000,
         description: 'Limite de query results'
     }];
-/**
- * Valores matemáticos comuns (já cobertos no detector, mas listados para completude)
- */
 export const MATH_CONSTANTES = [{
         value: -1,
         description: 'Index not found'
@@ -107,9 +92,6 @@ export const MATH_CONSTANTES = [{
         value: 1000,
         description: 'Milhar/conversão ms→s'
     }];
-/**
- * Mapa de frameworks para suas whitelists
- */
 export const FRAMEWORK_WHITELISTS = {
     'Discord.js': DISCORD_LIMITES,
     Express: HTTP_STATUS_CODIGOS,
@@ -121,27 +103,19 @@ export const FRAMEWORK_WHITELISTS = {
     Stripe: [],
     'AWS SDK': []
 };
-/**
- * Verifica se um valor numérico está na whitelist para os frameworks detectados
- */
 export function isWhitelistedConstant(value, frameworks, userWhitelist) {
-    // Verificar whitelist do usuário primeiro
     if (userWhitelist?.includes(value)) {
         return true;
     }
-    // Verificar valores matemáticos comuns (sempre válidos)
     if (MATH_CONSTANTES.some(rule => rule.value === value)) {
         return true;
     }
-    // Verificar limites comuns
     if (COMUM_LIMITES.some(rule => rule.value === value)) {
         return true;
     }
-    // Verificar HTTP status codes (sempre válidos em projetos web)
     if (HTTP_STATUS_CODIGOS.some(rule => rule.value === value)) {
         return true;
     }
-    // Verificar whitelists específicas de frameworks
     for (const framework of frameworks) {
         const whitelist = FRAMEWORK_WHITELISTS[framework];
         if (whitelist.some(rule => rule.value === value)) {
@@ -150,11 +124,7 @@ export function isWhitelistedConstant(value, frameworks, userWhitelist) {
     }
     return false;
 }
-/**
- * Obtém a descrição de um magic constant, se estiver na whitelist
- */
 export function getConstantDescription(value, frameworks) {
-    // Verificar todas as whitelists
     const allRules = [...MATH_CONSTANTES, ...COMUM_LIMITES, ...HTTP_STATUS_CODIGOS, ...frameworks.flatMap(arquivo => FRAMEWORK_WHITELISTS[arquivo] ?? [])];
     const rule = allRules.find(raiz => raiz.value === value);
     return rule?.description;