@semacode/cli 1.5.17 → 1.5.19

package/README.md

@@ -1,112 +1,144 @@
-# Sema CLI
+# @semacode/cli
 
-`@semacode/cli` e a interface publica principal da Sema.
+## English
 
-Ela valida contratos `.sema`, mede `drift` entre contrato e codigo vivo, importa legado, gera codigo derivado, produz contexto IA-first e agora governa persistencia vendor-first para `postgres`, `mysql`, `sqlite`, `mongodb` e `redis`.
+`@semacode/cli` is the public Sema command-line package published on npm.
 
-Lua e suportado como alvo de geracao e como origem semantica de codigo vivo em `use`, `impl`, IR, `drift` e `sema importar`.
-PHP tambem e suportado como origem semantica de codigo vivo em `use`, `impl`, IR, `drift` e `sema importar`, incluindo controllers, funcoes, rotas Laravel/Slim e atributos Symfony/PHP 8.
-`sema author` expoe o profile Author para obra, capitulos, cenas, personagens, continuidade, fontes, estilo, agents e flow editorial.
-O comando tambem expoe `regrasAutomaticas` com o piso geral do Author: mostrar por evidencia, causa e consequencia, cena com dupla funcao, exposicao com atrito, dialogo com subtexto, final sem slogan e anti-cliche adaptativa.
-Em pacotes de contexto e resumos de projeto, os artefatos compactos (`resumo.micro.txt`, `resumo.curto.txt`, `prompt-curto.txt`, `briefing.min.json` e `SEMA_BRIEF.*`) tambem expõem `AUTHOR_RULES_AUTO` para IA pequena nao perder essas regras.
+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.
 
-Tambem resolve documentacao obrigatoria por intencao para impedir IA de agir sem ler ou criar docs relacionadas.
+Current public version: `1.5.19`.
 
-## Instalar
-
-Global:
+### Install
 
 ```bash
 npm install -g @semacode/cli
-sema --help
+sema --version
 sema doctor
 ```
 
-Local ao projeto:
+### Core Flow
 
 ```bash
-npm install @semacode/cli
-npx sema --help
+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
 ```
 
-Tarball da release:
+### MCP Client Key
 
 ```bash
-npm install -g https://github.com/gerlanss/Sema/releases/latest/download/sema-cli-latest.tgz
+printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
 ```
 
-## Fluxos principais
+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.
 
-Projeto novo:
+Versão pública atual: `1.5.19`.
+
+### Instalar
 
 ```bash
-sema iniciar
-sema validar contratos/pedidos.sema --json
-sema compilar contratos --alvo typescript --saida ./generated/typescript
-sema verificar contratos --json
+npm install -g @semacode/cli
+sema --version
+sema doctor
 ```
 
-Projeto que ja usa Sema:
+### Fluxo Central
 
 ```bash
-sema inspecionar . --json
-sema resumo contratos/pedidos.sema --micro --para mudanca
-sema drift contratos/pedidos.sema --json
+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 contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto --json
+sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json
 ```
 
-Adocao incremental em legado:
+### Chave MCP Do Cliente
 
 ```bash
-sema importar nextjs ./app --saida ./contratos-importados --json
-sema formatar ./contratos-importados
-sema validar ./contratos-importados --json
-sema drift ./contratos-importados --json
+printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json
 ```
 
-## Persistencia vendor-first
+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.
 
-A CLI atual entende blocos `database` e recursos de persistencia no IR, no formatador, no semantico, na importacao, no drift, no impact map, na renomeacao semantica assistida e no `verificar`. O objetivo nao e esconder diferencas entre bancos, e sim capturar essas diferencas no contrato.
+### Comandos Comuns
 
-Nesta linha, o `drift` tambem passa a resolver melhor metodos JS/TS browser-side definidos via `Object.assign(...prototype...)` e a entrada padrao da CLI para de tropeçar em `exemplos/` quando o projeto real ja tem `contratos/`, `sema/` ou arquivos `.sema` na raiz.
+- `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
 
-Nesta linha, o `drift` tambem passa a enxergar `Preferences`, `localStorage` e `sessionStorage` como persistencia local real, distinguir `ancoragemVinculo` herdada do modulo e cobrir `angular-consumer` standalone mesmo quando o app nao tem `.routes`.
+`@semacode/cli` es el paquete público de línea de comando de Sema publicado en npm.
 
-Nesta linha, o `verificar/typescript` tambem deixa de depender de `tsx`: a CLI transpila os testes gerados com `typescript` e roda `node --test`, evitando `fsevents` e `node-gyp` na instalacao global do Windows.
+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.
 
-Cobertura publica:
+Versión pública actual: `1.5.19`.
 
-- `postgres`: tabela, relacao, query SQL, schema e capacidades relacionais
-- `mysql`: tabela, indice e diferencas operacionais do engine
-- `sqlite`: armazenamento local, retencao curta e modos de transacao simples
-- `mongodb`: `collection`, `document`, pipeline e indices documentais
-- `redis`: `keyspace`, `stream`, TTL e superficies de estado/cache
+### Instalar
+
+```bash
+npm install -g @semacode/cli
+sema --version
+sema doctor
+```
 
-## Pacote publico
+### Flujo Central
 
-O tarball publico da CLI inclui:
+```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
+```
 
-- `dist/`
-- docs IA-first e docs de operacao
-- pasta `exemplos/`
-- `AGENTS.md`, `llms.txt`, `SEMA_BRIEF.*` e `SEMA_INDEX.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 uteis
+### Comandos Comunes
 
 - `sema validar <arquivo-ou-pasta> --json`
 - `sema drift <arquivo-ou-pasta> --json`
 - `sema resumo <arquivo-ou-pasta> --micro --para onboarding`
