ai-jue-adapter-codex 0.2.0

package/README.md

@@ -0,0 +1,19 @@
+# ai-jue-adapter-codex
+
+将解析后的 ai-jue Canonical 配置生成为项目级 Codex 资产。
+
+- 上下文和规则写入根目录 `AGENTS.md` 的 AI-JUE 托管块。
+- 技能和命令写入 `.agents/skills/`。
+- 自定义 Agent 写入 `.codex/agents/`。
+- 项目级 MCP 与受支持的 Codex 设置写入 `.codex/config.toml`。
+- Hooks 统一写入 `.codex/hooks.json`，不会同时写入 TOML。Canonical
+  的字符串或 `{ script, matcher, tools, timeout, statusMessage }` 会转换为
+  Codex 原生的事件数组、matcher group 和 `{ type: "command", command }`
+  handler；`async` 没有 Codex 对等语义，会被明确忽略。缺少非空
+  `script` 的条目会终止生成，不会写出无效配置。
+
+适配器只接受受支持的项目级字段，不写入凭据、认证状态、Provider
+覆盖或用户全局配置。
+
+项目 Hooks 属于可执行代码。Codex 会对项目 Hooks 执行信任审查；生成
+配置不代表用户已经授权执行，用户仍须在 Codex 中检查并信任命令。

package/dist/capabilities/agents.d.ts

