@semacode/cli 2.3.1 → 3.5.0

package/dist/drift.part04.js

@@ -1,11 +1,71 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+// SEMA-GOVERNED: sema.produto.governanca_ia.drift
+// Descricao: compartilha primitivas de indexacao e leitura do drift entre linguagens.
+import { AsyncLocalStorage } from "node:async_hooks";
 import { readdir } from "node:fs/promises";
 import path from "node:path";
 import ts from "typescript";
 import { diretoriosIgnoradosAtivos } from "./drift.part01.js";
 import { escolherArquivoPorVinculo, escolherSimboloPorVinculo } from "./drift.part03.js";
 import { avaliarPontuacaoSemantica, resolverPoliticaPontuacaoSemantica } from "./driftScore.js";
+export function chaveCaminhoCanonicoDrift(caminho) {
+    const resolvido = path.resolve(caminho);
+    return process.platform === "win32" ? resolvido.toLowerCase() : resolvido;
+}
+function caminhoEstaDentroDaRaizDrift(raiz, candidato) {
+    const relativo = path.relative(path.resolve(raiz), path.resolve(candidato));
+    return relativo === "" || (!relativo.startsWith("..") && !path.isAbsolute(relativo));
+}
+const contextoRaizesSobrepostasDrift = new AsyncLocalStorage();
+export function deduplicarRaizesSobrepostasDrift(diretorios) {
+    const unicas = new Map();
+    for (const diretorio of diretorios) {
+        const chave = chaveCaminhoCanonicoDrift(diretorio);
+        if (!unicas.has(chave)) {
+            unicas.set(chave, diretorio);
+        }
+    }
+    const candidatas = [...unicas.values()];
+    const raizesFisicas = candidatas.filter((candidata, indice) => !candidatas.some((outra, outroIndice) => indice !== outroIndice
+        && chaveCaminhoCanonicoDrift(candidata) !== chaveCaminhoCanonicoDrift(outra)
+        && caminhoEstaDentroDaRaizDrift(outra, candidata)));
+    const aliasesPorRaiz = new Map();
+    for (const raizFisica of raizesFisicas) {
+        aliasesPorRaiz.set(chaveCaminhoCanonicoDrift(raizFisica), candidatas.filter((candidata) => chaveCaminhoCanonicoDrift(candidata) !== chaveCaminhoCanonicoDrift(raizFisica)
+            && caminhoEstaDentroDaRaizDrift(raizFisica, candidata)));
+    }
+    contextoRaizesSobrepostasDrift.enterWith(aliasesPorRaiz);
+    return raizesFisicas;
+}
+export function encontrarCandidatosFisicosImplementacaoDrift(simbolos, origem, caminhoDeclarado) {
+    const caminhoNormalizado = caminhoDeclarado.trim().toLowerCase();
+    if (!caminhoNormalizado) {
+        return [];
+    }
+    const mesmaFamilia = (candidato) => candidato.origem === origem
+        || ((origem === "ts" || origem === "js") && (candidato.origem === "ts" || candidato.origem === "js"));
+    const porArquivo = new Map();
+    for (const candidato of simbolos) {
+        const caminhoCandidato = candidato.caminho.toLowerCase();
+        if (!mesmaFamilia(candidato)
+            || (caminhoCandidato !== caminhoNormalizado && !caminhoCandidato.endsWith(`.${caminhoNormalizado}`))) {
+            continue;
+        }
+        const chaveArquivo = chaveCaminhoCanonicoDrift(candidato.arquivo);
+        const anterior = porArquivo.get(chaveArquivo);
+        const candidatoExato = caminhoCandidato === caminhoNormalizado;
+        const anteriorExato = anterior?.caminho.toLowerCase() === caminhoNormalizado;
+        if (!anterior
+            || (candidatoExato && !anteriorExato)
+            || (candidatoExato === anteriorExato
+                && (candidato.caminho.length < anterior.caminho.length
+                    || (candidato.caminho.length === anterior.caminho.length
+                        && candidato.caminho.localeCompare(anterior.caminho, "pt-BR") < 0)))) {
+            porArquivo.set(chaveArquivo, candidato);
+        }
+    }
+    return [...porArquivo.values()].sort((a, b) => a.arquivo.localeCompare(b.arquivo, "pt-BR")
+        || a.caminho.localeCompare(b.caminho, "pt-BR"));
+}
 export function resolverArquivoOuSimboloAncora(vinculos, simbolos, mapaImpl, arquivos) {
     for (const vinculo of vinculos) {
         if (vinculo.simbolo) {
@@ -94,7 +154,34 @@ export function calcularConfiancaTask(task, implsValidos, implsQuebrados, vincul
     }
     return "baixa";
 }
-export function calcularScoreTask(task, implsValidos, implsQuebrados, vinculosValidos, vinculosQuebrados, semImplementacao) {
+export async function carregarEvidenciaVerificacaoDrift(opcoes) {
+    const { readFile } = await import("node:fs/promises");
+    const { calcularChaveVerificacao, carregarManifestoVerificacao } = await import("./verificacaoCache.js");
+    const pacoteCli = (await import("../package.json", { with: { type: "json" } })).default;
+    const conteudoContrato = await readFile(opcoes.caminhoContrato, "utf8").catch(() => "");
+    if (!conteudoContrato) {
+        return undefined;
+    }
+    const chave = calcularChaveVerificacao({
+        versaoCli: pacoteCli.version,
+        versaoNode: process.versions.node ?? "",
+        modulo: opcoes.nomeModulo,
+        alvo: opcoes.alvo,
+        framework: opcoes.framework,
+        estrutura: opcoes.estrutura,
+        conteudoContrato,
+    });
+    const manifesto = await carregarManifestoVerificacao(chave);
+    if (!manifesto) {
+        return undefined;
+    }
+    return {
+        sucesso: manifesto.sucesso,
+        quantidadeTestes: manifesto.quantidadeTestes,
+        alvo: manifesto.alvo,
+    };
+}
+export function calcularScoreTask(task, implsValidos, implsQuebrados, vinculosValidos, vinculosQuebrados, semImplementacao, evidenciaVerificada) {
     let score = 45;
     if (!semImplementacao && task.implementacoesExternas.length > 0) {
         score += 15;
@@ -109,9 +196,12 @@ export function calcularScoreTask(task, implsValidos, implsQuebrados, vinculosVa
     if (task.execucao.explicita) {
         score += 5;
     }
+    if (evidenciaVerificada?.sucesso && evidenciaVerificada.quantidadeTestes > 0) {
+        score += 8;
+    }
     return Math.max(0, Math.min(100, score));
 }
-export function resumirLacunasTask(task, semImplementacao, implsQuebrados, vinculosQuebrados, guardrails) {
+export function resumirLacunasTask(task, semImplementacao, implsQuebrados, vinculosQuebrados, guardrails, evidenciaVerificada) {
     const lacunas = [];
     if (semImplementacao) {
         lacunas.push("sem_impl");
@@ -128,6 +218,9 @@ export function resumirLacunasTask(task, semImplementacao, implsQuebrados, vincu
     if (!task.execucao.explicita) {
         lacunas.push("execucao_implicita");
     }
+    if ((guardrails.publica || guardrails.sensivel) && !semImplementacao && !evidenciaVerificada) {
+        lacunas.push("sem_evidencia_verificada");
+    }
     if (guardrails.publica && !task.execucao.explicita) {
         lacunas.push("superficie_publica_sem_execucao");
     }
@@ -258,9 +351,11 @@ export function juntarCaminhoHttp(base, sufixo) {
     const caminho = `/${partes.join("/")}`.replace(/\/+/g, "/");
     return caminho === "//" ? "/" : caminho;
 }
-export async function listarArquivosRecursivos(diretorio, extensoes, catalogo) {
-    if (catalogo) {
-        return catalogo.listarPorRaiz(diretorio, extensoes);
+export async function listarArquivosRecursivos(diretorio, extensoes, adaptadorLeitura) {
+    if (adaptadorLeitura) {
+        const arquivos = await adaptadorLeitura.listarPorRaiz(diretorio, extensoes);
+        return [...new Map(arquivos.map((arquivo) => [chaveCaminhoCanonicoDrift(arquivo), arquivo])).values()]
+            .sort((a, b) => a.localeCompare(b, "pt-BR"));
     }
     let entradas;
     try {
@@ -294,16 +389,19 @@ export const EXTENSOES_ARQUIVOS_RASTREAVEIS_DRIFT = [
     ".yml", ".yaml", ".toml", ".xml", ".html", ".htm", ".css",
     ".Caddyfile", ".caddyfile",
 ];
-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, catalogo)) {
-            arquivos.add(arquivo);
+export async function indexarArquivosRastreaveis(diretorios, adaptadorLeitura) {
+    const arquivos = new Map();
+    for (const diretorio of deduplicarRaizesSobrepostasDrift(diretorios)) {
+        for (const arquivo of await listarArquivosRecursivos(diretorio, EXTENSOES_ARQUIVOS_RASTREAVEIS_DRIFT, adaptadorLeitura)) {
+            const chave = chaveCaminhoCanonicoDrift(arquivo);
+            if (!arquivos.has(chave)) {
+                arquivos.set(chave, arquivo);
+            }
         }
     }
-    return [...arquivos].sort((a, b) => a.localeCompare(b, "pt-BR"));
+    return [...arquivos.values()].sort((a, b) => a.localeCompare(b, "pt-BR"));
 }
-export function caminhosSimbolicos(baseDiretorio, arquivo) {
+function caminhosSimbolicosParaBaseDrift(baseDiretorio, arquivo) {
     const relativo = path.relative(baseDiretorio, arquivo).replace(/\.[^.]+$/, "");
     const semPrefixo = relativo
         .split(path.sep)
@@ -312,13 +410,19 @@ export function caminhosSimbolicos(baseDiretorio, arquivo) {
         .join(".");
     const prefixo = paraIdentificadorModulo(path.basename(baseDiretorio));
     const comPrefixo = prefixo ? [prefixo, semPrefixo].filter(Boolean).join(".") : semPrefixo;
+    const aliasesBase = [semPrefixo, comPrefixo].filter(Boolean);
     const aliasesIndex = path.basename(relativo) === "index"
-        ? [
-            semPrefixo.replace(/(?:^|\.)index$/, ""),
-            comPrefixo.replace(/(?:^|\.)index$/, ""),
-        ]
+        ? aliasesBase.map((alias) => alias.replace(/(?:^|\.)index$/, ""))
         : [];
-    return [...new Set([semPrefixo, comPrefixo, ...aliasesIndex].filter(Boolean))];
+    return [...new Set([...aliasesBase, ...aliasesIndex].filter(Boolean))];
+}
+export function caminhosSimbolicos(baseDiretorio, arquivo) {
+    const aliasesConfigurados = contextoRaizesSobrepostasDrift.getStore()
+        ?.get(chaveCaminhoCanonicoDrift(baseDiretorio))
+        ?.filter((raiz) => caminhoEstaDentroDaRaizDrift(raiz, arquivo))
+        ?? [];
+    return [...new Set([baseDiretorio, ...aliasesConfigurados]
+            .flatMap((base) => caminhosSimbolicosParaBaseDrift(base, arquivo)))];
 }
 export function registrarSimboloTypeScript(simbolos, basesSimbolicas, arquivo, nome, nomeClasse, origem = "ts") {
     for (const baseSimbolica of basesSimbolicas) {

package/dist/drift.part05.d.ts

@@ -1,6 +1,6 @@
 import ts from "typescript";
 import { RegistroConsumerSurfaceDrift, SimboloResolvido } from "./drift.part01.js";
-import type { CatalogoDrift } from "./driftCatalogo.js";
+import { type AdaptadorLeituraCompartilhadaDrift } from "./drift.part04.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;
@@ -44,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>, catalogo?: CatalogoDrift): Promise<RotaAngularConsumerDrift[]>;
+export declare function extrairRotasAngularConsumer(diretorioBase: string, relacaoArquivo: string, prefixo?: string, visitados?: Set<string>, adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<RotaAngularConsumerDrift[]>;
 export declare function simboloEhBridgeConsumer(caminho: string, arquivo: string): boolean;

package/dist/drift.part05.js

@@ -1,9 +1,9 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+// SEMA-GOVERNED: sema.produto.governanca_ia.drift
+// Descricao: extrai rotas e superficies consumidoras dentro do escopo fisico planejado.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import ts from "typescript";
-import { desembrulharExpressaoTypeScript, extrairNomePropriedadeTypeScript, registrarSimboloTypeScript } from "./drift.part04.js";
+import { desembrulharExpressaoTypeScript, extrairNomePropriedadeTypeScript, registrarSimboloTypeScript, } from "./drift.part04.js";
 export function registrarMetodoTypeScriptProtoOuObjeto(simbolos, basesSimbolicas, arquivo, nomeMetodo, nomeClasse, origem = "ts") {
     if (!nomeMetodo) {
         return;
@@ -318,7 +318,7 @@ export function extrairRotasAngularConsumerDiretas(relacaoArquivo, codigo, prefi
     }
     return rotas;
 }
-export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo, prefixo = "/", visitados = new Set(), catalogo) {
+export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo, prefixo = "/", visitados = new Set(), adaptadorLeitura) {
     const relacaoNormalizada = normalizarRelacaoConsumer(relacaoArquivo);
     if (visitados.has(relacaoNormalizada)) {
         return [];
@@ -327,7 +327,9 @@ export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo,
     let codigo = "";
     try {
         const arquivo = path.join(diretorioBase, relacaoNormalizada);
-        codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
+        codigo = adaptadorLeitura
+            ? await adaptadorLeitura.lerTexto(arquivo)
+            : await readFile(arquivo, "utf8");
     }
     catch {
         return [];
@@ -338,7 +340,7 @@ export async function extrairRotasAngularConsumer(diretorioBase, relacaoArquivo,
         if (!rota.arquivoRotasFilhas) {
             continue;
         }
-        filhas.push(...await extrairRotasAngularConsumer(diretorioBase, rota.arquivoRotasFilhas, rota.rota, visitados, catalogo));
+        filhas.push(...await extrairRotasAngularConsumer(diretorioBase, rota.arquivoRotasFilhas, rota.rota, visitados, adaptadorLeitura));
     }
     return [...rotas, ...filhas];
 }

package/dist/drift.part06.d.ts

@@ -1,9 +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";
+import { type AdaptadorLeituraCompartilhadaDrift } from "./drift.part04.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[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarTypeScript(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];

package/dist/drift.part06.js

@@ -1,12 +1,12 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
+// SEMA-GOVERNED: sema.produto.governanca_ia.drift
+// Descricao: indexa TypeScript com catalogo e AST compartilhados pelo drift.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import ts from "typescript";
 import { coletarSuperficiesAngularStandaloneConsumer } from "./angular-consumer-standalone.js";
 import { extrairRotasTypeScriptHttp } from "./typescript-http.js";
 import { arquivoEhRotasAngularConsumer, arquivoEhRotasAngularConsumerRaiz, arquivoEhRotasReactViteConsumer, arquivoEhSuperficieNextJsConsumer, arquivoEhSuperficieReactViteConsumer, extrairRotasAngularConsumer, extrairRotasReactViteConsumer, inferirRotaNextJsConsumer, inferirRotaReactViteConsumer, normalizarRelacaoConsumer, registrarAtribuicaoPrototypeTypeScript, registrarMetodosObjectAssignTypeScript } from "./drift.part05.js";
-import { caminhosSimbolicos, desembrulharExpressaoTypeScript, extrairNomeClassePrototypeTypeScript, extrairTextoLiteral, juntarCaminhoHttp, lerDecorator, listarArquivosRecursivos, registrarSimboloTypeScript } from "./drift.part04.js";
+import { caminhosSimbolicos, chaveCaminhoCanonicoDrift, deduplicarRaizesSobrepostasDrift, desembrulharExpressaoTypeScript, extrairNomeClassePrototypeTypeScript, extrairTextoLiteral, juntarCaminhoHttp, lerDecorator, listarArquivosRecursivos, registrarSimboloTypeScript, } from "./drift.part04.js";
 import { extrairRecursosPersistenciaCodigoVivo, registrarRecursoDrift } from "./drift.part03.js";
 export function inferirConsumerFrameworkPrincipal(fontesLegado, consumerSurfaces, consumerBridges) {
     const arquivos = [
@@ -38,6 +38,75 @@ export function inferirConsumerFrameworkPrincipal(fontesLegado, consumerSurfaces
     }
     return null;
 }
+function fonteDeclaraRotasReactVite(relacaoArquivo, sourceFile) {
+    if (arquivoEhRotasReactViteConsumer(relacaoArquivo)) {
+        return true;
+    }
+    let encontrouDeclaracao = false;
+    const nomeExpressao = (expressao) => {
+        if (ts.isIdentifier(expressao))
+            return expressao.text;
+        if (ts.isPropertyAccessExpression(expressao))
+            return expressao.name.text;
+        return undefined;
+    };
+    const nomePropriedade = (elemento) => {
+        if (!("name" in elemento) || !elemento.name)
+            return undefined;
+        if (ts.isIdentifier(elemento.name) || ts.isStringLiteralLike(elemento.name)) {
+            return elemento.name.text;
+        }
+        return undefined;
+    };
+    const visitar = (node) => {
+        if (encontrouDeclaracao)
+            return;
+        if (ts.isCallExpression(node)
+            && ["createBrowserRouter", "createRoutesFromElements", "useRoutes"]
+                .includes(nomeExpressao(node.expression) ?? "")) {
+            encontrouDeclaracao = true;
+            return;
+        }
+        if ((ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node))
+            && ["Route", "Routes", "RouterProvider"].includes(nomeExpressao(node.tagName) ?? "")) {
+            encontrouDeclaracao = true;
+            return;
+        }
+        if (ts.isObjectLiteralExpression(node)) {
+            const propriedades = new Set(node.properties.map(nomePropriedade).filter(Boolean));
+            if ((propriedades.has("path") || propriedades.has("index"))
+                && (propriedades.has("element") || propriedades.has("Component"))) {
+                encontrouDeclaracao = true;
+                return;
+            }
+        }
+        ts.forEachChild(node, visitar);
+    };
+    visitar(sourceFile);
+    return encontrouDeclaracao;
+}
+function resolverArquivoConsumerCatalogado(diretorio, caminhoRelativo, arquivosCatalogados) {
+    const normalizado = caminhoRelativo.replace(/\\/g, "/");
+    const semExtensao = normalizado.replace(/\.(?:ts|tsx|js|jsx)$/i, "");
+    const candidatos = [
+        normalizado,
+        `${semExtensao}.ts`,
+        `${semExtensao}.tsx`,
+        `${semExtensao}.js`,
+        `${semExtensao}.jsx`,
+        `${semExtensao}/index.ts`,
+        `${semExtensao}/index.tsx`,
+        `${semExtensao}/index.js`,
+        `${semExtensao}/index.jsx`,
+    ];
+    for (const candidato of candidatos) {
+        const absoluto = path.resolve(diretorio, ...candidato.split("/"));
+        const catalogado = arquivosCatalogados.get(chaveCaminhoCanonicoDrift(absoluto));
+        if (catalogado)
+            return catalogado;
+    }
+    return undefined;
+}
 export function extrairColecoesFirebase(arquivo, codigo) {
     const recursos = new Map();
     const registrar = (nome) => {
@@ -126,27 +195,39 @@ function aplicarReexportacoesTypeScript(simbolos, reexportacoes) {
         }
     }
 }
-export async function indexarTypeScript(diretorios, catalogo) {
-    catalogo?.emitir("extractor.run");
+export async function indexarTypeScript(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.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"], catalogo))
+    const arquivosProcessados = new Set();
+    for (const diretorio of deduplicarRaizesSobrepostasDrift(diretorios)) {
+        const arquivos = (await listarArquivosRecursivos(diretorio, [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs"], adaptadorLeitura))
             .filter((arquivo) => !arquivo.endsWith(".d.ts")
             && !arquivo.endsWith(".spec.ts")
-            && !arquivo.endsWith(".test.ts"));
+            && !arquivo.endsWith(".test.ts"))
+            .filter((arquivo) => {
+            const chave = chaveCaminhoCanonicoDrift(arquivo);
+            if (arquivosProcessados.has(chave)) {
+                return false;
+            }
+            arquivosProcessados.add(chave);
+            return true;
+        });
         const arquivosRotasAngular = arquivos.filter((arquivo) => arquivoEhRotasAngularConsumer(path.relative(diretorio, arquivo)));
         const arquivosRotasAngularRaiz = new Set(arquivosRotasAngular
             .filter((arquivo) => arquivoEhRotasAngularConsumerRaiz(path.relative(diretorio, arquivo)))
             .map((arquivo) => path.resolve(arquivo)));
+        const arquivosCatalogadosRaiz = new Map(arquivos.map((arquivo) => [chaveCaminhoCanonicoDrift(arquivo), arquivo]));
         const usarApenasRotasAngularRaiz = arquivosRotasAngularRaiz.size > 0;
         let encontrouSuperficieAngularPorRotas = false;
         const reexportacoes = [];
         for (const arquivo of arquivos) {
-            const codigo = catalogo ? await catalogo.lerTexto(arquivo) : await readFile(arquivo, "utf8");
+            const codigo = adaptadorLeitura
+                ? await adaptadorLeitura.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
@@ -155,7 +236,7 @@ export async function indexarTypeScript(diretorios, catalogo) {
                     : origemArquivo === "js"
                         ? ts.ScriptKind.JS
                         : ts.ScriptKind.TS;
-            catalogo?.emitir("ast.create", arquivo);
+            adaptadorLeitura?.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);
@@ -206,7 +287,7 @@ export async function indexarTypeScript(diretorios, catalogo) {
                     simbolo: superficieReact.tipoArquivo,
                 });
             }
-            if (arquivoEhRotasReactViteConsumer(relacao, codigo)) {
+            if (fonteDeclaraRotasReactVite(relacao, sourceFile)) {
                 for (const rotaReact of extrairRotasReactViteConsumer(relacao, codigo)) {
                     consumerSurfaces.set(`${rotaReact.rota}:${arquivo}:router`, {
                         rota: rotaReact.rota,
@@ -221,19 +302,23 @@ export async function indexarTypeScript(diretorios, catalogo) {
                         simbolo: "router",
                     });
                     if (rotaReact.arquivoComponente) {
-                        const arquivoComponente = path.join(diretorio, rotaReact.arquivoComponente);
-                        consumerSurfaces.set(`${rotaReact.rota}:${arquivoComponente}:page`, {
-                            rota: rotaReact.rota,
-                            arquivo: arquivoComponente,
-                            tipoArquivo: "page",
-                        });
+                        const arquivoComponente = resolverArquivoConsumerCatalogado(diretorio, rotaReact.arquivoComponente, arquivosCatalogadosRaiz);
+                        if (arquivoComponente) {
+                            consumerSurfaces.set(`${rotaReact.rota}:${arquivoComponente}:page`, {
+                                rota: rotaReact.rota,
+                                arquivo: arquivoComponente,
+                                tipoArquivo: "page",
+                            });
+                        }
                     }
                 }
             }
             if (arquivoEhRotasAngularConsumer(relacao) && (!usarApenasRotasAngularRaiz || arquivosRotasAngularRaiz.has(path.resolve(arquivo)))) {
                 encontrouSuperficieAngularPorRotas = true;
-                for (const rotaAngular of await extrairRotasAngularConsumer(diretorio, relacao, "/", new Set(), catalogo)) {
-                    const arquivoRotasAngular = path.join(diretorio, rotaAngular.arquivoRotas);
+                for (const rotaAngular of await extrairRotasAngularConsumer(diretorio, relacao, "/", new Set(), adaptadorLeitura)) {
+                    const arquivoRotasAngular = resolverArquivoConsumerCatalogado(diretorio, rotaAngular.arquivoRotas, arquivosCatalogadosRaiz);
+                    if (!arquivoRotasAngular)
+                        continue;
                     consumerSurfaces.set(`${rotaAngular.rota}:${arquivoRotasAngular}:routes`, {
                         rota: rotaAngular.rota,
                         arquivo: arquivoRotasAngular,
@@ -247,12 +332,14 @@ export async function indexarTypeScript(diretorios, catalogo) {
                         simbolo: rotaAngular.componente ?? "routes",
                     });
                     if (rotaAngular.arquivoComponente) {
-                        const arquivoComponente = path.join(diretorio, rotaAngular.arquivoComponente);
-                        consumerSurfaces.set(`${rotaAngular.rota}:${arquivoComponente}:component`, {
-                            rota: rotaAngular.rota,
-                            arquivo: arquivoComponente,
-                            tipoArquivo: "component",
-                        });
+                        const arquivoComponente = resolverArquivoConsumerCatalogado(diretorio, rotaAngular.arquivoComponente, arquivosCatalogadosRaiz);
+                        if (arquivoComponente) {
+                            consumerSurfaces.set(`${rotaAngular.rota}:${arquivoComponente}:component`, {
+                                rota: rotaAngular.rota,
+                                arquivo: arquivoComponente,
+                                tipoArquivo: "component",
+                            });
+                        }
                     }
                 }
             }
@@ -332,7 +419,7 @@ export async function indexarTypeScript(diretorios, catalogo) {
             }
         }
         if (!encontrouSuperficieAngularPorRotas) {
-            for (const superficie of await coletarSuperficiesAngularStandaloneConsumer(diretorio, arquivos, catalogo ? (arquivo) => catalogo.lerTexto(arquivo) : undefined, sourceFiles)) {
+            for (const superficie of await coletarSuperficiesAngularStandaloneConsumer(diretorio, arquivos, adaptadorLeitura ? (arquivo) => adaptadorLeitura.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,52 +1,52 @@
 import type { EngineBanco } from "@sema/nucleo";
 import { OrigemRecursoDrift, RecursoResolvido, RegistroColunaPersistenciaDrift, RegistroConsumerSurfaceDrift, RotaResolvida, SimboloResolvido } from "./drift.part01.js";
-import type { CatalogoDrift } from "./driftCatalogo.js";
-export declare function indexarPython(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+import { type AdaptadorLeituraCompartilhadaDrift } from "./drift.part04.js";
+export declare function indexarPython(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarDart(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarDart(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): 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[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarDotnet(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarJava(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarJava(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarGo(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarGo(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarRust(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarRust(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarCpp(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarCpp(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarPhp(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarPhp(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     rotas: RotaResolvida[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarLua(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarLua(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     simbolos: SimboloResolvido[];
     recursos: RecursoResolvido[];
 }>;
-export declare function indexarPersistenciaDeclarativa(diretorios: string[], catalogo?: CatalogoDrift): Promise<{
+export declare function indexarPersistenciaDeclarativa(diretorios: string[], adaptadorLeitura?: AdaptadorLeituraCompartilhadaDrift): Promise<{
     recursos: RecursoResolvido[];
     simbolos: SimboloResolvido[];
 }>;