@claudexor/schema 5.1.0 → 6.0.0

package/dist/harness-maintenance.d.ts

@@ -1,5 +1,4 @@
 import { z } from "zod/v3";
-/** One exact vendor registry version (no range, tag or `v` prefix). */
 export declare const HarnessVendorVersion: z.ZodString;
 export declare const HarnessMaintenanceTarget: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     kind: z.ZodLiteral<"latest">;
@@ -16,77 +15,337 @@ export declare const HarnessMaintenanceTarget: z.ZodDiscriminatedUnion<"kind", [
 }, {
     kind: "version";
     version: string;
+}>]>;
+export type HarnessMaintenanceTarget = z.infer<typeof HarnessMaintenanceTarget>;
+export declare const HarnessNewestObservation: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+    status: z.ZodLiteral<"not_read">;
+    source: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    status: "not_read";
+    source: string | null;
+}, {
+    status: "not_read";
+    source: string | null;
 }>, z.ZodObject<{
-    kind: z.ZodLiteral<"previous">;
+    status: z.ZodLiteral<"available">;
+    source: z.ZodString;
+    version: z.ZodString;
+    observedAt: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    kind: "previous";
+    status: "available";
+    source: string;
+    version: string;
+    observedAt: string;
 }, {
-    kind: "previous";
+    status: "available";
+    source: string;
+    version: string;
+    observedAt: string;
 }>, z.ZodObject<{
-    kind: z.ZodLiteral<"baseline">;
+    status: z.ZodLiteral<"unavailable">;
+    source: z.ZodNullable<z.ZodString>;
+    observedAt: z.ZodString;
+    problem: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    }, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    }>;
 }, "strict", z.ZodTypeAny, {
-    kind: "baseline";
+    status: "unavailable";
+    source: string | null;
+    observedAt: string;
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    };
 }, {
-    kind: "baseline";
+    status: "unavailable";
+    source: string | null;
+    observedAt: string;
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    };
 }>]>;
