@mocoto/mahoraga 0.14.7 → 0.14.9

package/dist/analysts/circleci/detectors/detector-circleci-performance.js

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { messages } from '../../../core/messages/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
 const MSG = messages.RelatorioCircleciMensagens;
@@ -35,7 +33,6 @@ export const detectorCircleCIPerformance = {
             return [];
         }
         const ocorrencias = [];
-        // 1. Falta de cache
         if (!/save_cache:/.test(src) && !/restore_cache:/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'circleci-missing-cache',
@@ -46,7 +43,6 @@ export const detectorCircleCIPerformance = {
                 sugestao: 'Implemente cache para dependências para reduzir drasticamente o tempo de build'
             }));
         }
-        // 2. Falta de parallelism
         if (!/parallelism:/.test(src)) {
             ocorrencias.push(criarOcorrencia({
                 tipo: 'circleci-missing-parallelism',
@@ -57,7 +53,6 @@ export const detectorCircleCIPerformance = {
                 sugestao: 'Considere usar "parallelism: N" para dividir suítes de teste longas entre múltiplos containers'
             }));
         }
-        // 3. Docker layer caching detection
         if (/docker/.test(src) && /build/.test(src) && !/docker_layer_caching/.test(src)) {
             const dockerMsg = MSG.missingDockerLayerCaching;
             const dockerSugestao = MSG.missingDockerLayerCachingSugestao;
@@ -69,7 +64,6 @@ export const detectorCircleCIPerformance = {
                 sugestao: typeof dockerSugestao === 'function' ? dockerSugestao() : dockerSugestao,
             }));
         }
-        // 4. Workspace persistence analysis
         const persistCount = (src.match(/persist_to_workspace:/g) ?? []).length;
         if (persistCount > 0) {
             const pathsMatch = src.match(/paths:\s*\n(\s+-[^\n]*\n?)*/g);
@@ -83,7 +77,6 @@ export const detectorCircleCIPerformance = {
                 }));
             }
         }
-        // 5. Test splitting detection - has test but no test splitting
         const hasTestCommand = /\b(npm test|yarn test|pnpm test|mocha|jest|rspec|pytest|go test)\b/i.test(src);
         const hasTestSplitting = /test_split|circleci tests glob|circleci tests run/i.test(src) || /parallelism:\s*[2-9]/.test(src);
         if (hasTestCommand && !hasTestSplitting) {
@@ -95,9 +88,7 @@ export const detectorCircleCIPerformance = {
                 sugestao: typeof MSG.missingTestSplittingSugestao === 'function' ? (MSG.missingTestSplittingSugestao)() : MSG.missingTestSplittingSugestao
             }));
         }
-        // 6. Sequential test jobs analysis
         const jobCountEstimate = analisarJobsSequenciais(src, relPath, ocorrencias);
-        // 7. Single executor type for all jobs
         const executorTypes = new Set();
         const machineMatch = src.match(/machine:/g);
         const dockerMatch = src.match(/(?<!image:)docker:/g);

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

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { messages } from '../../../core/messages/index.js';
 import { splitLines } from '../../../shared/helpers/index.js';
 import { criarOcorrencia } from '../../../types/index.js';

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

@@ -1,5 +1,3 @@
-// SPDX-License-Identifier: MIT
-// @mahoraga-disable ml-deep-nesting
 import { parseDocument } from 'yaml';
 import { messages } from '../../../core/messages/index.js';
 import { criarOcorrencia } from '../../../types/index.js';
