@semacode/cli 1.5.54 → 2.0.0

package/dist/index.part03.js

@@ -1,6 +1,3 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
-import { writeFile } from "node:fs/promises";
 import path from "node:path";
 import { temErros, } from "@sema/nucleo";
 import { carregarProjeto, } from "./projeto.js";
@@ -9,6 +6,7 @@ import { ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL
 import { criarAgentContextPack, criarGuiaCapacidadeIa } from './agentContextPack.js';
 import { criarEntradaCanonicaProjeto } from './agentContext.js';
 import { renderizarSemaBoot, renderizarSemaSmallModel, } from './agentEntryPoints.js';
+import { escreverArquivoWorkspaceSeguro, validarDestinosEscritaWorkspace } from './workspaceWrite.js';
 import { resumirListaTexto } from './textoListas.js';
 import { coletarResumoSemanticoModulo, criarBriefingMinimo, criarPromptCurtoModulo, renderizarResumoModuloMarkdown, renderizarResumoModuloTexto } from "./index.part02.js";
 export function renderizarResumoProjetoMarkdown(geradoEm, modulos, guiaPorCapacidade) {
@@ -325,6 +323,16 @@ export async function carregarContextoModuloIa(arquivoEntrada) {
         briefing,
     };
 }
+export const ARQUIVOS_RESUMO_MODULO_IA = [
+    ARQUIVO_SEMA_BOOT,
+    ARQUIVO_SEMA_SMALL_MODEL,
+    "agent-context-pack.json",
+    "resumo.micro.txt",
+    "resumo.curto.txt",
+    "resumo.md",
+    "briefing.min.json",
+    "prompt-curto.txt",
+];
 export async function gerarArquivosResumoModuloIa(contexto, pastaBase) {
     const guiaPorCapacidade = criarGuiaCapacidadeIa();
     const resumoSemantico = coletarResumoSemanticoModulo(contexto);
@@ -336,16 +344,22 @@ export async function gerarArquivosResumoModuloIa(contexto, pastaBase) {
     const agentContextPack = criarAgentContextPack(guiaPorCapacidade);
     const semaBoot = renderizarSemaBoot(agentContextPack);
     const semaSmallModel = renderizarSemaSmallModel(agentContextPack);
-    await writeFile(path.join(pastaBase, ARQUIVO_SEMA_BOOT), semaBoot, "utf8");
-    await writeFile(path.join(pastaBase, ARQUIVO_SEMA_SMALL_MODEL), semaSmallModel, "utf8");
-    await writeFile(path.join(pastaBase, "agent-context-pack.json"), `${JSON.stringify(agentContextPack, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaBase, "resumo.micro.txt"), resumoMicro, "utf8");
-    await writeFile(path.join(pastaBase, "resumo.curto.txt"), resumoCurto, "utf8");
-    await writeFile(path.join(pastaBase, "resumo.md"), resumoMarkdown, "utf8");
-    await writeFile(path.join(pastaBase, "briefing.min.json"), `${JSON.stringify(briefingMinimo, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaBase, "prompt-curto.txt"), promptCurto, "utf8");
+    const artefatos = [
+        { caminhoRelativo: ARQUIVO_SEMA_BOOT, conteudo: semaBoot },
+        { caminhoRelativo: ARQUIVO_SEMA_SMALL_MODEL, conteudo: semaSmallModel },
+        { caminhoRelativo: "agent-context-pack.json", conteudo: `${JSON.stringify(agentContextPack, null, 2)}\n` },
+        { caminhoRelativo: "resumo.micro.txt", conteudo: resumoMicro },
+        { caminhoRelativo: "resumo.curto.txt", conteudo: resumoCurto },
+        { caminhoRelativo: "resumo.md", conteudo: resumoMarkdown },
+        { caminhoRelativo: "briefing.min.json", conteudo: `${JSON.stringify(briefingMinimo, null, 2)}\n` },
+        { caminhoRelativo: "prompt-curto.txt", conteudo: promptCurto },
+    ];
+    await validarDestinosEscritaWorkspace(pastaBase, artefatos.map((artefato) => artefato.caminhoRelativo));
+    for (const artefato of artefatos) {
+        await escreverArquivoWorkspaceSeguro(pastaBase, artefato.caminhoRelativo, artefato.conteudo, { sobrescrever: true });
+    }
     return {
-        artefatosCompactos: [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, "agent-context-pack.json", "resumo.micro.txt", "resumo.curto.txt", "resumo.md", "briefing.min.json", "prompt-curto.txt"],
+        artefatosCompactos: [...ARQUIVOS_RESUMO_MODULO_IA],
         guiaPorCapacidade,
     };
 }

package/dist/index.part04.d.ts

@@ -1,5 +1,6 @@
 import { type GuiaCapacidadeIaMap } from './agentContextTipos.js';
 import { ContextoIaGerado, ResumoSemanticoModuloIa } from "./index.part01.js";
+export declare const ARQUIVOS_RESUMO_PROJETO_IA: readonly ["SEMA_BOOT.md", "SEMA_SMALL_MODEL.md", "SEMA_BRIEF.md", "SEMA_BRIEF.micro.txt", "SEMA_BRIEF.curto.txt", "SEMA_INDEX.json", "AGENT_CONTEXT_PACK.json", "docs/ai-integration.md"];
 export declare function gerarResumoProjetoIa(entrada: string | undefined, pastaSaidaOpcional?: string, escreverNaRaiz?: boolean): Promise<{
     geradoEm: string;
     baseProjeto: string;

package/dist/index.part04.js

@@ -1,6 +1,6 @@
-// SEMA-GOVERNED: sema.governanca_ia_contexto
-// Descricao: CLI particionada; consulte contratos/sema/governanca_ia_contexto.sema antes de editar.
-import { mkdir, writeFile } from "node:fs/promises";
+// SEMA-GOVERNED: sema.governanca_ia_contexto, sema.produto.escrita_segura_workspace
+// Descrição: gera contexto local e grava artefatos somente dentro da base validada.
+import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import { formatarDiagnosticos, gerarRespostaValidacao, temErros, } from "@sema/nucleo";
 import { carregarProjeto, } from "./projeto.js";
@@ -11,13 +11,24 @@ import { ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE, ARQUIVO_SEM
 import { criarGuiaCapacidadeIa, LIMITE_CARACTERES_PAYLOAD_INLINE } from './agentContextPack.js';
 import { criarEntradaCanonicaProjeto } from './agentContext.js';
 import { renderizarDocumentoAgentesPorCapacidade, renderizarSemaBoot, renderizarSemaSmallModel, } from './agentEntryPoints.js';
+import { escreverArquivoWorkspaceSeguro, validarDestinosEscritaWorkspace } from './workspaceWrite.js';
 import { carregarModulos } from './carregarModulos.js';
 import { obterOpcao, obterOpcoesRepetidas, possuiFlag } from './cliArgs.js';
 import { resumirListaTexto, unicosOrdenados } from './textoListas.js';
 import { EXTENSOES_CODIGO, listarArquivosRecursivosLimitado } from './projetoBusca.js';
 import { VERSAO_CLI } from "./index.part01.js";
 import { coletarResumoSemanticoModulo, descreverFontesConclusao, detectarFontesConclusaoSnapshot, detectarModoVerificacaoCodigo } from "./index.part02.js";
-import { carregarContextoModuloIa, criarBriefingAgente, gerarArquivosResumoModuloIa, renderizarResumoProjetoMarkdown, resumirDriftPorModulo } from "./index.part03.js";
+import { ARQUIVOS_RESUMO_MODULO_IA, carregarContextoModuloIa, criarBriefingAgente, gerarArquivosResumoModuloIa, renderizarResumoProjetoMarkdown, resumirDriftPorModulo } from "./index.part03.js";
+export const ARQUIVOS_RESUMO_PROJETO_IA = [
+    ARQUIVO_SEMA_BOOT,
+    ARQUIVO_SEMA_SMALL_MODEL,
+    "SEMA_BRIEF.md",
+    "SEMA_BRIEF.micro.txt",
+    "SEMA_BRIEF.curto.txt",
+    "SEMA_INDEX.json",
+    ARQUIVO_AGENT_CONTEXT_PACK,
+    ARQUIVO_DOC_AGENTES_CAPACIDADE,
+];
 async function listarTopArquivosCodigoDetectados(diretoriosCodigo, limite = 24) {
     const encontrados = new Set();
     for (const diretorio of diretoriosCodigo.sort((a, b) => a.localeCompare(b, "pt-BR"))) {
@@ -148,21 +159,26 @@ export async function gerarResumoProjetoIa(entrada, pastaSaidaOpcional, escrever
         `GERADO_EM: ${geradoEm}`,
         "",
     ].join("\n");
-    await writeFile(path.join(pastaSaida, "SEMA_BRIEF.md"), semaBrief, "utf8");
-    await writeFile(path.join(pastaSaida, ARQUIVO_SEMA_BOOT), semaBoot, "utf8");
-    await writeFile(path.join(pastaSaida, ARQUIVO_SEMA_SMALL_MODEL), semaSmallModel, "utf8");
-    await writeFile(path.join(pastaSaida, "SEMA_BRIEF.micro.txt"), micro, "utf8");
-    await writeFile(path.join(pastaSaida, "SEMA_BRIEF.curto.txt"), curto, "utf8");
-    await writeFile(path.join(pastaSaida, "SEMA_INDEX.json"), `${JSON.stringify(indexJson, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaSaida, ARQUIVO_AGENT_CONTEXT_PACK), `${JSON.stringify(agentContextPack, null, 2)}\n`, "utf8");
-    await mkdir(path.dirname(path.join(pastaSaida, ARQUIVO_DOC_AGENTES_CAPACIDADE)), { recursive: true });
-    await writeFile(path.join(pastaSaida, ARQUIVO_DOC_AGENTES_CAPACIDADE), docAgentesCapacidade, "utf8");
+    const artefatosResumo = [
+        { caminhoRelativo: "SEMA_BRIEF.md", conteudo: semaBrief },
+        { caminhoRelativo: ARQUIVO_SEMA_BOOT, conteudo: semaBoot },
+        { caminhoRelativo: ARQUIVO_SEMA_SMALL_MODEL, conteudo: semaSmallModel },
+        { caminhoRelativo: "SEMA_BRIEF.micro.txt", conteudo: micro },
+        { caminhoRelativo: "SEMA_BRIEF.curto.txt", conteudo: curto },
+        { caminhoRelativo: "SEMA_INDEX.json", conteudo: `${JSON.stringify(indexJson, null, 2)}\n` },
+        { caminhoRelativo: ARQUIVO_AGENT_CONTEXT_PACK, conteudo: `${JSON.stringify(agentContextPack, null, 2)}\n` },
+        { caminhoRelativo: ARQUIVO_DOC_AGENTES_CAPACIDADE, conteudo: docAgentesCapacidade },
+    ];
+    await validarDestinosEscritaWorkspace(pastaSaida, artefatosResumo.map((artefato) => artefato.caminhoRelativo));
+    for (const artefato of artefatosResumo) {
+        await escreverArquivoWorkspaceSeguro(pastaSaida, artefato.caminhoRelativo, artefato.conteudo, { sobrescrever: true });
+    }
     return {
         geradoEm,
         baseProjeto,
         pastaSaida,
         modoVerificacaoCodigo,
-        artefatos: [ARQUIVO_SEMA_BOOT, ARQUIVO_SEMA_SMALL_MODEL, "SEMA_BRIEF.md", "SEMA_BRIEF.micro.txt", "SEMA_BRIEF.curto.txt", "SEMA_INDEX.json", ARQUIVO_AGENT_CONTEXT_PACK, ARQUIVO_DOC_AGENTES_CAPACIDADE],
+        artefatos: [...ARQUIVOS_RESUMO_PROJETO_IA],
         modulos,
         guiaPorCapacidade,
     };
@@ -173,12 +189,22 @@ export async function gerarContextoIa(arquivoEntrada, pastaSaidaOpcional) {
         ? path.resolve(pastaSaidaOpcional)
         : path.resolve(process.cwd(), ".tmp", "contexto-ia", path.basename(contexto.arquivo, ".sema"));
     await mkdir(pastaBase, { recursive: true });
-    await writeFile(path.join(pastaBase, "validar.json"), `${JSON.stringify(contexto.validar, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaBase, "diagnosticos.json"), `${JSON.stringify(contexto.diagnosticosJson, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaBase, "ast.json"), `${JSON.stringify(contexto.ast, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaBase, "ir.json"), `${JSON.stringify(contexto.irJson, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaBase, "drift.json"), `${JSON.stringify(contexto.drift, null, 2)}\n`, "utf8");
-    await writeFile(path.join(pastaBase, "briefing.json"), `${JSON.stringify(contexto.briefing, null, 2)}\n`, "utf8");
+    const artefatosContexto = [
+        { caminhoRelativo: "validar.json", conteudo: `${JSON.stringify(contexto.validar, null, 2)}\n` },
+        { caminhoRelativo: "diagnosticos.json", conteudo: `${JSON.stringify(contexto.diagnosticosJson, null, 2)}\n` },
+        { caminhoRelativo: "ast.json", conteudo: `${JSON.stringify(contexto.ast, null, 2)}\n` },
+        { caminhoRelativo: "ir.json", conteudo: `${JSON.stringify(contexto.irJson, null, 2)}\n` },
+        { caminhoRelativo: "drift.json", conteudo: `${JSON.stringify(contexto.drift, null, 2)}\n` },
+        { caminhoRelativo: "briefing.json", conteudo: `${JSON.stringify(contexto.briefing, null, 2)}\n` },
+    ];
+    await validarDestinosEscritaWorkspace(pastaBase, [
+        ...artefatosContexto.map((artefato) => artefato.caminhoRelativo),
+        ...ARQUIVOS_RESUMO_MODULO_IA,
+        "README.md",
+    ]);
+    for (const artefato of artefatosContexto) {
+        await escreverArquivoWorkspaceSeguro(pastaBase, artefato.caminhoRelativo, artefato.conteudo, { sobrescrever: true });
+    }
     const resumoGerado = await gerarArquivosResumoModuloIa(contexto, pastaBase);
     const resumo = `# Contexto de IA para ${contexto.modulo}
 
@@ -277,7 +303,9 @@ Antes de escolher arquivo de código, leia \`${ARQUIVO_SEMA_BOOT}\` e \`agent-co
 - \`sema prompt-curto "${contexto.arquivo}" --para mudanca\`
 - \`sema prompt-ia\`
 `;
-    await writeFile(path.join(pastaBase, "README.md"), resumo, "utf8");
+    await escreverArquivoWorkspaceSeguro(pastaBase, "README.md", resumo, {
+        sobrescrever: true,
+    });
     return {
         sucesso: contexto.sucesso,
         arquivo: contexto.arquivo,

package/dist/index.part05.js

@@ -178,7 +178,7 @@ export async function comandoDrift(entrada, args, emJson, cwd = process.cwd()) {
 export async function comandoImpacto(entrada, args, emJson, cwd = process.cwd()) {
     const alvoSemantico = obterOpcao(args, "--alvo");
     if (!alvoSemantico) {
-        console.error("Uso: sema impacto <arquivo-ou-pasta> --alvo <token-semântico> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]");
+        console.error("Uso: sema impacto <arquivo-ou-pasta> --alvo <token-semântico> [--mudanca <descricao>] [--escopo <arquivo|modulo|projeto>] [--incluir-worktrees] [--incluir-consumidores-laterais] [--json]");
         return 1;
     }
     const contextoProjeto = await carregarProjeto(entrada, cwd);

package/dist/index.part06.d.ts

@@ -4,7 +4,7 @@ export declare function comandoCompilar(entrada: string | undefined, alvo: AlvoG
 export declare function comandoDiagnosticos(arquivo: string, emJson: boolean): Promise<number>;
 export declare function comandoFormatar(entrada: string | undefined, verificarApenas: boolean, emJson: boolean): Promise<number>;
 export declare function comandoStarterIa(): Promise<number>;
-export declare function comandoSyncAiEntrypoints(emJson: boolean): Promise<number>;
+export declare function comandoSyncCodex(emJson: boolean): Promise<number>;
 export declare function comandoAjudaIa(): Promise<number>;
 export declare function comandoPromptIa(): Promise<number>;
 export declare function comandoPromptIaUi(): Promise<number>;

package/dist/index.part06.js

@@ -6,7 +6,7 @@ import { compilarCodigo, formatarCodigo, formatarDiagnosticos, lerArquivoTexto,
 import { carregarProjeto, } from "./projeto.js";
 import { ARQUIVOS_CANONICOS_IA_RAIZ, } from './agentContextTipos.js';
 import { criarGuiaCapacidadeIa } from './agentContextPack.js';
-import { sincronizarEntryPointsAgentes, } from './agentEntryPoints.js';
+import { sincronizarEntrypointCodex, } from './agentEntryPoints.js';
 import { escreverArquivos, formatarAvisoArtefatosGeradosAcimaDoLimite, } from './fsGovernado.js';
 import { materializarExemplosOficiais } from './exemplosOficiais.js';
 import { carregarModulos } from './carregarModulos.js';
@@ -120,13 +120,13 @@ export async function comandoStarterIa() {
     console.log(STARTER_IA);
     return 0;
 }
-export async function comandoSyncAiEntrypoints(emJson) {
+export async function comandoSyncCodex(emJson) {
     const resumoProjeto = await gerarResumoProjetoIa(process.cwd(), undefined, true);
     const exemplos = await materializarExemplosOficiais(resumoProjeto.baseProjeto, true);
     if (!exemplos.sucesso) {
         if (emJson) {
             console.log(JSON.stringify({
-                comando: "sync-ai-entrypoints",
+                comando: "sync-codex",
                 sucesso: false,
                 baseProjeto: resumoProjeto.baseProjeto,
                 erro: exemplos.erro,
@@ -138,34 +138,43 @@ export async function comandoSyncAiEntrypoints(emJson) {
         return 1;
     }
     const indexJson = JSON.parse(await readFile(path.join(resumoProjeto.pastaSaida, "SEMA_INDEX.json"), "utf8"));
-    const entrypointsClientes = await sincronizarEntryPointsAgentes(resumoProjeto.baseProjeto, indexJson.agentContextPack);
+    const resultadosCodex = await sincronizarEntrypointCodex(resumoProjeto.baseProjeto, indexJson.agentContextPack);
     const artefatos = [...new Set([
             ...ARQUIVOS_CANONICOS_IA_RAIZ,
             ...resumoProjeto.artefatos,
-            ...entrypointsClientes.arquivos.map((item) => item.caminho),
+            ...resultadosCodex.arquivos.map((item) => item.caminho),
             "exemplos",
         ])];
+    const sucesso = resultadosCodex.entrypointsLegadosLimpos;
     if (emJson) {
         console.log(JSON.stringify({
-            comando: "sync-ai-entrypoints",
-            sucesso: true,
+            comando: "sync-codex",
+            sucesso,
+            erro: sucesso ? undefined : "Entrypoints legados com conteudo Sema incompleto ou sem bloco gerenciado exigem revisao manual.",
             baseProjeto: resumoProjeto.baseProjeto,
             pastaSaida: resumoProjeto.pastaSaida,
             artefatos,
             entradaCanonica: indexJson.entradaCanonica,
-            entrypointsClientes,
+            resultadosCodex,
             exemplos,
         }, null, 2));
-        return 0;
+        return sucesso ? 0 : 1;
+    }
+    if (!sucesso) {
+        console.error("Entrypoints legados pendentes de revisao manual:");
+        for (const caminho of resultadosCodex.entrypointsLegadosPendentes) {
+            console.error(`- ${caminho}`);
+        }
+        return 1;
     }
-    console.log("Entrypoints IA-first sincronizados");
+    console.log("Entrypoint do Codex sincronizado");
     console.log("");
     console.log(`Base do projeto: ${resumoProjeto.baseProjeto}`);
     console.log(`Ordem canônica: ${indexJson.entradaCanonica.ordemLeitura.join(" -> ")}`);
     console.log(`IA fraca: ${indexJson.entradaCanonica.porCapacidade.fraca.join(" -> ")}`);
     console.log(`IA média: ${indexJson.entradaCanonica.porCapacidade.media.join(" -> ")}`);
     console.log(`IA forte: ${indexJson.entradaCanonica.porCapacidade.forte.join(" -> ")}`);
-    console.log(`Clientes: ${entrypointsClientes.criados.length} criados, ${entrypointsClientes.atualizados.length} atualizados, ${entrypointsClientes.preservados.length} preservados`);
+    console.log(`Codex: ${resultadosCodex.criados.length} criados, ${resultadosCodex.atualizados.length} atualizados, ${resultadosCodex.preservados.length} preservados`);
     console.log(`Exemplos oficiais: ${exemplos.criados.length} criados, ${exemplos.preservados.length} preservados em ${exemplos.destino}`);
     return 0;
 }
@@ -187,16 +196,16 @@ export async function comandoAjudaIa() {
     ]));
     console.log("");
     console.log(renderizarSecaoAscii("Capacidade de IA", [
-        "fraca: `sema resumo --micro`, `briefing.min.json`, `prompt-curto.txt`",
-        "média: `sema resumo --curto`, `drift.json`, `briefing.min.json`",
-        "forte: `sema contexto-ia`, `briefing.json`, `ir.json`, `ast.json`",
+        "fraca: `sema resumo <arquivo> --micro --json` usa stdout compacto",
+        "média: `sema resumo <arquivo> --curto --json` + `sema drift <arquivo> --json`",
+        "forte: `sema contexto-ia <arquivo.sema> --saida <diretorio> --json` materializa o pacote completo",
     ]));
     console.log("");
     console.log(renderizarSecaoAscii("Fluxo recomendado", [
         "Use `sema starter-ia` para um texto curto de onboarding.",
-        "Use `sema sync-ai-entrypoints` para regenerar `AGENT_CONTEXT_PACK.json`, `SEMA_BRIEF.*` e `SEMA_INDEX.json` na raiz.",
+        "Use `sema sync-codex` para regenerar o contexto governado do Codex na raiz.",
         "Use `sema instalar-exemplos` para materializar `exemplos/` oficiais sem sobrescrever arquivos locais.",
-        "Use `sema resumo <arquivo> --micro --para onboarding` para IA fraca.",
+        "Use `sema resumo <arquivo> --micro --para onboarding --json` para IA fraca; o resumo vem no stdout.",
         "Se `sema resumo` ou outro gate estourar timeout local, aumente o timeout e tente de novo; timeout do agente nao e falha do Sema.",
         "Use `sema prompt-curto <arquivo> --curto --para mudanca` para colar contexto em modelo gratuito.",
         "Use `sema prompt-ia`, `sema prompt-ia-ui`, `sema prompt-ia-react` e `sema prompt-ia-sema-primeiro` conforme a tarefa.",
@@ -205,8 +214,8 @@ export async function comandoAjudaIa() {
         "Use `sema drift` para medir impls, vinculos, rotas, score e lacunas.",
         "Use `sema docs-impacto --intencao <acao>` para ler ou criar docs obrigatorias antes de agir.",
         "Use `sema finalizar-mudanca --intencao <acao>` para bloquear conclusao sem leitura documental comprovada.",
-        "Use `sema contexto-ia <arquivo.sema>` para gerar AST, IR, drift, `briefing.json` e `briefing.min.json`.",
-        "Use `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|dart|lua|javascript|html|css> --saida <diretorio>` quando a tarefa pedir codigo derivado.",
+        "Use `sema contexto-ia <arquivo.sema> --saida <diretorio> --json` para gerar AST, IR, drift, `briefing.json` e `briefing.min.json`.",
+        "Use `sema compilar <arquivo-ou-pasta> --alvo <typescript|python|php|dart|lua|javascript|html|css> --saida <diretorio>` quando a tarefa pedir codigo derivado.",
     ]));
     console.log("");
     console.log(renderizarSecaoAscii("Regras praticas", [
@@ -218,7 +227,7 @@ export async function comandoAjudaIa() {
         "Se o projeto ja existe, trate `importar` como rascunho e `drift` como juiz.",
         "IA fraca comeca no menor artefato que resolve a tarefa; nao enfie `ast.json` inteiro nela de bobeira.",
         "Timeout local e so limite do agente: escale e tente de novo antes de chamar Sema de inativo.",
-        "Antes de editar software vivo, leia `briefing.min.json` ou `briefing.json` em vez de sair cavando arquivo na fe.",
+        "Antes de editar software vivo, rode os gates locais; se precisar do pacote materializado, gere-o com `sema contexto-ia ... --saida <diretorio>` antes de ler `briefing.min.json` ou `briefing.json`.",
         "Trate `route`, `worker`, `evento`, `fila`, `cron`, `webhook`, `cache`, `storage` e `policy` como superficies de primeira classe.",
     ]));
     return 0;

package/dist/index.part07.js

@@ -6,7 +6,7 @@ import { compilarCodigo, formatarDiagnosticos, lerArquivoTexto, temErros, } from
 import { carregarProjeto, resolverAlvosVerificacao, } from "./projeto.js";
 import { escreverArquivos, formatarAvisoArtefatosGeradosAcimaDoLimite, } from './fsGovernado.js';
 import { obterOpcao } from './cliArgs.js';
-import { avaliarPreflightVerificacao, imprimirPreflightVerificacao } from './doctorCommand.js';
+import { avaliarDependenciasVerificacao, imprimirFalhaDependenciasVerificacao } from './doctorCommand.js';
 import { aplicarEstruturaSaida, executarTestesGerados, executarTestesParaVerificacao, gerarArquivosPorAlvo, garantirIr, nomeSubpastaModulo, resolverConfiguracaoVerificacaoPorAlvo, validarCompatibilidadeFramework, } from './geracaoCore.js';
 import { normalizarModoResumo, normalizarTamanhoResumo } from "./index.part01.js";
 import { carregarContextoModuloIa } from "./index.part03.js";
@@ -45,27 +45,27 @@ export async function comandoPromptCurto(entrada, args, emJson) {
             : "SEMA_BRIEF.md";
     const contextoProjeto = await readFile(path.join(resumoProjeto.pastaSaida, arquivoResumo), "utf8");
     const capacidade = tamanho === "micro" ? "fraca" : tamanho === "curto" ? "media" : "forte";
-    const prompt = `⚠️ REGRA OBRIGATÓRIA DE GOVERNANÇA:
+    const prompt = `⚠️ REGRA OBRIGATÓRIA DE GOVERNANÇA:
 
-ANTES DE QUALQUER AÇÃO (editar, criar, deletar, executar, consultar, modificar):
-1. Chame sema_docs_impacto com sua intenção declarada
-2. Aguarde a resposta com as docs obrigatórias
-3. Leia as docs antes de agir
-4. Use sema_finalizar_mudanca para comprovar que leu as docs
+ANTES DE QUALQUER AÇÃO (editar, criar, deletar, executar, consultar ou modificar):
+1. Rode \`sema docs-impacto --intencao "<ação>" --json\` com sua intenção declarada.
+2. Aguarde a resposta com as docs obrigatórias.
+3. Leia as docs antes de agir.
+4. Antes de concluir, rode \`sema finalizar-mudanca --intencao "<ação>" --doc-lida <arquivo> --json\` com todas as docs lidas.
 
-Você está operando Sema em modo IA-first.
+Você está operando Sema em modo IA-first.
 
-Isto e contexto comprimido para IA operar contrato semantico antes de tocar codigo vivo.
+Isto é contexto comprimido para IA operar contrato semântico antes de tocar código vivo.
 
 Capacidade alvo: ${capacidade}
 Modo da tarefa: ${modo}
 
 Regras:
-- ANTES DE TUDO: chame sema_docs_impacto com sua intenção declarada
-- comece pelo resumo compacto abaixo
-- se a tarefa pedir mais contexto, abra \`AGENT_CONTEXT_PACK.json\` e depois \`SEMA_INDEX.json\`
-- nao tente ler o repo inteiro se o resumo ja disser onde tocar
-- preserve contrato, risco, lacuna e checks sugeridos
+- ANTES DE TUDO: rode \`sema docs-impacto --intencao "<ação>" --json\`.
+- Comece pelo resumo compacto abaixo.
+- Se a tarefa pedir mais contexto, abra \`AGENT_CONTEXT_PACK.json\` e depois \`SEMA_INDEX.json\`.
+- Não tente ler o repositório inteiro se o resumo já disser onde tocar.
+- Preserve contrato, risco, lacuna e checks sugeridos.
 
 Contexto do projeto:
 ${contextoProjeto.trim()}
@@ -157,9 +157,9 @@ export async function comandoVerificar(entrada, baseSaida, cwd = process.cwd())
         console.error(incompatibilidade.incompatibilidade);
         return 1;
     }
-    const preflight = avaliarPreflightVerificacao(configuracoesAlvo);
-    if (!preflight.ok) {
-        imprimirPreflightVerificacao(preflight);
+    const verificacaoDependencias = avaliarDependenciasVerificacao(configuracoesAlvo);
+    if (!verificacaoDependencias.ok) {
+        imprimirFalhaDependenciasVerificacao(verificacaoDependencias);
         return 1;
     }
     const resumos = [];
@@ -235,13 +235,13 @@ export async function comandoVerificarJson(entrada, baseSaida, cwd = process.cwd
         }, null, 2));
         return 1;
     }
-    const preflight = avaliarPreflightVerificacao(configuracoesAlvo);
-    if (!preflight.ok) {
+    const verificacaoDependencias = avaliarDependenciasVerificacao(configuracoesAlvo);
+    if (!verificacaoDependencias.ok) {
         console.log(JSON.stringify({
             comando: "verificar",
             sucesso: false,
             erro: "Dependencias obrigatorias ausentes para executar a verificacao.",
-            preflight,
+            dependencias: verificacaoDependencias,
             modulos: [],
             totais: { modulos: 0, alvos: 0, arquivos: 0, testes: 0 },
         }, null, 2));

package/dist/index.part08.js

@@ -3,7 +3,6 @@
 import path from "node:path";
 import { carregarConfiguracaoProjeto, resolverAlvoPadrao, resolverEstruturaSaidaPadrao, resolverFrameworkPadrao, resolverSaidaPadrao, } from "./projeto.js";
 import { REGISTRO_COMANDOS } from "./comandos.js";
-import * as billing from "./billing/index.js";
 import { comandoIniciar, comandoInstalarExemplos } from './initCommand.js';
 import { obterOpcao, obterPosicionais, possuiFlag } from './cliArgs.js';
 import { comandoAuthor, comandoProfile, criarPayloadRulePacks, normalizarProfileGovernanca, renderizarRulePacksTexto } from './profileAuthorCommand.js';
@@ -12,7 +11,7 @@ import { normalizarFonteImportacao, normalizarTemplateIniciar, } from './geracao
 import { VERSAO_CLI, ajuda, obterArgumentos } from "./index.part01.js";
 import { comandoDocsImpacto, comandoFinalizarMudanca, comandoValidar, comandoValidarJson } from "./index.part04.js";
 import { comandoAst, comandoAstJson, comandoDrift, comandoImpacto, comandoImportar, comandoInspecionar, comandoIr, comandoIrJson, comandoRenomearSemantico } from "./index.part05.js";
-import { comandoAjudaIa, comandoCompilar, comandoDiagnosticos, comandoExemplosPromptIa, comandoFormatar, comandoPromptIa, comandoPromptIaReact, comandoPromptIaSemaPrimeiro, comandoPromptIaUi, comandoResumo, comandoStarterIa, comandoSyncAiEntrypoints } from "./index.part06.js";
+import { comandoAjudaIa, comandoCompilar, comandoDiagnosticos, comandoExemplosPromptIa, comandoFormatar, comandoPromptIa, comandoPromptIaReact, comandoPromptIaSemaPrimeiro, comandoPromptIaUi, comandoResumo, comandoStarterIa, comandoSyncCodex } from "./index.part06.js";
 import { comandoContextoIa, comandoPromptCurto, comandoTestar, comandoVerificar, comandoVerificarJson } from "./index.part07.js";
 export async function principal() {
     const { comando, resto } = obterArgumentos();
@@ -36,7 +35,7 @@ export async function principal() {
     }
     switch (comando) {
         case "iniciar":
-            codigoSaida = await comandoIniciar(cwd, normalizarTemplateIniciar(obterOpcao(resto, "--template")));
+            codigoSaida = await comandoIniciar(cwd, normalizarTemplateIniciar(obterOpcao(resto, "--template")), { force: possuiFlag(resto, "--force") });
             break;
         case "author":
             codigoSaida = await comandoAuthor(posicionais, resto, possuiFlag(resto, "--json"));
@@ -140,15 +139,12 @@ export async function principal() {
         case "starter-ia":
             codigoSaida = await comandoStarterIa();
             break;
-        case "sync-ai-entrypoints":
-            codigoSaida = await comandoSyncAiEntrypoints(possuiFlag(resto, "--json"));
+        case "sync-codex":
+            codigoSaida = await comandoSyncCodex(possuiFlag(resto, "--json"));
             break;
         case "instalar-exemplos":
             codigoSaida = await comandoInstalarExemplos(possuiFlag(resto, "--json"));
             break;
-        case "preflight":
-            codigoSaida = await billing.comandoPreflightCli(resto, possuiFlag(resto, "--json"));
-            break;
         case "docs-impacto":
             codigoSaida = await comandoDocsImpacto(posicionais, resto, possuiFlag(resto, "--json"));
             break;

package/dist/initCommand.d.ts

@@ -1,3 +1,5 @@
 import { type TemplateIniciar } from "./initTemplatesBase.js";
-export declare function comandoIniciar(cwd: string, template: TemplateIniciar): Promise<number>;
+export declare function comandoIniciar(cwd: string, template: TemplateIniciar, opcoes?: {
+    force?: boolean;
+}): Promise<number>;
 export declare function comandoInstalarExemplos(emJson: boolean): Promise<number>;

package/dist/initCommand.js

@@ -1,40 +1,69 @@
-// SEMA-GOVERNED
-// M?dulo: sema.produto.orcamento_semantico
-// Contrato: contratos/sema/orcamento_semantico.sema
-// Descri??o: comandos de inicializa??o de projeto e sincroniza??o de exemplos oficiais da CLI.
+// SEMA-GOVERNED: sema.produto.cli_init_templates, sema.produto.escrita_segura_workspace
+// Descrição: inicializa projetos preservando arquivos existentes e bloqueando escapes do workspace.
 import * as fs from "node:fs";
 import path from "node:path";
 import { escreverArquivos } from "./fsGovernado.js";
 import { arquivosTemplateIniciar } from "./initTemplatesBase.js";
-import { materializarExemplosOficiais } from "./exemplosOficiais.js";
+import { materializarExemplosOficiais, planejarExemplosOficiais } from "./exemplosOficiais.js";
+import { validarDestinosEscritaWorkspace } from "./workspaceWrite.js";
 async function sincronizarKitIaInicial(cwd) {
-    const [{ gerarResumoProjetoIa }, { sincronizarEntryPointsAgentes }] = await Promise.all([
+    const [{ gerarResumoProjetoIa }, { sincronizarEntrypointCodex }] = await Promise.all([
         import("./index.part04.js"),
         import("./agentEntryPoints.js"),
     ]);
     const resumoProjeto = await gerarResumoProjetoIa(cwd, undefined, true);
     const indexJson = JSON.parse(fs.readFileSync(path.join(resumoProjeto.pastaSaida, "SEMA_INDEX.json"), "utf8"));
-    const clientes = await sincronizarEntryPointsAgentes(resumoProjeto.baseProjeto, indexJson.agentContextPack);
+    const codex = await sincronizarEntrypointCodex(resumoProjeto.baseProjeto, indexJson.agentContextPack);
     return {
         artefatos: [...new Set([
                 ...resumoProjeto.artefatos,
-                ...clientes.arquivos.map((item) => item.caminho),
+                ...codex.arquivos.map((item) => item.caminho),
             ])],
-        clientes,
+        codex,
     };
 }
-export async function comandoIniciar(cwd, template) {
+export async function comandoIniciar(cwd, template, opcoes = {}) {
     const arquivos = arquivosTemplateIniciar(template);
-    await escreverArquivos(cwd, arquivos, { inserirCabecalhoGovernado: true });
+    const planoExemplos = await planejarExemplosOficiais();
+    if (!planoExemplos.origem) {
+        console.error("Diretorio de exemplos oficiais nao foi encontrado no pacote da CLI.");
+        return 1;
+    }
+    const [{ ARQUIVOS_RESUMO_PROJETO_IA }, { listarDestinosEntrypointCodex }] = await Promise.all([
+        import("./index.part04.js"),
+        import("./agentEntryPoints.js"),
+    ]);
+    const caminhosTemplate = new Set(arquivos.map((arquivo) => arquivo.caminhoRelativo));
+    const destinos = await validarDestinosEscritaWorkspace(cwd, [
+        ...caminhosTemplate,
+        ...planoExemplos.arquivos.map((arquivo) => arquivo.caminhoRelativo),
+        ...ARQUIVOS_RESUMO_PROJETO_IA,
+        ...listarDestinosEntrypointCodex("AGENTS.md"),
+    ]);
+    const existentes = new Set(destinos
+        .filter((destino) => caminhosTemplate.has(destino.caminhoRelativo) && destino.existe)
+        .map((destino) => destino.caminhoRelativo));
+    const arquivosParaEscrever = opcoes.force
+        ? arquivos
+        : arquivos.filter((arquivo) => !existentes.has(arquivo.caminhoRelativo));
+    await escreverArquivos(cwd, arquivosParaEscrever, { inserirCabecalhoGovernado: true });
     const exemplos = await materializarExemplosOficiais(cwd, true);
     if (!exemplos.sucesso) {
         console.error(exemplos.erro);
         return 1;
     }
     const kitIa = await sincronizarKitIaInicial(cwd);
+    if (!kitIa.codex.entrypointsLegadosLimpos) {
+        console.error("Entrypoints Sema pendentes de revisão manual:");
+        for (const caminho of kitIa.codex.entrypointsLegadosPendentes) {
+            console.error(`- ${caminho}`);
+        }
+        return 1;
+    }
     console.log(`Projeto Sema inicializado com template ${template}.`);
+    console.log(`Arquivos do projeto: ${arquivosParaEscrever.length} escritos, ${opcoes.force ? 0 : existentes.size} preservados.`);
     console.log(`Exemplos oficiais sincronizados em ${exemplos.destino} (${exemplos.criados.length} criados, ${exemplos.preservados.length} preservados).`);
-    console.log(`Kit IA sincronizado (${kitIa.artefatos.length} artefatos; clientes ${kitIa.clientes.criados.length} criados, ${kitIa.clientes.atualizados.length} atualizados, ${kitIa.clientes.preservados.length} preservados).`);
+    console.log(`Kit IA Codex-native sincronizado (${kitIa.artefatos.length} artefatos; entrypoint ${kitIa.codex.entrypointCodex}; ${kitIa.codex.criados.length} criados, ${kitIa.codex.atualizados.length} atualizados, ${kitIa.codex.preservados.length} preservados).`);
     return 0;
 }
 export async function comandoInstalarExemplos(emJson) {

package/dist/initTemplatesBase.js

@@ -1,7 +1,5 @@
-// SEMA-GOVERNED
-// M?dulo: sema.produto.orcamento_semantico
-// Contrato: contratos/sema/orcamento_semantico.sema
-// Descri??o: contrato base e dispatcher de templates de inicializa??o.
+// SEMA-GOVERNED: sema.produto.cli_init_templates
+// Descrição: contrato base e dispatcher dos templates Codex-native de inicialização.
 import { arquivosInitTemplatesBackend } from "./initTemplatesBackend.js";
 import { arquivosInitTemplatesWeb } from "./initTemplatesWeb.js";
 import { arquivosInitTemplatesFlutter } from "./initTemplatesFlutter.js";
@@ -70,21 +68,21 @@ function arquivosApoioIaIniciar() {
 
 Este projeto foi inicializado com Sema.
 
-## Entrada para IA
+## Entrada oficial do Codex
 
 Antes de alterar codigo, contrato ou documentacao:
 
 1. leia \`AGENTS.md\`;
 2. rode \`sema --version\`;
-3. rode \`sema preflight resumo --json\`;
-4. rode \`sema resumo\`;
-5. rode \`sema docs-impacto --intencao "<acao>" --json\`;
-6. leia \`docs/commands.md\` antes de escolher comando ou interpretar \`--saida\`;
-7. use \`exemplos/\` e \`docs/syntax.md\` antes de criar ou corrigir \`.sema\`.
+3. rode \`sema resumo\`;
+4. rode \`sema docs-impacto --intencao "<acao>" --json\`;
+5. leia \`docs/commands.md\` antes de escolher comando ou interpretar \`--saida\`;
+6. use \`exemplos/\` e \`docs/syntax.md\` antes de criar ou corrigir \`.sema\`.
 
 ## Estrutura criada
 
 - \`contratos/\`: contratos semanticamente governados.
+- \`AGENTS.md\`: entrypoint oficial do Codex.
 - \`exemplos/\`: exemplos oficiais da DSL Sema.
 - \`docs/commands.md\`: catalogo de comandos, gates e regra de \`--saida\`.
 - \`docs/syntax.md\`: referencia curta para escrever \`.sema\`.
@@ -118,7 +116,7 @@ export function arquivosTemplateIniciar(template) {
         ?? [
             {
                 caminhoRelativo: "sema.config.json",
-                conteudo: "{\n  \"origens\": [\"./contratos\"],\n  \"saida\": \"./generated\",\n  \"alvos\": [\"typescript\", \"javascript\", \"python\", \"dart\", \"lua\", \"html\", \"css\"],\n  \"alvoPadrao\": \"typescript\",\n  \"estruturaSaida\": \"modulos\",\n  \"framework\": \"base\",\n  \"modoEstrito\": true,\n  \"diretoriosSaidaPorAlvo\": {\n    \"typescript\": \"./generated/typescript\",\n    \"javascript\": \"./generated/javascript\",\n    \"python\": \"./generated/python\",\n    \"dart\": \"./generated/dart\",\n    \"lua\": \"./generated/lua\",\n    \"html\": \"./generated/html\",\n    \"css\": \"./generated/css\"\n  },\n  \"convencoesGeracaoPorProjeto\": \"base\"\n}\n",
+                conteudo: "{\n  \"origens\": [\"./contratos\"],\n  \"saida\": \"./generated\",\n  \"alvos\": [\"typescript\", \"javascript\", \"python\", \"php\", \"dart\", \"lua\", \"html\", \"css\"],\n  \"alvoPadrao\": \"typescript\",\n  \"estruturaSaida\": \"modulos\",\n  \"framework\": \"base\",\n  \"modoEstrito\": true,\n  \"diretoriosSaidaPorAlvo\": {\n    \"typescript\": \"./generated/typescript\",\n    \"javascript\": \"./generated/javascript\",\n    \"python\": \"./generated/python\",\n    \"php\": \"./generated/php\",\n    \"dart\": \"./generated/dart\",\n    \"lua\": \"./generated/lua\",\n    \"html\": \"./generated/html\",\n    \"css\": \"./generated/css\"\n  },\n  \"convencoesGeracaoPorProjeto\": \"base\"\n}\n",
             },
             ...arquivosBase,
         ];

package/dist/projetoConfig.js

@@ -52,7 +52,7 @@ export function normalizarFrameworkGeracao(valor) {
     return "base";
 }
 export function normalizarAlvo(valor) {
-    if (valor === "typescript" || valor === "python" || valor === "dart" || valor === "lua" || valor === "javascript" || valor === "html" || valor === "css") {
+    if (valor === "typescript" || valor === "python" || valor === "dart" || valor === "lua" || valor === "javascript" || valor === "html" || valor === "css" || valor === "php") {
         return valor;
     }
     if (valor === "js") {