@semacode/cli 1.5.41 → 1.5.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/AGENTS.md +34 -22
  2. package/AGENT_CONTEXT_PACK.json +6 -6
  3. package/README.md +21 -12
  4. package/SEMA_BRIEF.curto.txt +3 -3
  5. package/SEMA_BRIEF.md +94 -94
  6. package/SEMA_BRIEF.micro.txt +2 -2
  7. package/SEMA_INDEX.json +147 -313
  8. package/dist/agentContextPack.js +6 -6
  9. package/dist/agentContextPack.js.map +1 -1
  10. package/dist/agentEntryPoints.js +21 -21
  11. package/dist/billing/index.d.ts +28 -0
  12. package/dist/billing/index.js +189 -1
  13. package/dist/billing/index.js.map +1 -1
  14. package/dist/bridge.d.ts +1 -1
  15. package/dist/bridge.js +16 -4
  16. package/dist/bridge.js.map +1 -1
  17. package/dist/cliArgs.js +5 -0
  18. package/dist/cliArgs.js.map +1 -1
  19. package/dist/comandos.d.ts +0 -9
  20. package/dist/comandos.js +12 -17
  21. package/dist/comandos.js.map +1 -1
  22. package/dist/index.js +1 -1
  23. package/dist/index.js.map +1 -1
  24. package/dist/index.part01.d.ts +1 -1
  25. package/dist/index.part01.js +2 -1
  26. package/dist/index.part01.js.map +1 -1
  27. package/dist/index.part08.js +4 -0
  28. package/dist/index.part08.js.map +1 -1
  29. package/dist/mcpInstalarChaveCommand.js +38 -11
  30. package/dist/mcpInstalarChaveCommand.js.map +1 -1
  31. package/docs/cli.md +21 -9
  32. package/docs/como-ensinar-a-sema-para-ia.md +3 -3
  33. package/docs/fluxo-pratico-ia-sema.md +37 -24
  34. package/docs/instalacao-e-primeiro-uso.md +21 -9
  35. package/docs/integracao-com-ia.md +12 -6
  36. package/docs/mcp.md +9 -9
  37. package/docs/repositories.md +9 -9
  38. package/node_modules/@sema/gerador-css/package.json +1 -1
  39. package/node_modules/@sema/gerador-dart/package.json +1 -1
  40. package/node_modules/@sema/gerador-html/package.json +1 -1
  41. package/node_modules/@sema/gerador-javascript/package.json +1 -1
  42. package/node_modules/@sema/gerador-lua/package.json +1 -1
  43. package/node_modules/@sema/gerador-python/package.json +1 -1
  44. package/node_modules/@sema/gerador-typescript/package.json +1 -1
  45. package/node_modules/@sema/nucleo/package.json +1 -1
  46. package/node_modules/@sema/padroes/package.json +1 -1
  47. package/package.json +10 -10
@@ -7,9 +7,13 @@
7
7
 
8
8
  ## English
9
9
 
10
- Sema is private. The MCP endpoint is the primary product surface and coordinates authentication, SEMAS consumption, profiles, pipelines, and project mirrors.
10
+ Sema is private. Local IDEs use the complete Sema CLI. Web/chat clients without local workspace access use the remote MCP.
11
11
 
12
- Local IDEs should receive `AGENTS.md` first. Web chats should use `sema_chat_contexto` and `sema_sync` instead of downloading files into the chat environment.
12
+ In a local IDE, install the CLI and key, keep `AGENTS.md` in the project root, run `sema preflight resumo --json`, and stop unless `decisao` is `use_cli_local`. After that, use local CLI commands: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar`, and `sema finalizar-mudanca`.
13
+
14
+ Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace. Those paths are forbidden for local IDE work when the CLI is operational.
15
+
16
+ Web chats should use `sema_chat_contexto` and `sema_sync` with inline contract, selected code, operational docs, and index. Web chats must not download files into the chat environment.
13
17
 
14
18
  Install the governed CLI/client from npm when a local IDE or VPS mirror needs the `sema` command:
15
19
 
@@ -17,13 +21,17 @@ Install the governed CLI/client from npm when a local IDE or VPS mirror needs th
17
21
  npm install -g @semacode/cli
18
22
  ```
19
23
 
20
- The MCP server remains the private product surface. Do not install the MCP from the npm installer package; configure the authorized remote `/mcp` endpoint instead.
24
+ The MCP server remains the private web/chat surface. Do not install the MCP from the npm installer package; configure the authorized remote `/mcp` endpoint only for remote clients.
21
25
 
