@semacode/cli 1.5.46 → 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.
Files changed (92) hide show
  1. package/AGENTS.md +81 -324
  2. package/AGENT_CONTEXT_PACK.json +79 -37
  3. package/SEMA_BRIEF.curto.txt +8 -8
  4. package/SEMA_BRIEF.md +133 -112
  5. package/SEMA_BRIEF.micro.txt +6 -6
  6. package/SEMA_INDEX.json +978 -517
  7. package/dist/agentContext.d.ts +1 -1
  8. package/dist/agentContextPack.js +76 -35
  9. package/dist/agentContextPack.js.map +1 -1
  10. package/dist/agentContextTipos.d.ts +1 -1
  11. package/dist/agentContextTipos.js +1 -0
  12. package/dist/agentContextTipos.js.map +1 -1
  13. package/dist/agentEntryPoints.js +359 -42
  14. package/dist/agentEntryPoints.js.map +1 -1
  15. package/dist/drift.part01.d.ts +1 -1
  16. package/dist/drift.part04.d.ts +1 -1
  17. package/dist/drift.part04.js +2 -2
  18. package/dist/drift.part04.js.map +1 -1
  19. package/dist/drift.part05.d.ts +3 -3
  20. package/dist/drift.part05.js +8 -8
  21. package/dist/drift.part05.js.map +1 -1
  22. package/dist/drift.part06.js +15 -8
  23. package/dist/drift.part06.js.map +1 -1
  24. package/dist/drift.part09.js +11 -7
  25. package/dist/drift.part09.js.map +1 -1
  26. package/dist/driftOrcamento.d.ts +11 -1
  27. package/dist/driftOrcamento.js +48 -18
  28. package/dist/driftOrcamento.js.map +1 -1
  29. package/dist/index.part02.js +4 -2
  30. package/dist/index.part02.js.map +1 -1
  31. package/dist/index.part04.js +3 -3
  32. package/dist/index.part04.js.map +1 -1
  33. package/dist/initCommand.js +20 -0
  34. package/dist/initCommand.js.map +1 -1
  35. package/dist/initTemplatesBase.js +50 -2
  36. package/dist/initTemplatesBase.js.map +1 -1
  37. package/dist/profileArtefatoValidadores.js +42 -0
  38. package/dist/profileArtefatoValidadores.js.map +1 -1
  39. package/dist/profileI18nCatalogo.js +2 -0
  40. package/dist/profileI18nCatalogo.js.map +1 -1
  41. package/dist/projetoConfig.js +7 -0
  42. package/dist/projetoConfig.js.map +1 -1
  43. package/dist/projetoLegado.js +10 -3
  44. package/dist/projetoLegado.js.map +1 -1
  45. package/dist/runnerValidacaoRemotaWorkspace.js +4 -1
  46. package/dist/runnerValidacaoRemotaWorkspace.js.map +1 -1
  47. package/dist/tipos.d.ts +1 -1
  48. package/docs/AGENT_STARTER.md +49 -13
  49. package/docs/agentes-por-capacidade.md +26 -22
  50. package/docs/cli.md +3 -0
  51. package/docs/comandos.md +807 -0
  52. package/docs/env.md +2 -2
  53. package/docs/extensao-vscode.md +1 -1
  54. package/docs/fluxo-pratico-ia-sema.md +63 -0
  55. package/docs/sintaxe.md +178 -6
  56. package/node_modules/@sema/gerador-css/dist/index.part01.js +1 -0
  57. package/node_modules/@sema/gerador-css/dist/index.part01.js.map +1 -1
  58. package/node_modules/@sema/gerador-css/package.json +1 -1
  59. package/node_modules/@sema/gerador-dart/dist/index.js +1 -0
  60. package/node_modules/@sema/gerador-dart/dist/index.js.map +1 -1
  61. package/node_modules/@sema/gerador-dart/package.json +1 -1
  62. package/node_modules/@sema/gerador-html/dist/index.js +1 -0
  63. package/node_modules/@sema/gerador-html/dist/index.js.map +1 -1
  64. package/node_modules/@sema/gerador-html/package.json +1 -1
  65. package/node_modules/@sema/gerador-javascript/dist/index.js +1 -0
  66. package/node_modules/@sema/gerador-javascript/dist/index.js.map +1 -1
  67. package/node_modules/@sema/gerador-javascript/package.json +1 -1
  68. package/node_modules/@sema/gerador-lua/dist/index.js +1 -0
  69. package/node_modules/@sema/gerador-lua/dist/index.js.map +1 -1
  70. package/node_modules/@sema/gerador-lua/package.json +1 -1
  71. package/node_modules/@sema/gerador-python/dist/index.part02.js +1 -0
  72. package/node_modules/@sema/gerador-python/dist/index.part02.js.map +1 -1
  73. package/node_modules/@sema/gerador-python/package.json +1 -1
  74. package/node_modules/@sema/gerador-typescript/dist/index.part02.js +1 -0
  75. package/node_modules/@sema/gerador-typescript/dist/index.part02.js.map +1 -1
  76. package/node_modules/@sema/gerador-typescript/package.json +1 -1
  77. package/node_modules/@sema/nucleo/dist/ast/tipos.d.ts +1 -1
  78. package/node_modules/@sema/nucleo/dist/ir/conversor.part01.js +4 -0
  79. package/node_modules/@sema/nucleo/dist/ir/conversor.part01.js.map +1 -1
  80. package/node_modules/@sema/nucleo/dist/ir/conversor.part02.d.ts +1 -1
  81. package/node_modules/@sema/nucleo/dist/ir/modelos.d.ts +3 -3
  82. package/node_modules/@sema/nucleo/dist/parser/parser.declaracoes.js +3 -0
  83. package/node_modules/@sema/nucleo/dist/parser/parser.declaracoes.js.map +1 -1
  84. package/node_modules/@sema/nucleo/dist/semantico/analisador.part01.d.ts +2 -2
  85. package/node_modules/@sema/nucleo/dist/semantico/analisador.part01.js +4 -1
  86. package/node_modules/@sema/nucleo/dist/semantico/analisador.part01.js.map +1 -1
  87. package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.d.ts +2 -2
  88. package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js +11 -5
  89. package/node_modules/@sema/nucleo/dist/semantico/orcamentoSemantico.js.map +1 -1
  90. package/node_modules/@sema/nucleo/package.json +1 -1
  91. package/node_modules/@sema/padroes/package.json +1 -1
  92. package/package.json +10 -10
