@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/core/messages/zh/cli/cli-processing-diagnostic-messages.js

@@ -1,17 +1,21 @@
+// SPDX-License-Identifier: MIT
 import { ICONES_ACAO, ICONES_ARQUIVO, ICONES_FEEDBACK, ICONES_STATUS } from '../../shared/icons.js';
 export const CliProcessamentoDiagnosticoMensagens = {
     linhaEmBranco: '',
     templateArquetipoPreview: '已生成自定义原型模板(预览)',
+    // 执行摘要
     resumoExecutivoHeader: (total, criticos, altos) => `执行摘要:${total} 个问题(严重:${criticos},高:${altos})`,
     resumoExecutivoCriticos: (criticos) => `严重:${criticos}`,
     resumoExecutivoAltos: (altos) => `高:${altos}`,
     resumoExecutivoTopArquivosErrosAltos: '顶级文件(错误/高优先级):',
     resumoExecutivoBulletTopArquivo: (arquivo, count) => `  • ${arquivo}(${count})`,
     resumoExecutivoAcaoSugerida: '建议操作:使用 --include "<模式>" 按文件过滤,或使用 --export 进行离线分析',
+    // 基本摘要(控制台)
     principaisTiposTitulo: '  消息  主要类型:',
     principaisTiposLinha: (tipo, count) => `     • ${tipo}:${count}`,
     topArquivosTitulo: `  ${ICONES_ARQUIVO.diretorio} 顶级文件:`,
     topArquivosLinha: (arquivo, count) => `     • ${arquivo}(${count})`,
+    // 详细详情
     porTipoTitulo: '按类型:',
     porTipoLinha: (tipo, count) => `  • ${tipo}:${count}`,
     porSeveridadeTitulo: '按严重程度:',
@@ -28,6 +32,7 @@ export const CliProcessamentoDiagnosticoMensagens = {
     analistaOcorrenciasLinha: (nome, ocorrencias, duracaoMsFixed) => `  • ${nome}:${ocorrencias} 次出现,耗时 ${duracaoMsFixed}ms`,
     diagnosticoConcluido: '诊断完成',
     tudoPronto: '一切就绪',
+    // 原型
     arquetiposDetectados: (qtd) => `检测到 ${qtd} 个原型候选`,
     arquetiposCompact: (nome, confidence) => `原型:${nome}(${confidence}%)`,
     arquetiposCandidatosEncontrados: (qtd) => `找到原型候选:${qtd}`,
@@ -45,6 +50,7 @@ export const CliProcessamentoDiagnosticoMensagens = {
     driftMantido: (atual) => `漂移:原型 ${atual} 保持不变`,
     driftNovos: (novosStr) => `新增:[${novosStr}]`,
     driftRemovidos: (removidosStr) => `移除:[${removidosStr}]`,
+    // 结构/基线
     baselineDesconhecidoAviso: '未知基线 - 首次运行或未找到基线',
     baselineArquetipoDesconhecido: '基线原型:未知',
     baselineArquetipo: (arquetipo, confidence) => `基线原型:${arquetipo}(${confidence}%)`,
@@ -55,10 +61,12 @@ export const CliProcessamentoDiagnosticoMensagens = {
     arquivosRemovidosRaiz: (joined) => `根目录移除文件:${joined}`,
     candidatoPrincipal: (nome, confidence) => `主要候选:${nome}(${confidence}%)`,
     resumoEstruturaTitulo: '结构摘要',
+    // JSON/调试
     debugAboutToEmitJson: (optsJson) => `即将输出 JSON;选项=${optsJson}`,
     todosPendentesEncontrados: (qtd) => `找到 ${qtd} 个待处理的 TODO`,
     errorGeneratingJson: '生成 JSON 时出错:',
     fallbackJson: '回退 JSON:',
+    // 最终块(摘要/导出)
     resumoExecutivoTitulo: (prioritarios) => `执行摘要(${prioritarios} 个优先级)`,
     cabecalhoExecProblema: '问题',
     cabecalhoExecQtd: '数量',
@@ -78,4 +86,3 @@ export const CliProcessamentoDiagnosticoMensagens = {
     falhaExportarRelatorios: (errMsg) => `导出报告失败:${errMsg}`,
     erroFatalDiagnostico: (errMsg) => `诊断期间发生致命错误:${errMsg}`
 };
-//# sourceMappingURL=cli-processing-diagnostic-messages.js.map

package/dist/core/messages/zh/cli/cli-processing-extra-messages.js

@@ -1,6 +1,6 @@
+// SPDX-License-Identifier: MIT
 export const CliProcessamentoExtraMensagens = {
     falhaSalvarAnalise: '无法保存详细分析：{erro}',
     erroAplicarCorrecoes: '应用修复时出错：{erro}',
     erroExportarRelatorios: '导出报告时出错：{erro}',
 };
-//# sourceMappingURL=cli-processing-extra-messages.js.map

package/dist/core/messages/zh/cli/index.js

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * CLI Commands and Handlers Messages
+ */
 export * from './cli-archetype-handler-messages.js';
 export * from './cli-auto-fix-handler-messages.js';
 export * from './cli-bin-index.js';
@@ -35,4 +39,3 @@ export * from './cli-flags-validator-messages.js';
 export * from './cli-options-diagnose-messages.js';
 export * from './cli-processing-diagnostic-messages.js';
 export * from './cli-processing-extra-messages.js';
-//# sourceMappingURL=index.js.map

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

@@ -1,6 +1,19 @@
+// SPDX-License-Identifier: MIT
+/**
+ * 自动修复消息
+ *
+ * 集中所有与以下相关的消息:
+ * - 快速修复(fix-any-to-proper-type、fix-unknown 等)
+ * - 管理员(导入、结构、类型)
+ * - 自动修复总体
+ */
 import { buildTypesRelPathPosix, getTypesDirectoryDisplay } from '../../../../core/config/conventions.js';
 import { ICONES } from '../../shared/icons.js';
+/**
+ * 快速修复消息 - Any/Unknown
+ */
 export const MENSAGENS_CORRECAO_TIPOS = {
+    // 快速修复的标题和描述
     fixAny: {
         title: '将 any 替换为安全类型',
         get description() { return `分析 any 的使用情况并推断/创建正确的类型到 ${getTypesDirectoryDisplay()}`; }
@@ -9,10 +22,12 @@ export const MENSAGENS_CORRECAO_TIPOS = {
         title: '将 unknown 替换为具体类型',
         description: '检测类型守卫模式并创建专用类型'
     },
+    // 验证消息
     validacao: {
         falha: (erros) => `验证失败:${erros.join(', ')}`,
         revisar: '请手动审查'
     },
+    // 警告和建议
     warnings: {
         confiancaBaixa: (confianca) => `不安全类型(any),置信度过低(${confianca}%),不适合自动修复`,
         confiancaMedia: (confianca, tipoSugerido) => `检测到不安全类型。建议:${tipoSugerido}(置信度:${confianca}%)`,
@@ -21,22 +36,29 @@ export const MENSAGENS_CORRECAO_TIPOS = {
         criarTipoDedicado: (caminho) => `考虑在 ${buildTypesRelPathPosix(caminho)} 创建专用类型`,
         adicioneTypeGuards: () => `如果可能,请添加类型守卫或在 ${getTypesDirectoryDisplay()} 创建专用类型`
     },
+    // 错误消息
     erros: {
         extrairNome: '无法提取变量名',
         variavelNaoUsada: '变量未使用 - 无法推断类型',
         analise: (erro) => `分析错误:${erro}`
     }
 };
+/**
+ * 自动修复消息
+ */
 export const MENSAGENS_AUTOFIX = {
+    // 状态消息
     iniciando: (modo) => `${ICONES.acao.correcao} 开始自动修复(模式:${modo})`,
     dryRun: `${ICONES.feedback.info} 模拟运行:模拟修复(不会应用任何更改)`,
     aplicando: (count) => `正在应用 ${count} 处修复...`,
     concluido: (aplicadas, falhas) => `${ICONES.nivel.sucesso} 自动修复完成:${aplicadas} 处已应用,${falhas} 处失败`,
     naoDisponivel: `${ICONES.feedback.info} 没有可用的自动修复`,
+    // 标志和模式
     flags: {
         fixSafe: `${ICONES.comando.guardian} 检测到 --fix-safe 标志:启用保守模式`,
         requireMutateFS: `${ICONES.status.falha} 当前无法使用自动修复。`
     },
+    // 进度日志
     logs: {
         modoConservador: `${ICONES.comando.guardian} 已激活保守模式 - 仅应用高置信度修复`,
         validacaoEslint: `${ICONES.acao.analise} 正在运行自动修复后的 ESLint 验证...`,
@@ -44,11 +66,13 @@ export const MENSAGENS_AUTOFIX = {
         arquivoRevertido: (origem, destino) => `[BACK] 文件已还原:${destino} → ${origem}`,
         arquivoRevertidoConteudo: (origem, destino) => `[BACK] 文件已还原为原始内容:${destino} → ${origem}`
     },
+    // 结果
     resultados: {
         sucesso: (count) => `${ICONES.status.ok} ${count} 个文件已修复`,
         falhas: (count) => `${ICONES.status.falha} ${count} 个文件出错`,
         erroArquivo: (arquivo, erro) => `${ICONES.status.falha} ${arquivo}:${erro}`
     },
+    // 修复后提示
     dicas: {
         executarLint: `${ICONES.feedback.dica} 运行 \`npm run lint\` 验证修复`,
         executarBuild: `${ICONES.feedback.dica} 运行 \`npm run build\` 验证代码是否可以编译`,
@@ -56,6 +80,9 @@ export const MENSAGENS_AUTOFIX = {
         ajustarConfianca: `${ICONES.feedback.dica} 使用 --confidence <数字> 调整阈值(当前:85%)`
     }
 };
+/**
+ * 分析报告消息
+ */
 export const MENSAGENS_RELATORIOS_ANALISE = {
     asyncPatterns: {
         titulo: `${ICONES.relatorio.resumo} Async/Await 模式分析`,
@@ -76,6 +103,9 @@ export const MENSAGENS_RELATORIOS_ANALISE = {
         exportado: `${ICONES.arquivo.doc} Guardian 报告已导出:`
     }
 };
+/**
+ * 原型消息
+ */
 export const MENSAGENS_ARQUETIPOS_HANDLER = {
     timeout: `${ICONES.feedback.atencao} 原型检测超时`,
     salvo: (caminho) => `${ICONES.status.ok} 自定义原型已保存到 ${caminho}`,
@@ -83,14 +113,23 @@ export const MENSAGENS_ARQUETIPOS_HANDLER = {
     falhaEstrategista: `${ICONES.feedback.atencao} 策略师未能建议计划。`,
     falhaGeral: `${ICONES.feedback.atencao} 总体计划失败。`
 };
+/**
+ * 插件消息
+ */
 export const MENSAGENS_PLUGINS = {
     registrado: (nome, extensoes) => `${ICONES.status.ok} 插件 ${nome} 已注册,扩展:${extensoes.join(', ')}`,
     configAtualizada: `${ICONES.acao.correcao} 注册表配置已更新`,
     erroParsear: (linguagem, erro) => `${ICONES.feedback.atencao} 解析 ${linguagem} 出错:${erro}`
 };
+/**
+ * 执行器消息
+ */
 export const MENSAGENS_EXECUTOR = {
     analiseCompleta: (tecnica, arquivo, duracao) => `${ICONES.arquivo.arquivo} '${tecnica}' 分析了 ${arquivo},耗时 ${duracao}`
 };
+/**
+ * 整合导出
+ */
 export const MENSAGENS_CORRECOES = {
     fixTypes: MENSAGENS_CORRECAO_TIPOS,
     autofix: MENSAGENS_AUTOFIX,
@@ -99,4 +138,3 @@ export const MENSAGENS_CORRECOES = {
     plugins: MENSAGENS_PLUGINS,
     executor: MENSAGENS_EXECUTOR
 };
-//# sourceMappingURL=correcoes-messages.js.map

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

@@ -1,3 +1,14 @@
+// SPDX-License-Identifier: MIT
+// @mahoraga-disable tipo-literal-inline-complexo
+// Justificativa: tipos inline para helpers de mensagens
+/**
+ * 诊断命令消息
+ *
+ * 集中所有与仓库诊断相关的消息
+ */
+/**
+ * 诊断图标
+ */
 const ICONES_DIAGNOSTICO = {
     inicio: '[SCAN]',
     progresso: '[...]',
@@ -15,12 +26,18 @@ const ICONES_DIAGNOSTICO = {
     executive: '[STATS]',
     rapido: '[FAST]'
 };
+/**
+ * 各模式下的启动消息
+ */
 export const MENSAGENS_INICIO = {
     compact: `${ICONES_DIAGNOSTICO.inicio} 诊断(紧凑模式)`,
     full: `${ICONES_DIAGNOSTICO.inicio} 开始完整诊断`,
     executive: `${ICONES_DIAGNOSTICO.executive} 执行摘要(仅严重问题)`,
     quick: `${ICONES_DIAGNOSTICO.rapido} 快速分析`
 };
+/**
+ * 进度消息
+ */
 export const MENSAGENS_PROGRESSO = {
     varredura: (total) => `${ICONES_DIAGNOSTICO.arquivos} 正在扫描 ${total} 个文件...`,
     analise: (atual, total) => `${ICONES_DIAGNOSTICO.analise} 正在分析:${atual}/${total}`,
@@ -29,11 +46,17 @@ export const MENSAGENS_PROGRESSO = {
     autoFix: (modo) => `${ICONES_DIAGNOSTICO.autoFix} 正在应用修复(模式:${modo})...`,
     export: (formato) => `${ICONES_DIAGNOSTICO.export} 正在导出报告(${formato})...`
 };
+/**
+ * 完成消息
+ */
 export const MENSAGENS_CONCLUSAO = {
     sucesso: (ocorrencias) => `${ICONES_DIAGNOSTICO.sucesso} 诊断完成:找到 ${ocorrencias} 处问题`,
     semProblemas: `${ICONES_DIAGNOSTICO.sucesso} 未发现问题!代码状态良好。`,
     exportado: (caminho) => `${ICONES_DIAGNOSTICO.export} 报告已保存到:${caminho}`
 };
+/**
+ * 错误消息
+ */
 export const MENSAGENS_ERRO = {
     falhaAnalise: (erro) => `${ICONES_DIAGNOSTICO.erro} 分析失败:${erro}`,
     falhaExport: (erro) => `${ICONES_DIAGNOSTICO.erro} 导出失败:${erro}`,
@@ -41,33 +64,47 @@ export const MENSAGENS_ERRO = {
     falhaAutoFix: (erro) => `${ICONES_DIAGNOSTICO.erro} 自动修复失败:${erro}`,
     flagsInvalidas: (erros) => `${ICONES_DIAGNOSTICO.erro} 无效的标志:\n${erros.map(erro => `  • ${erro}`).join('\n')}`
 };
+/**
+ * 警告消息
+ */
 export const MENSAGENS_AVISO = {
-    modoFast: `${ICONES_DIAGNOSTICO.info} 快速模式已激活(MAHORAGA_TEST_FAST=1)`,
+    modoFast: `${ICONES_DIAGNOSTICO.info} 快速模式已激活(SUKUNA_TEST_FAST=1)`,
     semMutateFS: `${ICONES_DIAGNOSTICO.aviso} 自动修复已禁用。`,
     guardianDesabilitado: `${ICONES_DIAGNOSTICO.info} Guardian 未执行`,
     arquetiposTimeout: `${ICONES_DIAGNOSTICO.aviso} 原型检测超时`
 };
+/**
+ * 过滤器消息
+ */
 export const MENSAGENS_FILTROS = {
     titulo: '活动过滤器',
     include: (patterns) => `Include:${patterns.length > 0 ? patterns.join(', ') : '无'}`,
     exclude: (patterns) => `Exclude:${patterns.length > 0 ? patterns.join(', ') : '默认模式'}`,
     nodeModules: (incluido) => `node_modules:${incluido ? `${ICONES_DIAGNOSTICO.sucesso} 已包含` : `${ICONES_DIAGNOSTICO.aviso} 已忽略(默认)`}`
 };
+/**
+ * 统计消息
+ */
 export const MENSAGENS_ESTATISTICAS = {
     titulo: '分析统计',
     arquivos: (total) => `已分析文件:${total}`,
     ocorrencias: (total) => `发现问题:${total}`,
     porTipo: (tipo, count) => `  • ${tipo}:${count}`,
     duracao: (ms) => {
-        if (ms < 1000)
+        if (ms < 1000) {
             return `耗时:${ms}ms`;
-        if (ms < 60000)
+        }
+        if (ms < 60000) {
             return `耗时:${(ms / 1000).toFixed(1)}s`;
+        }
         const min = Math.floor(ms / 60000);
         const seg = Math.floor(ms % 60000 / 1000);
         return `耗时:${min}m ${seg}s`;
     }
 };
+/**
+ * Guardian 消息
+ */
 export const MENSAGENS_GUARDIAN = {
     iniciando: `${ICONES_DIAGNOSTICO.guardian} 开始 Guardian 验证...`,
     baseline: '使用现有基线',
@@ -80,6 +117,10 @@ export const MENSAGENS_GUARDIAN = {
     },
     drift: (count) => `检测到漂移:与基线相比有 ${count} 处更改`
 };
+// MENSAGENS_AUTOFIX 已移至 correcoes-messages.ts 以进行整合
+/**
+ * 原型消息
+ */
 export const MENSAGENS_ARQUETIPOS = {
     detectando: `${ICONES_DIAGNOSTICO.arquetipos} 正在检测项目结构...`,
     identificado: (tipo, confianca) => `已识别原型:${tipo}(${confianca}% 置信度)`,
@@ -87,6 +128,9 @@ export const MENSAGENS_ARQUETIPOS = {
     salvando: `正在保存自定义原型...`,
     salvo: (caminho) => `${ICONES_DIAGNOSTICO.sucesso} 原型已保存到:${caminho}`
 };
+/**
+ * 块模板
+ */
 export const MODELOS_BLOCO = {
     sugestoes: {
         titulo: '快速建议',
@@ -104,9 +148,12 @@ export const MODELOS_BLOCO = {
         }
     }
 };
+/**
+ * 格式化标志建议块
+ */
 export function formatarBlocoSugestoes(flagsAtivas, dicas) {
     const linhas = [];
-    linhas.push('');
+    linhas.push(''); // 空行
     linhas.push(`┌── ${MODELOS_BLOCO.sugestoes.titulo} ─────────────────────────────────────────`);
     if (flagsAtivas.length > 0) {
         linhas.push(`活动标志:${flagsAtivas.join(' ')}`);
@@ -122,12 +169,15 @@ export function formatarBlocoSugestoes(flagsAtivas, dicas) {
         }
     }
     linhas.push('└───────────────────────────────────────────────────────────────');
-    linhas.push('');
+    linhas.push(''); // 空行
     return linhas;
 }
+/**
+ * 格式化统计摘要
+ */
 export function formatarResumoStats(stats) {
     const linhas = [];
-    linhas.push('');
+    linhas.push(''); // 空行
     linhas.push(`┌── ${MODELOS_BLOCO.resumo.secoes.estatisticas} ─────────────────────────────────────────`);
     linhas.push(`  ${MENSAGENS_ESTATISTICAS.arquivos(stats.arquivos)}`);
     linhas.push(`  ${MENSAGENS_ESTATISTICAS.ocorrencias(stats.ocorrencias)}`);
@@ -141,12 +191,18 @@ export function formatarResumoStats(stats) {
     linhas.push('');
     linhas.push(`  ${MENSAGENS_ESTATISTICAS.duracao(stats.duracao)}`);
     linhas.push('└───────────────────────────────────────────────────────────────');
-    linhas.push('');
+    linhas.push(''); // 空行
     return linhas;
 }
+/**
+ * 格式化 JSON 模式消息
+ */
 export function formatarModoJson(ascii) {
     return `${ICONES_DIAGNOSTICO.info} 结构化 JSON 输出${ascii ? '(ASCII 转义)' : ''}已激活`;
 }
+/**
+ * 命令的默认标头和文本
+ */
 export const CABECALHOS = {
     analistas: {
         tituloFast: `${ICONES_DIAGNOSTICO.info} 已注册的分析器(快速模式)`,
@@ -164,4 +220,3 @@ export const CABECALHOS = {
         conflitosDetectadosFast: (count) => `${ICONES_DIAGNOSTICO.aviso} 检测到冲突:${count}(快速模式)`
     }
 };
-//# sourceMappingURL=diagnostic-messages.js.map

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

@@ -1,10 +1,19 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Mahoraga 核心的异常和错误消息。
+ * 集中化与 CLI、插件、分析员、
+ * 验证、安全、持久化、模式、扫描器、回滚和报告相关的错误字符串。
+ */
 export const ExcecoesMensagens = {
+    // CLI
     exit1: 'exit:1',
     requireMutateFsAutoFix: '自动修复不可用',
     autoFixTimeout: (timeoutMs) => `自动修复超时,已耗时 ${timeoutMs}ms`,
-    pluginsDesabilitadosSafeMode: '在 SAFE_MODE 中已禁用插件加载。设置 MAHORAGA_ALLOW_PLUGINS=1 以允许。',
+    // 插件 / 安全导入
+    pluginsDesabilitadosSafeMode: '在 SAFE_MODE 中已禁用插件加载。设置 SUKUNA_ALLOW_PLUGINS=1 以允许。',
     pluginBloqueado: (erro) => `插件被阻止: ${erro}`,
     caminhoPluginNaoResolvido: '插件路径未解析',
+    // 插件注册表
     pluginRegistradoNaoPodeSerObtido: (name) => `插件 ${name} 已注册但无法获取`,
     pluginCarregandoPromiseNaoPodeSerObtida: (name) => `插件 ${name} 正在加载但无法获取 promise`,
     naoFoiPossivelCarregarPlugin: (name, errMsg) => `无法加载插件 '${name}': ${errMsg}`,
@@ -12,25 +21,32 @@ export const ExcecoesMensagens = {
     pluginDeveTerVersaoValida: '插件必须有有效的版本',
     pluginDeveDefinirPeloMenosUmaExtensao: '插件必须定义至少一个扩展',
     pluginDeveImplementarMetodoParse: '插件必须实现 parse() 方法',
+    // 类型/分析员
     definicaoAnalistaInvalida: '无效的分析员定义',
     analistaSemFuncaoAplicar: (nome) => `分析员 ${nome} 没有 apply 函数`,
+    // 验证 / 安全
     caminhoForaDaCwdNaoPermitido: (caminho) => `不允许 CWD 之外的路径: ${caminho}`,
     persistenciaNegadaForaRaizProjeto: (caminho) => `拒绝持久化: 路径在项目根目录之外: ${caminho}`,
     validacaoScanIncremental: '不要同时使用 --scan-only 和 --incremental (incremental 需要 AST)。',
+    // 持久化 (环境)
     fsWriteFileBinaryIndisponivel: '当前环境中 fs.writeFile (binary) 不可用',
     fsReadFileIndisponivel: '当前环境中 fs.readFile 不可用',
     fsWriteFileIndisponivel: '当前环境中 fs.writeFile 不可用',
     fsRenameIndisponivel: '当前环境中 fs.rename 不可用',
     fsMkdirIndisponivel: '当前环境中 fs.mkdir 不可用',
+    // 模式
     versaoSchemaDesconhecida: (versao) => `未知的 schema 版本: ${versao}`,
     relatorioSchemaInvalido: (erros) => `报告具有无效的 schema: ${erros}`,
+    // 文件注册表
     arquivoNaoEncontrado: (fileCaminho) => `文件未找到: ${fileCaminho}`,
     validacaoFalhouPara: (fileCaminho) => `验证失败: ${fileCaminho}`,
     erroAoLer: (fileCaminho, errMsg) => `读取 ${fileCaminho} 时出错: ${errMsg}`,
     erroAoEscrever: (fileCaminho, errMsg) => `写入 ${fileCaminho} 时出错: ${errMsg}`,
     erroAoDeletar: (fileCaminho, errMsg) => `删除 ${fileCaminho} 时出错: ${errMsg}`,
+    // 扫描器
     statIndefinidoPara: (fullCaminho) => `${fullCaminho} 的 stat 未定义`,
+    // 回滚
     mapaReversaoCorrompido: '回滚映射已损坏',
+    // 报告
     semPkg: '无 pkg'
 };
-//# sourceMappingURL=excecoes-messages.js.map

package/dist/core/messages/zh/core/executor-extra-messages.js

@@ -1,3 +1,6 @@
+/**
+ * Extra messages for executor (Chinese).
+ */
 export const ExecutorExtraMensagens = {
     tecnicaGlobal: '全局技术 "{nome}"',
     erroTecnicaGlobal: '{prefixo} 全局技术 \'{nome}\' 出错: {erro}',
@@ -13,4 +16,3 @@ export const ExecutorExtraMensagens = {
     timeoutTecnica: (nome, tempo) => `超时: 技术 '${nome}' 超过 ${tempo}ms`,
     erroExecutarTecnica: (nome, erro) => `执行技术 ${nome} 时出错: ${erro}`,
 };
-//# sourceMappingURL=executor-extra-messages.js.map

package/dist/core/messages/zh/core/fix-types-messages.js

@@ -1,4 +1,14 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Fix-Types 命令消息
+ *
+ * 集中化所有与 fix-types 命令相关的消息、文本和模板
+ * 该命令用于检测和分类 TypeScript 代码中的不安全类型 (any/unknown)。
+ */
 import { ICONES_ACAO, ICONES_ARQUIVO, ICONES_COMANDO, ICONES_DIAGNOSTICO, ICONES_FEEDBACK, ICONES_RELATORIO, ICONES_STATUS, ICONES_TIPOS } from '../../shared/icons.js';
+/**
+ * 不安全类型类别配置
+ */
 export const CATEGORIAS_TIPOS = {
     LEGITIMO: {
         icone: ICONES_TIPOS.legitimo,
@@ -19,16 +29,25 @@ export const CATEGORIAS_TIPOS = {
         confidenciaMin: 95
     }
 };
+/**
+ * 命令开始/头部消息
+ */
 const MENSAGENS_INICIO = {
     titulo: `${ICONES_COMANDO.fixTypes} 开始分析不安全类型...`,
     analisando: (target) => `${ICONES_ARQUIVO.diretorio} 正在分析: ${target}`,
     confianciaMin: (min) => `${ICONES_DIAGNOSTICO.stats} 最低置信度: ${min}%`,
     modo: (dryRun) => `${dryRun ? ICONES_ACAO.analise : ICONES_ACAO.correcao} 模式: ${dryRun ? '分析 (dry-run)' : '应用修复'}`
 };
+/**
+ * 进度/状态消息
+ */
 const MENSAGENS_PROGRESSO = {
     processandoArquivos: (count) => `${ICONES_ARQUIVO.diretorio} 正在处理 ${count} 个文件...`,
     arquivoAtual: (arquivo, count) => `${ICONES_ARQUIVO.arquivo} ${arquivo}: ${count} 处出现`
 };
+/**
+ * 摘要/统计消息
+ */
 export const MENSAGENS_RESUMO = {
     encontrados: (count) => `发现 ${count} 个不安全类型:`,
     tituloCategorizacao: `${ICONES_DIAGNOSTICO.stats} 分类分析:`,
@@ -38,17 +57,26 @@ export const MENSAGENS_RESUMO = {
         return `${count} 个案例 (${pct}%)`;
     }
 };
+/**
+ * 提示/帮助消息
+ */
 export const DICAS = {
     removerDryRun: '[提示] 要应用修复,请移除 --dry-run 标志',
     usarInterativo: '[提示] 使用 --interactive 确认每个修复',
     ajustarConfianca: (atual) => `${ICONES_FEEDBACK.dica} 使用 --confidence <num> 调整阈值 (当前: ${atual}%)`,
     revisar: (categoria) => `${ICONES_FEEDBACK.dica} 手动审查 ${categoria} 案例`
 };
+/**
+ * 每个类别的建议操作
+ */
 export const ACOES_SUGERIDAS = {
     LEGITIMO: ['这些情况正确,应保持原样', '不需要任何额外操作'],
     MELHORAVEL: ['考虑在可能时替换为更具体的类型', '在未来重构期间审查', '添加注释说明使用 unknown 的原因'],
     CORRIGIR: ['优先修复这些情况', '替换为具体的 TypeScript 类型', '必要时使用类型守卫']
 };
+/**
+ * 错误/警告消息
+ */
 const MENSAGENS_ERRO = {
     correcaoNaoImplementada: '完整的自动修复尚未实现',
     sistemaDesenvolvimento: `${ICONES_FEEDBACK.foguete} 高级自动修复系统正在开发中`,
@@ -56,11 +84,17 @@ const MENSAGENS_ERRO = {
     detectorNaoEncontrado: '在分析器注册表中未找到不安全类型检测器',
     modulosNaoEncontrados: '未找到修复模块'
 };
+/**
+ * 成功消息
+ */
 export const MENSAGENS_SUCESSO = {
     nenhumTipoInseguro: `${ICONES_STATUS.ok} 未检测到不安全类型!代码具有良好的类型安全性。`,
     nenhumAltaConfianca: `${ICONES_STATUS.ok} 未找到高置信度修复`,
     nenhumaCorrecao: '未应用任何修复 (使用 --confidence 调整阈值)'
 };
+/**
+ * CLI 流程专用消息(行和标题),用于 src/cli/**
+ */
 export const MENSAGENS_CLI_CORRECAO_TIPOS = {
     linhaEmBranco: '',
     erroExecutar: (mensagem) => `运行 fix-types 时出错: ${mensagem}`,
@@ -72,6 +106,7 @@ export const MENSAGENS_CLI_CORRECAO_TIPOS = {
     maisOcorrencias: (qtd) => `  ... 还有 ${qtd} 处出现`,
     aplicandoCorrecoesAuto: `${ICONES_ACAO.correcao} 正在应用自动修复...`,
     exportandoRelatorios: `${ICONES_ACAO.export} 导出报告中...`,
+    // 详细日志
     verboseAnyDetectado: (arquivo, linha) => `  ${ICONES_TIPOS.any} ${arquivo}:${linha} - 检测到 any (建议修复)`,
     verboseAsAnyCritico: (arquivo, linha) => `  ${ICONES_TIPOS.corrigir} ${arquivo}:${linha} - 检测到 "as any" (严重 - 必须修复)`,
     verboseAngleAnyCritico: (arquivo, linha) => `  ${ICONES_TIPOS.corrigir} ${arquivo}:${linha} - 检测到 "<any>" (严重 - 遗留语法)`,
@@ -96,6 +131,9 @@ export const MENSAGENS_CLI_CORRECAO_TIPOS = {
     dryRunAviso: (iconeInicio) => `${iconeInicio} Dry-run 模式激活 - 不会进行任何更改`,
     templatePasso: (passo) => `  ${passo}`
 };
+/**
+ * 分类文本(原因/建议),出现在日志和导出中。
+ */
 export const TEXTOS_CATEGORIZACAO_CORRECAO_TIPOS = {
     anyMotivo: 'any 不安全 - 替换为具体类型',
     anySugestao: '分析变量用法以推断正确类型',
@@ -106,10 +144,16 @@ export const TEXTOS_CATEGORIZACAO_CORRECAO_TIPOS = {
     semContextoMotivo: '无法分析上下文',
     semContextoSugestao: '手动审查'
 };
+/**
+ * 最终摘要模板
+ */
 export const TEMPLATE_RESUMO_FINAL = {
     titulo: `${ICONES_RELATORIO.detalhado} 手动应用修复:`,
     passos: ['审查上面分类的案例', `合法 (${ICONES_TIPOS.legitimo}): 保持原样`, `可改进 (${ICONES_TIPOS.melhoravel}): 考虑更具体的类型`, `需修复 (${ICONES_TIPOS.corrigir}): 替换为具体类型`, '修复后运行 `npm run lint`']
 };
+/**
+ * 命令中使用的表情和图标
+ */
 const ICONES = {
     inicio: ICONES_COMANDO.fixTypes,
     aplicando: '[>]',
@@ -131,28 +175,45 @@ export const MENSAGENS_ERRO_FIX_TYPES = MENSAGENS_ERRO;
 export const MENSAGENS_INICIO_FIX_TYPES = MENSAGENS_INICIO;
 export const MENSAGENS_PROGRESSO_FIX_TYPES = MENSAGENS_PROGRESSO;
 export const MENSAGENS_SUCESSO_FIX_TYPES = MENSAGENS_SUCESSO;
+/**
+ * 格式化不安全类型消息,包含图标和计数器
+ */
 export function formatarTipoInseguro(tipo, count) {
     const icone = tipo.includes('any') ? ICONES_TIPOS.any : ICONES_TIPOS.unknown;
     const plural = count !== 1 ? 's' : '';
     return `${icone} ${tipo}: ${count} 处出现${plural}`;
 }
+/**
+ * 格式化单个出现行
+ */
 export function formatarOcorrencia(relPath, linha) {
-    return `  ${ICONES.setinha} ${relPath}:${linha || '?'}`;
+    return `  ${ICONES.setinha} ${relPath}:${linha ?? '?'}`;
 }
+/**
+ * 格式化带上下文的消息
+ */
 export function formatarComContexto(mensagem, indentLevel = 1) {
     const indent = '  '.repeat(indentLevel);
     return `${indent}${ICONES.setinha} ${mensagem}`;
 }
+/**
+ * 格式化修复建议
+ */
 export function formatarSugestao(sugestao) {
     return `     ${ICONES.setinha} ${ICONES.lampada} ${sugestao}`;
 }
+/**
+ * 生成类别摘要文本
+ */
 export function gerarResumoCategoria(categoria, count, total) {
     const config = CATEGORIAS_TIPOS[categoria];
     const porcentagem = MENSAGENS_RESUMO.porcentagem(count, total);
     return [categoria === 'CORRIGIR' ? `${config.icone} ${config.nome}: ${porcentagem}` : categoria === 'MELHORAVEL' ? `${config.icone} ${config.nome}: ${porcentagem}` : `${config.icone} ${config.nome}: ${porcentagem}`, `   ${ICONES.setinha} ${config.descricao}`];
 }
+/**
+ * 调试消息(仅在 DEV_MODE 中)
+ */
 export const DEPURACAO = {
     categorizacao: (arquivo, tipo, categoria) => `[DEBUG] ${arquivo} - ${tipo} → ${categoria}`,
     confianca: (tipo, valor) => `[DEBUG] ${tipo} 的置信度: ${valor}%`
 };
-//# sourceMappingURL=fix-types-messages.js.map

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

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const FormattersMensagens = {
     descricao: '管理报告格式化程序（输出插件）',
     listDescricao: '列出已注册的格式化程序',
@@ -11,7 +12,7 @@ export const FormattersMensagens = {
     semDados: '# 无数据',
 };
 export const ExecSafeMensagens = {
-    safeModeBloqueado: 'SAFE_MODE下命令执行已禁用。设置 MAHORAGA_ALLOW_EXEC=1 以允许。',
+    safeModeBloqueado: 'SAFE_MODE下命令执行已禁用。设置 SUKUNA_ALLOW_EXEC=1 以允许。',
 };
 export const WorkerExecutorMensagens = {
     timeoutTecnica: (nome, ms) => `超时: 技术 '${nome}' 已超过 ${ms}ms`,
@@ -21,4 +22,3 @@ export const ConfigMensagens = {
     babelTraverseNaoFuncao: 'Babel traverse 不是一个函数 - 请检查模块解析。',
     exclusaoInsegura: (padroes) => `[警告] 一些排除模式被认为不安全，已被忽略: ${padroes}`,
 };
-//# sourceMappingURL=formatters-messages.js.map

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

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * 核心消息: 修复、诊断、异常、修复类型、审查器、插件
+ */
 export * from './correcoes-messages.js';
 export * from './diagnostic-messages.js';
 export * from './excecoes-messages.js';
@@ -8,4 +12,3 @@ export * from './inquisitor-extra-messages.js';
 export * from './inquisitor-messages.js';
 export * from './parser-extra-messages.js';
 export * from './plugin-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/zh/core/inquisitor-extra-messages.js

@@ -1,7 +1,9 @@
+/**
+ * Extra messages for inquisidor (Chinese).
+ */
 export const InquisidorExtraMensagens = {
     iniciandoInquisicao: '{icone} 正在 {diretorio} 启动 Mahoraga 审查',
     priorizacaoAplicada: '[CALC] 已应用优先级 (前 5 个无 meta): {exibidos}',
     arquivosMetaMovidos: '   ({icone} {total} 个 meta 文件已移至队列末尾)',
     inquisicaoConcluida: '[CRYSTAL] 审查完成。总出现次数: {total}',
 };
-//# sourceMappingURL=inquisitor-extra-messages.js.map

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

@@ -1,7 +1,12 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview Inquisitor (AST 解析器) 的诊断消息。
+ * 提供用于报告解析失败、AST 错误
+ * 以及聚合被抑制的解析错误的文本模板。
+ */
 export const InquisidorMensagens = {
     parseAstNaoGerada: '解析错误: 未生成 AST (代码可能无效)。',
     parseErro: (erro) => `解析错误: ${erro}`,
     parseErrosAgregados: (quantidade) => `聚合解析错误: 此文件中抑制了 ${quantidade} 处出现 (仅显示 1 处)。`,
     falhaGerarAst: (relPath, erro) => `无法为 ${relPath} 生成 AST: ${erro}`
 };
-//# sourceMappingURL=inquisitor-messages.js.map