@semacode/cli 1.5.29 → 1.5.31

package/docs/AGENT_STARTER.md

@@ -1,109 +0,0 @@
-# AGENT_STARTER
-
-<!-- sema:i18n -->
-> EN: English first. The canonical operational body below may still be in Portuguese until full translation lands.
-> PT: Português depois, com acentos preservados.
-> ES: Español al final; não traduza comandos, rotas nem sómbolos `.sema` sem contrato.
-
-
-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 média: `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 código derivado
-- projeto já 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 adoção incremental
-
-Para manter os artefatos gerados da raiz sincronizados:
-
-- `sema sync-ai-entrypoints --json`
-
-```text
-Voce esta trabalhando com Sema, um contrato semantico IA-first para agentes operarem software vivo em backend e front consumer.
-
-Importante:
-- a Sema e protocolo de governanca semantica desenhado para IA, nao para ergonomia humana
-- humanos sao autores/aprovadores; agentes sao os consumidores primarios do contrato
-- 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/api.md

@@ -1,82 +0,0 @@
-# API and Operational Surfaces
-
-## English
-
-Sema's public repository exposes the open language, CLI, contracts, examples, and editor support. It does not expose the private hosted MCP control plane, account APIs, OAuth internals, dashboards, audit storage, or commercial runtime governance APIs.
-
-### Public Surfaces
-
-- CLI commands documented in `README.md`, `docs/README.md`, and `docs/profiles.md`.
-- `.sema` contracts under `contratos/` and public examples under `exemplos/`.
-- Release artifacts generated by the public release scripts.
-- Editor support and local validation flows.
-
-### Private Or Commercial Surfaces
-
-- Hosted MCP endpoint and OAuth authorization flows.
-- Account, project, usage, billing, dashboard, and audit APIs.
-- Runtime governance, approval gates, private rule packs, and advanced artifact validation.
-- Deployment secrets, environment files, local runbooks, and infrastructure-specific scripts.
-
-### API Rule For Agents
-
-When a change touches an endpoint, webhook, CLI command, or MCP tool, the agent must:
-
-- declare or update the applicable `.sema` contract before code;
-- validate authentication, authorization, tenant/workspace boundaries, idempotency, auditability, and rollback expectations;
-- keep private endpoints and commercial control-plane details out of the public repository;
-- run Sema validation and public repository boundary checks before release.
-
-## Português
-
-O repositório público do Sema expõe a linguagem aberta, CLI, contratos, exemplos e suporte de editor. Ele não expõe o control plane MCP hospedado, APIs de conta, detalhes internos de OAuth, dashboards, armazenamento de auditoria ou APIs comerciais de runtime governance.
-
-### Superfícies Públicas
-
-- Comandos da CLI documentados em `README.md`, `docs/README.md` e `docs/profiles.md`.
-- Contratos `.sema` em `contratos/` e exemplos públicos em `exemplos/`.
-- Artefatos de release gerados pelos scripts públicos de release.
-- Suporte de editor e fluxos locais de validação.
-
-### Superfícies Privadas Ou Comerciais
-
-- Endpoint MCP hospedado e fluxos de autorização OAuth.
-- APIs de conta, projeto, uso, cobrança, dashboard e auditoria.
-- Runtime governance, approval gates, rule packs privados e validação avançada de artefatos.
-- Segredos de deploy, arquivos de ambiente, runbooks locais e scripts específicos de infraestrutura.
-
-### Regra De API Para Agentes
-
-Quando uma mudança toca endpoint, webhook, comando de CLI ou ferramenta MCP, a IA deve:
-
-- declarar ou atualizar o contrato `.sema` aplicável antes do código;
-- validar autenticação, autorização, fronteira de tenant/workspace, idempotência, auditoria e expectativa de rollback;
-- manter endpoints privados e detalhes comerciais do control plane fora do repositório público;
-- rodar validação Sema e checagem de fronteira pública antes do release.
-
-## Español
-
-El repositorio público de Sema expone el lenguaje abierto, CLI, contratos, ejemplos y soporte de editor. No expone el control plane MCP hospedado, APIs de cuenta, detalles internos de OAuth, dashboards, almacenamiento de auditoría ni APIs comerciales de runtime governance.
-
-### Superficies Públicas
-
-- Comandos de la CLI documentados en `README.md`, `docs/README.md` y `docs/profiles.md`.
-- Contratos `.sema` en `contratos/` y ejemplos públicos en `exemplos/`.
-- Artefactos de release generados por los scripts públicos de release.
-- Soporte de editor y flujos locales de validación.
-
-### Superficies Privadas O Comerciales
-
-- Endpoint MCP hospedado y flujos de autorización OAuth.
-- APIs de cuenta, proyecto, uso, facturación, dashboard y auditoría.
-- Runtime governance, approval gates, rule packs privados y validación avanzada de artefactos.
-- Secretos de deploy, archivos de entorno, runbooks locales y scripts específicos de infraestructura.
-
-### Regla De API Para Agentes
-
-Cuando un cambio toca un endpoint, webhook, comando de CLI o herramienta MCP, la IA debe:
-
-- declarar o actualizar el contrato `.sema` aplicable antes del código;
-- validar autenticación, autorización, frontera de tenant/workspace, idempotencia, auditoría y expectativa de rollback;
-- mantener endpoints privados y detalles comerciales del control plane fuera del repositorio público;
-- ejecutar validación Sema y chequeo de frontera pública antes del release.

