@semacode/cli

English

@semacode/cli is the public Sema command-line package published on npm.

It validates .sema contracts, checks semantic drift against live code, maps impact, prepares AI-first context, enforces documentation gates, and validates the official Sema profiles: Software, Workflow/Ops, Author, Game, Legal, and Research.

Current public version: 1.5.28.

Install

npm install -g @semacode/cli
sema --version
sema doctor

Core Flow

sema iniciar
sema validar contratos/pedidos.sema --json
sema drift contratos/pedidos.sema --escopo modulo --json
sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "replace pedido_id with pedido_uuid" --json
sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json

MCP Client Key

printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json

The command stores the commercial MCP key in the local user environment as SEMA_MCP_AUTH_TOKEN without receiving the secret as a CLI argument.

Common Commands

• sema validar <arquivo-ou-pasta> --json
• sema drift <arquivo-ou-pasta> --json
• sema resumo <arquivo-ou-pasta> --micro --para onboarding
• sema contexto-ia <arquivo.sema> --saida <diretorio> --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 profile validar <software|workflow|ops|game|legal|research> <arquivo.sema> --json

Português

@semacode/cli é o pacote público de linha de comando da Sema publicado no npm.

Ele valida contratos .sema, verifica drift semântico contra código vivo, mapeia impacto, prepara contexto IA-first, aplica gates de documentação e valida os profiles oficiais da Sema: Software, Workflow/Ops, Author, Game, Legal e Research.

Versão pública atual: 1.5.28.

Instalar

npm install -g @semacode/cli
sema --version
sema doctor

Fluxo Central

sema iniciar
sema validar contratos/pedidos.sema --json
sema drift contratos/pedidos.sema --escopo modulo --json
sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "trocar pedido_id por pedido_uuid" --json
sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json

Chave MCP Do Cliente

printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json

O comando grava a chave MCP comercial no ambiente local do usuário como SEMA_MCP_AUTH_TOKEN, sem receber o segredo como argumento da CLI.

Comandos Comuns

• sema validar <arquivo-ou-pasta> --json
• sema drift <arquivo-ou-pasta> --json
• sema resumo <arquivo-ou-pasta> --micro --para onboarding
• sema contexto-ia <arquivo.sema> --saida <diretorio> --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 profile validar <software|workflow|ops|game|legal|research> <arquivo.sema> --json

Español

@semacode/cli es el paquete público de línea de comando de Sema publicado en npm.

Valida contratos .sema, verifica drift semántico contra código vivo, mapea impacto, prepara contexto IA-first, aplica gates de documentación y valida los profiles oficiales de Sema: Software, Workflow/Ops, Author, Game, Legal y Research.

Versión pública actual: 1.5.28.

Instalar

npm install -g @semacode/cli
sema --version
sema doctor

Flujo Central

sema iniciar
sema validar contratos/pedidos.sema --json
sema drift contratos/pedidos.sema --escopo modulo --json
sema impacto contratos/pedidos.sema --alvo pedido_id --mudanca "cambiar pedido_id por pedido_uuid" --json
sema docs-impacto --intencao "alterar pedidos" --arquivo contratos/pedidos.sema --json
sema finalizar-mudanca --intencao "alterar pedidos" --doc-lida README.md --json

Clave MCP Del Cliente

printf '%s' 'sema_mcp_...' | sema mcp-instalar-chave --stdin --json

El comando guarda la clave MCP comercial en el entorno local del usuario como SEMA_MCP_AUTH_TOKEN, sin recibir el secreto como argumento de la CLI.

Comandos Comunes

• sema validar <arquivo-ou-pasta> --json
• sema drift <arquivo-ou-pasta> --json
• sema resumo <arquivo-ou-pasta> --micro --para onboarding
• sema contexto-ia <arquivo.sema> --saida <diretorio> --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 profile validar <software|workflow|ops|game|legal|research> <arquivo.sema> --json

Links

• Repository: https://github.com/gerlanss/Sema
• Documentation: https://github.com/gerlanss/Sema/tree/main/docs