@semacode/cli 1.5.17 → 1.5.18

package/README.md

@@ -1,112 +1,104 @@
-# 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`.
-
-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.
-
-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 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.
-
-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 `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.
-
-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 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>`
-
-## Links
-
-- repositorio: <https://github.com/gerlanss/Sema>
-- docs: <https://github.com/gerlanss/Sema/tree/main/docs>
+# 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>

package/SEMA_BRIEF.curto.txt

@@ -1,9 +1,9 @@
 PROJETO: Sema
 BASE: C:\GitHub\Sema
-MODULOS: 7
+MODULOS: 6
 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.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_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

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-15T21:54:48.396Z`
+- Modulos: `6`
 
 ## Entrada canonica para IA
 
@@ -23,48 +23,41 @@ 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.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.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), 13 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\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
+- 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
-
-### sema.produto.profiles_author_agents_flow
-- Faz: governa 6 task(s) com foco em interpretar blocos author e agents
-- 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
+- Lacunas: sem_impl, vinculo_quebrado

package/SEMA_BRIEF.micro.txt

@@ -1,7 +1,7 @@
 PROJETO: Sema
-MODULOS: 7
+MODULOS: 6
 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.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_LACUNAS: sem_impl, vinculo_quebrado
+GERADO_EM: 2026-05-15T21:54:48.396Z