@semacode/cli 1.5.55 → 2.0.0

package/README.md

@@ -1,10 +1,15 @@
 # @semacode/cli
 
-`@semacode/cli` is the public local CLI for Sema semantic governance.
+`@semacode/cli` is the public Codex-native local CLI for Sema semantic
+governance.
 
 It validates `.sema` contracts, checks semantic drift, maps impact, enforces
-documentation gates, generates starter code, and prepares AI-first context for
-agents working inside a local project folder.
+documentation gates, generates starter code, and prepares contract-first
+context for Codex inside a local project folder.
+
+Sema is an independent product and is not affiliated with or endorsed by
+OpenAI. Codex-native describes Sema's official product direction, not an
+official OpenAI program, integration, or submission.
 
 Official support: [suporte@otimitare.online](mailto:suporte@otimitare.online)
 
@@ -12,19 +17,53 @@ Official support: [suporte@otimitare.online](mailto:suporte@otimitare.online)
 
 ```bash
 npm install -g @semacode/cli
+codex plugin marketplace add gerlanss/Sema
+codex plugin add sema@sema
 ```
 
+Open a new Codex task in the target repository after installing the plugin.
+Existing tasks do not reload their plugin/skill catalog. Invoke `$sema` in the
+new task; after it creates and reads `AGENTS.md`, later tasks load that workspace
+protocol automatically.
+
 ## First Run
 
 ```bash
 sema --version
-sema preflight resumo --json
 sema resumo . --curto
 ```
 
