@mocoto/mahoraga 0.14.1 → 0.14.2

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/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

@@ -83,7 +83,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,7 +94,7 @@ export async function decifrarSintaxe(codigo, ext, opts = {}) {
                 return await race;
             }
             finally {
-                if (timer) {
+                if (timer !== undefined) {
                     clearTimeout(timer);
                 }
                 setCurrentParsingFile(undefined);

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,11 @@ 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');
+function getLog() {
+    const { log, GuardianMensagens } = getMessages();
+    return { log, GuardianMensagens };
+}
 /**
  * Salva as assinaturas GPG dos arquivos fornecidos em um arquivo de integridade.
  */
@@ -21,6 +24,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 +35,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
  */

package/dist/guardian/sentinel.js

@@ -7,7 +7,10 @@ import { config } from '../core/config/index.js';
 import { getMessages } from '../core/messages/index.js';
 import { ensureDir, normalizePath } from '../shared/helpers/index.js';
 import { GuardianError, IntegridadeStatus } from '../types/index.js';
-const { log, GuardianMensagens } = getMessages();
+function getLog() {
+    const { log, GuardianMensagens } = getMessages();
+    return { log, GuardianMensagens };
+}
 function getErrMsg(err) {
     return typeof err === 'object' && err && 'message' in err ? err.message : String(err);
 }
@@ -21,6 +24,7 @@ async function construirSnapshot(fileEntries) {
             snapshot[relPath] = await gerarSnapshotDoConteudo(content);
         }
         catch (err) {
+            const { log, GuardianMensagens } = getLog();
             log.aviso(GuardianMensagens.falhaGerarAssinaturaGpg(relPath, getErrMsg(err)));
         }
     }
@@ -28,6 +32,7 @@ async function construirSnapshot(fileEntries) {
 }
 export async function scanSystemIntegrity(fileEntries, options) {
     const agora = new Date().toISOString();
+    const { log, GuardianMensagens } = getLog();
     await ensureDir(LINHA_BASE_CAMINHO);
     let baselineAnterior = null;
     try {

package/dist/guardian/watcher-hidden.js

@@ -1,8 +1,12 @@
 // SPDX-License-Identifier: MIT
 import { carregarRegistros, inicializarChaves, REGISTRO_VIGIA_CAMINHO_PADRAO, salvarRegistros, verificarAssinatura } from './index.js';
 import { getMessages } from '../core/messages/index.js';
-const { log, VigiaOcultaMensagens } = getMessages();
+function getLog() {
+    const { log, VigiaOcultaMensagens } = getMessages();
+    return { log, VigiaOcultaMensagens };
+}
 export async function vigiaOculta(arquivos, caminhoRegistro = REGISTRO_VIGIA_CAMINHO_PADRAO, autoReset = true) {
+    const { log, VigiaOcultaMensagens } = getLog();
     const registros = await carregarRegistros(caminhoRegistro);
     const mapaAnterior = new Map(registros.map(raiz => [raiz.arquivo, raiz.assinatura]));
     const corrompidos = [];

package/dist/licenses/fs-utils.js

@@ -22,7 +22,10 @@ export function exists(caminho) {
 export function readPackageJsonSync(pkgCaminho) {
     try {
         const data = fs.readFileSync(pkgCaminho, 'utf8');
-        return JSON.parse(data);
+        const parsed = JSON.parse(data);
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        return parsed;
     }
     catch {
         return null;

package/dist/licenses/generate-notices.js

@@ -127,7 +127,7 @@ export async function generateNotices({ root = process.cwd(), ptBr = false, outp
         await fs.writeFile(path.join(dir, 'licenses.json'), JSON.stringify(results, null, 2), 'utf-8');
     }
     catch { }
-    const entries = Object.entries(results ?? {}).filter(([id]) => !id.startsWith(`${pkg.name}@`)).sort((arquivo, base) => arquivo[0].localeCompare(base[0]));
+    const entries = Object.entries(results).filter(([id]) => !id.startsWith(`${pkg.name}@`)).sort((arquivo, base) => arquivo[0].localeCompare(base[0]));
     const parts = [header({
             projectNome,
             license: projectLicenca,

package/dist/licenses/header-options.js

@@ -1,2 +1 @@
-// SPDX-License-Identifier: MIT
 export {};

package/dist/licenses/index.js

@@ -10,3 +10,4 @@ export * from './normalizer.js';
 export { checkLicenseStatus, DEFAULT_LICENSE_POLICY } from './policy.js';
 export * from './scanner.js';
 export * from './types.js';
+export * from './header-options.js';

package/dist/licenses/normalizer.js

@@ -15,19 +15,19 @@ async function tryLoadSpdx() {
     }
     spdxLoaded = true;
     try {
-        spdxParse = (await import('spdx-expression-parse')).default ?? (await import('spdx-expression-parse'));
+        spdxParse = ((await import('spdx-expression-parse')).default ?? (await import('spdx-expression-parse')));
     }
     catch (err) {
         log.debug(`${LicensasMensagens.erroCarregarSpdxExpressionParse} - ${err instanceof Error ? err.message : String(err)}`);
     }
     try {
-        spdxCorrect = (await import('spdx-correct')).default ?? (await import('spdx-correct'));
+        spdxCorrect = ((await import('spdx-correct')).default ?? (await import('spdx-correct')));
     }
     catch (err) {
         log.debug(`${LicensasMensagens.erroCarregarSpdxCorrect} - ${err instanceof Error ? err.message : String(err)}`);
     }
     try {
-        spdxLicencaList = (await import('spdx-license-list')).default ?? (await import('spdx-license-list'));
+        spdxLicencaList = ((await import('spdx-license-list')).default ?? (await import('spdx-license-list')));
     }
     catch (err) {
         log.debug(`${LicensasMensagens.erroCarregarSpdxLicenseList} - ${err instanceof Error ? err.message : String(err)}`);
@@ -46,7 +46,7 @@ function fallbackNormalize(raw) {
     if (isRecord(raw)) {
         return raw.type !== null ? fallbackNormalize(raw.type) : 'UNKNOWN';
     }
-    let string = String(raw).trim();
+    let string = `${raw}`.trim();
     string = string.replace(/\s+/g, ' ');
     const map = {
         mit: 'MIT',
@@ -113,7 +113,7 @@ export async function normalizeLicense(raw) {
                 return raw.map(raiz => awaitOrFallback(raiz)).join(' OR ');
             }
             if (isRecord(raw)) {
-                raw = raw.type ?? raw;
+                return awaitOrFallback(raw.type ?? raw);
             }
             return awaitOrFallback(raw);
         }
@@ -154,11 +154,12 @@ export async function normalizeLicense(raw) {
         if (!isRecord(ast)) {
             return JSON.stringify(ast);
         }
-        if (ast.license) {
-            return String(ast.license);
+        const astRecord = ast;
+        if (astRecord.license) {
+            return astRecord.license;
         }
-        if (ast.left !== null && ast.right !== null && ast.conjunction) {
-            return `${astToExpression(ast.left)} ${String(ast.conjunction).toUpperCase()} ${astToExpression(ast.right)}`;
+        if (astRecord.left !== null && astRecord.right !== null && astRecord.conjunction) {
+            return `${astToExpression(astRecord.left)} ${astRecord.conjunction.toUpperCase()} ${astToExpression(astRecord.right)}`;
         }
         return JSON.stringify(ast);
     }