@semacode/cli 2.3.0 → 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,10 +10,22 @@ import { escreverArquivos, formatarAvisoArtefatosGeradosAcimaDoLimite, } from '.
 import { carregarModulos } from './carregarModulos.js';
 import { obterOpcao } from './cliArgs.js';
 import { resumirDriftPorModulo } from "./index.part03.js";
-import { resolverOpcoesDriftCli } from "./index.part01.js";
-export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
-    const contextoProjeto = await carregarProjeto(entrada, cwd);
-    const resultadoDrift = await analisarDriftLegado(contextoProjeto);
+import { resolverAnaliseDriftConsultaCli, resolverOpcoesDriftCli } from "./index.part01.js";
+export async function comandoInspecionar(entrada, emJson, cwd = process.cwd(), args = []) {
+    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)
+        : null;
     const framework = resolverFrameworkPadrao(undefined, contextoProjeto.configCarregada);
     const estruturaSaida = resolverEstruturaSaidaPadrao(undefined, framework, contextoProjeto.configCarregada);
     const alvos = resolverAlvosVerificacao(contextoProjeto.configCarregada);
@@ -29,12 +44,22 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
             diretoriosCodigo: contextoProjeto.diretoriosCodigo,
             fontesLegado: contextoProjeto.fontesLegado,
             modoAdocao: contextoProjeto.modoAdocao,
-            scoreDrift: resultadoDrift.resumo_operacional.scoreMedio,
-            confiancaGeral: resultadoDrift.resumo_operacional.confiancaGeral,
-            consumerFramework: resultadoDrift.consumerFramework,
-            appRoutes: resultadoDrift.appRoutes,
-            consumerSurfaces: resultadoDrift.consumerSurfaces,
-            consumerBridges: resultadoDrift.consumerBridges,
+            analiseDrift: {
+                modo: analiseDrift.modo,
+                executada: analiseDrift.executar,
+                sucesso: resultadoDrift?.sucesso ?? null,
+                aviso: analiseDrift.executar
+                    ? null
+                    : "Análise de drift não executada; implementação, vínculos e rotas não foram verificados.",
+                avisos: analiseDrift.avisos,
+                cache: resultadoDrift?.escopo_aplicado.cache ?? 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,
@@ -44,25 +69,38 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
                 sucesso: !temErros(item.resultado.diagnosticos),
                 diagnosticos: item.resultado.diagnosticos.length,
                 superficies: item.resultado.ir?.superficies.map((superficie) => `${superficie.tipo}:${superficie.nome}`) ?? [],
-                implementacao: resumirDriftPorModulo(item.resultado.modulo?.nome ?? null, item.caminho, resultadoDrift),
+                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(`- Score medio de drift: ${payload.configuracao.scoreDrift}`);
-    console.log(`- Confianca geral: ${payload.configuracao.confiancaGeral}`);
-    console.log("- Saidas por alvo:");
+    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(`- 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("- Saídas por alvo:");
     for (const [alvo, saida] of Object.entries(payload.configuracao.saidas)) {
         console.log(`  - ${alvo}: ${saida}`);
     }
@@ -70,30 +108,63 @@ export async function comandoInspecionar(entrada, emJson, cwd = process.cwd()) {
     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("- 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(`    impls validos=${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}`);
+        if (modulo.implementacao) {
+            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}`);
+            }
+        }
+        else {
+            console.log("    implementação: não verificada neste modo");
         }
     }
-    return 0;
+    return codigoSaida;
 }
 export async function comandoDrift(entrada, args, emJson, cwd = process.cwd()) {
-    const contextoProjeto = await carregarProjeto(entrada, cwd);
-    const resultado = await analisarDriftLegado(contextoProjeto, resolverOpcoesDriftCli(args));
+    const opcoes = resolverOpcoesDriftCli(args);
+    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));
         return resultado.sucesso ? 0 : 1;
     }
     console.log("Drift entre Sema e codigo legado");
     console.log(`- Escopo aplicado: ${resultado.escopo_aplicado.escopo}`);
+    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(`- 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"}`);
     console.log(`- Modulos analisados: ${resultado.modulos.length}`);
@@ -181,8 +252,12 @@ export async function comandoImpacto(entrada, args, emJson, cwd = process.cwd())
         console.error("Uso: sema impacto <arquivo-ou-pasta> --alvo <token-semântico> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]");
         return 1;
     }
-    const contextoProjeto = await carregarProjeto(entrada, cwd);
-    const resultado = await gerarMapaImpactoSemantico(contextoProjeto, alvoSemantico, obterOpcao(args, "--mudanca", `avaliar impacto de ${alvoSemantico}`), resolverOpcoesDriftCli(args));
+    const opcoes = resolverOpcoesDriftCli(args);
+    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));
         return resultado.sucesso ? 0 : 1;
