@semacode/cli 2.3.0 → 3.0.0

package/dist/drift.part07.js

@@ -1,5 +1,5 @@
-// 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 linguagens legadas sem reabrir fontes fora do catalogo do drift.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { extrairSimbolosCpp } from "./cpp-symbols.js";
@@ -11,134 +11,149 @@ import { extrairRotasPhp, extrairSimbolosPhp } from "./php-http.js";
 import { contarIndentacaoPython, extrairRotasFlaskDecoradas } from "./python-http.js";
 import { extrairRotasRust, extrairSimbolosRust } from "./rust-http.js";
 import { categorizarPersistenciaPorOrigem } from "./drift.part01.js";
-import { caminhosSimbolicos, listarArquivosRecursivos } from "./drift.part04.js";
+import { caminhosSimbolicos, chaveCaminhoCanonicoDrift, deduplicarRaizesSobrepostasDrift, listarArquivosRecursivos, } from "./drift.part04.js";
 import { extrairRecursosPersistenciaCodigoVivo, extrairRecursosPrisma, extrairSimbolosSqlDeclarativos, recursoEhIgnorado, registrarRecursoDrift } from "./drift.part03.js";
 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) {
+async function listarArquivosIndexacaoCompartilhada(diretorios, extensoes, adaptadorLeitura) {
+    const arquivos = new Map();
+    for (const diretorio of deduplicarRaizesSobrepostasDrift(diretorios)) {
+        for (const arquivo of await listarArquivosRecursivos(diretorio, extensoes, adaptadorLeitura)) {
+            const chave = chaveCaminhoCanonicoDrift(arquivo);
+            if (!arquivos.has(chave)) {
+                arquivos.set(chave, { diretorio, arquivo });
+            }
+        }
+    }
+    return [...arquivos.values()];
+}
+async function lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura) {
+    return adaptadorLeitura
+        ? adaptadorLeitura.lerTexto(arquivo)
+        : readFile(arquivo, "utf8");
+}
+export async function indexarPython(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".py"]))
-            .filter((arquivo) => !arquivo.endsWith("__init__.py") && !/tests?[\\/]/i.test(arquivo));
-        for (const arquivo of arquivos) {
-            const texto = 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)) {
-                registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+    const arquivos = (await listarArquivosIndexacaoCompartilhada(diretorios, [".py"], adaptadorLeitura))
+        .filter(({ arquivo }) => !arquivo.endsWith("__init__.py") && !/tests?[\\/]/i.test(arquivo));
+    for (const { diretorio, arquivo } of arquivos) {
+        const texto = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        const prefixo = texto.match(/APIRouter\s*\(\s*prefix\s*=\s*["']([^"']+)["']/)?.[1];
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, texto)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const rota of extrairRotasFlaskDecoradas(texto)) {
+            rotas.push({
+                origem: "flask",
+                metodo: rota.metodo,
+                caminho: rota.caminho,
+                arquivo,
+                simbolo: rota.nomeFuncao,
+            });
+        }
+        const blocos = [];
+        let decoratorsPendentes = [];
+        for (const linha of texto.split(/\r?\n/)) {
+            const trim = linha.trim();
+            if (trim === "" || trim.startsWith("#")) {
+                decoratorsPendentes = [];
+                continue;
             }
-            for (const rota of extrairRotasFlaskDecoradas(texto)) {
-                rotas.push({
-                    origem: "flask",
-                    metodo: rota.metodo,
-                    caminho: rota.caminho,
-                    arquivo,
-                    simbolo: rota.nomeFuncao,
-                });
+            const indentacao = contarIndentacaoPython(linha);
+            while (blocos.length > 0 && indentacao <= blocos[blocos.length - 1].indentacao) {
+                blocos.pop();
             }
-            const blocos = [];
-            let decoratorsPendentes = [];
-            for (const linha of texto.split(/\r?\n/)) {
-                const trim = linha.trim();
-                if (trim === "" || trim.startsWith("#")) {
-                    decoratorsPendentes = [];
-                    continue;
-                }
-                const indentacao = contarIndentacaoPython(linha);
-                while (blocos.length > 0 && indentacao <= blocos[blocos.length - 1].indentacao) {
-                    blocos.pop();
-                }
-                if (trim.startsWith("@")) {
-                    decoratorsPendentes.push(trim);
-                    continue;
-                }
-                const classe = trim.match(/^class\s+([A-Za-z_]\w*)(?:\([^)]*\))?:\s*(?:#.*)?$/);
-                if (classe) {
-                    blocos.push({ tipo: "class", nome: classe[1], indentacao });
-                    decoratorsPendentes = [];
-                    continue;
+            if (trim.startsWith("@")) {
+                decoratorsPendentes.push(trim);
+                continue;
+            }
+            const classe = trim.match(/^class\s+([A-Za-z_]\w*)(?:\([^)]*\))?:\s*(?:#.*)?$/);
+            if (classe) {
+                blocos.push({ tipo: "class", nome: classe[1], indentacao });
+                decoratorsPendentes = [];
+                continue;
+            }
+            const definicao = trim.match(/^(?:async\s+def|def)\s+([A-Za-z_]\w*)\s*\(/);
+            if (definicao) {
+                const nomeFuncao = definicao[1];
+                const existeDefPai = blocos.some((bloco) => bloco.tipo === "def");
+                const classeAtual = [...blocos].reverse().find((bloco) => bloco.tipo === "class");
+                if (!existeDefPai && classeAtual) {
+                    registrarSimboloPython(simbolos, basesSimbolicas, arquivo, nomeFuncao, classeAtual.nome);
                 }
-                const definicao = trim.match(/^(?:async\s+def|def)\s+([A-Za-z_]\w*)\s*\(/);
-                if (definicao) {
-                    const nomeFuncao = definicao[1];
-                    const existeDefPai = blocos.some((bloco) => bloco.tipo === "def");
-                    const classeAtual = [...blocos].reverse().find((bloco) => bloco.tipo === "class");
-                    if (!existeDefPai && classeAtual) {
-                        registrarSimboloPython(simbolos, basesSimbolicas, arquivo, nomeFuncao, classeAtual.nome);
-                    }
-                    else if (!existeDefPai) {
-                        registrarSimboloPython(simbolos, basesSimbolicas, arquivo, nomeFuncao);
-                        registrarRotasPython(rotas, decoratorsPendentes, prefixo, arquivo, nomeFuncao);
-                    }
-                    blocos.push({ tipo: "def", nome: nomeFuncao, indentacao });
-                    decoratorsPendentes = [];
-                    continue;
+                else if (!existeDefPai) {
+                    registrarSimboloPython(simbolos, basesSimbolicas, arquivo, nomeFuncao);
+                    registrarRotasPython(rotas, decoratorsPendentes, prefixo, arquivo, nomeFuncao);
                 }
+                blocos.push({ tipo: "def", nome: nomeFuncao, indentacao });
                 decoratorsPendentes = [];
+                continue;
             }
+            decoratorsPendentes = [];
         }
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarDart(diretorios) {
+export async function indexarDart(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.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"]))
-            .filter((arquivo) => !arquivo.endsWith(".g.dart") && !arquivo.endsWith(".freezed.dart"));
-        for (const arquivo of arquivos) {
-            const texto = await readFile(arquivo, "utf8");
-            const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
-            const relacao = path.relative(diretorio, arquivo);
-            for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, texto)) {
-                registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+    const arquivos = (await listarArquivosIndexacaoCompartilhada(diretorios, [".dart"], adaptadorLeitura))
+        .filter(({ arquivo }) => !arquivo.endsWith(".g.dart") && !arquivo.endsWith(".freezed.dart"));
+    for (const { diretorio, arquivo } of arquivos) {
+        const texto = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        const relacao = path.relative(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, texto)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const match of texto.matchAll(/(?:Future<[^\n]+>|[\w?<>.,\s]+)\s+(\w+)\(([^)]*)\)\s*(?:async\s*)?\{/g)) {
+            const nome = match[1];
+            if (["build", "toString"].includes(nome)) {
+                continue;
             }
-            for (const match of texto.matchAll(/(?:Future<[^\n]+>|[\w?<>.,\s]+)\s+(\w+)\(([^)]*)\)\s*(?:async\s*)?\{/g)) {
-                const nome = match[1];
-                if (["build", "toString"].includes(nome)) {
-                    continue;
-                }
-                for (const baseSimbolica of basesSimbolicas) {
-                    const caminho = `${baseSimbolica}.${nome}`;
-                    simbolos.set(caminho, { origem: "dart", caminho, arquivo, simbolo: nome });
-                }
+            for (const baseSimbolica of basesSimbolicas) {
+                const caminho = `${baseSimbolica}.${nome}`;
+                simbolos.set(caminho, { origem: "dart", caminho, arquivo, simbolo: nome });
             }
-            const superficieFlutter = inferirRotaFlutterConsumer(relacao);
-            if (superficieFlutter) {
-                consumerSurfaces.set(`${superficieFlutter.rota}:${arquivo}:${superficieFlutter.tipoArquivo}`, {
-                    rota: superficieFlutter.rota,
+        }
+        const superficieFlutter = inferirRotaFlutterConsumer(relacao);
+        if (superficieFlutter) {
+            consumerSurfaces.set(`${superficieFlutter.rota}:${arquivo}:${superficieFlutter.tipoArquivo}`, {
+                rota: superficieFlutter.rota,
+                arquivo,
+                tipoArquivo: superficieFlutter.tipoArquivo,
+            });
+            rotas.push({
+                origem: "flutter-consumer",
+                metodo: "VIEW",
+                caminho: superficieFlutter.rota,
+                arquivo,
+                simbolo: superficieFlutter.tipoArquivo,
+            });
+        }
+        if (arquivoEhRotasFlutterConsumer(relacao, texto)) {
+            for (const rotaFlutter of extrairRotasFlutterConsumer(relacao, texto)) {
+                consumerSurfaces.set(`${rotaFlutter.rota}:${arquivo}:router`, {
+                    rota: rotaFlutter.rota,
                     arquivo,
-                    tipoArquivo: superficieFlutter.tipoArquivo,
+                    tipoArquivo: "router",
                 });
                 rotas.push({
                     origem: "flutter-consumer",
                     metodo: "VIEW",
-                    caminho: superficieFlutter.rota,
+                    caminho: rotaFlutter.rota,
                     arquivo,
-                    simbolo: superficieFlutter.tipoArquivo,
+                    simbolo: "router",
                 });
             }
-            if (arquivoEhRotasFlutterConsumer(relacao, texto)) {
-                for (const rotaFlutter of extrairRotasFlutterConsumer(relacao, texto)) {
-                    consumerSurfaces.set(`${rotaFlutter.rota}:${arquivo}:router`, {
-                        rota: rotaFlutter.rota,
-                        arquivo,
-                        tipoArquivo: "router",
-                    });
-                    rotas.push({
-                        origem: "flutter-consumer",
-                        metodo: "VIEW",
-                        caminho: rotaFlutter.rota,
-                        arquivo,
-                        simbolo: "router",
-                    });
-                }
-            }
         }
     }
     return {
@@ -173,135 +188,129 @@ export function registrarSimboloGenerico(simbolos, origem, basesSimbolicas, arqu
         }
     }
 }
-export async function indexarDotnet(diretorios) {
+export async function indexarDotnet(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".cs"]))
-            .filter((arquivo) => !/(^|[\\/])(bin|obj|Test[s]?)([\\/]|$)/i.test(arquivo));
-        for (const arquivo of arquivos) {
-            const codigo = 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);
-            }
-            for (const simbolo of extrairSimbolosDotnet(codigo)) {
-                registrarSimboloGenerico(simbolos, "cs", basesSimbolicas, arquivo, simbolo.simbolo);
-            }
-            for (const rota of extrairRotasDotnet(codigo)) {
-                rotas.push({
-                    origem: "dotnet",
-                    metodo: rota.metodo,
-                    caminho: rota.caminho,
-                    arquivo,
-                    simbolo: rota.simbolo,
-                });
-            }
+    const arquivos = (await listarArquivosIndexacaoCompartilhada(diretorios, [".cs"], adaptadorLeitura))
+        .filter(({ arquivo }) => !/(^|[\\/])(bin|obj|Test[s]?)([\\/]|$)/i.test(arquivo));
+    for (const { diretorio, arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosDotnet(codigo)) {
+            registrarSimboloGenerico(simbolos, "cs", basesSimbolicas, arquivo, simbolo.simbolo);
+        }
+        for (const rota of extrairRotasDotnet(codigo)) {
+            rotas.push({
+                origem: "dotnet",
+                metodo: rota.metodo,
+                caminho: rota.caminho,
+                arquivo,
+                simbolo: rota.simbolo,
+            });
         }
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarJava(diretorios) {
+export async function indexarJava(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".java"]))
-            .filter((arquivo) => !/(^|[\\/])(target|build|out|Test[s]?)([\\/]|$)/i.test(arquivo));
-        for (const arquivo of arquivos) {
-            const codigo = 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);
-            }
-            for (const simbolo of extrairSimbolosJava(codigo)) {
-                registrarSimboloGenerico(simbolos, "java", basesSimbolicas, arquivo, simbolo.simbolo);
-            }
-            for (const rota of extrairRotasJava(codigo)) {
-                rotas.push({
-                    origem: "java",
-                    metodo: rota.metodo,
-                    caminho: rota.caminho,
-                    arquivo,
-                    simbolo: rota.simbolo,
-                });
-            }
+    const arquivos = (await listarArquivosIndexacaoCompartilhada(diretorios, [".java"], adaptadorLeitura))
+        .filter(({ arquivo }) => !/(^|[\\/])(target|build|out|Test[s]?)([\\/]|$)/i.test(arquivo));
+    for (const { diretorio, arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosJava(codigo)) {
+            registrarSimboloGenerico(simbolos, "java", basesSimbolicas, arquivo, simbolo.simbolo);
+        }
+        for (const rota of extrairRotasJava(codigo)) {
+            rotas.push({
+                origem: "java",
+                metodo: rota.metodo,
+                caminho: rota.caminho,
+                arquivo,
+                simbolo: rota.simbolo,
+            });
         }
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarGo(diretorios) {
+export async function indexarGo(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = await listarArquivosRecursivos(diretorio, [".go"]);
-        for (const arquivo of arquivos) {
-            const codigo = 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);
-            }
-            for (const simbolo of extrairSimbolosGo(codigo)) {
-                registrarSimboloGenerico(simbolos, "go", basesSimbolicas, arquivo, simbolo.simbolo);
-            }
-            for (const rota of extrairRotasGo(codigo)) {
-                rotas.push({
-                    origem: "go",
-                    metodo: rota.metodo,
-                    caminho: rota.caminho,
-                    arquivo,
-                    simbolo: rota.simbolo,
-                });
-            }
+    const arquivos = await listarArquivosIndexacaoCompartilhada(diretorios, [".go"], adaptadorLeitura);
+    for (const { diretorio, arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosGo(codigo)) {
+            registrarSimboloGenerico(simbolos, "go", basesSimbolicas, arquivo, simbolo.simbolo);
+        }
+        for (const rota of extrairRotasGo(codigo)) {
+            rotas.push({
+                origem: "go",
+                metodo: rota.metodo,
+                caminho: rota.caminho,
+                arquivo,
+                simbolo: rota.simbolo,
+            });
         }
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarRust(diretorios) {
+export async function indexarRust(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = await listarArquivosRecursivos(diretorio, [".rs"]);
-        for (const arquivo of arquivos) {
-            const codigo = 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);
-            }
-            for (const simbolo of extrairSimbolosRust(codigo)) {
-                registrarSimboloGenerico(simbolos, "rust", basesSimbolicas, arquivo, simbolo.simbolo);
-            }
-            for (const rota of extrairRotasRust(codigo)) {
-                rotas.push({
-                    origem: "rust",
-                    metodo: rota.metodo,
-                    caminho: rota.caminho,
-                    arquivo,
-                    simbolo: rota.simbolo,
-                });
-            }
+    const arquivos = await listarArquivosIndexacaoCompartilhada(diretorios, [".rs"], adaptadorLeitura);
+    for (const { diretorio, arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosRust(codigo)) {
+            registrarSimboloGenerico(simbolos, "rust", basesSimbolicas, arquivo, simbolo.simbolo);
+        }
+        for (const rota of extrairRotasRust(codigo)) {
+            rotas.push({
+                origem: "rust",
+                metodo: rota.metodo,
+                caminho: rota.caminho,
+                arquivo,
+                simbolo: rota.simbolo,
+            });
         }
     }
     return { simbolos: [...simbolos.values()], rotas, recursos: [...recursos.values()] };
 }
-export async function indexarCpp(diretorios) {
+export async function indexarCpp(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.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"]))
-            .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 basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
-            for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
-                registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
-            }
-            for (const simbolo of extrairSimbolosCpp(codigo)) {
-                registrarSimboloGenerico(simbolos, "cpp", basesSimbolicas, arquivo, simbolo.simbolo);
-            }
+    const arquivos = (await listarArquivosIndexacaoCompartilhada(diretorios, [".cpp", ".cc", ".cxx", ".hpp", ".h"], adaptadorLeitura)).filter(({ arquivo }) => !/(^|[\\/])(windows|linux|macos|runner|flutter|ephemeral|build|vendor)([\\/]|$)/i.test(arquivo));
+    for (const { diretorio, arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosCpp(codigo)) {
+            registrarSimboloGenerico(simbolos, "cpp", basesSimbolicas, arquivo, simbolo.simbolo);
         }
     }
     return {
@@ -309,40 +318,39 @@ export async function indexarCpp(diretorios) {
         recursos: [...recursos.values()],
     };
 }
-export async function indexarPhp(diretorios) {
+export async function indexarPhp(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const simbolos = new Map();
     const rotas = [];
     const recursos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".php"]))
-            .filter((arquivo) => !/(^|[\\/])(vendor|storage|bootstrap[\\/]cache|cache|tests?)([\\/]|$)/i.test(arquivo));
-        for (const arquivo of arquivos) {
-            const codigo = 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);
-            }
-            for (const simbolo of extrairSimbolosPhp(codigo)) {
-                registrarSimboloGenerico(simbolos, "php", basesSimbolicas, arquivo, simbolo.simbolo);
-                for (const alias of simbolo.aliases ?? []) {
-                    simbolos.set(alias, {
-                        origem: "php",
-                        caminho: alias,
-                        arquivo,
-                        simbolo: simbolo.simbolo,
-                    });
-                }
-            }
-            for (const rota of extrairRotasPhp(codigo)) {
-                rotas.push({
+    const arquivos = (await listarArquivosIndexacaoCompartilhada(diretorios, [".php"], adaptadorLeitura))
+        .filter(({ arquivo }) => !/(^|[\\/])(vendor|storage|bootstrap[\\/]cache|cache|tests?)([\\/]|$)/i.test(arquivo));
+    for (const { diretorio, arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosPhp(codigo)) {
+            registrarSimboloGenerico(simbolos, "php", basesSimbolicas, arquivo, simbolo.simbolo);
+            for (const alias of simbolo.aliases ?? []) {
+                simbolos.set(alias, {
                     origem: "php",
-                    metodo: rota.metodo,
-                    caminho: rota.caminho,
+                    caminho: alias,
                     arquivo,
-                    simbolo: rota.simbolo,
+                    simbolo: simbolo.simbolo,
                 });
             }
         }
+        for (const rota of extrairRotasPhp(codigo)) {
+            rotas.push({
+                origem: "php",
+                metodo: rota.metodo,
+                caminho: rota.caminho,
+                arquivo,
+                simbolo: rota.simbolo,
+            });
+        }
     }
     return {
         simbolos: [...simbolos.values()],
@@ -350,21 +358,20 @@ export async function indexarPhp(diretorios) {
         recursos: [...recursos.values()],
     };
 }
-export async function indexarLua(diretorios) {
+export async function indexarLua(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const simbolos = new Map();
     const recursos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = (await listarArquivosRecursivos(diretorio, [".lua"]))
-            .filter((arquivo) => !/(^|[\\/])(vendor|build|dist|generated|tests?)([\\/]|$)/i.test(arquivo));
-        for (const arquivo of arquivos) {
-            const codigo = 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);
-            }
-            for (const simbolo of extrairSimbolosLua(codigo)) {
-                registrarSimboloGenerico(simbolos, "lua", basesSimbolicas, arquivo, simbolo.simbolo);
-            }
+    const arquivos = (await listarArquivosIndexacaoCompartilhada(diretorios, [".lua"], adaptadorLeitura))
+        .filter(({ arquivo }) => !/(^|[\\/])(vendor|build|dist|generated|tests?)([\\/]|$)/i.test(arquivo));
+    for (const { diretorio, arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const basesSimbolicas = caminhosSimbolicos(diretorio, arquivo);
+        for (const recurso of extrairRecursosPersistenciaCodigoVivo(arquivo, codigo)) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosLua(codigo)) {
+            registrarSimboloGenerico(simbolos, "lua", basesSimbolicas, arquivo, simbolo.simbolo);
         }
     }
     return {
@@ -372,26 +379,25 @@ export async function indexarLua(diretorios) {
         recursos: [...recursos.values()],
     };
 }
-export async function indexarPersistenciaDeclarativa(diretorios) {
+export async function indexarPersistenciaDeclarativa(diretorios, adaptadorLeitura) {
+    adaptadorLeitura?.emitir?.("extractor.run");
     const recursos = new Map();
     const simbolos = new Map();
-    for (const diretorio of diretorios) {
-        const arquivos = await listarArquivosRecursivos(diretorio, [
-            ".sql", ".psql", ".ddl", ".prisma",
-            ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs",
-            ".py", ".dart", ".lua", ".cs", ".java", ".go", ".rs", ".cpp", ".cc", ".cxx", ".hpp", ".h", ".php",
-        ]);
-        for (const arquivo of arquivos) {
-            const codigo = await readFile(arquivo, "utf8");
-            const extracoes = arquivo.endsWith(".prisma")
-                ? extrairRecursosPrisma(arquivo, codigo)
-                : extrairRecursosPersistenciaCodigoVivo(arquivo, codigo);
-            for (const recurso of extracoes) {
-                registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
-            }
-            for (const simbolo of extrairSimbolosSqlDeclarativos(arquivo, codigo)) {
-                simbolos.set(`${simbolo.caminho}:${simbolo.arquivo}`, simbolo);
-            }
+    const arquivos = await listarArquivosIndexacaoCompartilhada(diretorios, [
+        ".sql", ".psql", ".ddl", ".prisma",
+        ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs",
+        ".py", ".dart", ".lua", ".cs", ".java", ".go", ".rs", ".cpp", ".cc", ".cxx", ".hpp", ".h", ".php",
+    ], adaptadorLeitura);
+    for (const { arquivo } of arquivos) {
+        const codigo = await lerTextoIndexacaoCompartilhada(arquivo, adaptadorLeitura);
+        const extracoes = arquivo.endsWith(".prisma")
+            ? extrairRecursosPrisma(arquivo, codigo)
+            : extrairRecursosPersistenciaCodigoVivo(arquivo, codigo);
+        for (const recurso of extracoes) {
+            registrarRecursoDrift(recursos, recurso.origem, recurso.tipo, recurso.nome, recurso.arquivo, recurso.simbolo);
+        }
+        for (const simbolo of extrairSimbolosSqlDeclarativos(arquivo, codigo)) {
+            simbolos.set(`${simbolo.caminho}:${simbolo.arquivo}`, simbolo);
         }
     }
     return { recursos: [...recursos.values()], simbolos: [...simbolos.values()] };