@mocoto/mahoraga 0.14.1 → 0.14.3

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

@@ -162,11 +162,11 @@ export const ICONES_ZELADOR = {
 export function getIcone(categoria, nome) {
     switch (categoria) {
         case 'nivel':
-            return ICONES_NIVEL[nome] || ICONES_NIVEL.info;
+            return ICONES_NIVEL[nome];
         case 'status':
-            return ICONES_STATUS[nome] || ICONES_STATUS.pendente;
+            return ICONES_STATUS[nome];
         case 'acao':
-            return ICONES_ACAO[nome] || '[*]';
+            return ICONES_ACAO[nome];
         default:
             return '[*]';
     }

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

@@ -54,5 +54,5 @@ export const AnalistaGithubActionsMensagens = {
     pullRequestTargetGrantsWritePermissionsSugestao: '使用 pull_request 代替 pull_request_target,或仔细验证源分支',
     workflowDispatchWithoutInputs: 'workflow_dispatch 未定义 inputs',
     workflowDispatchWithoutInputsSugestao: '定义必需输入以控制手动工作流执行',
-    erroAplicarCorrecao: (erro) => `应用修复错误: ${erro}`,
+    erroAplicarCorrecao: (erro) => `应用修复错误: ${String(erro)}`,
 };

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

@@ -16,5 +16,6 @@ export const PadroesUsoMensagens = {
     nonArrowCallback: "使用 'function' 的回调更适合使用箭头函数。建议使用 () => {}。",
     consoleLog: "在生产代码中检测到 console.log。请删除或替换为适当的日志记录器。",
     uselessConditional: "不必要的比较：if (x === true)。只需使用 if (x)。",
+    satisfiesUsage: "TypeScript 的 'satisfies' 关键字已使用 — 在不拓宽类型的情况下确保类型安全",
     erroAnalise: (relPath, erro) => `分析 ${relPath} 中的使用模式失败：${erro}`
 };

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

@@ -60,4 +60,19 @@ export const AnalistaShellMensagens = {
     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; }。',
 };

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

@@ -11,4 +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()",
 };

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

@@ -54,4 +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 操作',
 };

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

@@ -57,4 +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: '使用默认参数值代替',
 };

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

@@ -60,4 +60,21 @@ export const DetectorShellMensagens = {
     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',
 };

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