@@ -10,62 +10,70 @@
10
10
  "SEMA_BRIEF.micro.txt",
11
11
  "SEMA_INDEX.json",
12
12
  "AGENTS.md",
13
+ "docs/comandos.md",
13
14
  "exemplos/"
14
15
  ],
15
16
  "regrasObrigatorias": [
16
17
  "Contrato vem antes da ação.",
17
18
  "Leia SEMA_BOOT.md antes de qualquer outro artefato de IA.",
18
19
  "Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy.",
19
- "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 MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para workspace local; em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline.",
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 rota remota, sincronização externa ou leitura por espelho para workspace local.",
20
22
  "Antes de editar, chame sema_inspecionar no contrato aplicável e rode sema_drift e sema_impacto.",
21
23
  "Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.",
22
24
  "Use SEMA_INDEX.json para escolher contrato, módulo e arquivos prováveis antes de abrir código cru.",
23
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.",
24
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.",
25
28
  "Sema não contorna políticas da plataforma; ele governa contrato, escopo, drift, evidência e qualidade.",
26
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.",
27
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.",
28
31
  "Mantenha o cabeçalho SEMA-GOVERNED em código gerado ou governado e volte ao contrato antes de editar.",
29
32
  "Validação inline não dispensa cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
30
- "Payload inline MCP acima de 262144 caracteres deve ser dividido por responsabilidade ou enviado por transporte autorizado; não é timeout para escalar.",
31
- "Não crie nem conclua código ou contrato governado acima de 2000 linhas; acima de 1000, planeje divisão por responsabilidade. Documentação Markdown não entra nesse limite de código.",
32
- "Divida código ou contrato grande por responsabilidade real, como HTML, CSS, estado, renderização, cálculo e dados; não gere index_p1/index_p2 sem fronteira semântica.",
33
- "Caminho Linux retornado pelo MCP remoto é espelho governado do Sema; não confunda com o checkout local do usuário.",
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.",
34
38
  "Se uma chamada Sema estourar por timeout local, aumente o timeout e tente novamente; não trate lentidão como sessão inativa.",
35
- "Se a tarefa tiver UI, trate design moderno como requisito governado por capacidade."
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."
36
40
  ],
