tutanus 0.12.0

package/dist/core/schema/version.js

@@ -0,0 +1,87 @@
+import { messages } from '../messages/index.js';
+export const VERSAO_ATUAL = '1.0.0';
+export const HISTORICO_VERSOES = {
+    '1.0.0': {
+        versao: '1.0.0',
+        criadoEm: '2025-08-28',
+        descricao: 'Versão inicial com campos básicos de relatório',
+        compatibilidade: ['1.0.0'],
+        camposObrigatorios: ['_schema', 'dados', '_schema.versao', '_schema.criadoEm', '_schema.descricao'],
+        camposOpcionais: ['_schema.compatibilidade', '_schema.camposObrigatorios', '_schema.camposOpcionais']
+    }
+};
+export function criarSchemaMetadata(versao = VERSAO_ATUAL, descricaoPersonalizada) {
+    const base = HISTORICO_VERSOES[versao];
+    if (!base) {
+        throw new Error(messages.ExcecoesMensagens.versaoSchemaDesconhecida(versao));
+    }
+    return {
+        ...base,
+        ...(descricaoPersonalizada && {
+            descricao: descricaoPersonalizada
+        })
+    };
+}
+export function validarSchema(relatorio) {
+    const erros = [];
+    if (!relatorio || typeof relatorio !== 'object') {
+        erros.push('Relatório deve ser um objeto');
+        return {
+            valido: false,
+            erros
+        };
+    }
+    if (!('_schema' in relatorio) || !relatorio._schema) {
+        erros.push('Campo _schema é obrigatório');
+        return {
+            valido: false,
+            erros
+        };
+    }
+    const schema = relatorio._schema;
+    const camposObrigatorios = ['versao', 'criadoEm', 'descricao'];
+    for (const campo of camposObrigatorios) {
+        if (!(campo in schema)) {
+            erros.push(`Campo _schema.${campo} é obrigatório`);
+        }
+    }
+    if (schema.versao && typeof schema.versao === 'string' && !HISTORICO_VERSOES[schema.versao]) {
+        erros.push(`Versão de schema desconhecida: ${schema.versao}`);
+    }
+    if (!('dados' in relatorio)) {
+        erros.push('Campo dados é obrigatório');
+    }
+    return {
+        valido: erros.length === 0,
+        erros
+    };
+}
+export function migrarParaVersaoAtual(relatorio) {
+    const validacao = validarSchema(relatorio);
+    if (validacao.valido && relatorio._schema) {
+        return relatorio;
+    }
+    if (!('_schema' in relatorio) || !relatorio._schema) {
+        return criarRelatorioComVersao(relatorio);
+    }
+    if (!validacao.valido) {
+        throw new Error(messages.ExcecoesMensagens.relatorioSchemaInvalido(validacao.erros.join(', ')));
+    }
+    return relatorio;
+}
+export function criarRelatorioComVersao(dados, versao = VERSAO_ATUAL, descricao) {
+    return {
+        _schema: criarSchemaMetadata(versao, descricao),
+        dados
+    };
+}
+export function extrairDados(relatorio) {
+    return relatorio.dados;
+}
+export function versaoCompativel(versao) {
+    const metadata = HISTORICO_VERSOES[versao];
+    if (!metadata)
+        return false;
+    return metadata.compatibilidade.includes(VERSAO_ATUAL);
+}
+//# sourceMappingURL=version.js.map

