@gkorepanov/ccodex 0.3.0

package/dist/handoff/store.d.ts

@@ -0,0 +1,28 @@
+import type { Thread } from "../codex/generated/v2/Thread.js";
+import type { ThreadSettingsUpdateParams } from "../codex/generated/v2/ThreadSettingsUpdateParams.js";
+import type { Turn } from "../codex/generated/v2/Turn.js";
+export type ProviderKind = "claude" | "stock";
+export interface PendingProviderSwitch {
+    readonly threadId: string;
+    readonly sourceProvider: ProviderKind;
+    readonly targetProvider: ProviderKind;
+    readonly targetModel: string;
+    readonly settings: ThreadSettingsUpdateParams;
+}
+export interface StockHistoryOverlay {
+    readonly threadId: string;
+    readonly sourceThreadId: string;
+    readonly sourceThread: Thread;
+    readonly inheritedTurns: Turn[];
+}
+export declare class HandoffStore {
+    private readonly database;
+    constructor(path: string);
+    setPending(pending: PendingProviderSwitch): void;
+    getPending(threadId: string): PendingProviderSwitch | undefined;
+    clearPending(threadId: string): void;
+    setOverlay(overlay: StockHistoryOverlay): void;
+    getOverlay(threadId: string): StockHistoryOverlay | undefined;
+    clearOverlay(threadId: string): void;
+    close(): void;
+}

package/dist/handoff/store.js

