@semacode/cli 2.3.1 → 3.0.0

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 (250) hide show
  1. package/README.md +265 -217
  2. package/dist/agentContextPack.js +14 -10
  3. package/dist/agentEntryPoints.d.ts +5 -0
  4. package/dist/agentEntryPoints.js +567 -557
  5. package/dist/angular-consumer-standalone.js +1 -1
  6. package/dist/bin.d.ts +6 -0
  7. package/dist/bin.js +130 -0
  8. package/dist/cliArgs.js +4 -4
  9. package/dist/cliControlError.d.ts +12 -0
  10. package/dist/cliControlError.js +47 -0
  11. package/dist/cliGrammar.d.ts +11 -0
  12. package/dist/cliGrammar.js +551 -0
  13. package/dist/cliHelp.d.ts +13 -0
  14. package/dist/cliHelp.js +19 -0
  15. package/dist/cliHelpTexto.d.ts +3 -0
  16. package/dist/cliHelpTexto.js +168 -0
  17. package/dist/cliRuntime.d.ts +2 -0
  18. package/dist/cliRuntime.js +31 -0
  19. package/dist/comandos.js +9 -22
  20. package/dist/contexto.js +5 -5
  21. package/dist/dev/index.d.ts +1 -0
  22. package/dist/dev/index.js +51 -9
  23. package/dist/discovery/catalog.js +3 -3
  24. package/dist/distribuicao/filesystemGlobal.d.ts +63 -0
  25. package/dist/distribuicao/filesystemGlobal.js +701 -0
  26. package/dist/distribuicao/index.d.ts +7 -0
  27. package/dist/distribuicao/index.js +227 -0
  28. package/dist/distribuicao/launcherGlobal.d.ts +53 -0
  29. package/dist/distribuicao/launcherGlobal.js +643 -0
  30. package/dist/distribuicao/launcherWindows.d.ts +28 -0
  31. package/dist/distribuicao/launcherWindows.js +326 -0
  32. package/dist/distribuicao/lockContextGlobal.d.ts +10 -0
  33. package/dist/distribuicao/lockContextGlobal.js +17 -0
  34. package/dist/distribuicao/lockGlobal.d.ts +6 -0
  35. package/dist/distribuicao/lockGlobal.js +520 -0
  36. package/dist/distribuicao/skillGlobal.d.ts +48 -0
  37. package/dist/distribuicao/skillGlobal.js +652 -0
  38. package/dist/distribuicao/skillIntentPolicy.d.ts +21 -0
  39. package/dist/distribuicao/skillIntentPolicy.js +115 -0
  40. package/dist/distribuicao/tipos.d.ts +50 -0
  41. package/dist/distribuicao/tipos.js +10 -0
  42. package/dist/distribuicao/versaoSemantica.d.ts +3 -0
  43. package/dist/distribuicao/versaoSemantica.js +62 -0
  44. package/dist/drift.part01.d.ts +26 -24
  45. package/dist/drift.part01.js +2 -1
  46. package/dist/drift.part04.d.ts +12 -3
  47. package/dist/drift.part04.js +88 -17
  48. package/dist/drift.part05.d.ts +2 -2
  49. package/dist/drift.part05.js +8 -6
  50. package/dist/drift.part06.d.ts +2 -2
  51. package/dist/drift.part06.js +113 -26
  52. package/dist/drift.part07.d.ts +11 -11
  53. package/dist/drift.part07.js +261 -265
  54. package/dist/drift.part08.d.ts +2 -2
  55. package/dist/drift.part08.js +35 -26
  56. package/dist/drift.part11.js +238 -56
  57. package/dist/drift.part12.d.ts +1 -1
  58. package/dist/drift.part12.js +193 -21
  59. package/dist/drift.part13.d.ts +20 -39
  60. package/dist/drift.part13.js +601 -647
  61. package/dist/drift.part14.js +21 -7
  62. package/dist/driftCacheCas.d.ts +43 -0
  63. package/dist/driftCacheCas.js +351 -0
  64. package/dist/driftCacheFilesystem.d.ts +64 -0
  65. package/dist/driftCacheFilesystem.js +313 -0
  66. package/dist/driftCacheModes.d.ts +38 -0
  67. package/dist/driftCacheModes.js +147 -0
  68. package/dist/driftCacheStore.d.ts +80 -0
  69. package/dist/driftCacheStore.js +603 -0
  70. package/dist/driftCatalogo.d.ts +2 -28
  71. package/dist/driftCatalogo.js +143 -284
  72. package/dist/driftEscopo.d.ts +1 -3
  73. package/dist/driftEscopo.js +235 -151
  74. package/dist/driftEscopoReferencias.d.ts +5 -1
  75. package/dist/driftEscopoReferencias.js +375 -28
  76. package/dist/driftOrcamento.d.ts +0 -6
  77. package/dist/driftOrcamento.js +2 -1
  78. package/dist/execucoesExternas.js +19 -5
  79. package/dist/geracaoCore.js +4 -6
  80. package/dist/iaPrompts.d.ts +3 -3
  81. package/dist/iaPrompts.js +312 -313
  82. package/dist/index.d.ts +4 -1
  83. package/dist/index.js +6 -25
  84. package/dist/index.part01.d.ts +20 -28
  85. package/dist/index.part01.js +16 -237
  86. package/dist/index.part02.js +36 -22
  87. package/dist/index.part03.d.ts +24 -2
  88. package/dist/index.part03.js +83 -19
  89. package/dist/index.part04.d.ts +10 -2
  90. package/dist/index.part04.js +142 -120
  91. package/dist/index.part05.js +80 -78
  92. package/dist/index.part06.js +34 -17
  93. package/dist/index.part07.js +7 -3
  94. package/dist/index.part08.d.ts +1 -1
  95. package/dist/index.part08.js +22 -27
  96. package/dist/initCommand.js +5 -1
  97. package/dist/initTemplatesBase.js +81 -79
  98. package/dist/pipelineConteudo/command.d.ts +1 -0
  99. package/dist/pipelineConteudo/command.js +9 -2
  100. package/dist/pipelineConteudo/help.d.ts +2 -0
  101. package/dist/pipelineConteudo/help.js +33 -0
  102. package/dist/profileAuthorCommand.js +3 -7
  103. package/dist/profileCommand.js +3 -7
  104. package/dist/projetoCarregar.js +35 -17
  105. package/dist/projetoCatalogo.d.ts +1 -0
  106. package/dist/projetoCatalogo.js +64 -25
  107. package/dist/projetoOrigens.d.ts +2 -0
  108. package/dist/projetoOrigens.js +65 -9
  109. package/dist/projetoTipos.d.ts +1 -0
  110. package/dist/resultadoCli.d.ts +20 -0
  111. package/dist/resultadoCli.js +57 -0
  112. package/dist/saidaCli.d.ts +35 -0
  113. package/dist/saidaCli.js +118 -0
  114. package/dist/sistemasInterativos/acceptanceEvidence.d.ts +22 -0
  115. package/dist/sistemasInterativos/acceptanceEvidence.js +345 -0
  116. package/dist/sistemasInterativos/engineObservation.d.ts +12 -0
  117. package/dist/sistemasInterativos/engineObservation.js +438 -0
  118. package/dist/sistemasInterativos/jobOrchestration.d.ts +2 -0
  119. package/dist/sistemasInterativos/jobOrchestration.js +204 -0
  120. package/dist/sistemasInterativos/operationPrimitives.d.ts +21 -0
  121. package/dist/sistemasInterativos/operationPrimitives.js +194 -0
  122. package/dist/sistemasInterativos/operations.d.ts +4 -39
  123. package/dist/sistemasInterativos/operations.js +5 -1164
  124. package/dist/skillCommand.d.ts +5 -0
  125. package/dist/skillCommand.js +88 -0
  126. package/docs/README.md +34 -30
  127. package/docs/ai-integration.md +25 -12
  128. package/docs/ai-onboarding.md +37 -18
  129. package/docs/ai-workflow.md +9 -7
  130. package/docs/cli.md +125 -7
  131. package/docs/commands.md +41 -20
  132. package/docs/deploy.md +21 -8
  133. package/docs/descoberta-capacidades.md +106 -106
  134. package/docs/documentation.md +49 -39
  135. package/docs/drift-cache.md +108 -0
  136. package/docs/getting-started.md +43 -18
  137. package/docs/pipeline-conteudo.md +246 -246
  138. package/docs/profiles.md +54 -54
  139. package/docs/repositories.md +19 -2
  140. package/docs/rollback.md +15 -8
  141. package/docs/security.md +25 -3
  142. package/docs/sistemas-interativos.md +379 -374
  143. package/docs/testing.md +139 -40
  144. package/exemplos/pipeline-conteudo/README.md +44 -44
  145. package/exemplos/pipeline-conteudo/alvos.json +23 -23
  146. package/exemplos/pipeline-conteudo/definicao.json +136 -136
  147. package/exemplos/profile_simulation.sema +211 -211
  148. package/exemplos/sistemas-interativos/README.md +100 -100
  149. package/exemplos/sistemas-interativos/advanced/acceptance-context-evaluate-valid.json +5 -5
  150. package/exemplos/sistemas-interativos/advanced/acceptance-lock-valid.json +16 -16
  151. package/exemplos/sistemas-interativos/advanced/asset-provenance-valid.json +32 -32
  152. package/exemplos/sistemas-interativos/advanced/autonomy-repair-valid.json +93 -93
  153. package/exemplos/sistemas-interativos/advanced/control-run-definition-valid.json +78 -78
  154. package/exemplos/sistemas-interativos/advanced/control-run-valid.json +27 -27
  155. package/exemplos/sistemas-interativos/advanced/distributed-workers-valid.json +79 -79
  156. package/exemplos/sistemas-interativos/advanced/editor-state-valid.json +42 -42
  157. package/exemplos/sistemas-interativos/advanced/engine-snapshot-after-valid.json +32 -32
  158. package/exemplos/sistemas-interativos/advanced/engine-snapshot-before-valid.json +23 -23
  159. package/exemplos/sistemas-interativos/advanced/job-orchestration-valid.json +39 -39
  160. package/exemplos/sistemas-interativos/advanced/multimodal-evidence-valid.json +46 -46
  161. package/exemplos/sistemas-interativos/advanced/multiplayer-authority-valid.json +39 -39
  162. package/exemplos/sistemas-interativos/advanced/playtest-fuzz-valid.json +37 -37
  163. package/exemplos/sistemas-interativos/advanced/portability-valid.json +104 -104
  164. package/exemplos/sistemas-interativos/advanced/temporal-evidence-valid.json +27 -27
  165. package/exemplos/sistemas-interativos/advanced/temporal-valid.json +118 -118
  166. package/exemplos/sistemas-interativos/experience-ir-valid.json +459 -459
  167. package/exemplos/sistemas-interativos/game-2d.json +83 -83
  168. package/exemplos/sistemas-interativos/game-3d-human.json +81 -81
  169. package/exemplos/sistemas-interativos/game-pixel-16-bit.json +97 -97
  170. package/exemplos/sistemas-interativos/game-pixel-8-bit.json +94 -94
  171. package/exemplos/sistemas-interativos/game-xr-human.json +80 -80
  172. package/exemplos/sistemas-interativos/hybrid-2-5d.json +108 -108
  173. package/exemplos/sistemas-interativos/protocol-mutating-rollback-valid.json +75 -75
  174. package/exemplos/sistemas-interativos/protocol-read-only-valid.json +58 -58
  175. package/exemplos/sistemas-interativos/simulation-2d-controlled.json +97 -97
  176. package/exemplos/sistemas-interativos/simulation-3d-calibrated-autonomous.json +141 -141
  177. package/exemplos/sistemas-interativos/simulation-headless-autonomous-batch.json +112 -112
  178. package/exemplos/sistemas-interativos/simulation-pixel-16-bit.json +103 -103
  179. package/exemplos/sistemas-interativos/simulation-text-controlled.json +95 -95
  180. package/node_modules/@sema/gerador-cpp/package.json +1 -1
  181. package/node_modules/@sema/gerador-dotnet/package.json +1 -1
  182. package/node_modules/@sema/gerador-lua/dist/index.js +51 -51
  183. package/node_modules/@sema/gerador-php/dist/index.js +113 -113
  184. package/node_modules/@sema/nucleo/dist/semantico/analisador.d.ts +1 -0
  185. package/node_modules/@sema/nucleo/dist/semantico/analisador.js +1 -0
  186. package/package.json +9 -4
  187. package/scripts/postinstall.mjs +148 -0
  188. package/skills/sema/SKILL.md +199 -0
  189. package/skills/sema/agents/openai.yaml +4 -0
  190. package/dist/driftCache.d.ts +0 -49
  191. package/dist/driftCache.js +0 -311
  192. package/dist/driftCacheIncremental.d.ts +0 -98
  193. package/dist/driftCacheIncremental.js +0 -596
  194. package/dist/driftCatalogoPersistente.d.ts +0 -8
  195. package/dist/driftCatalogoPersistente.js +0 -77
  196. package/node_modules/@sema/gerador-cpp/dist/index.js.map +0 -1
  197. package/node_modules/@sema/gerador-css/dist/index.js.map +0 -1
  198. package/node_modules/@sema/gerador-css/dist/index.part01.js.map +0 -1
  199. package/node_modules/@sema/gerador-css/dist/index.part02.js.map +0 -1
  200. package/node_modules/@sema/gerador-dart/dist/index.js.map +0 -1
  201. package/node_modules/@sema/gerador-dotnet/dist/index.js.map +0 -1
  202. package/node_modules/@sema/gerador-html/dist/index.js.map +0 -1
  203. package/node_modules/@sema/gerador-javascript/dist/index.js.map +0 -1
  204. package/node_modules/@sema/gerador-lua/dist/index.js.map +0 -1
  205. package/node_modules/@sema/gerador-php/dist/index.js.map +0 -1
  206. package/node_modules/@sema/gerador-python/dist/index.js.map +0 -1
  207. package/node_modules/@sema/gerador-python/dist/index.part01.js.map +0 -1
  208. package/node_modules/@sema/gerador-python/dist/index.part02.js.map +0 -1
  209. package/node_modules/@sema/gerador-typescript/dist/index.js.map +0 -1
  210. package/node_modules/@sema/gerador-typescript/dist/index.part01.js.map +0 -1
  211. package/node_modules/@sema/gerador-typescript/dist/index.part02.js.map +0 -1
  212. package/node_modules/@sema/gerador-typescript/dist/index.part03.js.map +0 -1
  213. package/node_modules/@sema/nucleo/dist/ast/tipos.js.map +0 -1
  214. package/node_modules/@sema/nucleo/dist/diagnosticos/index.js.map +0 -1
  215. package/node_modules/@sema/nucleo/dist/diagnosticos/melhorador.js.map +0 -1
  216. package/node_modules/@sema/nucleo/dist/diagnosticos/snippets.js.map +0 -1
  217. package/node_modules/@sema/nucleo/dist/formatador/index.js.map +0 -1
  218. package/node_modules/@sema/nucleo/dist/formatador/index.part01.js.map +0 -1
  219. package/node_modules/@sema/nucleo/dist/formatador/index.part02.js.map +0 -1
  220. package/node_modules/@sema/nucleo/dist/index.js.map +0 -1
  221. package/node_modules/@sema/nucleo/dist/ir/conversor.js.map +0 -1
  222. package/node_modules/@sema/nucleo/dist/ir/conversor.part01.js.map +0 -1
  223. package/node_modules/@sema/nucleo/dist/ir/conversor.part02.js.map +0 -1
  224. package/node_modules/@sema/nucleo/dist/ir/conversor.part03.js.map +0 -1
  225. package/node_modules/@sema/nucleo/dist/ir/modelos.js.map +0 -1
  226. package/node_modules/@sema/nucleo/dist/lexer/lexer.js.map +0 -1
  227. package/node_modules/@sema/nucleo/dist/lexer/tokens.js.map +0 -1
  228. package/node_modules/@sema/nucleo/dist/parser/parser.declaracoes.js.map +0 -1
  229. package/node_modules/@sema/nucleo/dist/parser/parser.js.map +0 -1
  230. package/node_modules/@sema/nucleo/dist/parser/parser.modulo.js.map +0 -1
  231. package/node_modules/@sema/nucleo/dist/parser/parser.part01.js.map +0 -1
  232. package/node_modules/@sema/nucleo/dist/parser/parser.part02.js.map +0 -1
  233. package/node_modules/@sema/nucleo/dist/parser/parser.part03.js.map +0 -1
  234. package/node_modules/@sema/nucleo/dist/persistencia/contratos.js.map +0 -1
  235. package/node_modules/@sema/nucleo/dist/semantico/analisador.js.map +0 -1
  236. package/node_modules/@sema/nucleo/dist/semantico/analisador.part01.js.map +0 -1
  237. package/node_modules/@sema/nucleo/dist/semantico/analisador.part02.js.map +0 -1
  238. package/node_modules/@sema/nucleo/dist/semantico/analisador.part03.js.map +0 -1
  239. package/node_modules/@sema/nucleo/dist/semantico/analisador.part04.js.map +0 -1
  240. package/node_modules/@sema/nucleo/dist/semantico/analisador.part05.js.map +0 -1
  241. package/node_modules/@sema/nucleo/dist/semantico/analisador.part06.js.map +0 -1
  242. package/node_modules/@sema/nucleo/dist/semantico/analisador.part07.js.map +0 -1
  243. package/node_modules/@sema/nucleo/dist/semantico/analisador.part08.js.map +0 -1
  244. package/node_modules/@sema/nucleo/dist/semantico/estruturas.js.map +0 -1
  245. package/node_modules/@sema/nucleo/dist/semantico/estruturas.part01.js.map +0 -1
  246. package/node_modules/@sema/nucleo/dist/semantico/estruturas.part02.js.map +0 -1
  247. package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js.map +0 -1
  248. package/node_modules/@sema/nucleo/dist/semantico/seguranca.js.map +0 -1
  249. package/node_modules/@sema/nucleo/dist/util/arquivos.js.map +0 -1
  250. package/node_modules/@sema/padroes/dist/index.js.map +0 -1
