@semacode/cli 2.3.1 → 3.5.0

package/README.md

@@ -1,251 +1,299 @@
-# @semacode/cli
-
-`@semacode/cli` is the public Codex-native local CLI for Sema semantic
-governance.
-
-It validates `.sema` contracts, checks semantic drift, maps impact, enforces
-documentation gates, generates starter code, and prepares contract-first
-context for Codex inside a local project folder.
-
-Sema is an independent product and is not affiliated with or endorsed by
-OpenAI. Codex-native describes Sema's official product direction, not an
-official OpenAI program, integration, or submission.
-
-Official support: [suporte@otimitare.online](mailto:suporte@otimitare.online)
-
-## Install
-
+# @semacode/cli
+
+`@semacode/cli` is the public Codex-native local CLI for Sema semantic
+governance.
+
+It validates `.sema` contracts, checks semantic drift, maps impact, enforces
+documentation gates, generates starter code, and prepares contract-first
+context for Codex inside a local project folder.
+
+Sema is an independent product and is not affiliated with or endorsed by
+OpenAI. Codex-native describes Sema's official product direction, not an
+official OpenAI program, integration, or submission.
+
+Official support: [suporte@otimitare.online](mailto:suporte@otimitare.online)
+
+## Install
+
 ```bash
 npm install -g @semacode/cli
-codex plugin marketplace add gerlanss/Sema
-codex plugin add sema@sema
-```
-
-Open a new Codex task in the target repository after installing the plugin.
-Existing tasks do not reload their plugin/skill catalog. Invoke `$sema` in the
-new task; after it creates and reads `AGENTS.md`, later tasks load that workspace
-protocol automatically.
-
-## First Run
-
-```bash
-sema --version
-sema resumo . --curto
+sema skill status --json
 ```
 
+The global package installs a stable launcher under `~/.sema/bin` and
+synchronizes the bundled skill to `~/.agents/skills/sema`. If Claude is already
+configured, it also maintains `~/.claude/skills/sema`. Open a new task after an
+install or update because existing tasks do not reload their skill catalog.
+
+## First Run
+
+```bash
+sema --version
+sema resumo . --curto --drift none
+```
+
 Public Sema is local-only. The CLI runs directly without a Sema login, user
 authorization, product-license check, activation key, token, credits, billing
 service, control panel, or external service credentials. The license governs
 use and redistribution; it is not a runtime activation gate.
 
-## Codex Setup
+## Side-Effect-Free Help And JSON Results
 
-`AGENTS.md` is the official Sema entrypoint for Codex:
+`--help` and `-h` short-circuit before the operational runtime or handlers are
+imported wherever they appear. Help exits with status `0` without inspecting or mutating the workspace, home,
+user cache, or plugin cache, and without starting subprocesses or network
+calls.
 
 ```bash
-sema sync-codex --json
+sema iniciar --help
+sema dev --help --json
+sema skill sync --help
 ```
 