-export type HarnessMaintenanceTarget = z.infer<typeof HarnessMaintenanceTarget>;
-export declare const HarnessMaintenanceEntry: z.ZodObject<{
-    harness: z.ZodString;
-    mechanism: z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>;
-    maintainable: z.ZodBoolean;
-    canCheckLatest: z.ZodBoolean;
-    targets: z.ZodArray<z.ZodEnum<["latest", "version", "previous", "baseline"]>, "many">;
-    remedy: z.ZodNullable<z.ZodString>;
-    selection: z.ZodObject<{
-        kind: z.ZodEnum<["managed", "override", "path", "missing"]>;
-        binary: z.ZodNullable<z.ZodString>;
-        version: z.ZodNullable<z.ZodString>;
-        overrideEnv: z.ZodNullable<z.ZodString>;
+export type HarnessNewestObservation = z.infer<typeof HarnessNewestObservation>;
+export declare const HarnessMaintenanceCommand: z.ZodObject<{
+    binary: z.ZodString;
+    args: z.ZodArray<z.ZodString, "many">;
+    env: z.ZodRecord<z.ZodString, z.ZodString>;
+    script: z.ZodNullable<z.ZodObject<{
+        url: z.ZodString;
+        size: z.ZodNumber;
+        sha256: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        kind: "managed" | "missing" | "override" | "path";
-        binary: string | null;
-        version: string | null;
-        overrideEnv: string | null;
+        url: string;
+        size: number;
+        sha256: string;
     }, {
-        kind: "managed" | "missing" | "override" | "path";
-        binary: string | null;
-        version: string | null;
-        overrideEnv: string | null;
+        url: string;
+        size: number;
+        sha256: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    binary: string;
+    args: string[];
+    env: Record<string, string>;
+    script: {
+        url: string;
+        size: number;
+        sha256: string;
+    } | null;
+}, {
+    binary: string;
+    args: string[];
+    env: Record<string, string>;
+    script: {
+        url: string;
+        size: number;
+        sha256: string;
+    } | null;
+}>;
+export type HarnessMaintenanceCommand = z.infer<typeof HarnessMaintenanceCommand>;
+/** Kept in the existing command record, including partial effects on cancellation. */
+export declare const HarnessMaintenanceEvidence: z.ZodObject<{
+    phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"latest">;
+        version: z.ZodNull;
+    }, "strict", z.ZodTypeAny, {
+        kind: "latest";
+        version: null;
+    }, {
+        kind: "latest";
+        version: null;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"version">;
+        version: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "version";
+        version: string;
+    }, {
+        kind: "version";
+        version: string;
+    }>]>;
+    requester: z.ZodObject<{
+        source: z.ZodString;
+        requestId: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        requestId: string | null;
+    }, {
+        source: string;
+        requestId: string | null;
     }>;
-    installed: z.ZodObject<{
+    installationHome: z.ZodNullable<z.ZodString>;
+    commands: z.ZodArray<z.ZodObject<{
+        binary: z.ZodString;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodRecord<z.ZodString, z.ZodString>;
+        script: z.ZodNullable<z.ZodObject<{
+            url: z.ZodString;
+            size: z.ZodNumber;
+            sha256: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            url: string;
+            size: number;
+            sha256: string;
+        }, {
+            url: string;
+            size: number;
+            sha256: string;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }, {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }>, "many">;
+    profileCleanup: z.ZodOptional<z.ZodObject<{
+        plannedPaths: z.ZodArray<z.ZodString, "many">;
+        removedPaths: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        plannedPaths: string[];
+        removedPaths: string[];
+    }, {
+        plannedPaths: string[];
+        removedPaths: string[];
+    }>>;
+    before: z.ZodNullable<z.ZodObject<{
+        path: z.ZodNullable<z.ZodString>;
+        realPath: z.ZodNullable<z.ZodString>;
         version: z.ZodNullable<z.ZodString>;
-        binary: z.ZodNullable<z.ZodString>;
-        proved: z.ZodBoolean;
+        versionOutput: z.ZodNullable<z.ZodString>;
+        overrideEnv: z.ZodNullable<z.ZodString>;
+        overrideValue: z.ZodNullable<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        path: string | null;
+        realPath: string | null;
         version: string | null;
-        binary: string | null;
-        proved: boolean;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
     }, {
+        path: string | null;
+        realPath: string | null;
         version: string | null;
-        binary: string | null;
-        proved: boolean;
-    }>;
-    releaseTested: z.ZodObject<{
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }>>;
+    after: z.ZodNullable<z.ZodObject<{
+        path: z.ZodNullable<z.ZodString>;
+        realPath: z.ZodNullable<z.ZodString>;
         version: z.ZodNullable<z.ZodString>;
-        verification: z.ZodNullable<z.ZodEnum<["release_verified", "deterministic_only"]>>;
+        versionOutput: z.ZodNullable<z.ZodString>;
+        overrideEnv: z.ZodNullable<z.ZodString>;
+        overrideValue: z.ZodNullable<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        path: string | null;
+        realPath: string | null;
         version: string | null;
-        verification: "deterministic_only" | "release_verified" | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
     }, {
+        path: string | null;
+        realPath: string | null;
         version: string | null;
-        verification: "deterministic_only" | "release_verified" | null;
-    }>;
-    available: z.ZodNullable<z.ZodObject<{
-        version: z.ZodString;
-        observedAt: z.ZodString;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }>>;
+    elsewhere: z.ZodNullable<z.ZodObject<{
+        before: z.ZodObject<{
+            path: z.ZodNullable<z.ZodString>;
+            realPath: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+            versionOutput: z.ZodNullable<z.ZodString>;
+            overrideEnv: z.ZodNullable<z.ZodString>;
+            overrideValue: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }>;
+        after: z.ZodObject<{
+            path: z.ZodNullable<z.ZodString>;
+            realPath: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+            versionOutput: z.ZodNullable<z.ZodString>;
+            overrideEnv: z.ZodNullable<z.ZodString>;
+            overrideValue: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }>;
     }, "strict", z.ZodTypeAny, {
-        version: string;
-        observedAt: string;
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
     }, {
-        version: string;
-        observedAt: string;
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
     }>>;
-    availableProblem: z.ZodNullable<z.ZodObject<{
+    activeRunsAtStart: z.ZodNullable<z.ZodNumber>;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    outcome: z.ZodEnum<["changed", "not_changed", "changed_elsewhere", "unknown"]>;
+    mutation: z.ZodEnum<["none", "applied", "unknown"]>;
+    termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
+    limitations: z.ZodArray<z.ZodString, "many">;
+    progress: z.ZodArray<z.ZodString, "many">;
+    problem: z.ZodNullable<z.ZodObject<{
         code: z.ZodString;
         message: z.ZodString;
         retryable: z.ZodBoolean;
@@ -111,63 +370,76 @@ export declare const HarnessMaintenanceEntry: z.ZodObject<{
         evidenceRefs?: string[] | undefined;
         context?: Record<string, unknown> | undefined;
     }>>;
-    previous: z.ZodNullable<z.ZodObject<{
-        version: z.ZodString;
-        operationId: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        version: string;
-        operationId: string;
-    }, {
-        version: string;
-        operationId: string;
-    }>>;
-    operation: z.ZodNullable<z.ZodObject<{
-        id: z.ZodString;
-        state: z.ZodString;
-        phase: z.ZodString;
-        targetVersion: z.ZodNullable<z.ZodString>;
-        finishedAt: z.ZodNullable<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        id: string;
-        state: string;
-        phase: string;
-        targetVersion: string | null;
-        finishedAt: string | null;
-    }, {
-        id: string;
-        state: string;
-        phase: string;
-        targetVersion: string | null;
-        finishedAt: string | null;
-    }>>;
-    observedAt: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    harness: string;
-    mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
-    maintainable: boolean;
-    canCheckLatest: boolean;
-    targets: ("baseline" | "latest" | "previous" | "version")[];
-    remedy: string | null;
-    selection: {
-        kind: "managed" | "missing" | "override" | "path";
-        binary: string | null;
-        version: string | null;
-        overrideEnv: string | null;
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    target: {
+        kind: "latest";
+        version: null;
+    } | {
+        kind: "version";
+        version: string;
     };
-    installed: {
-        version: string | null;
-        binary: string | null;
-        proved: boolean;
+    requester: {
+        source: string;
+        requestId: string | null;
     };
-    releaseTested: {
+    installationHome: string | null;
+    commands: {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }[];
+    profileCleanup?: {
+        plannedPaths: string[];
+        removedPaths: string[];
+    } | undefined;
+    before: {
+        path: string | null;
+        realPath: string | null;
         version: string | null;
-        verification: "deterministic_only" | "release_verified" | null;
-    };
-    available: {
-        version: string;
-        observedAt: string;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    after: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    elsewhere: {
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
     } | null;
-    availableProblem: {
+    activeRunsAtStart: number | null;
+    exitCode: number | null;
+    outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
         code: string;
         message: string;
         retryable: boolean;
@@ -176,45 +448,76 @@ export declare const HarnessMaintenanceEntry: z.ZodObject<{
         evidenceRefs: string[];
         context: Record<string, unknown>;
     } | null;
-    previous: {
-        version: string;
-        operationId: string;
-    } | null;
-    operation: {
-        id: string;
-        state: string;
-        phase: string;
-        targetVersion: string | null;
-        finishedAt: string | null;
-    } | null;
-    observedAt: string;
 }, {
-    harness: string;
-    mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
-    maintainable: boolean;
-    canCheckLatest: boolean;
-    targets: ("baseline" | "latest" | "previous" | "version")[];
-    remedy: string | null;
-    selection: {
-        kind: "managed" | "missing" | "override" | "path";
-        binary: string | null;
-        version: string | null;
-        overrideEnv: string | null;
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    target: {
+        kind: "latest";
+        version: null;
+    } | {
+        kind: "version";
+        version: string;
     };
-    installed: {
-        version: string | null;
-        binary: string | null;
-        proved: boolean;
+    requester: {
+        source: string;
+        requestId: string | null;
     };
-    releaseTested: {
+    installationHome: string | null;
+    commands: {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }[];
+    profileCleanup?: {
+        plannedPaths: string[];
+        removedPaths: string[];
+    } | undefined;
+    before: {
+        path: string | null;
+        realPath: string | null;
         version: string | null;
-        verification: "deterministic_only" | "release_verified" | null;
-    };
-    available: {
-        version: string;
-        observedAt: string;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    after: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    elsewhere: {
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
     } | null;
-    availableProblem: {
+    activeRunsAtStart: number | null;
+    exitCode: number | null;
+    outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
         code: string;
         message: string;
         retryable: boolean;
@@ -223,79 +526,472 @@ export declare const HarnessMaintenanceEntry: z.ZodObject<{
         evidenceRefs?: string[] | undefined;
         context?: Record<string, unknown> | undefined;
     } | null;
-    previous: {
-        version: string;
-        operationId: string;
-    } | null;
-    operation: {
-        id: string;
-        state: string;
-        phase: string;
-        targetVersion: string | null;
-        finishedAt: string | null;
-    } | null;
-    observedAt: string;
 }>;
-export type HarnessMaintenanceEntry = z.infer<typeof HarnessMaintenanceEntry>;
-export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
-    observedAt: z.ZodString;
-    harnesses: z.ZodArray<z.ZodObject<{
-        harness: z.ZodString;
-        mechanism: z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>;
-        maintainable: z.ZodBoolean;
-        canCheckLatest: z.ZodBoolean;
-        targets: z.ZodArray<z.ZodEnum<["latest", "version", "previous", "baseline"]>, "many">;
-        remedy: z.ZodNullable<z.ZodString>;
-        selection: z.ZodObject<{
-            kind: z.ZodEnum<["managed", "override", "path", "missing"]>;
-            binary: z.ZodNullable<z.ZodString>;
+export type HarnessMaintenanceEvidence = z.infer<typeof HarnessMaintenanceEvidence>;
+export declare const ControlHarnessMaintenanceOperation: z.ZodObject<{
+    phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"latest">;
+        version: z.ZodNull;
+    }, "strict", z.ZodTypeAny, {
+        kind: "latest";
+        version: null;
+    }, {
+        kind: "latest";
+        version: null;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"version">;
+        version: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "version";
+        version: string;
+    }, {
+        kind: "version";
+        version: string;
+    }>]>;
+    requester: z.ZodObject<{
+        source: z.ZodString;
+        requestId: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        source: string;
+        requestId: string | null;
+    }, {
+        source: string;
+        requestId: string | null;
+    }>;
+    installationHome: z.ZodNullable<z.ZodString>;
+    commands: z.ZodArray<z.ZodObject<{
+        binary: z.ZodString;
+        args: z.ZodArray<z.ZodString, "many">;
+        env: z.ZodRecord<z.ZodString, z.ZodString>;
+        script: z.ZodNullable<z.ZodObject<{
+            url: z.ZodString;
+            size: z.ZodNumber;
+            sha256: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            url: string;
+            size: number;
+            sha256: string;
+        }, {
+            url: string;
+            size: number;
+            sha256: string;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }, {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }>, "many">;
+    profileCleanup: z.ZodOptional<z.ZodObject<{
+        plannedPaths: z.ZodArray<z.ZodString, "many">;
+        removedPaths: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        plannedPaths: string[];
+        removedPaths: string[];
+    }, {
+        plannedPaths: string[];
+        removedPaths: string[];
+    }>>;
+    before: z.ZodNullable<z.ZodObject<{
+        path: z.ZodNullable<z.ZodString>;
+        realPath: z.ZodNullable<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+        versionOutput: z.ZodNullable<z.ZodString>;
+        overrideEnv: z.ZodNullable<z.ZodString>;
+        overrideValue: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }, {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }>>;
+    after: z.ZodNullable<z.ZodObject<{
+        path: z.ZodNullable<z.ZodString>;
+        realPath: z.ZodNullable<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+        versionOutput: z.ZodNullable<z.ZodString>;
+        overrideEnv: z.ZodNullable<z.ZodString>;
+        overrideValue: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }, {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }>>;
+    elsewhere: z.ZodNullable<z.ZodObject<{
+        before: z.ZodObject<{
+            path: z.ZodNullable<z.ZodString>;
+            realPath: z.ZodNullable<z.ZodString>;
             version: z.ZodNullable<z.ZodString>;
+            versionOutput: z.ZodNullable<z.ZodString>;
             overrideEnv: z.ZodNullable<z.ZodString>;
+            overrideValue: z.ZodNullable<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
-            kind: "managed" | "missing" | "override" | "path";
-            binary: string | null;
+            path: string | null;
+            realPath: string | null;
             version: string | null;
+            versionOutput: string | null;
             overrideEnv: string | null;
+            overrideValue: string | null;
         }, {
-            kind: "managed" | "missing" | "override" | "path";
-            binary: string | null;
+            path: string | null;
+            realPath: string | null;
             version: string | null;
+            versionOutput: string | null;
             overrideEnv: string | null;
+            overrideValue: string | null;
         }>;
-        installed: z.ZodObject<{
+        after: z.ZodObject<{
+            path: z.ZodNullable<z.ZodString>;
+            realPath: z.ZodNullable<z.ZodString>;
             version: z.ZodNullable<z.ZodString>;
-            binary: z.ZodNullable<z.ZodString>;
-            proved: z.ZodBoolean;
+            versionOutput: z.ZodNullable<z.ZodString>;
+            overrideEnv: z.ZodNullable<z.ZodString>;
+            overrideValue: z.ZodNullable<z.ZodString>;
         }, "strict", z.ZodTypeAny, {
+            path: string | null;
+            realPath: string | null;
             version: string | null;
-            binary: string | null;
-            proved: boolean;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
         }, {
+            path: string | null;
+            realPath: string | null;
             version: string | null;
-            binary: string | null;
-            proved: boolean;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
         }>;
-        releaseTested: z.ZodObject<{
-            version: z.ZodNullable<z.ZodString>;
-            verification: z.ZodNullable<z.ZodEnum<["release_verified", "deterministic_only"]>>;
-        }, "strict", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
+        before: {
+            path: string | null;
+            realPath: string | null;
             version: string | null;
-            verification: "deterministic_only" | "release_verified" | null;
-        }, {
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
             version: string | null;
-            verification: "deterministic_only" | "release_verified" | null;
-        }>;
-        available: z.ZodNullable<z.ZodObject<{
-            version: z.ZodString;
-            observedAt: z.ZodString;
-        }, "strict", z.ZodTypeAny, {
-            version: string;
-            observedAt: string;
-        }, {
-            version: string;
-            observedAt: string;
-        }>>;
-        availableProblem: z.ZodNullable<z.ZodObject<{
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+    }, {
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+    }>>;
+    activeRunsAtStart: z.ZodNullable<z.ZodNumber>;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    outcome: z.ZodEnum<["changed", "not_changed", "changed_elsewhere", "unknown"]>;
+    mutation: z.ZodEnum<["none", "applied", "unknown"]>;
+    termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
+    limitations: z.ZodArray<z.ZodString, "many">;
+    progress: z.ZodArray<z.ZodString, "many">;
+    problem: z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+        requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    }, {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    }>>;
+} & {
+    id: z.ZodString;
+    harness: z.ZodString;
+    state: z.ZodEnum<["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]>;
+    createdAt: z.ZodString;
+    startedAt: z.ZodNullable<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    target: {
+        kind: "latest";
+        version: null;
+    } | {
+        kind: "version";
+        version: string;
+    };
+    requester: {
+        source: string;
+        requestId: string | null;
+    };
+    installationHome: string | null;
+    commands: {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }[];
+    profileCleanup?: {
+        plannedPaths: string[];
+        removedPaths: string[];
+    } | undefined;
+    before: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    after: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    elsewhere: {
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+    } | null;
+    activeRunsAtStart: number | null;
+    exitCode: number | null;
+    outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors: Record<string, string[]>;
+        requiredActions: string[];
+        evidenceRefs: string[];
+        context: Record<string, unknown>;
+    } | null;
+    id: string;
+    harness: string;
+    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+    createdAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+}, {
+    phase: "accepted" | "installing" | "preparing" | "settled";
+    target: {
+        kind: "latest";
+        version: null;
+    } | {
+        kind: "version";
+        version: string;
+    };
+    requester: {
+        source: string;
+        requestId: string | null;
+    };
+    installationHome: string | null;
+    commands: {
+        binary: string;
+        args: string[];
+        env: Record<string, string>;
+        script: {
+            url: string;
+            size: number;
+            sha256: string;
+        } | null;
+    }[];
+    profileCleanup?: {
+        plannedPaths: string[];
+        removedPaths: string[];
+    } | undefined;
+    before: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    after: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    } | null;
+    elsewhere: {
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+    } | null;
+    activeRunsAtStart: number | null;
+    exitCode: number | null;
+    outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+    mutation: "applied" | "none" | "unknown";
+    termination: "confirmed" | "not_applicable" | "unconfirmed";
+    limitations: string[];
+    progress: string[];
+    problem: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        fieldErrors?: Record<string, string[]> | undefined;
+        requiredActions?: string[] | undefined;
+        evidenceRefs?: string[] | undefined;
+        context?: Record<string, unknown> | undefined;
+    } | null;
+    id: string;
+    harness: string;
+    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+    createdAt: string;
+    startedAt: string | null;
+    finishedAt: string | null;
+}>;
+export type ControlHarnessMaintenanceOperation = z.infer<typeof ControlHarnessMaintenanceOperation>;
+export declare const HarnessMaintenanceEntry: z.ZodObject<{
+    harness: z.ZodString;
+    selection: z.ZodObject<{
+        path: z.ZodNullable<z.ZodString>;
+        realPath: z.ZodNullable<z.ZodString>;
+        version: z.ZodNullable<z.ZodString>;
+        versionOutput: z.ZodNullable<z.ZodString>;
+        overrideEnv: z.ZodNullable<z.ZodString>;
+        overrideValue: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }, {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    }>;
+    newest: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+        status: z.ZodLiteral<"not_read">;
+        source: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        status: "not_read";
+        source: string | null;
+    }, {
+        status: "not_read";
+        source: string | null;
+    }>, z.ZodObject<{
+        status: z.ZodLiteral<"available">;
+        source: z.ZodString;
+        version: z.ZodString;
+        observedAt: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        status: "available";
+        source: string;
+        version: string;
+        observedAt: string;
+    }, {
+        status: "available";
+        source: string;
+        version: string;
+        observedAt: string;
+    }>, z.ZodObject<{
+        status: z.ZodLiteral<"unavailable">;
+        source: z.ZodNullable<z.ZodString>;
+        observedAt: z.ZodString;
+        problem: z.ZodObject<{
             code: z.ZodString;
             message: z.ZodString;
             retryable: z.ZodBoolean;
@@ -319,64 +1015,12 @@ export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
             requiredActions?: string[] | undefined;
             evidenceRefs?: string[] | undefined;
             context?: Record<string, unknown> | undefined;
-        }>>;
-        previous: z.ZodNullable<z.ZodObject<{
-            version: z.ZodString;
-            operationId: z.ZodString;
-        }, "strict", z.ZodTypeAny, {
-            version: string;
-            operationId: string;
-        }, {
-            version: string;
-            operationId: string;
-        }>>;
-        operation: z.ZodNullable<z.ZodObject<{
-            id: z.ZodString;
-            state: z.ZodString;
-            phase: z.ZodString;
-            targetVersion: z.ZodNullable<z.ZodString>;
-            finishedAt: z.ZodNullable<z.ZodString>;
-        }, "strict", z.ZodTypeAny, {
-            id: string;
-            state: string;
-            phase: string;
-            targetVersion: string | null;
-            finishedAt: string | null;
-        }, {
-            id: string;
-            state: string;
-            phase: string;
-            targetVersion: string | null;
-            finishedAt: string | null;
-        }>>;
-        observedAt: z.ZodString;
+        }>;
     }, "strict", z.ZodTypeAny, {
-        harness: string;
-        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
-        maintainable: boolean;
-        canCheckLatest: boolean;
-        targets: ("baseline" | "latest" | "previous" | "version")[];
-        remedy: string | null;
-        selection: {
-            kind: "managed" | "missing" | "override" | "path";
-            binary: string | null;
-            version: string | null;
-            overrideEnv: string | null;
-        };
-        installed: {
-            version: string | null;
-            binary: string | null;
-            proved: boolean;
-        };
-        releaseTested: {
-            version: string | null;
-            verification: "deterministic_only" | "release_verified" | null;
-        };
-        available: {
-            version: string;
-            observedAt: string;
-        } | null;
-        availableProblem: {
+        status: "unavailable";
+        source: string | null;
+        observedAt: string;
+        problem: {
             code: string;
             message: string;
             retryable: boolean;
@@ -384,46 +1028,577 @@ export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
             requiredActions: string[];
             evidenceRefs: string[];
             context: Record<string, unknown>;
-        } | null;
-        previous: {
-            version: string;
-            operationId: string;
-        } | null;
-        operation: {
-            id: string;
-            state: string;
-            phase: string;
-            targetVersion: string | null;
-            finishedAt: string | null;
-        } | null;
+        };
+    }, {
+        status: "unavailable";
+        source: string | null;
         observedAt: string;
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors?: Record<string, string[]> | undefined;
+            requiredActions?: string[] | undefined;
+            evidenceRefs?: string[] | undefined;
+            context?: Record<string, unknown> | undefined;
+        };
+    }>]>;
+    updateAvailable: z.ZodEnum<["yes", "no", "cannot_tell"]>;
+    releaseNotesUrl: z.ZodNullable<z.ZodString>;
+    actions: z.ZodObject<{
+        install: z.ZodObject<{
+            available: z.ZodBoolean;
+            reason: z.ZodNullable<z.ZodString>;
+            /** Display only. {version} is user input; {installedProgram} is resolved after installation. */
+            commands: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        }, {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        }>;
+        update: z.ZodObject<{
+            available: z.ZodBoolean;
+            reason: z.ZodNullable<z.ZodString>;
+            /** Display only. {version} is user input; {installedProgram} is resolved after installation. */
+            commands: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        }, {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        }>;
+        exactVersion: z.ZodObject<{
+            available: z.ZodBoolean;
+            reason: z.ZodNullable<z.ZodString>;
+            /** Display only. {version} is user input; {installedProgram} is resolved after installation. */
+            commands: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"exec">;
+                command: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"script">;
+                url: z.ZodString;
+                interpreter: z.ZodString;
+                interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            }, "strict", z.ZodTypeAny, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }, {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            }>]>, "many">;
+        }, "strict", z.ZodTypeAny, {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        }, {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        install: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
+        update: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
+        exactVersion: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
     }, {
-        harness: string;
-        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
-        maintainable: boolean;
-        canCheckLatest: boolean;
-        targets: ("baseline" | "latest" | "previous" | "version")[];
-        remedy: string | null;
-        selection: {
-            kind: "managed" | "missing" | "override" | "path";
-            binary: string | null;
-            version: string | null;
-            overrideEnv: string | null;
+        install: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
         };
-        installed: {
-            version: string | null;
-            binary: string | null;
-            proved: boolean;
+        update: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
         };
-        releaseTested: {
-            version: string | null;
-            verification: "deterministic_only" | "release_verified" | null;
+        exactVersion: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
         };
-        available: {
+    }>;
+    operation: z.ZodNullable<z.ZodObject<{
+        phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
+        target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"latest">;
+            version: z.ZodNull;
+        }, "strict", z.ZodTypeAny, {
+            kind: "latest";
+            version: null;
+        }, {
+            kind: "latest";
+            version: null;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"version">;
+            version: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "version";
             version: string;
-            observedAt: string;
-        } | null;
-        availableProblem: {
+        }, {
+            kind: "version";
+            version: string;
+        }>]>;
+        requester: z.ZodObject<{
+            source: z.ZodString;
+            requestId: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            source: string;
+            requestId: string | null;
+        }, {
+            source: string;
+            requestId: string | null;
+        }>;
+        installationHome: z.ZodNullable<z.ZodString>;
+        commands: z.ZodArray<z.ZodObject<{
+            binary: z.ZodString;
+            args: z.ZodArray<z.ZodString, "many">;
+            env: z.ZodRecord<z.ZodString, z.ZodString>;
+            script: z.ZodNullable<z.ZodObject<{
+                url: z.ZodString;
+                size: z.ZodNumber;
+                sha256: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                url: string;
+                size: number;
+                sha256: string;
+            }, {
+                url: string;
+                size: number;
+                sha256: string;
+            }>>;
+        }, "strict", z.ZodTypeAny, {
+            binary: string;
+            args: string[];
+            env: Record<string, string>;
+            script: {
+                url: string;
+                size: number;
+                sha256: string;
+            } | null;
+        }, {
+            binary: string;
+            args: string[];
+            env: Record<string, string>;
+            script: {
+                url: string;
+                size: number;
+                sha256: string;
+            } | null;
+        }>, "many">;
+        profileCleanup: z.ZodOptional<z.ZodObject<{
+            plannedPaths: z.ZodArray<z.ZodString, "many">;
+            removedPaths: z.ZodArray<z.ZodString, "many">;
+        }, "strict", z.ZodTypeAny, {
+            plannedPaths: string[];
+            removedPaths: string[];
+        }, {
+            plannedPaths: string[];
+            removedPaths: string[];
+        }>>;
+        before: z.ZodNullable<z.ZodObject<{
+            path: z.ZodNullable<z.ZodString>;
+            realPath: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+            versionOutput: z.ZodNullable<z.ZodString>;
+            overrideEnv: z.ZodNullable<z.ZodString>;
+            overrideValue: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }>>;
+        after: z.ZodNullable<z.ZodObject<{
+            path: z.ZodNullable<z.ZodString>;
+            realPath: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+            versionOutput: z.ZodNullable<z.ZodString>;
+            overrideEnv: z.ZodNullable<z.ZodString>;
+            overrideValue: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }>>;
+        elsewhere: z.ZodNullable<z.ZodObject<{
+            before: z.ZodObject<{
+                path: z.ZodNullable<z.ZodString>;
+                realPath: z.ZodNullable<z.ZodString>;
+                version: z.ZodNullable<z.ZodString>;
+                versionOutput: z.ZodNullable<z.ZodString>;
+                overrideEnv: z.ZodNullable<z.ZodString>;
+                overrideValue: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }>;
+            after: z.ZodObject<{
+                path: z.ZodNullable<z.ZodString>;
+                realPath: z.ZodNullable<z.ZodString>;
+                version: z.ZodNullable<z.ZodString>;
+                versionOutput: z.ZodNullable<z.ZodString>;
+                overrideEnv: z.ZodNullable<z.ZodString>;
+                overrideValue: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+        }, {
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+        }>>;
+        activeRunsAtStart: z.ZodNullable<z.ZodNumber>;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        outcome: z.ZodEnum<["changed", "not_changed", "changed_elsewhere", "unknown"]>;
+        mutation: z.ZodEnum<["none", "applied", "unknown"]>;
+        termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
+        limitations: z.ZodArray<z.ZodString, "many">;
+        progress: z.ZodArray<z.ZodString, "many">;
+        problem: z.ZodNullable<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            retryable: z.ZodBoolean;
+            fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+            requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strict", z.ZodTypeAny, {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        }, {
             code: string;
             message: string;
             retryable: boolean;
@@ -431,49 +1606,84 @@ export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
             requiredActions?: string[] | undefined;
             evidenceRefs?: string[] | undefined;
             context?: Record<string, unknown> | undefined;
-        } | null;
-        previous: {
+        }>>;
+    } & {
+        id: z.ZodString;
+        harness: z.ZodString;
+        state: z.ZodEnum<["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]>;
+        createdAt: z.ZodString;
+        startedAt: z.ZodNullable<z.ZodString>;
+        finishedAt: z.ZodNullable<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        phase: "accepted" | "installing" | "preparing" | "settled";
+        target: {
+            kind: "latest";
+            version: null;
+        } | {
+            kind: "version";
             version: string;
-            operationId: string;
-        } | null;
-        operation: {
-            id: string;
-            state: string;
-            phase: string;
-            targetVersion: string | null;
-            finishedAt: string | null;
-        } | null;
-        observedAt: string;
-    }>, "many">;
-}, "strict", z.ZodTypeAny, {
-    observedAt: string;
-    harnesses: {
-        harness: string;
-        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
-        maintainable: boolean;
-        canCheckLatest: boolean;
-        targets: ("baseline" | "latest" | "previous" | "version")[];
-        remedy: string | null;
-        selection: {
-            kind: "managed" | "missing" | "override" | "path";
-            binary: string | null;
-            version: string | null;
-            overrideEnv: string | null;
         };
-        installed: {
-            version: string | null;
-            binary: string | null;
-            proved: boolean;
+        requester: {
+            source: string;
+            requestId: string | null;
         };
-        releaseTested: {
+        installationHome: string | null;
+        commands: {
+            binary: string;
+            args: string[];
+            env: Record<string, string>;
+            script: {
+                url: string;
+                size: number;
+                sha256: string;
+            } | null;
+        }[];
+        profileCleanup?: {
+            plannedPaths: string[];
+            removedPaths: string[];
+        } | undefined;
+        before: {
+            path: string | null;
+            realPath: string | null;
             version: string | null;
-            verification: "deterministic_only" | "release_verified" | null;
-        };
-        available: {
-            version: string;
-            observedAt: string;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        } | null;
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        } | null;
+        elsewhere: {
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
         } | null;
-        availableProblem: {
+        activeRunsAtStart: number | null;
+        exitCode: number | null;
+        outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+        mutation: "applied" | "none" | "unknown";
+        termination: "confirmed" | "not_applicable" | "unconfirmed";
+        limitations: string[];
+        progress: string[];
+        problem: {
             code: string;
             message: string;
             retryable: boolean;
@@ -482,48 +1692,82 @@ export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
             evidenceRefs: string[];
             context: Record<string, unknown>;
         } | null;
-        previous: {
-            version: string;
-            operationId: string;
-        } | null;
-        operation: {
-            id: string;
-            state: string;
-            phase: string;
-            targetVersion: string | null;
-            finishedAt: string | null;
-        } | null;
-        observedAt: string;
-    }[];
-}, {
-    observedAt: string;
-    harnesses: {
+        id: string;
         harness: string;
-        mechanism: "managed_npm" | "vendor_script" | "vendor_updater";
-        maintainable: boolean;
-        canCheckLatest: boolean;
-        targets: ("baseline" | "latest" | "previous" | "version")[];
-        remedy: string | null;
-        selection: {
-            kind: "managed" | "missing" | "override" | "path";
-            binary: string | null;
-            version: string | null;
-            overrideEnv: string | null;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+    }, {
+        phase: "accepted" | "installing" | "preparing" | "settled";
+        target: {
+            kind: "latest";
+            version: null;
+        } | {
+            kind: "version";
+            version: string;
         };
-        installed: {
-            version: string | null;
-            binary: string | null;
-            proved: boolean;
+        requester: {
+            source: string;
+            requestId: string | null;
         };
-        releaseTested: {
+        installationHome: string | null;
+        commands: {
+            binary: string;
+            args: string[];
+            env: Record<string, string>;
+            script: {
+                url: string;
+                size: number;
+                sha256: string;
+            } | null;
+        }[];
+        profileCleanup?: {
+            plannedPaths: string[];
+            removedPaths: string[];
+        } | undefined;
+        before: {
+            path: string | null;
+            realPath: string | null;
             version: string | null;
-            verification: "deterministic_only" | "release_verified" | null;
-        };
-        available: {
-            version: string;
-            observedAt: string;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        } | null;
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
         } | null;
-        availableProblem: {
+        elsewhere: {
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+        } | null;
+        activeRunsAtStart: number | null;
+        exitCode: number | null;
+        outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+        mutation: "applied" | "none" | "unknown";
+        termination: "confirmed" | "not_applicable" | "unconfirmed";
+        limitations: string[];
+        progress: string[];
+        problem: {
             code: string;
             message: string;
             retryable: boolean;
@@ -532,407 +1776,2007 @@ export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
             evidenceRefs?: string[] | undefined;
             context?: Record<string, unknown> | undefined;
         } | null;
-        previous: {
-            version: string;
-            operationId: string;
-        } | null;
-        operation: {
-            id: string;
-            state: string;
-            phase: string;
-            targetVersion: string | null;
-            finishedAt: string | null;
-        } | null;
-        observedAt: string;
-    }[];
-}>;
-export type ControlHarnessMaintenanceInventory = z.infer<typeof ControlHarnessMaintenanceInventory>;
-export declare const ControlHarnessMaintenanceCreateRequest: z.ZodObject<{
-    harness: z.ZodString;
-    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
-        kind: z.ZodLiteral<"latest">;
-    }, "strict", z.ZodTypeAny, {
-        kind: "latest";
-    }, {
-        kind: "latest";
-    }>, z.ZodObject<{
-        kind: z.ZodLiteral<"version">;
-        version: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        kind: "version";
-        version: string;
-    }, {
-        kind: "version";
-        version: string;
-    }>, z.ZodObject<{
-        kind: z.ZodLiteral<"previous">;
-    }, "strict", z.ZodTypeAny, {
-        kind: "previous";
-    }, {
-        kind: "previous";
-    }>, z.ZodObject<{
-        kind: z.ZodLiteral<"baseline">;
-    }, "strict", z.ZodTypeAny, {
-        kind: "baseline";
-    }, {
-        kind: "baseline";
-    }>]>;
+        id: string;
+        harness: string;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+    }>>;
+    observedAt: z.ZodString;
 }, "strict", z.ZodTypeAny, {
     harness: string;
-    target: {
-        kind: "latest";
+    selection: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    };
+    newest: {
+        status: "not_read";
+        source: string | null;
     } | {
-        kind: "version";
+        status: "available";
+        source: string;
         version: string;
+        observedAt: string;
     } | {
-        kind: "previous";
-    } | {
-        kind: "baseline";
+        status: "unavailable";
+        source: string | null;
+        observedAt: string;
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        };
+    };
+    updateAvailable: "cannot_tell" | "no" | "yes";
+    releaseNotesUrl: string | null;
+    actions: {
+        install: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
+        update: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
+        exactVersion: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
     };
+    operation: {
+        phase: "accepted" | "installing" | "preparing" | "settled";
+        target: {
+            kind: "latest";
+            version: null;
+        } | {
+            kind: "version";
+            version: string;
+        };
+        requester: {
+            source: string;
+            requestId: string | null;
+        };
+        installationHome: string | null;
+        commands: {
+            binary: string;
+            args: string[];
+            env: Record<string, string>;
+            script: {
+                url: string;
+                size: number;
+                sha256: string;
+            } | null;
+        }[];
+        profileCleanup?: {
+            plannedPaths: string[];
+            removedPaths: string[];
+        } | undefined;
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        } | null;
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        } | null;
+        elsewhere: {
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+        } | null;
+        activeRunsAtStart: number | null;
+        exitCode: number | null;
+        outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+        mutation: "applied" | "none" | "unknown";
+        termination: "confirmed" | "not_applicable" | "unconfirmed";
+        limitations: string[];
+        progress: string[];
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors: Record<string, string[]>;
+            requiredActions: string[];
+            evidenceRefs: string[];
+            context: Record<string, unknown>;
+        } | null;
+        id: string;
+        harness: string;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+    } | null;
+    observedAt: string;
 }, {
     harness: string;
-    target: {
-        kind: "latest";
+    selection: {
+        path: string | null;
+        realPath: string | null;
+        version: string | null;
+        versionOutput: string | null;
+        overrideEnv: string | null;
+        overrideValue: string | null;
+    };
+    newest: {
+        status: "not_read";
+        source: string | null;
     } | {
-        kind: "version";
+        status: "available";
+        source: string;
         version: string;
+        observedAt: string;
     } | {
-        kind: "previous";
-    } | {
-        kind: "baseline";
+        status: "unavailable";
+        source: string | null;
+        observedAt: string;
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors?: Record<string, string[]> | undefined;
+            requiredActions?: string[] | undefined;
+            evidenceRefs?: string[] | undefined;
+            context?: Record<string, unknown> | undefined;
+        };
+    };
+    updateAvailable: "cannot_tell" | "no" | "yes";
+    releaseNotesUrl: string | null;
+    actions: {
+        install: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
+        update: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
+        exactVersion: {
+            available: boolean;
+            reason: string | null;
+            commands: ({
+                kind: "exec";
+                command: string;
+                args: string[];
+                env?: Record<string, string> | undefined;
+            } | {
+                kind: "script";
+                url: string;
+                interpreter: string;
+                interpreterArgs: string[];
+                args: string[];
+                env?: Record<string, string> | undefined;
+            })[];
+        };
     };
+    operation: {
+        phase: "accepted" | "installing" | "preparing" | "settled";
+        target: {
+            kind: "latest";
+            version: null;
+        } | {
+            kind: "version";
+            version: string;
+        };
+        requester: {
+            source: string;
+            requestId: string | null;
+        };
+        installationHome: string | null;
+        commands: {
+            binary: string;
+            args: string[];
+            env: Record<string, string>;
+            script: {
+                url: string;
+                size: number;
+                sha256: string;
+            } | null;
+        }[];
+        profileCleanup?: {
+            plannedPaths: string[];
+            removedPaths: string[];
+        } | undefined;
+        before: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        } | null;
+        after: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        } | null;
+        elsewhere: {
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            };
+        } | null;
+        activeRunsAtStart: number | null;
+        exitCode: number | null;
+        outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+        mutation: "applied" | "none" | "unknown";
+        termination: "confirmed" | "not_applicable" | "unconfirmed";
+        limitations: string[];
+        progress: string[];
+        problem: {
+            code: string;
+            message: string;
+            retryable: boolean;
+            fieldErrors?: Record<string, string[]> | undefined;
+            requiredActions?: string[] | undefined;
+            evidenceRefs?: string[] | undefined;
+            context?: Record<string, unknown> | undefined;
+        } | null;
+        id: string;
+        harness: string;
+        state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+        createdAt: string;
+        startedAt: string | null;
+        finishedAt: string | null;
+    } | null;
+    observedAt: string;
 }>;
-export type ControlHarnessMaintenanceCreateRequest = z.infer<typeof ControlHarnessMaintenanceCreateRequest>;
-/** Durable command params; `target.version` is bound at acceptance for
- * previous/baseline/version and stays null for latest until execution. */
-export declare const HarnessMaintenanceParams: z.ZodObject<{
-    kind: z.ZodLiteral<"harness_maintenance">;
-    harness: z.ZodString;
-    target: z.ZodObject<{
-        kind: z.ZodEnum<["latest", "version", "previous", "baseline"]>;
-        version: z.ZodNullable<z.ZodString>;
+export type HarnessMaintenanceEntry = z.infer<typeof HarnessMaintenanceEntry>;
+export declare const ControlHarnessMaintenanceInventory: z.ZodObject<{
+    observedAt: z.ZodString;
+    harnesses: z.ZodArray<z.ZodObject<{
+        harness: z.ZodString;
+        selection: z.ZodObject<{
+            path: z.ZodNullable<z.ZodString>;
+            realPath: z.ZodNullable<z.ZodString>;
+            version: z.ZodNullable<z.ZodString>;
+            versionOutput: z.ZodNullable<z.ZodString>;
+            overrideEnv: z.ZodNullable<z.ZodString>;
+            overrideValue: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }, {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        }>;
+        newest: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+            status: z.ZodLiteral<"not_read">;
+            source: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            status: "not_read";
+            source: string | null;
+        }, {
+            status: "not_read";
+            source: string | null;
+        }>, z.ZodObject<{
+            status: z.ZodLiteral<"available">;
+            source: z.ZodString;
+            version: z.ZodString;
+            observedAt: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            status: "available";
+            source: string;
+            version: string;
+            observedAt: string;
+        }, {
+            status: "available";
+            source: string;
+            version: string;
+            observedAt: string;
+        }>, z.ZodObject<{
+            status: z.ZodLiteral<"unavailable">;
+            source: z.ZodNullable<z.ZodString>;
+            observedAt: z.ZodString;
+            problem: z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+                retryable: z.ZodBoolean;
+                fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+                requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strict", z.ZodTypeAny, {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            }, {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            status: "unavailable";
+            source: string | null;
+            observedAt: string;
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            };
+        }, {
+            status: "unavailable";
+            source: string | null;
+            observedAt: string;
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            };
+        }>]>;
+        updateAvailable: z.ZodEnum<["yes", "no", "cannot_tell"]>;
+        releaseNotesUrl: z.ZodNullable<z.ZodString>;
+        actions: z.ZodObject<{
+            install: z.ZodObject<{
+                available: z.ZodBoolean;
+                reason: z.ZodNullable<z.ZodString>;
+                /** Display only. {version} is user input; {installedProgram} is resolved after installation. */
+                commands: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"exec">;
+                    command: z.ZodString;
+                    args: z.ZodArray<z.ZodString, "many">;
+                    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }, {
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"script">;
+                    url: z.ZodString;
+                    interpreter: z.ZodString;
+                    interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                    args: z.ZodArray<z.ZodString, "many">;
+                    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }, {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }>]>, "many">;
+            }, "strict", z.ZodTypeAny, {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            }, {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            }>;
+            update: z.ZodObject<{
+                available: z.ZodBoolean;
+                reason: z.ZodNullable<z.ZodString>;
+                /** Display only. {version} is user input; {installedProgram} is resolved after installation. */
+                commands: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"exec">;
+                    command: z.ZodString;
+                    args: z.ZodArray<z.ZodString, "many">;
+                    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }, {
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"script">;
+                    url: z.ZodString;
+                    interpreter: z.ZodString;
+                    interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                    args: z.ZodArray<z.ZodString, "many">;
+                    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }, {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }>]>, "many">;
+            }, "strict", z.ZodTypeAny, {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            }, {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            }>;
+            exactVersion: z.ZodObject<{
+                available: z.ZodBoolean;
+                reason: z.ZodNullable<z.ZodString>;
+                /** Display only. {version} is user input; {installedProgram} is resolved after installation. */
+                commands: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"exec">;
+                    command: z.ZodString;
+                    args: z.ZodArray<z.ZodString, "many">;
+                    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }, {
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"script">;
+                    url: z.ZodString;
+                    interpreter: z.ZodString;
+                    interpreterArgs: z.ZodArray<z.ZodString, "many">;
+                    args: z.ZodArray<z.ZodString, "many">;
+                    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }, {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                }>]>, "many">;
+            }, "strict", z.ZodTypeAny, {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            }, {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            }>;
+        }, "strict", z.ZodTypeAny, {
+            install: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            update: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            exactVersion: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+        }, {
+            install: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            update: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            exactVersion: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+        }>;
+        operation: z.ZodNullable<z.ZodObject<{
+            phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
+            target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"latest">;
+                version: z.ZodNull;
+            }, "strict", z.ZodTypeAny, {
+                kind: "latest";
+                version: null;
+            }, {
+                kind: "latest";
+                version: null;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"version">;
+                version: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "version";
+                version: string;
+            }, {
+                kind: "version";
+                version: string;
+            }>]>;
+            requester: z.ZodObject<{
+                source: z.ZodString;
+                requestId: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                source: string;
+                requestId: string | null;
+            }, {
+                source: string;
+                requestId: string | null;
+            }>;
+            installationHome: z.ZodNullable<z.ZodString>;
+            commands: z.ZodArray<z.ZodObject<{
+                binary: z.ZodString;
+                args: z.ZodArray<z.ZodString, "many">;
+                env: z.ZodRecord<z.ZodString, z.ZodString>;
+                script: z.ZodNullable<z.ZodObject<{
+                    url: z.ZodString;
+                    size: z.ZodNumber;
+                    sha256: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                }, {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                }>>;
+            }, "strict", z.ZodTypeAny, {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }, {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }>, "many">;
+            profileCleanup: z.ZodOptional<z.ZodObject<{
+                plannedPaths: z.ZodArray<z.ZodString, "many">;
+                removedPaths: z.ZodArray<z.ZodString, "many">;
+            }, "strict", z.ZodTypeAny, {
+                plannedPaths: string[];
+                removedPaths: string[];
+            }, {
+                plannedPaths: string[];
+                removedPaths: string[];
+            }>>;
+            before: z.ZodNullable<z.ZodObject<{
+                path: z.ZodNullable<z.ZodString>;
+                realPath: z.ZodNullable<z.ZodString>;
+                version: z.ZodNullable<z.ZodString>;
+                versionOutput: z.ZodNullable<z.ZodString>;
+                overrideEnv: z.ZodNullable<z.ZodString>;
+                overrideValue: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }>>;
+            after: z.ZodNullable<z.ZodObject<{
+                path: z.ZodNullable<z.ZodString>;
+                realPath: z.ZodNullable<z.ZodString>;
+                version: z.ZodNullable<z.ZodString>;
+                versionOutput: z.ZodNullable<z.ZodString>;
+                overrideEnv: z.ZodNullable<z.ZodString>;
+                overrideValue: z.ZodNullable<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }, {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            }>>;
+            elsewhere: z.ZodNullable<z.ZodObject<{
+                before: z.ZodObject<{
+                    path: z.ZodNullable<z.ZodString>;
+                    realPath: z.ZodNullable<z.ZodString>;
+                    version: z.ZodNullable<z.ZodString>;
+                    versionOutput: z.ZodNullable<z.ZodString>;
+                    overrideEnv: z.ZodNullable<z.ZodString>;
+                    overrideValue: z.ZodNullable<z.ZodString>;
+                }, "strict", z.ZodTypeAny, {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                }, {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                }>;
+                after: z.ZodObject<{
+                    path: z.ZodNullable<z.ZodString>;
+                    realPath: z.ZodNullable<z.ZodString>;
+                    version: z.ZodNullable<z.ZodString>;
+                    versionOutput: z.ZodNullable<z.ZodString>;
+                    overrideEnv: z.ZodNullable<z.ZodString>;
+                    overrideValue: z.ZodNullable<z.ZodString>;
+                }, "strict", z.ZodTypeAny, {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                }, {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                }>;
+            }, "strict", z.ZodTypeAny, {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            }, {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            }>>;
+            activeRunsAtStart: z.ZodNullable<z.ZodNumber>;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+            outcome: z.ZodEnum<["changed", "not_changed", "changed_elsewhere", "unknown"]>;
+            mutation: z.ZodEnum<["none", "applied", "unknown"]>;
+            termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
+            limitations: z.ZodArray<z.ZodString, "many">;
+            progress: z.ZodArray<z.ZodString, "many">;
+            problem: z.ZodNullable<z.ZodObject<{
+                code: z.ZodString;
+                message: z.ZodString;
+                retryable: z.ZodBoolean;
+                fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+                requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, "strict", z.ZodTypeAny, {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            }, {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            }>>;
+        } & {
+            id: z.ZodString;
+            harness: z.ZodString;
+            state: z.ZodEnum<["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]>;
+            createdAt: z.ZodString;
+            startedAt: z.ZodNullable<z.ZodString>;
+            finishedAt: z.ZodNullable<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            phase: "accepted" | "installing" | "preparing" | "settled";
+            target: {
+                kind: "latest";
+                version: null;
+            } | {
+                kind: "version";
+                version: string;
+            };
+            requester: {
+                source: string;
+                requestId: string | null;
+            };
+            installationHome: string | null;
+            commands: {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }[];
+            profileCleanup?: {
+                plannedPaths: string[];
+                removedPaths: string[];
+            } | undefined;
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            elsewhere: {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            } | null;
+            activeRunsAtStart: number | null;
+            exitCode: number | null;
+            outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+            mutation: "applied" | "none" | "unknown";
+            termination: "confirmed" | "not_applicable" | "unconfirmed";
+            limitations: string[];
+            progress: string[];
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            } | null;
+            id: string;
+            harness: string;
+            state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+            createdAt: string;
+            startedAt: string | null;
+            finishedAt: string | null;
+        }, {
+            phase: "accepted" | "installing" | "preparing" | "settled";
+            target: {
+                kind: "latest";
+                version: null;
+            } | {
+                kind: "version";
+                version: string;
+            };
+            requester: {
+                source: string;
+                requestId: string | null;
+            };
+            installationHome: string | null;
+            commands: {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }[];
+            profileCleanup?: {
+                plannedPaths: string[];
+                removedPaths: string[];
+            } | undefined;
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            elsewhere: {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            } | null;
+            activeRunsAtStart: number | null;
+            exitCode: number | null;
+            outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+            mutation: "applied" | "none" | "unknown";
+            termination: "confirmed" | "not_applicable" | "unconfirmed";
+            limitations: string[];
+            progress: string[];
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            } | null;
+            id: string;
+            harness: string;
+            state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+            createdAt: string;
+            startedAt: string | null;
+            finishedAt: string | null;
+        }>>;
+        observedAt: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
+        harness: string;
+        selection: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        newest: {
+            status: "not_read";
+            source: string | null;
+        } | {
+            status: "available";
+            source: string;
+            version: string;
+            observedAt: string;
+        } | {
+            status: "unavailable";
+            source: string | null;
+            observedAt: string;
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            };
+        };
+        updateAvailable: "cannot_tell" | "no" | "yes";
+        releaseNotesUrl: string | null;
+        actions: {
+            install: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            update: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            exactVersion: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+        };
+        operation: {
+            phase: "accepted" | "installing" | "preparing" | "settled";
+            target: {
+                kind: "latest";
+                version: null;
+            } | {
+                kind: "version";
+                version: string;
+            };
+            requester: {
+                source: string;
+                requestId: string | null;
+            };
+            installationHome: string | null;
+            commands: {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }[];
+            profileCleanup?: {
+                plannedPaths: string[];
+                removedPaths: string[];
+            } | undefined;
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            elsewhere: {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            } | null;
+            activeRunsAtStart: number | null;
+            exitCode: number | null;
+            outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+            mutation: "applied" | "none" | "unknown";
+            termination: "confirmed" | "not_applicable" | "unconfirmed";
+            limitations: string[];
+            progress: string[];
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            } | null;
+            id: string;
+            harness: string;
+            state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+            createdAt: string;
+            startedAt: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
     }, {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
-    }>;
+        harness: string;
+        selection: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        newest: {
+            status: "not_read";
+            source: string | null;
+        } | {
+            status: "available";
+            source: string;
+            version: string;
+            observedAt: string;
+        } | {
+            status: "unavailable";
+            source: string | null;
+            observedAt: string;
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            };
+        };
+        updateAvailable: "cannot_tell" | "no" | "yes";
+        releaseNotesUrl: string | null;
+        actions: {
+            install: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            update: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            exactVersion: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+        };
+        operation: {
+            phase: "accepted" | "installing" | "preparing" | "settled";
+            target: {
+                kind: "latest";
+                version: null;
+            } | {
+                kind: "version";
+                version: string;
+            };
+            requester: {
+                source: string;
+                requestId: string | null;
+            };
+            installationHome: string | null;
+            commands: {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }[];
+            profileCleanup?: {
+                plannedPaths: string[];
+                removedPaths: string[];
+            } | undefined;
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            elsewhere: {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            } | null;
+            activeRunsAtStart: number | null;
+            exitCode: number | null;
+            outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+            mutation: "applied" | "none" | "unknown";
+            termination: "confirmed" | "not_applicable" | "unconfirmed";
+            limitations: string[];
+            progress: string[];
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            } | null;
+            id: string;
+            harness: string;
+            state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+            createdAt: string;
+            startedAt: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
+    }>, "many">;
 }, "strict", z.ZodTypeAny, {
-    kind: "harness_maintenance";
-    harness: string;
-    target: {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
-    };
+    observedAt: string;
+    harnesses: {
+        harness: string;
+        selection: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        newest: {
+            status: "not_read";
+            source: string | null;
+        } | {
+            status: "available";
+            source: string;
+            version: string;
+            observedAt: string;
+        } | {
+            status: "unavailable";
+            source: string | null;
+            observedAt: string;
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            };
+        };
+        updateAvailable: "cannot_tell" | "no" | "yes";
+        releaseNotesUrl: string | null;
+        actions: {
+            install: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            update: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            exactVersion: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+        };
+        operation: {
+            phase: "accepted" | "installing" | "preparing" | "settled";
+            target: {
+                kind: "latest";
+                version: null;
+            } | {
+                kind: "version";
+                version: string;
+            };
+            requester: {
+                source: string;
+                requestId: string | null;
+            };
+            installationHome: string | null;
+            commands: {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }[];
+            profileCleanup?: {
+                plannedPaths: string[];
+                removedPaths: string[];
+            } | undefined;
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            elsewhere: {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            } | null;
+            activeRunsAtStart: number | null;
+            exitCode: number | null;
+            outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+            mutation: "applied" | "none" | "unknown";
+            termination: "confirmed" | "not_applicable" | "unconfirmed";
+            limitations: string[];
+            progress: string[];
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors: Record<string, string[]>;
+                requiredActions: string[];
+                evidenceRefs: string[];
+                context: Record<string, unknown>;
+            } | null;
+            id: string;
+            harness: string;
+            state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+            createdAt: string;
+            startedAt: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
+    }[];
 }, {
-    kind: "harness_maintenance";
-    harness: string;
-    target: {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
-    };
+    observedAt: string;
+    harnesses: {
+        harness: string;
+        selection: {
+            path: string | null;
+            realPath: string | null;
+            version: string | null;
+            versionOutput: string | null;
+            overrideEnv: string | null;
+            overrideValue: string | null;
+        };
+        newest: {
+            status: "not_read";
+            source: string | null;
+        } | {
+            status: "available";
+            source: string;
+            version: string;
+            observedAt: string;
+        } | {
+            status: "unavailable";
+            source: string | null;
+            observedAt: string;
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            };
+        };
+        updateAvailable: "cannot_tell" | "no" | "yes";
+        releaseNotesUrl: string | null;
+        actions: {
+            install: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            update: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+            exactVersion: {
+                available: boolean;
+                reason: string | null;
+                commands: ({
+                    kind: "exec";
+                    command: string;
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                } | {
+                    kind: "script";
+                    url: string;
+                    interpreter: string;
+                    interpreterArgs: string[];
+                    args: string[];
+                    env?: Record<string, string> | undefined;
+                })[];
+            };
+        };
+        operation: {
+            phase: "accepted" | "installing" | "preparing" | "settled";
+            target: {
+                kind: "latest";
+                version: null;
+            } | {
+                kind: "version";
+                version: string;
+            };
+            requester: {
+                source: string;
+                requestId: string | null;
+            };
+            installationHome: string | null;
+            commands: {
+                binary: string;
+                args: string[];
+                env: Record<string, string>;
+                script: {
+                    url: string;
+                    size: number;
+                    sha256: string;
+                } | null;
+            }[];
+            profileCleanup?: {
+                plannedPaths: string[];
+                removedPaths: string[];
+            } | undefined;
+            before: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            after: {
+                path: string | null;
+                realPath: string | null;
+                version: string | null;
+                versionOutput: string | null;
+                overrideEnv: string | null;
+                overrideValue: string | null;
+            } | null;
+            elsewhere: {
+                before: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+                after: {
+                    path: string | null;
+                    realPath: string | null;
+                    version: string | null;
+                    versionOutput: string | null;
+                    overrideEnv: string | null;
+                    overrideValue: string | null;
+                };
+            } | null;
+            activeRunsAtStart: number | null;
+            exitCode: number | null;
+            outcome: "changed" | "changed_elsewhere" | "not_changed" | "unknown";
+            mutation: "applied" | "none" | "unknown";
+            termination: "confirmed" | "not_applicable" | "unconfirmed";
+            limitations: string[];
+            progress: string[];
+            problem: {
+                code: string;
+                message: string;
+                retryable: boolean;
+                fieldErrors?: Record<string, string[]> | undefined;
+                requiredActions?: string[] | undefined;
+                evidenceRefs?: string[] | undefined;
+                context?: Record<string, unknown> | undefined;
+            } | null;
+            id: string;
+            harness: string;
+            state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
+            createdAt: string;
+            startedAt: string | null;
+            finishedAt: string | null;
+        } | null;
+        observedAt: string;
+    }[];
 }>;
