@semacode/cli 1.0.0 → 1.2.0

package/AGENTS.md

@@ -0,0 +1,50 @@
+# AGENTS.md
+
+Sema e IA-first. Este repositorio nao foi desenhado para ergonomia humana como objetivo principal.
+
+Se voce for uma IA, nao comece pelo codigo cru. Comece pela trilha canonica:
+
+1. `llms.txt`
+2. `SEMA_BRIEF.md`
+3. `SEMA_INDEX.json`
+4. `README.md`
+5. `docs/AGENT_STARTER.md`
+
+Roteamento por capacidade:
+
+- IA pequena ou gratuita: `llms.txt` -> `SEMA_BRIEF.micro.txt` -> `SEMA_INDEX.json` -> `README.md`
+- IA media: `llms.txt` -> `SEMA_BRIEF.curto.txt` -> `SEMA_INDEX.json` -> `README.md` -> `docs/AGENT_STARTER.md`
+- IA grande ou com tool use: `llms-full.txt` -> `SEMA_BRIEF.md` -> `SEMA_INDEX.json` -> `README.md` -> `docs/AGENT_STARTER.md`
+
+Fontes de verdade:
+
+1. artefatos Sema gerados ou versionados na raiz
+2. JSON da CLI
+3. docs oficiais
+4. exemplos oficiais
+5. codigo vivo
+
+Regras:
+
+- trate a Sema como camada semantica para IA operar backend vivo com menos adivinhacao
+- preserve contrato, vinculo, execucao, erro, efeito, garantia, score, confianca e lacunas
+- se existir artefato Sema para a tarefa, use-o antes de abrir o codigo
+- nao trate texto solto como mais confiavel que `drift`, `ir`, `diagnosticos` ou `briefing`
+- se a IA for pequena, nao tente carregar AST e IR de cara
+- nao invente sintaxe fora da gramatica oficial
+
+Comandos minimos:
+
+- `sema resumo <arquivo-ou-pasta> --micro --para mudanca`
+- `sema prompt-curto <arquivo-ou-pasta> --curto --para review`
+- `sema drift <arquivo-ou-pasta> --json`
+- `sema contexto-ia <arquivo.sema> --saida ./.tmp/contexto --json`
+- `sema validar <arquivo-ou-pasta> --json`
+- `sema verificar <arquivo-ou-pasta> --json`
+
+Se a tarefa envolver edicao real:
+
+1. leia o menor artefato que resolver
+2. suba para `drift` e `briefing` antes de editar
+3. use `diagnosticos` para correcao
+4. valide e verifique no fim

package/README.md

@@ -13,6 +13,19 @@ Este pacote entrega a CLI oficial para:
 - 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:
+
+```bash
+sema sync-ai-entrypoints --json
+```
+
 ## Instalacao pelo npm registry
 
 ```bash
@@ -23,7 +36,7 @@ sema --help
 ## Instalacao via tarball da release
 
 ```bash
-npm install -g ./sema-cli-1.0.0.tgz
+npm install -g ./sema-cli-1.2.0.tgz
 ```
 
 Ou direto da GitHub Release:
@@ -42,7 +55,7 @@ npx sema --help
 Ou, se voce estiver testando um tarball local:
 
 ```bash
-npm install ./sema-cli-1.0.0.tgz
+npm install ./sema-cli-1.2.0.tgz
 npx sema --help
 ```
 

package/SEMA_BRIEF.curto.txt

@@ -0,0 +1,9 @@
+PROJETO: Sema
+BASE: C:\GitHub\Sema
+MODULOS: 4
+ENTRADA_IA: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+TOP_MODULOS: app.pedidos, sema.produto.ergonomia_e_dominio, sema.produto.governanca_ia, sema.produto.linguagem_composta
+TOP_RISCOS: altera_persistencia, consultar_scorecard_compatibilidade:medio, converter_bloco_composto_para_ir:alto, criar_pedido:alto, efeito_critico, explicitar_variacao_e_compatibilidade:medio (+13)
+TOP_LACUNAS: execucao_implicita, sem_impl, sem_vinculos
+TOP_ARQUIVOS: C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\gerador-lua\src\index.ts, C:\GitHub\Sema\pacotes\gerador-python\src\index.ts, C:\GitHub\Sema\pacotes\gerador-typescript\src\index.ts (+4)
+GERADO_EM: 2026-04-02T00:02:31.211Z

package/SEMA_BRIEF.md

@@ -0,0 +1,49 @@
+# SEMA_BRIEF
+
+Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem ter que catar o repo inteiro feito barata tonta.
+
+- Gerado em: `2026-04-02T00:02:31.211Z`
+- Modulos: `4`
+
+## Entrada canonica para IA
+
+- Ordem minima: llms.txt -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md -> llms-full.txt
+- IA pequena: llms.txt -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
+- IA media: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+- IA grande: llms-full.txt -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md
+
+## Guia por capacidade
+
+- pequena: IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo. Artefatos: resumo.micro.txt, briefing.min.json, prompt-curto.txt.
+- media: IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift. Artefatos: resumo.curto.txt, briefing.min.json, drift.json, prompt-curto.txt.
+- grande: IA com contexto grande ou tool use. Pode consumir o pacote completo. Artefatos: README.md, resumo.md, briefing.json, drift.json, ir.json, ast.json.
+
+## Modulos
+
+### app.pedidos
+- Faz: governa 1 rota(s), 1 task(s) com foco em criar pedido publico
+- Publico: POST /pedidos
+- Tocar: nenhum
+- Score: 50 | Confianca: baixa | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos
+
+### sema.produto.ergonomia_e_dominio
+- Faz: governa 2 superficie(s), 5 task(s) com foco em scorecard atualizado
+- Publico: evento:scorecard_atualizado, policy:compatibilidade_publica
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\ir\conversor.ts, C:\GitHub\Sema\pacotes\nucleo\src\semantico\analisador.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos
+
+### sema.produto.governanca_ia
+- Faz: governa 2 superficie(s), 4 task(s) com foco em preparar briefing contextual
+- Publico: webhook:confirmar_contexto_publico, worker:preparar_briefing_contextual
+- Tocar: C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos
+
+### sema.produto.linguagem_composta
+- Faz: governa 1 superficie(s), 6 task(s) com foco em regressao composta
+- Publico: storage:regressao_composta
+- Tocar: C:\GitHub\Sema\pacotes\gerador-lua\src\index.ts, C:\GitHub\Sema\pacotes\gerador-python\src\index.ts, C:\GitHub\Sema\pacotes\gerador-typescript\src\index.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts (+2)
+- Score: 90 | Confianca: alta | Risco: alto
+- Lacunas: execucao_implicita, sem_impl, sem_vinculos

package/SEMA_BRIEF.micro.txt

@@ -0,0 +1,7 @@
+PROJETO: Sema
+MODULOS: 4
+ENTRADA_IA: llms.txt -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
+TOP_MODULOS: app.pedidos, sema.produto.ergonomia_e_dominio, sema.produto.governanca_ia (+1)
+TOP_RISCOS: altera_persistencia, consultar_scorecard_compatibilidade:medio, converter_bloco_composto_para_ir:alto (+16)
+TOP_LACUNAS: execucao_implicita, sem_impl, sem_vinculos
+GERADO_EM: 2026-04-02T00:02:31.211Z