@mocoto/mahoraga 0.14.0 → 0.14.1

package/dist/core/messages/zh/log/log-helper.js

@@ -1,24 +1,40 @@
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-literal-inline-complexo
+// Justification: inline types for logging system
+/**
+ * 统一日志辅助系统
+ * 整合 log-helpers.ts 和 log-helpers-inteligente.ts
+ * 消除重复并通过 log-engine 集中逻辑
+ */
 import { config } from '../../../config/index.js';
 import { ICONES_ARQUIVO, ICONES_DIAGNOSTICO, ICONES_FEEDBACK, ICONES_STATUS } from '../../shared/index.js';
 import { logEngine } from './log-engine.js';
 import { LogMensagens } from './log-messages.js';
+/**
+ * 具有统一垃圾控制的分析师日志系统
+ */
 export const logAnalistas = {
     ultimoProgressoGlobal: 0,
     contadorArquivos: 0,
     totalArquivos: 0,
     ultimoEmitMs: 0,
+    /** 初始化分析批次 */
     iniciarBatch(totalArquivos) {
         this.totalArquivos = totalArquivos;
         this.contadorArquivos = 0;
         this.ultimoProgressoGlobal = 0;
         this.ultimoEmitMs = 0;
+        // 仅在复杂/详细模式下使用 logEngine 进行一致格式化
         if (logEngine.contexto === 'complexo' || config.VERBOSE) {
             logEngine.log('info', LogMensagens.analistas.execucao.inicio_detalhado, {
                 totalArquivos: totalArquivos.toString()
             });
         }
+        // 在简单模式下,不发出冗余消息 (进度已显示)
     },
+    /** 分析师开始日志 (现在仅注册) */
     iniciandoAnalista(nomeAnalista, arquivo, tamanho) {
+        // [MUTE] 反垃圾: 仅在特定上下文中记录单个分析师
         const deveLogarIndividual = logEngine.contexto === 'complexo' || config.DEV_MODE || process.env.VERBOSE === 'true';
         if (deveLogarIndividual) {
             logEngine.log('debug', LogMensagens.analistas.execucao.inicio_detalhado, {
@@ -28,12 +44,14 @@ export const logAnalistas = {
             });
         }
     },
+    /** 文件处理完毕时递增计数器 */
     arquivoProcessado() {
         this.contadorArquivos++;
         if (logEngine.contexto !== 'complexo' && !config.DEV_MODE) {
             this.logProgressoGrupado();
         }
     },
+    /** 分析师完成日志 */
     concluido(nomeAnalista, arquivo, ocorrencias, duracao) {
         const deveLogarIndividual = logEngine.contexto === 'complexo' || config.DEV_MODE || process.env.VERBOSE === 'true';
         if (deveLogarIndividual) {
@@ -44,11 +62,15 @@ export const logAnalistas = {
             });
         }
     },
+    /** 智能分组进度日志 */
     logProgressoGrupado() {
         const porcentagem = Math.round(this.contadorArquivos / this.totalArquivos * 100);
         const agora = Date.now();
+        // 自适应密度: 小型项目 5%,大型项目 10%
         const passo = this.totalArquivos < 200 ? 5 : 10;
+        // 频率限制: 每秒最多 2 次更新
         const minIntervalMs = 500;
+        // 在自适应间隔更新进度,带反垃圾
         if (porcentagem - this.ultimoProgressoGlobal >= passo || this.contadorArquivos === this.totalArquivos) {
             if (agora - this.ultimoEmitMs >= minIntervalMs || this.contadorArquivos === this.totalArquivos) {
                 logEngine.log('info', `${ICONES_DIAGNOSTICO.progresso} 进度: {arquivosProcessados}/{totalArquivos} ({percentual}%)`, {
@@ -61,6 +83,7 @@ export const logAnalistas = {
             }
         }
     },
+    /** 完成分析批次 */
     finalizarBatch(totalOcorrencias, duracaoTotal) {
         if (logEngine.contexto === 'simples') {
             logEngine.log('info', `${ICONES_STATUS.ok} 分析已完成 - 发现 {totalOcorrencias} 个问题`, {
@@ -74,18 +97,21 @@ export const logAnalistas = {
             });
         }
     },
+    /** 超时始终重要 - 使用 logEngine */
     timeout(nomeAnalista, duracao) {
         logEngine.log('aviso', LogMensagens.analistas.execucao.timeout, {
             analista: nomeAnalista,
             tempo: duracao.toString()
         });
     },
+    /** 错误始终重要 - 使用 logEngine */
     erro(nomeAnalista, erro) {
         logEngine.log('erro', LogMensagens.analistas.execucao.erro, {
             analista: nomeAnalista,
             erro
         });
     },
+    /** 复杂项目的性能 */
     performance(dados) {
         if (logEngine.contexto === 'complexo' || config.DEV_MODE) {
             logEngine.log('info', LogMensagens.analistas.metricas.performance, {
@@ -95,6 +121,9 @@ export const logAnalistas = {
         }
     }
 };
+/**
+ * Logging system for scanner (now via logEngine)
+ */
 export const logVarredor = {
     iniciarVarredura(diretorio) {
         if (logEngine.contexto !== 'simples') {
@@ -105,7 +134,7 @@ export const logVarredor = {
     },
     progresso(diretorio, arquivos) {
         if (logEngine.contexto === 'complexo' || config.VERBOSE) {
-            const nomeDiretorio = diretorio.split('/').pop() || diretorio;
+            const nomeDiretorio = diretorio.split('/').pop() ?? diretorio;
             logEngine.log('info', LogMensagens.scanner.progresso, {
                 diretorio: nomeDiretorio,
                 arquivos: arquivos.toString()
@@ -127,6 +156,9 @@ export const logVarredor = {
         });
     }
 };
+/**
+ * Logging system for the main system (via logEngine)
+ */
 export const logSistema = {
     inicializacao() {
         if (logEngine.contexto !== 'simples') {
@@ -142,6 +174,7 @@ export const logSistema = {
         const detalhesStr = detalhes ? ` - ${detalhes}` : '';
         logEngine.log('erro', `${ICONES_STATUS.falha} 错误: ${mensagem}${detalhesStr}`, {});
     },
+    // Auto fixes
     autoFixNenhumaCorrecao() {
         logEngine.log('info', LogMensagens.sistema.correcoes.nenhuma_disponivel, {});
     },
@@ -195,6 +228,7 @@ export const logSistema = {
             erro
         });
     },
+    // Diagnostic processing
     processamentoFixDetectada() {
         logEngine.log('info', LogMensagens.sistema.processamento.fix_detectada, {});
     },
@@ -267,6 +301,7 @@ export const logSistema = {
             quantidade: quantidade.toString()
         });
     },
+    // System update
     atualizacaoExecutando(comando) {
         logEngine.log('info', LogMensagens.sistema.atualizacao.executando, {
             comando
@@ -283,6 +318,7 @@ export const logSistema = {
             detalhe
         });
     },
+    // Performance
     performanceRegressaoDetectada(limite) {
         logEngine.log('aviso', LogMensagens.sistema.performance.regressao_detectada, {
             limite: limite.toString()
@@ -291,12 +327,14 @@ export const logSistema = {
     performanceSemRegressoes() {
         logEngine.log('info', LogMensagens.sistema.performance.sem_regressoes, {});
     },
+    // Pruning
     podaCancelada() {
         logEngine.log('info', LogMensagens.sistema.poda.cancelada, {});
     },
     podaConcluida() {
         logEngine.log('info', LogMensagens.sistema.poda.concluida, {});
     },
+    // Reversal
     reversaoNenhumMove(arquivo) {
         logEngine.log('erro', LogMensagens.sistema.reversao.nenhum_move, {
             arquivo
@@ -318,6 +356,9 @@ export const logSistema = {
         });
     }
 };
+/**
+ * Logging system for filters (via logEngine)
+ */
 export const logFiltros = {
     incluindo(pattern, matches) {
         if (config.VERBOSE || logEngine.contexto === 'complexo') {
@@ -344,6 +385,9 @@ export const logFiltros = {
         }
     }
 };
+/**
+ * Logging system for project (via logEngine)
+ */
 export const logProjeto = {
     detectado(tipo, confianca) {
         logEngine.log('info', LogMensagens.projeto.detectado, {
@@ -383,12 +427,15 @@ export const logProjeto = {
         }
     }
 };
+/**
+ * Logging system for occurrences (via logEngine)
+ */
 export const logOcorrencias = {
     critica(mensagem, arquivo, linha) {
         logEngine.log('erro', LogMensagens.ocorrencias.critica, {
             mensagem,
             arquivo,
-            linha: linha?.toString() || ''
+            linha: linha?.toString() ?? ''
         });
     },
     resumo(total, criticos, avisos) {
@@ -399,6 +446,9 @@ export const logOcorrencias = {
         });
     }
 };
+/**
+ * Logging system for reports (via logEngine)
+ */
 export const logRelatorio = {
     gerado(caminho, formato) {
         logEngine.log('info', `${ICONES_ARQUIVO.arquivo} ${formato} 报告已生成: ${caminho}`, {});
@@ -421,7 +471,11 @@ export const logRelatorio = {
         logEngine.log('aviso', LogMensagens.relatorio.funcoes_longas, {});
     }
 };
+/**
+ * Logging system for automation (via logEngine)
+ */
 export const logAuto = {
+    // Reversal map
     mapaReversaoErroCarregar(erro) {
         logEngine.log('erro', LogMensagens.sistema.auto.mapa_reversao.erro_carregar, {
             erro
@@ -480,6 +534,7 @@ export const logAuto = {
     mapaReversaoNenhumEncontrado() {
         logEngine.log('info', LogMensagens.sistema.auto.mapa_reversao.nenhum_encontrado, {});
     },
+    // Pruning
     podaNenhumArquivo() {
         logEngine.log('info', LogMensagens.sistema.auto.poda.nenhum_arquivo, {});
     },
@@ -498,6 +553,7 @@ export const logAuto = {
             arquivo
         });
     },
+    // Structure corrector
     corretorErroCriarDiretorio(destino, erro) {
         logEngine.log('erro', LogMensagens.sistema.auto.corretor.erro_criar_diretorio, {
             destino,
@@ -516,6 +572,7 @@ export const logAuto = {
             erro
         });
     },
+    // Specific plugin
     pluginIgnorado(plugin, erro) {
         logEngine.log('aviso', LogMensagens.auto.plugin_ignorado, {
             plugin,
@@ -539,6 +596,9 @@ export const logAuto = {
         });
     }
 };
+/**
+ * Logging system for Guardian (via logEngine)
+ */
 export const logGuardian = {
     integridadeOk() {
         logEngine.log('info', LogMensagens.guardian.integridade_ok, {});
@@ -566,6 +626,7 @@ export const logGuardian = {
     avisosEncontrados() {
         logEngine.log('aviso', LogMensagens.guardian.avisos_encontrados, {});
     },
+    // Guardian command specific
     fullScanAviso() {
         logEngine.log('aviso', LogMensagens.guardian.full_scan_aviso, {});
     },
@@ -612,6 +673,7 @@ export const logGuardian = {
             erro
         });
     },
+    // Generic method for other Guardian messages
     info(mensagem) {
         logEngine.log('info', `${ICONES_FEEDBACK.info} ${mensagem}`, {});
     },
@@ -619,6 +681,9 @@ export const logGuardian = {
         logEngine.log('aviso', `${ICONES_FEEDBACK.atencao} ${mensagem}`, {});
     }
 };
+/**
+ * Wise advisor for developer well-being
+ */
 export const logConselheiro = {
     volumeAlto() {
         logEngine.log('aviso', LogMensagens.conselheiro.volume_alto, {});
@@ -635,6 +700,9 @@ export const logConselheiro = {
         });
     }
 };
+/**
+ * Logging system for Metrics
+ */
 export const logMetricas = {
     execucoesRegistradas(quantidade) {
         logEngine.log('info', LogMensagens.metricas.execucoes_registradas, {
@@ -645,35 +713,38 @@ export const logMetricas = {
         logEngine.log('aviso', LogMensagens.metricas.nenhum_historico, {});
     }
 };
+/**
+ * Logging system for Core (parsing, etc.)
+ */
 export const logCore = {
     erroBabel(erro, arquivo) {
         logEngine.log('debug', LogMensagens.core.parsing.erro_babel, {
             erro,
-            arquivo: arquivo || 'unknown'
+            arquivo: arquivo ?? 'unknown'
         });
     },
     erroTs(erro, arquivo) {
         logEngine.log('debug', LogMensagens.core.parsing.erro_ts, {
             erro,
-            arquivo: arquivo || 'unknown'
+            arquivo: arquivo ?? 'unknown'
         });
     },
     erroCss(erro, arquivo) {
         logEngine.log('debug', LogMensagens.core.parsing.erro_css, {
             erro,
-            arquivo: arquivo || 'unknown'
+            arquivo: arquivo ?? 'unknown'
         });
     },
     erroXml(erro, arquivo) {
         logEngine.log('debug', LogMensagens.core.parsing.erro_xml, {
             erro,
-            arquivo: arquivo || 'unknown'
+            arquivo: arquivo ?? 'unknown'
         });
     },
     erroHtml(erro, arquivo) {
         logEngine.log('debug', LogMensagens.core.parsing.erro_html, {
             erro,
-            arquivo: arquivo || 'unknown'
+            arquivo: arquivo ?? 'unknown'
         });
     },
     nenhumParser(extensao) {
@@ -697,6 +768,7 @@ export const logCore = {
             erro
         });
     },
+    // Plugins
     erroCarregarPlugin(nome, erro) {
         logEngine.log('debug', LogMensagens.core.plugins.erro_carregar, {
             nome,
@@ -739,4 +811,3 @@ export const logCore = {
         });
     }
 };
-//# sourceMappingURL=log-helper.js.map

package/dist/core/messages/zh/log/log-messages.js

@@ -1,3 +1,8 @@
+// SPDX-License-Identifier: MIT
+/**
+ * 集中化上下文日志消息系统
+ * 自动适应项目类型和复杂度
+ */
 import { ICONES_ACAO, ICONES_ARQUIVO, ICONES_COMANDO, ICONES_DIAGNOSTICO, ICONES_FEEDBACK, ICONES_NIVEL, ICONES_RELATORIO, ICONES_STATUS } from '../../shared/icons.js';
 export const LogMensagens = {
     sistema: {
@@ -76,7 +81,7 @@ export const LogMensagens = {
             erros_criticos: `${ICONES_RELATORIO.error} 发现 {total} 个严重错误 - 请优先处理`,
             avisos_encontrados: `${ICONES_RELATORIO.warning} 发现 {total} 个警告`,
             quick_fixes_muitos: `${ICONES_ACAO.correcao} 有 {total} 个自动修正可用:`,
-            quick_fixes_comando: '   → MAHORAGA_ALLOW_MUTATE_FS=1 npm run diagnosticar --fix',
+            quick_fixes_comando: '   → SUKUNA_ALLOW_MUTATE_FS=1 npm run diagnosticar --fix',
             quick_fixes_executar: '   (命令已就绪可运行)',
             todos_muitos: `${ICONES_RELATORIO.lista} 发现 {total} 个 TODO - 建议使用 --include 聚焦特定区域`,
             todos_poucos: `${ICONES_RELATORIO.lista} 发现 {total} 个 TODO - 控制良好!`,
@@ -96,8 +101,10 @@ export const LogMensagens = {
     },
     analistas: {
         execucao: {
+            // 小型项目的简单日志
             inicio_simples: `${ICONES_DIAGNOSTICO.inicio} 正在分析 {arquivo}`,
             sucesso_simples: `${ICONES_STATUS.ok} {arquivo}: {ocorrencias} 个问题`,
+            // 大型项目的详细日志
             inicio_detalhado: `${ICONES_DIAGNOSTICO.inicio} 在 {arquivo} ({tamanho}kb) 上运行 '{analista}'`,
             sucesso_detalhado: `${ICONES_STATUS.ok} '{analista}' 完成: {ocorrencias} 个出现项 ({tempo}ms)`,
             timeout: `${ICONES_FEEDBACK.atencao} 分析员 '{analista}' 超时,已耗时 {tempo}ms`,
@@ -159,6 +166,7 @@ export const LogMensagens = {
         modo_permissivo: `${ICONES_DIAGNOSTICO.guardian} ${ICONES_NIVEL.aviso} 宽松模式: 继续操作,风险自负。`,
         scan_only: `${ICONES_DIAGNOSTICO.guardian} ${ICONES_NIVEL.info} 仅扫描模式: 已映射 {arquivos} 个文件。`,
         avisos_encontrados: `${ICONES_DIAGNOSTICO.guardian} ${ICONES_NIVEL.aviso} 存在警告级别的出现项`,
+        // Guardian 命令
         full_scan_aviso: `${ICONES_NIVEL.aviso} --full-scan 已激活: 扩展范围的基线将不会持久化。`,
         full_scan_warning_baseline: `${ICONES_NIVEL.aviso} --full-scan 已激活,但将创建临时扩展范围的基线。`,
         aceitando_baseline: `\n${ICONES_COMANDO.atualizar} 正在接受新的完整性基线...\n`,
@@ -210,31 +218,41 @@ export const LogMensagens = {
         }
     }
 };
+/**
+ * 适应不同项目类型的上下文配置
+ */
 export const LogContextConfiguracao = {
+    // 简单项目: 文件少,一个开发者
     simples: {
         nivel_detalhamento: 'basico',
         mostrar_performance: false,
         mostrar_cache: false,
         mostrar_workers: false,
         formato_arquivo: 'nome_apenas',
+        // 仅文件名,不含完整路径
         agrupar_ocorrencias: true
     },
+    // 中等项目: 小团队,多种语言
     medio: {
         nivel_detalhamento: 'moderado',
         mostrar_performance: true,
         mostrar_cache: false,
         mostrar_workers: false,
         formato_arquivo: 'relativo',
+        // 相对路径
         agrupar_ocorrencias: true
     },
+    // 复杂项目: 大团队,CI/CD,多模块
     complexo: {
         nivel_detalhamento: 'completo',
         mostrar_performance: true,
         mostrar_cache: true,
         mostrar_workers: true,
         formato_arquivo: 'completo',
+        // 完整路径 + 元数据
         agrupar_ocorrencias: false
     },
+    // CI/CD 环境: 结构化日志,无颜色
     ci: {
         nivel_detalhamento: 'estruturado',
         mostrar_performance: true,
@@ -245,4 +263,3 @@ export const LogContextConfiguracao = {
         formato_saida: 'json_lines'
     }
 };
-//# sourceMappingURL=log-messages.js.map