@semacode/cli 1.5.32 → 1.5.35

package/AGENTS.md

@@ -3,6 +3,20 @@
 O Sema e o contrato semantico IA-first deste projeto.
 Toda IA deve consultar o Sema antes de qualquer acao sobre codigo ou contratos. Humanos escrevem e aprovam; agentes consomem o contrato para operar software vivo.
 
+## Boot obrigatório para qualquer IA
+
+Antes de abrir código cru, leia `SEMA_BOOT.md`. Se a IA tiver pouco contexto, pouca disciplina de tool use ou for um agente secundário, leia também `SEMA_SMALL_MODEL.md`.
+
+Capacidade operacional:
+
+- IA fraca: use `SEMA_BOOT.md`, `SEMA_SMALL_MODEL.md`, `SEMA_BRIEF.micro.txt` e falhe fechado se Sema não responder.
+- IA média: use `SEMA_BOOT.md`, `AGENT_CONTEXT_PACK.json`, `SEMA_BRIEF.curto.txt` e `SEMA_INDEX.json`.
+- IA forte: pode subir para `SEMA_BRIEF.md`, AST, IR e drift completo, mas continua obrigada a passar pelos gates Sema.
+
+Timeout operacional: timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `sema_drift`, `sema_docs_impacto` ou outro gate estourar timeout local, aumente o timeout e tente de novo. Para projeto grande, prefira escopar para o contrato ou arquivo alvo; se o ambiente impedir continuar, pare bloqueado e não avance sem Sema.
+
+Idioma humano: responda no idioma falado pelo usuário. Em PT-BR, use acentos, cedilha, pontuação e símbolos normais. A DSL `.sema` pode usar palavras-chave ASCII; isso não autoriza texto humano sem acentos.
+
 ## Regras
 
 1. Ao abrir o projeto, chame sema_resumo para entender o estado atual.
@@ -16,7 +30,7 @@ Toda IA deve consultar o Sema antes de qualquer acao sobre codigo ou contratos.
 ## 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 quando o endpoint privado estiver configurado: 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.
+Use as ferramentas quando o endpoint privado estiver configurado: 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_exemplos, 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.
 
@@ -47,7 +61,9 @@ Quando usar Sema via CLI:
 
 - 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.
+- Antes de criar qualquer arquivo .sema, leia os exemplos oficiais para entender o formato correto da linguagem.
+- Em MCP remoto/cliente web, use `sema_exemplos` para listar ou ler exemplos oficiais. Nao peca para o MCP ler `C:\GitHub\Sema\exemplos` nem qualquer pasta local do usuario.
+- Em CLI/local repo, a pasta `exemplos/` pode ser lida ou materializada localmente quando necessario.
 - Nunca edite os arquivos da pasta `exemplos/`.
 
 ## Quando o projeto nao tem .sema

package/AGENT_CONTEXT_PACK.json