-export type HarnessMaintenanceParams = z.infer<typeof HarnessMaintenanceParams>;
-export declare function isHarnessMaintenanceOperation(params: unknown): boolean;
-/** Evidence kept in the generic command record (JobRecord.result). */
-export declare const HarnessMaintenanceEvidence: z.ZodObject<{
-    phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
-    mechanism: z.ZodNullable<z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>>;
-    target: z.ZodObject<{
-        kind: z.ZodEnum<["latest", "version", "previous", "baseline"]>;
-        version: z.ZodNullable<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
-    }, {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
-    }>;
-    before: z.ZodNullable<z.ZodObject<{
-        version: z.ZodNullable<z.ZodString>;
-        binary: z.ZodNullable<z.ZodString>;
-        selection: z.ZodEnum<["managed", "override", "path", "missing"]>;
-        proved: z.ZodBoolean;
-    }, "strict", z.ZodTypeAny, {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
-    }, {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
-    }>>;
-    after: z.ZodNullable<z.ZodObject<{
-        version: z.ZodNullable<z.ZodString>;
-        binary: z.ZodNullable<z.ZodString>;
-        selected: z.ZodBoolean;
-        proved: z.ZodBoolean;
+export type ControlHarnessMaintenanceInventory = z.infer<typeof ControlHarnessMaintenanceInventory>;
+export declare const ControlHarnessMaintenanceCreateRequest: z.ZodObject<{
+    harness: z.ZodString;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"latest">;
     }, "strict", z.ZodTypeAny, {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
+        kind: "latest";
     }, {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
-    }>>;
-    mutation: z.ZodEnum<["none", "applied", "unknown"]>;
-    termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
-    limitations: z.ZodArray<z.ZodString, "many">;
-    progress: z.ZodArray<z.ZodString, "many">;
-    problem: z.ZodNullable<z.ZodObject<{
-        code: z.ZodString;
-        message: z.ZodString;
-        retryable: z.ZodBoolean;
-        fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-        requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: "latest";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"version">;
+        version: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors: Record<string, string[]>;
-        requiredActions: string[];
-        evidenceRefs: string[];
-        context: Record<string, unknown>;
+        kind: "version";
+        version: string;
     }, {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors?: Record<string, string[]> | undefined;
-        requiredActions?: string[] | undefined;
-        evidenceRefs?: string[] | undefined;
-        context?: Record<string, unknown> | undefined;
-    }>>;
+        kind: "version";
+        version: string;
+    }>]>;
 }, "strict", z.ZodTypeAny, {
-    phase: "accepted" | "installing" | "preparing" | "settled";
-    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    harness: string;
     target: {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
+        kind: "latest";
+    } | {
+        kind: "version";
+        version: string;
     };
-    before: {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
-    } | null;
-    after: {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
-    } | null;
-    mutation: "applied" | "none" | "unknown";
-    termination: "confirmed" | "not_applicable" | "unconfirmed";
-    limitations: string[];
-    progress: string[];
-    problem: {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors: Record<string, string[]>;
-        requiredActions: string[];
-        evidenceRefs: string[];
-        context: Record<string, unknown>;
-    } | null;
 }, {
-    phase: "accepted" | "installing" | "preparing" | "settled";
-    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    harness: string;
     target: {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
+        kind: "latest";
+    } | {
+        kind: "version";
+        version: string;
     };
-    before: {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
-    } | null;
-    after: {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
-    } | null;
-    mutation: "applied" | "none" | "unknown";
-    termination: "confirmed" | "not_applicable" | "unconfirmed";
-    limitations: string[];
-    progress: string[];
-    problem: {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors?: Record<string, string[]> | undefined;
-        requiredActions?: string[] | undefined;
-        evidenceRefs?: string[] | undefined;
-        context?: Record<string, unknown> | undefined;
-    } | null;
 }>;
