@semacode/cli 2.3.1 → 3.0.0

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));

package/dist/index.part06.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: resume contrato ou projeto com política explícita de análise de drift.
 import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { compilarCodigo, formatarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from "@sema/nucleo";
@@ -13,7 +13,7 @@ import { carregarModulos } from './carregarModulos.js';
 import { obterOpcao, possuiFlag } from './cliArgs.js';
 import { EXEMPLOS_PROMPT_IA, PROMPT_BASE_IA, PROMPT_IA_REACT, PROMPT_IA_SEMA_PRIMEIRO, PROMPT_IA_UI, STARTER_IA } from './iaPrompts.js';
 import { aplicarEstruturaSaida, gerarArquivosPorAlvo, garantirIr, validarCompatibilidadeFramework, } from './geracaoCore.js';
-import { descobrirDocsIa, normalizarModoResumo, normalizarTamanhoResumo, renderizarCabecalhoDocsIa, renderizarCaixaAscii, renderizarSecaoAscii } from "./index.part01.js";
+import { descobrirDocsIa, normalizarModoResumo, normalizarTamanhoResumo, renderizarCabecalhoDocsIa, renderizarCaixaAscii, renderizarSecaoAscii, resolverAnaliseDriftConsultaCli } from "./index.part01.js";
 import { gerarResumoProjetoIa } from "./index.part04.js";
 import { carregarContextoModuloIa, gerarArquivosResumoModuloIa } from "./index.part03.js";
 import { coletarResumoSemanticoModulo, renderizarResumoModuloMarkdown, renderizarResumoModuloTexto } from "./index.part02.js";
@@ -121,7 +121,11 @@ export async function comandoStarterIa() {
     return 0;
 }
 export async function comandoSyncCodex(emJson) {
-    const resumoProjeto = await gerarResumoProjetoIa(process.cwd(), undefined, true);
+    const resumoProjeto = await gerarResumoProjetoIa(process.cwd(), undefined, true, {
+        modo: "fresh",
+        executar: true,
+        avisos: [],
+    });
     const exemplos = await materializarExemplosOficiais(resumoProjeto.baseProjeto, true);
     if (!exemplos.sucesso) {
         if (emJson) {
@@ -196,8 +200,8 @@ export async function comandoAjudaIa() {
     ]));
     console.log("");
     console.log(renderizarSecaoAscii("Capacidade de IA", [
-        "fraca: `sema resumo <arquivo> --micro --json` usa stdout compacto",
-        "média: `sema resumo <arquivo> --curto --json` + `sema drift <arquivo> --json`",
+        "fraca: `sema resumo <arquivo> --micro --drift none --json` usa stdout compacto sem inventar evidência de implementação",
+        "média: `sema resumo <arquivo> --curto --drift none --json` + `sema drift <arquivo> --cache fresh --json`",
         "forte: `sema contexto-ia <arquivo.sema> --saida <diretorio> --json` materializa o pacote completo",
     ]));
     console.log("");
@@ -208,14 +212,13 @@ export async function comandoAjudaIa() {
         "Use `sema interativo pipelines --json` para jogos, simulações e híbridos 3D, 2D, retro, texto, XR ou headless.",
         "Use `sema sync-codex` para regenerar o contexto governado do Codex na raiz.",
         "Use `sema instalar-exemplos` para materializar `exemplos/` oficiais sem sobrescrever arquivos locais.",
-        "Use `sema resumo <arquivo> --micro --para onboarding --json` para IA fraca; o resumo vem no stdout.",
-        "Use `--drift fresh|cache|none` em `resumo` para escolher análise nova, cache válido ou somente contratos; `--micro` usa `none` por padrão e os demais usam `fresh`.",
+        "Use `sema resumo <arquivo> --micro --para onboarding --drift none --json` para IA fraca; o resumo contratual vem no stdout e campos derivados ficam não avaliados.",
         "Se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo; timeout do agente nao e falha do Sema.",
         "Use `sema prompt-curto <arquivo> --curto --para mudanca` para colar contexto em modelo gratuito.",
         "Use `sema prompt-ia`, `sema prompt-ia-ui`, `sema prompt-ia-react` e `sema prompt-ia-sema-primeiro` conforme a tarefa.",
         "Use `sema exemplos-prompt-ia` para pegar modelos prontos de prompt.",
-        "Use `sema inspecionar` para descobrir base, codigo vivo e fontes legado.",
-        "Use `sema drift` para medir impls, vinculos, rotas, score e lacunas.",
+        "Use `sema inspecionar --drift none` para descobrir a superfície contratual sem executar drift implicitamente.",
+        "Use `sema drift --cache fresh` para medir impls, vínculos, rotas, score e lacunas no fechamento; cache é aceleração, não prova final.",
         "Use `sema docs-impacto --intencao <acao>` para ler ou criar docs obrigatorias antes de agir.",
         "Use `sema finalizar-mudanca --intencao <acao>` para bloquear conclusao sem leitura documental comprovada.",
         "Use `sema contexto-ia <arquivo.sema> --saida <diretorio> --json` para gerar AST, IR, drift, `briefing.json` e `briefing.min.json`.",
@@ -287,8 +290,10 @@ export async function comandoResumo(entrada, args, emJson) {
     const pastaSaida = obterOpcao(args, "--saida");
     const escreverNaRaiz = possuiFlag(args, "--raiz");
     const alvo = entrada ? path.resolve(process.cwd(), entrada) : process.cwd();
-    if (entrada && entrada.toLowerCase().endsWith(".sema")) {
-        const contexto = await carregarContextoModuloIa(alvo, args, tamanho === "micro" ? "none" : "fresh");
+    const analiseDrift = resolverAnaliseDriftConsultaCli(args, "resumo");
+    const alvoEhArquivo = (await stat(alvo)).isFile();
+    if (alvoEhArquivo) {
+        const contexto = await carregarContextoModuloIa(alvo, analiseDrift);
         const resumoSemantico = coletarResumoSemanticoModulo(contexto);
         const guiaPorCapacidade = criarGuiaCapacidadeIa();
         const texto = tamanho === "medio"
@@ -312,20 +317,28 @@ export async function comandoResumo(entrada, args, emJson) {
                 modulo: contexto.modulo,
                 pastaSaida: pastaResumo ?? null,
                 artefatosCompactos,
+                analiseDrift: {
+                    modo: contexto.drift.modo,
+                    executada: contexto.drift.executada,
+                    sucesso: contexto.drift.sucesso,
+                    aviso: contexto.drift.aviso,
+                    avisos: analiseDrift.avisos,
+                    cache: contexto.drift.drift?.escopo_aplicado.cache ?? null,
+                },
                 guiaPorCapacidade,
                 resumo: resumoSemantico,
                 texto,
             }, null, 2));
-            return 0;
+            return contexto.drift.sucesso === false ? 1 : 0;
         }
         if (pastaResumo) {
             console.log(`Resumo IA-first gerado em ${pastaResumo}`);
             console.log("");
         }
         console.log(texto);
-        return 0;
+        return contexto.drift.sucesso === false ? 1 : 0;
     }
-    const resumoProjeto = await gerarResumoProjetoIa(alvo, pastaSaida, escreverNaRaiz, args, tamanho === "micro" ? "none" : "fresh");
+    const resumoProjeto = await gerarResumoProjetoIa(alvo, pastaSaida, escreverNaRaiz, analiseDrift);
     const arquivoResumo = tamanho === "micro"
         ? "SEMA_BRIEF.micro.txt"
         : tamanho === "curto"
@@ -341,15 +354,19 @@ export async function comandoResumo(entrada, args, emJson) {
             baseProjeto: resumoProjeto.baseProjeto,
             pastaSaida: resumoProjeto.pastaSaida,
             artefatos: resumoProjeto.artefatos,
+            analiseDrift: {
+                ...resumoProjeto.analiseDrift,
+                avisos: analiseDrift.avisos,
+            },
             guiaPorCapacidade: resumoProjeto.guiaPorCapacidade,
             modulos: resumoProjeto.modulos,
             texto,
         }, null, 2));