@@ -1,90 +1,117 @@
 {
   "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.",
+  "versao": 3,
+  "objetivo": "Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.",
   "ordemLeitura": [
+    "SEMA_BOOT.md",
     "llms.txt",
     "AGENT_CONTEXT_PACK.json",
+    "SEMA_SMALL_MODEL.md",
     "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.",
+    "Contrato vem antes da ação.",
+    "Leia SEMA_BOOT.md antes de qualquer outro artefato de IA.",
+    "Leia AGENTS.md antes de editar código, 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.",
+    "Use SEMA_INDEX.json para escolher contrato, módulo e arquivos prováveis antes de abrir código cru.",
     "Valide .sema alterado e rode drift antes de concluir.",
-    "Quando faltar contrato aplicavel, crie ou edite o contrato antes do codigo."
+    "Quando faltar contrato aplicável, crie ou edite o contrato antes do código.",
+    "Responda no idioma do usuário e preserve acentos, cedilha, pontuação e símbolos humanos.",
+    "Mantenha o cabeçalho SEMA-GOVERNED em código gerado ou governado e volte ao contrato antes de editar.",
+    "Se uma chamada Sema estourar por timeout local, aumente o timeout e tente novamente; não trate lentidão como sessão inativa."
   ],
   "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."
+    "Não inventar sintaxe Sema fora da gramática e dos exemplos oficiais.",
+    "Não tratar README, texto livre ou código como fonte superior ao contrato.",
+    "Não sincronizar segredos, .env, node_modules, builds, caches, uploads ou artefatos privados fora do escopo.",
+    "Não publicar, deployar ou remover capacidade sem contrato, drift e verificação.",
+    "Não misturar repositório público e privado sem conferir docs de repositórios e AGENTS.md.",
+    "Não usar a estética ASCII da DSL como desculpa para escrever PT-BR sem acentos.",
+    "Não remover SEMA-GOVERNED nem substituir drift por comentário dentro do código.",
+    "Não copiar o contrato inteiro para comentário de código; mantenha descrição humana curta.",
+    "Não tratar timeout definido pelo agente como falha do Sema ou permissão para pular gate."
   ],
   "prioridades": [
     "Menor artefato suficiente primeiro.",
-    "Contrato, indice e AGENTS antes de codigo cru.",
+    "Contrato, índice e AGENTS antes de código cru.",
     "Exemplos oficiais antes de nova sintaxe.",
-    "Diagnostico estruturado antes de opiniao livre.",
-    "Se risco ou escopo estiver ambigui, parar e pedir contrato/contexto."
+    "Diagnóstico estruturado antes de opinião livre.",
+    "Retry progressivo em timeout antes de declarar bloqueio.",
+    "Se risco ou escopo estiver ambíguo, parar e pedir contrato/contexto."
   ],
   "fontes": [
     {
-      "caminho": "llms.txt",
+      "caminho": "SEMA_BOOT.md",
       "tipo": "entrypoint",
       "prioridade": 1,
       "obrigatorio": true,
+      "quandoUsar": "sempre no primeiro contato de qualquer agente com o projeto",
+      "incluirTextoBrutoQuando": "a IA precisa de um boot curto, fail-closed e independente do tamanho de contexto"
+    },
+    {
+      "caminho": "SEMA_SMALL_MODEL.md",
+      "tipo": "entrypoint",
+      "prioridade": 2,
+      "obrigatorio": true,
+      "quandoUsar": "IA fraca, Copilot, modelo local pequeno, Cline/Roo com pouco contexto ou tarefa curta",
+      "incluirTextoBrutoQuando": "a IA tende a ignorar instruções longas ou copiar a estética ASCII da DSL"
+    },
+    {
+      "caminho": "llms.txt",
+      "tipo": "entrypoint",
+      "prioridade": 3,
+      "obrigatorio": true,
       "quandoUsar": "sempre no primeiro contato com o projeto",
-      "incluirTextoBrutoQuando": "a IA precisa de orientacao compacta para operar o repositorio"
+      "incluirTextoBrutoQuando": "a IA precisa de orientação compacta para operar o repositório"
     },
     {
       "caminho": "AGENT_CONTEXT_PACK.json",
       "tipo": "entrypoint",
-      "prioridade": 2,
+      "prioridade": 4,
       "obrigatorio": true,
       "quandoUsar": "sempre antes de decidir quais documentos ou exemplos abrir",
-      "incluirTextoBrutoQuando": "a IA precisa auditar regras, proibicoes, prioridades e fontes de verdade"
+      "incluirTextoBrutoQuando": "a IA precisa auditar regras, proibições, prioridades e fontes de verdade"
     },
     {
       "caminho": "SEMA_BRIEF.micro.txt",
       "tipo": "resumo",
-      "prioridade": 3,
+      "prioridade": 5,
       "obrigatorio": true,
-      "quandoUsar": "IA pequena, onboarding, chat remoto ou primeiro triage",
+      "quandoUsar": "IA fraca, onboarding, chat remoto ou primeiro triage",
       "incluirTextoBrutoQuando": "a tarefa cabe em contexto curto"
     },
     {
       "caminho": "SEMA_BRIEF.curto.txt",
       "tipo": "resumo",
-      "prioridade": 4,
+      "prioridade": 6,
       "obrigatorio": true,
-      "quandoUsar": "IA media, mudanca pequena ou review rapido",
-      "incluirTextoBrutoQuando": "o modulo alvo ainda nao esta claro pelo micro"
+      "quandoUsar": "IA média, mudança pequena ou review rápido",
+      "incluirTextoBrutoQuando": "o módulo alvo ainda não está claro pelo micro"
     },
     {
       "caminho": "SEMA_INDEX.json",
       "tipo": "indice",
-      "prioridade": 5,
+      "prioridade": 7,
       "obrigatorio": true,
-      "quandoUsar": "antes de abrir codigo cru ou escolher contrato alvo",
-      "incluirTextoBrutoQuando": "a IA precisa mapear modulos, lacunas, riscos ou arquivos provaveis"
+      "quandoUsar": "antes de abrir código cru ou escolher contrato alvo",
+      "incluirTextoBrutoQuando": "a IA precisa mapear módulos, lacunas, riscos ou arquivos prováveis"
     },
     {
       "caminho": "AGENTS.md",
       "tipo": "operacional",
-      "prioridade": 6,
+      "prioridade": 8,
       "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"
+      "quandoUsar": "antes de editar código, contrato, docs operacionais, release ou deploy",
+      "incluirTextoBrutoQuando": "a IA precisa confirmar regras locais obrigatórias e prioridades do projeto"
     },
     {
       "caminho": "exemplos/",
       "tipo": "exemplos",
-      "prioridade": 7,
+      "prioridade": 9,
       "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"
@@ -92,25 +119,33 @@
     {
       "caminho": "docs/AGENT_STARTER.md",
       "tipo": "docs",
-      "prioridade": 8,
+      "prioridade": 10,
+      "obrigatorio": false,
+      "quandoUsar": "onboarding de agente novo ou explicação curta do fluxo",
+      "incluirTextoBrutoQuando": "o agente remoto não conhece Sema ainda"
+    },
+    {
+      "caminho": "docs/agentes-por-capacidade.md",
+      "tipo": "docs",
+      "prioridade": 11,
       "obrigatorio": false,
-      "quandoUsar": "onboarding de agente novo ou explicacao curta do fluxo",
-      "incluirTextoBrutoQuando": "o agente remoto nao conhece Sema ainda"
+      "quandoUsar": "configurar Copilot, Cline, Roo Code, OpenCode ou outro agente com disciplina variável",
+      "incluirTextoBrutoQuando": "a IA precisa entender tiers fraca/média/forte e política de idioma"
     },
     {
       "caminho": "docs/sintaxe.md",
       "tipo": "docs",
-      "prioridade": 9,
+      "prioridade": 12,
       "obrigatorio": false,
-      "quandoUsar": "duvida de gramatica, blocos ou formato do DSL",
-      "incluirTextoBrutoQuando": "a IA vai editar contrato e os exemplos nao bastam"
+      "quandoUsar": "dúvida de gramática, blocos ou formato do DSL",
+      "incluirTextoBrutoQuando": "a IA vai editar contrato e os exemplos não bastam"
     },
     {
       "caminho": "contratos/",
       "tipo": "contrato",
-      "prioridade": 10,
+      "prioridade": 13,
       "obrigatorio": true,
-      "quandoUsar": "antes de qualquer implementacao ou alteracao de comportamento",
+      "quandoUsar": "antes de qualquer implementação ou alteração de comportamento",
       "incluirTextoBrutoQuando": "a tarefa toca uma capacidade governada por contrato"
     }
   ],
@@ -126,32 +161,57 @@
     "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_BOOT.md": "a IA precisa de um boot curto, fail-closed e independente do tamanho de contexto",
+    "SEMA_SMALL_MODEL.md": "a IA tende a ignorar instruções longas ou copiar a estética ASCII da DSL",
+    "llms.txt": "a IA precisa de orientação compacta para operar o repositório",
+    "AGENT_CONTEXT_PACK.json": "a IA precisa auditar regras, proibições, 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",
+    "SEMA_BRIEF.curto.txt": "o módulo alvo ainda não está claro pelo micro",
+    "SEMA_INDEX.json": "a IA precisa mapear módulos, lacunas, riscos ou arquivos prováveis",
+    "AGENTS.md": "a IA precisa confirmar regras locais obrigatórias 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",
+    "docs/AGENT_STARTER.md": "o agente remoto não conhece Sema ainda",
+    "docs/agentes-por-capacidade.md": "a IA precisa entender tiers fraca/média/forte e política de idioma",
+    "docs/sintaxe.md": "a IA vai editar contrato e os exemplos não bastam",
     "contratos/": "a tarefa toca uma capacidade governada por contrato"
   },
   "guiaPorCapacidade": {
+    "fraca": [
+      "SEMA_BOOT.md",
+      "SEMA_SMALL_MODEL.md",
+      "agent-context-pack.json",
+      "resumo.micro.txt",
+      "briefing.min.json",
+      "resumo.curto.txt"
+    ],
     "pequena": [
+      "SEMA_BOOT.md",
+      "SEMA_SMALL_MODEL.md",
       "agent-context-pack.json",
       "resumo.micro.txt",
       "briefing.min.json",
       "resumo.curto.txt"
     ],
     "media": [
+      "SEMA_BOOT.md",
       "agent-context-pack.json",
       "resumo.curto.txt",
       "briefing.min.json",
       "drift.json",
       "resumo.md"
     ],
+    "forte": [
+      "SEMA_BOOT.md",
+      "agent-context-pack.json",
+      "README.md",
+      "resumo.md",
+      "briefing.json",
+      "drift.json",
+      "ir.json",
+      "ast.json"
+    ],
     "grande": [
+      "SEMA_BOOT.md",
       "agent-context-pack.json",
       "README.md",
       "resumo.md",
@@ -160,5 +220,112 @@
       "ir.json",
       "ast.json"
     ]
-  }
+  },
+  "aliasesCapacidade": {
+    "pequena": "fraca",
+    "grande": "forte"
+  },
+  "entrypointsClientes": [
+    {
+      "cliente": "copilot",
+      "arquivos": [
+        ".github/copilot-instructions.md",
+        "AGENTS.md",
+        "SEMA_BOOT.md"
+      ],
+      "capacidadePadrao": "media",
+      "observacao": "VS Code/Copilot deve receber uma instrução curta e repetida no arquivo próprio, sem depender só do AGENTS.md."
+    },
+    {
+      "cliente": "cline",
+      "arquivos": [
+        ".clinerules/00-sema.md",
+        ".clinerules",
+        "SEMA_BOOT.md"
+      ],
+      "capacidadePadrao": "fraca",
+      "observacao": "Cline costuma obedecer melhor quando o gate Sema vem em arquivo curto; se .clinerules for arquivo legado, o Sema atualiza esse fallback."
+    },
+    {
+      "cliente": "roo",
+      "arquivos": [
+        ".roo/rules/00-sema.md",
+        "AGENTS.md",
+        "SEMA_BOOT.md"
+      ],
+      "capacidadePadrao": "fraca",
+      "observacao": "Roo Code deve começar por uma regra dedicada em .roo/rules antes de abrir arquivos longos."
+    },
+    {
+      "cliente": "opencode",
+      "arquivos": [
+        ".opencode/instructions.md",
+        "AGENTS.md",
+        "SEMA_BOOT.md"
+      ],
+      "capacidadePadrao": "media",
+      "observacao": "OpenCode deve receber a mesma regra curta em instructions.md quando a pasta .opencode já existir."
+    },
+    {
+      "cliente": "generico",
+      "arquivos": [
+        "SEMA_BOOT.md",
+        "SEMA_SMALL_MODEL.md",
+        "AGENT_CONTEXT_PACK.json"
+      ],
+      "capacidadePadrao": "fraca",
+      "observacao": "Qualquer agente sem integração específica começa pelo boot card e só sobe contexto se passar pelos gates."
+    }
+  ],
+  "politicaIdioma": {
+    "regra": "A linguagem humana da resposta deve seguir o idioma do usuário e preservar acentos, cedilha, pontuação e símbolos esperados. A DSL .sema pode ter palavras-chave ASCII; isso não autoriza PT-BR sem acentos.",
+    "idiomaHumanoPadrao": "pt-BR quando a conversa ou o projeto estiverem em português; caso contrário, use o idioma falado pelo usuário.",
+    "preservarAcentos": true,
+    "separarDslDeTextoHumano": true,
+    "comandosESimbolos": "Não traduza comandos, nomes de arquivos, rotas, símbolos de código ou palavras-chave da DSL."
+  },
+  "politicaCodigoGovernado": {
+    "marcador": "SEMA-GOVERNED",
+    "regra": "Arquivos de código gerados ou governados pela Sema devem manter um cabeçalho curto com módulo de origem, lembrete para consultar o contrato .sema e descrição humana no idioma do usuário.",
+    "descricaoHumana": "O comentário deve orientar humanos e IAs sem duplicar o contrato inteiro dentro do código.",
+    "porCapacidade": {
+      "fraca": "Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar.",
+      "media": "Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento.",
+      "forte": "Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift e finalizar-mudanca."
+    },
+    "formatosPorAlvo": {
+      "typescript": "// SEMA-GOVERNED",
+      "javascript": "// SEMA-GOVERNED",
+      "python": "# SEMA-GOVERNED",
+      "dart": "// SEMA-GOVERNED",
+      "lua": "-- SEMA-GOVERNED",
+      "html": "<!-- SEMA-GOVERNED -->",
+      "css": "/* SEMA-GOVERNED */"
+    }
+  },
+  "politicaTimeoutResumo": {
+    "regra": "Timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `inspecionar`, `drift` ou `sync-ai-entrypoints` estourar por timeout local, aumente o timeout e tente de novo com escopo menor quando possível.",
+    "timeoutInicialSegundos": 120,
+    "escalonamentoSegundos": [
+      120,
+      300,
+      600
+    ],
+    "timeoutDoAgenteNaoEhFalhaSema": true,
+    "ateQuandoTentar": "Tente de novo com timeouts maiores enquanto houver execução disponível; se o ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.",
+    "porCapacidade": {
+      "fraca": "Se `resumo . --micro` estourar, tente `resumo <arquivo.sema> --micro`, depois repita com timeout maior. Timeout não autoriza editar.",
+      "media": "Prefira resumo escopado; se um gate Sema estourar, aumente timeout e repita antes de concluir falha.",
+      "forte": "Pode rodar projeto inteiro com timeout alto, mas deve distinguir lentidão de falha real e registrar evidência."
+    }
+  },
+  "failClosed": [
+    "Se não conseguir chamar Sema, pare e declare bloqueio em vez de editar código ou contrato.",
+    "Se não houver contrato aplicável, crie ou edite o .sema antes do código.",
+    "Se o MCP remoto não tiver projeto sincronizado, use sema_chat_contexto e sema_sync/conteúdo inline; não peça para ler C:\\GitHub\\Sema.",
+    "Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
+    "Se a resposta humana estiver em PT-BR, preserve acentos e símbolos mesmo que a DSL use ASCII.",
+    "Se um arquivo de código tiver SEMA-GOVERNED, consulte Sema e o contrato aplicável antes de editar.",
+    "Se uma chamada Sema estourar por timeout local, aumente o timeout e tente de novo; timeout do agente não libera ação sem Sema."
+  ]
 }

