@semacode/cli 2.3.1 → 3.5.0

package/dist/index.part04.js

@@ -1,11 +1,11 @@
-// 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";
 import { formatarDiagnosticos, gerarRespostaValidacao, temErros, } from "@sema/nucleo";
 import { carregarProjeto, } from "./projeto.js";
 import { analisarDriftLegado, } from "./drift.js";
-import { resolverDocumentacaoObrigatoria, verificarDocumentacaoMudanca, } from "./docs.js";
+import { compactarDocumentoObrigatorio, resolverDocumentacaoObrigatoria, verificarDocumentacaoMudanca, } from "./docs.js";
 import { LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO, LIMITE_AVISO_LINHAS_CONTRATO_SEMA, LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO, LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA, } from "./driftOrcamento.js";
 import { ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, } from './agentContextTipos.js';
 import { criarGuiaCapacidadeIa, LIMITE_CARACTERES_PAYLOAD_INLINE } from './agentContextPack.js';
@@ -16,9 +16,9 @@ import { carregarModulos } from './carregarModulos.js';
 import { obterOpcao, obterOpcoesRepetidas, possuiFlag } from './cliArgs.js';
 import { resumirListaTexto, unicosOrdenados } from './textoListas.js';
 import { EXTENSOES_CODIGO, listarArquivosRecursivosLimitado } from './projetoBusca.js';
-import { VERSAO_CLI, criarResultadoDriftNaoExecutado, resolverAnaliseDriftCli, } from "./index.part01.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,26 +53,36 @@ function escolherTopArquivosResumo(modulos, arquivosCodigoDetectados) {
     }
     return { arquivos: [], fonte: "nenhum" };
 }
-export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz = false, args = [], modoDriftPadrao = "fresh") {
-    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 analiseDrift = resolverAnaliseDriftCli(args, modoDriftPadrao);
-    const modoVerificacaoCodigo = analiseDrift.modo === "none"
-        ? "contratos_apenas"
-        : await detectarModoVerificacaoCodigo(contextoProjeto.baseProjeto, contextoProjeto.diretoriosCodigo);
-    const fontesConclusao = analiseDrift.modo === "none"
-        ? ["contrato"]
-        : await detectarFontesConclusaoSnapshot(contextoProjeto.baseProjeto);
-    const resultadoDrift = analiseDrift.modo === "none"
-        ? criarResultadoDriftNaoExecutado(contextoProjeto, analiseDrift.opcoes)
-        : await analisarDriftLegado(contextoProjeto, analiseDrift.opcoes);
+    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,
@@ -83,12 +93,12 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
                 comando: "drift",
                 caminho: item.caminho,
                 modulo,
-                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,
+                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,
             },
