@semacode/cli 1.5.27 → 1.5.29

package/AGENT_CONTEXT_PACK.json

@@ -0,0 +1,164 @@
+{
+  "nome": "Agent Context Pack",
+  "versao": 1,
+  "objetivo": "Dar a agentes IA uma entrada curta, estruturada e auditavel antes de abrir codigo cru ou inventar contexto.",
+  "ordemLeitura": [
+    "llms.txt",
+    "AGENT_CONTEXT_PACK.json",
+    "SEMA_BRIEF.micro.txt",
+    "SEMA_INDEX.json",
+    "AGENTS.md",
+    "exemplos/"
+  ],
+  "regrasObrigatorias": [
+    "Contrato vem antes da acao.",
+    "Leia AGENTS.md antes de editar codigo, contrato, docs operacionais, release ou deploy.",
+    "Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.",
+    "Use SEMA_INDEX.json para escolher contrato, modulo e arquivos provaveis antes de abrir codigo cru.",
+    "Valide .sema alterado e rode drift antes de concluir.",
+    "Quando faltar contrato aplicavel, crie ou edite o contrato antes do codigo."
+  ],
+  "proibicoes": [
+    "Nao inventar sintaxe Sema fora da gramatica e dos exemplos oficiais.",
+    "Nao tratar README, texto livre ou codigo como fonte superior ao contrato.",
+    "Nao sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
+    "Nao publicar, deployar ou remover capacidade sem contrato, drift e verificacao.",
+    "Nao misturar repositorio publico e privado sem conferir docs de repositorios e AGENTS.md."
+  ],
+  "prioridades": [
+    "Menor artefato suficiente primeiro.",
+    "Contrato, indice e AGENTS antes de codigo cru.",
+    "Exemplos oficiais antes de nova sintaxe.",
+    "Diagnostico estruturado antes de opiniao livre.",
+    "Se risco ou escopo estiver ambigui, parar e pedir contrato/contexto."
+  ],
+  "fontes": [
+    {
+      "caminho": "llms.txt",
+      "tipo": "entrypoint",
+      "prioridade": 1,
+      "obrigatorio": true,
+      "quandoUsar": "sempre no primeiro contato com o projeto",
+      "incluirTextoBrutoQuando": "a IA precisa de orientacao compacta para operar o repositorio"
+    },
+    {
+      "caminho": "AGENT_CONTEXT_PACK.json",
+      "tipo": "entrypoint",
+      "prioridade": 2,
+      "obrigatorio": true,
+      "quandoUsar": "sempre antes de decidir quais documentos ou exemplos abrir",
+      "incluirTextoBrutoQuando": "a IA precisa auditar regras, proibicoes, prioridades e fontes de verdade"
+    },
+    {
+      "caminho": "SEMA_BRIEF.micro.txt",
+      "tipo": "resumo",
+      "prioridade": 3,
+      "obrigatorio": true,
+      "quandoUsar": "IA pequena, onboarding, chat remoto ou primeiro triage",
+      "incluirTextoBrutoQuando": "a tarefa cabe em contexto curto"
+    },
+    {
+      "caminho": "SEMA_BRIEF.curto.txt",
+      "tipo": "resumo",
+      "prioridade": 4,
+      "obrigatorio": true,
+      "quandoUsar": "IA media, mudanca pequena ou review rapido",
+      "incluirTextoBrutoQuando": "o modulo alvo ainda nao esta claro pelo micro"
+    },
+    {
+      "caminho": "SEMA_INDEX.json",
+      "tipo": "indice",
+      "prioridade": 5,
+      "obrigatorio": true,
+      "quandoUsar": "antes de abrir codigo cru ou escolher contrato alvo",
+      "incluirTextoBrutoQuando": "a IA precisa mapear modulos, lacunas, riscos ou arquivos provaveis"
+    },
+    {
+      "caminho": "AGENTS.md",
+      "tipo": "operacional",
+      "prioridade": 6,
+      "obrigatorio": true,
+      "quandoUsar": "antes de editar codigo, contrato, docs operacionais, release ou deploy",
+      "incluirTextoBrutoQuando": "a IA precisa confirmar regras locais obrigatorias e prioridades do projeto"
+    },
+    {
+      "caminho": "exemplos/",
+      "tipo": "exemplos",
+      "prioridade": 7,
+      "obrigatorio": true,
+      "quandoUsar": "antes de criar ou corrigir arquivo .sema, profile, Author, workflow, ops, game, legal ou research",
+      "incluirTextoBrutoQuando": "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial"
+    },
+    {
+      "caminho": "docs/AGENT_STARTER.md",
+      "tipo": "docs",
+      "prioridade": 8,
+      "obrigatorio": false,
+      "quandoUsar": "onboarding de agente novo ou explicacao curta do fluxo",
+      "incluirTextoBrutoQuando": "o agente remoto nao conhece Sema ainda"
+    },
+    {
+      "caminho": "docs/sintaxe.md",
+      "tipo": "docs",
+      "prioridade": 9,
+      "obrigatorio": false,
+      "quandoUsar": "duvida de gramatica, blocos ou formato do DSL",
+      "incluirTextoBrutoQuando": "a IA vai editar contrato e os exemplos nao bastam"
+    },
+    {
+      "caminho": "contratos/",
+      "tipo": "contrato",
+      "prioridade": 10,
+      "obrigatorio": true,
+      "quandoUsar": "antes de qualquer implementacao ou alteracao de comportamento",
+      "incluirTextoBrutoQuando": "a tarefa toca uma capacidade governada por contrato"
+    }
+  ],
+  "exemplosOficiais": [
+    "exemplos/calculadora.sema",
+    "exemplos/pagamento.sema",
+    "exemplos/profile_software.sema",
+    "exemplos/profile_workflow_n8n.sema",
+    "exemplos/profile_ops.sema",
+    "exemplos/profile_game.sema",
+    "exemplos/profile_legal.sema",
+    "exemplos/profile_research.sema",
+    "exemplos/author_obra_comum.sema"
+  ],
+  "textoBrutoSobDemanda": {
+    "llms.txt": "a IA precisa de orientacao compacta para operar o repositorio",
+    "AGENT_CONTEXT_PACK.json": "a IA precisa auditar regras, proibicoes, prioridades e fontes de verdade",
+    "SEMA_BRIEF.micro.txt": "a tarefa cabe em contexto curto",
+    "SEMA_BRIEF.curto.txt": "o modulo alvo ainda nao esta claro pelo micro",
+    "SEMA_INDEX.json": "a IA precisa mapear modulos, lacunas, riscos ou arquivos provaveis",
+    "AGENTS.md": "a IA precisa confirmar regras locais obrigatorias e prioridades do projeto",
+    "exemplos/": "a IA vai escrever sintaxe Sema ou comparar um contrato com formato oficial",
+    "docs/AGENT_STARTER.md": "o agente remoto nao conhece Sema ainda",
+    "docs/sintaxe.md": "a IA vai editar contrato e os exemplos nao bastam",
+    "contratos/": "a tarefa toca uma capacidade governada por contrato"
+  },
+  "guiaPorCapacidade": {
+    "pequena": [
+      "agent-context-pack.json",
+      "resumo.micro.txt",
+      "briefing.min.json",
+      "resumo.curto.txt"
+    ],
+    "media": [
+      "agent-context-pack.json",
+      "resumo.curto.txt",
+      "briefing.min.json",
+      "drift.json",
+      "resumo.md"
+    ],
+    "grande": [
+      "agent-context-pack.json",
+      "README.md",
+      "resumo.md",
+      "briefing.json",
+      "drift.json",
+      "ir.json",
+      "ast.json"
+    ]
+  }
+}