package/dist/core/schema/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/core/schema/version.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * Sistema de Versionamento de Schema para Relatórios JSON\n *\n * Este módulo gerencia versões de schema para relatórios JSON do Tutanus,\n * garantindo compatibilidade futura e evolução controlada dos formatos.\n */\n\nimport { messages } from '@core/messages';\n\nimport type { RelatorioComVersao, SchemaMetadata } from '@';\n\n// Re-exporta os tipos para compatibilidade\nexport type { RelatorioComVersao, SchemaMetadata };\n\n/** Versão atual do schema */\nexport const VERSAO_ATUAL = '1.0.0';\n\n/** Histórico de versões do schema */\nexport const HISTORICO_VERSOES: Record<string, SchemaMetadata> = {\n  '1.0.0': {\n    versao: '1.0.0',\n    criadoEm: '2025-08-28',\n    descricao: 'Versão inicial com campos básicos de relatório',\n    compatibilidade: ['1.0.0'],\n    camposObrigatorios: ['_schema', 'dados', '_schema.versao', '_schema.criadoEm', '_schema.descricao'],\n    camposOpcionais: ['_schema.compatibilidade', '_schema.camposObrigatorios', '_schema.camposOpcionais']\n  }\n};\n\n/**\n * Cria metadados de schema para a versão atual\n */\n\nexport function criarSchemaMetadata(versao: string = VERSAO_ATUAL, descricaoPersonalizada?: string): SchemaMetadata {\n  const base = HISTORICO_VERSOES[versao];\n  if (!base) {\n    throw new Error(messages.ExcecoesMensagens.versaoSchemaDesconhecida(versao));\n  }\n  return {\n    ...base,\n    ...(descricaoPersonalizada && {\n      descricao: descricaoPersonalizada\n    })\n  };\n}\n\n/**\n * Valida se um relatório tem schema válido\n */\n\nexport function validarSchema(relatorio: Record<string, unknown>): {\n  valido: boolean;\n  erros: string[];\n} {\n  const erros: string[] = [];\n\n  // Verificar estrutura básica\n  if (!relatorio || typeof relatorio !== 'object') {\n    erros.push('Relatório deve ser um objeto');\n    return {\n      valido: false,\n      erros\n    };\n  }\n\n  // Verificar presença do schema\n  if (!('_schema' in relatorio) || !relatorio._schema) {\n    erros.push('Campo _schema é obrigatório');\n    return {\n      valido: false,\n      erros\n    };\n  }\n  const schema = relatorio._schema as Record<string, unknown>;\n\n  // Verificar campos obrigatórios do schema\n  const camposObrigatorios = ['versao', 'criadoEm', 'descricao'];\n  for (const campo of camposObrigatorios) {\n    if (!(campo in schema)) {\n      erros.push(`Campo _schema.${campo} é obrigatório`);\n    }\n  }\n\n  // Verificar se a versão existe no histórico\n  if (schema.versao && typeof schema.versao === 'string' && !HISTORICO_VERSOES[schema.versao]) {\n    erros.push(`Versão de schema desconhecida: ${schema.versao}`);\n  }\n\n  // Verificar presença dos dados\n  if (!('dados' in relatorio)) {\n    erros.push('Campo dados é obrigatório');\n  }\n  return {\n    valido: erros.length === 0,\n    erros\n  };\n}\n\n/**\n * Migra um relatório para a versão atual se necessário\n */\nexport function migrarParaVersaoAtual<T>(relatorio: Record<string, unknown>): RelatorioComVersao<T> {\n  // Se já tem schema válido, retornar como está\n  const validacao = validarSchema(relatorio);\n  if (validacao.valido && relatorio._schema) {\n    return relatorio as unknown as RelatorioComVersao<T>;\n  }\n\n  // Se não tem schema, rejeitar: relatórios sem `_schema` são considerados formatos antigos\n  // e devem ser migrados explicitamente pelo consumidor antes de chamar esta função.\n  // Se não tem schema, considerar que é um relatório legado e migrar explicitamente\n  // Chamadas a esta função são a migração explícita, então embrulhamos o relatório\n  // antigo com os metadados de versão atuais.\n  if (!('_schema' in relatorio) || !relatorio._schema) {\n    return criarRelatorioComVersao<T>(relatorio as unknown as T);\n  }\n\n  // Para futuras migrações, implementar lógica aqui\n  // Por enquanto, apenas revalidar\n  if (!validacao.valido) {\n    throw new Error(messages.ExcecoesMensagens.relatorioSchemaInvalido(validacao.erros.join(', ')));\n  }\n  return relatorio as unknown as RelatorioComVersao<T>;\n}\n\n/**\n * Cria um relatório com versão atual\n */\nexport function criarRelatorioComVersao<T>(dados: T, versao: string = VERSAO_ATUAL, descricao?: string): RelatorioComVersao<T> {\n  return {\n    _schema: criarSchemaMetadata(versao, descricao),\n    dados\n  };\n}\n\n/**\n * Extrai apenas os dados de um relatório versionado\n */\nexport function extrairDados<T>(relatorio: RelatorioComVersao<T>): T {\n  return relatorio.dados;\n}\n\n/**\n * Verifica se uma versão é compatível com a atual\n */\n\nexport function versaoCompativel(versao: string): boolean {\n  const metadata = HISTORICO_VERSOES[versao];\n  if (!metadata) return false;\n  return metadata.compatibilidade.includes(VERSAO_ATUAL);\n}"]}