@@ -5,13 +5,13 @@ export const DetectorTailwindMensagens = {
     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 类一起使用',

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

@@ -1,18 +1,18 @@
 // SPDX-License-Identifier: MIT
 export const RelatorioCircleciMensagens = {
     tituloPadrao: '分析报告 - CircleCI',
-    repositorio: (nome) => `**仓库:** ${nome}`,
-    data: (data) => `**日期:** ${data}`,
-    tempo: (ms) => `**时间:** ${ms}ms`,
+    repositorio: (...args) => `**仓库:** ${String(args[0])}`,
+    data: (...args) => `**日期:** ${String(args[0])}`,
+    tempo: (...args) => `**时间:** ${args[0]}ms`,
     resumo: '## 摘要',
-    scoreGeral: (score) => `| 总体评分 | ${score}/100 |`,
-    totalConfigs: (total) => `| 配置总数 | ${total} |`,
-    totalOcorrencias: (total) => `| 出现总次数 | ${total} |`,
+    scoreGeral: (...args) => `| 总体评分 | ${args[0]}/100 |`,
+    totalConfigs: (...args) => `| 配置总数 | ${args[0]} |`,
+    totalOcorrencias: (...args) => `| 出现总次数 | ${args[0]} |`,
     severidade: '## 严重程度',
     configsAnalisadas: '## 已分析的配置',
     ocorrenciasDetalhadas: '## 详细出现情况',
     geradoPor: '*由Mahoraga v0.7.0生成*',
-    formatoNaoSuportado: (formato) => `不支持的格式: ${formato}`,
+    formatoNaoSuportado: (...args) => `不支持的格式: ${args[0]}`,
     schemaJson: 'mahoraga://schemas/circleci-report/v1',
     versao: '0.7.0',
     csvCabecalho: '文件,行,严重程度,类型,消息,建议',

package/dist/core/messages/zh/caretakers/caretaker-messages.js

@@ -1,19 +1,13 @@
 // SPDX-License-Identifier: MIT
 // @mahoraga-disable tipo-literal-inline-complexo
 // Justification: inline types for caretaker messages
-import { ICONES_ACAO, ICONES_STATUS, ICONES_ZELADOR as ICONES_ZELADOR_CENTRAL } from '../../shared/icons.js';
+import { ICONES_ACAO, ICONES_STATUS, ICONES_ZELADOR } from '../../shared/icons.js';
 /**
  * 管理员消息
  *
  * 集中化所有与管理员 (自动修复) 相关的消息
  * 包括: 导入、类型、结构等。
  */
-/**
- * 管理员使用的图标和表情
- */
-const ICONES_ZELADOR = {
-    ...ICONES_ZELADOR_CENTRAL
-};
 /**
  * 导入管理员消息
  */

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

@@ -29,7 +29,16 @@ export const ReactMensagens = {
 export const ReactHooksMensagens = {
     useEffectNoDeps: 'useEffect 缺少依赖数组 (请评估依赖项以避免循环)。',
     memoCallbackNoDeps: 'Hook 缺少依赖数组 (useMemo/useCallback)。',
-    hookInConditional: '在条件语句中声明了 Hook (违反了 Hooks 规则)。'
+    hookInConditional: '在条件语句中声明了 Hook (违反了 Hooks 规则)。',
+    react19Use: '检测到 use() 钩子 (React 19) — 请确保包裹在 <Suspense> 边界内。',
+    react19UseOptimistic: '检测到 useOptimistic 钩子 (React 19) — 需要更新函数。',
+    react19UseActionState: '检测到 useActionState 钩子 (React 19) — 用于表单操作。',
+    react19UseFormStatus: '检测到 useFormStatus 钩子 (React 19) — 访问表单待处理状态。',
+    react19ForwardRefDeprecated: 'forwardRef 在 React 19 中已弃用 — 将 ref 作为常规 prop 传递。',
+    react19FCDeprecated: 'React.FC/FunctionComponent 在 React 19 中已弃用 — 直接键入 props。',
+    react19DefaultPropsDeprecated: 'defaultProps 在 React 19 中已弃用 — 使用默认参数。',
+    react19UseClient: '文件使用了客户端功能 (hooks/events) 但缺少 \'use client\' 指令 (React 19)。',
+    react19FormAction: '检测到带有 action 属性的表单 (React 19)。'
 };
 // ─── Tailwind 消息 ──────────────────────────────────────────────
 export const TailwindMensagens = {
@@ -38,7 +47,13 @@ export const TailwindMensagens = {
     importantUsage: (token) => `在 (${token}) 中检测到使用 ! (important)。建议使用工具类或作用域增强,而非 important。`,
     variantConflict: (prop, variants) => `${prop} 可能存在变体冲突 (变体: ${variants.slice(0, 6).join(', ')})。请检查顺序/作用域。`,
     dangerousArbitraryValue: (token) => `带有潜在危险的 url 任意值 (${token})。避免使用 javascript:/data:text/html。`,
-    arbitraryValue: (token) => `带有任意值的类 (${token})。请确认是否符合设计。`
+    arbitraryValue: (token) => `带有任意值的类 (${token})。请确认是否符合设计。`,
+    v3DeprecatedUtility: (token, replacement) => `v3 废弃的工具类 "${token}" → 使用 "${replacement}" (Tailwind v4).`,
+    v3Directive: `检测到 @tailwind 指令 (v3) → 使用 @import "tailwindcss" (Tailwind v4).`,
+    v3LayerUtilities: `检测到 @layer utilities (v3) → 使用 @utility (Tailwind v4).`,
+    themeFunction: `检测到 theme() 函数 (v3 已弃用) → 优先使用 CSS 变量 (var(--color-*)).`,
+    v3ImportantPrefix: (token) => `"${token}" 中的 !important 前缀 (v3) → 将 ! 移到末尾 ("${token.replace('!', '')}!" ).`,
+    v3ArbitraryVar: `方括号中的变量 (v3) → 使用圆括号 (例如用 bg-(--var) 代替 bg-[--var]).`
 };
 // ─── CSS 消息 ───────────────────────────────────────────────────
 export const CssMensagens = {
@@ -270,7 +285,20 @@ export const RustMensagens = {
     missingDoc: (fnName) => `公开函数 '${fnName}' 缺少文档注释 (///)。`,
     namingConvention: (constName) => `常量 '${constName}' 应遵循 SCREAMING_CASE 命名约定。`,
     redundantReturn: '函数末尾的 return 是多余的;Rust 使用隐式返回 (最后一个表达式)。',
-    wildcardImport: (importPath) => `通配符导入 '${importPath}' 可能污染命名空间;建议使用显式导入。`
+    wildcardImport: (importPath) => `通配符导入 '${importPath}' 可能污染命名空间;建议使用显式导入。`,
+    lazyLockSuggestion: '检测到 once_cell::sync::Lazy — 使用 std::sync::LazyLock (Rust 1.80+)。',
+    onceLockSuggestion: '检测到 once_cell::sync::OnceCell — 使用 std::sync::OnceLock (Rust 1.70+)。',
+    offsetOfSuggestion: '手动指针偏移访问字段 — 使用 std::mem::offset_of! (Rust 1.77+)。',
+    letChainsPattern: '检测到 let_chains 模式 (Rust 1.78 起稳定)。',
+    assertMatchesSuggestion: 'assert!(matches!(...)) 模式 — 考虑 assert_matches!(...) (nightly)。',
+    isSomeAnd: '.is_some() && 谓词模式 — 使用 .is_some_and(|x| ...) (Rust 1.70+)。',
+    isOkAnd: '.is_ok() && 谓词模式 — 使用 .is_ok_and(|x| ...) (Rust 1.70+)。',
+    inspectMethod: '具有副作用的 map() — 使用 .inspect() (Rust 1.76+)。',
+    implicitFormatCapture: 'format!("...{var}...") 可使用隐式捕获 (Rust 1.80+)。',
+    pointerCast: '使用 `as` 进行指针转换 — 使用 .cast() (Rust 1.72+)。',
+    splitOnce: '使用索引访问的 splitn(2, ...) — 使用 .split_once() (Rust 1.62+)。',
+    okErrAntipattern: '.ok()?.unwrap() 反模式 — 直接在 Result 上使用 ?。',
+    collectOverPush: '循环中使用 push() 构建集合 — 使用 .map().collect()。'
 };
 // ─── Java / Kotlin 消息 ─────────────────────────────────────────
 export const JavaMensagens = {

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

@@ -140,7 +140,7 @@ export function formatarLinha({ nivel, mensagem, sanitize = true }) {
     if (!process.env.VITEST && process.env.SUKUNA_CENTER === '1') {
         try {
             const cols = obterColunasTerm();
-            const out = process.stdout && typeof process.stdout.isTTY !== 'undefined' ? process.stdout : undefined;
+            const out = typeof process.stdout.isTTY !== 'undefined' ? process.stdout : undefined;
             const isTty = !!out && out.isTTY;
             if (isTty && cols && cols > 0) {
                 const ANSI_REGEX = /[\u001B\u009B][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
@@ -164,7 +164,7 @@ export function formatarLinha({ nivel, mensagem, sanitize = true }) {
 function obterColunasTerm() {
     // Tries to get terminal width safely
     try {
-        const out = process.stdout && typeof process.stdout.columns !== 'undefined' ? process.stdout : undefined;
+        const out = typeof process.stdout.columns !== 'undefined' ? process.stdout : undefined;
         const cols = out?.columns;
         if (typeof cols === 'number' && cols > 0) {
             return cols;
@@ -414,7 +414,7 @@ export const log = {
                 const visibleLen = (string) => string.replace(ANSI_REGEX, '').length;
                 const frameWidth = Math.max(...lines.map(linha => visibleLen(linha)));
                 const cols = obterColunasTerm() ?? 0;
-                const outStream = process.stdout && typeof process.stdout.isTTY !== 'undefined' ? process.stdout : undefined;
+                const outStream = typeof process.stdout.isTTY !== 'undefined' ? process.stdout : undefined;
                 const isTty = !!outStream && outStream.isTTY;
                 if (isTty) {
                     const pad = Math.floor(Math.max(0, cols - frameWidth) / 2);

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

@@ -221,11 +221,7 @@ export const AGRUPAMENTOS_MENSAGEM = [
  * 获取问题类型的优先级
  */
 export function getPrioridade(tipo) {
-    return PRIORIDADES[tipo] || {
-        prioridade: 'baixa',
-        icone: ICONES_ARQUIVO.arquivo,
-        descricao: '未分类问题'
-    };
+    return PRIORIDADES[tipo];
 }
 /**
  * 按消息查找分组

package/dist/core/parsing/filters.js

@@ -16,7 +16,7 @@ export function aplicarSupressaoOcorrencias(ocorrencias, filtros) {
         const relPath = ocorrencia.relPath || '';
         const mensagem = (ocorrencia).mensagem || '';
         // Suprime por tipo/regra (verifica tanto o tipo quanto a mensagem)
-        if (filtros.suppressRules?.some(rule => tipo.includes(rule) || mensagem.includes(rule))) {
+        if (filtros.suppressRules?.some((rule) => tipo.includes(rule) || mensagem.includes(rule))) {
             return false;
         }
         // Suprime por severidade: se a regra tiver override de severidade "off", suprime
@@ -24,14 +24,14 @@ export function aplicarSupressaoOcorrencias(ocorrencias, filtros) {
             return false;
         }
         // Suprime por caminho (glob patterns)
-        if (filtros.suppressByPath?.some(pattern => {
+        if (filtros.suppressByPath?.some((pattern) => {
             const regex = globPatternToRegExp(pattern);
             return regex.test(relPath);
         })) {
             return false;
         }
         // Suprime por padrão de arquivo
-        if (filtros.suppressByFilePattern?.some(pattern => {
+        if (filtros.suppressByFilePattern?.some((pattern) => {
             const fileNome = relPath.split('/').pop() ?? '';
             const regex = globPatternToRegExp(pattern);
             return regex.test(fileNome);

package/dist/core/parsing/langs/json.js

@@ -7,7 +7,7 @@ export function parseComJson(codigo) {
         const info = {
             type: Array.isArray(parsed) ? 'array' : typeof parsed,
         };
-        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+        if (typeof parsed === 'object' && !Array.isArray(parsed)) {
             const keys = Object.keys(parsed);
             info.keys = keys;
             info.depth = estimateDepth(parsed, 0);

package/dist/core/parsing/langs/python.js

@@ -8,7 +8,7 @@ export function parseComPython(codigo) {
         const asyncFunctions = Array.from(codigo.matchAll(/^\s*async\s+def\s+([A-Za-z0-9_]+)/gm)).map(m => m[1]);
         const imports = Array.from(codigo.matchAll(/^\s*(?:from\s+([\w.]+)\s+)?import\s+(.+)$/gm)).map(m => ({
             module: m[1] || null,
-            names: m[2].split(',').map(s => s.trim().split(/\s+as\s+/)[0]).filter(Boolean) || []
+            names: m[2].split(',').map(s => s.trim().split(/\s+as\s+/)[0]).filter(Boolean)
         }));
         const decorators = Array.from(codigo.matchAll(/^\s*@([A-Za-z0-9_.]+)/gm)).map(m => m[1]);
         const topLevelVars = Array.from(codigo.matchAll(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=(?!=)/gm)).map(m => m[1]);

package/dist/core/parsing/langs/typescript.js

@@ -9,7 +9,7 @@ export function parseComTypeScript(codigo, tsx = false) {
         const sf = ts.createSourceFile(tsx ? 'file.tsx' : 'file.ts', codigo, ts.ScriptTarget.Latest, false, tsx ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
         return wrapMinimal(tsx ? 'tsx-tsc' : 'ts-tsc', {
             kind: sf.kind,
-            statements: sf.statements.length ?? 0
+            statements: sf.statements.length
         });
     }
     catch (erro) {

package/dist/core/parsing/parser.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getMessages } from '../messages/index.js';
 import { getGlobalRegistry, initializeDefaultPlugins } from '../../shared/plugins/index.js';
 import { parseComBabel, parseComCss, parseComGo, parseComHtmlFunc, parseComJson, parseComMarkdown, parseComPhp, parseComPython, parseComRust, parseComScss, parseComShell, parseComText, parseComTypeScript, parseComVue, parseComXml, parseComYaml, } from './langs/index.js';
@@ -83,7 +84,7 @@ export async function decifrarSintaxe(codigo, ext, opts = {}) {
     }
     if (opts.timeoutMs) {
         return (async () => {
-            let timer = null;
+            let timer = undefined;
             try {
                 const race = Promise.race([Promise.resolve(parseResultado), new Promise(resolve => {
                         timer = setTimeout(() => {
@@ -94,9 +95,7 @@ export async function decifrarSintaxe(codigo, ext, opts = {}) {
                 return await race;
             }
             finally {
-                if (timer) {
-                    clearTimeout(timer);
-                }
+                clearTimeout(timer);
                 setCurrentParsingFile(undefined);
             }
         })();

package/dist/core/parsing/utils.js

@@ -22,6 +22,7 @@ export function wrapMinimal(lang, rawAst) {
         },
         comments: [],
         tokens: [],
+        errors: [],
         mahoragaExtra: {
             lang,
             rawAst

package/dist/core/registry/file-registry.js

@@ -109,17 +109,18 @@ async function tryMigrate(targetPath) {
  */
 export async function readJSON(fileCaminho, options = {}) {
     const { default: defaultValue, migrate = true, validate } = options;
+    let resolvedPath = fileCaminho;
     try {
         // Tentar migração se habilitado
         if (migrate) {
             const migration = await tryMigrate(fileCaminho);
             if (migration.migrated && migration.to) {
                 // Usar arquivo migrado
-                fileCaminho = migration.to;
+                resolvedPath = migration.to;
             }
         }
         // Ler e parsear diretamente (sem check de existência separado para evitar TOCTOU)
-        const content = await fs.readFile(fileCaminho, 'utf-8');
+        const content = await fs.readFile(resolvedPath, 'utf-8');
         const parsed = JSON.parse(content);
         // Validar se fornecido
         if (validate && !validate(parsed)) {

package/dist/core/registry/paths.js

@@ -87,11 +87,11 @@ export const REPORT_PADROES = {
  */
 export const MIGRACAO_MAPA = {
     // Guardian: baseline.json → guardian.baseline.json
-    [SUKUNA_ARQUIVOS.GUARDIAN_BASELINE_LEGACY]: SUKUNA_ARQUIVOS.GUARDIAN_BASELINE,
+    [path.join(SUKUNA_DIRS.STATE, 'baseline.json')]: SUKUNA_ARQUIVOS.GUARDIAN_BASELINE,
     // Estrutura: baseline-estrutura.json → estrutura.baseline.json
-    [SUKUNA_ARQUIVOS.ESTRUTURA_BASELINE_LEGACY]: SUKUNA_ARQUIVOS.ESTRUTURA_BASELINE,
+    [path.join(SUKUNA_DIRS.STATE, 'baseline-estrutura.json')]: SUKUNA_ARQUIVOS.ESTRUTURA_BASELINE,
     // Arquétipo: mahoraga.repo.arquetipo.json (raiz) → .mahoraga/estrutura.arquetipo.json
-    [SUKUNA_ARQUIVOS.ESTRUTURA_ARQUETIPO_LEGACY_ROOT]: SUKUNA_ARQUIVOS.ESTRUTURA_ARQUETIPO
+    [path.join(PROJETO_RAIZ, 'mahoraga.repo.arquetipo.json')]: SUKUNA_ARQUIVOS.ESTRUTURA_ARQUETIPO
 };
 /**
  * Retorna o caminho legado (se existir) ou o novo

package/dist/core/reporting/default-reporter.js

@@ -23,7 +23,7 @@ export function createDefaultReporter() {
         }
         // Mapeamentos mínimos (incrementais) por code
         if (code === 'ARQ_PADRAO') {
-            const padrao = String((data?.padraoIdentificado) ?? '');
+            const padrao = typeof data?.padraoIdentificado === 'string' ? data.padraoIdentificado : '';
             const confianca = Number((data?.confianca) ?? 0);
             return criarOcorrencia({
                 tipo,
@@ -50,7 +50,7 @@ export function createDefaultReporter() {
             });
         }
         if (code === 'ARQ_VIOLACAO') {
-            const violacao = String((data?.violacao) ?? '');
+            const violacao = typeof data?.violacao === 'string' ? data.violacao : '';
             return criarOcorrencia({
                 tipo,
                 nivel,

package/dist/core/schema/version.js

@@ -23,10 +23,10 @@ export const HISTORICO_VERSOES = {
  * Cria metadados de schema para a versão atual
  */
 export function criarSchemaMetadata(versao = VERSAO_ATUAL, descricaoPersonalizada) {
-    const base = HISTORICO_VERSOES[versao];
-    if (!base) {
+    if (!(versao in HISTORICO_VERSOES)) {
         throw new Error(messages.ExcecoesMensagens.versaoSchemaDesconhecida(versao));
     }
+    const base = HISTORICO_VERSOES[versao];
     return {
         ...base,
         ...(descricaoPersonalizada && {
@@ -40,7 +40,7 @@ export function criarSchemaMetadata(versao = VERSAO_ATUAL, descricaoPersonalizad
 export function validarSchema(relatorio) {
     const erros = [];
     // Verificar estrutura básica
-    if (!relatorio || typeof relatorio !== 'object') {
+    if (typeof relatorio !== 'object') {
         erros.push('Relatório deve ser um objeto');
         return {
             valido: false,
@@ -64,7 +64,7 @@ export function validarSchema(relatorio) {
         }
     }
     // Verificar se a versão existe no histórico
-    if (schema.versao && typeof schema.versao === 'string' && !HISTORICO_VERSOES[schema.versao]) {
+    if (schema.versao && typeof schema.versao === 'string' && !(schema.versao in HISTORICO_VERSOES)) {
         erros.push(`Versão de schema desconhecida: ${schema.versao}`);
     }
     // Verificar presença dos dados
@@ -119,9 +119,9 @@ export function extrairDados(relatorio) {
  * Verifica se uma versão é compatível com a atual
  */
 export function versaoCompativel(versao) {
-    const metadata = HISTORICO_VERSOES[versao];
-    if (!metadata) {
+    if (!(versao in HISTORICO_VERSOES)) {
         return false;
     }
+    const metadata = HISTORICO_VERSOES[versao];
     return metadata.compatibilidade.includes(VERSAO_ATUAL);
 }

package/dist/core/workers/worker-executor.js

@@ -99,7 +99,7 @@ async function processarLote(lote, contexto) {
                 const inicio = Date.now();
                 const out = await executarTecnicaEmArquivo(tecnica, file, contexto, timeoutMs);
                 const dur = Date.now() - inicio;
-                if (out && Array.isArray(out)) {
+                if (Array.isArray(out)) {
                     fileResultado.ocorrencias.push(...out);
                 }
                 fileResultado.tempos.push({
@@ -150,8 +150,8 @@ async function main() {
             /* ignore */
         }
         const resultados = await processarLote(wd.lote ?? wd.files ?? [], contexto);
-        const occurrences = resultados.flatMap(raiz => raiz.ocorrencias || []);
-        const metrics = resultados.flatMap(raiz => raiz.tempos || []);
+        const occurrences = resultados.flatMap(raiz => raiz.ocorrencias);
+        const metrics = resultados.flatMap(raiz => raiz.tempos);
         const processedArquivos = Array.isArray(wd.files) ? wd.files.length : resultados.length || 0;
         if (port) {
             port.postMessage({

package/dist/guardian/baseline.js

@@ -9,7 +9,7 @@ import { lerEstado, salvarEstado } from '../shared/persistence/index.js';
 export async function carregarBaseline() {
     try {
         const json = await lerEstado(LINHA_BASE_CAMINHO);
-        if (json && typeof json === 'object' && !Array.isArray(json)) {
+        if (typeof json === 'object' && !Array.isArray(json)) {
             const entries = Object.entries(json).filter(([chave, valor]) => typeof chave === 'string' && typeof valor === 'string');
             return Object.fromEntries(entries);
         }

package/dist/guardian/gpg.js

@@ -80,6 +80,8 @@ export async function inicializarChaves() {
     }
     const par = await gerarParDeChaves();
     await salvarChavePublica(par.chavePublica);
-    await salvarChavePrivada(par.chavePrivada);
+    if (par.chavePrivada) {
+        await salvarChavePrivada(par.chavePrivada);
+    }
     return par;
 }

package/dist/guardian/integrity.js

@@ -1,11 +1,6 @@
 // SPDX-License-Identifier: MIT
-export var IntegridadeStatus;
-(function (IntegridadeStatus) {
-    IntegridadeStatus["Criado"] = "baseline-criado";
-    IntegridadeStatus["Aceito"] = "baseline-aceito";
-    IntegridadeStatus["Ok"] = "ok";
-    IntegridadeStatus["AlteracoesDetectadas"] = "alteracoes-detectadas";
-})(IntegridadeStatus || (IntegridadeStatus = {}));
+import { IntegridadeStatus } from '../types/guardian/integrity.js';
+export { IntegridadeStatus };
 export class GuardianError extends Error {
     detalhes;
     constructor(erros) {

package/dist/guardian/records.js

@@ -5,8 +5,12 @@ import { config } from '../core/config/index.js';
 import { getMessages } from '../core/messages/index.js';
 import { ensureDir } from '../shared/helpers/index.js';
 import { lerEstado, salvarEstado } from '../shared/persistence/index.js';
-const { log, GuardianMensagens } = getMessages();
 const DESTINO_PADRAO = path.join(config.STATE_DIR, 'integridade.json');
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+function getLog() {
+    const { log, GuardianMensagens } = getMessages();
+    return { log, GuardianMensagens };
+}
 /**
  * Salva as assinaturas GPG dos arquivos fornecidos em um arquivo de integridade.
  */
@@ -21,6 +25,7 @@ export async function salvarRegistros(fileEntries, destino = DESTINO_PADRAO) {
     }
     await ensureDir(destino);
     await salvarEstado(destino, registros);
+    const { log, GuardianMensagens } = getLog();
     log.sucesso(GuardianMensagens.registroIntegridadeSalvo(destino));
 }
 /**
@@ -31,6 +36,7 @@ export async function carregarRegistros(caminho = DESTINO_PADRAO) {
         return await lerEstado(caminho);
     }
     catch {
+        const { log, GuardianMensagens } = getLog();
         log.aviso(GuardianMensagens.nenhumRegistroEncontrado(caminho));
         return [];
     }

package/dist/guardian/result.js

@@ -2,6 +2,7 @@
 /**
  * Tipos para resultados do Guardian
  */
+import { IntegridadeStatus } from './index.js';
 /**
  * Type guard para verificar se é resultado válido do Guardian
  */
@@ -19,7 +20,6 @@ export function isGuardianResult(value) {
     const status = obj.status;
     return (status === 'ok' || status === 'alteracoes-detectadas' || status === 'erro');
 }
-import { IntegridadeStatus } from './integrity.js';
 /**
  * Converte ResultadoGuardian (tipo legado) para GuardianResult
  */