@semacode/cli 1.5.18 → 1.5.25

package/README.md

@@ -1,104 +1,144 @@
-# Sema CLI
-
-`@semacode/cli` e a interface publica principal da Sema.
-
-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`.
-
-Tambem resolve documentacao obrigatoria por intencao para impedir IA de agir sem ler ou criar docs relacionadas.
-
-## Instalar
-
-Global:
-
-```bash
-npm install -g @semacode/cli
-sema --help
-sema doctor
-```
-
-Local ao projeto:
-
-```bash
-npm install @semacode/cli
-npx sema --help
-```
-
-Tarball da release:
-
-```bash
-npm install -g https://github.com/gerlanss/Sema/releases/latest/download/sema-cli-latest.tgz
-```
-
-## Fluxos principais
-
-Projeto novo:
-
-```bash
-sema iniciar
-sema validar contratos/pedidos.sema --json
-sema compilar contratos --alvo typescript --saida ./generated/typescript
-sema verificar contratos --json
-```
-
-Projeto que ja usa Sema:
-
-```bash
-sema inspecionar . --json
-sema resumo contratos/pedidos.sema --micro --para mudanca
-sema drift contratos/pedidos.sema --json
-sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
-sema contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto --json
-```
-
-Adocao incremental em legado:
-
-```bash
-sema importar nextjs ./app --saida ./contratos-importados --json
-sema formatar ./contratos-importados
-sema validar ./contratos-importados --json
-sema drift ./contratos-importados --json
-```
-
-## Persistencia vendor-first
-
-A CLI 1.5.18 entende blocos `database` e recursos de persistencia na 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.
-
-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.
-
-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`.
-
-Nesta linha, o pacote publico da CLI tambem deixa `tsx` fora das dependencias de runtime para evitar ruído de instalacao global no Windows.
-
-Cobertura publica:
-
-- `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
-
-## Pacote publico
-
-O tarball publico da CLI inclui:
-
-- `dist/`
-- docs IA-first e docs de operacao
-- pasta `exemplos/`
-- `AGENTS.md`, `llms.txt`, `SEMA_BRIEF.*` e `SEMA_INDEX.json`
-
-## Comandos uteis
-
-- `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 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>`
-
-## Links
-
-- repositorio: <https://github.com/gerlanss/Sema>
-- docs: <https://github.com/gerlanss/Sema/tree/main/docs>
+# @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.25`.
+
+### 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.25`.
+
+### 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.25`.
+
+### 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>

package/SEMA_BRIEF.curto.txt

@@ -1,9 +1,11 @@
 PROJETO: Sema
 BASE: C:\GitHub\Sema
-MODULOS: 6
+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
-TOP_RISCOS: 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, criar_pedido:alto (+22)
+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, atualizar_perfil_conta:alto, atualizar_projeto_workspace:alto (+40)
 TOP_LACUNAS: sem_impl, vinculo_quebrado
-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\projeto.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js (+11)
-GERADO_EM: 2026-05-15T21:54:48.396Z
+TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\env.md, C:\GitHub\Sema\docs\mcp.md (+31)
+GERADO_EM: 2026-05-18T20:59:43.825Z

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-05-15T21:54:48.396Z`
-- Modulos: `6`
+- Gerado em: `2026-05-18T20:59:43.825Z`
+- Modulos: `14`
 
 ## Entrada canonica para IA
 
@@ -27,6 +27,20 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Score: 50 | Confianca: media | Risco: alto
 - Lacunas: sem_impl, vinculo_quebrado
 
+### sema.produto.author
+- Faz: governa 2 superficie(s), 14 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 12 task(s) com foco em cadastrar usuario free
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\controleComercialSupabase.ts, C:\GitHub\Sema\site\sema\auth.js, C:\GitHub\Sema\site\sema\painel.html, C:\GitHub\Sema\site\sema\site.js (+4)
+- Score: 95 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado
+
 ### sema.produto.ergonomia_e_dominio
 - Faz: governa 2 superficie(s), 5 task(s) com foco em scorecard atualizado
 - Publico: evento:scorecard_atualizado, policy:compatibilidade_publica
@@ -34,6 +48,13 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - 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
@@ -42,10 +63,17 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Lacunas: sem_impl, vinculo_quebrado
 
 ### sema.produto.governanca_ia
-- Faz: governa 2 superficie(s), 13 task(s) com foco em preparar briefing contextual
+- Faz: governa 2 superficie(s), 19 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\projeto.ts (+4)
-- Score: 92 | Confianca: alta | Risco: alto
+- Tocar: C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\env.md, C:\GitHub\Sema\docs\mcp.md (+4)
+- Score: 93 | 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
@@ -61,3 +89,31 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - 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: 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.site_publico
+- Faz: governa 1 task(s) com foco em apresentar site publico
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\site\sema\auth.js, C:\GitHub\Sema\site\sema\cadastro.html, C:\GitHub\Sema\site\sema\entrar.html, C:\GitHub\Sema\site\sema\mcp-installer.js (+3)
+- 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 3 task(s) com foco em validar runtime workflow
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\site\sema\auth.js (+3)
+- Score: 92 | Confianca: alta | Risco: alto
+- Lacunas: sem_impl, vinculo_quebrado

package/SEMA_BRIEF.micro.txt

@@ -1,7 +1,9 @@
 PROJETO: Sema
-MODULOS: 6
+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 (+3)
-TOP_RISCOS: assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio, consultar_scorecard_compatibilidade:medio (+25)
+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 (+43)
 TOP_LACUNAS: sem_impl, vinculo_quebrado
-GERADO_EM: 2026-05-15T21:54:48.396Z
+GERADO_EM: 2026-05-18T20:59:43.825Z