@semacode/cli 2.2.0 → 2.3.1

package/dist/index.js

@@ -1,6 +1,9 @@
 #!/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";
 export * from "./index.part01.js";
 export * from "./index.part08.js";
@@ -9,9 +12,24 @@ export { validarProfileSemantico } from "./profileCommand.js";
 export { materializarExemplosOficiais } from "./exemplosOficiais.js";
 export { expandirIntencaoSemanticaProfile, sugerirStarterPresetProfile, validarPipelineProfiles, exigirQaCriativoQuandoPublicavel, catalogoDropdownOnboarding } from "./profileOrquestracao.js";
 export * from "./pipelineConteudo/index.js";
-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 "./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);
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/index.part01.d.ts

@@ -1,8 +1,9 @@
 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" | "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";
+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";
 export interface ResultadoFormatacaoArquivo {
     caminho: string;
     alterado: boolean;
@@ -29,6 +30,8 @@ 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 {
@@ -75,10 +78,15 @@ export interface PacoteContextoModuloIa {
         caminho: string;
         modulo: string | null;
         sucesso: boolean;
+        modoAnalise?: ModoAnaliseDriftCli;
+        executado?: boolean;
+        aviso?: string | null;
         resumo: ResumoModuloDrift;
         drift: ResultadoDriftIa;
     };
     briefing: ReturnType<typeof criarBriefingAgente>;
+    modoVerificacaoCodigo?: ResumoSemanticoModuloIa["modoVerificacaoCodigo"];
+    fontesConclusao?: string[];
 }
 export interface ResumoSemanticoModuloIa {
     geradoEm: string;
@@ -123,7 +131,14 @@ export declare function obterArgumentos(): {
 export declare function renderizarCaixaAscii(linhas: string[]): string;
 export declare function renderizarSecaoAscii(titulo: string, linhas: string[]): string;
 export declare function ajuda(): string;
-export declare function resolverOpcoesDriftCli(args: string[]): OpcoesDriftLegado;
+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;
+    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

@@ -60,20 +60,47 @@ export function ajuda() {
             "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] Orquestrar criação de conteúdo por IA",
+            "[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",
             "",
-            "[6] Adotar Sema em projeto que ainda não usa",
+            "[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",
@@ -87,8 +114,11 @@ export function ajuda() {
         ]),
         "",
         renderizarSecaoAscii("Comandos principais", [
-            "descoberta: sema inspecionar [arquivo-ou-pasta] [--json]",
-            "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
+            "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]",
@@ -100,16 +130,17 @@ export function ajuda() {
             "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|legal|research|redacao|propostas|conversas> <arquivo-ou-pasta> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--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]",
-            "rule packs: sema rule-packs [--profile <author|software|workflow|ops|game|legal|research|redacao|propostas|conversas>] [--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>] [--saida <diretorio>] [--raiz] [--json]",
+            "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",
@@ -127,6 +158,10 @@ export function ajuda() {
             "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]",
         ]),
@@ -137,12 +172,88 @@ export function ajuda() {
         ]),
     ].join("\n");
 }
-export function resolverOpcoesDriftCli(args) {
+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.");
+}
+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) {
     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 } : {}),
+    };
+}
+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 criarResultadoDriftNaoExecutado(contextoProjeto, opcoes) {
+    const escopo = opcoes?.escopo === "arquivo" || opcoes?.escopo === "projeto" ? opcoes.escopo : "modulo";
+    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: [],
     };
 }
 export function normalizarTamanhoResumo(args) {

package/dist/index.part02.js

@@ -320,27 +320,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

@@ -1,7 +1,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 { PacoteContextoModuloIa, ResumoSemanticoModuloIa, type ModoAnaliseDriftCli } from "./index.part01.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 +52,7 @@ export declare function criarBriefingAgente(arquivo: string, modulo: string, ir:
     ancoragensVinculo: string[];
     testesMinimos: string[];
 };