22
26
  ## Português
23
27
 
24
- A Sema é privada. O endpoint MCP é a superfície principal do produto e coordena autenticação, consumo de SEMAS, profiles, pipelines e espelhos de projeto.
28
+ A Sema é privada. IDE local usa a CLI completa da Sema. Cliente web/chat sem acesso ao workspace local usa MCP remoto.
29
+
30
+ Em IDE local, instale a CLI e a chave, mantenha `AGENTS.md` na raiz do projeto, rode `sema preflight resumo --json` e pare se `decisao` não for `use_cli_local`. Depois disso, use comandos locais da CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` e `sema finalizar-mudanca`.
25
31
 
26
- IDEs locais devem receber `AGENTS.md` primeiro. Chats web devem usar `sema_chat_contexto` e `sema_sync`, não baixar arquivos no ambiente do chat.
32
+ Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local. Esses caminhos são proibidos em IDE local quando a CLI está operacional.
33
+
34
+ Chats web devem usar `sema_chat_contexto` e `sema_sync` com contrato inline, código selecionado, docs operacionais e índice. Chats web não devem baixar arquivos no ambiente do chat.
27
35
 
28
36
  Instale a CLI/cliente governada pelo npm quando uma IDE local ou espelho na VPS precisar do comando `sema`:
29
37
 
@@ -31,13 +39,17 @@ Instale a CLI/cliente governada pelo npm quando uma IDE local ou espelho na VPS
31
39
  npm install -g @semacode/cli
32
40
  ```
33
41
 
34
- O servidor MCP continua sendo a superfície privada do produto. Não instale o MCP pelo pacote npm do instalador; configure o endpoint remoto `/mcp` autorizado.
42
+ O servidor MCP continua sendo a superfície privada para web/chat. Não instale o MCP pelo pacote npm do instalador; configure o endpoint remoto `/mcp` autorizado apenas para clientes remotos.
35
43
 
36
44
  ## Español
37
45
 
38
- Sema es privada. El endpoint MCP es la superficie principal del producto y coordina autenticación, consumo de SEMAS, profiles, pipelines y espejos de proyecto.
46
+ Sema es privada. Una IDE local usa la CLI completa de Sema. Un cliente web/chat sin acceso al workspace local usa el MCP remoto.
47
+
48
+ En una IDE local, instala la CLI y la clave, deja `AGENTS.md` en la raíz del proyecto, ejecuta `sema preflight resumo --json` y para si `decisao` no es `use_cli_local`. Después usa comandos locales de la CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` y `sema finalizar-mudanca`.
49
+
50
+ No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local. Esos caminos están prohibidos en una IDE local cuando la CLI está operacional.
39
51
 
40
- Las IDEs locales deben recibir `AGENTS.md` primero. Los chats web deben usar `sema_chat_contexto` y `sema_sync`, no descargar archivos en el entorno del chat.
52
+ Los chats web deben usar `sema_chat_contexto` y `sema_sync` con contrato inline, código seleccionado, docs operativas e índice. Los chats web no deben descargar archivos en el entorno del chat.
41
53
 
42
54
  Instala la CLI/cliente gobernada desde npm cuando una IDE local o espejo en la VPS necesite el comando `sema`:
43
55
 
@@ -45,4 +57,4 @@ Instala la CLI/cliente gobernada desde npm cuando una IDE local o espejo en la V
45
57
  npm install -g @semacode/cli
46
58
  ```
47
59
 
48
- El servidor MCP sigue siendo la superficie privada del producto. No instales el MCP desde el paquete npm instalador; configura el endpoint remoto `/mcp` autorizado.
60
+ El servidor MCP sigue siendo la superficie privada para web/chat. No instales el MCP desde el paquete npm instalador; configura el endpoint remoto `/mcp` autorizado solo para clientes remotos.
@@ -21,18 +21,24 @@ Sema pode usar palavras-chave de DSL em ASCII. A IA não deve copiar essa estét
21
21
 
22
22
  ## English
23
23
 
24
- 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.
24
+ Sema exists for AI agents operating live systems. The agent should ask Sema for preflight, summary, docs impact, drift, impact, profile validation, and finalization instead of guessing from raw code.
25
25
 
