@semacode/cli 2.3.0 → 3.0.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)}`,
                 "",
             ]
             : []),
@@ -320,27 +334,27 @@ export function criarBriefingMinimo(resumo, modo, tamanho) {
 }
 export function criarPromptCurtoModulo(resumo, modo, tamanho, capacidade) {
     const resumoTexto = renderizarResumoModuloTexto(resumo, tamanho, modo).trim();
-    return `Você está operando Sema em modo IA-first.
-
-Esta linguagem existe para traduzir intenção operacional em contrato consumível por IA. Humanos aprovam; agentes operam.
-
-Capacidade alvo: ${capacidade}
-Modo da tarefa: ${modo}
-
-Regras:
-- não invente sintaxe nem bloco fora da gramática oficial
-- preserve a intenção do contrato
-- use este resumo como fonte compacta inicial
-- se a tarefa pedir mais contexto, rode \`sema contexto-ia <arquivo.sema> --saida <diretorio> --json\` e então abra \`briefing.min.json\`, \`drift.json\` e \`ir.json\` nessa saída
-- não saia editando software vivo sem olhar risco, lacuna e checks sugeridos
-- se abrir código com \`SEMA-GOVERNED\`, volte ao contrato e chame Sema antes de editar
-- não crie nem conclua código governado acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas; acima de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO}, planeje divisão; documentação Markdown não entra nesse limite de código
-- não crie nem edite contrato .sema acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} linhas; acima de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA}, planeje split por domínio/capacidade, nunca parte_1/parte_2
-- vários contratos .sema podem governar o mesmo arquivo por vinculos; Sema Código deve preservar essa rastreabilidade
-${resumo.consumerFramework ? "- se for tarefa visual consumer, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivos aleatórios" : ""}
-
-Contexto compacto:
-${resumoTexto}
+    return `Você está operando Sema em modo IA-first.
+
+Esta linguagem existe para traduzir intenção operacional em contrato consumível por IA. Humanos aprovam; agentes operam.
+
+Capacidade alvo: ${capacidade}
+Modo da tarefa: ${modo}
+
+Regras:
+- não invente sintaxe nem bloco fora da gramática oficial
+- preserve a intenção do contrato
+- use este resumo como fonte compacta inicial
+- se a tarefa pedir mais contexto, rode \`sema contexto-ia <arquivo.sema> --saida <diretorio> --json\` e então abra \`briefing.min.json\`, \`drift.json\` e \`ir.json\` nessa saída
+- não saia editando software vivo sem olhar risco, lacuna e checks sugeridos
+- se abrir código com \`SEMA-GOVERNED\`, volte ao contrato e chame Sema antes de editar
+- não crie nem conclua código governado acima de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas; acima de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO}, planeje divisão; documentação Markdown não entra nesse limite de código
+- não crie nem edite contrato .sema acima de ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} linhas; acima de ${LIMITE_AVISO_LINHAS_CONTRATO_SEMA}, planeje split por domínio/capacidade, nunca parte_1/parte_2
+- vários contratos .sema podem governar o mesmo arquivo por vinculos; Sema Código deve preservar essa rastreabilidade
+${resumo.consumerFramework ? "- se for tarefa visual consumer, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivos aleatórios" : ""}
+
+Contexto compacto:
+${resumoTexto}
 `;
 }
 //# sourceMappingURL=index.part02.js.map

package/dist/index.part03.d.ts

@@ -2,6 +2,7 @@ import { type IrModulo } from "@sema/nucleo";
 import { analisarDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.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): 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

@@ -82,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("");
     }