@@ -96,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);
@@ -117,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,
@@ -130,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`,
@@ -150,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"
@@ -193,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) {
@@ -218,102 +240,102 @@ export async function gerarContextoIa(arquivoEntrada, pastaSaidaOpcional) {
         await escreverArquivoWorkspaceSeguro(pastaBase, artefato.caminhoRelativo, artefato.conteudo, { sobrescrever: true });
     }
     const resumoGerado = await gerarArquivosResumoModuloIa(contexto, pastaBase);
-    const resumo = `# Contexto de IA para ${contexto.modulo}
-
-- Arquivo alvo: \`${contexto.arquivo}\`
-- Modulo: \`${contexto.modulo}\`
-- Sucesso em validar: \`${contexto.sucesso}\`
-- Quantidade de diagnosticos: \`${contexto.diagnosticos.length}\`
-- Gerado em: \`${contexto.geradoEm}\`
-
-## Arquivos gerados neste pacote
-
-- \`agent-context-pack.json\`
-- \`${ARQUIVO_SEMA_BOOT}\`
-- \`${ARQUIVO_SEMA_SMALL_MODEL}\`
-- \`resumo.micro.txt\`
-- \`resumo.curto.txt\`
-- \`resumo.md\`
-- \`briefing.min.json\`
-- \`prompt-curto.txt\`
-- \`validar.json\`
-- \`diagnosticos.json\`
-- \`ast.json\`
-- \`ir.json\`
-- \`drift.json\`
-- \`briefing.json\`
-
-## Fluxo recomendado para o agente
-
-Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-context-pack.json\`. Eles declaram regras obrigatórias, proibições, prioridades, idioma humano e quando abrir texto bruto como \`AGENTS.md\`, \`exemplos/\`, docs e contratos.
-
-## Políticas da plataforma
-
-- Sema governa contrato, escopo, drift, evidência e qualidade; não contorna políticas, termos, permissões, segurança ou leis.
-- Se houver alerta externo, trate como bloqueio da plataforma ou falso positivo possível, explique de forma neutra e não tente burlar filtro.
-
-### IA fraca, gratuita ou com pouca disciplina
-
-1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
-2. Ler \`${ARQUIVO_SEMA_SMALL_MODEL}\`.
-3. Ler \`agent-context-pack.json\`.
-4. Ler \`resumo.micro.txt\`.
-5. Ler \`briefing.min.json\`.
-6. Se ainda couber contexto, ler \`resumo.curto.txt\`.
-
-### IA média
-
-1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
-2. Ler \`agent-context-pack.json\`.
-3. Ler \`resumo.curto.txt\`.
-4. Ler \`briefing.min.json\`.
-5. Ler \`drift.json\`.
-6. Se precisar, subir para \`resumo.md\`.
-
-### IA forte ou com tool use
-
-1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
-2. Ler \`agent-context-pack.json\`.
-3. Ler \`README.md\`.
-4. Ler \`resumo.md\`.
-5. Ler \`briefing.json\`.
-6. Ler \`drift.json\`.
-7. Só depois abrir \`ir.json\` e \`ast.json\`.
-
-## Idioma humano
-
-- Responda no idioma do usuário.
-- Em PT-BR, use acentos, cedilha, pontuação e símbolos normais.
-- A DSL \`.sema\` pode ser ASCII; texto humano não precisa ser.
-
-## Texto bruto sob demanda
-
-- Abra \`AGENTS.md\` antes de editar código, contrato, docs operacionais, release ou deploy.
-- Abra \`exemplos/\` antes de criar ou corrigir sintaxe \`.sema\`.
-- Abra \`docs/syntax.md\` quando exemplos não bastarem para resolver a gramática.
-- Abra \`contratos/\` antes de qualquer implementação ou mudança de comportamento.
-
-## Timeout e retry
-
-- 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 ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.
-
-## Fechamento
-
-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\`.
-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 prompt-curto "${contexto.arquivo}" --para mudanca\`
-- \`sema prompt-ia\`
+    const resumo = `# Contexto de IA para ${contexto.modulo}
+
+- Arquivo alvo: \`${contexto.arquivo}\`
+- Modulo: \`${contexto.modulo}\`
+- Sucesso em validar: \`${contexto.sucesso}\`
+- Quantidade de diagnosticos: \`${contexto.diagnosticos.length}\`
+- Gerado em: \`${contexto.geradoEm}\`
+
+## Arquivos gerados neste pacote
+
+- \`agent-context-pack.json\`
+- \`${ARQUIVO_SEMA_BOOT}\`
+- \`${ARQUIVO_SEMA_SMALL_MODEL}\`
+- \`resumo.micro.txt\`
+- \`resumo.curto.txt\`
+- \`resumo.md\`
+- \`briefing.min.json\`
+- \`prompt-curto.txt\`
+- \`validar.json\`
+- \`diagnosticos.json\`
+- \`ast.json\`
+- \`ir.json\`
+- \`drift.json\`
+- \`briefing.json\`
+
+## Fluxo recomendado para o agente
+
+Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-context-pack.json\`. Eles declaram regras obrigatórias, proibições, prioridades, idioma humano e quando abrir texto bruto como \`AGENTS.md\`, \`exemplos/\`, docs e contratos.
+
+## Políticas da plataforma
+
+- Sema governa contrato, escopo, drift, evidência e qualidade; não contorna políticas, termos, permissões, segurança ou leis.
+- Se houver alerta externo, trate como bloqueio da plataforma ou falso positivo possível, explique de forma neutra e não tente burlar filtro.
+
+### IA fraca, gratuita ou com pouca disciplina
+
+1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
+2. Ler \`${ARQUIVO_SEMA_SMALL_MODEL}\`.
+3. Ler \`agent-context-pack.json\`.
+4. Ler \`resumo.micro.txt\`.
+5. Ler \`briefing.min.json\`.
+6. Se ainda couber contexto, ler \`resumo.curto.txt\`.
+
+### IA média
+
+1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
+2. Ler \`agent-context-pack.json\`.
+3. Ler \`resumo.curto.txt\`.
+4. Ler \`briefing.min.json\`.
+5. Ler \`drift.json\`.
+6. Se precisar, subir para \`resumo.md\`.
+
+### IA forte ou com tool use
+
+1. Ler \`${ARQUIVO_SEMA_BOOT}\`.
+2. Ler \`agent-context-pack.json\`.
+3. Ler \`README.md\`.
+4. Ler \`resumo.md\`.
+5. Ler \`briefing.json\`.
+6. Ler \`drift.json\`.
+7. Só depois abrir \`ir.json\` e \`ast.json\`.
+
+## Idioma humano
+
+- Responda no idioma do usuário.
+- Em PT-BR, use acentos, cedilha, pontuação e símbolos normais.
+- A DSL \`.sema\` pode ser ASCII; texto humano não precisa ser.
+
+## Texto bruto sob demanda
+
+- Abra \`AGENTS.md\` antes de editar código, contrato, docs operacionais, release ou deploy.
+- Abra \`exemplos/\` antes de criar ou corrigir sintaxe \`.sema\`.
+- Abra \`docs/syntax.md\` quando exemplos não bastarem para resolver a gramática.
+- Abra \`contratos/\` antes de qualquer implementação ou mudança de comportamento.
+
+## Timeout e retry
+
+- 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 --drift none\`.
+- Se o ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.
+
+## Fechamento
+
+1. Editar o arquivo \`.sema\`.
+2. Rodar \`sema formatar "${contexto.arquivo}"\`.
+3. Rodar \`sema validar "${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 --drift none\`
+- \`sema prompt-curto "${contexto.arquivo}" --para mudanca\`
+- \`sema prompt-ia\`
 `;
     await escreverArquivoWorkspaceSeguro(pastaBase, "README.md", resumo, {
         sobrescrever: true,
@@ -350,7 +372,7 @@ export function resolverEntradaDocs(posicionais, args) {
 export async function comandoDocsImpacto(posicionais, args, emJson) {
     const { intencao, arquivosAlvo } = resolverEntradaDocs(posicionais, args);
     if (!intencao.trim()) {
-        console.error("Uso: sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--json]");
+        console.error("Uso: sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--completo] [--json]");
         return 1;
     }
     const resultado = await resolverDocumentacaoObrigatoria({
@@ -359,9 +381,16 @@ export async function comandoDocsImpacto(posicionais, args, emJson) {
         arquivosAlvo,
         criarAusentes: possuiFlag(args, "--criar-ausentes"),
     });
+    const completo = possuiFlag(args, "--completo");
     const payload = {
         comando: "docs-impacto",
-        ...resultado,
+        ...(completo ? resultado : {
+            ...resultado,
+            leituraObrigatoria: resultado.leituraObrigatoria.map(compactarDocumentoObrigatorio),
+            docsAusentes: resultado.docsAusentes.map(compactarDocumentoObrigatorio),
+            docsCriadas: resultado.docsCriadas.map(compactarDocumentoObrigatorio),
+            modoDocumentos: "compacto",
+        }),
     };
     if (emJson) {
         console.log(JSON.stringify(payload, null, 2));

package/dist/index.part05.js

@@ -1,3 +1,6 @@
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.governanca_ia.drift.cache.modos
+// Descrição: executa drift sob modo explícito e mantém consultas honestas quando a análise é pulada.
+import { stat } from "node:fs/promises";
 import path from "node:path";
 import { compilarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from "@sema/nucleo";
 import { carregarProjeto, resolverAlvosVerificacao, resolverEstruturaSaidaPadrao, resolverFrameworkPadrao, resolverSaidaPadrao, } from "./projeto.js";
@@ -7,14 +10,22 @@ import { escreverArquivos, formatarAvisoArtefatosGeradosAcimaDoLimite, } from '.
 import { carregarModulos } from './carregarModulos.js';
 import { obterOpcao } from './cliArgs.js';
 import { resumirDriftPorModulo } from "./index.part03.js";
-import { criarResultadoDriftNaoExecutado, resolverAnaliseDriftCli, resolverOpcoesDriftCli } from "./index.part01.js";
+import { resolverAnaliseDriftConsultaCli, resolverOpcoesDriftCli } from "./index.part01.js";
 export async function comandoInspecionar(entrada, emJson, cwd = process.cwd(), args = []) {
-    const analiseDrift = resolverAnaliseDriftCli(args, "none");
-    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: analiseDrift.opcoes.escopo });
-    const driftExecutado = analiseDrift.modo !== "none";
-    const resultadoDrift = driftExecutado
+    const analiseDrift = resolverAnaliseDriftConsultaCli(args, "inspecionar");
+    const alvo = entrada ? path.resolve(cwd, entrada) : cwd;
+    const alvoEhArquivo = (await stat(alvo)).isFile();
+    const escopoEstreito = analiseDrift.opcoes.escopo === "arquivo"
+        || analiseDrift.opcoes.escopo === "modulo"
+        || (analiseDrift.opcoes.escopo === undefined
+            && alvoEhArquivo);
+    const contextoProjeto = await carregarProjeto(entrada, cwd, {
+        escopo: analiseDrift.opcoes.escopo,
+        adiarDescobertaCodigo: !analiseDrift.executar || escopoEstreito,
+    });
+    const resultadoDrift = analiseDrift.executar
         ? await analisarDriftLegado(contextoProjeto, analiseDrift.opcoes)
-        : criarResultadoDriftNaoExecutado(contextoProjeto, analiseDrift.opcoes);
+        : null;
     const framework = resolverFrameworkPadrao(undefined, contextoProjeto.configCarregada);
     const estruturaSaida = resolverEstruturaSaidaPadrao(undefined, framework, contextoProjeto.configCarregada);
     const alvos = resolverAlvosVerificacao(contextoProjeto.configCarregada);
@@ -35,78 +46,61 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd(), a
             modoAdocao: contextoProjeto.modoAdocao,
             analiseDrift: {
                 modo: analiseDrift.modo,
-                executada: driftExecutado,
-                cache: analiseDrift.modo === "fresh" ? "refresh" : analiseDrift.modo === "cache" ? "auto" : null,
-                aviso: driftExecutado
+                executada: analiseDrift.executar,
+                sucesso: resultadoDrift?.sucesso ?? null,
+                aviso: analiseDrift.executar
                     ? null
-                    : "Análise de drift não executada; código, rotas, vínculos e implementações não foram verificados.",
+                    : "Análise de drift não executada; implementação, vínculos e rotas não foram verificados.",
+                avisos: analiseDrift.avisos,
+                cache: resultadoDrift?.escopo_aplicado.cache ?? null,
             },
-            scoreDrift: driftExecutado ? resultadoDrift.resumo_operacional.scoreMedio : null,
-            confiancaGeral: driftExecutado ? resultadoDrift.resumo_operacional.confiancaGeral : null,
-            consumerFramework: driftExecutado ? resultadoDrift.consumerFramework : null,
-            appRoutes: driftExecutado ? resultadoDrift.appRoutes : null,
-            consumerSurfaces: driftExecutado ? resultadoDrift.consumerSurfaces : null,
-            consumerBridges: driftExecutado ? resultadoDrift.consumerBridges : null,
+            scoreDrift: resultadoDrift?.resumo_operacional.scoreMedio ?? null,
+            confiancaGeral: resultadoDrift?.resumo_operacional.confiancaGeral ?? null,
+            consumerFramework: resultadoDrift?.consumerFramework ?? null,
+            appRoutes: resultadoDrift?.appRoutes ?? null,
+            consumerSurfaces: resultadoDrift?.consumerSurfaces ?? null,
+            consumerBridges: resultadoDrift?.consumerBridges ?? null,
         },
         projeto: {
             arquivos: contextoProjeto.arquivosProjeto,
-            arquivosDescobertos: contextoProjeto.arquivosDescobertos,
             modulos: contextoProjeto.modulosSelecionados.map((item) => ({
                 caminho: item.caminho,
                 modulo: item.resultado.modulo?.nome ?? null,
                 sucesso: !temErros(item.resultado.diagnosticos),
                 diagnosticos: item.resultado.diagnosticos.length,
                 superficies: item.resultado.ir?.superficies.map((superficie) => `${superficie.tipo}:${superficie.nome}`) ?? [],
-                tasks: item.resultado.ir?.tasks.map((task) => task.nome) ?? [],
-                vinculos: item.resultado.ir
-                    ? [
-                        ...item.resultado.ir.vinculos,
-                        ...item.resultado.ir.tasks.flatMap((task) => task.vinculos),
-                        ...item.resultado.ir.flows.flatMap((flow) => flow.vinculos),
-                        ...item.resultado.ir.routes.flatMap((route) => route.vinculos),
-                        ...item.resultado.ir.superficies.flatMap((superficie) => superficie.vinculos),
-                    ]
-                    : [],
-                arquivosEsperados: item.resultado.ir
-                    ? [...new Set([
-                            ...item.resultado.ir.vinculos,
-                            ...item.resultado.ir.tasks.flatMap((task) => task.vinculos),
-                            ...item.resultado.ir.flows.flatMap((flow) => flow.vinculos),
-                            ...item.resultado.ir.routes.flatMap((route) => route.vinculos),
-                            ...item.resultado.ir.superficies.flatMap((superficie) => superficie.vinculos),
-                        ].flatMap((vinculo) => [
-                            vinculo.arquivo,
-                            vinculo.tipo === "arquivo" ? vinculo.valor : undefined,
-                        ]).filter((arquivo) => Boolean(arquivo)))]
-                        .sort((a, b) => a.localeCompare(b, "pt-BR"))
-                    : [],
-                implementacao: driftExecutado
+                implementacao: resultadoDrift
                     ? resumirDriftPorModulo(item.resultado.modulo?.nome ?? null, item.caminho, resultadoDrift)
                     : null,
             })),
         },
     };
+    const codigoSaida = resultadoDrift?.sucesso === false ? 1 : 0;
     if (emJson) {
         console.log(JSON.stringify(payload, null, 2));
-        return 0;
+        return codigoSaida;
     }
-    console.log("Inspecao de projeto Sema");
+    console.log("Inspeção de projeto Sema");
     console.log(`- Entrada: ${payload.entrada}`);
-    console.log(`- Configuracao: ${payload.configuracao.caminho ?? "nenhuma"}`);
+    console.log(`- Configuração: ${payload.configuracao.caminho ?? "nenhuma"}`);
     console.log(`- Base do projeto: ${payload.configuracao.baseProjeto}`);
     console.log(`- Framework: ${payload.configuracao.framework}`);
     console.log(`- Estrutura de saida: ${payload.configuracao.estruturaSaida}`);
     console.log(`- Alvos: ${payload.configuracao.alvos.join(", ")}`);
-    console.log(`- Modo de adocao: ${payload.configuracao.modoAdocao}`);
+    console.log(`- Modo de adoção: ${payload.configuracao.modoAdocao}`);
     console.log(`- Análise de drift: ${payload.configuracao.analiseDrift.modo} (${payload.configuracao.analiseDrift.executada ? "executada" : "não executada"})`);
     if (payload.configuracao.analiseDrift.executada) {
-        console.log(`- Score medio de drift: ${payload.configuracao.scoreDrift}`);
-        console.log(`- Confianca geral: ${payload.configuracao.confiancaGeral}`);
+        console.log(`- Resultado do drift: ${payload.configuracao.analiseDrift.sucesso ? "sucesso" : "falha"}`);
+        console.log(`- Score médio de drift: ${payload.configuracao.scoreDrift}`);
+        console.log(`- Confiança geral: ${payload.configuracao.confiancaGeral}`);
     }
     else {
+        console.log("- Resultado do drift: não avaliado");
+        console.log("- Score médio de drift: não avaliado");
+        console.log("- Confiança geral: não avaliada");
         console.log(`- Aviso: ${payload.configuracao.analiseDrift.aviso}`);
     }
-    console.log("- Saidas por alvo:");
+    console.log("- Saídas por alvo:");
     for (const [alvo, saida] of Object.entries(payload.configuracao.saidas)) {
         console.log(`  - ${alvo}: ${saida}`);
     }
@@ -114,22 +108,16 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd(), a
     for (const origem of payload.configuracao.origens) {
         console.log(`  - ${origem}`);
     }
-    console.log("- Diretorios de codigo:");
+    console.log("- Diretórios de código:");
     for (const diretorio of payload.configuracao.diretoriosCodigo) {
         console.log(`  - ${diretorio}`);
     }
     console.log(`- Fontes de legado detectadas: ${payload.configuracao.fontesLegado.join(", ") || "nenhuma"}`);
-    console.log(`- Contratos carregados: ${payload.projeto.arquivos.length}`);
-    console.log(`- Contratos descobertos: ${payload.projeto.arquivosDescobertos.length}`);
-    console.log("- Modulos selecionados:");
+    console.log("- Módulos selecionados:");
     for (const modulo of payload.projeto.modulos) {
         console.log(`  - ${modulo.modulo ?? "(sem modulo)"} :: ${modulo.caminho} :: diagnosticos=${modulo.diagnosticos}`);
-        console.log(`    tasks=${modulo.tasks.length} vinculos=${modulo.vinculos.length} arquivos esperados=${modulo.arquivosEsperados.length}`);
-        for (const arquivoEsperado of modulo.arquivosEsperados.slice(0, 8)) {
-            console.log(`    arquivo esperado: ${arquivoEsperado}`);
-        }
         if (modulo.implementacao) {
-            console.log(`    impls validos=${modulo.implementacao.implsValidos} quebrados=${modulo.implementacao.implsQuebrados} recursos divergentes=${modulo.implementacao.recursosDivergentesCount} sem_impl=${modulo.implementacao.tasksSemImplementacao}`);
+            console.log(`    impls válidos=${modulo.implementacao.implsValidos} quebrados=${modulo.implementacao.implsQuebrados} recursos divergentes=${modulo.implementacao.recursosDivergentesCount} sem_impl=${modulo.implementacao.tasksSemImplementacao}`);
             for (const arquivoRelacionado of modulo.implementacao.arquivosRelacionados.slice(0, 5)) {
                 console.log(`    arquivo relacionado: ${arquivoRelacionado}`);
             }
@@ -138,11 +126,14 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd(), a
             console.log("    implementação: não verificada neste modo");
         }
     }
-    return 0;
+    return codigoSaida;
 }
 export async function comandoDrift(entrada, args, emJson, cwd = process.cwd()) {
     const opcoes = resolverOpcoesDriftCli(args);
-    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: opcoes.escopo });
+    const contextoProjeto = await carregarProjeto(entrada, cwd, {
+        escopo: opcoes.escopo,
+        adiarDescobertaCodigo: opcoes.escopo !== "projeto",
+    });
     const resultado = await analisarDriftLegado(contextoProjeto, opcoes);
     if (emJson) {
         console.log(JSON.stringify(resultado, null, 2));
@@ -150,18 +141,29 @@ export async function comandoDrift(entrada, args, emJson, cwd = process.cwd()) {
     }
     console.log("Drift entre Sema e codigo legado");
     console.log(`- Escopo aplicado: ${resultado.escopo_aplicado.escopo}`);
-    console.log(`- Estrategia fisica: ${resultado.escopo_aplicado.estrategia ?? "legado"}`);
-    console.log(`- Cobertura: ${resultado.escopo_aplicado.cobertura ?? "nao informada"}`);
+    console.log(`- Estratégia física: ${resultado.escopo_aplicado.estrategia ?? "não informada"}`);
+    console.log(`- Cobertura: ${resultado.escopo_aplicado.cobertura ?? "não informada"}`);
     console.log(`- Arquivos planejados: ${resultado.escopo_aplicado.arquivosPlanejados?.length ?? 0}`);
-    console.log(`- Cache: ${resultado.escopo_aplicado.cache?.politica ?? "nao informado"} (${resultado.escopo_aplicado.cache?.origem ?? "nao informado"})`);
-    console.log(`- Catálogo: ${resultado.escopo_aplicado.catalogo?.arquivosCatalogados ?? 0} arquivos, ${resultado.escopo_aplicado.catalogo?.diretoriosVisitados ?? 0} diretórios visitados, ${resultado.escopo_aplicado.catalogo?.leiturasConteudo ?? 0} leituras`);
-    const cacheIncremental = resultado.escopo_aplicado.cache?.incremental;
-    if (cacheIncremental) {
-        console.log(`- Cache incremental: ${cacheIncremental.metadataHits} metadata hits, ${cacheIncremental.contentHits} content hits, ${cacheIncremental.groupHits} grupos reutilizados, ${cacheIncremental.groupMisses} grupos recalculados`);
-    }
-    const fases = resultado.escopo_aplicado.cache?.fasesMs;
-    if (fases) {
-        console.log(`- Fases: plano ${fases.planejamento}ms, catálogo ${fases.catalogacao}ms, dependências ${fases.dependencias}ms, assinaturas ${fases.assinaturas}ms, índices ${fases.indexacao}ms, total ${fases.total}ms`);
+    console.log(`- Arquivos declarados: ${resultado.escopo_aplicado.arquivosDeclarados?.length ?? 0}`);
+    console.log(`- Arquivos inferidos: ${resultado.escopo_aplicado.arquivosInferidos?.length ?? 0}`);
+    console.log(`- Arquivos ausentes: ${resultado.escopo_aplicado.arquivosAusentes?.length ?? 0}`);
+    console.log(`- Bloqueios do plano: ${resultado.escopo_aplicado.bloqueios?.length ?? 0}`);
+    for (const bloqueio of resultado.escopo_aplicado.bloqueios ?? []) {
+        console.log(`  - ${bloqueio}`);
+    }
+    const metricasCatalogo = resultado.escopo_aplicado.catalogo;
+    if (metricasCatalogo) {
+        const origemCatalogo = metricasCatalogo.origem === "plano_explicito"
+            ? "plano explícito"
+            : "caminhada";
+        console.log(`- Catálogo: ${metricasCatalogo.arquivosCatalogados} arquivos, ${metricasCatalogo.diretoriosVisitados} diretórios visitados, ${metricasCatalogo.leiturasConteudo} leituras, ${metricasCatalogo.bytesLidos} bytes, ${metricasCatalogo.acertosMemoriaConteudo} reaproveitamentos em memória, origem ${origemCatalogo}`);
+    }
+    const estadoCache = resultado.escopo_aplicado.cache;
+    if (estadoCache) {
+        console.log(`- Cache: modo=${estadoCache.modo} origem=${estadoCache.origem} hits=${estadoCache.metricas.hits} misses=${estadoCache.metricas.misses} corrompidos=${estadoCache.metricas.corruptos} gravações=${estadoCache.metricas.gravacoes}`);
+        for (const aviso of estadoCache.avisos) {
+            console.log(`  - Aviso: ${aviso.mensagem}`);
+        }
     }
     console.log(`- Ignorar worktrees: ${resultado.escopo_aplicado.ignorarWorktrees ? "sim" : "nao"}`);
     console.log(`- Ignorar consumidores laterais: ${resultado.escopo_aplicado.ignorarConsumidoresLaterais ? "sim" : "nao"}`);
@@ -251,10 +253,10 @@ export async function comandoImpacto(entrada, args, emJson, cwd = process.cwd())
         return 1;
     }
     const opcoes = resolverOpcoesDriftCli(args);
-    if (!obterOpcao(args, "--escopo")) {
-        opcoes.escopo = entrada?.toLowerCase().endsWith(".sema") ? "modulo" : "projeto";
-    }
-    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: opcoes.escopo });
+    const contextoProjeto = await carregarProjeto(entrada, cwd, {
+        escopo: opcoes.escopo,
+        adiarDescobertaCodigo: opcoes.escopo !== "projeto",
+    });
     const resultado = await gerarMapaImpactoSemantico(contextoProjeto, alvoSemantico, obterOpcao(args, "--mudanca", `avaliar impacto de ${alvoSemantico}`), opcoes);
     if (emJson) {
         console.log(JSON.stringify(resultado, null, 2));
@@ -289,10 +291,10 @@ export async function comandoRenomearSemantico(entrada, args, emJson, cwd = proc
         return 1;
     }
     const opcoes = resolverOpcoesDriftCli(args);
-    if (!obterOpcao(args, "--escopo")) {
-        opcoes.escopo = entrada?.toLowerCase().endsWith(".sema") ? "modulo" : "projeto";
-    }
-    const contextoProjeto = await carregarProjeto(entrada, cwd, { escopo: opcoes.escopo });
+    const contextoProjeto = await carregarProjeto(entrada, cwd, {
+        escopo: opcoes.escopo,
+        adiarDescobertaCodigo: opcoes.escopo !== "projeto",
+    });
     const resultado = await assistirRenomeacaoSemantica(contextoProjeto, nomeAtual, nomeNovo, opcoes);
     if (emJson) {
         console.log(JSON.stringify(resultado, null, 2));