@semacode/cli 1.5.32 → 1.5.34

package/docs/agentes-por-capacidade.md

@@ -0,0 +1,42 @@
+# Agentes por capacidade
+
+Sema deve funcionar em agentes fortes, médios e fracos. A diferença não é só tamanho de contexto; é disciplina operacional.
+
+## Fraca
+
+Use para Copilot em modo simples, Cline/Roo com pouco contexto, modelos locais pequenos e agentes que ignoram instrução longa.
+
+- Entrada: `SEMA_BOOT.md` -> `SEMA_SMALL_MODEL.md` -> `SEMA_BRIEF.micro.txt`.
+- Não abrir AST/IR completos no começo.
+- Não editar se Sema não respondeu.
+- Não pedir para MCP remoto ler pasta local.
+
+## Média
+
+Use para agentes com bom contexto, mas sem garantia de seguir todos os gates.
+
+- Entrada: `SEMA_BOOT.md` -> `AGENT_CONTEXT_PACK.json` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json`.
+- Rodar docs-impacto antes de agir.
+- Validar drift e contrato no fechamento.
+
+## Forte
+
+Use para Codex, Claude e agentes com tool use confiável.
+
+- Entrada: `SEMA_BOOT.md` -> `AGENT_CONTEXT_PACK.json` -> `SEMA_BRIEF.md` -> `SEMA_INDEX.json`.
+- Pode consumir AST/IR/drift completos.
+- Ainda deve respeitar contrato primeiro e falha fechada.
+
+## Idioma
+
+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.
+
+A gramática Sema pode ter palavras-chave ASCII. Isso não autoriza resposta humana sem acentos.
+
+## Clientes
+
+- copilot: .github/copilot-instructions.md, AGENTS.md, SEMA_BOOT.md. Capacidade padrão: media. VS Code/Copilot deve receber uma instrução curta e repetida no arquivo próprio, sem depender só do AGENTS.md.
+- cline: .clinerules/00-sema.md, .clinerules, SEMA_BOOT.md. Capacidade padrão: fraca. Cline costuma obedecer melhor quando o gate Sema vem em arquivo curto; se .clinerules for arquivo legado, o Sema atualiza esse fallback.
+- roo: .roo/rules/00-sema.md, AGENTS.md, SEMA_BOOT.md. Capacidade padrão: fraca. Roo Code deve começar por uma regra dedicada em .roo/rules antes de abrir arquivos longos.
+- opencode: .opencode/instructions.md, AGENTS.md, SEMA_BOOT.md. Capacidade padrão: media. OpenCode deve receber a mesma regra curta em instructions.md quando a pasta .opencode já existir.
+- generico: SEMA_BOOT.md, SEMA_SMALL_MODEL.md, AGENT_CONTEXT_PACK.json. Capacidade padrão: fraca. Qualquer agente sem integração específica começa pelo boot card e só sobe contexto se passar pelos gates.

package/docs/env.md

@@ -25,13 +25,13 @@ Ambiente necessário para publicar a Sema.
 No PowerShell, o instalador recebe a versão por parametro:
 
 ```powershell
-.\install-sema.ps1 -Version 1.5.29 -WithVSCode
+.\install-sema.ps1 -Version 1.5.34 -WithVSCode
 ```
 
 No shell:
 
 ```bash