@@ -53,7 +51,6 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
-            // Orb version pinning
             const orbs = config.orbs;
             if (orbs) {
                 for (const [_orbName, orbValue] of Object.entries(orbs)) {
@@ -69,7 +66,6 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
-            // Executor documentation
             const executors = config.executors;
             if (executors) {
                 for (const [_execName, execDef] of Object.entries(executors)) {
@@ -85,7 +81,6 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
-            // Command parameter analysis
             const commands = config.commands;
             if (commands) {
                 for (const [_cmdName, cmdDef] of Object.entries(commands)) {
@@ -101,7 +96,6 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
-            // Workflow count and naming
             const workflows = config.workflows;
             if (workflows) {
                 const wfNames = Object.keys(workflows);
@@ -126,7 +120,6 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
-            // Orphaned job detection
             if (jobs.jobs && workflows) {
                 const usedJobs = collectUsedJobsFromWorkflows(Object.values(workflows));
                 for (const jn of Object.keys(jobs.jobs)) {
@@ -141,7 +134,6 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
-            // Resource class pricing consideration
             if (jobs.jobs) {
                 for (const [, job] of Object.entries(jobs.jobs)) {
                     if (!('resource_class' in job) && job.steps && job.steps.length > 5) {
@@ -156,7 +148,6 @@ export const detectorCircleCIEstrutura = {
                     }
                 }
             }
-            // Compliance checks via regex
             if (!/circleci config validate|circleci config process|config validation/i.test(src)) {
                 ocorrencias.push(criarOcorrencia({
                     tipo: 'circleci-missing-config-validation',
@@ -198,7 +189,7 @@ export const detectorCircleCIEstrutura = {
                 }));
             }
         }
-        catch { /* silent parse fail */ }
+        catch { }
         return ocorrencias;
     }
 };

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

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

package/dist/analysts/circleci/index.js

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

package/dist/analysts/circleci/reports/generator-report-circleci.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/circleci/reports/index.js

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

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

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

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

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 import { splitLines } from '../../../shared/helpers/index.js';
 export function pontuarCircleCI(src, _relPath) {
     let score = 0;

package/dist/analysts/converters/converter-base.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * [REFRESH] Contrato Base para Conversores de Templates
- */
 export class ConversorBase {
     criarResultado(conteudo, avisos = [], erros = []) {
         return {

package/dist/analysts/converters/engines/converter-gha-to-gitlab.js

@@ -1,10 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
-/**
- * [LANCAMENTO] Conversor: GitHub Actions [->] GitLab CI
- *
- * Realiza o mapeamento best-effort de workflows GHA para pipelines GitLab.
- */
 import { Document, parseDocument } from 'yaml';
 import { ConversorBase } from '../converter-base.js';
 export class ConversorGhaToGitlab extends ConversorBase {
@@ -20,15 +13,12 @@ export class ConversorGhaToGitlab extends ConversorBase {
                 throw new Error(doc.errors[0].message);
             }
             const gha = doc.toJS();
-            // Estrutura inicial do GitLab CI
             const gitlab = {
                 stages: []
             };
-            // 1. Mapear variáveis globais
             if (gha.env) {
                 gitlab.variables = gha.env;
             }
-            // 2. Mapear Jobs
             if (gha.jobs) {
                 const jobs = gha.jobs;
                 const jobsEntries = Object.entries(jobs);
@@ -40,30 +30,25 @@ export class ConversorGhaToGitlab extends ConversorBase {
                         script: []
                     };
                     stagesSet.add(gitlabJob.stage);
-                    // Mapear Image (executors)
                     if (job['runs-on']) {
                         avisos.push(`Job '${jobId}': Mapeamento de 'runs-on: ${job['runs-on']}' para image do GitLab pode exigir ajuste manual.`);
                         if (job['runs-on'].includes('ubuntu')) {
                             gitlabJob.image = 'ubuntu:latest';
                         }
                     }
-                    // Mapear Steps
                     if (job.steps && Array.isArray(job.steps)) {
                         const steps = job.steps;
                         for (const step of steps) {
                             processWorkflowStep(step, jobId, gitlabJob, avisos);
                         }
                     }
-                    // Mapear dependências (needs)
                     if (job.needs) {
                         gitlabJob.needs = Array.isArray(job.needs) ? job.needs : [job.needs];
                     }
-                    // Adicionar o job ao root
                     gitlab[jobId] = gitlabJob;
                 }
                 gitlab.stages = Array.from(stagesSet);
             }
-            // Gerar YAML final
             const outputDoc = new Document(gitlab);
             return this.criarResultado(outputDoc.toString(), avisos, erros);
         }

package/dist/analysts/converters/index.js

@@ -1,14 +1,7 @@
-// SPDX-License-Identifier: MIT
-/**
- * [REFRESH] Registro Central de Conversores
- */
 import { ConversorGhaToGitlab } from './engines/converter-gha-to-gitlab.js';
 export * from './converter-base.js';
 export * from './engines/converter-gha-to-gitlab.js';
 export const registroConversores = [new ConversorGhaToGitlab()];
-/**
- * Busca um conversor compatível com as plataformas de origem e destino.
- */
 export function obterConversor(de, para) {
     return registroConversores?.find(elem => elem.de.toLowerCase() === de.toLowerCase() && elem.para.toLowerCase() === para.toLowerCase());
 }

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

@@ -12,15 +12,12 @@ export const analistaQuickFixes = {
             return [];
         }
         const ocorrencias = [];
-        // Buscar quick fixes gerais
         const quickFixes = findQuickFixes(src, undefined, undefined, relPath);
-        // Buscar quick fixes específicos por tipo de problema detectado
         const problemaTipos = ['unhandled-async', 'console-log', 'memory-leak', 'dangerous-html', 'eval-usage', 'complex-regex'];
         for (const problemTipo of problemaTipos) {
             const specificFixes = findQuickFixes(src, problemTipo, undefined, relPath);
             quickFixes.push(...specificFixes);
         }
-        // Remover duplicatas por ID
         const uniqueFixes = quickFixes.filter((fix, index, arr) => arr.findIndex(arquivo => arquivo.id === fix.id) === index);
         for (const fixResultado of uniqueFixes) {
             for (const match of fixResultado.matches) {

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

@@ -2,7 +2,6 @@ import { findQuickFixes } from '../../core/config/auto/index.js';
 import { extrairSupressoes, isRegraSuprimida } from '../../shared/helpers/index.js';
 import { analisarTexto, calcularLinha } from './scoring-shared.js';
 import { criarOcorrencia } from '../../types/index.js';
-// ─── Helpers / Config ─────────────────────────────────────────
 function mapearCategoriaNivel(category) {
     switch (category) {
         case 'security':
@@ -16,13 +15,11 @@ function mapearCategoriaNivel(category) {
             return 'info';
     }
 }
-// ─── analistaQuickFixes ───────────────────────────────────────
 export const analistaQuickFixes = {
     nome: 'quick-fixes',
     categoria: 'melhorias',
     descricao: 'Detecta problemas comuns e oferece correções automáticas',
     test: (relPath) => {
-        // Inclui SVGs para permitir quick-fixes seguros (otimização e viewBox)
         return /\.(js|jsx|ts|tsx|mjs|cjs|svg)$/.test(relPath);
     },
     aplicar: (src, relPath, _ast) => {
@@ -30,15 +27,12 @@ export const analistaQuickFixes = {
             return [];
         }
         const ocorrencias = [];
-        // Quick fixes gerais
         const quickFixes = findQuickFixes(src, undefined, undefined, relPath);
-        // Quick fixes específicos por tipo de problema detectado
         const problemaTipos = ['unhandled-async', 'console-log', 'memory-leak', 'dangerous-html', 'eval-usage', 'complex-regex'];
         for (const problemTipo of problemaTipos) {
             const specificFixes = findQuickFixes(src, problemTipo, undefined, relPath);
             quickFixes.push(...specificFixes);
         }
-        // Remover duplicatas por ID
         const uniqueFixes = quickFixes.filter((fix, index, arr) => arr.findIndex(arquivo => arquivo.id === fix.id) === index);
         for (const fixResultado of uniqueFixes) {
             for (const match of fixResultado.matches) {
@@ -71,7 +65,6 @@ function processQuickFixMatchScoring(match, fixResultado, src, relPath, ocorrenc
     ocorrenciaGenerica.matchLength = match[0].length;
     ocorrencias.push(ocorrencia);
 }
-// ─── analistaPontuacao ────────────────────────────────────────
 export const analistaPontuacao = {
     nome: 'pontuacao-fix',
     categoria: 'formatacao',
@@ -109,5 +102,4 @@ export const analistaPontuacao = {
         return ocorrencias;
     }
 };
-// ─── Exports adicionais ───────────────────────────────────────
 export const analistas = [analistaQuickFixes, analistaPontuacao];

package/dist/analysts/corrections/auto-fix-engine.js

@@ -1,15 +1,6 @@
-// SPDX-License-Identifier: MIT
-/**
- * Motor de correção automática de tipos inseguros
- * Aplica correções baseadas em análise de contexto e confiança
- */
 import { readFileSync, writeFileSync } from 'node:fs';
-/**
- * Aplica correção em um arquivo específico
- */
 export function aplicarCorrecaoArquivo(arquivo, ocorrencias, config) {
     try {
-        // Filtrar apenas ocorrências que devem ser corrigidas
         const paraCorrigir = ocorrencias.filter(ocorrencia => ocorrencia.categoria === 'corrigir' && ocorrencia.confianca >= config.minConfianca);
         if (paraCorrigir.length === 0) {
             return {
@@ -18,11 +9,9 @@ export function aplicarCorrecaoArquivo(arquivo, ocorrencias, config) {
                 linhasModificadas: 0
             };
         }
-        // Ler arquivo
         const conteudo = readFileSync(arquivo, 'utf-8');
         const linhas = conteudo.split('\n');
         let modificadas = 0;
-        // Ordenar por linha (decrescente) para não afetar números de linha
         const ordenadas = [...paraCorrigir].sort((arquivo, base) => (base.ocorrencia.linha ?? 0) - (arquivo.ocorrencia.linha ?? 0));
         for (const item of ordenadas) {
             const linha = item.ocorrencia.linha;
@@ -31,19 +20,15 @@ export function aplicarCorrecaoArquivo(arquivo, ocorrencias, config) {
             }
             const linhaIdx = linha - 1;
             const linhaOriginal = linhas[linhaIdx];
-            // Aplicar correção baseada no tipo
             let linhaCorrigida = linhaOriginal;
             if (item.ocorrencia.tipo === 'tipo-inseguro-any') {
-                // Substituir any por unknown (seguro por padrão)
                 linhaCorrigida = linhaOriginal.replace(/:\s*any\b/g, ': unknown');
                 linhaCorrigida = linhaCorrigida.replace(/\)\s*:\s*any\b/g, '): unknown');
             }
             else if (item.ocorrencia.tipo === 'tipo-inseguro-any-assertion') {
-                // Substituir as any por unknown (mais seguro)
                 linhaCorrigida = linhaOriginal.replace(/as\s+any\b/g, 'as unknown');
             }
             else if (item.ocorrencia.tipo === 'tipo-inseguro-any-cast') {
-                // Substituir <any> por <unknown>
                 linhaCorrigida = linhaOriginal.replace(/<any>/g, '<unknown>');
             }
             if (linhaCorrigida !== linhaOriginal) {
@@ -51,7 +36,6 @@ export function aplicarCorrecaoArquivo(arquivo, ocorrencias, config) {
                 modificadas++;
             }
         }
-        // Se não houve modificações, retornar sucesso
         if (modificadas === 0) {
             return {
                 sucesso: true,
@@ -60,7 +44,6 @@ export function aplicarCorrecaoArquivo(arquivo, ocorrencias, config) {
             };
         }
         const novoConteudo = linhas.join('\n');
-        // Se não é dry-run, escrever arquivo
         if (!config.dryRun) {
             writeFileSync(arquivo, novoConteudo, 'utf-8');
         }
@@ -80,9 +63,6 @@ export function aplicarCorrecaoArquivo(arquivo, ocorrencias, config) {
         };
     }
 }
-/**
- * Aplica correções em múltiplos arquivos
- */
 export function aplicarCorrecoesEmLote(porArquivo, config) {
     const resultados = [];
     let sucesso = 0;

package/dist/analysts/corrections/correction-aggregator-analyst.js

@@ -1,11 +1,9 @@
 import { analistaPontuacao, analistaQuickFixes } from './analyst-scoring.js';
-// Punto de entrada único para correções automáticas
 export const analistaCorrecaoAutomatica = {
     nome: 'correcoes-automaticas',
     categoria: 'melhorias',
     descricao: 'Agrega técnicas de correções automáticas (quick-fixes e correções de pontuação)',
     test: (relPath) => {
-        // Delegamos aos analistas internos - já tipados como Analista
         const quickFixesApplies = typeof analistaQuickFixes.test === 'function' ? analistaQuickFixes.test(relPath) : false;
         const pontuacaoApplies = typeof analistaPontuacao.test === 'function' ? analistaPontuacao.test(relPath) : false;
         return (quickFixesApplies || pontuacaoApplies);

package/dist/analysts/corrections/corrector-structure.js

@@ -1,6 +1,3 @@
-// @mahoraga-disable tipo-inseguro-unknown tipo-literal-inline-complexo ml-deep-nesting
-// SPDX-License-Identifier: MIT
-// Justificativa: unknown é usado para tipagem defensiva de erros e módulos dinâmicos
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import pLimit from 'p-limit';
@@ -11,7 +8,6 @@ import { reescreverImports } from '../../shared/helpers/index.js';
 import { mapaReversao } from './map-reversion.js';
 const { log, logAuto, CorretorEstruturaExtraMensagens } = getMessages();
 export async function corrigirEstrutura(mapa, fileEntries, baseDir = process.cwd()) {
-    // Captura dinâmica das configs (evita congelar valores em tempo de import)
     const CONCORRENCIA = config.STRUCTURE_CONCURRENCY;
     const AUTO_CORRECAO = config.STRUCTURE_AUTO_FIX;
     const rawPlugins = config.STRUCTURE_PLUGINS;
@@ -24,7 +20,6 @@ export async function corrigirEstrutura(mapa, fileEntries, baseDir = process.cwd
             return;
         }
         const origem = path.join(baseDir, arquivo);
-        // Preserva o nome do arquivo ao mover para a pasta ideal
         const nomeArquivo = path.basename(arquivo);
         const destino = path.join(baseDir, ideal, nomeArquivo);
         if (!AUTO_CORRECAO) {

package/dist/analysts/corrections/fix-alias-imports.js

@@ -40,7 +40,6 @@ export async function scanAndApplyFix(root) {
             }
         }
         catch {
-            // Fail silently on directory traversal errors.
         }
     }
     await walk(path.join(root, 'src'));

package/dist/analysts/corrections/fix-md-fences.js

@@ -1,4 +1,3 @@
-// @mahoraga-disable ml-deep-nesting
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 export function guessLang(block) {

package/dist/analysts/corrections/index.js

@@ -1,15 +1,12 @@
 import { analistaPontuacao, analistaQuickFixes } from './analyst-scoring.js';
-// Re-exporta funções de barrel
 export { mapaReversao } from './map-reversion.js';
 export { removerArquivosOrfaos } from './pruning.js';
 export { gerarBarrels, reorganizarBarrelsAposMovimento } from './reorganize-barrels.js';
-// Punto de entrada único para correções automáticas
 export const analistaCorrecaoAutomatica = {
     nome: 'correcoes-automaticas',
     categoria: 'melhorias',
     descricao: 'Agrega técnicas de correções automáticas (quick-fixes e correções de pontuação)',
     test: (relPath) => {
-        // Delegamos aos analistas internos - já tipados como Analista
         const quickFixesApplies = typeof analistaQuickFixes.test === 'function' ? analistaQuickFixes.test(relPath) : false;
         const pontuacaoApplies = typeof analistaPontuacao.test === 'function' ? analistaPontuacao.test(relPath) : false;
         return (quickFixesApplies || pontuacaoApplies);

package/dist/analysts/corrections/map-reversion.js

@@ -1,9 +1,7 @@
-// @mahoraga-disable ml-deep-nesting
-// SPDX-License-Identifier: MIT
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { messages } from '../../core/messages/index.js';
-import { SUKUNA_ARQUIVOS } from '../../core/registry/index.js';
+import { MAHORAGA_ARQUIVOS } from '../../core/registry/index.js';
 import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
 const { log, logAuto, MapaReversaoExtraMensagens } = messages;
 const CONSTANTES_MAPA = {
@@ -16,7 +14,7 @@ export class GerenciadorMapaReversao {
     mapaPath;
     mapa;
     constructor(opts) {
-        this.mapaPath = opts?.mapaPath ?? SUKUNA_ARQUIVOS.MAPA_REVERSAO;
+        this.mapaPath = opts?.mapaPath ?? MAHORAGA_ARQUIVOS.MAPA_REVERSAO;
         this.mapa = {
             versao: CONSTANTES_MAPA.VERSAO,
             moves: [],
@@ -27,9 +25,6 @@ export class GerenciadorMapaReversao {
             }
         };
     }
-    /**
-     * Carrega o mapa de reversão do disco
-     */
     async carregar() {
         try {
             this.mapa = (await lerEstado(this.mapaPath, null)) ?? {
@@ -41,7 +36,6 @@ export class GerenciadorMapaReversao {
                     podeReverter: true
                 }
             };
-            // Validação básica
             if (!Array.isArray(this.mapa.moves)) {
                 throw new Error(messages.ExcecoesMensagens.mapaReversaoCorrompido);
             }
@@ -49,13 +43,10 @@ export class GerenciadorMapaReversao {
         }
         catch (error) {
             if (error.code === 'ENOENT') {
-                // Não persistimos automaticamente um mapa vazio ao carregar: evitar efeitos colaterais
-                // (ex.: chamada a fs.mkdir) durante operações que apenas consultam o mapa.
                 logAuto.mapaReversaoNenhumEncontrado();
             }
             else {
                 logAuto.mapaReversaoErroCarregar(error.message);
-                // Reinicia com mapa vazio em caso de erro
                 this.mapa = {
                     versao: CONSTANTES_MAPA.VERSAO,
                     moves: [],
@@ -68,9 +59,6 @@ export class GerenciadorMapaReversao {
             }
         }
     }
-    /**
-     * Salva o mapa de reversão no disco
-     */
     async salvar() {
         try {
             await fs.mkdir(path.dirname(this.mapaPath), {
@@ -83,12 +71,7 @@ export class GerenciadorMapaReversao {
             logAuto.mapaReversaoErroSalvar(error.message);
         }
     }
-    /**
-     * Registra um novo move no mapa de reversão
-     */
-    async registrarMove(origem, destino, motivo, conteudoOriginal, conteudoFinal, 
-    // quando true, evita persistir o mapa no disco imediatamente (útil para chamadas em massa/tests)
-    skipSalvar) {
+    async registrarMove(origem, destino, motivo, conteudoOriginal, conteudoFinal, skipSalvar) {
         try {
             const id = `move_${Date.now()}_${Math.random().toString(CONSTANTES_MAPA.RADIX_36).slice(CONSTANTES_MAPA.ID_OFFSET, CONSTANTES_MAPA.ID_OFFSET + CONSTANTES_MAPA.ID_LENGTH)}`;
             const move = {
@@ -97,8 +80,6 @@ export class GerenciadorMapaReversao {
                 origem,
                 destino,
                 motivo,
-                // Considera que imports foram reescritos se houver conteúdo original
-                // fornecido (testes esperam que passar conteudoOriginal permita restauração)
                 importsReescritos: !!conteudoOriginal || !!conteudoFinal && conteudoOriginal !== conteudoFinal,
                 conteudoOriginal,
                 conteudoFinal
@@ -106,7 +87,6 @@ export class GerenciadorMapaReversao {
             this.mapa.moves.push(move);
             this.mapa.metadata.totalMoves = this.mapa.moves.length;
             this.mapa.metadata.ultimoMove = move.timestamp;
-            // Persiste no disco por padrão; caller pode optar por adiar a persistência
             if (!skipSalvar) {
                 await this.salvar();
             }
@@ -118,9 +98,6 @@ export class GerenciadorMapaReversao {
             throw err;
         }
     }
-    /**
-     * Remove um move do mapa de reversão
-     */
     async removerMove(id) {
         try {
             const indice = this.mapa.moves.findIndex((move) => move.id === id);
@@ -138,28 +115,16 @@ export class GerenciadorMapaReversao {
             return false;
         }
     }
-    /**
-     * Obtém todos os moves registrados
-     */
     obterMoves() {
         return [...this.mapa.moves];
     }
-    /**
-     * Obtém moves por arquivo
-     */
     obterMovesPorArquivo(arquivo) {
         return this.mapa.moves.filter((move) => move.origem === arquivo || move.destino === arquivo);
     }
-    /**
-     * Verifica se um arquivo pode ser revertido
-     */
     podeReverterArquivo(arquivo) {
         const moves = this.obterMovesPorArquivo(arquivo);
         return moves.length > 0;
     }
-    /**
-     * Reverte um move específico
-     */
     async reverterMove(id, baseDir = process.cwd()) {
         const move = this.mapa.moves.find((metrica) => metrica.id === id);
         if (!move) {
@@ -172,11 +137,9 @@ export class GerenciadorMapaReversao {
             await fs.mkdir(path.dirname(origemCaminho), {
                 recursive: true
             });
-            // Move o arquivo de volta
             if (!await this.reverterComConteudo(move, origemCaminho, destinoCaminho)) {
                 return false;
             }
-            // Remove o move do mapa
             await this.removerMove(id);
             return true;
         }
@@ -185,18 +148,13 @@ export class GerenciadorMapaReversao {
             return false;
         }
     }
-    /**
-     * Reverte todos os moves de um arquivo
-     */
     async reverterArquivo(arquivo, baseDir = process.cwd()) {
         const moves = this.obterMovesPorArquivo(arquivo);
         if (moves.length === 0) {
             logAuto.mapaReversaoNenhumMove(arquivo);
             return false;
         }
-        // Reverte do mais recente para o mais antigo
         const movesOrdenados = moves.sort((arquivo, base) => new Date(base.timestamp).getTime() - new Date(arquivo.timestamp).getTime());
-        // Retorna true se pelo menos um move foi revertido com sucesso
         let revertedContagem = 0;
         try {
             for (const move of movesOrdenados) {
@@ -212,15 +170,11 @@ export class GerenciadorMapaReversao {
         }
         return revertedContagem > 0;
     }
-    /**
-     * Lista moves em formato legível
-     */
     listarMoves() {
         if (this.mapa.moves.length === 0) {
             return MapaReversaoExtraMensagens.nenhumMoveRegistrado;
         }
         let resultado = MapaReversaoExtraMensagens.tituloMapa.replace('{total}', String(this.mapa.moves.length));
-        // Ordena por timestamp (mais recente primeiro)
         const movesOrdenados = [...this.mapa.moves].sort((arquivo, base) => new Date(base.timestamp).getTime() - new Date(arquivo.timestamp).getTime());
         for (const move of movesOrdenados) {
             const dataFormatada = new Date(move.timestamp).toLocaleString('pt-BR');
@@ -232,9 +186,6 @@ export class GerenciadorMapaReversao {
         }
         return resultado;
     }
-    /**
-     * Limpa o mapa de reversão
-     */
     async limpar() {
         try {
             this.mapa.moves = [];
@@ -300,5 +251,4 @@ export class GerenciadorMapaReversao {
         return true;
     }
 }
-// Instância global
 export const mapaReversao = new GerenciadorMapaReversao();