@semacode/cli 1.5.45 → 1.5.47

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 (60) hide show
  1. package/AGENTS.md +324 -324
  2. package/AGENT_CONTEXT_PACK.json +30 -18
  3. package/SEMA_BRIEF.curto.txt +6 -5
  4. package/SEMA_BRIEF.md +106 -106
  5. package/SEMA_BRIEF.micro.txt +4 -4
  6. package/SEMA_INDEX.json +741 -456
  7. package/dist/agentContext.d.ts +2 -2
  8. package/dist/agentContextPack.js +29 -18
  9. package/dist/agentContextPack.js.map +1 -1
  10. package/dist/agentContextTipos.d.ts +1 -1
  11. package/dist/agentContextTipos.js +1 -0
  12. package/dist/agentContextTipos.js.map +1 -1
  13. package/dist/agentEntryPoints.js +247 -7
  14. package/dist/agentEntryPoints.js.map +1 -1
  15. package/dist/driftOrcamento.d.ts +2 -2
  16. package/dist/driftOrcamento.js +13 -10
  17. package/dist/driftOrcamento.js.map +1 -1
  18. package/dist/index.part01.js +4 -2
  19. package/dist/index.part01.js.map +1 -1
  20. package/dist/index.part02.js +1 -1
  21. package/dist/index.part02.js.map +1 -1
  22. package/dist/index.part04.js +34 -3
  23. package/dist/index.part04.js.map +1 -1
  24. package/dist/initCommand.js +20 -0
  25. package/dist/initCommand.js.map +1 -1
  26. package/dist/initTemplatesBase.js +50 -2
  27. package/dist/initTemplatesBase.js.map +1 -1
  28. package/dist/profileArtefatoValidadores.d.ts +2 -0
  29. package/dist/profileArtefatoValidadores.js +42 -0
  30. package/dist/profileArtefatoValidadores.js.map +1 -1
  31. package/dist/profileAuthorTipos.d.ts +2 -2
  32. package/dist/profileCatalogo.js +64 -2
  33. package/dist/profileCatalogo.js.map +1 -1
  34. package/dist/profileCommand.js +4 -4
  35. package/dist/profileCommand.js.map +1 -1
  36. package/dist/profileRegras.js +17 -0
  37. package/dist/profileRegras.js.map +1 -1
  38. package/dist/profileRulePacks.js +71 -1
  39. package/dist/profileRulePacks.js.map +1 -1
  40. package/dist/projetoBusca.js +8 -0
  41. package/dist/projetoBusca.js.map +1 -1
  42. package/docs/AGENT_STARTER.md +13 -13
  43. package/docs/agentes-por-capacidade.md +7 -7
  44. package/docs/cli.md +3 -0
  45. package/docs/comandos.md +702 -0
  46. package/docs/env.md +2 -2
  47. package/docs/extensao-vscode.md +1 -1
  48. package/node_modules/@sema/gerador-css/package.json +1 -1
  49. package/node_modules/@sema/gerador-dart/package.json +1 -1
  50. package/node_modules/@sema/gerador-html/package.json +1 -1
  51. package/node_modules/@sema/gerador-javascript/package.json +1 -1
  52. package/node_modules/@sema/gerador-lua/package.json +1 -1
  53. package/node_modules/@sema/gerador-python/package.json +1 -1
  54. package/node_modules/@sema/gerador-typescript/package.json +1 -1
  55. package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.d.ts +2 -2
  56. package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js +2 -2
  57. package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js.map +1 -1
  58. package/node_modules/@sema/nucleo/package.json +1 -1
  59. package/node_modules/@sema/padroes/package.json +1 -1
  60. package/package.json +10 -10
