@mocoto/mahoraga 0.14.8 → 0.15.0

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

@@ -1,17 +1,8 @@
-// @mahoraga-disable ml-deep-nesting
-// 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;
@@ -55,7 +46,6 @@ async function gerarRelatorioJson(caminho, options) {
             variantes: elem.variantes ?? [],
             contexto: elem.contexto
         })),
-        // Agrupamentos úteis para análise
         analise: {
             porArquivo: agruparPorArquivo(casos),
             porCategoria: agruparPorCategoria(casos),
@@ -76,22 +66,17 @@ 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}`);
@@ -105,7 +90,6 @@ 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)');
@@ -126,7 +110,6 @@ 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)');
@@ -156,7 +139,6 @@ 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']) {
@@ -179,18 +161,12 @@ 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) => {
         acc[caso.categoria].push({
@@ -200,34 +176,22 @@ function agruparPorCategoria(casos) {
         return acc;
     }, { legitimo: [], melhoravel: [], corrigir: [] });
 }
-/**
- * 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));

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

@@ -1,17 +1,8 @@
-// @mahoraga-disable ml-deep-nesting
-// 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 = {
@@ -37,23 +28,17 @@ 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 { 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('');
@@ -62,7 +47,6 @@ async function gerarRelatorioMarkdown(caminho, options) {
         lines.push('```');
         lines.push('');
     }
-    // Drift
     if (drift) {
         lines.push(messages.GuardianMensagens.reportDriftSection);
         lines.push('');
@@ -86,7 +70,6 @@ async function gerarRelatorioMarkdown(caminho, options) {
         }
         lines.push('');
     }
-    // Erros
     if (erros && erros.length > 0) {
         lines.push(messages.GuardianMensagens.reportErrosSection);
         lines.push('');
@@ -97,7 +80,6 @@ async function gerarRelatorioMarkdown(caminho, options) {
             lines.push('');
         });
     }
-    // Warnings
     if (warnings && warnings.length > 0) {
         lines.push(messages.GuardianMensagens.reportAvisosSection);
         lines.push('');
@@ -108,7 +90,6 @@ async function gerarRelatorioMarkdown(caminho, options) {
             lines.push('');
         });
     }
-    // Recomendações
     lines.push(messages.GuardianMensagens.reportRecomendacoesSection);
     lines.push('');
     if (status === 'ok') {
@@ -124,34 +105,22 @@ 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));

package/dist/cli/handlers/index.js

@@ -1,7 +1,3 @@
-// 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';

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

@@ -1,50 +1,27 @@
-// 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';
 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,
@@ -54,7 +31,6 @@ 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;
     }
 }

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

@@ -1,58 +1,22 @@
-// @mahoraga-disable ml-deep-nesting
-// 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 {
-            // 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);
@@ -71,12 +35,6 @@ export function exibirMolduraPlano(movimentos, limite = 10) {
         }
     });
 }
-/**
- * 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);

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

@@ -1,4 +1,3 @@
-// SPDX-License-Identifier: MIT
 export var ExitCode;
 (function (ExitCode) {
     ExitCode[ExitCode["Ok"] = 0] = "Ok";
@@ -8,11 +7,9 @@ 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;
     }
 }

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

@@ -1,23 +1,3 @@
-// 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 : [];

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

@@ -1,10 +1,6 @@
-// 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;
@@ -27,9 +23,6 @@ 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;

package/dist/cli/helpers/index.js

@@ -1,7 +1,3 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview CLI helper utilities
- */
 export * from './display-frame.js';
 export * from './exit-codes.js';
 export * from './flags-helpers.js';

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

@@ -1,59 +1,17 @@
-// SPDX-License-Identifier: MIT
-/**
- * Helpers para processamento de padrões glob (include/exclude)
- */
-/**
- * Processa lista de padrões raw (com vírgulas, espaços, duplicatas)
- *
- * Normaliza entrada de usuário removendo duplicatas e espaços vazios.
- * Aceita padrões separados por vírgulas ou espaços.
- *
- * @param raw - Array de strings raw do usuário
- * @returns Array normalizado sem duplicatas e vazio
- *
- * @example
- * ```typescript
- * processPatternList(['*.ts, *.js', '  *.md  '])
- * // ['*.ts', '*.js', '*.md']
- * ```
- */
 export function processPatternList(raw) {
     if (!raw?.length) {
         return [];
     }
     return Array.from(new Set(raw.flatMap(raiz => raiz.split(/[\s,]+/)).map(string => string.trim()).filter(Boolean)));
 }