package/SEMA_BRIEF.curto.txt

@@ -1,11 +1,13 @@
 PROJETO: Sema
 BASE: C:\GitHub\Sema
-MODULOS: 84
+MODULOS: 85
 MODO_CODIGO: codigo_completo
 FONTES_CONCLUSAO: contrato, codigo
-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 (+78)
-TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+174)
+ENTRADA_IA: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+TIMEOUT_SEMA: Timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `inspecionar`, `drift` ou `sync-ai-entrypoints` estourar por timeout local, aumente o timeout e tente de novo com escopo menor quando possível. Escale 120s -> 300s -> 600s antes de declarar bloqueio.
+CODIGO_GOVERNADO: SEMA-GOVERNED -> docs-impacto e drift antes de alterar comportamento
+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 (+79)
+TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio, analisar_foto_original:medio, analisar_job_freela:medio, apresentar_console_admin:medio (+177)
 TOP_LACUNAS: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados, execucao_critica_sem_bloco, execucao_implicita
-TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\deploy.md, C:\GitHub\Sema\docs\documentacao.md (+104)
-GERADO_EM: 2026-06-04T04:37:43.152Z
+TOP_ARQUIVOS: C:\GitHub\Sema\deploy\caddy\sema-site.Caddyfile, C:\GitHub\Sema\docs\agentes-por-capacidade.md, C:\GitHub\Sema\docs\auth.md, C:\GitHub\Sema\docs\cli.md, C:\GitHub\Sema\docs\controle-comercial-supabase.md, C:\GitHub\Sema\docs\deploy.md (+108)
+GERADO_EM: 2026-06-05T15:14:17.230Z