@@ -0,0 +1,86 @@
+import { chmodSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+export class HandoffStore {
+    database;
+    constructor(path) {
+        mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+        this.database = new DatabaseSync(path);
+        this.database.exec(`
+      PRAGMA journal_mode=WAL;
+      PRAGMA synchronous=FULL;
+      PRAGMA busy_timeout=5000;
+      CREATE TABLE IF NOT EXISTS pending_provider_switches (
+        thread_id TEXT PRIMARY KEY,
+        source_provider TEXT NOT NULL,
+        target_provider TEXT NOT NULL,
+        target_model TEXT NOT NULL,
+        settings_json TEXT NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS stock_history_overlays (
+        thread_id TEXT PRIMARY KEY,
+        source_thread_id TEXT NOT NULL,
+        source_thread_json TEXT NOT NULL,
+        turns_json TEXT NOT NULL,
+        created_at INTEGER NOT NULL
+      );
+    `);
+        chmodSync(path, 0o600);
+    }
+    setPending(pending) {
+        this.database.prepare(`
+      INSERT INTO pending_provider_switches (
+        thread_id, source_provider, target_provider, target_model, settings_json, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(thread_id) DO UPDATE SET
+        source_provider = excluded.source_provider,
+        target_provider = excluded.target_provider,
+        target_model = excluded.target_model,
+        settings_json = excluded.settings_json,
+        updated_at = excluded.updated_at
+    `).run(pending.threadId, pending.sourceProvider, pending.targetProvider, pending.targetModel, JSON.stringify(pending.settings), Date.now());
+    }
+    getPending(threadId) {
+        const row = this.database.prepare("SELECT * FROM pending_provider_switches WHERE thread_id = ?")
+            .get(threadId);
+        return row ? {
+            threadId: row.thread_id,
+            sourceProvider: row.source_provider,
+            targetProvider: row.target_provider,
+            targetModel: row.target_model,
+            settings: JSON.parse(row.settings_json),
+        } : undefined;
+    }
+    clearPending(threadId) {
+        this.database.prepare("DELETE FROM pending_provider_switches WHERE thread_id = ?").run(threadId);
+    }
+    setOverlay(overlay) {
+        this.database.prepare(`
+      INSERT INTO stock_history_overlays (
+        thread_id, source_thread_id, source_thread_json, turns_json, created_at
+      ) VALUES (?, ?, ?, ?, ?)
+      ON CONFLICT(thread_id) DO UPDATE SET
+        source_thread_id = excluded.source_thread_id,
+        source_thread_json = excluded.source_thread_json,
+        turns_json = excluded.turns_json
+    `).run(overlay.threadId, overlay.sourceThreadId, JSON.stringify(overlay.sourceThread), JSON.stringify(overlay.inheritedTurns), Date.now());
+    }
+    getOverlay(threadId) {
+        const row = this.database.prepare("SELECT * FROM stock_history_overlays WHERE thread_id = ?")
+            .get(threadId);
+        return row ? {
+            threadId: row.thread_id,
+            sourceThreadId: row.source_thread_id,
+            sourceThread: JSON.parse(row.source_thread_json),
+            inheritedTurns: JSON.parse(row.turns_json),
+        } : undefined;
+    }
+    clearOverlay(threadId) {
+        this.database.prepare("DELETE FROM stock_history_overlays WHERE thread_id = ?").run(threadId);
+    }
+    close() {
+        this.database.close();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/handoff/store.js.map

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

package/dist/management/commands.d.ts

@@ -0,0 +1,3 @@
+import type { HybridConfig } from "../config/config.js";
+export declare function runEarlyManagementCommand(args: readonly string[]): Promise<number | undefined>;
+export declare function runManagementCommand(config: HybridConfig, args: readonly string[]): Promise<number | undefined>;

package/dist/management/commands.js

@@ -0,0 +1,33 @@
+import { delegate } from "../cli/delegate.js";
+import { printDoctor, runDoctor } from "./doctor.js";
+import { setup } from "./setup.js";
+import { rollback, uninstall, update } from "./lifecycle.js";
+export async function runEarlyManagementCommand(args) {
+    if (args[0] === "setup")
+        return setup(args.slice(1));
+    if (args[0] === "update")
+        return update(args.slice(1));
+    if (args[0] === "rollback")
+        return rollback(args.slice(1));
+    if (args[0] === "uninstall")
+        return uninstall(args.slice(1));
+    return undefined;
+}
+export async function runManagementCommand(config, args) {
+    if (args[0] === "doctor") {
+        const unexpected = args.slice(1).filter((arg) => arg !== "--json" && arg !== "--deep");
+        if (unexpected.length > 0)
+            throw new Error(`Unexpected doctor options: ${unexpected.join(" ")}`);
+        return printDoctor(await runDoctor(config, args.includes("--deep")), args.includes("--json"));
+    }
+    if (args[0] === "auth" && args[1] === "codex" && args.length === 2) {
+        return delegate(config.realCodex, ["login"]);
+    }
+    if (args[0] === "auth" && args[1] === "claude" && args.length === 2) {
+        return delegate(config.claudeBinary, ["auth", "login"]);
+    }
+    if (args[0] === "auth")
+        throw new Error("Usage: ccodex auth codex|claude");
+    return undefined;
+}
+//# sourceMappingURL=commands.js.map

package/dist/management/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/management/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAuB;IACrE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAoB,EAAE,IAAuB;IACtF,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,QAAQ,CAAC,CAAC;QACvF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,OAAO,WAAW,CAAC,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,OAAO,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC3E,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/management/doctor.d.ts

@@ -0,0 +1,12 @@
+import type { HybridConfig } from "../config/config.js";
+type CheckStatus = "ok" | "error";
+export interface DoctorCheck {
+    readonly id: string;
+    readonly status: CheckStatus;
+    readonly detected: string;
+    readonly expected: string;
+    readonly repair?: string;
+}
+export declare function runDoctor(config: HybridConfig, deep?: boolean): Promise<DoctorCheck[]>;
+export declare function printDoctor(checks: readonly DoctorCheck[], json: boolean): number;
+export {};

package/dist/management/doctor.js

@@ -0,0 +1,204 @@
+import { constants, existsSync, mkdirSync, statSync } from "node:fs";
+import { access } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { createConnection } from "node:net";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+import { promisify } from "node:util";
+import WebSocket from "ws";
+import { claudeAgentSdkVersion, compatibilityManifest, executableVersion, } from "../compatibility/probe.js";
+import { relayBinary } from "../gateway/remoteRelay.js";
+import { runtimePlatformKey } from "../runtime/dependencies.js";
+import { probeAppServer } from "../daemon/probe.js";
+import { reconcileManagedProcess } from "../daemon/supervisor.js";
+import { installLayout } from "./layout.js";
+const execute = promisify(execFile);
+function check(id, valid, detected, expected, repair) {
+    return { id, status: valid ? "ok" : "error", detected, expected, ...(!valid && repair ? { repair } : {}) };
+}
+function hasVersion(output, expected) {
+    return new RegExp(`(^|[^0-9.])${expected.replaceAll(".", "\\.")}([^0-9.]|$)`).test(output);
+}
+async function output(command, args) {
+    const result = await execute(command, args, { timeout: 10_000, maxBuffer: 128 * 1024 });
+    return `${result.stdout}${result.stderr}`.trim();
+}
+async function authChecks(config) {
+    const checks = [];
+    try {
+        const detected = await output(config.realCodex, ["login", "status"]);
+        checks.push(check("codex-auth", /logged in/i.test(detected), detected || "not logged in", "logged in", "ccodex auth codex"));
+    }
+    catch (error) {
+        checks.push(check("codex-auth", false, String(error), "logged in", "ccodex auth codex"));
+    }
+    try {
+        const detected = await output(config.claudeBinary, ["auth", "status"]);
+        const status = JSON.parse(detected);
+        checks.push(check("claude-auth", status.loggedIn === true, detected, "loggedIn: true", "ccodex auth claude"));
+    }
+    catch (error) {
+        checks.push(check("claude-auth", false, String(error), "loggedIn: true", "ccodex auth claude"));
+    }
+    return checks;
+}
+async function modelCatalog(socketPath) {
+    return new Promise((resolve, reject) => {
+        const webSocket = new WebSocket("ws://ccodex/rpc", {
+            createConnection: () => createConnection(socketPath),
+            perMessageDeflate: false,
+            maxPayload: 64 * 1024 * 1024,
+        });
+        const timer = setTimeout(() => finish(new Error("timed out reading merged model catalog")), 10_000);
+        const finish = (error, models) => {
+            clearTimeout(timer);
+            webSocket.removeAllListeners();
+            webSocket.terminate();
+            error ? reject(error) : resolve(models);
+        };
+        webSocket.once("error", (error) => finish(error));
+        webSocket.once("open", () => webSocket.send(JSON.stringify({
+            id: 1,
+            method: "initialize",
+            params: { clientInfo: { name: "ccodex_doctor", title: "CCodex Doctor", version: compatibilityManifest().productVersion } },
+        })));
+        webSocket.on("message", (bytes) => {
+            try {
+                const message = JSON.parse(bytes.toString());
+                if (message.error)
+                    throw new Error(message.error.message ?? "app-server RPC failed");
+                if (message.id === 1) {
+                    webSocket.send(JSON.stringify({ method: "initialized", params: {} }));
+                    webSocket.send(JSON.stringify({ id: 2, method: "model/list", params: { limit: 100 } }));
+                }
+                else if (message.id === 2) {
+                    finish(undefined, (message.result?.data ?? []).map((entry) => entry.id).filter((id) => typeof id === "string"));
+                }
+            }
+            catch (error) {
+                finish(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    });
+}
+async function deepChecks(config) {
+    const checks = [];
+    const expected = compatibilityManifest();
+    try {
+        const info = await probeAppServer(config.publicSocket);
+        checks.push(check("daemon-ready", hasVersion(info.appServerVersion, expected.codexCli), info.appServerVersion, expected.codexCli, "codex app-server daemon restart"));
+    }
+    catch (error) {
+        checks.push(check("daemon-ready", false, String(error), "managed gateway responding", "codex app-server daemon start"));
+    }
+    try {
+        const models = await modelCatalog(config.publicSocket);
+        const stock = models.filter((id) => id.startsWith("gpt-")).length;
+        const claude = models.filter((id) => id.startsWith(config.modelPrefix)).length;
+        checks.push(check("merged-models", stock > 0 && claude > 0, `${stock} Codex, ${claude} Claude`, "both provider catalogs", "codex app-server daemon restart"));
+    }
+    catch (error) {
+        checks.push(check("merged-models", false, String(error), "both provider catalogs", "codex app-server daemon restart"));
+    }
+    const layout = installLayout();
+    try {
+        const { stdout } = await execute(process.env.SHELL ?? "/bin/sh", ["-lc", "command -v codex"], { timeout: 10_000, maxBuffer: 64 * 1024 });
+        const detected = stdout.trim().split("\n").at(-1) ?? "";
+        checks.push(check("shell-routing", detected === join(layout.bin, "codex"), detected || "not found", join(layout.bin, "codex"), "ccodex setup --repair"));
+    }
+    catch (error) {
+        checks.push(check("shell-routing", false, String(error), join(layout.bin, "codex"), "ccodex setup --repair"));
+    }
+    const socketParent = dirname(config.publicSocket);
+    const parentMode = existsSync(socketParent) ? statSync(socketParent).mode & 0o777 : 0;
+    checks.push(check("socket-dir-mode", parentMode !== 0 && (parentMode & 0o077) === 0, parentMode.toString(8), "0700", `chmod 700 ${socketParent}`));
+    const captures = ["rpc.jsonl", "rpc.jsonl.1", "debug.jsonl"].map((name) => join(config.dataDir, name)).filter(existsSync);
+    const unsafeCapture = captures.find((path) => (statSync(path).mode & 0o077) !== 0);
+    checks.push(check("capture-modes", !unsafeCapture, unsafeCapture ?? `${captures.length} private capture files`, "0600", unsafeCapture ? `chmod 600 ${unsafeCapture}` : undefined));
+    const pidFile = join(process.env.CODEX_HOME ?? join(homedir(), ".codex"), "app-server-daemon", "app-server.pid");
+    const managed = reconcileManagedProcess(pidFile);
+    checks.push(check("managed-process", Boolean(managed), managed ? `pid ${managed.pid}` : "not managed", "one owned gateway process", "codex app-server daemon restart"));
+    return checks;
+}
+export async function runDoctor(config, deep = false) {
+    const expected = compatibilityManifest();
+    const checks = [];
+    const key = runtimePlatformKey();
+    const report = process.report?.getReport();
+    const glibc = report?.header?.glibcVersionRuntime;
+    const [glibcMajor = 0, glibcMinor = 0] = glibc?.split(".").map(Number) ?? [];
+    const supportedPlatform = /^(darwin-(arm64|x64)|linux-(arm64|x64)-gnu)$/.test(key) &&
+        (process.platform !== "linux" || glibcMajor > 2 || (glibcMajor === 2 && glibcMinor >= 31));
+    checks.push(check("platform", supportedPlatform, glibc ? `${key} (glibc ${glibc})` : key, "macOS 11+ arm64/x64 or Linux glibc >=2.31 arm64/x64", "Use macOS 11+ or a supported glibc-based Linux host; Alpine/musl is not supported."));
+    const [major = 0, minor = 0] = process.versions.node.split(".").map(Number);
+    checks.push(check("node", major >= 22 && major < 27 && (major !== 22 || minor >= 13), process.versions.node, expected.node, "Install Node.js 22 or 24 LTS."));
+    try {
+        const detected = await output("npm", ["--version"]);
+        checks.push(check("npm", Number(detected.split(".")[0]) >= 10, detected, ">=10", "Update npm: npm install -g npm@latest"));
+    }
+    catch (error) {
+        checks.push(check("npm", false, String(error), ">=10", "Install npm with Node.js 22 or 24 LTS."));
+    }
+    try {
+        const binary = relayBinary();
+        await access(binary, constants.X_OK);
+        checks.push(check("relay", true, binary, "installed executable"));
+    }
+    catch (error) {
+        checks.push(check("relay", false, String(error), "installed executable", "npm install -g @gkorepanov/ccodex --include=optional"));
+    }
+    try {
+        const detected = await executableVersion(config.realCodex);
+        checks.push(check("codex-version", hasVersion(detected, expected.codexCli), detected, expected.codexCli, "npm install -g @gkorepanov/ccodex"));
+    }
+    catch (error) {
+        checks.push(check("codex-version", false, String(error), expected.codexCli, "npm install -g @gkorepanov/ccodex"));
+    }
+    if (config.delegateCodex) {
+        try {
+            checks.push(check("delegated-codex", true, `${await executableVersion(config.delegateCodex)} (${config.delegateCodex})`, "any user-selected Codex CLI"));
+        }
+        catch (error) {
+            checks.push(check("delegated-codex", false, String(error), "working Codex CLI", "Unset CCODEX_DELEGATE_CODEX or point it at a working Codex."));
+        }
+    }
+    try {
+        const detected = await executableVersion(config.claudeBinary);
+        checks.push(check("claude-version", hasVersion(detected, expected.claudeCode), detected, expected.claudeCode, "npm install -g @gkorepanov/ccodex --include=optional"));
+    }
+    catch (error) {
+        checks.push(check("claude-version", false, String(error), expected.claudeCode, "npm install -g @gkorepanov/ccodex --include=optional"));
+    }
+    const sdk = claudeAgentSdkVersion();
+    checks.push(check("claude-sdk", sdk === expected.claudeAgentSdk, sdk, expected.claudeAgentSdk, "npm install -g @gkorepanov/ccodex"));
+    if (!existsSync(config.dataDir))
+        mkdirSync(config.dataDir, { recursive: true, mode: 0o700 });
+    const mode = statSync(config.dataDir).mode & 0o777;
+    checks.push(check("data-dir-mode", (mode & 0o077) === 0, mode.toString(8), "0700", `chmod 700 ${config.dataDir}`));
+    try {
+        await access(config.dataDir, constants.W_OK);
+        checks.push(check("data-dir-writable", true, config.dataDir, "writable"));
+    }
+    catch (error) {
+        checks.push(check("data-dir-writable", false, String(error), "writable", `chmod u+w ${config.dataDir}`));
+    }
+    checks.push(...await authChecks(config));
+    if (deep)
+        checks.push(...await deepChecks(config));
+    return checks;
+}
+export function printDoctor(checks, json) {
+    const ok = checks.every((item) => item.status === "ok");
+    if (json) {
+        process.stdout.write(`${JSON.stringify({ ok, checks }, null, 2)}\n`);
+    }
+    else {
+        for (const item of checks) {
+            process.stdout.write(`${item.status === "ok" ? "✓" : "✗"} ${item.id}: ${item.detected}\n`);
+            if (item.status === "error")
+                process.stdout.write(`  expected: ${item.expected}\n  repair: ${item.repair}\n`);
+        }
+    }
+    return ok ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/management/doctor.js.map

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

package/dist/management/layout.d.ts

@@ -0,0 +1,14 @@
+export interface InstallLayout {
+    readonly home: string;
+    readonly bin: string;
+    readonly versions: string;
+    readonly staging: string;
+    readonly state: string;
+    readonly current: string;
+    readonly previous: string;
+    readonly manifest: string;
+}
+export declare function installLayout(): InstallLayout;
+export declare function ensureLayout(layout: InstallLayout): void;
+export declare function atomicWrite(path: string, content: string, mode: number): void;
+export declare function atomicSymlink(target: string, path: string): void;

package/dist/management/layout.js

@@ -0,0 +1,39 @@
+import { chmodSync, mkdirSync, renameSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+export function installLayout() {
+    const home = resolve(process.env.CCODEX_HOME ?? join(homedir(), ".ccodex"));
+    return {
+        home,
+        bin: join(home, "bin"),
+        versions: join(home, "versions"),
+        staging: join(home, "staging"),
+        state: join(home, "state"),
+        current: join(home, "current"),
+        previous: join(home, "previous"),
+        manifest: join(home, "install.json"),
+    };
+}
+export function ensureLayout(layout) {
+    for (const directory of [layout.home, layout.bin, layout.versions, layout.staging, layout.state]) {
+        mkdirSync(directory, { recursive: true, mode: 0o700 });
+        chmodSync(directory, 0o700);
+    }
+}
+export function atomicWrite(path, content, mode) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.tmp-${process.pid}`;
+    writeFileSync(temporary, content, { mode });
+    chmodSync(temporary, mode);
+    renameSync(temporary, path);
+}
+export function atomicSymlink(target, path) {
+    const temporary = `${path}.tmp-${process.pid}`;
+    try {
+        rmSync(temporary, { force: true });
+    }
+    catch { /* best effort stale cleanup */ }
+    symlinkSync(target, temporary);
+    renameSync(temporary, path);
+}
+//# sourceMappingURL=layout.js.map

package/dist/management/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/management/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAanD,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5E,OAAO;QACL,IAAI;QACJ,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QACtB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QAC9B,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;QAC1B,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;QAC9B,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAChC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,KAAK,MAAM,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjG,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvD,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,IAAY;IACrE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/C,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3B,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,IAAY;IACxD,MAAM,SAAS,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/C,IAAI,CAAC;QAAC,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;IACrF,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/B,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/management/lifecycle.d.ts

@@ -0,0 +1,4 @@
+export declare function update(args: readonly string[]): Promise<number>;
+export declare function rollback(args: readonly string[]): Promise<number>;
+export declare function uninstall(args: readonly string[]): Promise<number>;
+export declare function ensureInstallLayout(): void;

package/dist/management/lifecycle.js

@@ -0,0 +1,154 @@
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { existsSync, lstatSync, readFileSync, readlinkSync, rmSync, statSync, } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { promisify } from "node:util";
+import { atomicSymlink, atomicWrite, ensureLayout, installLayout } from "./layout.js";
+import { readInstallManifest, setup } from "./setup.js";
+import { reconcileManagedProcess } from "../daemon/supervisor.js";
+const execute = promisify(execFile);
+const BEGIN = "# >>> ccodex >>>";
+const END = "# <<< ccodex <<<";
+async function registryVersion(channel) {
+    const { stdout } = await execute("npm", ["view", "@gkorepanov/ccodex", `dist-tags.${channel}`, "--json"], {
+        timeout: 30_000,
+        maxBuffer: 128 * 1024,
+    });
+    const value = JSON.parse(stdout);
+    if (typeof value !== "string" || !/^\d+\.\d+\.\d+(?:[-+].+)?$/u.test(value)) {
+        throw new Error(`npm returned an invalid latest version: ${stdout.trim()}`);
+    }
+    return value;
+}
+function daemonPidFile() {
+    return join(process.env.CODEX_HOME ?? join(homedir(), ".codex"), "app-server-daemon", "app-server.pid");
+}
+async function daemon(layout, version, operation) {
+    const command = join(layout.versions, version, "node_modules", ".bin", "ccodex");
+    await execute(command, ["app-server", "daemon", operation], { timeout: 90_000, maxBuffer: 512 * 1024 });
+}
+export async function update(args) {
+    const channelIndex = args.indexOf("--channel");
+    const channel = channelIndex >= 0 ? args[channelIndex + 1] : "latest";
+    const valued = new Set([channelIndex + 1]);
+    if (!channel || !["latest", "next"].includes(channel) || args.some((arg, index) => !valued.has(index) && arg !== "--check" && arg !== "--channel")) {
+        throw new Error("Usage: ccodex update [--check] [--channel latest|next]");
+    }
+    const layout = installLayout();
+    const manifest = readInstallManifest(layout);
+    if (!manifest)
+        throw new Error("CCodex is not activated. Run: ccodex setup");
+    const latest = await registryVersion(channel);
+    const current = manifest.activeVersion;
+    if (args.includes("--check")) {
+        process.stdout.write(latest === current ? `CCodex ${current} is current.\n` : `CCodex ${latest} is available (current: ${current}).\n`);
+        return 0;
+    }
+    if (latest === current) {
+        process.stdout.write(`CCodex ${current} is already current.\n`);
+        return 0;
+    }
+    return setup(["--version", latest]);
+}
+export async function rollback(args) {
+    if (args.length > 0)
+        throw new Error("Usage: ccodex rollback");
+    const layout = installLayout();
+    const manifest = readInstallManifest(layout);
+    if (!manifest)
+        throw new Error("CCodex is not activated.");
+    if (!existsSync(layout.previous) || !lstatSync(layout.previous).isSymbolicLink()) {
+        throw new Error("No previous CCodex version is available.");
+    }
+    const previous = basename(readlinkSync(layout.previous));
+    const current = manifest.activeVersion;
+    if (!existsSync(join(layout.versions, previous)))
+        throw new Error(`Previous CCodex ${previous} is missing.`);
+    const daemonWasRunning = Boolean(reconcileManagedProcess(daemonPidFile()));
+    atomicSymlink(join("versions", previous), layout.current);
+    atomicSymlink(join("versions", current), layout.previous);
+    try {
+        if (daemonWasRunning)
+            await daemon(layout, previous, "restart");
+        const next = { ...manifest, activeVersion: previous, previousVersion: current };
+        atomicWrite(layout.manifest, `${JSON.stringify(next, null, 2)}\n`, 0o600);
+    }
+    catch (error) {
+        atomicSymlink(join("versions", current), layout.current);
+        atomicSymlink(join("versions", previous), layout.previous);
+        await daemon(layout, current, "restart").catch(() => undefined);
+        throw error;
+    }
+    process.stdout.write(`CCodex rolled back from ${current} to ${previous}.\n`);
+    return 0;
+}
+function hashFile(path) {
+    return createHash("sha256").update(readFileSync(path)).digest("hex");
+}
+function removeManagedShellFile(path, layout) {
+    if (!existsSync(path))
+        return true;
+    const content = readFileSync(path, "utf8");
+    if (path.endsWith("ccodex.fish")) {
+        const expected = `# Managed by CCodex.\nfish_add_path --prepend "${layout.bin}"\n`;
+        if (content !== expected)
+            return false;
+        rmSync(path);
+        return true;
+    }
+    const block = `${BEGIN}\nexport PATH="${layout.bin}:$PATH"\n${END}\n`;
+    if (!content.includes(block))
+        return false;
+    const mode = statSync(path).mode & 0o777;
+    atomicWrite(path, content.replace(block, ""), mode);
+    return true;
+}
+export async function uninstall(args) {
+    if (args.some((arg) => arg !== "--purge" && arg !== "--yes"))
+        throw new Error("Usage: ccodex uninstall [--purge --yes]");
+    if (args.includes("--purge") && !args.includes("--yes")) {
+        throw new Error("Purging removes all CCodex state and captures. Confirm with: ccodex uninstall --purge --yes");
+    }
+    const layout = installLayout();
+    const manifest = readInstallManifest(layout);
+    if (!manifest)
+        throw new Error("CCodex is not activated.");
+    if (existsSync(daemonPidFile()))
+        await daemon(layout, manifest.activeVersion, "stop");
+    const preserved = [];
+    for (const path of manifest.managedShellFiles) {
+        if (!removeManagedShellFile(path, layout))
+            preserved.push(path);
+    }
+    for (const [name, expected] of Object.entries(manifest.shimHashes)) {
+        const path = join(layout.bin, name);
+        if (!existsSync(path))
+            continue;
+        if (hashFile(path) === expected)
+            rmSync(path);
+        else
+            preserved.push(path);
+    }
+    for (const path of [layout.current, layout.previous, layout.versions, layout.staging, layout.manifest]) {
+        rmSync(path, { recursive: true, force: true });
+    }
+    if (args.includes("--purge")) {
+        rmSync(layout.state, { recursive: true, force: true });
+        rmSync(join(layout.home, "config.toml"), { force: true });
+    }
+    for (const path of [layout.bin, layout.home]) {
+        try {
+            rmSync(path);
+        }
+        catch { /* preserved state, config, or modified owned file */ }
+    }
+    if (preserved.length > 0)
+        process.stderr.write(`Preserved modified files:\n${preserved.map((path) => `  ${path}`).join("\n")}\n`);
+    process.stdout.write(args.includes("--purge") ? "CCodex uninstalled and state purged.\n" : `CCodex uninstalled; state preserved in ${layout.state}.\n`);
+    return 0;
+}
+export function ensureInstallLayout() {
+    ensureLayout(installLayout());
+}
+//# sourceMappingURL=lifecycle.js.map