package/docs/cli.md

@@ -1,175 +0,0 @@
-# Sema CLI
-
-## English
-
-The Sema CLI is the public npm package for local semantic governance. It validates `.sema` contracts, checks drift, maps impact, prepares AI-first context, resolves documentation gates, and runs profile validators before an agent continues.
-
-Current public version: `1.5.29`.
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema validar contratos/pedidos.sema --json
-```
-
-## Português
-
-A CLI da Sema é o pacote público no npm para governança semântica local. Ela valida contratos `.sema`, verifica drift, mapeia impacto, prepara contexto IA-first, resolve gates de documentação e roda validadores de profiles antes de um agente continuar.
-
-Versão pública atual: `1.5.29`.
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema validar contratos/pedidos.sema --json
-```
-
-## Español
-
-La CLI de Sema es el paquete público en npm para gobernanza semántica local. Valida contratos `.sema`, verifica drift, mapea impacto, prepara contexto IA-first, resuelve gates de documentación y ejecuta validadores de profiles antes de que un agente continúe.
-
-Versión pública actual: `1.5.29`.
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema validar contratos/pedidos.sema --json
-```
-
-## Referência Operacional
-
-### Papel da CLI
-
-A CLI é a interface oficial da Sema para:
-
-- validar contratos `.sema`
-- exportar AST e IR
-- medir `drift` entre contrato e código vivo
-- importar legado para rascunho revisável
-- gerar código derivado
-- preparar contexto IA-first
-- resolver docs obrigatórias por intenção antes de editar ou operar
-- verificar múltiplos alvos de geração
-
-### Três Modos De Operação
-
-Projeto novo:
-
-- `sema iniciar`
-- `sema validar`
-- `sema compilar`
-- `sema verificar`
-
-Projeto já semantizado:
-
-- `sema inspecionar`
-- `sema resumo`
-- `sema drift`
-- `sema contexto-ia`
-
-Adoção incremental:
-
-- `sema importar`
-- `sema formatar`
-- `sema validar`
-- `sema drift`
-
-## Persistência vendor-first
-
-A linha 1.5.29 mantém persistência vendor-first como seção canônica no contrato, no semântico, na IR e no formatador, além de `drift` com escopo real, `impacto`, renomeação semântica assistida, `verificar` mais coerente nos alvos gerados, match de métodos JS/TS definidos via `Object.assign(...prototype...)`, leitura de `Preferences`/`localStorage`/`sessionStorage`, fallback para `angular-consumer` standalone sem `.routes`, limpeza de runtime da CLI pública no Windows, Sema Author oficial e MCP remoto desmembrado da distribuição pública.
-
-Cobertura pública:
-
-- `postgres`: `table`, `relationship`, `query`, `schema`, capacidades relacionais
-- `mysql`: `table`, `index`, consultas SQL e diferenças operacionais do engine
-- `sqlite`: `table`, `retention`, uso local e edge
-- `mongodb`: `collection`, `document`, `query` em `pipeline`
-- `redis`: `keyspace`, `stream`, `retention`, TTL e superfícies de estado
-
-## Drift e código vivo
-
-`sema drift` agora cruza contrato com recursos reais encontrados em:
-
-- código de backend
-- DDL `.sql`
-- schema `.prisma`
-- uso de MongoDB
-- uso de Redis, incluindo keyspaces e streams
-
-O objetivo não é adivinhar tudo; é produzir um score explicável com lacunas claras.
-
-## Ajuda IA-first
-
-- `sema ajuda-ia`
-- `sema starter-ia`
-- `sema resumo <arquivo-ou-pasta> --micro|--curto|--medio`
-- `sema prompt-curto <arquivo-ou-pasta> --micro|--curto|--medio`
-- `sema contexto-ia <arquivo.sema> --saida <diretorio>`
-- `sema sync-ai-entrypoints --json`
-- `sema docs-impacto --intencao <acao> --criar-ausentes --json`
-- `sema finalizar-mudanca --intencao <acao> --doc-lida <caminho> --json`
-
-## Profiles Semânticos
-
-Profiles oficiais usam contrato Sema normal e um gate de requisitos obrigatórios. O requisito comum é contrato primeiro: criar, editar ou remover contrato antes de qualquer ação. Se o contrato não declara o mínimo do domínio, o comando falha.
-
-```bash
-sema profile validar software contratos/sema/software.sema --json
-sema profile validar workflow contratos/sema/workflow_ops.sema --json
-sema profile validar ops contratos/sema/workflow_ops.sema --json
-sema profile validar game contratos/sema/game.sema --json
-sema profile validar legal contratos/sema/legal.sema --json
-sema profile validar research contratos/sema/research.sema --json
-```
-
-## Sema Author
-
-Author é um profile oficial para governança autoral IA-first. Ele usa a mesma DSL, sem palavra-chave nova, e organiza contratos em core, agents e flow. Se obra, tom, limite, público ou política muda, edite o contrato antes de gerar ou revisar texto.
-
-```bash
-sema author iniciar --saida contratos/author.sema
-sema author iniciar --tema-sensivel --saida contratos/author.sema
-sema author validar contratos/author.sema --json
-sema author briefing contratos/author.sema --json
-sema author revisar-cliches contratos/author.sema --texto "O escolhido predestinado aceitou a missão." --json
-sema author validar-narrativa contratos/author.sema --texto "Mara perdeu a chave para salvar Raul. Por isso, o capitulo seguinte muda a promessa dela." --texto-anterior "Mara prometeu proteger a chave." --json
-```
-
-O comando `author iniciar` usa os exemplos oficiais `author_obra_comum.sema` ou `author_tema_sensivel.sema` como starter. Ele não sobrescreve contrato existente.
-
-## Importadores Públicos
-
-- `nestjs`
-- `fastapi`
-- `flask`
-- `nextjs`
-- `nextjs-consumer`
-- `react-vite-consumer`
-- `angular-consumer`
-- `flutter-consumer`
-- `firebase`
-- `dotnet`
-- `java`
-- `go`
-- `rust`
-- `cpp`
-- `typescript`
-- `python`
-- `dart`
-
-## Comandos mais usados
-
-```bash
-sema validar <arquivo-ou-pasta> --json
-sema diagnosticos <arquivo.sema> --json
-sema ir <arquivo.sema> --json
-sema drift <arquivo-ou-pasta> --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 importar <fonte> <diretorio> --saida <diretorio> --json
-sema docs-impacto --intencao "fazer deploy" --criar-ausentes --json
-sema finalizar-mudanca --intencao "fazer deploy" --doc-lida docs/deploy.md --json
-sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua> --saida <diretorio>
-sema verificar <arquivo-ou-pasta> --saida <diretorio>
-```

package/docs/como-ensinar-a-sema-para-ia.md

@@ -1,155 +0,0 @@
-# Como Ensinar a Sema para IA
-
-<!-- sema:i18n -->
-> EN: English first. The canonical operational body below may still be in Portuguese until full translation lands.
-> PT: Português depois, com acentos preservados.
-> ES: Español al final; não traduza comandos, rotas nem sómbolos `.sema` sem contrato.
-
-
-Este documento explica como fazer uma IA entender a Sema sem depender de memória prévia do modelo. A estratégia correta não é presumir que a IA "já conhece a linguagem", e sim entregar contexto suficiente para ela operar com segurança.
-
-Leia isso do ponto de vista da CLI pública. A IA não deve assumir que está dentro do monorepo da Sema, nem que precisa chamar `node pacotes/cli/dist/index.js`.
-
-## Principio central
-
-Uma IA entende uma linguagem nova quando recebe quatro camadas de contexto:
-
-1. sintaxe
-2. semântica
-3. estrutura intermediaria estavel
-4. exemplos reais
-
-Sem essas quatro camadas, o modelo comeca a adivinhar. É adivinhação em linguagem de contrato e pedir para nascer bug feio.
-
-Antes de qualquer outra coisa, a IA também precisa receber a **moldura correta**:
-
-- a Sema é um contrato semântico IA-first para agentes operarem software vivo
-- a Sema foi feita para IA, não para ergonomia humana
-- a Sema não foi feita para "automatizar tudo"
-- a Sema existe para explicitar, alinhar e verificar contrato contra sistema vivo
-- humanos sao autores, revisores e aprovadores; agentes sao consumidores primarios
-
-Se a IA errar essa moldura, ela vai cobrar da ferramenta a coisa errada e operar por adivinhação.
-
-## Camada 1. Sintaxe
-
-A IA precisa saber como a linguagem e escrita.
-
-Fontes principais:
-
-- [README.md](../README.md)
-- [sintaxe.md](./sintaxe.md)
-- [integração-com-ia.md](./integracao-com-ia.md)
-
-Objetivo dessa camada:
-
-- reconhecer blocos validos
-- entender delimitadores
-- não inventar palavras-chave
-- respeitar a organizacao canonicamente formatada
-
-## Camada 2. Semântica
-
-Depois de saber ler, a IA precisa saber o que cada bloco significa.
-
-Fontes principais:
-
-- [README.md](../README.md)
-- [integração-com-ia.md](./integracao-com-ia.md)
-- [pagamento-ponta-a-ponta.md](./pagamento-ponta-a-ponta.md)
-
-Objetivo dessa camada:
-
-- distinguir contrato interno de `task`
-- distinguir contrato público de `route`
-- entender `effects`, `guarantees`, `error`, `state` e `flow`
-- operar na linguagem como especificacao executavel, não como texto decorativo
-- entender que `importar` e bootstrap
-- entender que `drift` e regua de coerência contra o runtime
-- entender que `impl` e ponte rastreavel para simbolo vivo
-
-## Camada 3. Estrutura intermediaria estavel
-
-Essa e a camada que faz a parada parar de ser um cassino.
-
-Em vez de confiar que a IA vai interpretar `.sema` cru de primeira, use a CLI como tradutora oficial da linguagem.
-
-Comandos principais:
-
-```bash
-sema resumo arquivo.sema --micro --para onboarding
-sema validar arquivo.sema --json
-sema diagnosticos arquivo.sema --json
-sema ast arquivo.sema --json
-sema ir arquivo.sema --json
-sema verificar arquivo-ou-pasta --json --saida ./.tmp/verificacao-ia
-```
-
-Como cada comando ajuda:
-
-- `resumo`: entrega cartao semântico pequeno para IA com janela curta
-- `validar --json`: diz se a base está semanticamente valida
-- `diagnosticos --json`: devolve erros e avisos como contrato estruturado
-- `ast --json`: mostra a forma sintatica escrita
-- `ir --json`: mostra a forma semântica resolvida
-- `verificar --json`: mostra o estado operacional do projeto
-
-Se a IA puder consumir `ir --json`, melhor ainda. É ali que a linguagem fica menos ambigua e mais utilizavel para automacao. Para modelo pequeno, comece em `resumo` e `briefing.min.json`.
-
-## Camada 4. Exemplos reais
-
-Modelo aprende muito por padrão. Por isso, bons exemplos valem quase tanto quanto especificacao.
-
-Arquivos recomendados:
-
-- [pagamento.sema](../exemplos/pagamento.sema)
-- [pagamento_dominio.sema](../exemplos/pagamento_dominio.sema)
-- [automacao.sema](../exemplos/automacao.sema)
-- [tratamento_erro.sema](../exemplos/tratamento_erro.sema)
-- [crud_simples.sema](../exemplos/crud_simples.sema)
-
-O vertical oficial de pagamento deve ser tratado como a referência principal.
-
-## O que a IA não deve fazer
-
-- inventar palavras-chave fora da gramática
-- introduzir blocos inexistentes
-- assumir semântica que não aparece na especificacao
-- tratar draft importado como contrato final só porque veio da CLI
-- tratar a Sema como gerador mágico de sistema completo
-- editar `.sema` sem rodar `sema formatar`
-- encerrar alteracao sem consultar `diagnosticos` quando houver falha
-
-## O que a IA deve fazer
-
-- usar a gramática e os exemplos como fonte de estilo
-- usar a IR como fonte de verdade semântica sempre que possóvel
-- usar diagnósticos estruturados como guia de correcao
-- rodar o formatador antes de considerar o trabalho pronto
-- validar e verificar a mudanca no mesmo fluxo
-
-## Estratégia recomendada
-
-Se voce for instruir uma IA para trabalhar com Sema, entregue o contexto nesta ordem:
-
-1. [README.md](../README.md)
-2. [como-ensinar-a-sema-para-ia.md](./como-ensinar-a-sema-para-ia.md)
-3. [pagamento-ponta-a-ponta.md](./pagamento-ponta-a-ponta.md)
-4. [prompt-base-ia-sema.md](./prompt-base-ia-sema.md)
-5. `sema resumo --micro` ou `sema resumo --curto`, conforme a capacidade da IA
-6. `ast --json`, `ir --json` e `diagnosticos --json` do módulo alvo, se a capacidade aguentar
-
-Essa ordem faz a IA ir de contexto geral para contexto operacional, em vez de cair direto num arquivo cru e sair chutando.
-
-## Regra de ouro
-
-A Sema foi desenhada para ser entendida por IA, mas isso não significa que a IA vai adivinhar sozinha.
-
-Ela entende bem quando recebe:
-
-- especificacao
-- exemplos
-- JSON estrutural
-- feedback automático
-
-Sem isso, até o modelo mais caro vira estagiário emocionado.

package/docs/deploy.md

@@ -1,93 +0,0 @@
-# Public Release Runbook
-
-<!-- sema:i18n -->
-> EN: English first.
-> PT: Português depois.
-> ES: Español al final.
-
-## English
-
-This public runbook covers only the open Sema distribution: source repository, npm CLI package, VS Code extension artifact, release notes, checksums, and public install scripts.
-
-Private hosting, account panels, OAuth endpoints, Supabase projects, billing flows, service accounts, customer data, server paths, and commercial deployment scripts belong in the private repository.
-
-### What Goes Public
-
-- Versioned source for the open language, parser, CLI, base profiles, examples, public docs, and basic extension.
-- Public release assets generated under `.tmp/release-assets`.
-- Generic install scripts that do not embed tokens, private URLs, customer identifiers, or server paths.
-- Release notes in this order: English, Portuguese, Spanish.
-
-### What Stays Private
-
-- Hosted-site code, account panel code, billing, Supabase migrations, OAuth client secrets, MCP key issuing, production Caddy/Nginx files, and server-specific runbooks.
-- Any token, service role, customer identifier, database URL, private endpoint, or local agent configuration.
-- Commercial rule packs and internal dashboards until explicitly approved for public release.
-
-### Public Release Checklist
-
-1. Run `npm run repo:verificar-publico`.
-2. Run `npm run project:check`.
-3. Run `npm run release:preparar-publica`.
-4. Publish the npm package only after `npm dist-tag ls @semacode/cli` can be checked.
-5. Push `main` and the matching `v<version>` tag.
-6. Create the GitHub Release from `.tmp/release-assets` and mark it as latest.
-7. Confirm the GitHub About description is English and product-facing.
-
-## Português
-
-Este runbook público cobre apenas a distribuição aberta da Sema: repositório-fonte, pacote npm da CLI, artefato da extensão VS Code, notas de release, checksums e instaladores públicos.
-
-Hospedagem privada, painéis de conta, endpoints OAuth, projetos Supabase, billing, service accounts, dados de clientes, caminhos de servidor e scripts comerciais de deploy ficam no repositório privado.
-
-### O Que Vai Para o Público
-
-- Código versionado da linguagem aberta, parser, CLI, profiles base, exemplos, docs públicas e extensão básica.
-- Assets públicos de release gerados em `.tmp/release-assets`.
-- Instaladores genéricos sem tokens, URLs privadas, identificadores de cliente ou caminhos de servidor.
-- Notas de release nesta ordem: inglês, português, espanhol.
-
-### O Que Fica Privado
-
-- Código do site hospedado, painel de contas, billing, migrations Supabase, OAuth client secrets, emissão de chaves MCP, Caddy/Nginx de produção e runbooks específicos de servidor.
-- Qualquer token, service role, identificador de cliente, URL de banco, endpoint privado ou configuração local de agentes.
-- Rule packs comerciais e dashboards internos até aprovação explícita para release pública.
-
-### Checklist De Release Pública
-
-1. Rode `npm run repo:verificar-publico`.
-2. Rode `npm run project:check`.
-3. Rode `npm run release:preparar-publica`.
-4. Publique o pacote npm somente depois de conseguir conferir `npm dist-tag ls @semacode/cli`.
-5. Envie `main` e a tag `v<versão>` correspondente.
-6. Crie o GitHub Release a partir de `.tmp/release-assets` e marque como latest.
-7. Confirme que o About do GitHub está em inglês e com posicionamento de produto.
-
-## Español
-
-Este runbook público cubre solo la distribución abierta de Sema: repositorio fuente, paquete npm de la CLI, artefacto de la extensión VS Code, notas de release, checksums e instaladores públicos.
-
-El hosting privado, los paneles de cuenta, endpoints OAuth, proyectos Supabase, billing, service accounts, datos de clientes, rutas de servidor y scripts comerciales de despliegue pertenecen al repositorio privado.
-
-### Qué Va Al Público
-
-- Código versionado del lenguaje abierto, parser, CLI, profiles base, ejemplos, docs públicas y extensión básica.
-- Assets públicos de release generados en `.tmp/release-assets`.
-- Instaladores genéricos sin tokens, URLs privadas, identificadores de cliente ni rutas de servidor.
-- Notas de release en este orden: inglés, portugués, español.
-
-### Qué Queda Privado
-
-- Código del sitio hospedado, panel de cuentas, billing, migrations Supabase, OAuth client secrets, emisión de claves MCP, Caddy/Nginx de producción y runbooks específicos de servidor.
-- Cualquier token, service role, identificador de cliente, URL de base de datos, endpoint privado o configuración local de agentes.
-- Rule packs comerciales y dashboards internos hasta aprobación explícita para release pública.
-
-### Checklist De Release Pública
-
-1. Ejecuta `npm run repo:verificar-publico`.
-2. Ejecuta `npm run project:check`.
-3. Ejecuta `npm run release:preparar-publica`.
-4. Publica el paquete npm solo después de poder verificar `npm dist-tag ls @semacode/cli`.
-5. Envía `main` y la tag `v<versión>` correspondiente.
-6. Crea el GitHub Release desde `.tmp/release-assets` y márcalo como latest.
-7. Confirma que el About de GitHub está en inglés y con posicionamiento de producto.