package/dist/iaPrompts.js CHANGED
@@ -1,321 +1,320 @@
1
- // SEMA-GOVERNED
2
- // M?dulo: sema.produto.orcamento_semantico
3
- // Contrato: contratos/sema/orcamento_semantico.sema
4
- // Descri??o: textos oficiais de prompt e onboarding IA-first usados pela CLI.
5
- export const STARTER_IA = `Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.
6
-
7
- Importante:
8
- - a Sema se apresenta publicamente como protocolo e funciona tecnicamente como linguagem de intencao
9
- - a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana
10
- - humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato
11
- - leitura humana e bonus toleravel, nao objetivo de produto
12
- - a Sema nao e gerador magico que deveria fazer tudo
13
- - a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
14
- - a Sema gera codigo e scaffolding real para TypeScript, Python, PHP, Dart, Lua, JavaScript, HTML e CSS
15
- - a Sema usa \`importar\` para bootstrap revisavel, nao para contrato final automatico
16
- - a Sema usa \`impl\` para ligar task a simbolo real do runtime
17
- - a Sema usa \`vinculos\` para ligar contrato a arquivo, simbolo, recurso e superficie real
18
- - a Sema usa \`execucao\` para explicitar timeout, retry, compensacao e criticidade
19
- - a Sema usa \`drift\` para medir diferenca entre contrato e codigo vivo com score, confianca e lacunas
20
- - a Sema usa \`resumo\` e \`prompt-curto\` para IA fraca, gratuita ou com pouco contexto
21
- - a Sema usa \`contexto-ia\` para gerar \`ast.json\`, \`ir.json\`, \`drift.json\`, \`briefing.json\` e artefatos compactos antes da edicao
22
- - timeout definido pelo agente nao e falha do Sema; aumente o timeout e tente de novo antes de concluir falha
23
- - a Sema pode servir de base para interfaces graficas elegantes e coerentes
24
- - a Sema gera artefatos HTML/CSS derivados, mas nao substitui sozinha uma interface completa de produto
25
- - trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto
26
- - se a tarefa envolver UI, prefira pedir Sema + React + TypeScript ou Sema + arquitetura de front-end
27
- - evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
28
-
29
- Regras:
30
- - nao invente sintaxe fora da gramatica e dos exemplos oficiais
31
- - antes de qualquer acao, crie, edite ou remova o contrato .sema aplicavel; isso vale para Software, Author, Workflow, Ops, Game, Legal e Research
32
- - se a IA for fraca, nao tente abrir tudo de uma vez
33
- - use \`sema resumo <arquivo> --micro --json\` pelo stdout antes de subir para o pacote completo
34
- - se \`sema resumo . --micro\` estourar timeout local, repita com timeout maior ou escopo menor; nao avance com codigo
35
- - trate \`ir --json\` como fonte de verdade semantica
36
- - trate \`briefing.json\` como plano de intervencao antes de editar projeto vivo
37
- - trate \`diagnosticos --json\` como fonte de correcao
38
- - use \`sema formatar\` como fonte unica de estilo
39
- - preserve a intencao do contrato
40
- - nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo
41
-
42
- Comandos essenciais:
43
- - resumo compacto por capacidade: \`sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]\`
44
- - prompt curto para IA fraca: \`sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]\`
45
- - descoberta do projeto: \`sema inspecionar [arquivo-ou-pasta] --json\`
46
- - auditoria do contrato vivo: \`sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--json]\`
47
- - mapa de impacto: \`sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--json]\`
48
- - renomeacao assistida: \`sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--json]\`
49
- - contexto completo do modulo: \`sema contexto-ia <arquivo.sema>\`
50
- - estrutura sintatica: \`sema ast <arquivo.sema> --json\`
51
- - estrutura semantica: \`sema ir <arquivo.sema> --json\`
52
- - validacao: \`sema validar <arquivo.sema> --json\`
53
- - diagnosticos: \`sema diagnosticos <arquivo.sema> --json\`
54
- - formatacao: \`sema formatar <arquivo.sema>\`
55
- - importacao assistida de legado: \`sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|php|typescript|python|dart> <diretorio> --saida <diretorio>\`
56
- - exemplos oficiais no projeto: \`sema instalar-exemplos\`
57
- - geracao de codigo: \`sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>\`
1
+ // SEMA-GOVERNED: sema.produto.governanca_ia.drift.cache.modos, sema.governanca_ia_contexto
2
+ // Descrição: textos oficiais de prompt e onboarding que distinguem contrato resumido de evidência fresh do código vivo.
3
+ export const STARTER_IA = `Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.
4
+
5
+ Importante:
6
+ - a Sema se apresenta publicamente como protocolo e funciona tecnicamente como linguagem de intencao
7
+ - a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana
8
+ - humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato
9
+ - leitura humana e bonus toleravel, nao objetivo de produto
10
+ - a Sema nao e gerador magico que deveria fazer tudo
11
+ - a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
12
+ - a Sema gera codigo e scaffolding real para TypeScript, Python, PHP, Dart, Lua, JavaScript, HTML e CSS
13
+ - a Sema usa \`importar\` para bootstrap revisavel, nao para contrato final automatico
14
+ - a Sema usa \`impl\` para ligar task a simbolo real do runtime
15
+ - a Sema usa \`vinculos\` para ligar contrato a arquivo, simbolo, recurso e superficie real
16
+ - a Sema usa \`execucao\` para explicitar timeout, retry, compensacao e criticidade
17
+ - a Sema usa \`drift\` para medir diferenca entre contrato e codigo vivo com score, confianca e lacunas
18
+ - a Sema usa \`resumo\` e \`prompt-curto\` para IA fraca, gratuita ou com pouco contexto
19
+ - a Sema usa \`contexto-ia\` para gerar \`ast.json\`, \`ir.json\`, \`drift.json\`, \`briefing.json\` e artefatos compactos antes da edicao
20
+ - timeout definido pelo agente nao e falha do Sema; aumente o timeout e tente de novo antes de concluir falha
21
+ - a Sema pode servir de base para interfaces graficas elegantes e coerentes
22
+ - a Sema gera artefatos HTML/CSS derivados, mas nao substitui sozinha uma interface completa de produto
23
+ - trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto
24
+ - se a tarefa envolver UI, prefira pedir Sema + React + TypeScript ou Sema + arquitetura de front-end
25
+ - evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
26
+
27
+ Regras:
28
+ - nao invente sintaxe fora da gramatica e dos exemplos oficiais
29
+ - antes de qualquer acao, crie, edite ou remova o contrato .sema aplicavel; isso vale para Software, Author, Workflow, Ops, Game, Legal e Research
30
+ - se a IA for fraca, nao tente abrir tudo de uma vez
31
+ - use \`sema resumo <arquivo> --micro --drift none --json\` pelo stdout antes de subir para o pacote completo; score, confiança e implementação ficam não avaliados
32
+ - se \`sema resumo . --micro\` estourar timeout local, repita com timeout maior ou escopo menor; nao avance com codigo
33
+ - trate \`ir --json\` como fonte de verdade semantica
34
+ - trate \`briefing.json\` como plano de intervencao antes de editar projeto vivo
35
+ - trate \`diagnosticos --json\` como fonte de correcao
36
+ - use \`sema formatar\` como fonte unica de estilo
37
+ - preserve a intencao do contrato
38
+ - nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo
39
+
40
+ Comandos essenciais:
41
+ - resumo compacto por capacidade: \`sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>] [--drift <none|cache|fresh>]\` (padrão: none, sem evidência derivada)
42
+ - prompt curto para IA fraca: \`sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]\`
43
+ - descoberta do projeto: \`sema inspecionar [arquivo-ou-pasta] [--drift <none|cache|fresh>] --json\` (padrão: none)
44
+ - auditoria do contrato vivo: \`sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--cache <none|cache|fresh>] [--json]\` (padrão: fresh; none ainda executa sem cache persistente)
45
+ - mapa de impacto: \`sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--json]\`
46
+ - renomeacao assistida: \`sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--json]\`
47
+ - contexto completo do modulo: \`sema contexto-ia <arquivo.sema>\`
48
+ - estrutura sintatica: \`sema ast <arquivo.sema> --json\`
49
+ - estrutura semantica: \`sema ir <arquivo.sema> --json\`
50
+ - validacao: \`sema validar <arquivo.sema> --json\`
51
+ - diagnosticos: \`sema diagnosticos <arquivo.sema> --json\`
52
+ - formatacao: \`sema formatar <arquivo.sema>\`
53
+ - importacao assistida de legado: \`sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|dotnet|java|go|rust|cpp|php|typescript|python|dart> <diretorio> --saida <diretorio>\`
54
+ - exemplos oficiais no projeto: \`sema instalar-exemplos\`
55
+ - geracao de codigo: \`sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>\`
58
56
  - verificacao final: \`sema verificar <arquivo-ou-pasta> [--json]\`
59
-
60
- Antes de editar:
61
- 1. leia README, docs de IA e um exemplo oficial parecido
62
- 2. se a IA for fraca, rode \`sema resumo <arquivo> --micro --json\` e use o stdout compacto
63
- - se timeout local estourar, aumente o timeout e tente de novo; timeout nao significa Sema inativo
64
- 3. se a IA aguentar mais, rode \`sema drift\` para medir impls, vinculos, rotas, score e lacunas
65
- 4. se a tarefa for pesada, rode \`sema contexto-ia\` e leia \`briefing.json\`
66
- 5. consulte AST e IR do modulo alvo so quando a capacidade realmente aguentar
67
-
68
- Depois de editar:
69
- 1. rode \`sema formatar\`
70
- 2. rode \`sema validar --json\`
71
- 3. se houver falha, use \`diagnosticos --json\`
72
- 4. rode \`sema drift\` de novo quando mexer em codigo vivo
73
- 5. se a tarefa pedir codigo derivado, rode \`sema compilar\`
74
- 6. feche com \`sema verificar <arquivo-ou-pasta> --json\`
75
-
76
- Priorize sempre:
77
- - exemplos oficiais
78
- - JSON da CLI
79
- - o menor artefato que resolva a tarefa da IA atual
80
- - score, confianca e lacunas do \`drift\`
81
- - \`briefing.json\` como guia de mudanca
82
- - consistencia semantica
83
-
84
- Superficies que a IA deve enxergar como first-class:
85
- - \`route\`
86
- - \`worker\`
87
- - \`evento\`
88
- - \`fila\`
89
- - \`cron\`
90
- - \`webhook\`
91
- - \`cache\`
92
- - \`storage\`
93
- - \`policy\`
94
-
95
- Nao improvise quando faltar contexto.
57
+ - distribuição global: \`sema skill status --json\` diagnostica sem alterar; \`sema skill sync --json\` repara launcher e skill; no Windows, PowerShell usa \`sema.ps1\` no PATH, cmd.exe usa \`sema.cmd\`, e \`& "$env:SystemRoot\\System32\\WindowsPowerShell\\v1.0\\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$HOME\\.sema\\bin\\sema-managed.ps1" --version\` é o fallback absoluto
58
+
59
+ Antes de editar:
60
+ 1. leia README, docs de IA e um exemplo oficial parecido
61
+ 2. se a IA for fraca, rode \`sema resumo <arquivo> --micro --drift none --json\` e use o stdout compacto sem inventar evidência de implementação
62
+ - se timeout local estourar, aumente o timeout e tente de novo; timeout nao significa Sema inativo
63
+ 3. se a IA aguentar mais, rode \`sema drift --cache fresh\` para medir impls, vinculos, rotas, score e lacunas com evidência recalculada
64
+ 4. se a tarefa for pesada, rode \`sema contexto-ia\` e leia \`briefing.json\`
65
+ 5. consulte AST e IR do modulo alvo so quando a capacidade realmente aguentar
66
+
67
+ Depois de editar:
68
+ 1. rode \`sema formatar\`
69
+ 2. rode \`sema validar --json\`
70
+ 3. se houver falha, use \`diagnosticos --json\`
71
+ 4. rode \`sema drift --cache fresh\` de novo quando mexer em codigo vivo
72
+ 5. se a tarefa pedir codigo derivado, rode \`sema compilar\`
73
+ 6. feche com \`sema verificar <arquivo-ou-pasta> --json\`
74
+
75
+ Priorize sempre:
76
+ - exemplos oficiais
77
+ - JSON da CLI
78
+ - o menor artefato que resolva a tarefa da IA atual
79
+ - score, confianca e lacunas do \`drift\`
80
+ - \`briefing.json\` como guia de mudanca
81
+ - consistencia semantica
82
+
83
+ Superficies que a IA deve enxergar como first-class:
84
+ - \`route\`
85
+ - \`worker\`
86
+ - \`evento\`
87
+ - \`fila\`
88
+ - \`cron\`
89
+ - \`webhook\`
90
+ - \`cache\`
91
+ - \`storage\`
92
+ - \`policy\`
93
+
94
+ Nao improvise quando faltar contexto.
96
95
  `;
