@semacode/cli 1.3.7 → 1.4.0

package/README.md

@@ -1,73 +1,93 @@
 # Sema CLI
 
-Sema e um Protocolo de Governanca de Intencao para IA e backend vivo.
+`@semacode/cli` e a interface publica principal da Sema.
 
-Ela nao foi desenhada para ergonomia humana como prioridade. O alvo principal e IA operando contrato, drift e contexto de sistema vivo com menos chute.
+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`.
 
-Este pacote entrega a CLI oficial para:
+## Instalar
 
-- validar contratos `.sema`
-- inspecionar projeto
-- medir `drift` entre contrato e codigo vivo
-- importar legado
-- gerar resumo compacto por capacidade de IA
-- preparar contexto para IA
-
-Quando a CLI roda em projeto, a trilha IA-first recomendada fica assim:
-
-- raiz do repo: `llms.txt`, `SEMA_BRIEF.*`, `SEMA_INDEX.json`, `AGENTS.md`, `README.md`
-- modulo alvo: `resumo.micro.txt`, `briefing.min.json`, `prompt-curto.txt`, `drift.json`, `briefing.json`
-
-Isto nao existe para agradar humano. Existe para a IA achar o contexto certo sem entupir a janela com lixo.
-
-Para regenerar os entrypoints IA-first da raiz:
-
-```bash
-sema sync-ai-entrypoints --json
-```
-
-## Instalacao pelo npm registry
+Global:
 
 ```bash
 npm install -g @semacode/cli
 sema --help
+sema doctor
 ```
 
-## Instalacao via tarball da release
+Local ao projeto:
 
 ```bash
-npm install -g ./sema-cli-1.3.7.tgz
+npm install @semacode/cli
+npx sema --help
 ```
 
-Ou direto da GitHub Release:
+Tarball da release:
 
 ```bash
 npm install -g https://github.com/gerlanss/Sema/releases/latest/download/sema-cli-latest.tgz
 ```
 
-## Instalacao local ao projeto
+## Fluxos principais
+
+Projeto novo:
 
 ```bash
-npm install @semacode/cli
-npx sema --help
+sema iniciar
+sema validar contratos/pedidos.sema --json
+sema compilar contratos --alvo typescript --saida ./generated/typescript
+sema verificar contratos --json
 ```
 
-Ou, se voce estiver testando um tarball local:
+Projeto que ja usa Sema:
 
 ```bash
-npm install ./sema-cli-1.3.7.tgz
-npx sema --help
+sema inspecionar . --json
+sema resumo contratos/pedidos.sema --micro --para mudanca
+sema drift contratos/pedidos.sema --json
+sema contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto --json
 ```
 
-## Primeiro teste
+Adocao incremental em legado:
 
 ```bash
-mkdir sema-demo
-cd sema-demo
-sema iniciar
-sema validar contratos/pedidos.sema --json
-sema starter-ia
-sema resumo contratos/pedidos.sema --micro --para onboarding
+sema importar nextjs ./app --saida ./contratos-importados --json
+sema formatar ./contratos-importados
+sema validar ./contratos-importados --json
+sema drift ./contratos-importados --json
 ```
 
-Repositorio: https://github.com/gerlanss/Sema
+## Persistencia vendor-first
+
+A CLI 1.4.0 entende blocos `database` e recursos de persistencia no IR, no formatador, no semantico, na importacao e no drift. O objetivo nao e esconder diferencas entre bancos, e sim capturar essas diferencas no contrato.
+
+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 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/dist/drift.d.ts

@@ -1,4 +1,4 @@
-import type { NivelConfiancaSemantica, NivelRiscoSemantico } from "@sema/nucleo";
+import type { EngineBanco, NivelConfiancaSemantica, NivelRiscoSemantico, TipoRecursoPersistencia } from "@sema/nucleo";
 import type { ContextoProjetoCarregado } from "./projeto.js";
 type ConsumerFramework = "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer";
 interface RegistroConsumerSurfaceDrift {
@@ -36,14 +36,16 @@ interface RegistroRotaDivergente {
     caminho?: string;
     motivo: string;
 }
+type OrigemRecursoDrift = "firebase" | EngineBanco;
+type TipoRecursoDrift = "colecao" | TipoRecursoPersistencia;
 interface RegistroRecursoDrift {
     modulo: string;
     task: string;
     categoria: "persistencia";
     alvo: string;
     arquivo: string;
-    origem: "firebase";
-    tipo: "colecao";
+    origem: OrigemRecursoDrift;
+    tipo: TipoRecursoDrift;
     status: "resolvido" | "divergente";
 }
 interface SimboloCandidatoDrift {