@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/cli/diagnostic/processing-helpers.js

@@ -1,12 +1,14 @@
+// SPDX-License-Identifier: MIT
 import path from 'node:path';
-import { detectarArquetipos } from '../../analysts/architects/index.js';
 import { config } from '../../core/config/index.js';
 import { messages } from '../../core/messages/index.js';
+import { detectarArquetipos } from '../../analysts/architects/index.js';
 const { log } = messages;
 let salvarEstado;
 export async function getSalvarEstado() {
-    if (salvarEstado)
+    if (salvarEstado) {
         return salvarEstado;
+    }
     const candidates = process.env.VITEST
         ? ['@shared/persistence/persistencia.js', '@shared/persistence/persistencia.ts']
         : ['@shared/persistence/persistencia.js'];
@@ -31,14 +33,14 @@ export async function getSalvarEstado() {
 const DETECTAR_TEMPO_LIMITE_MS = process.env.VITEST ? 1000 : 30000;
 export async function detectarArquetiposComTimeout(ctx, baseDir, options) {
     try {
-        const detectPromise = detectarArquetipos(ctx, baseDir, options).catch(erro => {
+        const detectPromise = detectarArquetipos(ctx, baseDir, options).catch((erro) => {
             if (config.DEV_MODE) {
                 const msg = erro instanceof Error ? erro.message : String(erro);
                 log.erro(`Falha detector arquetipos: ${msg}`);
             }
             return undefined;
         });
-        const timeoutPromise = new Promise(resolve => setTimeout(() => resolve(undefined), DETECTAR_TEMPO_LIMITE_MS));
+        const timeoutPromise = new Promise(resolve => setTimeout(() => { resolve(undefined); }, DETECTAR_TEMPO_LIMITE_MS));
         return (await Promise.race([detectPromise, timeoutPromise]));
     }
     catch {
@@ -76,7 +78,7 @@ export function computeLinguagens(fes) {
     let sem_ext = 0;
     for (const arquivo of fes || []) {
         const rel = arquivo.relPath || arquivo.fullCaminho || '';
-        const base = rel.split(/[\\/]/).pop() || '';
+        const base = rel.split(/[\\/]/).pop() ?? '';
         const idx = base.lastIndexOf('.');
         if (idx === -1) {
             sem_ext++;
@@ -99,4 +101,3 @@ export function limparOcorrencia(oc) {
         ...(oc.sugestao ? { sugestao: oc.sugestao } : {}),
     };
 }
-//# sourceMappingURL=processing-helpers.js.map

package/dist/cli/handlers/command-vulnerabilities.js

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: MIT
+import path from 'node:path';
+import { scanVulnerabilities } from '../../vulnerabilities/index.js';
+import { Command } from 'commander';
+import { getMessages } from '../../core/messages/index.js';
+import { ExitCode, sair } from '../helpers/index.js';
+const { log, CliComandoVulnerabilidadesMensagens } = getMessages();
+const msgs = CliComandoVulnerabilidadesMensagens;
+export function comandoVulnerabilidades() {
+    const cmd = new Command('vulnerabilidades').description(msgs.descricao);
+    cmd.allowUnknownOption(true);
+    cmd.allowExcessArguments(true);
+    cmd.command('scan')
+        .description(msgs.scanDescricao)
+        .option('--root <path>', 'diretório raiz (padrão: cwd)')
+        .option('--production', 'apenas dependências de produção')
+        .option('--audit-level <level>', 'nível mínimo de severidade (critical|high|moderate|low)')
+        .action(async (opts) => {
+        try {
+            const root = opts.root ? path.resolve(opts.root) : process.cwd();
+            const result = await scanVulnerabilities({
+                root,
+                production: Boolean(opts.production),
+                auditLevel: opts.auditLevel,
+            });
+            console.log(JSON.stringify(result, null, 2));
+            const { counts } = result;
+            log.info(msgs.resumoScan(result.totalVulnerabilities, counts.critical, counts.high, counts.moderate, counts.low));
+            process.exitCode = counts.critical > 0 || counts.high > 0 ? 1 : 0;
+        }
+        catch (err) {
+            log.erro(msgs.falhaScan(err instanceof Error ? err.message : String(err)));
+            sair(ExitCode.Failure);
+        }
+    });
+    return cmd;
+}

package/dist/cli/handlers/fix-types-exporter.js

@@ -1,8 +1,16 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Handler para exportação de relatórios de fix-types
+ * Gera relatórios Markdown e JSON padronizados
+ */
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { config } from '../../core/config/index.js';
 import { messages } from '../../core/messages/index.js';
 const log = messages.log;
+/**
+ * Gera relatório JSON estruturado
+ */
 async function gerarRelatorioJson(caminho, options) {
     const { casos, stats, minConfidence, verbose } = options;
     const total = stats.legitimo + stats.melhoravel + stats.corrigir;
@@ -43,9 +51,10 @@ async function gerarRelatorioJson(caminho, options) {
             confianca: elem.confianca,
             motivo: elem.motivo,
             sugestao: elem.sugestao,
-            variantes: elem.variantes || [],
+            variantes: elem.variantes ?? [],
             contexto: elem.contexto
         })),
+        // Agrupamentos úteis para análise
         analise: {
             porArquivo: agruparPorArquivo(casos),
             porCategoria: agruparPorCategoria(casos),
@@ -53,7 +62,7 @@ async function gerarRelatorioJson(caminho, options) {
                 arquivo: elem.arquivo,
                 linha: elem.linha,
                 confianca: elem.confianca,
-                sugestao: elem.sugestao || elem.motivo
+                sugestao: elem.sugestao ?? elem.motivo
             })),
             casosIncertos: casos.filter(elem => elem.confianca < 70 && elem.variantes && elem.variantes.length > 0).map(elem => ({
                 arquivo: elem.arquivo,
@@ -66,17 +75,22 @@ async function gerarRelatorioJson(caminho, options) {
     };
     await fs.writeFile(caminho, JSON.stringify(relatorio, null, 2));
 }
+/**
+ * Gera relatório Markdown legível
+ */
 async function gerarRelatorioMarkdown(caminho, options) {
     const { casos, stats, minConfidence } = options;
     const total = stats.legitimo + stats.melhoravel + stats.corrigir;
     const mediaConfianca = total > 0 ? Math.round(stats.totalConfianca / total) : 0;
     const lines = [];
+    // Cabeçalho
     lines.push('# Relatório de Análise de Tipos Inseguros');
     lines.push('');
     lines.push(`**Gerado em:** ${new Date().toISOString()}`);
     lines.push(`**Comando:** \`mahoraga fix-types\``);
     lines.push(`**Confiança Mínima:** ${minConfidence}%`);
     lines.push('');
+    // Resumo Executivo
     lines.push('## [GRAFICO] Resumo Executivo');
     lines.push('');
     lines.push(`- **Total de Casos:** ${total}`);
@@ -90,12 +104,13 @@ async function gerarRelatorioMarkdown(caminho, options) {
     lines.push(`| [AVISO] MELHORÁVEL | ${stats.melhoravel} | ${total > 0 ? Math.round(stats.melhoravel / total * 100) : 0}% | Pode ser mais específico - revisão manual recomendada |`);
     lines.push(`| [ERRO] CORRIGIR | ${stats.corrigir} | ${total > 0 ? Math.round(stats.corrigir / total * 100) : 0}% | Deve ser substituído - correção necessária |`);
     lines.push('');
+    // Casos de Alta Prioridade
     const altaPrioridade = casos.filter(elem => elem.categoria === 'corrigir' && elem.confianca >= 85);
     if (altaPrioridade.length > 0) {
         lines.push('## [ERRO] Correções de Alta Prioridade (≥85% confiança)');
         lines.push('');
         altaPrioridade.forEach((caso, idx) => {
-            lines.push(`### ${idx + 1}. ${caso.arquivo}:${caso.linha || '?'} (${caso.confianca}%)`);
+            lines.push(`### ${idx + 1}. ${caso.arquivo}:${caso.linha ?? '?'} (${caso.confianca}%)`);
             lines.push('');
             lines.push(`**Motivo:** ${caso.motivo}`);
             if (caso.sugestao) {
@@ -110,6 +125,7 @@ async function gerarRelatorioMarkdown(caminho, options) {
             lines.push('');
         });
     }
+    // Casos Incertos
     const casosIncertos = casos.filter(elem => elem.confianca < 70 && elem.variantes && elem.variantes.length > 0);
     if (casosIncertos.length > 0) {
         lines.push('## [AVISO] Casos com Análise Incerta (<70% confiança)');
@@ -117,7 +133,7 @@ async function gerarRelatorioMarkdown(caminho, options) {
         lines.push('*Estes casos requerem revisão manual cuidadosa - múltiplas possibilidades detectadas*');
         lines.push('');
         casosIncertos.forEach((caso, idx) => {
-            lines.push(`### ${idx + 1}. ${caso.arquivo}:${caso.linha || '?'} (${caso.confianca}%)`);
+            lines.push(`### ${idx + 1}. ${caso.arquivo}:${caso.linha ?? '?'} (${caso.confianca}%)`);
             lines.push('');
             lines.push(`**Motivo:** ${caso.motivo}`);
             if (caso.sugestao) {
@@ -139,18 +155,20 @@ async function gerarRelatorioMarkdown(caminho, options) {
             lines.push('');
         });
     }
+    // Lista Completa por Categoria
     lines.push('## [INFO] Lista Completa de Casos');
     lines.push('');
     for (const categoria of ['legitimo', 'melhoravel', 'corrigir']) {
         const casosPorCategoria = casos.filter(elem => elem.categoria === categoria);
-        if (casosPorCategoria.length === 0)
+        if (casosPorCategoria.length === 0) {
             continue;
+        }
         const prefixo = categoria === 'legitimo' ? '[SUCESSO]' : categoria === 'melhoravel' ? '[AVISO]' : '[ERRO]';
         const titulo = categoria.toUpperCase();
         lines.push(`### ${prefixo} ${titulo} (${casosPorCategoria.length} casos)`);
         lines.push('');
         casosPorCategoria.forEach(caso => {
-            lines.push(`- **${caso.arquivo}:${caso.linha || '?'}** (${caso.confianca}%)`);
+            lines.push(`- **${caso.arquivo}:${caso.linha ?? '?'}** (${caso.confianca}%)`);
             lines.push(`  - ${caso.motivo}`);
             if (caso.sugestao) {
                 lines.push(`  - [INFO] ${caso.sugestao}`);
@@ -160,16 +178,23 @@ async function gerarRelatorioMarkdown(caminho, options) {
     }
     await fs.writeFile(caminho, lines.join('\n'));
 }
+/**
+ * Agrupa casos por arquivo
+ */
 function agruparPorArquivo(casos) {
     return casos.reduce((acc, caso) => {
         acc[caso.arquivo] = (acc[caso.arquivo] || 0) + 1;
         return acc;
     }, {});
 }
+/**
+ * Agrupa casos por categoria
+ */
 function agruparPorCategoria(casos) {
     return casos.reduce((acc, caso) => {
-        if (!acc[caso.categoria])
+        if (!acc[caso.categoria]) {
             acc[caso.categoria] = [];
+        }
         acc[caso.categoria].push({
             arquivo: caso.arquivo,
             linha: caso.linha
@@ -177,22 +202,34 @@ function agruparPorCategoria(casos) {
         return acc;
     }, {});
 }
+/**
+ * Exporta relatórios de fix-types (Markdown e JSON)
+ *
+ * @param options - Opções de exportação
+ * @returns Caminhos dos arquivos gerados ou null em caso de erro
+ */
 export async function exportarRelatoriosFixTypes(options) {
     if (!config.REPORT_EXPORT_ENABLED) {
         return null;
     }
     try {
         const { baseDir } = options;
+        // Determinar diretório de saída
         const dir = typeof config.REPORT_OUTPUT_DIR === 'string' ? config.REPORT_OUTPUT_DIR : path.join(baseDir, 'reports');
+        // Criar diretório se não existir
         await fs.mkdir(dir, {
             recursive: true
         });
+        // Gerar timestamp único para os arquivos
         const ts = new Date().toISOString().replace(/[:.]/g, '-');
         const nomeBase = `mahoraga-fix-types-${ts}`;
+        // Gerar relatório Markdown
         const caminhoMd = path.join(dir, `${nomeBase}.md`);
         await gerarRelatorioMarkdown(caminhoMd, options);
+        // Gerar relatório JSON
         const caminhoJson = path.join(dir, `${nomeBase}.json`);
         await gerarRelatorioJson(caminhoJson, options);
+        // Log de sucesso
         log.sucesso(messages.CliExportersMensagens.fixTypes.relatoriosExportadosTitulo);
         log.info(messages.CliExportersMensagens.fixTypes.caminhoMarkdown(caminhoMd));
         log.info(messages.CliExportersMensagens.fixTypes.caminhoJson(caminhoJson));
@@ -207,4 +244,3 @@ export async function exportarRelatoriosFixTypes(options) {
         return null;
     }
 }
-//# sourceMappingURL=fix-types-exporter.js.map

package/dist/cli/handlers/guardian-exporter.js

@@ -1,8 +1,16 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Handler para exportação de relatórios do Guardian
+ * Gera relatórios Markdown e JSON padronizados
+ */
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { config } from '../../core/config/index.js';
 import { messages } from '../../core/messages/index.js';
 const log = messages.log;
+/**
+ * Gera relatório JSON estruturado
+ */
 async function gerarRelatorioJson(caminho, options) {
     const { status, baseline, drift, erros, warnings } = options;
     const relatorio = {
@@ -12,33 +20,39 @@ async function gerarRelatorioJson(caminho, options) {
             schemaVersion: '1.0.0'
         },
         status,
-        baseline: baseline || null,
-        drift: drift || null,
+        baseline: baseline ?? null,
+        drift: drift ?? null,
         issues: {
-            erros: erros || [],
-            warnings: warnings || [],
-            totalErros: erros?.length || 0,
-            totalWarnings: warnings?.length || 0
+            erros: erros ?? [],
+            warnings: warnings ?? [],
+            totalErros: erros?.length ?? 0,
+            totalWarnings: warnings?.length ?? 0
         },
         resumo: {
             integridadeOk: status === 'ok' || status === 'baseline-criada',
-            requerAtencao: (erros?.length || 0) > 0,
+            requerAtencao: (erros?.length ?? 0) > 0,
             drift: drift ? drift.alterouArquetipo : false
         }
     };
     await fs.writeFile(caminho, JSON.stringify(relatorio, null, 2));
 }
+/**
+ * Gera relatório Markdown legível
+ */
 async function gerarRelatorioMarkdown(caminho, options) {
     const { status, baseline, drift, erros, warnings } = options;
     const lines = [];
+    // Cabeçalho
     lines.push(messages.GuardianMensagens.reportTitulo);
     lines.push('');
     lines.push(`**Gerado em:** ${new Date().toISOString()}`);
     lines.push(`**Comando:** \`mahoraga guardian\``);
     lines.push('');
+    // Status
     const statusIcon = status === 'ok' ? '[SUCESSO]' : status === 'erro' ? '[ERRO]' : '[AVISO]';
     lines.push(`## ${statusIcon} Status: ${status}`);
     lines.push('');
+    // Baseline
     if (baseline) {
         lines.push(messages.GuardianMensagens.reportBaselineSection);
         lines.push('');
@@ -47,6 +61,7 @@ async function gerarRelatorioMarkdown(caminho, options) {
         lines.push('```');
         lines.push('');
     }
+    // Drift
     if (drift) {
         lines.push(messages.GuardianMensagens.reportDriftSection);
         lines.push('');
@@ -70,6 +85,7 @@ async function gerarRelatorioMarkdown(caminho, options) {
         }
         lines.push('');
     }
+    // Erros
     if (erros && erros.length > 0) {
         lines.push(messages.GuardianMensagens.reportErrosSection);
         lines.push('');
@@ -80,6 +96,7 @@ async function gerarRelatorioMarkdown(caminho, options) {
             lines.push('');
         });
     }
+    // Warnings
     if (warnings && warnings.length > 0) {
         lines.push(messages.GuardianMensagens.reportAvisosSection);
         lines.push('');
@@ -90,6 +107,7 @@ async function gerarRelatorioMarkdown(caminho, options) {
             lines.push('');
         });
     }
+    // Recomendações
     lines.push(messages.GuardianMensagens.reportRecomendacoesSection);
     lines.push('');
     if (status === 'ok') {
@@ -105,22 +123,34 @@ async function gerarRelatorioMarkdown(caminho, options) {
     }
     await fs.writeFile(caminho, lines.join('\n'));
 }
+/**
+ * Exporta relatórios do Guardian (Markdown e JSON)
+ *
+ * @param options - Opções de exportação
+ * @returns Caminhos dos arquivos gerados ou null em caso de erro
+ */
 export async function exportarRelatoriosGuardian(options) {
     if (!config.REPORT_EXPORT_ENABLED) {
         return null;
     }
     try {
         const { baseDir } = options;
+        // Determinar diretório de saída
         const dir = typeof config.REPORT_OUTPUT_DIR === 'string' ? config.REPORT_OUTPUT_DIR : path.join(baseDir, 'reports');
+        // Criar diretório se não existir
         await fs.mkdir(dir, {
             recursive: true
         });
+        // Gerar timestamp único para os arquivos
         const ts = new Date().toISOString().replace(/[:.]/g, '-');
         const nomeBase = `mahoraga-guardian-${ts}`;
+        // Gerar relatório Markdown
         const caminhoMd = path.join(dir, `${nomeBase}.md`);
         await gerarRelatorioMarkdown(caminhoMd, options);
+        // Gerar relatório JSON
         const caminhoJson = path.join(dir, `${nomeBase}.json`);
         await gerarRelatorioJson(caminhoJson, options);
+        // Log de sucesso
         log.sucesso(messages.CliExportersMensagens.guardian.relatoriosExportadosTitulo);
         log.info(messages.CliExportersMensagens.guardian.caminhoMarkdown(caminhoMd));
         log.info(messages.CliExportersMensagens.guardian.caminhoJson(caminhoJson));
@@ -135,4 +165,3 @@ export async function exportarRelatoriosGuardian(options) {
         return null;
     }
 }
-//# sourceMappingURL=guardian-exporter.js.map

package/dist/cli/handlers/index.js

@@ -1,4 +1,8 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview CLI handlers for exporters
+ */
+export * from './command-vulnerabilities.js';
 export * from './fix-types-exporter.js';
 export * from './guardian-exporter.js';
 export * from './pruning-exporter.js';
-//# sourceMappingURL=index.js.map

package/dist/cli/handlers/pruning-exporter.js

@@ -1,27 +1,50 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Handler para exportação de relatórios de poda
+ * Consolida lógica duplicada de geração de relatórios Markdown e JSON
+ */
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
+import { gerarRelatorioPodaJson, gerarRelatorioPodaMarkdown } from '../../reports/index.js';
 import { config } from '../../core/config/index.js';
 import { messages } from '../../core/messages/index.js';
-import { gerarRelatorioPodaJson, gerarRelatorioPodaMarkdown } from '../../reports/index.js';
 const log = messages.log;
+/**
+ * Exporta relatórios de poda (Markdown e JSON)
+ *
+ * Centraliza a lógica de:
+ * - Criação de diretório de relatórios
+ * - Geração de timestamp único
+ * - Exportação em ambos os formatos
+ * - Tratamento de erros
+ *
+ * @param options - Opções de exportação
+ * @returns Caminhos dos arquivos gerados ou null em caso de erro
+ */
 export async function exportarRelatoriosPoda(options) {
     if (!config.REPORT_EXPORT_ENABLED) {
         return null;
     }
     try {
         const { baseDir, podados, pendentes, simulado } = options;
+        // Determinar diretório de saída
         const dir = typeof config.REPORT_OUTPUT_DIR === 'string' ? config.REPORT_OUTPUT_DIR : path.join(baseDir, 'reports');
+        // Criar diretório se não existir
         await fs.mkdir(dir, {
             recursive: true
         });
+        // Gerar timestamp único para os arquivos
         const ts = new Date().toISOString().replace(/[:.]/g, '-');
         const nomeBase = `mahoraga-poda-${ts}`;
+        // Gerar relatório Markdown
         const caminhoMd = path.join(dir, `${nomeBase}.md`);
         await gerarRelatorioPodaMarkdown(caminhoMd, podados, pendentes, {
             simulado
         });
+        // Gerar relatório JSON
         const caminhoJson = path.join(dir, `${nomeBase}.json`);
         await gerarRelatorioPodaJson(caminhoJson, podados, pendentes);
+        // Log de sucesso
         log.sucesso(messages.CliExportersMensagens.poda.relatoriosExportados(dir));
         return {
             markdown: caminhoMd,
@@ -31,7 +54,7 @@ export async function exportarRelatoriosPoda(options) {
     }
     catch (error) {
         log.erro(messages.CliExportersMensagens.poda.falhaExportar(error.message));
+        // Re-throw para manter comportamento original do comando
         throw error;
     }
 }
-//# sourceMappingURL=pruning-exporter.js.map

package/dist/cli/helpers/display-frame.js

@@ -1,40 +1,81 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Helper para exibição segura de molduras (blocos formatados)
+ * Fornece fallback para ambientes onde log.bloco não está disponível
+ */
 import { messages } from '../../core/messages/index.js';
 import { normalizePath } from '../../shared/helpers/index.js';
 const log = messages.log;
+/**
+ * Exibe uma moldura formatada com fallback seguro
+ *
+ * Tenta usar log.bloco para exibir uma moldura estilizada.
+ * Se falhar (ambiente de teste ou log.bloco não disponível),
+ * usa fallback simples com log.info.
+ *
+ * @param titulo - Título da moldura
+ * @param linhas - Linhas de conteúdo a exibir
+ * @param fallbackFn - Função de fallback customizada (opcional)
+ * @returns true se usou moldura, false se usou fallback
+ *
+ * @example
+ * ```typescript
+ * exibirMolduraSegura('Plano de reestruturação', [
+ *   'De                  → Para',
+ *   '---  ---',
+ *   'src/old.ts          → src/new.ts',
+ * ]);
+ * ```
+ */
 export function exibirMolduraSegura(titulo, linhas, fallbackFn) {
     try {
+        // Tenta usar log.bloco (disponível em produção)
         const bloco = log.bloco(titulo, linhas);
         console.log(bloco);
         return true;
     }
     catch {
+        // Fallback: usa função customizada ou exibição simples
         if (fallbackFn) {
             fallbackFn();
         }
         else {
-            linhas.forEach(linha => log.info(messages.CliExibirMolduraMensagens.fallbackLinha(linha)));
+            // Fallback padrão: exibe linhas simples com log.info
+            linhas.forEach(linha => { log.info(messages.CliExibirMolduraMensagens.fallbackLinha(linha)); });
         }
         return false;
     }
 }
+/**
+ * Exibe moldura de plano de reestruturação com tratamento de overflow
+ *
+ * @param movimentos - Lista de movimentos (formato: { de, para })
+ * @param limite - Número máximo de linhas a exibir (padrão: 10)
+ */
 export function exibirMolduraPlano(movimentos, limite = 10) {
     const linhas = [messages.CliExibirMolduraMensagens.planoCabecalhoLinha1, messages.CliExibirMolduraMensagens.planoCabecalhoLinha2];
     const primeiros = movimentos.slice(0, limite);
     for (const metrica of primeiros) {
-        const de = normalizePath(String(metrica.de)).slice(0, 34).padEnd(34, ' ');
-        const para = normalizePath(String(metrica.para)).slice(0, 39);
+        const de = normalizePath(metrica.de).slice(0, 34).padEnd(34, ' ');
+        const para = normalizePath(metrica.para).slice(0, 39);
         linhas.push(`${de}  → ${para}`);
     }
     if (movimentos.length > limite) {
         linhas.push(messages.CliExibirMolduraMensagens.planoOverflow(movimentos.length - limite));
     }
     exibirMolduraSegura(messages.CliExibirMolduraMensagens.planoTitulo, linhas, () => {
-        primeiros.forEach(metrica => log.info(messages.CliExibirMolduraMensagens.planoFallbackLinha(metrica.de, metrica.para)));
+        primeiros.forEach(metrica => { log.info(messages.CliExibirMolduraMensagens.planoFallbackLinha(metrica.de, metrica.para)); });
         if (movimentos.length > limite) {
             log.info(messages.CliExibirMolduraMensagens.planoFallbackOverflow(movimentos.length - limite));
         }
     });
 }
+/**
+ * Exibe moldura de conflitos com tratamento de overflow
+ *
+ * @param conflitos - Lista de conflitos (formato: { alvo, motivo })
+ * @param limite - Número máximo de linhas a exibir (padrão: 10)
+ */
 export function exibirMolduraConflitos(conflitos, limite = 10) {
     const linhas = [messages.CliExibirMolduraMensagens.conflitosCabecalhoLinha1, messages.CliExibirMolduraMensagens.conflitosCabecalhoLinha2];
     const primeiros = conflitos.slice(0, limite);
@@ -57,4 +98,3 @@ export function exibirMolduraConflitos(conflitos, limite = 10) {
         }
     });
 }
-//# sourceMappingURL=display-frame.js.map

package/dist/cli/helpers/exit-codes.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export var ExitCode;
 (function (ExitCode) {
     ExitCode[ExitCode["Ok"] = 0] = "Ok";
@@ -7,10 +8,11 @@ export var ExitCode;
 })(ExitCode || (ExitCode = {}));
 export function sair(codigo) {
     if (!process.env.VITEST) {
+        // Encerra o processo imediatamente em execução normal
         process.exit(codigo);
     }
     else {
+        // Em testes, apenas sinaliza o exit code para o runner
         process.exitCode = codigo;
     }
 }
-//# sourceMappingURL=exit-codes.js.map

package/dist/cli/helpers/flags-helpers.js

@@ -1,12 +1,32 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Helpers para processamento de flags e opções CLI
+ */
+/**
+ * Parseia categorias no formato "chave=valor"
+ *
+ * Converte array de strings no formato "categoria=destino" em um mapa.
+ * Exemplo: ["controller=handlers", "model=entities"]
+ * → { "controller": "handlers", "model": "entities" }
+ *
+ * @param categoria - Array de strings no formato "chave=valor"
+ * @returns Mapa de categorias (chave minúscula → valor trimado)
+ *
+ * @example
+ * ```typescript
+ * const map = parsearCategorias(['Controller=handlers', 'Model=entities']);
+ * // { "controller": "handlers", "model": "entities" }
+ * ```
+ */
 export function parsearCategorias(categoria) {
     const map = {};
     const itemList = Array.isArray(categoria) ? categoria : [];
     for (const caminho of itemList) {
-        const [chave, valor] = String(caminho).split("=");
-        if (!chave || !valor)
+        const [chave, valor] = caminho.split("=");
+        if (!chave || !valor) {
             continue;
+        }
         map[chave.trim().toLowerCase()] = valor.trim();
     }
     return map;
 }
-//# sourceMappingURL=flags-helpers.js.map

package/dist/cli/helpers/get-files-src.js

@@ -1,6 +1,10 @@
+// SPDX-License-Identifier: MIT
 import * as fs from 'fs';
 import * as path from 'path';
 const DIRS_IGNORADOS = new Set(['node_modules', 'dist', 'names', '.git', '.mahoraga']);
+/**
+ * Lista arquivos .ts e .js recursivamente sob `dir`, ignorando pastas comuns.
+ */
 export function getSourceFiles(dir) {
     const files = [];
     let items;
@@ -12,8 +16,9 @@ export function getSourceFiles(dir) {
     }
     for (const item of items) {
         if (item.isDirectory()) {
-            if (DIRS_IGNORADOS.has(item.name))
+            if (DIRS_IGNORADOS.has(item.name)) {
                 continue;
+            }
             files.push(...getSourceFiles(path.join(dir, item.name)));
         }
         else if (item.name.endsWith('.ts') || item.name.endsWith('.js')) {
@@ -22,6 +27,9 @@ export function getSourceFiles(dir) {
     }
     return files;
 }
+/**
+ * Lista todos os arquivos com extensão `ext` (ex: ".txt") recursivamente sob `dir`.
+ */
 export function getFilesWithExtension(dir, ext) {
     const files = [];
     let items;
@@ -41,4 +49,3 @@ export function getFilesWithExtension(dir, ext) {
     }
     return files;
 }
-//# sourceMappingURL=get-files-src.js.map

package/dist/cli/helpers/index.js

@@ -1,6 +1,9 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview CLI helper utilities
+ */
 export * from './display-frame.js';
 export * from './exit-codes.js';
 export * from './flags-helpers.js';
 export * from './get-files-src.js';
 export * from './pattern-helpers.js';
-//# sourceMappingURL=index.js.map