@semacode/cli 1.2.0 → 1.2.9

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 (38) hide show
  1. package/README.md +2 -2
  2. package/SEMA_BRIEF.curto.txt +9 -9
  3. package/SEMA_BRIEF.md +49 -49
  4. package/SEMA_BRIEF.micro.txt +7 -7
  5. package/SEMA_INDEX.json +501 -546
  6. package/dist/drift.d.ts +2 -2
  7. package/dist/drift.js +0 -20
  8. package/dist/drift.js.map +1 -1
  9. package/dist/importador.d.ts +1 -1
  10. package/dist/importador.js +0 -60
  11. package/dist/importador.js.map +1 -1
  12. package/dist/index.js +1334 -1360
  13. package/dist/index.js.map +1 -1
  14. package/dist/projeto.js +0 -6
  15. package/dist/projeto.js.map +1 -1
  16. package/dist/tipos.d.ts +1 -1
  17. package/docs/AGENT_STARTER.md +102 -102
  18. package/docs/instalacao-e-primeiro-uso.md +196 -198
  19. package/node_modules/@sema/gerador-dart/package.json +1 -1
  20. package/node_modules/@sema/gerador-lua/dist/index.js +49 -81
  21. package/node_modules/@sema/gerador-lua/dist/index.js.map +1 -1
  22. package/node_modules/@sema/gerador-lua/package.json +1 -1
  23. package/node_modules/@sema/gerador-python/package.json +1 -1
  24. package/node_modules/@sema/gerador-typescript/package.json +1 -1
  25. package/node_modules/@sema/nucleo/dist/ast/tipos.d.ts +1 -1
  26. package/node_modules/@sema/nucleo/dist/ir/conversor.js +0 -4
  27. package/node_modules/@sema/nucleo/dist/ir/conversor.js.map +1 -1
  28. package/node_modules/@sema/nucleo/dist/ir/modelos.d.ts +3 -3
  29. package/node_modules/@sema/nucleo/dist/parser/parser.js +0 -2
  30. package/node_modules/@sema/nucleo/dist/parser/parser.js.map +1 -1
  31. package/node_modules/@sema/nucleo/dist/semantico/analisador.d.ts +2 -2
  32. package/node_modules/@sema/nucleo/dist/semantico/analisador.js +1 -3
  33. package/node_modules/@sema/nucleo/dist/semantico/analisador.js.map +1 -1
  34. package/node_modules/@sema/nucleo/package.json +1 -1
  35. package/node_modules/@sema/padroes/dist/index.js +18 -1
  36. package/node_modules/@sema/padroes/dist/index.js.map +1 -1
  37. package/node_modules/@sema/padroes/package.json +1 -1
  38. package/package.json +7 -7
