@claudexor/cli 3.23.2 → 3.25.1

package/dist/harness-maintenance-service.js

@@ -0,0 +1,429 @@
+/**
+ * The engine-owned harness maintenance OPERATION. One accepted request is one
+ * durable command on the daemon's existing queue/cancel/idempotency authority
+ * (the model-operation precedent: no second scheduler or job ledger). Execution
+ * runs the CLI primitive (`harness inspect|update`, harness-maintenance.ts) as
+ * a child through core spawnProcess, so the blocking installer never runs on
+ * the daemon event loop, Cancel reaches the whole process group, and an
+ * unconfirmed tree death stays a typed fact instead of a clean cancel.
+ *
+ * Evidence (before/target/after/mutation) lives in the command record. The
+ * proved `before` and the exact resolved target are written durably BEFORE
+ * the first mutation; a restart leaves the command interrupted with that
+ * evidence and never replays the install. A small in-memory index answers
+ * per-harness reads without scanning history on every poll.
+ */
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnProcess } from "@claudexor/core";
+import { commandStoreForId, commandStoreForRequest, commandStores, } from "@claudexor/daemon";
+import { clearCodexEffortCache } from "@claudexor/harness-codex";
+import { ControlHarnessMaintenanceCreateRequest, ControlHarnessMaintenanceInventory, ControlHarnessMaintenanceOperation, ControlProblem, HarnessMaintenanceEntry, HarnessMaintenanceEvidence, HarnessMaintenanceParams, isHarnessMaintenanceOperation, isTerminalLifecycle, } from "@claudexor/schema";
+import { redactSecrets } from "@claudexor/util";
+import { accountObservations } from "./account-observations.js";
+import { INSTALLABLE_HARNESSES } from "./harness-command-specs.js";
+import { harnessMaintenanceRecipe, isInstallableHarness, NPM_PINS, } from "./harness-install-recipes.js";
+export const HARNESS_MAINTENANCE_OPERATION_ID = "harness.maintenance.create";
+const CLIENT_ID = "control-api";
+const Inspection = HarnessMaintenanceEntry.omit({ previous: true, operation: true });
+/** The CLI entry beside this module: the packaged bundle, else the dist CLI. */
+export function claudexorCliEntry(moduleUrl = import.meta.url, exists = existsSync) {
+    const directory = dirname(fileURLToPath(moduleUrl));
+    const bundled = resolve(directory, "claudexor.bundle.cjs");
+    return exists(bundled) ? bundled : resolve(directory, "cli.js");
+}
+function problem(code, message, retryable = false) {
+    return ControlProblem.parse({ code, message: redactSecrets(message), retryable });
+}
+function failure(code, message, status, context = {}) {
+    return Object.assign(new Error(message), { code, status, retryable: false, context });
+}
+export function createHarnessMaintenance(deps) {
+    const now = () => (deps.now ?? (() => new Date()))();
+    const cli = deps.cli ?? { command: process.execPath, args: [claudexorCliEntry()] };
+    const spawn = deps.spawn ?? spawnProcess;
+    const inventory = new Map();
+    const inventoryGenerations = new Map();
+    const latestSeen = new Map();
+    const creating = new Set();
+    let index = null;
+    const byHarness = () => {
+        if (index)
+            return index;
+        index = new Map();
+        const records = commandStores(deps.commands)
+            .flatMap((store) => store.records())
+            .filter((record) => isHarnessMaintenanceOperation(record.params))
+            .sort((a, b) => (a.createdAt < b.createdAt ? -1 : 1));
+        for (const record of records)
+            remember(record.id, record.params.harness);
+        return index;
+    };
+    const remember = (id, harness) => {
+        const ids = index.get(harness) ?? [];
+        if (!ids.includes(id))
+            index.set(harness, [...ids, id]);
+    };
+    /** Newest first; ids pruned by ordinary retention drop out of the index. */
+    const operationsOf = (harness) => {
+        const ids = byHarness().get(harness) ?? [];
+        const live = ids.flatMap((id) => commandStoreForId(deps.commands, id)?.get(id) ?? []);
+        if (live.length !== ids.length)
+            byHarness().set(harness, live.map((record) => record.id));
+        return live.reverse();
+    };
+    const evidenceOf = (record) => {
+        const { lifecycle: _lifecycle, ...result } = (record.result ?? {});
+        const parsed = HarnessMaintenanceEvidence.safeParse(result);
+        return parsed.success ? parsed.data : null;
+    };
+    /** A proved earlier version from retained evidence, only where a mutation
+     * could have replaced it. Unknown or pruned stays unknown. */
+    const previousOf = (harness) => {
+        for (const record of operationsOf(harness)) {
+            const evidence = evidenceOf(record);
+            if (evidence?.before?.proved && evidence.before.version && evidence.mutation !== "none")
+                return { version: evidence.before.version, operationId: record.id };
+        }
+        return null;
+    };
+    async function runChild(args, signal) {
+        let stdout = "";
+        const progress = [];
+        let unconfirmed = false;
+        for await (const event of spawn(cli.command, [...cli.args, ...args, "--json"], {
+            ...(signal ? { abortSignal: signal } : {}),
+            cancelSignal: "SIGTERM",
+            cancelKillDelayMs: deps.cancelKillDelayMs ?? 10_000,
+        })) {
+            if (event.type === "stdout")
+                stdout += `${event.line}\n`;
+            else if (event.type === "stderr") {
+                progress.push(redactSecrets(event.line).slice(0, 400));
+                if (progress.length > 40)
+                    progress.shift();
+            }
+            else if (event.type === "termination_unconfirmed")
+                unconfirmed = true;
+        }
+        let json = null;
+        try {
+            json = JSON.parse(stdout.trim());
+        }
+        catch {
+            json = null;
+        }
+        return { json, progress, unconfirmed };
+    }
+    async function inspect(ids, latest, fresh, signal) {
+        let stale = fresh || latest ? ids : ids.filter((id) => !inventory.has(id));
+        while (stale.length) {
+            // A multi-harness child returns all rows, including ones not requested.
+            const generations = new Map(inventoryGenerations);
+            const one = stale.length === 1 ? [stale[0]] : [];
+            const out = await runChild(["harness", "inspect", ...one, ...(latest ? ["--latest"] : [])], signal);
+            if (out.unconfirmed || signal?.aborted)
+                throw Object.assign(failure("maintenance_cancelled", "Maintenance preparation was cancelled", 409), {
+                    termination: out.unconfirmed ? "unconfirmed" : "confirmed",
+                });
+            const rows = out.json?.harnesses;
+            const parsed = Array.isArray(rows) ? rows.map((row) => Inspection.safeParse(row)) : [];
+            if (!parsed.length || parsed.some((row) => !row.success))
+                throw failure("maintenance_inspection_failed", `harness inspection did not return its typed answer: ${out.progress.slice(-3).join(" | ")}`, 502);
+            for (const row of parsed) {
+                const value = row.data;
+                if (generations.get(value.harness) !== inventoryGenerations.get(value.harness))
+                    continue;
+                if (latest)
+                    latestSeen.set(value.harness, value);
+                inventory.set(value.harness, value);
+            }
+            // A newer read may already own the invalidated row. Otherwise acquire it
+            // now, so this caller also gets current facts instead of an empty answer.
+            stale = ids.filter((id) => generations.get(id) !== inventoryGenerations.get(id) && !inventory.has(id));
+        }
+        return ids.flatMap((id) => inventory.get(id) ?? []);
+    }
+    function detail(id) {
+        const record = commandStoreForId(deps.commands, id)?.get(id);
+        const params = HarnessMaintenanceParams.safeParse(record?.params);
+        if (!record || !params.success)
+            throw failure("maintenance_operation_not_found", "No such maintenance operation", 404);
+        const evidence = evidenceOf(record) ?? {
+            phase: "accepted",
+            mechanism: null,
+            target: params.data.target,
+            before: null,
+            after: null,
+            mutation: "none",
+            termination: "not_applicable",
+            limitations: [],
+            progress: [],
+            problem: null,
+        };
+        if (isTerminalLifecycle(record.state) && !evidence.problem && record.state !== "succeeded")
+            evidence.problem = problem(record.errorCode ?? `maintenance_${record.state}`, record.error ?? `maintenance ended ${record.state}`);
+        return ControlHarnessMaintenanceOperation.parse({
+            ...evidence,
+            id,
+            harness: params.data.harness,
+            state: record.state,
+            createdAt: record.createdAt,
+            startedAt: record.startedAt ?? null,
+            finishedAt: record.finishedAt ?? null,
+        });
+    }
+    function save(id, evidence) {
+        commandStoreForId(deps.commands, id)?.update(id, { result: evidence });
+    }
+    /** After any step that may have changed bytes: drop this harness's cached
+     * observations so the next read re-proves them (no account fanout). */
+    function invalidate(harness) {
+        inventoryGenerations.set(harness, (inventoryGenerations.get(harness) ?? 0) + 1);
+        inventory.delete(harness);
+        accountObservations.invalidateHarness(harness);
+        deps.readiness?.().invalidate(harness);
+        // Keyed by binary path, which an in-place install keeps. (Claude's model
+        // probe cache is package-private; its documented TTL/fresh bypass remain.)
+        clearCodexEffortCache();
+    }
+    async function execute(raw, ctx) {
+        const params = HarnessMaintenanceParams.parse(raw);
+        const { harness } = params;
+        const evidence = {
+            phase: "preparing",
+            mechanism: null,
+            target: { ...params.target },
+            before: null,
+            after: null,
+            mutation: "none",
+            termination: "not_applicable",
+            limitations: [],
+            progress: [],
+            problem: null,
+        };
+        let lifecycle = "failed";
+        let spawned = false;
+        try {
+            save(ctx.jobId, evidence);
+            const npm = harnessMaintenanceRecipe(harness).mechanism === "managed_npm";
+            const [row] = await inspect([harness], npm && params.target.kind === "latest", true, ctx.signal);
+            ctx.signal.throwIfAborted();
+            if (!row)
+                throw failure("maintenance_inspection_failed", `no inspection for ${harness}`, 502);
+            evidence.mechanism = row.mechanism;
+            const managed = row.mechanism === "managed_npm";
+            evidence.before = {
+                version: managed ? row.installed.version : row.selection.version,
+                binary: managed ? row.installed.binary : row.selection.binary,
+                selection: row.selection.kind,
+                proved: managed ? row.installed.proved : row.selection.version !== null,
+            };
+            if (!row.maintainable || !row.targets.includes(params.target.kind))
+                throw failure("harness_not_maintainable", row.remedy ?? "target is not supported", 409);
+            const version = managed && params.target.kind === "latest" ? row.available?.version : params.target.version;
+            if (managed && !version)
+                throw failure("latest_unavailable", row.availableProblem?.message ?? "no latest version", 502);
+            // Durable BEFORE the first mutation: proved before, exact target, effect unknown.
+            evidence.target = { kind: params.target.kind, version: version ?? null };
+            evidence.phase = "installing";
+            evidence.mutation = "unknown";
+            evidence.limitations = ["in_place_replacement", "new_starts_may_fail"];
+            save(ctx.jobId, evidence);
+            spawned = true;
+            const out = await runChild(["harness", "update", harness, ...(version ? ["--vendor-version", version] : []), "--yes"], ctx.signal);
+            const receipt = (out.json ?? {});
+            evidence.progress = out.progress.slice(-20);
+            evidence.termination = out.unconfirmed
+                ? "unconfirmed"
+                : ctx.signal.aborted
+                    ? "confirmed"
+                    : "not_applicable";
+            if (receipt.after !== undefined)
+                evidence.after = receipt.after;
+            if (receipt.mutation)
+                evidence.mutation = receipt.mutation;
+            if (receipt.limitations)
+                evidence.limitations = receipt.limitations;
+            if (ctx.signal.aborted) {
+                lifecycle = "cancelled";
+                evidence.problem = problem("maintenance_cancelled", evidence.mutation === "none"
+                    ? "cancelled; nothing was changed"
+                    : "cancelled after the installer started; the installation may be partially replaced");
+            }
+            else if (receipt.ok === true)
+                lifecycle = "succeeded";
+            else {
+                if (!receipt.mutation)
+                    evidence.mutation = "unknown";
+                evidence.problem = problem(receipt.code ?? "maintenance_failed", receipt.refusal ??
+                    (out.progress.slice(-3).join(" | ") || "the update child returned no receipt"));
+            }
+        }
+        catch (error) {
+            const code = error.code;
+            const termination = error.termination;
+            if (termination === "unconfirmed" || termination === "confirmed")
+                evidence.termination = termination;
+            lifecycle = ctx.signal.aborted ? "cancelled" : "failed";
+            evidence.problem = problem(typeof code === "string" ? code : "maintenance_failed", error instanceof Error ? error.message : String(error));
+        }
+        finally {
+            evidence.phase = "settled";
+            // Any started step may have touched bytes (a vendor "no change" too).
+            if (spawned)
+                invalidate(harness);
+        }
+        return { lifecycle, ...evidence };
+    }
+    const routes = {
+        maintenanceInventory: async (input = {}) => {
+            const ids = input.harnessIds?.length ? input.harnessIds : [...INSTALLABLE_HARNESSES];
+            const unknown = ids.filter((id) => !isInstallableHarness(id));
+            if (unknown.length)
+                throw failure("harness_not_installable", `unknown harness: ${unknown.join(", ")}`, 400);
+            const rows = await inspect(ids, input.checkLatest === true, input.fresh === true);
+            return ControlHarnessMaintenanceInventory.parse({
+                observedAt: now().toISOString(),
+                harnesses: rows.map((row) => {
+                    const seen = latestSeen.get(row.harness);
+                    const [current] = operationsOf(row.harness);
+                    const evidence = current ? evidenceOf(current) : null;
+                    return {
+                        ...row,
+                        available: row.available ?? seen?.available ?? null,
+                        availableProblem: row.availableProblem ?? seen?.availableProblem ?? null,
+                        previous: row.targets.includes("previous") ? previousOf(row.harness) : null,
+                        operation: current
+                            ? {
+                                id: current.id,
+                                state: current.state,
+                                phase: evidence?.phase ?? "accepted",
+                                targetVersion: evidence?.target.version ?? null,
+                                finishedAt: current.finishedAt ?? null,
+                            }
+                            : null,
+                    };
+                }),
+            });
+        },
+        createMaintenanceOperation: async (body, idempotencyKey) => {
+            const request = ControlHarnessMaintenanceCreateRequest.parse(body);
+            const { harness, target } = request;
+            if (!isInstallableHarness(harness))
+                throw failure("harness_not_installable", `unknown harness: ${harness}`, 400);
+            const routing = {
+                kind: "harness_maintenance",
+                harness,
+                target: { kind: target.kind, version: null },
+            };
+            const envelope = {
+                idempotencyKey,
+                clientId: CLIENT_ID,
+                operation: HARNESS_MAINTENANCE_OPERATION_ID,
+            };
+            const replay = commandStoreForRequest(deps.commands, routing).find({
+                ...envelope,
+                params: routing,
+                idempotencyParams: request,
+            });
+            if (replay)
+                return detail(replay.id);
+            const recipe = harnessMaintenanceRecipe(harness);
+            const cached = inventory.get(harness);
+            if (!recipe.targets.includes(target.kind) || (cached && !cached.maintainable))
+                throw failure("harness_not_maintainable", cached?.remedy ?? `${harness} cannot install target ${target.kind}`, 409, {
+                    selection: cached?.selection ?? null,
+                });
+            const active = operationsOf(harness).find((record) => !isTerminalLifecycle(record.state));
+            if (active || creating.has(harness))
+                throw failure("maintenance_already_active", `${harness} already has a maintenance operation`, 409, {
+                    operationId: active?.id ?? null,
+                });
+            const version = target.kind === "version"
+                ? target.version
+                : target.kind === "baseline"
+                    ? (NPM_PINS[harness]?.version ?? null)
+                    : target.kind === "previous"
+                        ? (previousOf(harness)?.version ?? null)
+                        : null;
+            if (target.kind !== "latest" && !version)
+                throw failure("maintenance_target_unknown", `no proved ${target.kind} version is known for ${harness}`, 409);
+            creating.add(harness);
+            try {
+                const params = HarnessMaintenanceParams.parse({
+                    ...routing,
+                    target: { kind: target.kind, version },
+                });
+                const { id } = await deps.client.enqueue(params, {
+                    ...envelope,
+                    idempotencyRequest: request,
+                });
+                byHarness();
+                remember(id, harness);
+                return detail(id);
+            }
+            finally {
+                creating.delete(harness);
+            }
+        },
+        getMaintenanceOperation: async (id) => detail(id),
+        cancelMaintenanceOperation: async (id) => {
+            const current = detail(id);
+            if (!isTerminalLifecycle(current.state))
+                await deps.client.cancel(id, "user_cancelled");
+            return detail(id);
+        },
+    };
+    /** Readiness projection: an active operation is disclosed on its harness row
+     * (existing fields) so a failed native start reads as maintenance, not auth. */
+    function decorateHarnessList(list) {
+        return async (...args) => {
+            const value = (await list(...args));
+            if (!value?.harnesses)
+                return value;
+            return {
+                ...value,
+                harnesses: value.harnesses.map((row) => {
+                    const [current] = operationsOf(String(row.id));
+                    if (!current || isTerminalLifecycle(current.state))
+                        return row;
+                    const target = evidenceOf(current)?.target.version;
+                    const detailText = `Claudexor is maintaining ${String(row.id)}${target ? ` (installing ${target})` : ""}; new native starts may fail until operation ${current.id} finishes`;
+                    return {
+                        ...row,
+                        reasons: [...(row.reasons ?? []), detailText],
+                        readiness: [
+                            ...(row.readiness ?? []),
+                            {
+                                id: "maintenance",
+                                kind: "binary",
+                                title: "Maintenance in progress",
+                                status: "skip",
+                                detail: detailText,
+                            },
+                        ],
+                    };
+                }),
+            };
+        };
+    }
+    return {
+        owns: (params) => isHarnessMaintenanceOperation(params),
+        execute,
+        routes,
+        decorateHarnessList,
+        /** Daemon composition: routes + readiness decoration on the control services. */
+        bind(services) {
+            Object.assign(services, routes);
+            if (services.harnesses)
+                services.harnesses = decorateHarnessList(services.harnesses);
+        },
+    };
+}
+/** The daemon's composition (claudexord.ts); readiness is bound lazily. */
+export function daemonHarnessMaintenance(commands, client, readiness) {
+    return createHarnessMaintenance({ commands, client, readiness });
+}
+//# sourceMappingURL=harness-maintenance-service.js.map

