@semacode/cli 1.5.35 → 1.5.36
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 +1 -1
- package/AGENT_CONTEXT_PACK.json +55 -5
- package/README.md +3 -3
- package/SEMA_BRIEF.curto.txt +2 -1
- package/SEMA_BRIEF.md +11 -2
- package/SEMA_BRIEF.micro.txt +2 -1
- package/SEMA_INDEX.json +222 -124
- package/dist/index.js +107 -2
- package/dist/index.js.map +1 -1
- package/docs/agentes-por-capacidade.md +13 -0
- package/docs/api.md +21 -21
- package/docs/cli.md +3 -3
- package/docs/env.md +20 -24
- package/docs/instalacao-e-primeiro-uso.md +3 -3
- package/docs/repositories.md +21 -21
- package/package.json +12 -16
package/AGENTS.md
CHANGED
|
@@ -29,7 +29,7 @@ Idioma humano: responda no idioma falado pelo usuário. Em PT-BR, use acentos, c
|
|
|
29
29
|
|
|
30
30
|
## MCP
|
|
31
31
|
|
|
32
|
-
O servidor MCP do Sema e uma superficie privada/comercial acessada por endpoint remoto autorizado; ele nao e instalado
|
|
32
|
+
O servidor MCP do Sema e uma superficie privada/comercial acessada por endpoint remoto autorizado; ele nao e instalado pelo pacote npm do instalador neste repositorio.
|
|
33
33
|
Use as ferramentas quando o endpoint privado estiver configurado: sema_resumo, sema_validar, sema_drift, sema_impacto, sema_renomear_semantico, sema_inspecionar, sema_ir, sema_verificar, sema_contexto_ia, sema_prompt_ia, sema_author_iniciar, sema_author_validar, sema_author_briefing, sema_author_revisar_cliches, sema_sync_ai_entrypoints, sema_exemplos, sema_instalar_exemplos, sema_docs_impacto, sema_finalizar_mudanca.
|
|
34
34
|
|
|
35
35
|
O MCP deve deixar claro em toda orientacao: se nao existe contrato, crie; se a intencao mudou, edite; se a capacidade saiu, remova ou aposente. Isso vale para todo tipo de Sema: Software, Author, Workflow, Ops, Game, Legal, Research e profiles futuros.
|
package/AGENT_CONTEXT_PACK.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"nome": "Agent Context Pack",
|
|
3
|
-
"versao":
|
|
3
|
+
"versao": 4,
|
|
4
4
|
"objetivo": "Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.",
|
|
5
5
|
"ordemLeitura": [
|
|
6
6
|
"SEMA_BOOT.md",
|
|
@@ -22,18 +22,20 @@
|
|
|
22
22
|
"Quando faltar contrato aplicável, crie ou edite o contrato antes do código.",
|
|
23
23
|
"Responda no idioma do usuário e preserve acentos, cedilha, pontuação e símbolos humanos.",
|
|
24
24
|
"Mantenha o cabeçalho SEMA-GOVERNED em código gerado ou governado e volte ao contrato antes de editar.",
|
|
25
|
-
"Se uma chamada Sema estourar por timeout local, aumente o timeout e tente novamente; não trate lentidão como sessão inativa."
|
|
25
|
+
"Se uma chamada Sema estourar por timeout local, aumente o timeout e tente novamente; não trate lentidão como sessão inativa.",
|
|
26
|
+
"Se a tarefa tiver UI, trate design moderno como requisito governado por capacidade."
|
|
26
27
|
],
|
|
27
28
|
"proibicoes": [
|
|
28
29
|
"Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
|
|
29
30
|
"Não tratar README, texto livre ou código como fonte superior ao contrato.",
|
|
30
31
|
"Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
|
|
31
32
|
"Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
|
|
32
|
-
"Não
|
|
33
|
+
"Não assumir repositório público, GitHub Release pública ou leitura local pelo MCP; confira docs de repositórios e AGENTS.md.",
|
|
33
34
|
"Não usar a estética ASCII da DSL como desculpa para escrever PT-BR sem acentos.",
|
|
34
35
|
"Não remover SEMA-GOVERNED nem substituir drift por comentário dentro do código.",
|
|
35
36
|
"Não copiar o contrato inteiro para comentário de código; mantenha descrição humana curta.",
|
|
36
|
-
"Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate."
|
|
37
|
+
"Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate.",
|
|
38
|
+
"Não entregar interface genérica, cinza, com cara de template antigo ou sem estados visuais quando a tarefa envolve UI."
|
|
37
39
|
],
|
|
38
40
|
"prioridades": [
|
|
39
41
|
"Menor artefato suficiente primeiro.",
|
|
@@ -41,6 +43,7 @@
|
|
|
41
43
|
"Exemplos oficiais antes de nova sintaxe.",
|
|
42
44
|
"Diagnóstico estruturado antes de opinião livre.",
|
|
43
45
|
"Retry progressivo em timeout antes de declarar bloqueio.",
|
|
46
|
+
"Design visual por capacidade quando houver UI.",
|
|
44
47
|
"Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto."
|
|
45
48
|
],
|
|
46
49
|
"fontes": [
|
|
@@ -319,6 +322,52 @@
|
|
|
319
322
|
"forte": "Pode rodar projeto inteiro com timeout alto, mas deve distinguir lentidão de falha real e registrar evidência."
|
|
320
323
|
}
|
|
321
324
|
},
|
|
325
|
+
"politicaDesignVisual": {
|
|
326
|
+
"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.",
|
|
327
|
+
"modernoObrigatorio": true,
|
|
328
|
+
"aplicarQuando": "site, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual ou qualquer entrega com UI.",
|
|
329
|
+
"proibicoes": [
|
|
330
|
+
"interface_generica_2010",
|
|
331
|
+
"formularios_sem_hierarquia_visual",
|
|
332
|
+
"cards_cinzas_sem_identidade",
|
|
333
|
+
"layout_sem_responsividade_real",
|
|
334
|
+
"texto_estourando_ou_sobreposto",
|
|
335
|
+
"sem_estados_de_hover_focus_loading_erro_vazio",
|
|
336
|
+
"sem_assets_quando_o_dominio_pede_visual",
|
|
337
|
+
"copiar_estetica_do_contrato_para_ui"
|
|
338
|
+
],
|
|
339
|
+
"porCapacidade": {
|
|
340
|
+
"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.",
|
|
341
|
+
"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.",
|
|
342
|
+
"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."
|
|
343
|
+
},
|
|
344
|
+
"evidencias": {
|
|
345
|
+
"fraca": [
|
|
346
|
+
"descrever padrão visual escolhido",
|
|
347
|
+
"confirmar responsividade básica",
|
|
348
|
+
"listar estados essenciais"
|
|
349
|
+
],
|
|
350
|
+
"media": [
|
|
351
|
+
"registrar tokens e componentes usados",
|
|
352
|
+
"validar desktop e mobile",
|
|
353
|
+
"corrigir texto sobreposto"
|
|
354
|
+
],
|
|
355
|
+
"forte": [
|
|
356
|
+
"screenshot desktop/mobile",
|
|
357
|
+
"verificação de assets e renderização",
|
|
358
|
+
"auditoria de contraste, hierarquia e estado vazio"
|
|
359
|
+
]
|
|
360
|
+
},
|
|
361
|
+
"criteriosMinimos": [
|
|
362
|
+
"não parecer template de 2010",
|
|
363
|
+
"hierarquia visual clara",
|
|
364
|
+
"paleta com contraste e identidade do domínio",
|
|
365
|
+
"responsividade mobile e desktop",
|
|
366
|
+
"estados de hover, focus, loading, erro e vazio quando aplicáveis",
|
|
367
|
+
"texto sem overlap ou estouro",
|
|
368
|
+
"componentes coerentes com o workflow real"
|
|
369
|
+
]
|
|
370
|
+
},
|
|
322
371
|
"failClosed": [
|
|
323
372
|
"Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
|
|
324
373
|
"Se não houver contrato aplicável, crie ou edite o .sema antes do código.",
|
|
@@ -326,6 +375,7 @@
|
|
|
326
375
|
"Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
|
|
327
376
|
"Se a resposta humana estiver em PT-BR, preserve acentos e símbolos mesmo que a DSL use ASCII.",
|
|
328
377
|
"Se um arquivo de código tiver SEMA-GOVERNED, consulte Sema e o contrato aplicável antes de editar.",
|
|
329
|
-
"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."
|
|
378
|
+
"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.",
|
|
379
|
+
"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."
|
|
330
380
|
]
|
|
331
381
|
}
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## English
|
|
4
4
|
|
|
5
|
-
`@semacode/cli` is the
|
|
5
|
+
`@semacode/cli` is the npm installer/client for the governed Sema CLI. It is not the MCP server and it is not the commercial control plane.
|
|
6
6
|
|
|
7
7
|
The private MCP coordinates authentication, project selection, SEMAS consumption, profile routing, and final decisions. The CLI executes the local or VPS-side work: contract validation, drift, impact, AI-first context, documentation gates, profile checks, and selected project actions.
|
|
8
8
|
|
|
@@ -30,7 +30,7 @@ The command stores the commercial MCP key in the local user environment as `SEMA
|
|
|
30
30
|
|
|
31
31
|
## Português
|
|
32
32
|
|
|
33
|
-
`@semacode/cli` agora é o instalador/cliente
|
|
33
|
+
`@semacode/cli` agora é o instalador/cliente npm da CLI governada da Sema. Ele não é o servidor MCP nem o control plane comercial.
|
|
34
34
|
|
|
35
35
|
O MCP privado coordena autenticação, seleção de projeto, consumo de SEMAS, roteamento de profiles e decisões finais. A CLI executa o trabalho local ou na VPS: validação de contrato, drift, impacto, contexto IA-first, gates de documentação, checks de profiles e ações selecionadas do projeto.
|
|
36
36
|
|
|
@@ -58,7 +58,7 @@ O comando grava a chave MCP comercial no ambiente local do usuário como `SEMA_M
|
|
|
58
58
|
|
|
59
59
|
## Español
|
|
60
60
|
|
|
61
|
-
`@semacode/cli` ahora es el instalador/cliente
|
|
61
|
+
`@semacode/cli` ahora es el instalador/cliente npm de la CLI gobernada de Sema. No es el servidor MCP ni el control plane comercial.
|
|
62
62
|
|
|
63
63
|
El MCP privado coordina autenticación, selección de proyecto, consumo de SEMAS, ruteo de profiles y decisiones finales. La CLI ejecuta el trabajo local o en la VPS: validación de contrato, drift, impacto, contexto IA-first, gates de documentación, checks de profiles y acciones seleccionadas del proyecto.
|
|
64
64
|
|
package/SEMA_BRIEF.curto.txt
CHANGED
|
@@ -6,8 +6,9 @@ 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
|
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.
|
|
8
8
|
CODIGO_GOVERNADO: SEMA-GOVERNED -> docs-impacto e drift antes de alterar comportamento
|
|
9
|
+
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.
|
|
9
10
|
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 (+79)
|
|
10
11
|
TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+177)
|
|
11
12
|
TOP_LACUNAS: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados, execucao_critica_sem_bloco, execucao_implicita
|
|
12
13
|
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\deploy.md (+108)
|
|
13
|
-
GERADO_EM: 2026-06-
|
|
14
|
+
GERADO_EM: 2026-06-05T19:06:56.767Z
|
package/SEMA_BRIEF.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
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-
|
|
5
|
+
- Gerado em: `2026-06-05T19:06:56.767Z`
|
|
6
6
|
- Modulos: `85`
|
|
7
7
|
|
|
8
8
|
## Entrada canonica para IA
|
|
@@ -28,6 +28,15 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
|
|
|
28
28
|
- IA média: Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento.
|
|
29
29
|
- IA forte: Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift e finalizar-mudanca.
|
|
30
30
|
|
|
31
|
+
## Design visual
|
|
32
|
+
|
|
33
|
+
- 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.
|
|
34
|
+
- Aplicar quando: site, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual ou qualquer entrega com UI.
|
|
35
|
+
- 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 visualmente, pare e peça revisão.
|
|
36
|
+
- IA média: 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.
|
|
37
|
+
- IA 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.
|
|
38
|
+
- Proibido: interface_generica_2010, formularios_sem_hierarquia_visual, cards_cinzas_sem_identidade, layout_sem_responsividade_real, texto_estourando_ou_sobreposto
|
|
39
|
+
|
|
31
40
|
## Timeout e retry
|
|
32
41
|
|
|
33
42
|
- Regra: 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.
|
|
@@ -614,7 +623,7 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
|
|
|
614
623
|
- Faz: governa 2 task(s) com foco em validar runtime workflow
|
|
615
624
|
- Publico: nenhum
|
|
616
625
|
- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
|
|
617
|
-
- Score:
|
|
626
|
+
- Score: 90 | Confianca: alta | Risco: alto
|
|
618
627
|
- Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
|
|
619
628
|
|
|
620
629
|
### sema.produto.youtube_metadata
|
package/SEMA_BRIEF.micro.txt
CHANGED
|
@@ -5,7 +5,8 @@ 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
|
TIMEOUT_SEMA: timeout local nao e falha; retry progressivo 120s -> 300s -> 600s; escopar arquivo se projeto inteiro for lento
|
|
7
7
|
CODIGO_GOVERNADO: SEMA-GOVERNED -> chamar Sema antes de editar codigo gerado
|
|
8
|
+
DESIGN_VISUAL: se houver UI, moderno obrigatorio; fraca=padrao seguro responsivo; media=tokens+estados; forte=screenshot+assets+microinteracoes
|
|
8
9
|
TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+82)
|
|
9
10
|
TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+180)
|
|
10
11
|
TOP_LACUNAS: audit_ausente, auth_ausente, authz_frouxa (+3)
|
|
11
|
-
GERADO_EM: 2026-06-
|
|
12
|
+
GERADO_EM: 2026-06-05T19:06:56.767Z
|