@claudexor/cli 1.0.1

package/dist/orphan-sweeper.js

@@ -0,0 +1,289 @@
+/**
+ * Crash GC: a daemon crash leaves three kinds of debris behind —
+ * workspace envelopes (worktree + scoped home WITH SEEDED CREDENTIALS),
+ * per-attempt `claudexor/<task>/<attempt>` branches, and `claudexor-ro-*`
+ * read-only tmp homes. The sweep runs at daemon startup BEFORE any new work
+ * is accepted, when nothing can own an envelope (running jobs were flipped
+ * to interrupted, queued jobs have not materialized task ids), so every
+ * found envelope under a daemon-known project root is an orphan.
+ *
+ * Reach is honest: only roots recorded in jobs.json (plus their thread
+ * trees) are sweepable — a project never run through this daemon is not.
+ *
+ * LIVE-OWNER GUARD: envelopes carry owner.json (pid + kernel start time);
+ * a live owner's envelopes survive the sweep. When start-time recycling
+ * proof is unavailable on either side (ps-less/sandboxed env, legacy
+ * marker), a live pid keeps the envelope only while its working dirs are
+ * FRESH (24h window over the newest of base/tree/home/owner.json mtimes) —
+ * a declared tradeoff: brief proof-less windows never kill in-flight work,
+ * while a recycled pid cannot pin a seeded-credential home forever.
+ */
+import { existsSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { WorkspaceManager, git, processStartTime } from "@claudexor/workspace";
+const RO_HOME_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+export async function sweepOrphanWorkspaces(input) {
+    const actions = [];
+    const roots = knownProjectRoots(input.jobsPath);
+    const liveThreadIds = knownThreadIds(input.threadsPath);
+    for (const root of roots) {
+        const trees = [root, ...threadTreesUnder(root)];
+        for (const tree of trees) {
+            actions.push(...(await sweepEnvelopesUnder(tree)));
+            actions.push(...(await sweepAttemptBranches(tree, liveThreadIds)));
+        }
+    }
+    actions.push(...sweepReadOnlyHomes());
+    return actions;
+}
+/** Project roots this daemon has ever run against (jobs.json scope roots). */
+function knownProjectRoots(jobsPath) {
+    const roots = new Set();
+    try {
+        const records = JSON.parse(readFileSync(jobsPath, "utf8"));
+        if (!Array.isArray(records))
+            return [];
+        for (const rec of records) {
+            const scope = rec?.params
+                ?.scope;
+            if (scope &&
+                scope.kind === "project" &&
+                typeof scope.root === "string" &&
+                existsSync(scope.root)) {
+                roots.add(scope.root);
+            }
+        }
+    }
+    catch {
+        return [];
+    }
+    return [...roots];
+}
+function knownThreadIds(threadsPath) {
+    try {
+        const raw = JSON.parse(readFileSync(threadsPath, "utf8"));
+        return new Set((raw.threads ?? []).map((t) => t?.id).filter((id) => typeof id === "string"));
+    }
+    catch {
+        return new Set();
+    }
+}
+/** Isolated-thread worktrees nest their own envelopes: <root>/.claudexor/threads/<tid>/tree. */
+function threadTreesUnder(root) {
+    const threadsDir = join(root, ".claudexor", "threads");
+    if (!existsSync(threadsDir))
+        return [];
+    try {
+        return readdirSync(threadsDir)
+            .map((tid) => join(threadsDir, tid, "tree"))
+            .filter((tree) => existsSync(tree));
+    }
+    catch {
+        return [];
+    }
+}
+async function sweepEnvelopesUnder(execRoot) {
+    const actions = [];
+    const workspacesDir = join(execRoot, ".claudexor", "workspaces");
+    if (!existsSync(workspacesDir))
+        return actions;
+    const wsm = new WorkspaceManager(execRoot);
+    for (const taskId of safeReaddir(workspacesDir)) {
+        const taskDir = join(workspacesDir, taskId);
+        for (const attemptId of safeReaddir(taskDir)) {
+            // LIVE-OWNER GUARD: an envelope created by a still-running process
+            // (in-process CLI run, MCP/ACP serve, another daemon) is NOT an orphan.
+            // The startup premise "nothing can own an envelope" only covers
+            // daemon-tracked jobs; owner.json (pid + command, recycling-guarded)
+            // covers everyone else. Fail-safe: a live-looking owner means KEEP.
+            const owner = envelopeOwner(join(taskDir, attemptId));
+            if (owner) {
+                actions.push(`kept envelope ${taskId}/${attemptId} under ${execRoot}: live owner pid ${owner}`);
+                continue;
+            }
+            try {
+                await wsm.disposeOrphan(taskId, attemptId);
+                actions.push(`disposed orphan envelope ${taskId}/${attemptId} under ${execRoot}`);
+            }
+            catch (err) {
+                actions.push(`FAILED to dispose orphan envelope ${taskId}/${attemptId} under ${execRoot}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    return actions;
+}
+/** How long an envelope may be KEPT on live-pid evidence alone when
+ * start-time recycling proof is unavailable on either side. Bounds credential
+ * retention: a recycled pid cannot pin a seeded-credential home forever. */
+const OWNERLESS_PROOF_KEEP_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+/** The live owner pid recorded in the envelope's owner.json, or null when the
+ * marker is missing, the pid is dead, or the pid was RECYCLED (the live
+ * process's kernel start time no longer matches the recorded one — command
+ * names/titles mutate, start times never do). FAIL-SAFE, bounded: when
+ * start-time evidence is unavailable on either side (`ps` missing/sandboxed,
+ * legacy marker), a LIVE pid keeps the envelope only while it is FRESH —
+ * in-flight work survives, but a recycled pid cannot retain credential-bearing
+ * homes indefinitely. A pid alive under another uid (EPERM) counts as alive. */
+function envelopeOwner(envelopeBase) {
+    try {
+        const raw = JSON.parse(readFileSync(join(envelopeBase, "owner.json"), "utf8"));
+        if (typeof raw.pid !== "number" || !Number.isInteger(raw.pid) || raw.pid <= 0)
+            return null;
+        let alive = false;
+        try {
+            process.kill(raw.pid, 0);
+            alive = true;
+        }
+        catch (err) {
+            // EPERM = the pid EXISTS but belongs to another security boundary —
+            // that is a live process, not a dead one.
+            alive = err?.code === "EPERM";
+        }
+        if (!alive)
+            return null;
+        const recorded = typeof raw.started === "string" ? raw.started : null;
+        const live = processStartTime(raw.pid);
+        // Recycling proof requires BOTH sides; with both present they must match.
+        if (recorded !== null && live !== null)
+            return live === recorded ? raw.pid : null;
+        // No recycling proof available: bounded keep on freshness. Freshness is
+        // the NEWEST mtime across the envelope base, owner.json, and a BOUNDED
+        // recursive walk of the working dirs — editing an EXISTING file bumps
+        // only the file's mtime, not its parent directory's, so directory stats
+        // alone would sweep a live owner that edits in place. A live long-running
+        // owner keeps extending its own window; a recycled pid cannot pin a
+        // seeded-credential home forever.
+        const newestMtime = Math.max(safeMtime(envelopeBase), safeMtime(join(envelopeBase, "owner.json")), newestMtimeUnder(join(envelopeBase, "tree")), newestMtimeUnder(join(envelopeBase, "home")));
+        return Date.now() - newestMtime < OWNERLESS_PROOF_KEEP_MAX_AGE_MS ? raw.pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Per-attempt branches whose envelope is gone are debris (disposeOrphan
+ * removes its own branch; this catches branches whose envelope dir was
+ * deleted out-of-band). Thread branches (`claudexor/thread-<tid>`) are
+ * PERSISTENT for live threads and only deleted when the thread is gone from
+ * the store.
+ */
+async function sweepAttemptBranches(execRoot, liveThreadIds) {
+    const actions = [];
+    const branches = await git(execRoot, [
+        "branch",
+        "--list",
+        "claudexor/*",
+        "--format=%(refname:short)",
+    ]);
+    if (branches.code !== 0)
+        return actions;
+    for (const branch of branches.stdout
+        .split("\n")
+        .map((b) => b.trim())
+        .filter(Boolean)) {
+        const rest = branch.slice("claudexor/".length);
+        if (rest.startsWith("verify-")) {
+            // FinalVerifier branches leak only when a crash hit mid-verify (the
+            // verifier deletes them in its finally). git refuses to delete a branch
+            // a live verify worktree still has checked out, so this is safe.
+            const del = await git(execRoot, ["branch", "-D", branch]);
+            if (del.code === 0)
+                actions.push(`deleted leaked verify branch ${branch} under ${execRoot}`);
+            continue;
+        }
+        if (rest.startsWith("thread-")) {
+            const tid = rest.slice("thread-".length);
+            if (liveThreadIds.has(tid))
+                continue;
+            // Dead thread branch: its worktree dir decides — an existing tree means
+            // the thread store lost the record but the work is still there; keep it
+            // (evidence beats cleanup) and only note it.
+            const threadTree = join(execRoot, ".claudexor", "threads", tid, "tree");
+            if (existsSync(threadTree)) {
+                actions.push(`kept branch ${branch}: thread tree still on disk (store record missing)`);
+                continue;
+            }
+            const del = await git(execRoot, ["branch", "-D", branch]);
+            if (del.code === 0)
+                actions.push(`deleted dead thread branch ${branch} under ${execRoot}`);
+            continue;
+        }
+        const [taskId, attemptId] = rest.split("/");
+        if (!taskId || !attemptId)
+            continue;
+        const envelopeBase = join(execRoot, ".claudexor", "workspaces", taskId, attemptId);
+        if (existsSync(envelopeBase))
+            continue; // still owned (sweep order: envelopes first)
+        const del = await git(execRoot, ["branch", "-D", branch]);
+        if (del.code === 0)
+            actions.push(`deleted orphan attempt branch ${branch} under ${execRoot}`);
+    }
+    return actions;
+}
+/** Read-only scoped homes and verify worktree dirs leak on crash; ro homes can hold seeded credentials. */
+function sweepReadOnlyHomes() {
+    const actions = [];
+    const tmp = tmpdir();
+    for (const entry of safeReaddir(tmp)) {
+        if (!entry.startsWith("claudexor-ro-") && !entry.startsWith("claudexor-verify-"))
+            continue;
+        const full = join(tmp, entry);
+        try {
+            if (Date.now() - statSync(full).mtimeMs < RO_HOME_MAX_AGE_MS)
+                continue;
+            rmSync(full, { recursive: true, force: true });
+            actions.push(`deleted stale tmp dir ${entry}`);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    return actions;
+}
+function safeMtime(path) {
+    try {
+        return statSync(path).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Newest mtime under a dir via a BOUNDED walk (freshness evidence, not an
+ * exhaustive index): caps visited entries so a huge worktree cannot stall the
+ * startup sweep; the newest-first ordering is not needed — any fresh entry
+ * proves liveness. */
+function newestMtimeUnder(root, maxEntries = 512) {
+    let newest = safeMtime(root);
+    let visited = 0;
+    const stack = [root];
+    while (stack.length > 0 && visited < maxEntries) {
+        const dir = stack.pop();
+        for (const entry of safeReaddir(dir)) {
+            if (visited >= maxEntries)
+                break;
+            visited += 1;
+            const full = join(dir, entry);
+            try {
+                const st = statSync(full);
+                if (st.mtimeMs > newest)
+                    newest = st.mtimeMs;
+                if (st.isDirectory())
+                    stack.push(full);
+            }
+            catch {
+                /* raced deletion — skip */
+            }
+        }
+    }
+    return newest;
+}
+function safeReaddir(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=orphan-sweeper.js.map

package/dist/orphan-sweeper.js.map

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

package/dist/plugins.d.ts

@@ -0,0 +1,44 @@
+export type PluginHost = "cursor" | "claude" | "codex" | "opencode";
+export type PluginTarget = PluginHost | "all";
+export type PluginVerb = "install" | "status" | "doctor" | "repair" | "uninstall";
+export type PluginInstallState = "missing" | "installed" | "registered" | "drifted" | "partial" | "blocked";
+export declare const PLUGIN_HOSTS: PluginHost[];
+export declare const PLUGIN_TARGETS: PluginTarget[];
+export declare const PLUGIN_VERBS: PluginVerb[];
+export interface PluginHostResult {
+    host: PluginHost;
+    state: PluginInstallState;
+    ok: boolean;
+    changed: boolean;
+    path: string;
+    actions: string[];
+    notes: string[];
+    warnings: string[];
+    errors: string[];
+}
+export interface PluginCommandResult {
+    verb: PluginVerb;
+    target: PluginTarget;
+    dryRun: boolean;
+    results: PluginHostResult[];
+    ok: boolean;
+    exitCode: number;
+}
+export interface PluginCommandErrorResult {
+    verb: string | null;
+    target: string | null;
+    dryRun: boolean;
+    results: [];
+    ok: false;
+    exitCode: number;
+    error: string;
+}
+export interface PluginCommandOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    json?: boolean;
+}
+export declare function runPluginCommand(verb: PluginVerb, target: PluginTarget, options?: PluginCommandOptions): Promise<PluginCommandResult>;
+export declare function formatPluginResult(result: PluginCommandResult): string;
+export declare function pluginCommandErrorResult(verb: string | undefined, target: string | undefined, dryRun: boolean, exitCode: number, error: string): PluginCommandErrorResult;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AACpE,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5G,eAAO,MAAM,YAAY,EAAE,UAAU,EAA8C,CAAC;AACpF,eAAO,MAAM,cAAc,EAAE,YAAY,EAA6B,CAAC;AACvE,eAAO,MAAM,YAAY,EAAE,UAAU,EAA2D,CAAC;AAkEjG,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,EAAE,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAyyCD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoB/I;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAWtE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,wBAAwB,CAUzK"}