@semacode/cli 1.5.42 → 1.5.43

package/AGENTS.md

@@ -19,23 +19,24 @@ Idioma humano: responda no idioma falado pelo usuário. Em PT-BR, use acentos, c
 
 ## Regras
 
-1. Em IDE/local com workspace no disco, use a Sema CLI. Antes de qualquer leitura de projeto, rode `sema preflight resumo --json`; se `decisao` não for `use_cli_local`, pare bloqueado.
-2. Com CLI autorizada, rode `sema resumo`, depois `sema docs-impacto --intencao "<ação declarada>" --json`, leia as docs obrigatórias e só então avance.
-3. Em web/chat/remoto sem workspace local, use MCP remoto: `sema_chat_contexto`, depois `sema_sync` inline com contrato `.sema`, código selecionado, documentação e índice. Use o `projeto` retornado nas chamadas seguintes.
-4. É proibido usar MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ou `sema mcp-client` para ler workspace local quando a CLI estiver operacional.
-5. Antes de criar qualquer módulo, rota, task ou contrato, chame `sema inspecionar` ou `sema_inspecionar` no arquivo `.sema` mais próximo.
-6. Antes de editar código existente, chame `sema drift` e `sema impacto` ou as ferramentas MCP equivalentes no projeto remoto sincronizado.
-7. Ao criar ou editar um arquivo `.sema`, chame `sema validar` ou `sema_validar` ao final.
-8. Nunca invente contratos — use o Sema para descobrir o que já existe.
-9. Se qualquer ferramenta Sema retornar erro, corrija o problema antes de prosseguir — não avance com código enquanto houver erros Sema pendentes.
-10. Contrato vem antes de qualquer ação: crie, edite ou remova o `.sema` aplicável antes de código, deploy, docs operacionais, workflow, texto Author, game, legal, research ou ops.
+1. Em IDE/local com workspace no disco, use a Sema CLI. Antes de qualquer leitura de projeto, rode `sema --version`; se o comando não existir, pare. A IA não acessa o painel Sema: peça ao humano para abrir o painel, baixar/rodar o instalador de chave e repetir `sema --version`.
+2. Depois rode `sema preflight resumo --json`; se `decisao` não for `use_cli_local`, pare bloqueado.
+3. Com CLI autorizada, rode `sema resumo`, depois `sema docs-impacto --intencao "<ação declarada>" --json`, leia as docs obrigatórias e só então avance.
+4. Em web/chat/remoto sem workspace local, use MCP remoto: `sema_chat_contexto`, depois `sema_sync` inline com contrato `.sema`, código selecionado, documentação e índice. Use o `projeto` retornado nas chamadas seguintes.
+5. É proibido usar MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ou `sema mcp-client` para ler workspace local quando a CLI estiver operacional.
+6. Antes de criar qualquer módulo, rota, task ou contrato, chame `sema inspecionar` ou `sema_inspecionar` no arquivo `.sema` mais próximo.
+7. Antes de editar código existente, em IDE/local chame `sema drift` e `sema impacto`. Em web/remoto, use `sema_drift` e `sema_impacto` somente sobre o projeto remoto sincronizado.
+8. Ao criar ou editar um arquivo `.sema`, chame `sema validar` ou `sema_validar` ao final.
+9. Nunca invente contratos — use o Sema para descobrir o que já existe.
+10. Se qualquer ferramenta Sema retornar erro, corrija o problema antes de prosseguir — não avance com código enquanto houver erros Sema pendentes.
+11. Contrato vem antes de qualquer ação: crie, edite ou remova o `.sema` aplicável antes de código, deploy, docs operacionais, workflow, texto Author, game, legal, research ou ops.
 
 ## MCP
 
 O servidor MCP do Sema e uma superficie privada/comercial acessada por endpoint remoto autorizado; ele nao e instalado pelo pacote npm do instalador neste repositorio.
 Use as ferramentas quando o endpoint privado estiver configurado: sema_resumo, sema_validar, sema_drift, sema_impacto, sema_renomear_semantico, sema_inspecionar, sema_ir, sema_verificar, sema_contexto_ia, sema_prompt_ia, sema_author_iniciar, sema_author_validar, sema_author_briefing, sema_author_revisar_cliches, sema_sync_ai_entrypoints, sema_exemplos, sema_instalar_exemplos, sema_docs_impacto, sema_finalizar_mudanca.
 
