@mocoto/mahoraga 0.14.7 → 0.14.9

package/dist/analysts/corrections/pruning.js

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import path from 'node:path';
 import { gerarRelatorioPodaJson, gerarRelatorioPodaMarkdown } from '../../reports/index.js';
 import pLimit from 'p-limit';
@@ -8,7 +7,7 @@ import { detectarFantasmas } from '../detectors/index.js';
 import { ensureDir } from '../../shared/helpers/index.js';
 import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
 const { log, logAuto } = getMessages();
-export async function removerArquivosOrfaos(_fileEntries /* executarRealmente = false*/) {
+export async function removerArquivosOrfaos(_fileEntries) {
     const { fantasmas } = await detectarFantasmas();
     return {
         arquivosOrfaos: fantasmas
@@ -75,7 +74,6 @@ export async function executarPodaCiclica(executarRealmente = false) {
         log.sucesso('[BROOM] Podagem concluída.');
     }
     else {
-        // Mesmo em simulação, mostramos contagem para cobrir mensagem esperada
         logAuto.podaPodandoSimulado(aPodar.length);
         moverArquivosSimulado(aPodar, base);
     }

package/dist/analysts/corrections/quick-fixes/fix-any-to-proper-type.js

@@ -1,9 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * Quick Fix: Replace any with proper types
- * Analisa uso de `any` e infere/cria tipos corretos
- */
 import { buildTypesRelPathPosix } from '../../../core/config/index.js';
 import { getMessages } from '../../../core/messages/index.js';
 import { isAnyInGenericFunction, isInStringOrComment, isLegacyOrVendorFile, isTypeScriptContext } from '../type-safety/context-analyzer.js';
@@ -23,51 +17,36 @@ export const fixAnyToProperTipo = {
     description: MENSAGENS_CORRECAO_TIPOS.fixAny.description,
     pattern: /:\s*any\b/g,
     category: 'style',
-    // Type safety é considerado 'style' pois não afeta execução
     confidence: CONFIANCA_NIVEIS.DEFAULT,
-    // Média - requer análise contextual
     shouldApply: (match, fullCode, lineContext, fileCaminho) => {
-        // 1. Verificar contexto básico
         if (isInStringOrComment(fullCode, match.index ?? 0)) {
             return false;
         }
-        // 2. Verificar contexto TypeScript (type assertion, etc)
         if (isTypeScriptContext(fullCode, match.index ?? 0)) {
             return false;
         }
-        // 3. Não modificar arquivos de definição de tipos
         if (fileCaminho?.includes('.d.ts') || fileCaminho?.includes('/@types/')) {
             return false;
         }
-        // 4. Não modificar vendor/node_modules
         if (isLegacyOrVendorFile(fileCaminho)) {
             return false;
         }
-        // 5. Verificar se any está em função genérica apropriada
         if (isAnyInGenericFunction(fullCode, match.index ?? 0)) {
-            return false; // any pode ser apropriado aqui
+            return false;
         }
         return true;
     },
     fix: (match, fullCode) => {
-        // Retornar código sem modificação por padrão
-        // A aplicação real deve ser feita via fixAsync
         return fullCode;
     }
 };
-/**
- * Versão assíncrona do fix que faz análise completa
- */
 export async function fixAnyToProperTypeAsync(match, fullCode, fileCaminho, ast) {
     try {
-        // 1. Analisar uso do tipo
         const typeAnalise = analyzeTypeUsage(match, fullCode, fileCaminho, ast);
-        // 2. Estratégia baseada em confiança
         if (typeAnalise.confidence >= CONFIANCA_NIVEIS.HIGH) {
             return await applyHighConfidenceAnyFix(match, fullCode, fileCaminho, typeAnalise);
         }
         else if (typeAnalise.confidence >= CONFIANCA_NIVEIS.MEDIUM) {
-            // MÉDIA CONFIANÇA: Sugerir mas não aplicar
             const warning = {
                 type: 'type-suggestion',
                 message: MENSAGENS_CORRECAO_TIPOS.warnings.confiancaMedia(typeAnalise.confidence, typeAnalise.inferredTipo),
@@ -82,7 +61,6 @@ export async function fixAnyToProperTypeAsync(match, fullCode, fileCaminho, ast)
             };
         }
         else {
-            // BAIXA CONFIANÇA: Apenas avisar
             const warning = {
                 type: 'unsafe-type',
                 message: MENSAGENS_CORRECAO_TIPOS.warnings.confiancaBaixa(typeAnalise.confidence),
@@ -159,26 +137,19 @@ async function applyHighConfidenceAnyFix(match, fullCode, fileCaminho, typeAnali
             }]
     };
 }
-/**
- * Encontra ponto de inserção para import
- */
 function findImportInsertionPoint(lines) {
     let lastImportIndex = -1;
     for (let indice = 0; indice < lines.length; indice++) {
         const line = lines[indice].trim();
-        // Pular comentários no topo
         if (line.startsWith('//') || line.startsWith('/*') || line.startsWith('*')) {
             continue;
         }
-        // Encontrar último import
         if (line.startsWith('import ')) {
             lastImportIndex = indice;
         }
-        // Se encontrou código não-import, parar
         if (line && !line.startsWith('import ') && lastImportIndex !== -1) {
             break;
         }
     }
-    // Inserir após último import ou no topo
     return lastImportIndex + 1;
 }

package/dist/analysts/corrections/quick-fixes/fix-unknown-to-specific-type.js

@@ -1,8 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * Quick Fix: Replace unknown with specific types
- * Mais conservador que fix-any - requer confiança >= 90%
- */
 import { buildTypesRelPathPosix, getTypesDirectoryDisplay } from '../../../core/config/index.js';
 import { getMessages } from '../../../core/messages/index.js';
 import { isInStringOrComment, isLegacyOrVendorFile, isUnknownInGenericContext } from '../type-safety/context-analyzer.js';
@@ -17,44 +12,32 @@ export const fixUnknownToSpecificTipo = {
     pattern: /:\s*unknown\b/g,
     category: 'style',
     confidence: 75,
-    // Mais conservador que any
     shouldApply: (match, fullCode, lineContext, fileCaminho) => {
-        // 1. Verificar contexto básico
         if (isInStringOrComment(fullCode, match.index ?? 0)) {
             return false;
         }
-        // 2. Não modificar arquivos de definição
         if (fileCaminho?.includes('.d.ts') || fileCaminho?.includes('/@types/')) {
             return false;
         }
-        // 3. Não modificar legado/vendor
         if (isLegacyOrVendorFile(fileCaminho)) {
             return false;
         }
-        // 4. Verificar se unknown está em contexto genérico apropriado
         if (isUnknownInGenericContext(fullCode, match.index ?? 0)) {
-            return false; // unknown é apropriado aqui (entrada genérica, deserialização, etc)
+            return false;
         }
         return true;
     },
     fix: (match, fullCode) => {
-        // Retornar código sem modificação por padrão
         return fullCode;
     }
 };
-/**
- * Versão assíncrona com análise completa (conservador)
- */
 export async function fixUnknownToSpecificTypeAsync(match, fullCode, fileCaminho, ast) {
     try {
-        // 1. Analisar uso (mais conservador que any)
         const typeAnalise = await analyzeUnknownUsage(match, fullCode, fileCaminho, ast);
-        // 2. Estratégia mais conservadora (requer >= 90% confiança)
         if (typeAnalise.confidence >= 90) {
             return await applyHighConfidenceUnknownFix(match, fullCode, fileCaminho, typeAnalise);
         }
         else if (typeAnalise.confidence >= 70) {
-            // MÉDIA CONFIANÇA: Sugerir tipo
             const warning = {
                 type: 'type-suggestion',
                 message: `unknown pode ser substituído por tipo específico: ${typeAnalise.inferredTipo}`,
@@ -69,7 +52,6 @@ export async function fixUnknownToSpecificTypeAsync(match, fullCode, fileCaminho
             };
         }
         else {
-            // BAIXA CONFIANÇA: Manter unknown
             const warning = {
                 type: 'keep-unknown',
                 message: 'unknown apropriado aqui (entrada genérica ou baixa confiança)',
@@ -120,9 +102,6 @@ async function applyHighConfidenceUnknownFix(match, fullCode, fileCaminho, typeA
             }]
     };
 }
-/**
- * Encontra ponto de inserção para import
- */
 function findImportInsertionPoint(lines) {
     let lastImportIndex = -1;
     for (let indice = 0; indice < lines.length; indice++) {

package/dist/analysts/corrections/quick-fixes/index.js

@@ -1,6 +1,2 @@
-// SPDX-License-Identifier: MIT
-/**
- * Quick Fixes para Type Safety
- */
 export * from './fix-any-to-proper-type.js';
 export * from './fix-unknown-to-specific-type.js';

package/dist/analysts/corrections/reorganize-barrels.js

@@ -1,5 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { existsSync, promises as fsAsync, readdirSync } from 'node:fs';
 import path from 'node:path';
 import { getMessages } from '../../core/messages/index.js';
@@ -295,13 +293,10 @@ async function extrairNomesExportados(srcDir, relPath, visitados = new Set(), pr
             if (trimmed.startsWith('export default ')) {
                 nomes.add('default');
             }
-            // export function, export async function, export const, export let, export var,
-            // export class, export interface, export type, export enum
             const exportDecl = trimmed.match(/^export\s+(?:type\s+)?(?:(?:async\s+)?(?:function|const|let|var|class|interface|type|enum))\s+(\w+)/);
             if (exportDecl?.[1]) {
                 nomes.add(exportDecl[1]);
             }
-            // export { name1, name2 as alias, ... }
             const exportList = trimmed.match(/^export\s+(?:type\s+)?\s*\{([^}]+)\}/);
             if (exportList) {
                 const body = exportList[1];
@@ -314,7 +309,6 @@ async function extrairNomesExportados(srcDir, relPath, visitados = new Set(), pr
                     });
                 }
             }
-            // Segue re-exports: export * from './foo'
             const reexportMatch = trimmed.match(/^export\s+(?:type\s+)?\*\s+from\s+['"]([^'"]+)['"]/);
             if (reexportMatch) {
                 const resolved = resolverImportRelativo(relPath, reexportMatch[1]);
@@ -331,7 +325,6 @@ async function extrairNomesExportados(srcDir, relPath, visitados = new Set(), pr
         }
     }
     catch {
-        // arquivo não encontrado, ignora
     }
     return nomes;
 }
@@ -346,13 +339,11 @@ function classificarExports(content) {
         if (/from\s+['"]/.test(trimmed)) {
             continue;
         }
-        // export interface X
         let m = trimmed.match(/^export\s+interface\s+(\w+)/);
         if (m) {
             types.add(m[1]);
             continue;
         }
-        // export type X = ... (mas NÃO export type { X })
         if (/^export\s+type\s+(\w+)\s*=/.test(trimmed)) {
             m = trimmed.match(/^export\s+type\s+(\w+)\s*=/);
             if (m) {
@@ -360,13 +351,11 @@ function classificarExports(content) {
                 continue;
             }
         }
-        // export enum X (enum é runtime value)
         m = trimmed.match(/^export\s+enum\s+(\w+)/);
         if (m) {
             values.add(m[1]);
             continue;
         }
-        // export default class/function
         m = trimmed.match(/^export\s+default\s+(?:abstract\s+)?(?:class|function)\s+(\w+)/);
         if (m) {
             values.add(m[1]);
@@ -375,13 +364,11 @@ function classificarExports(content) {
         if (/^export\s+default\s+/.test(trimmed)) {
             continue;
         }
-        // export function/const/let/var/class
         m = trimmed.match(/^export\s+(?:abstract\s+)?(?:async\s+)?(?:function|const|let|var|class)\s+(\w+)/);
         if (m) {
             values.add(m[1]);
             continue;
         }
-        // export { X, Y } - assume que são valores (inferência conservadora)
         m = trimmed.match(/^export\s+(?:type\s+)?\{([^}]+)\}/);
         if (m) {
             m[1].split(',').forEach(part => {
@@ -400,7 +387,6 @@ async function repararImportsBarrelPerdidos(srcDir, barrelsPerdidos, _movimentos
         return 0;
     }
     let totalReparados = 0;
-    // Pré-constrói mapa nomeExportado -> moveDest lendo os arquivos destino
     const nomeParaDestino = new Map();
     for (const [, perdas] of barrelsPerdidos) {
         for (const [, dest] of perdas) {
@@ -424,7 +410,6 @@ async function repararImportsBarrelPerdidos(srcDir, barrelsPerdidos, _movimentos
         if (perdas.size === 0) {
             continue;
         }
-        // Constrói o alias do barrel pra matching nos imports
         const barrelAliasCandidates = new Set();
         barrelAliasCandidates.add(barrelRel.replace(/\/index\.ts$/, ''));
         barrelAliasCandidates.add(barrelRel.replace(/\.ts$/, ''));
@@ -558,33 +543,27 @@ export async function reorganizarBarrelsAposMovimento(baseDir, mapa) {
         if (!analise.todosMovidos && analise.movidos.length === 0) {
             continue;
         }
-        // Caso 1: todos os exports moveram para o MESMO diretório → move o barrel junto
         if (analise.todosMovidos && analise.dirDestinoUnico) {
             const nomeBarrel = path.basename(barrelRel);
             const novoBarrelRel = path.posix.join(analise.dirDestinoUnico, nomeBarrel);
             const destBarrelAbs = path.join(srcDir, novoBarrelRel);
-            // Se o destino já tem barrel, funde (cai no Caso 2 em vez de mover)
             if (!existsSync(destBarrelAbs)) {
                 await moverBarrel(barrelRel, analise.dirDestinoUnico, srcDir);
                 barrisMovidos++;
                 movimentos.set(semExt(barrelRel), semExt(novoBarrelRel));
                 continue;
             }
-            // Fallthrough → Caso 2: remove exports e deixa criarBarrelSeNecessario fundir
         }
-        // Caso 2: alguns exports moveram → remove do barrel antigo
         if (analise.movidos.length > 0) {
             const novoConteudo = removerExportsMovidos(content, barrelRel, movimentos);
             await fsAsync.writeFile(path.join(srcDir, barrelRel), novoConteudo, 'utf-8');
             barrisModificados++;
             log.info(`Barrel atualizado (exports removidos): ${barrelRel}`);
-            // Registra exports removidos pra reparo posterior
             const perdas = new Map();
             for (const exp of analise.movidos) {
                 perdas.set(exp.resolved, exp.moveDest);
             }
             barrelsPerdidos.set(barrelRel, perdas);
-            // Registra os exports que precisam ir para os destinos
             for (const exp of analise.movidos) {
                 const dirDest = path.posix.dirname(exp.moveDest);
                 const lista = mapDestinos.get(dirDest);
@@ -595,20 +574,17 @@ export async function reorganizarBarrelsAposMovimento(baseDir, mapa) {
                     mapDestinos.set(dirDest, [exp]);
                 }
             }
-            // Se após remoção o barrel ficou vazio, apaga
             const vazio = await apagarBarrelSeVazio(barrelRel, srcDir);
             if (vazio) {
                 barrisRemovidos++;
             }
         }
     }
-    // Cria/atualiza barrels nos destinos com os exports movidos
     for (const [dirRel, exportsParaAdicionar] of mapDestinos) {
         if (await criarBarrelSeNecessario(dirRel, exportsParaAdicionar, srcDir)) {
             barrisCriados++;
         }
     }
-    // Também cria barrels para destinos que receberam arquivos mas não têm barrel ainda
     const dirsDestino = new Set();
     for (const [, destino] of movimentos) {
         dirsDestino.add(path.posix.dirname(destino));
@@ -687,8 +663,6 @@ function exportsBarrelExistentes(content) {
     }
     return exports;
 }
-/** Verifica se o barrel contém APENAS re-exports (export * from / export { } from), espaços e comentários.
- *  Barrels com imports, named exports, ou lógica customizada são considerados "curados" e NÃO devem ser alterados. */
 function barrelEhPuroReexport(content) {
     for (const linha of content.split('\n')) {
         const trimmed = linha.trim();
@@ -756,7 +730,6 @@ export async function gerarBarrels(baseDir, dryRun = false) {
         if (files.length === 0) {
             continue;
         }
-        // Filtra .d.ts que são declarações ambientes (não módulos)
         const filesModulo = [];
         for (const f of files) {
             if (f.endsWith('.d.ts')) {
@@ -775,7 +748,6 @@ export async function gerarBarrels(baseDir, dryRun = false) {
         if (filesModulo.length === 0) {
             continue;
         }
-        // Mapeia nomes de exportação para arquivos para detectar conflitos
         const nomeExportParaArquivos = new Map();
         const exportacoesPorArquivo = new Map();
         for (const f of filesModulo) {
@@ -794,9 +766,8 @@ export async function gerarBarrels(baseDir, dryRun = false) {
                     }
                 }
             }
-            catch { /* arquivo problemático, ignora */ }
+            catch { }
         }
-        // Gera linha(s) de export para um arquivo, respeitando conflitos de nome e verbatimModuleSyntax
         function gerarLinhasExportacao(filename) {
             const spec = gerarSpecExport(filename);
             const classified = exportacoesPorArquivo.get(filename);

package/dist/analysts/corrections/rewrite-testes-aliases.js

@@ -1,6 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable tipo-literal-inline-complexo
-// Justificativa: tipos locais usados internamente para parsing de caminhos
 import fsSync from 'node:fs';
 import path from 'node:path';
 const _TOP_DIRS = new Set(['analysts', 'arquitetos', 'cli', 'guardian', 'nucleo', 'reports', 'tipos', 'auto']);

package/dist/analysts/corrections/scoring-shared.js

@@ -1,7 +1,4 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { isInStringOrComment } from '../../shared/helpers/index.js';
-// Constantes de limites e valores de threshold
 export const LIMITES = {
     ASCII_EXTENDED_MIN: 128,
     CARACTERES_INCOMUNS_PADRAO: 10,
@@ -76,9 +73,6 @@ export const CONFIGURACAO_PADRAO = {
     detectarCaracteresIncomuns: true,
     limiteCaracteresIncomuns: LIMITES.CARACTERES_INCOMUNS_PADRAO
 };
-/**
- * Normaliza caracteres Unicode comuns para seus equivalentes ASCII.
- */
 export function normalizeUnicode(input) {
     let normalized = input.normalize('NFKC');
     let changed = false;
@@ -93,23 +87,15 @@ export function normalizeUnicode(input) {
         changed
     };
 }
-/**
- * Verifica se a posição está em contexto TypeScript onde ':' ou outros podem ser válidos.
- */
 export function isTypeScriptContext(src, index) {
     const before = src.substring(Math.max(0, index - LIMITES.CONTEXTO_TYPESCRIPT_LOOKBACK), index);
     const after = src.substring(index, Math.min(src.length, index + LIMITES.CONTEXTO_TYPESCRIPT_LOOKAHEAD));
     const tsPadroes = [/\?\s*:\s*$/,
-        // Ternário: a ? b :
         /:\s*\?/,
-        // Tipo opcional: prop?: string
         /\(\?\s*:\s*$/,
-        // Non-capturing group: (?:
         /interface\s+\w+\s*{/,
-        // Interface declaration
         /type\s+\w+\s*=/,
-        // Type alias
-        /<[^>]*$/ // Generics: Array<Type>
+        /<[^>]*$/
     ];
     return tsPadroes.some(pattern => pattern.test(before) || pattern.test(after));
 }
@@ -126,15 +112,12 @@ function isMarkdownOrCodePattern(text, index, matchStr) {
     if (/^{-{3,}}/.test(line.trim()) || /^\*{3,}\*/.test(line.trim())) {
         return true;
     }
-    // Ignorar blockquote markdown: > no início da linha
     if (/^>\s?/.test(line) && posInLine === 0) {
         return true;
     }
-    // Ignorar lista não-ordenada markdown: - ou * no início da linha
     if (/^[-*]\s/.test(line) && posInLine === 0) {
         return true;
     }
-    // Ignorar lista ordenada markdown: 1. 2. etc
     if (/^\d+\.\s/.test(line) && posInLine === 0) {
         return true;
     }
@@ -163,24 +146,17 @@ function isMarkdownOrCodePattern(text, index, matchStr) {
     if (matchStr === '--' || matchStr === '::' || matchStr === '**') {
         return true;
     }
-    // Ignorar linhas de tabela markdown: |---|---|
     if (/^\|.*\|$/.test(line.trim())) {
         return true;
     }
-    // Ignorar comandos com : sem espaço (licenses:notice, namespace:name)
     if (matchStr === ':' && /^[\w-]+:[\w./@-]+/.test(afterInLine.trimStart())) {
         return true;
     }
-    // CLI flags: --flag, --option=value
     if (matchStr === '--' && /^-\w/.test(afterInLine)) {
         return true;
     }
     return false;
 }
-/**
- * Colapsa pontuação repetida (ex: .. -> .) respeitando contextos de string, comentário e TypeScript.
- * Mantém até 3 caracteres para .!? (ex: !!! -> !!!), colapsa outros para único.
- */
 export function collapseRepeatedPunct(string) {
     let count = 0;
     const { text: protectedStr, placeholders } = protectSequences(string);
@@ -219,9 +195,6 @@ export function collapseRepeatedPunct(string) {
         count
     };
 }
-/**
- * Corrige espaçamento básico ao redor de pontuações comuns.
- */
 export function fixSpacingAroundPunct(string) {
     const { text: protected_s, placeholders } = protectSequences(string);
     const t1 = protected_s.replace(SPACE_BEFORE_PUNCT_RE, '$1');
@@ -255,9 +228,6 @@ function getCharacterDisplayName(ch) {
         return '';
     }
 }
-/**
- * Detecta caracteres fora do range ASCII comum.
- */
 export function detectUncommonChars(text, limite) {
     const issues = [];
     let pos = 0;
@@ -281,9 +251,6 @@ export function detectUncommonChars(text, limite) {
     }
     return issues;
 }
-/**
- * Executa a análise completa de pontuação e formatação em um texto.
- */
 export function analisarTexto(src, config = CONFIGURACAO_PADRAO) {
     const problemas = [];
     const isMarkdown = src.includes('# ') || src.includes('## ') || /^---$/.test(src.trim().split('\n')[0] || '');
@@ -332,9 +299,6 @@ export function analisarTexto(src, config = CONFIGURACAO_PADRAO) {
     }
     return problemas;
 }
-/**
- * Calcula o número da linha para uma dada posição.
- */
 export function calcularLinha(src, posOrIndex, match) {
     if (typeof posOrIndex === 'number') {
         return src.substring(0, posOrIndex).split('\n').length;