-SEMA_VERSION=1.5.29 ./install-sema.sh --with-vscode
+SEMA_VERSION=1.5.34 ./install-sema.sh --with-vscode
 ```
 
 ## Credenciais
@@ -102,7 +102,7 @@ O limite de bytes e validado antes de gravar espelhos remotos ou executar contra
 
 ## GitHub Release
 
-O tag público deve seguir `v<versao>`, por exemplo `v1.5.29`.
+O tag público deve seguir `v<versao>`, por exemplo `v1.5.34`.
 
 Os assets ficam em `.tmp/release-assets` e sao derivados dos scripts versionados no repositório.
 

package/docs/fluxo-pratico-ia-sema.md

@@ -12,7 +12,15 @@ Se a IA seguir isso, ela trabalha com contexto. Se não seguir, vira adivinhaç
 
 O ponto central: Sema não é texto para agradar humano. É contrato semântico IA-first. Humanos autorizam e revisam; a IA consome o contrato para decidir o próximo movimento.
 
-## Fluxo curto
+Antes de qualquer etapa, classifique a capacidade operacional do agente:
+
+- IA fraca: leia `SEMA_BOOT.md`, `SEMA_SMALL_MODEL.md` e `SEMA_BRIEF.micro.txt`; se Sema não responder, pare.
+- IA média: leia `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_BRIEF.curto.txt` e `SEMA_INDEX.json`.
+- IA forte: pode usar `SEMA_BRIEF.md`, AST, IR e drift completo, mas ainda começa pelo boot.
+
+Regra de idioma humano: responda no idioma do usuário. Em PT-BR, use acentos, cedilha, pontuação e símbolos normais. A gramática `.sema` pode ser ASCII; texto humano não precisa ser.
+
+## Fluxo curto
 
 1. ler contexto do projeto
 2. identificar a capacidade da IA
@@ -41,9 +49,9 @@ Se o trabalho estiver ligado a pagamento, ler também:
 
 Antes de despejar contexto na IA, escolha o que ela aguenta:
 
-- IA pequena ou gratuita: `sema resumo --micro` e `briefing.min.json`
-- IA média: `sema resumo --curto`, `briefing.min.json` e `drift.json`
-- IA grande: `contexto-ia`, `briefing.json`, `drift.json`, `ir.json` e `ast.json`
+- IA fraca, gratuita ou com pouca disciplina: `SEMA_BOOT.md`, `SEMA_SMALL_MODEL.md`, `sema resumo --micro` e `briefing.min.json`
+- IA média: `sema resumo --curto`, `briefing.min.json` e `drift.json`
+- IA forte: `contexto-ia`, `briefing.json`, `drift.json`, `ir.json` e `ast.json`
 
 ### Etapa 3. Ler o módulo alvo e um exemplo parecido
 
@@ -136,7 +144,7 @@ sema verificar arquivo-ou-pasta --json --saida ./.tmp/verificacao-ia
 
 ## Fluxo mínimo para automacao
 
-Se voce quiser o menor fluxo aceitavel para uma IA pequena:
+Se voce quiser o menor fluxo aceitavel para uma IA fraca:
 
 ```bash
 sema resumo caminho/arquivo.sema --micro --para mudanca

package/docs/integracao-com-ia.md

@@ -5,6 +5,20 @@
 > PT: Português depois, com acentos preservados.
 > ES: Español al final.
 
+## Regra de idioma humano
+
+Sema pode usar palavras-chave de DSL em ASCII. A IA não deve copiar essa estética para texto humano.
+
+- Se o usuário fala português, responda em português com acentos, cedilha, pontuação e símbolos normais.
+- Preserve o idioma do usuário em propostas, documentação, mensagens de erro, textos Author, briefing, resposta final e comentários.
+- Não traduza comandos, rotas, nomes de arquivos, símbolos de código nem palavras-chave `.sema`.
+
+## Agentes fortes, médios e fracos
+
+- IA fraca: comece por `SEMA_BOOT.md`, `SEMA_SMALL_MODEL.md` e `SEMA_BRIEF.micro.txt`; se Sema não responder, pare.
+- IA média: use `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_BRIEF.curto.txt` e `SEMA_INDEX.json`.
+- IA forte: pode usar `SEMA_BRIEF.md`, AST, IR e drift completo, mas continua obedecendo contrato primeiro.
+
 ## English
 
 Sema exists for AI agents operating live systems. The agent should ask Sema for summary, docs impact, drift, impact, profile validation, and finalization instead of guessing from raw code.

package/docs/mcp.md

@@ -17,6 +17,8 @@ The MCP must never pretend that a local Windows path exists on the Linux server.
 
 The app or connector must recognize the remote MCP from connection/authentication even when no project workspace has been synchronized. Missing workspace is not a missing active session; it only means project work must use `sema_sync`, an attachment, or inline content. The remote MCP must not ask for or try to read the user's local folder.
 