-        return 0;
+        return resumoProjeto.analiseDrift.sucesso === false ? 1 : 0;
     }
     console.log(`Resumo IA-first do projeto gerado em ${resumoProjeto.pastaSaida}`);
     console.log("");
     console.log(texto);
-    return 0;
+    return resumoProjeto.analiseDrift.sucesso === false ? 1 : 0;
 }
 //# sourceMappingURL=index.part06.js.map

package/dist/index.part07.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: preserva modos explícitos nas superfícies auxiliares de contexto.
 import { readFile } from "node:fs/promises";
 import path from "node:path";
 import { compilarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from "@sema/nucleo";
@@ -17,7 +17,11 @@ export async function comandoPromptCurto(entrada, args, emJson) {
     const modo = normalizarModoResumo(obterOpcao(args, "--para"));
     const alvo = entrada ? path.resolve(process.cwd(), entrada) : process.cwd();
     if (entrada && entrada.toLowerCase().endsWith(".sema")) {
-        const contexto = await carregarContextoModuloIa(alvo);
+        const contexto = await carregarContextoModuloIa(alvo, {
+            modo: "none",
+            executar: false,
+            avisos: [],
+        });
         const resumoSemantico = coletarResumoSemanticoModulo(contexto);
         const capacidade = tamanho === "micro" ? "fraca" : tamanho === "curto" ? "media" : "forte";
         const prompt = criarPromptCurtoModulo(resumoSemantico, modo, tamanho, capacidade);

package/dist/index.part08.d.ts

@@ -1 +1 @@
-export declare function principal(): Promise<void>;
+export declare function principal(): Promise<number>;

package/dist/index.part08.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, sema.produto.cli_invocacao_publica, sema.produto.cli_invocacao_publica.argumentos
+// Descrição: encaminha argumentos validados para as consultas e o comando de drift.
 import path from "node:path";
 import { carregarConfiguracaoProjeto, resolverAlvoPadrao, resolverEstruturaSaidaPadrao, resolverFrameworkPadrao, resolverSaidaPadrao, } from "./projeto.js";
 import { REGISTRO_COMANDOS } from "./comandos.js";
@@ -7,32 +7,31 @@ import { comandoIniciar, comandoInstalarExemplos } from './initCommand.js';
 import { obterOpcao, obterPosicionais, possuiFlag } from './cliArgs.js';
 import { comandoAuthor, comandoProfile, criarPayloadRulePacks, normalizarProfileGovernanca, renderizarRulePacksTexto } from './profileAuthorCommand.js';
 import { comandoDoctor } from './doctorCommand.js';
+import { erroArgumentoInvalido, erroComandoDesconhecido } from './cliControlError.js';
+import { validarSintaxeInvocacaoPublica } from './cliGrammar.js';
 import { normalizarFonteImportacao, normalizarTemplateIniciar, } from './geracaoCore.js';
-import { VERSAO_CLI, ajuda, obterArgumentos } from "./index.part01.js";
+import { obterArgumentos } from "./index.part01.js";
 import { comandoDocsImpacto, comandoFinalizarMudanca, comandoValidar, comandoValidarJson } from "./index.part04.js";
 import { comandoAst, comandoAstJson, comandoDrift, comandoImpacto, comandoImportar, comandoInspecionar, comandoIr, comandoIrJson, comandoRenomearSemantico } from "./index.part05.js";
 import { comandoAjudaIa, comandoCompilar, comandoDiagnosticos, comandoExemplosPromptIa, comandoFormatar, comandoPromptIa, comandoPromptIaReact, comandoPromptIaSemaPrimeiro, comandoPromptIaUi, comandoResumo, comandoStarterIa, comandoSyncCodex } from "./index.part06.js";
 import { comandoContextoIa, comandoPromptCurto, comandoTestar, comandoVerificar, comandoVerificarJson } from "./index.part07.js";
 export async function principal() {
+    const argvPublico = process.argv.slice(2);
+    const sintaxe = validarSintaxeInvocacaoPublica(argvPublico);
+    if (!sintaxe.dispatchPermitido)
+        return 0;
     const { comando, resto } = obterArgumentos();
-    const comandoCru = process.argv[2];
-    if (comandoCru === "--versao" || comandoCru === "--version" || comandoCru === "-v") {
-        console.log(VERSAO_CLI);
-        process.exit(0);
-    }
-    if (!comando || comandoCru === "--help" || comandoCru === "-h") {
-        console.log(ajuda());
-        process.exit(0);
-    }
-    const cwd = process.cwd();
+    if (!comando)
+        return 0;
     const posicionais = obterPosicionais(resto);
-    let codigoSaida = 0;
+    const modoJson = argvPublico.includes("--json");
+    const cwd = process.cwd();
     // --- Comandos registrados via REGISTRO_COMANDOS (guard, init, dev, sync) ---
     const handlerRegistrado = REGISTRO_COMANDOS[comando];
     if (handlerRegistrado) {
-        codigoSaida = await handlerRegistrado(posicionais, resto, possuiFlag(resto, "--json"));
-        process.exit(codigoSaida);
+        return handlerRegistrado(posicionais, resto, modoJson);
     }
+    let codigoSaida = 0;
     switch (comando) {
         case "iniciar":
             codigoSaida = await comandoIniciar(cwd, normalizarTemplateIniciar(obterOpcao(resto, "--template")), { force: possuiFlag(resto, "--force") });
@@ -58,13 +57,13 @@ export async function principal() {
             break;
         case "ast":
             codigoSaida = possuiFlag(resto, "--json")
-                ? await comandoAstJson(resto[0] ?? "")
-                : await comandoAst(resto[0] ?? "");
+                ? await comandoAstJson(posicionais[0] ?? "")
+                : await comandoAst(posicionais[0] ?? "");
             break;
         case "ir":
             codigoSaida = possuiFlag(resto, "--json")
-                ? await comandoIrJson(resto[0] ?? "")
-                : await comandoIr(resto[0] ?? "");
+                ? await comandoIrJson(posicionais[0] ?? "")
+                : await comandoIr(posicionais[0] ?? "");
             break;
         case "compilar":
             {
@@ -120,9 +119,7 @@ export async function principal() {
             {
                 const fonte = normalizarFonteImportacao(posicionais[0]);
                 if (!fonte || !posicionais[1]) {
-                    console.error("Uso: 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]");
-                    codigoSaida = 1;
-                    break;
+                    throw erroArgumentoInvalido();
                 }
                 codigoSaida = await comandoImportar(fonte, path.resolve(cwd, posicionais[1]), path.resolve(cwd, obterOpcao(resto, "--saida", "./sema/importado")), obterOpcao(resto, "--namespace"), possuiFlag(resto, "--json"));
             }
@@ -176,10 +173,8 @@ export async function principal() {
             codigoSaida = await comandoContextoIa(posicionais[0] ?? "", obterOpcao(resto, "--saida"), possuiFlag(resto, "--json"));
             break;
         default:
-            console.log(ajuda());
-            codigoSaida = 1;
-            break;
+            throw erroComandoDesconhecido();
     }
-    process.exit(codigoSaida);
+    return codigoSaida;
 }
 //# sourceMappingURL=index.part08.js.map

package/dist/initCommand.js

@@ -11,7 +11,11 @@ async function sincronizarKitIaInicial(cwd) {
         import("./index.part04.js"),
         import("./agentEntryPoints.js"),
     ]);
-    const resumoProjeto = await gerarResumoProjetoIa(cwd, undefined, true);
+    const resumoProjeto = await gerarResumoProjetoIa(cwd, undefined, true, {
+        modo: "fresh",
+        executar: true,
+        avisos: [],
+    });
     const indexJson = JSON.parse(fs.readFileSync(path.join(resumoProjeto.pastaSaida, "SEMA_INDEX.json"), "utf8"));
     const codex = await sincronizarEntrypointCodex(resumoProjeto.baseProjeto, indexJson.agentContextPack);
     return {