@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.
- package/AGENTS.md +81 -324
- package/AGENT_CONTEXT_PACK.json +79 -37
- package/SEMA_BRIEF.curto.txt +8 -8
- package/SEMA_BRIEF.md +133 -112
- package/SEMA_BRIEF.micro.txt +6 -6
- package/SEMA_INDEX.json +978 -517
- package/dist/agentContext.d.ts +1 -1
- package/dist/agentContextPack.js +76 -35
- package/dist/agentContextPack.js.map +1 -1
- package/dist/agentContextTipos.d.ts +1 -1
- package/dist/agentContextTipos.js +1 -0
- package/dist/agentContextTipos.js.map +1 -1
- package/dist/agentEntryPoints.js +359 -42
- 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/initCommand.js +20 -0
- package/dist/initCommand.js.map +1 -1
- package/dist/initTemplatesBase.js +50 -2
- package/dist/initTemplatesBase.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 +49 -13
- package/docs/agentes-por-capacidade.md +26 -22
- package/docs/cli.md +3 -0
- package/docs/comandos.md +807 -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
|
@@ -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
|
-
"
|
|
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
|
|
31
|
-
"
|
|
32
|
-
"
|
|
33
|
-
"
|
|
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
|
|
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
|
|
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
|
-
"
|
|
48
|
-
"
|
|
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
|
-
"
|
|
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
|
|
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
|
|
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
|
-
"
|
|
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":
|
|
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":
|
|
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":
|
|
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":
|
|
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":
|
|
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
|
|
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
|
|
348
|
-
"media": "Se abrir
|
|
349
|
-
"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."
|
|
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
|
|
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
|
|
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
|
-
"
|
|
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
|
|
393
|
-
"media": "Defina intenção
|
|
394
|
-
"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."
|
|
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
|
-
"
|
|
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
|
-
"
|
|
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
|
|
444
|
-
"
|
|
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
|
|
450
|
-
"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.",
|
|
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
|
|
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
|
|
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
|
}
|
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 (+
|
|
15
|
-
TOP_LACUNAS: execucao_implicita, persistencia:
|
|
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 (+
|
|
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-
|
|
18
|
+
GERADO_EM: 2026-06-18T17:36:09.649Z
|