@mocoto/mahoraga 0.14.0 → 0.14.2

package/dist/core/messages/zh/analysts/analyst-github-actions-messages.js

@@ -1,3 +1,8 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview GitHub Actions 分析师的诊断消息。
+ * 提供工作流问题的汇总文本模板。
+ */
 export const AnalistaGithubActionsMensagens = {
     resumoWorkflow: (score, total) => `GitHub Actions 工作流:得分 ${score}/100,发现 ${total} 个问题`,
     workflowOtimo: '工作流遵循所有 GitHub Actions 最佳实践',
@@ -49,6 +54,5 @@ export const AnalistaGithubActionsMensagens = {
     pullRequestTargetGrantsWritePermissionsSugestao: '使用 pull_request 代替 pull_request_target,或仔细验证源分支',
     workflowDispatchWithoutInputs: 'workflow_dispatch 未定义 inputs',
     workflowDispatchWithoutInputsSugestao: '定义必需输入以控制手动工作流执行',
-    erroAplicarCorrecao: (erro) => `应用修复错误: ${erro}`,
+    erroAplicarCorrecao: (erro) => `应用修复错误: ${String(erro)}`,
 };
-//# sourceMappingURL=analyst-github-actions-messages.js.map

package/dist/core/messages/zh/analysts/analyst-gitlab-ci-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const AnalistaGitlabCiMensagens = {
     jobScriptMuitoLongo: (key, n) => `作业 '${key}' 的脚本过长 (${n} 行)`,
     semCache: '管道没有缓存配置',
@@ -9,4 +10,3 @@ export const AnalistaGitlabCiMensagens = {
     secretHardcoded: '在管道中检测到硬编码的 Secret',
     scriptInjection: '可能通过 GitLab 上下文变量进行脚本注入',
 };
-//# sourceMappingURL=analyst-gitlab-ci-messages.js.map

package/dist/core/messages/zh/analysts/analyst-patterns-usage-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const PadroesUsoMensagens = {
     varUsage: "检测到使用 'var'。请优先使用 'let' 或 'const'。",
     letUsage: "检测到使用 'let'。如果没有重新赋值，请考虑使用 'const'。",
@@ -15,6 +16,6 @@ export const PadroesUsoMensagens = {
     nonArrowCallback: "使用 'function' 的回调更适合使用箭头函数。建议使用 () => {}。",
     consoleLog: "在生产代码中检测到 console.log。请删除或替换为适当的日志记录器。",
     uselessConditional: "不必要的比较：if (x === true)。只需使用 if (x)。",
+    satisfiesUsage: "TypeScript 的 'satisfies' 关键字已使用 — 在不拓宽类型的情况下确保类型安全",
     erroAnalise: (relPath, erro) => `分析 ${relPath} 中的使用模式失败：${erro}`
 };
-//# sourceMappingURL=analyst-patterns-usage-messages.js.map

package/dist/core/messages/zh/analysts/analyst-shell-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const AnalistaShellMensagens = {
     missingShebang: '检测到Shell脚本缺少shebang。',
     missingShebangSugestao: '请在文件开头添加#!/bin/bash或#!/bin/sh。',
@@ -15,6 +16,7 @@ export const AnalistaShellMensagens = {
     hardcodedPasswordSugestao: '请使用运行时注入的环境变量。',
     sudoUsage: '脚本中检测到sudo使用。',
     sudoUsageSugestao: '尝试设计无需root权限即可运行的脚本，或要求用户使用sudo运行整个脚本。',
+    // Security (enhanced)
     unsafePipefail: '管道缺少pipefail - 管道错误被忽略。',
     unsafePipefailSugestao: '添加"set -o pipefail"以捕获管道错误。',
     unsafeCdWithoutCheck: 'cd命令没有错误检查。',
@@ -27,6 +29,7 @@ export const AnalistaShellMensagens = {
     dangerousFlagsSugestao: '确认标志是故意的且范围有限。',
     unsafeReadWithoutR: 'read没有使用-r - 反斜杠被解释。',
     unsafeReadWithoutRSugestao: '使用"read -r"以保留反斜杠原样。',
+    // Best Practices
     missingLocalVar: '函数中的变量未声明为local。',
     missingLocalVarSugestao: '使用"local"关键字将变量作用域限定在函数内。',
     uppercaseLocalVar: '局部变量使用大写字母命名。',
@@ -43,17 +46,33 @@ export const AnalistaShellMensagens = {
     missingDefaultCaseSugestao: '添加*)作为默认情况以处理意外值。',
     emptyCatchBlock: '检测到空的then或else块。',
     emptyCatchBlockSugestao: '添加解释性注释或删除空块。',
+    // Portability
     bashismDetected: '使用#!/bin/sh shebang的脚本中的Bash特有功能。',
     bashismDetectedSugestao: '在sh脚本中仅使用POSIX语法。',
     platformSpecificPath: '检测到平台特定路径(/usr/bin vs /bin)。',
     platformSpecificPathSugestao: '使用"command -v"定位可执行文件。',
     missingQuoteArrays: '数组展开未加引号。',
     missingQuoteArraysSugestao: '使用"${arr[@]}"以保留元素中的空格。',
+    // Performance
     uselessCat: '无用的cat: "cat file | command"。',
     uselessCatSugestao: '使用重定向: "command < file"。',
     loopOverCommandOutput: '循环ls输出: "for f in $(ls)"。',
     loopOverCommandOutputSugestao: '使用glob: "for f in *"。',
     pipeOverTempfile: '管道可以替代临时文件。',
     pipeOverTempfileSugestao: '使用管道代替临时文件。',
+    // Modern Bash (2026)
+    missingSetU: '缺少 "set -u" — 未设置的变量将静默展开为空。',
+    missingSetUSugestao: '添加 "set -u" 以捕获变量名拼写错误。',
+    missingIso: '缺少 IFS=$\'\\n\\t\' — 分词可能导致意外行为。',
+    missingIsoSugestao: '在脚本开头添加 IFS=$\'\\n\\t\' 以确保安全分词。',
+    missingTrap: '未找到 trap 处理程序 — 信号时可能跳过清理。',
+    missingTrapSugestao: '添加 trap 处理程序: trap "cleanup" EXIT INT TERM。',
+    missingMainFn: '脚本缺少 main 函数模式。',
+    missingMainFnSugestao: '将逻辑包装在 main() 中并在底部调用 main "$@"。',
+    missingCommandV: '硬编码路径而非使用 command -v。',
+    missingCommandVSugestao: '使用 "command -v <工具>" 检查可用性。',
+    missingDebugMode: '脚本没有调试模式 — 故障排除更困难。',
+    missingDebugModeSugestao: '添加 [[ "${DEBUG:-}" == "true" ]] && set -x 以启用调试跟踪。',
+    missingInputValidation: '命令参数未验证 — 意外输入可能导致错误。',
+    missingInputValidationSugestao: '在开头验证参数: [[ -z "$1" ]] && { echo "用法: ..."; exit 1; }。',
 };
-//# sourceMappingURL=analyst-shell-messages.js.map

package/dist/core/messages/zh/analysts/analyst-todo-comments-messages.js

@@ -1,5 +1,5 @@
+// SPDX-License-Identifier: MIT
 export const TodoComentariosMensagens = {
     todoFound: '发现 TODO 注释',
     todoOrFixmeFound: (tipo, texto) => `发现${tipo}: ${texto}`,
 };
-//# sourceMappingURL=analyst-todo-comments-messages.js.map

package/dist/core/messages/zh/analysts/archetypes-defs-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const ArquetiposDefsMensagens = {
     cliModular: 'TypeScript/JavaScript模块化CLI，组织化的命令和bin/入口',
     landingPage: '带有pages/和components/的简单Web应用程序（前端）',
@@ -9,4 +10,3 @@ export const ArquetiposDefsMensagens = {
     monorepoPackages: '带有packages/和workspaces的Monorepo（pnpm/npm/yarn）',
     vueSpa: '带有components/、views/和现代结构的Vue.js SPA',
 };
-//# sourceMappingURL=archetypes-defs-messages.js.map

package/dist/core/messages/zh/analysts/archetypes-extra-messages.js

@@ -1,3 +1,6 @@
+/**
+ * Extra messages for archetype analysis (Chinese).
+ */
 export const ArquetiposExtraMensagens = {
     naoEncontrado: '[警告] 在 {novo} 或 {legado} 中未找到自定义原型',
     salvo: '[OK] 自定义原型已保存到 {caminho}',
@@ -22,4 +25,3 @@ export const ArquetiposExtraMensagens = {
         documenteApis: '记录 API 和重要功能',
     },
 };
-//# sourceMappingURL=archetypes-extra-messages.js.map

package/dist/core/messages/zh/analysts/corrector-structure-extra-messages.js

@@ -3,4 +3,3 @@ export const CorretorEstruturaExtraMensagens = {
     safeMode: '→ 安全模式：模拟写入/移动到 {arquivo} → {destino}',
     movido: '[OK] 已移动：{arquivo} → {destino}',
 };
-//# sourceMappingURL=corrector-structure-extra-messages.js.map

package/dist/core/messages/zh/analysts/detector-aggregates-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 function erroToMessage(erro) {
     return erro instanceof Error ? erro.message : '未知错误';
 }
@@ -11,4 +12,3 @@ export const DetectorAgregadosMensagens = {
     duplicacoesResumo: (tipo, resumo, total) => `${tipo}重复:${resumo}${total > 3 ? `(+${total - 3} 更多)` : ''}`,
     erroAnalisarDuplicacoes: (erro) => `分析重复时出错:${erroToMessage(erro)}`
 };
-//# sourceMappingURL=detector-aggregates-messages.js.map

package/dist/core/messages/zh/analysts/detector-archetypes-extra-messages.js

@@ -2,4 +2,3 @@ export const DetectorArquetiposExtraMensagens = {
     debugChamado: '[BUSCA] detectarArquetipos 被调用,参数:',
     debugContextual: '[BUSCA] 尝试调用上下文检测器...',
 };
-//# sourceMappingURL=detector-archetypes-extra-messages.js.map

package/dist/core/messages/zh/analysts/detector-architecture-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 function erroToMessage(erro) {
     return erro instanceof Error ? erro.message : '未知错误';
 }
@@ -8,4 +9,3 @@ export const DetectorArquiteturaMensagens = {
     metricas: (acoplamento, coesao) => `度量:耦合度=${(acoplamento * 100).toFixed(0)}%,内聚度=${(coesao * 100).toFixed(0)}%`,
     erroAnalisarArquitetura: (erro) => `分析架构时出错:${erroToMessage(erro)}`
 };
-//# sourceMappingURL=detector-architecture-messages.js.map

package/dist/core/messages/zh/analysts/detector-bugs-ml-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const BugMlMensagens = {
     altaProbabilidade: (prob, fatores) => `ML: 高概率存在错误 (${prob}%)。因素: ${fatores}`,
     mlPattern: (confianca, message) => `[ML ${confianca}%] ${message}`,
@@ -9,6 +10,7 @@ export const BugMlMensagens = {
     usoExcessivoAny: (count) => `过度使用 'any' (${count})`,
     promisesSemTratamento: 'Promise 缺少错误处理',
     muitosTODOs: '大量 TODOs/FIXMEs',
+    // Pattern messages
     nullPointerDerefMessage: (preview) => `可能的空指针解引用: ${preview}`,
     nullPointerDerefSuggestion: '在链式调用方法前检查结果是否为 null/undefined',
     chamadaSemOptionalMessage: (funcName) => `调用 '${funcName}' 时没有可选链式调用可能导致空指针`,
@@ -28,4 +30,3 @@ export const BugMlMensagens = {
     unsafeComparisonMessage: (preview) => `潜在不安全的比较: ${preview}`,
     unsafeComparisonSuggestion: '使用 === 替代 ==，避免硬编码的密钥'
 };
-//# sourceMappingURL=detector-bugs-ml-messages.js.map

package/dist/core/messages/zh/analysts/detector-clean-arch-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 function erroToMessage(erro) {
     return erro instanceof Error ? erro.message : '未知错误';
 }
@@ -13,4 +14,3 @@ export const DetectorCleanArchMensagens = {
     recomendacaoRepository: '在领域层定义仓储接口,在基础设施层实现',
     erroAnalisarCleanArch: (erro) => `分析整洁架构时出错:${erroToMessage(erro)}`
 };
-//# sourceMappingURL=detector-clean-arch-messages.js.map

package/dist/core/messages/zh/analysts/detector-code-fragile-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 function erroToMessage(erro) {
     return erro instanceof Error ? erro.message : '未知错误';
 }
@@ -5,4 +6,3 @@ export const DetectorCodigoFragilMensagens = {
     fragilidadesResumo: (severidade, resumo, detalhes) => `脆弱性(${severidade}):${resumo} | 详情:${JSON.stringify(detalhes)}`,
     erroAnalisarCodigoFragil: (erro) => `分析脆弱代码时出错:${erroToMessage(erro)}`
 };
-//# sourceMappingURL=detector-code-fragile-messages.js.map

package/dist/core/messages/zh/analysts/detector-constructions-syntactic-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 function erroToMessage(erro) {
     return erro instanceof Error ? erro.message : '未知错误';
 }
@@ -10,5 +11,10 @@ export const DetectorConstrucoesSintaticasMensagens = {
     templateLiteralOveruse: "简单拼接不需要使用模板字面量。请使用 '+' 运算符。",
     unnecessaryObjectSpread: "不必要的对象展开。直接赋值 'obj.prop = val' 更高效。",
     getterSetterWithoutValidation: "getter/setter 的 setter 中没有验证。请添加验证以防止无效数据。",
+    // ES2025/ES2026
+    explicitResourceManagement: "检测到使用 'using' 的显式资源管理 (ES2026)",
+    temporalApiUsage: "检测到 Temporal API 的使用 (ES2026) — 现代日期/时间替代 Date",
+    iteratorHelperUsage: "检测到迭代器辅助方法 (ES2025) — 可迭代对象的惰性求值",
+    setMethodUsage: "检测到新的 Set 方法 (ES2025) — 用于集合操作",
+    mapUpsertUsage: "检测到 Map 的 upsert 方法 (ES2026) — .getOrInsert() / .getOrInsertComputed()",
 };
-//# sourceMappingURL=detector-constructions-syntactic-messages.js.map

package/dist/core/messages/zh/analysts/detector-context-extra-messages.js

@@ -1,6 +1,8 @@
+/**
+ * Mensagens em chinês para o detector de contexto extra
+ */
 export const DetectorContextoExtraMensagens = {
     debugDependencias: '[BUSCA] 分析依赖：',
     debugPackageCompleto: '[BUSCA] 完整的 package.json：',
     debugPackageVue: '[BUSCA] Package.json 包含 Vue：',
 };
-//# sourceMappingURL=detector-context-extra-messages.js.map

package/dist/core/messages/zh/analysts/detector-css-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorCssMensagens = {
     emptyRule: '检测到空 CSS 规则',
     emptyRuleSugestao: '移除空规则或添加属性',
@@ -48,4 +49,3 @@ export const DetectorCssMensagens = {
     cssHack: '检测到 CSS hack',
     cssHackSugestao: '移除浏览器 hack - 使用特性检测',
 };
-//# sourceMappingURL=detector-css-messages.js.map

package/dist/core/messages/zh/analysts/detector-dependencies-messages.js

@@ -1,3 +1,10 @@
+// SPDX-License-Identifier: MIT
+/**
+ * @fileoverview 依赖检测器的诊断消息。
+ * 提供文本模板,用于检测外部依赖的 import/require、
+ * 过长的相对路径、不存在的文件、混用 require/import、
+ * 循环导入以及其他导入不良实践。
+ */
 export const DetectorDependenciasMensagens = {
     importDependenciaExterna: (val) => `导入外部依赖:'${val}'`,
     importRelativoLongo: (val) => `相对导入跨越过多目录:'${val}'`,
@@ -12,4 +19,3 @@ export const DetectorDependenciasMensagens = {
     importCircularSelf: '检测到循环导入:文件导入了自身。',
     dependenciaCircular: (totalArquivos, caminhoCompleto) => `检测到循环依赖(${totalArquivos} 个文件):${caminhoCompleto}`
 };
-//# sourceMappingURL=detector-dependencies-messages.js.map

package/dist/core/messages/zh/analysts/detector-distributed-arch-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 function erroToMessage(erro) {
     return erro instanceof Error ? erro.message : '未知错误';
 }
@@ -14,4 +15,3 @@ export const DetectorDistributedArchMensagens = {
     semContainerizacao: '服务未容器化。请考虑添加 Docker 实现一致部署',
     erroAnalisarDistributedArch: (erro) => `分析分布式架构时出错:${erroToMessage(erro)}`
 };
-//# sourceMappingURL=detector-distributed-arch-messages.js.map

package/dist/core/messages/zh/analysts/detector-html-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorHtmlMensagens = {
     missingDoctype: '缺少DOCTYPE',
     missingDoctypeSugestao: '请在文件开头添加<!DOCTYPE html>',
@@ -47,4 +48,3 @@ export const DetectorHtmlMensagens = {
     performanceRenderBlocking: '检测到阻塞渲染的资源',
     metaRefreshUnsafe: '带URL的Meta refresh (开放重定向风险)',
 };
-//# sourceMappingURL=detector-html-messages.js.map

package/dist/core/messages/zh/analysts/detector-interfaces-inline-messages.js

@@ -1,7 +1,7 @@
+// SPDX-License-Identifier: MIT
 export const DetectorInterfacesInlineMensagens = {
     moverTipoParaTipos: (nomeTipo, tiposDir = 'src/tipos') => `将类型 '${nomeTipo}' 移至 ${tiposDir.endsWith('/') ? tiposDir : `${tiposDir}/`}`,
     interfaceExportadaParaTipos: (nomeInterface, tiposDir = 'src/tipos') => `导出的接口 '${nomeInterface}' 应位于 ${tiposDir.endsWith('/') ? tiposDir : `${tiposDir}/`}`,
     interfaceComplexaParaTipos: (nomeInterface, tiposDir = 'src/tipos') => `复杂接口 '${nomeInterface}' 应移至 ${tiposDir.endsWith('/') ? tiposDir : `${tiposDir}/`}`,
     tipoDuplicado: (args) => `类型 {${args.propriedades.join(', ')}...} 重复 ${args.totalOcorrencias} 次 ${args.contextoDesc} - 提取为 '${args.nomesSugeridos}Type'`
 };
-//# sourceMappingURL=detector-interfaces-inline-messages.js.map

package/dist/core/messages/zh/analysts/detector-jenkins-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorJenkinsMensagens = {
     missingTimeout: '管道或阶段未配置超时',
     missingTimeoutSugestao: "请添加 \"options { timeout(time: 30, unit: 'MINUTES') }\" 块以防止僵尸作业",
@@ -64,4 +65,3 @@ export const DetectorJenkinsMensagens = {
     archiveArtifactsWithoutPattern: '归档工件时未指定模式',
     archiveArtifactsWithoutPatternSugestao: '指定工件模式',
 };
-//# sourceMappingURL=detector-jenkins-messages.js.map

package/dist/core/messages/zh/analysts/detector-js-ts-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorJsTsMensagens = {
     tipoAnyComUtilidade: (varNome, _tipo) => `在 '${varNome}' 中使用带'any'的类型工具掩盖了类型安全性的丧失`,
     tipoAnyComUtilidadeSugestao: (tipo) => `替换为: ${tipo.replace('any', 'TipoEspecifico')}`,
@@ -53,5 +54,31 @@ export const DetectorJsTsMensagens = {
     observerWithoutDisconnect: 'Observer（MutationObserver/IntersectionObserver）没有 disconnect()。这会导致内存泄漏。',
     webSocketWithoutClose: 'WebSocket 没有对应的 close() 调用。连接可能保持打开状态。',
     workerWithoutTerminate: 'Worker 没有 terminate() 调用。worker 将继续在后台运行。',
+    // ES2025+ features
+    satisfiesAvailable: '类型可以使用 "satisfies" 替代 "as" 断言以获得更安全的窄化',
+    satisfiesAvailableSugestao: '将 "as Type" 替换为 "satisfies Type" 以验证而不拓宽类型',
+    usingResourceManagement: '检测到使用 "using" 的显式资源管理 (ES2026)',
+    usingResourceManagementSugestao: '确保资源实现了 Symbol.dispose 或 Symbol.asyncDispose',
+    temporalApi: '检测到 Temporal API 使用 (ES2026)',
+    temporalApiSugestao: 'Temporal 替代 Date — 使用 Temporal.Now, Temporal.PlainDate 等',
+    iteratorHelper: '检测到迭代器辅助方法 (ES2025)',
+    iteratorHelperSugestao: '迭代器辅助方法 (.map(), .filter(), .take()) 支持惰性求值',
+    setMethods: '检测到新的 Set 方法 (ES2025)',
+    setMethodsSugestao: '使用 Set.prototype.union(), .intersection(), .difference() 进行集合操作',
+    topLevelAwait: '检测到顶层 await',
+    topLevelAwaitSugestao: '确认顶层 await 不会不必要地阻塞导入',
+    promiseWithResolvers: '检测到 Promise.withResolvers() (ES2025)',
+    promiseWithResolversSugestao: '尽可能使用 async/await 而不是 Promise.withResolvers()',
+    promiseAllSettled: '检测到 Promise.allSettled() — 适合 all-settled 模式',
+    promiseAllSettledSugestao: '当你需要所有 promise 的结果（无论是否被拒绝）时使用 Promise.allSettled()',
+    forAwaitOf: '检测到 for await...of — 异步迭代',
+    forAwaitOfSugestao: '确保异步可迭代对象正确实现了 Symbol.asyncIterator',
+    regexpEscape: '检测到 RegExp.escape() (ES2025)',
+    regexpEscapeSugestao: '使用 RegExp.escape() 安全地转义正则表达式中的用户输入',
+    errorIsError: '检测到 Error.isError() (ES2026)',
+    errorIsErrorSugestao: '使用 Error.isError() 进行可靠的错误类型检查',
+    arrayFromAsync: '检测到 Array.fromAsync() (ES2026)',
+    arrayFromAsyncSugestao: '使用 Array.fromAsync() 从异步可迭代对象创建数组',
+    mapGetOrInsert: '检测到 Map.getOrInsert() / .getOrInsertComputed() (ES2026)',
+    mapGetOrInsertSugestao: '使用 getOrInsert() 进行原子化的 Map upsert 操作',
 };
-//# sourceMappingURL=detector-js-ts-messages.js.map

package/dist/core/messages/zh/analysts/detector-python-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorPythonMensagens = {
     bareExcept: '检测到裸except - 捕获包括SystemExit在内的所有异常',
     bareExceptSugestao: '请使用except Exception: 或特定异常',
@@ -14,4 +15,3 @@ export const DetectorPythonMensagens = {
     subprocessShell: 'subprocess使用shell=True - 存在注入风险',
     subprocessShellSugestao: '请传递参数列表，而不是使用shell=True的字符串',
 };
-//# sourceMappingURL=detector-python-messages.js.map

package/dist/core/messages/zh/analysts/detector-react-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorReactMensagens = {
     dangerousHtml: '检测到dangerouslySetInnerHTML - 存在XSS风险',
     dangerousHtmlSugestao: '请使用DOMPurify或sanitize-html对内容进行消毒',
@@ -56,5 +57,12 @@ export const DetectorReactMensagens = {
     contextTooBroadSugestao: '拆分为更小的context',
     liftingStateTooHigh: '状态提升到比所需更多的层级',
     liftingStateTooHighSugestao: '考虑使用context或局部状态',
+    react19ForwardRef: 'forwardRef 在 React 19 中已弃用',
+    react19ForwardRefSugestao: '将 ref 作为常规 prop 传递',
+    react19FC: 'React.FC 在 React 19 中已弃用',
+    react19FCSugestao: '直接键入 props，不要使用 React.FC',
+    react19UseClient: '缺少 \'use client\' 指令 (React 19)',
+    react19UseClientSugestao: '为客户端组件在文件顶部添加 \'use client\'',
+    react19DefaultProps: 'defaultProps 在 React 19 中已弃用',
+    react19DefaultPropsSugestao: '使用默认参数值代替',
 };
-//# sourceMappingURL=detector-react-messages.js.map

package/dist/core/messages/zh/analysts/detector-shell-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorShellMensagens = {
     missingShebang: '脚本缺少shebang',
     missingShebangSugestao: '请添加#!/bin/bash或#!/bin/sh',
@@ -15,6 +16,7 @@ export const DetectorShellMensagens = {
     unquotedVariableSugestao: '请使用"$VAR"代替$VAR',
     sudoUsage: '检测到使用sudo',
     sudoUsageSugestao: '请设计无需root权限即可运行的脚本',
+    // Security (enhanced)
     unsafePipefail: '管道缺少pipefail - 管道错误被忽略',
     unsafePipefailSugestao: '添加"set -o pipefail"以捕获管道错误',
     unsafeCdWithoutCheck: 'cd没有错误检查',
@@ -27,6 +29,7 @@ export const DetectorShellMensagens = {
     dangerousFlagsSugestao: '确认标志是故意的且范围有限',
     unsafeReadWithoutR: 'read没有使用-r(反斜杠被解释)',
     unsafeReadWithoutRSugestao: '使用"read -r"以保留反斜杠',
+    // Best Practices
     missingLocalVar: '函数中的变量未声明为local',
     missingLocalVarSugestao: '使用"local"关键字限定变量作用域',
     uppercaseLocalVar: '局部变量使用大写命名',
@@ -43,17 +46,35 @@ export const DetectorShellMensagens = {
     missingDefaultCaseSugestao: '添加*)默认情况以确保安全',
     emptyCatchBlock: '空的then/else块',
     emptyCatchBlockSugestao: '添加注释或删除空块',
+    // Portability
     bashismDetected: '#!/bin/sh脚本中的Bash特有功能',
     bashismDetectedSugestao: '为sh脚本使用POSIX兼容语法',
     platformSpecificPath: '平台特定路径(/usr/bin vs /bin)',
     platformSpecificPathSugestao: '使用command -v或which进行发现',
     missingQuoteArrays: '数组展开未加引号',
     missingQuoteArraysSugestao: '使用"${arr[@]}"以保留空格',
+    // Performance
     uselessCat: 'cat file | command而不是command < file',
     uselessCatSugestao: '使用输入重定向代替cat管道',
     loopOverCommandOutput: 'for file in $(ls)而不是for file in *',
     loopOverCommandOutputSugestao: '使用glob模式代替解析ls',
     pipeOverTempfile: '管道可以替代临时文件',
     pipeOverTempfileSugestao: '使用管道代替临时文件',
+    // Modern Bash (2026)
+    missingSetU: '缺少 "set -u" — 未设置的变量将静默展开为空',
+    missingSetUSugestao: '添加 "set -u" 以捕获变量名拼写错误',
+    missingIso: '缺少 IFS=$\'\\n\\t\' — 分词可能导致意外行为',
+    missingIsoSugestao: '在脚本开头添加 IFS=$\'\\n\\t\' 以确保安全分词',
+    missingTrap: '未找到 trap 处理程序 — 信号时可能跳过清理',
+    missingTrapSugestao: '添加 trap 处理程序: trap "cleanup" EXIT INT TERM',
+    missingMainFn: '脚本缺少 main 函数模式',
+    missingMainFnSugestao: '将逻辑包装在 main() 中并在底部调用 main "$@"',
+    missingCommandV: '硬编码路径而非使用 command -v',
+    missingCommandVSugestao: '使用 "command -v <工具>" 检查可用性',
+    missingDebugMode: '脚本没有调试模式 — 故障排除更困难',
+    missingDebugModeSugestao: '添加 [[ "${DEBUG:-}" == "true" ]] && set -x 以启用调试跟踪',
+    missingInputValidation: '命令参数未验证 — 意外输入可能导致错误',
+    missingInputValidationSugestao: '在开头验证参数: [[ -z "$1" ]] && { echo "用法: ..."; exit 1; }',
+    shellCheckRecommended: '考虑运行 ShellCheck 进行全面分析',
+    shellCheckRecommendedSugestao: '安装 shellcheck 并运行: shellcheck script.sh',
 };
-//# sourceMappingURL=detector-shell-messages.js.map

package/dist/core/messages/zh/analysts/detector-sql-messages.js

@@ -1,4 +1,6 @@
+// SPDX-License-Identifier: MIT
 export const DetectorSqlMensagens = {
+    // ── 现有 ──────────────────────────────────────────────────────────────────
     missingWhere: 'DELETE/UPDATE缺少WHERE子句',
     missingWhereSugestao: '请添加WHERE以限制影响范围',
     selectStar: '检测到SELECT *',
@@ -11,6 +13,7 @@ export const DetectorSqlMensagens = {
     missingIfNotExistsSugestao: '请使用CREATE ... IF NOT EXISTS以实现幂等性',
     varcharWithoutSize: 'VARCHAR未定义大小',
     varcharWithoutSizeSugestao: '请定义最大大小: VARCHAR(255)',
+    // ── 安全 ──────────────────────────────────────────────────────────────────
     sqlInjectionDynamic: '检测到动态SQL字符串拼接',
     sqlInjectionDynamicSugestao: '请使用参数化查询（预编译语句）',
     dynamicWhere: 'WHERE子句通过字符串拼接构建',
@@ -21,6 +24,7 @@ export const DetectorSqlMensagens = {
     sqlWithoutTransactionSugestao: '请使用BEGIN/COMMIT包装或ORM事务',
     grantAllPrivileges: '检测到GRANT ALL PRIVILEGES',
     grantAllPrivilegesSugestao: '请仅授予所需的特定权限',
+    // ── 注入模式 ──────────────────────────────────────────────────────────────
     unsafeConcatInQuery: 'SQL查询中的变量插值',
     unsafeConcatInQuerySugestao: '请使用参数化查询',
     likeWithoutEscape: 'LIKE模式使用用户输入但未使用ESCAPE',
@@ -29,6 +33,7 @@ export const DetectorSqlMensagens = {
     orderByInjectionSugestao: '请根据白名单验证列名',
     limitOffsetInjection: 'LIMIT/OFFSET使用动态值',
     limitOffsetInjectionSugestao: '请转换为整数或使用参数化查询',
+    // ── 性能 ──────────────────────────────────────────────────────────────────
     noIndexColumns: 'WHERE中的列没有索引（启发式）',
     noIndexColumnsSugestao: '请考虑添加索引',
     functionOnColumn: 'WHERE中对列应用了函数（阻止索引使用）',
@@ -41,6 +46,7 @@ export const DetectorSqlMensagens = {
     notInSubquerySugestao: '请使用NOT EXISTS代替NOT IN',
     orWithMultipleConditions: '多个OR条件（可能无法使用索引）',
     orWithMultipleConditionsSugestao: '请考虑使用UNION或重构查询',
+    // ── 最佳实践 ──────────────────────────────────────────────────────────────
     missingNotNull: '列缺少NOT NULL约束',
     missingNotNullSugestao: '如适用请添加NOT NULL',
     missingDefault: 'NULL默认值的列可以设置显式默认值',
@@ -55,9 +61,9 @@ export const DetectorSqlMensagens = {
     floatForCurrencySugestao: '请使用DECIMAL以确保货币精度',
     missingForeignKey: '可能存在关系但缺少外键',
     missingForeignKeySugestao: '请添加FOREIGN KEY约束',
+    // ── ORM特定 ───────────────────────────────────────────────────────────────
     eagerLoadingMissing: '循环中的延迟加载（N+1）',
     eagerLoadingMissingSugestao: '请使用.with_()或.include()进行预加载',
     transactionTooLarge: '单个事务包含过多操作',
     transactionTooLargeSugestao: '请将操作分批到较小的事务中',
 };
-//# sourceMappingURL=detector-sql-messages.js.map

package/dist/core/messages/zh/analysts/detector-structure-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorEstruturaMensagens = {
     monorepoDetectado: '检测到 Monorepo 结构。',
     monorepoSemPackages: 'Monorepo 缺少 packages/ 目录。',
@@ -13,4 +14,3 @@ export const DetectorEstruturaMensagens = {
     multiplosEntrypointsLista: (preview, resto) => resto > 0 ? `项目有多个入口点:${preview.join(', ')} ...(+${resto} 个已隐藏)` : `项目有多个入口点:${preview.join(', ')}`,
     nomeDiretorioNaoConforme: (atual, esperado) => `目录 '${atual}' 不符合命名约定。期望名称:'${esperado}'。`
 };
-//# sourceMappingURL=detector-structure-messages.js.map

package/dist/core/messages/zh/analysts/detector-svg-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorSvgMensagens = {
     notValid: '.svg文件不包含<svg>标签',
     notValidSugestao: '请检查文件是否为有效的SVG',
@@ -12,4 +13,3 @@ export const DetectorSvgMensagens = {
     missingDimensions: 'SVG未定义width/height',
     missingDimensionsSugestao: '请添加width和height以确保布局稳定',
 };
-//# sourceMappingURL=detector-svg-messages.js.map

package/dist/core/messages/zh/analysts/detector-tailwind-messages.js

@@ -1,16 +1,17 @@
+// SPDX-License-Identifier: MIT
 export const DetectorTailwindMensagens = {
     conflictingClasses: (key, tokens) => `${key} 的冲突类: ${tokens}`,
     conflictingClassesSugestao: '请删除冲突的类，只保留需要的那个',
     repeatedClasses: (duplicates) => `重复的类: ${duplicates}`,
     repeatedClassesSugestao: '请删除重复的类',
     arbitraryValue: (val) => `检测到任意值: ${val}`,
-    arbitraryValueSugestao: '请考虑添加到tailwind.config.js中',
+    arbitraryValueSugestao: '请考虑通过 CSS 中的 @theme 添加 (Tailwind v4)',
     important: '在Tailwind类中检测到!important',
     importantSugestao: '避免使用!important - 请重构优先级',
     arbitraryValueOveruse: '过度使用任意值 - 可能表明缺少设计令牌',
-    arbitraryValueOveruseSugestao: '在 tailwind.config.js 中定义自定义令牌，而不是使用任意值',
+    arbitraryValueOveruseSugestao: '通过 CSS 中的 @theme 定义自定义令牌，而不是使用任意值 (Tailwind v4)',
     missingDesignToken: '检测到硬编码值 - 请使用 Tailwind 设计令牌',
-    missingDesignTokenSugestao: '将颜色、间距和大小提取到 tailwind.config.js 中',
+    missingDesignTokenSugestao: '将颜色、间距和大小提取到 CSS 的 @theme 中 (Tailwind v4)',
     responsiveWithoutBase: '响应式类没有对应的基础类',
     responsiveWithoutBaseSugestao: '在响应式变体之前添加基础类',
     inlineStylesWithTailwind: '检测到内联样式与 Tailwind 类一起使用',
@@ -26,4 +27,3 @@ export const DetectorTailwindMensagens = {
     nestedTailwindPlugin: '嵌套的 Tailwind 插件可能导致冲突',
     nestedTailwindPluginSugestao: '避免在 @layer 内嵌套 Tailwind 插件',
 };
-//# sourceMappingURL=detector-tailwind-messages.js.map

package/dist/core/messages/zh/analysts/detector-xml-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const DetectorXmlMensagens = {
     doctype: '检测到DOCTYPE - 存在潜在的XXE风险',
     doctypeSugestao: '请在XML解析器中禁用DOCTYPE',
@@ -72,4 +73,3 @@ export const DetectorXmlMensagens = {
     xslIncludeInjection: '检测到不安全的XSLT包含（<xsl:include>）',
     xslIncludeInjectionSugestao: '请验证XSLT包含路径以防止路径遍历',
 };
-//# sourceMappingURL=detector-xml-messages.js.map

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

@@ -1,3 +1,7 @@
+// SPDX-License-Identifier: MIT
+/**
+ * Mensagens de Analistas e Detectores
+ */
 export * from './analyst-commands-cli-messages.js';
 export * from './analyst-github-actions-messages.js';
 export * from './analyst-gitlab-ci-messages.js';
@@ -37,4 +41,3 @@ export * from './report-github-actions-messages.js';
 export * from './report-gitlab-ci-messages.js';
 export * from './report-jenkins-messages.js';
 export * from './scorer-messages.js';
-//# sourceMappingURL=index.js.map

package/dist/core/messages/zh/analysts/map-reversion-extra-messages.js

@@ -1,3 +1,6 @@
+/**
+ * Extra messages for reversal map (Chinese).
+ */
 export const MapaReversaoExtraMensagens = {
     mapaSalvo: '[SAVE] 回滚映射已保存:{total} 个移动',
     moveRegistrado: '[DOCUMENTO] 已注册移动:{origem} → {destino}({motivo})',
@@ -7,4 +10,3 @@ export const MapaReversaoExtraMensagens = {
     tituloMapa: '[LIST] 回滚映射({total} 个移动):\n\n',
     mapaLimpo: '[BROOM] 回滚映射已清除',
 };
-//# sourceMappingURL=map-reversion-extra-messages.js.map

package/dist/core/messages/zh/analysts/report-azure-messages.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 export const RelatorioAzureMensagens = {
     tituloPadrao: '分析报告 - Azure Pipelines',
     repositorio: (nome) => `**仓库:** ${nome}`,
@@ -15,6 +16,7 @@ export const RelatorioAzureMensagens = {
     schemaJson: 'mahoraga://schemas/azure-pipelines-report/v1',
     versao: '0.7.0',
     csvCabecalho: '文件,行,严重程度,类型,消息,建议',
+    // Security
     vulnerableTask: '使用易受攻击的任务版本',
     vulnerableTaskSugestao: '将任务更新到最新版本',
     missingCheckoutToken: '私有仓库检出未使用个人访问令牌',
@@ -27,6 +29,7 @@ export const RelatorioAzureMensagens = {
     environmentWithoutReviewersSugestao: '为生产环境配置手动审批',
     unsafeVariableInjection: '脚本中存在不安全的变量注入',
     unsafeVariableInjectionSugestao: '安全使用宏语法 $(var)',
+    // Performance
     missingParallelDeployment: '部署作业可以并行运行',
     missingParallelDeploymentSugestao: '配置并行部署策略',
     missingCacheTask: '构建未缓存依赖项',
@@ -37,6 +40,7 @@ export const RelatorioAzureMensagens = {
     singleBuildForAllPlatformsSugestao: '使用矩阵策略进行多平台构建',
     missingConditionalSteps: '始终运行但应条件化的步骤',
     missingConditionalStepsSugestao: '为不必要的步骤添加条件',
+    // Structure
     missingStageDependencies: '阶段没有显式依赖',
     missingStageDependenciesSugestao: '定义dependsOn以排序阶段',
     mutableAgentPool: '使用Microsoft托管代理但未指定池',
@@ -51,6 +55,7 @@ export const RelatorioAzureMensagens = {
     templateWithoutParametersSugestao: '传递必需的模板参数',
     missingJobDisplayName: '作业没有显示名称',
     missingJobDisplayNameSugestao: '添加displayName以提高清晰度',
+    // Compliance
     missingRequiredTemplate: '缺少必需的模板结构',
     missingRequiredTemplateSugestao: '遵循模板约定',
     deploymentWithoutCheckpoint: '滚动部署无检查点',
@@ -58,4 +63,3 @@ export const RelatorioAzureMensagens = {
     missingValidationStep: '构建未设置验证/质量关卡',
     missingValidationStepSugestao: '添加质量关卡步骤',
 };
-//# sourceMappingURL=report-azure-messages.js.map