37
41
  "proibicoes": [
38
42
  "Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
39
43
  "Não tratar README, texto livre ou código como fonte superior ao contrato.",
40
44
  "Não substituir contexto Sema por AGENTS.md, README.md, busca local, inferência pelo nome do projeto ou bom senso sem preflight/autorização Sema.",
45
+ "Não tratar a pasta --saida de sema compilar como entrega final; entrega são os arquivos alvo/vínculos do contrato.",
41
46
  "Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
42
47
  "Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
43
- "Não assumir repositório público, GitHub Release pública, leitura local pelo MCP ou acesso da IA ao painel; em IDE local prove CLI com sema --version, em web/remoto use sync inline.",
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.",
44
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.",
45
50
  "Não remover SEMA-GOVERNED nem substituir drift por comentário dentro do código.",
46
51
  "Não copiar o contrato inteiro para comentário de código; mantenha descrição humana curta.",
47
- "Não tratar orçamento semântico como sugestão; código ou contrato governado grande deve ser dividido antes de concluir.",
48
- "Não fatiar código ou contrato grande em partes sem responsabilidade real para passar no limite.",
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.",
49
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.",
50
56
  "Não tratar validação inline como dispensa de cabeçalho SEMA-GOVERNED no arquivo físico.",
51
57
  "Não tentar resolver payload inline acima de 262144 caracteres aumentando timeout.",
52
- "Não culpar o limite de 2000 linhas por arquitetura monolítica escolhida pela IA.",
58
+ "Nao culpar o limite de 2000 linhas para codigo ou 500 linhas para .sema por arquitetura monolitica escolhida pela IA.",
53
59
  "Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate.",
54
60
  "Não usar Sema para contornar política, segurança, permissões, termos ou filtros da plataforma.",
55
- "Não entregar interface genérica, cinza, com cara de template antigo ou sem estados visuais quando a tarefa envolve UI."
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."
56
63
  ],
57
64
  "prioridades": [
58
65
  "Menor artefato suficiente primeiro.",
59
- "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 MCP remoto, sema_sync, sema_contratos_sincronizar ou sema mcp-client para workspace; web/remoto: sema_chat_contexto e sema_sync inline.",
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.",
60
67
  "Contrato, índice e AGENTS complementam o contexto Sema; não substituem chamada Sema.",
61
68
  "Exemplos oficiais antes de nova sintaxe.",
62
69
  "Diagnóstico estruturado antes de opinião livre.",
63
70
  "Compatibilidade com políticas da plataforma antes de reformular ou continuar após alerta externo.",
64
71
  "Sinal sem evidência vira ritual; evidência concreta antes de concluir aderência.",
65
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.",
66
74
  "Separar limite de transporte inline de lentidão real: payload grande demais exige split/transporte correto, não retry infinito.",
67
75
  "Orçamento semântico, divisão por responsabilidade e cabeçalho governado antes de gravar ou finalizar código.",
68
- "Design visual por capacidade quando houver UI.",
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.",
69
77
  "Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto."
70
78
  ],
71
79
  "fontes": [
@@ -133,10 +141,18 @@
133
141
  "quandoUsar": "antes de editar código, contrato, docs operacionais, release ou deploy",
134
142
  "incluirTextoBrutoQuando": "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto"
135
143
  },