package/dist/harness-maintenance-service.js.map

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

package/dist/harness-maintenance.d.ts

@@ -0,0 +1,62 @@
+import { type HarnessMaintenanceEntry } from "@claudexor/schema";
+import { type ParsedArgs } from "./args.js";
+import { type InstallableHarness } from "./harness-install-recipes.js";
+import { type InstallerRuntime } from "./harness-install-runtime.js";
+export type HarnessInspection = Omit<HarnessMaintenanceEntry, "previous" | "operation">;
+type Selection = HarnessInspection["selection"];
+export interface MaintenanceOptions {
+    home?: string;
+    nodePath?: string;
+    platform?: NodeJS.Platform;
+    arch?: string;
+    sourceEnv?: NodeJS.ProcessEnv;
+    spawn?: InstallerRuntime["spawn"];
+    now?: () => Date;
+    lock?: boolean;
+    json?: boolean;
+}
+/** One registry read of the newest published version, through the embedded
+ * npm and the clean vendor environment (no credentials). */
+export declare function resolveLatestNpmVersion(harness: InstallableHarness, runtime: InstallerRuntime): {
+    version: string;
+} | {
+    problem: {
+        code: string;
+        message: string;
+    };
+};
+export declare function inspectHarness(harness: InstallableHarness, options?: MaintenanceOptions & {
+    latest?: boolean;
+}): HarnessInspection;
+export interface HarnessUpdateReceipt {
+    ok: boolean;
+    harness: InstallableHarness;
+    mechanism: HarnessInspection["mechanism"];
+    exitCode: number;
+    code?: string;
+    refusal?: string;
+    requestedVersion: string | null;
+    resolvedVersion: string | null;
+    previousVersion: string | null;
+    before: {
+        version: string | null;
+        binary: string | null;
+        selection: Selection["kind"];
+        proved: boolean;
+    };
+    after: {
+        version: string | null;
+        binary: string | null;
+        selected: boolean;
+        proved: boolean;
+    } | null;
+    mutation: "none" | "applied" | "unknown";
+    limitations: string[];
+}
+/** Exactly one maintenance step. `requested` is an exact version, "latest", or
+ * omitted (latest for either mechanism). */
+export declare function runHarnessUpdate(harness: InstallableHarness, requested: string | undefined, options?: MaintenanceOptions): HarnessUpdateReceipt;
+export declare function harnessInspectCommand(args: ParsedArgs, json: boolean, options?: MaintenanceOptions): number;
+export declare function harnessUpdateCommand(args: ParsedArgs, json: boolean, options?: MaintenanceOptions): number;
+export {};
+//# sourceMappingURL=harness-maintenance.d.ts.map

package/dist/harness-maintenance.d.ts.map

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