@claudexor/cli 3.1.1 → 3.2.0

package/dist/request-preflight.d.ts

@@ -1,13 +1,22 @@
 import type { AdapterRegistry } from "@claudexor/core";
 import type { ResourceStore } from "@claudexor/daemon";
 import type { HarnessStatus } from "@claudexor/gateway";
-import type { AccessProfile, ControlRunStartRequest } from "@claudexor/schema";
+import { type AccessProfile, type ControlRunStartRequest, type GitCapability } from "@claudexor/schema";
 interface RunRequirementsPreflightDependencies {
     statusAll?: (cwd: string) => Promise<Array<Pick<HarnessStatus, "id" | "status" | "enabledIntents">>>;
     registry?: AdapterRegistry;
     accessDefault?: (cwd: string) => AccessProfile;
+    gitCapability?: () => Promise<GitCapability>;
+    requiresGit?: (request: ControlRunStartRequest) => boolean;
 }
+export interface RunRequirementsPreflightPolicy {
+    /** Thread turns defer Git to the durable daemon job; direct runs keep eager admission. */
+    git?: "eager" | "durable_job";
+}
+/** Canonical Git admission used both eagerly by direct runs and immediately
+ * pre-provider by durable thread jobs. */
+export declare function preflightRunGitRequirement(request: ControlRunStartRequest, dependencies?: Pick<RunRequirementsPreflightDependencies, "gitCapability" | "requiresGit">): Promise<void>;
 /** Refuse requests that no selected lane can satisfy before a run or turn is created. */
-export declare function createRunRequirementsPreflight(resources: Pick<ResourceStore, "resolve">, noProjectRoot: string, dependencies?: RunRequirementsPreflightDependencies): (request: ControlRunStartRequest) => Promise<void>;
+export declare function createRunRequirementsPreflight(resources: Pick<ResourceStore, "resolve">, noProjectRoot: string, dependencies?: RunRequirementsPreflightDependencies, policy?: RunRequirementsPreflightPolicy): (request: ControlRunStartRequest) => Promise<void>;
 export {};
 //# sourceMappingURL=request-preflight.d.ts.map