package/dist/core/utils/exec-safe.d.ts

@@ -0,0 +1,4 @@
+import { type ExecSyncOptions } from 'node:child_process';
+export declare function executarShellSeguro(cmd: string, opts?: ExecSyncOptions): Buffer | string;
+export declare function executarShellSeguroAsync(cmd: string, opts?: ExecSyncOptions): Promise<Buffer | string>;
+//# sourceMappingURL=exec-safe.d.ts.map

package/dist/core/utils/exec-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-safe.d.ts","sourceRoot":"","sources":["../../../src/core/utils/exec-safe.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAapE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,eAAoB,GACzB,MAAM,GAAG,MAAM,CAQjB;AAUD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAG1B"}

package/dist/core/utils/exec-safe.js

@@ -0,0 +1,13 @@
+import { execSync } from 'node:child_process';
+import { config } from '../config/index.js';
+import { getMessages } from '../messages/index.js';
+export function executarShellSeguro(cmd, opts = {}) {
+    if (config.SAFE_MODE === true && !config.ALLOW_EXEC) {
+        throw new Error(getMessages().ExecSafeMensagens.safeModeBloqueado);
+    }
+    return execSync(cmd, opts);
+}
+export async function executarShellSeguroAsync(cmd, opts = {}) {
+    return executarShellSeguro(cmd, opts);
+}
+//# sourceMappingURL=exec-safe.js.map

