@semacode/cli 1.5.40 → 1.5.42

package/AGENTS.md

@@ -19,43 +19,55 @@ Idioma humano: responda no idioma falado pelo usuário. Em PT-BR, use acentos, c
 
 ## Regras
 
-1. Ao abrir o projeto, chame sema_resumo para entender o estado atual.
-2. Antes de criar qualquer modulo, rota, task ou contrato, chame sema_inspecionar no arquivo .sema mais proximo.
-3. Antes de editar codigo existente, chame sema_drift para verificar divergencias entre contrato e implementacao.
-4. Ao criar ou editar um arquivo .sema, chame sema_validar ao final.
-5. Nunca invente contratos — use o Sema para descobrir o que ja existe.
-6. Se qualquer ferramenta Sema retornar erro, corrija o problema antes de prosseguir — nao avance com codigo enquanto houver erros Sema pendentes.
-7. Contrato vem antes de qualquer acao: crie, edite ou remova o `.sema` aplicavel antes de codigo, 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 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.
 
 ## 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 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.
+
 O MCP deve deixar claro em toda orientacao: se nao existe contrato, crie; se a intencao mudou, edite; se a capacidade saiu, remova ou aposente. Isso vale para todo tipo de Sema: Software, Author, Workflow, Ops, Game, Legal, Research e profiles futuros.
 
 ## Plataformas e Interfaces
 
-### IDEs com MCP (Roo Code, VS Code, Cursor, Windsurf, etc.)
-Quando usar MCP Sema configurado:
-1. Ao abrir o projeto, chame `sema_resumo` para entender o estado atual
-2. **ANTES DE QUALQUER AÇÃO**: chame `sema_docs_impacto` com sua intenção declarada
-3. Aguarde a resposta com as docs obrigatórias e leia-as antes de agir
-4. Use `sema_finalizar_mudanca` para comprovar que leu as docs
+### 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.
 
 ### Web / Chat (ChatGPT, Lovable, etc.)
-Quando usar Sema via web sem MCP:
-1. Ao abrir o projeto, chame `sema_resumo` (se disponivel via web hook)
-2. **ANTES DE QUALQUER AÇÃO**: Declare sua intenção ao usuário
-3. Use `sema_docs_impacto` para descobrir docs obrigatórias (se via API)
-4. Leia as docs antes de agir e finalize com `sema_finalizar_mudanca`
+Quando usar Sema via MCP remoto sem workspace local:
+1. Chame `sema_chat_contexto` para confirmar conexão e orientação.
+2. **ANTES DE QUALQUER AÇÃO**: declare sua intenção ao usuário.
+3. Chame `sema_sync` com contrato `.sema`, código selecionado, documentação e índice.
+4. Use obrigatoriamente o `projeto` retornado por `sema_sync`.
+5. Chame `sema_resumo`, `sema_docs_impacto`, `sema_inspecionar`, `sema_drift` e `sema_impacto` usando esse `projeto`.
+6. Leia as docs antes de agir e finalize com `sema_finalizar_mudanca`.
 
 ### CLI / Terminal
 Quando usar Sema via CLI:
-1. Execute `sema resumo` para entender o estado atual
-2. Execute `sema docs-impacto` antes de qualquer ação
-3. Leia as docs recomendadas antes de editar/criar/deletar
-4. Execute `sema finalizar-mudanca` ao concluir
+1. Execute `sema preflight <comando> --json` antes de operar; se bloquear, pare.
+2. Execute `sema resumo` para entender o estado atual.
+3. Execute `sema docs-impacto` antes de qualquer ação.
+4. Leia as docs recomendadas antes de editar/criar/deletar.
+5. Execute `sema finalizar-mudanca` ao concluir.
 
 ## Contratos e exemplos
 

package/AGENT_CONTEXT_PACK.json

@@ -16,6 +16,8 @@
     "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.",
+    "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.",
     "Valide .sema alterado e rode drift antes de concluir.",
