@semacode/cli 2.0.1 → 2.2.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 (134) hide show
  1. package/LICENSE +39 -39
  2. package/README.md +141 -121
  3. package/dist/agentEntryPoints.js +499 -499
  4. package/dist/comandos.js +2 -0
  5. package/dist/doctorCommand.js +28 -0
  6. package/dist/execucoesExternas.js +19 -5
  7. package/dist/geracaoCore.js +97 -1
  8. package/dist/iaPrompts.d.ts +1 -1
  9. package/dist/iaPrompts.js +307 -307
  10. package/dist/index.d.ts +1 -0
  11. package/dist/index.js +1 -0
  12. package/dist/index.part01.d.ts +1 -1
  13. package/dist/index.part01.js +14 -4
  14. package/dist/index.part02.js +21 -21
  15. package/dist/index.part04.js +96 -96
  16. package/dist/index.part06.js +1 -1
  17. package/dist/index.part07.js +35 -24
  18. package/dist/init/templates.part01.js +393 -393
  19. package/dist/init/templates.part02.js +189 -189
  20. package/dist/initTemplatesBackend.js +73 -73
  21. package/dist/initTemplatesBase.js +81 -81
  22. package/dist/initTemplatesFlutter.js +137 -137
  23. package/dist/initTemplatesRuntime.js +350 -350
  24. package/dist/initTemplatesWeb.js +309 -309
  25. package/dist/nativeToolchains.d.ts +15 -0
  26. package/dist/nativeToolchains.js +132 -0
  27. package/dist/pipelineConteudo/adapters.d.ts +84 -0
  28. package/dist/pipelineConteudo/adapters.js +449 -0
  29. package/dist/pipelineConteudo/canonical.d.ts +18 -0
  30. package/dist/pipelineConteudo/canonical.js +107 -0
  31. package/dist/pipelineConteudo/command.d.ts +3 -0
  32. package/dist/pipelineConteudo/command.js +572 -0
  33. package/dist/pipelineConteudo/index.d.ts +9 -0
  34. package/dist/pipelineConteudo/index.js +12 -0
  35. package/dist/pipelineConteudo/ledger.d.ts +68 -0
  36. package/dist/pipelineConteudo/ledger.js +732 -0
  37. package/dist/pipelineConteudo/planner.d.ts +12 -0
  38. package/dist/pipelineConteudo/planner.js +366 -0
  39. package/dist/pipelineConteudo/projection.d.ts +16 -0
  40. package/dist/pipelineConteudo/projection.js +57 -0
  41. package/dist/pipelineConteudo/state.d.ts +23 -0
  42. package/dist/pipelineConteudo/state.js +615 -0
  43. package/dist/pipelineConteudo/trust.d.ts +17 -0
  44. package/dist/pipelineConteudo/trust.js +750 -0
  45. package/dist/pipelineConteudo/types.d.ts +331 -0
  46. package/dist/pipelineConteudo/types.js +4 -0
  47. package/dist/projetoConfig.js +7 -1
  48. package/dist/projetoResolucao.js +21 -6
  49. package/dist/sync/index.js +35 -35
  50. package/docs/README.md +28 -25
  51. package/docs/ai-onboarding.md +62 -62
  52. package/docs/ai-workflow.md +1 -1
  53. package/docs/auth.md +26 -26
  54. package/docs/cli.md +79 -72
  55. package/docs/commands.md +1 -1
  56. package/docs/database.md +15 -15
  57. package/docs/deploy.md +41 -36
  58. package/docs/documentation.md +39 -39
  59. package/docs/env.md +16 -16
  60. package/docs/frontend.md +41 -41
  61. package/docs/getting-started.md +57 -57
  62. package/docs/i18n.md +15 -15
  63. package/docs/pipeline-conteudo.md +246 -0
  64. package/docs/profiles.md +45 -43
  65. package/docs/repositories.md +43 -43
  66. package/docs/rollback.md +31 -31
  67. package/docs/security.md +32 -32
  68. package/docs/support.md +8 -8
  69. package/docs/syntax.md +1 -1
  70. package/docs/testing.md +35 -28
  71. package/docs/vocabulary.md +29 -29
  72. package/exemplos/agendamento.sema +1 -1
  73. package/exemplos/assinatura.sema +1 -1
  74. package/exemplos/auditoria.sema +1 -1
  75. package/exemplos/autenticacao.sema +1 -1
  76. package/exemplos/author_obra_comum.sema +1 -1
  77. package/exemplos/author_tema_sensivel.sema +1 -1
  78. package/exemplos/automacao.sema +1 -1
  79. package/exemplos/cadastro_usuario.sema +1 -1
  80. package/exemplos/calculadora.sema +1 -1
  81. package/exemplos/crud_simples.sema +1 -1
  82. package/exemplos/estoque.sema +1 -1
  83. package/exemplos/exportacao.sema +1 -1
  84. package/exemplos/fila.sema +1 -1
  85. package/exemplos/integracao_externa.sema +1 -1
  86. package/exemplos/multi_tenant.sema +1 -1
  87. package/exemplos/notificacao.sema +1 -1
  88. package/exemplos/operacao_estrategia.sema +132 -132
  89. package/exemplos/operacao_estrategia_discovery.sema +220 -220
  90. package/exemplos/operacao_estrategia_fluxo.sema +114 -114
  91. package/exemplos/operacao_estrategia_gates.sema +106 -106
  92. package/exemplos/operacao_estrategia_quarentena.sema +133 -133
  93. package/exemplos/operacao_estrategia_rollout.sema +124 -124
  94. package/exemplos/pagamento.sema +1 -1
  95. package/exemplos/pagamento_dominio.sema +1 -1
  96. package/exemplos/pedido.sema +1 -1
  97. package/exemplos/permissao.sema +1 -1
  98. package/exemplos/persistencia_vendor_first.sema +1 -1
  99. package/exemplos/pipeline-conteudo/README.md +44 -0
  100. package/exemplos/pipeline-conteudo/alvos.json +23 -0
  101. package/exemplos/pipeline-conteudo/definicao.json +136 -0
  102. package/exemplos/profile_conversas.sema +165 -165
  103. package/exemplos/profile_game.sema +1 -1
  104. package/exemplos/profile_legal.sema +1 -1
  105. package/exemplos/profile_ops.sema +1 -1
  106. package/exemplos/profile_research.sema +1 -1
  107. package/exemplos/profile_software.sema +1 -1
  108. package/exemplos/profile_workflow_n8n.sema +1 -1
  109. package/exemplos/relatorio.sema +1 -1
  110. package/exemplos/replica_analitica_erp.sema +1 -1
  111. package/exemplos/testes_embutidos.sema +1 -1
  112. package/exemplos/tratamento_erro.sema +1 -1
  113. package/exemplos/upload_arquivo.sema +1 -1
  114. package/exemplos/webhook.sema +1 -1
  115. package/node_modules/@sema/gerador-cpp/dist/index.d.ts +3 -0
  116. package/node_modules/@sema/gerador-cpp/dist/index.js +859 -0
  117. package/node_modules/@sema/gerador-cpp/dist/index.js.map +1 -0
  118. package/node_modules/@sema/gerador-cpp/package.json +7 -0
  119. package/node_modules/@sema/gerador-css/dist/index.part01.js +10 -10
  120. package/node_modules/@sema/gerador-css/dist/index.part02.js +460 -460
  121. package/node_modules/@sema/gerador-dotnet/dist/index.d.ts +3 -0
  122. package/node_modules/@sema/gerador-dotnet/dist/index.js +828 -0
  123. package/node_modules/@sema/gerador-dotnet/dist/index.js.map +1 -0
  124. package/node_modules/@sema/gerador-dotnet/package.json +7 -0
  125. package/node_modules/@sema/gerador-html/dist/index.js +17 -17
  126. package/node_modules/@sema/gerador-lua/dist/index.js +53 -8
  127. package/node_modules/@sema/gerador-lua/dist/index.js.map +1 -1
  128. package/node_modules/@sema/gerador-php/dist/index.js +121 -113
  129. package/node_modules/@sema/gerador-php/dist/index.js.map +1 -1
  130. package/node_modules/@sema/gerador-python/dist/index.part02.js +3 -3
  131. package/node_modules/@sema/gerador-typescript/dist/index.part02.js +11 -11
  132. package/node_modules/@sema/nucleo/dist/diagnosticos/melhorador.js +42 -42
  133. package/node_modules/@sema/padroes/dist/index.d.ts +1 -1
  134. package/package.json +12 -1