144
+ {
145
+ "caminho": "docs/comandos.md",
146
+ "tipo": "docs",
147
+ "prioridade": 9,
148
+ "obrigatorio": true,
149
+ "quandoUsar": "antes de escolher comando Sema, interpretar --saida de sema compilar ou destravar Sema Codigo",
150
+ "incluirTextoBrutoQuando": "a IA precisa entender comandos, gates, saida gerada e proximo passo governado"
151
+ },
136
152
  {
137
153
  "caminho": "exemplos/",
138
154
  "tipo": "exemplos",
139
- "prioridade": 9,
155
+ "prioridade": 10,
140
156
  "obrigatorio": true,
141
157
  "quandoUsar": "antes de criar ou corrigir arquivo .sema, profile, Author, workflow, ops, game, legal ou research",
142
158
  "incluirTextoBrutoQuando": "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial"
@@ -144,7 +160,7 @@
144
160
  {
145
161
  "caminho": "docs/AGENT_STARTER.md",
146
162
  "tipo": "docs",
147
- "prioridade": 10,
163
+ "prioridade": 11,
148
164
  "obrigatorio": false,
149
165
  "quandoUsar": "onboarding de agente novo ou explicação curta do fluxo",
150
166
  "incluirTextoBrutoQuando": "o agente remoto não conhece Sema ainda"
@@ -152,7 +168,7 @@
152
168
  {
153
169
  "caminho": "docs/agentes-por-capacidade.md",
154
170
  "tipo": "docs",
155
- "prioridade": 11,
171
+ "prioridade": 12,
156
172
  "obrigatorio": false,
157
173
  "quandoUsar": "configurar Copilot, Cline, Roo Code, OpenCode ou outro agente com disciplina variável",
158
174
  "incluirTextoBrutoQuando": "a IA precisa entender tiers fraca/média/forte e política de idioma"
@@ -160,7 +176,7 @@
160
176
  {
161
177
  "caminho": "docs/sintaxe.md",
162
178
  "tipo": "docs",
163
- "prioridade": 12,
179
+ "prioridade": 13,
164
180
  "obrigatorio": false,
165
181
  "quandoUsar": "dúvida de gramática, blocos ou formato do DSL",
166
182
  "incluirTextoBrutoQuando": "a IA vai editar contrato e os exemplos não bastam"
@@ -168,7 +184,7 @@
168
184
  {
169
185
  "caminho": "contratos/",
170
186
  "tipo": "contrato",
171
- "prioridade": 13,
187
+ "prioridade": 14,
172
188
  "obrigatorio": true,
173
189
  "quandoUsar": "antes de qualquer implementação ou alteração de comportamento",
174
190
  "incluirTextoBrutoQuando": "a tarefa toca uma capacidade governada por contrato"
@@ -194,6 +210,7 @@
194
210
  "SEMA_BRIEF.curto.txt": "o módulo alvo ainda não está claro pelo micro",
195
211
  "SEMA_INDEX.json": "a IA precisa mapear módulos, lacunas, riscos ou arquivos prováveis",
196
212
  "AGENTS.md": "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto",
213
+ "docs/comandos.md": "a IA precisa entender comandos, gates, saida gerada e proximo passo governado",
197
214
  "exemplos/": "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial",
198
215
  "docs/AGENT_STARTER.md": "o agente remoto não conhece Sema ainda",
199
216
  "docs/agentes-por-capacidade.md": "a IA precisa entender tiers fraca/média/forte e política de idioma",
@@ -341,12 +358,12 @@
341
358
  },
342
359
  "politicaCodigoGovernado": {
343
360
  "marcador": "SEMA-GOVERNED",
344
- "regra": "Arquivos de código gerados ou governados pela Sema devem manter um cabeçalho curto com módulo de origem, lembrete para consultar o contrato .sema e descrição humana no idioma do usuário. Validação inline prova apenas o payload enviado; o arquivo físico sincronizado ainda precisa de SEMA-GOVERNED para orientar a próxima IA. Código e contrato governados acima de 1000 linhas geram diagnóstico de refatoração; acima de 2000 linhas bloqueiam drift, finalização, geração e snapshot. Documentação Markdown não entra nesse limite de código; continua governada por docs-impacto, limite de bytes e verificação de segredos. Payload inline MCP acima de 262144 caracteres não é caso de aumentar timeout: divida por responsabilidade ou use anexo/caminho de servidor autorizado. O limite exige divisão por responsabilidade real, não fatiamento artificial como index_p1.html, index_p2.html só para passar no gate.",
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.",
345
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.",
346
363
  "porCapacidade": {
347
- "fraca": "Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Não crie código ou contrato governado acima de 2000 linhas nem envie payload inline acima de 262144 caracteres; divida antes por responsabilidade, nunca em partes p1/p2 sem sentido.",
348
- "media": "Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate 1000+ linhas em código ou contrato governado como refatoração provável; se o payload inline passar de 262144 caracteres, separe HTML, estilos, estado, renderização, cálculo e dados antes de sincronizar.",
349
- "forte": "Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift, orçamento governado de 2000 linhas e finalizar-mudanca. Contexto grande não autoriza monólito nem payload inline acima de 262144 caracteres."
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."
350
367
  },
351
368
  "formatosPorAlvo": {
352
369
  "typescript": "// SEMA-GOVERNED",
@@ -375,9 +392,9 @@
375
392
  }
376
393
  },
377
394
  "politicaDesignVisual": {
378
- "regra": "Quando a tarefa envolve interface, app, site, dashboard, painel, formulário, landing, jogo ou artefato visual, o Sema governa também qualidade visual. Modernidade, identidade, responsividade, estados e evidência visual não são extras opcionais.",
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.",
379
396
  "modernoObrigatorio": true,
380
- "aplicarQuando": "site, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual ou qualquer entrega com UI.",
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.",
381
398
  "proibicoes": [
382
399
  "interface_generica_2010",
383
400
  "formularios_sem_hierarquia_visual",
@@ -386,38 +403,59 @@
386
403
  "texto_estourando_ou_sobreposto",
387
404
  "sem_estados_de_hover_focus_loading_erro_vazio",
388
405
  "sem_assets_quando_o_dominio_pede_visual",
389
- "copiar_estetica_do_contrato_para_ui"
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"
390
414
  ],
391
415
  "porCapacidade": {
392
- "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 visualmente, pare e peça revisão.",
393
- "media": "Defina intenção visual antes de codar: público, domínio, densidade, tokens, componentes, estados, responsividade e anti-2010. Rode ou peça screenshot/browser check quando houver UI.",
394
- "forte": "Crie direção visual específica do domínio, use assets reais/gerados quando fizer sentido, refine microinterações e faça verificação visual em desktop/mobile com screenshot e correção de overlap."
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."
395
419
  },
396
420
  "evidencias": {
397
421
  "fraca": [
398
422
  "descrever padrão visual escolhido",
423
+ "explicar como o domínio aparece na interface ou terminal",
399
424
  "confirmar responsividade básica",
425
+ "provar mobile sem overflow horizontal com scrollWidth <= clientWidth",
400
426
  "listar estados essenciais"
401
427
  ],
402
428
  "media": [
403
429
  "registrar tokens e componentes usados",
430
+ "registrar bibliotecas, APIs ou efeitos escolhidos e por que combinam com o pedido",
404
431
  "validar desktop e mobile",
405
- "corrigir texto sobreposto"
432
+ "testar viewport estreito como 390px sem scroll horizontal",
433
+ "corrigir texto sobreposto",
434
+ "rodar smoke check de CLI/TUI quando aplicável"
406
435
  ],
407
436
  "forte": [
408
437
  "screenshot desktop/mobile",
438
+ "browser check com scrollWidth <= clientWidth em desktop/mobile",
409
439
  "verificação de assets e renderização",
410
- "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"
411
443
  ]
412
444
  },
413
445
  "criteriosMinimos": [
414
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",
415
449
  "hierarquia visual clara",
416
450
  "paleta com contraste e identidade do domínio",
451
+ "tecnologia, biblioteca ou efeito escolhido combina com pedido e stack existente",
417
452
  "responsividade mobile e desktop",
453
+ "evidencia mobile sem overflow horizontal (scrollWidth <= clientWidth)",
418
454
  "estados de hover, focus, loading, erro e vazio quando aplicáveis",
419
455
  "texto sem overlap ou estouro",
420
- "componentes coerentes com o workflow real"
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"
421
459
  ]
422
460
  },
423
461
  "politicaPlataforma": {
@@ -440,19 +478,23 @@
440
478
  "failClosed": [
441
479
  "Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
442
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.",
443
- "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 MCP remoto, sema_sync, sema_contratos_sincronizar nem sema mcp-client para workspace local.",
444
- "Em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline com contrato, código selecionado, documentação e índice; se falhar, pare.",
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.",
445
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.",
446
484
  "Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
447
485
  "Se a resposta humana estiver em PT-BR, use vocabulário Sema canônico e preserve acentos mesmo que a DSL use ASCII.",
448
486
  "Se um arquivo de código tiver SEMA-GOVERNED, consulte Sema e o contrato aplicável antes de editar.",
449
- "Se código ou contrato governado passar de 1000 linhas, planeje divisão; se passar de 2000, pare e divida antes de concluir. Documentação Markdown não entra nesse limite de código.",
450
- "Se código ou contrato governado passar do orçamento, divida por responsabilidade real; não fatie em partes artificiais para enganar limite.",
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.",
451
490
  "Se score, achados ou decisaoAgente parecerem bons, trate como sinal de triagem e confira evidência concreta no contrato e no código.",
452
491
  "Se validar artefato inline com 100/100, ainda preserve cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
453
- "Se o MCP retornar caminho Linux como /srv/sema/projetos, trate como espelho remoto autorizado, não como pasta local do usuário.",
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.",
454
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.",
455
497
  "Se a plataforma bloquear ou alertar política, trate como bloqueio externo ou falso positivo possível; explique sem tentar contornar filtro.",
456
- "Se a tarefa tiver UI e você não conseguir garantir um padrão visual moderno mínimo, pare e peça revisão em vez de entregar interface genérica."
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."
457
499
  ]
458
500
  }
@@ -1,18 +1,18 @@
1
1
  PROJETO: Sema
2
2
  BASE: C:\GitHub\Sema
3
- MODULOS: 92
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/contrato governado acima de 1000 linhas exige refatoracao planejada; acima de 2000 bloqueia finalizar-mudanca, drift, geracao e snapshot; Markdown/documentacao nao entra no limite de 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 interface, app, site, dashboard, painel, formulário, landing, jogo ou artefato visual, o Sema governa também qualidade visual. Modernidade, identidade, responsividade, estados e evidência visual não são extras opcionais. 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 visualmente, pare e peça revisão. Media=Defina intenção visual antes de codar: público, domínio, densidade, tokens, componentes, estados, responsividade e anti-2010. Rode ou peça screenshot/browser check quando houver UI. Forte=Crie direção visual específica do domínio, use assets reais/gerados quando fizer sentido, refine microinterações e faça verificação visual em desktop/mobile com screenshot e correção de overlap.
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 (+86)
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 (+190)
15
- TOP_LACUNAS: execucao_implicita, persistencia:FerramentaGovernanca:materializado:desconhecida, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres: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 (+151)
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
+ 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 (+154)
17
17
  TOP_ARQUIVOS_FONTE: vinculo_contrato
18
- GERADO_EM: 2026-06-09T21:49:22.646Z
18
+ GERADO_EM: 2026-06-18T17:36:09.649Z