97
- export const PROMPT_BASE_IA = `Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo.
98
-
99
- Trate a Sema como protocolo de governanca semantica e linguagem de intencao feita para IA, nao para leitura humana confortavel. Humanos escrevem e aprovam; agentes consomem. Nao invente sintaxe, palavras-chave ou blocos fora da gramatica e dos exemplos oficiais.
100
-
101
- Fontes de verdade, em ordem:
102
- 1. se o projeto expuser \`SEMA_CONTEXT.md\`, comece por ele
103
- 2. \`AGENT_CONTEXT_PACK.json\`
104
- 3. \`SEMA_BRIEF.md\`
105
- 4. \`SEMA_INDEX.json\`
106
- 5. \`AGENTS.md\`
107
- 6. README do projeto
108
- 7. gramatica e documentacao de sintaxe da Sema
109
- 8. exemplos oficiais, com prioridade para o vertical de pagamento
110
- 9. \`sema resumo <arquivo> --micro --json\` e o stdout compacto quando a IA for fraca
111
- 10. AST, IR e diagnosticos exportados pela CLI em JSON quando a capacidade aguentar
112
-
113
- Regras de operacao:
114
- - contrato vem antes da acao: crie, edite ou remova o .sema aplicavel antes de codigo, docs operacionais, texto Author, workflow, jogo, pesquisa, legal ou ops
115
- - preserve o significado semantico
116
- - use o formatador oficial da Sema como fonte unica de estilo
117
- - use diagnosticos estruturados como contrato de correcao
118
- - use a IR como fonte de verdade semantica quando houver duvida
119
- - use predicados canonicos como normalizacao opcional, preservando a forma original
120
- - nao conclua uma alteracao sem validar e verificar o modulo
121
- - comece pelo menor artefato semantico que resolva a tarefa
122
-
123
- Antes de editar \`.sema\`, entenda:
124
- - o module alvo
125
- - os contratos de task, route, error, effects, guarantees, state e flow
126
- - os exemplos oficiais relacionados
127
-
128
- Depois de editar \`.sema\`, execute este fluxo:
129
- 1. formatar
130
- 2. validar
131
- 3. diagnosticar, se houver falha
132
- 4. verificar
133
-
134
- Se houver conflito entre texto livre e IR/diagnosticos, priorize a IR e os diagnosticos da CLI.
135
-
136
- Se algo nao estiver claro, siga a forma ja usada nos exemplos oficiais. Nao improvise sem base.
96
+ export const PROMPT_BASE_IA = `Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo.
97
+
98
+ Trate a Sema como protocolo de governanca semantica e linguagem de intencao feita para IA, nao para leitura humana confortavel. Humanos escrevem e aprovam; agentes consomem. Nao invente sintaxe, palavras-chave ou blocos fora da gramatica e dos exemplos oficiais.
99
+
100
+ Fontes de verdade, em ordem:
101
+ 1. se o projeto expuser \`SEMA_CONTEXT.md\`, comece por ele
102
+ 2. \`AGENT_CONTEXT_PACK.json\`
103
+ 3. \`SEMA_BRIEF.md\`
104
+ 4. \`SEMA_INDEX.json\`
105
+ 5. \`AGENTS.md\`
106
+ 6. README do projeto
107
+ 7. gramatica e documentacao de sintaxe da Sema
108
+ 8. exemplos oficiais, com prioridade para o vertical de pagamento
109
+ 9. \`sema resumo <arquivo> --micro --drift none --json\` e o stdout compacto quando a IA for fraca; campos derivados nulos significam não avaliados
110
+ 10. AST, IR e diagnosticos exportados pela CLI em JSON quando a capacidade aguentar
111
+
112
+ Regras de operacao:
113
+ - contrato vem antes da acao: crie, edite ou remova o .sema aplicavel antes de codigo, docs operacionais, texto Author, workflow, jogo, pesquisa, legal ou ops
114
+ - preserve o significado semantico
115
+ - use o formatador oficial da Sema como fonte unica de estilo
116
+ - use diagnosticos estruturados como contrato de correcao
117
+ - use a IR como fonte de verdade semantica quando houver duvida
118
+ - use predicados canonicos como normalizacao opcional, preservando a forma original
119
+ - nao conclua uma alteracao sem validar e verificar o modulo
120
+ - comece pelo menor artefato semantico que resolva a tarefa
121
+
122
+ Antes de editar \`.sema\`, entenda:
123
+ - o module alvo
124
+ - os contratos de task, route, error, effects, guarantees, state e flow
125
+ - os exemplos oficiais relacionados
126
+
127
+ Depois de editar \`.sema\`, execute este fluxo:
128
+ 1. formatar
129
+ 2. validar
130
+ 3. diagnosticar, se houver falha
131
+ 4. verificar
132
+
133
+ Se houver conflito entre texto livre e IR/diagnosticos, priorize a IR e os diagnosticos da CLI.
134
+
135
+ Se algo nao estiver claro, siga a forma ja usada nos exemplos oficiais. Nao improvise sem base.
137
136
  `;
