cdx-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Masao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# cdx-cli
+
+Codex SDK を使ってローカルの作業ディレクトリに対して実行する、シンプルな CLI ラッパーです。
+
+## 前提
+
+- Node.js 20+
+- npm
+- OpenAI API キー（例: `OPENAI_API_KEY`）
+
+## インストール
+
+```bash
+npm i -g cdx-cli
+```
+
+## 使い方
+
+```bash
+cdx-cli run -w <workdir> "やってほしいこと"
+```
+
+例:
+
+```bash
+cdx-cli run -w /Users/masao/project/my-app "テストを実行して失敗を直して"
+```
+
+## コマンド
+
+`cdx-cli run [options] "prompt"`
+
+オプション:
+
+- `--workdir, -w <path>`: 作業ディレクトリ（必須）
+- `--instructions, -i <path>`: 追加指示を読み込むテキストファイル
+- `--trace-file <path>`: トレースJSONの出力先
+- `--agent-id <id>`: トレースへ記録する任意のエージェントID
+- `--model, -m <model>`: 使用モデルの上書き
+
+## 出力
+
+標準出力に以下形式の JSON を返します。
+
+```json
+{
+  "session_id": "sess_xxx",
+  "status": "completed",
+  "files_changed": [
+    { "path": "src/foo.ts", "kind": "update" }
+  ],
+  "final_response": "作業内容の要約",
+  "duration_ms": 12345
+}
+```
+
+終了コード:
+
+- `0`: 成功（`status=completed`）
+- `1`: 実行失敗（`status=failed`）
+- `2`: CLI 実行時の致命エラー
+
+## トレースファイル
+
+実行ごとに `.agent-trace.json` へ追記します。
+
+- `--trace-file` 未指定時は、Git リポジトリのルート（サブモジュール時は superproject ルート）に出力
+- Git 管理外ディレクトリでは `<workdir>/.agent-trace.json` に出力
+
+## 開発用コマンド
+
+```bash
+npm install
+npm run build
+npm run typecheck
+npm run start -- --help
+```

package/dist/commands/run.d.ts

@@ -0,0 +1,5 @@
+import type { RunOptions } from "../types.js";
+/** CLI 引数をパースして RunOptions を生成 */
+export declare function parseRunArgs(args: string[]): RunOptions;
+/** run コマンドを実行 */
+export declare function executeRun(args: string[]): Promise<void>;

package/dist/commands/run.js

