@semacode/cli 1.5.35 → 1.5.37

package/AGENTS.md

@@ -29,7 +29,7 @@ Idioma humano: responda no idioma falado pelo usuário. Em PT-BR, use acentos, c
 
 ## MCP
 
-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.
+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.
 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.
 
 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

@@ -1,6 +1,6 @@
 {
   "nome": "Agent Context Pack",
-  "versao": 3,
+  "versao": 5,
   "objetivo": "Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.",
   "ordemLeitura": [
     "SEMA_BOOT.md",
@@ -20,27 +20,45 @@
     "Use SEMA_INDEX.json para escolher contrato, módulo e arquivos prováveis antes de abrir código cru.",
     "Valide .sema alterado e rode drift antes de concluir.",
     "Quando faltar contrato aplicável, crie ou edite o contrato antes do código.",
+    "Sema não contorna políticas da plataforma; ele governa contrato, escopo, drift, evidência e qualidade.",
     "Responda no idioma do usuário e preserve acentos, cedilha, pontuação e símbolos humanos.",
+    "Use score composto, achados e decisaoAgente como sinais de triagem; confirme substância com contrato, código e evidência.",
     "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."
+    "Validação inline não dispensa cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
+    "Não crie nem conclua arquivo acima de 500 linhas; acima de 300, planeje divisão por responsabilidade.",
+    "Divida arquivo 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.",
+    "Caminho Linux retornado pelo MCP remoto é espelho governado do Sema; não confunda com o checkout local do usuário.",
+    "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 tratar orçamento semântico como sugestão; arquivo grande deve ser dividido antes de concluir.",
+    "Não fatiar arquivo grande em partes sem responsabilidade real para passar no limite.",
+    "Não tratar score 100, regex ou presença de palavra-chave como prova suficiente de governança.",
+    "Não tratar validação inline como dispensa de cabeçalho SEMA-GOVERNED no arquivo físico.",
+    "Não culpar o limite de 500 linhas por arquitetura monolítica escolhida pela IA.",
+    "Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate.",
+    "Não usar Sema para contornar política, segurança, permissões, termos ou filtros da plataforma.",
+    "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.",
     "Contrato, índice e AGENTS antes de código cru.",
     "Exemplos oficiais antes de nova sintaxe.",
     "Diagnóstico estruturado antes de opinião livre.",
+    "Compatibilidade com políticas da plataforma antes de reformular ou continuar após alerta externo.",
+    "Sinal sem evidência vira ritual; evidência concreta antes de concluir aderência.",
     "Retry progressivo em timeout antes de declarar bloqueio.",
+    "Orçamento semântico, divisão por responsabilidade e cabeçalho governado antes de gravar ou finalizar código.",
+    "Design visual por capacidade quando houver UI.",
     "Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto."
   ],
   "fontes": [
@@ -266,6 +284,36 @@
       "capacidadePadrao": "media",
       "observacao": "OpenCode deve receber a mesma regra curta em instructions.md quando a pasta .opencode já existir."
     },
+    {
+      "cliente": "cursor",
+      "arquivos": [
+        ".cursor/rules/sema.mdc",
+        "AGENTS.md",
+        "SEMA_BOOT.md"
+      ],
+      "capacidadePadrao": "media",
+      "observacao": "Cursor deve receber uma regra curta própria para não depender de leitura completa do AGENTS.md."
+    },
+    {
+      "cliente": "claude",
+      "arquivos": [
+        ".claude/CLAUDE.md",
+        "AGENTS.md",
+        "SEMA_BOOT.md"
+      ],
+      "capacidadePadrao": "forte",
+      "observacao": "Claude costuma seguir gates longos, mas ainda precisa de entrypoint explícito e repetido no workspace."
+    },
+    {
+      "cliente": "windsurf",
+      "arquivos": [
+        ".windsurf/rules.md",
+        "AGENTS.md",
+        "SEMA_BOOT.md"
+      ],
+      "capacidadePadrao": "media",
+      "observacao": "Windsurf deve receber regra curta dedicada para evitar cair direto no código sem Sema."
+    },
     {
       "cliente": "generico",
       "arquivos": [
@@ -286,12 +334,12 @@
   },
   "politicaCodigoGovernado": {
     "marcador": "SEMA-GOVERNED",
-    "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.",
-    "descricaoHumana": "O comentário deve orientar humanos e IAs sem duplicar o contrato inteiro dentro do código.",
+    "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. Acima de 300 linhas gera diagnóstico de refatoração; acima de 500 linhas bloqueia drift, finalização, geração e snapshot. O limite exige divisão por responsabilidade real, não fatiamento artificial como index_p1.html, index_p2.html só para passar no gate.",
+    "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.",
     "porCapacidade": {
-      "fraca": "Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar.",
-      "media": "Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento.",
-      "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."
+      "fraca": "Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar. Não crie arquivo acima de 500 linhas; divida antes por responsabilidade, nunca em partes p1/p2 sem sentido.",
+      "media": "Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento. Trate 300+ linhas como refatoração provável; em UI, separe estrutura, estilos, estado, renderização, cálculo e dados.",
+      "forte": "Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift, orçamento de 500 linhas e finalizar-mudanca. Contexto grande não autoriza monólito."
     },
     "formatosPorAlvo": {
       "typescript": "// SEMA-GOVERNED",
@@ -299,8 +347,8 @@
       "python": "# SEMA-GOVERNED",
       "dart": "// SEMA-GOVERNED",
       "lua": "-- SEMA-GOVERNED",
-      "html": "<!-- SEMA-GOVERNED -->",
-      "css": "/* SEMA-GOVERNED */"
+      "html": "<!--\nSEMA-GOVERNED: modulo_ou_contrato\nDescrição: o que este arquivo implementa e qual contrato consultar\n-->",
+      "css": "/*\nSEMA-GOVERNED: modulo_ou_contrato\nDescrição: estilos governados e contrato aplicável\n*/"
     }
   },
   "politicaTimeoutResumo": {
@@ -319,6 +367,69 @@
       "forte": "Pode rodar projeto inteiro com timeout alto, mas deve distinguir lentidão de falha real e registrar evidência."
     }
   },
+  "politicaDesignVisual": {
+    "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"
+    ]
+  },
+  "politicaPlataforma": {
+    "regra": "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.",
+    "escopoGovernanca": "Contrato primeiro, documentação obrigatória, rastreabilidade, auditoria de drift, orçamento semântico, idioma humano, design quando houver UI e evidência de fechamento.",
+    "naoContornaPoliticas": true,
+    "quandoHouverBloqueio": "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.",
+    "proibicoes": [
+      "contornar_politica_da_plataforma",
+      "apresentar_sema_como_bypass_de_seguranca",
+      "insistir_em_conteudo_bloqueado",
+      "confundir_governanca_com_permissao_para_acao_proibida"
+    ],
+    "porCapacidade": {
+      "fraca": "Se aparecer alerta de política, pare. Diga que Sema é governança de projeto, não bypass; peça reformulação segura ou contexto permitido.",
+      "media": "Separe bloqueio da plataforma de erro do Sema. Reformule em linguagem neutra quando permitido e mantenha os gates; não tente contornar filtro.",
+      "forte": "Registre evidência, reduza ambiguidade e continue apenas no escopo permitido pela plataforma. Governança Sema nunca substitui política externa."
+    }
+  },
   "failClosed": [
     "Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
     "Se não houver contrato aplicável, crie ou edite o .sema antes do código.",
@@ -326,6 +437,13 @@
     "Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
     "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 um arquivo passar de 300 linhas, planeje divisão; se passar de 500, pare e divida antes de concluir.",
+    "Se um arquivo passar do orçamento, divida por responsabilidade real; não fatie em partes artificiais para enganar limite.",
+    "Se score, achados ou decisaoAgente parecerem bons, trate como sinal de triagem e confira evidência concreta no contrato e no código.",
+    "Se validar artefato inline com 100/100, ainda preserve cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
+    "Se o MCP retornar caminho Linux como /srv/sema/projetos, trate como espelho remoto autorizado, não como pasta local do usuário.",
+    "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 plataforma bloquear ou alertar política, trate como bloqueio externo ou falso positivo possível; explique sem tentar contornar filtro.",
+    "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."
   ]
 }

