@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 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 por pacote npm publico neste repositorio.
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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "nome": "Agent Context Pack",
3
- "versao": 3,
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 misturar repositório público e privado sem conferir docs de repositórios e AGENTS.md.",
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 public npm installer/client for the governed Sema CLI. It is not the MCP server and it is not the commercial control plane.
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 público da CLI governada da Sema no npm. Ele não é o servidor MCP nem o control plane comercial.
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 público de la CLI gobernada de Sema en npm. No es el servidor MCP ni el control plane comercial.
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
 
@@ -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-05T15:14:17.230Z
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-05T15:14:17.230Z`
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: 60 | Confianca: media | Risco: alto
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
@@ -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-05T15:14:17.230Z
12
+ GERADO_EM: 2026-06-05T19:06:56.767Z