Sema CLI

Sema e um Protocolo de Governanca de Intencao para IA e backend vivo.

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.

Este pacote entrega a CLI oficial para:

• 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:

sema sync-ai-entrypoints --json

Instalacao pelo npm registry

npm install -g @semacode/cli
sema --help

Instalacao via tarball da release

npm install -g ./sema-cli-1.2.17.tgz

Ou direto da GitHub Release:

npm install -g https://github.com/gerlanss/Sema/releases/latest/download/sema-cli-latest.tgz

Instalacao local ao projeto

npm install @semacode/cli
npx sema --help

Ou, se voce estiver testando um tarball local:

npm install ./sema-cli-1.2.17.tgz
npx sema --help

Primeiro teste

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

Repositorio: https://github.com/gerlanss/Sema