138
- export const PROMPT_IA_UI = `Atue como Engenheiro de Software Senior e UX/UI Designer de elite.
139
-
140
- Quero que voce trabalhe com Sema como fonte de verdade semantica do sistema e com React + TypeScript como camada de interface.
141
-
142
- Entregue obrigatoriamente duas partes integradas:
143
- 1. os arquivos \`.sema\` do dominio
144
- 2. a proposta ou implementacao da interface em React + TypeScript
145
-
146
- Regras:
147
- - nao entregue apenas HTML solto em arquivo unico
148
- - nao trate a Sema como enfeite conceitual
149
- - a interface deve nascer do contrato semantico definido em Sema
150
- - use os exemplos oficiais da Sema como referencia de estilo e semantica
151
- - nao invente sintaxe fora da gramatica suportada
152
-
153
- A Sema deve modelar, quando fizer sentido:
154
- - \`module\`
155
- - \`use\`
156
- - \`entity\`
157
- - \`enum\`
158
- - \`state\`
159
- - \`task\`
160
- - \`flow\`
161
- - \`route\`
162
- - \`effects\`
163
- - \`error\`
164
- - \`guarantees\`
165
- - \`tests\`
166
- - \`docs\`
167
-
168
- A interface deve refletir visualmente:
169
- - \`state\` como status e progresso observavel
170
- - \`flow\` como etapas ou orquestracao visivel
171
- - \`error\` como falhas tratadas com clareza
172
- - \`effects\` como operacoes relevantes para usuario ou operacao
173
- - \`guarantees\` como confianca, confirmacao ou consistencia final
174
-
175
- Estruture a entrega assim:
176
- 1. visao do produto
177
- 2. dominio modelado em Sema
178
- 3. arquitetura de pastas em React + TypeScript
179
- 4. componentes principais
180
- 5. estrategia visual
181
- 6. codigo principal da interface
182
- 7. explicacao curta de como a UI conversa com a semantica da Sema
183
-
184
- Se a tarefa envolver app visual, a Sema governa o significado e o React renderiza a experiencia. Nao atropele essa separacao.
137
+ export const PROMPT_IA_UI = `Atue como Engenheiro de Software Senior e UX/UI Designer de elite.
138
+
139
+ Quero que voce trabalhe com Sema como fonte de verdade semantica do sistema e com React + TypeScript como camada de interface.
140
+
141
+ Entregue obrigatoriamente duas partes integradas:
142
+ 1. os arquivos \`.sema\` do dominio
143
+ 2. a proposta ou implementacao da interface em React + TypeScript
144
+
145
+ Regras:
146
+ - nao entregue apenas HTML solto em arquivo unico
147
+ - nao trate a Sema como enfeite conceitual
148
+ - a interface deve nascer do contrato semantico definido em Sema
149
+ - use os exemplos oficiais da Sema como referencia de estilo e semantica
150
+ - nao invente sintaxe fora da gramatica suportada
151
+
152
+ A Sema deve modelar, quando fizer sentido:
153
+ - \`module\`
154
+ - \`use\`
155
+ - \`entity\`
156
+ - \`enum\`
157
+ - \`state\`
158
+ - \`task\`
159
+ - \`flow\`
160
+ - \`route\`
161
+ - \`effects\`
162
+ - \`error\`
163
+ - \`guarantees\`
164
+ - \`tests\`
165
+ - \`docs\`
166
+
167
+ A interface deve refletir visualmente:
168
+ - \`state\` como status e progresso observavel
169
+ - \`flow\` como etapas ou orquestracao visivel
170
+ - \`error\` como falhas tratadas com clareza
171
+ - \`effects\` como operacoes relevantes para usuario ou operacao
172
+ - \`guarantees\` como confianca, confirmacao ou consistencia final
173
+
174
+ Estruture a entrega assim:
175
+ 1. visao do produto
176
+ 2. dominio modelado em Sema
177
+ 3. arquitetura de pastas em React + TypeScript
178
+ 4. componentes principais
179
+ 5. estrategia visual
180
+ 6. codigo principal da interface
181
+ 7. explicacao curta de como a UI conversa com a semantica da Sema
182
+
183
+ Se a tarefa envolver app visual, a Sema governa o significado e o React renderiza a experiencia. Nao atropele essa separacao.
185
184
  `;
