@semacode/cli 2.3.0 → 2.3.1

package/dist/angular-consumer-standalone.d.ts

@@ -1,6 +1,8 @@
+import ts from "typescript";
 export interface SuperficieAngularStandaloneConsumer {
     rota: string;
     arquivo: string;
     tipoArquivo: "app" | "component";
 }
-export declare function coletarSuperficiesAngularStandaloneConsumer(baseProjeto: string, arquivos: string[]): Promise<SuperficieAngularStandaloneConsumer[]>;
+export type LeitorTextoAngularConsumer = (arquivo: string) => Promise<string>;
+export declare function coletarSuperficiesAngularStandaloneConsumer(baseProjeto: string, arquivos: string[], leitorTexto?: LeitorTextoAngularConsumer, sourceFiles?: ReadonlyMap<string, ts.SourceFile>): Promise<SuperficieAngularStandaloneConsumer[]>;

package/dist/angular-consumer-standalone.js

@@ -1,3 +1,5 @@
+// SEMA-GOVERNED: sema.produto.governanca_ia.drift
+// Descricao: extrai superficies Angular usando o leitor compartilhado do plano de drift quando disponivel.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import ts from "typescript";
@@ -134,7 +136,7 @@ function extrairIdentificadorImportado(expressao) {
     }
     return undefined;
 }
