@semacode/cli 1.2.0 → 1.2.9

package/dist/tipos.d.ts

@@ -1,3 +1,3 @@
 export type EstruturaSaida = "flat" | "modulos" | "backend";
-export type FonteLegado = "nestjs" | "fastapi" | "flask" | "nextjs" | "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer" | "firebase" | "typescript" | "python" | "dart" | "lua" | "dotnet" | "java" | "go" | "rust" | "cpp";
+export type FonteLegado = "nestjs" | "fastapi" | "flask" | "nextjs" | "nextjs-consumer" | "react-vite-consumer" | "angular-consumer" | "flutter-consumer" | "firebase" | "typescript" | "python" | "dart" | "dotnet" | "java" | "go" | "rust" | "cpp";
 export type ModoAdocao = "incremental";

package/docs/AGENT_STARTER.md

@@ -1,102 +1,102 @@
-# AGENT_STARTER
-
-Use este texto como starter curto para qualquer IA antes de editar `.sema`.
-
-Ordem canonica de entrada no repo:
-
-1. `llms.txt`
-2. `SEMA_BRIEF.md`
-3. `SEMA_INDEX.json`
-4. `AGENTS.md`
-5. `README.md`
-
-Roteamento por capacidade:
-
-- IA pequena ou gratuita: `llms.txt` -> `SEMA_BRIEF.micro.txt` -> `SEMA_INDEX.json`
-- IA media: `llms.txt` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json` -> `README.md`
-- IA grande ou com tool use: `llms-full.txt` -> `SEMA_BRIEF.md` -> `SEMA_INDEX.json` -> `AGENTS.md` -> `README.md`
-
-Tres modos de uso da Sema:
-
-- projeto novo: modele, valide, compile e verifique antes de subir codigo derivado
-- projeto ja semantizado: inspecione, leia resumo, rode drift e gere contexto antes de editar
-- legado sem Sema: importe, revise o rascunho, formate, valide e use drift como arbitro da adocao incremental
-
-Para manter os artefatos gerados da raiz sincronizados:
-
-- `sema sync-ai-entrypoints --json`
-
-```text
-Voce esta trabalhando com Sema, um Protocolo de Governanca de Intencao para IA sobre software vivo em backend e front consumer.
-
-Importante:
-- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana
-- a Sema funciona como camada de navegacao operacional para agente, nao como runtime magico
-- leitura humana e bonus toleravel, nao centro do produto
-- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
-- a Sema gera codigo e scaffolding real para TypeScript, Python, Dart e Lua
-- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico
-- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo
-- a Sema usa `impl` para ligar task a simbolo real do runtime
-- a Sema usa `resumo` e `prompt-curto` para IA pequena ou gratuita
-- a Sema pode servir de base para interfaces graficas elegantes e coerentes
-- a primeira onda consumer oficial agora cobre `Next.js consumer`, `React/Vite consumer`, `Angular consumer` e `flutter-consumer`
-- esses slices oficiais cobrem `consumer bridge + superficies rastreaveis`, nao geracao completa de UI
-- a proxima camada semantica de front (`screen`, `action`, `query`, `form`, `navigation`) esta documentada como roadmap, nao como sintaxe oficial ja suportada
-- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto
-- nao cobre da Sema persistencia real, runtime ou smoke test automatico; isso continua sendo engenharia viva
-- se a tarefa envolver UI, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivo aleatorio
-- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
-
-Regras:
-- nao invente sintaxe fora da gramatica e dos exemplos oficiais
-- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
-- trate `ir --json` como fonte de verdade semantica
-- trate `diagnosticos --json` como fonte de correcao
-- use `sema formatar` como fonte unica de estilo
-- preserve a intencao do contrato
-- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo
-
-Comandos essenciais:
-- resumo por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
-- prompt curto: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
-- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`
-- estrutura sintatica: `sema ast <arquivo.sema> --json`
-- estrutura semantica: `sema ir <arquivo.sema> --json`
-- validacao: `sema validar <arquivo.sema> --json`
-- diagnosticos: `sema diagnosticos <arquivo.sema> --json`
-- formatacao: `sema formatar <arquivo.sema>`
-- importacao assistida de legado: `sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|typescript|python|dart|lua|dotnet|java|go|rust|cpp> <diretorio> --saida <diretorio>`
-- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>`
-- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`
-
-Regra pratica de ouro:
-- se a tarefa pedir codigo derivado, `sema compilar` e obrigatorio
-- se a tarefa partir de projeto que nao nasceu com Sema, `sema importar` deve entrar antes da lapidacao semantica
-- se a tarefa pedir apenas leitura ou correcao sem gerar codigo, `sema compilar` pode ficar fora
-
-Antes de editar:
-1. leia README, docs de IA e um exemplo oficial parecido
-2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
-3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
-
-Depois de editar:
-1. rode `sema formatar`
-2. rode `sema validar --json`
-3. se houver falha, use `diagnosticos --json`
-4. se a tarefa pedir codigo derivado, rode `sema compilar`
-5. feche com `sema verificar <arquivo-ou-pasta> --json`
-
-Priorize sempre:
-- exemplos oficiais
-- JSON da CLI
-- consistencia semantica
-
-Nao improvise quando faltar contexto.
-```
-
-Documentos de apoio:
-
-- [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
-- [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
-- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)
+# AGENT_STARTER
+
+Use este texto como starter curto para qualquer IA antes de editar `.sema`.
+
+Ordem canonica de entrada no repo:
+
+1. `llms.txt`
+2. `SEMA_BRIEF.md`
+3. `SEMA_INDEX.json`
+4. `AGENTS.md`
+5. `README.md`
+
+Roteamento por capacidade:
+
+- IA pequena ou gratuita: `llms.txt` -> `SEMA_BRIEF.micro.txt` -> `SEMA_INDEX.json`
+- IA media: `llms.txt` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json` -> `README.md`
+- IA grande ou com tool use: `llms-full.txt` -> `SEMA_BRIEF.md` -> `SEMA_INDEX.json` -> `AGENTS.md` -> `README.md`
+
+Tres modos de uso da Sema:
+
+- projeto novo: modele, valide, compile e verifique antes de subir codigo derivado
+- projeto ja semantizado: inspecione, leia resumo, rode drift e gere contexto antes de editar
+- legado sem Sema: importe, revise o rascunho, formate, valide e use drift como arbitro da adocao incremental
+
+Para manter os artefatos gerados da raiz sincronizados:
+
+- `sema sync-ai-entrypoints --json`
+
+```text
+Voce esta trabalhando com Sema, um Protocolo de Governanca de Intencao para IA sobre software vivo em backend e front consumer.
+
+Importante:
+- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana
+- a Sema funciona como camada de navegacao operacional para agente, nao como runtime magico
+- leitura humana e bonus toleravel, nao centro do produto
+- a Sema modela contratos, estados, fluxos, erros, efeitos, garantias, vinculos e execucao
+- a Sema gera codigo e scaffolding real para TypeScript, Python e Dart
+- a Sema usa `importar` para bootstrap revisavel, nao para contrato final automatico
+- a Sema usa `drift` para medir diferenca entre contrato e codigo vivo
+- a Sema usa `impl` para ligar task a simbolo real do runtime
+- a Sema usa `resumo` e `prompt-curto` para IA pequena ou gratuita
+- a Sema pode servir de base para interfaces graficas elegantes e coerentes
+- a primeira onda consumer oficial agora cobre `Next.js consumer`, `React/Vite consumer`, `Angular consumer` e `flutter-consumer`
+- esses slices oficiais cobrem `consumer bridge + superficies rastreaveis`, nao geracao completa de UI
+- a proxima camada semantica de front (`screen`, `action`, `query`, `form`, `navigation`) esta documentada como roadmap, nao como sintaxe oficial ja suportada
+- trate a Sema como cerebro semantico da aplicacao, nao como gerador magico de front-end pronto
+- nao cobre da Sema persistencia real, runtime ou smoke test automatico; isso continua sendo engenharia viva
+- se a tarefa envolver UI, priorize `appRoutes`, `consumerSurfaces` e `consumerBridges` antes de abrir arquivo aleatorio
+- evite pedir HTML unico solto quando a intencao for testar a Sema de verdade
+
+Regras:
+- nao invente sintaxe fora da gramatica e dos exemplos oficiais
+- se a IA for pequena, comece em `sema resumo` e `briefing.min.json`
+- trate `ir --json` como fonte de verdade semantica
+- trate `diagnosticos --json` como fonte de correcao
+- use `sema formatar` como fonte unica de estilo
+- preserve a intencao do contrato
+- nao cobre da Sema adivinhacao de negocio que nao esta no contrato nem no codigo
+
+Comandos essenciais:
+- resumo por capacidade: `sema resumo <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
+- prompt curto: `sema prompt-curto <arquivo-ou-pasta> [--micro|--curto|--medio] [--para <resumo|onboarding|review|mudanca|bug|arquitetura>]`
+- contexto completo do modulo: `sema contexto-ia <arquivo.sema>`
+- estrutura sintatica: `sema ast <arquivo.sema> --json`
+- estrutura semantica: `sema ir <arquivo.sema> --json`
+- validacao: `sema validar <arquivo.sema> --json`
+- diagnosticos: `sema diagnosticos <arquivo.sema> --json`
+- formatacao: `sema formatar <arquivo.sema>`
+- importacao assistida de legado: `sema importar <nestjs|fastapi|flask|nextjs|nextjs-consumer|react-vite-consumer|angular-consumer|flutter-consumer|firebase|typescript|python|dart|dotnet|java|go|rust|cpp> <diretorio> --saida <diretorio>`
+- geracao de codigo: `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart> --saida <diretorio>`
+- verificacao final: `sema verificar <arquivo-ou-pasta> [--json]`
+
+Regra pratica de ouro:
+- se a tarefa pedir codigo derivado, `sema compilar` e obrigatorio
+- se a tarefa partir de projeto que nao nasceu com Sema, `sema importar` deve entrar antes da lapidacao semantica
+- se a tarefa pedir apenas leitura ou correcao sem gerar codigo, `sema compilar` pode ficar fora
+
+Antes de editar:
+1. leia README, docs de IA e um exemplo oficial parecido
+2. se a IA for pequena, rode `sema resumo <arquivo> --micro`
+3. se a tarefa pedir contexto mais rico, consulte `drift`, `briefing.min.json` e depois AST/IR
+
+Depois de editar:
+1. rode `sema formatar`
+2. rode `sema validar --json`
+3. se houver falha, use `diagnosticos --json`
+4. se a tarefa pedir codigo derivado, rode `sema compilar`
+5. feche com `sema verificar <arquivo-ou-pasta> --json`
+
+Priorize sempre:
+- exemplos oficiais
+- JSON da CLI
+- consistencia semantica
+
+Nao improvise quando faltar contexto.
+```
+
+Documentos de apoio:
+
+- [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
+- [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
+- [fluxo-pratico-ia-sema.md](./fluxo-pratico-ia-sema.md)

package/docs/instalacao-e-primeiro-uso.md

@@ -1,198 +1,196 @@
-# Instalacao e Primeiro Uso
-
-Este guia mostra o caminho mais curto para testar a Sema do jeito certo, sem misturar fluxo de usuario com gambiarra de contribuinte.
-
-## Requisitos
-
-- Node.js instalado
-- npm funcionando
-- Python 3 e `pytest` se voce quiser rodar o fluxo completo de testes Python gerados
-
-O repositorio so e necessario se voce quiser contribuir na Sema, rodar o showcase oficial localmente ou empacotar release.
-
-## Caminho oficial
-
-Instalacao via npm:
-
-```bash
-npm install -g @semacode/cli
-sema --help
-sema doctor
-```
-
-Se preferir o tarball oficial da GitHub Release:
-
-```bash
-npm install -g https://github.com/gerlanss/Sema/releases/latest/download/sema-cli-latest.tgz
-sema --help
-sema doctor
-```
-
-Instalacao local ao projeto:
-
-```bash
-npm install @semacode/cli
-npx sema --help
-```
-
-Instaladores auxiliares para a linha publica atual:
-
-- Linux/macOS: `curl -fsSL https://raw.githubusercontent.com/gerlanss/Sema/v1.2.0/install-sema.sh | bash`
-- Windows PowerShell: `irm https://raw.githubusercontent.com/gerlanss/Sema/v1.2.0/install-sema.ps1 | iex`
-
-Se voce quiser reproducao estrita, prefira o npm registry ou o tarball da GitHub Release.
-
-## Primeiro teste sem clonar o repo
-
-```bash
-mkdir sema-demo
-cd sema-demo
-sema iniciar
-sema validar contratos/pedidos.sema --json
-sema compilar contratos/pedidos.sema --alvo lua --saida ./saida/lua
-```
-
-## Primeiro fluxo util
-
-```bash
-sema validar contratos/pedidos.sema --json
-sema ast contratos/pedidos.sema --json
-sema ir contratos/pedidos.sema --json
-sema formatar contratos/pedidos.sema
-sema verificar contratos --saida ./.tmp/verificacao
-```
-
-## Primeiro fluxo de IA real
-
-Sem clonar o repo, o fluxo que mais mostra a proposta da Sema hoje e:
-
-```bash
-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-pedidos --json
-```
-
-Esse fluxo mostra:
-
-- base de projeto resolvida
-- cartao semantico curto para IA pequena ou gratuita
-- codigo vivo detectado
-- `impl` e `vinculos` resolvidos
-- score, confianca e lacunas do `drift`
-- `briefing.min.json` e `briefing.json` para IA antes da edicao
-
-## `sema.config.json`
-
-Exemplo de configuracao para projeto real:
-
-```json
-{
-  "origens": ["./contratos"],
-  "saida": "./generated",
-  "alvos": ["typescript", "python"],
-  "alvoPadrao": "typescript",
-  "estruturaSaida": "backend",
-  "framework": "nestjs",
-  "modoEstrito": true,
-  "diretoriosSaidaPorAlvo": {
-    "typescript": "./generated/nestjs",
-    "python": "./generated/fastapi"
-  },
-  "convencoesGeracaoPorProjeto": "backend"
-}
-```
-
-## Gerar codigo
-
-Scaffold base:
-
-```bash
-sema compilar contratos/pedidos.sema --alvo typescript --saida ./saida/typescript
-sema compilar contratos/pedidos.sema --alvo python --saida ./saida/python
-sema compilar contratos/pedidos.sema --alvo dart --saida ./saida/dart
-sema compilar contratos/pedidos.sema --alvo lua --saida ./saida/lua
-```
-
-Scaffold backend:
-
-```bash
-sema compilar contratos/pedidos.sema --alvo typescript --framework nestjs --estrutura backend --saida ./generated/nestjs
-sema compilar contratos/pedidos.sema --alvo python --framework fastapi --estrutura backend --saida ./generated/fastapi
-```
-
-## Extensao VS Code
-
-Via GitHub Release:
-
-```bash
-curl -L -o sema-language-tools.vsix https://github.com/gerlanss/Sema/releases/latest/download/sema-language-tools-latest.vsix
-code --install-extension ./sema-language-tools.vsix --force
-```
-
-Windows PowerShell:
-
-```powershell
-Invoke-WebRequest -Uri https://github.com/gerlanss/Sema/releases/latest/download/sema-language-tools-latest.vsix -OutFile sema-language-tools.vsix
-code --install-extension .\sema-language-tools.vsix --force
-```
-
-Pagina oficial:
-
-- [https://github.com/gerlanss/Sema/releases/latest](https://github.com/gerlanss/Sema/releases/latest)
-
-Se voce estiver desenvolvendo a propria extensao localmente, ai sim entra a trilha de contribuinte:
-
-```bash
-npm run extensao:empacotar
-npm run extensao:instalar-local
-```
-
-## Caminho de contribuinte
-
-Se o objetivo for desenvolver a propria Sema:
-
-```bash
-npm install
-npm run build
-npm run cli:instalar-local
-sema validar exemplos/calculadora.sema
-```
-
-Se quiser validar tudo de cara:
-
-```bash
-npm run project:check
-```
-
-## `npm link` continua existindo
-
-Esse fluxo continua util, mas e trilha de contribuinte:
-
-```powershell
-npm run cli:instalar-local
-```
-
-Serve para:
-
-- testar a experiencia de terminal no proprio ambiente
-- desenvolver a CLI
-- usar `sema` como interface principal mesmo durante o desenvolvimento local
-
-Para remover:
-
-```powershell
-npm run cli:desinstalar-local
-```
-
-## Resumo honesto
-
-Hoje o jeito certo de testar a Sema e:
-
-1. instalar a CLI pelo npm ou pela GitHub Release
-2. rodar `sema iniciar`
-3. validar `contratos/pedidos.sema`
-4. usar `inspecionar -> resumo -> drift -> contexto-ia` quando o projeto for vivo
-5. ler `briefing.min.json` ou `briefing.json` antes de mandar a IA sair cavando arquivo
-
-Clone + build + `npm link` continua bom para oficina, nao para landing page publica.
+# Instalacao e Primeiro Uso
+
+Este guia mostra o caminho mais curto para testar a Sema do jeito certo, sem misturar fluxo de usuario com gambiarra de contribuinte.
+
+## Requisitos
+
+- Node.js instalado
+- npm funcionando
+- Python 3 e `pytest` se voce quiser rodar o fluxo completo de testes Python gerados
+
+O repositorio so e necessario se voce quiser contribuir na Sema, rodar o showcase oficial localmente ou empacotar release.
+
+## Caminho oficial
+
+Instalacao via npm:
+
+```bash
+npm install -g @semacode/cli
+sema --help
+sema doctor
+```
+
+Se preferir o tarball oficial da GitHub Release:
+
+```bash
+npm install -g https://github.com/gerlanss/Sema/releases/latest/download/sema-cli-latest.tgz
+sema --help
+sema doctor
+```
+
+Instalacao local ao projeto:
+
+```bash
+npm install @semacode/cli
+npx sema --help
+```
+
+Instaladores auxiliares para a linha publica atual:
+
+- Linux/macOS: `curl -fsSL https://raw.githubusercontent.com/gerlanss/Sema/v1.0.0/install-sema.sh | bash`
+- Windows PowerShell: `irm https://raw.githubusercontent.com/gerlanss/Sema/v1.0.0/install-sema.ps1 | iex`
+
+Se voce quiser reproducao estrita, prefira o npm registry ou o tarball da GitHub Release.
+
+## Primeiro teste sem clonar o repo
+
+```bash
+mkdir sema-demo
+cd sema-demo
+sema iniciar
+sema validar contratos/pedidos.sema --json
+```
+
+## Primeiro fluxo util
+
+```bash
+sema validar contratos/pedidos.sema --json
+sema ast contratos/pedidos.sema --json
+sema ir contratos/pedidos.sema --json
+sema formatar contratos/pedidos.sema
+sema verificar contratos --saida ./.tmp/verificacao
+```
+
+## Primeiro fluxo de IA real
+
+Sem clonar o repo, o fluxo que mais mostra a proposta da Sema hoje e:
+
+```bash
+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-pedidos --json
+```
+
+Esse fluxo mostra:
+
+- base de projeto resolvida
+- cartao semantico curto para IA pequena ou gratuita
+- codigo vivo detectado
+- `impl` e `vinculos` resolvidos
+- score, confianca e lacunas do `drift`
+- `briefing.min.json` e `briefing.json` para IA antes da edicao
+
+## `sema.config.json`
+
+Exemplo de configuracao para projeto real:
+
+```json
+{
+  "origens": ["./contratos"],
+  "saida": "./generated",
+  "alvos": ["typescript", "python"],
+  "alvoPadrao": "typescript",
+  "estruturaSaida": "backend",
+  "framework": "nestjs",
+  "modoEstrito": true,
+  "diretoriosSaidaPorAlvo": {
+    "typescript": "./generated/nestjs",
+    "python": "./generated/fastapi"
+  },
+  "convencoesGeracaoPorProjeto": "backend"
+}
+```
+
+## Gerar codigo
+
+Scaffold base:
+
+```bash
+sema compilar contratos/pedidos.sema --alvo typescript --saida ./saida/typescript
+sema compilar contratos/pedidos.sema --alvo python --saida ./saida/python
+sema compilar contratos/pedidos.sema --alvo dart --saida ./saida/dart
+```
+
+Scaffold backend:
+
+```bash
+sema compilar contratos/pedidos.sema --alvo typescript --framework nestjs --estrutura backend --saida ./generated/nestjs
+sema compilar contratos/pedidos.sema --alvo python --framework fastapi --estrutura backend --saida ./generated/fastapi
+```
+
+## Extensao VS Code
+
+Via GitHub Release:
+
+```bash
+curl -L -o sema-language-tools.vsix https://github.com/gerlanss/Sema/releases/latest/download/sema-language-tools-latest.vsix
+code --install-extension ./sema-language-tools.vsix --force
+```
+
+Windows PowerShell:
+
+```powershell
+Invoke-WebRequest -Uri https://github.com/gerlanss/Sema/releases/latest/download/sema-language-tools-latest.vsix -OutFile sema-language-tools.vsix
+code --install-extension .\sema-language-tools.vsix --force
+```
+
+Pagina oficial:
+
+- [https://github.com/gerlanss/Sema/releases/latest](https://github.com/gerlanss/Sema/releases/latest)
+
+Se voce estiver desenvolvendo a propria extensao localmente, ai sim entra a trilha de contribuinte:
+
+```bash
+npm run extensao:empacotar
+npm run extensao:instalar-local
+```
+
+## Caminho de contribuinte
+
+Se o objetivo for desenvolver a propria Sema:
+
+```bash
+npm install
+npm run build
+npm run cli:instalar-local
+sema validar exemplos/calculadora.sema
+```
+
+Se quiser validar tudo de cara:
+
+```bash
+npm run project:check
+```
+
+## `npm link` continua existindo
+
+Esse fluxo continua util, mas e trilha de contribuinte:
+
+```powershell
+npm run cli:instalar-local
+```
+
+Serve para:
+
+- testar a experiencia de terminal no proprio ambiente
+- desenvolver a CLI
+- usar `sema` como interface principal mesmo durante o desenvolvimento local
+
+Para remover:
+
+```powershell
+npm run cli:desinstalar-local
+```
+
+## Resumo honesto
+
+Hoje o jeito certo de testar a Sema e:
+
+1. instalar a CLI pelo npm ou pela GitHub Release
+2. rodar `sema iniciar`
+3. validar `contratos/pedidos.sema`
+4. usar `inspecionar -> resumo -> drift -> contexto-ia` quando o projeto for vivo
+5. ler `briefing.min.json` ou `briefing.json` antes de mandar a IA sair cavando arquivo
+
+Clone + build + `npm link` continua bom para oficina, nao para landing page publica.

package/node_modules/@sema/gerador-dart/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema/gerador-dart",
-  "version": "1.2.0",
+  "version": "1.2.9",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts"