@semacode/cli 2.2.0 → 2.3.1

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 (252) hide show
  1. package/LICENSE +39 -39
  2. package/README.md +251 -141
  3. package/dist/agentContext.d.ts +1 -1
  4. package/dist/agentContextPack.js +6 -1
  5. package/dist/agentContextTipos.d.ts +4 -2
  6. package/dist/agentContextTipos.js +7 -0
  7. package/dist/agentEntryPoints.js +551 -499
  8. package/dist/angular-consumer-standalone.d.ts +3 -1
  9. package/dist/angular-consumer-standalone.js +12 -8
  10. package/dist/comandos.js +4 -0
  11. package/dist/discovery/catalog.d.ts +11 -0
  12. package/dist/discovery/catalog.js +521 -0
  13. package/dist/discovery/command.d.ts +11 -0
  14. package/dist/discovery/command.js +226 -0
  15. package/dist/discovery/index.d.ts +5 -0
  16. package/dist/discovery/index.js +8 -0
  17. package/dist/discovery/ranker.d.ts +3 -0
  18. package/dist/discovery/ranker.js +310 -0
  19. package/dist/discovery/redaction.d.ts +2 -0
  20. package/dist/discovery/redaction.js +21 -0
  21. package/dist/discovery/render.d.ts +2 -0
  22. package/dist/discovery/render.js +100 -0
  23. package/dist/discovery/types.d.ts +119 -0
  24. package/dist/discovery/types.js +13 -0
  25. package/dist/drift.part01.d.ts +32 -2
  26. package/dist/drift.part01.js +2 -0
  27. package/dist/drift.part04.d.ts +3 -2
  28. package/dist/drift.part04.js +6 -3
  29. package/dist/drift.part05.d.ts +2 -1
  30. package/dist/drift.part05.js +4 -3
  31. package/dist/drift.part06.d.ts +2 -1
  32. package/dist/drift.part06.js +9 -5
  33. package/dist/drift.part07.d.ts +11 -10
  34. package/dist/drift.part07.js +40 -30
  35. package/dist/drift.part08.d.ts +2 -1
  36. package/dist/drift.part08.js +4 -3
  37. package/dist/drift.part11.js +71 -6
  38. package/dist/drift.part12.js +14 -1
  39. package/dist/drift.part13.d.ts +42 -7
  40. package/dist/drift.part13.js +660 -36
  41. package/dist/driftCache.d.ts +49 -0
  42. package/dist/driftCache.js +311 -0
  43. package/dist/driftCacheIncremental.d.ts +98 -0
  44. package/dist/driftCacheIncremental.js +596 -0
  45. package/dist/driftCatalogo.d.ts +91 -0
  46. package/dist/driftCatalogo.js +657 -0
  47. package/dist/driftCatalogoPersistente.d.ts +8 -0
  48. package/dist/driftCatalogoPersistente.js +77 -0
  49. package/dist/driftEscopo.d.ts +23 -0
  50. package/dist/driftEscopo.js +563 -0
  51. package/dist/driftEscopoReferencias.d.ts +4 -0
  52. package/dist/driftEscopoReferencias.js +265 -0
  53. package/dist/driftOrcamento.d.ts +12 -0
  54. package/dist/driftOrcamento.js +19 -3
  55. package/dist/execucoesExternas.js +5 -19
  56. package/dist/exemplosOficiais.js +29 -8
  57. package/dist/iaPrompts.d.ts +1 -1
  58. package/dist/iaPrompts.js +310 -307
  59. package/dist/index.d.ts +2 -0
  60. package/dist/index.js +23 -5
  61. package/dist/index.part01.d.ts +17 -2
  62. package/dist/index.part01.js +119 -8
  63. package/dist/index.part02.js +21 -21
  64. package/dist/index.part03.d.ts +2 -2
  65. package/dist/index.part03.js +14 -3
  66. package/dist/index.part04.d.ts +2 -2
  67. package/dist/index.part04.js +113 -101
  68. package/dist/index.part05.d.ts +1 -1
  69. package/dist/index.part05.js +99 -22
  70. package/dist/index.part06.js +6 -2
  71. package/dist/index.part07.js +24 -24
  72. package/dist/index.part08.js +1 -1
  73. package/dist/init/templates.part01.js +393 -393
  74. package/dist/init/templates.part02.js +189 -189
  75. package/dist/initTemplatesBackend.js +73 -73
  76. package/dist/initTemplatesBase.js +81 -80
  77. package/dist/initTemplatesFlutter.js +137 -137
  78. package/dist/initTemplatesRuntime.js +350 -350
  79. package/dist/initTemplatesWeb.js +309 -309
  80. package/dist/pipelineConteudo/command.js +1 -36
  81. package/dist/profileArtefatoValidadores.d.ts +3 -2
  82. package/dist/profileArtefatoValidadores.js +81 -0
  83. package/dist/profileAuthorTipos.d.ts +4 -3
  84. package/dist/profileCatalogo.d.ts +5 -5
  85. package/dist/profileCatalogo.js +30 -0
  86. package/dist/profileCommand.d.ts +8 -2
  87. package/dist/profileCommand.js +15 -5
  88. package/dist/profileRegras.d.ts +5 -5
  89. package/dist/profileRegras.js +13 -1
  90. package/dist/profileRulePacks.js +68 -0
  91. package/dist/projeto.d.ts +1 -1
  92. package/dist/projetoCarregar.d.ts +2 -2
  93. package/dist/projetoCarregar.js +47 -24
  94. package/dist/projetoCatalogo.d.ts +7 -0
  95. package/dist/projetoCatalogo.js +125 -0
  96. package/dist/projetoTipos.d.ts +14 -5
  97. package/dist/sistemasInterativos/adapterProtocol.d.ts +3 -0
  98. package/dist/sistemasInterativos/adapterProtocol.js +240 -0
  99. package/dist/sistemasInterativos/advancedCatalog.d.ts +5 -0
  100. package/dist/sistemasInterativos/advancedCatalog.js +442 -0
  101. package/dist/sistemasInterativos/autonomy.d.ts +230 -0
  102. package/dist/sistemasInterativos/autonomy.js +753 -0
  103. package/dist/sistemasInterativos/canonical.d.ts +3 -0
  104. package/dist/sistemasInterativos/canonical.js +43 -0
  105. package/dist/sistemasInterativos/catalog.d.ts +116 -0
  106. package/dist/sistemasInterativos/catalog.js +543 -0
  107. package/dist/sistemasInterativos/command.d.ts +7 -0
  108. package/dist/sistemasInterativos/command.js +311 -0
  109. package/dist/sistemasInterativos/controlRun.d.ts +56 -0
  110. package/dist/sistemasInterativos/controlRun.js +391 -0
  111. package/dist/sistemasInterativos/evidence.d.ts +5 -0
  112. package/dist/sistemasInterativos/evidence.js +306 -0
  113. package/dist/sistemasInterativos/experienceIr.d.ts +12 -0
  114. package/dist/sistemasInterativos/experienceIr.js +895 -0
  115. package/dist/sistemasInterativos/experienceIrSemantics.d.ts +30 -0
  116. package/dist/sistemasInterativos/experienceIrSemantics.js +368 -0
  117. package/dist/sistemasInterativos/experienceIrTypes.d.ts +370 -0
  118. package/dist/sistemasInterativos/experienceIrTypes.js +5 -0
  119. package/dist/sistemasInterativos/extensionCommand.d.ts +391 -0
  120. package/dist/sistemasInterativos/extensionCommand.js +383 -0
  121. package/dist/sistemasInterativos/index.d.ts +19 -0
  122. package/dist/sistemasInterativos/index.js +22 -0
  123. package/dist/sistemasInterativos/operations.d.ts +40 -0
  124. package/dist/sistemasInterativos/operations.js +1167 -0
  125. package/dist/sistemasInterativos/operationsTypes.d.ts +297 -0
  126. package/dist/sistemasInterativos/operationsTypes.js +11 -0
  127. package/dist/sistemasInterativos/planner.d.ts +2 -0
  128. package/dist/sistemasInterativos/planner.js +159 -0
  129. package/dist/sistemasInterativos/portability.d.ts +164 -0
  130. package/dist/sistemasInterativos/portability.js +539 -0
  131. package/dist/sistemasInterativos/render.d.ts +3 -0
  132. package/dist/sistemasInterativos/render.js +179 -0
  133. package/dist/sistemasInterativos/temporal.d.ts +183 -0
  134. package/dist/sistemasInterativos/temporal.js +543 -0
  135. package/dist/sistemasInterativos/types.d.ts +215 -0
  136. package/dist/sistemasInterativos/types.js +4 -0
  137. package/dist/sistemasInterativos/validator.d.ts +2 -0
  138. package/dist/sistemasInterativos/validator.js +305 -0
  139. package/dist/sync/index.js +35 -35
  140. package/docs/README.md +34 -28
  141. package/docs/ai-onboarding.md +62 -62
  142. package/docs/ai-workflow.md +9 -4
  143. package/docs/auth.md +26 -26
  144. package/docs/cli.md +79 -79
  145. package/docs/commands.md +47 -2
  146. package/docs/database.md +15 -15
  147. package/docs/deploy.md +41 -41
  148. package/docs/descoberta-capacidades.md +106 -0
  149. package/docs/documentation.md +39 -39
  150. package/docs/env.md +16 -16
  151. package/docs/frontend.md +41 -41
  152. package/docs/getting-started.md +57 -57
  153. package/docs/i18n.md +15 -15
  154. package/docs/pipeline-conteudo.md +246 -246
  155. package/docs/profiles.md +54 -45
  156. package/docs/repositories.md +43 -43
  157. package/docs/rollback.md +31 -31
  158. package/docs/security.md +32 -32
  159. package/docs/sistemas-interativos.md +376 -0
  160. package/docs/support.md +8 -8
  161. package/docs/testing.md +51 -35
  162. package/docs/vocabulary.md +29 -29
  163. package/exemplos/agendamento.sema +1 -1
  164. package/exemplos/assinatura.sema +1 -1
  165. package/exemplos/auditoria.sema +1 -1
  166. package/exemplos/autenticacao.sema +1 -1
  167. package/exemplos/author_obra_comum.sema +1 -1
  168. package/exemplos/author_tema_sensivel.sema +1 -1
  169. package/exemplos/automacao.sema +1 -1
  170. package/exemplos/cadastro_usuario.sema +1 -1
  171. package/exemplos/calculadora.sema +1 -1
  172. package/exemplos/crud_simples.sema +1 -1
  173. package/exemplos/estoque.sema +1 -1
  174. package/exemplos/exportacao.sema +1 -1
  175. package/exemplos/fila.sema +1 -1
  176. package/exemplos/integracao_externa.sema +1 -1
  177. package/exemplos/multi_tenant.sema +1 -1
  178. package/exemplos/notificacao.sema +1 -1
  179. package/exemplos/operacao_estrategia.sema +132 -132
  180. package/exemplos/operacao_estrategia_discovery.sema +220 -220
  181. package/exemplos/operacao_estrategia_fluxo.sema +114 -114
  182. package/exemplos/operacao_estrategia_gates.sema +106 -106
  183. package/exemplos/operacao_estrategia_quarentena.sema +133 -133
  184. package/exemplos/operacao_estrategia_rollout.sema +124 -124
  185. package/exemplos/pagamento.sema +1 -1
  186. package/exemplos/pagamento_dominio.sema +1 -1
  187. package/exemplos/pedido.sema +1 -1
  188. package/exemplos/permissao.sema +1 -1
  189. package/exemplos/persistencia_vendor_first.sema +1 -1
  190. package/exemplos/pipeline-conteudo/README.md +44 -44
  191. package/exemplos/pipeline-conteudo/alvos.json +23 -23
  192. package/exemplos/pipeline-conteudo/definicao.json +136 -136
  193. package/exemplos/profile_conversas.sema +165 -165
  194. package/exemplos/profile_game.sema +1 -1
  195. package/exemplos/profile_legal.sema +1 -1
  196. package/exemplos/profile_ops.sema +1 -1
  197. package/exemplos/profile_research.sema +1 -1
  198. package/exemplos/profile_simulation.sema +211 -0
  199. package/exemplos/profile_software.sema +1 -1
  200. package/exemplos/profile_workflow_n8n.sema +1 -1
  201. package/exemplos/relatorio.sema +1 -1
  202. package/exemplos/replica_analitica_erp.sema +1 -1
  203. package/exemplos/sistemas-interativos/README.md +100 -0
  204. package/exemplos/sistemas-interativos/advanced/acceptance-context-evaluate-valid.json +5 -0
  205. package/exemplos/sistemas-interativos/advanced/acceptance-lock-valid.json +16 -0
  206. package/exemplos/sistemas-interativos/advanced/asset-provenance-valid.json +32 -0
  207. package/exemplos/sistemas-interativos/advanced/autonomy-repair-valid.json +93 -0
  208. package/exemplos/sistemas-interativos/advanced/control-run-definition-valid.json +78 -0
  209. package/exemplos/sistemas-interativos/advanced/control-run-valid.json +27 -0
  210. package/exemplos/sistemas-interativos/advanced/distributed-workers-valid.json +79 -0
  211. package/exemplos/sistemas-interativos/advanced/editor-state-valid.json +42 -0
  212. package/exemplos/sistemas-interativos/advanced/engine-snapshot-after-valid.json +32 -0
  213. package/exemplos/sistemas-interativos/advanced/engine-snapshot-before-valid.json +23 -0
  214. package/exemplos/sistemas-interativos/advanced/job-orchestration-valid.json +39 -0
  215. package/exemplos/sistemas-interativos/advanced/multimodal-evidence-valid.json +46 -0
  216. package/exemplos/sistemas-interativos/advanced/multiplayer-authority-valid.json +39 -0
  217. package/exemplos/sistemas-interativos/advanced/playtest-fuzz-valid.json +37 -0
  218. package/exemplos/sistemas-interativos/advanced/portability-valid.json +104 -0
  219. package/exemplos/sistemas-interativos/advanced/temporal-evidence-valid.json +27 -0
  220. package/exemplos/sistemas-interativos/advanced/temporal-valid.json +118 -0
  221. package/exemplos/sistemas-interativos/experience-ir-valid.json +459 -0
  222. package/exemplos/sistemas-interativos/game-2d.json +83 -0
  223. package/exemplos/sistemas-interativos/game-3d-human.json +81 -0
  224. package/exemplos/sistemas-interativos/game-pixel-16-bit.json +97 -0
  225. package/exemplos/sistemas-interativos/game-pixel-8-bit.json +94 -0
  226. package/exemplos/sistemas-interativos/game-xr-human.json +80 -0
  227. package/exemplos/sistemas-interativos/hybrid-2-5d.json +108 -0
  228. package/exemplos/sistemas-interativos/protocol-mutating-rollback-valid.json +75 -0
  229. package/exemplos/sistemas-interativos/protocol-read-only-valid.json +58 -0
  230. package/exemplos/sistemas-interativos/simulation-2d-controlled.json +97 -0
  231. package/exemplos/sistemas-interativos/simulation-3d-calibrated-autonomous.json +141 -0
  232. package/exemplos/sistemas-interativos/simulation-headless-autonomous-batch.json +112 -0
  233. package/exemplos/sistemas-interativos/simulation-pixel-16-bit.json +103 -0
  234. package/exemplos/sistemas-interativos/simulation-text-controlled.json +95 -0
  235. package/exemplos/testes_embutidos.sema +1 -1
  236. package/exemplos/tratamento_erro.sema +1 -1
  237. package/exemplos/upload_arquivo.sema +1 -1
  238. package/exemplos/webhook.sema +1 -1
  239. package/node_modules/@sema/gerador-cpp/dist/index.js +176 -176
  240. package/node_modules/@sema/gerador-cpp/package.json +1 -1
  241. package/node_modules/@sema/gerador-css/dist/index.part01.js +10 -10
  242. package/node_modules/@sema/gerador-css/dist/index.part02.js +460 -460
  243. package/node_modules/@sema/gerador-dotnet/dist/index.js +169 -169
  244. package/node_modules/@sema/gerador-dotnet/package.json +1 -1
  245. package/node_modules/@sema/gerador-html/dist/index.js +17 -17
  246. package/node_modules/@sema/gerador-lua/dist/index.js +76 -47
  247. package/node_modules/@sema/gerador-lua/dist/index.js.map +1 -1
  248. package/node_modules/@sema/gerador-php/dist/index.js +113 -113
  249. package/node_modules/@sema/gerador-python/dist/index.part02.js +3 -3
  250. package/node_modules/@sema/gerador-typescript/dist/index.part02.js +11 -11
  251. package/node_modules/@sema/nucleo/dist/diagnosticos/melhorador.js +42 -42
  252. package/package.json +3 -3
@@ -1,43 +1,43 @@
1
- # Repository Boundary
2
-
3
- The public Sema repository should contain only the Codex-native local CLI, the
4
- first-contact Codex skill, runtime packages, examples, tests that run locally,
5
- and English documentation.
6
-
7
- ## Public
8
-
9
- - local CLI source
10
- - contract parser and validators
11
- - local drift and impact tooling
12
- - local code generators
13
- - examples
14
- - English docs
15
- - local package scripts
16
- - `AGENTS.md` as the official Codex entrypoint
17
- - the official Sema skill as a thin bootstrap before `AGENTS.md` exists
18
- - the repo marketplace that installs that skill explicitly
19
-
20
- ## Not Public
21
-
22
- - private or sensitive operational material
23
- - real credentials, environment files, or secret inventories
24
- - private project data or generated private artifacts
25
- - runtime authorization, activation, billing, credit, token, or panel gates
26
- - product-specific entrypoint files for AI clients other than Codex
27
- - MCP servers, remote workspace bridges, or duplicated governance inside the
28
- bootstrap skill
29
-
30
- The CLI must run directly against the local workspace without login, user
31
- authorization, a product-license check, activation key, credits, token, billing
32
- service, or control panel.
33
-
34
- Sema is an independent product and is not affiliated with or endorsed by
35
- OpenAI. Codex-native is Sema's official product direction, not an official
36
- OpenAI program or submission.
37
-
38
- ## Commercial Use
39
-
40
- The public Sema source may not be copied, rebranded, bundled, or replicated for
41
- commercial resale without written permission from OtimiTare.
42
-
43
- Support: suporte@otimitare.online
1
+ # Repository Boundary
2
+
3
+ The public Sema repository should contain only the Codex-native local CLI, the
4
+ first-contact Codex skill, runtime packages, examples, tests that run locally,
5
+ and English documentation.
6
+
7
+ ## Public
8
+
9
+ - local CLI source
10
+ - contract parser and validators
11
+ - local drift and impact tooling
12
+ - local code generators
13
+ - examples
14
+ - English docs
15
+ - local package scripts
16
+ - `AGENTS.md` as the official Codex entrypoint
17
+ - the official Sema skill as a thin bootstrap before `AGENTS.md` exists
18
+ - the repo marketplace that installs that skill explicitly
19
+
20
+ ## Not Public
21
+
22
+ - private or sensitive operational material
23
+ - real credentials, environment files, or secret inventories
24
+ - private project data or generated private artifacts
25
+ - runtime authorization, activation, billing, credit, token, or panel gates
26
+ - product-specific entrypoint files for AI clients other than Codex
27
+ - MCP servers, remote workspace bridges, or duplicated governance inside the
28
+ bootstrap skill
29
+
30
+ The CLI must run directly against the local workspace without login, user
31
+ authorization, a product-license check, activation key, credits, token, billing
32
+ service, or control panel.
33
+
34
+ Sema is an independent product and is not affiliated with or endorsed by
35
+ OpenAI. Codex-native is Sema's official product direction, not an official
36
+ OpenAI program or submission.
37
+
38
+ ## Commercial Use
39
+
40
+ The public Sema source may not be copied, rebranded, bundled, or replicated for
41
+ commercial resale without written permission from OtimiTare.
42
+
43
+ Support: suporte@otimitare.online
package/docs/rollback.md CHANGED
@@ -1,31 +1,31 @@
1
- # Rollback Boundary
2
-
3
- Public rollback covers both the npm CLI and the separately installed Codex
4
- bootstrap skill.
5
-
6
- For a failed pre-publication candidate:
7
-
8
- 1. Keep the previous tarball until the new one passes smoke tests.
9
- 2. Revert the plugin source, marketplace manifest, CLI source, and versions to
10
- the last known-good commit.
11
- 3. Re-run `npm run release:preparar-publica`.
12
-
13
- If a bad commit was already pushed, revert it with a normal Git revert and push
14
- the corrective commit. Refresh the marketplace and reinstall the skill:
15
-
16
- ```bash
17
- codex plugin marketplace upgrade sema
18
- codex plugin remove sema@sema
19
- codex plugin add sema@sema
20
- ```
21
-
22
- Open a new Codex task before validating the reinstalled skill. Already-open
23
- tasks keep the plugin/skill catalog they started with.
24
-
25
- If a bad npm version was published, do not overwrite it. Publish a corrected
26
- version and direct users to that version. Verify the final registry/GitHub state
27
- with `npm run release:verificar-distribuicao`. Do not create a GitHub Release or
28
- asset as a rollback shortcut while the release contract blocks that surface.
29
-
30
- Do not publish private or sensitive operational rollback material in this
31
- repository.
1
+ # Rollback Boundary
2
+
3
+ Public rollback covers both the npm CLI and the separately installed Codex
4
+ bootstrap skill.
5
+
6
+ For a failed pre-publication candidate:
7
+
8
+ 1. Keep the previous tarball until the new one passes smoke tests.
9
+ 2. Revert the plugin source, marketplace manifest, CLI source, and versions to
10
+ the last known-good commit.
11
+ 3. Re-run `npm run release:preparar-publica`.
12
+
13
+ If a bad commit was already pushed, revert it with a normal Git revert and push
14
+ the corrective commit. Refresh the marketplace and reinstall the skill:
15
+
16
+ ```bash
17
+ codex plugin marketplace upgrade sema
18
+ codex plugin remove sema@sema
19
+ codex plugin add sema@sema
20
+ ```
21
+
22
+ Open a new Codex task before validating the reinstalled skill. Already-open
23
+ tasks keep the plugin/skill catalog they started with.
24
+
25
+ If a bad npm version was published, do not overwrite it. Publish a corrected
26
+ version and direct users to that version. Verify the final registry/GitHub state
27
+ with `npm run release:verificar-distribuicao`. Do not create a GitHub Release or
28
+ asset as a rollback shortcut while the release contract blocks that surface.
29
+
30
+ Do not publish private or sensitive operational rollback material in this
31
+ repository.
package/docs/security.md CHANGED
@@ -1,32 +1,32 @@
1
- # Security
2
-
3
- The public Sema repository must not contain private or sensitive operational
4
- material.
5
-
6
- Local Sema execution does not need a credential, login, activation key, license
7
- token, billing token, or control-panel session. Do not introduce one as a
8
- condition for reading or governing a local workspace.
9
-
10
- The official Codex bootstrap skill contains instructions only. It must not
11
- bundle an MCP server, app connector, remote workspace bridge, credential flow,
12
- or a second copy of the repository governance that belongs in `AGENTS.md`.
13
-
14
- Do not publish:
15
-
16
- - real credentials or secret material;
17
- - private data or internal operational artifacts.
18
-
19
- Placeholder examples are allowed:
20
-
21
- ```bash
22
- EXAMPLE_KEY=replace-me
23
- ```
24
-
25
- If a real credential is exposed in code, docs, logs, screenshots, packages, or
26
- Git history:
27
-
28
- 1. Rotate it immediately.
29
- 2. Remove it from the affected artifact.
30
- 3. Rebuild and rescan before publishing.
31
-
32
- Official support: suporte@otimitare.online
1
+ # Security
2
+
3
+ The public Sema repository must not contain private or sensitive operational
4
+ material.
5
+
6
+ Local Sema execution does not need a credential, login, activation key, license
7
+ token, billing token, or control-panel session. Do not introduce one as a
8
+ condition for reading or governing a local workspace.
9
+
10
+ The official Codex bootstrap skill contains instructions only. It must not
11
+ bundle an MCP server, app connector, remote workspace bridge, credential flow,
12
+ or a second copy of the repository governance that belongs in `AGENTS.md`.
13
+
14
+ Do not publish:
15
+
16
+ - real credentials or secret material;
17
+ - private data or internal operational artifacts.
18
+
19
+ Placeholder examples are allowed:
20
+
21
+ ```bash
22
+ EXAMPLE_KEY=replace-me
23
+ ```
24
+
25
+ If a real credential is exposed in code, docs, logs, screenshots, packages, or
26
+ Git history:
27
+
28
+ 1. Rotate it immediately.
29
+ 2. Remove it from the affected artifact.
30
+ 3. Rebuild and rescan before publishing.
31
+
32
+ Official support: suporte@otimitare.online
@@ -0,0 +1,376 @@
1
+ # AI-native Interactive Systems
2
+
3
+ Sema Interactive is the declarative control plane for games, simulations, and
4
+ hybrid interactive systems. The same core covers 3D, 2.5D, 2D, text, retro
5
+ 8/16-bit presentation, XR, and headless execution.
6
+
7
+ It does not embed a game engine or silently control an editor. Sema validates
8
+ definitions, calculates required capabilities, selects compatible external
9
+ adapter descriptors, expands pipelines into evidence-bearing stages, and
10
+ derives non-authoritative local results. An explicitly integrated external
11
+ runner must perform any engine, editor, plug-in, build, verifier, or worker
12
+ operation.
13
+
14
+ The public CLI is a read-only control plane. It does **not** detect, probe,
15
+ launch, install, or control Unreal, Unity, Godot, Blender, PICO-8, TIC-80,
16
+ LÖVE, a browser runtime, a custom engine, a plug-in, or a distributed worker.
17
+ Catalog presence means only that a descriptor exists; it is not runtime
18
+ availability evidence.
19
+
20
+ ## The dimensions are independent
21
+
22
+ An interactive definition separates concerns that are often incorrectly mixed:
23
+
24
+ | Axis | Examples |
25
+ | --- | --- |
26
+ | Kind | `GAME`, `SIMULATION`, `HYBRID` |
27
+ | Spatial model | `NON_SPATIAL`, `TWO_D`, `TWO_POINT_FIVE_D`, `THREE_D` |
28
+ | Render mode | `HEADLESS`, `TEXT`, `VISUAL`, `XR` |
29
+ | Visual profile | `NONE`, `PIXEL_8_BIT`, `PIXEL_16_BIT`, `RASTER`, `VECTOR`, `STYLIZED`, `REALISTIC` |
30
+ | Fidelity | `ARCADE`, `STYLIZED`, `SYSTEMIC`, `REALISTIC`, `CALIBRATED` |
31
+ | Control | human, scripted, AI, hybrid, autonomous, or uncontrolled/emergent |
32
+ | Time | fixed step, variable step, turn based, event driven, or accelerated |
33
+ | Determinism | strict, seeded, best effort, or stochastic |
34
+
35
+ `PIXEL_8_BIT` and `PIXEL_16_BIT` are visual/technical profiles, not spatial
36
+ dimensions or lesser product classes. A 16-bit economic simulation and a 3D
37
+ flight simulation use the same world/state/time/evidence core with different
38
+ budgets and adapters.
39
+
40
+ ## Core commands
41
+
42
+ ```bash
43
+ sema interativo capabilities --json
44
+ sema interativo schema --json
45
+ sema interativo pipelines --json
46
+ sema interativo adapters --spatial-model TWO_D --render-mode VISUAL --json
47
+ sema interativo validar exemplos/sistemas-interativos/game-pixel-16-bit.json --json
48
+ sema interativo planejar exemplos/sistemas-interativos/game-pixel-16-bit.json --json
49
+ sema interativo validar-evidencias <definition.json> [--plano-arquivo <plan.json>] --bundle-arquivo <bundle.json> --json
50
+ sema interativo status <definition.json> [--plano-arquivo <plan.json>] --bundle-arquivo <bundle.json> --json
51
+ sema interativo validar-protocolo <adapter-run.json> --json
52
+ ```
53
+
54
+ Every command above is local and declarative. Responses report
55
+ `executed: false` and `workspaceMutated: false`. The CLI does not open an
56
+ engine, editor, browser runtime, or custom simulator.
57
+
58
+ `--evidencias-arquivo` is accepted as an alias for `--bundle-arquivo`. When
59
+ `--plano-arquivo` is omitted, the CLI recomputes the deterministic plan and
60
+ still rejects any bundle whose definition or plan digest does not match.
61
+
62
+ `schema` is the stable, read-only machine contract for definition generation.
63
+ It exposes required fields, supported enum values, cross-field constraints,
64
+ the capability matrix, and canonical example paths. Its advanced command map
65
+ links every positional/option surface to input and output schemas; each data
66
+ schema exposes required top-level fields and official fixtures. Each subcommand
67
+ has an explicit argument allowlist: unknown flags, duplicate semantic flags,
68
+ missing values, and invalid enum values fail closed instead of producing an
69
+ empty successful result.
70
+
71
+ ## Advanced read-only commands
72
+
73
+ The advanced command surface exposes the same pure validators and planners to
74
+ AI agents. File-based commands read JSON, every command returns structured JSON,
75
+ and engine, editor, process, plug-in, and worker inspection remains an external
76
+ integration responsibility.
77
+
78
+ Experience IR:
79
+
80
+ ```bash
81
+ sema interativo validar-ir <experience-ir.json> --json
82
+ sema interativo indexar-ir <experience-ir.json> --json
83
+ sema interativo consultar-ir <experience-ir.json> --semantic-id <id> --json
84
+ sema interativo chunk-ir <experience-ir.json> --semantic-id <id> [--raso] --json
85
+ sema interativo descrever-ir --json
86
+ ```
87
+
88
+ Operational snapshots, provenance, jobs, acceptance, and multimodal evidence:
89
+
90
+ ```bash
91
+ sema interativo validar-engine-snapshot <snapshot.json> --json
92
+ sema interativo diff-engine-snapshots <before.json> <after.json> --json
93
+ sema interativo validar-asset-provenance <provenance.json> --json
94
+ sema interativo validar-editor-state <editor-state.json> --json
95
+ sema interativo planejar-jobs <jobs.json> --json
96
+ sema interativo validar-acceptance <acceptance-lock.json> --json
97
+ sema interativo operar-acceptance <acceptance-lock.json> --operation <VALIDATE|EVALUATE|INVALIDATE> --context-file <context.json> --json
98
+ sema interativo validar-multimodal <evidence.json> --json
99
+ ```
100
+
101
+ Time, autonomy, portability, and distributed work:
102
+
103
+ ```bash
104
+ sema interativo validar-temporal <temporal-contract.json> --json
105
+ sema interativo validar-evidencia-temporal <temporal-contract.json> --bundle-arquivo <temporal-evidence.json> --json
106
+ sema interativo validar-autonomia <repair-cycle.json> --json
107
+ sema interativo validar-playtest-fuzz <playtest-fuzz.json> --json
108
+ sema interativo validar-multiplayer <authority-model.json> --json
109
+ sema interativo analisar-portabilidade <portability-plan.json> --json
110
+ sema interativo validar-workers <distributed-jobs.json> --json
111
+ ```
112
+
113
+ These commands validate descriptions and derive plans, diffs, indexes, queries,
114
+ chunks, eligibility, or assignments. They do not perform the described work.
115
+
116
+ `sema interativo schema --json` publishes distinct input and output shapes for
117
+ all 20 extension commands. The advertised multimodal input includes claim and
118
+ producer/verifier bindings; autonomy includes cycle and acceptance-lock fields;
119
+ and `jobOrchestrationPlan` exposes `requestDigest`, `planDigest`, and an ordered
120
+ `queue` whose entries are the declared job assignments. Result shapes are
121
+ checked against the official fixtures, and every command publishes
122
+ `outputTargets` path segments from the payload root, so an agent never has to
123
+ reuse an input shape or guess where a validator's output lives.
124
+
125
+ ## Bound control runs
126
+
127
+ `validar-control-run` is the fail-closed bridge from a planned pipeline to one
128
+ specific advanced validator invocation. It binds a strict manifest to the
129
+ definition digest, recomputed canonical plan, selected pipeline descriptor,
130
+ validation contract, schema-declared input digests, evidence, producer and
131
+ verifier identity, and the exact validator result. The CLI reruns the selected
132
+ pure validator and rejects a result, contract, input, evidence, or pipeline
133
+ borrowed from another run.
134
+
135
+ ```bash
136
+ sema interativo validar-control-run <control-run.json> \
137
+ --definition-arquivo <definition.json> \
138
+ --plano-arquivo <plan.json> \
139
+ --contrato-arquivo <validation-contract.json> \
140
+ --entrada-arquivo <input.json> \
141
+ [--entrada-auxiliar-arquivo <supporting-input.json>] \
142
+ --evidencia-arquivo <evidence.json> \
143
+ --resultado-arquivo <result.json> \
144
+ --json
145
+ ```
146
+
147
+ This proves deterministic local binding only. A valid control run still returns
148
+ `completed: false`, `authoritative: false`, and
149
+ `awaitingExternalAttestation: true`; it does not prove that an engine, editor,
150
+ worker, verifier, or external adapter actually ran.
151
+
152
+ ## Experience IR
153
+
154
+ Experience IR is the engine-neutral semantic substrate below the advanced
155
+ pipelines. Version `sema.experience-ir/v1` models 20 kinds of project, world,
156
+ scene, entity, component, transform, camera, light, material, texture, audio,
157
+ physics, constraint, animation, VFX, timeline, input, save, network, and build
158
+ objects. Stable semantic IDs and explicit references make the graph queryable
159
+ without relying on engine-specific object paths.
160
+
161
+ The v1 kind set remains unchanged. Eight engine-neutral concepts use optional,
162
+ typed semantic roles in their natural containers, so existing v1 documents
163
+ remain valid while newer documents can expose the concepts explicitly:
164
+
165
+ | Semantic role | Typed v1 representation |
166
+ | --- | --- |
167
+ | `LEVEL` | `SCENE.semanticRole` |
168
+ | `PIVOT` | `TRANSFORM.semanticRole` |
169
+ | `COLLIDER` | `PHYSICS.colliders[]` |
170
+ | `EMITTER` | `VFX.emitters[]` |
171
+ | `TRACK` | `TIMELINE.tracks[].semanticRole` |
172
+ | `CLIP` | `TIMELINE.tracks[].clips[]` |
173
+ | `EVENT` | `TIMELINE.tracks[].events[]` |
174
+ | `GAME_STATE` | `SAVE.semanticRole` |
175
+
176
+ `descrever-ir` publishes this mapping as
177
+ `sema.experience-ir.semantic-roles/v1`. Index and chunk entries expose their
178
+ canonical `semanticRoles`, while node `kind` remains one of the original 20.
179
+ Typed clips participate in reference validation and dependency closure.
180
+
181
+ The IR declares units and coordinate systems, records asset provenance, and
182
+ uses content-addressed digests for deterministic indexing and chunking. JSON is
183
+ the native canonical serialization. CBOR is an explicitly external codec path;
184
+ the CLI does not pretend to encode it. Indexing, lookup, and dependency-aware
185
+ chunks are in-memory read-only operations. They do not import assets, convert a
186
+ project, materialize a scene, or execute a build.
187
+
188
+ Validation also rejects sensitive values under neutral keys, including private
189
+ keys, Bearer credentials, and common `sk`, `ghp`, or `github_pat` token forms,
190
+ as well as credential-bearing URI queries such as `access_token`, `api_key`,
191
+ `signature`, or `X-Amz-*`, without echoing the value or caller-controlled key
192
+ path. Entity and transform
193
+ parent graphs must be acyclic. Network nodes apply cross-field policy:
194
+ `OFFLINE` means `NONE`, no replicated IDs, and tick zero; `CLIENT_SERVER`
195
+ requires `SERVER`; `PEER_TO_PEER` accepts `OWNER` or `DISTRIBUTED`; and
196
+ `LOCKSTEP` requires `DISTRIBUTED`. Every online mode requires declared
197
+ replication and a positive integer tick rate.
198
+
199
+ ## P0, P1, and P2 coverage
200
+
201
+ The advanced surface is grouped by operational responsibility, not rendering
202
+ style:
203
+
204
+ | Priority | Covered responsibilities |
205
+ | --- | --- |
206
+ | P0 — represent and observe | Experience IR; semantic engine snapshots and diffs; asset origin, license, hashes, transforms, and derivatives; editor-state descriptors; multimodal evidence descriptors; job budgets, locks, heartbeats, checkpoints, resume tokens, and recovery; artifact/time-bound acceptance locks. |
207
+ | P1 — validate behavior over time | 4D phases, tracks, clips, and invariants; shots and camera visibility; collision, attachment, and separation relations; flicker, ghosting, popping, exposure, and jitter QA; materialization, clean-install, launch, and smoke-playtest requirements; target hardware budgets. |
208
+ | P2 — diagnose, scale, and migrate | `diagnose -> propose -> simulate -> prove` repair cycles with safe rollback; bounded bots, fuzzing, and save/load recovery; explicit multiplayer authority and reconnect rules; versioned engine migration and cross-engine portability with declared losses; distributed worker DAGs with capabilities, leases, budgets, and checkpoints. |
209
+
210
+ All three groups apply to 3D, 2.5D, 2D, 8-bit, 16-bit, text, XR, and headless
211
+ games or simulations. A visual profile changes constraints and evidence needs;
212
+ it does not switch to a weaker governance model.
213
+
214
+ ## Canonical pipelines
215
+
216
+ The canonical catalog exposes **35 unique pipelines** and **28 unique external
217
+ adapter descriptors**. Pipelines are reusable goals rather than one workflow
218
+ per rendering style.
219
+
220
+ Core pipelines:
221
+
222
+ - `interactive.prototype`
223
+ - `interactive.playtest`
224
+ - `interactive.package`
225
+ - `interactive.release`
226
+ - `interactive.replay`
227
+ - `interactive.calibrate`
228
+ - `interactive.safety`
229
+ - `game.balance`
230
+ - `game.progression`
231
+ - `game.multiplayer`
232
+ - `simulation.scenario`
233
+ - `simulation.batch_run`
234
+ - `simulation.calibrate`
235
+ - `simulation.validate`
236
+ - `simulation.safety`
237
+
238
+ P0/P1/P2 pipelines:
239
+
240
+ - `interactive.experience_ir`
241
+ - `interactive.observe`
242
+ - `interactive.asset_provenance`
243
+ - `interactive.editor_state`
244
+ - `interactive.evidence_capture`
245
+ - `interactive.job_recovery`
246
+ - `interactive.acceptance_lock`
247
+ - `interactive.temporal_validate`
248
+ - `interactive.shot_validate`
249
+ - `interactive.physics_validate`
250
+ - `interactive.temporal_qa`
251
+ - `interactive.clean_install_smoke`
252
+ - `interactive.hardware_budget`
253
+ - `interactive.autonomous_repair`
254
+ - `interactive.bot_playtest`
255
+ - `interactive.state_fuzz`
256
+ - `interactive.multiplayer_authority`
257
+ - `interactive.engine_migration`
258
+ - `interactive.portability`
259
+ - `interactive.distributed_jobs`
260
+
261
+ Spatial model, render mode, and visual profile influence capabilities, budgets,
262
+ evidence, and adapter compatibility. They do not decide the workflow goal.
263
+ `THREE_D + HEADLESS` is therefore valid, while `XR` requires `THREE_D`.
264
+
265
+ ## Adapter boundary
266
+
267
+ Adapter descriptors represent runtime, editor, asset, build, telemetry,
268
+ observation, IR, autonomy, portability, or distributed-job capabilities. They
269
+ describe compatibility; they do not prove that an engine, editor, plug-in, or
270
+ worker is installed, reachable, or running.
271
+
272
+ The protocol model uses a read-only observation prefix:
273
+
274
+ ```text
275
+ DETECT -> PROBE -> SNAPSHOT -> PLAN
276
+ ```
277
+
278
+ Those names describe phases that an external adapter must implement; the local
279
+ CLI does not perform `DETECT` or `PROBE`. Read-only adapters continue with
280
+ `VALIDATE -> EVIDENCE`. Mutating adapters add `APPLY` and must support
281
+ `ROLLBACK`:
282
+
283
+ ```text
284
+ DETECT -> PROBE -> SNAPSHOT -> PLAN -> APPLY -> VALIDATE -> EVIDENCE
285
+ \-> ROLLBACK on failure
286
+ ```
287
+
288
+ Stable semantic target IDs bind every phase. A failed external mutation without
289
+ rollback evidence is a blocking result.
290
+
291
+ The descriptor catalog includes general targets for Unreal, Unity, Godot,
292
+ Blender, web canvas, LÖVE, PICO-8, TIC-80, headless runtimes, simulation
293
+ runners, validators, telemetry, assets, builds, operational observers, IR,
294
+ autonomy, portability, and distributed jobs. These are compatibility
295
+ descriptors, not bundled integrations, probes, detections, or installation
296
+ claims.
297
+
298
+ Planning is provider-aware. `adapterTargets` is an explicit composition, not a
299
+ decorative preference: every expanded stage capability must be supplied by at
300
+ least one selected compatible descriptor. An empty or partial selection
301
+ produces a blocked plan with deterministic candidate and
302
+ recommended-composition output. A telemetry descriptor cannot stand in for an
303
+ executor, and a generic headless descriptor cannot claim packaging capabilities
304
+ it does not declare.
305
+
306
+ ## Evidence and operational truth
307
+
308
+ Pipeline stages declare exact evidence types. Examples include runtime boot,
309
+ first input, loop completion, failure state, deterministic replay, calibration,
310
+ tolerance comparison, package creation, packaged launch, smoke execution, and
311
+ rollback observation.
312
+
313
+ Compilation does not prove playability. Opening an editor does not prove a
314
+ simulation is valid. An editor playtest does not prove a packaged build. A
315
+ runner saying “success” does not replace observed evidence.
316
+
317
+ The portable evidence bundle in v1 is explicitly non-authoritative. It
318
+ validates binding, digests, stage coverage, stable IDs, non-empty observation
319
+ data, and the producing adapter ID/version against the selected provider for
320
+ each stage. High-assurance environments must additionally provide signed
321
+ envelopes, quorum, anti-replay state, and externally retained checkpoints
322
+ through an appropriate trust/ledger layer. Sema does not label a local JSON file
323
+ as a strong trust boundary.
324
+
325
+ When all local structural checks and supplied observation records pass, status
326
+ is `STRUCTURALLY_COMPLETE`. This is **not authoritative completion**. It means
327
+ only that local structural coverage is complete; it deliberately keeps
328
+ `completed: false`, `authoritative: false`, and
329
+ `awaitingExternalAttestation: true`. It does not prove that an engine ran, an
330
+ editor was inspected, a plug-in existed, a worker accepted a job, a package
331
+ launched, or an external observer attested the result.
332
+
333
+ ## Semantic budget split plan
334
+
335
+ The current operational facade remains compatible, but two governed artifacts
336
+ have crossed the planning threshold: `operations.ts` has 1,112 lines and
337
+ `sistemas_interativos_operacao.sema` has 304 lines. Before either reaches its
338
+ blocking limit, split by responsibility as follows:
339
+
340
+ - move engine snapshots, semantic diffs, asset provenance, and editor-state
341
+ observation into `engineObservation.ts`;
342
+ - move queues, locks, budgets, leases, checkpoints, and recovery planning into
343
+ `jobOrchestration.ts`;
344
+ - move acceptance locks, invalidation, and multimodal claim evidence into
345
+ `acceptanceEvidence.ts`;
346
+ - keep `operations.ts` as the stable re-export facade while callers migrate;
347
+ - split the contract into `sistemas_interativos_observacao_engine.sema`,
348
+ `sistemas_interativos_orquestracao_jobs.sema`, and
349
+ `sistemas_interativos_acceptance_evidencias.sema`, with all three contracts
350
+ linked to the shared facade and their actual implementation files.
351
+
352
+ This is a responsibility split, not a numbered-file workaround. Existing
353
+ exports, schema versions, fixtures, digests, and fail-closed behavior must remain
354
+ backward compatible through the migration.
355
+
356
+ ## Fidelity rules
357
+
358
+ Visual realism and model validity are separate. A `REALISTIC` or `CALIBRATED`
359
+ simulation must declare reference data, units, calibration method, tolerances,
360
+ uncertainty, and telemetry. A photorealistic scene without those items is only
361
+ photorealistic, not a validated simulation.
362
+
363
+ Strict or seeded determinism requires a seed, snapshots, event log, reproducible
364
+ step model, and replay result digest. Autonomous or uncontrolled systems require
365
+ stopping criteria, boundaries, and safety evidence.
366
+
367
+ ## Examples
368
+
369
+ The fixtures under `exemplos/sistemas-interativos/` deliberately cover opposing
370
+ cases: human-controlled retro games, 2D simulations, 3D calibrated simulations,
371
+ and autonomous headless batch execution. The `advanced/` fixtures mirror the
372
+ public schemas for IR-adjacent operations, temporal validation, autonomy,
373
+ multiplayer authority, portability, distributed jobs, and fully bound control
374
+ runs. They are synthetic validation inputs, not captured runtime evidence. The coverage matrix proves
375
+ that kind, spatial model, render mode, visual profile, control, fidelity, and
376
+ runtime are composable rather than hardcoded around one showcase project.
package/docs/support.md CHANGED
@@ -1,8 +1,8 @@
1
- # Support
2
-
3
- Official Sema support email: suporte@otimitare.online
4
-
5
- OtimiTare website: https://otimitare.online
6
-
7
- Do not publish private or sensitive support routing material in the public Sema
8
- repository.
1
+ # Support
2
+
3
+ Official Sema support email: suporte@otimitare.online
4
+
5
+ OtimiTare website: https://otimitare.online
6
+
7
+ Do not publish private or sensitive support routing material in the public Sema
8
+ repository.