@semacode/cli 2.3.1 → 3.5.0

package/dist/cliHelpTexto.js

@@ -0,0 +1,168 @@
+// SEMA-GOVERNED: sema.produto.cli_invocacao_publica
+// Descrição: renderiza a ajuda pública da CLI sem carregar handlers ou consultar estado externo.
+export function renderizarCaixaAscii(linhas) {
+    const largura = Math.max(...linhas.map((linha) => linha.length), 12);
+    const borda = `+${"-".repeat(largura + 2)}+`;
+    return [
+        borda,
+        ...linhas.map((linha) => `| ${linha.padEnd(largura, " ")} |`),
+        borda,
+    ].join("\n");
+}
+export function renderizarSecaoAscii(titulo, linhas) {
+    return [
+        titulo,
+        ...linhas.map((linha) => `  ${linha}`),
+    ].join("\n");
+}
+export function criarAjudaRaiz(versao) {
+    return [
+        renderizarCaixaAscii([
+            `Sema CLI v${versao}`,
+            "IA-first para contrato, geração e adoção incremental",
+            "novo projeto, edição guiada e legado sem contrato inicial",
+        ]),
+        "",
+        renderizarSecaoAscii("Fluxos rápidos", [
+            "[1] Projeto novo / produção inicial",
+            "sema iniciar --template <base|nestjs|fastapi|nextjs-api|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer> [--force] [--com-exemplos]",
+            "Arquivos existentes são preservados; use --force somente para sobrescrita explícita. O starter de exemplos vem por padrão; --com-exemplos instala o pacote completo.",
+            "sema validar contratos/<modulo>.sema --json",
+            "sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>",
+            "sema verificar <arquivo-ou-pasta> [--saida <dir>] [--alvo <alvo>] [--sem-cache] --json",
+            "",
+            "[2] Editar projeto que já usa Sema",
+            "sema inspecionar . [--drift <none|cache|fresh>] --json",
+            "sema resumo <arquivo-ou-pasta> --micro --para mudanca [--drift <none|cache|fresh>]",
+            "sema drift <arquivo-ou-pasta> --escopo modulo [--cache <none|cache|fresh>] --json",
+            "sema impacto <arquivo-ou-pasta> --alvo <token> --mudanca <descricao> --json",
+            "sema docs-impacto --intencao \"fazer deploy\" --criar-ausentes --json",
+            "sema contexto-ia <arquivo.sema> --saida ./.tmp/contexto --json",
+            "",
+            "[3] Governar escrita autoral com Sema Author",
+            "sema author iniciar [--tema-sensivel] [--saida contratos/author.sema]",
+            "sema author validar contratos/author.sema --json",
+            "sema author briefing contratos/author.sema --json",
+            "sema author revisar-cliches contratos/author.sema --texto <texto> --json  # reprova se houver bloqueio",
+            "sema author validar-narrativa contratos/author.sema --texto <texto> --texto-anterior <texto> --json",
+            "sema author validar-proibicoes contratos/author.sema --texto <texto> --json",
+            "",
+            "[4] Validar profiles semânticos",
+            "sema profile validar workflow contratos/sema/workflow_ops.sema --maturidade production --preset webhook --artefato-arquivo workflow.md --json",
+            "sema profile validar ops contratos/sema/workflow_ops.sema --maturidade critical --preset deploy --artefato-arquivo runbook.md --json",
+            "sema profile validar game contratos/sema/game.sema --maturidade prototype --preset playtest --artefato-arquivo playtest.md --json",
+            "sema profile validar simulation contratos/sema/simulation.sema --maturidade production --preset calibration --artefato-arquivo calibration.md --json",
+            "sema profile validar redacao contratos/sema/redator.sema --maturidade production --preset seo --artefato-arquivo materia.md --json",
+            "sema profile validar propostas contratos/sema/propostas_comerciais.sema --maturidade production --preset score90 --artefato-arquivo proposta.md --json",
+            "sema profile validar conversas contratos/sema/conversas.sema --maturidade production --preset vendas --artefato-arquivo conversa.md --json",
+            "sema profile capabilities --json",
+            "sema rule-packs --profile legal --json",
+            "",
+            "[5] Descobrir a capacidade ou pipeline certo",
+            "sema descobrir catalogo --json",
+            "sema descobrir recomendar --intencao \"validar simulador 3D autônomo calibrado\" --json",
+            "sema descobrir explicar simulation.calibrate --json",
+            "sema pipeline listar --json",
+            "sema capabilities --json",
+            "",
+            "[6] Modelar jogos e simulações em qualquer combinação espacial, visual e de render",
+            "sema interativo capabilities --json",
+            "sema interativo schema --json",
+            "sema interativo pipelines --json",
+            "sema interativo adapters --spatial-model THREE_D --render-mode VISUAL --json",
+            "sema interativo validar <definition.json> --json",
+            "sema interativo planejar <definition.json> --json",
+            "sema interativo validar-evidencias <definition.json> [--plano-arquivo <plan.json>] --bundle-arquivo <bundle.json> --json",
+            "sema interativo validar-protocolo <adapter-run.json> --json",
+            "sema interativo validar-ir <experience-ir.json> --json",
+            "sema interativo consultar-ir <experience-ir.json> --semantic-id <id> --json",
+            "sema interativo validar-engine-snapshot <snapshot.json> --json",
+            "sema interativo validar-temporal <temporal.json> --json",
+            "sema interativo validar-autonomia <cycle.json> --json",
+            "sema interativo validar-playtest-fuzz <plan.json> --json",
+            "sema interativo validar-multiplayer <model.json> --json",
+            "sema interativo analisar-portabilidade <plan.json> --json",
+            "sema interativo validar-workers <plan.json> --json",
+            "",
+            "[7] Orquestrar criação de conteúdo por IA",
+            "sema conteudo capabilities --json",
+            "sema conteudo validar <definition.json> --json",
+            "sema conteudo planejar <definition.json> --alvos-arquivo <targets.json> --json",
+            "sema conteudo registrar <ledger.ndjson> --envelope-arquivo <envelope.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-id <id> --expected-head <sha256:...> --json",
+            "sema conteudo status <definition.json> --politica-arquivo <policy-envelope.json> --confianca-arquivo <trust.json> --trust-root-digest <sha256:...> --revocation-digest <sha256:...> --ledger-arquivo <ledger.ndjson> --expected-head <sha256:...> --json",
+            "",
+            "[8] Adotar Sema em projeto que ainda não usa",
+            "sema importar <fonte> <diretorio> --saida <diretorio> --json",
+            "sema formatar <arquivo-ou-pasta>",
+            "sema validar <arquivo-ou-pasta> --json",
+            "sema drift <arquivo-ou-pasta> --escopo modulo --cache fresh --json",
+        ]),
+        "",
+        renderizarSecaoAscii("IA por capacidade", [
+            "fraca: sema resumo <arquivo> --micro --drift none --json (contrato compacto; implementação não avaliada)",
+            "média: sema resumo <arquivo> --curto --drift none --json + sema drift <arquivo> --cache fresh --json",
+            "forte: sema contexto-ia <arquivo.sema> --saida <diretorio> --json",
+        ]),
+        "",
+        renderizarSecaoAscii("Comandos principais", [
+            "descoberta: sema inspecionar [arquivo-ou-pasta] [--drift <none|cache|fresh>] [--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]",
+            "distribuição global: sema skill <status|sync> [--json] (status é somente leitura; sync repara launcher e skill)",
+            "auditoria: sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <none|cache|fresh>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]",
+            "modos: drift direto usa fresh por padrão; --cache none ainda executa sem cache persistente; resumo/inspecionar usam --drift none por padrão e não fabricam evidência",
+            "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|express|fastify|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|php|typescript|python|dart> <diretorio> [--saida <diretorio>] [--namespace <base>] [--json]",
+            "validação: sema validar <arquivo-ou-pasta> [--json]",
+            "diagnóstico: sema diagnosticos <arquivo.sema> [--json]",
+            "geração: sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio> [--estrutura <flat|modulos|backend>] [--framework <base|nestjs|fastapi>]",
+            "teste local: sema testar <arquivo.sema> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio-temporario> [--estrutura <flat|modulos|backend>] [--framework <base|nestjs|fastapi>]",
+            "aliases nativos: cs|csharp -> dotnet; c++|cxx|cc -> cpp (CLI e sema.config.json)",
+            "verificação final: sema verificar <arquivo-ou-pasta> [--saida <diretorio-base>] [--alvo <alvo>] [--sem-cache] [--json]",
+            "formatação: sema formatar <arquivo-ou-pasta> [--check] [--json]",
+            "author: sema author <iniciar|validar|briefing|revisar-cliches|validar-narrativa|validar-proibicoes> [arquivo] [--tema-sensivel] [--preset conto|romance|roteiro|lore|campanha] [--saida <arquivo>] [--texto <texto>] [--json]",
+            "profile: sema profile validar <software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas> <arquivo-ou-pasta> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
+            "capabilities: sema profile capabilities [--json]",
+            "conteúdo: sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
+            "interativo: sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
+            "rule packs: sema rule-packs [--profile <author|software|workflow|ops|game|simulation|legal|research|redacao|propostas|conversas>] [--json]",
+        ]),
+        "",
+        renderizarSecaoAscii("Ajuda IA-first", [
+            "sema ajuda-ia",
+            "sema starter-ia",
+            "sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <none|cache|fresh>] [--saida <diretorio>] [--raiz] [--json]",
+            "sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--json]",
+            "sema prompt-ia",
+            "sema prompt-ia-ui",
+            "sema prompt-ia-react",
+            "sema prompt-ia-sema-primeiro",
+            "sema exemplos-prompt-ia",
+            "sema contexto-ia <arquivo.sema> [--saida <diretorio>] [--json]",
+            "sema sync-codex [--json]",
+            "sema instalar-exemplos [--json]",
+            "sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] [--completo] [--json]",
+            "sema finalizar-mudanca --intencao <acao> [--arquivo <caminho>] [--doc-lida <caminho>] [--json]",
+            "sema author briefing <arquivo.sema> [--json]",
+            "sema author revisar-cliches <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--texto-anterior <texto>|--texto-anterior-arquivo <arquivo>] [--json]",
+            "sema author validar-narrativa <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--json]",
+            "sema author validar-proibicoes <arquivo.sema> [--texto <texto>|--texto-arquivo <arquivo>] [--json]",
+            "sema profile validar <profile> <arquivo.sema> [--maturidade draft|prototype|production|critical] [--preset <preset>] [--artefato <texto>|--artefato-arquivo <arquivo>] [--json]",
+            "sema profile capabilities [--json]",
+            "sema descobrir <catalogo|recomendar|explicar> [id] [--intencao <objetivo>] [--json]",
+            "sema pipeline <listar|descrever> [id] [--json]",
+            "sema capabilities [--json]",
+            "sema interativo <capabilities|schema|pipelines|adapters|validar|planejar|validar-evidencias|status|validar-protocolo|extensões-P0-P2> [opções] [--json]",
+            "sema conteudo <capabilities|validar|planejar|validar-envelope|registrar|status|projetar> [--trust-root-digest <sha256:...>] [--revocation-digest <sha256:...>] [--expected-head <sha256:...>] [opções] [--json]",
+            "sema rule-packs [--profile <profile>] [--json]",
+        ]),
+        "",
+        renderizarSecaoAscii("Operacional", [
+            "sema doctor",
+            "sema --versao | --version | -v",
+        ]),
+    ].join("\n");
+}
+//# sourceMappingURL=cliHelpTexto.js.map