@@ -0,0 +1,71 @@
+import { resolve } from "node:path";
+import { runSession } from "../core/session.js";
+/** CLI 引数をパースして RunOptions を生成 */
+export function parseRunArgs(args) {
+    let workdir;
+    let instructions;
+    let traceFile;
+    let agentId;
+    let model;
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case "--workdir":
+            case "-w":
+                workdir = args[++i];
+                break;
+            case "--instructions":
+            case "-i":
+                instructions = args[++i];
+                break;
+            case "--trace-file":
+                traceFile = args[++i];
+                break;
+            case "--agent-id":
+                agentId = args[++i];
+                break;
+            case "--model":
+            case "-m":
+                model = args[++i];
+                break;
+            default:
+                if (!arg.startsWith("-")) {
+                    positional.push(arg);
+                }
+                break;
+        }
+    }
+    if (!workdir) {
+        process.stderr.write("Error: --workdir (-w) is required\n");
+        process.exit(1);
+    }
+    const prompt = positional.join(" ");
+    if (!prompt) {
+        process.stderr.write("Error: prompt is required\n");
+        process.exit(1);
+    }
+    return {
+        workdir: resolve(workdir),
+        instructions: instructions ? resolve(instructions) : undefined,
+        traceFile: traceFile ? resolve(traceFile) : undefined,
+        agentId,
+        model,
+        prompt,
+    };
+}
+/** run コマンドを実行 */
+export async function executeRun(args) {
+    const options = parseRunArgs(args);
+    try {
+        const result = await runSession(options);
+        process.stdout.write(JSON.stringify(result, null, 2) + "\n");
+        process.exit(result.status === "completed" ? 0 : 1);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[cdx] fatal: ${message}\n`);
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,kCAAkC;AAClC,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,IAAI,OAA2B,CAAC;IAChC,IAAI,YAAgC,CAAC;IACrC,IAAI,SAA6B,CAAC;IAClC,IAAI,OAA2B,CAAC;IAChC,IAAI,KAAyB,CAAC;IAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;QACrB,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,WAAW,CAAC;YACjB,KAAK,IAAI;gBACP,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpB,MAAM;YACR,KAAK,gBAAgB,CAAC;YACtB,KAAK,IAAI;gBACP,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzB,MAAM;YACR,KAAK,cAAc;gBACjB,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACtB,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpB,MAAM;YACR,KAAK,SAAS,CAAC;YACf,KAAK,IAAI;gBACP,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClB,MAAM;YACR;gBACE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;gBACD,MAAM;QACV,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;QACzB,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;QAC9D,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;QACrD,OAAO;QACP,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED,kBAAkB;AAClB,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAc;IAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,OAAO,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/core/event-handler.d.ts

@@ -0,0 +1,5 @@
+import type { ThreadEvent, EventAccumulator } from "../types.js";
+/** 空の蓄積状態を生成 */
+export declare function createAccumulator(): EventAccumulator;
+/** ThreadEvent を処理し、蓄積状態を更新する */
+export declare function handleEvent(acc: EventAccumulator, event: ThreadEvent): void;

package/dist/core/event-handler.js

@@ -0,0 +1,72 @@
+/** 空の蓄積状態を生成 */
+export function createAccumulator() {
+    return {
+        sessionId: null,
+        filesChanged: [],
+        finalResponse: "",
+        status: "completed",
+        usage: null,
+    };
+}
+/** stderr にログ出力 */
+function log(msg) {
+    process.stderr.write(`[cdx] ${msg}\n`);
+}
+/** ThreadEvent を処理し、蓄積状態を更新する */
+export function handleEvent(acc, event) {
+    switch (event.type) {
+        case "thread.started":
+            acc.sessionId = event.thread_id;
+            log(`session: ${event.thread_id}`);
+            break;
+        case "turn.started":
+            log("turn started");
+            break;
+        case "turn.completed":
+            acc.usage = event.usage;
+            log(`turn completed (tokens: in=${event.usage.input_tokens} out=${event.usage.output_tokens})`);
+            break;
+        case "turn.failed":
+            acc.status = "failed";
+            acc.error = event.error.message;
+            log(`turn failed: ${event.error.message}`);
+            break;
+        case "item.completed":
+            handleItemCompleted(acc, event.item);
+            break;
+        case "item.started":
+        case "item.updated":
+            // stderr に進捗表示のみ
+            if (event.item.type === "command_execution" && event.type === "item.started") {
+                log(`exec: ${event.item.command}`);
+            }
+            break;
+        case "error":
+            acc.status = "failed";
+            acc.error = event.message;
+            log(`error: ${event.message}`);
+            break;
+    }
+}
+function handleItemCompleted(acc, item) {
+    switch (item.type) {
+        case "file_change": {
+            const changes = item.changes.map((c) => ({
+                path: c.path,
+                kind: c.kind,
+            }));
+            acc.filesChanged.push(...changes);
+            for (const c of changes) {
+                log(`file ${c.kind}: ${c.path}`);
+            }
+            break;
+        }
+        case "command_execution":
+            log(`exec done: ${item.command} (exit=${item.exit_code ?? "?"})`);
+            break;
+        case "agent_message":
+            acc.finalResponse = item.text;
+            break;
+    }
+}
+//# sourceMappingURL=event-handler.js.map

package/dist/core/event-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler.js","sourceRoot":"","sources":["../../src/core/event-handler.ts"],"names":[],"mappings":"AAOA,gBAAgB;AAChB,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,EAAE;QACjB,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED,mBAAmB;AACnB,SAAS,GAAG,CAAC,GAAW;IACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,WAAW,CACzB,GAAqB,EACrB,KAAkB;IAElB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,gBAAgB;YACnB,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YAChC,GAAG,CAAC,YAAY,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;YACnC,MAAM;QAER,KAAK,cAAc;YACjB,GAAG,CAAC,cAAc,CAAC,CAAC;YACpB,MAAM;QAER,KAAK,gBAAgB;YACnB,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACxB,GAAG,CACD,8BAA8B,KAAK,CAAC,KAAK,CAAC,YAAY,QAAQ,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,CAC3F,CAAC;YACF,MAAM;QAER,KAAK,aAAa;YAChB,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;YACtB,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;YAChC,GAAG,CAAC,gBAAgB,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,MAAM;QAER,KAAK,gBAAgB;YACnB,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM;QAER,KAAK,cAAc,CAAC;QACpB,KAAK,cAAc;YACjB,iBAAiB;YACjB,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAC7E,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACrC,CAAC;YACD,MAAM;QAER,KAAK,OAAO;YACV,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC;YACtB,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC;YAC1B,GAAG,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/B,MAAM;IACV,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAC1B,GAAqB,EACrB,IAAgB;IAEhB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,OAAO,GAAiB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrD,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC,CAAC;YACJ,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;YAClC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnC,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,mBAAmB;YACtB,GAAG,CACD,cAAc,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,SAAS,IAAI,GAAG,GAAG,CAC7D,CAAC;YACF,MAAM;QAER,KAAK,eAAe;YAClB,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC;YAC9B,MAAM;IACV,CAAC;AACH,CAAC"}

package/dist/core/session.d.ts

@@ -0,0 +1,3 @@
+import type { RunOptions, RunResult } from "../types.js";
+/** Codex セッションを実行し、結果を返す */
+export declare function runSession(options: RunOptions): Promise<RunResult>;

package/dist/core/session.js

@@ -0,0 +1,111 @@
+import { Codex } from "@openai/codex-sdk";
+import { createAccumulator, handleEvent } from "./event-handler.js";
+import { appendTrace, resolveTraceFilePath } from "./trace-writer.js";
+import { readFile } from "node:fs/promises";
+import { execSync } from "node:child_process";
+/** Codex セッションを実行し、結果を返す */
+export async function runSession(options) {
+    const startTime = Date.now();
+    const codex = new Codex({
+        ...(options.model ? { config: { model: options.model } } : {}),
+    });
+    const thread = codex.startThread({
+        workingDirectory: options.workdir,
+        sandboxMode: "workspace-write",
+        approvalPolicy: "never",
+    });
+    // プロンプト構築: instructions + タスク
+    let prompt = options.prompt;
+    if (options.instructions) {
+        const instructionsContent = await readFile(options.instructions, "utf-8");
+        prompt = `${instructionsContent}\n\n---\n\n${prompt}`;
+    }
+    const acc = createAccumulator();
+    const streamed = await thread.runStreamed(prompt);
+    for await (const event of streamed.events) {
+        handleEvent(acc, event);
+    }
+    const durationMs = Date.now() - startTime;
+    // git で実際の変更を検出（FileChangeItem だけでは shell 経由の変更を拾えない）
+    const gitChanges = detectGitChanges(options.workdir);
+    const filesChanged = mergeFileChanges(acc.filesChanged, gitChanges);
+    const result = {
+        session_id: acc.sessionId ?? "unknown",
+        status: acc.status,
+        files_changed: filesChanged,
+        final_response: acc.finalResponse,
+        duration_ms: durationMs,
+    };
+    // トレース書き込み
+    const traceFilePath = options.traceFile ?? await resolveTraceFilePath(options.workdir);
+    const transcriptPath = resolveTranscriptPath(acc.sessionId);
+    const traceEntry = {
+        coding_agent: "codex",
+        session_id: acc.sessionId ?? "unknown",
+        agent_id: options.agentId ?? "",
+        status: acc.status,
+        files_changed: filesChanged,
+        timestamp: new Date().toISOString(),
+        duration_ms: durationMs,
+        transcript: transcriptPath,
+    };
+    await appendTrace(traceFilePath, traceEntry);
+    return result;
+}
+/** git status + diff で実際のファイル変更を検出 */
+function detectGitChanges(workdir) {
+    try {
+        // --porcelain=v1: M/A/D/?? をパース
+        const output = execSync("git status --porcelain", {
+            cwd: workdir,
+            encoding: "utf-8",
+        }).trim();
+        if (!output)
+            return [];
+        return output.split("\n").map((line) => {
+            const status = line.substring(0, 2).trim();
+            const filePath = line.substring(3);
+            let kind;
+            switch (status) {
+                case "D":
+                    kind = "delete";
+                    break;
+                case "??":
+                case "A":
+                    kind = "add";
+                    break;
+                default:
+                    kind = "update";
+                    break;
+            }
+            return { path: filePath, kind };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/** SDK の FileChangeItem と git 検出結果をマージ（重複排除） */
+function mergeFileChanges(sdkChanges, gitChanges) {
+    const seen = new Set(sdkChanges.map((c) => c.path));
+    const merged = [...sdkChanges];
+    for (const gc of gitChanges) {
+        if (!seen.has(gc.path)) {
+            merged.push(gc);
+            seen.add(gc.path);
+        }
+    }
+    return merged;
+}
+/** Codex セッションの transcript パスを推定 */
+function resolveTranscriptPath(sessionId) {
+    if (!sessionId)
+        return "";
+    const home = process.env["HOME"] ?? "";
+    const now = new Date();
+    const y = now.getFullYear();
+    const m = String(now.getMonth() + 1).padStart(2, "0");
+    const d = String(now.getDate()).padStart(2, "0");
+    return `${home}/.codex/sessions/${y}/${m}/${d}`;
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

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

package/dist/core/trace-writer.d.ts

@@ -0,0 +1,5 @@
+import type { TraceEntry } from "../types.js";
+/** .agent-trace.json にトレースエントリを追記する */
+export declare function appendTrace(traceFilePath: string, entry: TraceEntry): Promise<void>;
+/** git common-dir からトレースファイルパスを算出 */
+export declare function resolveTraceFilePath(workdir: string): Promise<string>;

package/dist/core/trace-writer.js

@@ -0,0 +1,36 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+const TRACE_VERSION = "0.1.0";
+/** .agent-trace.json を読み込む。存在しなければ空構造を返す */
+async function readTraceFile(path) {
+    if (!existsSync(path)) {
+        return { version: TRACE_VERSION, traces: [] };
+    }
+    const raw = await readFile(path, "utf-8");
+    return JSON.parse(raw);
+}
+/** .agent-trace.json にトレースエントリを追記する */
+export async function appendTrace(traceFilePath, entry) {
+    const traceFile = await readTraceFile(traceFilePath);
+    traceFile.traces.push(entry);
+    await writeFile(traceFilePath, JSON.stringify(traceFile, null, 2) + "\n");
+}
+/** git common-dir からトレースファイルパスを算出 */
+export async function resolveTraceFilePath(workdir) {
+    const { execSync } = await import("node:child_process");
+    try {
+        const superproject = execSync("git rev-parse --show-superproject-working-tree", {
+            cwd: workdir,
+            encoding: "utf-8",
+        }).trim();
+        const toplevel = superproject || execSync("git rev-parse --show-toplevel", {
+            cwd: workdir,
+            encoding: "utf-8",
+        }).trim();
+        return `${toplevel}/.agent-trace.json`;
+    }
+    catch {
+        return `${workdir}/.agent-trace.json`;
+    }
+}
+//# sourceMappingURL=trace-writer.js.map

package/dist/core/trace-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-writer.js","sourceRoot":"","sources":["../../src/core/trace-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,MAAM,aAAa,GAAG,OAAO,CAAC;AAE9B,4CAA4C;AAC5C,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;AACtC,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,aAAqB,EACrB,KAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC;IACrD,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe;IAEf,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,QAAQ,CAAC,gDAAgD,EAAE;YAC9E,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,QAAQ,GAAG,YAAY,IAAI,QAAQ,CAAC,+BAA+B,EAAE;YACzE,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,QAAQ,oBAAoB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,OAAO,oBAAoB,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { executeRun } from "./commands/run.js";
+const USAGE = `cdx-cli - Codex SDK wrapper CLI
+
+Usage:
+  cdx-cli run [options] "prompt"
+
+Options:
+  --workdir, -w <path>       Working directory (required)
+  --instructions, -i <path>  Instructions file
+  --trace-file <path>        Trace output path
+  --agent-id <id>            Agent ID
+  --model, -m <model>        Model override
+`;
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (!command || command === "--help" || command === "-h") {
+        process.stderr.write(USAGE);
+        process.exit(command ? 0 : 1);
+    }
+    switch (command) {
+        case "run":
+            await executeRun(args.slice(1));
+            break;
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n${USAGE}`);
+            process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,KAAK,GAAG;;;;;;;;;;;CAWb,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,KAAK;YACR,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM;QACR;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+import type { ThreadEvent, ThreadItem, FileChangeItem, CommandExecutionItem, AgentMessageItem, Usage } from "@openai/codex-sdk";
+/** CLI run コマンドのオプション */
+export interface RunOptions {
+    workdir: string;
+    instructions?: string;
+    traceFile?: string;
+    agentId?: string;
+    model?: string;
+    prompt: string;
+}
+/** ファイル変更記録 */
+export interface FileChange {
+    path: string;
+    kind: "add" | "delete" | "update";
+}
+/** run コマンドの実行結果（stdout JSON） */
+export interface RunResult {
+    session_id: string;
+    status: "completed" | "failed";
+    files_changed: FileChange[];
+    final_response: string;
+    duration_ms: number;
+}
+/** .agent-trace.json 内の個別トレースエントリ */
+export interface TraceEntry {
+    coding_agent: string;
+    session_id: string;
+    agent_id: string;
+    status: "completed" | "failed";
+    files_changed: FileChange[];
+    timestamp: string;
+    duration_ms: number;
+    transcript: string;
+}
+/** .agent-trace.json のルート構造 */
+export interface TraceFile {
+    version: string;
+    traces: TraceEntry[];
+}
+/** イベントハンドラが蓄積する状態 */
+export interface EventAccumulator {
+    sessionId: string | null;
+    filesChanged: FileChange[];
+    finalResponse: string;
+    status: "completed" | "failed";
+    error?: string;
+    usage: Usage | null;
+}
+export type { ThreadEvent, ThreadItem, FileChangeItem, CommandExecutionItem, AgentMessageItem, Usage, };

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "cdx-cli",
+  "version": "0.1.0",
+  "description": "Codex SDK wrapper CLI for local coding tasks",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "cdx-cli": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MASAKASUNO1/cdx-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MASAKASUNO1/cdx-cli/issues"
+  },
+  "homepage": "https://github.com/MASAKASUNO1/cdx-cli#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run typecheck && npm run build",
+    "typecheck": "tsc --noEmit",
+    "start": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@openai/codex-sdk": "^0.98.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.0",
+    "tsx": "^4.19.0",
+    "@types/node": "^22.0.0"
+  }
+}