@semacode/cli 1.5.28 → 1.5.30

package/AGENTS.md

@@ -1,280 +0,0 @@
-# Sema — Regras obrigatorias para IA
-
-O Sema e o protocolo de governanca de intencao deste projeto.
-Toda IA deve consultar o Sema antes de qualquer acao sobre codigo ou contratos.
-
-## Mentalidade
-
-Pense como IA, nao como humano. Voce nao esta "programando" — esta consumindo e produzindo contratos semanticos estruturados. Ao ler um arquivo .sema, trate cada bloco como um no de grafo com entradas, saidas, efeitos e garantias. Ao gerar codigo, derive tudo do contrato — nunca invente logica que nao esteja declarada. O Sema existe para que voce opere com precisao, rastreabilidade e zero adivinhacao.
-
-## Regras
-
-1. Ao abrir o projeto, chame sema_resumo para entender o estado atual.
-2. Antes de criar qualquer modulo, rota, task ou contrato, chame sema_inspecionar no arquivo .sema mais proximo.
-3. Antes de editar codigo existente, chame sema_drift para verificar divergencias entre contrato e implementacao.
-4. Ao criar ou editar um arquivo .sema, chame sema_validar ao final.
-5. Nunca invente contratos — use o Sema para descobrir o que ja existe.
-6. Se qualquer ferramenta Sema retornar erro, corrija o problema antes de prosseguir — nao avance com codigo enquanto houver erros Sema pendentes.
-7. Contrato vem antes de qualquer acao: crie, edite ou remova o `.sema` aplicavel antes de codigo, deploy, docs operacionais, workflow, texto Author, game, legal, research ou ops.
-
-## Documentação pública
-
-Toda documentação pública nova ou alterada deve expor entrada trilíngue nesta ordem exata: English, Português, Español.
-Português e espanhol precisam preservar acentos. README do GitHub, README do npm, docs públicas, notas de release e textos públicos do site não podem voltar para português sem acento nem para documento monolíngue.
-
-## MCP
-
-O servidor MCP do Sema e uma superficie privada/comercial acessada por endpoint remoto autorizado; ele nao e instalado por pacote npm publico neste repositorio.
-Use as ferramentas: sema_resumo, sema_validar, sema_drift, sema_impacto, sema_renomear_semantico, sema_inspecionar, sema_ir, sema_verificar, sema_contexto_ia, sema_prompt_ia, sema_author_iniciar, sema_author_validar, sema_author_briefing, sema_author_revisar_cliches, sema_sync_ai_entrypoints, sema_instalar_exemplos, sema_docs_impacto, sema_finalizar_mudanca.
-
-O MCP deve deixar claro em toda orientacao: se nao existe contrato, crie; se a intencao mudou, edite; se a capacidade saiu, remova ou aposente. Isso vale para todo tipo de Sema: Software, Author, Workflow, Ops, Game, Legal, Research e profiles futuros.
-
-## Contratos e exemplos
-
-- Sempre salve arquivos .sema na pasta `contratos/` do projeto.
-- Crie um arquivo .sema por modulo ou contexto de negocio. Exemplo: `contratos/pedido.sema`, `contratos/pagamento.sema`, `contratos/usuario.sema`. Nunca coloque modulos de contextos diferentes no mesmo arquivo.
-- Antes de criar qualquer arquivo .sema, leia todos os arquivos da pasta `exemplos/` para entender o formato correto da linguagem.
-- Nunca edite os arquivos da pasta `exemplos/`.
-
-## Quando o projeto nao tem .sema
-
-Pergunte ao usuario se deseja semantizar o projeto e sugira: sema iniciar
-
-## Exemplos de arquivos .sema (referencia de formato)
-
-### 1. Task simples com testes
-```
-module exemplos.calculadora {
-  task somar {
-    input {
-      a: Numero required
-      b: Numero required
-    }
-    output {
-      resultado: Numero
-    }
-    rules {
-      a deve_ser numero_valido
-      b deve_ser numero_valido
-    }
-    effects {
-      auditoria operacao soma
-    }
-    guarantees {
-      resultado existe
-    }
-    error {
-      entrada_invalida: "Os valores precisam ser numericos."
-    }
-    tests {
-      caso "soma basica" {
-        given { a: 2  b: 3 }
-        expect { sucesso: verdadeiro }
-      }
-    }
-  }
-}
-```
-
-### 2. Entity + CRUD com route
-```
-module exemplos.crud.simples {
-  entity Produto {
-    fields {
-      id: Id
-      nome: Texto
-      preco: Decimal
-      ativo: Booleano
-    }
-  }
-
-  task criar_produto {
-    input {
-      nome: Texto required
-      preco: Decimal required
-    }
-    output {
-      produto: Produto
-    }
-    rules {
-      nome deve_ser preenchido
-      preco deve_ser positivo
-    }
-    effects {
-      persistencia Produto
-      auditoria produto_criado
-    }
-    guarantees {
-      produto existe
-    }
-    tests {
-      caso "cria produto" {
-        given { nome: "Caneca"  preco: 39.9 }
-        expect { sucesso: verdadeiro }
-      }
-    }
-  }
-
-  route produtos {
-    metodo: POST
-    caminho: /produtos
-    task: criar_produto
-    finalidade: cadastro_produto
-    input { nome: Texto  preco: Decimal }
-    output { produto: Produto }
-  }
-}
-```
-
-### 3. Cadastro com validacoes e unicidade
-```
-module exemplos.cadastro.usuario {
-  entity Usuario {
-    fields {
-      id: Id
-      nome: Texto
-      email: Email
-      ativo: Booleano
-    }
-  }
-
-  task criar_usuario {
-    input {
-      nome: Texto required
-      email: Email required
-    }
-    output {
-      usuario: Usuario
-    }
-    rules {
-      nome deve_ser preenchido
-      email deve_ser email_valido
-      email deve_ser unico em Usuario.email
-    }
-    effects {
-      persistencia Usuario
-      evento usuario_criado
-      auditoria cadastro_usuario
-    }
-    guarantees {
-      usuario existe
-      persistencia concluida
-    }
-    error {
-      email_duplicado: "Ja existe usuario com este email."
-      entrada_invalida: "Os dados informados nao atendem as regras."
-    }
-    tests {
-      caso "cria usuario valido" {
-        given { nome: "Ana"  email: "ana@empresa.com" }
-        expect { sucesso: verdadeiro }
-      }
-    }
-  }
-}
-```
-
-### 4. Pagamento com state e flow
-```
-module exemplos.pagamento {
-  task processar_pagamento {
-    input {
-      pagamento_id: Id required
-      valor: Decimal required
-      token: Texto required
-    }
-    output {
-      pagamento: Pagamento
-      status: StatusPagamento
-    }
-    rules {
-      valor > 0
-      token deve_ser valido
-    }
-    effects {
-      consulta gateway_pagamento criticidade = alta
-      persistencia Pagamento criticidade = alta
-      evento pagamento_autorizado criticidade = media
-      auditoria pagamento criticidade = alta
-    }
-    state ciclo_pagamento {
-      transitions {
-        PENDENTE -> AUTORIZADO
-        AUTORIZADO -> PROCESSADO
-      }
-    }
-    guarantees {
-      pagamento existe
-      status em [AUTORIZADO, PROCESSADO]
-    }
-    error {
-      autorizacao_negada: "Recusado pelo gateway."
-      timeout_gateway: "Gateway nao respondeu."
-    }
-    tests {
-      caso "pagamento autorizado" {
-        given { pagamento_id: "pag_1"  valor: 199.9  token: "tok_ok" }
-        expect { sucesso: verdadeiro }
-      }
-      caso "pagamento recusado" {
-        given { pagamento_id: "pag_err"  valor: 10  token: "tok_recusado" }
-        expect { sucesso: falso }
-        error { tipo: "autorizacao_negada" }
-      }
-    }
-  }
-
-  flow orquestracao_pagamento {
-    pagamento_id: Id
-    valor: Decimal
-    token: Texto
-    etapa autorizar usa processar_pagamento com pagamento_id = pagamento_id, valor = valor, token = token em_sucesso confirmar em_erro registrar_falha
-    etapa confirmar usa confirmar_pagamento com pagamento_id = pagamento_id depende_de autorizar
-    etapa registrar_falha usa registrar_timeout_pagamento com pagamento_id = pagamento_id depende_de autorizar
-  }
-}
-```
-
-### 5. Tratamento de erro com flow ramificado
-```
-module exemplos.tratamento.erro {
-  task executar_operacao_sensivel {
-    input {
-      chave: Texto required
-    }
-    output {
-      protocolo: Id
-    }
-    rules {
-      chave deve_ser preenchida
-    }
-    effects {
-      consulta cofre
-      auditoria falha_operacao_sensivel
-    }
-    guarantees {
-      protocolo existe
-    }
-    error {
-      acesso_negado: "A chave nao tem permissao."
-      recurso_indisponivel: "Servico temporariamente indisponivel."
-    }
-    tests {
-      caso "falha por acesso negado" {
-        given { chave: "sem_permissao" }
-        expect { sucesso: falso }
-        error { tipo: "acesso_negado" }
-      }
-    }
-  }
-
-  flow resposta_segura {
-    chave: Texto
-    etapa tentar usa executar_operacao_sensivel com chave = chave em_sucesso concluir em_erro registrar_falha por_erro acesso_negado = tratar_acesso_negado, recurso_indisponivel = agendar_retentativa
-    etapa tratar_acesso_negado usa responder_acesso_negado com chave = chave depende_de tentar
-    etapa agendar_retentativa usa responder_retentativa com chave = chave depende_de tentar
-    etapa registrar_falha usa registrar_auditoria_falha com chave = chave depende_de tentar
-    etapa concluir usa registrar_sucesso com protocolo = tentar.protocolo depende_de tentar
-  }
-}
-```