package/dist/cliRuntime.d.ts

@@ -0,0 +1,2 @@
+export type PrincipalCliRuntime = () => Promise<number>;
+export declare function executarCliRuntimeInterno(principalInjetado?: PrincipalCliRuntime): Promise<number>;

package/dist/cliRuntime.js

@@ -0,0 +1,31 @@
+// SEMA-GOVERNED: sema.produto.cli_invocacao_publica.handlers
+// Descrição: executa o dispatcher operacional no processo interno capturado pela CLI pública.
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { CODIGO_SAIDA_FATAL_RUNTIME_CLI } from "./resultadoCli.js";
+export async function executarCliRuntimeInterno(principalInjetado) {
+    try {
+        const principal = principalInjetado
+            ?? (await import("./index.part08.js")).principal;
+        const codigoSaida = await principal();
+        return Number.isSafeInteger(codigoSaida) && codigoSaida >= 0 && codigoSaida <= 255
+            ? codigoSaida
+            : CODIGO_SAIDA_FATAL_RUNTIME_CLI;
+    }
+    catch {
+        return CODIGO_SAIDA_FATAL_RUNTIME_CLI;
+    }
+}
+function executadoDiretamente() {
+    const entrada = process.argv[1];
+    return typeof entrada === "string"
+        && pathToFileURL(path.resolve(entrada)).href === import.meta.url;
+}
+if (executadoDiretamente()) {
+    void executarCliRuntimeInterno().then((codigoSaida) => {
+        process.exitCode = codigoSaida;
+    }, () => {
+        process.exitCode = CODIGO_SAIDA_FATAL_RUNTIME_CLI;
+    });
+}
+//# sourceMappingURL=cliRuntime.js.map