@@ -215,8 +290,12 @@ export async function comandoRenomearSemantico(entrada, args, emJson, cwd = proc
         console.error("Uso: sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]");
         return 1;
     }
-    const contextoProjeto = await carregarProjeto(entrada, cwd);
-    const resultado = await assistirRenomeacaoSemantica(contextoProjeto, nomeAtual, nomeNovo, resolverOpcoesDriftCli(args));
+    const opcoes = resolverOpcoesDriftCli(args);
+    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));
         return resultado.sucesso ? 0 : 1;

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,13 +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 `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`.",
@@ -286,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);
+    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"
@@ -311,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);
+    const resumoProjeto = await gerarResumoProjetoIa(alvo, pastaSaida, escreverNaRaiz, analiseDrift);
     const arquivoResumo = tamanho === "micro"
         ? "SEMA_BRIEF.micro.txt"
         : tamanho === "curto"
@@ -340,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);
@@ -45,30 +49,30 @@ export async function comandoPromptCurto(entrada, args, emJson) {
             : "SEMA_BRIEF.md";
     const contextoProjeto = await readFile(path.join(resumoProjeto.pastaSaida, arquivoResumo), "utf8");
     const capacidade = tamanho === "micro" ? "fraca" : tamanho === "curto" ? "media" : "forte";
-    const prompt = `⚠️ REGRA OBRIGATÓRIA DE GOVERNANÇA:
-
-ANTES DE QUALQUER AÇÃO (editar, criar, deletar, executar, consultar ou modificar):
-1. Rode \`sema docs-impacto --intencao "<ação>" --json\` com sua intenção declarada.
-2. Aguarde a resposta com as docs obrigatórias.
-3. Leia as docs antes de agir.
-4. Antes de concluir, rode \`sema finalizar-mudanca --intencao "<ação>" --doc-lida <arquivo> --json\` com todas as docs lidas.
-
-Você está operando Sema em modo IA-first.
-
-Isto é contexto comprimido para IA operar contrato semântico antes de tocar código vivo.
-
-Capacidade alvo: ${capacidade}
-Modo da tarefa: ${modo}
-
-Regras:
-- ANTES DE TUDO: rode \`sema docs-impacto --intencao "<ação>" --json\`.
-- Comece pelo resumo compacto abaixo.
-- Se a tarefa pedir mais contexto, abra \`AGENT_CONTEXT_PACK.json\` e depois \`SEMA_INDEX.json\`.
-- Não tente ler o repositório inteiro se o resumo já disser onde tocar.
-- Preserve contrato, risco, lacuna e checks sugeridos.
-
-Contexto do projeto:
-${contextoProjeto.trim()}
+    const prompt = `⚠️ REGRA OBRIGATÓRIA DE GOVERNANÇA:
+
+ANTES DE QUALQUER AÇÃO (editar, criar, deletar, executar, consultar ou modificar):
+1. Rode \`sema docs-impacto --intencao "<ação>" --json\` com sua intenção declarada.
+2. Aguarde a resposta com as docs obrigatórias.
+3. Leia as docs antes de agir.
+4. Antes de concluir, rode \`sema finalizar-mudanca --intencao "<ação>" --doc-lida <arquivo> --json\` com todas as docs lidas.
+
+Você está operando Sema em modo IA-first.
+
+Isto é contexto comprimido para IA operar contrato semântico antes de tocar código vivo.
+
+Capacidade alvo: ${capacidade}
+Modo da tarefa: ${modo}
+
+Regras:
+- ANTES DE TUDO: rode \`sema docs-impacto --intencao "<ação>" --json\`.
+- Comece pelo resumo compacto abaixo.
+- Se a tarefa pedir mais contexto, abra \`AGENT_CONTEXT_PACK.json\` e depois \`SEMA_INDEX.json\`.
+- Não tente ler o repositório inteiro se o resumo já disser onde tocar.
+- Preserve contrato, risco, lacuna e checks sugeridos.
+
+Contexto do projeto:
+${contextoProjeto.trim()}
 `;
     if (emJson) {
         console.log(JSON.stringify({

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":
             {
@@ -105,7 +104,7 @@ export async function principal() {
                 : await comandoVerificar(posicionais[0], resolverSaidaPadrao(obterOpcao(resto, "--saida", "./.tmp/sema-verificar"), "typescript", await carregarConfiguracaoProjeto(posicionais[0] ? path.resolve(cwd, posicionais[0]) : cwd)), cwd);
             break;
         case "inspecionar":
-            codigoSaida = await comandoInspecionar(posicionais[0], possuiFlag(resto, "--json"), cwd);
+            codigoSaida = await comandoInspecionar(posicionais[0], possuiFlag(resto, "--json"), cwd, resto);
             break;
         case "drift":
             codigoSaida = await comandoDrift(posicionais[0], resto, possuiFlag(resto, "--json"), cwd);
@@ -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