-export type HarnessMaintenanceEvidence = z.infer<typeof HarnessMaintenanceEvidence>;
-export declare const ControlHarnessMaintenanceOperation: z.ZodObject<{
-    phase: z.ZodEnum<["accepted", "preparing", "installing", "settled"]>;
-    mechanism: z.ZodNullable<z.ZodEnum<["managed_npm", "vendor_updater", "vendor_script"]>>;
-    target: z.ZodObject<{
-        kind: z.ZodEnum<["latest", "version", "previous", "baseline"]>;
-        version: z.ZodNullable<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
-    }, {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
-    }>;
-    before: z.ZodNullable<z.ZodObject<{
-        version: z.ZodNullable<z.ZodString>;
-        binary: z.ZodNullable<z.ZodString>;
-        selection: z.ZodEnum<["managed", "override", "path", "missing"]>;
-        proved: z.ZodBoolean;
+export type ControlHarnessMaintenanceCreateRequest = z.infer<typeof ControlHarnessMaintenanceCreateRequest>;
+export declare const HarnessMaintenanceParams: z.ZodObject<{
+    kind: z.ZodLiteral<"harness_maintenance">;
+    harness: z.ZodString;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"latest">;
+        version: z.ZodNull;
     }, "strict", z.ZodTypeAny, {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
+        kind: "latest";
+        version: null;
     }, {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
-    }>>;
-    after: z.ZodNullable<z.ZodObject<{
-        version: z.ZodNullable<z.ZodString>;
-        binary: z.ZodNullable<z.ZodString>;
-        selected: z.ZodBoolean;
-        proved: z.ZodBoolean;
+        kind: "latest";
+        version: null;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"version">;
+        version: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
+        kind: "version";
+        version: string;
     }, {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
-    }>>;
-    mutation: z.ZodEnum<["none", "applied", "unknown"]>;
-    termination: z.ZodEnum<["not_applicable", "confirmed", "unconfirmed"]>;
-    limitations: z.ZodArray<z.ZodString, "many">;
-    progress: z.ZodArray<z.ZodString, "many">;
-    problem: z.ZodNullable<z.ZodObject<{
-        code: z.ZodString;
-        message: z.ZodString;
-        retryable: z.ZodBoolean;
-        fieldErrors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
-        requiredActions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        evidenceRefs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        kind: "version";
+        version: string;
+    }>]>;
+    requester: z.ZodObject<{
+        source: z.ZodString;
+        requestId: z.ZodNullable<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors: Record<string, string[]>;
-        requiredActions: string[];
-        evidenceRefs: string[];
-        context: Record<string, unknown>;
+        source: string;
+        requestId: string | null;
     }, {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors?: Record<string, string[]> | undefined;
-        requiredActions?: string[] | undefined;
-        evidenceRefs?: string[] | undefined;
-        context?: Record<string, unknown> | undefined;
-    }>>;
-} & {
-    id: z.ZodString;
-    harness: z.ZodString;
-    state: z.ZodEnum<["queued", "running", "succeeded", "failed", "cancelled", "interrupted"]>;
-    createdAt: z.ZodString;
-    startedAt: z.ZodNullable<z.ZodString>;
-    finishedAt: z.ZodNullable<z.ZodString>;
+        source: string;
+        requestId: string | null;
+    }>;
 }, "strict", z.ZodTypeAny, {
-    phase: "accepted" | "installing" | "preparing" | "settled";
-    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    kind: "harness_maintenance";
+    harness: string;
     target: {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
+        kind: "latest";
+        version: null;
+    } | {
+        kind: "version";
+        version: string;
+    };
+    requester: {
+        source: string;
+        requestId: string | null;
     };
-    before: {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
-    } | null;
-    after: {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
-    } | null;
-    mutation: "applied" | "none" | "unknown";
-    termination: "confirmed" | "not_applicable" | "unconfirmed";
-    limitations: string[];
-    progress: string[];
-    problem: {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors: Record<string, string[]>;
-        requiredActions: string[];
-        evidenceRefs: string[];
-        context: Record<string, unknown>;
-    } | null;
-    id: string;
-    harness: string;
-    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
-    createdAt: string;
-    startedAt: string | null;
-    finishedAt: string | null;
 }, {
-    phase: "accepted" | "installing" | "preparing" | "settled";
-    mechanism: "managed_npm" | "vendor_script" | "vendor_updater" | null;
+    kind: "harness_maintenance";
+    harness: string;
     target: {
-        kind: "baseline" | "latest" | "previous" | "version";
-        version: string | null;
+        kind: "latest";
+        version: null;
+    } | {
+        kind: "version";
+        version: string;
+    };
+    requester: {
+        source: string;
+        requestId: string | null;
     };
-    before: {
-        version: string | null;
-        binary: string | null;
-        selection: "managed" | "missing" | "override" | "path";
-        proved: boolean;
-    } | null;
-    after: {
-        version: string | null;
-        binary: string | null;
-        selected: boolean;
-        proved: boolean;
-    } | null;
-    mutation: "applied" | "none" | "unknown";
-    termination: "confirmed" | "not_applicable" | "unconfirmed";
-    limitations: string[];
-    progress: string[];
-    problem: {
-        code: string;
-        message: string;
-        retryable: boolean;
-        fieldErrors?: Record<string, string[]> | undefined;
-        requiredActions?: string[] | undefined;
-        evidenceRefs?: string[] | undefined;
-        context?: Record<string, unknown> | undefined;
-    } | null;
-    id: string;
-    harness: string;
-    state: "cancelled" | "failed" | "interrupted" | "queued" | "running" | "succeeded";
-    createdAt: string;
-    startedAt: string | null;
-    finishedAt: string | null;
 }>;
-export type ControlHarnessMaintenanceOperation = z.infer<typeof ControlHarnessMaintenanceOperation>;
+export type HarnessMaintenanceParams = z.infer<typeof HarnessMaintenanceParams>;
+export declare function isHarnessMaintenanceOperation(params: unknown): boolean;
 //# sourceMappingURL=harness-maintenance.d.ts.map