package/SEMA_BRIEF.md

@@ -2,28 +2,44 @@
 
 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-06-04T04:37:43.152Z`
-- Modulos: `84`
+- Gerado em: `2026-06-05T15:14:17.230Z`
+- Modulos: `85`
 
 ## Entrada canonica para IA
 
-- Ordem minima: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md -> llms-full.txt
-- IA pequena: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
-- IA media: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
-- IA grande: llms-full.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md
+- Ordem minima: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_SMALL_MODEL.md -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md -> llms-full.txt
+- IA fraca: SEMA_BOOT.md -> SEMA_SMALL_MODEL.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
+- IA média: SEMA_BOOT.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.curto.txt -> SEMA_INDEX.json -> AGENTS.md -> README.md
+- IA forte: SEMA_BOOT.md -> llms-full.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.md -> SEMA_INDEX.json -> AGENTS.md -> README.md
+- Aliases: pequena -> fraca; grande -> forte
 
 ## Agent Context Pack
 
 - Arquivo: `AGENT_CONTEXT_PACK.json`
-- Objetivo: Dar a agentes IA uma entrada curta, estruturada e auditavel antes de abrir codigo cru ou inventar contexto.
-- Regras: 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.
-- Fontes brutas sob demanda: llms.txt, AGENT_CONTEXT_PACK.json, SEMA_BRIEF.micro.txt, SEMA_BRIEF.curto.txt, SEMA_INDEX.json, AGENTS.md, exemplos/
+- Objetivo: Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.
+- Regras: Contrato vem antes da ação. | Leia SEMA_BOOT.md antes de qualquer outro artefato de IA. | Leia AGENTS.md antes de editar código, contrato, docs operacionais, release ou deploy. | Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.
+- Fontes brutas sob demanda: SEMA_BOOT.md, SEMA_SMALL_MODEL.md, llms.txt, AGENT_CONTEXT_PACK.json, SEMA_BRIEF.micro.txt, SEMA_BRIEF.curto.txt, SEMA_INDEX.json
+
+## Código governado
+
+- Marcador: `SEMA-GOVERNED`
+- Regra: Arquivos de código gerados ou governados pela Sema devem manter um cabeçalho curto com módulo de origem, lembrete para consultar o contrato .sema e descrição humana no idioma do usuário.
+- IA fraca: Se abrir código com SEMA-GOVERNED, pare, leia SEMA_SMALL_MODEL.md e chame Sema antes de editar.
+- IA média: Se abrir código com SEMA-GOVERNED, rode docs-impacto e drift antes de alterar comportamento.
+- IA forte: Se abrir código com SEMA-GOVERNED, pode inspecionar AST/IR e código completo, mas mantém contrato primeiro, drift e finalizar-mudanca.
+
+## Timeout e retry
+
+- Regra: Timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `inspecionar`, `drift` ou `sync-ai-entrypoints` estourar por timeout local, aumente o timeout e tente de novo com escopo menor quando possível.
+- Timeout inicial para projeto inteiro: 120s
+- Escalonamento: 120s -> 300s -> 600s
+- Bloqueio: Tente de novo com timeouts maiores enquanto houver execução disponível; se o ambiente impedir continuar, pare bloqueado e não avance com código sem Sema.
 
 ## Guia por capacidade
 
-- pequena: IA gratuita ou com contexto curto. Leia so o cartao semantico e o briefing minimo. Artefatos: agent-context-pack.json, resumo.micro.txt, briefing.min.json, prompt-curto.txt.
-- media: IA com contexto medio. Aguenta resumo expandido, briefing minimo e drift. Artefatos: agent-context-pack.json, 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: agent-context-pack.json, README.md, resumo.md, briefing.json, drift.json, ir.json, ast.json.
+- fraca: IA fraca, gratuita, local pequena ou com disciplina baixa. Leia o boot card, pare cedo e chame Sema antes de agir. Artefatos: SEMA_BOOT.md, SEMA_SMALL_MODEL.md, agent-context-pack.json, resumo.micro.txt, briefing.min.json, prompt-curto.txt.
+- media: IA média. Aguenta boot, resumo expandido, briefing mínimo, drift e documentação curta. Artefatos: SEMA_BOOT.md, agent-context-pack.json, resumo.curto.txt, briefing.min.json, drift.json, prompt-curto.txt.
+- forte: IA forte, com tool use bom e contexto grande. Pode consumir o pacote completo, mas ainda deve começar pelo boot e pelos gates Sema. Artefatos: SEMA_BOOT.md, agent-context-pack.json, README.md, resumo.md, briefing.json, drift.json, ir.json, ast.json.
 
 ## Modulos
 
@@ -258,6 +274,13 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Score: 60 | Confianca: media | Risco: medio
 - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
 
+### sema.produto.geradores_codigo_governado
+- Faz: governa 1 task(s) com foco em emitir cabecalho codigo governado
+- Publico: nenhum
+- Tocar: C:\GitHub\Sema\docs\agentes-por-capacidade.md, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\gerador-css\src\index.ts, C:\GitHub\Sema\pacotes\gerador-dart\src\index.ts (+4)
+- Score: 95 | Confianca: alta | Risco: alto
+- Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
+
 ### sema.produto.geradores_web
 - Faz: governa 3 task(s) com foco em gerar contrato javascript
 - Publico: nenhum
@@ -266,17 +289,17 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
 
 ### sema.produto.governanca_ia.contexto
-- Faz: governa 3 task(s) com foco em mapear projeto sem adivinhacao
+- Faz: governa 4 task(s) com foco em mapear projeto sem adivinhacao
 - Publico: nenhum
 - Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\cli\src\projeto.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js, C:\GitHub\Sema\scripts\empacotar-cli-publica.mjs (+2)
-- Score: 82 | Confianca: alta | Risco: alto
+- Score: 91 | Confianca: alta | Risco: alto
 - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
 
 ### sema.produto.governanca_ia.documentacao
 - Faz: governa 3 task(s) com foco em resolver documentacao obrigatoria para mudanca
 - Publico: nenhum
 - Tocar: C:\GitHub\Sema\docs\documentacao.md, C:\GitHub\Sema\docs\i18n.md, C:\GitHub\Sema\docs\README.md, C:\GitHub\Sema\pacotes\cli\package.json (+4)
-- Score: 52 | Confianca: media | Risco: alto
+- Score: 95 | Confianca: alta | Risco: alto
 - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
 
 ### sema.produto.governanca_ia.drift_impacto
@@ -294,10 +317,10 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
 
 ### sema.produto.governanca_ia.exemplos
-- Faz: governa 2 task(s) com foco em materializar exemplos oficiais
+- Faz: governa 3 task(s) com foco em materializar exemplos oficiais
 - Publico: nenhum
-- Tocar: C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\pacotes\editor-vscode\extension.js
-- Score: 63 | Confianca: media | Risco: medio
+- Tocar: C:\GitHub\Sema\docs\mcp.md, C:\GitHub\Sema\mcp\src\officialExamples.ts, C:\GitHub\Sema\mcp\src\runtimeConfig.ts, C:\GitHub\Sema\mcp\src\toolsAuthorDocs.ts (+2)
+- Score: 93 | Confianca: alta | Risco: medio
 - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
 
 ### sema.produto.governanca_ia.mcp
@@ -318,7 +341,7 @@ Sema e IA-first. Este arquivo existe para IA achar o ponto de entrada do projeto
 - Faz: governa 2 task(s) com foco em verificar distribuicao publica
 - Publico: nenhum
 - Tocar: C:\GitHub\Sema\docs\refinamentos-agentes-semanticos.md, C:\GitHub\Sema\pacotes\cli\src\index.ts, C:\GitHub\Sema\scripts\verificar-distribuicao-publica.mjs
-- Score: 78 | Confianca: alta | Risco: alto
+- Score: 93 | Confianca: alta | Risco: alto
 - Lacunas: audit_ausente, auth_ausente, authz_frouxa, dados_nao_classificados (+2)
 
 ### sema.produto.governanca_ia

package/SEMA_BRIEF.micro.txt

@@ -1,9 +1,11 @@
 PROJETO: Sema
-MODULOS: 84
+MODULOS: 85
 MODO_CODIGO: codigo_completo
 FONTES_CONCLUSAO: contrato, codigo
-ENTRADA_IA: llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
-TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+81)
-TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+177)
+ENTRADA_IA: SEMA_BOOT.md -> SEMA_SMALL_MODEL.md -> llms.txt -> AGENT_CONTEXT_PACK.json -> SEMA_BRIEF.micro.txt -> SEMA_INDEX.json -> AGENTS.md
+TIMEOUT_SEMA: timeout local nao e falha; retry progressivo 120s -> 300s -> 600s; escopar arquivo se projeto inteiro for lento
+CODIGO_GOVERNADO: SEMA-GOVERNED -> chamar Sema antes de editar codigo gerado
+TOP_MODULOS: sema.produto.artes_produto, sema.produto.author.fluxos, sema.produto.author.modelos_2 (+82)
+TOP_RISCOS: adaptar_copy_multicanal:medio, altera_persistencia, analisar_drift_ferramenta:medio (+180)
 TOP_LACUNAS: audit_ausente, auth_ausente, authz_frouxa (+3)
-GERADO_EM: 2026-06-04T04:37:43.152Z
+GERADO_EM: 2026-06-05T15:14:17.230Z