@semacode/cli 1.5.35 → 1.5.36

package/dist/index.js

@@ -1613,6 +1613,54 @@ function criarPoliticaTimeoutResumoAgentContext() {
         },
     };
 }
+function criarPoliticaDesignVisualAgentContext() {
+    return {
+        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.",
+        modernoObrigatorio: true,
+        aplicarQuando: "site, app, dashboard, painel, admin, onboarding, formulário, modal, jogo, material visual ou qualquer entrega com UI.",
+        proibicoes: [
+            "interface_generica_2010",
+            "formularios_sem_hierarquia_visual",
+            "cards_cinzas_sem_identidade",
+            "layout_sem_responsividade_real",
+            "texto_estourando_ou_sobreposto",
+            "sem_estados_de_hover_focus_loading_erro_vazio",
+            "sem_assets_quando_o_dominio_pede_visual",
+            "copiar_estetica_do_contrato_para_ui",
+        ],
+        porCapacidade: {
+            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.",
+        },
+        evidencias: {
+            fraca: [
+                "descrever padrão visual escolhido",
+                "confirmar responsividade básica",
+                "listar estados essenciais",
+            ],
+            media: [
+                "registrar tokens e componentes usados",
+                "validar desktop e mobile",
+                "corrigir texto sobreposto",
+            ],
+            forte: [
+                "screenshot desktop/mobile",
+                "verificação de assets e renderização",
+                "auditoria de contraste, hierarquia e estado vazio",
+            ],
+        },
+        criteriosMinimos: [
+            "não parecer template de 2010",
+            "hierarquia visual clara",
+            "paleta com contraste e identidade do domínio",
+            "responsividade mobile e desktop",
+            "estados de hover, focus, loading, erro e vazio quando aplicáveis",
+            "texto sem overlap ou estouro",
+            "componentes coerentes com o workflow real",
+        ],
+    };
+}
 function criarEntrypointsClientesIa() {
     return [
         {
@@ -1656,6 +1704,7 @@ function criarFailClosedAgentContext() {
         "Se a resposta humana estiver em PT-BR, preserve acentos e símbolos mesmo que a DSL use ASCII.",
         "Se um arquivo de código tiver SEMA-GOVERNED, consulte Sema e o contrato aplicável antes de editar.",
         "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.",
+        "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.",
     ];
 }
 function criarAgentContextPack(guiaPorCapacidade) {
@@ -1767,7 +1816,7 @@ function criarAgentContextPack(guiaPorCapacidade) {
     ];
     return {
         nome: "Agent Context Pack",
-        versao: 3,
+        versao: 4,
         objetivo: "Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.",
         ordemLeitura: [
             ARQUIVO_SEMA_BOOT,
@@ -1790,17 +1839,19 @@ function criarAgentContextPack(guiaPorCapacidade) {
             "Responda no idioma do usuário e preserve acentos, cedilha, pontuação e símbolos humanos.",
             "Mantenha o cabeçalho SEMA-GOVERNED em código gerado ou governado e volte ao contrato antes de editar.",
             "Se uma chamada Sema estourar por timeout local, aumente o timeout e tente novamente; não trate lentidão como sessão inativa.",
+            "Se a tarefa tiver UI, trate design moderno como requisito governado por capacidade.",
         ],
         proibicoes: [
             "Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
             "Não tratar README, texto livre ou código como fonte superior ao contrato.",
             "Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
             "Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
-            "Não misturar repositório público e privado sem conferir docs de repositórios e AGENTS.md.",
+            "Não assumir repositório público, GitHub Release pública ou leitura local pelo MCP; confira docs de repositórios e AGENTS.md.",
             "Não usar a estética ASCII da DSL como desculpa para escrever PT-BR sem acentos.",
             "Não remover SEMA-GOVERNED nem substituir drift por comentário dentro do código.",
             "Não copiar o contrato inteiro para comentário de código; mantenha descrição humana curta.",
             "Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate.",
+            "Não entregar interface genérica, cinza, com cara de template antigo ou sem estados visuais quando a tarefa envolve UI.",
         ],
         prioridades: [
             "Menor artefato suficiente primeiro.",
@@ -1808,6 +1859,7 @@ function criarAgentContextPack(guiaPorCapacidade) {
             "Exemplos oficiais antes de nova sintaxe.",
             "Diagnóstico estruturado antes de opinião livre.",
             "Retry progressivo em timeout antes de declarar bloqueio.",
+            "Design visual por capacidade quando houver UI.",
             "Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto.",
         ],
         fontes,
@@ -1825,6 +1877,7 @@ function criarAgentContextPack(guiaPorCapacidade) {
         politicaIdioma: criarPoliticaIdiomaAgentContext(),
         politicaCodigoGovernado: criarPoliticaCodigoGovernadoAgentContext(),
         politicaTimeoutResumo: criarPoliticaTimeoutResumoAgentContext(),
+        politicaDesignVisual: criarPoliticaDesignVisualAgentContext(),
         failClosed: criarFailClosedAgentContext(),
     };
 }
@@ -1832,6 +1885,7 @@ function renderizarSemaBoot(agentContextPack) {
     const politica = agentContextPack.politicaIdioma;
     const politicaCodigo = agentContextPack.politicaCodigoGovernado;
     const politicaTimeout = agentContextPack.politicaTimeoutResumo;
+    const politicaDesign = agentContextPack.politicaDesignVisual;
     return `# SEMA_BOOT
 
 Você está em um projeto governado por Sema. O contrato semântico vem antes de qualquer ação.
@@ -1859,6 +1913,16 @@ ${politicaCodigo.regra}
 - IA média: ${politicaCodigo.porCapacidade.media}
 - IA forte: ${politicaCodigo.porCapacidade.forte}
 
+## Design visual quando houver UI
+
+${politicaDesign.regra}
+
+- Aplicar quando: ${politicaDesign.aplicarQuando}
+- IA fraca: ${politicaDesign.porCapacidade.fraca}
+- IA média: ${politicaDesign.porCapacidade.media}
+- IA forte: ${politicaDesign.porCapacidade.forte}
+- Proibido: ${politicaDesign.proibicoes.slice(0, 5).join(", ")}.
+
 ## Timeout e retry
 
 ${politicaTimeout.regra}
@@ -1886,6 +1950,7 @@ ${agentContextPack.failClosed.map((regra) => `- ${regra}`).join("\n")}
 }
 function renderizarSemaSmallModel(agentContextPack) {
     const politicaTimeout = agentContextPack.politicaTimeoutResumo;
+    const politicaDesign = agentContextPack.politicaDesignVisual;
     return `# SEMA_SMALL_MODEL
 
 Leia isto primeiro se você tem pouco contexto, pouca memória, pouco tool use ou tendência a ignorar instruções longas.
@@ -1899,6 +1964,7 @@ Leia isto primeiro se você tem pouco contexto, pouca memória, pouco tool use o
 7. Responda no idioma do usuário. Em PT-BR, use acentos e símbolos normais.
 8. Se abrir código com \`${agentContextPack.politicaCodigoGovernado.marcador}\`: volte ao contrato, chame Sema e só então edite.
 9. Se Sema estourar por timeout local: aumente o timeout e tente de novo. Não trate isso como falha do Sema.
+10. Se a tarefa tiver UI: aplique design moderno mínimo, responsivo, com hierarquia clara e estados visuais. Não entregue formulário cinza genérico.
 
 Ordem curta:
 
@@ -1916,12 +1982,20 @@ Timeout:
 - Se o projeto inteiro for lento, escopar para \`sema resumo <arquivo.sema> --micro --para mudanca\`.
 - ${politicaTimeout.ateQuandoTentar}
 
+Design visual:
+
+- ${politicaDesign.regra}
+- IA fraca: ${politicaDesign.porCapacidade.fraca}
+- Evidência mínima: ${politicaDesign.evidencias.fraca.join(", ")}.
+- Proibido: ${politicaDesign.proibicoes.slice(0, 5).join(", ")}.
+
 Fail-closed:
 
 ${agentContextPack.failClosed.map((regra) => `- ${regra}`).join("\n")}
 `;
 }
 function renderizarDocumentoAgentesPorCapacidade(agentContextPack) {
+    const politicaDesign = agentContextPack.politicaDesignVisual;
     return `# Agentes por capacidade
 
 Sema deve funcionar em agentes fortes, médios e fracos. A diferença não é só tamanho de contexto; é disciplina operacional.
@@ -1934,6 +2008,19 @@ Arquivos gerados ou governados pela Sema devem manter o marcador \`${agentContex
 - Média: ${agentContextPack.politicaCodigoGovernado.porCapacidade.media}
 - Forte: ${agentContextPack.politicaCodigoGovernado.porCapacidade.forte}
 
+## Design Visual
+
+${politicaDesign.regra}
+
+- Fraca: ${politicaDesign.porCapacidade.fraca}
+  Evidência: ${politicaDesign.evidencias.fraca.join(", ")}.
+- Média: ${politicaDesign.porCapacidade.media}
+  Evidência: ${politicaDesign.evidencias.media.join(", ")}.
+- Forte: ${politicaDesign.porCapacidade.forte}
+  Evidência: ${politicaDesign.evidencias.forte.join(", ")}.
+- Proibido: ${politicaDesign.proibicoes.join(", ")}.
+- Critérios mínimos: ${politicaDesign.criteriosMinimos.join(", ")}.
+
 ## Fraca
 
 Use para Copilot em modo simples, Cline/Roo com pouco contexto, modelos locais pequenos e agentes que ignoram instrução longa.
@@ -1984,6 +2071,7 @@ ${agentContextPack.entrypointsClientes.map((cliente) => `- ${cliente.cliente}: $
 function renderizarInstrucaoClienteSema(cliente, capacidade, agentContextPack) {
     const guia = agentContextPack.guiaPorCapacidade[capacidade];
     const politicaTimeout = agentContextPack.politicaTimeoutResumo;
+    const politicaDesign = agentContextPack.politicaDesignVisual;
     const tituloCliente = cliente === "generico" ? "agente" : cliente;
     return `# Sema para ${tituloCliente}
 
@@ -2013,6 +2101,12 @@ Código governado:
 - Ao encontrar esse marcador, volte ao contrato .sema aplicável e chame Sema antes de editar.
 - Comentário de código é lembrete curto; não substitui drift, docs-impacto nem finalizar-mudanca.
 
+Design visual:
+- Se houver UI, design moderno é requisito governado, não enfeite.
+- Capacidade ${capacidade}: ${politicaDesign.porCapacidade[capacidade]}
+- Evidências: ${politicaDesign.evidencias[capacidade].join(", ")}.
+- Proibido: ${politicaDesign.proibicoes.slice(0, 5).join(", ")}.
+
 Idioma:
 - Responda no idioma do usuário.
 - Em PT-BR, use acentos, cedilha, pontuação e símbolos normais.
@@ -2396,6 +2490,15 @@ function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade) {
         `- IA média: ${agentContextPack.politicaCodigoGovernado.porCapacidade.media}`,
         `- IA forte: ${agentContextPack.politicaCodigoGovernado.porCapacidade.forte}`,
         "",
+        "## Design visual",
+        "",
+        `- Regra: ${agentContextPack.politicaDesignVisual.regra}`,
+        `- Aplicar quando: ${agentContextPack.politicaDesignVisual.aplicarQuando}`,
+        `- IA fraca: ${agentContextPack.politicaDesignVisual.porCapacidade.fraca}`,
+        `- IA média: ${agentContextPack.politicaDesignVisual.porCapacidade.media}`,
+        `- IA forte: ${agentContextPack.politicaDesignVisual.porCapacidade.forte}`,
+        `- Proibido: ${agentContextPack.politicaDesignVisual.proibicoes.slice(0, 5).join(", ")}`,
+        "",
         "## Timeout e retry",
         "",
         `- Regra: ${agentContextPack.politicaTimeoutResumo.regra}`,
@@ -2768,6 +2871,7 @@ async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz
         `ENTRADA_IA: ${entradaCanonica.porCapacidade.fraca.join(" -> ")}`,
         `TIMEOUT_SEMA: timeout local nao e falha; retry progressivo ${agentContextPack.politicaTimeoutResumo.escalonamentoSegundos.map((segundos) => `${segundos}s`).join(" -> ")}; escopar arquivo se projeto inteiro for lento`,
         `CODIGO_GOVERNADO: ${agentContextPack.politicaCodigoGovernado.marcador} -> chamar Sema antes de editar codigo gerado`,
+        `DESIGN_VISUAL: se houver UI, moderno obrigatorio; fraca=padrao seguro responsivo; media=tokens+estados; forte=screenshot+assets+microinteracoes`,
         `TOP_MODULOS: ${resumirListaTexto(modulos.map((modulo) => modulo.modulo), 3)}`,
         `TOP_RISCOS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.riscosPrincipais)), 3)}`,
         `TOP_LACUNAS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.lacunas)), 3)}`,
@@ -2788,6 +2892,7 @@ async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escreverNaRaiz
         `ENTRADA_IA: ${entradaCanonica.porCapacidade.media.join(" -> ")}`,
         `TIMEOUT_SEMA: ${agentContextPack.politicaTimeoutResumo.regra} Escale ${agentContextPack.politicaTimeoutResumo.escalonamentoSegundos.map((segundos) => `${segundos}s`).join(" -> ")} antes de declarar bloqueio.`,
         `CODIGO_GOVERNADO: ${agentContextPack.politicaCodigoGovernado.marcador} -> docs-impacto e drift antes de alterar comportamento`,
+        `DESIGN_VISUAL: ${agentContextPack.politicaDesignVisual.regra} Fraca=${agentContextPack.politicaDesignVisual.porCapacidade.fraca} Media=${agentContextPack.politicaDesignVisual.porCapacidade.media} Forte=${agentContextPack.politicaDesignVisual.porCapacidade.forte}`,
         `TOP_MODULOS: ${resumirListaTexto(modulos.map((modulo) => modulo.modulo), 6)}`,
         `TOP_RISCOS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.riscosPrincipais)), 6)}`,
         `TOP_LACUNAS: ${resumirListaTexto(unicosOrdenados(modulos.flatMap((modulo) => modulo.lacunas)), 6)}`,