Sema Language Tools e a extensao oficial do VS Code para a Sema, o protocolo semantico IA-first para contrato, fluxo, erro, efeito, garantia, vinculos, execucao e drift em backend vivo.
Ela nao existe para virar enfeite de sintaxe. Ela existe para deixar a camada semantica da Sema util no editor enquanto a CLI fecha o resto do fluxo.
O que a extensao entrega
- associacao automatica de arquivos
.sema
- destaque de sintaxe para os blocos centrais da linguagem
- snippets para
module, task, flow, route e state
- hover basico para palavras-chave da linguagem
- diagnosticos semanticos no editor
- validacao com contexto de projeto, incluindo
use cross-module
- formatacao de documento
- integracao com a CLI oficial da Sema
O que ela nao tenta fazer sozinha
- substituir a CLI
- rodar scaffold completo
- fazer
drift, contexto-ia e verificacao de projeto so pelo editor
O fluxo bom continua sendo: editor para escrever e revisar, CLI para validar, medir drift, gerar contexto para IA e compilar.
Instale a extensao
GitHub Releases:
Depois de baixar:
code --install-extension ./sema-language-tools-latest.vsix --force
Windows PowerShell:
Invoke-WebRequest -Uri https://github.com/gerlanss/Sema/releases/latest/download/sema-language-tools-latest.vsix -OutFile sema-language-tools-latest.vsix
code --install-extension .\sema-language-tools-latest.vsix --force
Instale a CLI da Sema
Para usar a Sema direito no projeto, instale tambem a CLI oficial:
npm install -g @semacode/cli
sema --help
sema doctor
Opcionalmente, voce tambem pode instalar pela release:
npm install -g https://github.com/gerlanss/Sema/releases/latest/download/sema-cli-latest.tgz
sema --help
sema doctor
Guia completo:
Primeiro fluxo recomendado
- abra ou crie um arquivo
.sema
- use
Sema: Formatar Documento
- corrija os diagnosticos do editor
- feche o ciclo com a CLI
sema validar contratos/pedidos.sema --json
sema diagnosticos contratos/pedidos.sema --json
sema drift contratos/pedidos.sema --json
sema contexto-ia contratos/pedidos.sema --saida ./.tmp/contexto-pedidos --json
Como a extensao encontra a CLI
sema.cliPath, se voce configurar manualmente- bin
sema disponivel no sistema
node_modules/.bin/sema do projeto atual- CLI local do proprio repositorio da Sema
Se sema --help funciona no terminal do projeto, a extensao quase sempre encontra o caminho certo.
Links diretos
Sobre a Sema
A Sema nao foi desenhada para ser human-first.
Ela foi desenhada para reduzir ambiguidade para IA em sistema real. O editor entra como apoio. A camada principal continua sendo a semantica explicita e o fluxo completo da CLI.
