feat: add OpenCode/Codex outputs and update changelog (#104)

* Add OpenCode converter coverage and specs * Add Codex target support and spec docs * Generate Codex command skills and refresh spec docs * Add global Codex install path * fix: harden plugin path loading and codex descriptions * feat: ensure codex agents block on convert/install * docs: clarify target branch usage for review * chore: prep npm package metadata and release notes * docs: mention opencode and codex in changelog * docs: update CLI usage and remove stale todos * feat: install from GitHub with global outputs
2026-01-21 17:00:30 -08:00
parent c50208d413
commit e97f85bd53
61 changed files with 3303 additions and 5 deletions
--- a/src/targets/codex.ts
+++ b/src/targets/codex.ts
@@ -0,0 +1,91 @@
+import path from "path"
+import { copyDir, ensureDir, writeText } from "../utils/files"
+import type { CodexBundle } from "../types/codex"
+import type { ClaudeMcpServer } from "../types/claude"
+
+export async function writeCodexBundle(outputRoot: string, bundle: CodexBundle): Promise<void> {
+  const codexRoot = resolveCodexRoot(outputRoot)
+  await ensureDir(codexRoot)
+
+  if (bundle.prompts.length > 0) {
+    const promptsDir = path.join(codexRoot, "prompts")
+    for (const prompt of bundle.prompts) {
+      await writeText(path.join(promptsDir, `${prompt.name}.md`), prompt.content + "\n")
+    }
+  }
+
+  if (bundle.skillDirs.length > 0) {
+    const skillsRoot = path.join(codexRoot, "skills")
+    for (const skill of bundle.skillDirs) {
+      await copyDir(skill.sourceDir, path.join(skillsRoot, skill.name))
+    }
+  }
+
+  if (bundle.generatedSkills.length > 0) {
+    const skillsRoot = path.join(codexRoot, "skills")
+    for (const skill of bundle.generatedSkills) {
+      await writeText(path.join(skillsRoot, skill.name, "SKILL.md"), skill.content + "\n")
+    }
+  }
+
+  const config = renderCodexConfig(bundle.mcpServers)
+  if (config) {
+    await writeText(path.join(codexRoot, "config.toml"), config)
+  }
+}
+
+function resolveCodexRoot(outputRoot: string): string {
+  return path.basename(outputRoot) === ".codex" ? outputRoot : path.join(outputRoot, ".codex")
+}
+
+export function renderCodexConfig(mcpServers?: Record<string, ClaudeMcpServer>): string | null {
+  if (!mcpServers || Object.keys(mcpServers).length === 0) return null
+
+  const lines: string[] = ["# Generated by compound-plugin", ""]
+
+  for (const [name, server] of Object.entries(mcpServers)) {
+    const key = formatTomlKey(name)
+    lines.push(`[mcp_servers.${key}]`)
+
+    if (server.command) {
+      lines.push(`command = ${formatTomlString(server.command)}`)
+      if (server.args && server.args.length > 0) {
+        const args = server.args.map((arg) => formatTomlString(arg)).join(", ")
+        lines.push(`args = [${args}]`)
+      }
+
+      if (server.env && Object.keys(server.env).length > 0) {
+        lines.push("")
+        lines.push(`[mcp_servers.${key}.env]`)
+        for (const [envKey, value] of Object.entries(server.env)) {
+          lines.push(`${formatTomlKey(envKey)} = ${formatTomlString(value)}`)
+        }
+      }
+    } else if (server.url) {
+      lines.push(`url = ${formatTomlString(server.url)}`)
+      if (server.headers && Object.keys(server.headers).length > 0) {
+        lines.push(`http_headers = ${formatTomlInlineTable(server.headers)}`)
+      }
+    }
+
+    lines.push("")
+  }
+
+  return lines.join("\n")
+}
+
+function formatTomlString(value: string): string {
+  return JSON.stringify(value)
+}
+
+function formatTomlKey(value: string): string {
+  if (/^[A-Za-z0-9_-]+$/.test(value)) return value
+  return JSON.stringify(value)
+}
+
+function formatTomlInlineTable(entries: Record<string, string>): string {
+  const parts = Object.entries(entries).map(
+    ([key, value]) => `${formatTomlKey(key)} = ${formatTomlString(value)}`,
+  )
+  return `{ ${parts.join(", ")} }`
+}