-Codex automatically loads `AGENTS.md` as durable repository guidance. See the
-[Codex `AGENTS.md` documentation](https://learn.chatgpt.com/docs/agent-configuration/agents-md).
+When `--json` is present, help and command-control failures emit exactly one
+`sema.cli.control/v1` document on stdout with empty stderr. Its only fields are
+`schemaVersion`, `ok`, `kind`, `code`, `message`, and `exitCode`. Failures are
+redacted and never expose a stack, absolute path, or raw argv.
+
+Every syntactically valid command invoked with `--json` in 3.0.0 emits exactly
+one `sema.cli.result/v1` document. Its only fields are `schemaVersion`, `ok`,
+`kind`, `command`, `code`, `message`, `exitCode`, and `payload`. `SUCCESS` uses
+`ok: true`, `CLI_SUCCESS`, `message: null`, and exit code `0`;
+`DOMAIN_ERROR` uses `ok: false`, `CLI_DOMAIN_ERROR`, a safe public message, and
+a positive exit code. `payload` is always present, may contain any JSON value,
+and is the only location for the command-specific result; `data` is not an
+alias.
+
+Envelope `ok` classifies the CLI result path and does not replace domain fields
+inside `payload`. Consumers must unwrap the payload before reading values such
+as `sucesso`, `aprovado`, or `bloqueado`. `sema --version` remains plain exact
+SemVer text rather than a JSON envelope.
+
+The package separates execution from imports: `bin.sema` points to
+`dist/bin.js`, while `main` and the root export remain `dist/index.js`.
+Unknown commands/subcommands, missing or invalid CLI syntax, and uncaught
+runtime exceptions use the control envelope; structured domain-level failures
+after valid dispatch use `sema.cli.result/v1` with `kind: "DOMAIN_ERROR"`.
 
+## Codex Setup
+
+`AGENTS.md` is the official Sema entrypoint for Codex:
+
+```bash
+sema sync-codex --json
+```
+
+Codex automatically loads `AGENTS.md` as durable repository guidance. See the
+[Codex `AGENTS.md` documentation](https://learn.chatgpt.com/docs/agent-configuration/agents-md).
+
 The CLI is the engine and source of truth; `AGENTS.md` is the automatic
-workspace protocol. The Sema skill is required for Codex to bootstrap a project
-that does not have Sema yet. After initialization, the skill delegates to the
-generated `AGENTS.md`. Installing this npm package never writes into
-`CODEX_HOME`; skill installation remains an explicit Codex command.
-
-## Codex-Native Architecture
-
-- `AGENTS.md` is the only official entrypoint. `sync-codex` changes only valid
-  Sema-managed blocks and preserves malformed or manual content for review.
-- Agent Context Pack consumers use schema version 7, including the deterministic
-  discovery summary and the fields `entrypointCodex`, `codexNativo`, and
-  `cliLocalSemAutorizacao`.
-- The Sema Codex skill is required for first contact. It initializes the
-  workspace and generates `AGENTS.md`; it does not duplicate the governed
-  workflow after that handoff.
-
-## Local Workflow
-
-```bash
-sema docs-impacto --intencao "describe the change" --arquivo contratos/app.sema --json
-sema inspecionar contratos/app.sema --json
-sema drift contratos/app.sema --escopo modulo --json
-sema impacto contratos/app.sema --alvo app.modulo --mudanca "describe the change" --json
-sema finalizar-mudanca --intencao "describe the change" --doc-lida README.md --json
-```
-
-## Focused Drift and Incremental Cache
-
-`sema inspecionar contratos/app.sema` and `sema resumo contratos/app.sema --micro`
-are light, contract-only discovery by default (`--drift none`). Use
-`--com-drift`, `--drift cache`, or `--drift fresh` explicitly when live-code
-evidence is needed. A `none` result leaves the drift score absent and never
-claims that implementation, routes, or links were verified.
-
-```bash
-sema inspecionar contratos/app.sema --com-drift --json
-sema resumo contratos/app.sema --micro --drift cache --json
-sema drift contratos/app.sema --escopo modulo --cache auto --json
-```
-
-A file target loads only the selected contract and its transitive `use`
-closure. Narrow drift plans physical files before cataloging, shares one
-catalog/content snapshot across indexers, and stores validated incremental
-entries under `.tmp/sema-cache`. Inspect `escopo_aplicado.catalogo`,
-`escopo_aplicado.cache.incremental`, and `escopo_aplicado.cache.fasesMs` for
-the actual work performed. Use `--escopo projeto` for an intentional global
-walk and `--cache refresh|off` to force recalculation or disable persistent
-cache I/O.
-
-If the project has no `.sema` contract, create one before implementing behavior:
+workspace protocol. The Sema skill bootstraps a project that does not have Sema
+yet and then delegates to the generated `AGENTS.md`. The npm lifecycle updates
+only Sema-managed launcher and skill roots; it never writes into plugin caches,
+credentials, the workspace, or `CODEX_HOME`.
 
-```bash
-sema iniciar --template base
-```
-
-Initialization preserves existing files and rejects symlink or junction
-escapes. Use `--force` only when overwriting the template destinations is an
-explicit human decision; the Codex bootstrap skill never adds it.
+Use `sema skill status --json` for a read-only diagnosis and `sema skill sync
+--json` to repair the launcher and skill after `npm install --ignore-scripts`.
+If a shell still cannot resolve `sema`, invoke the managed launcher directly:
 
-## Code Generation
-
-```bash
-sema compilar contratos/app.sema --alvo typescript --saida .tmp/app-ts --estrutura modulos
-sema compilar contratos/app.sema --alvo python --saida .tmp/app-py --estrutura modulos
-sema compilar contratos/app.sema --alvo php --saida .tmp/app-php --estrutura modulos
-sema compilar contratos/app.sema --alvo dotnet --saida .tmp/app-dotnet --estrutura modulos
-sema compilar contratos/app.sema --alvo cpp --saida .tmp/app-cpp --estrutura modulos
+```powershell
+& "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$HOME\.sema\bin\sema-managed.ps1" --version
 ```
 
-Generated artifacts include `SEMA-GOVERNED` headers and must stay aligned with
-the source contract.
-
-## Validation
-
 ```bash
-sema validar contratos/app.sema --json
-sema diagnosticos contratos/app.sema --json
-sema testar contratos/app.sema --alvo typescript --saida .tmp/app-tests
-sema testar contratos/app.sema --alvo dotnet --saida .tmp/app-dotnet-tests
-sema testar contratos/app.sema --alvo cpp --saida .tmp/app-cpp-tests
-sema verificar contratos/app.sema --saida .tmp/app-check --json
+"$HOME/.sema/bin/sema" --version
 ```
 
-## AI-native Content Pipeline
-
-`sema conteudo` validates and plans multi-channel, multi-format content work,
-verifies signed policies and evidence, replays canonical state, and projects
-non-authoritative manifests. Producer agents, specialized AI evaluators,
-creative tools, and delivery adapters run in an external runner; there is no
-native human-review transition.
-
-```bash
-sema conteudo validar exemplos/pipeline-conteudo/definicao.json --json
-sema conteudo planejar exemplos/pipeline-conteudo/definicao.json --alvos-arquivo exemplos/pipeline-conteudo/alvos.json --json
-```
-
-See `docs/pipeline-conteudo.md` for the signed trust, quorum, ledger, target,
-adapter, and projection model.
-
-## Capability Discovery and Interactive Systems
-
-`sema descobrir` exposes one explainable catalog and a deterministic intent
-router. `sema interativo` validates and plans games, simulations, and hybrids
-across independent spatial models, render modes, retro visual profiles, control,
-time, determinism, and fidelity axes without running an engine or silently
-mutating a workspace.
-
-```bash
-sema descobrir catalogo --json
-sema descobrir recomendar --intencao "calibrate a headless autonomous simulation" --json
-sema interativo schema --json
-sema interativo pipelines --json
-sema interativo validar exemplos/sistemas-interativos/simulation-headless-autonomous-batch.json --json
+On Windows, PowerShell resolves `sema.ps1` from `PATH`, `cmd.exe` resolves
+`sema.cmd`, and `sema-managed.ps1` is the PATH-independent fallback.
+
+## Codex-Native Architecture
+
+- `AGENTS.md` is the only official entrypoint. `sync-codex` changes only valid
+  Sema-managed blocks and preserves malformed or manual content for review.
+- Agent Context Pack consumers use schema version 7, including the deterministic
+  discovery summary and the fields `entrypointCodex`, `codexNativo`, and
+  `cliLocalSemAutorizacao`.
+- The bundled Sema skill handles first contact. Its canonical shared copy is
+  `~/.agents/skills/sema`; Claude gets a managed mirror only when detected. It
+  asks for adoption authorization before implementation and does not duplicate
+  governance after handing off to `AGENTS.md`. Installing or updating the
+  global CLI authorizes distribution changes only, not workspace adoption.
+
+## Local Workflow
+
+```bash
+sema docs-impacto --intencao "describe the change" --arquivo contratos/app.sema --json
+sema inspecionar contratos/app.sema --drift none --json
+sema drift contratos/app.sema --escopo modulo --cache fresh --json
+sema impacto contratos/app.sema --alvo app.modulo --mudanca "describe the change" --json
+sema finalizar-mudanca --intencao "describe the change" --doc-lida README.md --json
 ```
 
-The canonical interactive catalog contains 35 unique pipelines and 28 unique
-external adapter descriptors. Its advanced P0/P1/P2 surface covers Experience
-IR, semantic engine snapshots, asset provenance, editor-state descriptions,
-multimodal evidence, resumable jobs, acceptance locks, temporal/shot/physics QA,
-clean-install and hardware constraints, safe autonomous repair, bounded
-playtest/fuzz plans, multiplayer authority, portability with declared losses,
-and distributed worker DAGs.
-
-Advanced read-only commands:
+`resumo` and `inspecionar` default to `--drift none`; unobserved score,
+confidence, implementation, and route evidence inside the result `payload`
+stays `null`. Use `--drift cache|fresh` to request analysis. Direct `sema drift`
+accepts `--cache none|cache|fresh` and defaults to `fresh`. Persistent objects are stored in the
+operating system's user-cache directory outside the workspace. They reuse only
+validated extraction data; the final drift decision is always recalculated.
+
+If the project has no `.sema` contract, an informational request must remain
+read-only. Before implementing behavior, obtain explicit adoption authorization,
+then inspect the official flow and initialize:
 
 ```bash
-sema interativo validar-ir <file> --json
-sema interativo indexar-ir <file> --json
-sema interativo consultar-ir <file> --semantic-id <id> --json
-sema interativo chunk-ir <file> --semantic-id <id> [--raso] --json
-sema interativo descrever-ir --json
-
-sema interativo validar-engine-snapshot <file> --json
-sema interativo diff-engine-snapshots <before> <after> --json
-sema interativo validar-asset-provenance <file> --json
-sema interativo validar-editor-state <file> --json
-sema interativo planejar-jobs <file> --json
-sema interativo validar-acceptance <file> --json
-sema interativo operar-acceptance <lock> --operation <VALIDATE|EVALUATE|INVALIDATE> --context-file <file> --json
-sema interativo validar-multimodal <file> --json
-
-sema interativo validar-temporal <file> --json
-sema interativo validar-evidencia-temporal <contract> --bundle-arquivo <file> --json
-sema interativo validar-autonomia <file> --json
-sema interativo validar-playtest-fuzz <file> --json
-sema interativo validar-multiplayer <file> --json
-sema interativo analisar-portabilidade <file> --json
-sema interativo validar-workers <file> --json
-
-sema interativo validar-control-run <control-run.json> --definition-arquivo <definition.json> --plano-arquivo <plan.json> --contrato-arquivo <validation-contract.json> --entrada-arquivo <input.json> [--entrada-auxiliar-arquivo <supporting-input.json>] --evidencia-arquivo <evidence.json> --resultado-arquivo <result.json> --json
-```
-
-All of these commands are local and read-only. Adapter entries are external
-capability descriptors: the package does not detect, probe, launch, install, or
-control any engine, editor, plug-in, process, verifier, or worker. A
-`STRUCTURALLY_COMPLETE` result is local structural coverage only; it always
-remains `completed: false`, `authoritative: false`, and awaits external
-attestation. The CLI never equates a descriptor, fixture, plan, or supplied JSON
-record with proof that external work occurred.
-
-See `docs/descoberta-capacidades.md` and `docs/sistemas-interativos.md` for the
-ranking, adapter protocol, evidence boundary, fidelity, and coverage model.
-
-## Programmatic API
-
-The package root can be imported without executing the CLI process:
-
-```js
-import {
-  analisarPlanoPortabilidadeInterativa,
-  indexarExperienceIr,
-  montarCatalogoCapacidades,
-  validarContratoTemporalInterativo,
-  validarControlRunInterativo,
-  validarDefinicaoSistemaInterativo,
-  validarExperienceIr,
-} from "@semacode/cli";
+sema descobrir explicar flow.project-adoption --json
+sema iniciar --template base
+sema sync-codex --json
 ```
-
-Only the package-root exports are public. Internal `dist/*` deep imports remain
-blocked, and importing the package never parses CLI arguments or exits the host
-process. Programmatic validators and planners preserve the same read-only,
-non-authoritative boundary as their CLI equivalents.
-
+
+Initialization preserves existing files and rejects symlink or junction
+escapes. Use `--force` only when overwriting the template destinations is an
+explicit human decision; the Codex bootstrap skill never adds it.
+
+## Code Generation
+
+```bash
+sema compilar contratos/app.sema --alvo typescript --saida .tmp/app-ts --estrutura modulos
+sema compilar contratos/app.sema --alvo python --saida .tmp/app-py --estrutura modulos
+sema compilar contratos/app.sema --alvo php --saida .tmp/app-php --estrutura modulos
+sema compilar contratos/app.sema --alvo dotnet --saida .tmp/app-dotnet --estrutura modulos
+sema compilar contratos/app.sema --alvo cpp --saida .tmp/app-cpp --estrutura modulos
+```
+
+Generated artifacts include `SEMA-GOVERNED` headers and must stay aligned with
+the source contract.
+
+## Validation
+
+```bash
+sema validar contratos/app.sema --json
+sema diagnosticos contratos/app.sema --json
+sema testar contratos/app.sema --alvo typescript --saida .tmp/app-tests
+sema testar contratos/app.sema --alvo dotnet --saida .tmp/app-dotnet-tests
+sema testar contratos/app.sema --alvo cpp --saida .tmp/app-cpp-tests
+sema verificar contratos/app.sema --saida .tmp/app-check --json
+```
+
+## AI-native Content Pipeline
+
+`sema conteudo` validates and plans multi-channel, multi-format content work,
+verifies signed policies and evidence, replays canonical state, and projects
+non-authoritative manifests. Producer agents, specialized AI evaluators,
+creative tools, and delivery adapters run in an external runner; there is no
+native human-review transition.
+
+```bash
+sema conteudo validar exemplos/pipeline-conteudo/definicao.json --json
+sema conteudo planejar exemplos/pipeline-conteudo/definicao.json --alvos-arquivo exemplos/pipeline-conteudo/alvos.json --json
+```
+
+See `docs/pipeline-conteudo.md` for the signed trust, quorum, ledger, target,
+adapter, and projection model.
+
+## Capability Discovery and Interactive Systems
+
+`sema descobrir` exposes one explainable catalog and a deterministic intent
+router. `sema interativo` validates and plans games, simulations, and hybrids
+across independent spatial models, render modes, retro visual profiles, control,
+time, determinism, and fidelity axes without running an engine or silently
+mutating a workspace.
+
+```bash
+sema descobrir catalogo --json
+sema descobrir recomendar --intencao "calibrate a headless autonomous simulation" --json
+sema interativo schema --json
+sema interativo pipelines --json
+sema interativo validar exemplos/sistemas-interativos/simulation-headless-autonomous-batch.json --json
+```
+
+The canonical interactive catalog contains 35 unique pipelines and 28 unique
+external adapter descriptors. Its advanced P0/P1/P2 surface covers Experience
+IR, semantic engine snapshots, asset provenance, editor-state descriptions,
+multimodal evidence, resumable jobs, acceptance locks, temporal/shot/physics QA,
+clean-install and hardware constraints, safe autonomous repair, bounded
+playtest/fuzz plans, multiplayer authority, portability with declared losses,
+and distributed worker DAGs.
+
+Advanced read-only commands:
+
+```bash
+sema interativo validar-ir <file> --json
+sema interativo indexar-ir <file> --json
+sema interativo consultar-ir <file> --semantic-id <id> --json
+sema interativo chunk-ir <file> --semantic-id <id> [--raso] --json
+sema interativo descrever-ir --json
+
+sema interativo validar-engine-snapshot <file> --json
+sema interativo diff-engine-snapshots <before> <after> --json
+sema interativo validar-asset-provenance <file> --json
+sema interativo validar-editor-state <file> --json
+sema interativo planejar-jobs <file> --json
+sema interativo validar-acceptance <file> --json
+sema interativo operar-acceptance <lock> --operation <VALIDATE|EVALUATE|INVALIDATE> --context-file <file> --json
+sema interativo validar-multimodal <file> --json
+
+sema interativo validar-temporal <file> --json
+sema interativo validar-evidencia-temporal <contract> --bundle-arquivo <file> --json
+sema interativo validar-autonomia <file> --json
+sema interativo validar-playtest-fuzz <file> --json
+sema interativo validar-multiplayer <file> --json
+sema interativo analisar-portabilidade <file> --json
+sema interativo validar-workers <file> --json
+
+sema interativo validar-control-run <control-run.json> --definition-arquivo <definition.json> --plano-arquivo <plan.json> --contrato-arquivo <validation-contract.json> --entrada-arquivo <input.json> [--entrada-auxiliar-arquivo <supporting-input.json>] --evidencia-arquivo <evidence.json> --resultado-arquivo <result.json> --json
+```
+
+All of these commands are local and read-only. Adapter entries are external
+capability descriptors: the package does not detect, probe, launch, install, or
+control any engine, editor, plug-in, process, verifier, or worker. A
+`STRUCTURALLY_COMPLETE` result is local structural coverage only; it always
+remains `completed: false`, `authoritative: false`, and awaits external
+attestation. The CLI never equates a descriptor, fixture, plan, or supplied JSON
+record with proof that external work occurred.
+
+See `docs/descoberta-capacidades.md` and `docs/sistemas-interativos.md` for the
+ranking, adapter protocol, evidence boundary, fidelity, and coverage model.
+
+## Programmatic API
+
+The package root can be imported without executing the CLI process:
+
+```js
+import {
+  analisarPlanoPortabilidadeInterativa,
+  indexarExperienceIr,
+  montarCatalogoCapacidades,
+  validarContratoTemporalInterativo,
+  validarControlRunInterativo,
+  validarDefinicaoSistemaInterativo,
+  validarExperienceIr,
+} from "@semacode/cli";
+```
+
+Only the package-root exports are public. Internal `dist/*` deep imports remain
+blocked, and importing the package never parses CLI arguments or exits the host
+process. Programmatic validators and planners preserve the same read-only,
+non-authoritative boundary as their CLI equivalents.
+
 ## Public Boundary
 
 The npm package is local-only: its CLI and programmatic API do not depend on a
 hosted Sema service. It must not contain private or sensitive operational
 material.
 
-## Commercial Use
-
-Sema is public source for local semantic governance, but commercial resale,
-white-label redistribution, or commercial replicas require written permission
-from OtimiTare.
-
-## Support
-
-Use [suporte@otimitare.online](mailto:suporte@otimitare.online) for support.
+Contributors must create the tarball through `npm run cli:empacotar-publica`
+from the repository root. Direct `npm pack` in this source package is blocked:
+the official factory uses an isolated per-run stage and is the only supported
+path that bundles runtime packages, examples, documentation, the launcher, and
+the Sema skill.
+
+## Commercial Use
+
+Sema is public source for local semantic governance, but commercial resale,
+white-label redistribution, or commercial replicas require written permission
+from OtimiTare.
+
+## Support
+
+Use [suporte@otimitare.online](mailto:suporte@otimitare.online) for support.

package/dist/agentContextPack.js

@@ -1,4 +1,4 @@
-// SEMA-GOVERNED: sema.produto.governanca_ia.contexto.agent_pack
+// SEMA-GOVERNED: sema.produto.governanca_ia.contexto.agent_pack, sema.produto.governanca_ia.drift.cache.modos
 // Descrição: monta o Agent Context Pack e políticas que agentes fracos, médios e fortes consomem antes do código.
 import { LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO, LIMITE_AVISO_LINHAS_CONTRATO_SEMA, LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO, LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA, } from './driftOrcamento.js';
 import { ALIASES_CAPACIDADE_IA, ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_ENTRYPOINT_CODEX, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, EXEMPLOS_OFICIAIS_AGENT_CONTEXT, } from './agentContextTipos.js';
@@ -167,7 +167,7 @@ function criarFailClosedAgentContext() {
     return [
         "Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
         "Se não houver contrato aplicável ou vínculo semântico do arquivo, inspecione o arquivo, descubra ou crie o .sema aplicável e vincule antes do código.",
-        "Em workspace local, rode sema --version; se falhar, pare e peça a instalação da CLI. Com a CLI disponível, opere diretamente sobre a pasta local e não substitua essa fonte por espelho externo ou inferência.",
+        "Em workspace local, rode sema --version; se o shell não localizar o comando, use $HOME/.sema/bin/sema no macOS/Linux. No Windows, PowerShell usa sema.ps1 no PATH e cmd.exe usa sema.cmd; use & \"$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File \"$HOME\\.sema\\bin\\sema-managed.ps1\" --version como fallback. Só então declare a CLI indisponível.",
         "Se não houver workspace local em disco, pare bloqueado e peça o fluxo apropriado; não invente caminho nem substitua a CLI local por ferramenta paralela.",
         `Se arquivos_codigo.conteudo ou conteudo inline passar de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres, não aumente timeout para forçar: divida por responsabilidade ou use anexo/caminho de servidor autorizado.`,
         "Se for criar ou corrigir .sema, leia `exemplos/`; se a pasta estiver ausente, rode `sema instalar-exemplos --json` antes de escrever sintaxe.",
@@ -178,7 +178,7 @@ function criarFailClosedAgentContext() {
         "Um mesmo arquivo de codigo pode ser governado por varios contratos .sema via vinculos; Sema Codigo deve preservar essa rastreabilidade.",
         "Se score, achados ou decisaoAgente parecerem bons, trate como sinal de triagem e confira evidência concreta no contrato e no código.",
         "Se validar artefato inline com 100/100, ainda preserve cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
-        "Se `sema drift` retornar sucesso:false, `vinculos_quebrados`, `rotas_divergentes` ou impls quebradas, a mudanca nao pode ser declarada concluida; corrija contrato/codigo e rode drift de novo.",
+        "Se o `payload` de `sema drift --cache fresh --json` retornar sucesso:false, `vinculos_quebrados`, `rotas_divergentes` ou `impls_quebrados`, a mudança não pode ser declarada concluída; corrija contrato/código e rode drift fresh de novo.",
         "Se a tarefa tiver site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal, nao conclua sem acabamento moderno, contextual e evidenciado; em UI mobile estreita (ex. 390px), `document.documentElement.scrollWidth <= document.documentElement.clientWidth` precisa ser verdadeiro.",
         "Se texto visivel PT-BR perder acento ou cedilha em termos como descricao, lancamentos, saude ou alimentacao, trate como defeito bloqueante quando houver i18n/idioma declarado.",
         "Se aparecer caminho que não pertence ao workspace local aberto pelo usuário, pare e confirme a fonte antes de agir.",
@@ -306,12 +306,15 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             "Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy.",
             "Leia docs/commands.md antes de escolher comando Sema, interpretar um gate ou usar --saida de sema compilar.",
             "Quando a intenção não deixar claro qual profile, workflow, pipeline, gerador ou adapter usar, rode `sema descobrir recomendar --intencao \"<objetivo>\" --json`; a recomendação informa, mas nunca se autoexecuta.",
-            "Em workspace local, rode sema --version; se falhar, pare e peça a instalação da CLI. Com a CLI disponível, use diretamente sema resumo, docs-impacto, inspecionar, drift e impacto sobre a pasta local.",
-            "Antes de editar, rode `sema inspecionar <contrato.sema> --json`, `sema drift <contrato.sema> --escopo modulo --json` e `sema impacto <contrato.sema> --alvo <token> --mudanca \"<descricao>\" --json`.",
+            "Em workspace local, rode sema --version; se o shell falhar, use $HOME/.sema/bin/sema no macOS/Linux. No Windows, PowerShell usa sema.ps1 no PATH e cmd.exe usa sema.cmd; use & \"$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File \"$HOME\\.sema\\bin\\sema-managed.ps1\" --version como fallback. Só depois peça instalação ou reparo.",
+            "`sema resumo` e `sema inspecionar` usam análise `none` por padrão: não executam drift e mantêm score, confiança, implementação e superfícies derivadas como nulos/não avaliados; use `--drift cache|fresh` somente quando precisar dessa evidência.",
+            "Quando `resumo` ou `inspecionar` executa drift explicitamente, `payload.analiseDrift.sucesso` deve ser verdadeiro ou falso e uma falha solicitada mantém exit code diferente de zero.",
+            "Na CLI 3.0.0, `sema --version` continua texto SemVer exato; com `--json`, help e falhas de controle usam o envelope exato `sema.cli.control/v1`, enquanto todo comando sintaticamente válido usa o envelope exato de oito campos `sema.cli.result/v1`, mantém o resultado do comando em `payload` e não confunde `ok` de transporte com o veredito de domínio dentro desse payload.",
+            "Antes de editar, rode `sema inspecionar <contrato.sema> --drift none --json`, `sema drift <contrato.sema> --escopo modulo --cache fresh --json` e `sema impacto <contrato.sema> --alvo <token> --mudanca \"<descricao>\" --json`.",
             "Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.",
             "Use SEMA_INDEX.json para escolher contrato, módulo e arquivos prováveis antes de abrir código cru.",
             "Valide .sema alterado e rode drift antes de concluir.",
-            "Conclusao so e valida se `sema drift --json` retornar sucesso:true, sem `vinculos_quebrados`, sem `rotas_divergentes` e sem impls quebradas.",
+            "Conclusão só é válida se o `payload` de `sema drift --cache fresh --json` retornar sucesso:true, sem `vinculos_quebrados`, sem `rotas_divergentes` e sem `impls_quebrados`; hit de cache orienta trabalho, mas não substitui evidência fresh de fechamento.",
             "Quando faltar contrato aplicável ou vínculo semântico do arquivo, inspecione o arquivo, crie/edite o contrato aplicável e vincule antes do código.",
             "Sema não contorna políticas da plataforma; ele governa contrato, escopo, drift, evidência e qualidade.",
             "Responda no idioma do usuário; em PT-BR, use vocabulário Sema canônico e preserve acentos, cedilha, pontuação e símbolos humanos.",
@@ -334,14 +337,15 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             "Não tratar a pasta --saida de sema compilar como entrega final; entrega são os arquivos alvo/vínculos do contrato.",
             "Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
             "Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
-            "Não assumir repositório público, GitHub Release pública ou fonte externa de workspace; em ambiente local, prove a CLI com sema --version.",
+            "Não assumir repositório público, GitHub Release pública ou fonte externa de workspace; em ambiente local, prove a CLI com sema --version ou com o launcher gerenciado absoluto.",
             "Não usar a estética ASCII da DSL nem inglês de produto como desculpa para fugir do vocabulário Sema em PT-BR.",
             "Não remover SEMA-GOVERNED nem substituir drift por comentário dentro do código.",
             "Não copiar o contrato inteiro para comentário de código; mantenha descrição humana curta.",
             "Nao tratar orcamento semantico como sugestao; codigo governado ou contrato .sema grande deve ser dividido antes de concluir.",
             "Nao fatiar codigo ou contrato grande em partes sem responsabilidade real para passar no limite.",
             "Não tratar score 100, regex ou presença de palavra-chave como prova suficiente de governança; pontuação abaixo do piso ou do alvo evolutivo bloqueia conclusão.",
-            "Nao dizer que drift passou limpo quando o JSON trouxe sucesso:false, vinculos_quebrados, rotas_divergentes ou impls quebradas.",
+            "Nao dizer que drift passou limpo quando o `payload` do JSON trouxe sucesso:false, vinculos_quebrados, rotas_divergentes ou impls_quebrados.",
+            "Não ler campos específicos do comando no topo de `sema.cli.result/v1`, não usar `data` como alias de `payload` e não tratar `ok` como substituto de `payload.sucesso` ou outro veredito de domínio.",
             "Não tratar validação inline como dispensa de cabeçalho SEMA-GOVERNED no arquivo físico.",
             `Não tentar resolver payload inline acima de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres aumentando timeout.`,
             `Nao culpar o limite de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO} linhas para codigo ou ${LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA} linhas para .sema por arquitetura monolitica escolhida pela IA.`,
@@ -353,14 +357,14 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         prioridades: [
             "Menor artefato suficiente primeiro.",
             "Catálogo de discovery antes de escolher por chute entre profile, workflow, pipeline, gerador ou adapter.",
-            "Workspace local: sema --version, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare e peça a instalação da CLI.",
+            "Workspace local: sema --version, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; sem shim, use $HOME/.sema/bin/sema ou, no Windows, sema.ps1 pelo PATH / sema.cmd no cmd.exe / & \"$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe\" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File \"$HOME\\.sema\\bin\\sema-managed.ps1\" --version, e só depois peça reparo.",
             "Contrato, índice e AGENTS complementam o contexto Sema; não substituem chamada Sema.",
             "Exemplos oficiais antes de nova sintaxe.",
             "Diagnóstico estruturado antes de opinião livre.",
             "Compatibilidade com políticas da plataforma antes de reformular ou continuar após alerta externo.",
             "Sinal sem evidência vira ritual; evidência concreta antes de concluir aderência.",
             "Retry progressivo em timeout antes de declarar bloqueio.",
-            "Fechamento honesto: drift JSON verde antes de dizer concluido; sucesso:false, vinculo quebrado ou rota divergente ainda e bloqueio.",
+            "Fechamento honesto: `payload` do drift JSON verde antes de dizer concluido; sucesso:false, vinculo quebrado ou rota divergente ainda e bloqueio.",
             "Separar limite de transporte inline de lentidão real: payload grande demais exige split/transporte correto, não retry infinito.",
             "Orçamento semântico, divisão por responsabilidade e cabeçalho governado antes de gravar ou finalizar código.",
             "Acabamento visual/terminal por capacidade quando houver experiência de uso, com prova de viewport mobile sem overflow horizontal ou smoke check de comando.",

package/dist/agentEntryPoints.d.ts

@@ -16,10 +16,15 @@ export declare function sincronizarEntrypointCodex(baseProjeto: string, agentCon
     codexNativo: true;
     cliLocalSemAutorizacao: true;
     skillBootstrapCodexDocumentada: true;
+    launcherGlobalFallbackDocumentado: true;
+    cliIndisponivelSomenteAposFallback: true;
+    skillGlobalDelegaAgentsMd: true;
     idiomaHumanoPreservado: true;
     retryTimeoutProgressivo: true;
     politicaPlataformaExplicita: true;
     politicaSinalVsRitualExplicita: true;
+    politicaModosDriftExplicita: true;
+    docsComandos: true;
     divisaoPorResponsabilidadeExplicita: true;
     contextoLocalSemEspelho: true;
     destinosEntrypointPrevalidados: true;