@semacode/cli 1.5.47 → 1.5.48
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.
- package/AGENTS.md +81 -324
- package/AGENT_CONTEXT_PACK.json +62 -32
- package/SEMA_BRIEF.curto.txt +7 -7
- package/SEMA_BRIEF.md +38 -17
- package/SEMA_BRIEF.micro.txt +5 -5
- package/SEMA_INDEX.json +539 -220
- package/dist/agentContext.d.ts +1 -1
- package/dist/agentContextPack.js +60 -30
- package/dist/agentContextPack.js.map +1 -1
- package/dist/agentEntryPoints.js +120 -43
- package/dist/agentEntryPoints.js.map +1 -1
- package/dist/drift.part01.d.ts +1 -1
- package/dist/drift.part04.d.ts +1 -1
- package/dist/drift.part04.js +2 -2
- package/dist/drift.part04.js.map +1 -1
- package/dist/drift.part05.d.ts +3 -3
- package/dist/drift.part05.js +8 -8
- package/dist/drift.part05.js.map +1 -1
- package/dist/drift.part06.js +15 -8
- package/dist/drift.part06.js.map +1 -1
- package/dist/drift.part09.js +11 -7
- package/dist/drift.part09.js.map +1 -1
- package/dist/driftOrcamento.d.ts +11 -1
- package/dist/driftOrcamento.js +48 -18
- package/dist/driftOrcamento.js.map +1 -1
- package/dist/index.part02.js +4 -2
- package/dist/index.part02.js.map +1 -1
- package/dist/index.part04.js +3 -3
- package/dist/index.part04.js.map +1 -1
- package/dist/profileArtefatoValidadores.js +42 -0
- package/dist/profileArtefatoValidadores.js.map +1 -1
- package/dist/profileI18nCatalogo.js +2 -0
- package/dist/profileI18nCatalogo.js.map +1 -1
- package/dist/projetoConfig.js +7 -0
- package/dist/projetoConfig.js.map +1 -1
- package/dist/projetoLegado.js +10 -3
- package/dist/projetoLegado.js.map +1 -1
- package/dist/runnerValidacaoRemotaWorkspace.js +4 -1
- package/dist/runnerValidacaoRemotaWorkspace.js.map +1 -1
- package/dist/tipos.d.ts +1 -1
- package/docs/AGENT_STARTER.md +36 -0
- package/docs/agentes-por-capacidade.md +26 -22
- package/docs/comandos.md +105 -0
- package/docs/env.md +2 -2
- package/docs/extensao-vscode.md +1 -1
- package/docs/fluxo-pratico-ia-sema.md +63 -0
- package/docs/sintaxe.md +178 -6
- package/node_modules/@sema/gerador-css/dist/index.part01.js +1 -0
- package/node_modules/@sema/gerador-css/dist/index.part01.js.map +1 -1
- package/node_modules/@sema/gerador-css/package.json +1 -1
- package/node_modules/@sema/gerador-dart/dist/index.js +1 -0
- package/node_modules/@sema/gerador-dart/dist/index.js.map +1 -1
- package/node_modules/@sema/gerador-dart/package.json +1 -1
- package/node_modules/@sema/gerador-html/dist/index.js +1 -0
- package/node_modules/@sema/gerador-html/dist/index.js.map +1 -1
- package/node_modules/@sema/gerador-html/package.json +1 -1
- package/node_modules/@sema/gerador-javascript/dist/index.js +1 -0
- package/node_modules/@sema/gerador-javascript/dist/index.js.map +1 -1
- package/node_modules/@sema/gerador-javascript/package.json +1 -1
- package/node_modules/@sema/gerador-lua/dist/index.js +1 -0
- package/node_modules/@sema/gerador-lua/dist/index.js.map +1 -1
- package/node_modules/@sema/gerador-lua/package.json +1 -1
- package/node_modules/@sema/gerador-python/dist/index.part02.js +1 -0
- package/node_modules/@sema/gerador-python/dist/index.part02.js.map +1 -1
- package/node_modules/@sema/gerador-python/package.json +1 -1
- package/node_modules/@sema/gerador-typescript/dist/index.part02.js +1 -0
- package/node_modules/@sema/gerador-typescript/dist/index.part02.js.map +1 -1
- package/node_modules/@sema/gerador-typescript/package.json +1 -1
- package/node_modules/@sema/nucleo/dist/ast/tipos.d.ts +1 -1
- package/node_modules/@sema/nucleo/dist/ir/conversor.part01.js +4 -0
- package/node_modules/@sema/nucleo/dist/ir/conversor.part01.js.map +1 -1
- package/node_modules/@sema/nucleo/dist/ir/conversor.part02.d.ts +1 -1
- package/node_modules/@sema/nucleo/dist/ir/modelos.d.ts +3 -3
- package/node_modules/@sema/nucleo/dist/parser/parser.declaracoes.js +3 -0
- package/node_modules/@sema/nucleo/dist/parser/parser.declaracoes.js.map +1 -1
- package/node_modules/@sema/nucleo/dist/semantico/analisador.part01.d.ts +2 -2
- package/node_modules/@sema/nucleo/dist/semantico/analisador.part01.js +4 -1
- package/node_modules/@sema/nucleo/dist/semantico/analisador.part01.js.map +1 -1
- package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.d.ts +2 -2
- package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js +11 -5
- package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js.map +1 -1
- package/node_modules/@sema/nucleo/package.json +1 -1
- package/node_modules/@sema/padroes/package.json +1 -1
- package/package.json +10 -10
package/AGENT_CONTEXT_PACK.json
CHANGED
|
@@ -18,23 +18,25 @@
|
|
|
18
18
|
"Leia SEMA_BOOT.md antes de qualquer outro artefato de IA.",
|
|
19
19
|
"Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy.",
|
|
20
20
|
"Leia docs/comandos.md antes de escolher comando Sema, interpretar bloqueio do Guard ou usar --saida de sema compilar.",
|
|
21
|
-
"Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois chame sema preflight <comando> --json e use a CLI somente com use_cli_local; não use
|
|
21
|
+
"Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois chame sema preflight <comando> --json e use a CLI somente com use_cli_local; não use rota remota, sincronização externa ou leitura por espelho para workspace local.",
|
|
22
22
|
"Antes de editar, chame sema_inspecionar no contrato aplicável e rode sema_drift e sema_impacto.",
|
|
23
23
|
"Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.",
|
|
24
24
|
"Use SEMA_INDEX.json para escolher contrato, módulo e arquivos prováveis antes de abrir código cru.",
|
|
25
25
|
"Valide .sema alterado e rode drift antes de concluir.",
|
|
26
|
+
"Conclusao so e valida se `sema drift --json` retornar sucesso:true, sem `vinculos_quebrados`, sem `rotas_divergentes` e sem impls quebradas.",
|
|
26
27
|
"Quando faltar contrato aplicável ou vínculo semântico do arquivo, inspecione o arquivo, crie/edite o contrato aplicável e vincule antes do código.",
|
|
27
28
|
"Sema não contorna políticas da plataforma; ele governa contrato, escopo, drift, evidência e qualidade.",
|
|
28
29
|
"Responda no idioma do usuário; em PT-BR, use vocabulário Sema canônico e preserve acentos, cedilha, pontuação e símbolos humanos.",
|
|
29
30
|
"Use pontuação composta, achados e decisaoAgente como sinais de triagem; abaixo de 80 bloqueia, o alvo evolui 0.5 ponto até 100, e toda pontuação exige contrato, código e evidência.",
|
|
30
31
|
"Mantenha o cabeçalho SEMA-GOVERNED em código gerado ou governado e volte ao contrato antes de editar.",
|
|
31
32
|
"Validação inline não dispensa cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
|
|
32
|
-
"Payload inline
|
|
33
|
-
"
|
|
34
|
-
"
|
|
35
|
-
"
|
|
33
|
+
"Payload inline acima de 262144 caracteres deve ser dividido por responsabilidade ou enviado por transporte autorizado; não é timeout para escalar.",
|
|
34
|
+
"Nao crie nem conclua codigo governado acima de 2000 linhas; acima de 1000, planeje divisao por responsabilidade. Documentacao Markdown nao entra nesse limite de codigo.",
|
|
35
|
+
"Nao crie nem edite contrato .sema acima de 500 linhas; acima de 300, planeje split por dominio/capacidade.",
|
|
36
|
+
"Divida contratos .sema por capacidade real, nunca parte_1/parte_2; varios contratos podem apontar para o mesmo arquivo de codigo por vinculos.",
|
|
37
|
+
"Caminho de servidor ou espelho governado do Sema não é o checkout local do usuário.",
|
|
36
38
|
"Se uma chamada Sema estourar por timeout local, aumente o timeout e tente novamente; não trate lentidão como sessão inativa.",
|
|
37
|
-
"Se a tarefa tiver UI, trate
|
|
39
|
+
"Se a tarefa tiver site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal, trate acabamento moderno, contextual, responsividade real ou ergonomia de comando como requisito governado."
|
|
38
40
|
],
|
|
39
41
|
"proibicoes": [
|
|
40
42
|
"Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
|
|
@@ -43,32 +45,35 @@
|
|
|
43
45
|
"Não tratar a pasta --saida de sema compilar como entrega final; entrega são os arquivos alvo/vínculos do contrato.",
|
|
44
46
|
"Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
|
|
45
47
|
"Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
|
|
46
|
-
"Não assumir repositório público, GitHub Release pública, leitura local
|
|
48
|
+
"Não assumir repositório público, GitHub Release pública, leitura local por espelho ou acesso da IA ao painel; em IDE local prove CLI com sema --version.",
|
|
47
49
|
"Não usar a estética ASCII da DSL nem inglês de produto como desculpa para fugir do vocabulário Sema em PT-BR.",
|
|
48
50
|
"Não remover SEMA-GOVERNED nem substituir drift por comentário dentro do código.",
|
|
49
51
|
"Não copiar o contrato inteiro para comentário de código; mantenha descrição humana curta.",
|
|
50
|
-
"
|
|
51
|
-
"
|
|
52
|
+
"Nao tratar orcamento semantico como sugestao; codigo governado ou contrato .sema grande deve ser dividido antes de concluir.",
|
|
53
|
+
"Nao fatiar codigo ou contrato grande em partes sem responsabilidade real para passar no limite.",
|
|
52
54
|
"Não tratar score 100, regex ou presença de palavra-chave como prova suficiente de governança; pontuação abaixo do piso ou do alvo evolutivo bloqueia conclusão.",
|
|
55
|
+
"Nao dizer que drift passou limpo quando o JSON trouxe sucesso:false, vinculos_quebrados, rotas_divergentes ou impls quebradas.",
|
|
53
56
|
"Não tratar validação inline como dispensa de cabeçalho SEMA-GOVERNED no arquivo físico.",
|
|
54
57
|
"Não tentar resolver payload inline acima de 262144 caracteres aumentando timeout.",
|
|
55
|
-
"
|
|
58
|
+
"Nao culpar o limite de 2000 linhas para codigo ou 500 linhas para .sema por arquitetura monolitica escolhida pela IA.",
|
|
56
59
|
"Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate.",
|
|
57
60
|
"Não usar Sema para contornar política, segurança, permissões, termos ou filtros da plataforma.",
|
|
58
|
-
"Não entregar
|
|
61
|
+
"Não entregar site, app, painel ou terminal genérico, engessado, com cara de template antigo, sem domínio, sem estados ou sem ergonomia real.",
|
|
62
|
+
"Nao declarar UI responsiva sem teste mobile/desktop; scroll horizontal em 390px bloqueia fechamento."
|
|
59
63
|
],
|
|
60
64
|
"prioridades": [
|
|
61
65
|
"Menor artefato suficiente primeiro.",
|
|
62
|
-
"IDE local: sema --version, preflight, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare. A IA não acessa o painel Sema: peça ao humano instalar pelo painel; sem
|
|
66
|
+
"IDE local: sema --version, preflight, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare. A IA não acessa o painel Sema: peça ao humano instalar pelo painel; sem rota remota, sincronização externa ou leitura por espelho para workspace.",
|
|
63
67
|
"Contrato, índice e AGENTS complementam o contexto Sema; não substituem chamada Sema.",
|
|
64
68
|
"Exemplos oficiais antes de nova sintaxe.",
|
|
65
69
|
"Diagnóstico estruturado antes de opinião livre.",
|
|
66
70
|
"Compatibilidade com políticas da plataforma antes de reformular ou continuar após alerta externo.",
|
|
67
71
|
"Sinal sem evidência vira ritual; evidência concreta antes de concluir aderência.",
|
|
68
72
|
"Retry progressivo em timeout antes de declarar bloqueio.",
|
|
73
|
+
"Fechamento honesto: drift JSON verde antes de dizer concluido; sucesso:false, vinculo quebrado ou rota divergente ainda e bloqueio.",
|
|
69
74
|
"Separar limite de transporte inline de lentidão real: payload grande demais exige split/transporte correto, não retry infinito.",
|
|
70
75
|
"Orçamento semântico, divisão por responsabilidade e cabeçalho governado antes de gravar ou finalizar código.",
|
|
71
|
-
"
|
|
76
|
+
"Acabamento visual/terminal por capacidade quando houver experiência de uso, com prova de viewport mobile sem overflow horizontal ou smoke check de comando.",
|
|
72
77
|
"Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto."
|
|
73
78
|
],
|
|
74
79
|
"fontes": [
|
|
@@ -353,12 +358,12 @@
|
|
|
353
358
|
},
|
|
354
359
|
"politicaCodigoGovernado": {
|
|
355
360
|
"marcador": "SEMA-GOVERNED",
|
|
356
|
-
"regra": "Arquivos de
|
|
361
|
+
"regra": "Arquivos de codigo gerados ou governados pela Sema devem manter cabecalho curto com modulo de origem, contrato .sema aplicavel e descricao humana. Validacao inline prova apenas o payload enviado; o arquivo fisico ainda precisa de SEMA-GOVERNED para orientar a proxima IA. Codigo governado avisa acima de 1000 linhas e bloqueia acima de 2000. Contrato .sema avisa acima de 300 linhas e bloqueia criacao, edicao, drift, finalizacao, geracao e snapshot acima de 500. O split de .sema deve ser por dominio/capacidade, nunca parte_1/parte_2; varios contratos podem governar o mesmo arquivo de codigo via vinculos. Sema Codigo deve preservar essa rastreabilidade em cabecalhos e saidas geradas. Documentacao Markdown nao entra nesse limite de codigo; continua governada por docs-impacto, limite de bytes e verificacao de segredos. Payload inline acima de 262144 caracteres nao e caso de aumentar timeout: divida por responsabilidade ou use anexo/caminho de servidor autorizado.",
|
|
357
362
|
"descricaoHumana": "O comentário deve orientar humanos e IAs sem duplicar o contrato inteiro dentro do código: diga o que o arquivo implementa, qual contrato governa e onde a próxima IA deve olhar.",
|
|
358
363
|
"porCapacidade": {
|
|
359
|
-
"fraca": "Se abrir
|
|
360
|
-
"media": "Se abrir
|
|
361
|
-
"forte": "Se abrir
|
|
364
|
+
"fraca": "Se abrir codigo com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Nao crie codigo acima de 2000 linhas nem contrato .sema acima de 500; divida .sema por capacidade, nunca em parte_1/parte_2.",
|
|
365
|
+
"media": "Se abrir codigo com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate codigo 1000+ e contrato .sema 300+ como refatoracao provavel; se o payload inline passar de 262144 caracteres, separe HTML, estilos, estado, renderizacao, calculo e dados antes de sincronizar.",
|
|
366
|
+
"forte": "Se abrir codigo com SEMA-GOVERNED, pode inspecionar AST/IR e codigo completo, mas mantem contrato primeiro, drift, codigo ate 2000, .sema ate 500 e finalizar-mudanca. Contexto grande nao autoriza monolito nem payload inline acima de 262144 caracteres."
|
|
362
367
|
},
|
|
363
368
|
"formatosPorAlvo": {
|
|
364
369
|
"typescript": "// SEMA-GOVERNED",
|
|
@@ -387,9 +392,9 @@
|
|
|
387
392
|
}
|
|
388
393
|
},
|
|
389
394
|
"politicaDesignVisual": {
|
|
390
|
-
"regra": "Quando a tarefa envolve
|
|
395
|
+
"regra": "Quando a tarefa envolve site, sistema, app, interface, dashboard, painel, formulário, landing, jogo, terminal, CLI/TUI ou qualquer artefato voltado ao usuário, o Sema governa também acabamento, modernidade e adequação ao domínio. Beleza funcional, identidade, criatividade útil, tecnologia adequada, estados, responsividade e evidência não são extras opcionais.",
|
|
391
396
|
"modernoObrigatorio": true,
|
|
392
|
-
"aplicarQuando": "site, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual ou qualquer entrega com
|
|
397
|
+
"aplicarQuando": "site, sistema, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual, CLI, TUI, terminal, relatório interativo ou qualquer entrega com experiência de uso.",
|
|
393
398
|
"proibicoes": [
|
|
394
399
|
"interface_generica_2010",
|
|
395
400
|
"formularios_sem_hierarquia_visual",
|
|
@@ -398,38 +403,59 @@
|
|
|
398
403
|
"texto_estourando_ou_sobreposto",
|
|
399
404
|
"sem_estados_de_hover_focus_loading_erro_vazio",
|
|
400
405
|
"sem_assets_quando_o_dominio_pede_visual",
|
|
401
|
-
"
|
|
406
|
+
"mesma_estetica_para_dominios_diferentes",
|
|
407
|
+
"painel_agrono_com_cara_de_ecommerce_generico",
|
|
408
|
+
"terminal_sem_hierarquia_status_ou_feedback",
|
|
409
|
+
"ignorar_bibliotecas_atuais_quando_disponiveis",
|
|
410
|
+
"efeitos_gratuitos_sem_proposito",
|
|
411
|
+
"copiar_estetica_do_contrato_para_ui",
|
|
412
|
+
"declarar_responsivo_sem_prova_mobile",
|
|
413
|
+
"fechar_ui_com_scrollwidth_maior_que_clientwidth"
|
|
402
414
|
],
|
|
403
415
|
"porCapacidade": {
|
|
404
|
-
"fraca": "Use um padrão moderno seguro: hierarquia clara, espaçamento consistente, paleta com contraste, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Se não conseguir validar
|
|
405
|
-
"media": "Defina intenção
|
|
406
|
-
"forte": "Crie direção
|
|
416
|
+
"fraca": "Use um padrão moderno seguro e contextual: hierarquia clara, espaçamento consistente, paleta com contraste, componentes coerentes com o domínio, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Em terminal, entregue saída organizada com status e erro claros. Se não conseguir validar o resultado, pare e peça revisão.",
|
|
417
|
+
"media": "Defina intenção de experiência antes de codar: público, domínio, workflow real, densidade, tokens, componentes, tecnologia/biblioteca/efeitos adequados, estados, responsividade e anti-2010. O domínio manda na solução: agro, finanças, saúde, game e e-commerce não podem compartilhar a mesma casca. Rode ou peça screenshot/browser check quando houver UI e smoke check quando for terminal.",
|
|
418
|
+
"forte": "Crie direção específica e ambiciosa do domínio, use bibliotecas, APIs, assets, microinterações e efeitos atuais quando fizerem sentido, refine o fluxo principal até parecer produto real e faça verificação visual/terminal com evidência. Inovação precisa servir ao uso, não virar enfeite."
|
|
407
419
|
},
|
|
408
420
|
"evidencias": {
|
|
409
421
|
"fraca": [
|
|
410
422
|
"descrever padrão visual escolhido",
|
|
423
|
+
"explicar como o domínio aparece na interface ou terminal",
|
|
411
424
|
"confirmar responsividade básica",
|
|
425
|
+
"provar mobile sem overflow horizontal com scrollWidth <= clientWidth",
|
|
412
426
|
"listar estados essenciais"
|
|
413
427
|
],
|
|
414
428
|
"media": [
|
|
415
429
|
"registrar tokens e componentes usados",
|
|
430
|
+
"registrar bibliotecas, APIs ou efeitos escolhidos e por que combinam com o pedido",
|
|
416
431
|
"validar desktop e mobile",
|
|
417
|
-
"
|
|
432
|
+
"testar viewport estreito como 390px sem scroll horizontal",
|
|
433
|
+
"corrigir texto sobreposto",
|
|
434
|
+
"rodar smoke check de CLI/TUI quando aplicável"
|
|
418
435
|
],
|
|
419
436
|
"forte": [
|
|
420
437
|
"screenshot desktop/mobile",
|
|
438
|
+
"browser check com scrollWidth <= clientWidth em desktop/mobile",
|
|
421
439
|
"verificação de assets e renderização",
|
|
422
|
-
"auditoria de contraste, hierarquia e estado vazio"
|
|
440
|
+
"auditoria de contraste, hierarquia e estado vazio",
|
|
441
|
+
"evidência de fluxo principal polido",
|
|
442
|
+
"evidência de saída terminal com status, erro e ajuda quando aplicável"
|
|
423
443
|
]
|
|
424
444
|
},
|
|
425
445
|
"criteriosMinimos": [
|
|
426
446
|
"não parecer template de 2010",
|
|
447
|
+
"não reciclar a mesma estética para domínios diferentes",
|
|
448
|
+
"domínio e público moldam layout, linguagem, componentes e interação",
|
|
427
449
|
"hierarquia visual clara",
|
|
428
450
|
"paleta com contraste e identidade do domínio",
|
|
451
|
+
"tecnologia, biblioteca ou efeito escolhido combina com pedido e stack existente",
|
|
429
452
|
"responsividade mobile e desktop",
|
|
453
|
+
"evidencia mobile sem overflow horizontal (scrollWidth <= clientWidth)",
|
|
430
454
|
"estados de hover, focus, loading, erro e vazio quando aplicáveis",
|
|
431
455
|
"texto sem overlap ou estouro",
|
|
432
|
-
"
|
|
456
|
+
"texto visivel com acentos e cedilha quando o idioma exigir",
|
|
457
|
+
"componentes coerentes com o workflow real",
|
|
458
|
+
"terminal/CLI com hierarquia, status, erro, ajuda e confirmações quando aplicável"
|
|
433
459
|
]
|
|
434
460
|
},
|
|
435
461
|
"politicaPlataforma": {
|
|
@@ -452,19 +478,23 @@
|
|
|
452
478
|
"failClosed": [
|
|
453
479
|
"Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
|
|
454
480
|
"Se não houver contrato aplicável ou vínculo semântico do arquivo, inspecione o arquivo, descubra ou crie o .sema aplicável e vincule antes do código.",
|
|
455
|
-
"Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois rode sema preflight <comando> --json; só continue com use_cli_local; não use
|
|
456
|
-
"
|
|
481
|
+
"Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois rode sema preflight <comando> --json; só continue com use_cli_local; não use rota remota, sincronização externa ou leitura por espelho para workspace local.",
|
|
482
|
+
"Se não houver workspace local em disco, pare bloqueado e peça o fluxo apropriado; não invente caminho nem substitua a CLI local por ferramenta paralela.",
|
|
457
483
|
"Se arquivos_codigo.conteudo ou conteudo inline passar de 262144 caracteres, não aumente timeout para forçar: divida por responsabilidade ou use anexo/caminho de servidor autorizado.",
|
|
458
484
|
"Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
|
|
459
485
|
"Se a resposta humana estiver em PT-BR, use vocabulário Sema canônico e preserve acentos mesmo que a DSL use ASCII.",
|
|
460
486
|
"Se um arquivo de código tiver SEMA-GOVERNED, consulte Sema e o contrato aplicável antes de editar.",
|
|
461
|
-
"Se
|
|
462
|
-
"Se
|
|
487
|
+
"Se codigo governado passar de 1000 linhas, planeje divisao; se passar de 2000, pare e divida antes de concluir. Documentacao Markdown nao entra nesse limite de codigo.",
|
|
488
|
+
"Se contrato .sema passar de 300 linhas, planeje split por dominio/capacidade; acima de 500, criacao e edicao ficam bloqueadas. Nao use parte_1/parte_2 e nao remova guarantees, tests ou vinculos so para caber.",
|
|
489
|
+
"Um mesmo arquivo de codigo pode ser governado por varios contratos .sema via vinculos; Sema Codigo deve preservar essa rastreabilidade.",
|
|
463
490
|
"Se score, achados ou decisaoAgente parecerem bons, trate como sinal de triagem e confira evidência concreta no contrato e no código.",
|
|
464
491
|
"Se validar artefato inline com 100/100, ainda preserve cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
|
|
465
|
-
"Se
|
|
492
|
+
"Se `sema drift` retornar sucesso:false, `vinculos_quebrados`, `rotas_divergentes` ou impls quebradas, a mudanca nao pode ser declarada concluida; corrija contrato/codigo e rode drift de novo.",
|
|
493
|
+
"Se a tarefa tiver site, sistema, app, UI, painel, jogo, CLI/TUI ou terminal, nao conclua sem acabamento moderno, contextual e evidenciado; em UI mobile estreita (ex. 390px), `document.documentElement.scrollWidth <= document.documentElement.clientWidth` precisa ser verdadeiro.",
|
|
494
|
+
"Se texto visivel PT-BR perder acento ou cedilha em termos como descricao, lancamentos, saude ou alimentacao, trate como defeito bloqueante quando houver i18n/idioma declarado.",
|
|
495
|
+
"Se aparecer caminho de servidor como /srv/sema/projetos, trate como espelho governado, não como pasta local do usuário.",
|
|
466
496
|
"Se uma chamada Sema estourar por timeout local, aumente o timeout e tente de novo; timeout do agente não libera ação sem Sema.",
|
|
467
497
|
"Se a plataforma bloquear ou alertar política, trate como bloqueio externo ou falso positivo possível; explique sem tentar contornar filtro.",
|
|
468
|
-
"Se a tarefa tiver
|
|
498
|
+
"Se a tarefa tiver experiência de uso e você não conseguir garantir padrão moderno, contextual e não genérico, pare e peça revisão em vez de entregar coisa engessada."
|
|
469
499
|
]
|
|
470
500
|
}
|
package/SEMA_BRIEF.curto.txt
CHANGED
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
PROJETO: Sema
|
|
2
2
|
BASE: C:\GitHub\Sema
|
|
3
|
-
MODULOS:
|
|
3
|
+
MODULOS: 95
|
|
4
4
|
MODO_CODIGO: codigo_completo
|
|
5
5
|
FONTES_CONCLUSAO: contrato, codigo
|
|
6
6
|
ENTRADA_IA: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
|
|
7
7
|
POLITICA_PLATAFORMA: O Sema governa contrato, escopo, drift, evidência e qualidade do projeto. Ele não pede, não autoriza e não contorna políticas da plataforma, termos de uso, permissões, segurança ou leis. Se um cliente, modelo ou classificador bloquear a mensagem, trate como bloqueio externo ou falso positivo possível: explique de forma neutra, preserve a intenção legítima de governança e não tente burlar filtros.
|
|
8
8
|
TIMEOUT_SEMA: Timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `inspecionar`, `drift` ou `sync-ai-entrypoints` estourar por timeout local, aumente o timeout e tente de novo com escopo menor quando possível. Escale 120s -> 300s -> 600s antes de declarar bloqueio.
|
|
9
9
|
CODIGO_GOVERNADO: SEMA-GOVERNED -> docs-impacto e drift antes de alterar comportamento
|
|
10
|
-
ORCAMENTO_SEMANTICO: codigo
|
|
10
|
+
ORCAMENTO_SEMANTICO: codigo governado acima de 1000 linhas exige refatoracao e acima de 2000 bloqueia; .sema acima de 300 diagnostica e acima de 500 bloqueia criacao, edicao, drift, geracao e snapshot; varios .sema podem governar o mesmo arquivo via vinculos
|
|
11
11
|
PAYLOAD_MCP: conteudo inline acima de 262144 caracteres deve virar arquivos logicos, anexo, caminho de servidor autorizado ou manifesto; nao aumente timeout para empurrar o mesmo payload
|
|
12
|
-
DESIGN_VISUAL: Quando a tarefa envolve
|
|
13
|
-
TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2, sema.produto.author.modelos, sema.produto.author.superficies, sema.produto.author.tarefas_2 (+
|
|
14
|
-
TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, aplicar_vocabulario_canonico_ia:medio (+
|
|
12
|
+
DESIGN_VISUAL: Quando a tarefa envolve site, sistema, app, interface, dashboard, painel, formulário, landing, jogo, terminal, CLI/TUI ou qualquer artefato voltado ao usuário, o Sema governa também acabamento, modernidade e adequação ao domínio. Beleza funcional, identidade, criatividade útil, tecnologia adequada, estados, responsividade e evidência não são extras opcionais. Fraca=Use um padrão moderno seguro e contextual: hierarquia clara, espaçamento consistente, paleta com contraste, componentes coerentes com o domínio, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Em terminal, entregue saída organizada com status e erro claros. Se não conseguir validar o resultado, pare e peça revisão. Media=Defina intenção de experiência antes de codar: público, domínio, workflow real, densidade, tokens, componentes, tecnologia/biblioteca/efeitos adequados, estados, responsividade e anti-2010. O domínio manda na solução: agro, finanças, saúde, game e e-commerce não podem compartilhar a mesma casca. Rode ou peça screenshot/browser check quando houver UI e smoke check quando for terminal. Forte=Crie direção específica e ambiciosa do domínio, use bibliotecas, APIs, assets, microinterações e efeitos atuais quando fizerem sentido, refine o fluxo principal até parecer produto real e faça verificação visual/terminal com evidência. Inovação precisa servir ao uso, não virar enfeite.
|
|
13
|
+
TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2, sema.produto.author.modelos, sema.produto.author.superficies, sema.produto.author.tarefas_2 (+89)
|
|
14
|
+
TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, aplicar_vocabulario_canonico_ia:medio (+193)
|
|
15
15
|
TOP_LACUNAS: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida, persistencia:FerramentaGovernanca:materializado:desconhecida, persistencia:kit_ia:materializado:desconhecida
|
|
16
|
-
TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\agentes-por-capacidade.md, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\da-sema-para-codigo.md (+
|
|
16
|
+
TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\agentes-por-capacidade.md, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\da-sema-para-codigo.md (+154)
|
|
17
17
|
TOP_ARQUIVOS_FONTE: vinculo_contrato
|
|
18
|
-
GERADO_EM: 2026-06-
|
|
18
|
+
GERADO_EM: 2026-06-18T17:36:09.649Z
|
package/SEMA_BRIEF.md
CHANGED
|
@@ -2,8 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem varrer o repo inteiro no escuro.
|
|
4
4
|
|
|
5
|
-
- Gerado em: `2026-06-
|
|
6
|
-
- Modulos: `
|
|
5
|
+
- Gerado em: `2026-06-18T17:36:09.649Z`
|
|
6
|
+
- Modulos: `95`
|
|
7
7
|
|
|
8
8
|
## Entrada canonica para IA
|
|
9
9
|
|
|
@@ -31,18 +31,18 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
|
|
|
31
31
|
## Código governado
|
|
32
32
|
|
|
33
33
|
- Marcador: `SEMA-GOVERNED`
|
|
34
|
-
- Regra: Arquivos de
|
|
35
|
-
- IA fraca: Se abrir
|
|
36
|
-
- IA média: Se abrir
|
|
37
|
-
- IA forte: Se abrir
|
|
34
|
+
- Regra: Arquivos de codigo gerados ou governados pela Sema devem manter cabecalho curto com modulo de origem, contrato .sema aplicavel e descricao humana. Validacao inline prova apenas o payload enviado; o arquivo fisico ainda precisa de SEMA-GOVERNED para orientar a proxima IA. Codigo governado avisa acima de 1000 linhas e bloqueia acima de 2000. Contrato .sema avisa acima de 300 linhas e bloqueia criacao, edicao, drift, finalizacao, geracao e snapshot acima de 500. O split de .sema deve ser por dominio/capacidade, nunca parte_1/parte_2; varios contratos podem governar o mesmo arquivo de codigo via vinculos. Sema Codigo deve preservar essa rastreabilidade em cabecalhos e saidas geradas. Documentacao Markdown nao entra nesse limite de codigo; continua governada por docs-impacto, limite de bytes e verificacao de segredos. Payload inline acima de 262144 caracteres nao e caso de aumentar timeout: divida por responsabilidade ou use anexo/caminho de servidor autorizado.
|
|
35
|
+
- IA fraca: Se abrir codigo com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Nao crie codigo acima de 2000 linhas nem contrato .sema acima de 500; divida .sema por capacidade, nunca em parte_1/parte_2.
|
|
36
|
+
- IA média: Se abrir codigo com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate codigo 1000+ e contrato .sema 300+ como refatoracao provavel; se o payload inline passar de 262144 caracteres, separe HTML, estilos, estado, renderizacao, calculo e dados antes de sincronizar.
|
|
37
|
+
- IA forte: Se abrir codigo com SEMA-GOVERNED, pode inspecionar AST/IR e codigo completo, mas mantem contrato primeiro, drift, codigo ate 2000, .sema ate 500 e finalizar-mudanca. Contexto grande nao autoriza monolito nem payload inline acima de 262144 caracteres.
|
|
38
38
|
|
|
39
39
|
## Design visual
|
|
40
40
|
|
|
41
|
-
- Regra: Quando a tarefa envolve
|
|
42
|
-
- Aplicar quando: site, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual ou qualquer entrega com
|
|
43
|
-
- IA fraca: Use um padrão moderno seguro: hierarquia clara, espaçamento consistente, paleta com contraste, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Se não conseguir validar
|
|
44
|
-
- IA média: Defina intenção
|
|
45
|
-
- IA forte: Crie direção
|
|
41
|
+
- Regra: Quando a tarefa envolve site, sistema, app, interface, dashboard, painel, formulário, landing, jogo, terminal, CLI/TUI ou qualquer artefato voltado ao usuário, o Sema governa também acabamento, modernidade e adequação ao domínio. Beleza funcional, identidade, criatividade útil, tecnologia adequada, estados, responsividade e evidência não são extras opcionais.
|
|
42
|
+
- Aplicar quando: site, sistema, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual, CLI, TUI, terminal, relatório interativo ou qualquer entrega com experiência de uso.
|
|
43
|
+
- IA fraca: Use um padrão moderno seguro e contextual: hierarquia clara, espaçamento consistente, paleta com contraste, componentes coerentes com o domínio, estados básicos, responsivo mobile/desktop e nada de formulário cinza genérico. Em terminal, entregue saída organizada com status e erro claros. Se não conseguir validar o resultado, pare e peça revisão.
|
|
44
|
+
- IA média: Defina intenção de experiência antes de codar: público, domínio, workflow real, densidade, tokens, componentes, tecnologia/biblioteca/efeitos adequados, estados, responsividade e anti-2010. O domínio manda na solução: agro, finanças, saúde, game e e-commerce não podem compartilhar a mesma casca. Rode ou peça screenshot/browser check quando houver UI e smoke check quando for terminal.
|
|
45
|
+
- IA forte: Crie direção específica e ambiciosa do domínio, use bibliotecas, APIs, assets, microinterações e efeitos atuais quando fizerem sentido, refine o fluxo principal até parecer produto real e faça verificação visual/terminal com evidência. Inovação precisa servir ao uso, não virar enfeite.
|
|
46
46
|
- Proibido: interface_generica_2010, formularios_sem_hierarquia_visual, cards_cinzas_sem_identidade, layout_sem_responsividade_real, texto_estourando_ou_sobreposto
|
|
47
47
|
|
|
48
48
|
## Timeout e retry
|
|
@@ -326,11 +326,32 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
|
|
|
326
326
|
- Score: 90 | Confianca: alta | Risco: medio
|
|
327
327
|
- Lacunas: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida (+2)
|
|
328
328
|
|
|
329
|
+
### sema.produto.governanca_ia.contexto.agent_pack
|
|
330
|
+
- Faz: governa 1 task(s) com foco em gerar agent context pack
|
|
331
|
+
- Publico: nenhum
|
|
332
|
+
- Tocar: C:\GitHub\Sema\pacotes\cli\src\agentContextPack.ts, C:\GitHub\Sema\pacotes\cli\src\agentContextTipos.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js, C:\GitHub\Sema\scripts\empacotar-cli-publica.mjs (+2)
|
|
333
|
+
- Score: 95 | Confianca: alta | Risco: alto
|
|
334
|
+
- Lacunas: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida (+2)
|
|
335
|
+
|
|
336
|
+
### sema.produto.governanca_ia.contexto.entrypoints
|
|
337
|
+
- Faz: governa 1 task(s) com foco em sincronizar entrypoints agentes
|
|
338
|
+
- Publico: nenhum
|
|
339
|
+
- Tocar: C:\GitHub\Sema\pacotes\cli\src\agentEntryPoints.ts
|
|
340
|
+
- Score: 90 | Confianca: alta | Risco: alto
|
|
341
|
+
- Lacunas: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida (+2)
|
|
342
|
+
|
|
343
|
+
### sema.produto.governanca_ia.contexto.projeto
|
|
344
|
+
- Faz: governa 2 task(s) com foco em mapear projeto sem adivinhacao
|
|
345
|
+
- Publico: nenhum
|
|
346
|
+
- Tocar: C:\GitHub\Sema\pacotes\cli\src\projetoCarregar.ts, C:\GitHub\Sema\pacotes\cli\src\projetoConfig.ts
|
|
347
|
+
- Score: 90 | Confianca: alta | Risco: medio
|
|
348
|
+
- Lacunas: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida (+2)
|
|
349
|
+
|
|
329
350
|
### sema.produto.governanca_ia.contexto
|
|
330
|
-
- Faz: governa
|
|
351
|
+
- Faz: governa 1 task(s) com foco em manter mapa contexto ia
|
|
331
352
|
- Publico: nenhum
|
|
332
|
-
- Tocar: C:\GitHub\Sema\pacotes\cli\src\
|
|
333
|
-
- Score:
|
|
353
|
+
- Tocar: C:\GitHub\Sema\pacotes\cli\src\agentContext.ts
|
|
354
|
+
- Score: 90 | Confianca: alta | Risco: medio
|
|
334
355
|
- Lacunas: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida (+2)
|
|
335
356
|
|
|
336
357
|
### sema.produto.governanca_ia.documentacao
|
|
@@ -390,10 +411,10 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
|
|
|
390
411
|
- Lacunas: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida (+2)
|
|
391
412
|
|
|
392
413
|
### sema.produto.governanca_ia
|
|
393
|
-
- Faz: governa
|
|
414
|
+
- Faz: governa 1 task(s) com foco em manter indice governanca ia
|
|
394
415
|
- Publico: nenhum
|
|
395
|
-
- Tocar:
|
|
396
|
-
- Score:
|
|
416
|
+
- Tocar: C:\GitHub\Sema\pacotes\cli\src\agentContext.ts
|
|
417
|
+
- Score: 90 | Confianca: alta | Risco: medio
|
|
397
418
|
- Lacunas: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida, persistencia:exemplos_oficiais:materializado:desconhecida (+2)
|
|
398
419
|
|
|
399
420
|
### sema.produto.identidade_marca
|
package/SEMA_BRIEF.micro.txt
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
PROJETO: Sema
|
|
2
|
-
MODULOS:
|
|
2
|
+
MODULOS: 95
|
|
3
3
|
MODO_CODIGO: codigo_completo
|
|
4
4
|
FONTES_CONCLUSAO: contrato, codigo
|
|
5
5
|
ENTRADA_IA: SEMA_BOOT.md -> SEMA_SMALL_MODEL.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
|
|
6
6
|
POLITICA_PLATAFORMA: Sema governa projeto e nao contorna politicas da plataforma; se houver alerta externo, pare e explique sem burlar filtro
|
|
7
7
|
TIMEOUT_SEMA: timeout local nao e falha; retry progressivo 120s -> 300s -> 600s; escopar arquivo se projeto inteiro for lento
|
|
8
8
|
CODIGO_GOVERNADO: SEMA-GOVERNED -> chamar Sema antes de editar codigo gerado; validacao inline nao dispensa cabecalho fisico
|
|
9
|
-
ORCAMENTO_SEMANTICO: codigo
|
|
9
|
+
ORCAMENTO_SEMANTICO: codigo aviso>1000 bloqueio>2000; .sema aviso>300 bloqueio>500; .sema por capacidade, nunca parte_1/parte_2; docs Markdown fora do limite de codigo
|
|
10
10
|
PAYLOAD_MCP: inline>262144 caracteres nao e timeout; modularize por responsabilidade ou use anexo/caminho autorizado
|
|
11
11
|
SINAL_VS_RITUAL: score/achados/decisaoAgente sao triagem; exigir evidencia concreta alem de palavra-chave ou regex
|
|
12
12
|
DESIGN_VISUAL: se houver UI, moderno obrigatorio; fraca=padrao seguro responsivo; media=tokens+estados; forte=screenshot+assets+microinteracoes
|
|
13
|
-
TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+
|
|
14
|
-
TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+
|
|
13
|
+
TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+92)
|
|
14
|
+
TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+196)
|
|
15
15
|
TOP_LACUNAS: execucao_implicita, persistencia:arquivo_config:materializado:desconhecida, persistencia:contrato_inicial:materializado:desconhecida (+3)
|
|
16
|
-
GERADO_EM: 2026-06-
|
|
16
|
+
GERADO_EM: 2026-06-18T17:36:09.649Z
|