@mocoto/mahoraga 0.14.1 → 0.14.3

package/dist/shared/helpers/masking.js

@@ -23,7 +23,7 @@ export function maskKeepingNewlines(src, start, end) {
 export function maskJsComments(src) {
     let out = src;
     for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
@@ -31,11 +31,11 @@ export function maskJsComments(src) {
     }
     // Usa negative lookbehind para evitar match em URLs (://)
     for (const metrica of out.matchAll(/(?<![\\:])\/\/.*$/gm)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
-        out = maskKeepingNewlines(out, start, start + (metrica[0].length ?? 0));
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
     }
     return out;
 }
@@ -47,7 +47,7 @@ export function maskJsComments(src) {
 export function maskHtmlComments(src) {
     let out = src;
     for (const metrica of out.matchAll(/<!--([\s\S]*?)-->/g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
@@ -66,7 +66,7 @@ export function maskTagBlocks(src, tag) {
     let out = src;
     const re = new RegExp(`<${tag}\\b[^>]*>[\\s\\S]*?<\\/${tag}>`, 'gi');
     for (const metrica of out.matchAll(re)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
@@ -83,14 +83,14 @@ export function maskTagBlocks(src, tag) {
 export function maskXmlNonCode(src) {
     let out = src;
     for (const metrica of out.matchAll(/<!--[\s\S]*?-->/g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
         out = maskKeepingNewlines(out, start, start + metrica[0].length);
     }
     for (const metrica of out.matchAll(/<!\[CDATA\[[\s\S]*?\]\]>/g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
@@ -107,14 +107,14 @@ export function maskXmlNonCode(src) {
 export function maskPythonStringsAndComments(src) {
     let out = maskPythonComments(src);
     for (const metrica of out.matchAll(/([ruRUfFbB]{0,3})("""|''')[\s\S]*?\2/g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
         out = maskKeepingNewlines(out, start, start + metrica[0].length);
     }
     for (const metrica of out.matchAll(/([ruRUfFbB]{0,3})("([^"\\\n]|\\.)*"|'([^'\\\n]|\\.)*')/g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
@@ -130,11 +130,11 @@ export function maskPythonStringsAndComments(src) {
 export function maskPythonComments(src) {
     let out = src;
     for (const metrica of out.matchAll(/(^|[^\\])#.*$/gm)) {
-        const start = (metrica.index ?? -1) + (metrica[1] ? metrica[1].length : 0);
+        const start = metrica.index + (metrica[1] ? metrica[1].length : 0);
         if (start < 0) {
             continue;
         }
-        out = maskKeepingNewlines(out, start, start + (metrica[0].length ?? 0) - (metrica[1] ? metrica[1].length : 0));
+        out = maskKeepingNewlines(out, start, start + (metrica[0].length) - (metrica[1] ? metrica[1].length : 0));
     }
     return out;
 }
@@ -146,14 +146,14 @@ export function maskPythonComments(src) {
 export function maskGoComments(src) {
     let out = src;
     for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
         out = maskKeepingNewlines(out, start, start + metrica[0].length);
     }
     for (const metrica of out.matchAll(/\/\/.*$/gm)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
@@ -178,14 +178,14 @@ export function maskRustComments(src) {
 export function maskJavaComments(src) {
     let out = src;
     for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
         out = maskKeepingNewlines(out, start, start + metrica[0].length);
     }
     for (const metrica of out.matchAll(/\/\/.*$/gm)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
@@ -202,14 +202,14 @@ export function maskJavaComments(src) {
 export function maskPhpComments(src) {
     let out = src;
     for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }
         out = maskKeepingNewlines(out, start, start + metrica[0].length);
     }
     for (const metrica of out.matchAll(/(\/\/|#).*$/gm)) {
-        const start = metrica.index ?? -1;
+        const start = metrica.index;
         if (start < 0) {
             continue;
         }

package/dist/shared/helpers/reader-report.js

@@ -12,12 +12,6 @@ export async function lerRelatorioVersionado(options) {
     try {
         // Ler arquivo
         const conteudo = await lerEstado(caminho);
-        if (!conteudo) {
-            return {
-                sucesso: false,
-                erro: 'Arquivo não encontrado ou vazio',
-            };
-        }
         let relatorioFinal = conteudo;
         let migrado = false;
         // Validar schema se solicitado
@@ -97,12 +91,6 @@ export async function lerDadosRelatorio(caminho) {
 export async function verificarSchemaRelatorio(caminho) {
     try {
         const conteudo = await lerEstado(caminho);
-        if (!conteudo) {
-            return {
-                valido: false,
-                erros: ['Arquivo não encontrado ou vazio'],
-            };
-        }
         const validacao = validarSchema(conteudo);
         return {
             valido: validacao.valido,

package/dist/shared/helpers/structural-hash.js

@@ -34,7 +34,7 @@ function extrairEstrutura(ast) {
         return elementos;
     }
     const node = isNodePath(ast) ? ast.node : ast;
-    if (!node || typeof node !== 'object') {
+    if (typeof node !== 'object') {
         return elementos;
     }
     const nodeRecord = toRecord(node);
@@ -47,7 +47,8 @@ function extrairEstrutura(ast) {
     }
     const body = Array.isArray(program.body) ? program.body : [];
     for (const stmt of body) {
-        const tipo = String(stmt.type ?? '');
+        const rawTipo = stmt.type;
+        const tipo = typeof rawTipo === 'string' ? rawTipo : '';
         const stmtRecord = toRecord(stmt);
         if (!stmtRecord) {
             continue;

package/dist/shared/helpers/structure.js

@@ -268,7 +268,7 @@ export function normalizarRel(relPath) {
 export async function carregarConfigEstrategia(baseDir, overrides) {
     const caminho = path.join(baseDir, '.mahoraga', 'estrutura.json');
     const lido = await lerEstado(caminho);
-    const cfgObj = lido && !Array.isArray(lido) && typeof lido === 'object' ? lido : {};
+    const cfgObj = !Array.isArray(lido) && typeof lido === 'object' ? lido : {};
     const nomePreset = overrides?.preset ?? cfgObj['preset'];
     const preset = nomePreset && PRESETS[nomePreset].nome ? PRESETS[nomePreset] : undefined;
     const base = {

package/dist/shared/marketplace/registry.js

@@ -26,7 +26,7 @@ export async function salvarPacotesInstalados(pacotes) {
 }
 export async function pacoteEstaInstalado(nome) {
     const pacotes = await listarPacotesInstalados();
-    return pacotes.find(p => p.nome === nome) ?? null;
+    return pacotes?.find(p => p.nome === nome) ?? null;
 }
 export async function instalarPacote(analista, versao, _conteudo) {
     const pacotes = await listarPacotesInstalados();

package/dist/shared/marketplace/remote.js

@@ -15,7 +15,7 @@ const CONFIG_PATH = '.mahoraga/marketplace/registries.json';
 async function carregarRegistries() {
     try {
         const configs = await lerEstado(CONFIG_PATH);
-        if (!configs || configs.length === 0) {
+        if (configs.length === 0) {
             return DEFAULT_REGISTRIES;
         }
         return configs;
@@ -55,7 +55,7 @@ export async function obterAnalistaDoRegistry(nome, registry) {
         }
         try {
             const analistas = await fetchRegistry(reg);
-            const encontrado = analistas.find(a => a.nome === nome);
+            const encontrado = analistas?.find(a => a.nome === nome);
             if (encontrado) {
                 return encontrado;
             }
@@ -74,7 +74,7 @@ async function fetchRegistry(reg) {
                 throw new Error(MarketplaceRemoteMensagens.httpStatus(res.status));
             }
             const data = await res.json();
-            return data.analistas || [];
+            return data.analistas;
         }
         case 'github': {
             const apiUrl = `https://api.github.com/repos/${reg.url}/contents/index.json`;
@@ -85,7 +85,7 @@ async function fetchRegistry(reg) {
                 throw new Error(MarketplaceRemoteMensagens.githubApiHttpStatus(res.status));
             }
             const data = await res.json();
-            return data.analistas || [];
+            return data.analistas;
         }
         case "npm": {
             throw new Error('Not implemented yet: "npm" case');

package/dist/shared/persistence/persistence.js

@@ -6,7 +6,6 @@ import * as fsCb from 'node:fs';
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { messages } from '../../core/messages/index.js';
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 const getLog = () => messages.log;
 const RAIZ = process.cwd();
 const IS_TEST = (process.env.VITEST ?? '') !== '';
@@ -110,11 +109,18 @@ async function salvarEstadoImpl(caminho, dados) {
 /**
  * Encapsula função com spy do Vitest quando em ambiente de teste,
  * permitindo assertions sem modificar a implementação original.
- * @template T - Tipo da função
- * @param fn - Função original
- * @returns Função com spy ou a original
+ *
+ * @template T - Tipo da função que será envolvida. Deve ser uma função com qualquer número de argumentos
+ * @param fn - Função original a ser envolvida com spy
+ * @returns Função com spy do Vitest (se em ambiente de teste) ou a função original sem modificações
+ * @throws Não lança erros; erros internos são logados como debug
+ *
+ * @example
+ * const originalFn = (x: number) => x * 2;
+ * const spyedFn = wrapVitestSpy(originalFn);
+ * // Se em teste: spyedFn pode ser usado para assertions (vi.fn())
+ * // Se em produção: spyedFn é idêntico a originalFn
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function wrapVitestSpy(fn) {
     try {
         const maybeVi = globalThis.vi;
@@ -123,7 +129,8 @@ function wrapVitestSpy(fn) {
         }
     }
     catch (err) {
-        getLog().debug(`Erro ao configurar spy (Vitest): ${err instanceof Error ? err.message : String(err)}`);
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        getLog().debug(`Erro ao configurar spy (Vitest): ${errorMessage}`);
     }
     return fn;
 }

package/dist/shared/plugins/core-plugin.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: MIT
 import { getMessages } from '../../core/messages/index.js';
 import { parseComBabel, parseComCss, parseComHtmlFunc, parseComPhp, parseComPython, parseComTypeScript, parseComXml, } from '../../core/parsing/langs/index.js';
 const { logCore } = getMessages();
@@ -58,7 +59,10 @@ export class CorePlugin {
     }
     inferExtension(codigo, opts) {
         if (opts?.pluginConfig?.extension) {
-            return String(opts.pluginConfig.extension);
+            const ext = opts.pluginConfig.extension;
+            if (typeof ext === 'string') {
+                return ext;
+            }
         }
         if (/^<\?php/.test(codigo.trim())) {
             return '.php';

package/dist/shared/plugins/registry.js

@@ -91,7 +91,8 @@ export class PluginRegistry {
             // Usa import dinâmico mockável (globalThis.import pode ser substituído nos testes)
             const dynImport = globalThis.import ?? ((caminho) => import(caminho));
             const pluginModule = await dynImport(pluginCaminho);
-            const plugin = pluginModule.default || pluginModule;
+            const pluginModuleDefault = pluginModule.default;
+            const plugin = (pluginModuleDefault ?? pluginModule);
             // Valida e registra
             this.validatePlugin(plugin);
             this.registerPlugin(plugin);
@@ -134,7 +135,7 @@ export class PluginRegistry {
         // Verifica suporte da linguagem
         const langChave = extension.substring(1); // remove o ponto
         const langSuporte = this.languageSupport[langChave];
-        if (langSuporte && !langSuporte.enabled) {
+        if (!langSuporte.enabled) {
             const msgLinguagem = messages.PluginRegistryMensagens.linguagemDesabilitada;
             log.debug(msgLinguagem.replace('{linguagem}', langChave));
             return null;

package/dist/types/analysts/tailwind-correction.js

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

package/dist/types/caretakers/imports-barrel.js

@@ -0,0 +1 @@
+export {};

package/dist/types/caretakers/index.js

@@ -0,0 +1,4 @@
+export * from './imports-barrel.js';
+export * from './map-reversion.js';
+export * from './pruning.js';
+export * from './scoring.js';

package/dist/types/caretakers/map-reversion.js

@@ -0,0 +1 @@
+export {};

package/dist/types/caretakers/pruning.js

@@ -0,0 +1 @@
+export {};

package/dist/types/caretakers/scoring.js

@@ -0,0 +1 @@
+export {};

package/dist/types/common/analysts.js

@@ -4,7 +4,7 @@ import { messages } from '../../core/messages/index.js';
  * Fábrica para criar analista com validação mínima
  */
 export function criarAnalista(def) {
-    if (!def || typeof def !== 'object') {
+    if (typeof def !== 'object') {
         throw new Error(messages.ExcecoesMensagens.definicaoAnalistaInvalida);
     }
     if (!def.nome || /\s/.test(def.nome)) {

package/dist/types/core/config/filters.js

@@ -0,0 +1 @@
+export {};

package/dist/types/core/config/index.js

@@ -0,0 +1,2 @@
+export * from './config.js';
+export * from './filters.js';

package/dist/types/core/execution/ambiente.js

@@ -0,0 +1 @@
+export {};

package/dist/types/core/execution/linguagens.js

@@ -0,0 +1 @@
+export {};

package/dist/types/core/execution/parse-errors.js

@@ -0,0 +1 @@
+export {};

package/dist/types/core/execution/results.js

@@ -0,0 +1 @@
+export {};

package/dist/types/core/execution/structure-json.js

@@ -0,0 +1 @@
+export {};

package/dist/types/core/index.js

@@ -0,0 +1 @@
+export * from './runtime.js';

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

@@ -0,0 +1 @@
+export * from './log.js';

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

@@ -0,0 +1 @@
+export {};

package/dist/types/core/parsing/babel-narrow.js

@@ -0,0 +1 @@
+export {};

package/dist/types/core/parsing/index.js

@@ -0,0 +1 @@
+export * from './babel-narrow.js';

package/dist/types/core/runtime.js

@@ -0,0 +1 @@
+export {};

package/dist/types/guardian/index.js

@@ -0,0 +1,2 @@
+export * from './integrity.js';
+export * from './snapshot.js';

package/dist/types/guardian/integrity.js

@@ -0,0 +1,7 @@
+export var IntegridadeStatus;
+(function (IntegridadeStatus) {
+    IntegridadeStatus["Criado"] = "baseline-criado";
+    IntegridadeStatus["Aceito"] = "baseline-aceito";
+    IntegridadeStatus["Ok"] = "ok";
+    IntegridadeStatus["AlteracoesDetectadas"] = "alteracoes-detectadas";
+})(IntegridadeStatus || (IntegridadeStatus = {}));

package/dist/types/guardian/snapshot.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.js

@@ -1,9 +1,9 @@
-export { IntegridadeStatus } from '../guardian/integrity.js';
-export { converterResultadoGuardian } from '../guardian/result.js';
-export { extrairMensagemErro } from '../shared/validation.js';
 export * from './analysts/index.js';
 export * from './common/index.js';
+export { IntegridadeStatus } from './guardian/integrity.js';
 export * from './processing/index.js';
 export * from './project/index.js';
 export * from './structure/index.js';
-export { GuardianError } from '../guardian/integrity.js';
+export { converterResultadoGuardian } from '../guardian/index.js';
+export { extrairMensagemErro } from '../shared/index.js';
+export { GuardianError } from '../guardian/index.js';

package/dist/types/licenses/index.js

@@ -0,0 +1,2 @@
+export * from './header-options.js';
+export * from './licenses.js';

package/dist/types/processing/display.js

@@ -26,10 +26,13 @@ export function exibirBlocoFiltros(includeGroupsExpanded, includeListFlat, exclu
         linhas.push('(node_modules incluído: ignorado dos padrões de exclusão)');
     }
     const titulo = 'Filtros ativos:';
-    const l = getLog();
-    const largura = l.calcularLargura ? l.calcularLargura(titulo, linhas, config.COMPACT_MODE ? 84 : 96) : undefined;
-    const logBloco = (l).imprimirBloco;
-    const logInfo = l;
+    const log = getLog();
+    const logComLargura = log;
+    const largura = logComLargura.calcularLargura
+        ? logComLargura.calcularLargura(titulo, linhas, config.COMPACT_MODE ? 84 : 96)
+        : undefined;
+    const logBloco = (log).imprimirBloco;
+    const logInfo = log;
     if (typeof logInfo.info === 'function') {
         if (linhas.length) {
             logInfo.info(`${titulo} ${linhas.join(' ')}`);
@@ -40,7 +43,7 @@ export function exibirBlocoFiltros(includeGroupsExpanded, includeListFlat, exclu
     }
     // Imprime bloco moldurado se disponível
     if (typeof logBloco === 'function') {
-        logBloco(titulo, linhas, chalk.cyan.bold, typeof largura === 'number' ? largura : config.COMPACT_MODE ? 84 : 96);
+        logBloco(titulo, linhas, chalk.cyan.bold ?? ((text) => text), typeof largura === 'number' ? largura : config.COMPACT_MODE ? 84 : 96);
     }
 }
 // Função para listar analistas registrados
@@ -53,12 +56,12 @@ export async function listarAnalistas() {
     }
     catch (err) {
         listaAnalistas = [];
-        const l2 = getLog();
-        if (config.DEV_MODE && typeof l2.debug === 'function') {
-            l2.debug(`Falha ao listar analistas: ${String(err)}`);
+        const log2 = getLog();
+        if (config.DEV_MODE && typeof log2.debug === 'function') {
+            log2.debug(`Falha ao listar analistas: ${String(err)}`);
         }
-        if (process.env.VITEST && typeof l2.debug === 'function') {
-            l2.debug('Falha ao listar analistas');
+        if (process.env.VITEST && typeof log2.debug === 'function') {
+            log2.debug('Falha ao listar analistas');
         }
     }
     // Prepara linhas do bloco
@@ -78,9 +81,9 @@ export async function listarAnalistas() {
     const titulo = 'Técnicas ativas (registro de analistas)';
     // Largura definida dinamicamente com fallback para modo compacto/padrão
     let largura;
-    const l3 = getLog();
-    if (typeof (l3).calcularLargura === 'function') {
-        largura = l3.calcularLargura(titulo, linhas, config.COMPACT_MODE ? 84 : 96);
+    const log3 = getLog();
+    if (typeof (log3).calcularLargura === 'function') {
+        largura = log3.calcularLargura(titulo, linhas, config.COMPACT_MODE ? 84 : 96);
         // Se calcularLargura retornar undefined, usar fallback 96
         if (typeof largura !== 'number' || isNaN(largura)) {
             largura = config.COMPACT_MODE ? 84 : 96;

package/dist/types/processing/filters.js

@@ -37,13 +37,9 @@ export function expandIncludes(list) {
 export function getDefaultExcludes() {
     // Primeiro tenta obter do mahoraga.config.json do usuário
     const configIncluirExcluir = config.INCLUDE_EXCLUDE_RULES;
-    if (configIncluirExcluir) {
-        // Prioriza `globalExcludeGlob` (configuração moderna). Se não existir,
-        // usa `defaultExcludes` para compatibilidade com formas antigas.
-        if (Array.isArray(configIncluirExcluir.globalExcludeGlob) && configIncluirExcluir.globalExcludeGlob.length > 0) {
-            return Array.from(new Set(configIncluirExcluir.globalExcludeGlob));
-        }
-        // Se não houver globalExcludeGlob, cairá no fallback abaixo que mescla padrões do sistema
+    const globalExclude = configIncluirExcluir.globalExcludeGlob;
+    if (Array.isArray(globalExclude) && globalExclude.length > 0) {
+        return Array.from(new Set(configIncluirExcluir.globalExcludeGlob));
     }
     // Se não há configuração do usuário, usa os padrões recomendados do sistema
     // Por enquanto usa 'generico', mas poderia detectar o tipo de projeto
@@ -78,13 +74,14 @@ function detectarTipoProjeto() {
 // Função principal para configurar filtros CLI
 export function configurarFiltros(includeGroupsRaw, includeListFlat, excludeList, incluiNodeModules) {
     // Configurar includes
+    const cfg = config;
     if (includeListFlat.length) {
-        config.CLI_INCLUDE_GROUPS = includeGroupsRaw;
-        config.CLI_INCLUDE_PATTERNS = includeListFlat;
+        cfg.CLI_INCLUDE_GROUPS = includeGroupsRaw;
+        cfg.CLI_INCLUDE_PATTERNS = includeListFlat;
     }
     else {
-        config.CLI_INCLUDE_GROUPS = [];
-        config.CLI_INCLUDE_PATTERNS = [];
+        cfg.CLI_INCLUDE_GROUPS = [];
+        cfg.CLI_INCLUDE_PATTERNS = [];
     }
     // Configurar excludes com precedência clara:
     // 1. CLI --exclude (prioridade máxima)

package/dist/types/reports/compliance.js

@@ -0,0 +1 @@
+export {};

package/dist/types/reports/streaming.js

@@ -0,0 +1 @@
+export {};

package/dist/types/scripts/index.js

@@ -0,0 +1 @@
+export * from './migrar-aliases.js';

package/dist/types/scripts/migrar-aliases.js

@@ -0,0 +1 @@
+export {};

package/dist/types/sdk/index.js

@@ -0,0 +1 @@
+export * from './analyzer.js';

package/dist/types/shared/index.js

@@ -0,0 +1,2 @@
+export * from './memory.js';
+export * from './persistence.js';

package/dist/types/vulnerabilities/index.js

@@ -0,0 +1,2 @@
+export * from './npm-audit.js';
+export * from './vulnerabilities.js';

package/dist/vulnerabilities/scanner.js

@@ -5,7 +5,8 @@ function execFileAsync(cmd, args, opts) {
     return new Promise((resolve, reject) => {
         execFile(cmd, args, opts, (err, stdout) => {
             if (err) {
-                reject(Object.assign(err, { stdout }));
+                const npmErr = Object.assign(err, { stdout });
+                reject(npmErr);
             }
             else {
                 resolve({ stdout });
@@ -54,7 +55,7 @@ function normalizeAuditResult(raw) {
             name: vuln.name,
             severity: vuln.severity,
             isDirect: vuln.isDirect,
-            via: vuln.via.map(v => (typeof v === 'string' ? v : ((v.title ?? v.url) ?? v.name) ?? '')),
+            via: vuln.via.map(v => (typeof v === 'string' ? v : (v.title || v.url || v.name || ''))),
             effects: vuln.effects,
             range: vuln.range,
             fixAvailable: vuln.fixAvailable === false ? null : {