186
- export const PROMPT_IA_REACT = `Crie uma solucao com Sema + React + TypeScript.
187
-
188
- Regras principais:
189
- - a Sema deve ser a fonte de verdade semantica do dominio
190
- - React + TypeScript deve ser a camada de interface e experiencia
191
- - nao entregue HTML unico solto
192
- - nao trate a Sema como enfeite
193
-
194
- Entregue obrigatoriamente:
195
- 1. arquivos \`.sema\` do dominio
196
- 2. arquitetura de pastas do frontend
197
- 3. componentes React principais
198
- 4. contratos e tipos derivados da semantica
199
- 5. interface elegante e implementavel
200
-
201
- A modelagem Sema deve cobrir, quando fizer sentido:
202
- - \`entity\`
203
- - \`enum\`
204
- - \`state\`
205
- - \`task\`
206
- - \`flow\`
207
- - \`route\`
208
- - \`effects\`
209
- - \`error\`
210
- - \`guarantees\`
211
- - \`tests\`
212
-
213
- A interface React deve tornar visiveis:
214
- - estado atual e transicoes relevantes
215
- - fluxo operacional
216
- - erros publicos
217
- - efeitos operacionais importantes
218
- - garantias ou confirmacoes finais
219
-
220
- Estruture a entrega assim:
221
- 1. visao do produto
222
- 2. arquivos \`.sema\`
223
- 3. arquitetura React + TypeScript
224
- 4. componentes e telas
225
- 5. codigo principal
226
- 6. explicacao de como a UI deriva da semantica da Sema
227
-
228
- Se houver duvida, siga os exemplos oficiais e mantenha a separacao:
229
- - Sema governa o significado
230
- - React governa a apresentacao
185
+ export const PROMPT_IA_REACT = `Crie uma solucao com Sema + React + TypeScript.
186
+
187
+ Regras principais:
188
+ - a Sema deve ser a fonte de verdade semantica do dominio
189
+ - React + TypeScript deve ser a camada de interface e experiencia
190
+ - nao entregue HTML unico solto
191
+ - nao trate a Sema como enfeite
192
+
193
+ Entregue obrigatoriamente:
194
+ 1. arquivos \`.sema\` do dominio
195
+ 2. arquitetura de pastas do frontend
196
+ 3. componentes React principais
197
+ 4. contratos e tipos derivados da semantica
198
+ 5. interface elegante e implementavel
199
+
200
+ A modelagem Sema deve cobrir, quando fizer sentido:
201
+ - \`entity\`
202
+ - \`enum\`
203
+ - \`state\`
204
+ - \`task\`
205
+ - \`flow\`
206
+ - \`route\`
207
+ - \`effects\`
208
+ - \`error\`
209
+ - \`guarantees\`
210
+ - \`tests\`
211
+
212
+ A interface React deve tornar visiveis:
213
+ - estado atual e transicoes relevantes
214
+ - fluxo operacional
215
+ - erros publicos
216
+ - efeitos operacionais importantes
217
+ - garantias ou confirmacoes finais
218
+
219
+ Estruture a entrega assim:
220
+ 1. visao do produto
221
+ 2. arquivos \`.sema\`
222
+ 3. arquitetura React + TypeScript
223
+ 4. componentes e telas
224
+ 5. codigo principal
225
+ 6. explicacao de como a UI deriva da semantica da Sema
226
+
227
+ Se houver duvida, siga os exemplos oficiais e mantenha a separacao:
228
+ - Sema governa o significado
229
+ - React governa a apresentacao
231
230
  `;