26
- In local IDEs, confirm `AGENTS.md` exists before `sema_resumo`. If the remote MCP cannot read the local path, call `sema_sync` with the applicable contract, selected code, documentation, and index; then use the returned `projeto`. In web chats, use `sema_chat_contexto` first, then `sema_sync` with the same typed snapshot. The MCP coordinates the flow and charges SEMAS; the CLI executes local or VPS-side checks.
26
+ In local IDEs, confirm `AGENTS.md` exists, install the complete Sema CLI, run `sema preflight resumo --json`, and stop unless the decision is `use_cli_local`. Then use local CLI commands: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar`, and `sema finalizar-mudanca`. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace.
27
+
28
+ In web chats without workspace access, use `sema_chat_contexto` first, then `sema_sync` with contract, selected code, documentation, and index; then use the returned `projeto`. The CLI and MCP use the same commercial control plane and SEMAS account.
27
29
 
28
30
  ## Português
29
31
 
30
- A Sema existe para agentes de IA operarem sistemas vivos. O agente deve pedir resumo, impacto documental, drift, impacto, validação de profile e finalização para a Sema em vez de adivinhar pelo código cru.
32
+ A Sema existe para agentes de IA operarem sistemas vivos. O agente deve pedir preflight, resumo, impacto documental, drift, impacto, validação de profile e finalização para a Sema em vez de adivinhar pelo código cru.
33
+
34
+ Em IDE local, confirme que `AGENTS.md` existe, instale a CLI completa da Sema, rode `sema preflight resumo --json` e pare se a decisão não for `use_cli_local`. Depois use comandos locais da CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` e `sema finalizar-mudanca`. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local.
31
35
 
32
- Em IDE local, confirme que `AGENTS.md` existe antes de `sema_resumo`. Se o MCP remoto não conseguir ler o caminho local, chame `sema_sync` com contrato aplicável, código selecionado, documentação e índice; depois use o `projeto` retornado. Em chats web, use primeiro `sema_chat_contexto`, depois `sema_sync` com o mesmo snapshot tipado. O MCP coordena o fluxo e cobra SEMAS; a CLI executa checks locais ou na VPS.
36
+ Em chats web sem acesso ao workspace, use primeiro `sema_chat_contexto`, depois `sema_sync` com contrato, código selecionado, documentação e índice; depois use o `projeto` retornado. CLI e MCP usam o mesmo control plane comercial e a mesma conta de SEMAS.
33
37
 
34
38
  ## Español
35
39
 
36
- Sema existe para agentes de IA que operan sistemas vivos. El agente debe pedir resumen, impacto documental, drift, impacto, validación de profile y finalización a Sema en vez de adivinar desde código crudo.
40
+ Sema existe para agentes de IA que operan sistemas vivos. El agente debe pedir preflight, resumen, impacto documental, drift, impacto, validación de profile y finalización a Sema en vez de adivinar desde código crudo.
41
+
42
+ En una IDE local, confirma que `AGENTS.md` existe, instala la CLI completa de Sema, ejecuta `sema preflight resumo --json` y para si la decisión no es `use_cli_local`. Después usa comandos locales de la CLI: `sema resumo`, `sema docs-impacto`, `sema inspecionar`, `sema drift`, `sema impacto`, `sema validar` y `sema finalizar-mudanca`. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local.
37
43
 
38
- En IDE local, confirma que `AGENTS.md` existe antes de `sema_resumo`. Si el MCP remoto no puede leer la ruta local, llama `sema_sync` con contrato aplicable, código seleccionado, documentación e índice; después usa el `projeto` devuelto. En chats web, usa primero `sema_chat_contexto`, después `sema_sync` con el mismo snapshot tipado. El MCP coordina el flujo y cobra SEMAS; la CLI ejecuta checks locales o en la VPS.
44
+ En chats web sin acceso al workspace, usa primero `sema_chat_contexto`, después `sema_sync` con contrato, código seleccionado, documentación e índice; después usa el `projeto` devuelto. CLI y MCP usan el mismo control plane comercial y la misma cuenta de SEMAS.
package/docs/mcp.md CHANGED
@@ -11,11 +11,11 @@ The Sema MCP is the private coordinator for agents. It authenticates clients, se
11
11
 
12
12
  It must stay compatible with web chats. For ChatGPT, Lovable, GPTs, and similar clients, the MCP runs on the VPS and uses the governed CLI installed there against authorized mirrors such as `/srv/sema/projetos/...`.
13
13
 