-Em IDE/local, a superfície principal é a Sema CLI. A CLI deve estar instalada com tudo que precisa, deve ter `SEMA_CLI_AUTH_TOKEN` e deve chamar `sema preflight <comando> --json` antes de operar. Se `decisao` não for `use_cli_local`, pare. Não use MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local quando a CLI estiver operacional.
+Em IDE/local, a superfície principal é a Sema CLI. A IA deve provar a CLI com `sema --version`; se falhar, deve parar. A IA não acessa o painel Sema: peça ao humano para instalar pelo painel. A CLI deve ter `SEMA_CLI_AUTH_TOKEN` e deve chamar `sema preflight <comando> --json` antes de operar. Se `decisao` não for `use_cli_local`, pare. Não use MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local quando a CLI estiver operacional.
 
 Em web/chat/remoto sem workspace local, use MCP remoto: `sema_chat_contexto`, depois `sema_sync` inline com contrato, código selecionado, documentação e índice, e então use o `projeto` retornado.
 
@@ -45,12 +46,13 @@ O MCP deve deixar claro em toda orientacao: se nao existe contrato, crie; se a i
 
 ### IDEs locais (Codex, Roo Code, VS Code, Cursor, Windsurf, etc.)
 Quando houver workspace local:
-1. Rode `sema preflight resumo --json`; se `decisao` não for `use_cli_local`, pare.
-2. Rode `sema resumo` para entender o estado atual.
-3. **ANTES DE QUALQUER AÇÃO**: rode `sema docs-impacto --intencao "<acao>" --json`.
-4. Leia as docs obrigatórias antes de agir.
-5. Rode `sema inspecionar`, `sema drift` e `sema impacto` antes de editar.
-6. Use `sema finalizar-mudanca` para comprovar que leu as docs.
+1. Rode `sema --version`; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para abrir o painel, baixar/rodar o instalador de chave e repetir `sema --version`.
+2. Rode `sema preflight resumo --json`; se `decisao` não for `use_cli_local`, pare.
+3. Rode `sema resumo` para entender o estado atual.
+4. **ANTES DE QUALQUER AÇÃO**: rode `sema docs-impacto --intencao "<acao>" --json`.
+5. Leia as docs obrigatórias antes de agir.
+6. Rode `sema inspecionar`, `sema drift` e `sema impacto` antes de editar.
+7. Use `sema finalizar-mudanca` para comprovar que leu as docs.
 
 ### Web / Chat (ChatGPT, Lovable, etc.)
 Quando usar Sema via MCP remoto sem workspace local:

package/AGENT_CONTEXT_PACK.json

@@ -16,7 +16,7 @@
     "Contrato vem antes da ação.",
     "Leia SEMA_BOOT.md antes de qualquer outro artefato de IA.",
     "Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy.",
-    "Em IDE local, chame sema preflight <comando> --json e use a CLI; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para ler workspace local; em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline.",
+    "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois chame sema preflight <comando> --json e use a CLI somente com use_cli_local; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para workspace local; em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline.",
     "Antes de editar, chame sema_inspecionar no contrato aplicável e rode sema_drift e sema_impacto.",
     "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.",
@@ -40,7 +40,7 @@
     "Não substituir contexto Sema por AGENTS.md, README.md, busca local, inferência pelo nome do projeto ou bom senso sem preflight/autorização Sema.",
     "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 leitura local pelo MCP; em IDE local use CLI, em web/remoto use sync inline.",
+    "Não assumir repositório público, GitHub Release pública, leitura local pelo MCP ou acesso da IA ao painel; em IDE local prove CLI com sema --version, em web/remoto use sync inline.",
     "Não usar a estética ASCII da DSL como desculpa para escrever PT-BR sem acentos.",
     "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.",