package/dist/request-preflight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-preflight.d.ts","sourceRoot":"","sources":["../src/request-preflight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAU,MAAM,mBAAmB,CAAC;AASvF,UAAU,oCAAoC;IAC5C,SAAS,CAAC,EAAE,CACV,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;CAChD;AAED,yFAAyF;AACzF,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,YAAY,GAAE,oCAAyC,GACtD,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAgFpD"}
+{"version":3,"file":"request-preflight.d.ts","sourceRoot":"","sources":["../src/request-preflight.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAU3B,UAAU,oCAAoC;IAC5C,SAAS,CAAC,EAAE,CACV,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;IAC/C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC;CAC5D;AAED,MAAM,WAAW,8BAA8B;IAC7C,0FAA0F;IAC1F,GAAG,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CAC/B;AAED;0CAC0C;AAC1C,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,sBAAsB,EAC/B,YAAY,GAAE,IAAI,CAAC,oCAAoC,EAAE,eAAe,GAAG,aAAa,CAAM,GAC7F,OAAO,CAAC,IAAI,CAAC,CAef;AAED,yFAAyF;AACzF,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,EACzC,aAAa,EAAE,MAAM,EACrB,YAAY,GAAE,oCAAyC,EACvD,MAAM,GAAE,8BAAmC,GAC1C,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAkFpD"}

package/dist/request-preflight.js

@@ -1,15 +1,39 @@
 import { loadConfig } from "@claudexor/config";
 import { RequestRequirementsResolver } from "@claudexor/orchestrator";
+import { runStartRequiresGit, } from "@claudexor/schema";
+import { gitCapabilityProblem, probeGitCapability } from "@claudexor/workspace";
 import { buildGateway, buildRegistry } from "./registry.js";
 const modeIntent = {
     agent: "implement",
     ask: "explain",
     plan: "plan",
 };
+/** Canonical Git admission used both eagerly by direct runs and immediately
+ * pre-provider by durable thread jobs. */
+export async function preflightRunGitRequirement(request, dependencies = {}) {
+    if (!(dependencies.requiresGit ?? runStartRequiresGit)(request))
+        return;
+    const git = await (dependencies.gitCapability ?? probeGitCapability)();
+    const blocker = gitCapabilityProblem(git);
+    if (!blocker)
+        return;
+    throw Object.assign(new Error(blocker.reason), {
+        status: 503,
+        code: blocker.code,
+        retryable: true,
+        requiredActions: [blocker.remediation ?? "Install Git and retry."],
+        context: {
+            capability: "git",
+            capabilityStatus: git.status,
+        },
+    });
+}
 /** Refuse requests that no selected lane can satisfy before a run or turn is created. */
-export function createRunRequirementsPreflight(resources, noProjectRoot, dependencies = {}) {
+export function createRunRequirementsPreflight(resources, noProjectRoot, dependencies = {}, policy = {}) {
     const requirements = new RequestRequirementsResolver();
     return async (request) => {
+        if ((policy.git ?? "eager") === "eager")
+            await preflightRunGitRequirement(request, dependencies);
         if ((request.attachments?.length ?? 0) === 0 && request.browser !== true)
             return;
         const cwd = request.scope.kind === "project" ? request.scope.root : noProjectRoot;
@@ -35,19 +59,18 @@ export function createRunRequirementsPreflight(resources, noProjectRoot, depende
                 throw requestError(`unknown harness lane: ${harnessId}`, 400, "harness_unavailable");
             return { harnessId, manifest: await adapter.discover() };
         }));
-        const compatibleManifests = [];
-        for (const { harnessId, manifest } of manifests) {
-            const refusal = requirements.attachmentRefusal(harnessId, attachments, manifest.capability_profile.attachment_inputs);
-            if (refusal) {
-                if (explicitPool)
-                    throw requestError(refusal, 400, "attachment_pool_unsupported");
-                continue;
-            }
-            compatibleManifests.push({ harnessId, manifest });
-        }
-        if (compatibleManifests.length === 0) {
-            throw requestError("no eligible harness lane can receive every required attachment", 400, "attachment_pool_unsupported");
+        const attachmentAdmission = requirements.resolveAttachmentPool(explicitPool ? "explicit" : "auto", attachments, manifests.map(({ harnessId, manifest }) => ({
+            harnessId,
+            declarations: manifest.capability_profile.attachment_inputs,
+            available: true,
+        })));
+        if (attachmentAdmission.outcome === "refused") {
+            throw requestError(attachmentAdmission.message ??
+                "no eligible harness lane can receive every required attachment", 400, "attachment_pool_unsupported");
         }
+        const compatibleManifests = attachmentAdmission.admittedHarnessIds
+            .map((harnessId) => manifests.find((entry) => entry.harnessId === harnessId))
+            .filter((entry) => entry !== undefined);
         if (request.browser !== true)
             return;
         const access = intent === "implement"

package/dist/request-preflight.js.map

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

package/dist/retry-command-specs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry-command-specs.d.ts","sourceRoot":"","sources":["../src/retry-command-specs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,eAAO,MAAM,mBAAmB,EAAE,SAAS,cAAc,EAmBxD,CAAC"}
+{"version":3,"file":"retry-command-specs.d.ts","sourceRoot":"","sources":["../src/retry-command-specs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,eAAO,MAAM,mBAAmB,EAAE,SAAS,cAAc,EAqBxD,CAAC"}

package/dist/retry-command-specs.js

@@ -1,6 +1,7 @@
 export const RETRY_COMMAND_SPECS = [
     {
         id: "retry",
+        positionalPatterns: [{ min: 1, max: 1 }],
         usageArgs: "<run_id>",
         summary: "Exact Retry with the immutable original request and fresh preflight",
         flags: ["json"],
@@ -10,6 +11,7 @@ export const RETRY_COMMAND_SPECS = [
     },
     {
         id: "run-again",
+        positionalPatterns: [{ min: 1, max: 1 }],
         usageArgs: "<run_id>",
         summary: "Print an editable draft copied from a prior run",
         flags: ["json"],

package/dist/retry-command-specs.js.map

@@ -1 +1 @@
-{"version":3,"file":"retry-command-specs.js","sourceRoot":"","sources":["../src/retry-command-specs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAA8B;IAC5D;QACE,EAAE,EAAE,OAAO;QACX,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,IAAI;KACf;IACD;QACE,EAAE,EAAE,WAAW;QACf,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,iDAAiD;QAC1D,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,IAAI;KACf;CACF,CAAC"}
+{"version":3,"file":"retry-command-specs.js","sourceRoot":"","sources":["../src/retry-command-specs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAA8B;IAC5D;QACE,EAAE,EAAE,OAAO;QACX,kBAAkB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACxC,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,qEAAqE;QAC9E,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,OAAO;QACnB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,IAAI;KACf;IACD;QACE,EAAE,EAAE,WAAW;QACf,kBAAkB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;QACxC,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,iDAAiD;QAC1D,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,UAAU,EAAE,MAAM;QAClB,SAAS,EAAE,QAAQ;QACnB,QAAQ,EAAE,IAAI;KACf;CACF,CAAC"}

package/dist/run-applicability.d.ts

@@ -0,0 +1,74 @@
+import { type GitCapability, type RunGitApplicabilityMatrix } from "@claudexor/schema";
+export interface RunApplicabilityDependencies {
+    gitCapability?: () => Promise<GitCapability>;
+    protectedPaths?: (repoRoot: string) => readonly string[];
+}
+/**
+ * Project one complete matrix through the same predicate the actual thread
+ * resolver and run preflight use. Clients only select a cell from their exact
+ * outgoing wire; they never reproduce Git/worktree business rules.
+ */
+export declare function buildRunApplicabilityMatrix(input: {
+    repoRoot: string;
+    protectedPaths: readonly string[];
+    git: GitCapability;
+}): RunGitApplicabilityMatrix;
+/** Root-scoped service behind GET /run-applicability. */
+export declare function projectRunApplicability(requestedRoot: string, dependencies?: RunApplicabilityDependencies): Promise<{
+    repoRoot: string;
+    git: {
+        status: "available" | "developer_tools_stub" | "failed" | "missing";
+        version: string | null;
+        detail: string | null;
+        remediation: string | null;
+    };
+    matrix: {
+        in_place: {
+            read_only: {
+                applicable: boolean;
+                requiresGit: boolean;
+                code: "git_developer_tools_stub" | "git_failed" | "git_missing" | null;
+                reason: string | null;
+                remediation: string | null;
+            };
+            agent_convergence: {
+                applicable: boolean;
+                requiresGit: boolean;
+                code: "git_developer_tools_stub" | "git_failed" | "git_missing" | null;
+                reason: string | null;
+                remediation: string | null;
+            };
+            agent_other: {
+                applicable: boolean;
+                requiresGit: boolean;
+                code: "git_developer_tools_stub" | "git_failed" | "git_missing" | null;
+                reason: string | null;
+                remediation: string | null;
+            };
+        };
+        isolated: {
+            read_only: {
+                applicable: boolean;
+                requiresGit: boolean;
+                code: "git_developer_tools_stub" | "git_failed" | "git_missing" | null;
+                reason: string | null;
+                remediation: string | null;
+            };
+            agent_convergence: {
+                applicable: boolean;
+                requiresGit: boolean;
+                code: "git_developer_tools_stub" | "git_failed" | "git_missing" | null;
+                reason: string | null;
+                remediation: string | null;
+            };
+            agent_other: {
+                applicable: boolean;
+                requiresGit: boolean;
+                code: "git_developer_tools_stub" | "git_failed" | "git_missing" | null;
+                reason: string | null;
+                remediation: string | null;
+            };
+        };
+    };
+}>;
+//# sourceMappingURL=run-applicability.d.ts.map

package/dist/run-applicability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-applicability.d.ts","sourceRoot":"","sources":["../src/run-applicability.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,4BAA4B;IAC3C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7C,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAC;CAC1D;AA+BD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,GAAG,EAAE,aAAa,CAAC;CACpB,GAAG,yBAAyB,CAqB5B;AAED,yDAAyD;AACzD,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,YAAY,GAAE,4BAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAehD"}

package/dist/run-applicability.js

@@ -0,0 +1,72 @@
+import { loadConfig } from "@claudexor/config";
+import { normalizeExistingProjectRoot } from "@claudexor/control-api";
+import { ControlRunApplicabilityResponse, ThreadWorkspace, } from "@claudexor/schema";
+import { gitCapabilityProblem, probeGitCapability } from "@claudexor/workspace";
+import { threadRunStartRequiresGit } from "./thread-execution-workspace.js";
+function requestFor(repoRoot, shape) {
+    const base = {
+        prompt: "run applicability projection",
+        scope: { kind: "project", root: repoRoot, context: "auto" },
+        execution: { isolation: shape === "read_only" ? "envelope" : "live" },
+    };
+    if (shape === "read_only")
+        return { ...base, mode: "ask" };
+    if (shape === "agent_convergence")
+        return { ...base, mode: "agent", untilClean: true };
+    return { ...base, mode: "agent" };
+}
+function cell(requiresGit, git) {
+    const blocker = gitCapabilityProblem(git);
+    if (!requiresGit || blocker === null) {
+        return {
+            applicable: true,
+            requiresGit,
+            code: null,
+            reason: null,
+            remediation: null,
+        };
+    }
+    return {
+        applicable: false,
+        requiresGit: true,
+        ...blocker,
+    };
+}
+/**
+ * Project one complete matrix through the same predicate the actual thread
+ * resolver and run preflight use. Clients only select a cell from their exact
+ * outgoing wire; they never reproduce Git/worktree business rules.
+ */
+export function buildRunApplicabilityMatrix(input) {
+    const workspace = (mode) => ({
+        workspace: ThreadWorkspace.parse({ mode }),
+    });
+    const project = (mode) => {
+        const thread = workspace(mode);
+        const projectCell = (shape) => cell(threadRunStartRequiresGit(requestFor(input.repoRoot, shape), thread, input.protectedPaths), input.git);
+        return {
+            read_only: projectCell("read_only"),
+            agent_convergence: projectCell("agent_convergence"),
+            agent_other: projectCell("agent_other"),
+        };
+    };
+    return {
+        in_place: project("in_place"),
+        isolated: project("isolated"),
+    };
+}
+/** Root-scoped service behind GET /run-applicability. */
+export async function projectRunApplicability(requestedRoot, dependencies = {}) {
+    const repoRoot = normalizeExistingProjectRoot(requestedRoot);
+    const [git, protectedPaths] = await Promise.all([
+        (dependencies.gitCapability ?? probeGitCapability)(),
+        Promise.resolve(dependencies.protectedPaths?.(repoRoot) ??
+            loadConfig(repoRoot).project.constraints.protected_paths),
+    ]);
+    return ControlRunApplicabilityResponse.parse({
+        repoRoot,
+        git,
+        matrix: buildRunApplicabilityMatrix({ repoRoot, protectedPaths, git }),
+    });
+}
+//# sourceMappingURL=run-applicability.js.map

package/dist/run-applicability.js.map

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

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

@@ -0,0 +1,39 @@
+import { type ControlPrimaryOutput as ControlPrimaryOutputType, type RunFailure as RunFailureType } from "@claudexor/schema";
+export type PrimaryOutputPresentation = Pick<ControlPrimaryOutputType, "kind" | "path" | "text"> & {
+    truncated?: boolean;
+};
+/** Schema-validate the Control API's single primary-output owner. */
+export declare function projectRunPrimaryOutput(detail: Record<string, unknown> | null): ControlPrimaryOutputType | null;
+/** Inline non-patch output with an honest bounded-preview disclosure. */
+export declare function presentRunPrimaryOutput(output: PrimaryOutputPresentation | null): string | null;
+export type ApplyEligibilityProjection = {
+    eligible: boolean;
+    state: string | null;
+    reason: string | null;
+    requiredAction: string | null;
+};
+export declare function projectApplyEligibility(detail: Record<string, unknown> | null): ApplyEligibilityProjection | null;
+export declare function projectRunSpendUsd(detail: Record<string, unknown> | null): number | null;
+export declare function projectRunCouncil(detail: Record<string, unknown> | null): unknown;
+/** Preserve only the schema-owned typed terminal failure. Every surface uses
+ * this projection instead of forwarding an arbitrary failure-shaped object. */
+export declare function projectRunFailure(detail: Record<string, unknown> | null): RunFailureType | null;
+export declare function projectRunLineage(detail: Record<string, unknown> | null): {
+    parentRunId: string | null;
+    delegatedFromRunId: string | null;
+    delegation: Record<string, unknown> | null;
+};
+export declare function projectOutcomeBanner(detail: Record<string, unknown> | null): string | null;
+/** Typed description of a raised post-terminal run-detail problem for surfaces
+ * that must DEGRADE instead of failing the caller (MCP results, ACP turn
+ * results, --json outcome projections): the finished run's result survives with
+ * its runId, and this field discloses WHY its detail projections are absent.
+ * The CLI's own terminal path keeps the raise (renderCliFailure, non-zero
+ * exit) — there the run result IS the process outcome. */
+export interface RunDetailProblem {
+    code: string | null;
+    message: string;
+    retryable: boolean | null;
+}
+export declare function describeRunDetailProblem(error: unknown): RunDetailProblem;
+//# sourceMappingURL=run-detail-projections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-detail-projections.d.ts","sourceRoot":"","sources":["../src/run-detail-projections.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,IAAI,wBAAwB,EACrD,KAAK,UAAU,IAAI,cAAc,EAClC,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,wBAAwB,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,GAAG;IACjG,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACrC,wBAAwB,GAAG,IAAI,CAGjC;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,yBAAyB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAO/F;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACrC,0BAA0B,GAAG,IAAI,CAGnC;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAOxF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,OAAO,CAGjF;AAED;+EAC+E;AAC/E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,cAAc,GAAG,IAAI,CAG/F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC5C,CAcA;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAG1F;AAED;;;;;0DAK0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAOzE"}

package/dist/run-detail-projections.js

@@ -0,0 +1,64 @@
+import { ControlPrimaryOutput, CouncilProjection, RunFailure, } from "@claudexor/schema";
+import { redactSecrets } from "@claudexor/util";
+/** Schema-validate the Control API's single primary-output owner. */
+export function projectRunPrimaryOutput(detail) {
+    const parsed = ControlPrimaryOutput.safeParse(detail?.["primaryOutput"]);
+    return parsed.success ? parsed.data : null;
+}
+/** Inline non-patch output with an honest bounded-preview disclosure. */
+export function presentRunPrimaryOutput(output) {
+    if (!output || output.kind === "patch" || typeof output.text !== "string")
+        return null;
+    const text = output.text.trim();
+    if (!text)
+        return null;
+    return output.truncated === true
+        ? `${text}\n\n[Inline preview bounded; full artifact: ${output.path}]`
+        : text;
+}
+export function projectApplyEligibility(detail) {
+    const value = detail?.["applyEligibility"];
+    return value && typeof value === "object" ? value : null;
+}
+export function projectRunSpendUsd(detail) {
+    const summary = detail?.["summary"];
+    const spend = summary && typeof summary === "object"
+        ? summary.spendUsd
+        : undefined;
+    return typeof spend === "number" && Number.isFinite(spend) ? spend : null;
+}
+export function projectRunCouncil(detail) {
+    const parsed = CouncilProjection.safeParse(detail?.["council"]);
+    return parsed.success ? parsed.data : null;
+}
+/** Preserve only the schema-owned typed terminal failure. Every surface uses
+ * this projection instead of forwarding an arbitrary failure-shaped object. */
+export function projectRunFailure(detail) {
+    const parsed = RunFailure.safeParse(detail?.["failure"]);
+    return parsed.success ? parsed.data : null;
+}
+export function projectRunLineage(detail) {
+    const summary = detail?.["summary"] && typeof detail["summary"] === "object"
+        ? detail["summary"]
+        : null;
+    return {
+        parentRunId: typeof summary?.["parentRunId"] === "string" ? summary["parentRunId"] : null,
+        delegatedFromRunId: typeof summary?.["delegatedFromRunId"] === "string" ? summary["delegatedFromRunId"] : null,
+        delegation: summary?.["delegation"] && typeof summary["delegation"] === "object"
+            ? summary["delegation"]
+            : null,
+    };
+}
+export function projectOutcomeBanner(detail) {
+    const banner = detail?.["outcomeBanner"];
+    return typeof banner === "string" && banner.length > 0 ? banner : null;
+}
+export function describeRunDetailProblem(error) {
+    const record = error && typeof error === "object" ? error : {};
+    return {
+        code: typeof record["code"] === "string" && record["code"] ? record["code"] : null,
+        message: redactSecrets(error instanceof Error ? error.message : String(error)),
+        retryable: typeof record["retryable"] === "boolean" ? record["retryable"] : null,
+    };
+}
+//# sourceMappingURL=run-detail-projections.js.map

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

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

package/dist/run-detail-response.d.ts

@@ -0,0 +1,7 @@
+type JsonResponse = {
+    json(): Promise<unknown>;
+};
+/** Decode and schema-check a successful Control API run-detail response. */
+export declare function readRunDetailResponse(response: JsonResponse): Promise<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=run-detail-response.d.ts.map

package/dist/run-detail-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-detail-response.d.ts","sourceRoot":"","sources":["../src/run-detail-response.ts"],"names":[],"mappings":"AAGA,KAAK,YAAY,GAAG;IAAE,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAEjD,4EAA4E;AAC5E,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWlC"}

package/dist/run-detail-response.js

@@ -0,0 +1,23 @@
+import { ControlRunDetail } from "@claudexor/schema";
+import { CliError } from "./cli-error.js";
+/** Decode and schema-check a successful Control API run-detail response. */
+export async function readRunDetailResponse(response) {
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        throw invalidRunDetailResponse("run detail endpoint returned malformed JSON");
+    }
+    if (!ControlRunDetail.safeParse(body).success) {
+        throw invalidRunDetailResponse("run detail endpoint returned an invalid response");
+    }
+    return body;
+}
+function invalidRunDetailResponse(message) {
+    return new CliError("operational", message, {
+        code: "invalid_service_response",
+        retryable: true,
+    });
+}
+//# sourceMappingURL=run-detail-response.js.map

package/dist/run-detail-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-detail-response.js","sourceRoot":"","sources":["../src/run-detail-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAsB;IAEtB,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,wBAAwB,CAAC,6CAA6C,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9C,MAAM,wBAAwB,CAAC,kDAAkD,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,IAA+B,CAAC;AACzC,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAe;IAC/C,OAAO,IAAI,QAAQ,CAAC,aAAa,EAAE,OAAO,EAAE;QAC1C,IAAI,EAAE,0BAA0B;QAChC,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/run-facts-projection.d.ts

@@ -0,0 +1,22 @@
+import { type ExpectedRunFactsIdentity, type RunFacts as RunFactsType } from "@claudexor/schema";
+import { type ApplyEligibilityProjection } from "./run-detail-projections.js";
+type RunDetail = Record<string, unknown> | null;
+export type { ExpectedRunFactsIdentity } from "@claudexor/schema";
+/** Exact validated terminal receipt from an already-fetched run detail. */
+export declare function projectRunFacts(detail: RunDetail, expected?: ExpectedRunFactsIdentity): RunFactsType | null;
+/**
+ * Shared fields appended to both terminal machine surfaces. RunFacts is
+ * intentionally always present; only a genuinely missing legacy receipt
+ * projects to null, while present malformed data fails loudly.
+ */
+export declare function projectTerminalDetailFields(detail: RunDetail, expected?: ExpectedRunFactsIdentity): {
+    outcomeBanner?: string;
+    applyEligibility?: ApplyEligibilityProjection;
+    runFacts: RunFactsType | null;
+};
+type YamlArtifactReader = {
+    readYaml(path: string): unknown;
+};
+/** Read the canonical immutable RunFacts artifact without reconstructing it. */
+export declare function readRunFactsArtifact(reader: YamlArtifactReader, finalDir: string, expected?: ExpectedRunFactsIdentity): RunFactsType | null;
+//# sourceMappingURL=run-facts-projection.d.ts.map

package/dist/run-facts-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-facts-projection.d.ts","sourceRoot":"","sources":["../src/run-facts-projection.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,QAAQ,IAAI,YAAY,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,6BAA6B,CAAC;AAErC,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AAKhD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,wBAA6B,GACtC,YAAY,GAAG,IAAI,CAKrB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,wBAA6B,GACtC;IACD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAC/B,CAQA;AAED,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,wBAA6B,GACtC,YAAY,GAAG,IAAI,CAmBrB"}

package/dist/run-facts-projection.js

@@ -0,0 +1,86 @@
+import { lstatSync } from "node:fs";
+import { join } from "node:path";
+import { RunFactsInvalidError, validateRunFactsReceipt, } from "@claudexor/schema";
+import { projectApplyEligibility, projectOutcomeBanner, } from "./run-detail-projections.js";
+/** Exact validated terminal receipt from an already-fetched run detail. */
+export function projectRunFacts(detail, expected = {}) {
+    if (!detail)
+        return null;
+    const value = detail["runFacts"];
+    if (value === null || value === undefined)
+        return null;
+    return validateRunFactsReceipt(value, expectedIdentityFromDetail(detail, expected));
+}
+/**
+ * Shared fields appended to both terminal machine surfaces. RunFacts is
+ * intentionally always present; only a genuinely missing legacy receipt
+ * projects to null, while present malformed data fails loudly.
+ */
+export function projectTerminalDetailFields(detail, expected = {}) {
+    const outcomeBanner = projectOutcomeBanner(detail);
+    const applyEligibility = projectApplyEligibility(detail);
+    return {
+        ...(outcomeBanner ? { outcomeBanner } : {}),
+        ...(applyEligibility ? { applyEligibility } : {}),
+        runFacts: projectRunFacts(detail, expected),
+    };
+}
+/** Read the canonical immutable RunFacts artifact without reconstructing it. */
+export function readRunFactsArtifact(reader, finalDir, expected = {}) {
+    const path = join(finalDir, "run_facts.yaml");
+    const finalDirStat = lstatOrNull(finalDir);
+    if (finalDirStat === null)
+        return null;
+    if (!finalDirStat.isDirectory() || finalDirStat.isSymbolicLink()) {
+        throw new RunFactsInvalidError();
+    }
+    const artifactStat = lstatOrNull(path);
+    if (artifactStat === null)
+        return null;
+    if (!artifactStat.isFile() || artifactStat.isSymbolicLink())
+        throw new RunFactsInvalidError();
+    let raw;
+    try {
+        raw = reader.readYaml(path);
+    }
+    catch {
+        throw new RunFactsInvalidError();
+    }
+    return validateRunFactsReceipt(raw, expected);
+}
+function expectedIdentityFromDetail(detail, expected) {
+    const summary = detail["summary"];
+    if (!summary || typeof summary !== "object")
+        return expected;
+    const record = summary;
+    const summaryRunId = typeof record["runId"] === "string" ? record["runId"] : undefined;
+    const summaryTaskId = typeof record["taskId"] === "string" ? record["taskId"] : undefined;
+    if ((expected.runId !== undefined &&
+        summaryRunId !== undefined &&
+        expected.runId !== summaryRunId) ||
+        (expected.taskId !== undefined &&
+            summaryTaskId !== undefined &&
+            expected.taskId !== summaryTaskId)) {
+        throw new RunFactsInvalidError();
+    }
+    return {
+        runId: expected.runId ?? summaryRunId,
+        taskId: expected.taskId ?? summaryTaskId,
+        ...(expected.lifecycle !== undefined ? { lifecycle: expected.lifecycle } : {}),
+    };
+}
+function lstatOrNull(path) {
+    try {
+        return lstatSync(path);
+    }
+    catch (error) {
+        if (error &&
+            typeof error === "object" &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return null;
+        }
+        throw new RunFactsInvalidError();
+    }
+}
+//# sourceMappingURL=run-facts-projection.js.map

package/dist/run-facts-projection.js.map

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

package/dist/runtime-replacement-stop.d.ts

@@ -0,0 +1,25 @@
+import { type AwaitDaemonTerminationOptions, type DaemonTerminationOutcome, type DaemonLeaseOwner, DaemonClient, awaitDaemonTermination } from "@claudexor/daemon";
+interface RuntimeReplacementStopDeps {
+    socketPath(): string;
+    readToken(): string | null;
+    socketAlive(path: string): Promise<boolean>;
+    leaseOwner(path: string): DaemonLeaseOwner | null;
+    client(path: string, token: string): Pick<DaemonClient, "shutdownForRuntimeReplacement">;
+    awaitTermination(path: string, options: AwaitDaemonTerminationOptions): ReturnType<typeof awaitDaemonTermination>;
+    write(line: string): void;
+}
+/** One owner for the admission/termination uncertainty boundary used by both
+ * local and remote runtime replacement. Only a proven
+ * `{ok:true,fenced:true,targetBound:true}` receipt grants
+ * signal authority for the pre-RPC writer-lease owner.
+ * A lost, legacy, or untyped response may passively prove that the pinned
+ * daemon exited, but can never turn into a kill. */
+export declare function admitAndAwaitRuntimeReplacementStop(requestAdmission: () => Promise<unknown>, awaitTermination: (options: AwaitDaemonTerminationOptions) => Promise<DaemonTerminationOutcome>, expectedOwner: DaemonLeaseOwner): Promise<DaemonTerminationOutcome>;
+/** Handle `claudexord --stop`: the identity-proven, admission-safe shutdown the
+ * macOS installer runs before an atomic pointer swap. Unlike explicit operator
+ * shutdown, this asks the daemon to atomically prove idle and fence every ingress
+ * before stopping. The pinned termination proof remains authoritative when the
+ * accepted RPC response is lost as the socket closes. */
+export declare function runStopIfRequested(argv: readonly string[], deps?: RuntimeReplacementStopDeps): Promise<boolean>;
+export {};
+//# sourceMappingURL=runtime-replacement-stop.d.ts.map

package/dist/runtime-replacement-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-replacement-stop.d.ts","sourceRoot":"","sources":["../src/runtime-replacement-stop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,YAAY,EAGZ,sBAAsB,EAIvB,MAAM,mBAAmB,CAAC;AAE3B,UAAU,0BAA0B;IAClC,UAAU,IAAI,MAAM,CAAC;IACrB,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,+BAA+B,CAAC,CAAC;IACzF,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,6BAA6B,GACrC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAoED;;;;;oDAKoD;AACpD,wBAAsB,mCAAmC,CACvD,gBAAgB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EACxC,gBAAgB,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,wBAAwB,CAAC,EAC/F,aAAa,EAAE,gBAAgB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAgCnC;AAED;;;;yDAIyD;AACzD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,GAAE,0BAA2C,GAChD,OAAO,CAAC,OAAO,CAAC,CAwElB"}