@semacode/cli 1.5.31 → 1.5.32

package/README.md

@@ -1,144 +1,85 @@
-# @semacode/cli
-
-## English
-
-`@semacode/cli` is the public Sema command-line package published on npm.
-
-It validates `.sema` contracts, checks semantic drift against live code, maps impact, prepares AI-first context, enforces documentation gates, and validates the official Sema profiles: Software, Workflow/Ops, Author, Game, Legal, and Research.
-
-Current public version: `1.5.29`.
-
-### Install
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema doctor
-```
-
-### Core Flow
-
-```bash
-sema iniciar
-sema validar contratos/pedidos.sema --json
-sema drift contratos/pedidos.sema --escopo modulo --json
-sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "replace pedido_id with pedido_uuid" --json
-sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
-sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
-```
-
-### MCP Client Key
-
-```bash
-printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
-```
-
-The command stores the commercial MCP key in the local user environment as `SEMA_MCP_AUTH_TOKEN` without receiving the secret as a CLI argument.
-
-### Common Commands
-
-- `sema validar <arquivo-ou-pasta> --json`
-- `sema drift <arquivo-ou-pasta> --json`
-- `sema resumo <arquivo-ou-pasta> --micro --para onboarding`
-- `sema contexto-ia <arquivo.sema> --saida <diretorio> --json`
-- `sema author briefing <arquivo.sema> --json`
-- `sema author revisar-cliches <arquivo.sema> --texto <texto> --json`
-- `sema author validar-narrativa <arquivo.sema> --texto <texto> [--texto-anterior <texto>] --json`
-- `sema profile validar <software|workflow|ops|game|legal|research> <arquivo.sema> --json`
-
-## Português
-
-`@semacode/cli` é o pacote público de linha de comando da Sema publicado no npm.
-
-Ele valida contratos `.sema`, verifica drift semântico contra código vivo, mapeia impacto, prepara contexto IA-first, aplica gates de documentação e valida os profiles oficiais da Sema: Software, Workflow/Ops, Author, Game, Legal e Research.
-
-Versão pública atual: `1.5.29`.
-
-### Instalar
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema doctor
-```
-
-### Fluxo Central
-
-```bash
-sema iniciar
-sema validar contratos/pedidos.sema --json
-sema drift contratos/pedidos.sema --escopo modulo --json
-sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "trocar pedido_id por pedido_uuid" --json
-sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
-sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
-```
-
-### Chave MCP Do Cliente
-
-```bash
-printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
-```
-
-O comando grava a chave MCP comercial no ambiente local do usuário como `SEMA_MCP_AUTH_TOKEN`, sem receber o segredo como argumento da CLI.
-
-### Comandos Comuns
-
-- `sema validar <arquivo-ou-pasta> --json`
-- `sema drift <arquivo-ou-pasta> --json`
-- `sema resumo <arquivo-ou-pasta> --micro --para onboarding`
-- `sema contexto-ia <arquivo.sema> --saida <diretorio> --json`
-- `sema author briefing <arquivo.sema> --json`
-- `sema author revisar-cliches <arquivo.sema> --texto <texto> --json`
-- `sema author validar-narrativa <arquivo.sema> --texto <texto> [--texto-anterior <texto>] --json`
-- `sema profile validar <software|workflow|ops|game|legal|research> <arquivo.sema> --json`
-
-## Español
-
-`@semacode/cli` es el paquete público de línea de comando de Sema publicado en npm.
-
-Valida contratos `.sema`, verifica drift semántico contra código vivo, mapea impacto, prepara contexto IA-first, aplica gates de documentación y valida los profiles oficiales de Sema: Software, Workflow/Ops, Author, Game, Legal y Research.
-
-Versión pública actual: `1.5.29`.
-
-### Instalar
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema doctor
-```
-
-### Flujo Central
-
-```bash
-sema iniciar
-sema validar contratos/pedidos.sema --json
-sema drift contratos/pedidos.sema --escopo modulo --json
-sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "cambiar pedido_id por pedido_uuid" --json
-sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
-sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
-```
-
-### Clave MCP Del Cliente
-
-```bash
-printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
-```
-
-El comando guarda la clave MCP comercial en el entorno local del usuario como `SEMA_MCP_AUTH_TOKEN`, sin recibir el secreto como argumento de la CLI.
-
-### Comandos Comunes
-
-- `sema validar <arquivo-ou-pasta> --json`
-- `sema drift <arquivo-ou-pasta> --json`
-- `sema resumo <arquivo-ou-pasta> --micro --para onboarding`
-- `sema contexto-ia <arquivo.sema> --saida <diretorio> --json`
-- `sema author briefing <arquivo.sema> --json`
-- `sema author revisar-cliches <arquivo.sema> --texto <texto> --json`
-- `sema author validar-narrativa <arquivo.sema> --texto <texto> [--texto-anterior <texto>] --json`
-- `sema profile validar <software|workflow|ops|game|legal|research> <arquivo.sema> --json`
-
-## Links
-
-- Repository: <https://github.com/gerlanss/Sema>
-- Documentation: <https://github.com/gerlanss/Sema/tree/main/docs>
+# @semacode/cli
+
+## 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.
+
+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.
+
+```bash
+npm install -g @semacode/cli
+```
+
+### Runtime Flow
+
+```bash
+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
+```
+
+### MCP Client Key
+
+```bash
+printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
+```
+
+The command stores the commercial MCP key in the local user environment as `SEMA_MCP_AUTH_TOKEN` without receiving the secret as a CLI argument.
+
+## 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.
+
+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.
+
+```bash
+npm install -g @semacode/cli
+```
+
+### Fluxo De Runtime
+
+```bash
+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
+```
+
+### Chave MCP Do Cliente
+
+```bash
+printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
+```
+
+O comando grava a chave MCP comercial no ambiente local do usuário como `SEMA_MCP_AUTH_TOKEN`, sem receber o segredo como argumento da CLI.
+
+## 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.
+
+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.
+
+```bash
+npm install -g @semacode/cli
+```
+
+### Flujo De Runtime
+
+```bash
+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
+```
+
+### Clave MCP Del Cliente
+
+```bash
+printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
+```
+
+El comando guarda la clave MCP comercial en el entorno local del usuario como `SEMA_MCP_AUTH_TOKEN`, sin recibir el secreto como argumento de la CLI.

package/SEMA_BRIEF.curto.txt

@@ -0,0 +1,11 @@
+PROJETO: Sema
+BASE: C:\GitHub\Sema
+MODULOS: 84
+MODO_CODIGO: codigo_completo
+FONTES_CONCLUSAO: contrato, codigo
+ENTRADA_IA: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+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 (+78)
+TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+174)
+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\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\documentacao.md (+104)
+GERADO_EM: 2026-06-04T04:37:43.152Z