@semacode/cli 2.3.1 → 3.5.0

package/dist/index.part02.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.governanca_ia_contexto, sema.produto.governanca_ia.drift.cache.modos
+// Descrição: tipa contexto e evidência de drift opcional sem fabricar métricas.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO, LIMITE_AVISO_LINHAS_CONTRATO_SEMA, LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO, LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA, } from "./driftOrcamento.js";
@@ -27,8 +27,13 @@ export function descreverFazModulo(ir, modulo) {
 }
 export function coletarResumoSemanticoModulo(contexto) {
     const { arquivo, modulo, geradoEm, ir, briefing, drift } = contexto;
-    const modoVerificacaoCodigo = contexto.modoVerificacaoCodigo ?? "codigo_completo";
-    const fontesConclusao = contexto.fontesConclusao ?? ["contrato", "codigo"];
+    const driftExecutado = drift.executada && drift.resumo !== null && drift.drift !== null;
+    const modoVerificacaoCodigo = driftExecutado
+        ? (contexto.modoVerificacaoCodigo ?? "codigo_completo")
+        : "contratos_apenas";
+    const fontesConclusao = driftExecutado
+        ? (contexto.fontesConclusao ?? ["contrato", "codigo"])
+        : ["contrato"];
     const tarefas = ir?.tasks ?? [];
     const rotas = ir?.routes ?? [];
     const superficies = ir?.superficies ?? [];
@@ -58,7 +63,7 @@ export function coletarResumoSemanticoModulo(contexto) {
         modulo,
         modoVerificacaoCodigo,
         avisoVerificacaoCodigo: modoVerificacaoCodigo === "contratos_apenas"
-            ? "Somente contratos foram enviados; implementacao nao foi verificada neste modo."
+            ? "Somente contratos foram analisados; a implementação não foi verificada neste modo."
             : modoVerificacaoCodigo === "codigo_selecionado"
                 ? "Codigo selecionado foi enviado; conclusoes de implementacao valem apenas para os arquivos do snapshot."
                 : null,
@@ -66,7 +71,7 @@ export function coletarResumoSemanticoModulo(contexto) {
         perfilCompatibilidade: ir?.perfilCompatibilidade ?? briefing.perfilCompatibilidade,
         scoreSemantico: briefing.scoreSemantico,
         confiancaGeral: briefing.confiancaGeral,
-        riscoOperacional: calcularRiscoOperacionalResumo(drift.resumo),
+        riscoOperacional: drift.resumo ? calcularRiscoOperacionalResumo(drift.resumo) : "nao_avaliado",
         faz: descreverFazModulo(ir, modulo),
         tarefasPrincipais: limitarLista(tarefas.map((task) => task.nome), 6),
         entradasChave: limitarLista(tarefas.map((task) => resumirCamposTask(task, "input", 4)), 4),
@@ -86,8 +91,8 @@ export function coletarResumoSemanticoModulo(contexto) {
         inferido: limitarLista(unicosOrdenados(briefing.oQueFoiInferido), 6),
         checksSugeridos: limitarLista(unicosOrdenados(briefing.oQueValidar), 6),
         testesMinimos: limitarLista(unicosOrdenados(briefing.testesMinimos), 6),
-        consumerFramework: briefing.consumerFramework ?? drift.drift.consumerFramework ?? null,
-        appRoutes: limitarLista(unicosOrdenados(briefing.appRoutes ?? drift.drift.appRoutes ?? []), 8),
+        consumerFramework: briefing.consumerFramework ?? drift.drift?.consumerFramework ?? null,
+        appRoutes: limitarLista(unicosOrdenados(briefing.appRoutes ?? drift.drift?.appRoutes ?? []), 8),
         consumerSurfaces: limitarLista(unicosOrdenados(briefing.consumerSurfaces ?? []), 8),
         consumerBridges: limitarLista(unicosOrdenados(briefing.consumerBridges ?? []), 8),
         ancoragensVinculo: limitarLista(unicosOrdenados(briefing.ancoragensVinculo ?? []), 8),
@@ -116,6 +121,10 @@ export function normalizarResumoModoContratosApenas(resumo) {
         .filter((check) => !/drift|vinculo/i.test(check));
     return {
         ...resumo,
+        appRoutes: modoContratosApenas ? null : resumo.appRoutes,
+        consumerSurfaces: modoContratosApenas ? null : resumo.consumerSurfaces,
+        consumerBridges: modoContratosApenas ? null : resumo.consumerBridges,
+        ancoragensVinculo: modoContratosApenas ? null : resumo.ancoragensVinculo,
         riscosPrincipais: limitarLista(unicosOrdenados([
             ...riscosPrincipais,
             ...(riscosCodigo || lacunasCodigo ? ["codigo_nao_verificado_neste_modo"] : []),
@@ -177,6 +186,8 @@ export function descreverFontesConclusao(fontes, modo) {
 }
 export function renderizarResumoModuloTexto(resumo, tamanho, modo) {
     const limite = tamanho === "micro" ? 2 : tamanho === "curto" ? 4 : 6;
+    const consumerAvaliado = resumo.modoVerificacaoCodigo !== "contratos_apenas";
+    const resumirEvidenciaLista = (itens) => itens === null ? "não avaliado" : resumirListaTexto(itens, limite);
     const linhas = [
         `MODO: ${modo}`,
         `MODULO: ${resumo.modulo}`,
@@ -185,11 +196,11 @@ export function renderizarResumoModuloTexto(resumo, tamanho, modo) {
         `MODO_CODIGO: ${resumo.modoVerificacaoCodigo}`,
         ...(resumo.avisoVerificacaoCodigo ? [`AVISO_CODIGO: ${resumo.avisoVerificacaoCodigo}`] : []),
         `FONTES_CONCLUSAO: ${resumirListaTexto(resumo.fontesConclusao, limite)}`,
-        `CONSUMER_FRAMEWORK: ${resumo.consumerFramework ?? "nenhum"}`,
-        `APP_ROUTES: ${resumirListaTexto(resumo.appRoutes, limite)}`,
-        `CONSUMER_SURFACES: ${resumirListaTexto(resumo.consumerSurfaces, limite)}`,
-        `CONSUMER_BRIDGES: ${resumirListaTexto(resumo.consumerBridges, limite)}`,
-        `ANCORAGEM_VINCULO: ${resumirListaTexto(resumo.ancoragensVinculo, limite)}`,
+        `CONSUMER_FRAMEWORK: ${resumo.consumerFramework ?? (consumerAvaliado ? "nenhum" : "não avaliado")}`,
+        `APP_ROUTES: ${resumirEvidenciaLista(resumo.appRoutes)}`,
+        `CONSUMER_SURFACES: ${resumirEvidenciaLista(resumo.consumerSurfaces)}`,
+        `CONSUMER_BRIDGES: ${resumirEvidenciaLista(resumo.consumerBridges)}`,
+        `ANCORAGEM_VINCULO: ${resumirEvidenciaLista(resumo.ancoragensVinculo)}`,
         `PUBLICO: ${resumirListaTexto(resumo.superficiesPublicas, limite)}`,
         `TAREFAS: ${resumirListaTexto(resumo.tarefasPrincipais, limite)}`,
         `ENTRADAS: ${resumirListaTexto(resumo.entradasChave, limite)}`,
@@ -203,9 +214,9 @@ export function renderizarResumoModuloTexto(resumo, tamanho, modo) {
         `RISCOS: ${resumirListaTexto(resumo.riscosPrincipais, limite)}`,
         `LACUNAS: ${resumirListaTexto(resumo.lacunas, limite)}`,
         `INFERIDO: ${resumirListaTexto(resumo.inferido, limite)}`,
-        `CONFIANCA: ${resumo.confiancaGeral}`,
+        `CONFIANCA: ${resumo.confiancaGeral ?? "não avaliada"}`,
         `RISCO_OPERACIONAL: ${resumo.riscoOperacional}`,
-        `SCORE: ${resumo.scoreSemantico}`,
+        `SCORE: ${resumo.scoreSemantico ?? "não avaliado"}`,
         `GERADO_EM: ${resumo.geradoEm}`,
     ];
     if (tamanho === "micro") {
@@ -214,6 +225,9 @@ export function renderizarResumoModuloTexto(resumo, tamanho, modo) {
     return `${linhas.join("\n")}\n`;
 }
 export function renderizarResumoModuloMarkdown(resumo, modo, guiaPorCapacidade) {
+    const consumerAvaliado = resumo.modoVerificacaoCodigo !== "contratos_apenas";
+    const resumirEvidenciaLista = (itens) => itens === null ? "não avaliado" : resumirListaTexto(itens, 6);
+    const exibirConsumer = resumo.consumerFramework !== null || resumo.appRoutes === null;
     const linhas = [
         `# Resumo Sema para ${resumo.modulo}`,
         "",
@@ -224,8 +238,8 @@ export function renderizarResumoModuloMarkdown(resumo, modo, guiaPorCapacidade)
         `- Modo de codigo: \`${resumo.modoVerificacaoCodigo}\``,
         ...(resumo.avisoVerificacaoCodigo ? [`- Aviso de codigo: ${resumo.avisoVerificacaoCodigo}`] : []),
         `- Fontes de conclusao: ${resumirListaTexto(resumo.fontesConclusao, 6)}`,
-        `- Score: \`${resumo.scoreSemantico}\``,
-        `- Confianca: \`${resumo.confiancaGeral}\``,
+        `- Score: \`${resumo.scoreSemantico ?? "não avaliado"}\``,
+        `- Confiança: \`${resumo.confiancaGeral ?? "não avaliada"}\``,
         `- Risco operacional: \`${resumo.riscoOperacional}\``,
         "",
         "## O que este modulo faz",
@@ -243,14 +257,14 @@ export function renderizarResumoModuloMarkdown(resumo, modo, guiaPorCapacidade)
         `- Erros: ${resumirListaTexto(resumo.erros, 6)}`,
         `- Entidades afetadas: ${resumirListaTexto(resumo.entidadesAfetadas, 6)}`,
         "",
-        ...(resumo.consumerFramework
+        ...(exibirConsumer
             ? [
                 "## Consumer IA-first",
                 "",
-                `- Framework consumer: ${resumo.consumerFramework}`,
-                `- Rotas de app: ${resumirListaTexto(resumo.appRoutes, 6)}`,
-                `- Superficies consumer: ${resumirListaTexto(resumo.consumerSurfaces, 6)}`,
-                `- Bridges consumer: ${resumirListaTexto(resumo.consumerBridges, 6)}`,
+                `- Framework consumer: ${resumo.consumerFramework ?? (consumerAvaliado ? "nenhum" : "não avaliado")}`,
+                `- Rotas de app: ${resumirEvidenciaLista(resumo.appRoutes)}`,
+                `- Superficies consumer: ${resumirEvidenciaLista(resumo.consumerSurfaces)}`,
+                `- Bridges consumer: ${resumirEvidenciaLista(resumo.consumerBridges)}`,
                 "",
             ]
             : []),

package/dist/index.part03.d.ts

@@ -1,7 +1,8 @@
 import { type IrModulo } from "@sema/nucleo";
 import { analisarDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { PacoteContextoModuloIa, ResumoSemanticoModuloIa, type ModoAnaliseDriftCli } from "./index.part01.js";
+import { PacoteContextoModuloIa, ResumoSemanticoModuloIa } from "./index.part01.js";
+import type { ResolucaoModoCacheDrift } from "./driftCacheModes.js";
 export declare function renderizarResumoProjetoMarkdown(geradoEm: string, modulos: ResumoSemanticoModuloIa[], guiaPorCapacidade: GuiaCapacidadeIaMap): string;
 export declare function falharContextoIa(mensagem: string): never;
 export declare function garantirArquivoSema(caminhoArquivo: string): void;
@@ -52,7 +53,28 @@ export declare function criarBriefingAgente(arquivo: string, modulo: string, ir:
     ancoragensVinculo: string[];
     testesMinimos: string[];
 };
-export declare function carregarContextoModuloIa(arquivoEntrada: string, args?: string[], modoDriftPadrao?: ModoAnaliseDriftCli): Promise<PacoteContextoModuloIa>;
+export declare function criarBriefingAgenteContratos(arquivo: string, modulo: string, ir: IrModulo | null): {
+    arquivo: string;
+    modulo: string;
+    perfilCompatibilidade: import("@sema/nucleo").PerfilCompatibilidade;
+    scoreSemantico: null;
+    confiancaGeral: null;
+    riscosPrincipais: string[];
+    oQueTocar: string[];
+    arquivosProvaveisEditar: string[];
+    oQueValidar: string[];
+    oQueEstaFrouxo: never[];
+    oQueFoiInferido: string[];
+    simbolosRelacionados: string[];
+    superficiesImpactadas: string[];
+    consumerFramework: null;
+    appRoutes: never[];
+    consumerSurfaces: never[];
+    consumerBridges: never[];
+    ancoragensVinculo: never[];
+    testesMinimos: string[];
+};
+export declare function carregarContextoModuloIa(arquivoEntrada: string, analiseDrift?: ResolucaoModoCacheDrift): Promise<PacoteContextoModuloIa>;
 export declare const ARQUIVOS_RESUMO_MODULO_IA: readonly ["SEMA_BOOT.md", "SEMA_SMALL_MODEL.md", "agent-context-pack.json", "resumo.micro.txt", "resumo.curto.txt", "resumo.md", "briefing.min.json", "prompt-curto.txt"];
 export declare function gerarArquivosResumoModuloIa(contexto: PacoteContextoModuloIa, pastaBase: string): Promise<{
     artefatosCompactos: string[];

package/dist/index.part03.js

@@ -8,7 +8,6 @@ import { criarEntradaCanonicaProjeto } from './agentContext.js';
 import { renderizarSemaBoot, renderizarSemaSmallModel, } from './agentEntryPoints.js';
 import { escreverArquivoWorkspaceSeguro, validarDestinosEscritaWorkspace } from './workspaceWrite.js';
 import { resumirListaTexto } from './textoListas.js';
-import { criarResultadoDriftNaoExecutado, resolverAnaliseDriftCli, } from "./index.part01.js";
 import { coletarResumoSemanticoModulo, criarBriefingMinimo, criarPromptCurtoModulo, renderizarResumoModuloMarkdown, renderizarResumoModuloTexto } from "./index.part02.js";
 export function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade) {
     const entradaCanonica = criarEntradaCanonicaProjeto(guiaPorCapacidade);
@@ -83,7 +82,7 @@ export function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapaci
         linhas.push(`- Faz: ${modulo.faz}`);
         linhas.push(`- Publico: ${resumirListaTexto(modulo.superficiesPublicas, 4)}`);
         linhas.push(`- Tocar: ${resumirListaTexto(modulo.arquivosProvaveis, 4)}`);
-        linhas.push(`- Score: ${modulo.scoreSemantico} | Confianca: ${modulo.confiancaGeral} | Risco: ${modulo.riscoOperacional}`);
+        linhas.push(`- Score: ${modulo.scoreSemantico ?? "não avaliado"} | Confiança: ${modulo.confiancaGeral ?? "não avaliada"} | Risco: ${modulo.riscoOperacional}`);
         linhas.push(`- Lacunas: ${resumirListaTexto(modulo.lacunas, 4)}`);
         linhas.push("");
     }
@@ -249,16 +248,74 @@ export function criarBriefingAgente(arquivo, modulo, ir, resumoDrift, resultadoD
         ancoragensVinculo: resumoDrift.ancoragensVinculo,
         testesMinimos: [
             "sema validar <arquivo> --json",
-            "sema drift <arquivo> --json",
+            "sema drift <arquivo> --cache fresh --json",
             "sema verificar <arquivo-ou-pasta> --json",
         ],
     };
 }
-export async function carregarContextoModuloIa(arquivoEntrada, args = [], modoDriftPadrao = "fresh") {
+export function criarBriefingAgenteContratos(arquivo, modulo, ir) {
+    const vinculos = ir
+        ? [
+            ...ir.vinculos,
+            ...ir.tasks.flatMap((task) => task.vinculos),
+            ...ir.flows.flatMap((flow) => flow.vinculos),
+            ...ir.routes.flatMap((route) => route.vinculos),
+            ...ir.superficies.flatMap((superficie) => superficie.vinculos),
+        ]
+        : [];
+    const arquivosDeclarados = [...new Set(vinculos.flatMap((vinculo) => [
+            vinculo.arquivo,
+            vinculo.tipo === "arquivo" ? vinculo.valor : undefined,
+        ]).filter((valor) => Boolean(valor)))]
+        .sort((a, b) => a.localeCompare(b, "pt-BR"));
+    const simbolosDeclarados = [...new Set(vinculos
+            .map((vinculo) => vinculo.simbolo)
+            .filter((valor) => Boolean(valor)))]
+        .sort((a, b) => a.localeCompare(b, "pt-BR"));
+    return {
+        arquivo,
+        modulo,
+        perfilCompatibilidade: ir?.perfilCompatibilidade ?? "interno",
+        scoreSemantico: null,
+        confiancaGeral: null,
+        riscosPrincipais: [...new Set(ir?.resumoAgente.riscos ?? [])],
+        oQueTocar: arquivosDeclarados,
+        arquivosProvaveisEditar: arquivosDeclarados,
+        oQueValidar: [...new Set([
+                ...(ir?.resumoAgente.checks ?? []),
+                ...(ir?.tasks.flatMap((task) => task.resumoAgente.checks) ?? []),
+                "executar drift antes de concluir sobre a implementação",
+            ])],
+        oQueEstaFrouxo: [],
+        oQueFoiInferido: ["modo_contratos_apenas", "implementacao_nao_verificada"],
+        simbolosRelacionados: simbolosDeclarados,
+        superficiesImpactadas: [
+            ...(ir?.routes.map((route) => `${route.metodo ?? "?"} ${route.caminho ?? route.nome}`) ?? []),
+            ...(ir?.superficies.map((superficie) => `${superficie.tipo}:${superficie.nome}`) ?? []),
+        ],
+        consumerFramework: null,
+        appRoutes: [],
+        consumerSurfaces: [],
+        consumerBridges: [],
+        ancoragensVinculo: [],
+        testesMinimos: [
+            "sema validar <arquivo> --json",
+            "sema drift <arquivo> --cache fresh --json",
+        ],
+    };
+}
+const ANALISE_DRIFT_PADRAO_CONTEXTO = {
+    modo: "fresh",
+    executar: true,
+    avisos: [],
+};
+export async function carregarContextoModuloIa(arquivoEntrada, analiseDrift = ANALISE_DRIFT_PADRAO_CONTEXTO) {
     const arquivo = path.resolve(arquivoEntrada);
     garantirArquivoSema(arquivo);
-    const analiseDrift = resolverAnaliseDriftCli(args, modoDriftPadrao);
-    const contextoProjeto = await carregarProjeto(arquivo, process.cwd(), { escopo: analiseDrift.opcoes.escopo });
+    const contextoProjeto = await carregarProjeto(arquivo, process.cwd(), {
+        escopo: "modulo",
+        adiarDescobertaCodigo: true,
+    });
     const resultadoModulo = contextoProjeto.modulosSelecionados.find((item) => path.resolve(item.caminho) === arquivo)?.resultado;
     if (!resultadoModulo) {
         falharContextoIa(`Nao foi possivel encontrar o modulo correspondente ao arquivo ${arquivo}.`);
@@ -266,20 +323,27 @@ export async function carregarContextoModuloIa(arquivoEntrada, args = [], modoDr
     const sucesso = !temErros(resultadoModulo.diagnosticos);
     const modulo = resultadoModulo.modulo?.nome ?? path.basename(arquivo, ".sema");
     const geradoEm = new Date().toISOString();
-    const resultadoDrift = analiseDrift.modo === "none"
-        ? criarResultadoDriftNaoExecutado(contextoProjeto, analiseDrift.opcoes)
-        : await analisarDriftLegado(contextoProjeto, analiseDrift.opcoes);
+    const resultadoDrift = analiseDrift.executar
+        ? await analisarDriftLegado(contextoProjeto, {
+            escopo: "modulo",
+            modoCache: analiseDrift.modo,
+            avisosModoCache: analiseDrift.avisos,
+        })
+        : null;
+    const resumoDrift = resultadoDrift
+        ? resumirDriftPorModulo(resultadoModulo.modulo?.nome ?? null, arquivo, resultadoDrift)
+        : null;
     const drift = {
         comando: "drift",
         caminho: arquivo,
         modulo: resultadoModulo.modulo?.nome ?? null,
-        sucesso: resultadoDrift.sucesso,
-        modoAnalise: analiseDrift.modo,
-        executado: analiseDrift.modo !== "none",
-        aviso: analiseDrift.modo === "none"
-            ? "Análise de drift não executada; nenhuma conclusão sobre o código foi produzida."
-            : null,
-        resumo: resumirDriftPorModulo(resultadoModulo.modulo?.nome ?? null, arquivo, resultadoDrift),
+        modo: analiseDrift.modo,
+        executada: analiseDrift.executar,
+        sucesso: resultadoDrift?.sucesso ?? null,
+        aviso: analiseDrift.executar
+            ? null
+            : "Análise de drift não executada; implementação, vínculos e rotas não foram verificados.",
+        resumo: resumoDrift,
         drift: resultadoDrift,
     };
     const validar = {
@@ -316,7 +380,9 @@ export async function carregarContextoModuloIa(arquivoEntrada, args = [], modoDr
         diagnosticos: resultadoModulo.diagnosticos,
         ir: resultadoModulo.ir ?? null,
     };
-    const briefing = criarBriefingAgente(arquivo, modulo, resultadoModulo.ir ?? null, drift.resumo, resultadoDrift);
+    const briefing = resultadoDrift && resumoDrift
+        ? criarBriefingAgente(arquivo, modulo, resultadoModulo.ir ?? null, resumoDrift, resultadoDrift)
+        : criarBriefingAgenteContratos(arquivo, modulo, resultadoModulo.ir ?? null);
     return {
         arquivo,
         modulo,
@@ -330,8 +396,6 @@ export async function carregarContextoModuloIa(arquivoEntrada, args = [], modoDr
         irJson: ir,
         drift,
         briefing,
-        modoVerificacaoCodigo: analiseDrift.modo === "none" ? "contratos_apenas" : undefined,
-        fontesConclusao: analiseDrift.modo === "none" ? ["contrato"] : undefined,
     };
 }
 export const ARQUIVOS_RESUMO_MODULO_IA = [

package/dist/index.part04.d.ts

@@ -1,7 +1,8 @@
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { ContextoIaGerado, ResumoSemanticoModuloIa, type ModoAnaliseDriftCli } from "./index.part01.js";
+import { ContextoIaGerado, ResumoSemanticoModuloIa, type ResultadoDriftIa } from "./index.part01.js";
+import type { ResolucaoModoCacheDrift } from "./driftCacheModes.js";
 export declare const ARQUIVOS_RESUMO_PROJETO_IA: readonly ["SEMA_BOOT.md", "SEMA_SMALL_MODEL.md", "SEMA_BRIEF.md", "SEMA_BRIEF.micro.txt", "SEMA_BRIEF.curto.txt", "SEMA_INDEX.json", "AGENT_CONTEXT_PACK.json", "docs/ai-integration.md"];
-export declare function gerarResumoProjetoIa(entrada: string | undefined, pastaSaidaOpcional?: string, escreverNaRaiz?: boolean, args?: string[], modoDriftPadrao?: ModoAnaliseDriftCli): Promise<{
+export declare function gerarResumoProjetoIa(entrada: string | undefined, pastaSaidaOpcional?: string, escreverNaRaiz?: boolean, analiseDrift?: ResolucaoModoCacheDrift): Promise<{
     geradoEm: string;
     baseProjeto: string;
     pastaSaida: string;
@@ -9,6 +10,13 @@ export declare function gerarResumoProjetoIa(entrada: string | undefined, pastaS
     artefatos: string[];
     modulos: ResumoSemanticoModuloIa[];
     guiaPorCapacidade: GuiaCapacidadeIaMap;
+    analiseDrift: {
+        modo: ResolucaoModoCacheDrift["modo"];
+        executada: boolean;
+        sucesso: boolean | null;
+        aviso: string | null;
+        cache: ResultadoDriftIa["escopo_aplicado"]["cache"] | null;
+    };
 }>;
 export declare function gerarContextoIa(arquivoEntrada: string, pastaSaidaOpcional?: string): Promise<ContextoIaGerado>;
 export declare function resolverEntradaDocs(posicionais: string[], args: string[]): {