Function cleanupCodex

src/commands/cleanup.ts:216–312

(plugin: Awaited<ReturnType<typeof loadClaudePlugin>>, codexRoot: string)

}

async function cleanupCodex(plugin: Awaited<ReturnType<typeof loadClaudePlugin>>, codexRoot: string): Promise<CleanupResult> {
  const bundle = convertClaudeToCodex(plugin, {
    agentMode: "subagent",
    inferTemperature: true,
    permissions: "none",
    // Cleanup needs the FULL bundle (skills, command-skills, agents) to know
    // what's "current" vs "legacy." The agents-only default of `--to codex`
    // is wrong here; it would make cleanup think every existing skill is
    // legacy and remove them.
    codexIncludeSkills: true,
  })
  const artifacts = getLegacyCodexArtifacts(bundle)
  const currentNamespacedSkills = new Set([
    ...bundle.skillDirs.map((skill) => sanitizePathName(skill.name)),
    ...bundle.generatedSkills.map((skill) => sanitizePathName(skill.name)),
  ])
  const currentPrompts = new Set(bundle.prompts.map((prompt) => `${sanitizePathName(prompt.name)}.md`))
  const currentAgents = new Set((bundle.agents ?? []).map((agent) => `${sanitizePathName(agent.name)}.toml`))
  const managedDir = path.join(codexRoot, plugin.manifest.name)
  let moved = 0
  for (const skillName of artifacts.skills) {
    moved += await moveLegacySkillIfOwned(managedDir, "skills", path.join(codexRoot, "skills"), skillName, "Codex")
    if (!currentNamespacedSkills.has(skillName)) {
      moved += await moveIfExists(
        managedDir,
        "skills",
        path.join(codexRoot, "skills", plugin.manifest.name),
        skillName,
        "Codex",
      )
    }
  }
  for (const promptFile of artifacts.prompts) {
    // Ownership gate: `~/.codex/prompts/` is a shared directory across plugins
    // and user-authored prompts. A filename match against the historical CE
    // allow-list is not a strong enough signal — a user who creates
    // `~/.codex/prompts/ce-plan.md` for their own workflow would otherwise see
    // it swept into `compound-engineering/legacy-backup/` on every cleanup run.
    // Mirror the body + frontmatter check used by `cleanupStalePrompts` so
    // install-time and standalone cleanup paths treat ownership identically.
    // "unknown" (no fingerprint on record) falls through so fully-retired
    // historical wrappers still get cleaned up. Manifest-driven migration
    // below is already safe because it only touches files CE recorded writing.
    const promptPath = path.join(codexRoot, "prompts", promptFile)
    const ownership = await classifyCodexLegacyPromptOwnership(promptPath)
    if (ownership === "foreign") continue
    moved += await moveIfExists(managedDir, "prompts", path.join(codexRoot, "prompts"), promptFile, "Codex")
  }
  for (const agentFile of artifacts.agents ?? []) {
    moved += await moveIfExists(
      managedDir,
      "agents",
      path.join(codexRoot, "agents", plugin.manifest.name),
      agentFile,
      "Codex",
    )
    moved += await moveLegacyAgentIfOwned(managedDir, "agents", path.join(codexRoot, "agents"), agentFile, "Codex", ".toml")
  }