package/README.md

@@ -1,144 +1,144 @@
-# @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.27`.
-
-### Install
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema doctor
-```
-
-### Core Flow
-
-```bash
-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
-
-```bash
-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.27`.
-
-### Instalar
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema doctor
-```
-
-### Fluxo Central
-
-```bash
-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
-
-```bash
-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.27`.
-
-### Instalar
-
-```bash
-npm install -g @semacode/cli
-sema --version
-sema doctor
-```
-
-### Flujo Central
-
-```bash
-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
-
-```bash
-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>
+# @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.29`.
+
+### Install
+
+```bash
+npm install -g @semacode/cli
+sema --version
+sema doctor
+```
+
+### Core Flow
+
+```bash
+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
+
+```bash
+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.29`.
+
+### Instalar
+
+```bash
+npm install -g @semacode/cli
+sema --version
+sema doctor
+```
+
+### Fluxo Central
+
+```bash
+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
+
+```bash
+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.29`.
+
+### Instalar
+
+```bash
+npm install -g @semacode/cli
+sema --version
+sema doctor
+```
+
+### Flujo Central
+
+```bash
+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
+
+```bash
+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>

package/SEMA_BRIEF.curto.txt

@@ -1,11 +1,11 @@
 PROJETO: Sema
 BASE: C:\GitHub\Sema
-MODULOS: 13
+MODULOS: 69
 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\documentacao.md, C:\GitHub\Sema\docs\env.md, C:\GitHub\Sema\docs\mcp.md, C:\GitHub\Sema\docs\README.md, C:\GitHub\Sema\docs\refinamentos-agentes-semanticos.md (+18)
-GERADO_EM: 2026-05-18T22:48:13.851Z
+ENTRADA_IA: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2, sema.produto.author.modelos, sema.produto.author.superficies, sema.produto.author.tarefas_2 (+63)
+TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+146)
+TOP_LACUNAS: audit_ausente, authz_frouxa, dados_nao_classificados, execucao_critica_sem_bloco, execucao_implicita, impl_quebrado
+TOP_ARQUIVOS: C:\GitHub\Sema\private\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\private\docs\controle-comercial-supabase.md, C:\GitHub\Sema\private\docs\deploy.md, C:\GitHub\Sema\private\docs\frontend.md, C:\GitHub\Sema\private\experimentos\estoque-comparativo\artefatos\alto\README.md, C:\GitHub\Sema\private\mcp\package.json (+99)
+GERADO_EM: 2026-05-24T14:45:10.627Z