tutanus 0.12.0

package/dist/shared/plugins/registry.js

@@ -0,0 +1,192 @@
+import { messages } from '../../core/messages/index.js';
+const { log, logCore } = messages;
+export class PluginRegistry {
+    plugins = new Map();
+    extensionMap = new Map();
+    config;
+    userConfiguredEnabled = false;
+    languageSupport;
+    loadingPromises = new Map();
+    constructor(config, languageSupport) {
+        this.config = {
+            enabled: ['core'],
+            autoload: true,
+            registry: '@tutanus/plugins',
+            ...config
+        };
+        this.userConfiguredEnabled = !!config?.enabled;
+        this.languageSupport = languageSupport || {};
+    }
+    registerPlugin(plugin) {
+        logCore.registrandoPlugin(plugin.name, plugin.version);
+        this.validatePlugin(plugin);
+        this.plugins.set(plugin.name, plugin);
+        for (const ext of plugin.extensions) {
+            if (this.extensionMap.has(ext)) {
+                const existing = this.extensionMap.get(ext);
+                const msg = messages.PluginRegistryMensagens.extensaoSobrescrita;
+                log.debug(msg.replace('{ext}', ext).replace('{existente}', existing || '').replace('{novo}', plugin.name));
+            }
+            this.extensionMap.set(ext, plugin.name);
+        }
+        const msgRegistrado = messages.PluginRegistryMensagens.pluginRegistrado;
+        log.debug(msgRegistrado.replace('{nome}', plugin.name).replace('{extensoes}', plugin.extensions.join(', ')));
+    }
+    async loadPlugin(name) {
+        if (this.plugins.has(name)) {
+            const plugin = this.plugins.get(name);
+            if (!plugin) {
+                throw new Error(messages.ExcecoesMensagens.pluginRegistradoNaoPodeSerObtido(name));
+            }
+            return plugin;
+        }
+        if (this.loadingPromises.has(name)) {
+            const promise = this.loadingPromises.get(name);
+            if (!promise) {
+                throw new Error(messages.ExcecoesMensagens.pluginCarregandoPromiseNaoPodeSerObtida(name));
+            }
+            return promise;
+        }
+        const loadingPromise = this.doLoadPlugin(name);
+        this.loadingPromises.set(name, loadingPromise);
+        try {
+            const plugin = await loadingPromise;
+            this.loadingPromises.delete(name);
+            return plugin;
+        }
+        catch (error) {
+            this.loadingPromises.delete(name);
+            throw error;
+        }
+    }
+    async doLoadPlugin(name) {
+        const msgCarregando = messages.PluginRegistryMensagens.carregandoPlugin;
+        log.debug(msgCarregando.replace('{nome}', name));
+        try {
+            const pluginCaminho = `${this.config.registry}/${name}-plugin`;
+            const dynImport = globalThis.import || ((caminho) => import(caminho));
+            const pluginModule = await dynImport(pluginCaminho);
+            const plugin = pluginModule.default || pluginModule;
+            this.validatePlugin(plugin);
+            this.registerPlugin(plugin);
+            return plugin;
+        }
+        catch (error) {
+            logCore.erroCarregarPlugin(name, error.message);
+            throw new Error(messages.ExcecoesMensagens.naoFoiPossivelCarregarPlugin(name, error.message));
+        }
+    }
+    async getPluginForExtension(extension) {
+        const pluginNome = this.extensionMap.get(extension);
+        if (!pluginNome) {
+            if (this.config.autoload) {
+                logCore.tentandoAutoload(extension);
+                const inferredNome = this.inferPluginName(extension);
+                if (inferredNome && this.config.enabled.includes(inferredNome)) {
+                    try {
+                        return await this.loadPlugin(inferredNome);
+                    }
+                    catch {
+                        logCore.autoloadFalhou(inferredNome);
+                    }
+                }
+            }
+            return null;
+        }
+        if (this.userConfiguredEnabled && !this.config.enabled.includes(pluginNome)) {
+            const msgDesabilitado = messages.PluginRegistryMensagens.pluginDesabilitado;
+            log.debug(msgDesabilitado.replace('{nome}', pluginNome).replace('{extensao}', extension));
+            return null;
+        }
+        const langChave = extension.substring(1);
+        const langSuporte = this.languageSupport[langChave];
+        if (langSuporte && !langSuporte.enabled) {
+            const msgLinguagem = messages.PluginRegistryMensagens.linguagemDesabilitada;
+            log.debug(msgLinguagem.replace('{linguagem}', langChave));
+            return null;
+        }
+        return await this.loadPlugin(pluginNome);
+    }
+    inferPluginName(extension) {
+        const extMap = {
+            '.xml': 'core',
+            '.html': 'core',
+            '.htm': 'core',
+            '.css': 'core',
+            '.js': 'core',
+            '.jsx': 'core',
+            '.ts': 'core',
+            '.tsx': 'core',
+            '.mjs': 'core',
+            '.cjs': 'core',
+            '.php': 'core',
+            '.py': 'core'
+        };
+        return extMap[extension] || null;
+    }
+    validatePlugin(plugin) {
+        if (!plugin.name || typeof plugin.name !== 'string') {
+            throw new Error(messages.ExcecoesMensagens.pluginDeveTerNomeValido);
+        }
+        if (!plugin.version || typeof plugin.version !== 'string') {
+            throw new Error(messages.ExcecoesMensagens.pluginDeveTerVersaoValida);
+        }
+        if (!Array.isArray(plugin.extensions) || plugin.extensions.length === 0) {
+            throw new Error(messages.ExcecoesMensagens.pluginDeveDefinirPeloMenosUmaExtensao);
+        }
+        if (typeof plugin.parse !== 'function') {
+            throw new Error(messages.ExcecoesMensagens.pluginDeveImplementarMetodoParse);
+        }
+    }
+    getRegisteredPlugins() {
+        return Array.from(this.plugins.keys());
+    }
+    getSupportedExtensions() {
+        return Array.from(this.extensionMap.keys());
+    }
+    getStats() {
+        return {
+            pluginsRegistrados: this.plugins.size,
+            extensoesSuportadas: this.extensionMap.size,
+            pluginsHabilitados: this.config.enabled.length,
+            autoloadAtivo: this.config.autoload
+        };
+    }
+    updateConfig(newConfig) {
+        this.config = {
+            ...this.config,
+            ...newConfig
+        };
+        if (Object.prototype.hasOwnProperty.call(newConfig, 'enabled')) {
+            this.userConfiguredEnabled = true;
+        }
+        log.debug(messages.PluginRegistryMensagens.configAtualizada);
+    }
+    updateLanguageSupport(newSupport) {
+        this.languageSupport = {
+            ...this.languageSupport,
+            ...newSupport
+        };
+        log.debug(messages.PluginRegistryMensagens.suporteAtualizado);
+    }
+    clearCache() {
+        this.plugins.clear();
+        this.extensionMap.clear();
+        this.loadingPromises.clear();
+        log.debug(messages.PluginRegistryMensagens.cacheLimpo);
+    }
+}
+let globalRegistro = null;
+export function getGlobalRegistry() {
+    if (!globalRegistro) {
+        globalRegistro = new PluginRegistry();
+    }
+    return globalRegistro;
+}
+export function configureGlobalRegistry(config, languageSupport) {
+    globalRegistro = new PluginRegistry(config, languageSupport);
+}
+export function resetGlobalRegistry() {
+    globalRegistro = null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/shared/plugins/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/shared/plugins/registry.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport { messages } from '@core/messages';\n\nimport type { GlobalComImport, ImportDinamico, LanguageSupport, ParserPlugin, PluginConfig } from '@';\n\nconst {\n  log,\n  logCore\n} = messages;\n\n/**\n * Registry centralizado para gerenciamento de plugins de parser\n * Suporta loading dinâmico, cache e configuração flexível\n */\nexport class PluginRegistry {\n  private plugins = new Map<string, ParserPlugin>();\n  private extensionMap = new Map<string, string>(); // extensão -> nome do plugin\n  private config: PluginConfig;\n  private userConfiguredEnabled = false;\n  private languageSupport: Record<string, LanguageSupport>;\n  private loadingPromises = new Map<string, Promise<ParserPlugin>>();\n  constructor(config?: PluginConfig, languageSupport?: Record<string, LanguageSupport>) {\n    this.config = {\n      enabled: ['core'],\n      autoload: true,\n      registry: '@tutanus/plugins',\n      ...config\n    };\n    this.userConfiguredEnabled = !!config?.enabled;\n    this.languageSupport = languageSupport || {};\n  }\n\n  /**\n   * Registra um plugin no registry\n   */\n  registerPlugin(plugin: ParserPlugin): void {\n    logCore.registrandoPlugin(plugin.name, plugin.version);\n\n    // Valida o plugin\n    this.validatePlugin(plugin);\n\n    // Registra o plugin\n    this.plugins.set(plugin.name, plugin);\n\n    // Mapeia extensões para o plugin\n    for (const ext of plugin.extensions) {\n      if (this.extensionMap.has(ext)) {\n        const existing = this.extensionMap.get(ext);\n        const msg = messages.PluginRegistryMensagens.extensaoSobrescrita;\n        log.debug(msg.replace('{ext}', ext).replace('{existente}', existing || '').replace('{novo}', plugin.name));\n      }\n      this.extensionMap.set(ext, plugin.name);\n    }\n    const msgRegistrado = messages.PluginRegistryMensagens.pluginRegistrado;\n    log.debug(msgRegistrado.replace('{nome}', plugin.name).replace('{extensoes}', plugin.extensions.join(', ')));\n  }\n\n  /**\n   * Carrega um plugin dinamicamente\n   */\n  async loadPlugin(name: string): Promise<ParserPlugin> {\n    // Se já está carregado, retorna\n    if (this.plugins.has(name)) {\n      const plugin = this.plugins.get(name);\n      if (!plugin) {\n        throw new Error(messages.ExcecoesMensagens.pluginRegistradoNaoPodeSerObtido(name));\n      }\n      return plugin;\n    }\n\n    // Se já está sendo carregado, retorna a promise existente\n    // NOTE: este padrão evita condições de race onde múltiplos callers tentariam\n    // carregar o mesmo plugin simultaneamente - a promise existente é retornada\n    // e quaisquer erros são propagados pela promise, evitando rejetions não tratadas.\n    if (this.loadingPromises.has(name)) {\n      const promise = this.loadingPromises.get(name);\n      if (!promise) {\n        throw new Error(messages.ExcecoesMensagens.pluginCarregandoPromiseNaoPodeSerObtida(name));\n      }\n      return promise;\n    }\n\n    // Cria nova promise de loading\n    const loadingPromise = this.doLoadPlugin(name);\n    this.loadingPromises.set(name, loadingPromise);\n    try {\n      const plugin = await loadingPromise;\n      this.loadingPromises.delete(name);\n      return plugin;\n    } catch (error) {\n      this.loadingPromises.delete(name);\n      throw error;\n    }\n  }\n\n  /**\n   * Implementação real do loading do plugin\n   */\n  private async doLoadPlugin(name: string): Promise<ParserPlugin> {\n    const msgCarregando = messages.PluginRegistryMensagens.carregandoPlugin;\n    log.debug(msgCarregando.replace('{nome}', name));\n    try {\n      // Tenta carregar do registry configurado\n      const pluginCaminho = `${this.config.registry}/${name}-plugin`;\n      // Usa import dinâmico mockável (globalThis.import pode ser substituído nos testes)\n      const dynImport: ImportDinamico = (globalThis as GlobalComImport).import || ((caminho: string) => import(caminho));\n      const pluginModule = await dynImport(pluginCaminho);\n      const plugin: ParserPlugin = (pluginModule as Record<string, unknown>).default as ParserPlugin || pluginModule as ParserPlugin;\n\n      // Valida e registra\n      this.validatePlugin(plugin);\n      this.registerPlugin(plugin);\n      return plugin;\n    } catch (error) {\n      logCore.erroCarregarPlugin(name, (error as Error).message);\n      throw new Error(messages.ExcecoesMensagens.naoFoiPossivelCarregarPlugin(name, (error as Error).message));\n    }\n  }\n\n  /**\n   * Obtém plugin por extensão de arquivo\n   */\n  async getPluginForExtension(extension: string): Promise<ParserPlugin | null> {\n    const pluginNome = this.extensionMap.get(extension);\n    if (!pluginNome) {\n      if (this.config.autoload) {\n        logCore.tentandoAutoload(extension);\n        // Tenta inferir nome do plugin pela extensão\n        const inferredNome = this.inferPluginName(extension);\n        if (inferredNome && this.config.enabled.includes(inferredNome)) {\n          try {\n            return await this.loadPlugin(inferredNome);\n          } catch {\n            logCore.autoloadFalhou(inferredNome);\n          }\n        }\n      }\n      return null;\n    }\n\n    // Verifica se o plugin está habilitado\n    // Regra: se o usuário NÃO configurou a lista 'enabled', tratamos todos os plugins registrados como habilitados por padrão.\n    // Só aplicamos o gate includes() quando houve configuração explícita de 'enabled'.\n    if (this.userConfiguredEnabled && !this.config.enabled.includes(pluginNome)) {\n      const msgDesabilitado = messages.PluginRegistryMensagens.pluginDesabilitado;\n      log.debug(msgDesabilitado.replace('{nome}', pluginNome).replace('{extensao}', extension));\n      return null;\n    }\n\n    // Verifica suporte da linguagem\n    const langChave = extension.substring(1); // remove o ponto\n    const langSuporte = this.languageSupport[langChave];\n    if (langSuporte && !langSuporte.enabled) {\n      const msgLinguagem = messages.PluginRegistryMensagens.linguagemDesabilitada;\n      log.debug(msgLinguagem.replace('{linguagem}', langChave));\n      return null;\n    }\n    return await this.loadPlugin(pluginNome);\n  }\n\n  /**\n   * Infere nome do plugin baseado na extensão\n   */\n  private inferPluginName(extension: string): string | null {\n    const extMap: Record<string, string> = {\n      '.xml': 'core',\n      // XML fica no core\n      '.html': 'core',\n      // HTML fica no core\n      '.htm': 'core',\n      '.css': 'core',\n      // CSS fica no core\n      '.js': 'core',\n      '.jsx': 'core',\n      '.ts': 'core',\n      '.tsx': 'core',\n      '.mjs': 'core',\n      '.cjs': 'core',\n      '.php': 'core',\n      // PHP fica no core\n      '.py': 'core' // Python fica no core\n    };\n    return extMap[extension] || null;\n  }\n\n  /**\n   * Valida um plugin antes do registro\n   */\n  private validatePlugin(plugin: ParserPlugin): void {\n    if (!plugin.name || typeof plugin.name !== 'string') {\n      throw new Error(messages.ExcecoesMensagens.pluginDeveTerNomeValido);\n    }\n    if (!plugin.version || typeof plugin.version !== 'string') {\n      throw new Error(messages.ExcecoesMensagens.pluginDeveTerVersaoValida);\n    }\n    if (!Array.isArray(plugin.extensions) || plugin.extensions.length === 0) {\n      throw new Error(messages.ExcecoesMensagens.pluginDeveDefinirPeloMenosUmaExtensao);\n    }\n    if (typeof plugin.parse !== 'function') {\n      throw new Error(messages.ExcecoesMensagens.pluginDeveImplementarMetodoParse);\n    }\n  }\n\n  /**\n   * Lista plugins registrados\n   */\n  getRegisteredPlugins(): string[] {\n    return Array.from(this.plugins.keys());\n  }\n\n  /**\n   * Lista extensões suportadas\n   */\n  getSupportedExtensions(): string[] {\n    return Array.from(this.extensionMap.keys());\n  }\n\n  /**\n   * Obtém estatísticas do registry\n   */\n  getStats(): {\n    pluginsRegistrados: number;\n    extensoesSuportadas: number;\n    pluginsHabilitados: number;\n    autoloadAtivo: boolean;\n  } {\n    return {\n      pluginsRegistrados: this.plugins.size,\n      extensoesSuportadas: this.extensionMap.size,\n      pluginsHabilitados: this.config.enabled.length,\n      autoloadAtivo: this.config.autoload\n    };\n  }\n\n  /**\n   * Atualiza configuração do registry\n   */\n  updateConfig(newConfig: Partial<PluginConfig>): void {\n    this.config = {\n      ...this.config,\n      ...newConfig\n    };\n    if (Object.prototype.hasOwnProperty.call(newConfig, 'enabled')) {\n      this.userConfiguredEnabled = true;\n    }\n    log.debug(messages.PluginRegistryMensagens.configAtualizada);\n  }\n\n  /**\n   * Atualiza suporte a linguagens\n   */\n  updateLanguageSupport(newSupport: Record<string, LanguageSupport>): void {\n    this.languageSupport = {\n      ...this.languageSupport,\n      ...newSupport\n    };\n    log.debug(messages.PluginRegistryMensagens.suporteAtualizado);\n  }\n\n  /**\n   * Limpa cache de plugins (útil para testes)\n   */\n  clearCache(): void {\n    this.plugins.clear();\n    this.extensionMap.clear();\n    this.loadingPromises.clear();\n    log.debug(messages.PluginRegistryMensagens.cacheLimpo);\n  }\n}\n\n/**\n * Instância global do registry (singleton)\n */\nlet globalRegistro: PluginRegistry | null = null;\n\n/**\n * Obtém a instância global do registry\n */\n\nexport function getGlobalRegistry(): PluginRegistry {\n  if (!globalRegistro) {\n    globalRegistro = new PluginRegistry();\n  }\n  return globalRegistro;\n}\n\n/**\n * Configura a instância global do registry\n */\n\nexport function configureGlobalRegistry(config?: PluginConfig, languageSupport?: Record<string, LanguageSupport>): void {\n  globalRegistro = new PluginRegistry(config, languageSupport);\n}\n\n/**\n * Reseta a instância global (útil para testes)\n */\n\nexport function resetGlobalRegistry(): void {\n  globalRegistro = null;\n}"]}

package/dist/shared/validation/index.d.ts

@@ -0,0 +1,2 @@
+export * from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/validation/index.ts"],"names":[],"mappings":"AAKA,cAAc,iBAAiB,CAAC"}

package/dist/shared/validation/index.js

@@ -0,0 +1,2 @@
+export * from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/validation/index.ts"],"names":[],"mappings":"AAKA,cAAc,iBAAiB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Validation utilities\n */\n\nexport * from './validation.js';\n"]}

package/dist/shared/validation/validation.d.ts

@@ -0,0 +1,14 @@
+import type { ErroValidacaoCombinacao } from '../../types/index.js';
+export type { ErroValidacaoCombinacao };
+export declare function normalizePath(caminho: string): string;
+export declare function isPathSafe(fileCaminho: string): boolean;
+export declare function isFilenameSafe(filename: string): boolean;
+export declare function sanitizeFilename(filename: string): string;
+export declare function isRelativePathValid(relativePath: string): boolean;
+export declare function getFileExtension(filename: string): string;
+export declare function isExtensionAllowed(filename: string, allowedExtensions: string[]): boolean;
+export declare function normalizarPathLocal(caminho: string): string;
+export declare function validarNumeroPositivo(valor: unknown, _nome: string): number | null;
+export declare function validarCombinacoes(flags: Record<string, unknown>): ErroValidacaoCombinacao[];
+export declare function sanitizarFlags(flags: Record<string, unknown>): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/shared/validation/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/shared/validation/validation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,GAAG,CAAC;AAGjD,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAGxC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUrD;AAGD,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAuBvD;AAGD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAYxD;AAGD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAGD,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAKjE;AAGD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAGD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,OAAO,CAGzF;AAGD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOlF;AAGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,uBAAuB,EAAE,CAS5F;AAOD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMnE"}

package/dist/shared/validation/validation.js

@@ -0,0 +1,91 @@
+import path from 'node:path';
+import { messages } from '../../core/messages/index.js';
+export function normalizePath(caminho) {
+    const normalized = path.normalize(caminho);
+    const resolved = path.resolve(normalized);
+    const cwd = process.cwd();
+    if (!resolved.startsWith(cwd)) {
+        throw new Error(messages.ExcecoesMensagens.caminhoForaDaCwdNaoPermitido(caminho));
+    }
+    return normalized;
+}
+export function isPathSafe(fileCaminho) {
+    try {
+        const normalized = normalizePath(fileCaminho);
+        const dangerousPadroes = [/\.\./,
+            /^\/etc\//,
+            /^\/root\//,
+            /^\/sys\//,
+            /^\/proc\//,
+            /^C:\\Windows\\/i,
+            /^C:\\System32\\/i
+        ];
+        return !dangerousPadroes.some(pattern => pattern.test(normalized));
+    }
+    catch {
+        return false;
+    }
+}
+export function isFilenameSafe(filename) {
+    if (!filename || filename.length === 0)
+        return false;
+    if (filename.length > 255)
+        return false;
+    const invalidChars = /[<>:"|?*\x00-\x1f]/;
+    if (invalidChars.test(filename))
+        return false;
+    const reservedNomes = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\.|$)/i;
+    if (reservedNomes.test(filename))
+        return false;
+    return true;
+}
+export function sanitizeFilename(filename) {
+    return filename.replace(/[<>:"|?*\x00-\x1f]/g, '_').replace(/^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\.|$)/i, 'file_$1$2').slice(0, 255);
+}
+export function isRelativePathValid(relativePath) {
+    if (!relativePath)
+        return false;
+    if (path.isAbsolute(relativePath))
+        return false;
+    const normalized = path.normalize(relativePath);
+    return !normalized.startsWith('..');
+}
+export function getFileExtension(filename) {
+    const ext = path.extname(filename);
+    return ext.toLowerCase();
+}
+export function isExtensionAllowed(filename, allowedExtensions) {
+    const ext = getFileExtension(filename);
+    return allowedExtensions.includes(ext);
+}
+export function normalizarPathLocal(caminho) {
+    return normalizePath(caminho);
+}
+export function validarNumeroPositivo(valor, _nome) {
+    if (typeof valor === 'number' && valor > 0)
+        return valor;
+    if (typeof valor === 'string') {
+        const num = Number.parseFloat(valor);
+        if (!Number.isNaN(num) && num > 0)
+            return num;
+    }
+    return null;
+}
+export function validarCombinacoes(flags) {
+    const erros = [];
+    if (flags.scanOnly && flags.incremental) {
+        erros.push({
+            codigo: 'SCAN_INCREMENTAL',
+            mensagem: 'Não combinar --scan-only com --incremental (incremental exige AST).'
+        });
+    }
+    return erros;
+}
+export function sanitizarFlags(flags) {
+    const erros = validarCombinacoes(flags);
+    if (erros.length) {
+        const detalhe = erros.map(erro => `${erro.codigo}: ${erro.mensagem}`).join('; ');
+        throw new Error(detalhe);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/shared/validation/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/shared/validation/validation.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\nimport path from 'node:path';\n\nimport { messages } from '@core/messages';\n\nimport type { ErroValidacaoCombinacao } from '@';\n\n// Re-exporta o tipo para compatibilidade\nexport type { ErroValidacaoCombinacao };\n\n/** Normaliza um caminho assegurando que permanece dentro da CWD (remove tentativas de escape). */\nexport function normalizePath(caminho: string): string {\n  const normalized = path.normalize(caminho);\n  const resolved = path.resolve(normalized);\n  const cwd = process.cwd();\n\n  // Assegurar que o caminho permanece dentro da CWD\n  if (!resolved.startsWith(cwd)) {\n    throw new Error(messages.ExcecoesMensagens.caminhoForaDaCwdNaoPermitido(caminho));\n  }\n  return normalized;\n}\n\n/** Valida se um caminho de arquivo é seguro para operações de leitura/escrita */\nexport function isPathSafe(fileCaminho: string): boolean {\n  try {\n    const normalized = normalizePath(fileCaminho);\n\n    // Verificar padrões perigosos\n    const dangerousPadroes = [/\\.\\./,\n    // Directory traversal\n    /^\\/etc\\//,\n    // System directories\n    /^\\/root\\//,\n    // Root directory\n    /^\\/sys\\//,\n    // System files\n    /^\\/proc\\//,\n    // Process files\n    /^C:\\\\Windows\\\\/i,\n    // Windows system directory\n    /^C:\\\\System32\\\\/i // Windows system32\n    ];\n    return !dangerousPadroes.some(pattern => pattern.test(normalized));\n  } catch {\n    return false;\n  }\n}\n\n/** Valida se um nome de arquivo é válido e seguro */\nexport function isFilenameSafe(filename: string): boolean {\n  if (!filename || filename.length === 0) return false;\n  if (filename.length > 255) return false;\n\n  // Caracteres proibidos\n  const invalidChars = /[<>:\"|?*\\x00-\\x1f]/;\n  if (invalidChars.test(filename)) return false;\n\n  // Nomes reservados no Windows\n  const reservedNomes = /^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\\.|$)/i;\n  if (reservedNomes.test(filename)) return false;\n  return true;\n}\n\n/** Sanitiza um nome de arquivo removendo caracteres perigosos */\nexport function sanitizeFilename(filename: string): string {\n  return filename.replace(/[<>:\"|?*\\x00-\\x1f]/g, '_').replace(/^(CON|PRN|AUX|NUL|COM[1-9]|LPT[1-9])(\\.|$)/i, 'file_$1$2').slice(0, 255);\n}\n\n/** Valida se uma string representa um caminho relativo válido */\nexport function isRelativePathValid(relativePath: string): boolean {\n  if (!relativePath) return false;\n  if (path.isAbsolute(relativePath)) return false;\n  const normalized = path.normalize(relativePath);\n  return !normalized.startsWith('..');\n}\n\n/** Extrai a extensão de um arquivo de forma segura */\nexport function getFileExtension(filename: string): string {\n  const ext = path.extname(filename);\n  return ext.toLowerCase();\n}\n\n/** Verifica se uma extensão está na lista de extensões permitidas */\nexport function isExtensionAllowed(filename: string, allowedExtensions: string[]): boolean {\n  const ext = getFileExtension(filename);\n  return allowedExtensions.includes(ext);\n}\n\n/** Alias de compatibilidade para {@link normalizePath}. */\nexport function normalizarPathLocal(caminho: string): string {\n  return normalizePath(caminho);\n}\n\n/** Valida se um valor é um número positivo */\nexport function validarNumeroPositivo(valor: unknown, _nome: string): number | null {\n  if (typeof valor === 'number' && valor > 0) return valor;\n  if (typeof valor === 'string') {\n    const num = Number.parseFloat(valor);\n    if (!Number.isNaN(num) && num > 0) return num;\n  }\n  return null;\n}\n\n/** Regras simples de combinação de flags globais. Expandir conforme novos casos. */\nexport function validarCombinacoes(flags: Record<string, unknown>): ErroValidacaoCombinacao[] {\n  const erros: ErroValidacaoCombinacao[] = [];\n  if (flags.scanOnly && flags.incremental) {\n    erros.push({\n      codigo: 'SCAN_INCREMENTAL',\n      mensagem: 'Não combinar --scan-only com --incremental (incremental exige AST).'\n    });\n  }\n  return erros;\n}\n\n/**\n * Sanitiza flags de CLI, lançando erro se houver combinações inválidas.\n * @param flags - Mapa de flags da linha de comando\n * @throws Error com detalhes das combinações inválidas encontradas\n */\nexport function sanitizarFlags(flags: Record<string, unknown>): void {\n  const erros = validarCombinacoes(flags);\n  if (erros.length) {\n    const detalhe = erros.map(erro => `${erro.codigo}: ${erro.mensagem}`).join('; ');\n    throw new Error(detalhe);\n  }\n}"]}

package/dist/types/analysts/azure-pipelines.d.ts

@@ -0,0 +1,39 @@
+import type { Ocorrencia } from '../common/occurrences.js';
+export type FormatoRelatorio = 'json' | 'markdown' | 'html' | 'csv';
+export interface AzureCorrection {
+    tipo: string;
+    original: string;
+    sugerido: string;
+    linha: number;
+    confianca: number;
+}
+export interface AzureScoreResult {
+    score: number;
+    maxScore: number;
+    percentage: number;
+    issues: string[];
+    strengths: string[];
+}
+export interface DadosRelatorioAzure {
+    nomeRepositorio: string;
+    dataAnalise: string;
+    totalPipelines: number;
+    scoreGeral: number;
+    ocorrencias: Ocorrencia[];
+    resumoPorSeveridade: Record<string, number>;
+    resumoPorTipo: Record<string, number>;
+    pipelines: Array<{
+        nome: string;
+        score: number;
+        ocorrencias: number;
+    }>;
+    tempoAnaliseMs: number;
+}
+export interface OpcoesRelatorio {
+    formato: FormatoRelatorio;
+    output: string;
+    titulo?: string;
+    incluirDetalhes?: boolean;
+    filtrarSeveridade?: string[];
+}
+//# sourceMappingURL=azure-pipelines.d.ts.map

package/dist/types/analysts/azure-pipelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-pipelines.d.ts","sourceRoot":"","sources":["../../../src/types/analysts/azure-pipelines.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B"}

package/dist/types/analysts/azure-pipelines.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=azure-pipelines.js.map

package/dist/types/analysts/azure-pipelines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"azure-pipelines.js","sourceRoot":"","sources":["../../../src/types/analysts/azure-pipelines.ts"],"names":[],"mappings":"","sourcesContent":["// SPDX-License-Identifier: MIT\n\nimport type { Ocorrencia } from '../common/occurrences.js';\n\nexport type FormatoRelatorio = 'json' | 'markdown' | 'html' | 'csv';\n\nexport interface AzureCorrection {\n  tipo: string;\n  original: string;\n  sugerido: string;\n  linha: number;\n  confianca: number;\n}\n\nexport interface AzureScoreResult {\n  score: number;\n  maxScore: number;\n  percentage: number;\n  issues: string[];\n  strengths: string[];\n}\n\nexport interface DadosRelatorioAzure {\n  nomeRepositorio: string;\n  dataAnalise: string;\n  totalPipelines: number;\n  scoreGeral: number;\n  ocorrencias: Ocorrencia[];\n  resumoPorSeveridade: Record<string, number>;\n  resumoPorTipo: Record<string, number>;\n  pipelines: Array<{\n    nome: string;\n    score: number;\n    ocorrencias: number;\n  }>;\n  tempoAnaliseMs: number;\n}\n\nexport interface OpcoesRelatorio {\n  formato: FormatoRelatorio;\n  output: string;\n  titulo?: string;\n  incluirDetalhes?: boolean;\n  filtrarSeveridade?: string[];\n}\n"]}

package/dist/types/analysts/circleci.d.ts

@@ -0,0 +1,38 @@
+import type { Ocorrencia } from '../common/occurrences.js';
+export type FormatoRelatorio = 'json' | 'markdown' | 'html' | 'csv';
+export interface CircleCICorrection {
+    tipo: string;
+    original: string;
+    sugerido: string;
+    linha: number;
+    confianca: number;
+}
+export interface CircleCIScoreResult {
+    score: number;
+    maxScore: number;
+    percentage: number;
+    issues: string[];
+    strengths: string[];
+}
+export interface DadosRelatorioCircleCI {
+    nomeRepositorio: string;
+    dataAnalise: string;
+    totalConfigs: number;
+    scoreGeral: number;
+    ocorrencias: Ocorrencia[];
+    resumoPorSeveridade: Record<string, number>;
+    resumoPorTipo: Record<string, number>;
+    configs: Array<{
+        nome: string;
+        score: number;
+        ocorrencias: number;
+    }>;
+    tempoAnaliseMs: number;
+}
+export interface OpcoesRelatorio {
+    formato: FormatoRelatorio;
+    output: string;
+    titulo?: string;
+    incluirDetalhes?: boolean;
+}
+//# sourceMappingURL=circleci.d.ts.map

package/dist/types/analysts/circleci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circleci.d.ts","sourceRoot":"","sources":["../../../src/types/analysts/circleci.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/types/analysts/circleci.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=circleci.js.map

package/dist/types/analysts/circleci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circleci.js","sourceRoot":"","sources":["../../../src/types/analysts/circleci.ts"],"names":[],"mappings":"","sourcesContent":["// SPDX-License-Identifier: MIT\n\nimport type { Ocorrencia } from '../common/occurrences.js';\n\nexport type FormatoRelatorio = 'json' | 'markdown' | 'html' | 'csv';\n\nexport interface CircleCICorrection {\n  tipo: string;\n  original: string;\n  sugerido: string;\n  linha: number;\n  confianca: number;\n}\n\nexport interface CircleCIScoreResult {\n  score: number;\n  maxScore: number;\n  percentage: number;\n  issues: string[];\n  strengths: string[];\n}\n\nexport interface DadosRelatorioCircleCI {\n  nomeRepositorio: string;\n  dataAnalise: string;\n  totalConfigs: number;\n  scoreGeral: number;\n  ocorrencias: Ocorrencia[];\n  resumoPorSeveridade: Record<string, number>;\n  resumoPorTipo: Record<string, number>;\n  configs: Array<{ nome: string; score: number; ocorrencias: number }>;\n  tempoAnaliseMs: number;\n}\n\nexport interface OpcoesRelatorio {\n  formato: FormatoRelatorio;\n  output: string;\n  titulo?: string;\n  incluirDetalhes?: boolean;\n}\n"]}

package/dist/types/analysts/context.d.ts

@@ -0,0 +1,19 @@
+export interface EvidenciaContexto {
+    tipo: 'dependencia' | 'import' | 'export' | 'estrutura' | 'config' | 'script' | 'codigo' | string;
+    valor: string;
+    confianca: number;
+    tecnologia?: string;
+    origem?: string;
+    localizacao?: string;
+    detalhes?: Record<string, unknown>;
+}
+export interface ResultadoDeteccaoContextual {
+    tecnologia?: string;
+    contextoIdentificado?: string;
+    confiancaTotal: number;
+    evidencias: EvidenciaContexto[];
+    sugestoesMelhoria?: string[];
+    problemasDetectados?: string[];
+    sinaisAdicionais?: string[];
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/types/analysts/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/types/analysts/context.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EACA,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B"}

package/dist/types/analysts/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/types/analysts/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/types/analysts/context.ts"],"names":[],"mappings":"","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * Tipos para detecção inteligente de contexto e arquétipos\n * Consolidação de múltiplas versões\n */\n\nexport interface EvidenciaContexto {\n  tipo:\n    | 'dependencia'\n    | 'import'\n    | 'export'\n    | 'estrutura'\n    | 'config'\n    | 'script'\n    | 'codigo'\n    | string;\n  valor: string;\n  confianca: number; // 0-1\n  tecnologia?: string;\n  origem?: string;\n  localizacao?: string; // arquivo ou pasta onde foi encontrada\n  detalhes?: Record<string, unknown>;\n}\n\nexport interface ResultadoDeteccaoContextual {\n  tecnologia?: string;\n  contextoIdentificado?: string;\n  confiancaTotal: number;\n  evidencias: EvidenciaContexto[];\n  sugestoesMelhoria?: string[];\n  problemasDetectados?: string[];\n  sinaisAdicionais?: string[];\n}\n"]}

package/dist/types/analysts/corrections/index.d.ts

@@ -0,0 +1,3 @@
+export * from './reorganize-barrels.js';
+export * from './type-safety.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/analysts/corrections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/analysts/corrections/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC"}

package/dist/types/analysts/corrections/index.js

@@ -0,0 +1,3 @@
+export * from './reorganize-barrels.js';
+export * from './type-safety.js';
+//# sourceMappingURL=index.js.map

package/dist/types/analysts/corrections/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/analysts/corrections/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC","sourcesContent":["export * from './reorganize-barrels.js';\nexport * from './type-safety.js';\n"]}

package/dist/types/analysts/corrections/reorganize-barrels.d.ts

@@ -0,0 +1,12 @@
+export interface BarrelGerado {
+    caminho: string;
+    status: 'criado' | 'atualizado' | 'ok' | 'erro';
+    detalhes?: string;
+}
+export interface ResultadoGeracaoBarrels {
+    criados: number;
+    atualizados: number;
+    erros: string[];
+    barris: BarrelGerado[];
+}
+//# sourceMappingURL=reorganize-barrels.d.ts.map

package/dist/types/analysts/corrections/reorganize-barrels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorganize-barrels.d.ts","sourceRoot":"","sources":["../../../../src/types/analysts/corrections/reorganize-barrels.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,IAAI,GAAG,MAAM,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB"}

package/dist/types/analysts/corrections/reorganize-barrels.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reorganize-barrels.js.map

package/dist/types/analysts/corrections/reorganize-barrels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorganize-barrels.js","sourceRoot":"","sources":["../../../../src/types/analysts/corrections/reorganize-barrels.ts"],"names":[],"mappings":"","sourcesContent":["// SPDX-License-Identifier: MIT\n\nexport interface BarrelGerado {\n  caminho: string;\n  status: 'criado' | 'atualizado' | 'ok' | 'erro';\n  detalhes?: string;\n}\n\nexport interface ResultadoGeracaoBarrels {\n  criados: number;\n  atualizados: number;\n  erros: string[];\n  barris: BarrelGerado[];\n}\n"]}