package/LICENSE

@@ -18,5 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
+SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 ## English
 
-`@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.
+`@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.
 
 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.
 
@@ -30,7 +30,7 @@ The command stores the commercial MCP key in the local user environment as `SEMA
 
 ## Português
 
-`@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.
+`@semacode/cli` agora é o instalador/cliente npm da CLI governada da Sema. Ele não é o servidor MCP nem o control plane comercial.
 
 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.
 
@@ -58,7 +58,7 @@ O comando grava a chave MCP comercial no ambiente local do usuário como `SEMA_M
 
 ## Español
 
-`@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.
+`@semacode/cli` ahora es el instalador/cliente npm de la CLI gobernada de Sema. No es el servidor MCP ni el control plane comercial.
 
 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.
 

package/SEMA_BRIEF.curto.txt

@@ -1,13 +1,16 @@
 PROJETO: Sema
 BASE: C:\GitHub\Sema
-MODULOS: 85
+MODULOS: 89
 MODO_CODIGO: codigo_completo
 FONTES_CONCLUSAO: contrato, codigo
 ENTRADA_IA: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+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.
 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.
 CODIGO_GOVERNADO: SEMA-GOVERNED -> docs-impacto e drift antes de alterar comportamento
-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)
-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)
-TOP_LACUNAS: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados, execucao_critica_sem_bloco, execucao_implicita
-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)
-GERADO_EM: 2026-06-05T15:14:17.230Z
+ORCAMENTO_SEMANTICO: acima de 300 linhas exige refatoracao planejada; acima de 500 bloqueia finalizar-mudanca, drift, geracao e snapshot
+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.
+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 (+83)
+TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+185)
+TOP_LACUNAS: execucao_implicita, persistencia:ConsumoOperacao:parcial:desconhecida, persistencia:contexto_ia:materializado:desconhecida, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
+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 (+139)
+GERADO_EM: 2026-06-06T17:03:38.912Z