@@ -1 +1 @@
1
- {"version":3,"file":"projetoBusca.js","sourceRoot":"","sources":["../src/projetoBusca.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,iGAAiG;AAEjG,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IACjD,MAAM;IACN,SAAS;IACT,eAAe;IACf,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,OAAO;IACP,YAAY;IACZ,aAAa;IACb,OAAO;IACP,UAAU;IACV,QAAQ;IACR,MAAM;IACN,KAAK;IACL,MAAM;IACN,WAAW;IACX,cAAc;IACd,WAAW;IACX,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO;IACP,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,IAAI;IACJ,OAAO;IACP,MAAM;IACN,MAAM;CACP,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,aAAqB;IAChE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,OAAO,QAAQ;aACZ,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;aAC1C,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,aAAqB,EACrB,SAAmB,EACnB,kBAAkB,GAAG,CAAC,EACtB,MAAM,GAAG,EAAE;IAEX,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,KAAK,EAAE,cAAsB,EAAE,iBAAyB,EAAiB,EAAE;QACzF,IAAI,WAAW,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,WAAW,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;gBACjC,OAAO;YACT,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7D,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,IAAI,iBAAiB,IAAI,CAAC,IAAI,2BAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC1F,SAAS;gBACX,CAAC;gBACD,MAAM,OAAO,CAAC,YAAY,EAAE,iBAAiB,GAAG,CAAC,CAAC,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBAChF,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IACjD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAqB,EACrB,KAAe,EACf,kBAAkB,GAAG,CAAC;IAEtB,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,KAAK,EAAE,cAAsB,EAAE,iBAAyB,EAAiB,EAAE;QACzF,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7D,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC1B,IAAI,iBAAiB,IAAI,CAAC,IAAI,2BAA2B,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC1F,SAAS;gBACX,CAAC;gBACD,MAAM,OAAO,CAAC,YAAY,EAAE,iBAAiB,GAAG,CAAC,CAAC,CAAC;gBACnD,SAAS;YACX,CAAC;YAED,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACtD,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;IACjD,OAAO,WAAW,CAAC;AACrB,CAAC"}
1
+ {"version":3,"file":"projetoBusca.js","sourceRoot":"","sources":["../src/projetoBusca.ts"],"names":[],"mappings":"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"}
@@ -41,7 +41,7 @@ Importante:
41
41
  - a Sema funciona como camada de navegacao operacional para agente, nao como runtime magico
42
42
  - leitura humana e bonus toleravel, nao centro do produto
43
43
  - a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
44
- - a Sema gera codigo e scaffolding real para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS
44
+ - a Sema gera codigo e scaffolding real para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS
45
45
  - a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico
46
46
  - a Sema usa `drift` para medir diferenca entre contrato e codigo vivo
47
47
  - a Sema usa `impl` para ligar task a simbolo real do runtime
@@ -55,11 +55,11 @@ Importante:
55
55
  - se a tarefa envolver UI, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivo aleatorio
56
56
  - evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
57
57
 
58
- Regras:
59
- - nao invente sintaxe fora da gramatica e dos exemplos oficiais
60
- - se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
61
- - se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo antes de declarar falha
62
- - trate `ir --json` como fonte de verdade semantica
58
+ Regras:
59
+ - nao invente sintaxe fora da gramatica e dos exemplos oficiais
60
+ - se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
61
+ - se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo antes de declarar falha
62
+ - trate `ir --json` como fonte de verdade semantica
63
63
  - trate `diagnosticos --json` como fonte de correcao
64
64
  - use `sema formatar` como fonte unica de estilo
65
65
  - preserve a intencao do contrato
@@ -75,7 +75,7 @@ Comandos essenciais:
75
75
  - diagnosticos: `sema diagnosticos <arquivo.sema> --json`
76
76
  - formatacao: `sema formatar <arquivo.sema>`
77
77
  - 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>`
78
- - geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>`
78
+ - geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>`
79
79
  - verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`
80
80
 
81
81
  Regra pratica de ouro:
@@ -83,11 +83,11 @@ Regra pratica de ouro:
83
83
  - se a tarefa partir de projeto que nao nasceu com Sema, `sema importar` deve entrar antes da lapidacao semantica
84
84
  - se a tarefa pedir apenas leitura ou correcao sem gerar codigo, `sema compilar` pode ficar fora
85
85
 
86
- Antes de editar:
87
- 1. leia README, docs de IA e um exemplo oficial parecido
88
- 2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
89
- - se timeout local estourar, repita com timeout maior ou escopo menor; timeout do agente nao e falha do Sema
90
- 3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
86
+ Antes de editar:
87
+ 1. leia README, docs de IA e um exemplo oficial parecido
88
+ 2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
89
+ - se timeout local estourar, repita com timeout maior ou escopo menor; timeout do agente nao e falha do Sema
90
+ 3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
91
91
 
92
92
  Depois de editar:
93
93
  1. rode `sema formatar`
@@ -108,4 +108,4 @@ Documentos de apoio:
108
108
 
109
109
  - [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
110
110
  - [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
111
- - [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)
111
+ - [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)
@@ -16,12 +16,12 @@ O Sema governa contrato, escopo, drift, evidência e qualidade do projeto. Ele n
16
16
  ## Código Governado
17
17
 
18
18
  Arquivos gerados ou governados pela Sema devem manter o marcador `SEMA-GOVERNED`.
19
- Orçamento semântico é regra: 300+ linhas exige plano de divisão; 500+ linhas não pode concluir, gerar nem sincronizar.
19
+ Orçamento semântico é regra: código ou contrato governado com 1000+ linhas exige plano de divisão; 2000+ linhas não pode concluir, gerar nem sincronizar. Markdown documental não entra nesse limite de código.
20
20
  Validação inline 100/100 não remove essa obrigação: ela comprova aquele payload, mas o arquivo físico ainda precisa avisar a próxima IA que existe contrato.
21
21
 
22
- - Fraca: Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Não crie arquivo acima de 500 linhas nem envie payload inline acima de 262144 caracteres; divida antes por responsabilidade, nunca em partes p1/p2 sem sentido.
23
- - Média: Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate 300+ linhas como refatoração provável; se o payload inline passar de 262144 caracteres, separe HTML, estilos, estado, renderização, cálculo e dados antes de sincronizar.
24
- - Forte: Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift, orçamento de 500 linhas e finalizar-mudanca. Contexto grande não autoriza monólito nem payload inline acima de 262144 caracteres.
22
+ - Fraca: Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Não crie código ou contrato governado acima de 2000 linhas nem envie payload inline acima de 262144 caracteres; divida antes por responsabilidade, nunca em partes p1/p2 sem sentido.
23
+ - Média: Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate 1000+ linhas em código ou contrato governado como refatoração provável; se o payload inline passar de 262144 caracteres, separe HTML, estilos, estado, renderização, cálculo e dados antes de sincronizar.
24
+ - Forte: Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift, orçamento governado de 2000 linhas e finalizar-mudanca. Contexto grande não autoriza monólito nem payload inline acima de 262144 caracteres.
25
25
 
26
26
  ## Payload e Transporte MCP
27
27
 
@@ -71,8 +71,8 @@ Use para Copilot em modo simples, Cline/Roo com pouco contexto, modelos locais p
71
71
  - Não abrir AST/IR completos no começo.
72
72
  - Não editar se Sema não respondeu.
73
73
  - Não pedir para MCP remoto ler pasta local.
74
- - Não criar arquivo grande; divida antes de passar de 500 linhas.
75
- - Não fatiar arquivo grande em partes artificiais; divida por responsabilidade real.
74
+ - Não criar código ou contrato governado grande; divida antes de passar de 2000 linhas.
75
+ - Não fatiar código ou contrato grande em partes artificiais; divida por responsabilidade real.
76
76
  - Não aceitar score ou achado como prova sem evidência concreta.
77
77
 
78
78
  ## Média
@@ -82,7 +82,7 @@ Use para agentes com bom contexto, mas sem garantia de seguir todos os gates.
82
82
  - Entrada: `SEMA_BOOT.md` -> `AGENT_CONTEXT_PACK.json` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json`.
83
83
  - Rodar docs-impacto antes de agir.
84
84
  - Validar drift e contrato no fechamento.
85
- - Tratar 300+ linhas como sinal de refatoração e 500+ como bloqueio.
85
+ - Tratar 1000+ linhas em código ou contrato governado como sinal de refatoração e 2000+ como bloqueio.
86
86
  - Em UI ou HTML estático, separar estrutura, estilos, estado, cálculo, renderização e dados antes de sincronizar.
87
87
  - Verificar se score, achados e decisão correspondem a regra real, não só termo copiado.
88
88
 
package/docs/cli.md CHANGED
@@ -20,6 +20,7 @@ Use it for local-agent work:
20
20
  - resolve documentation gates;
21
21
  - run profile and pipeline validators;
22
22
  - generate derived artifacts for TypeScript, Python, Dart, Lua, JavaScript, HTML, and CSS;
23
+ - 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/`;
23
24
  - execute local or VPS-side project actions.
24
25
 
25
26
  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:
56
57
  - resolver gates de documentação;
57
58
  - rodar validadores de profiles e pipelines;
58
59
  - gerar artefatos derivados para TypeScript, Python, Dart, Lua, JavaScript, HTML e CSS;
60
+ - 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/`;
59
61
  - executar ações locais ou na VPS.
60
62
 
61
63
  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:
93
95
  - resolver gates de documentación;
94
96
  - ejecutar validadores de profiles y pipelines;
95
97
  - generar artefactos derivados para TypeScript, Python, Dart, Lua, JavaScript, HTML y CSS;
98
+ - 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/`;
96
99
  - ejecutar acciones locales o en la VPS.
97
100
 
98
101
  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.