@semacode/cli 2.3.1 → 3.0.0

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-#!/usr/bin/env node
 export * from "./index.part01.js";
 export * from "./index.part08.js";
+export * from "./cliHelp.js";
+export { criarAjudaRaiz } from "./cliHelpTexto.js";
+export * from "./saidaCli.js";
 export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarClichesAuthor } from "./profileAuthorCommand.js";
 export { validarProfileSemantico } from "./profileCommand.js";
 export { materializarExemplosOficiais } from "./exemplosOficiais.js";
@@ -8,3 +10,4 @@ export { expandirIntencaoSemanticaProfile, sugerirStarterPresetProfile, validarP
 export * from "./pipelineConteudo/index.js";
 export * from "./sistemasInterativos/index.js";
 export * from "./discovery/index.js";
+export * from "./distribuicao/index.js";

package/dist/index.js

@@ -1,12 +1,10 @@
-#!/usr/bin/env node
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
-import { realpathSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { principal } from "./index.part08.js";
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.distribuicao_global, sema.produto.cli_invocacao_publica
+// Descrição: superfície de biblioteca da CLI; o executável público vive exclusivamente em bin.ts.
 export * from "./index.part01.js";
 export * from "./index.part08.js";
+export * from "./cliHelp.js";
+export { criarAjudaRaiz } from "./cliHelpTexto.js";
+export * from "./saidaCli.js";
 export { iniciarProfileAuthor, comandoAuthor, criarAuthorBriefing, revisarClichesAuthor } from "./profileAuthorCommand.js";
 export { validarProfileSemantico } from "./profileCommand.js";
 export { materializarExemplosOficiais } from "./exemplosOficiais.js";
@@ -14,22 +12,5 @@ export { expandirIntencaoSemanticaProfile, sugerirStarterPresetProfile, validarP
 export * from "./pipelineConteudo/index.js";
 export * from "./sistemasInterativos/index.js";
 export * from "./discovery/index.js";
-function moduloExecutadoDiretamente() {
-    if (!process.argv[1]) {
-        return false;
-    }
-    try {
-        return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
-    }
-    catch {
-        return path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url));
-    }
-}
-if (moduloExecutadoDiretamente()) {
-    principal().catch((erro) => {
-        console.error("Falha ao executar a CLI da Sema.");
-        console.error(erro instanceof Error ? erro.stack ?? erro.message : erro);
-        process.exit(1);
-    });
-}
+export * from "./distribuicao/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.part01.d.ts

@@ -1,9 +1,10 @@
 import { compilarCodigo, type IrModulo } from "@sema/nucleo";
-import { type ContextoProjetoCarregado } from "./projeto.js";
 import { analisarDriftLegado, type OpcoesDriftLegado } from "./drift.js";
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { criarBriefingAgente, resumirDriftPorModulo } from "./index.part03.js";
-export type Comando = "iniciar" | "init" | "dev" | "sync" | "author" | "profile" | "conteudo" | "interativo" | "descobrir" | "pipeline" | "capabilities" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-codex" | "instalar-exemplos" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
+import { renderizarCaixaAscii, renderizarSecaoAscii } from './cliHelpTexto.js';
+import { criarBriefingAgente, criarBriefingAgenteContratos, resumirDriftPorModulo } from "./index.part03.js";
+import { type ComandoConsultaDrift, type ModoCacheDrift, type ResolucaoModoCacheDrift } from "./driftCacheModes.js";
+export type Comando = "iniciar" | "init" | "dev" | "sync" | "author" | "profile" | "conteudo" | "interativo" | "descobrir" | "pipeline" | "capabilities" | "validar" | "ast" | "ir" | "compilar" | "gerar" | "testar" | "diagnosticos" | "verificar" | "inspecionar" | "drift" | "impacto" | "renomear-semantico" | "importar" | "doctor" | "formatar" | "ajuda-ia" | "starter-ia" | "sync-codex" | "skill" | "instalar-exemplos" | "rule-packs" | "docs-impacto" | "finalizar-mudanca" | "resumo" | "prompt-curto" | "prompt-ia" | "prompt-ia-ui" | "prompt-ia-react" | "prompt-ia-sema-primeiro" | "exemplos-prompt-ia" | "contexto-ia";
 export interface ResultadoFormatacaoArquivo {
     caminho: string;
     alterado: boolean;
@@ -30,8 +31,6 @@ export interface DescobertaDocsIa {
 }
 export type TamanhoResumoIa = "micro" | "curto" | "medio";
 export type ModoResumoIa = "resumo" | "onboarding" | "review" | "mudanca" | "bug" | "arquitetura";
-export type ModoAnaliseDriftCli = "fresh" | "cache" | "none";
-export type PoliticaCacheDriftCli = "auto" | "refresh" | "off";
 export type ResultadoDriftIa = Awaited<ReturnType<typeof analisarDriftLegado>>;
 export type ResumoModuloDrift = ReturnType<typeof resumirDriftPorModulo>;
 export interface PacoteContextoModuloIa {
@@ -77,16 +76,14 @@ export interface PacoteContextoModuloIa {
         comando: "drift";
         caminho: string;
         modulo: string | null;
-        sucesso: boolean;
-        modoAnalise?: ModoAnaliseDriftCli;
-        executado?: boolean;
-        aviso?: string | null;
-        resumo: ResumoModuloDrift;
-        drift: ResultadoDriftIa;
+        modo: ModoCacheDrift;
+        executada: boolean;
+        sucesso: boolean | null;
+        aviso: string | null;
+        resumo: ResumoModuloDrift | null;
+        drift: ResultadoDriftIa | null;
     };
-    briefing: ReturnType<typeof criarBriefingAgente>;
-    modoVerificacaoCodigo?: ResumoSemanticoModuloIa["modoVerificacaoCodigo"];
-    fontesConclusao?: string[];
+    briefing: ReturnType<typeof criarBriefingAgente> | ReturnType<typeof criarBriefingAgenteContratos>;
 }
 export interface ResumoSemanticoModuloIa {
     geradoEm: string;
@@ -96,8 +93,8 @@ export interface ResumoSemanticoModuloIa {
     avisoVerificacaoCodigo: string | null;
     fontesConclusao: string[];
     perfilCompatibilidade: string;
-    scoreSemantico: number;
-    confiancaGeral: string;
+    scoreSemantico: number | null;
+    confiancaGeral: string | null;
     riscoOperacional: string;
     faz: string;
     tarefasPrincipais: string[];
@@ -116,29 +113,24 @@ export interface ResumoSemanticoModuloIa {
     checksSugeridos: string[];
     testesMinimos: string[];
     consumerFramework: string | null;
-    appRoutes: string[];
-    consumerSurfaces: string[];
-    consumerBridges: string[];
-    ancoragensVinculo: string[];
+    appRoutes: string[] | null;
+    consumerSurfaces: string[] | null;
+    consumerBridges: string[] | null;
+    ancoragensVinculo: string[] | null;
     arquivosProvaveisEditar: string[];
 }
 export declare const DIRETORIO_CLI_ATUAL: string;
 export declare const VERSAO_CLI: string;
+export { renderizarCaixaAscii, renderizarSecaoAscii };
 export declare function obterArgumentos(): {
     comando?: Comando;
     resto: string[];
 };
-export declare function renderizarCaixaAscii(linhas: string[]): string;
-export declare function renderizarSecaoAscii(titulo: string, linhas: string[]): string;
 export declare function ajuda(): string;
-export declare function normalizarModoAnaliseDriftCli(args: string[], padrao?: ModoAnaliseDriftCli): ModoAnaliseDriftCli;
-export declare function normalizarPoliticaCacheDriftCli(args: string[]): PoliticaCacheDriftCli | undefined;
-export declare function resolverOpcoesDriftCli(args: string[], cacheForcado?: PoliticaCacheDriftCli): OpcoesDriftLegado;
-export declare function resolverAnaliseDriftCli(args: string[], padrao?: ModoAnaliseDriftCli): {
-    modo: ModoAnaliseDriftCli;
+export declare function resolverOpcoesDriftCli(args: string[]): OpcoesDriftLegado;
+export declare function resolverAnaliseDriftConsultaCli(args: string[], comando: ComandoConsultaDrift): ResolucaoModoCacheDrift & {
     opcoes: OpcoesDriftLegado;
 };
-export declare function criarResultadoDriftNaoExecutado(contextoProjeto: ContextoProjetoCarregado, opcoes?: OpcoesDriftLegado): ResultadoDriftIa;
 export declare function normalizarTamanhoResumo(args: string[]): TamanhoResumoIa;
 export declare function normalizarModoResumo(valor?: string): ModoResumoIa;
 export declare function descobrirDocsIa(): Promise<DescobertaDocsIa>;

package/dist/index.part01.js

@@ -3,257 +3,36 @@ import { fileURLToPath } from "node:url";
 import pacoteCli from "../package.json" with { type: "json" };
 import { caminhoExiste } from './fsGovernado.js';
 import { obterOpcao, possuiFlag } from './cliArgs.js';
+import { criarAjudaRaiz, renderizarCaixaAscii, renderizarSecaoAscii } from './cliHelpTexto.js';
+import { resolverModoCacheComandoDrift, resolverModoCacheConsultaDrift, } from "./driftCacheModes.js";
 export const DIRETORIO_CLI_ATUAL = path.dirname(fileURLToPath(import.meta.url));
 export const VERSAO_CLI = pacoteCli.version;
+export { renderizarCaixaAscii, renderizarSecaoAscii };
 export function obterArgumentos() {
     const [, , comando, ...resto] = process.argv;
     return { comando: comando, resto };
 }
-export function renderizarCaixaAscii(linhas) {
-    const largura = Math.max(...linhas.map((linha) => linha.length), 12);
-    const borda = `+${"-".repeat(largura + 2)}+`;
-    return [
-        borda,
-        ...linhas.map((linha) => `| ${linha.padEnd(largura, " ")} |`),
-        borda,
-    ].join("\n");
-}
-export function renderizarSecaoAscii(titulo, linhas) {
-    return [
-        titulo,
-        ...linhas.map((linha) => `  ${linha}`),
-    ].join("\n");
-}
 export function ajuda() {
-    return [
-        renderizarCaixaAscii([
-            `Sema CLI v${VERSAO_CLI}`,
-            "IA-first para contrato, geração e adoção incremental",
-            "novo projeto, edição guiada e legado sem contrato inicial",
-        ]),
-        "",
-        renderizarSecaoAscii("Fluxos rápidos", [
-            "[1] Projeto novo / produção inicial",
-            "sema iniciar --template <base|nestjs|fastapi|nextjs-api|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer> [--force]",
-            "Arquivos existentes sao preservados; use --force somente para sobrescrita explicita.",
-            "sema validar contratos/<modulo>.sema --json",
-            "sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>",
-            "sema verificar <arquivo-ou-pasta> --json",
-            "",
-            "[2] Editar projeto que já usa Sema",
-            "sema inspecionar . --json",
-            "sema resumo <arquivo-ou-pasta> --micro --para mudanca",
-            "sema drift <arquivo-ou-pasta> --escopo modulo --json",
-            "sema impacto <arquivo-ou-pasta> --alvo <token> --mudanca <descricao> --json",
-            "sema docs-impacto --intencao \"fazer deploy\" --criar-ausentes --json",
-            "sema contexto-ia <arquivo.sema> --saida ./.tmp/contexto --json",
-            "",
-            "[3] Governar escrita autoral com Sema Author",
-            "sema author iniciar [--tema-sensivel] [--saida contratos/author.sema]",
-            "sema author validar contratos/author.sema --json",
-            "sema author briefing contratos/author.sema --json",
-            "sema author revisar-cliches contratos/author.sema --texto <texto> --json  # reprova se houver bloqueio",
-            "sema author validar-narrativa contratos/author.sema --texto <texto> --texto-anterior <texto> --json",
-            "sema author validar-proibicoes contratos/author.sema --texto <texto> --json",
-            "",
-            "[4] Validar profiles semânticos",
-            "sema profile validar workflow contratos/sema/workflow_ops.sema --maturidade production --preset webhook --artefato-arquivo workflow.md --json",
-            "sema profile validar ops contratos/sema/workflow_ops.sema --maturidade critical --preset deploy --artefato-arquivo runbook.md --json",
-            "sema profile validar game contratos/sema/game.sema --maturidade prototype --preset playtest --artefato-arquivo playtest.md --json",
-            "sema profile validar simulation contratos/sema/simulation.sema --maturidade production --preset calibration --artefato-arquivo calibration.md --json",
-            "sema profile validar redacao contratos/sema/redator.sema --maturidade production --preset seo --artefato-arquivo materia.md --json",
-            "sema profile validar propostas contratos/sema/propostas_comerciais.sema --maturidade production --preset score90 --artefato-arquivo proposta.md --json",
-            "sema profile validar conversas contratos/sema/conversas.sema --maturidade production --preset vendas --artefato-arquivo conversa.md --json",
-            "sema profile capabilities --json",
-            "sema rule-packs --profile legal --json",
-            "",
-            "[5] Descobrir a capacidade ou pipeline certo",
-            "sema descobrir catalogo --json",
-            "sema descobrir recomendar --intencao \"validar simulador 3D autonomo calibrado\" --json",
-            "sema descobrir explicar simulation.calibrate --json",
-            "sema pipeline listar --json",
-            "sema capabilities --json",
-            "",
-            "[6] Modelar jogos e simulações em qualquer combinação espacial, visual e de render",
-            "sema interativo capabilities --json",
-            "sema interativo schema --json",
-            "sema interativo pipelines --json",
-            "sema interativo adapters --spatial-model THREE_D --render-mode VISUAL --json",
-            "sema interativo validar <definition.json> --json",
-            "sema interativo planejar <definition.json> --json",
-            "sema interativo validar-evidencias <definition.json> [--plano-arquivo <plan.json>] --bundle-arquivo <bundle.json> --json",
-            "sema interativo validar-protocolo <adapter-run.json> --json",
-            "sema interativo validar-ir <experience-ir.json> --json",
-            "sema interativo consultar-ir <experience-ir.json> --semantic-id <id> --json",
-            "sema interativo validar-engine-snapshot <snapshot.json> --json",
-            "sema interativo validar-temporal <temporal.json> --json",
-            "sema interativo validar-autonomia <cycle.json> --json",
-            "sema interativo validar-playtest-fuzz <plan.json> --json",
-            "sema interativo validar-multiplayer <model.json> --json",
-            "sema interativo analisar-portabilidade <plan.json> --json",
-            "sema interativo validar-workers <plan.json> --json",
-            "",
-            "[7] Orquestrar criação de conteúdo por IA",
-            "sema conteudo capabilities --json",
-            "sema conteudo validar <definition.json> --json",
-            "sema conteudo planejar <definition.json> --alvos-arquivo <targets.json> --json",
-            "sema conteudo registrar <ledger.ndjson> --envelope-arquivo <envelope.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-id <id> --expected-head <sha256:...> --json",
-            "sema conteudo status <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --json",
-            "",
-            "[8] Adotar Sema em projeto que ainda não usa",
-            "sema importar <fonte> <diretorio> --saida <diretorio> --json",
-            "sema formatar <arquivo-ou-pasta>",
-            "sema validar <arquivo-ou-pasta> --json",
-            "sema drift <arquivo-ou-pasta> --escopo modulo --json",
-        ]),
-        "",
-        renderizarSecaoAscii("IA por capacidade", [
-            "fraca: sema resumo <arquivo> --micro --json (stdout compacto)",
-            "média: sema resumo <arquivo> --curto --json + sema drift <arquivo> --json",
-            "forte: sema contexto-ia <arquivo.sema> --saida <diretorio> --json",
-        ]),
-        "",
-        renderizarSecaoAscii("Comandos principais", [
-            "descoberta: sema inspecionar [arquivo-ou-pasta] [--drift <fresh|cache|none>|--com-drift] [--json] (padrão: none)",
-            "catálogo: sema descobrir <catalogo|recomendar|explicar> [id] [--intencao <objetivo>] [--json]",
-            "pipelines: sema pipeline <listar|descrever> [id] [--json]",
-            "todas as capacidades: sema capabilities [--json]",
-            "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <auto|refresh|off>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
-            "impacto: sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--json]",
-            "renomeação: sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--escopo <arquivo|modulo|projeto>] [--json]",
-            "importação: sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|php|typescript|python|dart> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]",
-            "validação: sema validar <arquivo-ou-pasta> [--json]",
-            "diagnóstico: sema diagnosticos <arquivo.sema> [--json]",
-            "geração: sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio> [--estrutura <flat|modulos|backend>] [--framework <base|nestjs|fastapi>]",
-            "teste local: sema testar <arquivo.sema> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio-temporario> [--estrutura <flat|modulos|backend>] [--framework <base|nestjs|fastapi>]",
-            "aliases nativos: cs|csharp -> dotnet; c++|cxx|cc -> cpp (CLI e sema.config.json)",
-            "verificação final: sema verificar <arquivo-ou-pasta> [--saida <diretorio-base>] [--json]",
-            "formatação: sema formatar <arquivo-ou-pasta> [--check] [--json]",
-            "author: sema author <iniciar|validar|briefing|revisar-cliches|validar-narrativa|validar-proibicoes> [arquivo] [--tema-sensivel] [--preset conto|romance|roteiro|lore|campanha] [--saida <arquivo>] [--texto <texto>] [--json]",
-            "profile: sema profile validar <software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas> <arquivo-ou-pasta> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
-            "capabilities: sema profile capabilities [--json]",
-            "conteúdo: sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
-            "interativo: sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
-            "rule packs: sema rule-packs [--profile <author|software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas>] [--json]",
-        ]),
-        "",
-        renderizarSecaoAscii("Ajuda IA-first", [
-            "sema ajuda-ia",
-            "sema starter-ia",
-            "sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <fresh|cache|none>] [--saida <diretorio>] [--raiz] [--json]",
-            "sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--json]",
-            "sema prompt-ia",
-            "sema prompt-ia-ui",
-            "sema prompt-ia-react",
-            "sema prompt-ia-sema-primeiro",
-            "sema exemplos-prompt-ia",
-            "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
-            "sema sync-codex [--json]",
-            "sema instalar-exemplos [--json]",
-            "sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--json]",
-            "sema finalizar-mudanca --intencao <acao> [--arquivo <caminho>] [--doc-lida <caminho>] [--json]",
-            "sema author briefing <arquivo.sema> [--json]",
-            "sema author revisar-cliches <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--texto-anterior <texto>|--texto-anterior-arquivo <arquivo>] [--json]",
-            "sema author validar-narrativa <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--json]",
-            "sema author validar-proibicoes <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--json]",
-            "sema profile validar <profile> <arquivo.sema> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
-            "sema profile capabilities [--json]",
-            "sema descobrir <catalogo|recomendar|explicar> [id] [--intencao <objetivo>] [--json]",
-            "sema pipeline <listar|descrever> [id] [--json]",
-            "sema capabilities [--json]",
-            "sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
-            "sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
-            "sema rule-packs [--profile <profile>] [--json]",
-        ]),
-        "",
-        renderizarSecaoAscii("Operacional", [
-            "sema doctor",
-            "sema --versao | --version | -v",
-        ]),
-    ].join("\n");
-}
-export function normalizarModoAnaliseDriftCli(args, padrao = "fresh") {
-    const valor = obterOpcao(args, "--drift");
-    if (valor === undefined)
-        return possuiFlag(args, "--com-drift") ? "fresh" : padrao;
-    if (valor === "fresh" || valor === "cache" || valor === "none")
-        return valor;
-    throw new Error("Use --drift fresh, --drift cache ou --drift none.");
+    return criarAjudaRaiz(VERSAO_CLI);
 }
-export function normalizarPoliticaCacheDriftCli(args) {
-    const valor = obterOpcao(args, "--cache");
-    if (valor === undefined)
-        return undefined;
-    if (valor === "auto" || valor === "refresh" || valor === "off")
-        return valor;
-    throw new Error("Use --cache auto, --cache refresh ou --cache off.");
-}
-export function resolverOpcoesDriftCli(args, cacheForcado) {
+function criarOpcoesDriftCli(args, resolucao) {
     const escopo = obterOpcao(args, "--escopo");
-    const cache = cacheForcado ?? normalizarPoliticaCacheDriftCli(args);
     return {
         escopo: escopo === "arquivo" || escopo === "modulo" || escopo === "projeto" ? escopo : undefined,
         ignorarWorktrees: !possuiFlag(args, "--incluir-worktrees"),
         ignorarConsumidoresLaterais: !possuiFlag(args, "--incluir-consumidores-laterais"),
-        ...(cache ? { cache } : {}),
+        modoCache: resolucao.modo,
+        avisosModoCache: resolucao.avisos,
     };
 }
-export function resolverAnaliseDriftCli(args, padrao = "fresh") {
-    const modo = normalizarModoAnaliseDriftCli(args, padrao);
-    const cache = modo === "fresh" ? "refresh" : modo === "cache" ? "auto" : undefined;
-    return {
-        modo,
-        opcoes: resolverOpcoesDriftCli(args, cache),
-    };
+export function resolverOpcoesDriftCli(args) {
+    return criarOpcoesDriftCli(args, resolverModoCacheComandoDrift(args));
 }
-export function criarResultadoDriftNaoExecutado(contextoProjeto, opcoes) {
-    const escopo = opcoes?.escopo === "arquivo" || opcoes?.escopo === "projeto" ? opcoes.escopo : "modulo";
+export function resolverAnaliseDriftConsultaCli(args, comando) {
+    const resolucao = resolverModoCacheConsultaDrift(args, comando);
     return {
-        comando: "drift",
-        sucesso: false,
-        escopo_aplicado: {
-            escopo,
-            ignorarWorktrees: opcoes?.ignorarWorktrees !== false,
-            ignorarConsumidoresLaterais: opcoes?.ignorarConsumidoresLaterais !== false,
-            termosEscopo: [],
-        },
-        consumerFramework: null,
-        appRoutes: [],
-        consumerSurfaces: [],
-        consumerBridges: [],
-        modulos: contextoProjeto.modulosSelecionados.map((item) => ({
-            caminho: item.caminho,
-            modulo: item.resultado.modulo?.nome ?? null,
-            tasks: item.resultado.ir?.tasks.length ?? 0,
-            routes: item.resultado.ir?.routes.length ?? 0,
-        })),
-        tasks: [],
-        impls_validos: [],
-        impls_quebrados: [],
-        vinculos_validos: [],
-        vinculos_quebrados: [],
-        rotas_divergentes: [],
-        recursos_validos: [],
-        recursos_divergentes: [],
-        persistencia_real: [],
-        resumo_operacional: {
-            scoreMedio: 0,
-            confiancaGeral: "baixa",
-            pontuacaoMinimaOperacional: 80,
-            pontuacaoAlvoAtual: 80,
-            pontuacaoAlvoFinal: 100,
-            passoEvolucaoPontuacao: 0.5,
-            proximaPontuacaoAlvo: 80,
-            pontuacaoAbaixoDoPiso: false,
-            pontuacaoAbaixoDoAlvo: false,
-            travasPontuacao: [],
-            riscosPrincipais: ["analise_drift_nao_executada"],
-            oQueTocar: [],
-            oQueValidar: ["executar sema drift antes de concluir sobre a implementação"],
-            oQueEstaFrouxo: ["codigo_nao_verificado_neste_modo"],
-            oQueFoiInferido: ["modo_contratos_apenas"],
-        },
-        diagnosticos: [],
+        ...resolucao,
+        opcoes: criarOpcoesDriftCli(args, resolucao),
     };
 }
 export function normalizarTamanhoResumo(args) {
@@ -327,9 +106,9 @@ export function renderizarCabecalhoDocsIa(descoberta) {
         "Modo IA-first da instalacao atual",
         "- Use `sema` como interface publica principal.",
         "- A Sema entra em projeto novo, projeto ja semantizado e adocao incremental em legado sem contrato inicial.",
-        "- Nao assuma monorepo, `node pacotes/cli/dist/index.js`, `npm run project:check` ou uma pasta `exemplos` externa ao projeto atual.",
-        "- Se a IA tiver contexto curto, comece por `sema resumo` e `sema prompt-curto`.",
-        "- Se a IA aguentar mais contexto, suba para `sema drift --json` e `sema contexto-ia`.",
+        "- Nao assuma monorepo, `node pacotes/cli/dist/bin.js`, `npm run project:check` ou uma pasta `exemplos` externa ao projeto atual.",
+        "- Se a IA tiver contexto curto, comece por `sema resumo --drift none` e `sema prompt-curto`; implementação e score ficam não avaliados.",
+        "- Se a IA aguentar mais contexto e precisar de evidência viva, suba para `sema drift --cache fresh --json` e `sema contexto-ia`.",
         "- So leia `ast.json` e `ir.json` completos quando a capacidade da IA realmente aguentar esse volume.",
     ];
     if (documentos.length > 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[];