232
- export const PROMPT_IA_SEMA_PRIMEIRO = `Quero que voce trabalhe no modo "Sema primeiro".
233
-
234
- Regra principal:
235
- - modele primeiro o dominio em arquivos \`.sema\`
236
- - se a intencao mudar, crie, edite ou remova o contrato antes de qualquer acao operacional
237
- - so depois proponha ou gere codigo de aplicacao derivado disso
238
-
239
- Fluxo obrigatorio:
240
- 1. entender o dominio pedido
241
- 2. modelar o contrato em Sema
242
- 3. validar coerencia entre \`task\`, \`route\`, \`state\`, \`flow\`, \`error\`, \`effects\` e \`guarantees\`
243
- 4. so depois gerar TypeScript, Python, React ou outra camada de implementacao
244
-
245
- Nao entregue apenas codigo de interface ou codigo imperativo direto sem antes entregar a camada semantica.
246
-
247
- A modelagem em Sema deve:
248
- - preservar a intencao do dominio
249
- - explicitar entradas, saidas, erros, efeitos e garantias
250
- - usar apenas blocos e sintaxe oficiais
251
- - incluir testes embutidos quando fizer sentido
252
-
253
- Se houver interface grafica:
254
- - entregue a modelagem Sema primeiro
255
- - depois explique como a interface deve refletir a semantica
256
- - se gerar UI, use React + TypeScript em vez de HTML unico solto
257
-
258
- Se houver backend:
259
- - entregue a modelagem Sema primeiro
260
- - depois gere a borda publica e a implementacao derivada
261
-
262
- Nao pule a etapa semantica. A camada \`.sema\` e a ancora principal da solucao.
231
+ export const PROMPT_IA_SEMA_PRIMEIRO = `Quero que voce trabalhe no modo "Sema primeiro".
232
+
233
+ Regra principal:
234
+ - modele primeiro o dominio em arquivos \`.sema\`
235
+ - se a intencao mudar, crie, edite ou remova o contrato antes de qualquer acao operacional
236
+ - so depois proponha ou gere codigo de aplicacao derivado disso
237
+
238
+ Fluxo obrigatorio:
239
+ 1. entender o dominio pedido
240
+ 2. modelar o contrato em Sema
241
+ 3. validar coerencia entre \`task\`, \`route\`, \`state\`, \`flow\`, \`error\`, \`effects\` e \`guarantees\`
242
+ 4. so depois gerar TypeScript, Python, React ou outra camada de implementacao
243
+
244
+ Nao entregue apenas codigo de interface ou codigo imperativo direto sem antes entregar a camada semantica.
245
+
246
+ A modelagem em Sema deve:
247
+ - preservar a intencao do dominio
248
+ - explicitar entradas, saidas, erros, efeitos e garantias
249
+ - usar apenas blocos e sintaxe oficiais
250
+ - incluir testes embutidos quando fizer sentido
251
+
252
+ Se houver interface grafica:
253
+ - entregue a modelagem Sema primeiro
254
+ - depois explique como a interface deve refletir a semantica
255
+ - se gerar UI, use React + TypeScript em vez de HTML unico solto
256
+
257
+ Se houver backend:
258
+ - entregue a modelagem Sema primeiro
259
+ - depois gere a borda publica e a implementacao derivada
260
+
261
+ Nao pule a etapa semantica. A camada \`.sema\` e a ancora principal da solucao.
263
262
  `;
