@claudexor/cli 3.3.15 → 3.4.0

package/dist/daemon-startup.js

@@ -0,0 +1,156 @@
+/**
+ * Two-stage daemon startup admission (issue #165 D5).
+ *
+ * Stage order enforced by main(): (1) acquire the root authority barrier with
+ * its epoch/floor refusals; (2) read-only prepare + validate the global AND
+ * every registered project partition — zero recovery writes; (3) bind the
+ * REAL transport (socket + control API) with product admission CLOSED and
+ * prove self-health/exact identity through it; (4) only then advance the
+ * semantic floor, run destructive recovery (crash-GC, prepared activation,
+ * recoverAfterStartup terminalization) and open normal admission. A
+ * recovery-needed partition leaves the recovery plane online with the floor
+ * UNCHANGED and cleanup OFF.
+ */
+import { appendFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { JournalRecoveryRequiredError } from "@claudexor/journal";
+import { CONTROL_PROTOCOL_MAJOR } from "@claudexor/schema";
+/** Single canonical admission snapshot; both transports read the SAME fact. */
+export class DaemonStartupAdmission {
+    mode = "recovery_only";
+    snapshot = () => this.mode;
+    openNormal() {
+        this.mode = "normal";
+    }
+}
+/** Stage-2 verdict: every partition that blocks destructive recovery. The
+ * loose Picks let the C6 in-process reopen feed LIVE inspections through the
+ * same verdict the frozen stage-2 receipts use. */
+export function recoveryBlockedPartitions(input) {
+    const blocked = [];
+    if (input.globalPreparation.inspection.status !== "ready")
+        blocked.push("global");
+    if (input.partitionsPreparation.coverage !== "complete") {
+        blocked.push("project-registry");
+    }
+    blocked.push(...input.partitionsPreparation.recoveryRequiredPartitions);
+    return blocked;
+}
+/** C6a: whether the control API binds this startup. CLAUDEXOR_NO_CONTROL_API=1
+ * is honored only on a clean verdict — the recovery surface IS the point of
+ * the recovery plane, so a recovery-required verdict overrides it (logged). */
+export function controlApiEnabledForStartup(input) {
+    if (!input.disabledByEnv)
+        return true;
+    if (input.blockedPartitions.length === 0)
+        return false;
+    input.log("recovery-required startup verdict overrides CLAUDEXOR_NO_CONTROL_API=1: binding the control API to serve the recovery surface");
+    return true;
+}
+/** Stage 3 bind: start the REAL socket + control transports (product
+ * admission still closed) and publish their addresses. Returns the control
+ * address, or null when the control API is disabled or shutdown began. */
+export async function bindRecoveryTransport(input) {
+    const stamp = () => `[${new Date().toISOString()}]`;
+    if (!input.requested())
+        await input.server.start();
+    if (!input.requested()) {
+        appendFileSync(input.logPath, `${stamp()} claudexord listening on ${input.socketPath} (recovery-only admission)\n`);
+    }
+    if (!input.control) {
+        if (!input.requested()) {
+            appendFileSync(input.logPath, `${stamp()} claudexor control-api disabled by CLAUDEXOR_NO_CONTROL_API=1\n`);
+        }
+        return null;
+    }
+    if (input.requested())
+        return null;
+    const controlAddr = await input.control.start();
+    if (input.requested())
+        return null;
+    writeFileSync(join(input.daemonDir, "control-api.json"), `${JSON.stringify({ ...controlAddr, tokenPath: join(input.daemonDir, "token") }, null, 2)}\n`, { mode: 0o600 });
+    appendFileSync(input.logPath, `${stamp()} claudexor control-api listening on http://${controlAddr.host}:${controlAddr.port}\n`);
+    return controlAddr;
+}
+/** Stage 3 proof: prove self-health and exact identity through the REAL
+ * transport while product admission is still closed. */
+export async function proveRecoveryTransport(input) {
+    const health = (await input.socket.health());
+    if (health?.ok !== true || health.servingMode !== "recovery_only") {
+        throw new Error("daemon transport proof failed: socket health did not report a recovery-only serving daemon");
+    }
+    if (!input.control)
+        return;
+    const response = await fetch(`http://${input.control.host}:${input.control.port}/v2/handshake`, {
+        method: "POST",
+        headers: {
+            authorization: `Bearer ${input.token}`,
+            "content-type": "application/json",
+        },
+        body: JSON.stringify({ protocolMajor: CONTROL_PROTOCOL_MAJOR, client: "claudexord-startup" }),
+    });
+    if (!response.ok) {
+        throw new Error(`daemon transport proof failed: control handshake HTTP ${response.status}`);
+    }
+    const body = (await response.json());
+    if (body?.engine?.version !== input.identity.version ||
+        body.engine.sha !== input.identity.sha ||
+        body.servingMode !== "recovery_only") {
+        throw new Error("daemon transport proof failed: control handshake did not prove this exact recovery-only runtime");
+    }
+}
+/** Stage 4: revalidate every read-only preparation FIRST; only on all-green
+ * advance the floor, run destructive recovery and open normal admission — or
+ * the protected recovery-only outcome (floor unchanged, cleanup off). */
+export async function completeStartupAdmission(input) {
+    if (input.blockedPartitions.length > 0) {
+        input.log(`startup admission: serving recovery only — floor unchanged, destructive recovery and cleanup OFF (recovery required: ${input.blockedPartitions.join(", ")})`);
+        return "recovery_only";
+    }
+    // C3: prove the filesystem still matches every stage-2 preparation BEFORE
+    // the first irreversible act. Any revalidation failure leaves the floor
+    // UNCHANGED and zero destructive work done.
+    try {
+        input.global.revalidatePreparation();
+        input.partitions.revalidatePreparation();
+    }
+    catch (error) {
+        if (error instanceof JournalRecoveryRequiredError) {
+            input.log(`startup admission: preparation revalidation failed; serving recovery only with floor unchanged (${error.message})`);
+            return "recovery_only";
+        }
+        throw error;
+    }
+    input.grant.advanceFloor();
+    await input.crashGc();
+    try {
+        input.global.activatePrepared();
+        input.partitions.activatePrepared();
+        input.global.recoverAfterStartup();
+        input.partitions.recoverAfterStartup();
+    }
+    catch (error) {
+        if (error instanceof JournalRecoveryRequiredError) {
+            // Activation re-revalidates and raced a journal mutation: stay on the
+            // recovery plane instead of serving a partition we could not activate.
+            input.log(`startup admission: prepared activation entered recovery; serving recovery only (${error.message})`);
+            return "recovery_only";
+        }
+        throw error;
+    }
+    input.admission.openNormal();
+    input.log("startup admission: normal product admission open");
+    return "normal";
+}
+/** Post-admission ghost-project quarantine (F2), normal admission only. */
+export function quarantineGhostProjectsAtStartup(threads, log) {
+    try {
+        for (const ghost of threads.quarantineGhostProjects()) {
+            log(`projects: quarantined ghost ${ghost.projectId} (${ghost.reason}): ${ghost.root}`);
+        }
+    }
+    catch (error) {
+        log(`projects: ghost sweep failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=daemon-startup.js.map

package/dist/daemon-startup.js.map

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

package/dist/delegation-belt-descriptor.d.ts

@@ -6,7 +6,7 @@ import type { ExtraMcpServer, PaidBudget } from "@claudexor/schema";
  * for credential isolation. Left to default, the belt's `defaultSocketPath()`
  * and token lookup both re-derive under that scoped HOME → a socket/token that
  * does not exist → the belt tries to AUTO-START a fresh daemon there, fails
- * ("daemon did not come up within 30s"), and every belt run tool errors. Pin
+ * after its bounded readiness wait, and every belt run tool errors. Pin
  * the belt to the real daemon by injecting the ACTUAL config root (so the token
  * and daemon dir resolve to this daemon's) and the exact socket path — both
  * captured from the live daemon env at descriptor-build time, so this is correct

package/dist/delegation-belt-descriptor.js

@@ -11,7 +11,7 @@ import { userConfigDir } from "@claudexor/util";
  * for credential isolation. Left to default, the belt's `defaultSocketPath()`
  * and token lookup both re-derive under that scoped HOME → a socket/token that
  * does not exist → the belt tries to AUTO-START a fresh daemon there, fails
- * ("daemon did not come up within 30s"), and every belt run tool errors. Pin
+ * after its bounded readiness wait, and every belt run tool errors. Pin
  * the belt to the real daemon by injecting the ACTUAL config root (so the token
  * and daemon dir resolve to this daemon's) and the exact socket path — both
  * captured from the live daemon env at descriptor-build time, so this is correct

package/dist/engine-skew.d.ts

@@ -12,6 +12,10 @@ export interface EngineSkew {
 export interface EngineIdentity {
     engineVersion: string | null;
     engineBuildSha: string | null;
+    /** Product admission at handshake time (issue #165 D5). A pre-#165 daemon
+     * reports nothing and is always serving normally, so absent maps to
+     * `normal`; `recovery_only` means product routes are typed-closed. */
+    servingMode: "normal" | "recovery_only";
 }
 /** The ONE remedy wording — stderr advisory and typed requiredActions speak
  * with the same voice, so it must stay CALLER-NEUTRAL: acting commands

package/dist/engine-skew.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine-skew.d.ts","sourceRoot":"","sources":["../src/engine-skew.ts"],"names":[],"mappings":"AA0BA,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;kFAGkF;AAClF,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;sEAMsE;AACtE,eAAO,MAAM,kBAAkB,uJACkH,CAAC;AAIlJ;;sEAEsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE9D;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,UAAU,GAAG,IAAI,CAEtD;AAQD,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,MAAM,EAAE,cAAc,CAAC;IACvB;uEACmE;IACnE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAyBzE;AAED;;2DAE2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,mBAAmB,EAC3B,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,mBAAmB,CAYrB"}
+{"version":3,"file":"engine-skew.d.ts","sourceRoot":"","sources":["../src/engine-skew.ts"],"names":[],"mappings":"AA0BA,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;kFAGkF;AAClF,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;0EAEsE;IACtE,WAAW,EAAE,QAAQ,GAAG,eAAe,CAAC;CACzC;AAED;;;;;;sEAMsE;AACtE,eAAO,MAAM,kBAAkB,uJACkH,CAAC;AAIlJ;;sEAEsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE9D;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,IAAI,UAAU,GAAG,IAAI,CAEtD;AAQD,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,MAAM,EAAE,cAAc,CAAC;IACvB;uEACmE;IACnE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB,CAgCzE;AAED;;2DAE2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,mBAAmB,EAC3B,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,mBAAmB,CAYrB"}

package/dist/engine-skew.js

@@ -58,9 +58,13 @@ export function consumeHandshakeIdentity(body) {
     if (!parsed.success) {
         // Identity is advisory; a malformed body never fails the handshake.
         recordEngineSkew(null);
-        return { engine: { engineVersion: null, engineBuildSha: null }, skewAdvisory: null };
+        return {
+            engine: { engineVersion: null, engineBuildSha: null, servingMode: "normal" },
+            skewAdvisory: null,
+        };
     }
     const { version, sha } = parsed.data.engine;
+    const servingMode = parsed.data.servingMode ?? "normal";
     const daemonVersion = ENGINE_VERSION_RE.test(version) ? version : null;
     const engineBuildSha = sha === "unknown" || BUILD_SHA_RE.test(sha) ? sha : null;
     if (daemonVersion && daemonVersion !== CLAUDEXOR_VERSION) {
@@ -70,13 +74,16 @@ export function consumeHandshakeIdentity(body) {
             cliVersion: CLAUDEXOR_VERSION,
         });
         return {
-            engine: { engineVersion: daemonVersion, engineBuildSha },
+            engine: { engineVersion: daemonVersion, engineBuildSha, servingMode },
             skewAdvisory: `claudexor: daemon is engine ${daemonVersion} but this CLI is ${CLAUDEXOR_VERSION}; ` +
                 `${ENGINE_STOP_REMEDY}\n`,
         };
     }
     recordEngineSkew(null);
-    return { engine: { engineVersion: daemonVersion, engineBuildSha }, skewAdvisory: null };
+    return {
+        engine: { engineVersion: daemonVersion, engineBuildSha, servingMode },
+        skewAdvisory: null,
+    };
 }
 /**
  * Shape a typed problem's fields at the controlProblemError choke point:

package/dist/engine-skew.js.map

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

package/dist/mcp-run-projections.d.ts

@@ -1,7 +1,80 @@
-export declare function projectImmediateRunDetail(detail: Record<string, unknown> | null): {
+import { type ExpectedRunFactsIdentity } from "./run-facts-projection.js";
+export declare function projectImmediateRunDetail(detail: Record<string, unknown> | null, expected?: ExpectedRunFactsIdentity): {
     parentRunId: string | null;
     delegatedFromRunId: string | null;
     delegation: Record<string, unknown> | null;
+    runFacts: {
+        schema_version: 2;
+        run_id: string;
+        task_id: string;
+        mode: "agent" | "ask" | "plan";
+        outcome: {
+            lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
+            noChanges: boolean;
+            checks: "failed" | "not_configured" | "passed";
+            review: "approved" | "blocked" | "not_run";
+            reason: "budget_exhausted" | "budget_overshoot" | "checks_failed" | "context_capacity_exhausted" | "cost_unverifiable" | "crash_interrupted" | "harness_failed" | "input_required" | "no_changes" | "not_converged" | "review_blocked" | "stuck_no_progress" | "user_cancelled" | "wall_clock_exceeded" | "work_incomplete" | "work_report_contract" | "workspace_unavailable" | null;
+            work_state?: {
+                state: "completed" | "incomplete" | "needs_input" | "unverified";
+                source: "absent" | "constrained" | "validated";
+                required_inputs?: {
+                    kind: "context" | "credential" | "decision" | "external_dependency" | "file" | "permission";
+                    locator: string | null;
+                    description: string;
+                }[] | undefined;
+            } | undefined;
+        };
+        deliverable: {
+            present: boolean;
+            kind: "answer" | "patch" | "plan" | "report" | "structured_output" | null;
+            path: string | null;
+            producer_attempt_id: string | null;
+        };
+        presentation?: {
+            state: "diagnostic" | "ready";
+            primary: {
+                kind: "answer" | "diagnostic" | "patch" | "plan" | "report" | "structured_output";
+                path: string;
+            } | null;
+        } | undefined;
+        participants: {
+            planners: number;
+            attempts: {
+                attempt_id: string | null;
+                harness_id: string;
+                role: "candidate" | "merge" | "planner" | "reducer" | "reviewer" | "scout";
+                deliverable_present: boolean;
+                status: "blocked" | "failed" | "success" | "success_with_warnings" | null;
+            }[];
+        };
+        gates: {
+            configured: boolean;
+            required: number;
+            total: number;
+            executed: boolean;
+            state: "failed" | "not_configured" | "passed" | "skipped";
+            receipt_attempt_id: string | null;
+        };
+        review: {
+            state: "approved" | "blocked" | "not_run";
+            blocker_ids: string[];
+            blockers: number;
+        };
+        apply: {
+            eligibility: {
+                eligible: boolean;
+                state: string | null;
+                reason: string | null;
+                requiredAction: string | null;
+            } | null;
+            operator_decision_present: boolean;
+        };
+        required_actions: {
+            id: "complete_incomplete_work" | "fix_failed_checks" | "provide_required_input" | "record_operator_decision" | "resolve_review_block";
+            detail: string;
+        }[];
+        generated_at: string;
+    } | null;
     outcomeFacts: {
         lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
         noChanges: boolean;
@@ -40,4 +113,8 @@ export declare function projectImmediateRunDetail(detail: Record<string, unknown
 };
 /** One typed read projection for inspect/status/result from a single detail snapshot. */
 export declare function projectRecoveryRunDetail(mode: string, runId: string, detail: Record<string, unknown>, delegationParentRunId?: string): Record<string, unknown>;
+/** Only canonical detail-integrity failures preserve a public recovery handle. */
+export declare function isRecoverableRunDetailIntegrityProblem(error: unknown): boolean;
+/** Minimal schema-valid handle when public recovery cannot trust run detail. */
+export declare function projectDegradedRecoveryRunDetail(runId: string, error: unknown): Record<string, unknown>;
 //# sourceMappingURL=mcp-run-projections.d.ts.map

package/dist/mcp-run-projections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-run-projections.d.ts","sourceRoot":"","sources":["../src/mcp-run-projections.ts"],"names":[],"mappings":"AAYA,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc/E;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,qBAAqB,CAAC,EAAE,MAAM,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4DzB"}
+{"version":3,"file":"mcp-run-projections.d.ts","sourceRoot":"","sources":["../src/mcp-run-projections.ts"],"names":[],"mappings":"AAcA,OAAO,EAAmB,KAAK,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE3F,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACtC,QAAQ,GAAE,wBAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBxC;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,qBAAqB,CAAC,EAAE,MAAM,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+EzB;AAED,kFAAkF;AAClF,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ9E;AAED,gFAAgF;AAChF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}

package/dist/mcp-run-projections.js

@@ -1,7 +1,11 @@
-import { projectApplyEligibility, projectOutcomeBanner, presentRunPrimaryOutput, projectRunFailure, projectRunCouncil, projectRunLineage, projectRunPrimaryOutput, projectRunSpendUsd, } from "./run-detail-projections.js";
+import { isTerminalLifecycle, RunFactsInvalidError } from "@claudexor/schema";
+import { CliError } from "./cli-error.js";
+import { describeRunDetailProblem, projectApplyEligibility, projectOutcomeBanner, presentRunPrimaryOutput, projectRunFailure, projectRunCouncil, projectRunLineage, projectRunPrimaryOutput, projectRunSpendUsd, } from "./run-detail-projections.js";
 import { projectRunOutcomeFacts } from "./daemon-outcome.js";
-export function projectImmediateRunDetail(detail) {
+import { projectRunFacts } from "./run-facts-projection.js";
+export function projectImmediateRunDetail(detail, expected = {}) {
     return {
+        runFacts: projectRunFacts(detail, expected),
         outcomeFacts: projectRunOutcomeFacts(detail),
         applyEligibility: projectApplyEligibility(detail),
         spendUsd: projectRunSpendUsd(detail),
@@ -17,7 +21,14 @@ export function projectImmediateRunDetail(detail) {
 /** One typed read projection for inspect/status/result from a single detail snapshot. */
 export function projectRecoveryRunDetail(mode, runId, detail, delegationParentRunId) {
     const summary = (detail["summary"] ?? {});
-    if (delegationParentRunId && summary["delegatedFromRunId"] !== delegationParentRunId) {
+    if (summary["runId"] !== runId) {
+        throw new CliError("operational", `run detail identity does not match requested run ${runId}`, {
+            code: "invalid_service_response",
+            retryable: true,
+        });
+    }
+    if (delegationParentRunId !== undefined &&
+        summary["delegatedFromRunId"] !== delegationParentRunId) {
         throw Object.assign(new Error(`run ${runId} is not a child of this delegation parent`), {
             code: "delegation_child_scope_violation",
             status: 403,
@@ -27,10 +38,19 @@ export function projectRecoveryRunDetail(mode, runId, detail, delegationParentRu
     const status = (typeof summary["state"] === "string" ? summary["state"] : null) ??
         (typeof summary["status"] === "string" ? summary["status"] : null) ??
         null;
+    const runFacts = status === "queued" || status === "running"
+        ? null
+        : projectRunFacts(detail, {
+            runId,
+            ...(status && isTerminalLifecycle(status)
+                ? { lifecycle: status }
+                : {}),
+        });
     const base = {
         runId,
         runDir: typeof summary["runDir"] === "string" ? summary["runDir"] : null,
         status,
+        runFacts,
         decisionStatus: decision ? (decision["status"] ?? null) : null,
         pendingInteractions: Array.isArray(detail["pendingInteractions"])
             ? detail["pendingInteractions"].length
@@ -71,4 +91,38 @@ export function projectRecoveryRunDetail(mode, runId, detail, delegationParentRu
                     : `run ${runId}: ${String(status ?? "unknown")}`;
     return { summary: terminalSummary, ...base };
 }
+/** Only canonical detail-integrity failures preserve a public recovery handle. */
+export function isRecoverableRunDetailIntegrityProblem(error) {
+    const record = error && typeof error === "object" ? error : {};
+    const code = record["code"];
+    if (code !== "run_facts_invalid" && code !== "invalid_service_response")
+        return false;
+    if (typeof record["mcpRecoveryTypedControlProblem"] === "boolean") {
+        return record["mcpRecoveryTypedControlProblem"] === true;
+    }
+    return error instanceof RunFactsInvalidError || error instanceof CliError;
+}
+/** Minimal schema-valid handle when public recovery cannot trust run detail. */
+export function projectDegradedRecoveryRunDetail(runId, error) {
+    return {
+        summary: `run ${runId}: detail unavailable`,
+        runId,
+        runDir: null,
+        status: null,
+        runFacts: null,
+        decisionStatus: null,
+        pendingInteractions: null,
+        outcomeFacts: null,
+        failure: null,
+        outcomeBanner: null,
+        applyEligibility: null,
+        planReadiness: null,
+        council: null,
+        budget: null,
+        parentRunId: null,
+        delegatedFromRunId: null,
+        delegation: null,
+        detailProblem: describeRunDetailProblem(error),
+    };
+}
 //# sourceMappingURL=mcp-run-projections.js.map

package/dist/mcp-run-projections.js.map

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

package/dist/mcp-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-runner.d.ts","sourceRoot":"","sources":["../src/mcp-runner.ts"],"names":[],"mappings":"AAeA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAIpE,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC;8DAC0D;IAC1D,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;oFACgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;qFACiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;0CAEsC;IACtC,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,GAAG,EACV,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,gBAAgB,CAAC;QAChC,YAAY,EAAE,OAAO,qBAAqB,CAAC;KAC5C,KACE,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,OACnD,GAAG,UAAU,kBAAkB,sBAwLjD;AA8OD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,WAAW,GAClB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAqB5C;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAC/C,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CA0E5C"}
+{"version":3,"file":"mcp-runner.d.ts","sourceRoot":"","sources":["../src/mcp-runner.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAUpE,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC;8DAC0D;IAC1D,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;oFACgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC;qFACiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;0CAEsC;IACtC,eAAe,CAAC,EAAE,CAChB,KAAK,EAAE,GAAG,EACV,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,gBAAgB,CAAC;QAChC,YAAY,EAAE,OAAO,qBAAqB,CAAC;KAC5C,KACE,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,OACnD,GAAG,UAAU,kBAAkB,sBA6KjD;AAoPD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,WAAW,GAClB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAqB5C;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,GAC/C,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CA0E5C"}

package/dist/mcp-runner.js

@@ -1,10 +1,12 @@
-import { isTerminalLifecycle, ModeKind } from "@claudexor/schema";
+import { ControlProblem, isTerminalLifecycle, ModeKind, } from "@claudexor/schema";
 import { connectDaemonIfRunning, daemonOutcomeSummary, ensureDaemon, enqueueAndAwait, fetchRunDetail, } from "./daemon-run.js";
 import { describeRunDetailProblem, presentRunPrimaryOutput, projectRunFailure, projectRunPrimaryOutput, } from "./run-detail-projections.js";
 import { primaryOutputForCli } from "./primary-output.js";
+import { controlProblemError } from "./cli-error.js";
 import { controlApiFetch } from "./live.js";
 import { absentDaemonRecovery, BELT_DAEMON_LOST } from "./mcp-daemon-unavailable.js";
-import { projectImmediateRunDetail, projectRecoveryRunDetail } from "./mcp-run-projections.js";
+import { isRecoverableRunDetailIntegrityProblem, projectDegradedRecoveryRunDetail, projectImmediateRunDetail, projectRecoveryRunDetail, } from "./mcp-run-projections.js";
+import { readRunDetailResponse } from "./run-detail-response.js";
 /**
  * Shared MCP/ACP runner. All product modes cross the daemon's /v2 boundary;
  * interactive questions bridge through pendingInteractions and typed answers.
@@ -112,30 +114,28 @@ export function mcpSurfaceRunner(options = {}) {
             ...(onPollTick ? { onPollTick } : {}),
         });
         try {
-            // The derived apply verdict rides the result (single producer: the run
-            // detail endpoint). The post-terminal detail read DEGRADES: a missing/
-            // legacy detail projects null fields, and a raised typed problem —
-            // especially 500 run_facts_invalid, the server's verdict that the run's
-            // receipt cannot be trusted — rides the result as `detailProblem` with
-            // the runId preserved instead of erasing the finished run's outcome.
-            // A deferred MCP call normally returns while the run is still live, but
-            // the bind/status race may already observe a terminal. Project detail
-            // from ACTUAL lifecycle truth; never delay an ordinary running handle.
             let detail = null;
+            let canonicalPrimary = null;
+            let detailProjection = projectImmediateRunDetail(null, { runId: out.runId });
             let detailProblem = null;
             if (p?.deferred !== true || isTerminalLifecycle(out.status)) {
                 try {
                     detail = await fetchRunDetail(addr, out.runId);
+                    detailProjection = projectImmediateRunDetail(detail, {
+                        runId: out.runId,
+                        ...(isTerminalLifecycle(out.status)
+                            ? { lifecycle: out.status }
+                            : {}),
+                    });
+                    canonicalPrimary = projectRunPrimaryOutput(detail);
                 }
                 catch (error) {
+                    detail = null;
                     detailProblem = describeRunDetailProblem(error);
+                    detailProjection = projectImmediateRunDetail(null, { runId: out.runId });
                 }
             }
-            // Canonical output comes from that same detail read (bounded, redacted,
-            // mode-aware). Read local artifacts only when detail was attempted but
-            // unavailable; this preserves a useful terminal result without creating a
-            // second normal-path artifact owner.
-            const canonicalPrimary = projectRunPrimaryOutput(detail);
+            // Local artifacts remain only the established soft-absence fallback.
             const localFallback = (p?.deferred !== true || isTerminalLifecycle(out.status)) &&
                 !detail &&
                 !detailProblem &&
@@ -149,7 +149,6 @@ export function mcpSurfaceRunner(options = {}) {
                 : null;
             const primary = canonicalPrimary ?? localFallback;
             const presented = presentRunPrimaryOutput(primary);
-            const detailProjection = projectImmediateRunDetail(detail);
             const reason = daemonOutcomeSummary({
                 ...out,
                 outcomeFacts: detailProjection.outcomeFacts ?? undefined,
@@ -158,14 +157,6 @@ export function mcpSurfaceRunner(options = {}) {
                 detailProjection.outcomeBanner ??
                 reason ??
                 (primary?.kind === "patch" ? "patch produced (see artifacts)" : `run ${out.status}`);
-            // The sub-run's real settled spend rides the result so the delegation belt
-            // can reconcile its budget reservation against the actual drawn amount
-            // (single producer: the run-detail budget projection). Deferred calls return
-            // before terminal, so spend is not yet settled — null (the belt then keeps
-            // its reservation committed fail-closed rather than seeing spend 0).
-            // Council membership + merge disclosure (QA-023b) rides the result so an MCP
-            // host that asked for `--council` can machine-verify it was really N/N and
-            // who merged. Terminal projection — null on a deferred (still-live) handle.
             return {
                 runId: out.runId,
                 runDir: out.runDir,
@@ -220,18 +211,21 @@ async function recoveryQuery(mode, runId, input = {}, context = {}) {
     if (!conn)
         return absentDaemonRecovery(mode, context.beltContext);
     const { addr } = conn;
-    const get = async (path) => {
+    const get = async (path, runDetail = false) => {
         const res = await controlApiFetch(addr, path, {
             headers: { authorization: `Bearer ${addr.token}` },
         });
-        const body = (await res.json().catch(() => ({})));
-        if (!res.ok)
-            throw new Error(typeof body["message"] === "string"
-                ? body["message"]
-                : typeof body["error"] === "string"
-                    ? body["error"]
-                    : `HTTP ${res.status} for ${path}`);
-        return body;
+        if (res.ok) {
+            return runDetail
+                ? readRunDetailResponse(res)
+                : (await res.json());
+        }
+        const body = await res.json().catch(() => ({}));
+        const error = controlProblemError(res.status, body, `HTTP ${res.status} for ${path}`);
+        Object.assign(error, {
+            mcpRecoveryTypedControlProblem: ControlProblem.safeParse(body).success,
+        });
+        throw error;
     };
     if (mode === "__runs_list") {
         // GET /runs is a BOUNDED keyset page (QA-052): a single read undercounts the
@@ -285,10 +279,20 @@ async function recoveryQuery(mode, runId, input = {}, context = {}) {
     if (!runId)
         throw new Error("runId is required");
     if (mode === "__run_inspect" || mode === "__run_status" || mode === "__run_result") {
-        const detail = await get(`/runs/${encodeURIComponent(runId)}`);
-        return projectRecoveryRunDetail(mode, runId, detail, typeof input["delegatedFromRunId"] === "string"
+        const parent = typeof input["delegatedFromRunId"] === "string"
             ? input["delegatedFromRunId"]
-            : undefined);
+            : undefined;
+        const scopedRecovery = context.beltContext || parent !== undefined;
+        try {
+            const detail = await get(`/runs/${encodeURIComponent(runId)}`, true);
+            return projectRecoveryRunDetail(mode, runId, detail, parent);
+        }
+        catch (error) {
+            if (scopedRecovery || !isRecoverableRunDetailIntegrityProblem(error)) {
+                throw error;
+            }
+            return projectDegradedRecoveryRunDetail(runId, error);
+        }
     }
     if (mode === "__run_cancel") {
         const res = await controlApiFetch(addr, `/runs/${encodeURIComponent(runId)}/control`, {