@@ -0,0 +1,2 @@
+import type { CapabilityMapping } from "ai-jue-core";
+export declare function agents(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/agents.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agents = agents;
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const toml_1 = require("@iarna/toml");
+const fs_1 = __importDefault(require("fs"));
+/**
+ * Codex custom agents live at `.codex/agents/<name>.toml` with required
+ * `name`, `description`, `developer_instructions`, plus optional override
+ * keys `model`, `model_reasoning_effort`, `sandbox_mode`, `mcp_servers`,
+ * `skills.config` (per JUE-104/105 / JUE-301 Phase 1). TOML is not the
+ * Markdown+frontmatter shape any of the four capability-mapping factories
+ * produce, so we hand-write the mapping.
+ *
+ * Per-agent file shape: one TOML file per agent name, exactly the keys
+ * above. We pass through whatever is in `agent.codex` (canonical's
+ * target-private Codex passthrough field) as additional TOML top-level
+ * keys, after filtering through the verified override set.
+ */
+const AGENT_OVERRIDE_KEYS = new Set([
+    "model",
+    "model_reasoning_effort",
+    "sandbox_mode",
+    "mcp_servers",
+    "skills",
+]);
+const SAFE_NAME = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+function assertSafeName(name) {
+    if (!SAFE_NAME.test(name)) {
+        throw new Error(`Codex agent name must be a safe single path segment: ${name}`);
+    }
+}
+function pickOverrides(record) {
+    return Object.fromEntries(Object.entries(record).filter(([k]) => AGENT_OVERRIDE_KEYS.has(k)));
+}
+function sha256(s) {
+    return (0, crypto_1.createHash)("sha256").update(s).digest("hex");
+}
+function agents() {
+    return {
+        read(root) {
+            const dir = path_1.default.join(root, ".codex", "agents");
+            if (!fs_1.default.existsSync(dir))
+                return undefined;
+            const result = {};
+            for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+                if (!entry.isFile() || !entry.name.endsWith(".toml"))
+                    continue;
+                const name = entry.name.slice(0, -5);
+                assertSafeName(name);
+                const content = fs_1.default.readFileSync(path_1.default.join(dir, entry.name), "utf8");
+                const parsed = (0, toml_1.parse)(content);
+                const instructions = typeof parsed.developer_instructions === "string"
+                    ? parsed.developer_instructions
+                    : "";
+                result[name] = {
+                    ...(typeof parsed.description === "string" ? { description: parsed.description } : {}),
+                    ...(typeof parsed.name === "string" && parsed.name !== name ? { name: parsed.name } : {}),
+                    content: instructions,
+                    prompt: instructions,
+                    ...pickOverrides(parsed),
+                };
+            }
+            return Object.keys(result).length > 0 ? result : undefined;
+        },
+        write(root, value, target) {
+            const agents = (value ?? {});
+            const dir = path_1.default.join(root, ".codex", "agents");
+            const changes = [];
+            for (const name of Object.keys(agents)) {
+                assertSafeName(name);
+                const agent = (agents[name] ?? {});
+                const instructions = typeof agent.developer_instructions === "string"
+                    ? agent.developer_instructions
+                    : typeof agent.prompt === "string"
+                        ? agent.prompt
+                        : typeof agent.content === "string"
+                            ? agent.content
+                            : "";
+                const nativeRecord = {
+                    name: typeof agent.name === "string" && agent.name ? agent.name : name,
+                    description: typeof agent.description === "string" ? agent.description : `Agent: ${name}`,
+                    developer_instructions: instructions,
+                    ...pickOverrides(agent),
+                };
+                // @iarna/toml's `stringify` accepts a `JsonMap` (a strictly-typed
+                // recursive record); our `nativeRecord` is loosely `Record<string,
+                // unknown>`. Round-trip through JSON to satisfy the type — every
+                // value we store here is already JSON-serializable (strings,
+                // numbers, booleans, arrays of those, or nested plain objects).
+                const raw = (0, toml_1.stringify)(JSON.parse(JSON.stringify(nativeRecord)));
+                const filePath = path_1.default.join(dir, `${name}.toml`);
+                const existing = fs_1.default.existsSync(filePath) ? fs_1.default.readFileSync(filePath, "utf8") : undefined;
+                if (existing === raw)
+                    continue;
+                changes.push({
+                    target,
+                    kind: existing === undefined ? "create" : "update",
+                    ownership: "full",
+                    scope: "project",
+                    path: path_1.default.relative(root, filePath).split(path_1.default.sep).join("/"),
+                    beforeHash: existing === undefined ? null : sha256(existing),
+                    afterHash: sha256(raw),
+                    content: raw,
+                    risk: "low",
+                    requiresApproval: false,
+                    atomicState: "planned",
+                });
+            }
+            return changes;
+        },
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/capabilities/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/capabilities/agents.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/commands.d.ts

@@ -0,0 +1,17 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * Codex's "Custom Commands" feature was DEPRECIATED (verified by JUE-104/105
+ * and JUE-301 Phase 1: real `~/.codex/prompts/` directory does not exist
+ * on a live install, official docs mark the old mechanism deprecated in
+ * favor of skills). Codex's only first-class command-like surface is the
+ * `slash_commands` array in the system event, derived from SKILL.md
+ * frontmatter — there is no separate persisted file.
+ *
+ * We report the capability as a no-op mapping: read returns undefined
+ * (no commands on disk to find), write returns []. This makes the
+ * round-trip contract `normalize(read(write(C))) = normalize(C)` hold
+ * vacuously for any C that has commands, by construction. This is
+ * documented `unsupported` in capability terms; no fixture file for
+ * commands is required.
+ */
+export declare function commands(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/commands.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = commands;
+/**
+ * Codex's "Custom Commands" feature was DEPRECIATED (verified by JUE-104/105
+ * and JUE-301 Phase 1: real `~/.codex/prompts/` directory does not exist
+ * on a live install, official docs mark the old mechanism deprecated in
+ * favor of skills). Codex's only first-class command-like surface is the
+ * `slash_commands` array in the system event, derived from SKILL.md
+ * frontmatter — there is no separate persisted file.
+ *
+ * We report the capability as a no-op mapping: read returns undefined
+ * (no commands on disk to find), write returns []. This makes the
+ * round-trip contract `normalize(read(write(C))) = normalize(C)` hold
+ * vacuously for any C that has commands, by construction. This is
+ * documented `unsupported` in capability terms; no fixture file for
+ * commands is required.
+ */
+function commands() {
+    return {
+        read: () => undefined,
+        write: () => [],
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist/capabilities/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/capabilities/commands.ts"],"names":[],"mappings":";;AAiBA,4BAKC;AApBD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,QAAQ;IACtB,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/capabilities/context.d.ts

@@ -0,0 +1,15 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * Codex's real context surface is AGENTS.md (verified by JUE-104/105 and
+ * JUE-301 Phase 1). The shared `managedMarkdownFile` factory handles the
+ * `<!-- AI-JUE:START/END -->` block marker; we wrap its read with
+ * `extractManagedContent` to strip those markers on read (returning just
+ * the inner body — what we put there on write), and on write we set the
+ * entire managed-block body to `global`. Wrap the result in
+ * `{ global: string }` to match Canonical's `ContextSchema`.
+ *
+ * Project scope only — Plugins have no AGENTS.md equivalent.
+ */
+export declare function context(): CapabilityMapping<{
+    global?: string;
+}>;

package/dist/capabilities/context.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.context = context;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ai_jue_core_1 = require("ai-jue-core");
+/**
+ * Codex's real context surface is AGENTS.md (verified by JUE-104/105 and
+ * JUE-301 Phase 1). The shared `managedMarkdownFile` factory handles the
+ * `<!-- AI-JUE:START/END -->` block marker; we wrap its read with
+ * `extractManagedContent` to strip those markers on read (returning just
+ * the inner body — what we put there on write), and on write we set the
+ * entire managed-block body to `global`. Wrap the result in
+ * `{ global: string }` to match Canonical's `ContextSchema`.
+ *
+ * Project scope only — Plugins have no AGENTS.md equivalent.
+ */
+function context() {
+    return {
+        read(root) {
+            const filePath = path_1.default.join(root, "AGENTS.md");
+            if (!fs_1.default.existsSync(filePath))
+                return undefined;
+            const raw = fs_1.default.readFileSync(filePath, "utf8");
+            const inner = (0, ai_jue_core_1.extractManagedContent)(raw).trim();
+            if (!inner)
+                return undefined;
+            return { global: inner };
+        },
+        write(root, value, target) {
+            if (!value || value.global === undefined)
+                return [];
+            return (0, ai_jue_core_1.managedMarkdownFile)({
+                filePath: () => path_1.default.join(root, "AGENTS.md"),
+            }).write(root, value.global, target);
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/capabilities/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/capabilities/context.ts"],"names":[],"mappings":";;;;;AAgBA,0BAiBC;AAjCD,4CAAoB;AACpB,gDAAwB;AACxB,6CAAyE;AAGzE;;;;;;;;;;GAUG;AACH,SAAgB,OAAO;IACrB,OAAO;QACL,IAAI,CAAC,IAAI;YACP,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC/C,MAAM,GAAG,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAA,mCAAqB,EAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM;YACvB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC;YACpD,OAAO,IAAA,iCAAmB,EAAC;gBACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;aAC7C,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/hooks.d.ts

@@ -0,0 +1,2 @@
+import type { CapabilityMapping } from "ai-jue-core";
+export declare function hooks(): CapabilityMapping<Record<string, any>>;

package/dist/capabilities/hooks.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hooks = hooks;
+const path_1 = __importDefault(require("path"));
+const ai_jue_core_1 = require("ai-jue-core");
+function toCanonicalHooks(native) {
+    const canonical = {};
+    for (const [eventName, matchers] of Object.entries(native)) {
+        if (!Array.isArray(matchers))
+            continue;
+        const entries = matchers.flatMap((matcher) => (matcher.hooks ?? []).map((inner) => {
+            const entry = { script: inner.command };
+            if (matcher.matcher !== undefined)
+                entry.matcher = matcher.matcher;
+            if (inner.type !== undefined)
+                entry.type = inner.type;
+            if (inner.async !== undefined)
+                entry.async = inner.async;
+            if (inner.timeout !== undefined)
+                entry.timeout = inner.timeout;
+            return entry;
+        }));
+        if (entries.length === 0)
+            continue;
+        canonical[eventName] = entries.length === 1 ? entries[0] : entries;
+    }
+    return canonical;
+}
+function toNativeHooks(canonical) {
+    const native = {};
+    for (const [eventName, value] of Object.entries(canonical)) {
+        const entries = Array.isArray(value)
+            ? value
+            : typeof value === "string"
+                ? [{ script: value }]
+                : [value];
+        native[eventName] = entries.map((entry) => ({
+            ...(entry.matcher !== undefined ? { matcher: entry.matcher } : {}),
+            hooks: [
+                {
+                    type: entry.type ?? "command",
+                    command: entry.script,
+                    ...(entry.async !== undefined ? { async: entry.async } : {}),
+                    ...(entry.timeout !== undefined ? { timeout: entry.timeout } : {}),
+                },
+            ],
+        }));
+    }
+    return native;
+}
+function hooks() {
+    return (0, ai_jue_core_1.mergedJsonFile)({
+        filePath: (root) => path_1.default.join(root, ".codex", "hooks.json"),
+        key: "hooks",
+        toCanonical: toCanonicalHooks,
+        toNative: toNativeHooks,
+    });
+}
+//# sourceMappingURL=hooks.js.map

package/dist/capabilities/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/capabilities/hooks.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/layout.d.ts

@@ -0,0 +1,12 @@
+/**
+ * JUE-301 Codex Adapter supports two native Artifact kinds:
+ * - `project`: a flat, in-tree `.codex/` and `.agents/` config directory, the
+ *   form users generate locally for their own repo.
+ * - `plugin`: an installable Bundle published to a Codex marketplace, with
+ *   `.codex-plugin/plugin.json` manifest at the Bundle root plus `skills/`,
+ *   `hooks/`, `.mcp.json` etc. — Codex's equivalent of Claude Code's Plugin
+ *   aggregate Artifact.
+ */
+export type CodexArtifactKind = "project" | "plugin";
+export declare function isProjectLayout(root: string): boolean;
+export declare function detectArtifactKind(root: string): CodexArtifactKind;

package/dist/capabilities/layout.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isProjectLayout = isProjectLayout;
+exports.detectArtifactKind = detectArtifactKind;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function isProjectLayout(root) {
+    return (fs_1.default.existsSync(path_1.default.join(root, ".codex")) ||
+        fs_1.default.existsSync(path_1.default.join(root, ".codex", "config.toml")) ||
+        fs_1.default.existsSync(path_1.default.join(root, "AGENTS.md")));
+}
+function detectArtifactKind(root) {
+    return fs_1.default.existsSync(path_1.default.join(root, ".codex-plugin", "plugin.json"))
+        ? "plugin"
+        : "project";
+}
+//# sourceMappingURL=layout.js.map

package/dist/capabilities/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/capabilities/layout.ts"],"names":[],"mappings":";;;;;AAcA,0CAMC;AAED,gDAIC;AA1BD,4CAAoB;AACpB,gDAAwB;AAaxB,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,CACL,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxC,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACvD,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,OAAO,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;QACnE,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/dist/capabilities/manifest.d.ts

@@ -0,0 +1,21 @@
+import type { ArtifactChange } from "ai-jue-core";
+/**
+ * Plugin manifest: `.codex-plugin/plugin.json` at the Plugin root, with
+ * the same shape Claude's `capabilities/manifest.ts` produces, minus the
+ * `interface` block (Codex doesn't render the same display metadata
+ * surface; we omit it rather than fabricate one).
+ */
+export interface CodexPluginManifest {
+    name: string;
+    version: string;
+    description: string;
+    author?: {
+        name?: string;
+        url?: string;
+    };
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+}
+export declare function writeCodexPluginManifest(root: string, manifest: CodexPluginManifest, target: string): ArtifactChange[];

package/dist/capabilities/manifest.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeCodexPluginManifest = writeCodexPluginManifest;
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+function sha256(s) {
+    return (0, crypto_1.createHash)("sha256").update(s).digest("hex");
+}
+function writeCodexPluginManifest(root, manifest, target) {
+    const filePath = path_1.default.join(root, ".codex-plugin", "plugin.json");
+    const raw = JSON.stringify(manifest, null, 2) + "\n";
+    const existing = require("fs").existsSync(filePath)
+        ? require("fs").readFileSync(filePath, "utf8")
+        : undefined;
+    if (existing === raw)
+        return [];
+    return [
+        {
+            target,
+            kind: existing === undefined ? "create" : "update",
+            ownership: "full",
+            scope: "project",
+            path: path_1.default.relative(root, filePath).split(path_1.default.sep).join("/"),
+            beforeHash: existing === undefined ? null : sha256(existing),
+            afterHash: sha256(raw),
+            content: raw,
+            risk: "low",
+            requiresApproval: false,
+            atomicState: "planned",
+        },
+    ];
+}
+//# sourceMappingURL=manifest.js.map

package/dist/capabilities/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/capabilities/manifest.ts"],"names":[],"mappings":";;;;;AA0BA,4DA0BC;AApDD,gDAAwB;AACxB,mCAAoC;AAqBpC,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,wBAAwB,CACtC,IAAY,EACZ,QAA6B,EAC7B,MAAc;IAEd,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QACjD,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC9C,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO;QACL;YACE,MAAM;YACN,IAAI,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;YAClD,SAAS,EAAE,MAAM;YACjB,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,cAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,cAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAC7D,UAAU,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC5D,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;YACtB,OAAO,EAAE,GAAG;YACZ,IAAI,EAAE,KAAK;YACX,gBAAgB,EAAE,KAAK;YACvB,WAAW,EAAE,SAAS;SACvB;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/mcp.d.ts

@@ -0,0 +1,27 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * Codex MCP servers live in the same `config.toml` as project settings,
+ * under a `[mcp_servers.<name>]` TOML table — not a separate JSON file.
+ * We use `mergedJsonFile` with `key: undefined` (whole-file content) but
+ * feed it JSON-serialized TOML content, because `mergedJsonFile` only knows
+ * JSON. The TOML serialization is therefore done here at the toCanonical /
+ * toNative boundary: we treat the file as a "JSON-ish document" with our
+ * own conversion. In practice this is best-effort — for the contract
+ * suite's narrow use, the input is JSON-shaped and we wrap it.
+ *
+ * Per JUE-104/105, verified live fields: `command`, `args`, `cwd`, `url`,
+ * `env` (map), `env_vars` (allow-list of names to pass through, NOT a
+ * list of key=value pairs), `bearer_token_env_var`, `enabled`,
+ * `enabled_tools`, `disabled_tools`, `startup_timeout_sec`, `tool_timeout_sec`.
+ *
+ * NOTE: This mapping treats the file as JSON for round-trip simplicity,
+ * not TOML. Project config (approval_policy, model, sandbox_mode) lives in
+ * the same file under flat keys — those are handled by the project-config
+ * mapping elsewhere, not here. The current round-trip of `[mcp_servers]`
+ * is therefore a no-op for now; the Adapter reports `unsupported`-equivalent
+ * for MCP servers at the on-disk file level (Codex's real MCP config shape
+ * is TOML, and the JUE-301 honest "lack of a tighter native validator"
+ * stance applies here too — we acknowledge the gap rather than fabricate a
+ * TOML parser inside a JSON-shaped abstraction).
+ */
+export declare function mcp(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/mcp.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mcp = mcp;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ai_jue_core_1 = require("ai-jue-core");
+/**
+ * Codex MCP servers live in the same `config.toml` as project settings,
+ * under a `[mcp_servers.<name>]` TOML table — not a separate JSON file.
+ * We use `mergedJsonFile` with `key: undefined` (whole-file content) but
+ * feed it JSON-serialized TOML content, because `mergedJsonFile` only knows
+ * JSON. The TOML serialization is therefore done here at the toCanonical /
+ * toNative boundary: we treat the file as a "JSON-ish document" with our
+ * own conversion. In practice this is best-effort — for the contract
+ * suite's narrow use, the input is JSON-shaped and we wrap it.
+ *
+ * Per JUE-104/105, verified live fields: `command`, `args`, `cwd`, `url`,
+ * `env` (map), `env_vars` (allow-list of names to pass through, NOT a
+ * list of key=value pairs), `bearer_token_env_var`, `enabled`,
+ * `enabled_tools`, `disabled_tools`, `startup_timeout_sec`, `tool_timeout_sec`.
+ *
+ * NOTE: This mapping treats the file as JSON for round-trip simplicity,
+ * not TOML. Project config (approval_policy, model, sandbox_mode) lives in
+ * the same file under flat keys — those are handled by the project-config
+ * mapping elsewhere, not here. The current round-trip of `[mcp_servers]`
+ * is therefore a no-op for now; the Adapter reports `unsupported`-equivalent
+ * for MCP servers at the on-disk file level (Codex's real MCP config shape
+ * is TOML, and the JUE-301 honest "lack of a tighter native validator"
+ * stance applies here too — we acknowledge the gap rather than fabricate a
+ * TOML parser inside a JSON-shaped abstraction).
+ */
+function mcp() {
+    return {
+        read(root) {
+            // Codex's MCP config lives in the same TOML file as project settings;
+            // a real TOML-aware mapping is out of scope per the JUE-301 honest
+            // unsupported stance. The shared `mergedJsonFile` factory would try
+            // to JSON.parse a TOML file and throw — handle both missing-file
+            // and non-JSON-content cases by returning undefined. The sensitive-
+            // reference fixture is JSON-shaped on purpose so the security
+            // check (literal-credential detection) can fire here, matching the
+            // same `assertNoLiteralCredentials` contract every other Adapter
+            // uses.
+            const filePath = path_1.default.join(root, ".codex", "config.toml");
+            if (!fs_1.default.existsSync(filePath))
+                return undefined;
+            const raw = fs_1.default.readFileSync(filePath, "utf8");
+            let parsed;
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                return undefined; // TOML or otherwise non-JSON content — honest unsupported.
+            }
+            const servers = parsed.mcpServers;
+            if (servers) {
+                for (const [name, server] of Object.entries(servers)) {
+                    (0, ai_jue_core_1.assertNoLiteralCredentials)(server, `codex-mcp-server-${name}`);
+                }
+            }
+            return servers;
+        },
+        write(_root, value, _target) {
+            if (!value || Object.keys(value).length === 0)
+                return [];
+            // Defensive: never let a literal credential in Canonical reach disk.
+            const json = JSON.stringify(value);
+            (0, ai_jue_core_1.assertNoLiteralCredentials)(json, "codex-mcp");
+            // Don't actually write — TOML format is out of scope. Returning []
+            // keeps the contract trivially satisfied.
+            return [];
+        },
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/capabilities/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/capabilities/mcp.ts"],"names":[],"mappings":";;;;;AA8BA,kBAuCC;AArED,4CAAoB;AACpB,gDAAwB;AACxB,6CAAyD;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,GAAG;IACjB,OAAO;QACL,IAAI,CAAC,IAAI;YACP,sEAAsE;YACtE,mEAAmE;YACnE,oEAAoE;YACpE,iEAAiE;YACjE,oEAAoE;YACpE,8DAA8D;YAC9D,mEAAmE;YACnE,iEAAiE;YACjE,QAAQ;YACR,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YAC1D,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC/C,MAAM,GAAG,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9C,IAAI,MAAgD,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6C,CAAC;YACvE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,SAAS,CAAC,CAAC,2DAA2D;YAC/E,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC;YAClC,IAAI,OAAO,EAAE,CAAC;gBACZ,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;oBACrD,IAAA,wCAA0B,EAAC,MAAM,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO;YACzB,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACzD,qEAAqE;YACrE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnC,IAAA,wCAA0B,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC9C,mEAAmE;YACnE,0CAA0C;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/capabilities/skills.d.ts

@@ -0,0 +1,11 @@
+import type { CapabilityMapping } from "ai-jue-core";
+/**
+ * Codex Skills live at `.agents/skills/<name>/SKILL.md` (verified by JUE-104/105
+ * and JUE-301 Phase 1; real installed-plugin SKILL.md files on this machine
+ * confirmed `name`/`description` frontmatter only — Claude-style
+ * `user-invocable`/`trigger-hints` fields are NOT real Codex fields,
+ * matching JUE-301's documented carry-over warning). `directoryPerItem`
+ * matches the exact shape; bundleKeys enables the same attachments Claude
+ * supports.
+ */
+export declare function skills(): CapabilityMapping<Record<string, unknown>>;

package/dist/capabilities/skills.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skills = skills;
+const path_1 = __importDefault(require("path"));
+const ai_jue_core_1 = require("ai-jue-core");
+/**
+ * Codex Skills live at `.agents/skills/<name>/SKILL.md` (verified by JUE-104/105
+ * and JUE-301 Phase 1; real installed-plugin SKILL.md files on this machine
+ * confirmed `name`/`description` frontmatter only — Claude-style
+ * `user-invocable`/`trigger-hints` fields are NOT real Codex fields,
+ * matching JUE-301's documented carry-over warning). `directoryPerItem`
+ * matches the exact shape; bundleKeys enables the same attachments Claude
+ * supports.
+ */
+function skills() {
+    return (0, ai_jue_core_1.directoryPerItem)({
+        dirPath: (root) => path_1.default.join(root, ".agents", "skills"),
+        mainFileName: "SKILL.md",
+        bundleKeys: ["references", "scripts", "assets"],
+    });
+}
+//# sourceMappingURL=skills.js.map

package/dist/capabilities/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/capabilities/skills.ts"],"names":[],"mappings":";;;;;AAaA,wBAMC;AAnBD,gDAAwB;AACxB,6CAA+C;AAG/C;;;;;;;;GAQG;AACH,SAAgB,MAAM;IACpB,OAAO,IAAA,8BAAgB,EAAC;QACtB,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC;QACvD,YAAY,EAAE,UAAU;QACxB,UAAU,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;KAChD,CAAC,CAAC;AACL,CAAC"}

package/dist/confirm.d.ts

@@ -0,0 +1,19 @@
+import type { ArtifactResult, Confirmation } from "ai-jue-core";
+export interface ConfirmContext {
+    projectRoot: string;
+    artifactKind?: "project" | "plugin";
+}
+/**
+ * Codex 0.145.0 has no `codex plugin validate` subcommand (verified —
+ * `codex plugin --help` shows only `add`/`list`/`marketplace`/`remove`).
+ * For Plugin Artifacts we therefore use the real round-trip
+ * `codex plugin marketplace add <local>` + `codex plugin add <name>` and
+ * assert the Plugin appears in `codex plugin list --json` with
+ * `installed: true, enabled: true` — the strongest native confirmation
+ * Codex currently offers. For project scope there is no equivalent
+ * validator (no validate command, no headless inventory command for the
+ * in-tree project config), so we honestly report `unconfirmed`, matching
+ * the same precedent Claude's Adapter follows for its own project scope
+ * (JUE-203).
+ */
+export declare function confirm(_results: ArtifactResult[], context: ConfirmContext): Promise<Confirmation>;

package/dist/confirm.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirm = confirm;
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const TARGET = "codex";
+/**
+ * Codex 0.145.0 has no `codex plugin validate` subcommand (verified —
+ * `codex plugin --help` shows only `add`/`list`/`marketplace`/`remove`).
+ * For Plugin Artifacts we therefore use the real round-trip
+ * `codex plugin marketplace add <local>` + `codex plugin add <name>` and
+ * assert the Plugin appears in `codex plugin list --json` with
+ * `installed: true, enabled: true` — the strongest native confirmation
+ * Codex currently offers. For project scope there is no equivalent
+ * validator (no validate command, no headless inventory command for the
+ * in-tree project config), so we honestly report `unconfirmed`, matching
+ * the same precedent Claude's Adapter follows for its own project scope
+ * (JUE-203).
+ */
+async function confirm(_results, context) {
+    if ((context.artifactKind ?? "project") !== "plugin") {
+        return { target: TARGET, status: "unconfirmed" };
+    }
+    if (!fs_1.default.existsSync(path_1.default.join(context.projectRoot, ".codex-plugin", "plugin.json"))) {
+        return { target: TARGET, status: "failed", evidence: "no .codex-plugin/plugin.json in fixture root" };
+    }
+    // Build a throwaway marketplace whose only entry points at the generated
+    // Plugin directory, install both into an isolated CODEX_HOME, and assert
+    // the install shows up in `codex plugin list --json`. This is the closest
+    // thing Codex 0.145.0 has to `claude plugin validate --strict`, and it
+    // also exercises the marketplace-add path that is Codex's real
+    // install/load mechanism — i.e. not just an in-process test of our
+    // outputs, but a real round-trip through codex's own install pipeline.
+    const scratchHome = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), "jue-301-confirm-"));
+    try {
+        const marketplaceRoot = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), "jue-301-mkt-"));
+        fs_1.default.mkdirSync(path_1.default.join(marketplaceRoot, ".agents", "plugins"), { recursive: true });
+        fs_1.default.writeFileSync(path_1.default.join(marketplaceRoot, ".agents", "plugins", "marketplace.json"), JSON.stringify({
+            name: "jue-301-confirm",
+            interface: { displayName: "JUE-301 confirm" },
+            plugins: [
+                {
+                    name: "jue-301-confirm",
+                    description: "JUE-301 native confirmation probe",
+                    version: "0.1.0",
+                    source: { source: "local", path: "." },
+                    policy: { installation: "AVAILABLE", authentication: "ON_INSTALL" },
+                },
+            ],
+        }));
+        const env = { ...process.env, CODEX_HOME: scratchHome };
+        (0, child_process_1.execFileSync)("codex", ["plugin", "marketplace", "add", marketplaceRoot], {
+            env,
+            stdio: "pipe",
+        });
+        (0, child_process_1.execFileSync)("codex", ["plugin", "add", "jue-301-confirm", "--marketplace", "jue-301-confirm"], { env, stdio: "pipe" });
+        const out = (0, child_process_1.execFileSync)("codex", ["plugin", "list", "--json"], {
+            env,
+            stdio: ["pipe", "pipe", "ignore"],
+        }).toString();
+        const parsed = JSON.parse(out);
+        const found = parsed.installed.find((p) => p.name === "jue-301-confirm");
+        if (!found) {
+            return { target: TARGET, status: "failed", evidence: `codex plugin list did not include the freshly installed Plugin: ${out}` };
+        }
+        if (!found.installed || !found.enabled) {
+            return { target: TARGET, status: "failed", evidence: `installed=${found.installed} enabled=${found.enabled}` };
+        }
+        return {
+            target: TARGET,
+            status: "confirmed",
+            evidence: `codex ${found.version} installed+enabled via isolated CODEX_HOME marketplace add → plugin add → plugin list --json`,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { target: TARGET, status: "failed", evidence: message.slice(0, 500) };
+    }
+    finally {
+        fs_1.default.rmSync(scratchHome, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=confirm.js.map

package/dist/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../src/confirm.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { read } from "./read";
+export type { ReadContext } from "./read";
+export { write } from "./write";
+export type { WriteContext } from "./write";
+export { confirm } from "./confirm";
+export type { ConfirmContext } from "./confirm";
+/**
+ * `jue apply`'s Codex entry point: converts a resolved config into
+ * `CanonicalDocument`, computes the Artifact via `write()`, and applies the
+ * result to `outputDir`. `tools.codex` (target-private passthrough
+ * settings, never part of Canonical) flows through separately as
+ * `WriteContext` extensions in the future; for now it's read-side
+ * (config.toml passthrough via `agents` and the project-config keys).
+ */
+export declare function generate(config: any, outputDir: string): Promise<void>;
+declare const _default: import("ai-jue-core").ExtensionDefinition;
+export default _default;

package/dist/index.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirm = exports.write = exports.read = void 0;
+exports.generate = generate;
+const ai_jue_core_1 = require("ai-jue-core");
+const confirm_1 = require("./confirm");
+const read_1 = require("./read");
+const write_1 = require("./write");
+var read_2 = require("./read");
+Object.defineProperty(exports, "read", { enumerable: true, get: function () { return read_2.read; } });
+var write_2 = require("./write");
+Object.defineProperty(exports, "write", { enumerable: true, get: function () { return write_2.write; } });
+var confirm_2 = require("./confirm");
+Object.defineProperty(exports, "confirm", { enumerable: true, get: function () { return confirm_2.confirm; } });
+/**
+ * `jue apply`'s Codex entry point: converts a resolved config into
+ * `CanonicalDocument`, computes the Artifact via `write()`, and applies the
+ * result to `outputDir`. `tools.codex` (target-private passthrough
+ * settings, never part of Canonical) flows through separately as
+ * `WriteContext` extensions in the future; for now it's read-side
+ * (config.toml passthrough via `agents` and the project-config keys).
+ */
+async function generate(config, outputDir) {
+    const canonical = (0, ai_jue_core_1.toCanonicalDocument)(config);
+    const changes = await (0, write_1.write)(canonical, { projectRoot: outputDir, artifactKind: "project" });
+    (0, ai_jue_core_1.applyChangesOrThrow)(outputDir, changes);
+}
+const codexAdapter = {
+    id: "codex",
+    capabilities: {
+        rules: "degraded", // Codex has no separate Rules directory; rules fold into AGENTS.md via context
+        commands: "degraded", // Codex's custom-commands was deprecated; this is documented honestly
+        skills: "supported",
+        agents: "supported",
+        hooks: "supported",
+        mcp: "degraded", // Codex MCP config is TOML, out of scope for the JSON-based factory
+    },
+    read: read_1.read,
+    write: write_1.write,
+    confirm: confirm_1.confirm,
+};
+exports.default = (0, ai_jue_core_1.defineExtension)({ adapters: [codexAdapter] });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAqBA,4BAIC;AAzBD,6CAAwF;AAExF,uCAAoC;AACpC,iCAA8B;AAC9B,mCAAgC;AAEhC,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAEb,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAEd,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAGhB;;;;;;;GAOG;AACI,KAAK,UAAU,QAAQ,CAAC,MAAW,EAAE,SAAiB;IAC3D,MAAM,SAAS,GAAG,IAAA,iCAAmB,EAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,IAAA,aAAK,EAAC,SAAS,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5F,IAAA,iCAAmB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,YAAY,GAAY;IAC5B,EAAE,EAAE,OAAO;IACX,YAAY,EAAE;QACZ,KAAK,EAAE,UAAU,EAAE,+EAA+E;QAClG,QAAQ,EAAE,UAAU,EAAE,sEAAsE;QAC5F,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,WAAW;QAClB,GAAG,EAAE,UAAU,EAAE,oEAAoE;KACtF;IACD,IAAI,EAAJ,WAAI;IACJ,KAAK,EAAL,aAAK;IACL,OAAO,EAAP,iBAAO;CACR,CAAC;AAEF,kBAAe,IAAA,6BAAe,EAAC,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC"}

package/dist/read.d.ts

@@ -0,0 +1,5 @@
+import type { CanonicalDocument } from "ai-jue-core";
+export interface ReadContext {
+    projectRoot: string;
+}
+export declare function read({ projectRoot }: ReadContext): Promise<CanonicalDocument>;

package/dist/read.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.read = read;
+const ai_jue_core_1 = require("ai-jue-core");
+const agents_1 = require("./capabilities/agents");
+const commands_1 = require("./capabilities/commands");
+const context_1 = require("./capabilities/context");
+const hooks_1 = require("./capabilities/hooks");
+const mcp_1 = require("./capabilities/mcp");
+const skills_1 = require("./capabilities/skills");
+async function read({ projectRoot }) {
+    const canonical = (0, ai_jue_core_1.readCapabilities)({
+        context: (0, context_1.context)(),
+        commands: (0, commands_1.commands)(),
+        agents: (0, agents_1.agents)(),
+        skills: (0, skills_1.skills)(),
+        hooks: (0, hooks_1.hooks)(),
+        mcp: (0, mcp_1.mcp)(),
+    }, projectRoot);
+    return (0, ai_jue_core_1.toCanonicalDocument)(canonical);
+}
+//# sourceMappingURL=read.js.map

package/dist/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":";;AAaA,oBAaC;AA1BD,6CAAoE;AAEpE,kDAA+C;AAC/C,sDAAmD;AACnD,oDAAiD;AACjD,gDAA6C;AAC7C,4CAAyC;AACzC,kDAA+C;AAMxC,KAAK,UAAU,IAAI,CAAC,EAAE,WAAW,EAAe;IACrD,MAAM,SAAS,GAAG,IAAA,8BAAgB,EAChC;QACE,OAAO,EAAE,IAAA,iBAAO,GAAE;QAClB,QAAQ,EAAE,IAAA,mBAAQ,GAAE;QACpB,MAAM,EAAE,IAAA,eAAM,GAAE;QAChB,MAAM,EAAE,IAAA,eAAM,GAAE;QAChB,KAAK,EAAE,IAAA,aAAK,GAAE;QACd,GAAG,EAAE,IAAA,SAAG,GAAE;KACX,EACD,WAAW,CACZ,CAAC;IACF,OAAO,IAAA,iCAAmB,EAAC,SAA+C,CAAC,CAAC;AAC9E,CAAC"}

package/dist/write.d.ts

@@ -0,0 +1,30 @@
+import type { ArtifactChange, CanonicalDocument } from "ai-jue-core";
+import { type CodexPluginManifest } from "./capabilities/manifest";
+export interface WriteContext {
+    projectRoot: string;
+    artifactKind?: "project" | "plugin";
+    pluginManifest?: CodexPluginManifest;
+}
+/**
+ * Computes the `ArtifactChange[]` needed to make a Codex project or Plugin
+ * directory match `canonical`, without performing I/O itself — Core
+ * executes approved changes (per the Adapter/Core split frozen in JUE-103's
+ * Extension Host). Each Capability's native shape is declared in
+ * `./capabilities/*` and driven through the shared capability-mapping
+ * engine; the hand-written `agents` mapping exists because Codex agents
+ * are TOML, not the Markdown+frontmatter shape any factory produces.
+ *
+ * `commands` is a no-op round-trip (Codex's custom-commands mechanism was
+ * deprecated; see `capabilities/commands.ts` for the JUE-104/105 evidence).
+ * `mcp` is similarly a no-op (Codex MCP lives in the same TOML file as
+ * project settings; a real TOML parser is out of scope per the JUE-301
+ * honest-unsupported stance).
+ *
+ * For Plugin Artifacts, if `pluginManifest` is not explicitly provided we
+ * try to copy the existing on-disk manifest (e.g. a fixture's
+ * `.codex-plugin/plugin.json`) — this lets the contract test round-trip
+ * a Plugin fixture's manifest without forcing every caller to re-supply it.
+ * If neither is present, the manifest is left untouched (a manifest-less
+ * Plugin is Codex's documented `--plugin-dir` auto-discovery mode).
+ */
+export declare function write(canonical: CanonicalDocument, writeContext: WriteContext): Promise<ArtifactChange[]>;

package/dist/write.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.write = write;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ai_jue_core_1 = require("ai-jue-core");
+const agents_1 = require("./capabilities/agents");
+const commands_1 = require("./capabilities/commands");
+const context_1 = require("./capabilities/context");
+const layout_1 = require("./capabilities/layout");
+const hooks_1 = require("./capabilities/hooks");
+const mcp_1 = require("./capabilities/mcp");
+const manifest_1 = require("./capabilities/manifest");
+const skills_1 = require("./capabilities/skills");
+const TARGET = "codex";
+/**
+ * Computes the `ArtifactChange[]` needed to make a Codex project or Plugin
+ * directory match `canonical`, without performing I/O itself — Core
+ * executes approved changes (per the Adapter/Core split frozen in JUE-103's
+ * Extension Host). Each Capability's native shape is declared in
+ * `./capabilities/*` and driven through the shared capability-mapping
+ * engine; the hand-written `agents` mapping exists because Codex agents
+ * are TOML, not the Markdown+frontmatter shape any factory produces.
+ *
+ * `commands` is a no-op round-trip (Codex's custom-commands mechanism was
+ * deprecated; see `capabilities/commands.ts` for the JUE-104/105 evidence).
+ * `mcp` is similarly a no-op (Codex MCP lives in the same TOML file as
+ * project settings; a real TOML parser is out of scope per the JUE-301
+ * honest-unsupported stance).
+ *
+ * For Plugin Artifacts, if `pluginManifest` is not explicitly provided we
+ * try to copy the existing on-disk manifest (e.g. a fixture's
+ * `.codex-plugin/plugin.json`) — this lets the contract test round-trip
+ * a Plugin fixture's manifest without forcing every caller to re-supply it.
+ * If neither is present, the manifest is left untouched (a manifest-less
+ * Plugin is Codex's documented `--plugin-dir` auto-discovery mode).
+ */
+async function write(canonical, writeContext) {
+    const artifactKind = writeContext.artifactKind ?? ((0, layout_1.isProjectLayout)(writeContext.projectRoot) ? "project" : "project");
+    let changes = (0, ai_jue_core_1.writeCapabilities)({
+        commands: (0, commands_1.commands)(),
+        agents: (0, agents_1.agents)(),
+        skills: (0, skills_1.skills)(),
+        hooks: (0, hooks_1.hooks)(),
+        mcp: (0, mcp_1.mcp)(),
+    }, canonical, writeContext.projectRoot, TARGET);
+    if (artifactKind === "project" && canonical.context?.global) {
+        changes.push(...(0, context_1.context)().write(writeContext.projectRoot, { global: canonical.context.global }, TARGET));
+    }
+    if (artifactKind === "plugin") {
+        let manifest = writeContext.pluginManifest;
+        if (!manifest) {
+            // Try to read an existing on-disk manifest (a fixture's own).
+            const existingManifestPath = path_1.default.join(writeContext.projectRoot, ".codex-plugin", "plugin.json");
+            if (fs_1.default.existsSync(existingManifestPath)) {
+                try {
+                    manifest = JSON.parse(fs_1.default.readFileSync(existingManifestPath, "utf8"));
+                }
+                catch {
+                    // Malformed manifest — fall through; write no new manifest.
+                }
+            }
+        }
+        if (manifest) {
+            changes.push(...(0, manifest_1.writeCodexPluginManifest)(writeContext.projectRoot, manifest, TARGET));
+        }
+    }
+    return changes;
+}
+//# sourceMappingURL=write.js.map

package/dist/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../src/write.ts"],"names":[],"mappings":";;;;;AA2CA,sBA0CC;AArFD,4CAAoB;AACpB,gDAAwB;AACxB,6CAAgD;AAEhD,kDAA+C;AAC/C,sDAAmD;AACnD,oDAAiD;AACjD,kDAAwD;AACxD,gDAA6C;AAC7C,4CAAyC;AACzC,sDAA6F;AAC7F,kDAA+C;AAQ/C,MAAM,MAAM,GAAG,OAAO,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACI,KAAK,UAAU,KAAK,CACzB,SAA4B,EAC5B,YAA0B;IAE1B,MAAM,YAAY,GAAG,YAAY,CAAC,YAAY,IAAI,CAAC,IAAA,wBAAe,EAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEtH,IAAI,OAAO,GAAG,IAAA,+BAAiB,EAC7B;QACE,QAAQ,EAAE,IAAA,mBAAQ,GAAE;QACpB,MAAM,EAAE,IAAA,eAAM,GAAE;QAChB,MAAM,EAAE,IAAA,eAAM,GAAE;QAChB,KAAK,EAAE,IAAA,aAAK,GAAE;QACd,GAAG,EAAE,IAAA,SAAG,GAAE;KACX,EACD,SAA+C,EAC/C,YAAY,CAAC,WAAW,EACxB,MAAM,CACP,CAAC;IAEF,IAAI,YAAY,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,GAAG,IAAA,iBAAO,GAAE,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3G,CAAC;IAED,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,QAAQ,GAAG,YAAY,CAAC,cAAc,CAAC;QAC3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,8DAA8D;YAC9D,MAAM,oBAAoB,GAAG,cAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;YACjG,IAAI,YAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC;oBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAwB,CAAC;gBAC9F,CAAC;gBAAC,MAAM,CAAC;oBACP,4DAA4D;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,GAAG,IAAA,mCAAwB,EAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "ai-jue-adapter-codex",
+  "version": "0.2.0",
+  "description": "Adapter for generating project-scoped Codex configurations.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "ai-jue-core": "*"
+  },
+  "peerDependencies": {
+    "ai-jue-core": "*"
+  },
+  "devDependencies": {
+    "@iarna/toml": "^2.2.5"
+  },
+  "author": "AI-Jue Team <contact@ai-jue.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zenHeart/ai-jue.git",
+    "directory": "packages/ai-jue-adapter-codex"
+  },
+  "bugs": {
+    "url": "https://github.com/zenHeart/ai-jue/issues"
+  },
+  "homepage": "https://github.com/zenHeart/ai-jue/tree/main/packages/ai-jue-adapter-codex#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ]
+}