@semacode/cli 1.5.46 → 1.5.47

package/docs/AGENT_STARTER.md

@@ -41,7 +41,7 @@ Importante:
 - a Sema funciona como camada de navegacao operacional para agente, nao como runtime magico
 - leitura humana e bonus toleravel, nao centro do produto
 - a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
-- a Sema gera codigo e scaffolding real para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS
+- a Sema gera codigo e scaffolding real para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS
 - a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico
 - a Sema usa `drift` para medir diferenca entre contrato e codigo vivo
 - a Sema usa `impl` para ligar task a simbolo real do runtime
@@ -55,11 +55,11 @@ Importante:
 - se a tarefa envolver UI, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivo aleatorio
 - evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
 
-Regras:
-- nao invente sintaxe fora da gramatica e dos exemplos oficiais
-- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
-- se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo antes de declarar falha
-- trate `ir --json` como fonte de verdade semantica
+Regras:
+- nao invente sintaxe fora da gramatica e dos exemplos oficiais
+- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
+- se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo antes de declarar falha
+- trate `ir --json` como fonte de verdade semantica
 - trate `diagnosticos --json` como fonte de correcao
 - use `sema formatar` como fonte unica de estilo
 - preserve a intencao do contrato
@@ -75,7 +75,7 @@ Comandos essenciais:
 - diagnosticos: `sema diagnosticos <arquivo.sema> --json`
 - formatacao: `sema formatar <arquivo.sema>`
 - importacao assistida de legado: `sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|typescript|python|dart|dotnet|java|go|rust|cpp> <diretorio> --saida <diretorio>`
-- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>`
+- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>`
 - verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`
 
 Regra pratica de ouro:
@@ -83,11 +83,11 @@ Regra pratica de ouro:
 - se a tarefa partir de projeto que nao nasceu com Sema, `sema importar` deve entrar antes da lapidacao semantica
 - se a tarefa pedir apenas leitura ou correcao sem gerar codigo, `sema compilar` pode ficar fora
 
-Antes de editar:
-1. leia README, docs de IA e um exemplo oficial parecido
-2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
-   - se timeout local estourar, repita com timeout maior ou escopo menor; timeout do agente nao e falha do Sema
-3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
+Antes de editar:
+1. leia README, docs de IA e um exemplo oficial parecido
+2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
+   - se timeout local estourar, repita com timeout maior ou escopo menor; timeout do agente nao e falha do Sema
+3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
 
 Depois de editar:
 1. rode `sema formatar`
@@ -108,4 +108,4 @@ Documentos de apoio:
 
 - [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
 - [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
-- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)
+- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)

package/docs/cli.md

@@ -20,6 +20,7 @@ Use it for local-agent work:
 - resolve documentation gates;
 - run profile and pipeline validators;
 - generate derived artifacts for TypeScript, Python, Dart, Lua, JavaScript, HTML, and CSS;
+- initialize a new project with `AGENTS.md`, `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_INDEX.json`, `docs/sintaxe.md`, `docs/fluxo-pratico-ia-sema.md`, and `exemplos/`;
 - execute local or VPS-side project actions.
 
 The key installer from the site installs Node/npm when missing, installs the CLI, and saves `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL`, and compatibility MCP env vars. In a local IDE, the agent must first run `sema --version`. If it fails, the agent stops and asks the human to open the Sema panel and run the key installer. If `preflight` returns anything other than `decisao=use_cli_local`, stop. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` just to read a local workspace.
@@ -56,6 +57,7 @@ Use a CLI para trabalho de agente local:
 - resolver gates de documentação;
 - rodar validadores de profiles e pipelines;
 - gerar artefatos derivados para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS;
+- iniciar projeto novo com `AGENTS.md`, `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_INDEX.json`, `docs/sintaxe.md`, `docs/fluxo-pratico-ia-sema.md` e `exemplos/`;
 - executar ações locais ou na VPS.
 
 O instalador do site instala Node/npm quando faltar, instala a CLI e grava `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` e variáveis MCP de compatibilidade. Se o `preflight` retornar qualquer coisa diferente de `decisao=use_cli_local`, pare. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` só para ler workspace local.
@@ -93,6 +95,7 @@ Usa la CLI para trabajo de agente local:
 - resolver gates de documentación;
 - ejecutar validadores de profiles y pipelines;
 - generar artefactos derivados para TypeScript, Python, Dart, Lua, JavaScript, HTML y CSS;
+- iniciar un proyecto nuevo con `AGENTS.md`, `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_INDEX.json`, `docs/sintaxe.md`, `docs/fluxo-pratico-ia-sema.md` y `exemplos/`;
 - ejecutar acciones locales o en la VPS.
 
 El instalador del sitio instala Node/npm cuando falten, instala la CLI y guarda `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` y variables MCP de compatibilidad. En una IDE local, el agente debe ejecutar primero `sema --version`. Si falla, para y pide al humano que abra el panel Sema y ejecute el instalador de clave. Si `preflight` devuelve algo distinto de `decisao=use_cli_local`, para. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` solo para leer un workspace local.