264
- export const EXEMPLOS_PROMPT_IA = `Exemplos de prompt oficial para trabalhar com Sema
265
-
266
- 1. Sema primeiro
267
-
268
- Crie uma solucao seguindo a estrategia "Sema primeiro".
269
- Entregue primeiro os arquivos \`.sema\` do dominio e so depois a implementacao derivada.
270
- Nao entregue apenas codigo imperativo.
271
- Use Sema como fonte de verdade para contratos, estados, erros, efeitos e garantias.
272
-
273
- 2. Sema + React + TypeScript
274
-
275
- Crie um projeto com Sema + React + TypeScript.
276
- Entregue:
277
- - os arquivos \`.sema\` do dominio
278
- - a arquitetura de pastas do frontend
279
- - componentes React que reflitam \`state\`, \`flow\`, \`error\`, \`effects\` e \`guarantees\`
280
- - uma interface elegante e implementavel
281
- - nao entregue HTML solto em arquivo unico
282
-
283
- 3. Revisar ou corrigir um modulo Sema
284
-
285
- Revise e corrija um modulo \`.sema\`.
286
- Antes de editar:
287
- - leia os exemplos oficiais parecidos
288
- - consulte AST e IR
289
- Depois de editar:
290
- - rode \`sema formatar\`
291
- - rode \`sema validar --json\`
292
- - use \`diagnosticos --json\` se houver falha
293
- - feche com \`sema verificar\`
294
-
295
- 4. Caso de UI sem perder a semantica
296
-
297
- Quero uma interface premium para este dominio, mas a solucao deve continuar ancorada em Sema.
298
- Modele primeiro o dominio em \`.sema\`.
299
- Depois proponha uma interface em React + TypeScript que torne visiveis:
300
- - estado
301
- - fluxo
302
- - erros
303
- - efeitos
304
- - garantias
305
- Nao transforme isso em um \`index.html\` solto.
306
-
307
- Comandos uteis da CLI para esse fluxo:
308
- - \`sema starter-ia\`
309
- - \`sema ajuda-ia\`
310
- - \`sema descobrir catalogo --json\`
311
- - \`sema descobrir recomendar --intencao "<objetivo>" --json\`
312
- - \`sema interativo pipelines --json\`
313
- - \`sema resumo <arquivo-ou-pasta>\`
314
- - \`sema prompt-curto <arquivo-ou-pasta>\`
315
- - \`sema prompt-ia\`
316
- - \`sema prompt-ia-ui\`
317
- - \`sema prompt-ia-react\`
318
- - \`sema prompt-ia-sema-primeiro\`
319
- - \`sema contexto-ia <arquivo.sema>\`
263
+ export const EXEMPLOS_PROMPT_IA = `Exemplos de prompt oficial para trabalhar com Sema
264
+
265
+ 1. Sema primeiro
266
+
267
+ Crie uma solucao seguindo a estrategia "Sema primeiro".
268
+ Entregue primeiro os arquivos \`.sema\` do dominio e so depois a implementacao derivada.
269
+ Nao entregue apenas codigo imperativo.
270
+ Use Sema como fonte de verdade para contratos, estados, erros, efeitos e garantias.
271
+
272
+ 2. Sema + React + TypeScript
273
+
274
+ Crie um projeto com Sema + React + TypeScript.
275
+ Entregue:
276
+ - os arquivos \`.sema\` do dominio
277
+ - a arquitetura de pastas do frontend
278
+ - componentes React que reflitam \`state\`, \`flow\`, \`error\`, \`effects\` e \`guarantees\`
279
+ - uma interface elegante e implementavel
280
+ - nao entregue HTML solto em arquivo unico
281
+
282
+ 3. Revisar ou corrigir um modulo Sema
283
+
284
+ Revise e corrija um modulo \`.sema\`.
285
+ Antes de editar:
286
+ - leia os exemplos oficiais parecidos
287
+ - consulte AST e IR
288
+ Depois de editar:
289
+ - rode \`sema formatar\`
290
+ - rode \`sema validar --json\`
291
+ - use \`diagnosticos --json\` se houver falha
292
+ - feche com \`sema verificar\`
293
+
294
+ 4. Caso de UI sem perder a semantica
295
+
296
+ Quero uma interface premium para este dominio, mas a solucao deve continuar ancorada em Sema.
297
+ Modele primeiro o dominio em \`.sema\`.
298
+ Depois proponha uma interface em React + TypeScript que torne visiveis:
299
+ - estado
300
+ - fluxo
301
+ - erros
302
+ - efeitos
303
+ - garantias
304
+ Nao transforme isso em um \`index.html\` solto.
305
+
306
+ Comandos uteis da CLI para esse fluxo:
307
+ - \`sema starter-ia\`
308
+ - \`sema ajuda-ia\`
309
+ - \`sema descobrir catalogo --json\`
310
+ - \`sema descobrir recomendar --intencao "<objetivo>" --json\`
311
+ - \`sema interativo pipelines --json\`
312
+ - \`sema resumo <arquivo-ou-pasta> --drift none\`
313
+ - \`sema prompt-curto <arquivo-ou-pasta>\`
314
+ - \`sema prompt-ia\`
315
+ - \`sema prompt-ia-ui\`
316
+ - \`sema prompt-ia-react\`
317
+ - \`sema prompt-ia-sema-primeiro\`
318
+ - \`sema contexto-ia <arquivo.sema>\`
320
319
  `;
321
320
  //# sourceMappingURL=iaPrompts.js.map