package/dist/comandos.js

@@ -1,4 +1,4 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.distribuicao_global, sema.produto.cli_invocacao_publica.argumentos
 // Descricao: dispatcher de comandos publicos da CLI local; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
 import { comandoDev } from "./dev/index.js";
 import { comandoInit } from "./init/index.js";
@@ -6,32 +6,18 @@ import { comandoSyncPrisma } from "./sync/index.js";
 import { comandoPipelineConteudo } from "./pipelineConteudo/command.js";
 import { REGISTRO_HANDLERS_DESCOBERTA } from "./discovery/index.js";
 import { comandoSistemasInterativos } from "./sistemasInterativos/command.js";
+import { comandoSkill } from "./skillCommand.js";
 async function comandoInitHandler(posicionais, args, _emJson) {
-    try {
-        await comandoInit([...posicionais, ...args]);
-        return 0;
-    }
-    catch {
-        return 1;
-    }
+    await comandoInit([...posicionais, ...args]);
+    return 0;
 }
 async function comandoDevHandler(posicionais, args, _emJson) {
-    try {
-        await comandoDev([...posicionais, ...args]);
-        return 0;
-    }
-    catch {
-        return 1;
-    }
+    await comandoDev([...posicionais, ...args]);
+    return 0;
 }
 async function comandoSyncPrismaHandler(posicionais, args, _emJson) {
-    try {
-        await comandoSyncPrisma([...posicionais, ...args]);
-        return 0;
-    }
-    catch {
-        return 1;
-    }
+    await comandoSyncPrisma([...posicionais, ...args]);
+    return 0;
 }
 async function comandoGuard(posicionais, _args, emJson) {
     const { ativarGuarda, desativarGuarda, statusGuarda } = await import("./guard.js");
@@ -64,6 +50,7 @@ export const REGISTRO_COMANDOS = {
     sync: comandoSyncPrismaHandler,
     conteudo: comandoPipelineConteudo,
     interativo: comandoSistemasInterativos,
+    skill: comandoSkill,
     ...REGISTRO_HANDLERS_DESCOBERTA,
 };
 //# sourceMappingURL=comandos.js.map

package/dist/contexto.js

@@ -1,5 +1,5 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: gera um pacote local de contexto Sema sem depender de servico externo.
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.governanca_ia.drift.cache.modos
+// Descrição: gera um pacote local de contexto Sema e distingue contexto contratual de evidência fresh de drift.
 import { readFile, mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 const LIMITE_TAMANHO_INLINE = 100_000;
@@ -62,8 +62,8 @@ export async function gerarPacoteContextoChat(entrada, cwd = process.cwd()) {
         "",
     ].join("\n");
     const driftResumido = entrada.incluirDrift
-        ? "## Drift\nRun `sema drift` locally for the authoritative drift result.\n"
-        : "## Drift\nNot included. Run `sema drift` locally when drift evidence is required.\n";
+        ? "## Drift\nRun `sema drift --cache fresh` locally for authoritative closing evidence. Persistent cache is navigation evidence only.\n"
+        : "## Drift\nNot evaluated. Run `sema drift --cache fresh` locally when live implementation evidence is required; do not interpret missing score or implementation as zero.\n";
     const impactMap = entrada.incluirImpacto
         ? tarefas.map((tarefa) => `- \`${tarefa}\`: local contract and linked implementation must be inspected with \`sema impacto\`.`)
         : [];
@@ -98,7 +98,7 @@ export async function gerarPacoteContextoChat(entrada, cwd = process.cwd()) {
         "1. Read the contracts above. They are the source of truth.",
         "2. Treat selected code as context, not as a substitute for the contract.",
         "3. Run `sema docs-impacto` with the declared intention before changing files.",
-        "4. Run `sema drift` and `sema impacto` locally before editing governed code.",
+        "4. Run `sema drift --cache fresh` and `sema impacto` locally before editing governed code.",
         "5. Close with `sema finalizar-mudanca` and concrete evidence.",
     ].join("\n");
     const tamanhoBytes = Buffer.byteLength(inlineTexto, "utf8");

package/dist/dev/index.d.ts

@@ -1,3 +1,4 @@
+export declare function resolverCaminhoBinCliDev(urlModulo?: string): string;
 export interface SessaoDev {
     id: string;
     pastaObservada: string;

package/dist/dev/index.js

@@ -1,10 +1,54 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.cli_dev_mode, sema.produto.cli_invocacao_publica.handlers
 // Descricao: codigo governado pelo Sema; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
 // Modo dev --watch para paralelizacao
 // Contrato: cli_dev_mode.sema
 import * as fs from 'fs';
 import * as path from 'path';
 import { spawn } from 'child_process';
+import { fileURLToPath } from 'node:url';
+export function resolverCaminhoBinCliDev(urlModulo = import.meta.url) {
+    return fileURLToPath(new URL('../bin.js', urlModulo));
+}
+const CAMINHO_BIN_CLI = resolverCaminhoBinCliDev();
+const CHAVES_RESULTADO_CLI_V1 = [
+    'code',
+    'command',
+    'exitCode',
+    'kind',
+    'message',
+    'ok',
+    'payload',
+    'schemaVersion'
+];
+function extrairPayloadValidacaoCli(saida, codigoProcesso) {
+    const envelope = JSON.parse(saida);
+    if (typeof envelope !== 'object'
+        || envelope === null
+        || Array.isArray(envelope)
+        || envelope.schemaVersion !== 'sema.cli.result/v1'
+        || envelope.command !== 'validar'
+        || !Number.isSafeInteger(envelope.exitCode)
+        || envelope.exitCode !== codigoProcesso
+        || JSON.stringify(Object.keys(envelope).sort()) !== JSON.stringify(CHAVES_RESULTADO_CLI_V1)) {
+        throw new TypeError('Resultado público de validação inválido.');
+    }
+    const sucesso = envelope.exitCode === 0;
+    if (envelope.ok !== sucesso
+        || envelope.kind !== (sucesso ? 'SUCCESS' : 'DOMAIN_ERROR')
+        || envelope.code !== (sucesso ? 'CLI_SUCCESS' : 'CLI_DOMAIN_ERROR')
+        || (sucesso ? envelope.message !== null : typeof envelope.message !== 'string')) {
+        throw new TypeError('Resultado público de validação incoerente.');
+    }
+    const payload = envelope.payload;
+    if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+        throw new TypeError('Payload público de validação inválido.');
+    }
+    const schemaPayload = payload.schemaVersion;
+    if (schemaPayload === 'sema.cli.result/v1' || schemaPayload === 'sema.cli.control/v1') {
+        throw new TypeError('Payload público de validação não pode conter envelope CLI aninhado.');
+    }
+    return payload;
+}
 const sessoes = new Map();
 export async function iniciarModoDev(pastaContratos, alvoCodigo, modoInicial = 'permissivo') {
     // Validar pasta
@@ -57,14 +101,13 @@ function iniciarWatcher(sessao) {
 }
 async function validarAlteracao(caminhoArquivo, modo) {
     // Executar validacao via CLI
-    const semaPath = path.resolve('pacotes/cli/dist/index.js');
     const args = ['validar', caminhoArquivo];
     if (modo === 'permissivo') {
         console.log('   🟡 Modo permissivo: mostrando apenas warnings\n');
     }
-    const processo = spawn('node', [semaPath, ...args], {
+    const processo = spawn(process.execPath, [CAMINHO_BIN_CLI, ...args], {
         stdio: 'inherit',
-        shell: true
+        shell: false
     });
     processo.on('close', (codigo) => {
         if (codigo === 0) {
@@ -81,16 +124,15 @@ async function validarAlteracao(caminhoArquivo, modo) {
 export async function promoverParaProduction(caminhoContrato, verificacoesPendentes) {
     console.log(`\n🚀 Promovendo ${path.basename(caminhoContrato)} para PRODUCTION...`);
     // Validar rigorosamente
-    const semaPath = path.resolve('pacotes/cli/dist/index.js');
     return new Promise((resolve) => {
-        const processo = spawn('node', [semaPath, 'validar', caminhoContrato, '--json'], {
-            shell: true
+        const processo = spawn(process.execPath, [CAMINHO_BIN_CLI, 'validar', caminhoContrato, '--json'], {
+            shell: false
         });
         let saida = '';
         processo.stdout?.on('data', (data) => { saida += data; });
-        processo.on('close', () => {
+        processo.on('close', (codigo) => {
             try {
-                const resultado = JSON.parse(saida);
+                const resultado = extrairPayloadValidacaoCli(saida, codigo);
                 const temErros = resultado.bloqueia_acao === true;
                 if (temErros) {
                     console.log('   ❌ Bloqueado: resolva os erros antes de promover\n');

package/dist/discovery/catalog.js

@@ -1,4 +1,4 @@
-// SEMA-GOVERNED: sema.produto.descoberta_capacidades
+// SEMA-GOVERNED: sema.produto.descoberta_capacidades, sema.produto.governanca_ia.drift.cache.modos
 // Descrição: registro canônico derivado de profiles, conteúdo e sistemas interativos.
 import { ALIASES_PROFILE, CAPABILITY_MATRIX_GOVERNANCA, PRESETS_PROFILE, } from "../profileCatalogo.js";
 import { CAPABILITIES_CONTEUDO_PADRAO } from "../pipelineConteudo/adapters.js";
@@ -112,8 +112,8 @@ function entradasGovernanca() {
             requiredInputs: ["<intenção>", "<contrato.sema>"],
             commandTemplates: [
                 template("docs-impacto", "sema docs-impacto --intencao <intenção> --arquivo <contrato.sema> --json", "WORKSPACE_VERIFICATION", true),
-                template("inspecionar", "sema inspecionar <contrato.sema> --json", "READ_ONLY_VALIDATION"),
-                template("drift", "sema drift <contrato.sema> --escopo modulo --json", "READ_ONLY_VALIDATION"),
+                template("inspecionar", "sema inspecionar <contrato.sema> --drift none --json", "READ_ONLY_VALIDATION"),
+                template("drift", "sema drift <contrato.sema> --escopo modulo --cache fresh --json", "READ_ONLY_VALIDATION"),
                 template("impacto", "sema impacto <contrato.sema> --alvo <token> --mudanca <descrição> --json", "READ_ONLY_VALIDATION"),
                 template("finalizar", "sema finalizar-mudanca --intencao <intenção> --doc-lida <documento> --json", "WORKSPACE_VERIFICATION"),
             ],

package/dist/distribuicao/filesystemGlobal.d.ts

@@ -0,0 +1,63 @@
+import { type BigIntStats } from "node:fs";
+import type { CodigoDiagnosticoDistribuicaoGlobal, EstadoDistribuicaoGlobal } from "./tipos.js";
+export declare class FalhaDistribuicaoGlobal extends Error {
+    readonly estado: Extract<EstadoDistribuicaoGlobal, "BROKEN_TARGET" | "PERMISSION_DENIED">;
+    readonly codigo: CodigoDiagnosticoDistribuicaoGlobal;
+    constructor(estado: Extract<EstadoDistribuicaoGlobal, "BROKEN_TARGET" | "PERMISSION_DENIED">, codigo: CodigoDiagnosticoDistribuicaoGlobal);
+}
+export interface IdentidadeDiretorioSeguro {
+    dev: bigint;
+    ino: bigint;
+}
+export declare function mesmaIdentidadeDiretorio(a: IdentidadeDiretorioSeguro, b: IdentidadeDiretorioSeguro): boolean;
+export declare function erroEhPermissao(erro: unknown): boolean;
+export declare function falhaParaResultado(erro: unknown): FalhaDistribuicaoGlobal;
+export declare function lstatOuNull(caminho: string): Promise<BigIntStats | null>;
+export declare function caminhosIguais(a: string, b: string): boolean;
+export declare function caminhoContido(base: string, alvo: string): boolean;
+export declare function identidadeDiretorioSeguro(caminho: string): Promise<IdentidadeDiretorioSeguro>;
+export declare function resolverHomeReal(diretorioUsuario: string): Promise<string>;
+export declare function resolverDentroDaHome(homeReal: string, ...segmentos: string[]): string;
+export declare function validarCadeiaExistente(homeReal: string, destino: string): Promise<"completa" | "ausente">;
+export declare function garantirDiretoriosSeguros(homeReal: string, destino: string): Promise<void>;
+export declare function validarArquivoRegular(caminho: string, basePermitida?: string): Promise<BigIntStats>;
+export declare function identidadeArquivoSeguro(caminho: string, basePermitida?: string): Promise<{
+    dev: bigint;
+    ino: bigint;
+}>;
+export declare function removerArquivoSeguro(homeReal: string, caminho: string, identidadeEsperada?: {
+    dev: bigint;
+    ino: bigint;
+}): Promise<void>;
+export declare function lerArquivoSeguro(caminho: string, limiteBytes?: number, basePermitida?: string): Promise<Buffer>;
+export declare function escreverArquivoAtomico(homeReal: string, destino: string, conteudo: string | Buffer, modo: number): Promise<void>;
+export declare function nomeTemporarioDiretorio(prefixo: "stage" | "backup"): string;
+export declare function removerDiretorioTemporarioGerenciado(homeReal: string, caminho: string, identidadeEsperada?: IdentidadeDiretorioSeguro): Promise<void>;
+export declare function moverDiretorioSeguro(homeReal: string, origem: string, destino: string, identidadeEsperada?: IdentidadeDiretorioSeguro): Promise<IdentidadeDiretorioSeguro>;
+export declare function diretorioExisteSeguro(caminho: string): Promise<boolean>;
+export declare function statDiretorioSeguro(caminho: string): Promise<BigIntStats>;
+export interface ArtefatoTransacaoArquivo {
+    nome: string;
+    conteudoDepois: Buffer;
+    modo: number;
+}
+export interface TransacaoArquivosDuravel {
+    readonly homeReal: string;
+    readonly diretorio: string;
+    readonly journal: string;
+    readonly stage: string;
+    readonly backup: string;
+    readonly journalPrepared: Buffer;
+    readonly journalCommitted: Buffer;
+    readonly stageBytes: Buffer;
+    readonly backupBytes: Buffer;
+}
+export declare function prepararTransacaoArquivosLauncher(homeReal: string, diretorio: string, artefatos: ArtefatoTransacaoArquivo[]): Promise<TransacaoArquivosDuravel>;
+export declare function recuperarTransacaoArquivosLauncher(homeReal: string, diretorio: string): Promise<{
+    alterado: boolean;
+    limpezaPendente: boolean;
+}>;
+export declare function concluirTransacaoArquivosLauncher(transacao: TransacaoArquivosDuravel): Promise<{
+    limpezaPendente: boolean;
+}>;
+export declare function transacaoArquivosLauncherPendente(homeReal: string, diretorio: string): Promise<boolean>;