tutanus 0.12.0

package/dist/core/config/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const SRC_RAIZ = "src";
+export declare const SRC_GLOB = "src/**";
+export declare const META_DIRS: string[];
+export declare function toPosix(caminho: string): string;
+export declare function isInsideSrc(relPath: string): boolean;
+export declare function isMetaPath(relPath: string): boolean;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/core/config/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,WAAW,CAAC;AAGjC,eAAO,MAAM,SAAS,UAAqC,CAAC;AAI5D,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/C;AAID,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpD;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAInD"}

package/dist/core/config/paths.js

@@ -0,0 +1,17 @@
+export const SRC_RAIZ = 'src';
+export const SRC_GLOB = 'src/**';
+export const META_DIRS = ['.github', '.vscode', '.tutanus'];
+export function toPosix(caminho) {
+    return String(caminho || '').replace(/\\+/g, '/');
+}
+export function isInsideSrc(relPath) {
+    const raiz = toPosix(relPath);
+    return /(?:^|\/)(?:src|source|codigo)(?:\/|$)/i.test(raiz);
+}
+export function isMetaPath(relPath) {
+    const raiz = toPosix(relPath);
+    if (META_DIRS.some(diretorio => raiz === diretorio || raiz.startsWith(`${diretorio}/`)))
+        return true;
+    return !isInsideSrc(raiz);
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/config/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/config/paths.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAC9B,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAGjC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAI5D,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACpD,CAAC;AAID,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B,OAAO,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC;AAID,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n// Centraliza padrões e utilidades de caminhos para evitar hardcodes dispersos\n\nexport const SRC_RAIZ = 'src';\nexport const SRC_GLOB = 'src/**';\n\n// Diretórios sempre tratados como meta (independente de SRC)\nexport const META_DIRS = ['.github', '.vscode', '.tutanus'];\n\n// Normaliza para separador POSIX\n\nexport function toPosix(caminho: string): string {\n  return String(caminho || '').replace(/\\\\+/g, '/');\n}\n\n// Caminho relativo (POSIX) está dentro de src?\n\nexport function isInsideSrc(relPath: string): boolean {\n  const raiz = toPosix(relPath);\n  // Considera qualquer segmento que case com src, source ou codigo: (^|/)(src|source|codigo)(/|$)\n  return /(?:^|\\/)(?:src|source|codigo)(?:\\/|$)/i.test(raiz);\n}\n\n// Heurística de meta: tudo fora de src é meta, além dos diretórios explícitos\n\nexport function isMetaPath(relPath: string): boolean {\n  const raiz = toPosix(relPath);\n  if (META_DIRS.some(diretorio => raiz === diretorio || raiz.startsWith(`${diretorio}/`))) return true;\n  return !isInsideSrc(raiz);\n}"]}

package/dist/core/config/security.d.ts

@@ -0,0 +1,9 @@
+export declare function sanitizarRelPath(rel: string): string;
+export declare function estaDentro(baseDir: string, alvo: string): boolean;
+export declare function resolverPluginSeguro(baseDir: string, pluginRel: string): {
+    caminho?: string;
+    erro?: string;
+};
+export declare function validarGlobBasico(padrao: string): boolean;
+export declare function filtrarGlobSeguros(padroes: string[]): string[];
+//# sourceMappingURL=security.d.ts.map

package/dist/core/config/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/core/config/security.ts"],"names":[],"mappings":"AASA,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWpD;AASD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjE;AASD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CA4BA;AAQD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAMzD;AAMD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE9D"}

package/dist/core/config/security.js

@@ -0,0 +1,58 @@
+import path from 'node:path';
+export function sanitizarRelPath(rel) {
+    if (!rel)
+        return '';
+    rel = rel.replace(/^[A-Za-z]:\\?/u, '').replace(/^\/+/, '');
+    const norm = rel.replace(/\\+/g, '/');
+    const collapsed = path.posix.normalize(norm);
+    if (collapsed.startsWith('..')) {
+        const semDots = collapsed.replace(new RegExp('^(\\.\\.\\/?|\\.\\/)+'), '');
+        return semDots.replace(/^\/+/, '');
+    }
+    return collapsed.replace(/^\/+/, '');
+}
+export function estaDentro(baseDir, alvo) {
+    const rel = path.relative(baseDir, alvo);
+    return !!rel && !rel.startsWith('..') && !path.isAbsolute(rel);
+}
+export function resolverPluginSeguro(baseDir, pluginRel) {
+    try {
+        if (typeof pluginRel !== 'string' || !pluginRel.trim()) {
+            return {
+                erro: 'entrada de plugin inválida (string vazia)'
+            };
+        }
+        const resolvido = path.resolve(baseDir, pluginRel);
+        if (!estaDentro(baseDir, resolvido)) {
+            return {
+                erro: 'plugin fora da raiz do projeto (bloqueado)'
+            };
+        }
+        const permitido = [/\.(c|m)?js$/i, /\.ts$/i];
+        if (!permitido.some(raiz => raiz.test(resolvido))) {
+            return {
+                erro: 'extensão de plugin não permitida'
+            };
+        }
+        return {
+            caminho: resolvido
+        };
+    }
+    catch (erro) {
+        return {
+            erro: erro.message || String(erro)
+        };
+    }
+}
+export function validarGlobBasico(padrao) {
+    if (padrao.length > 300)
+        return false;
+    const ocorrencias = (padrao.match(/\*\*/g) || []).length;
+    if (ocorrencias >= 5)
+        return false;
+    return true;
+}
+export function filtrarGlobSeguros(padroes) {
+    return padroes.filter(caminho => validarGlobBasico(caminho));
+}
+//# sourceMappingURL=security.js.map

package/dist/core/config/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../../src/core/config/security.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAE/B,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,uBAAuB,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3E,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AASD,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAY;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACjE,CAAC;AASD,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,SAAiB;IAIrE,IAAI,CAAC;QACH,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YACvD,OAAO;gBACL,IAAI,EAAE,2CAA2C;aAClD,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI,EAAE,4CAA4C;aACnD,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO;gBACL,IAAI,EAAE,kCAAkC;aACzC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,SAAS;SACnB,CAAC;IACJ,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAG,IAAc,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC;SAC9C,CAAC;IACJ,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAEtC,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACzD,IAAI,WAAW,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC;AAMD,MAAM,UAAU,kBAAkB,CAAC,OAAiB;IAClD,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nimport path from 'node:path';\n\n/**\n * Sanitiza um caminho relativo, eliminando tentativas de escape (..),\n * barras duplicadas e separadores inconsistentes.\n * @param rel - Caminho relativo a sanitizar\n * @returns Caminho normalizado e seguro\n */\nexport function sanitizarRelPath(rel: string): string {\n  if (!rel) return '';\n  rel = rel.replace(/^[A-Za-z]:\\\\?/u, '').replace(/^\\/+/, '');\n  const norm = rel.replace(/\\\\+/g, '/');\n  const collapsed = path.posix.normalize(norm);\n  if (collapsed.startsWith('..')) {\n    // remove todos os prefixos de ../ e ./ e barras iniciais resultantes\n    const semDots = collapsed.replace(new RegExp('^(\\\\.\\\\.\\\\/?|\\\\.\\\\/)+'), '');\n    return semDots.replace(/^\\/+/, '');\n  }\n  return collapsed.replace(/^\\/+/, '');\n}\n\n/**\n * Verifica se um caminho alvo está contido dentro do diretório base.\n * Impede acesso a caminhos fora da raiz do projeto.\n * @param baseDir - Diretório base de referência\n * @param alvo - Caminho absoluto do alvo a verificar\n * @returns `true` se o alvo está dentro do baseDir\n */\nexport function estaDentro(baseDir: string, alvo: string): boolean {\n  const rel = path.relative(baseDir, alvo);\n  return !!rel && !rel.startsWith('..') && !path.isAbsolute(rel);\n}\n\n/**\n * Resolve o caminho de um plugin de forma segura, verificando se está\n * dentro da raiz do projeto e se possui extensão permitida.\n * @param baseDir - Diretório raiz do projeto\n * @param pluginRel - Caminho relativo do plugin\n * @returns Objeto com `caminho` resolvido ou `erro` descritivo\n */\nexport function resolverPluginSeguro(baseDir: string, pluginRel: string): {\n  caminho?: string;\n  erro?: string;\n} {\n  try {\n    if (typeof pluginRel !== 'string' || !pluginRel.trim()) {\n      return {\n        erro: 'entrada de plugin inválida (string vazia)'\n      };\n    }\n    const resolvido = path.resolve(baseDir, pluginRel);\n    if (!estaDentro(baseDir, resolvido)) {\n      return {\n        erro: 'plugin fora da raiz do projeto (bloqueado)'\n      };\n    }\n    // Restringe extensões para reduzir risco de execução arbitrária\n    const permitido = [/\\.(c|m)?js$/i, /\\.ts$/i];\n    if (!permitido.some(raiz => raiz.test(resolvido))) {\n      return {\n        erro: 'extensão de plugin não permitida'\n      };\n    }\n    return {\n      caminho: resolvido\n    };\n  } catch (erro) {\n    return {\n      erro: (erro as Error).message || String(erro)\n    };\n  }\n}\n\n/**\n * Valida se um padrão glob é seguro para uso, bloqueando\n * padrões excessivamente longos ou com muitos wildcards recursivos.\n * @param padrao - Padrão glob a validar\n * @returns `true` se o padrão é considerado seguro\n */\nexport function validarGlobBasico(padrao: string): boolean {\n  if (padrao.length > 300) return false;\n  // Bloqueia mais de 4 ocorrências de '**' mesmo não consecutivas\n  const ocorrencias = (padrao.match(/\\*\\*/g) || []).length;\n  if (ocorrencias >= 5) return false;\n  return true;\n}\n/**\n * Filtra uma lista de padrões glob, retornando apenas os que são seguros.\n * @param padroes - Lista de padrões glob a filtrar\n * @returns Lista contendo apenas os padrões que passaram na validação\n */\nexport function filtrarGlobSeguros(padroes: string[]): string[] {\n  return padroes.filter(caminho => validarGlobBasico(caminho));\n}"]}

package/dist/core/config/traverse.d.ts

@@ -0,0 +1,3 @@
+export declare function __setTraverseModule(modulo: unknown): void;
+export declare function traverse(...args: unknown[]): unknown;
+//# sourceMappingURL=traverse.d.ts.map

package/dist/core/config/traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../../src/core/config/traverse.ts"],"names":[],"mappings":"AAYA,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAEzD;AACD,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAsBpD"}

package/dist/core/config/traverse.js

@@ -0,0 +1,23 @@
+import traverseModule from '@babel/traverse';
+let _traverseModule = traverseModule;
+export function __setTraverseModule(modulo) {
+    _traverseModule = modulo;
+}
+export function traverse(...args) {
+    const mod = _traverseModule;
+    let fn;
+    if (typeof mod === 'function') {
+        fn = mod;
+    }
+    else if (mod && typeof mod.default === 'function') {
+        fn = mod.default;
+    }
+    else if (mod && typeof mod.traverse === 'function') {
+        fn = mod.traverse;
+    }
+    if (!fn) {
+        throw new TypeError('Babel traverse não é uma função - verifique a resolução de módulo.');
+    }
+    return fn(...args);
+}
+//# sourceMappingURL=traverse.js.map

package/dist/core/config/traverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../../../src/core/config/traverse.ts"],"names":[],"mappings":"AACA,OAAO,cAAc,MAAM,iBAAiB,CAAC;AAO7C,IAAI,eAAe,GAAY,cAAc,CAAC;AAI9C,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,eAAe,GAAG,MAAM,CAAC;AAC3B,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,GAAG,IAAe;IACzC,MAAM,GAAG,GAAG,eAA0B,CAAC;IACvC,IAAI,EAA0B,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;QAC9B,EAAE,GAAG,GAAiB,CAAC;IACzB,CAAC;SAAM,IAAI,GAAG,IAAI,OAAQ,GAExB,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC1B,EAAE,GAAI,GAEJ,CAAC,OAAqB,CAAC;IAC3B,CAAC;SAAM,IAAI,GAAG,IAAI,OAAQ,GAExB,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC3B,EAAE,GAAI,GAEJ,CAAC,QAAsB,CAAC;IAC5B,CAAC;IACD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nimport traverseModule from '@babel/traverse';\n\n/**\n * Wrapper resiliente para o `@babel/traverse` lidando com variações de ESM/CJS.\n * Algumas builds expõem a função no `default`, outras como export do módulo CJS.\n */\ntype TraverseFn = (...arquivo: unknown[]) => unknown;\nlet _traverseModule: unknown = traverseModule;\n\n// Setter usado apenas em testes para injetar variações do módulo\n\nexport function __setTraverseModule(modulo: unknown): void {\n  _traverseModule = modulo;\n}\nexport function traverse(...args: unknown[]): unknown {\n  const mod = _traverseModule as unknown;\n  let fn: TraverseFn | undefined;\n  if (typeof mod === 'function') {\n    fn = mod as TraverseFn;\n  } else if (mod && typeof (mod as {\n    default?: unknown;\n  }).default === 'function') {\n    fn = (mod as {\n      default: unknown;\n    }).default as TraverseFn;\n  } else if (mod && typeof (mod as {\n    traverse?: unknown;\n  }).traverse === 'function') {\n    fn = (mod as {\n      traverse: unknown;\n    }).traverse as TraverseFn;\n  }\n  if (!fn) {\n    throw new TypeError('Babel traverse não é uma função - verifique a resolução de módulo.');\n  }\n  return fn(...args);\n}"]}

package/dist/core/execution/analysis-cache.d.ts

@@ -0,0 +1,25 @@
+import type { Ocorrencia } from '../../types/index.js';
+import type { AnalistaMetricsMap } from '../../types/core/execution/analysis-cache.js';
+export declare class AnalysisCache {
+    private cache;
+    private loaded;
+    private loadingPromise;
+    load(): Promise<void>;
+    private doLoad;
+    get(relPath: string, conteudo: string): Promise<Ocorrencia[] | null>;
+    set(relPath: string, conteudo: string, ocorrencias: Ocorrencia[]): Promise<void>;
+    invalidate(relPath: string): Promise<void>;
+    clear(): Promise<void>;
+    persistir(): Promise<void>;
+    estatisticas(): CacheEstatisticas;
+    private hashConteudo;
+    private limparExpirados;
+}
+export declare const analysisCache: AnalysisCache;
+export interface CacheEstatisticas {
+    totalEntradas: number;
+    totalOcorrencias: number;
+    expiradas: number;
+}
+export type { AnalistaMetricsMap };
+//# sourceMappingURL=analysis-cache.d.ts.map

package/dist/core/execution/analysis-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-cache.d.ts","sourceRoot":"","sources":["../../../src/core/execution/analysis-cache.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAOvF,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAA8B;IAK9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,MAAM;IAoBd,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC;IA0BpE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAehF,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAahC,YAAY,IAAI,iBAAiB;IAUjC,OAAO,CAAC,YAAY;YAIN,eAAe;CAS9B;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAcjD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/core/execution/analysis-cache.js

@@ -0,0 +1,105 @@
+import { config } from '../config/index.js';
+import { lerEstado, salvarEstado } from '../../shared/persistence/index.js';
+import XXH from 'xxhashjs';
+export class AnalysisCache {
+    cache = {};
+    loaded = false;
+    loadingPromise = null;
+    async load() {
+        if (this.loaded)
+            return;
+        if (this.loadingPromise)
+            return this.loadingPromise;
+        this.loadingPromise = this.doLoad();
+        return this.loadingPromise;
+    }
+    async doLoad() {
+        try {
+            const data = await lerEstado(config.ANALISE_CACHE_STATE_PATH, {
+                versao: config.ANALISE_CACHE_VERSION,
+                entradas: {}
+            });
+            if (data.versao === config.ANALISE_CACHE_VERSION) {
+                this.cache = data.entradas;
+            }
+        }
+        catch {
+        }
+        finally {
+            this.loaded = true;
+            this.loadingPromise = null;
+        }
+    }
+    async get(relPath, conteudo) {
+        if (!config.ANALISE_CACHE_ENABLED)
+            return null;
+        await this.load();
+        const hash = this.hashConteudo(conteudo);
+        const entry = this.cache[relPath];
+        if (!entry)
+            return null;
+        if (entry.hash !== hash)
+            return null;
+        if (config.ANALISE_CACHE_TTL_MS > 0) {
+            const idade = Date.now() - entry.timestamp;
+            if (idade > config.ANALISE_CACHE_TTL_MS) {
+                delete this.cache[relPath];
+                return null;
+            }
+        }
+        return entry.ocorrencias;
+    }
+    async set(relPath, conteudo, ocorrencias) {
+        if (!config.ANALISE_CACHE_ENABLED)
+            return;
+        await this.load();
+        this.cache[relPath] = {
+            hash: this.hashConteudo(conteudo),
+            ocorrencias,
+            timestamp: Date.now(),
+            count: ocorrencias.length
+        };
+    }
+    async invalidate(relPath) {
+        await this.load();
+        delete this.cache[relPath];
+    }
+    async clear() {
+        this.cache = {};
+        await this.persistir();
+    }
+    async persistir() {
+        if (!config.ANALISE_CACHE_ENABLED)
+            return;
+        await this.limparExpirados();
+        const data = {
+            versao: config.ANALISE_CACHE_VERSION,
+            entradas: this.cache
+        };
+        await salvarEstado(config.ANALISE_CACHE_STATE_PATH, data);
+    }
+    estatisticas() {
+        const entradas = Object.keys(this.cache);
+        const totalOcorrencias = entradas.reduce((acc, key) => acc + (this.cache[key]?.count ?? 0), 0);
+        return {
+            totalEntradas: entradas.length,
+            totalOcorrencias,
+            expiradas: 0
+        };
+    }
+    hashConteudo(conteudo) {
+        return XXH.h64(conteudo, 0xabcd).toString(16);
+    }
+    async limparExpirados() {
+        if (config.ANALISE_CACHE_TTL_MS <= 0)
+            return;
+        const agora = Date.now();
+        for (const [key, entry] of Object.entries(this.cache)) {
+            if (agora - entry.timestamp > config.ANALISE_CACHE_TTL_MS) {
+                delete this.cache[key];
+            }
+        }
+    }
+}
+export const analysisCache = new AnalysisCache();
+//# sourceMappingURL=analysis-cache.js.map

package/dist/core/execution/analysis-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-cache.js","sourceRoot":"","sources":["../../../src/core/execution/analysis-cache.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n// Cache de análise persistente entre execuções\n\nimport { config } from '@core/config';\nimport { lerEstado, salvarEstado } from '@shared/persistence';\nimport XXH from 'xxhashjs';\n\nimport type { Ocorrencia } from '@';\n\nimport type { AnalistaMetricsMap } from '../../types/core/execution/analysis-cache.js';\n\n/**\n * Cache de análise entre execuções.\n * Armazena resultados de análise por hash de conteúdo de arquivo,\n * permitindo reuso em execuções subsequentes.\n */\nexport class AnalysisCache {\n  private cache: Record<string, AnalistaCacheEntry> = {};\n  private loaded = false;\n  private loadingPromise: Promise<void> | null = null;\n\n  /**\n   * Carrega o cache do disco com proteção contra re-entrância\n   */\n  async load(): Promise<void> {\n    if (this.loaded) return;\n    if (this.loadingPromise) return this.loadingPromise;\n    this.loadingPromise = this.doLoad();\n    return this.loadingPromise;\n  }\n\n  private async doLoad(): Promise<void> {\n    try {\n      const data = await lerEstado<AnalysisCacheData>(config.ANALISE_CACHE_STATE_PATH, {\n        versao: config.ANALISE_CACHE_VERSION,\n        entradas: {}\n      });\n      if (data.versao === config.ANALISE_CACHE_VERSION) {\n        this.cache = data.entradas;\n      }\n    } catch {\n      // usa estado vazio\n    } finally {\n      this.loaded = true;\n      this.loadingPromise = null;\n    }\n  }\n\n  /**\n   * Obtém resultado em cache para um arquivo\n   */\n  async get(relPath: string, conteudo: string): Promise<Ocorrencia[] | null> {\n    if (!config.ANALISE_CACHE_ENABLED) return null;\n    await this.load();\n\n    const hash = this.hashConteudo(conteudo);\n    const entry = this.cache[relPath];\n\n    if (!entry) return null;\n    if (entry.hash !== hash) return null;\n\n    // Verifica TTL\n    if (config.ANALISE_CACHE_TTL_MS > 0) {\n      const idade = Date.now() - entry.timestamp;\n      if (idade > config.ANALISE_CACHE_TTL_MS) {\n        delete this.cache[relPath];\n        return null;\n      }\n    }\n\n    // Verifica se o arquivo ainda existe e tem o mesmo tamanho\n    return entry.ocorrencias;\n  }\n\n  /**\n   * Armazena resultado de análise no cache\n   */\n  async set(relPath: string, conteudo: string, ocorrencias: Ocorrencia[]): Promise<void> {\n    if (!config.ANALISE_CACHE_ENABLED) return;\n    await this.load();\n\n    this.cache[relPath] = {\n      hash: this.hashConteudo(conteudo),\n      ocorrencias,\n      timestamp: Date.now(),\n      count: ocorrencias.length\n    };\n  }\n\n  /**\n   * Remove entrada do cache\n   */\n  async invalidate(relPath: string): Promise<void> {\n    await this.load();\n    delete this.cache[relPath];\n  }\n\n  /**\n   * Limpa todo o cache\n   */\n  async clear(): Promise<void> {\n    this.cache = {};\n    await this.persistir();\n  }\n\n  /**\n   * Salva cache no disco\n   */\n  async persistir(): Promise<void> {\n    if (!config.ANALISE_CACHE_ENABLED) return;\n    await this.limparExpirados();\n    const data: AnalysisCacheData = {\n      versao: config.ANALISE_CACHE_VERSION,\n      entradas: this.cache\n    };\n    await salvarEstado(config.ANALISE_CACHE_STATE_PATH, data);\n  }\n\n  /**\n   * Retorna estatísticas do cache\n   */\n  estatisticas(): CacheEstatisticas {\n    const entradas = Object.keys(this.cache);\n    const totalOcorrencias = entradas.reduce((acc, key) => acc + (this.cache[key]?.count ?? 0), 0);\n    return {\n      totalEntradas: entradas.length,\n      totalOcorrencias,\n      expiradas: 0\n    };\n  }\n\n  private hashConteudo(conteudo: string): string {\n    return XXH.h64(conteudo, 0xabcd).toString(16);\n  }\n\n  private async limparExpirados(): Promise<void> {\n    if (config.ANALISE_CACHE_TTL_MS <= 0) return;\n    const agora = Date.now();\n    for (const [key, entry] of Object.entries(this.cache)) {\n      if (agora - entry.timestamp > config.ANALISE_CACHE_TTL_MS) {\n        delete this.cache[key];\n      }\n    }\n  }\n}\n\n// Singleton\nexport const analysisCache = new AnalysisCache();\n\ninterface AnalistaCacheEntry {\n  hash: string;\n  ocorrencias: Ocorrencia[];\n  timestamp: number;\n  count: number;\n}\n\ninterface AnalysisCacheData {\n  versao: number;\n  entradas: Record<string, AnalistaCacheEntry>;\n}\n\nexport interface CacheEstatisticas {\n  totalEntradas: number;\n  totalOcorrencias: number;\n  expiradas: number;\n}\n\nexport type { AnalistaMetricsMap };\n"]}

package/dist/core/execution/ast-cache.d.ts

@@ -0,0 +1,13 @@
+import type { NodePath } from '@babel/traverse';
+import type { Node } from '@babel/types';
+import type { AstCacheMetrics } from '../../types/core/execution/ast-cache.js';
+import type { FileEntry } from '../../types/index.js';
+export declare class ScopeAstCache {
+    private cache;
+    private metrics;
+    getOrParse(entry: FileEntry, ext: string): Promise<NodePath<Node> | null>;
+    has(relPath: string): boolean;
+    getMetrics(): AstCacheMetrics;
+    clear(): void;
+}
+//# sourceMappingURL=ast-cache.d.ts.map

package/dist/core/execution/ast-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-cache.d.ts","sourceRoot":"","sources":["../../../src/core/execution/ast-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAkBtD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,OAAO,CAKb;IAOI,UAAU,CACd,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAuDjC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAO7B,UAAU,IAAI,eAAe;IAO7B,KAAK,IAAI,IAAI;CAId"}

package/dist/core/execution/ast-cache.js

@@ -0,0 +1,59 @@
+import { decifrarSintaxe, TEM_PARSER } from '../parsing/parser.js';
+const AST_SENTINEL = {};
+export class ScopeAstCache {
+    cache = new Map();
+    metrics = {
+        hits: 0,
+        misses: 0,
+        parseTimeMs: 0,
+        cachedFiles: 0,
+    };
+    async getOrParse(entry, ext) {
+        const key = entry.relPath;
+        const cached = this.cache.get(key);
+        if (cached !== undefined) {
+            this.metrics.hits++;
+            return cached;
+        }
+        if (!TEM_PARSER(ext)) {
+            this.cache.set(key, null);
+            return null;
+        }
+        const globalStore = globalThis;
+        const globalCache = globalStore.__TUTANUS_AST_CACHE__;
+        const globalEntry = globalCache?.get(key);
+        if (globalEntry?.ast) {
+            this.cache.set(key, globalEntry.ast);
+            this.metrics.hits++;
+            return globalEntry.ast;
+        }
+        this.metrics.misses++;
+        const inicio = performance.now();
+        let ast = null;
+        if (entry.content) {
+            const parsed = await decifrarSintaxe(entry.content, ext, {
+                relPath: entry.relPath,
+            });
+            if (parsed && typeof parsed === 'object') {
+                if (Object.keys(parsed).length > 0) {
+                    ast = AST_SENTINEL;
+                }
+            }
+        }
+        this.metrics.parseTimeMs += performance.now() - inicio;
+        this.cache.set(key, ast);
+        this.metrics.cachedFiles = this.cache.size;
+        return ast;
+    }
+    has(relPath) {
+        return this.cache.has(relPath);
+    }
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    clear() {
+        this.cache.clear();
+        this.metrics = { hits: 0, misses: 0, parseTimeMs: 0, cachedFiles: 0 };
+    }
+}
+//# sourceMappingURL=ast-cache.js.map

package/dist/core/execution/ast-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-cache.js","sourceRoot":"","sources":["../../../src/core/execution/ast-cache.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,YAAY,GAAG,EAA+B,CAAC;AAerD,MAAM,OAAO,aAAa;IAChB,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAC;IACjD,OAAO,GAAoB;QACjC,IAAI,EAAE,CAAC;QACP,MAAM,EAAE,CAAC;QACT,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;KACf,CAAC;IAOF,KAAK,CAAC,UAAU,CACd,KAAgB,EAChB,GAAW;QAEX,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;QAG1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QAGD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAGD,MAAM,WAAW,GAAG,UAAgD,CAAC;QACrE,MAAM,WAAW,GAAG,WAAW,CAAC,qBAEnB,CAAC;QAEd,MAAM,WAAW,GAAG,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,WAAW,EAAE,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,WAAW,CAAC,GAAG,CAAC;QACzB,CAAC;QAGD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEjC,IAAI,GAAG,GAA0B,IAAI,CAAC;QACtC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvD,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC,CAAC;YACH,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzC,IAAI,MAAM,CAAC,IAAI,CAAC,MAA4C,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzE,GAAG,GAAG,YAAY,CAAC;gBACrB,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAE3C,OAAO,GAAG,CAAC;IACb,CAAC;IAKD,GAAG,CAAC,OAAe;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAKD,UAAU;QACR,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,CAAC;IAKD,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IACxE,CAAC;CACF","sourcesContent":["// SPDX-License-Identifier: MIT\nimport type { NodePath } from '@babel/traverse';\nimport type { Node } from '@babel/types';\n\nimport type { AstCacheMetrics } from '../../types/core/execution/ast-cache.js';\nimport type { FileEntry } from '../../types/index.js';\nimport { decifrarSintaxe, TEM_PARSER } from '../parsing/parser.js';\n\nconst AST_SENTINEL = {} as unknown as NodePath<Node>;\n\n/**\n * Cache de AST com escopo de execução.\n *\n * Compartilha ASTs entre analistas que processam o mesmo arquivo\n * durante uma única execução de análise. Elimina re-parsing\n * desnecessário quando múltiplas técnicas atuam sobre o mesmo arquivo.\n *\n * Funciona em conjunto com o cache global (process-level) mantido\n * pelo inquisidor, mas adiciona uma camada por escopo que:\n * - Garante consistência dentro da mesma execução\n * - Prepara o terreno para parsing lazy (parsear sob demanda)\n * - Coleta métricas granulares por escopo\n */\nexport class ScopeAstCache {\n  private cache = new Map<string, NodePath<Node> | null>();\n  private metrics: AstCacheMetrics = {\n    hits: 0,\n    misses: 0,\n    parseTimeMs: 0,\n    cachedFiles: 0,\n  };\n\n  /**\n   * Obtém ou faz parse do AST para um arquivo.\n   * Primeiro verifica o cache do escopo, depois o cache global\n   * (process-level), e por fim faz o parsing do conteúdo.\n   */\n  async getOrParse(\n    entry: FileEntry,\n    ext: string,\n  ): Promise<NodePath<Node> | null> {\n    const key = entry.relPath;\n\n    // 1) Cache do escopo atual\n    const cached = this.cache.get(key);\n    if (cached !== undefined) {\n      this.metrics.hits++;\n      return cached;\n    }\n\n    // Pula extensões sem parser registrado\n    if (!TEM_PARSER(ext)) {\n      this.cache.set(key, null);\n      return null;\n    }\n\n    // 2) Cache global (process-level) do inquisidor\n    const globalStore = globalThis as unknown as Record<string, unknown>;\n    const globalCache = globalStore.__TUTANUS_AST_CACHE__ as\n      | Map<string, { mtimeMs: number; size: number; ast: NodePath<Node> | undefined }>\n      | undefined;\n\n    const globalEntry = globalCache?.get(key);\n    if (globalEntry?.ast) {\n      this.cache.set(key, globalEntry.ast);\n      this.metrics.hits++;\n      return globalEntry.ast;\n    }\n\n    // 3) Parsing sob demanda\n    this.metrics.misses++;\n    const inicio = performance.now();\n\n    let ast: NodePath<Node> | null = null;\n    if (entry.content) {\n      const parsed = await decifrarSintaxe(entry.content, ext, {\n        relPath: entry.relPath,\n      });\n      if (parsed && typeof parsed === 'object') {\n        if (Object.keys(parsed as unknown as Record<string, unknown>).length > 0) {\n          ast = AST_SENTINEL;\n        }\n      }\n    }\n\n    this.metrics.parseTimeMs += performance.now() - inicio;\n    this.cache.set(key, ast);\n    this.metrics.cachedFiles = this.cache.size;\n\n    return ast;\n  }\n\n  /**\n   * Verifica se um arquivo já está em cache neste escopo\n   */\n  has(relPath: string): boolean {\n    return this.cache.has(relPath);\n  }\n\n  /**\n   * Retorna métricas acumuladas do escopo atual\n   */\n  getMetrics(): AstCacheMetrics {\n    return { ...this.metrics };\n  }\n\n  /**\n   * Limpa o cache do escopo\n   */\n  clear(): void {\n    this.cache.clear();\n    this.metrics = { hits: 0, misses: 0, parseTimeMs: 0, cachedFiles: 0 };\n  }\n}\n"]}

package/dist/core/execution/executor.d.ts

@@ -0,0 +1,13 @@
+import type { FileEntryWithAst, GuardianResult, MetricaExecucao, Ocorrencia, ResultadoInquisicao, Tecnica } from '../../types/index.js';
+import type { ExecutorEventEmitter } from '../../types/core/config/config.js';
+export type { ExecutorEventEmitter };
+export declare function executarInquisicao(fileEntriesComAst: FileEntryWithAst[], tecnicas: Tecnica[], baseDir: string, guardianResultado: GuardianResult, opts?: {
+    verbose?: boolean;
+    compact?: boolean;
+    fast?: boolean;
+    sequential?: boolean;
+    events?: ExecutorEventEmitter;
+    onOcorrencia?: (ocorrencia: Ocorrencia) => void;
+}): Promise<ResultadoInquisicao>;
+export declare function registrarUltimasMetricas(metricas: MetricaExecucao | undefined): void;
+//# sourceMappingURL=executor.d.ts.map

package/dist/core/execution/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/core/execution/executor.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAuC,gBAAgB,EAAE,cAAc,EAAmB,eAAe,EAAmB,UAAU,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC;AAG5L,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAU9E,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAyErC,wBAAsB,kBAAkB,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;IAC9J,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAE9B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACjD,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAugB/B;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI,CAMpF"}