package/dist/core/utils/exec-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-safe.js","sourceRoot":"","sources":["../../../src/core/utils/exec-safe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAwB,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAU7C,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,OAAwB,EAAE;IAG1B,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CACb,WAAW,EAAE,CAAC,iBAAiB,CAAC,iBAAiB,CAClD,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAW,EACX,OAAwB,EAAE;IAG1B,OAAO,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nimport { execSync, type ExecSyncOptions } from 'node:child_process';\n\nimport { config } from '@core/config';\nimport { getMessages } from '@core/messages';\n\n/**\n * Executa um comando shell de forma segura.\n * Bloqueia a execução quando SAFE_MODE está ativo e ALLOW_EXEC não está habilitado.\n * @param cmd - Comando shell a executar\n * @param opts - Opções do execSync do Node.js\n * @returns Buffer ou string com a saída do comando\n * @throws Error se SAFE_MODE estiver ativo sem ALLOW_EXEC\n */\nexport function executarShellSeguro(\n  cmd: string,\n  opts: ExecSyncOptions = {},\n): Buffer | string {\n  // only block if SAFE_MODE is explicitly true and ALLOW_EXEC is falsy\n  if (config.SAFE_MODE === true && !config.ALLOW_EXEC) {\n    throw new Error(\n      getMessages().ExecSafeMensagens.safeModeBloqueado,\n    );\n  }\n  return execSync(cmd, opts);\n}\n\n/**\n * Versão assíncrona do `executarShellSeguro`.\n * Wrapper async que delega ao sync, útil em contextos que já utilizam await.\n * @param cmd - Comando shell a executar\n * @param opts - Opções do execSync do Node.js\n * @returns Promise resolvida com Buffer ou string da saída do comando\n * @throws Error se SAFE_MODE estiver ativo sem ALLOW_EXEC\n */\nexport async function executarShellSeguroAsync(\n  cmd: string,\n  opts: ExecSyncOptions = {},\n): Promise<Buffer | string> {\n  // wrapper assíncrono que delega ao sync (usado onde já há await)\n  return executarShellSeguro(cmd, opts);\n}\n"]}

package/dist/core/utils/import-safe.d.ts

@@ -0,0 +1,2 @@
+export declare function importarModuloSeguro(baseDir: string, pluginRel: string): Promise<unknown>;
+//# sourceMappingURL=import-safe.d.ts.map

package/dist/core/utils/import-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-safe.d.ts","sourceRoot":"","sources":["../../../src/core/utils/import-safe.ts"],"names":[],"mappings":"AAIA,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS/F"}

package/dist/core/utils/import-safe.js

@@ -0,0 +1,14 @@
+import { config, resolverPluginSeguro } from '../config/index.js';
+import { messages } from '../messages/index.js';
+export async function importarModuloSeguro(baseDir, pluginRel) {
+    if (config.SAFE_MODE && !config.ALLOW_PLUGINS) {
+        throw new Error(messages.ExcecoesMensagens.pluginsDesabilitadosSafeMode);
+    }
+    const resolvido = resolverPluginSeguro(baseDir, pluginRel);
+    if (resolvido.erro)
+        throw new Error(messages.ExcecoesMensagens.pluginBloqueado(resolvido.erro));
+    if (!resolvido.caminho)
+        throw new Error(messages.ExcecoesMensagens.caminhoPluginNaoResolvido);
+    return import(resolvido.caminho);
+}
+//# sourceMappingURL=import-safe.js.map

package/dist/core/utils/import-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-safe.js","sourceRoot":"","sources":["../../../src/core/utils/import-safe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAe,EAAE,SAAiB;IAC3E,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC3D,IAAI,SAAS,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAChG,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,CAAC;IAE9F,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nimport { config, resolverPluginSeguro } from '@core/config';\nimport { messages } from '@core/messages';\n\nexport async function importarModuloSeguro(baseDir: string, pluginRel: string): Promise<unknown> {\n  if (config.SAFE_MODE && !config.ALLOW_PLUGINS) {\n    throw new Error(messages.ExcecoesMensagens.pluginsDesabilitadosSafeMode);\n  }\n  const resolvido = resolverPluginSeguro(baseDir, pluginRel);\n  if (resolvido.erro) throw new Error(messages.ExcecoesMensagens.pluginBloqueado(resolvido.erro));\n  if (!resolvido.caminho) throw new Error(messages.ExcecoesMensagens.caminhoPluginNaoResolvido);\n  // permite que o chamador capture exceções do plugin\n  return import(resolvido.caminho);\n}"]}

package/dist/core/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './exec-safe.js';
+export * from './import-safe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAKA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/core/utils/index.js

@@ -0,0 +1,3 @@
+export * from './exec-safe.js';
+export * from './import-safe.js';
+//# sourceMappingURL=index.js.map

package/dist/core/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAKA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Core utilities: exec-safe and import-safe\n */\n\nexport * from './exec-safe.js';\nexport * from './import-safe.js';\n"]}

package/dist/core/workers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './worker-executor.js';
+export * from './worker-pool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/workers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/workers/index.ts"],"names":[],"mappings":"AAKA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/core/workers/index.js

@@ -0,0 +1,3 @@
+export * from './worker-executor.js';
+export * from './worker-pool.js';
+//# sourceMappingURL=index.js.map

package/dist/core/workers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/workers/index.ts"],"names":[],"mappings":"AAKA,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Core worker pool management\n */\n\nexport * from './worker-executor.js';\nexport * from './worker-pool.js';\n"]}

package/dist/core/workers/worker-executor.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker-executor.d.ts.map

package/dist/core/workers/worker-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-executor.d.ts","sourceRoot":"","sources":["../../../src/core/workers/worker-executor.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,178 @@
+import * as path from 'node:path';
+import { parentPort, workerData } from 'node:worker_threads';
+import { decifrarSintaxe } from '../parsing/index.js';
+const port = parentPort;
+const workerAstCache = new Map();
+async function executarTecnicaEmArquivo(tecnica, arquivo, contexto, timeoutMs) {
+    if (typeof tecnica?.aplicar !== 'function')
+        return [];
+    const execPromise = tecnica.aplicar(arquivo.content ?? '', arquivo.relPath, arquivo.ast ?? null, arquivo.fullCaminho ?? '', contexto);
+    if (timeoutMs && timeoutMs > 0) {
+        return Promise.race([execPromise, new Promise((_, reject) => setTimeout(() => reject(new Error(`Timeout: tecnica '${tecnica.nome}' excedeu ${timeoutMs}ms`)), timeoutMs))]).then(result => Array.isArray(result) ? result : [], (err) => {
+            return [{
+                    arquivo: arquivo.relPath,
+                    linha: 1,
+                    coluna: 1,
+                    tipo: 'ERRO_EXECUCAO',
+                    mensagem: `Erro ao executar técnica ${tecnica.nome}: ${err.message}`,
+                    severidade: 'erro',
+                    tecnica: tecnica.nome,
+                    contexto: {
+                        erro: err.message,
+                        stack: err.stack
+                    }
+                }];
+        });
+    }
+    try {
+        const result = await execPromise;
+        return Array.isArray(result) ? result : [];
+    }
+    catch (erro) {
+        const err = erro;
+        return [{
+                arquivo: arquivo.relPath,
+                linha: 1,
+                coluna: 1,
+                tipo: 'ERRO_EXECUCAO',
+                mensagem: `Erro ao executar técnica ${tecnica.nome}: ${err.message}`,
+                severidade: 'erro',
+                tecnica: tecnica.nome,
+                contexto: {
+                    erro: err.message,
+                    stack: err.stack
+                }
+            }];
+    }
+}
+function yieldEventLoop() {
+    return new Promise(resolve => setImmediate(resolve));
+}
+async function processarLote(lote, contexto) {
+    const resultados = [];
+    const wd = workerData;
+    const timeoutMs = Number(wd?.timeoutMs) || 0;
+    const techniques = Array.isArray(wd?.techniques) ? wd.techniques : [];
+    const files = Array.isArray(wd?.files) ? wd.files : [];
+    for (const file of files) {
+        if (!file.ast && file.content) {
+            const ext = path.extname(file.relPath);
+            const cached = workerAstCache.get(file.relPath);
+            if (cached) {
+                file.ast = cached;
+            }
+            else {
+                try {
+                    const parsed = await decifrarSintaxe(file.content, ext, { relPath: file.relPath });
+                    if (parsed) {
+                        file.ast = parsed;
+                        workerAstCache.set(file.relPath, parsed);
+                    }
+                }
+                catch {
+                }
+            }
+        }
+        const fileResultado = {
+            arquivo: file.relPath,
+            ocorrencias: [],
+            tempos: [],
+            erros: []
+        };
+        for (const tecnica of techniques) {
+            if (tecnica.test && !tecnica.test(file.relPath))
+                continue;
+            try {
+                const inicio = Date.now();
+                const out = await executarTecnicaEmArquivo(tecnica, file, contexto, timeoutMs);
+                const dur = Date.now() - inicio;
+                if (out && Array.isArray(out))
+                    fileResultado.ocorrencias.push(...out);
+                fileResultado.tempos.push({
+                    tecnica: tecnica.nome,
+                    duracaoMs: dur
+                });
+            }
+            catch (err) {
+                fileResultado.erros.push(String(err && err.message ? err.message : err));
+            }
+            await yieldEventLoop();
+        }
+        resultados.push({
+            sucesso: true,
+            arquivo: file.relPath,
+            ocorrencias: fileResultado.ocorrencias,
+            tempoProcessamento: Date.now(),
+            erros: fileResultado.erros,
+            tempos: fileResultado.tempos
+        });
+        await yieldEventLoop();
+    }
+    return resultados;
+}
+async function main() {
+    const HEARTBEAT_MS = 5000;
+    let heartbeatInterval = null;
+    try {
+        const wd = workerData;
+        const contexto = wd?.contexto;
+        try {
+            if (port && typeof port.postMessage === 'function') {
+                heartbeatInterval = setInterval(() => {
+                    try {
+                        port.postMessage({
+                            type: 'heartbeat',
+                            ts: Date.now(),
+                            workerId: process.pid
+                        });
+                    }
+                    catch {
+                    }
+                }, HEARTBEAT_MS);
+            }
+        }
+        catch {
+        }
+        const resultados = await processarLote(wd.lote ?? wd.files ?? [], contexto);
+        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({
+                sucesso: true,
+                resultados,
+                workerId: process.pid,
+                occurrences,
+                metrics,
+                processedArquivos,
+                duration: Date.now()
+            });
+    }
+    catch (erro) {
+        try {
+            if (port)
+                port.postMessage({
+                    sucesso: false,
+                    erro: erro instanceof Error ? erro.message : String(erro),
+                    stack: erro instanceof Error ? erro.stack : undefined,
+                    workerId: process.pid
+                });
+        }
+        catch {
+        }
+    }
+    finally {
+        if (heartbeatInterval)
+            clearInterval(heartbeatInterval);
+    }
+}
+main().catch(erro => {
+    if (port)
+        port.postMessage({
+            sucesso: false,
+            erro: erro instanceof Error ? erro.message : String(erro),
+            stack: erro instanceof Error ? erro.stack : undefined,
+            workerId: process.pid
+        });
+});
+//# sourceMappingURL=worker-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-executor.js","sourceRoot":"","sources":["../../../src/core/workers/worker-executor.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * Executor de worker para processamento paralelo de arquivos\n * Este arquivo é executado em threads separadas pelos Worker Threads\n * Formato ESM (compatível com \"type\": \"module\")\n */\n\nimport * as path from 'node:path';\nimport { parentPort, workerData } from 'node:worker_threads';\n\nimport { decifrarSintaxe } from '@core/parsing';\n\nconst port = parentPort;\ninterface WorkerData {\n  lote?: unknown[];\n  files?: {\n    relPath: string;\n    content?: string;\n    ast?: unknown;\n    fullCaminho?: string;\n    ultimaModificacao?: number;\n  }[];\n  techniques?: {\n    nome: string;\n    test?: (path: string) => boolean;\n    aplicar: (content: string, relPath: string, ast: unknown | null, fullPath: string, context: unknown) => Promise<unknown[]>;\n  }[];\n  contexto?: unknown;\n  timeoutMs?: number;\n}\n\n// Cache de AST local por worker (evita re-parsar mesmo arquivo dentro do mesmo lote)\nconst workerAstCache = new Map<string, unknown>();\ninterface Ocorrencia {\n  arquivo: string;\n  linha: number;\n  coluna: number;\n  tipo: string;\n  mensagem: string;\n  severidade: string;\n  tecnica: string;\n  contexto: {\n    erro: string;\n    stack?: string;\n  };\n}\nasync function executarTecnicaEmArquivo(tecnica: {\n  nome: string;\n  aplicar: (content: string, relPath: string, ast: unknown | null, fullPath: string, context: unknown) => Promise<unknown>;\n}, arquivo: {\n  relPath: string;\n  content?: string;\n  ast?: unknown;\n  fullCaminho?: string;\n}, contexto: unknown, timeoutMs: number): Promise<Ocorrencia[]> {\n  if (typeof tecnica?.aplicar !== 'function') return [];\n  const execPromise = tecnica.aplicar(arquivo.content ?? '', arquivo.relPath, arquivo.ast ?? null, arquivo.fullCaminho ?? '', contexto);\n  if (timeoutMs && timeoutMs > 0) {\n    return Promise.race([execPromise, new Promise<Ocorrencia[]>((_, reject) => setTimeout(() => reject(new Error(`Timeout: tecnica '${tecnica.nome}' excedeu ${timeoutMs}ms`)), timeoutMs))]).then(result => Array.isArray(result) ? result : [], (err: Error) => {\n      return [{\n        arquivo: arquivo.relPath,\n        linha: 1,\n        coluna: 1,\n        tipo: 'ERRO_EXECUCAO',\n        mensagem: `Erro ao executar técnica ${tecnica.nome}: ${err.message}`,\n        severidade: 'erro',\n        tecnica: tecnica.nome,\n        contexto: {\n          erro: err.message,\n          stack: err.stack\n        }\n      }];\n    });\n  }\n  try {\n    const result = await execPromise;\n    return Array.isArray(result) ? result : [];\n  } catch (erro) {\n    const err = erro as Error;\n    return [{\n      arquivo: arquivo.relPath,\n      linha: 1,\n      coluna: 1,\n      tipo: 'ERRO_EXECUCAO',\n      mensagem: `Erro ao executar técnica ${tecnica.nome}: ${err.message}`,\n      severidade: 'erro',\n      tecnica: tecnica.nome,\n      contexto: {\n        erro: err.message,\n        stack: err.stack\n      }\n    }];\n  }\n}\nfunction yieldEventLoop(): Promise<void> {\n  return new Promise(resolve => setImmediate(resolve));\n}\nasync function processarLote(lote: unknown[], contexto: unknown) {\n  const resultados: {\n    sucesso: boolean;\n    arquivo: string;\n    ocorrencias: Ocorrencia[];\n    tempoProcessamento: number;\n    erros: string[];\n    tempos: {\n      tecnica: string;\n      duracaoMs: number;\n    }[];\n  }[] = [];\n  const wd = workerData as unknown as WorkerData;\n  const timeoutMs = Number(wd?.timeoutMs) || 0;\n  const techniques = Array.isArray(wd?.techniques) ? wd.techniques : [];\n  const files = Array.isArray(wd?.files) ? wd.files : [];\n  for (const file of files) {\n    // Parallel AST parsing: parseia o AST dentro do worker se não veio pré-parseado\n    if (!file.ast && file.content) {\n      const ext = path.extname(file.relPath);\n      const cached = workerAstCache.get(file.relPath);\n      if (cached) {\n        file.ast = cached;\n      } else {\n        try {\n          const parsed = await decifrarSintaxe(file.content, ext, { relPath: file.relPath });\n          if (parsed) {\n            file.ast = parsed;\n            workerAstCache.set(file.relPath, parsed);\n          }\n        } catch {\n          // Se falhar parsing, segue sem AST (analistas que precisam de AST tratarão null)\n        }\n      }\n    }\n\n    const fileResultado = {\n      arquivo: file.relPath,\n      ocorrencias: [] as Ocorrencia[],\n      tempos: [] as {\n        tecnica: string;\n        duracaoMs: number;\n      }[],\n      erros: [] as string[]\n    };\n    for (const tecnica of techniques) {\n      if (tecnica.test && !tecnica.test(file.relPath)) continue;\n      try {\n        const inicio = Date.now();\n        const out = await executarTecnicaEmArquivo(tecnica, file, contexto, timeoutMs);\n        const dur = Date.now() - inicio;\n        if (out && Array.isArray(out)) fileResultado.ocorrencias.push(...out);\n        fileResultado.tempos.push({\n          tecnica: tecnica.nome,\n          duracaoMs: dur\n        });\n      } catch (err) {\n        fileResultado.erros.push(String(err && (err as Error).message ? (err as Error).message : err));\n      }\n      await yieldEventLoop();\n    }\n    resultados.push({\n      sucesso: true,\n      arquivo: file.relPath,\n      ocorrencias: fileResultado.ocorrencias,\n      tempoProcessamento: Date.now(),\n      erros: fileResultado.erros,\n      tempos: fileResultado.tempos\n    });\n    await yieldEventLoop();\n  }\n  return resultados;\n}\nasync function main() {\n  const HEARTBEAT_MS = 5000;\n  let heartbeatInterval: ReturnType<typeof setInterval> | null = null;\n  try {\n    const wd = workerData as unknown as WorkerData;\n    const contexto = wd?.contexto;\n    try {\n      if (port && typeof port.postMessage === 'function') {\n        heartbeatInterval = setInterval(() => {\n          try {\n            port.postMessage({\n              type: 'heartbeat',\n              ts: Date.now(),\n              workerId: process.pid\n            });\n          } catch {\n            // ignore\n          }\n        }, HEARTBEAT_MS);\n      }\n    } catch {\n      /* ignore */\n    }\n    const resultados = await processarLote(wd.lote ?? wd.files ?? [], contexto);\n    const occurrences = resultados.flatMap(raiz => raiz.ocorrencias || []);\n    const metrics = resultados.flatMap(raiz => raiz.tempos || []);\n    const processedArquivos = Array.isArray(wd.files) ? wd.files.length : resultados.length || 0;\n    if (port) port.postMessage({\n      sucesso: true,\n      resultados,\n      workerId: process.pid,\n      occurrences,\n      metrics,\n      processedArquivos,\n      duration: Date.now()\n    });\n  } catch (erro) {\n    try {\n      if (port) port.postMessage({\n        sucesso: false,\n        erro: erro instanceof Error ? erro.message : String(erro),\n        stack: erro instanceof Error ? erro.stack : undefined,\n        workerId: process.pid\n      });\n    } catch {\n      // ignore\n    }\n  } finally {\n    if (heartbeatInterval) clearInterval(heartbeatInterval);\n  }\n}\nmain().catch(erro => {\n  if (port) port.postMessage({\n    sucesso: false,\n    erro: erro instanceof Error ? erro.message : String(erro),\n    stack: erro instanceof Error ? erro.stack : undefined,\n    workerId: process.pid\n  });\n});"]}

package/dist/core/workers/worker-pool.d.ts

@@ -0,0 +1,37 @@
+import type { ContextoExecucao, FileEntryWithAst, MetricaAnalista, Ocorrencia, ProcessFilesResult, Tecnica, WorkerPoolOptions, WorkerResult, WorkerTask } from '../../types/index.js';
+export type { ProcessFilesResult, WorkerPoolOptions, WorkerResult, WorkerTask };
+export declare class WorkerPool {
+    private maxWorkers;
+    private batchSize;
+    private timeoutMs;
+    private enabled;
+    private activeWorkers;
+    private results;
+    private errors;
+    constructor(options?: WorkerPoolOptions);
+    processFiles(files: FileEntryWithAst[], techniques: Tecnica[], context: ContextoExecucao): Promise<ProcessFilesResult>;
+    private createBatches;
+    private processGlobalTechniques;
+    private processBatches;
+    private processBatch;
+    private processSequentially;
+    private executeTechniqueWithTimeout;
+    private parseWorkerMsg;
+    private runWorker;
+    getStats(): {
+        maxWorkers: number;
+        batchSize: number;
+        enabled: boolean;
+        activeWorkers: number;
+        completedWorkers: number;
+        totalErrors: number;
+        errors: string[];
+    };
+}
+export declare function processarComWorkers(files: FileEntryWithAst[], techniques: Tecnica[], context: ContextoExecucao, options?: WorkerPoolOptions): Promise<{
+    occurrences: Ocorrencia[];
+    metrics: MetricaAnalista[];
+    totalProcessed: number;
+    duration: number;
+}>;
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/core/workers/worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../src/core/workers/worker-pool.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;AAQnK,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AAKhF,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAgB;gBAClB,OAAO,GAAE,iBAAsB;IA4BrC,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAmC5H,OAAO,CAAC,aAAa;YAWP,uBAAuB;YAkDvB,cAAc;YAwBd,YAAY;YAsEZ,mBAAmB;YAsEnB,2BAA2B;IAmBzC,OAAO,CAAC,cAAc;YAWR,SAAS;IA+CvB,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;CAWF;AAMD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC3J,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAGD"}