Function writeCodexBundle

src/targets/codex.ts:30–172

(
  outputRoot: string,
  bundle: CodexBundle,
  options: CodexWriteOptions = {},
)

}

export async function writeCodexBundle(
  outputRoot: string,
  bundle: CodexBundle,
  options: CodexWriteOptions = {},
): Promise<void> {
  const codexRoot = resolveCodexRoot(outputRoot, options)
  await ensureDir(codexRoot)

  const pluginName = bundle.pluginName ? sanitizeCodexPathComponent(bundle.pluginName) : undefined
  const manifest = pluginName ? await readInstallManifest(codexRoot, pluginName) : null
  const currentPrompts = bundle.prompts.map((prompt) => `${sanitizePathName(prompt.name)}.md`)
  const agents = bundle.agents ?? []
  const agentsRoot = pluginName
    ? path.join(codexRoot, "agents", pluginName)
    : path.join(codexRoot, "agents")
  const currentAgents = agents.map((agent) => `${sanitizePathName(agent.name)}.toml`)
  assertNoCodexAgentFilenameCollisions(agents)

  if (bundle.prompts.length > 0) {
    const promptsDir = path.join(codexRoot, "prompts")
    await cleanupRemovedPrompts(promptsDir, manifest, currentPrompts)
    for (const prompt of bundle.prompts) {
      await writeText(path.join(promptsDir, `${sanitizePathName(prompt.name)}.md`), prompt.content + "\n")
    }
  } else if (pluginName) {
    await cleanupRemovedPrompts(path.join(codexRoot, "prompts"), manifest, [])
  }

  const skillsRoot = pluginName
    ? path.join(codexRoot, "skills", pluginName)
    : path.join(codexRoot, "skills")
  // Include `externallyManagedSkillNames` so agents-only installs (default
  // `--to codex`) treat skills installed via Codex's native plugin flow as
  // "current" for cleanup purposes. Without this, `cleanupLegacyAgentSkillDirs`
  // would see an empty `currentSkills` set and sweep allow-listed names such
  // as `ce-plan` out of `.codex/skills/<plugin>/` into legacy-backup on every
  // re-run of `install --to codex`.
  const currentSkills = Array.from(new Set([
    ...bundle.skillDirs.map((skill) => sanitizePathName(skill.name)),
    ...bundle.generatedSkills.map((skill) => sanitizePathName(skill.name)),
    ...(bundle.externallyManagedSkillNames ?? []).map((name) => sanitizePathName(name)),
  ]))
  await cleanupRemovedSkills(skillsRoot, manifest, currentSkills)

  if (bundle.skillDirs.length > 0) {
    for (const skill of bundle.skillDirs) {
      const targetDir = path.join(skillsRoot, sanitizePathName(skill.name))
      await cleanupCurrentManagedSkillDir(targetDir, manifest, sanitizePathName(skill.name))
      await copySkillDir(
        skill.sourceDir,
        targetDir,
        (content) => transformContentForCodex(content, bundle.invocationTargets, {
          unknownSlashBehavior: "preserve",
        }),
      )
    }
  }