@@ -35,9 +37,10 @@
   "proibicoes": [
     "Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
     "Não tratar README, texto livre ou código como fonte superior ao contrato.",
+    "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; confira docs de repositórios e AGENTS.md.",
+    "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 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.",
@@ -53,7 +56,8 @@
   ],
   "prioridades": [
     "Menor artefato suficiente primeiro.",
-    "Contrato, índice e AGENTS antes de código cru.",
+    "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.",
+    "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.",
@@ -329,7 +333,7 @@
     }
   ],
   "politicaIdioma": {
-    "regra": "A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos.",
+    "regra": "A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos. Em PT-BR, texto humano sem acentos é entrega inválida.",
     "idiomaHumanoPadrao": "pt-BR quando a conversa ou o projeto estiverem em português; caso contrário, use o idioma falado pelo usuário.",
     "preservarAcentos": true,
     "separarDslDeTextoHumano": true,
@@ -436,7 +440,8 @@
   "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.",
-    "Se o MCP remoto não tiver projeto sincronizado, use sema_chat_contexto e sema_sync/conteúdo inline; não peça para ler C:\\GitHub\\Sema.",
+    "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 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.",
     "Se a resposta humana estiver em PT-BR, preserve acentos e símbolos mesmo que a DSL use ASCII.",

package/README.md

@@ -2,9 +2,11 @@
 
 ## English
 
-`@semacode/cli` is the npm installer/client for the governed Sema CLI. It is not the MCP server and it is not the commercial control plane.
+`@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 private MCP coordinates authentication, project selection, SEMAS consumption, profile routing, and final decisions. The CLI executes the local or VPS-side work: contract validation, drift, impact, AI-first context, documentation gates, profile checks, and selected project actions.
+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.
+
+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.
 
 ```bash
 npm install -g @semacode/cli
@@ -13,6 +15,7 @@ npm install -g @semacode/cli
 ### Runtime Flow
 
 ```bash
+sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
 sema drift contratos/pedidos.sema --escopo modulo --json
@@ -20,19 +23,21 @@ sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema
 sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
 ```
 
-### MCP Client Key
+### Local Key
 
 ```bash
 printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
 ```
 
-The command stores the commercial MCP key in the local user environment as `SEMA_MCP_AUTH_TOKEN` without receiving the secret as a CLI argument.
+The command stores the commercial key in the local user environment as `SEMA_CLI_AUTH_TOKEN` and keeps `SEMA_MCP_AUTH_TOKEN` for compatibility, without receiving the secret as a CLI argument.
 
 ## Português
 
-`@semacode/cli` agora é o instalador/cliente npm da CLI governada da Sema. Ele não é o servidor MCP nem o control plane comercial.
+`@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.
 
-O MCP privado coordena autenticação, seleção de projeto, consumo de SEMAS, roteamento de profiles e decisões finais. A CLI executa o trabalho local ou na VPS: validação de contrato, drift, impacto, contexto IA-first, gates de documentação, checks de profiles e ações selecionadas do projeto.
+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.
 
 ```bash
 npm install -g @semacode/cli
@@ -41,6 +46,7 @@ npm install -g @semacode/cli
 ### Fluxo De Runtime
 
 ```bash
+sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
 sema drift contratos/pedidos.sema --escopo modulo --json
@@ -48,19 +54,21 @@ sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema
 sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
 ```
 
-### Chave MCP Do Cliente
+### Chave Local
 
 ```bash
 printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
 ```
 
-O comando grava a chave MCP comercial no ambiente local do usuário como `SEMA_MCP_AUTH_TOKEN`, sem receber o segredo como argumento da CLI.
+O comando grava a chave comercial no ambiente local do usuário como `SEMA_CLI_AUTH_TOKEN` e mantém `SEMA_MCP_AUTH_TOKEN` por compatibilidade, sem receber o segredo como argumento da CLI.
 
 ## Español
 
-`@semacode/cli` ahora es el instalador/cliente npm de la CLI gobernada de Sema. No es el servidor MCP ni el control plane comercial.
+`@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.
 
-El MCP privado coordina autenticación, selección de proyecto, consumo de SEMAS, ruteo de profiles y decisiones finales. La CLI ejecuta el trabajo local o en la VPS: validación de contrato, drift, impacto, contexto IA-first, gates de documentación, checks de profiles y acciones seleccionadas del proyecto.
+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.
 
 ```bash
 npm install -g @semacode/cli
@@ -69,6 +77,7 @@ npm install -g @semacode/cli
 ### Flujo De Runtime
 
 ```bash
+sema preflight resumo --json
 sema resumo . --curto
 sema validar contratos/pedidos.sema --json
 sema drift contratos/pedidos.sema --escopo modulo --json
@@ -76,10 +85,10 @@ sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema
 sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
 ```
 
-### Clave MCP Del Cliente
+### Clave Local
 
 ```bash
 printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
 ```
 
-El comando guarda la clave MCP comercial en el entorno local del usuario como `SEMA_MCP_AUTH_TOKEN`, sin recibir el secreto como argumento de la CLI.
+El comando guarda la clave comercial en el entorno local del usuario como `SEMA_CLI_AUTH_TOKEN` y mantiene `SEMA_MCP_AUTH_TOKEN` por compatibilidad, sin recibir el secreto como argumento de la CLI.

package/SEMA_BRIEF.curto.txt

@@ -11,7 +11,7 @@ ORCAMENTO_SEMANTICO: acima de 300 linhas exige refatoracao planejada; acima de 5
 PAYLOAD_MCP: conteudo inline acima de 262144 caracteres deve virar arquivos logicos, anexo, caminho de servidor autorizado ou manifesto; nao aumente timeout para empurrar o mesmo payload
 DESIGN_VISUAL: Quando a tarefa envolve interface, app, site, dashboard, painel, formulário, landing, jogo ou artefato visual, o Sema governa também qualidade visual. Modernidade, identidade, responsividade, estados e evidência visual não são extras opcionais. Fraca=Use um padrão moderno seguro: hierarquia clara, espaçamento consistente, paleta com contraste, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Se não conseguir validar visualmente, pare e peça revisão. Media=Defina intenção visual antes de codar: público, domínio, densidade, tokens, componentes, estados, responsividade e anti-2010. Rode ou peça screenshot/browser check quando houver UI. Forte=Crie direção visual específica do domínio, use assets reais/gerados quando fizer sentido, refine microinterações e faça verificação visual em desktop/mobile com screenshot e correção de overlap.
 TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2, sema.produto.author.modelos, sema.produto.author.superficies, sema.produto.author.tarefas_2 (+83)
-TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+185)
-TOP_LACUNAS: execucao_implicita, persistencia:ConsumoOperacao:parcial:desconhecida, persistencia:contexto_ia:materializado:desconhecida, 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 (+139)
-GERADO_EM: 2026-06-07T02:26:15.834Z
+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