14
- It must also stay compatible with local IDEs. In that mode, the client sends typed snapshots: contracts, selected code, documentation, and an index. When complete local-code drift is required, the installed CLI may run in the IDE workspace.
14
+ Local IDEs should not use remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace. In that mode, install the complete Sema CLI, save the local key, run `sema preflight resumo --json`, and continue locally only when the decision is `use_cli_local`.
15
15
 
16
- The MCP must never pretend that a local Windows path exists on the Linux server. If the server cannot see the workspace, the next action is to request or create a mirror/snapshot.
16
+ The MCP must never pretend that a local Windows path exists on the Linux server. If a local IDE asks the remote MCP to read that path, the next action is to use the local CLI. If a web/chat client has no workspace, the next action is to request or create a mirror/snapshot.
17
17
 
18
- 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 means project work must use `sema_sync` with the applicable contract, selected code, documentation, and index. The remote MCP must not ask for or try to read the user's local folder.
18
+ 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. In web/chat, project work must use `sema_sync` with the applicable contract, selected code, documentation, and index. In a local IDE, project work must use CLI preflight and local CLI commands. The remote MCP must not ask for or try to read the user's local folder.
19
19
 
20
20
  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.
21
21
 
@@ -31,11 +31,11 @@ O MCP da Sema é o coordenador privado dos agentes. Ele autentica clientes, esco
31
31
 
32
32
  Ele precisa continuar compatível com chats web. Para ChatGPT, Lovable, GPTs e clientes parecidos, o MCP roda na VPS e usa a CLI governada instalada lá contra espelhos autorizados como `/srv/sema/projetos/...`.
33
33
 
34
- Ele também precisa continuar compatível com IDEs locais. Nesse modo, o cliente envia snapshots tipados: contratos, código selecionado, documentação e índice. Quando drift completo contra código local for necessário, a CLI instalada pode rodar no workspace da IDE.
34
+ IDEs locais não devem usar MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local. Nesse modo, instale a CLI completa da Sema, grave a chave local, rode `sema preflight resumo --json` e continue localmente somente quando a decisão for `use_cli_local`.
35
35
 
36
- O MCP nunca deve fingir que um caminho Windows local existe no servidor Linux. Se o servidor não enxerga o workspace, a próxima ação é pedir ou criar um espelho/snapshot.
36
+ O MCP nunca deve fingir que um caminho Windows local existe no servidor Linux. Se uma IDE local pedir ao MCP remoto para ler esse caminho, a próxima ação é usar a CLI local. Se um cliente web/chat não tiver workspace, a próxima ação é pedir ou criar um espelho/snapshot.
37
37
 
38
- O app ou conector deve reconhecer o MCP remoto pela conexão/autenticação, mesmo sem workspace de projeto sincronizado. Falta de workspace não é falta de sessão ativa: é o sinal de que a próxima ação de projeto deve usar `sema_sync` com contrato aplicável, código selecionado, documentação e índice. O MCP remoto não deve pedir nem tentar ler a pasta local do usuário.
38
+ O app ou conector deve reconhecer o MCP remoto pela conexão/autenticação, mesmo sem workspace de projeto sincronizado. Falta de workspace não é falta de sessão ativa. Em web/chat, trabalho de projeto deve usar `sema_sync` com contrato aplicável, código selecionado, documentação e índice. Em IDE local, trabalho de projeto deve usar preflight e comandos locais da CLI. O MCP remoto não deve pedir nem tentar ler a pasta local do usuário.
39
39
 
40
40
  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.
41
41
 
@@ -51,11 +51,11 @@ El MCP de Sema es el coordinador privado de los agentes. Autentica clientes, eli
51
51
 
52
52
  Debe seguir compatible con chats web. Para ChatGPT, Lovable, GPTs y clientes similares, el MCP corre en la VPS y usa la CLI gobernada instalada allí contra espejos autorizados como `/srv/sema/projetos/...`.
53
53
 
54
- También debe seguir compatible con IDEs locales. En ese modo, el cliente envía snapshots tipados: contratos, código seleccionado, documentación e índice. Cuando haga falta drift completo contra código local, la CLI instalada puede correr en el workspace de la IDE.
54
+ Las IDEs locales no deben usar el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local. En ese modo, instala la CLI completa de Sema, guarda la clave local, ejecuta `sema preflight resumo --json` y continúa localmente solo cuando la decisión sea `use_cli_local`.
55
55
 