@@ -56,7 +56,7 @@
   ],
   "prioridades": [
     "Menor artefato suficiente primeiro.",
-    "IDE local: sema preflight, resumo, docs-impacto, inspecionar, drift e impacto pela CLI, sem MCP remoto, sema_sync, sema_contratos_sincronizar ou sema mcp-client para ler workspace; web/remoto: sema_chat_contexto e sema_sync inline.",
+    "IDE local: sema --version, preflight, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare. A IA não acessa o painel Sema: peça ao humano instalar pelo painel; sem MCP remoto, sema_sync, sema_contratos_sincronizar ou sema mcp-client para workspace; web/remoto: sema_chat_contexto e sema_sync inline.",
     "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.",
@@ -440,7 +440,7 @@
   "failClosed": [
     "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, crie ou edite o .sema antes do código.",
-    "Em IDE local, rode sema preflight <comando> --json; se decisao não for use_cli_local, pare e declare bloqueio; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para ler workspace local.",
+    "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois rode sema preflight <comando> --json; só continue com use_cli_local; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para workspace local.",
     "Em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline com contrato, código selecionado, documentação e índice; se falhar, pare.",
     "Se arquivos_codigo.conteudo ou conteudo inline passar de 262144 caracteres, não aumente timeout para forçar: divida por responsabilidade ou use anexo/caminho de servidor autorizado.",
     "Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",

package/README.md

@@ -4,9 +4,9 @@
 
 `@semacode/cli` is the npm installer/client for the governed Sema CLI. In local IDEs, it is the complete Sema runtime for workspace access. It is not the MCP server and it is not the commercial control plane.
 
-The CLI checks SEMAS with the commercial control plane before local action through `sema preflight <command> --json`. The site key installer installs Node/npm when missing, installs this package globally, and saves `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL`, and compatibility MCP env vars.
+The CLI checks SEMAS with the commercial control plane before local action through `sema preflight <command> --json`. The site key installer installs Node/npm when missing, installs this package globally, and saves `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL`, and compatibility MCP env vars. In a local IDE, the agent runs `sema --version` first; if it fails, it stops and asks the human to open the Sema panel and run the key installer.
 
-Use the CLI directly in local IDEs. Run `sema preflight resumo --json` and stop unless the decision is `use_cli_local`. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` just to read a local workspace. Remote MCP remains the web/chat surface for ChatGPT, Lovable, GPTs, and similar clients without local workspace access.
+Use the CLI directly in local IDEs. Run `sema --version` first; if it fails, ask the human to install through the Sema panel. Then run `sema preflight resumo --json` and stop unless the decision is `use_cli_local`. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` just to read a local workspace. Remote MCP remains the web/chat surface for ChatGPT, Lovable, GPTs, and similar clients without local workspace access.
 
 ```bash
 npm install -g @semacode/cli
@@ -15,6 +15,7 @@ npm install -g @semacode/cli
 ### Runtime Flow
 
 ```bash
+sema --version
 sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
@@ -35,9 +36,9 @@ The command stores the commercial key in the local user environment as `SEMA_CLI
 
 `@semacode/cli` agora é o instalador/cliente npm da CLI governada da Sema. Em IDE local, ele é o runtime completo da Sema para acesso ao workspace. Ele não é o servidor MCP nem o control plane comercial.
 
-A CLI consulta SEMAS no control plane comercial antes de agir localmente com `sema preflight <comando> --json`. O instalador de chave do site instala Node/npm quando faltar, instala este pacote globalmente e grava `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` e variáveis MCP de compatibilidade.
+A CLI consulta SEMAS no control plane comercial antes de agir localmente com `sema preflight <comando> --json`. O instalador de chave do site instala Node/npm quando faltar, instala este pacote globalmente e grava `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` e variáveis MCP de compatibilidade. Em IDE local, o agente roda `sema --version` primeiro; se falhar, ele para e pede ao humano para abrir o painel Sema e rodar o instalador de chave.
 
-Use a CLI diretamente em IDE local. Rode `sema preflight resumo --json` e pare se a decisão não for `use_cli_local`. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` só para ler workspace local. O MCP remoto continua sendo a superfície web/chat para ChatGPT, Lovable, GPTs e clientes parecidos sem acesso ao workspace local.
+Use a CLI diretamente em IDE local. Rode `sema --version` primeiro; se falhar, peça ao humano para instalar pelo painel Sema. Depois rode `sema preflight resumo --json` e pare se a decisão não for `use_cli_local`. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` só para ler workspace local. O MCP remoto continua sendo a superfície web/chat para ChatGPT, Lovable, GPTs e clientes parecidos sem acesso ao workspace local.
 
 ```bash
 npm install -g @semacode/cli
@@ -46,6 +47,7 @@ npm install -g @semacode/cli
 ### Fluxo De Runtime
 
 ```bash
+sema --version
 sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
@@ -66,9 +68,9 @@ O comando grava a chave comercial no ambiente local do usuário como `SEMA_CLI_A
 
 `@semacode/cli` ahora es el instalador/cliente npm de la CLI gobernada de Sema. En una IDE local, es el runtime completo de Sema para acceso al workspace. No es el servidor MCP ni el control plane comercial.
 
-La CLI consulta SEMAS en el control plane comercial antes de actuar localmente con `sema preflight <comando> --json`. El instalador de clave del sitio instala Node/npm cuando falten, instala este paquete globalmente y guarda `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` y variables MCP de compatibilidad.
+La CLI consulta SEMAS en el control plane comercial antes de actuar localmente con `sema preflight <comando> --json`. El instalador de clave del sitio instala Node/npm cuando falten, instala este paquete globalmente y guarda `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` y variables MCP de compatibilidad. En una IDE local, el agente ejecuta `sema --version` primero; si falla, para y pide al humano que abra el panel Sema y ejecute el instalador de clave.
 
-Usa la CLI directamente en una IDE local. Ejecuta `sema preflight resumo --json` y para si la decisión no es `use_cli_local`. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` solo para leer un workspace local. El MCP remoto sigue siendo la superficie web/chat para ChatGPT, Lovable, GPTs y clientes similares sin acceso al workspace local.
+Usa la CLI directamente en una IDE local. Ejecuta `sema --version` primero; si falla, pide al humano que instale desde el panel Sema. Después ejecuta `sema preflight resumo --json` y para si la decisión no es `use_cli_local`. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` solo para leer un workspace local. El MCP remoto sigue siendo la superficie web/chat para ChatGPT, Lovable, GPTs y clientes similares sin acceso al workspace local.
 
 ```bash
 npm install -g @semacode/cli
@@ -77,6 +79,7 @@ npm install -g @semacode/cli
 ### Flujo De Runtime
 
 ```bash
+sema --version
 sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json

package/SEMA_BRIEF.curto.txt

@@ -14,4 +14,4 @@ TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produt
 TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+186)
 TOP_LACUNAS: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
 TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\agentes-por-capacidade.md, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\deploy.md (+140)
-GERADO_EM: 2026-06-07T16:13:27.495Z
+GERADO_EM: 2026-06-07T18:00:27.640Z

package/SEMA_BRIEF.md

@@ -2,7 +2,7 @@
 
 Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem varrer o repo inteiro no escuro.
 
-- Gerado em: `2026-06-07T16:13:27.495Z`
+- Gerado em: `2026-06-07T18:00:27.640Z`
 - Modulos: `89`
 
 ## Entrada canonica para IA
@@ -17,7 +17,7 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 
 - Arquivo: `AGENT_CONTEXT_PACK.json`
 - Objetivo: Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.
-- Regras: Contrato vem antes da ação. | Leia SEMA_BOOT.md antes de qualquer outro artefato de IA. | Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy. | Em IDE local, chame sema preflight <comando> --json e use a CLI; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para ler workspace local; em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline.
+- Regras: Contrato vem antes da ação. | Leia SEMA_BOOT.md antes de qualquer outro artefato de IA. | Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy. | Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois chame sema preflight <comando> --json e use a CLI somente com use_cli_local; não use MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para workspace local; em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline.
 - Fontes brutas sob demanda: SEMA_BOOT.md, SEMA_SMALL_MODEL.md, llms.txt, AGENT_CONTEXT_PACK.json, SEMA_BRIEF.micro.txt, SEMA_BRIEF.curto.txt, SEMA_INDEX.json
 
 ## Políticas da plataforma

package/SEMA_BRIEF.micro.txt

@@ -13,4 +13,4 @@ DESIGN_VISUAL: se houver UI, moderno obrigatorio; fraca=padrao seguro responsivo
 TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+86)
 TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+189)
 TOP_LACUNAS: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida (+1)
-GERADO_EM: 2026-06-07T16:13:27.495Z
+GERADO_EM: 2026-06-07T18:00:27.640Z