-- `sema prompt-curto <arquivo-ou-pasta> --curto --para mudanca`
-- `sema author --help`
-- `sema author exemplo [--sensivel] [--json]`
 - `sema contexto-ia <arquivo.sema> --saida <diretorio> --json`
-- `sema docs-impacto --intencao <acao> [--arquivo <caminho>] [--criar-ausentes] --json`
-- `sema finalizar-mudanca --intencao <acao> [--doc-lida <caminho>] --json`
-- `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>`
-- `sema verificar <arquivo-ou-pasta> --saida <diretorio>`
+- `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
 
-- repositorio: <https://github.com/gerlanss/Sema>
-- docs: <https://github.com/gerlanss/Sema/tree/main/docs>
+- Repository: <https://github.com/gerlanss/Sema>
+- Documentation: <https://github.com/gerlanss/Sema/tree/main/docs>

package/SEMA_BRIEF.curto.txt

@@ -1,9 +1,11 @@
 PROJETO: Sema
 BASE: C:\GitHub\Sema
-MODULOS: 7
+MODULOS: 14
+MODO_CODIGO: codigo_completo
+FONTES_CONCLUSAO: contrato, codigo
 ENTRADA_IA: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
-TOP_MODULOS: app.pedidos, sema.produto.ergonomia_e_dominio, sema.produto.geradores_web, sema.produto.governanca_ia, sema.produto.linguagem_composta, sema.produto.persistencia_vendor_first (+1)
-TOP_RISCOS: aplicar_regras_gerais_author_automaticas:alto, assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio, consultar_scorecard_compatibilidade:medio, converter_bloco_composto_para_ir:alto, converter_persistencia_para_ir_canonico:alto (+27)
-TOP_LACUNAS: execucao_implicita
-TOP_ARQUIVOS: C:\GitHub\Sema\pacotes\cli\src\docs.ts, C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\importador.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\lua-symbols.ts, C:\GitHub\Sema\pacotes\cli\src\php-symbols.ts (+17)
-GERADO_EM: 2026-05-09T17:05:35.014Z
+TOP_MODULOS: app.pedidos, sema.produto.author, sema.produto.controle_comercial_supabase, sema.produto.ergonomia_e_dominio, sema.produto.game, sema.produto.geradores_web (+8)
+TOP_RISCOS: altera_persistencia, apresentar_site_publico:alto, arquivar_projeto_workspace:alto, assistir_renomeacao_semantica:alto, cadastrar_usuario_free:alto, carregar_configuracao_de_persistencia:medio (+39)
+TOP_LACUNAS: sem_impl, vinculo_quebrado
+TOP_ARQUIVOS: C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\mcp.md, C:\GitHub\Sema\docs\README.md, C:\GitHub\Sema\pacotes\cli\README.md, C:\GitHub\Sema\pacotes\cli\src\controleComercialSupabase.ts, C:\GitHub\Sema\pacotes\cli\src\docs.ts (+22)
+GERADO_EM: 2026-05-17T00:42:22.153Z

package/SEMA_BRIEF.md

@@ -1,9 +1,9 @@
 # SEMA_BRIEF
 
-Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem ter que catar o repo inteiro feito barata tonta.
+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-05-09T17:05:35.014Z`
-- Modulos: `7`
+- Gerado em: `2026-05-17T00:42:22.153Z`
+- Modulos: `14`
 
 ## Entrada canonica para IA
 
@@ -23,48 +23,97 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 ### app.pedidos
 - Faz: governa 1 rota(s), 1 task(s) com foco em criar pedido publico
 - Publico: POST /pedidos
-- Tocar: C:\GitHub\Sema\src\pedidos.controller.ts
-- Score: 95 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita
+- Tocar: C:\GitHub\Sema\testes\integracao\drift-legado.test.ts
+- Score: 50 | Confianca: media | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
+
+### sema.produto.author
+- Faz: governa 2 superficie(s), 13 task(s) com foco em author briefing
+- Publico: policy:author_quality_gate, worker:author_briefing
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
+
+### sema.produto.controle_comercial_supabase
+- Faz: governa 6 task(s) com foco em cadastrar usuario free
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\controleComercialSupabase.ts, C:\GitHub\Sema\supabase\migrations\20260516210843_create_sema_control_plane.sql, C:\GitHub\Sema\supabase\migrations\20260516223000_require_verified_email_for_sema_signup.sql, C:\GitHub\Sema\supabase\migrations\20260516234500_account_panel_and_sema_usage.sql (+2)
+- Score: 94 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
 
 ### sema.produto.ergonomia_e_dominio