56
- El MCP nunca debe fingir que una ruta local de Windows existe en el servidor Linux. Si el servidor no ve el workspace, la siguiente acción es pedir o crear un espejo/snapshot.
56
+ El MCP nunca debe fingir que una ruta local de Windows existe en el servidor Linux. Si una IDE local pide al MCP remoto leer esa ruta, la siguiente acción es usar la CLI local. Si un cliente web/chat no tiene workspace, la siguiente acción es pedir o crear un espejo/snapshot.
57
57
 
58
- La app o el conector debe reconocer el MCP remoto por conexión/autenticación, incluso sin workspace de proyecto sincronizado. Falta de workspace no es falta de sesión activa: indica que la siguiente acción de proyecto debe usar `sema_sync` con contrato aplicable, código seleccionado, documentación e índice. El MCP remoto no debe pedir ni intentar leer la carpeta local del usuario.
58
+ La app o el conector debe reconocer el MCP remoto por conexión/autenticación, incluso sin workspace de proyecto sincronizado. Falta de workspace no es falta de sesión activa. En web/chat, el trabajo de proyecto debe usar `sema_sync` con contrato aplicable, código seleccionado, documentación e índice. En una IDE local, el trabajo de proyecto debe usar preflight y comandos locales de la CLI. El MCP remoto no debe pedir ni intentar leer la carpeta local del usuario.
59
59
 
60
60
  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.
61
61
 
@@ -13,10 +13,10 @@ The active tree lives at the repository root: `contratos/`, `pacotes/`, `mcp/`,
13
13
 
14
14
  The operating model is:
15
15
 
16
- - The MCP is the private coordinator: it authenticates clients, selects the right project or mirror, charges SEMAS, decides the required contract/profile flow, and returns the operational verdict.
17
- - The CLI is distributed through the npm installer/client `@semacode/cli`, then acts as the governed executor: it reads contracts, validates, checks drift, builds AI-first context, and performs local or server-side actions requested by the MCP.
16
+ - The CLI is distributed through the npm installer/client `@semacode/cli`, then acts as the governed local executor for IDEs: it reads contracts, validates, checks drift, builds AI-first context, and runs `sema preflight resumo --json` against the SEMAS control plane before local action.
17
+ - Local IDEs use the complete CLI and a local key. Stop unless `decisao=use_cli_local`. Do not use remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` to read a local workspace.
18
+ - The private MCP is the web/chat coordinator: it authenticates remote clients, selects the right server project or mirror, charges SEMAS, decides the required contract/profile flow, and returns the operational verdict.
18
19
  - Web chats remain supported because the private MCP keeps a CLI installed on the VPS and runs it against authorized mirrors under `/srv/sema/projetos/...`.
19
- - Local IDEs remain supported by sending typed snapshots, selected code, docs, and indexes to the MCP; when local full-code drift is required, the installed CLI can run inside the IDE environment.
20
20
 
21
21
  Distribution outside the private boundary is allowed only for the governed CLI installer. If a script tries to publish the MCP server, product release assets, secrets, control-plane code, GitHub Release, or any public package outside `@semacode/cli`, it must fail before any artifact is created.
22
22
 
@@ -34,10 +34,10 @@ A árvore ativa vive na raiz do repositório: `contratos/`, `pacotes/`, `mcp/`,
34
34
 
35
35
  O modelo operacional é:
36
36
 
37
- - O MCP é o coordenador privado: autentica clientes, escolhe o projeto ou espelho correto, cobra SEMAS, decide o fluxo de contrato/profile obrigatório e devolve o veredito operacional.
38
- - A CLI é distribuída pelo instalador/cliente npm `@semacode/cli` e depois atua como executor governado: lê contratos, valida, mede drift, monta contexto IA-first e executa ações locais ou no servidor quando o MCP pedir.
37
+ - A CLI é distribuída pelo instalador/cliente npm `@semacode/cli` e depois atua como executor local governado para IDEs: lê contratos, valida, mede drift, monta contexto IA-first e roda `sema preflight resumo --json` contra o control plane de SEMAS antes de agir localmente.
38
+ - IDEs locais usam a CLI completa e uma chave local. Pare se `decisao` não for `use_cli_local`. Não use MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` para ler workspace local.
39
+ - O MCP privado é o coordenador web/chat: autentica clientes remotos, escolhe o projeto ou espelho de servidor correto, cobra SEMAS, decide o fluxo de contrato/profile obrigatório e devolve o veredito operacional.
39
40
  - Chats web continuam suportados porque o MCP privado mantém uma CLI instalada na VPS e executa contra espelhos autorizados em `/srv/sema/projetos/...`.