+Official Sema examples and grammar references must be exposed through `sema_exemplos`. Remote agents must not read `C:\GitHub\Sema\exemplos` or any other local user checkout just to learn the DSL.
+
 Typed snapshot payloads have per-file byte limits for contracts, selected code, and documentation. The MCP exposes those limits in tool schemas and validates them again before writing a mirror or running inline contract operations. Clients must split oversized context into focused files instead of sending an entire repository or hiding the limit from the agent.
 
 ## Português
@@ -31,6 +33,8 @@ O MCP nunca deve fingir que um caminho Windows local existe no servidor Linux. S
 
 O app ou conector deve reconhecer o MCP remoto pela conexao/autenticacao, mesmo sem workspace de projeto sincronizado. Falta de workspace nao e falta de sessao ativa: e apenas o sinal de que a proxima acao de projeto deve usar `sema_sync`, anexo ou conteudo inline. O MCP remoto nao deve pedir nem tentar ler a pasta local do usuario.
 
+Exemplos oficiais da Sema e referencias de gramatica devem ser expostos por `sema_exemplos`. Agentes remotos nao devem ler `C:\GitHub\Sema\exemplos` nem qualquer checkout local do usuario so para aprender a DSL.
+
 Snapshots tipados tem limite de bytes por arquivo para contratos, codigo selecionado e documentacao. O MCP anuncia esses limites no schema das ferramentas e valida de novo antes de gravar espelho ou executar contrato inline. Clientes devem quebrar contexto grande em arquivos focados, nao enviar repositorio inteiro nem esconder o limite do agente.
 
 ## Español
@@ -45,4 +49,6 @@ El MCP nunca debe fingir que una ruta local de Windows existe en el servidor Lin
 
 La app o el conector debe reconocer el MCP remoto por conexion/autenticacion, incluso sin workspace de proyecto sincronizado. Falta de workspace no es falta de sesion activa: solo indica que el trabajo de proyecto debe usar `sema_sync`, un adjunto o contenido inline. El MCP remoto no debe pedir ni intentar leer la carpeta local del usuario.
 
+Los ejemplos oficiales de Sema y las referencias de gramatica deben exponerse mediante `sema_exemplos`. Los agentes remotos no deben leer `C:\GitHub\Sema\exemplos` ni ningun checkout local del usuario solo para aprender la DSL.
+
 Los snapshots tipados tienen limites de bytes por archivo para contratos, codigo seleccionado y documentacion. El MCP anuncia esos limites en los schemas de herramientas y vuelve a validarlos antes de escribir un espejo o ejecutar contratos inline. Los clientes deben dividir contexto grande en archivos enfocados, no enviar todo el repositorio ni ocultar el limite al agente.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@semacode/cli",
-  "version": "1.5.32",
+  "version": "1.5.34",
   "description": "Semantic governance CLI for AI agents: contracts, drift, impact, documentation gates, and Sema profiles for live systems.",
   "type": "module",
   "icon": "logo.png",
@@ -50,15 +50,15 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@sema/nucleo": "1.5.32",
-    "@sema/gerador-dart": "1.5.32",
-    "@sema/gerador-lua": "1.5.32",
-    "@sema/gerador-python": "1.5.32",
-    "@sema/gerador-typescript": "1.5.32",
-    "@sema/gerador-javascript": "1.5.32",
-    "@sema/gerador-html": "1.5.32",
-    "@sema/gerador-css": "1.5.32",
-    "@sema/padroes": "1.5.32",
+    "@sema/nucleo": "1.5.34",
+    "@sema/gerador-dart": "1.5.34",
+    "@sema/gerador-lua": "1.5.34",
+    "@sema/gerador-python": "1.5.34",
+    "@sema/gerador-typescript": "1.5.34",
+    "@sema/gerador-javascript": "1.5.34",
+    "@sema/gerador-html": "1.5.34",
+    "@sema/gerador-css": "1.5.34",
+    "@sema/padroes": "1.5.34",
     "typescript": "^5.8.3"
   },
   "bundledDependencies": [