@@ -248,15 +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) {
+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 contextoProjeto = await carregarProjeto(arquivo, process.cwd());
+    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}.`);
@@ -264,13 +323,27 @@ export async function carregarContextoModuloIa(arquivoEntrada) {
     const sucesso = !temErros(resultadoModulo.diagnosticos);
     const modulo = resultadoModulo.modulo?.nome ?? path.basename(arquivo, ".sema");
     const geradoEm = new Date().toISOString();
-    const resultadoDrift = await analisarDriftLegado(contextoProjeto);
+    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,
-        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 = {
@@ -307,7 +380,9 @@ export async function carregarContextoModuloIa(arquivoEntrada) {
         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,

package/dist/index.part04.d.ts

@@ -1,7 +1,8 @@
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { ContextoIaGerado, ResumoSemanticoModuloIa } 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): 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[]): {

package/dist/index.part04.js

@@ -1,4 +1,4 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.escrita_segura_workspace
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.escrita_segura_workspace, sema.produto.governanca_ia.drift.cache.modos
 // Descrição: gera contexto local e grava artefatos somente dentro da base validada.
 import { mkdir } from "node:fs/promises";
 import path from "node:path";
@@ -18,7 +18,7 @@ import { resumirListaTexto, unicosOrdenados } from './textoListas.js';
 import { EXTENSOES_CODIGO, listarArquivosRecursivosLimitado } from './projetoBusca.js';
 import { VERSAO_CLI } from "./index.part01.js";
 import { coletarResumoSemanticoModulo, descreverFontesConclusao, detectarFontesConclusaoSnapshot, detectarModoVerificacaoCodigo } from "./index.part02.js";
-import { ARQUIVOS_RESUMO_MODULO_IA, carregarContextoModuloIa, criarBriefingAgente, gerarArquivosResumoModuloIa, renderizarResumoProjetoMarkdown, resumirDriftPorModulo } from "./index.part03.js";
+import { ARQUIVOS_RESUMO_MODULO_IA, carregarContextoModuloIa, criarBriefingAgente, criarBriefingAgenteContratos, gerarArquivosResumoModuloIa, renderizarResumoProjetoMarkdown, resumirDriftPorModulo } from "./index.part03.js";
 export const ARQUIVOS_RESUMO_PROJETO_IA = [
     ARQUIVO_SEMA_BOOT,
     ARQUIVO_SEMA_SMALL_MODEL,
@@ -53,19 +53,36 @@ function escolherTopArquivosResumo(modulos, arquivosCodigoDetectados) {
     }
     return { arquivos: [], fonte: "nenhum" };
 }
-export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz = false) {
-    const contextoProjeto = await carregarProjeto(entrada, process.cwd());
+export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz = false, analiseDrift = { modo: "none", executar: false, avisos: [] }) {
+    const contextoProjeto = await carregarProjeto(entrada, process.cwd(), {
+        escopo: "projeto",
+        adiarDescobertaCodigo: !analiseDrift.executar,
+    });
     const geradoEm = new Date().toISOString();
     const guiaPorCapacidade = criarGuiaCapacidadeIa();
     const entradaCanonica = criarEntradaCanonicaProjeto(guiaPorCapacidade);
     const agentContextPack = entradaCanonica.agentContextPack;
-    const modoVerificacaoCodigo = await detectarModoVerificacaoCodigo(contextoProjeto.baseProjeto, contextoProjeto.diretoriosCodigo);
-    const fontesConclusao = await detectarFontesConclusaoSnapshot(contextoProjeto.baseProjeto);
-    const resultadoDrift = await analisarDriftLegado(contextoProjeto);
+    const modoVerificacaoCodigo = analiseDrift.executar
+        ? await detectarModoVerificacaoCodigo(contextoProjeto.baseProjeto, contextoProjeto.diretoriosCodigo)
+        : "contratos_apenas";
+    const fontesConclusao = analiseDrift.executar
+        ? await detectarFontesConclusaoSnapshot(contextoProjeto.baseProjeto)
+        : ["contrato"];
+    const resultadoDrift = analiseDrift.executar
+        ? await analisarDriftLegado(contextoProjeto, {
+            escopo: "projeto",
+            modoCache: analiseDrift.modo,
+            avisosModoCache: analiseDrift.avisos,
+        })
+        : null;
     const modulos = contextoProjeto.modulosSelecionados.map((item) => {
         const modulo = item.resultado.modulo?.nome ?? path.basename(item.caminho, ".sema");
-        const driftResumo = resumirDriftPorModulo(modulo, item.caminho, resultadoDrift);
-        const briefing = criarBriefingAgente(item.caminho, modulo, item.resultado.ir ?? null, driftResumo, resultadoDrift);
+        const driftResumo = resultadoDrift
+            ? resumirDriftPorModulo(modulo, item.caminho, resultadoDrift)
+            : null;
+        const briefing = resultadoDrift && driftResumo
+            ? criarBriefingAgente(item.caminho, modulo, item.resultado.ir ?? null, driftResumo, resultadoDrift)
+            : criarBriefingAgenteContratos(item.caminho, modulo, item.resultado.ir ?? null);
         return coletarResumoSemanticoModulo({
             arquivo: item.caminho,
             modulo,
@@ -76,7 +93,12 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
                 comando: "drift",
                 caminho: item.caminho,
                 modulo,
-                sucesso: resultadoDrift.sucesso,
+                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: driftResumo,
                 drift: resultadoDrift,
             },
@@ -84,7 +106,7 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
             fontesConclusao,
         });
     });
-    const arquivosCodigoDetectados = modoVerificacaoCodigo === "codigo_completo"
+    const arquivosCodigoDetectados = analiseDrift.executar && modoVerificacaoCodigo === "codigo_completo"
         ? await listarTopArquivosCodigoDetectados(contextoProjeto.diretoriosCodigo)
         : [];
     const topArquivosResumo = escolherTopArquivosResumo(modulos, arquivosCodigoDetectados);
@@ -105,6 +127,15 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
         cliVersao: VERSAO_CLI,
         baseProjeto,
         modoVerificacaoCodigo,
+        analiseDrift: {
+            modo: analiseDrift.modo,
+            executada: analiseDrift.executar,
+            sucesso: resultadoDrift?.sucesso ?? null,
+            aviso: analiseDrift.executar
+                ? null
+                : "Análise de drift não executada; o resumo contém somente evidência contratual.",
+            cache: resultadoDrift?.escopo_aplicado.cache ?? null,
+        },
         fontesConclusao,
         conclusoesPorFonte: descreverFontesConclusao(fontesConclusao, modoVerificacaoCodigo),
         totalModulos: modulos.length,
@@ -118,6 +149,7 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
         `PROJETO: ${path.basename(baseProjeto)}`,
         `MODULOS: ${modulos.length}`,
         `MODO_CODIGO: ${modoVerificacaoCodigo}`,
+        `RESULTADO_DRIFT: ${resultadoDrift ? (resultadoDrift.sucesso ? "sucesso" : "falha") : "não avaliado"}`,
         `FONTES_CONCLUSAO: ${resumirListaTexto(fontesConclusao, 4)}`,
         `ENTRADA_IA: ${entradaCanonica.porCapacidade.fraca.join(" -> ")}`,
         `POLITICA_PLATAFORMA: Sema governa projeto e nao contorna politicas da plataforma; se houver alerta externo, pare e explique sem burlar filtro`,
@@ -138,6 +170,7 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
         `BASE: ${baseProjeto}`,
         `MODULOS: ${modulos.length}`,
         `MODO_CODIGO: ${modoVerificacaoCodigo}`,
+        `RESULTADO_DRIFT: ${resultadoDrift ? (resultadoDrift.sucesso ? "sucesso" : "falha") : "não avaliado"}`,
         ...(modoVerificacaoCodigo === "contratos_apenas"
             ? ["AVISO_CODIGO: somente contratos enviados; implementacao nao verificada neste modo"]
             : modoVerificacaoCodigo === "codigo_selecionado"
@@ -181,6 +214,7 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
         artefatos: [...ARQUIVOS_RESUMO_PROJETO_IA],
         modulos,
         guiaPorCapacidade,
+        analiseDrift: indexJson.analiseDrift,
     };
 }
 export async function gerarContextoIa(arquivoEntrada, pastaSaidaOpcional) {
@@ -285,7 +319,7 @@ Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-co
 
 - Timeout local do agente não é falha do Sema.
 - Se uma chamada Sema estourar, aumente o timeout e tente de novo.
-- Se o projeto inteiro for lento, escopar para \`sema resumo "${contexto.arquivo}" --micro --para mudanca\`.
+- Se o projeto inteiro for lento, escopar para \`sema resumo "${contexto.arquivo}" --micro --para mudanca --drift none\`.
 - Se o ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.
 
 ## Fechamento
@@ -293,13 +327,13 @@ Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-co
 1. Editar o arquivo \`.sema\`.
 2. Rodar \`sema formatar "${contexto.arquivo}"\`.
 3. Rodar \`sema validar "${contexto.arquivo}" --json\`.
-4. Rodar \`sema drift "${contexto.arquivo}" --json\`.
+4. Rodar \`sema drift "${contexto.arquivo}" --cache fresh --json\`.
 5. Fechar com \`sema verificar <arquivo-ou-pasta> --json --saida ./.tmp/verificacao-ia\`.
 
 ## Textos base para onboarding do agente
 
 - \`sema starter-ia\`
-- \`sema resumo "${contexto.arquivo}" --micro --para onboarding\`
+- \`sema resumo "${contexto.arquivo}" --micro --para onboarding --drift none\`
 - \`sema prompt-curto "${contexto.arquivo}" --para mudanca\`
 - \`sema prompt-ia\`
 `;

package/dist/index.part05.d.ts

@@ -1,5 +1,5 @@
 import { type FonteImportacao } from "./importador.js";
-export declare function comandoInspecionar(entrada: string | undefined, emJson: boolean, cwd?: string): Promise<number>;
+export declare function comandoInspecionar(entrada: string | undefined, emJson: boolean, cwd?: string, args?: string[]): Promise<number>;
 export declare function comandoDrift(entrada: string | undefined, args: string[], emJson: boolean, cwd?: string): Promise<number>;
 export declare function comandoImpacto(entrada: string | undefined, args: string[], emJson: boolean, cwd?: string): Promise<number>;
 export declare function comandoRenomearSemantico(entrada: string | undefined, args: string[], emJson: boolean, cwd?: string): Promise<number>;