40
- - IDEs locais continuam suportadas enviando snapshots tipados, código selecionado, docs e índice para o MCP; quando drift completo local for necessário, a CLI instalada pode rodar dentro do ambiente da IDE.
41
41
 
42
42
  Distribuição fora da fronteira privada só é permitida para o instalador CLI governado. Se algum script tentar publicar o servidor MCP, assets de release de produto, segredos, control plane, GitHub Release ou qualquer pacote público fora de `@semacode/cli`, ele deve falhar antes de criar qualquer artefato.
43
43
 
@@ -55,10 +55,10 @@ El árbol activo vive en la raíz del repositorio: `contratos/`, `pacotes/`, `mc
55
55
 
56
56
  El modelo operativo es:
57
57
 
58
- - El MCP es el coordinador privado: autentica clientes, elige el proyecto o espejo correcto, cobra SEMAS, decide el flujo obligatorio de contrato/profile y devuelve el veredicto operativo.
59
- - La CLI se distribuye por el instalador/cliente npm `@semacode/cli` y luego actúa como ejecutor gobernado: lee contratos, valida, mide drift, prepara contexto IA-first y ejecuta acciones locales o del servidor cuando el MCP lo solicita.
58
+ - La CLI se distribuye por el instalador/cliente npm `@semacode/cli` y luego actúa como ejecutor local gobernado para IDEs: lee contratos, valida, mide drift, prepara contexto IA-first y ejecuta `sema preflight resumo --json` contra el control plane de SEMAS antes de actuar localmente.
59
+ - Las IDEs locales usan la CLI completa y una clave local. Para si `decisao` no es `use_cli_local`. No uses el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` para leer un workspace local.
60
+ - El MCP privado es el coordinador web/chat: autentica clientes remotos, elige el proyecto o espejo de servidor correcto, cobra SEMAS, decide el flujo obligatorio de contrato/profile y devuelve el veredicto operativo.
60
61
  - Los chats web siguen soportados porque el MCP privado mantiene una CLI instalada en la VPS y la ejecuta contra espejos autorizados en `/srv/sema/projetos/...`.
61
- - Las IDEs locales siguen soportadas enviando snapshots tipados, código seleccionado, docs e índice al MCP; cuando haga falta drift completo local, la CLI instalada puede correr dentro del entorno de la IDE.
62
62
 
63
63
  La distribución fuera de la frontera privada solo se permite para el instalador CLI gobernado. Si un script intenta publicar el servidor MCP, assets de release de producto, secretos, control plane, GitHub Release o cualquier paquete público fuera de `@semacode/cli`, debe fallar antes de crear cualquier artefacto.
64
64
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/gerador-css",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/gerador-dart",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/gerador-html",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/gerador-javascript",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/gerador-lua",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/gerador-python",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/gerador-typescript",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/nucleo",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sema/padroes",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@semacode/cli",
3
- "version": "1.5.41",
3
+ "version": "1.5.42",
4
4
  "description": "Semantic governance CLI for AI agents: contracts, drift, impact, documentation gates, and Sema profiles for live systems.",
5
5
  "type": "module",
6
6
  "icon": "logo.png",
@@ -46,15 +46,15 @@
46
46
  "LICENSE"
47
47
  ],
48
48
  "dependencies": {
49
- "@sema/nucleo": "1.5.41",
50
- "@sema/gerador-dart": "1.5.41",
51
- "@sema/gerador-lua": "1.5.41",
52
- "@sema/gerador-python": "1.5.41",
53
- "@sema/gerador-typescript": "1.5.41",
54
- "@sema/gerador-javascript": "1.5.41",
55
- "@sema/gerador-html": "1.5.41",
56
- "@sema/gerador-css": "1.5.41",
57
- "@sema/padroes": "1.5.41",
49
+ "@sema/nucleo": "1.5.42",
50
+ "@sema/gerador-dart": "1.5.42",
51
+ "@sema/gerador-lua": "1.5.42",
52
+ "@sema/gerador-python": "1.5.42",
53
+ "@sema/gerador-typescript": "1.5.42",
54
+ "@sema/gerador-javascript": "1.5.42",
55
+ "@sema/gerador-html": "1.5.42",
56
+ "@sema/gerador-css": "1.5.42",
57
+ "@sema/padroes": "1.5.42",
58
58
  "typescript": "^5.8.3"
59
59
  },
60
60
  "bundledDependencies": [