@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/core/messages/pt/reports/report-templates.js

@@ -1,5 +1,13 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Templates reutilizáveis para geração de relatórios Markdown
+ * Funções que geram seções completas de MD com formatação consistente
+ */
 import { formatMs } from '../../../config/index.js';
 import { RelatorioMensagens } from './report-messages.js';
+/**
+ * Gera o cabeçalho padrão do relatório Markdown
+ */
 export function gerarHeaderRelatorio(metadados) {
     const lines = [];
     const { principal } = RelatorioMensagens;
@@ -12,6 +20,7 @@ export function gerarHeaderRelatorio(metadados) {
     lines.push('');
     lines.push(RelatorioMensagens.comum.separadores.secao);
     lines.push('');
+    // Se houver manifest
     if (metadados.manifestFile && metadados.relatoriosDir) {
         lines.push(`**${principal.secoes.metadados.arquivoManifest}:** \`${metadados.manifestFile}\`  `);
         lines.push('');
@@ -22,6 +31,9 @@ export function gerarHeaderRelatorio(metadados) {
     }
     return lines;
 }
+/**
+ * Gera a seção Guardian do relatório
+ */
 export function gerarSecaoGuardian(guardian) {
     const lines = [];
     const { guardian: msg } = RelatorioMensagens.principal.secoes;
@@ -35,6 +47,9 @@ export function gerarSecaoGuardian(guardian) {
     lines.push('');
     return lines;
 }
+/**
+ * Gera tabela de resumo por tipo
+ */
 export function gerarTabelaResumoTipos(tiposContagem, limite = 10) {
     const lines = [];
     const { resumoTipos } = RelatorioMensagens.principal.secoes;
@@ -51,6 +66,9 @@ export function gerarTabelaResumoTipos(tiposContagem, limite = 10) {
     lines.push('');
     return lines;
 }
+/**
+ * Gera tabela de ocorrências
+ */
 function escapeMarkdownTableCell(value) {
     return value.replace(/\\/g, '\\\\').replace(/\|/g, '\\|');
 }
@@ -62,15 +80,18 @@ export function gerarTabelaOcorrencias(ocorrencias) {
     lines.push(`| ${msg.colunas.arquivo} | ${msg.colunas.linha} | ${msg.colunas.nivel}  | ${msg.colunas.mensagem} |`);
     lines.push('|---|---|---|---|');
     for (const ocorrencia of ocorrencias) {
-        const arquivo = String(ocorrencia.relPath || '');
+        const arquivo = (ocorrencia.relPath ?? '');
         const linha = ocorrencia.linha ? String(ocorrencia.linha) : '';
-        const nivel = String(ocorrencia.nivel || '');
-        const mensagem = escapeMarkdownTableCell(String(ocorrencia.mensagem || ''));
+        const nivel = (ocorrencia.nivel ?? '');
+        const mensagem = escapeMarkdownTableCell((ocorrencia.mensagem ?? ''));
         lines.push(`| ${arquivo} | ${linha} | ${nivel} | ${mensagem} |`);
     }
     lines.push('');
     return lines;
 }
+/**
+ * Gera seção de problemas agrupados (para filtro inteligente)
+ */
 export function gerarSecaoProblemasAgrupados(titulo, problemas, mostrarExemplos = true) {
     const lines = [];
     const { labels } = RelatorioMensagens.resumo;
@@ -90,6 +111,7 @@ export function gerarSecaoProblemasAgrupados(titulo, problemas, mostrarExemplos
             lines.push(`**${labels.acaoSugerida}:** ${prob.acaoSugerida}  `);
         }
         lines.push('');
+        // Mostrar até 3 exemplos
         if (mostrarExemplos && prob.ocorrencias.length > 0) {
             lines.push(`**${labels.exemplos}:**`);
             const exemplos = prob.ocorrencias.slice(0, 3);
@@ -108,6 +130,9 @@ export function gerarSecaoProblemasAgrupados(titulo, problemas, mostrarExemplos
     }
     return lines;
 }
+/**
+ * Gera tabela genérica de duas colunas
+ */
 export function gerarTabelaDuasColunas(dados, cabecalhos) {
     const lines = [];
     lines.push(`| ${cabecalhos[0]} | ${cabecalhos[1]} |`);
@@ -118,6 +143,9 @@ export function gerarTabelaDuasColunas(dados, cabecalhos) {
     lines.push('');
     return lines;
 }
+/**
+ * Gera seção de estatísticas
+ */
 export function gerarSecaoEstatisticas(stats) {
     const lines = [];
     const { estatisticas } = RelatorioMensagens.principal.secoes;
@@ -129,6 +157,9 @@ export function gerarSecaoEstatisticas(stats) {
     lines.push('');
     return lines;
 }
+/**
+ * Gera footer do relatório
+ */
 export function gerarFooterRelatorio(timestampISO) {
     const lines = [];
     lines.push(RelatorioMensagens.comum.separadores.secao);
@@ -140,8 +171,10 @@ export function gerarFooterRelatorio(timestampISO) {
     lines.push('');
     return lines;
 }
+/**
+ * Helper para escrever arquivo MD completo
+ */
 export async function escreverRelatorioMarkdown(outputCaminho, lines) {
     const { salvarEstado } = await import('../../../../shared/persistence/index.js');
     await salvarEstado(outputCaminho, lines.join('\n'));
 }
-//# sourceMappingURL=report-templates.js.map

package/dist/core/messages/pt/reports/streaming-report-messages.js

@@ -1,4 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const StreamingRelatorioMensagens = {
     jaFinalizado: 'RelatorioStream já finalizado',
 };
-//# sourceMappingURL=streaming-report-messages.js.map

package/dist/core/messages/pt/shared/index.js

@@ -1,6 +1,9 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Mensagens Compartilhadas: Plugin Registry, Plugin Core
+ */
 export * from './marketplace-messages.js';
 export * from './plugin-core-messages.js';
 export * from './plugin-registry-messages.js';
 export * from './shared-common-messages.js';
 export * from './stylelint-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/pt/shared/marketplace-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const MarketplaceRemoteMensagens = {
     httpStatus: (status) => `HTTP ${status}`,
     githubApiHttpStatus: (status) => `GitHub API HTTP ${status}`,
@@ -8,4 +9,3 @@ export const MarketplaceRemoteMensagens = {
     caminhoPacote: (caminho) => `  Caminho: ${caminho}`,
     categoriaPacote: (categoria) => `  Categoria: ${categoria}`,
 };
-//# sourceMappingURL=marketplace-messages.js.map

package/dist/core/messages/pt/shared/plugin-core-messages.js

@@ -1,7 +1,9 @@
+/**
+ * Messages for plugin core (Portuguese).
+ */
 export const PluginCoreMensagens = {
     phpParse: '[ELEPHANT] PHP pseudo-parse: {classes} classes, {funcoes} funções',
     phpErro: '[AVISO] Erro ao parsear PHP: {erro}',
     pythonParse: '[SNAKE] Python pseudo-parse: {classes} classes, {funcoes} funções',
     pythonErro: '[AVISO] Erro ao parsear Python: {erro}',
 };
-//# sourceMappingURL=plugin-core-messages.js.map

package/dist/core/messages/pt/shared/plugin-registry-messages.js

@@ -1,3 +1,6 @@
+/**
+ * Messages for plugin registry (Portuguese).
+ */
 export const PluginRegistryMensagens = {
     extensaoSobrescrita: '[AVISO] Extensão {ext} já mapeada para plugin {existente}, sobrescrevendo com {novo}',
     pluginRegistrado: '[OK] Plugin {nome} registrado com extensões: {extensoes}',
@@ -8,4 +11,3 @@ export const PluginRegistryMensagens = {
     suporteAtualizado: '[GLOBE] Suporte a linguagens atualizado',
     cacheLimpo: '[BROOM] Cache do registry limpo',
 };
-//# sourceMappingURL=plugin-registry-messages.js.map

package/dist/core/messages/pt/shared/shared-common-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const SharedCommonMensagens = {
     frameworkDetect: {
         discordjs: 'Discord.js',
@@ -31,4 +32,3 @@ export const SharedCommonMensagens = {
     exclusaoInsegura: (padroes) => `[AVISO] Alguns padrões de exclusão foram considerados inseguros e foram ignorados: ${padroes}`,
     correcaoSugerida: (tipo) => `Correção sugerida: ${tipo}`,
 };
-//# sourceMappingURL=shared-common-messages.js.map

package/dist/core/messages/pt/shared/stylelint-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const StylelintMensagens = {
     comentarioCSS: 'Comentário // detectado em CSS. Use /* */ para comentários CSS válidos.',
     important: 'Uso de !important detectado. Evite !important para facilitar manutenção.',
@@ -16,4 +17,3 @@ export const StylelintMensagens = {
     importantSugestao: 'Revise se !important é realmente necessário ou se pode usar especificidade.',
     propVendorPrefixed: (prop) => `Propriedade com prefixo vendor: ${prop}. Verificar necessidade.`,
 };
-//# sourceMappingURL=stylelint-messages.js.map

package/dist/core/messages/pt/ui/filter-config.js

@@ -1,5 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Configurações centralizadas para o filtro inteligente de relatórios
+ * Define prioridades, agrupamentos e categorização de problemas
+ */
 import { ICONES_ARQUIVO, ICONES_DIAGNOSTICO, ICONES_FEEDBACK } from '../../shared/icons.js';
+// ─── PRIORIDADES POR TIPO DE PROBLEMA ─────────────────────────
 export const PRIORIDADES = {
+    // Críticos - Segurança e dados
     PROBLEMA_SEGURANCA: {
         prioridade: 'critica',
         icone: '[LOCK]',
@@ -15,6 +22,7 @@ export const PRIORIDADES = {
         icone: '[LOCK]',
         descricao: 'Credenciais hardcoded ou expostas'
     },
+    // Altos - Código frágil e bugs
     CODIGO_FRAGIL: {
         prioridade: 'alta',
         icone: '[AVISO]',
@@ -45,6 +53,7 @@ export const PRIORIDADES = {
         icone: '[STATS]',
         descricao: 'Complexidade ciclomática alta'
     },
+    // Médios - Manutenibilidade e padrões
     PROBLEMA_DOCUMENTACAO: {
         prioridade: 'media',
         icone: '[DOC]',
@@ -70,6 +79,7 @@ export const PRIORIDADES = {
         icone: '[BUILD]',
         descricao: 'Análise arquitetural'
     },
+    // Baixos - Informativo e melhorias
     CONSTRUCOES_SINTATICAS: {
         prioridade: 'baixa',
         icone: '[SYNTAX]',
@@ -111,7 +121,9 @@ export const PRIORIDADES = {
         descricao: 'Tecnologias alternativas sugeridas'
     }
 };
+// ─── AGRUPAMENTOS INTELIGENTES POR PADRÃO DE MENSAGEM ─────────
 export const AGRUPAMENTOS_MENSAGEM = [
+    // Segurança Crítica
     {
         padrao: /token hardcoded|senha hardcoded|chave hardcoded|api.*key.*hardcoded/i,
         categoria: 'SEGURANCA_HARDCODED',
@@ -127,6 +139,7 @@ export const AGRUPAMENTOS_MENSAGEM = [
         icone: '[ERRO]',
         acaoSugerida: 'Aplicar sanitização e validação de entrada'
     },
+    // Código Frágil (Alta)
     {
         padrao: /tipo.*inseguro.*any|any.*inseguro|unsafe.*any/i,
         categoria: 'TIPOS_ANY_INSEGUROS',
@@ -156,6 +169,7 @@ export const AGRUPAMENTOS_MENSAGEM = [
         icone: '[LINK]',
         acaoSugerida: 'Revisar dependências e aplicar padrões de desacoplamento'
     },
+    // Manutenibilidade (Média)
     {
         padrao: /missing-jsdoc|missing documentation|sem documentação|no.*documentation/i,
         categoria: 'DOCUMENTACAO_AUSENTE',
@@ -185,6 +199,7 @@ export const AGRUPAMENTOS_MENSAGEM = [
         icone: '[SIZE]',
         acaoSugerida: 'Dividir em funções menores e mais coesas'
     },
+    // Baixa prioridade
     {
         padrao: /todo|fixme|hack|workaround/i,
         categoria: 'TAREFAS_PENDENTES',
@@ -201,6 +216,10 @@ export const AGRUPAMENTOS_MENSAGEM = [
         acaoSugerida: 'Substituir por constantes nomeadas'
     }
 ];
+// ─── HELPERS ──────────────────────────────────────────────────
+/**
+ * Obtém a prioridade de um tipo de problema
+ */
 export function getPrioridade(tipo) {
     return PRIORIDADES[tipo] || {
         prioridade: 'baixa',
@@ -208,6 +227,9 @@ export function getPrioridade(tipo) {
         descricao: 'Problema não categorizado'
     };
 }
+/**
+ * Encontra agrupamento por mensagem
+ */
 export function findAgrupamento(mensagem) {
     for (const grupo of AGRUPAMENTOS_MENSAGEM) {
         if (grupo.padrao.test(mensagem)) {
@@ -216,6 +238,9 @@ export function findAgrupamento(mensagem) {
     }
     return null;
 }
+/**
+ * Ordena problemas por prioridade
+ */
 export function ordenarPorPrioridade(problemas) {
     const ordem = {
         critica: 0,
@@ -224,11 +249,14 @@ export function ordenarPorPrioridade(problemas) {
         baixa: 3
     };
     return [...problemas].sort((arquivo, base) => {
-        const prioA = arquivo.prioridade || 'baixa';
-        const prioB = base.prioridade || 'baixa';
+        const prioA = arquivo.prioridade ?? 'baixa';
+        const prioB = base.prioridade ?? 'baixa';
         return ordem[prioA] - ordem[prioB];
     });
 }
+/**
+ * Conta problemas por prioridade
+ */
 export function contarPorPrioridade(problemas) {
     const contagem = {
         critica: 0,
@@ -237,9 +265,8 @@ export function contarPorPrioridade(problemas) {
         baixa: 0
     };
     for (const prob of problemas) {
-        const prio = prob.prioridade || 'baixa';
+        const prio = prob.prioridade ?? 'baixa';
         contagem[prio]++;
     }
     return contagem;
 }
-//# sourceMappingURL=filter-config.js.map

package/dist/core/messages/pt/ui/index.js

@@ -1,5 +1,8 @@
+// SPDX-License-Identifier: MIT
+/**
+ * UI: Ícones, Sugestões, Filtros
+ */
 export * from '../../shared/icons.js';
 export * from './filter-config.js';
 export * from './suggestions.js';
 export * from './suggestions-contextuais-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/pt/ui/suggestions-contextuais-messages.js

@@ -1,3 +1,10 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Mensagens para sugestões contextuais na interface do usuário.
+ * Fornece templates de texto com ícones para feedback de identificação de
+ * projetos, evidências de dependências, imports, padrões de código,
+ * estrutura de diretórios e tecnologias alternativas.
+ */
 import { ICONES_ACAO, ICONES_ARQUIVO, ICONES_FEEDBACK } from '../../shared/icons.js';
 export const SugestoesContextuaisMensagens = {
     arquetipoNaoIdentificado: 'Não foi possível identificar um arquétipo específico. Considere adicionar mais estrutura ao projeto.',
@@ -10,4 +17,3 @@ export const SugestoesContextuaisMensagens = {
     erroAnaliseContextual: (erro) => `Erro na análise contextual: ${erro}`,
     erroDuranteAnalise: 'Erro durante análise contextual inteligente'
 };
-//# sourceMappingURL=suggestions-contextuais-messages.js.map

package/dist/core/messages/pt/ui/suggestions.js

@@ -1,4 +1,19 @@
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-literal-inline-complexo
+// Justificativa: tipos inline para sistema de sugestões
+/**
+ * Sistema Centralizado de Sugestões e Dicas
+ *
+ * Centraliza TODAS as sugestões contextuais do Mahoraga:
+ * - Dicas de uso de comandos
+ * - Sugestões baseadas em contexto
+ * - Mensagens de ajuda rápida
+ * - Call-to-action para diferentes cenários
+ */
 import { ICONES } from '../../shared/icons.js';
+/**
+ * Sugestões gerais de comandos
+ */
 export const SUGESTOES_COMANDOS = {
     usarFull: `${ICONES.feedback.dica} Use --full para relatório detalhado com todas as informações`,
     usarJson: `${ICONES.feedback.dica} Use --json para saída estruturada em JSON`,
@@ -13,6 +28,9 @@ export const SUGESTOES_COMANDOS = {
     usarBaseline: `${ICONES.feedback.dica} Use --baseline para gerar baseline de referência`,
     usarAutoFix: `${ICONES.feedback.dica} Use --auto-fix para aplicar correções automáticas`,
 };
+/**
+ * Sugestões de diagnóstico
+ */
 export const SUGESTOES_DIAGNOSTICO = {
     modoExecutivo: `${ICONES.diagnostico.executive} Modo executivo: mostrando apenas problemas críticos`,
     primeiraVez: [
@@ -30,6 +48,9 @@ export const SUGESTOES_DIAGNOSTICO = {
     ],
     usarFiltros: `${ICONES.feedback.dica} Use filtros --include/--exclude para análise focada`,
 };
+/**
+ * Sugestões de auto-fix
+ */
 export const SUGESTOES_AUTOFIX = {
     autoFixDisponivel: `${ICONES.feedback.dica} Correções automáticas disponíveis - use --auto-fix`,
     autoFixAtivo: `${ICONES.feedback.atencao} Auto-fix ativo! Use --dry-run para simular sem modificar arquivos`,
@@ -41,6 +62,9 @@ export const SUGESTOES_AUTOFIX = {
         `${ICONES.feedback.dica} Execute npm test para validar funcionalidades`,
     ],
 };
+/**
+ * Sugestões de Guardian
+ */
 export const SUGESTOES_GUARDIAN = {
     guardianDesabilitado: `${ICONES.comando.guardian} Guardian desativado. Use --guardian para verificar integridade`,
     primeiroBaseline: [
@@ -54,6 +78,9 @@ export const SUGESTOES_GUARDIAN = {
     ],
     integridadeOK: `${ICONES.nivel.sucesso} Integridade verificada - nenhuma mudança não autorizada`,
 };
+/**
+ * Sugestões de tipos (fix-types)
+ */
 export const SUGESTOES_TIPOS = {
     ajustarConfianca: (atual) => `${ICONES.feedback.dica} Use --confidence <num> para ajustar o limiar (atual: ${atual}%)`,
     revisar: (categoria) => `${ICONES.feedback.dica} Revise os casos ${categoria} manualmente`,
@@ -64,6 +91,9 @@ export const SUGESTOES_TIPOS = {
     unknownLegitimo: `${ICONES.nivel.sucesso} Usos legítimos de 'unknown' identificados`,
     melhoravelDisponivel: `${ICONES.feedback.dica} Casos melhoráveis encontrados - revisar em refatoração futura`,
 };
+/**
+ * Sugestões de arquetipos
+ */
 export const SUGESTOES_ARQUETIPOS = {
     monorepo: [
         `${ICONES.feedback.dica} Monorepo detectado: considere usar filtros por workspace`,
@@ -91,6 +121,9 @@ export const SUGESTOES_ARQUETIPOS = {
         `${ICONES.feedback.dica} Use --criar-arquetipo --salvar-arquetipo para personalizar`,
     ],
 };
+/**
+ * Sugestões de reestruturação
+ */
 export const SUGESTOES_REESTRUTURAR = {
     backupRecomendado: [
         `${ICONES.feedback.importante} IMPORTANTE: Faça backup antes de reestruturar!`,
@@ -102,6 +135,9 @@ export const SUGESTOES_REESTRUTURAR = {
     ],
     usarDryRun: `${ICONES.feedback.dica} Primeira vez? Use --dry-run para ver mudanças propostas`,
 };
+/**
+ * Sugestões de poda
+ */
 export const SUGESTOES_PODAR = {
     cuidado: [
         `${ICONES.feedback.atencao} Poda remove arquivos permanentemente!`,
@@ -110,6 +146,9 @@ export const SUGESTOES_PODAR = {
     revisar: `${ICONES.feedback.dica} Revise a lista de arquivos antes de confirmar`,
     usarDryRun: `${ICONES.feedback.dica} Use --dry-run para simular poda sem deletar`,
 };
+/**
+ * Sugestões de métricas
+ */
 export const SUGESTOES_METRICAS = {
     baseline: [
         `${ICONES.feedback.dica} Gere baseline para comparações futuras`,
@@ -118,6 +157,9 @@ export const SUGESTOES_METRICAS = {
     tendencias: `${ICONES.feedback.dica} Execute regularmente para acompanhar tendências`,
     comparacao: `${ICONES.feedback.dica} Compare com execuções anteriores`,
 };
+/**
+ * Sugestões de zeladores
+ */
 export const SUGESTOES_ZELADOR = {
     imports: [
         `${ICONES.feedback.dica} Zelador de imports corrige caminhos automaticamente`,
@@ -128,8 +170,12 @@ export const SUGESTOES_ZELADOR = {
         `${ICONES.feedback.dica} Configure padrões em mahoraga.config.json`,
     ],
 };
+/**
+ * Sugestões contextuais - função helper
+ */
 export function gerarSugestoesContextuais(contexto) {
     const sugestoes = [];
+    // Sugestões por comando
     switch (contexto.comando) {
         case 'diagnosticar':
             if (!contexto.temProblemas) {
@@ -166,6 +212,7 @@ export function gerarSugestoesContextuais(contexto) {
             sugestoes.push(...SUGESTOES_PODAR.cuidado);
             break;
     }
+    // Sugestões por arquétipo
     if (contexto.arquetipo) {
         switch (contexto.arquetipo) {
             case 'monorepo':
@@ -187,9 +234,13 @@ export function gerarSugestoesContextuais(contexto) {
     }
     return sugestoes;
 }
+/**
+ * Formata sugestões para exibição
+ */
 export function formatarSugestoes(sugestoes, titulo = 'Sugestões') {
-    if (sugestoes.length === 0)
+    if (sugestoes.length === 0) {
         return [];
+    }
     const linhas = ['', `┌── ${titulo} ${'─'.repeat(50)}`.slice(0, 70)];
     for (const sugestao of sugestoes) {
         linhas.push(`  ${sugestao}`);
@@ -198,6 +249,9 @@ export function formatarSugestoes(sugestoes, titulo = 'Sugestões') {
     linhas.push('');
     return linhas;
 }
+/**
+ * Export consolidado
+ */
 export const SUGESTOES = {
     comandos: SUGESTOES_COMANDOS,
     diagnostico: SUGESTOES_DIAGNOSTICO,
@@ -210,4 +264,3 @@ export const SUGESTOES = {
     metricas: SUGESTOES_METRICAS,
     zelador: SUGESTOES_ZELADOR,
 };
-//# sourceMappingURL=suggestions.js.map

package/dist/core/messages/shared/icons.js

@@ -1,3 +1,14 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Sistema Centralizado de Prefixos e Cores ANSI (sem emojis)
+ *
+ * Centraliza TODOS os prefixos textuais e cores usados no Mahoraga para:
+ * - Consistência visual em toda aplicação
+ * - Fácil customização (pode trocar tudo aqui)
+ * - Suporte robusto em CI/CD, terminais simples e Windows CMD
+ * - Import dinâmico e tree-shaking
+ */
+// Códigos ANSI de cores
 const CORES = {
     RESET: '\x1b[0m',
     VERDE: '\x1b[32m',
@@ -6,6 +17,9 @@ const CORES = {
     VERMELHO: '\x1b[31m',
     CINZA: '\x1b[37m',
 };
+/**
+ * Níveis de severidade - prefixos com cores ANSI
+ */
 export const ICONES_NIVEL = {
     sucesso: `${CORES.VERDE}SUCESSO${CORES.RESET}`,
     info: `${CORES.AZUL}INFO${CORES.RESET}`,
@@ -14,6 +28,9 @@ export const ICONES_NIVEL = {
     critico: `${CORES.VERMELHO}ERRO${CORES.RESET}`,
     debug: `${CORES.CINZA}DEBUG${CORES.RESET}`,
 };
+/**
+ * Ícones de estado/status
+ */
 export const ICONES_STATUS = {
     ok: '[OK]',
     falha: '[FALHA]',
@@ -22,6 +39,9 @@ export const ICONES_STATUS = {
     pausado: '[||]',
     pulado: '[>>]',
 };
+/**
+ * Ícones de ações/operações
+ */
 export const ICONES_ACAO = {
     analise: '[SCAN]',
     correcao: '[FIX]',
@@ -38,6 +58,9 @@ export const ICONES_ACAO = {
     copiar: '[COPY]',
     renomear: '[RENAME]',
 };
+/**
+ * Ícones de arquivos/estrutura
+ */
 export const ICONES_ARQUIVO = {
     arquivo: '[FILE]',
     diretorio: '[DIR]',
@@ -51,6 +74,9 @@ export const ICONES_ARQUIVO = {
     typescript: '[TS]',
     javascript: '[JS]',
 };
+/**
+ * Ícones de feedback/dicas
+ */
 export const ICONES_FEEDBACK = {
     dica: '[DICA]',
     atencao: '[!]',
@@ -60,6 +86,9 @@ export const ICONES_FEEDBACK = {
     celebracao: '[!]',
     foguete: '[>]',
 };
+/**
+ * Ícones de diagnóstico
+ */
 export const ICONES_DIAGNOSTICO = {
     inicio: '[SCAN]',
     progresso: '[...]',
@@ -73,6 +102,9 @@ export const ICONES_DIAGNOSTICO = {
     info: '[INFO]',
     sucesso: '[OK]',
 };
+/**
+ * Ícones de tipos/qualidade
+ */
 export const ICONES_TIPOS = {
     any: `${CORES.VERMELHO}[ANY]${CORES.RESET}`,
     unknown: `${CORES.AMARELO}[?]${CORES.RESET}`,
@@ -82,6 +114,9 @@ export const ICONES_TIPOS = {
     seguro: '[OK]',
     inseguro: '[!]',
 };
+/**
+ * Ícones de comandos específicos
+ */
 export const ICONES_COMANDO = {
     diagnosticar: '[SCAN]',
     reestruturar: '[ORG]',
@@ -93,6 +128,9 @@ export const ICONES_COMANDO = {
     atualizar: '[UPD]',
     perf: '[PERF]',
 };
+/**
+ * Ícones de relatórios
+ */
 export const ICONES_RELATORIO = {
     resumo: '[SUMMARY]',
     detalhado: '[DETAIL]',
@@ -103,6 +141,9 @@ export const ICONES_RELATORIO = {
     error: `${CORES.VERMELHO}[ERR]${CORES.RESET}`,
     success: `${CORES.VERDE}[OK]${CORES.RESET}`,
 };
+/**
+ * Ícones de zeladores
+ */
 export const ICONES_ZELADOR = {
     inicio: '[START]',
     sucesso: `${CORES.VERDE}[OK]${CORES.RESET}`,
@@ -115,6 +156,9 @@ export const ICONES_ZELADOR = {
     dryRun: '[DRY]',
     estatistica: '[STATS]',
 };
+/**
+ * Função helper para obter prefixo/cor baseado na categoria
+ */
 export function getIcone(categoria, nome) {
     switch (categoria) {
         case 'nivel':
@@ -127,9 +171,17 @@ export function getIcone(categoria, nome) {
             return '[*]';
     }
 }
+/**
+ * Detecta se ambiente suporta cores ANSI (agora sempre retorna true)
+ */
 export function suportaCores() {
+    // A partir de agora, assumimos sempre cores ANSI disponíveis
+    // ou o terminal remove as sequências automaticamente
     return true;
 }
+/**
+ * Objeto consolidado para export fácil
+ */
 export const ICONES = {
     nivel: ICONES_NIVEL,
     status: ICONES_STATUS,
@@ -145,4 +197,6 @@ export const ICONES = {
 export const ICONES_CENTRAL = ICONES;
 export const ICONES_DIAGNOSTICO_CENTRAL = ICONES_DIAGNOSTICO;
 export const ICONES_ZELADOR_CENTRAL = ICONES_ZELADOR;
-//# sourceMappingURL=icons.js.map
+/**
+ * Export default para uso simplificado
+ */

package/dist/core/messages/shared/index.js

@@ -1,2 +1,5 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Shared message icons
+ */
 export * from './icons.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/zh/analysts/analyst-commands-cli-messages.js

@@ -1,3 +1,9 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview CLI 命令分析器的诊断消息。
+ * 提供文本模板,用于检测重复命令、匿名处理程序、
+ * 缺少错误处理以及 CLI 命令文件中的其他不良实践。
+ */
 function comandoLabel(comandoNome) {
     return comandoNome ? ` "${comandoNome}"` : "";
 }
@@ -11,4 +17,3 @@ export const ComandosCliMensagens = {
     handlerSemFeedback: (comandoNome) => `命令${comandoLabel(comandoNome)} 的处理程序既没有日志记录也没有响应用户。请考虑添加反馈/日志。`,
     multiplosComandos: (count) => `此文件中注册了多个命令(${count}个)。请考虑将每个命令拆分到独立模块中以便于维护。`
 };
-//# sourceMappingURL=analyst-commands-cli-messages.js.map