-Public Sema is local-only. The CLI does not require external service credentials,
-does not install service keys, and does not contact external services during
-`preflight`.
+Public Sema is local-only. The CLI runs directly without a Sema login, user
+authorization, product-license check, activation key, token, credits, billing
+service, control panel, or external service credentials. The license governs
+use and redistribution; it is not a runtime activation gate.
+
+## Codex Setup
+
+`AGENTS.md` is the official Sema entrypoint for Codex:
+
+```bash
+sema sync-codex --json
+```
+
+Codex automatically loads `AGENTS.md` as durable repository guidance. See the
+[Codex `AGENTS.md` documentation](https://learn.chatgpt.com/docs/agent-configuration/agents-md).
+
+The CLI is the engine and source of truth; `AGENTS.md` is the automatic
+workspace protocol. The Sema skill is required for Codex to bootstrap a project
+that does not have Sema yet. After initialization, the skill delegates to the
+generated `AGENTS.md`. Installing this npm package never writes into
+`CODEX_HOME`; skill installation remains an explicit Codex command.
+
+## Codex-Native Architecture
+
+- `AGENTS.md` is the only official entrypoint. `sync-codex` changes only valid
+  Sema-managed blocks and preserves malformed or manual content for review.
+- Agent Context Pack consumers use schema version 6 and the fields
+  `entrypointCodex`, `codexNativo`, and `cliLocalSemAutorizacao`.
+- The Sema Codex skill is required for first contact. It initializes the
+  workspace and generates `AGENTS.md`; it does not duplicate the governed
+  workflow after that handoff.
 
 ## Local Workflow
 
@@ -42,6 +81,10 @@ If the project has no `.sema` contract, create one before implementing behavior:
 sema iniciar --template base
 ```
 
+Initialization preserves existing files and rejects symlink or junction
+escapes. Use `--force` only when overwriting the template destinations is an
+explicit human decision; the Codex bootstrap skill never adds it.
+
 ## Code Generation
 
 ```bash

package/dist/agentContext.d.ts

@@ -1,7 +1,7 @@
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
 export declare function criarEntradaCanonicaProjeto(guiaPorCapacidade: GuiaCapacidadeIaMap): {
     descricao: string;
-    ordemLeitura: ("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")[];
+    ordemLeitura: ("AGENTS.md" | "SEMA_BOOT.md" | "SEMA_SMALL_MODEL.md" | "AGENT_CONTEXT_PACK.json" | "SEMA_BRIEF.micro.txt" | "SEMA_BRIEF.curto.txt" | "SEMA_BRIEF.md" | "SEMA_INDEX.json" | "README.md")[];
     porCapacidade: {
         fraca: string[];
         pequena: string[];

package/dist/agentContext.js

@@ -4,9 +4,9 @@ import { criarAgentContextPack } from './agentContextPack.js';
 import { ALIASES_CAPACIDADE_IA, ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, ARQUIVOS_CANONICOS_IA_RAIZ, DOCUMENTOS_SUPORTE_IA, } from './agentContextTipos.js';
 export function criarEntradaCanonicaProjeto(guiaPorCapacidade) {
     const agentContextPack = criarAgentContextPack(guiaPorCapacidade);
-    const fraca = [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, 'llms.txt', ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.micro.txt', 'SEMA_INDEX.json', 'AGENTS.md'];
-    const media = [ARQUIVO_SEMA_BOOT, 'llms.txt', ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.curto.txt', 'SEMA_INDEX.json', 'AGENTS.md', 'README.md'];
-    const forte = [ARQUIVO_SEMA_BOOT, 'llms-full.txt', ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.md', 'SEMA_INDEX.json', 'AGENTS.md', 'README.md'];
+    const fraca = [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.micro.txt', 'SEMA_INDEX.json', 'AGENTS.md'];
+    const media = [ARQUIVO_SEMA_BOOT, ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.curto.txt', 'SEMA_INDEX.json', 'AGENTS.md', 'README.md'];
+    const forte = [ARQUIVO_SEMA_BOOT, ARQUIVO_AGENT_CONTEXT_PACK, 'SEMA_BRIEF.md', 'SEMA_INDEX.json', 'AGENTS.md', 'README.md'];
     return {
         descricao: 'Entrada canônica do repositório para IA. O repo não é human-first; a IA deve começar por esses artefatos antes de abrir código cru.',
         ordemLeitura: [...ARQUIVOS_CANONICOS_IA_RAIZ],

package/dist/agentContextPack.js

@@ -1,26 +1,26 @@
 // SEMA-GOVERNED: sema.produto.governanca_ia.contexto.agent_pack
 // Descrição: monta o Agent Context Pack e políticas que agentes fracos, médios e fortes consomem antes do código.
 import { LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO, LIMITE_AVISO_LINHAS_CONTRATO_SEMA, LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO, LIMITE_BLOQUEIO_LINHAS_CONTRATO_SEMA, } from './driftOrcamento.js';
-import { ALIASES_CAPACIDADE_IA, ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, EXEMPLOS_OFICIAIS_AGENT_CONTEXT, } from './agentContextTipos.js';
+import { ALIASES_CAPACIDADE_IA, ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_ENTRYPOINT_CODEX, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, EXEMPLOS_OFICIAIS_AGENT_CONTEXT, } from './agentContextTipos.js';
 export const LIMITE_CARACTERES_PAYLOAD_INLINE = 262144;
 export function criarGuiaCapacidadeIa() {
     const fraca = {
         descricao: "IA fraca, gratuita, local pequena ou com disciplina baixa. Leia o boot card, pare cedo e chame Sema antes de agir.",
-        artefatos: [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, "agent-context-pack.json", "resumo.micro.txt", "briefing.min.json", "prompt-curto.txt"],
-        ordemLeitura: [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, "agent-context-pack.json", "resumo.micro.txt", "briefing.min.json", "resumo.curto.txt"],
+        artefatos: [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, ARQUIVO_AGENT_CONTEXT_PACK, "SEMA_BRIEF.micro.txt", "SEMA_INDEX.json", "AGENTS.md"],
+        ordemLeitura: [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, ARQUIVO_AGENT_CONTEXT_PACK, "SEMA_BRIEF.micro.txt", "SEMA_INDEX.json", "AGENTS.md"],
         evitar: ["ast.json", "ir.json", "diagnosticos.json"],
     };
     const media = {
         descricao: "IA média. Aguenta boot, resumo expandido, briefing mínimo, drift e documentação curta.",
-        artefatos: [ARQUIVO_SEMA_BOOT, "agent-context-pack.json", "resumo.curto.txt", "briefing.min.json", "drift.json", "prompt-curto.txt"],
-        ordemLeitura: [ARQUIVO_SEMA_BOOT, "agent-context-pack.json", "resumo.curto.txt", "briefing.min.json", "drift.json", "resumo.md"],
+        artefatos: [ARQUIVO_SEMA_BOOT, ARQUIVO_AGENT_CONTEXT_PACK, "SEMA_BRIEF.curto.txt", "SEMA_INDEX.json", "AGENTS.md", "README.md"],
+        ordemLeitura: [ARQUIVO_SEMA_BOOT, ARQUIVO_AGENT_CONTEXT_PACK, "SEMA_BRIEF.curto.txt", "SEMA_INDEX.json", "AGENTS.md", "README.md"],
         evitar: ["ast.json"],
     };
     const forte = {
         descricao: "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: [ARQUIVO_SEMA_BOOT, "agent-context-pack.json", "README.md", "resumo.md", "briefing.json", "drift.json", "ir.json", "ast.json"],
-        ordemLeitura: [ARQUIVO_SEMA_BOOT, "agent-context-pack.json", "README.md", "resumo.md", "briefing.json", "drift.json", "ir.json", "ast.json"],
-        evitar: [],
+        artefatos: [ARQUIVO_SEMA_BOOT, ARQUIVO_AGENT_CONTEXT_PACK, "SEMA_BRIEF.md", "SEMA_INDEX.json", "AGENTS.md", "README.md"],
+        ordemLeitura: [ARQUIVO_SEMA_BOOT, ARQUIVO_AGENT_CONTEXT_PACK, "SEMA_BRIEF.md", "SEMA_INDEX.json", "AGENTS.md", "README.md"],
+        evitar: ["ast.json", "ir.json", "drift.json"],
     };
     return {
         fraca,
@@ -62,7 +62,7 @@ function criarPoliticaCodigoGovernadoAgentContext() {
 }
 function criarPoliticaTimeoutResumoAgentContext() {
     return {
-        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.",
+        regra: "Timeout definido pelo agente não é falha do Sema. Se `sema resumo`, `inspecionar`, `drift` ou `sync-codex` 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,
@@ -162,66 +162,14 @@ function criarPoliticaPlataformaAgentContext() {
         },
     };
 }
-function criarEntrypointsClientesIa() {
-    return [
-        {
-            cliente: "copilot",
-            arquivos: [".github/copilot-instructions.md", "AGENTS.md", ARQUIVO_SEMA_BOOT],
-            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", ARQUIVO_SEMA_BOOT],
-            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", ARQUIVO_SEMA_BOOT],
-            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", ARQUIVO_SEMA_BOOT],
-            capacidadePadrao: "media",
-            observacao: "OpenCode deve receber a mesma regra curta em instructions.md quando a pasta .opencode já existir.",
-        },
-        {
-            cliente: "cursor",
-            arquivos: [".cursor/rules/sema.mdc", "AGENTS.md", ARQUIVO_SEMA_BOOT],
-            capacidadePadrao: "media",
-            observacao: "Cursor deve receber uma regra curta própria para não depender de leitura completa do AGENTS.md.",
-        },
-        {
-            cliente: "claude",
-            arquivos: [".claude/CLAUDE.md", "AGENTS.md", ARQUIVO_SEMA_BOOT],
-            capacidadePadrao: "forte",
-            observacao: "Claude costuma seguir gates longos, mas ainda precisa de entrypoint explícito e repetido no workspace.",
-        },
-        {
-            cliente: "windsurf",
-            arquivos: [".windsurf/rules.md", "AGENTS.md", ARQUIVO_SEMA_BOOT],
-            capacidadePadrao: "media",
-            observacao: "Windsurf deve receber regra curta dedicada para evitar cair direto no código sem Sema.",
-        },
-        {
-            cliente: "generico",
-            arquivos: [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, ARQUIVO_AGENT_CONTEXT_PACK],
-            capacidadePadrao: "fraca",
-            observacao: "Qualquer agente sem integração específica começa pelo boot card e só sobe contexto se passar pelos gates.",
-        },
-    ];
-}
 function criarFailClosedAgentContext() {
     return [
         "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 ou vínculo semântico do arquivo, inspecione o arquivo, descubra ou crie o .sema aplicável e vincule antes do código.",
-        "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois rode sema preflight <comando> --json; só continue com use_cli_local; não use fonte externa de workspace para substituir a CLI local.",
+        "Em workspace local, rode sema --version; se falhar, pare e peça a instalação da CLI. Com a CLI disponível, opere diretamente sobre a pasta local e não substitua essa fonte por espelho externo ou inferência.",
         "Se não houver workspace local em disco, pare bloqueado e peça o fluxo apropriado; não invente caminho nem substitua a CLI local por ferramenta paralela.",
         `Se arquivos_codigo.conteudo ou conteudo inline passar de ${LIMITE_CARACTERES_PAYLOAD_INLINE} caracteres, não aumente timeout para forçar: divida por responsabilidade ou use anexo/caminho de servidor autorizado.`,
-        "Se for criar ou corrigir .sema, use sema_exemplos antes de escrever sintaxe.",
+        "Se for criar ou corrigir .sema, leia `exemplos/`; se a pasta estiver ausente, rode `sema instalar-exemplos --json` antes de escrever sintaxe.",
         "Se a resposta humana estiver em PT-BR, use vocabulário Sema canônico e preserve acentos 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 codigo governado passar de ${LIMITE_AVISO_LINHAS_CODIGO_GOVERNADO} linhas, planeje divisao; se passar de ${LIMITE_BLOQUEIO_LINHAS_CODIGO_GOVERNADO}, pare e divida antes de concluir. Documentacao Markdown nao entra nesse limite de codigo.`,
@@ -253,21 +201,13 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             tipo: "entrypoint",
             prioridade: 2,
             obrigatorio: true,
-            quandoUsar: "IA fraca, Copilot, modelo local pequeno, Cline/Roo com pouco contexto ou tarefa curta",
+            quandoUsar: "Codex operando com pouco contexto, tarefa curta ou necessidade de instrução compacta",
             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 orientação compacta para operar o repositório",
-        },
         {
             caminho: ARQUIVO_AGENT_CONTEXT_PACK,
             tipo: "entrypoint",
-            prioridade: 4,
+            prioridade: 3,
             obrigatorio: true,
             quandoUsar: "sempre antes de decidir quais documentos ou exemplos abrir",
             incluirTextoBrutoQuando: "a IA precisa auditar regras, proibições, prioridades e fontes de verdade",
@@ -275,7 +215,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "SEMA_BRIEF.micro.txt",
             tipo: "resumo",
-            prioridade: 5,
+            prioridade: 4,
             obrigatorio: true,
             quandoUsar: "IA fraca, onboarding, chat remoto ou primeiro triage",
             incluirTextoBrutoQuando: "a tarefa cabe em contexto curto",
@@ -283,7 +223,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "SEMA_BRIEF.curto.txt",
             tipo: "resumo",
-            prioridade: 6,
+            prioridade: 5,
             obrigatorio: true,
             quandoUsar: "IA média, mudança pequena ou review rápido",
             incluirTextoBrutoQuando: "o módulo alvo ainda não está claro pelo micro",
@@ -291,7 +231,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "SEMA_INDEX.json",
             tipo: "indice",
-            prioridade: 7,
+            prioridade: 6,
             obrigatorio: true,
             quandoUsar: "antes de abrir código cru ou escolher contrato alvo",
             incluirTextoBrutoQuando: "a IA precisa mapear módulos, lacunas, riscos ou arquivos prováveis",
@@ -299,7 +239,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "AGENTS.md",
             tipo: "operacional",
-            prioridade: 8,
+            prioridade: 7,
             obrigatorio: true,
             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",
@@ -307,7 +247,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "docs/commands.md",
             tipo: "docs",
-            prioridade: 9,
+            prioridade: 8,
             obrigatorio: true,
             quandoUsar: "antes de escolher comando Sema, interpretar --saida de sema compilar ou destravar Sema Codigo",
             incluirTextoBrutoQuando: "a IA precisa entender comandos, gates, saida gerada e proximo passo governado",
@@ -315,7 +255,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "exemplos/",
             tipo: "exemplos",
-            prioridade: 10,
+            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",
@@ -323,15 +263,15 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: ARQUIVO_DOC_AGENTES_CAPACIDADE,
             tipo: "docs",
-            prioridade: 11,
+            prioridade: 10,
             obrigatorio: false,
-            quandoUsar: "configurar Copilot, Cline, Roo Code, OpenCode ou outro agente com disciplina variável",
+            quandoUsar: "configurar o Codex para operar com diferentes capacidades de contexto",
             incluirTextoBrutoQuando: "a IA precisa entender tiers fraca/média/forte e política de idioma",
         },
         {
             caminho: "docs/syntax.md",
             tipo: "docs",
-            prioridade: 12,
+            prioridade: 11,
             obrigatorio: false,
             quandoUsar: "dúvida de gramática, blocos ou formato do DSL",
             incluirTextoBrutoQuando: "a IA vai editar contrato e os exemplos não bastam",
@@ -339,7 +279,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         {
             caminho: "contratos/",
             tipo: "contrato",
-            prioridade: 13,
+            prioridade: 12,
             obrigatorio: true,
             quandoUsar: "antes de qualquer implementação ou alteração de comportamento",
             incluirTextoBrutoQuando: "a tarefa toca uma capacidade governada por contrato",
@@ -347,11 +287,10 @@ export function criarAgentContextPack(guiaPorCapacidade) {
     ];
     return {
         nome: "Agent Context Pack",
-        versao: 5,
+        versao: 6,
         objetivo: "Dar a agentes IA uma entrada curta, estruturada e auditável antes de abrir código cru ou inventar contexto.",
         ordemLeitura: [
             ARQUIVO_SEMA_BOOT,
-            "llms.txt",
             ARQUIVO_AGENT_CONTEXT_PACK,
             ARQUIVO_SEMA_SMALL_MODEL,
             "SEMA_BRIEF.micro.txt",
@@ -364,9 +303,9 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             "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.",
-            "Leia docs/commands.md antes de escolher comando Sema, interpretar bloqueio do Guard ou usar --saida de sema compilar.",
-            "Em IDE local, rode sema --version; se falhar, pare. A IA não acessa o painel Sema: peça ao humano para instalar a CLI pelo painel. Depois chame sema preflight <comando> --json e use a CLI somente com use_cli_local; não use fonte externa de workspace para substituir a CLI local.",
-            "Antes de editar, chame sema_inspecionar no contrato aplicável e rode sema_drift e sema_impacto.",
+            "Leia docs/commands.md antes de escolher comando Sema, interpretar um gate ou usar --saida de sema compilar.",
+            "Em workspace local, rode sema --version; se falhar, pare e peça a instalação da CLI. Com a CLI disponível, use diretamente sema resumo, docs-impacto, inspecionar, drift e impacto sobre a pasta local.",
+            "Antes de editar, rode `sema inspecionar <contrato.sema> --json`, `sema drift <contrato.sema> --escopo modulo --json` e `sema impacto <contrato.sema> --alvo <token> --mudanca \"<descricao>\" --json`.",
             "Use exemplos oficiais antes de criar ou corrigir sintaxe .sema.",
             "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.",
@@ -388,11 +327,11 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         proibicoes: [
             "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 substituir contexto Sema por AGENTS.md, README.md, busca local, inferência pelo nome do projeto ou bom senso sem preflight/autorização Sema.",
+            "Não substituir os gates da CLI Sema por README.md, busca local, inferência pelo nome do projeto ou bom senso.",
             "Não tratar a pasta --saida de sema compilar como entrega final; entrega são os arquivos alvo/vínculos do 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 assumir repositório público, GitHub Release pública, fonte externa de workspace ou acesso da IA ao painel; em IDE local prove CLI com sema --version.",
+            "Não assumir repositório público, GitHub Release pública ou fonte externa de workspace; em ambiente local, prove a CLI com sema --version.",
             "Não usar a estética ASCII da DSL nem inglês de produto como desculpa para fugir do vocabulário Sema em PT-BR.",
             "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.",
@@ -410,7 +349,7 @@ export function criarAgentContextPack(guiaPorCapacidade) {
         ],
         prioridades: [
             "Menor artefato suficiente primeiro.",
-            "IDE local: sema --version, preflight, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare. A IA não acessa o painel Sema: peça ao humano instalar pelo painel; sem fonte externa de workspace.",
+            "Workspace local: sema --version, resumo, docs-impacto, inspecionar, drift e impacto pela CLI; se sema não existir, pare e peça a instalação da CLI.",
             "Contrato, índice e AGENTS complementam o contexto Sema; não substituem chamada Sema.",
             "Exemplos oficiais antes de nova sintaxe.",
             "Diagnóstico estruturado antes de opinião livre.",
@@ -434,7 +373,9 @@ export function criarAgentContextPack(guiaPorCapacidade) {
             grande: guiaPorCapacidade.grande.ordemLeitura,
         },
         aliasesCapacidade: { ...ALIASES_CAPACIDADE_IA },
-        entrypointsClientes: criarEntrypointsClientesIa(),
+        entrypointCodex: ARQUIVO_ENTRYPOINT_CODEX,
+        codexNativo: true,
+        cliLocalSemAutorizacao: true,
         politicaIdioma: criarPoliticaIdiomaAgentContext(),
         politicaCodigoGovernado: criarPoliticaCodigoGovernadoAgentContext(),
         politicaTimeoutResumo: criarPoliticaTimeoutResumoAgentContext(),

package/dist/agentContextTipos.d.ts

@@ -2,7 +2,7 @@ export type CapacidadeIa = "fraca" | "media" | "forte";
 export type CapacidadeIaLegada = "pequena" | "grande";
 export type ChaveGuiaCapacidadeIa = CapacidadeIa | CapacidadeIaLegada;
 export type GuiaCapacidadeIaMap = Record<ChaveGuiaCapacidadeIa, GuiaCapacidadeIa>;
-export type TipoFonteAgentContext = "entrypoint" | "resumo" | "indice" | "operacional" | "exemplos" | "docs" | "contrato" | "cliente";
+export type TipoFonteAgentContext = "entrypoint" | "resumo" | "indice" | "operacional" | "exemplos" | "docs" | "contrato";
 export interface GuiaCapacidadeIa {
     descricao: string;
     artefatos: string[];
@@ -17,12 +17,6 @@ export interface FonteAgentContextPack {
     quandoUsar: string;
     incluirTextoBrutoQuando: string;
 }
-export interface EntryPointClienteIa {
-    cliente: "copilot" | "cline" | "roo" | "opencode" | "cursor" | "claude" | "windsurf" | "generico";
-    arquivos: string[];
-    capacidadePadrao: CapacidadeIa;
-    observacao: string;
-}
 export interface PoliticaIdiomaAgentContext {
     regra: string;
     idiomaHumanoPadrao: string;
@@ -75,7 +69,9 @@ export interface AgentContextPack {
     textoBrutoSobDemanda: Record<string, string>;
     guiaPorCapacidade: Record<ChaveGuiaCapacidadeIa, string[]>;
     aliasesCapacidade: Record<CapacidadeIaLegada, CapacidadeIa>;
-    entrypointsClientes: EntryPointClienteIa[];
+    entrypointCodex: "AGENTS.md";
+    codexNativo: true;
+    cliLocalSemAutorizacao: true;
     politicaIdioma: PoliticaIdiomaAgentContext;
     politicaCodigoGovernado: PoliticaCodigoGovernadoAgentContext;
     politicaTimeoutResumo: PoliticaTimeoutResumoAgentContext;
@@ -86,8 +82,9 @@ export interface AgentContextPack {
 export declare const ARQUIVO_SEMA_BOOT = "SEMA_BOOT.md";
 export declare const ARQUIVO_SEMA_SMALL_MODEL = "SEMA_SMALL_MODEL.md";
 export declare const ARQUIVO_AGENT_CONTEXT_PACK = "AGENT_CONTEXT_PACK.json";
+export declare const ARQUIVO_ENTRYPOINT_CODEX = "AGENTS.md";
 export declare const ARQUIVO_DOC_AGENTES_CAPACIDADE = "docs/ai-integration.md";
-export declare const ARQUIVOS_CANONICOS_IA_RAIZ: readonly ["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"];
+export declare const ARQUIVOS_CANONICOS_IA_RAIZ: readonly ["SEMA_BOOT.md", "AGENT_CONTEXT_PACK.json", "SEMA_SMALL_MODEL.md", "SEMA_BRIEF.micro.txt", "SEMA_BRIEF.curto.txt", "SEMA_BRIEF.md", "SEMA_INDEX.json", "AGENTS.md", "README.md"];
 export declare const CAPACIDADES_IA_OPERACIONAIS: readonly ["fraca", "media", "forte"];
 export declare const ALIASES_CAPACIDADE_IA: Record<CapacidadeIaLegada, CapacidadeIa>;
 export declare const MARCADOR_SEMA_AGENT_ENTRYPOINT_INICIO = "<!-- sema:agent-entrypoint:start -->";

package/dist/agentContextTipos.js

@@ -1,19 +1,20 @@
 // SEMA-GOVERNED: sema.produto.governanca_ia.contexto
-// Descrição: tipos e constantes compartilhadas para entrada IA-first e entrypoints de agentes.
+// Descrição: tipos e constantes compartilhadas para a entrada IA-first nativa do Codex.
 export const ARQUIVO_SEMA_BOOT = "SEMA_BOOT.md";
 export const ARQUIVO_SEMA_SMALL_MODEL = "SEMA_SMALL_MODEL.md";
 export const ARQUIVO_AGENT_CONTEXT_PACK = "AGENT_CONTEXT_PACK.json";
+export const ARQUIVO_ENTRYPOINT_CODEX = "AGENTS.md";
 export const ARQUIVO_DOC_AGENTES_CAPACIDADE = "docs/ai-integration.md";
 export const ARQUIVOS_CANONICOS_IA_RAIZ = [
     ARQUIVO_SEMA_BOOT,
-    "llms.txt",
     ARQUIVO_AGENT_CONTEXT_PACK,
     ARQUIVO_SEMA_SMALL_MODEL,
+    "SEMA_BRIEF.micro.txt",
+    "SEMA_BRIEF.curto.txt",
     "SEMA_BRIEF.md",
     "SEMA_INDEX.json",
-    "AGENTS.md",
+    ARQUIVO_ENTRYPOINT_CODEX,
     "README.md",
-    "llms-full.txt",
 ];
 export const CAPACIDADES_IA_OPERACIONAIS = ["fraca", "media", "forte"];
 export const ALIASES_CAPACIDADE_IA = {

package/dist/agentEntryPoints.d.ts

@@ -1,13 +1,33 @@
 import { type AgentContextPack } from './agentContextTipos.js';
+export declare function listarDestinosEntrypointCodex(entrypointCodex: string): string[];
+type StatusArquivoGerenciado = "criado" | "atualizado" | "preservado" | "pendente";
 export declare function renderizarSemaBoot(agentContextPack: AgentContextPack): string;
 export declare function renderizarSemaSmallModel(agentContextPack: AgentContextPack): string;
 export declare function renderizarDocumentoAgentesPorCapacidade(agentContextPack: AgentContextPack): string;
-export declare function sincronizarEntryPointsAgentes(baseProjeto: string, agentContextPack: AgentContextPack): Promise<{
+export declare function sincronizarEntrypointCodex(baseProjeto: string, agentContextPack: AgentContextPack): Promise<{
     arquivos: Array<{
         caminho: string;
-        status: "criado" | "atualizado" | "preservado";
+        status: StatusArquivoGerenciado;
     }>;
     criados: string[];
     atualizados: string[];
     preservados: string[];
+    entrypointCodex: "AGENTS.md";
+    codexNativo: true;
+    cliLocalSemAutorizacao: true;
+    skillBootstrapCodexDocumentada: true;
+    idiomaHumanoPreservado: true;
+    retryTimeoutProgressivo: true;
+    politicaPlataformaExplicita: true;
+    politicaSinalVsRitualExplicita: true;
+    divisaoPorResponsabilidadeExplicita: true;
+    contextoLocalSemEspelho: true;
+    destinosEntrypointPrevalidados: true;
+    entrypointsLegados: Array<{
+        caminho: string;
+        status: "removido" | "atualizado" | "preservado" | "pendente";
+    }>;
+    entrypointsLegadosPendentes: string[];
+    entrypointsLegadosLimpos: boolean;
 }>;
+export {};