package/SEMA_INDEX.json CHANGED
@@ -1,546 +1,501 @@
1
- {
2
- "comando": "resumo-projeto",
3
- "geradoEm": "2026-04-02T00:02:31.211Z",
4
- "cliVersao": "1.2.0",
5
- "baseProjeto": "C:\\GitHub\\Sema",
6
- "totalModulos": 4,
7
- "entradaCanonica": {
8
- "descricao": "Entrada canonica do repositorio para IA. O repo nao e human-first; a IA deve começar por esses artefatos antes de abrir codigo cru.",
9
- "ordemLeitura": [
10
- "llms.txt",
11
- "SEMA_BRIEF.md",
12
- "SEMA_INDEX.json",
13
- "AGENTS.md",
14
- "README.md",
15
- "llms-full.txt"
16
- ],
17
- "porCapacidade": {
18
- "pequena": [
19
- "llms.txt",
20
- "SEMA_BRIEF.micro.txt",
21
- "SEMA_INDEX.json",
22
- "AGENTS.md"
23
- ],
24
- "media": [
25
- "llms.txt",
26
- "SEMA_BRIEF.curto.txt",
27
- "SEMA_INDEX.json",
28
- "AGENTS.md",
29
- "README.md"
30
- ],
31
- "grande": [
32
- "llms-full.txt",
33
- "SEMA_BRIEF.md",
34
- "SEMA_INDEX.json",
35
- "AGENTS.md",
36
- "README.md"
37
- ]
38
- },
39
- "docsSuporte": [
40
- "docs/AGENT_STARTER.md",
41
- "docs/integracao-com-ia.md",
42
- "docs/fluxo-pratico-ia-sema.md",
43
- "docs/como-ensinar-a-sema-para-ia.md",
44
- "docs/sintaxe.md",
45
- "docs/cli.md"
46
- ],
47
- "guiaPorCapacidade": {
48
- "pequena": {
49
- "descricao": "IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo.",
50
- "artefatos": [
51
- "resumo.micro.txt",
52
- "briefing.min.json",
53
- "prompt-curto.txt"
54
- ],
55
- "ordemLeitura": [
56
- "resumo.micro.txt",
57
- "briefing.min.json",
58
- "resumo.curto.txt"
59
- ],
60
- "evitar": [
61
- "ast.json",
62
- "ir.json",
63
- "diagnosticos.json"
64
- ]
65
- },
66
- "media": {
67
- "descricao": "IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift.",
68
- "artefatos": [
69
- "resumo.curto.txt",
70
- "briefing.min.json",
71
- "drift.json",
72
- "prompt-curto.txt"
73
- ],
74
- "ordemLeitura": [
75
- "resumo.curto.txt",
76
- "briefing.min.json",
77
- "drift.json",
78
- "resumo.md"
79
- ],
80
- "evitar": [
81
- "ast.json"
82
- ]
83
- },
84
- "grande": {
85
- "descricao": "IA com contexto grande ou tool use. Pode consumir o pacote completo.",
86
- "artefatos": [
87
- "README.md",
88
- "resumo.md",
89
- "briefing.json",
90
- "drift.json",
91
- "ir.json",
92
- "ast.json"
93
- ],
94
- "ordemLeitura": [
95
- "README.md",
96
- "resumo.md",
97
- "briefing.json",
98
- "drift.json",
99
- "ir.json",
100
- "ast.json"
101
- ],
102
- "evitar": []
103
- }
104
- }
105
- },
106
- "guiaPorCapacidade": {
107
- "pequena": {
108
- "descricao": "IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo.",
109
- "artefatos": [
110
- "resumo.micro.txt",
111
- "briefing.min.json",
112
- "prompt-curto.txt"
113
- ],
114
- "ordemLeitura": [
115
- "resumo.micro.txt",
116
- "briefing.min.json",
117
- "resumo.curto.txt"
118
- ],
119
- "evitar": [
120
- "ast.json",
121
- "ir.json",
122
- "diagnosticos.json"
123
- ]
124
- },
125
- "media": {
126
- "descricao": "IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift.",
127
- "artefatos": [
128
- "resumo.curto.txt",
129
- "briefing.min.json",
130
- "drift.json",
131
- "prompt-curto.txt"
132
- ],
133
- "ordemLeitura": [
134
- "resumo.curto.txt",
135
- "briefing.min.json",
136
- "drift.json",
137
- "resumo.md"
138
- ],
139
- "evitar": [
140
- "ast.json"
141
- ]
142
- },
143
- "grande": {
144
- "descricao": "IA com contexto grande ou tool use. Pode consumir o pacote completo.",
145
- "artefatos": [
146
- "README.md",
147
- "resumo.md",
148
- "briefing.json",
149
- "drift.json",
150
- "ir.json",
151
- "ast.json"
152
- ],
153
- "ordemLeitura": [
154
- "README.md",
155
- "resumo.md",
156
- "briefing.json",
157
- "drift.json",
158
- "ir.json",
159
- "ast.json"
160
- ],
161
- "evitar": []
162
- }
163
- },
164
- "modulos": [
165
- {
166
- "geradoEm": "2026-04-02T00:02:31.211Z",
167
- "arquivo": "C:\\GitHub\\Sema\\contratos\\pedidos.sema",
168
- "modulo": "app.pedidos",
169
- "perfilCompatibilidade": "publico",
170
- "scoreSemantico": 50,
171
- "confiancaGeral": "baixa",
172
- "riscoOperacional": "alto",
173
- "faz": "governa 1 rota(s), 1 task(s) com foco em criar pedido publico",
174
- "tarefasPrincipais": [
175
- "criar_pedido"
176
- ],
177
- "entradasChave": [
178
- "criar_pedido(cliente_id, total)"
179
- ],
180
- "saidasChave": [
181
- "criar_pedido(pedido_id, status)"
182
- ],
183
- "superficiesPublicas": [
184
- "POST /pedidos"
185
- ],
186
- "regrasCriticas": [
187
- "pedido_id existe",
188
- "status existe",
189
- "total > 0"
190
- ],
191
- "efeitos": [
192
- "auditoria pedidos",
193
- "persistencia Pedido criticidade = alta"
194
- ],
195
- "erros": [],
196
- "entidadesAfetadas": [
197
- "Pedido",
198
- "pedidos"
199
- ],
200
- "arquivosProvaveis": [],
201
- "simbolosRelacionados": [],
202
- "riscosPrincipais": [
203
- "altera_persistencia",
204
- "criar_pedido:alto",
205
- "efeito_critico",
206
- "vinculo_fraco"
207
- ],
208
- "lacunas": [
209
- "execucao_implicita",
210
- "sem_impl",
211
- "sem_vinculos"
212
- ],
213
- "inferido": [],
214
- "checksSugeridos": [
215
- "revisar efeitos operacionais",
216
- "rodar sema drift --json",
217
- "rodar sema validar --json",
218
- "verificar guarantees"
219
- ],
220
- "testesMinimos": [
221
- "sema drift <arquivo> --json",
222
- "sema validar <arquivo> --json",
223
- "sema verificar <arquivo-ou-pasta> --json"
224
- ],
225
- "consumerFramework": "nextjs-consumer",
226
- "appRoutes": [],
227
- "consumerSurfaces": [],
228
- "consumerBridges": [],
229
- "arquivosProvaveisEditar": []
230
- },
231
- {
232
- "geradoEm": "2026-04-02T00:02:31.211Z",
233
- "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\ergonomia_e_dominio.sema",
234
- "modulo": "sema.produto.ergonomia_e_dominio",
235
- "perfilCompatibilidade": "interno",
236
- "scoreSemantico": 90,
237
- "confiancaGeral": "alta",
238
- "riscoOperacional": "alto",
239
- "faz": "governa 2 superficie(s), 5 task(s) com foco em scorecard atualizado",
240
- "tarefasPrincipais": [
241
- "reduzir_atrito_sintatico_em_contrato_rico",
242
- "modelar_payload_com_mais_precisao",
243
- "explicitar_variacao_e_compatibilidade",
244
- "separar_validacao_regra_e_poscondicao",
245
- "consultar_scorecard_compatibilidade"
246
- ],
247
- "entradasChave": [
248
- "reduzir_atrito_sintatico_em_contrato_rico(contrato_atual, repeticao_detectada)",
249
- "modelar_payload_com_mais_precisao(contrato_atual, payload_json_generico, exemplos_payload)",
250
- "explicitar_variacao_e_compatibilidade(contrato_atual, perfil_atual)",
251
- "separar_validacao_regra_e_poscondicao(contrato_atual, garantias_confusas)"
252
- ],
253
- "saidasChave": [
254
- "reduzir_atrito_sintatico_em_contrato_rico(leitura_mais_limpa, ambiguidade_controlada, perfil)",
255
- "modelar_payload_com_mais_precisao(tipo_composto_explicito, cardinalidade_explicita, shape_rico)",
256
- "explicitar_variacao_e_compatibilidade(versao_explicita, fallback_claro, contrato_publico_distinto)",
257
- "separar_validacao_regra_e_poscondicao(validacao_de_input_clara, regra_de_negocio_clara, pos_condicao_clara)"
258
- ],
259
- "superficiesPublicas": [
260
- "evento:scorecard_atualizado",
261
- "policy:compatibilidade_publica"
262
- ],
263
- "regrasCriticas": [
264
- "ambiguidade_controlada existe",
265
- "cardinalidade_explicita existe",
266
- "contrato_publico_distinto existe",
267
- "fallback_claro existe",
268
- "leitura_mais_limpa existe",
269
- "nota existe",
270
- "perfil em [ PUBLICO , INTERNO , EXPERIMENTAL , LEGADO , DEPRECADO ]",
271
- "pos_condicao_clara existe"
272
- ],
273
- "efeitos": [],
274
- "erros": [],
275
- "entidadesAfetadas": [
276
- "PerfilCompatibilidade"
277
- ],
278
- "arquivosProvaveis": [
279
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
280
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
281
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
282
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\semantico\\analisador.ts"
283
- ],
284
- "simbolosRelacionados": [
285
- "analisarSemantica",
286
- "converterParaIr",
287
- "formatarCodigo",
288
- "resolverAlvosVerificacao"
289
- ],
290
- "riscosPrincipais": [
291
- "consultar_scorecard_compatibilidade:medio",
292
- "explicitar_variacao_e_compatibilidade:medio",
293
- "modelar_payload_com_mais_precisao:alto",
294
- "reduzir_atrito_sintatico_em_contrato_rico:medio",
295
- "separar_validacao_regra_e_poscondicao:medio"
296
- ],
297
- "lacunas": [
298
- "execucao_implicita",
299
- "sem_impl",
300
- "sem_vinculos"
301
- ],
302
- "inferido": [
303
- "consultar_scorecard_compatibilidade:pacotes/cli/src/projeto.ts",
304
- "evento:scorecard_atualizado:scorecard_compatibilidade",
305
- "explicitar_variacao_e_compatibilidade:pacotes/nucleo/src/ir/conversor.ts",
306
- "modelar_payload_com_mais_precisao:pacotes/nucleo/src/semantico/analisador.ts",
307
- "policy:compatibilidade_publica:compatibilidade_publica",
308
- "reduzir_atrito_sintatico_em_contrato_rico:pacotes/nucleo/src/formatador/index.ts"
309
- ],
310
- "checksSugeridos": [
311
- "revisar efeitos operacionais",
312
- "rodar sema drift --json",
313
- "rodar sema validar --json",
314
- "verificar guarantees"
315
- ],
316
- "testesMinimos": [
317
- "sema drift <arquivo> --json",
318
- "sema validar <arquivo> --json",
319
- "sema verificar <arquivo-ou-pasta> --json"
320
- ],
321
- "consumerFramework": "nextjs-consumer",
322
- "appRoutes": [],
323
- "consumerSurfaces": [],
324
- "consumerBridges": [],
325
- "arquivosProvaveisEditar": [
326
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
327
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
328
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
329
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\semantico\\analisador.ts"
330
- ]
331
- },
332
- {
333
- "geradoEm": "2026-04-02T00:02:31.211Z",
334
- "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\governanca_ia.sema",
335
- "modulo": "sema.produto.governanca_ia",
336
- "perfilCompatibilidade": "publico",
337
- "scoreSemantico": 90,
338
- "confiancaGeral": "alta",
339
- "riscoOperacional": "alto",
340
- "faz": "governa 2 superficie(s), 4 task(s) com foco em preparar briefing contextual",
341
- "tarefasPrincipais": [
342
- "mapear_projeto_sem_adivinhacao",
343
- "normalizar_saida_sem_ruido",
344
- "medir_drift_contra_codigo_vivo",
345
- "padronizar_nomes_para_leitura_de_ia"
346
- ],
347
- "entradasChave": [
348
- "mapear_projeto_sem_adivinhacao(entrada, explicito)",
349
- "normalizar_saida_sem_ruido(estrutura_desejada)",
350
- "medir_drift_contra_codigo_vivo(contrato_alvo, codigo_vivo)",
351
- "padronizar_nomes_para_leitura_de_ia(contrato_atual, sinonimos_em_excesso)"
352
- ],
353
- "saidasChave": [
354
- "mapear_projeto_sem_adivinhacao(base_resolvida, origens_coerentes, codigo_vivo_detectado)",
355
- "normalizar_saida_sem_ruido(estrutura_canonica, alias_confuso)",
356
- "medir_drift_contra_codigo_vivo(impls_resolvidas, rotas_resolvidas, ambiguidades_explicitas)",
357
- "padronizar_nomes_para_leitura_de_ia(nomes_consistentes, leitura_rapida, casos_especiais_reduzidos)"
358
- ],
359
- "superficiesPublicas": [
360
- "webhook:confirmar_contexto_publico",
361
- "worker:preparar_briefing_contextual"
362
- ],
363
- "regrasCriticas": [
364
- "alias_confuso existe",
365
- "ambiguidades_explicitas existe",
366
- "base_resolvida existe",
367
- "casos_especiais_reduzidos existe",
368
- "codigo_vivo_detectado existe",
369
- "estrutura_canonica existe",
370
- "impls_resolvidas existe",
371
- "leitura_rapida existe"
372
- ],
373
- "efeitos": [],
374
- "erros": [
375
- "simbolo_ambiguo"
376
- ],
377
- "entidadesAfetadas": [],
378
- "arquivosProvaveis": [
379
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\drift.ts",
380
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts",
381
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
382
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts"
383
- ],
384
- "simbolosRelacionados": [
385
- "analisarDriftLegado",
386
- "carregarProjeto",
387
- "comandoContextoIa",
388
- "formatarCodigo",
389
- "normalizarEstruturaSaida"
390
- ],
391
- "riscosPrincipais": [
392
- "mapear_projeto_sem_adivinhacao:medio",
393
- "medir_drift_contra_codigo_vivo:alto",
394
- "normalizar_saida_sem_ruido:medio",
395
- "padronizar_nomes_para_leitura_de_ia:medio"
396
- ],
397
- "lacunas": [
398
- "execucao_implicita",
399
- "sem_impl",
400
- "sem_vinculos"
401
- ],
402
- "inferido": [
403
- "mapear_projeto_sem_adivinhacao:pacotes/cli/src/projeto.ts",
404
- "medir_drift_contra_codigo_vivo:pacotes/cli/src/drift.ts",
405
- "normalizar_saida_sem_ruido:pacotes/cli/src/projeto.ts",
406
- "padronizar_nomes_para_leitura_de_ia:pacotes/nucleo/src/formatador/index.ts",
407
- "sema.produto.governanca_ia:pacotes/cli/src/index.ts",
408
- "webhook:confirmar_contexto_publico:/ interno / contexto-ia"
409
- ],
410
- "checksSugeridos": [
411
- "revisar efeitos operacionais",
412
- "rodar sema drift --json",
413
- "rodar sema validar --json",
414
- "verificar guarantees"
415
- ],
416
- "testesMinimos": [
417
- "sema drift <arquivo> --json",
418
- "sema validar <arquivo> --json",
419
- "sema verificar <arquivo-ou-pasta> --json"
420
- ],
421
- "consumerFramework": "nextjs-consumer",
422
- "appRoutes": [
423
- "/ranking"
424
- ],
425
- "consumerSurfaces": [
426
- "router:/ranking -> C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts"
427
- ],
428
- "consumerBridges": [],
429
- "arquivosProvaveisEditar": [
430
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\drift.ts",
431
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts",
432
- "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
433
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts"
434
- ]
435
- },
436
- {
437
- "geradoEm": "2026-04-02T00:02:31.211Z",
438
- "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\linguagem_composta.sema",
439
- "modulo": "sema.produto.linguagem_composta",
440
- "perfilCompatibilidade": "interno",
441
- "scoreSemantico": 90,
442
- "confiancaGeral": "alta",
443
- "riscoOperacional": "alto",
444
- "faz": "governa 1 superficie(s), 6 task(s) com foco em regressao composta",
445
- "tarefasPrincipais": [
446
- "interpretar_bloco_nomeado",
447
- "converter_bloco_composto_para_ir",
448
- "formatar_bloco_composto",
449
- "gerar_teste_python_composto",
450
- "gerar_teste_typescript_composto",
451
- "gerar_teste_lua_composto"
452
- ],
453
- "entradasChave": [
454
- "interpretar_bloco_nomeado(arquivo_semantico, sinais)",
455
- "converter_bloco_composto_para_ir(arquivo_semantico)",
456
- "formatar_bloco_composto(arquivo_semantico)",
457
- "gerar_teste_python_composto(contrato)"
458
- ],
459
- "saidasChave": [
460
- "interpretar_bloco_nomeado(ast_valida, blocos_preservados, status)",
461
- "converter_bloco_composto_para_ir(ir_coerente, contexto_preservado, status)",
462
- "formatar_bloco_composto(formato_canonico, bloco_legivel)",
463
- "gerar_teste_python_composto(dataclass_aninhada, comparacao_tipada)"
464
- ],
465
- "superficiesPublicas": [
466
- "storage:regressao_composta"
467
- ],
468
- "regrasCriticas": [
469
- "asserts_coerentes existe",
470
- "ast_valida existe",
471
- "bloco_legivel existe",
472
- "blocos_preservados existe",
473
- "comparacao_tipada existe",
474
- "contexto_preservado existe",
475
- "dataclass_aninhada existe",
476
- "formato_canonico existe"
477
- ],
478
- "efeitos": [],
479
- "erros": [],
480
- "entidadesAfetadas": [
481
- "SinalTesteComposto",
482
- "StatusEvolucao"
483
- ],
484
- "arquivosProvaveis": [
485
- "C:\\GitHub\\Sema\\pacotes\\gerador-lua\\src\\index.ts",
486
- "C:\\GitHub\\Sema\\pacotes\\gerador-python\\src\\index.ts",
487
- "C:\\GitHub\\Sema\\pacotes\\gerador-typescript\\src\\index.ts",
488
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
489
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
490
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\parser\\parser.ts"
491
- ],
492
- "simbolosRelacionados": [
493
- "converterParaIr",
494
- "formatarCodigo",
495
- "gerarLua",
496
- "gerarPython",
497
- "gerarTypeScript",
498
- "parsear"
499
- ],
500
- "riscosPrincipais": [
501
- "converter_bloco_composto_para_ir:alto",
502
- "formatar_bloco_composto:medio",
503
- "gerar_teste_lua_composto:medio",
504
- "gerar_teste_python_composto:medio",
505
- "gerar_teste_typescript_composto:medio",
506
- "interpretar_bloco_nomeado:alto"
507
- ],
508
- "lacunas": [
509
- "execucao_implicita",
510
- "sem_impl",
511
- "sem_vinculos"
512
- ],
513
- "inferido": [
514
- "converter_bloco_composto_para_ir:pacotes/nucleo/src/ir/conversor.ts",
515
- "formatar_bloco_composto:pacotes/nucleo/src/formatador/index.ts",
516
- "gerar_teste_lua_composto:pacotes/gerador-lua/src/index.ts",
517
- "gerar_teste_python_composto:pacotes/gerador-python/src/index.ts",
518
- "gerar_teste_typescript_composto:pacotes/gerador-typescript/src/index.ts",
519
- "interpretar_bloco_nomeado:pacotes/nucleo/src/parser/parser.ts"
520
- ],
521
- "checksSugeridos": [
522
- "revisar efeitos operacionais",
523
- "rodar sema drift --json",
524
- "rodar sema validar --json",
525
- "verificar guarantees"
526
- ],
527
- "testesMinimos": [
528
- "sema drift <arquivo> --json",
529
- "sema validar <arquivo> --json",
530
- "sema verificar <arquivo-ou-pasta> --json"
531
- ],
532
- "consumerFramework": "nextjs-consumer",
533
- "appRoutes": [],
534
- "consumerSurfaces": [],
535
- "consumerBridges": [],
536
- "arquivosProvaveisEditar": [
537
- "C:\\GitHub\\Sema\\pacotes\\gerador-lua\\src\\index.ts",
538
- "C:\\GitHub\\Sema\\pacotes\\gerador-python\\src\\index.ts",
539
- "C:\\GitHub\\Sema\\pacotes\\gerador-typescript\\src\\index.ts",
540
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
541
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
542
- "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\parser\\parser.ts"
543
- ]
544
- }
545
- ]
546
- }
1
+ {
2
+ "comando": "resumo-projeto",
3
+ "geradoEm": "2026-03-31T16:04:57.600Z",
4
+ "cliVersao": "1.0.0",
5
+ "baseProjeto": "C:\\GitHub\\Sema",
6
+ "totalModulos": 4,
7
+ "entradaCanonica": {
8
+ "descricao": "Entrada canonica do repositorio para IA. O repo nao e human-first; a IA deve começar por esses artefatos antes de abrir codigo cru.",
9
+ "ordemLeitura": [
10
+ "llms.txt",
11
+ "SEMA_BRIEF.md",
12
+ "SEMA_INDEX.json",
13
+ "AGENTS.md",
14
+ "README.md",
15
+ "llms-full.txt"
16
+ ],
17
+ "porCapacidade": {
18
+ "pequena": [
19
+ "llms.txt",
20
+ "SEMA_BRIEF.micro.txt",
21
+ "SEMA_INDEX.json",
22
+ "AGENTS.md"
23
+ ],
24
+ "media": [
25
+ "llms.txt",
26
+ "SEMA_BRIEF.curto.txt",
27
+ "SEMA_INDEX.json",
28
+ "AGENTS.md",
29
+ "README.md"
30
+ ],
31
+ "grande": [
32
+ "llms-full.txt",
33
+ "SEMA_BRIEF.md",
34
+ "SEMA_INDEX.json",
35
+ "AGENTS.md",
36
+ "README.md"
37
+ ]
38
+ },
39
+ "docsSuporte": [
40
+ "docs/AGENT_STARTER.md",
41
+ "docs/integracao-com-ia.md",
42
+ "docs/fluxo-pratico-ia-sema.md",
43
+ "docs/como-ensinar-a-sema-para-ia.md",
44
+ "docs/sintaxe.md",
45
+ "docs/cli.md"
46
+ ],
47
+ "guiaPorCapacidade": {
48
+ "pequena": {
49
+ "descricao": "IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo.",
50
+ "artefatos": [
51
+ "resumo.micro.txt",
52
+ "briefing.min.json",
53
+ "prompt-curto.txt"
54
+ ],
55
+ "ordemLeitura": [
56
+ "resumo.micro.txt",
57
+ "briefing.min.json",
58
+ "resumo.curto.txt"
59
+ ],
60
+ "evitar": [
61
+ "ast.json",
62
+ "ir.json",
63
+ "diagnosticos.json"
64
+ ]
65
+ },
66
+ "media": {
67
+ "descricao": "IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift.",
68
+ "artefatos": [
69
+ "resumo.curto.txt",
70
+ "briefing.min.json",
71
+ "drift.json",
72
+ "prompt-curto.txt"
73
+ ],
74
+ "ordemLeitura": [
75
+ "resumo.curto.txt",
76
+ "briefing.min.json",
77
+ "drift.json",
78
+ "resumo.md"
79
+ ],
80
+ "evitar": [
81
+ "ast.json"
82
+ ]
83
+ },
84
+ "grande": {
85
+ "descricao": "IA com contexto grande ou tool use. Pode consumir o pacote completo.",
86
+ "artefatos": [
87
+ "README.md",
88
+ "resumo.md",
89
+ "briefing.json",
90
+ "drift.json",
91
+ "ir.json",
92
+ "ast.json"
93
+ ],
94
+ "ordemLeitura": [
95
+ "README.md",
96
+ "resumo.md",
97
+ "briefing.json",
98
+ "drift.json",
99
+ "ir.json",
100
+ "ast.json"
101
+ ],
102
+ "evitar": []
103
+ }
104
+ }
105
+ },
106
+ "guiaPorCapacidade": {
107
+ "pequena": {
108
+ "descricao": "IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo.",
109
+ "artefatos": [
110
+ "resumo.micro.txt",
111
+ "briefing.min.json",
112
+ "prompt-curto.txt"
113
+ ],
114
+ "ordemLeitura": [
115
+ "resumo.micro.txt",
116
+ "briefing.min.json",
117
+ "resumo.curto.txt"
118
+ ],
119
+ "evitar": [
120
+ "ast.json",
121
+ "ir.json",
122
+ "diagnosticos.json"
123
+ ]
124
+ },
125
+ "media": {
126
+ "descricao": "IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift.",
127
+ "artefatos": [
128
+ "resumo.curto.txt",
129
+ "briefing.min.json",
130
+ "drift.json",
131
+ "prompt-curto.txt"
132
+ ],
133
+ "ordemLeitura": [
134
+ "resumo.curto.txt",
135
+ "briefing.min.json",
136
+ "drift.json",
137
+ "resumo.md"
138
+ ],
139
+ "evitar": [
140
+ "ast.json"
141
+ ]
142
+ },
143
+ "grande": {
144
+ "descricao": "IA com contexto grande ou tool use. Pode consumir o pacote completo.",
145
+ "artefatos": [
146
+ "README.md",
147
+ "resumo.md",
148
+ "briefing.json",
149
+ "drift.json",
150
+ "ir.json",
151
+ "ast.json"
152
+ ],
153
+ "ordemLeitura": [
154
+ "README.md",
155
+ "resumo.md",
156
+ "briefing.json",
157
+ "drift.json",
158
+ "ir.json",
159
+ "ast.json"
160
+ ],
161
+ "evitar": []
162
+ }
163
+ },
164
+ "modulos": [
165
+ {
166
+ "geradoEm": "2026-03-31T16:04:57.600Z",
167
+ "arquivo": "C:\\GitHub\\Sema\\contratos\\pedidos.sema",
168
+ "modulo": "app.pedidos",
169
+ "perfilCompatibilidade": "publico",
170
+ "scoreSemantico": 50,
171
+ "confiancaGeral": "baixa",
172
+ "riscoOperacional": "alto",
173
+ "faz": "governa 1 rota(s), 1 task(s) com foco em criar pedido publico",
174
+ "tarefasPrincipais": [
175
+ "criar_pedido"
176
+ ],
177
+ "entradasChave": [
178
+ "criar_pedido(cliente_id, total)"
179
+ ],
180
+ "saidasChave": [
181
+ "criar_pedido(pedido_id, status)"
182
+ ],
183
+ "superficiesPublicas": [
184
+ "POST /pedidos"
185
+ ],
186
+ "regrasCriticas": [
187
+ "pedido_id existe",
188
+ "status existe",
189
+ "total > 0"
190
+ ],
191
+ "efeitos": [
192
+ "auditoria pedidos",
193
+ "persistencia Pedido criticidade = alta"
194
+ ],
195
+ "erros": [],
196
+ "entidadesAfetadas": [
197
+ "Pedido",
198
+ "pedidos"
199
+ ],
200
+ "arquivosProvaveis": [],
201
+ "simbolosRelacionados": [],
202
+ "riscosPrincipais": [
203
+ "altera_persistencia",
204
+ "criar_pedido:alto",
205
+ "efeito_critico",
206
+ "vinculo_fraco"
207
+ ],
208
+ "lacunas": [
209
+ "execucao_implicita",
210
+ "sem_impl",
211
+ "sem_vinculos"
212
+ ],
213
+ "inferido": [],
214
+ "checksSugeridos": [
215
+ "revisar efeitos operacionais",
216
+ "rodar sema drift --json",
217
+ "rodar sema validar --json",
218
+ "verificar guarantees"
219
+ ],
220
+ "testesMinimos": [
221
+ "sema drift <arquivo> --json",
222
+ "sema validar <arquivo> --json",
223
+ "sema verificar <arquivo-ou-pasta> --json"
224
+ ]
225
+ },
226
+ {
227
+ "geradoEm": "2026-03-31T16:04:57.600Z",
228
+ "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\ergonomia_e_dominio.sema",
229
+ "modulo": "sema.produto.ergonomia_e_dominio",
230
+ "perfilCompatibilidade": "interno",
231
+ "scoreSemantico": 90,
232
+ "confiancaGeral": "alta",
233
+ "riscoOperacional": "alto",
234
+ "faz": "governa 2 superficie(s), 5 task(s) com foco em scorecard atualizado",
235
+ "tarefasPrincipais": [
236
+ "reduzir_atrito_sintatico_em_contrato_rico",
237
+ "modelar_payload_com_mais_precisao",
238
+ "explicitar_variacao_e_compatibilidade",
239
+ "separar_validacao_regra_e_poscondicao",
240
+ "consultar_scorecard_compatibilidade"
241
+ ],
242
+ "entradasChave": [
243
+ "reduzir_atrito_sintatico_em_contrato_rico(contrato_atual, repeticao_detectada)",
244
+ "modelar_payload_com_mais_precisao(contrato_atual, payload_json_generico, exemplos_payload)",
245
+ "explicitar_variacao_e_compatibilidade(contrato_atual, perfil_atual)",
246
+ "separar_validacao_regra_e_poscondicao(contrato_atual, garantias_confusas)"
247
+ ],
248
+ "saidasChave": [
249
+ "reduzir_atrito_sintatico_em_contrato_rico(leitura_mais_limpa, ambiguidade_controlada, perfil)",
250
+ "modelar_payload_com_mais_precisao(tipo_composto_explicito, cardinalidade_explicita, shape_rico)",
251
+ "explicitar_variacao_e_compatibilidade(versao_explicita, fallback_claro, contrato_publico_distinto)",
252
+ "separar_validacao_regra_e_poscondicao(validacao_de_input_clara, regra_de_negocio_clara, pos_condicao_clara)"
253
+ ],
254
+ "superficiesPublicas": [
255
+ "evento:scorecard_atualizado",
256
+ "policy:compatibilidade_publica"
257
+ ],
258
+ "regrasCriticas": [
259
+ "ambiguidade_controlada existe",
260
+ "cardinalidade_explicita existe",
261
+ "contrato_publico_distinto existe",
262
+ "fallback_claro existe",
263
+ "leitura_mais_limpa existe",
264
+ "nota existe",
265
+ "perfil em [ PUBLICO , INTERNO , EXPERIMENTAL , LEGADO , DEPRECADO ]",
266
+ "pos_condicao_clara existe"
267
+ ],
268
+ "efeitos": [],
269
+ "erros": [],
270
+ "entidadesAfetadas": [
271
+ "PerfilCompatibilidade"
272
+ ],
273
+ "arquivosProvaveis": [
274
+ "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
275
+ "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
276
+ "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
277
+ "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\semantico\\analisador.ts"
278
+ ],
279
+ "simbolosRelacionados": [
280
+ "analisarSemantica",
281
+ "converterParaIr",
282
+ "formatarCodigo",
283
+ "resolverAlvosVerificacao"
284
+ ],
285
+ "riscosPrincipais": [
286
+ "consultar_scorecard_compatibilidade:medio",
287
+ "explicitar_variacao_e_compatibilidade:medio",
288
+ "modelar_payload_com_mais_precisao:alto",
289
+ "reduzir_atrito_sintatico_em_contrato_rico:medio",
290
+ "separar_validacao_regra_e_poscondicao:medio"
291
+ ],
292
+ "lacunas": [
293
+ "execucao_implicita",
294
+ "sem_impl",
295
+ "sem_vinculos"
296
+ ],
297
+ "inferido": [
298
+ "consultar_scorecard_compatibilidade:pacotes/cli/src/projeto.ts",
299
+ "evento:scorecard_atualizado:scorecard_compatibilidade",
300
+ "explicitar_variacao_e_compatibilidade:pacotes/nucleo/src/ir/conversor.ts",
301
+ "modelar_payload_com_mais_precisao:pacotes/nucleo/src/semantico/analisador.ts",
302
+ "policy:compatibilidade_publica:compatibilidade_publica",
303
+ "reduzir_atrito_sintatico_em_contrato_rico:pacotes/nucleo/src/formatador/index.ts"
304
+ ],
305
+ "checksSugeridos": [
306
+ "revisar efeitos operacionais",
307
+ "rodar sema drift --json",
308
+ "rodar sema validar --json",
309
+ "verificar guarantees"
310
+ ],
311
+ "testesMinimos": [
312
+ "sema drift <arquivo> --json",
313
+ "sema validar <arquivo> --json",
314
+ "sema verificar <arquivo-ou-pasta> --json"
315
+ ]
316
+ },
317
+ {
318
+ "geradoEm": "2026-03-31T16:04:57.600Z",
319
+ "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\governanca_ia.sema",
320
+ "modulo": "sema.produto.governanca_ia",
321
+ "perfilCompatibilidade": "publico",
322
+ "scoreSemantico": 90,
323
+ "confiancaGeral": "alta",
324
+ "riscoOperacional": "alto",
325
+ "faz": "governa 2 superficie(s), 4 task(s) com foco em preparar briefing contextual",
326
+ "tarefasPrincipais": [
327
+ "mapear_projeto_sem_adivinhacao",
328
+ "normalizar_saida_sem_ruido",
329
+ "medir_drift_contra_codigo_vivo",
330
+ "padronizar_nomes_para_leitura_de_ia"
331
+ ],
332
+ "entradasChave": [
333
+ "mapear_projeto_sem_adivinhacao(entrada, explicito)",
334
+ "normalizar_saida_sem_ruido(estrutura_desejada)",
335
+ "medir_drift_contra_codigo_vivo(contrato_alvo, codigo_vivo)",
336
+ "padronizar_nomes_para_leitura_de_ia(contrato_atual, sinonimos_em_excesso)"
337
+ ],
338
+ "saidasChave": [
339
+ "mapear_projeto_sem_adivinhacao(base_resolvida, origens_coerentes, codigo_vivo_detectado)",
340
+ "normalizar_saida_sem_ruido(estrutura_canonica, alias_confuso)",
341
+ "medir_drift_contra_codigo_vivo(impls_resolvidas, rotas_resolvidas, ambiguidades_explicitas)",
342
+ "padronizar_nomes_para_leitura_de_ia(nomes_consistentes, leitura_rapida, casos_especiais_reduzidos)"
343
+ ],
344
+ "superficiesPublicas": [
345
+ "webhook:confirmar_contexto_publico",
346
+ "worker:preparar_briefing_contextual"
347
+ ],
348
+ "regrasCriticas": [
349
+ "alias_confuso existe",
350
+ "ambiguidades_explicitas existe",
351
+ "base_resolvida existe",
352
+ "casos_especiais_reduzidos existe",
353
+ "codigo_vivo_detectado existe",
354
+ "estrutura_canonica existe",
355
+ "impls_resolvidas existe",
356
+ "leitura_rapida existe"
357
+ ],
358
+ "efeitos": [],
359
+ "erros": [
360
+ "simbolo_ambiguo"
361
+ ],
362
+ "entidadesAfetadas": [],
363
+ "arquivosProvaveis": [
364
+ "C:\\GitHub\\Sema\\pacotes\\cli\\src\\drift.ts",
365
+ "C:\\GitHub\\Sema\\pacotes\\cli\\src\\index.ts",
366
+ "C:\\GitHub\\Sema\\pacotes\\cli\\src\\projeto.ts",
367
+ "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts"
368
+ ],
369
+ "simbolosRelacionados": [
370
+ "analisarDriftLegado",
371
+ "carregarProjeto",
372
+ "comandoContextoIa",
373
+ "formatarCodigo",
374
+ "normalizarEstruturaSaida"
375
+ ],
376
+ "riscosPrincipais": [
377
+ "mapear_projeto_sem_adivinhacao:medio",
378
+ "medir_drift_contra_codigo_vivo:alto",
379
+ "normalizar_saida_sem_ruido:medio",
380
+ "padronizar_nomes_para_leitura_de_ia:medio"
381
+ ],
382
+ "lacunas": [
383
+ "execucao_implicita",
384
+ "sem_impl",
385
+ "sem_vinculos"
386
+ ],
387
+ "inferido": [
388
+ "mapear_projeto_sem_adivinhacao:pacotes/cli/src/projeto.ts",
389
+ "medir_drift_contra_codigo_vivo:pacotes/cli/src/drift.ts",
390
+ "normalizar_saida_sem_ruido:pacotes/cli/src/projeto.ts",
391
+ "padronizar_nomes_para_leitura_de_ia:pacotes/nucleo/src/formatador/index.ts",
392
+ "sema.produto.governanca_ia:pacotes/cli/src/index.ts",
393
+ "webhook:confirmar_contexto_publico:/ interno / contexto-ia"
394
+ ],
395
+ "checksSugeridos": [
396
+ "revisar efeitos operacionais",
397
+ "rodar sema drift --json",
398
+ "rodar sema validar --json",
399
+ "verificar guarantees"
400
+ ],
401
+ "testesMinimos": [
402
+ "sema drift <arquivo> --json",
403
+ "sema validar <arquivo> --json",
404
+ "sema verificar <arquivo-ou-pasta> --json"
405
+ ]
406
+ },
407
+ {
408
+ "geradoEm": "2026-03-31T16:04:57.600Z",
409
+ "arquivo": "C:\\GitHub\\Sema\\contratos\\sema\\linguagem_composta.sema",
410
+ "modulo": "sema.produto.linguagem_composta",
411
+ "perfilCompatibilidade": "interno",
412
+ "scoreSemantico": 90,
413
+ "confiancaGeral": "alta",
414
+ "riscoOperacional": "alto",
415
+ "faz": "governa 1 superficie(s), 5 task(s) com foco em regressao composta",
416
+ "tarefasPrincipais": [
417
+ "interpretar_bloco_nomeado",
418
+ "converter_bloco_composto_para_ir",
419
+ "formatar_bloco_composto",
420
+ "gerar_teste_python_composto",
421
+ "gerar_teste_typescript_composto"
422
+ ],
423
+ "entradasChave": [
424
+ "interpretar_bloco_nomeado(arquivo_semantico, sinais)",
425
+ "converter_bloco_composto_para_ir(arquivo_semantico)",
426
+ "formatar_bloco_composto(arquivo_semantico)",
427
+ "gerar_teste_python_composto(contrato)"
428
+ ],
429
+ "saidasChave": [
430
+ "interpretar_bloco_nomeado(ast_valida, blocos_preservados, status)",
431
+ "converter_bloco_composto_para_ir(ir_coerente, contexto_preservado, status)",
432
+ "formatar_bloco_composto(formato_canonico, bloco_legivel)",
433
+ "gerar_teste_python_composto(dataclass_aninhada, comparacao_tipada)"
434
+ ],
435
+ "superficiesPublicas": [
436
+ "storage:regressao_composta"
437
+ ],
438
+ "regrasCriticas": [
439
+ "asserts_coerentes existe",
440
+ "ast_valida existe",
441
+ "bloco_legivel existe",
442
+ "blocos_preservados existe",
443
+ "comparacao_tipada existe",
444
+ "contexto_preservado existe",
445
+ "dataclass_aninhada existe",
446
+ "formato_canonico existe"
447
+ ],
448
+ "efeitos": [],
449
+ "erros": [],
450
+ "entidadesAfetadas": [
451
+ "SinalTesteComposto",
452
+ "StatusEvolucao"
453
+ ],
454
+ "arquivosProvaveis": [
455
+ "C:\\GitHub\\Sema\\pacotes\\gerador-python\\src\\index.ts",
456
+ "C:\\GitHub\\Sema\\pacotes\\gerador-typescript\\src\\index.ts",
457
+ "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\formatador\\index.ts",
458
+ "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\ir\\conversor.ts",
459
+ "C:\\GitHub\\Sema\\pacotes\\nucleo\\src\\parser\\parser.ts"
460
+ ],
461
+ "simbolosRelacionados": [
462
+ "converterParaIr",
463
+ "formatarCodigo",
464
+ "gerarPython",
465
+ "gerarTypeScript",
466
+ "parsear"
467
+ ],
468
+ "riscosPrincipais": [
469
+ "converter_bloco_composto_para_ir:alto",
470
+ "formatar_bloco_composto:medio",
471
+ "gerar_teste_python_composto:medio",
472
+ "gerar_teste_typescript_composto:medio",
473
+ "interpretar_bloco_nomeado:alto"
474
+ ],
475
+ "lacunas": [
476
+ "execucao_implicita",
477
+ "sem_impl",
478
+ "sem_vinculos"
479
+ ],
480
+ "inferido": [
481
+ "converter_bloco_composto_para_ir:pacotes/nucleo/src/ir/conversor.ts",
482
+ "formatar_bloco_composto:pacotes/nucleo/src/formatador/index.ts",
483
+ "gerar_teste_python_composto:pacotes/gerador-python/src/index.ts",
484
+ "gerar_teste_typescript_composto:pacotes/gerador-typescript/src/index.ts",
485
+ "interpretar_bloco_nomeado:pacotes/nucleo/src/parser/parser.ts",
486
+ "sema.produto.linguagem_composta:pacotes/nucleo/src/parser/parser.ts"
487
+ ],
488
+ "checksSugeridos": [
489
+ "revisar efeitos operacionais",
490
+ "rodar sema drift --json",
491
+ "rodar sema validar --json",
492
+ "verificar guarantees"
493
+ ],
494
+ "testesMinimos": [
495
+ "sema drift <arquivo> --json",
496
+ "sema validar <arquivo> --json",
497
+ "sema verificar <arquivo-ou-pasta> --json"
498
+ ]
499
+ }
500
+ ]
501
+ }