package/dist/comandos.js CHANGED
@@ -3,6 +3,7 @@
3
3
  import { comandoDev } from "./dev/index.js";
4
4
  import { comandoInit } from "./init/index.js";
5
5
  import { comandoSyncPrisma } from "./sync/index.js";
6
+ import { comandoPipelineConteudo } from "./pipelineConteudo/command.js";
6
7
  async function comandoInitHandler(posicionais, args, _emJson) {
7
8
  try {
8
9
  await comandoInit([...posicionais, ...args]);
@@ -59,5 +60,6 @@ export const REGISTRO_COMANDOS = {
59
60
  init: comandoInitHandler,
60
61
  dev: comandoDevHandler,
61
62
  sync: comandoSyncPrismaHandler,
63
+ conteudo: comandoPipelineConteudo,
62
64
  };
63
65
  //# sourceMappingURL=comandos.js.map
@@ -3,12 +3,14 @@
3
3
  // Contrato: contratos/sema/cli_toolchain_local.sema
4
4
  // Descrição: comando doctor e verificação local de dependências por alvo de geração.
5
5
  import { comandoDisponivel, resolverExecucaoPython, resolverExecucaoPytest, TSX_EXECUTOR_CLI, TSX_IMPORTADOR_CLI, } from "./execucoesExternas.js";
6
+ import { resolverToolchainCpp } from "./nativeToolchains.js";
6
7
  function criarItemDependencia(nome, ok, detalhe, obrigatoria = true) {
7
8
  return { nome, ok, detalhe, obrigatoria };
8
9
  }
9
10
  function coletarDependenciasDoctor() {
10
11
  const python = resolverExecucaoPython();
11
12
  const pytest = resolverExecucaoPytest();
13
+ const toolchainCpp = resolverToolchainCpp();
12
14
  return [
13
15
  {
14
16
  comando: "base",
@@ -17,6 +19,7 @@ function coletarDependenciasDoctor() {
17
19
  criarItemDependencia("npm", comandoDisponivel("npm"), "instalacao, pack e publish", false),
18
20
  criarItemDependencia("python", Boolean(python), python?.rotulo ? `resolvido via ${python.rotulo}` : "python ou py", false),
19
21
  criarItemDependencia("dotnet", comandoDisponivel("dotnet"), "ecosistema ASP.NET", false),
22
+ criarItemDependencia("compilador_cpp", Boolean(toolchainCpp), toolchainCpp?.rotulo ?? "GCC, Clang ou MSVC", false),
20
23
  criarItemDependencia("go", comandoDisponivel("go"), "ecosistema Go", false),
21
24
  criarItemDependencia("cargo", comandoDisponivel("cargo"), "ecosistema Rust", false),
22
25
  criarItemDependencia("java", comandoDisponivel("java"), "ecosistema Java/Spring", false),
@@ -59,6 +62,18 @@ function coletarDependenciasDoctor() {
59
62
  criarItemDependencia("php", comandoDisponivel("php", ["-v"]), "runner de testes PHP"),
60
63
  ],
61
64
  },
65
+ {
66
+ comando: "verificar/dotnet",
67
+ itens: [
68
+ criarItemDependencia("dotnet", comandoDisponivel("dotnet"), "dotnet SDK para compilar e executar testes C#"),
69
+ ],
70
+ },
71
+ {
72
+ comando: "verificar/cpp",
73
+ itens: [
74
+ criarItemDependencia("compilador_cpp", Boolean(toolchainCpp), toolchainCpp?.rotulo ?? "GCC, Clang ou MSVC"),
75
+ ],
76
+ },
62
77
  ];
63
78
  }
64
79
  function renderizarCaixaAscii(linhas) {
@@ -128,6 +143,19 @@ export function avaliarDependenciasVerificacao(configuracoesAlvo) {
128
143
  registrar("verificar/php", [
129
144
  criarItemDependencia("php", comandoDisponivel("php", ["-v"]), "runner de testes PHP"),
130
145
  ]);
146
+ continue;
147
+ }
148
+ if (configuracao.alvo === "dotnet") {
149
+ registrar("verificar/dotnet", [
150
+ criarItemDependencia("dotnet", comandoDisponivel("dotnet"), "dotnet SDK para compilar e executar testes C#"),
151
+ ]);
152
+ continue;
153
+ }
154
+ if (configuracao.alvo === "cpp") {
155
+ const toolchainCpp = resolverToolchainCpp();
156
+ registrar("verificar/cpp", [
157
+ criarItemDependencia("compilador_cpp", Boolean(toolchainCpp), toolchainCpp?.rotulo ?? "GCC, Clang ou MSVC"),
158
+ ]);
131
159
  }
132
160
  }
133
161
  return {
@@ -1,7 +1,6 @@
1
- // SEMA-GOVERNED
2
- // M?dulo: sema.produto.orcamento_semantico
3
- // Contrato: contratos/sema/orcamento_semantico.sema
4
- // Descri??o: detec??o de comandos externos usados por doctor, testes gerados e runners opcionais.
1
+ // SEMA-GOVERNED: sema.produto.cli_toolchain_local
2
+ // Contrato: contratos/sema/cli_toolchain_local.sema
3
+ // Descrição: detecção de comandos externos usados por doctor, testes gerados e runners opcionais.
5
4
  import { spawnSync } from "node:child_process";
6
5
  import { createRequire } from "node:module";
7
6
  const requireRuntimeCli = createRequire(import.meta.url);
@@ -16,14 +15,29 @@ function resolverImportadorNodeOpcional(especificador) {
16
15
  export const TSX_IMPORTADOR_CLI = resolverImportadorNodeOpcional("tsx");
17
16
  export const TSX_EXECUTOR_CLI = resolverImportadorNodeOpcional("tsx/cli");
18
17
  const TIMEOUT_CHECAGEM_COMANDO_MS = 5_000;
18
+ const disponibilidadeComandosNoProcesso = new Map();
19
19
  export function comandoDisponivel(comando, argumentos = ["--version"]) {
20
+ const chaveSondagem = JSON.stringify({
21
+ comando,
22
+ argumentos,
23
+ cwd: process.cwd(),
24
+ path: process.env.PATH ?? "",
25
+ pathExt: process.env.PATHEXT ?? "",
26
+ comSpec: process.env.COMSPEC ?? "",
27
+ });
28
+ const resultadoMemorizado = disponibilidadeComandosNoProcesso.get(chaveSondagem);
29
+ if (resultadoMemorizado !== undefined) {
30
+ return resultadoMemorizado;
31
+ }
20
32
  const execucao = spawnSync(comando, argumentos, {
21
33
  stdio: "ignore",
22
34
  shell: process.platform === "win32",
23
35
  timeout: TIMEOUT_CHECAGEM_COMANDO_MS,
24
36
  windowsHide: true,
25
37
  });
26
- return !execucao.error && execucao.signal === null && (execucao.status ?? 1) === 0;
38
+ const disponivel = !execucao.error && execucao.signal === null && (execucao.status ?? 1) === 0;
39
+ disponibilidadeComandosNoProcesso.set(chaveSondagem, disponivel);
40
+ return disponivel;
27
41
  }
28
42
  export function resolverExecucaoPython() {
29
43
  if (comandoDisponivel("python")) {
@@ -14,7 +14,10 @@ import { gerarJavaScript } from "@sema/gerador-javascript";
14
14
  import { gerarHtml } from "@sema/gerador-html";
15
15
  import { gerarCss } from "@sema/gerador-css";
16
16
  import { gerarPhp } from "@sema/gerador-php";
17
+ import { gerarDotNet } from "@sema/gerador-dotnet";
18
+ import { gerarCpp } from "@sema/gerador-cpp";
17
19
  import { comandoDisponivel, resolverExecucaoPytest, TSX_EXECUTOR_CLI } from "./execucoesExternas.js";
20
+ import { compilarCpp, executarBinarioNativo, resolverToolchainCpp } from "./nativeToolchains.js";
18
21
  import { resolverEstruturaSaidaPadrao, resolverFrameworkPadrao, } from "./projeto.js";
19
22
  export function validarCompatibilidadeFramework(alvo, framework) {
20
23
  if (framework === "base") {
@@ -151,6 +154,12 @@ export function gerarArquivosPorAlvo(ir, alvo, framework) {
151
154
  if (alvo === "php") {
152
155
  return gerarPhp(ir);
153
156
  }
157
+ if (alvo === "dotnet") {
158
+ return gerarDotNet(ir);
159
+ }
160
+ if (alvo === "cpp") {
161
+ return gerarCpp(ir);
162
+ }
154
163
  return gerarTypeScript(ir, { framework });
155
164
  }
156
165
  export function aplicarEstruturaSaida(arquivos, ir, estrutura) {
@@ -247,6 +256,9 @@ export function contarCasosDeTesteGerados(alvo, arquivos) {
247
256
  }
248
257
  return (arquivoTeste.conteudo.match(/\btest\(/g) ?? []).length;
249
258
  }
259
+ if (alvo === "dotnet" || alvo === "cpp") {
260
+ return arquivos.reduce((total, arquivo) => total + (arquivo.conteudo.match(/SEMA-TEST:/g) ?? []).length, 0);
261
+ }
250
262
  const arquivoTeste = arquivos.find((item) => path.basename(item.caminhoRelativo).startsWith("test_"));
251
263
  if (!arquivoTeste) {
252
264
  return 0;
@@ -255,9 +267,17 @@ export function contarCasosDeTesteGerados(alvo, arquivos) {
255
267
  }
256
268
  export function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = false) {
257
269
  const quantidadeTestes = contarCasosDeTesteGerados(alvo, arquivos);
270
+ if (quantidadeTestes === 0 && (alvo === "dotnet" || alvo === "cpp")) {
271
+ return {
272
+ codigoSaida: 1,
273
+ quantidadeTestes,
274
+ saidaPadrao: "",
275
+ saidaErro: `O alvo ${alvo} nao gerou casos SEMA-TEST; a execucao nativa foi bloqueada.`,
276
+ };
277
+ }
258
278
  if (quantidadeTestes === 0) {
259
279
  if (!silencioso) {
260
- const nomesAlvo = { typescript: "TypeScript", python: "Python", lua: "Lua", dart: "Dart", javascript: "JavaScript", html: "HTML", css: "CSS", php: "PHP" };
280
+ const nomesAlvo = { typescript: "TypeScript", python: "Python", lua: "Lua", dart: "Dart", javascript: "JavaScript", html: "HTML", css: "CSS", php: "PHP", dotnet: ".NET", cpp: "C++" };
261
281
  console.log(`Nenhum teste ${nomesAlvo[alvo] ?? alvo} foi gerado.`);
262
282
  }
263
283
  return { codigoSaida: 0, quantidadeTestes, saidaPadrao: "", saidaErro: "" };
@@ -370,6 +390,82 @@ export function executarTestesGerados(alvo, baseSaida, arquivos, silencioso = fa
370
390
  saidaErro: typeof execucao.stderr === "string" ? execucao.stderr : "",
371
391
  };
372
392
  }
393
+ if (alvo === "dotnet") {
394
+ const projetoTeste = arquivos.find((item) => item.caminhoRelativo.endsWith(".Tests.csproj"))?.caminhoRelativo;
395
+ if (!projetoTeste) {
396
+ return {
397
+ codigoSaida: 1,
398
+ quantidadeTestes,
399
+ saidaPadrao: "",
400
+ saidaErro: "O gerador .NET nao produziu um projeto de testes *.Tests.csproj.",
401
+ };
402
+ }
403
+ if (!comandoDisponivel("dotnet")) {
404
+ return {
405
+ codigoSaida: 1,
406
+ quantidadeTestes,
407
+ saidaPadrao: "",
408
+ saidaErro: "Nao foi possivel localizar o dotnet SDK para executar os testes C# gerados.",
409
+ };
410
+ }
411
+ const execucao = spawnSync("dotnet", [
412
+ "run",
413
+ "--project",
414
+ path.join(baseSaida, projetoTeste),
415
+ "--configuration",
416
+ "Release",
417
+ "--nologo",
418
+ "--property:RestoreIgnoreFailedSources=true",
419
+ ], {
420
+ stdio: silencioso ? "pipe" : "inherit",
421
+ cwd: baseSaida,
422
+ encoding: silencioso ? "utf8" : undefined,
423
+ timeout: 120_000,
424
+ windowsHide: true,
425
+ });
426
+ return {
427
+ codigoSaida: execucao.status ?? 1,
428
+ quantidadeTestes,
429
+ saidaPadrao: typeof execucao.stdout === "string" ? execucao.stdout : "",
430
+ saidaErro: typeof execucao.stderr === "string" ? execucao.stderr : execucao.error?.message ?? "",
431
+ };
432
+ }
433
+ if (alvo === "cpp") {
434
+ const arquivoTeste = arquivos.find((item) => item.caminhoRelativo.endsWith(".test.cpp") || (item.caminhoRelativo.endsWith(".cpp") && item.conteudo.includes("SEMA-TEST:")));
435
+ const fontes = arquivos
436
+ .filter((item) => item.caminhoRelativo.endsWith(".cpp"))
437
+ .map((item) => path.join(baseSaida, item.caminhoRelativo));
438
+ if (!arquivoTeste || fontes.length === 0) {
439
+ return {
440
+ codigoSaida: 1,
441
+ quantidadeTestes,
442
+ saidaPadrao: "",
443
+ saidaErro: "O gerador C++ nao produziu fontes e um arquivo *.test.cpp executavel.",
444
+ };
445
+ }
446
+ const toolchain = resolverToolchainCpp();
447
+ if (!toolchain) {
448
+ return {
449
+ codigoSaida: 1,
450
+ quantidadeTestes,
451
+ saidaPadrao: "",
452
+ saidaErro: "Nao foi possivel localizar GCC, Clang ou MSVC para compilar os testes C++ gerados.",
453
+ };
454
+ }
455
+ const diretorioTeste = path.dirname(path.join(baseSaida, arquivoTeste.caminhoRelativo));
456
+ const executavel = path.join(diretorioTeste, process.platform === "win32" ? ".sema-cpp-tests.exe" : ".sema-cpp-tests");
457
+ const compilacao = compilarCpp(toolchain, fontes, diretorioTeste, executavel, silencioso);
458
+ if (compilacao.codigoSaida !== 0) {
459
+ return { ...compilacao, quantidadeTestes };
460
+ }
461
+ const execucao = executarBinarioNativo(executavel, silencioso);
462
+ return {
463
+ codigoSaida: execucao.codigoSaida,
464
+ quantidadeTestes,
465
+ saidaPadrao: `${compilacao.saidaPadrao}${execucao.saidaPadrao}`,
466
+ saidaErro: `${compilacao.saidaErro}${execucao.saidaErro}`,
467
+ };
468
+ }
373
469
  const arquivoTeste = arquivos.find((item) => path.basename(item.caminhoRelativo).startsWith("test_"))?.caminhoRelativo;
374
470
  if (!arquivoTeste) {
375
471
  if (!silencioso) {
@@ -1,4 +1,4 @@
1
- export declare const STARTER_IA = "Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.\n\nImportante:\n- a Sema se apresenta publicamente como protocolo e funciona tecnicamente como linguagem de intencao\n- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana\n- humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato\n- leitura humana e bonus toleravel, nao objetivo de produto\n- a Sema nao e gerador magico que deveria fazer tudo\n- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao\n- a Sema gera codigo e scaffolding real para TypeScript, Python, PHP, Dart, Lua, JavaScript, HTML e CSS\n- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico\n- a Sema usa `impl` para ligar task a simbolo real do runtime\n- a Sema usa `vinculos` para ligar contrato a arquivo, simbolo, recurso e superficie real\n- a Sema usa `execucao` para explicitar timeout, retry, compensacao e criticidade\n- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo com score, confianca e lacunas\n- a Sema usa `resumo` e `prompt-curto` para IA fraca, gratuita ou com pouco contexto\n- a Sema usa `contexto-ia` para gerar `ast.json`, `ir.json`, `drift.json`, `briefing.json` e artefatos compactos antes da edicao\n- timeout definido pelo agente nao e falha do Sema; aumente o timeout e tente de novo antes de concluir falha\n- a Sema pode servir de base para interfaces graficas elegantes e coerentes\n- a Sema gera artefatos HTML/CSS derivados, mas nao substitui sozinha uma interface completa de produto\n- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto\n- se a tarefa envolver UI, prefira pedir Sema + React + TypeScript ou Sema + arquitetura de front-end\n- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade\n\nRegras:\n- nao invente sintaxe fora da gramatica e dos exemplos oficiais\n- antes de qualquer acao, crie, edite ou remova o contrato .sema aplicavel; isso vale para Software, Author, Workflow, Ops, Game, Legal e Research\n- se a IA for fraca, nao tente abrir tudo de uma vez\n- use `sema resumo <arquivo> --micro --json` pelo stdout antes de subir para o pacote completo\n- se `sema resumo . --micro` estourar timeout local, repita com timeout maior ou escopo menor; nao avance com codigo\n- trate `ir --json` como fonte de verdade semantica\n- trate `briefing.json` como plano de intervencao antes de editar projeto vivo\n- trate `diagnosticos --json` como fonte de correcao\n- use `sema formatar` como fonte unica de estilo\n- preserve a intencao do contrato\n- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo\n\nComandos essenciais:\n- resumo compacto por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`\n- prompt curto para IA fraca: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`\n- descoberta do projeto: `sema inspecionar [arquivo-ou-pasta] --json`\n- auditoria do contrato vivo: `sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--json]`\n- mapa de impacto: `sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--json]`\n- renomeacao assistida: `sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--json]`\n- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`\n- estrutura sintatica: `sema ast <arquivo.sema> --json`\n- estrutura semantica: `sema ir <arquivo.sema> --json`\n- validacao: `sema validar <arquivo.sema> --json`\n- diagnosticos: `sema diagnosticos <arquivo.sema> --json`\n- formatacao: `sema formatar <arquivo.sema>`\n- 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>`\n- exemplos oficiais no projeto: `sema instalar-exemplos`\n- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css> --saida <diretorio>`\n- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`\n\nAntes de editar:\n1. leia README, docs de IA e um exemplo oficial parecido\n2. se a IA for fraca, rode `sema resumo <arquivo> --micro --json` e use o stdout compacto\n - se timeout local estourar, aumente o timeout e tente de novo; timeout nao significa Sema inativo\n3. se a IA aguentar mais, rode `sema drift` para medir impls, vinculos, rotas, score e lacunas\n4. se a tarefa for pesada, rode `sema contexto-ia` e leia `briefing.json`\n5. consulte AST e IR do modulo alvo so quando a capacidade realmente aguentar\n\nDepois de editar:\n1. rode `sema formatar`\n2. rode `sema validar --json`\n3. se houver falha, use `diagnosticos --json`\n4. rode `sema drift` de novo quando mexer em codigo vivo\n5. se a tarefa pedir codigo derivado, rode `sema compilar`\n6. feche com `sema verificar <arquivo-ou-pasta> --json`\n\nPriorize sempre:\n- exemplos oficiais\n- JSON da CLI\n- o menor artefato que resolva a tarefa da IA atual\n- score, confianca e lacunas do `drift`\n- `briefing.json` como guia de mudanca\n- consistencia semantica\n\nSuperficies que a IA deve enxergar como first-class:\n- `route`\n- `worker`\n- `evento`\n- `fila`\n- `cron`\n- `webhook`\n- `cache`\n- `storage`\n- `policy`\n\nNao improvise quando faltar contexto.\n";
1
+ export declare const STARTER_IA = "Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.\n\nImportante:\n- a Sema se apresenta publicamente como protocolo e funciona tecnicamente como linguagem de intencao\n- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana\n- humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato\n- leitura humana e bonus toleravel, nao objetivo de produto\n- a Sema nao e gerador magico que deveria fazer tudo\n- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao\n- a Sema gera codigo e scaffolding real para TypeScript, Python, PHP, Dart, Lua, JavaScript, HTML e CSS\n- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico\n- a Sema usa `impl` para ligar task a simbolo real do runtime\n- a Sema usa `vinculos` para ligar contrato a arquivo, simbolo, recurso e superficie real\n- a Sema usa `execucao` para explicitar timeout, retry, compensacao e criticidade\n- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo com score, confianca e lacunas\n- a Sema usa `resumo` e `prompt-curto` para IA fraca, gratuita ou com pouco contexto\n- a Sema usa `contexto-ia` para gerar `ast.json`, `ir.json`, `drift.json`, `briefing.json` e artefatos compactos antes da edicao\n- timeout definido pelo agente nao e falha do Sema; aumente o timeout e tente de novo antes de concluir falha\n- a Sema pode servir de base para interfaces graficas elegantes e coerentes\n- a Sema gera artefatos HTML/CSS derivados, mas nao substitui sozinha uma interface completa de produto\n- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto\n- se a tarefa envolver UI, prefira pedir Sema + React + TypeScript ou Sema + arquitetura de front-end\n- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade\n\nRegras:\n- nao invente sintaxe fora da gramatica e dos exemplos oficiais\n- antes de qualquer acao, crie, edite ou remova o contrato .sema aplicavel; isso vale para Software, Author, Workflow, Ops, Game, Legal e Research\n- se a IA for fraca, nao tente abrir tudo de uma vez\n- use `sema resumo <arquivo> --micro --json` pelo stdout antes de subir para o pacote completo\n- se `sema resumo . --micro` estourar timeout local, repita com timeout maior ou escopo menor; nao avance com codigo\n- trate `ir --json` como fonte de verdade semantica\n- trate `briefing.json` como plano de intervencao antes de editar projeto vivo\n- trate `diagnosticos --json` como fonte de correcao\n- use `sema formatar` como fonte unica de estilo\n- preserve a intencao do contrato\n- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo\n\nComandos essenciais:\n- resumo compacto por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`\n- prompt curto para IA fraca: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`\n- descoberta do projeto: `sema inspecionar [arquivo-ou-pasta] --json`\n- auditoria do contrato vivo: `sema drift <arquivo-ou-pasta> [--escopo <arquivo|modulo|projeto>] [--json]`\n- mapa de impacto: `sema impacto <arquivo-ou-pasta> --alvo <token> [--mudanca <descricao>] [--json]`\n- renomeacao assistida: `sema renomear-semantico <arquivo-ou-pasta> --de <nome-atual> --para <nome-novo> [--json]`\n- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`\n- estrutura sintatica: `sema ast <arquivo.sema> --json`\n- estrutura semantica: `sema ir <arquivo.sema> --json`\n- validacao: `sema validar <arquivo.sema> --json`\n- diagnosticos: `sema diagnosticos <arquivo.sema> --json`\n- formatacao: `sema formatar <arquivo.sema>`\n- 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>`\n- exemplos oficiais no projeto: `sema instalar-exemplos`\n- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css|dotnet|cpp> --saida <diretorio>`\n- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`\n\nAntes de editar:\n1. leia README, docs de IA e um exemplo oficial parecido\n2. se a IA for fraca, rode `sema resumo <arquivo> --micro --json` e use o stdout compacto\n - se timeout local estourar, aumente o timeout e tente de novo; timeout nao significa Sema inativo\n3. se a IA aguentar mais, rode `sema drift` para medir impls, vinculos, rotas, score e lacunas\n4. se a tarefa for pesada, rode `sema contexto-ia` e leia `briefing.json`\n5. consulte AST e IR do modulo alvo so quando a capacidade realmente aguentar\n\nDepois de editar:\n1. rode `sema formatar`\n2. rode `sema validar --json`\n3. se houver falha, use `diagnosticos --json`\n4. rode `sema drift` de novo quando mexer em codigo vivo\n5. se a tarefa pedir codigo derivado, rode `sema compilar`\n6. feche com `sema verificar <arquivo-ou-pasta> --json`\n\nPriorize sempre:\n- exemplos oficiais\n- JSON da CLI\n- o menor artefato que resolva a tarefa da IA atual\n- score, confianca e lacunas do `drift`\n- `briefing.json` como guia de mudanca\n- consistencia semantica\n\nSuperficies que a IA deve enxergar como first-class:\n- `route`\n- `worker`\n- `evento`\n- `fila`\n- `cron`\n- `webhook`\n- `cache`\n- `storage`\n- `policy`\n\nNao improvise quando faltar contexto.\n";
2
2
  export declare const PROMPT_BASE_IA = "Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo.\n\nTrate 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.\n\nFontes de verdade, em ordem:\n1. se o projeto expuser `SEMA_CONTEXT.md`, comece por ele\n2. `AGENT_CONTEXT_PACK.json`\n3. `SEMA_BRIEF.md`\n4. `SEMA_INDEX.json`\n5. `AGENTS.md`\n6. README do projeto\n7. gramatica e documentacao de sintaxe da Sema\n8. exemplos oficiais, com prioridade para o vertical de pagamento\n9. `sema resumo <arquivo> --micro --json` e o stdout compacto quando a IA for fraca\n10. AST, IR e diagnosticos exportados pela CLI em JSON quando a capacidade aguentar\n\nRegras de operacao:\n- 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\n- preserve o significado semantico\n- use o formatador oficial da Sema como fonte unica de estilo\n- use diagnosticos estruturados como contrato de correcao\n- use a IR como fonte de verdade semantica quando houver duvida\n- use predicados canonicos como normalizacao opcional, preservando a forma original\n- nao conclua uma alteracao sem validar e verificar o modulo\n- comece pelo menor artefato semantico que resolva a tarefa\n\nAntes de editar `.sema`, entenda:\n- o module alvo\n- os contratos de task, route, error, effects, guarantees, state e flow\n- os exemplos oficiais relacionados\n\nDepois de editar `.sema`, execute este fluxo:\n1. formatar\n2. validar\n3. diagnosticar, se houver falha\n4. verificar\n\nSe houver conflito entre texto livre e IR/diagnosticos, priorize a IR e os diagnosticos da CLI.\n\nSe algo nao estiver claro, siga a forma ja usada nos exemplos oficiais. Nao improvise sem base.\n";
3
3
  export declare const PROMPT_IA_UI = "Atue como Engenheiro de Software Senior e UX/UI Designer de elite.\n\nQuero que voce trabalhe com Sema como fonte de verdade semantica do sistema e com React + TypeScript como camada de interface.\n\nEntregue obrigatoriamente duas partes integradas:\n1. os arquivos `.sema` do dominio\n2. a proposta ou implementacao da interface em React + TypeScript\n\nRegras:\n- nao entregue apenas HTML solto em arquivo unico\n- nao trate a Sema como enfeite conceitual\n- a interface deve nascer do contrato semantico definido em Sema\n- use os exemplos oficiais da Sema como referencia de estilo e semantica\n- nao invente sintaxe fora da gramatica suportada\n\nA Sema deve modelar, quando fizer sentido:\n- `module`\n- `use`\n- `entity`\n- `enum`\n- `state`\n- `task`\n- `flow`\n- `route`\n- `effects`\n- `error`\n- `guarantees`\n- `tests`\n- `docs`\n\nA interface deve refletir visualmente:\n- `state` como status e progresso observavel\n- `flow` como etapas ou orquestracao visivel\n- `error` como falhas tratadas com clareza\n- `effects` como operacoes relevantes para usuario ou operacao\n- `guarantees` como confianca, confirmacao ou consistencia final\n\nEstruture a entrega assim:\n1. visao do produto\n2. dominio modelado em Sema\n3. arquitetura de pastas em React + TypeScript\n4. componentes principais\n5. estrategia visual\n6. codigo principal da interface\n7. explicacao curta de como a UI conversa com a semantica da Sema\n\nSe a tarefa envolver app visual, a Sema governa o significado e o React renderiza a experiencia. Nao atropele essa separacao.\n";
4
4
  export declare const PROMPT_IA_REACT = "Crie uma solucao com Sema + React + TypeScript.\n\nRegras principais:\n- a Sema deve ser a fonte de verdade semantica do dominio\n- React + TypeScript deve ser a camada de interface e experiencia\n- nao entregue HTML unico solto\n- nao trate a Sema como enfeite\n\nEntregue obrigatoriamente:\n1. arquivos `.sema` do dominio\n2. arquitetura de pastas do frontend\n3. componentes React principais\n4. contratos e tipos derivados da semantica\n5. interface elegante e implementavel\n\nA modelagem Sema deve cobrir, quando fizer sentido:\n- `entity`\n- `enum`\n- `state`\n- `task`\n- `flow`\n- `route`\n- `effects`\n- `error`\n- `guarantees`\n- `tests`\n\nA interface React deve tornar visiveis:\n- estado atual e transicoes relevantes\n- fluxo operacional\n- erros publicos\n- efeitos operacionais importantes\n- garantias ou confirmacoes finais\n\nEstruture a entrega assim:\n1. visao do produto\n2. arquivos `.sema`\n3. arquitetura React + TypeScript\n4. componentes e telas\n5. codigo principal\n6. explicacao de como a UI deriva da semantica da Sema\n\nSe houver duvida, siga os exemplos oficiais e mantenha a separacao:\n- Sema governa o significado\n- React governa a apresentacao\n";