package/LICENSE

@@ -1,22 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Sema
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-

package/SEMA_BRIEF.curto.txt

@@ -1,11 +0,0 @@
-PROJETO: Sema
-BASE: C:\GitHub\Sema
-MODULOS: 13
-MODO_CODIGO: codigo_completo
-FONTES_CONCLUSAO: contrato, codigo
-ENTRADA_IA: llms.txt -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
-TOP_MODULOS: app.pedidos, sema.produto.author, sema.produto.ergonomia_e_dominio, sema.produto.fronteira_repositorios, sema.produto.game, sema.produto.geradores_web (+7)
-TOP_RISCOS: altera_persistencia, assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio, classificar_artefato_repositorio:medio, comparar_diff_semantico_author:medio, consultar_scorecard_compatibilidade:medio (+35)
-TOP_LACUNAS: execucao_implicita, sem_impl, vinculo_quebrado
-TOP_ARQUIVOS: C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\env.md, C:\GitHub\Sema\docs\mcp.md, C:\GitHub\Sema\docs\README.md (+19)
-GERADO_EM: 2026-05-18T23:17:36.000Z

package/SEMA_BRIEF.md

@@ -1,112 +0,0 @@
-# SEMA_BRIEF
-
-Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto sem varrer o repo inteiro no escuro.
-
-- Gerado em: `2026-05-18T23:17:36.000Z`
-- Modulos: `13`
-
-## 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: C:\GitHub\Sema\testes\integracao\drift-legado.test.ts
-- Score: 50 | Confianca: media | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.author
-- Faz: governa 2 superficie(s), 14 task(s) com foco em author briefing
-- Publico: policy:author_quality_gate, worker:author_briefing
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
-- Score: 90 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### 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, vinculo_quebrado
-
-### sema.produto.fronteira_repositorios
-- Faz: governa 2 task(s) com foco em classificar artefato repositorio
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\repositories.md, C:\GitHub\Sema\scripts\verificar-fronteira-publica.mjs
-- Score: 93 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.game
-- Faz: governa 2 task(s) com foco em validar loop game
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
-- Score: 90 | Confianca: alta | Risco: medio
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.geradores_web
-- Faz: governa 3 task(s) com foco em gerar contrato javascript
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\gerador-css\src\index.ts, C:\GitHub\Sema\pacotes\gerador-html\src\index.ts, C:\GitHub\Sema\pacotes\gerador-javascript\src\index.ts
-- Score: 90 | Confianca: alta | Risco: medio
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.governanca_ia
-- Faz: governa 2 superficie(s), 19 task(s) com foco em preparar briefing contextual
-- Publico: webhook:confirmar_contexto_publico, worker:preparar_briefing_contextual
-- Tocar: C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\env.md, C:\GitHub\Sema\docs\mcp.md (+4)
-- Score: 93 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.legal
-- Faz: governa 1 task(s) com foco em validar contexto legal
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
-- Score: 90 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.linguagem_composta
-- Faz: governa 1 superficie(s), 5 task(s) com foco em regressao composta
-- Publico: storage:regressao_composta
-- Tocar: 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, C:\GitHub\Sema\pacotes\nucleo\src\ir\conversor.ts (+1)
-- Score: 90 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.persistencia_vendor_first
-- Faz: governa 6 task(s) com foco em validar compatibilidade vendor first
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\drift.ts, C:\GitHub\Sema\pacotes\cli\src\importador.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\nucleo\src\formatador\index.ts (+2)
-- Score: 90 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.research
-- Faz: governa 2 task(s) com foco em validar plano research
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
-- Score: 90 | Confianca: alta | Risco: medio
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.software
-- Faz: governa 2 task(s) com foco em validar profile software
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
-- Score: 90 | Confianca: alta | Risco: medio
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado
-
-### sema.produto.workflow_ops
-- Faz: governa 2 task(s) com foco em validar runtime workflow
-- Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts
-- Score: 90 | Confianca: alta | Risco: alto
-- Lacunas: execucao_implicita, sem_impl, vinculo_quebrado

package/SEMA_BRIEF.micro.txt

@@ -1,9 +0,0 @@
-PROJETO: Sema
-MODULOS: 13
-MODO_CODIGO: codigo_completo
-FONTES_CONCLUSAO: contrato, codigo
-ENTRADA_IA: llms.txt -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
-TOP_MODULOS: app.pedidos, sema.produto.author, sema.produto.ergonomia_e_dominio (+10)
-TOP_RISCOS: altera_persistencia, assistir_renomeacao_semantica:alto, carregar_configuracao_de_persistencia:medio (+38)
-TOP_LACUNAS: execucao_implicita, sem_impl, vinculo_quebrado
-GERADO_EM: 2026-05-18T23:17:36.000Z