@semacode/cli 1.5.43 → 1.5.44

package/AGENT_CONTEXT_PACK.json

@@ -23,8 +23,8 @@
     "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.",
+    "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.",
+    "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.",
     "Mantenha o cabeçalho SEMA-GOVERNED em código gerado ou governado e volte ao contrato antes de editar.",
     "Validação inline não dispensa cabeçalho SEMA-GOVERNED no arquivo físico sincronizado.",
     "Payload inline MCP acima de 262144 caracteres deve ser dividido por responsabilidade ou enviado por transporte autorizado; não é timeout para escalar.",
@@ -41,12 +41,12 @@
     "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 assumir repositório público, GitHub Release pública, leitura local pelo MCP ou acesso da IA ao painel; em IDE local prove CLI com sema --version, em web/remoto use sync inline.",
-    "Não usar a estética ASCII da DSL como desculpa para escrever PT-BR sem acentos.",
+    "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.",
     "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 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 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.",
     "Não tratar validação inline como dispensa de cabeçalho SEMA-GOVERNED no arquivo físico.",
     "Não tentar resolver payload inline acima de 262144 caracteres aumentando timeout.",
     "Não culpar o limite de 500 linhas por arquitetura monolítica escolhida pela IA.",
@@ -333,11 +333,11 @@
     }
   ],
   "politicaIdioma": {
-    "regra": "A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos. Em PT-BR, texto humano sem acentos é entrega inválida.",
+    "regra": "A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. Em PT-BR, use vocabulário Sema canônico: pontuação, desvio semântico, trava, pré-checagem, ambiente de execução e perfil. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos.",
     "idiomaHumanoPadrao": "pt-BR quando a conversa ou o projeto estiverem em português; caso contrário, use o idioma falado pelo usuário.",
     "preservarAcentos": true,
     "separarDslDeTextoHumano": true,
-    "comandosESimbolos": "Não traduza comandos, nomes de arquivos, rotas, símbolos de código ou palavras-chave da DSL."
+    "comandosESimbolos": "Não traduza comandos, nomes de arquivos, rotas, endpoints, variáveis, pacotes, marcas, símbolos de código ou palavras-chave da DSL."
   },
   "politicaCodigoGovernado": {
     "marcador": "SEMA-GOVERNED",
@@ -444,7 +444,7 @@
     "Em web/remoto sem workspace, use sema_chat_contexto e sema_sync inline com contrato, código selecionado, documentação e índice; se falhar, pare.",
     "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.",
     "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 a resposta humana estiver em PT-BR, use vocabulário Sema canônico e preserve acentos 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 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.",

package/README.md

@@ -1,97 +1,78 @@
 # @semacode/cli
 
-## English
+`@semacode/cli` é o instalador/cliente npm da CLI governada da Sema.
 
-`@semacode/cli` is the npm installer/client for the governed Sema CLI. In local IDEs, it is the complete Sema runtime for workspace access. It is not the MCP server and it is not the commercial control plane.
+Em IDE local, a CLI é a superfície completa para acesso ao workspace. Ela não é
+o servidor MCP remoto, não é o painel e não é o controle comercial inteiro. Ela
+opera localmente, mas consulta a pré-checagem comercial antes de executar ações
+governadas.
 
-The CLI checks SEMAS with the commercial control plane before local action through `sema preflight <command> --json`. The site key installer installs Node/npm when missing, installs this package globally, and saves `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL`, and compatibility MCP env vars. In a local IDE, the agent runs `sema --version` first; if it fails, it stops and asks the human to open the Sema panel and run the key installer.
-
-Use the CLI directly in local IDEs. Run `sema --version` first; if it fails, ask the human to install through the Sema panel. Then run `sema preflight resumo --json` and stop unless the decision is `use_cli_local`. Do not call remote MCP, `sema_sync`, `sema_contratos_sincronizar`, or `sema mcp-client` just to read a local workspace. Remote MCP remains the web/chat surface for ChatGPT, Lovable, GPTs, and similar clients without local workspace access.
+## Instalação
 
 ```bash
 npm install -g @semacode/cli
 ```
 
-### Runtime Flow
-
-```bash
-sema --version
-sema preflight resumo --json
-sema resumo . --curto
-sema validar contratos/pedidos.sema --json
-sema drift contratos/pedidos.sema --escopo modulo --json
-sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
-sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
-```
+Em uso real, o humano deve preferir o instalador de chave do painel Sema. A IA
+não acessa o painel. Se `sema --version` falhar, a IA deve parar e pedir ao
+humano para instalar pelo painel.
 
-### Local Key
+## Chave Local
 
 ```bash
 printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
 ```
 
-The command stores the commercial key in the local user environment as `SEMA_CLI_AUTH_TOKEN` and keeps `SEMA_MCP_AUTH_TOKEN` for compatibility, without receiving the secret as a CLI argument.
-
-## Português
-
-`@semacode/cli` agora é o instalador/cliente npm da CLI governada da Sema. Em IDE local, ele é o runtime completo da Sema para acesso ao workspace. Ele não é o servidor MCP nem o control plane comercial.
-
-A CLI consulta SEMAS no control plane comercial antes de agir localmente com `sema preflight <comando> --json`. O instalador de chave do site instala Node/npm quando faltar, instala este pacote globalmente e grava `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` e variáveis MCP de compatibilidade. Em IDE local, o agente roda `sema --version` primeiro; se falhar, ele para e pede ao humano para abrir o painel Sema e rodar o instalador de chave.
-
-Use a CLI diretamente em IDE local. Rode `sema --version` primeiro; se falhar, peça ao humano para instalar pelo painel Sema. Depois rode `sema preflight resumo --json` e pare se a decisão não for `use_cli_local`. Não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem `sema mcp-client` só para ler workspace local. O MCP remoto continua sendo a superfície web/chat para ChatGPT, Lovable, GPTs e clientes parecidos sem acesso ao workspace local.
+O comando grava a chave comercial no ambiente local como
+`SEMA_CLI_AUTH_TOKEN`, grava `SEMA_CLI_CONTROL_PLANE_URL` quando informado e
+mantém variáveis MCP de compatibilidade sem receber segredo como argumento de
+linha de comando.
 
-```bash
-npm install -g @semacode/cli
-```
-
-### Fluxo De Runtime
+## Fluxo Obrigatório Em IDE Local
 
 ```bash
 sema --version
 sema preflight resumo --json
 sema resumo . --curto
-sema validar contratos/pedidos.sema --json
-sema drift contratos/pedidos.sema --escopo modulo --json
 sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
+sema inspecionar contratos/pedidos.sema --json
+sema drift contratos/pedidos.sema --escopo modulo --json
+sema impacto contratos/pedidos.sema --alvo app.pedidos --mudanca "alterar pedidos" --json
 sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
 ```
 
-### Chave Local
+Se a decisão da pré-checagem não for `use_cli_local`, pare. Em workspace local,
+não chame MCP remoto, `sema_sync`, `sema_contratos_sincronizar` nem
+`sema mcp-client` só para ler a pasta local.
+
+## Geração De Código
 
 ```bash
-printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
+sema compilar contratos/pedidos.sema --alvo typescript --saida .tmp/pedidos-ts --estrutura modulos
+sema compilar contratos/pedidos.sema --alvo python --saida .tmp/pedidos-py --estrutura modulos
 ```
 
-O comando grava a chave comercial no ambiente local do usuário como `SEMA_CLI_AUTH_TOKEN` e mantém `SEMA_MCP_AUTH_TOKEN` por compatibilidade, sem receber o segredo como argumento da CLI.
-
-## Español
+A geração cria código com cabeçalho `SEMA-GOVERNED`, tipos/estruturas de entrada
+e saída, validações, garantias, erros e testes derivados do contrato.
 
-`@semacode/cli` ahora es el instalador/cliente npm de la CLI gobernada de Sema. En una IDE local, es el runtime completo de Sema para acceso al workspace. No es el servidor MCP ni el control plane comercial.
-
-La CLI consulta SEMAS en el control plane comercial antes de actuar localmente con `sema preflight <comando> --json`. El instalador de clave del sitio instala Node/npm cuando falten, instala este paquete globalmente y guarda `SEMA_CLI_AUTH_TOKEN`, `SEMA_CLI_CONTROL_PLANE_URL` y variables MCP de compatibilidad. En una IDE local, el agente ejecuta `sema --version` primero; si falla, para y pide al humano que abra el panel Sema y ejecute el instalador de clave.
-
-Usa la CLI directamente en una IDE local. Ejecuta `sema --version` primero; si falla, pide al humano que instale desde el panel Sema. Después ejecuta `sema preflight resumo --json` y para si la decisión no es `use_cli_local`. No llames el MCP remoto, `sema_sync`, `sema_contratos_sincronizar` ni `sema mcp-client` solo para leer un workspace local. El MCP remoto sigue siendo la superficie web/chat para ChatGPT, Lovable, GPTs y clientes similares sin acceso al workspace local.
-
-```bash
-npm install -g @semacode/cli
-```
+Alvos suportados pelo projeto incluem `typescript`, `python`, `dart`, `lua`,
+`javascript`, `html` e `css`. Estruturas e frameworks como `modulos`, `backend`,
+`nestjs` e `fastapi` podem ser usados quando aplicáveis.
 
-### Flujo De Runtime
+## Verificação
 
 ```bash
-sema --version
-sema preflight resumo --json
-sema resumo . --curto
 sema validar contratos/pedidos.sema --json
-sema drift contratos/pedidos.sema --escopo modulo --json
-sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
-sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
+sema diagnosticos contratos/pedidos.sema --json
+sema testar contratos/pedidos.sema --alvo typescript --saida .tmp/teste-pedidos
+sema verificar contratos/pedidos.sema --saida .tmp/verificacao-pedidos --json
 ```
 
-### Clave Local
+## Runner Remoto
 
-```bash
-printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
-```
+`sema runner servidor` só pode rodar sem token em host local. Bind público exige
+`--token` ou `SEMA_RUNNER_TOKEN`.
 
-El comando guarda la clave comercial en el entorno local del usuario como `SEMA_CLI_AUTH_TOKEN` y mantiene `SEMA_MCP_AUTH_TOKEN` por compatibilidad, sin recibir el secreto como argumento de la CLI.
+O runner remoto existe para snapshots controlados e validação em ambiente
+isolado. Ele não é desculpa para enviar workspace local inteiro sem filtro nem
+para vazar segredo.

package/SEMA_BRIEF.curto.txt

@@ -1,6 +1,6 @@
 PROJETO: Sema
 BASE: C:\GitHub\Sema
-MODULOS: 89
+MODULOS: 91
 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
@@ -10,8 +10,8 @@ CODIGO_GOVERNADO: SEMA-GOVERNED -> docs-impacto e drift antes de alterar comport
 ORCAMENTO_SEMANTICO: acima de 300 linhas exige refatoracao planejada; acima de 500 bloqueia finalizar-mudanca, drift, geracao e snapshot
 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
 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 (+186)
+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 (+85)
+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 (+190)
 TOP_LACUNAS: execucao_implicita, 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 (+140)
-GERADO_EM: 2026-06-07T18:00:27.640Z
+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 (+146)
+GERADO_EM: 2026-06-08T03:42:53.789Z

package/SEMA_BRIEF.md

@@ -2,8 +2,8 @@
 
 Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem varrer o repo inteiro no escuro.
 
-- Gerado em: `2026-06-07T18:00:27.640Z`
-- Modulos: `89`
+- Gerado em: `2026-06-08T03:42:53.789Z`
+- Modulos: `91`
 
 ## Entrada canonica para IA
 
@@ -322,7 +322,7 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 ### sema.produto.geradores_web
 - Faz: governa 3 task(s) com foco em gerar contrato javascript
 - Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\gerador-css\src\index.part02.ts, C:\GitHub\Sema\pacotes\gerador-css\src\index.ts, C:\GitHub\Sema\pacotes\gerador-html\src\index.ts, C:\GitHub\Sema\pacotes\gerador-javascript\src\index.ts
+- Tocar: C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\da-sema-para-codigo.md, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\gerador-css\src\index.part02.ts (+3)
 - Score: 90 | Confianca: alta | Risco: medio
 - Lacunas: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
 
@@ -382,6 +382,13 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Score: 93 | Confianca: alta | Risco: alto
 - Lacunas: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
 
+### sema.produto.governanca_ia.vocabulario
+- Faz: governa 1 task(s) com foco em aplicar vocabulario canonico ia
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\docs\vocabulario-sema.md, C:\GitHub\Sema\pacotes\cli\src\agentContextPack.ts, C:\GitHub\Sema\pacotes\cli\src\agentEntryPoints.ts, C:\GitHub\Sema\testes\unidade\agent-entrypoints-governanca.test.ts
+- Score: 95 | Confianca: alta | Risco: medio
+- Lacunas: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
+
 ### sema.produto.governanca_ia
 - Faz: governa o modulo sema produto governanca ia
 - Publico: nenhum
@@ -438,6 +445,13 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Score: 0 | Confianca: baixa | Risco: baixo
 - Lacunas: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
 
+### sema.mcp.acesso_hardening
+- Faz: governa 3 task(s) com foco em validar boot mcp publico
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\mcp\src\accessHardening.ts, C:\GitHub\Sema\mcp\src\billing.ts, C:\GitHub\Sema\mcp\src\httpServer.ts, C:\GitHub\Sema\pacotes\cli\src\runnerValidacaoRemotaServidor.ts
+- Score: 93 | Confianca: alta | Risco: alto
+- Lacunas: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida, persistencia:runner_postgres:materializado:desconhecida
+
 ### sema.integracao.mcp_cli_billing
 - Faz: governa 6 task(s) com foco em instalar chave cli local
 - Publico: nenhum

package/SEMA_BRIEF.micro.txt

@@ -1,5 +1,5 @@
 PROJETO: Sema
-MODULOS: 89
+MODULOS: 91
 MODO_CODIGO: codigo_completo
 FONTES_CONCLUSAO: contrato, codigo
 ENTRADA_IA: SEMA_BOOT.md -> SEMA_SMALL_MODEL.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
@@ -10,7 +10,7 @@ ORCAMENTO_SEMANTICO: aviso>300 linhas; bloqueio>500; dividir por responsabilidad
 PAYLOAD_MCP: inline>262144 caracteres nao e timeout; modularize por responsabilidade ou use anexo/caminho autorizado
 SINAL_VS_RITUAL: score/achados/decisaoAgente sao triagem; exigir evidencia concreta alem de palavra-chave ou regex
 DESIGN_VISUAL: se houver UI, moderno obrigatorio; fraca=padrao seguro responsivo; media=tokens+estados; forte=screenshot+assets+microinteracoes
-TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+86)
-TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+189)
+TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+88)
+TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+193)
 TOP_LACUNAS: execucao_implicita, persistencia:public.sema_monthly_balances:materializado:desconhecida, persistencia:public.sema_usage_events:materializado:desconhecida (+1)
-GERADO_EM: 2026-06-07T18:00:27.640Z
+GERADO_EM: 2026-06-08T03:42:53.789Z