-export declare function carregarContextoModuloIa(arquivoEntrada: string): Promise<PacoteContextoModuloIa>;
+export declare function carregarContextoModuloIa(arquivoEntrada: string, args?: string[], modoDriftPadrao?: ModoAnaliseDriftCli): Promise<PacoteContextoModuloIa>;
 export declare const ARQUIVOS_RESUMO_MODULO_IA: readonly ["SEMA_BOOT.md", "SEMA_SMALL_MODEL.md", "agent-context-pack.json", "resumo.micro.txt", "resumo.curto.txt", "resumo.md", "briefing.min.json", "prompt-curto.txt"];
 export declare function gerarArquivosResumoModuloIa(contexto: PacoteContextoModuloIa, pastaBase: string): Promise<{
     artefatosCompactos: string[];

package/dist/index.part03.js

@@ -8,6 +8,7 @@ import { criarEntradaCanonicaProjeto } from './agentContext.js';
 import { renderizarSemaBoot, renderizarSemaSmallModel, } from './agentEntryPoints.js';
 import { escreverArquivoWorkspaceSeguro, validarDestinosEscritaWorkspace } from './workspaceWrite.js';
 import { resumirListaTexto } from './textoListas.js';
+import { criarResultadoDriftNaoExecutado, resolverAnaliseDriftCli, } from "./index.part01.js";
 import { coletarResumoSemanticoModulo, criarBriefingMinimo, criarPromptCurtoModulo, renderizarResumoModuloMarkdown, renderizarResumoModuloTexto } from "./index.part02.js";
 export function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade) {
     const entradaCanonica = criarEntradaCanonicaProjeto(guiaPorCapacidade);
@@ -253,10 +254,11 @@ export function criarBriefingAgente(arquivo, modulo, ir, resumoDrift, resultadoD
         ],
     };
 }
-export async function carregarContextoModuloIa(arquivoEntrada) {
+export async function carregarContextoModuloIa(arquivoEntrada, args = [], modoDriftPadrao = "fresh") {
     const arquivo = path.resolve(arquivoEntrada);
     garantirArquivoSema(arquivo);
-    const contextoProjeto = await carregarProjeto(arquivo, process.cwd());
+    const analiseDrift = resolverAnaliseDriftCli(args, modoDriftPadrao);
+    const contextoProjeto = await carregarProjeto(arquivo, process.cwd(), { escopo: analiseDrift.opcoes.escopo });
     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,12 +266,19 @@ 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.modo === "none"
+        ? criarResultadoDriftNaoExecutado(contextoProjeto, analiseDrift.opcoes)
+        : await analisarDriftLegado(contextoProjeto, analiseDrift.opcoes);
     const drift = {
         comando: "drift",
         caminho: arquivo,
         modulo: resultadoModulo.modulo?.nome ?? null,
         sucesso: resultadoDrift.sucesso,
+        modoAnalise: analiseDrift.modo,
+        executado: analiseDrift.modo !== "none",
+        aviso: analiseDrift.modo === "none"
+            ? "Análise de drift não executada; nenhuma conclusão sobre o código foi produzida."
+            : null,
         resumo: resumirDriftPorModulo(resultadoModulo.modulo?.nome ?? null, arquivo, resultadoDrift),
         drift: resultadoDrift,
     };
@@ -321,6 +330,8 @@ export async function carregarContextoModuloIa(arquivoEntrada) {
         irJson: ir,
         drift,
         briefing,
+        modoVerificacaoCodigo: analiseDrift.modo === "none" ? "contratos_apenas" : undefined,
+        fontesConclusao: analiseDrift.modo === "none" ? ["contrato"] : undefined,
     };
 }
 export const ARQUIVOS_RESUMO_MODULO_IA = [

package/dist/index.part04.d.ts

@@ -1,7 +1,7 @@
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
-import { ContextoIaGerado, ResumoSemanticoModuloIa } from "./index.part01.js";
+import { ContextoIaGerado, ResumoSemanticoModuloIa, type ModoAnaliseDriftCli } from "./index.part01.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, args?: string[], modoDriftPadrao?: ModoAnaliseDriftCli): Promise<{
     geradoEm: string;
     baseProjeto: string;
     pastaSaida: string;