-/**
- * Expande padrões de include adicionando variações glob
- *
- * Para padrões não-glob (sem metacaracteres), adiciona automaticamente:
- * - `pattern/**` - Todos os arquivos dentro
- * - `** /pattern/**` - Pattern em qualquer nível (se não tiver `/` ou `\`)
- *
- * @param list - Lista de padrões processados
- * @returns Lista expandida com variações
- *
- * @example
- * ```typescript
- * expandIncludePatterns(['src', '*.ts'])
- * // ['src', 'src/**', '** /src/**', '*.ts']
- * //        ^           ^
- * //        |           |
- * //    dentro de src  src em qualquer nível
- * ```
- */
 export function expandIncludePatterns(list) {
     const META = /[\\*\?\{\}\[\]]/;
     const out = new Set();
     for (const caminho of list) {
-        // Sempre adiciona o padrão original
         out.add(caminho);
-        // Se não tem metacaracteres glob, expande
         if (!META.test(caminho)) {
-            // Adiciona pattern/** (todos os arquivos dentro)
             const withoutTrailing = caminho.replace(/\\+$/, '').replace(/\/+$/, '');
             out.add(`${withoutTrailing}/**`);
-            // Se não tem separador de caminho, adiciona **/pattern/** (qualquer nível)
             if (!caminho.includes('/') && !caminho.includes('\\')) {
                 out.add(`**/${caminho}/**`);
             }

package/dist/cli/options/flags-validator.js

@@ -1,17 +1,4 @@
-// SPDX-License-Identifier: MIT
-/**
- * [ALVO] Validação e Normalização de Flags do Comando Diagnosticar
- *
- * Sistema robusto para:
- * - Validar flags e detectar conflitos
- * - Normalizar aliases e atalhos
- * - Aplicar defaults inteligentes
- * - Gerar avisos e sugestões contextuais
- */
 import { messages } from '../../core/messages/index.js';
-/**
-* Defaults seguros
-*/
 const PADROES = {
     mode: 'compact',
     output: {
@@ -52,16 +39,11 @@ const PADROES = {
         verifyCycles: false
     },
 };
-/**
- * Valida e normaliza flags do comando diagnosticar
- */
 export function validateAndNormalizeFlags(opts) {
     const errors = [];
     const warnings = [];
     const normalized = JSON.parse(JSON.stringify(PADROES));
-    // ─── 1. MODO DE OPERAÇÃO (mutuamente exclusivo) ───────────────
     const modesAtivos = [opts.full && 'full', opts.executive && 'executive', opts.quick && 'quick'].filter((x) => typeof x === 'string');
-    // Trust compiler: reduz falsos positivos quando TS/ESLint não reportam erros
     const optsExt = opts;
     if (optsExt.trustCompiler) {
         normalized.special = {
@@ -81,7 +63,6 @@ export function validateAndNormalizeFlags(opts) {
     else if (modesAtivos.length === 1) {
         normalized.mode = modesAtivos[0];
     }
-    // ─── 2. FORMATO DE SAÍDA ──────────────────────────────────────
     const formatosAtivos = [opts.json && 'json', opts.markdown && 'markdown'].filter(Boolean);
     if (formatosAtivos.length > 1) {
         errors.push(messages.CliFlagsValidatorMensagens.conflitoFormatos(formatosAtivos.join(', ')));
@@ -89,22 +70,19 @@ export function validateAndNormalizeFlags(opts) {
     else if (formatosAtivos.length === 1) {
         normalized.output.format = formatosAtivos[0];
     }
-    // JSON ASCII escaping
     if (opts.jsonAscii) {
         normalized.output.jsonAscii = true;
     }
-    // Export
     if (opts.export) {
         normalized.output.export = true;
     }
     if (opts.exportFull) {
         normalized.output.exportFull = true;
-        normalized.output.export = true; // exportFull implica export
+        normalized.output.export = true;
     }
     if (opts.exportTo) {
         normalized.output.exportDir = opts.exportTo;
     }
-    // ─── 3. FILTROS ───────────────────────────────────────────────
     if (opts.include && opts.include.length > 0) {
         normalized.filters.include = opts.include;
     }
@@ -120,18 +98,15 @@ export function validateAndNormalizeFlags(opts) {
     if (opts.withNodeModules) {
         normalized.filters.includeNodeModules = true;
     }
-    // onlySrc é exclusivo com include customizado
     if (opts.onlySrc && normalized.filters.include.length > 0) {
         warnings.push(messages.CliFlagsValidatorMensagens.onlySrcIgnorado);
     }
     else if (opts.onlySrc) {
         normalized.filters.include = ['src/**'];
     }
-    // ─── 4. AUTO-FIX ──────────────────────────────────────────────
     if (opts.fix || opts.autoFix) {
         normalized.autoFix.enabled = true;
     }
-    // Modo de auto-fix (prioridade: autoFixMode > fixMode > flags individuais)
     let modoAutoCorrecao;
     if (opts.autoCorrecaoMode) {
         modoAutoCorrecao = opts.autoCorrecaoMode;
@@ -154,24 +129,20 @@ export function validateAndNormalizeFlags(opts) {
             warnings.push(messages.CliFlagsValidatorMensagens.modoAutoFixInvalido(modoAutoCorrecao));
         }
     }
-    // Dry run
     if (opts.dryRun) {
         normalized.autoFix.dryRun = true;
     }
-    // ─── 5. GUARDIAN ──────────────────────────────────────────────
     if (opts.guardian || opts.guardianCheck) {
         normalized.guardian.enabled = true;
     }
     if (opts.guardianFull) {
         normalized.guardian.fullScan = true;
-        normalized.guardian.enabled = true; // fullScan implica enabled
+        normalized.guardian.enabled = true;
     }
     if (opts.guardianBaseline) {
         normalized.guardian.saveBaseline = true;
-        normalized.guardian.enabled = true; // saveBaseline implica enabled
+        normalized.guardian.enabled = true;
     }
-    // ─── 6. VERBOSIDADE ───────────────────────────────────────────
-    // ─── 7. PERFORMANCE ───────────────────────────────────────────
     if (optsExt.fast) {
         if (normalized.performance) {
             normalized.performance.fastMode = true;
@@ -201,7 +172,6 @@ export function validateAndNormalizeFlags(opts) {
             warnings.push(messages.CliFlagsValidatorMensagens.nivelLogInvalido(opts.logNivel));
         }
     }
-    // ─── 8. ESPECIAIS ─────────────────────────────────────────────
     if (opts.listarAnalistas) {
         normalized.special.listarAnalistas = true;
     }
@@ -210,10 +180,9 @@ export function validateAndNormalizeFlags(opts) {
     }
     if (opts.salvarArquetipo) {
         normalized.special.salvarArquetipo = true;
-        normalized.special.criarArquetipo = true; // salvar implica criar
+        normalized.special.criarArquetipo = true;
         warnings.push(messages.CliFlagsValidatorMensagens.salvarArquetipoImplicaCriar);
     }
-    // ─── RESULTADO ────────────────────────────────────────────────
     return {
         valid: errors.length === 0,
         errors,
@@ -221,31 +190,23 @@ export function validateAndNormalizeFlags(opts) {
         normalized
     };
 }
-/**
- * Gera sugestões contextuais baseadas nas flags ativas
- */
 export function gerarSugestoes(flags) {
     const sugestoes = [];
-    // Modo
     if (flags.mode === 'compact') {
         sugestoes.push(messages.CliFlagsValidatorMensagens.sugestaoFull);
     }
     else if (flags.mode === 'executive') {
         sugestoes.push(messages.CliFlagsValidatorMensagens.sugestaoExecutive);
     }
-    // Export
     if (!flags.output.export && flags.output.format === 'json') {
         sugestoes.push(messages.CliFlagsValidatorMensagens.sugestaoJsonExport);
     }
-    // Auto-fix
     if (flags.autoFix.enabled && !flags.autoFix.dryRun) {
         sugestoes.push(messages.CliFlagsValidatorMensagens.sugestaoAutoFixDryRun);
     }
-    // Guardian
     if (!flags.guardian.enabled) {
         sugestoes.push(messages.CliFlagsValidatorMensagens.sugestaoGuardian);
     }
-    // Filtros
     if (flags.filters.include.length === 0) {
         sugestoes.push(messages.CliFlagsValidatorMensagens.sugestaoInclude);
     }

package/dist/cli/options/index.js

@@ -1,5 +1 @@
-// SPDX-License-Identifier: MIT
-/**
- * @fileoverview CLI options and flag validation
- */
 export * from './flags-validator.js';