-async function extrairTemplateAngularStandalone(baseProjeto, relacaoArquivo, metadata) {
+async function extrairTemplateAngularStandalone(baseProjeto, relacaoArquivo, metadata, leitorTexto) {
     const templateInline = extrairTextoLiteral(obterExpressaoPropriedade(metadata, "template"));
     if (templateInline) {
         return templateInline;
@@ -148,19 +150,21 @@ async function extrairTemplateAngularStandalone(baseProjeto, relacaoArquivo, met
         return "";
     }
     try {
-        return await readFile(path.join(baseProjeto, templateRelativo), "utf8");
+        const arquivo = path.join(baseProjeto, templateRelativo);
+        return leitorTexto ? await leitorTexto(arquivo) : await readFile(arquivo, "utf8");
     }
     catch {
         return "";
     }
 }
-async function indexarComponenteAngularStandalone(baseProjeto, arquivo) {
+async function indexarComponenteAngularStandalone(baseProjeto, arquivo, leitorTexto, sourceFiles) {
     const relacaoArquivo = normalizarCaminhoConsumer(path.relative(baseProjeto, arquivo));
     if (!arquivoEhComponenteAngularStandalone(relacaoArquivo)) {
         return undefined;
     }
-    const codigo = await readFile(arquivo, "utf8");
-    const sourceFile = ts.createSourceFile(arquivo, codigo, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const codigo = leitorTexto ? await leitorTexto(arquivo) : await readFile(arquivo, "utf8");
+    const sourceFile = sourceFiles?.get(path.resolve(arquivo))
+        ?? ts.createSourceFile(arquivo, codigo, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
     const imports = extrairImportsTypeScriptAngular(relacaoArquivo, codigo);
     for (const statement of sourceFile.statements) {
         if (!ts.isClassDeclaration(statement)) {
@@ -192,7 +196,7 @@ async function indexarComponenteAngularStandalone(baseProjeto, arquivo) {
             arquivo: relacaoArquivo,
             selector: extrairTextoLiteral(obterExpressaoPropriedade(metadata, "selector")),
             imports: [...importsArquivos],
-            template: await extrairTemplateAngularStandalone(baseProjeto, relacaoArquivo, metadata),
+            template: await extrairTemplateAngularStandalone(baseProjeto, relacaoArquivo, metadata, leitorTexto),
             raiz: arquivoEhRaizAngularStandalone(relacaoArquivo),
         };
     }
@@ -205,10 +209,10 @@ function templateReferenciaSelector(template, selector) {
     const escapado = selector.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
     return new RegExp(`<${escapado}(?:\\s|>)`, "i").test(template);
 }
-export async function coletarSuperficiesAngularStandaloneConsumer(baseProjeto, arquivos) {
+export async function coletarSuperficiesAngularStandaloneConsumer(baseProjeto, arquivos, leitorTexto, sourceFiles) {
     const componentes = new Map();
     for (const arquivo of arquivos) {
-        const componente = await indexarComponenteAngularStandalone(baseProjeto, arquivo);
+        const componente = await indexarComponenteAngularStandalone(baseProjeto, arquivo, leitorTexto, sourceFiles);
         if (componente) {
             componentes.set(componente.arquivo, componente);
         }

package/dist/drift.part01.d.ts

@@ -1,5 +1,8 @@
 import type { EngineBanco, NivelConfiancaSemantica, NivelRiscoSemantico, TipoRecursoPersistencia } from "@sema/nucleo";
 import type { ContextoProjetoCarregado } from "./projeto.js";
+import type { PoliticaCacheDrift } from "./driftCache.js";
+import type { MetricasCacheIncrementalDrift } from "./driftCacheIncremental.js";
+import type { MetricasCatalogoDrift, ObservadorOperacaoDrift } from "./driftCatalogo.js";
 export type OrigemCodigoDrift = "ts" | "js" | "py" | "dart" | "lua" | "cs" | "java" | "go" | "rust" | "cpp" | "php";
 export type OrigemSimboloDrift = OrigemCodigoDrift | "sql";
 export interface SimboloResolvido {
@@ -31,9 +34,11 @@ export interface OpcoesDriftLegado {
     escopo?: EscopoDriftReal;
     ignorarWorktrees?: boolean;
     ignorarConsumidoresLaterais?: boolean;
+    cache?: PoliticaCacheDrift;
+    observador?: ObservadorOperacaoDrift;
 }
 export interface DiagnosticoDrift {
-    tipo: "impl_quebrado" | "task_sem_impl" | "rota_divergente" | "recurso_divergente" | "vinculo_quebrado" | "seguranca_frouxa" | "pontuacao_semantica_insuficiente" | "contrato_monolitico" | "codigo_monolitico" | "codigo_governado_sem_cabecalho";
+    tipo: "impl_quebrado" | "task_sem_impl" | "rota_divergente" | "recurso_divergente" | "vinculo_quebrado" | "seguranca_frouxa" | "pontuacao_semantica_insuficiente" | "contrato_monolitico" | "codigo_monolitico" | "codigo_governado_sem_cabecalho" | "escopo_estreito_sem_vinculos";
     modulo: string;
     task?: string;
     route?: string;
@@ -159,6 +164,28 @@ export interface ConfiguracaoEscopoDriftAplicada {
     ignorarWorktrees: boolean;
     ignorarConsumidoresLaterais: boolean;
     termosEscopo: string[];
+    estrategia?: "arquivos_vinculados" | "projeto";
+    cobertura?: "completa" | "parcial";
+    arquivosPlanejados?: string[];
+    arquivosDeclarados?: string[];
+    arquivosInferidos?: string[];
+    arquivosAusentes?: string[];
+    bloqueios?: string[];
+    cache?: {
+        politica: PoliticaCacheDrift;
+        origem: "cache" | "calculado" | "nao_aplicavel";
+        chave?: string;
+        incremental?: MetricasCacheIncrementalDrift;
+        fasesMs?: {
+            planejamento: number;
+            catalogacao: number;
+            dependencias: number;
+            assinaturas: number;
+            indexacao: number;
+            total: number;
+        };
+    };
+    catalogo?: MetricasCatalogoDrift;
 }
 export interface RegistroImpactoSemanticoArquivo {
     arquivo: string;
@@ -251,7 +278,10 @@ export declare function obterDiretoriosIgnoradosAtivos(): Set<string>;
 export declare function definirDiretoriosIgnoradosAtivos(diretorios: Set<string>): void;
 export declare function normalizarFragmentoArquivo(valor: string): string;
 export declare function normalizarEscopoDrift(valor?: string): EscopoDriftReal;
-export declare function resolverOpcoesDrift(opcoes?: OpcoesDriftLegado): Required<OpcoesDriftLegado>;
+export type OpcoesDriftLegadoResolvidas = Required<Omit<OpcoesDriftLegado, "observador">> & {
+    observador?: ObservadorOperacaoDrift;
+};
+export declare function resolverOpcoesDrift(opcoes?: OpcoesDriftLegado): OpcoesDriftLegadoResolvidas;
 export declare function resolverDiretoriosIgnoradosAtivos(opcoes?: OpcoesDriftLegado): Set<string>;
 export declare function quebrarTermosEscopo(valor: string): string[];
 export declare function quebrarTermosModuloEscopo(nomeModulo: string): string[];

package/dist/drift.part01.js

@@ -91,6 +91,8 @@ export function resolverOpcoesDrift(opcoes) {
         escopo: normalizarEscopoDrift(opcoes?.escopo),
         ignorarWorktrees: opcoes?.ignorarWorktrees !== false,
         ignorarConsumidoresLaterais: opcoes?.ignorarConsumidoresLaterais !== false,
+        cache: opcoes?.cache === "refresh" || opcoes?.cache === "off" ? opcoes.cache : "auto",
+        observador: opcoes?.observador,
     };
 }
 export function resolverDiretoriosIgnoradosAtivos(opcoes) {

package/dist/drift.part04.d.ts

@@ -2,6 +2,7 @@ import ts from "typescript";
 import type { IrModulo, IrSuperficie, IrTask, IrVinculo, NivelConfiancaSemantica, NivelRiscoSemantico } from "@sema/nucleo";
 import { ResultadoDrift, SimboloResolvido } from "./drift.part01.js";
 import { type PoliticaPontuacaoSemantica } from "./driftScore.js";
+import type { CatalogoDrift } from "./driftCatalogo.js";
 export declare function resolverArquivoOuSimboloAncora(vinculos: IrVinculo[], simbolos: SimboloResolvido[], mapaImpl: Map<string, SimboloResolvido>, arquivos: string[]): {
     arquivo?: string;
     simbolo?: string;
@@ -37,9 +38,9 @@ export declare function lerDecorator(node: ts.Node, nomes: string[]): {
     argumentos: ts.NodeArray<ts.Expression>;
 } | undefined;
 export declare function juntarCaminhoHttp(base: string | undefined, sufixo: string | undefined): string;
-export declare function listarArquivosRecursivos(diretorio: string, extensoes: string[]): Promise<string[]>;
+export declare function listarArquivosRecursivos(diretorio: string, extensoes: string[], catalogo?: CatalogoDrift): Promise<string[]>;
 export declare const EXTENSOES_ARQUIVOS_RASTREAVEIS_DRIFT: string[];
-export declare function indexarArquivosRastreaveis(diretorios: string[]): Promise<string[]>;
+export declare function indexarArquivosRastreaveis(diretorios: string[], catalogo?: CatalogoDrift): Promise<string[]>;
 export declare function caminhosSimbolicos(baseDiretorio: string, arquivo: string): string[];
 export declare function registrarSimboloTypeScript(simbolos: Map<string, SimboloResolvido>, basesSimbolicas: string[], arquivo: string, nome: string, nomeClasse?: string, origem?: "ts" | "js"): void;
 export declare function desembrulharExpressaoTypeScript(expr: ts.Expression): ts.Expression;

package/dist/drift.part04.js

@@ -258,7 +258,10 @@ export function juntarCaminhoHttp(base, sufixo) {
     const caminho = `/${partes.join("/")}`.replace(/\/+/g, "/");
     return caminho === "//" ? "/" : caminho;
 }
-export async function listarArquivosRecursivos(diretorio, extensoes) {
+export async function listarArquivosRecursivos(diretorio, extensoes, catalogo) {
+    if (catalogo) {
+        return catalogo.listarPorRaiz(diretorio, extensoes);
+    }
     let entradas;
     try {
         entradas = await readdir(diretorio, { withFileTypes: true, encoding: "utf8" });
@@ -291,10 +294,10 @@ export const EXTENSOES_ARQUIVOS_RASTREAVEIS_DRIFT = [
     ".yml", ".yaml", ".toml", ".xml", ".html", ".htm", ".css",
     ".Caddyfile", ".caddyfile",
 ];
-export async function indexarArquivosRastreaveis(diretorios) {
+export async function indexarArquivosRastreaveis(diretorios, catalogo) {
     const arquivos = new Set();
     for (const diretorio of diretorios) {
-        for (const arquivo of await listarArquivosRecursivos(diretorio, EXTENSOES_ARQUIVOS_RASTREAVEIS_DRIFT)) {
+        for (const arquivo of await listarArquivosRecursivos(diretorio, EXTENSOES_ARQUIVOS_RASTREAVEIS_DRIFT, catalogo)) {
             arquivos.add(arquivo);
         }
     }

package/dist/drift.part05.d.ts

@@ -1,5 +1,6 @@
 import ts from "typescript";
 import { RegistroConsumerSurfaceDrift, SimboloResolvido } from "./drift.part01.js";
+import type { CatalogoDrift } from "./driftCatalogo.js";
 export declare function registrarMetodoTypeScriptProtoOuObjeto(simbolos: Map<string, SimboloResolvido>, basesSimbolicas: string[], arquivo: string, nomeMetodo: string, nomeClasse?: string, origem?: "ts" | "js"): void;
 export declare function registrarMetodosObjectAssignTypeScript(simbolos: Map<string, SimboloResolvido>, basesSimbolicas: string[], arquivo: string, objeto: ts.ObjectLiteralExpression, sourceFile: ts.SourceFile, nomeClasse?: string, origem?: "ts" | "js"): void;
 export declare function registrarAtribuicaoPrototypeTypeScript(simbolos: Map<string, SimboloResolvido>, basesSimbolicas: string[], arquivo: string, sourceFile: ts.SourceFile, esquerda: ts.Expression, direita: ts.Expression, origem?: "ts" | "js"): void;
@@ -43,5 +44,5 @@ export declare function extrairRotasReactViteConsumer(relacaoArquivo: string, co
 export declare function normalizarRotaDeclaradaFlutter(caminhoCru: string): string;
 export declare function extrairRotasFlutterConsumer(relacaoArquivo: string, codigo: string): RotaFlutterConsumerDrift[];
 export declare function extrairRotasAngularConsumerDiretas(relacaoArquivo: string, codigo: string, prefixo?: string): RotaAngularConsumerDrift[];
-export declare function extrairRotasAngularConsumer(diretorioBase: string, relacaoArquivo: string, prefixo?: string, visitados?: Set<string>): Promise<RotaAngularConsumerDrift[]>;
+export declare function extrairRotasAngularConsumer(diretorioBase: string, relacaoArquivo: string, prefixo?: string, visitados?: Set<string>, catalogo?: CatalogoDrift): Promise<RotaAngularConsumerDrift[]>;
 export declare function simboloEhBridgeConsumer(caminho: string, arquivo: string): boolean;

package/dist/drift.part05.js

@@ -318,7 +318,7 @@ export function extrairRotasAngularConsumerDiretas(relacaoArquivo, codigo, prefi
     }
     return rotas;
 }
-export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo, prefixo = "/", visitados = new Set()) {
+export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo, prefixo = "/", visitados = new Set(), catalogo) {
     const relacaoNormalizada = normalizarRelacaoConsumer(relacaoArquivo);
     if (visitados.has(relacaoNormalizada)) {
         return [];
@@ -326,7 +326,8 @@ export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo,
     visitados.add(relacaoNormalizada);
     let codigo = "";
     try {
-        codigo = await readFile(path.join(diretorioBase, relacaoNormalizada), "utf8");
+        const arquivo = path.join(diretorioBase, relacaoNormalizada);
+        codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
     }
     catch {
         return [];
@@ -337,7 +338,7 @@ export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo,
         if (!rota.arquivoRotasFilhas) {
             continue;
         }
-        filhas.push(...await extrairRotasAngularConsumer(diretorioBase, rota.arquivoRotasFilhas, rota.rota, visitados));
+        filhas.push(...await extrairRotasAngularConsumer(diretorioBase, rota.arquivoRotasFilhas, rota.rota, visitados, catalogo));
     }
     return [...rotas, ...filhas];
 }

package/dist/drift.part06.d.ts

@@ -1,8 +1,9 @@
 import type { FonteLegado } from "./tipos.js";
 import { ConsumerFramework, RecursoResolvido, RegistroConsumerBridgeDrift, RegistroConsumerSurfaceDrift, RotaResolvida, SimboloResolvido } from "./drift.part01.js";
+import type { CatalogoDrift } from "./driftCatalogo.js";
 export declare function inferirConsumerFrameworkPrincipal(fontesLegado: FonteLegado[], consumerSurfaces: RegistroConsumerSurfaceDrift[], consumerBridges: RegistroConsumerBridgeDrift[]): ConsumerFramework | null;
 export declare function extrairColecoesFirebase(arquivo: string, codigo: string): RecursoResolvido[];
-export declare function indexarTypeScript(diretorios: string[]): Promise<{
+export declare function indexarTypeScript(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];

package/dist/drift.part06.js

@@ -126,13 +126,15 @@ function aplicarReexportacoesTypeScript(simbolos, reexportacoes) {
         }
     }
 }
-export async function indexarTypeScript(diretorios) {
+export async function indexarTypeScript(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     const consumerSurfaces = new Map();
+    const sourceFiles = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"], catalogo))
             .filter((arquivo) => !arquivo.endsWith(".d.ts")
             && !arquivo.endsWith(".spec.ts")
             && !arquivo.endsWith(".test.ts"));
@@ -144,7 +146,7 @@ export async function indexarTypeScript(diretorios) {
         let encontrouSuperficieAngularPorRotas = false;
         const reexportacoes = [];
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const origemArquivo = /\.(?:js|jsx|mjs|cjs)$/i.test(arquivo) ? "js" : "ts";
             const scriptKind = arquivo.endsWith(".tsx")
                 ? ts.ScriptKind.TSX
@@ -153,7 +155,9 @@ export async function indexarTypeScript(diretorios) {
                     : origemArquivo === "js"
                         ? ts.ScriptKind.JS
                         : ts.ScriptKind.TS;
+            catalogo?.emitir("ast.create", arquivo);
             const sourceFile = ts.createSourceFile(arquivo, codigo, ts.ScriptTarget.Latest, true, scriptKind);
+            sourceFiles.set(path.resolve(arquivo), sourceFile);
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             const relacao = path.relative(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
@@ -228,7 +232,7 @@ export async function indexarTypeScript(diretorios) {
             }
             if (arquivoEhRotasAngularConsumer(relacao) && (!usarApenasRotasAngularRaiz || arquivosRotasAngularRaiz.has(path.resolve(arquivo)))) {
                 encontrouSuperficieAngularPorRotas = true;
-                for (const rotaAngular of await extrairRotasAngularConsumer(diretorio, relacao)) {
+                for (const rotaAngular of await extrairRotasAngularConsumer(diretorio, relacao, "/", new Set(), catalogo)) {
                     const arquivoRotasAngular = path.join(diretorio, rotaAngular.arquivoRotas);
                     consumerSurfaces.set(`${rotaAngular.rota}:${arquivoRotasAngular}:routes`, {
                         rota: rotaAngular.rota,
@@ -328,7 +332,7 @@ export async function indexarTypeScript(diretorios) {
             }
         }
         if (!encontrouSuperficieAngularPorRotas) {
-            for (const superficie of await coletarSuperficiesAngularStandaloneConsumer(diretorio, arquivos)) {
+            for (const superficie of await coletarSuperficiesAngularStandaloneConsumer(diretorio, arquivos, catalogo ? (arquivo) => catalogo.lerTexto(arquivo) : undefined, sourceFiles)) {
                 const arquivoSuperficie = path.join(diretorio, superficie.arquivo);
                 consumerSurfaces.set(`${superficie.rota}:${arquivoSuperficie}:${superficie.tipoArquivo}`, {
                     rota: superficie.rota,

package/dist/drift.part07.d.ts

@@ -1,51 +1,52 @@
 import type { EngineBanco } from "@sema/nucleo";
 import { OrigemRecursoDrift, RecursoResolvido, RegistroColunaPersistenciaDrift, RegistroConsumerSurfaceDrift, RotaResolvida, SimboloResolvido } from "./drift.part01.js";
-export declare function indexarPython(diretorios: string[]): Promise<{
+import type { CatalogoDrift } from "./driftCatalogo.js";
+export declare function indexarPython(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarDart(diretorios: string[]): Promise<{
+export declare function indexarDart(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
     consumerSurfaces: RegistroConsumerSurfaceDrift[];
 }>;
 export declare function registrarSimboloGenerico(simbolos: Map<string, SimboloResolvido>, origem: SimboloResolvido["origem"], basesSimbolicas: string[], arquivo: string, simbolo: string): void;
-export declare function indexarDotnet(diretorios: string[]): Promise<{
+export declare function indexarDotnet(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarJava(diretorios: string[]): Promise<{
+export declare function indexarJava(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarGo(diretorios: string[]): Promise<{
+export declare function indexarGo(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarRust(diretorios: string[]): Promise<{
+export declare function indexarRust(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarCpp(diretorios: string[]): Promise<{
+export declare function indexarCpp(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarPhp(diretorios: string[]): Promise<{
+export declare function indexarPhp(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarLua(diretorios: string[]): Promise<{
+export declare function indexarLua(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     simbolos: SimboloResolvido[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarPersistenciaDeclarativa(diretorios: string[]): Promise<{
+export declare function indexarPersistenciaDeclarativa(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     recursos: RecursoResolvido[];
     simbolos: SimboloResolvido[];
 }>;

package/dist/drift.part07.js

@@ -16,15 +16,16 @@ import { extrairRecursosPersistenciaCodigoVivo, extrairRecursosPrisma, extrairSi
 import { registrarRotasPython, registrarSimboloPython } from "./drift.part06.js";
 import { arquivoEhRotasFlutterConsumer, extrairRotasFlutterConsumer, inferirRotaFlutterConsumer } from "./drift.part05.js";
 import { fecharPrefixoRecurso, limparLiteralRecurso, normalizarNomeRecursoDrift } from "./drift.part02.js";
-export async function indexarPython(diretorios) {
+export async function indexarPython(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".py"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".py"], catalogo))
             .filter((arquivo) => !arquivo.endsWith("__init__.py") && !/tests?[\\/]/i.test(arquivo));
         for (const arquivo of arquivos) {
-            const texto = await readFile(arquivo, "utf8");
+            const texto = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             const prefixo = texto.match(/APIRouter\s*\(\s*prefix\s*=\s*["']([^"']+)["']/)?.[1];
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, texto)) {
@@ -83,16 +84,17 @@ export async function indexarPython(diretorios) {
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarDart(diretorios) {
+export async function indexarDart(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     const consumerSurfaces = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".dart"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".dart"], catalogo))
             .filter((arquivo) => !arquivo.endsWith(".g.dart") && !arquivo.endsWith(".freezed.dart"));
         for (const arquivo of arquivos) {
-            const texto = await readFile(arquivo, "utf8");
+            const texto = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             const relacao = path.relative(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, texto)) {
@@ -173,15 +175,16 @@ export function registrarSimboloGenerico(simbolos, origem, basesSimbolicas, arqu
         }
     }
 }
-export async function indexarDotnet(diretorios) {
+export async function indexarDotnet(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".cs"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".cs"], catalogo))
             .filter((arquivo) => !/(^|[\\/])(bin|obj|Test[s]?)([\\/]|$)/i.test(arquivo));
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
                 registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
@@ -202,15 +205,16 @@ export async function indexarDotnet(diretorios) {
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarJava(diretorios) {
+export async function indexarJava(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".java"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".java"], catalogo))
             .filter((arquivo) => !/(^|[\\/])(target|build|out|Test[s]?)([\\/]|$)/i.test(arquivo));
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
                 registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
@@ -231,14 +235,15 @@ export async function indexarJava(diretorios) {
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarGo(diretorios) {
+export async function indexarGo(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = await listarArquivosRecursivos(diretorio, [".go"]);
+        const arquivos = await listarArquivosRecursivos(diretorio, [".go"], catalogo);
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
                 registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
@@ -259,14 +264,15 @@ export async function indexarGo(diretorios) {
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarRust(diretorios) {
+export async function indexarRust(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = await listarArquivosRecursivos(diretorio, [".rs"]);
+        const arquivos = await listarArquivosRecursivos(diretorio, [".rs"], catalogo);
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
                 registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
@@ -287,14 +293,15 @@ export async function indexarRust(diretorios) {
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarCpp(diretorios) {
+export async function indexarCpp(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".cpp", ".cc", ".cxx", ".hpp", ".h"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".cpp", ".cc", ".cxx", ".hpp", ".h"], catalogo))
             .filter((arquivo) => !/(^|[\\/])(windows|linux|macos|runner|flutter|ephemeral|build|vendor)([\\/]|$)/i.test(arquivo));
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
                 registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
@@ -309,15 +316,16 @@ export async function indexarCpp(diretorios) {
         recursos: [...recursos.values()],
     };
 }
-export async function indexarPhp(diretorios) {
+export async function indexarPhp(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".php"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".php"], catalogo))
             .filter((arquivo) => !/(^|[\\/])(vendor|storage|bootstrap[\\/]cache|cache|tests?)([\\/]|$)/i.test(arquivo));
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
                 registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
@@ -350,14 +358,15 @@ export async function indexarPhp(diretorios) {
         recursos: [...recursos.values()],
     };
 }
-export async function indexarLua(diretorios) {
+export async function indexarLua(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const simbolos = new Map();
     const recursos = new Map();
     for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".lua"]))
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".lua"], catalogo))
             .filter((arquivo) => !/(^|[\\/])(vendor|build|dist|generated|tests?)([\\/]|$)/i.test(arquivo));
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
             for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
                 registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
@@ -372,7 +381,8 @@ export async function indexarLua(diretorios) {
         recursos: [...recursos.values()],
     };
 }
-export async function indexarPersistenciaDeclarativa(diretorios) {
+export async function indexarPersistenciaDeclarativa(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const recursos = new Map();
     const simbolos = new Map();
     for (const diretorio of diretorios) {
@@ -380,9 +390,9 @@ export async function indexarPersistenciaDeclarativa(diretorios) {
             ".sql", ".psql", ".ddl", ".prisma",
             ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs",
             ".py", ".dart", ".lua", ".cs", ".java", ".go", ".rs", ".cpp", ".cc", ".cxx", ".hpp", ".h", ".php",
-        ]);
+        ], catalogo);
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const extracoes = arquivo.endsWith(".prisma")
                 ? extrairRecursosPrisma(arquivo, codigo)
                 : extrairRecursosPersistenciaCodigoVivo(arquivo, codigo);

package/dist/drift.part08.d.ts

@@ -1,5 +1,6 @@
 import type { IrBancoDados, IrModulo, IrTask } from "@sema/nucleo";
 import { OrigemRecursoDrift, RecursoEsperadoDrift, RecursoResolvido, RegistroColunaPersistenciaDrift, RegistroPersistenciaRealDrift, RegistroRepositorioPersistenciaDrift, SimboloResolvido, TipoRecursoDrift } from "./drift.part01.js";
+import type { CatalogoDrift } from "./driftCatalogo.js";
 export declare function registrarRepositorioPersistenciaDrift(repositorios: Map<string, RegistroRepositorioPersistenciaDrift>, origem: OrigemRecursoDrift, recurso: string, arquivo: string): void;
 export declare function extrairColunasSqlDetalhadas(arquivo: string, codigo: string): RegistroColunaPersistenciaDrift[];
 export declare function extrairColunasPrismaDetalhadas(arquivo: string, codigo: string): RegistroColunaPersistenciaDrift[];
@@ -7,7 +8,7 @@ export declare function extrairCamposMongoDetalhados(arquivo: string, codigo: st
 export declare function extrairCamposRedisDetalhados(arquivo: string, codigo: string): RegistroColunaPersistenciaDrift[];
 export declare function extrairCamposArquivoLocalDetalhados(arquivo: string, codigo: string): RegistroColunaPersistenciaDrift[];
 export declare function registrarRepositoriosPorRecursos(repositorios: Map<string, RegistroRepositorioPersistenciaDrift>, arquivo: string, codigo: string, recursos: RecursoResolvido[]): void;
-export declare function indexarPersistenciaDetalhada(diretorios: string[]): Promise<{
+export declare function indexarPersistenciaDetalhada(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
     colunas: RegistroColunaPersistenciaDrift[];
     repositorios: RegistroRepositorioPersistenciaDrift[];
 }>;

package/dist/drift.part08.js

@@ -172,7 +172,8 @@ export function registrarRepositoriosPorRecursos(repositorios, arquivo, codigo,
         registrarRepositorioPersistenciaDrift(repositorios, recurso.origem, recurso.nome, arquivo);
     }
 }
-export async function indexarPersistenciaDetalhada(diretorios) {
+export async function indexarPersistenciaDetalhada(diretorios, catalogo) {
+    catalogo?.emitir("extractor.run");
     const colunas = new Map();
     const repositorios = new Map();
     for (const diretorio of diretorios) {
@@ -180,9 +181,9 @@ export async function indexarPersistenciaDetalhada(diretorios) {
             ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs",
             ".py", ".dart", ".lua", ".cs", ".java", ".go", ".rs", ".cpp", ".cc", ".cxx", ".hpp", ".h", ".php",
             ".sql", ".psql", ".ddl", ".prisma",
-        ]);
+        ], catalogo);
         for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
+            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
             const recursos = arquivo.endsWith(".prisma")
                 ? extrairRecursosPrisma(arquivo, codigo)
                 : extrairRecursosPersistenciaCodigoVivo(arquivo, codigo);