-- Faz: governa 2 superficie(s), 7 task(s) com foco em scorecard atualizado
+- Faz: governa 2 superficie(s), 5 task(s) com foco em scorecard atualizado
 - Publico: evento:scorecard_atualizado, policy:compatibilidade_publica
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\importador.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\lua-symbols.ts (+4)
-- Score: 91 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\ir\conversor.ts, C:\GitHub\Sema\pacotes\nucleo\src\semantico\analisador.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
+
+### sema.produto.game
+- Faz: governa 2 task(s) com foco em validar loop game
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
+- Score: 90 | Confianca: alta | Risco: medio
+- Lacunas: sem_impl, vinculo_quebrado
 
 ### 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.ts, C:\GitHub\Sema\pacotes\gerador-html\src\index.ts, C:\GitHub\Sema\pacotes\gerador-javascript\src\index.ts
 - Score: 90 | Confianca: alta | Risco: medio
-- Lacunas: execucao_implicita
+- Lacunas: sem_impl, vinculo_quebrado
 
 ### sema.produto.governanca_ia
-- Faz: governa 2 superficie(s), 9 task(s) com foco em preparar briefing contextual
+- Faz: governa 2 superficie(s), 17 task(s) com foco em preparar briefing contextual
 - Publico: webhook:confirmar_contexto_publico, worker:preparar_briefing_contextual
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\docs.ts, C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\lua-symbols.ts (+4)
-- Score: 93 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita
+- Tocar: C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\mcp.md, C:\GitHub\Sema\docs\README.md, C:\GitHub\Sema\pacotes\cli\README.md (+4)
+- Score: 92 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
+
+### sema.produto.legal
+- Faz: governa 1 task(s) com foco em validar contexto legal
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
 
 ### sema.produto.linguagem_composta
 - Faz: governa 1 superficie(s), 5 task(s) com foco em regressao composta
 - Publico: storage:regressao_composta
 - Tocar: C:\GitHub\Sema\pacotes\gerador-python\src\index.ts, C:\GitHub\Sema\pacotes\gerador-typescript\src\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\ir\conversor.ts (+1)
 - Score: 90 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita
+- Lacunas: sem_impl, vinculo_quebrado
 
 ### sema.produto.persistencia_vendor_first
 - Faz: governa 6 task(s) com foco em validar compatibilidade vendor first
 - Publico: nenhum
 - Tocar: C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\importador.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts (+2)
 - Score: 90 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita
+- Lacunas: sem_impl, vinculo_quebrado
+
+### sema.produto.research
+- Faz: governa 2 task(s) com foco em validar plano research
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
+- Score: 90 | Confianca: alta | Risco: medio
+- Lacunas: sem_impl, vinculo_quebrado
 
-### sema.produto.profiles_author_agents_flow
-- Faz: governa 6 task(s) com foco em interpretar blocos author e agents
+### sema.produto.site_publico
+- Faz: governa 1 task(s) com foco em apresentar site publico
 - Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\ast\tipos.ts, C:\GitHub\Sema\pacotes\nucleo\src\ir\conversor.ts, C:\GitHub\Sema\pacotes\nucleo\src\ir\modelos.ts (+3)
-- Score: 91 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita
+- Tocar: C:\GitHub\Sema\site\sema\auth.js, C:\GitHub\Sema\site\sema\site.js
+- Score: 95 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
+
+### sema.produto.software
+- Faz: governa 2 task(s) com foco em validar profile software
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
+- Score: 90 | Confianca: alta | Risco: medio
+- Lacunas: sem_impl, vinculo_quebrado
+
+### sema.produto.workflow_ops
+- Faz: governa 2 task(s) com foco em validar runtime workflow
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado

package/SEMA_BRIEF.micro.txt

@@ -1,7 +1,9 @@
 PROJETO: Sema
-MODULOS: 7
+MODULOS: 14
+MODO_CODIGO: codigo_completo
+FONTES_CONCLUSAO: contrato, codigo
 ENTRADA_IA: llms.txt -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
-TOP_MODULOS: app.pedidos, sema.produto.ergonomia_e_dominio, sema.produto.geradores_web (+4)
-TOP_RISCOS: aplicar_regras_gerais_author_automaticas:alto, assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio (+30)
-TOP_LACUNAS: execucao_implicita
-GERADO_EM: 2026-05-09T17:05:35.014Z
+TOP_MODULOS: app.pedidos, sema.produto.author, sema.produto.controle_comercial_supabase (+11)
+TOP_RISCOS: altera_persistencia, apresentar_site_publico:alto, arquivar_projeto_workspace:alto (+42)
+TOP_LACUNAS: sem_impl, vinculo_quebrado
+GERADO_EM: 2026-05-17T00:42:22.153Z