@kya-os/cli 1.8.3 → 2.0.2

package/node_modules/@kya-os/contracts/dist/workbench/routing.d.ts

@@ -0,0 +1,1200 @@
+import { z } from 'zod';
+export declare const TrackingRoutingAssignmentSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+    mode: z.ZodLiteral<"direct">;
+    candidateId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    mode: "direct";
+    candidateId: string;
+}, {
+    mode: "direct";
+    candidateId: string;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"pool">;
+    poolId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    mode: "pool";
+    poolId: string;
+}, {
+    mode: "pool";
+    poolId: string;
+}>]>;
+export declare const TrackingRoutingCandidateSchema: z.ZodObject<{
+    id: z.ZodEffects<z.ZodString, string, string>;
+    harness: z.ZodString;
+    model: z.ZodNullable<z.ZodString>;
+    poolIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    repositoryIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    capabilities: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    available: z.ZodBoolean;
+    estimatedCostMicrousd: z.ZodNullable<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    capabilities: string[];
+    harness: string;
+    model: string | null;
+    poolIds: string[];
+    repositoryIds: string[];
+    available: boolean;
+    estimatedCostMicrousd: number | null;
+}, {
+    id: string;
+    capabilities: string[];
+    harness: string;
+    model: string | null;
+    poolIds: string[];
+    repositoryIds: string[];
+    available: boolean;
+    estimatedCostMicrousd: number | null;
+}>;
+/** The judgment questions the planner asks; a new revision may intentionally bill again. */
+export declare const TRACKING_ROUTING_QUESTION_REVISION = "routing-reusable-v4";
+/** An item the prerequisite judgment may suggest; a suggestion is only ever a reviewed graph edit. */
+export declare const TrackingDependencyOptionSchema: z.ZodObject<{
+    taskId: z.ZodEffects<z.ZodString, string, string>;
+    title: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    taskId: string;
+}, {
+    title: string;
+    taskId: string;
+}>;
+export declare const TrackingRoutingInputSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    taskId: z.ZodString;
+    specRevision: z.ZodNumber;
+    title: z.ZodString;
+    objective: z.ZodString;
+    acceptanceCriteria: z.ZodArray<z.ZodString, "many">;
+    repositoryIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    dependencyTaskIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    completionClaim: z.ZodBoolean;
+    requiredCapabilities: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+    assignment: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"direct">;
+        candidateId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        mode: "direct";
+        candidateId: string;
+    }, {
+        mode: "direct";
+        candidateId: string;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"pool">;
+        poolId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        mode: "pool";
+        poolId: string;
+    }, {
+        mode: "pool";
+        poolId: string;
+    }>]>;
+    candidates: z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        harness: z.ZodString;
+        model: z.ZodNullable<z.ZodString>;
+        poolIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        repositoryIds: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        capabilities: z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>;
+        available: z.ZodBoolean;
+        estimatedCostMicrousd: z.ZodNullable<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }, {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }>, "many">;
+    dependencyOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        taskId: z.ZodEffects<z.ZodString, string, string>;
+        title: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        title: string;
+        taskId: string;
+    }, {
+        title: string;
+        taskId: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    title: string;
+    taskId: string;
+    specRevision: number;
+    objective: string;
+    acceptanceCriteria: string[];
+    repositoryIds: string[];
+    dependencyTaskIds: string[];
+    completionClaim: boolean;
+    requiredCapabilities: string[];
+    assignment: {
+        mode: "direct";
+        candidateId: string;
+    } | {
+        mode: "pool";
+        poolId: string;
+    };
+    candidates: {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }[];
+    dependencyOptions?: {
+        title: string;
+        taskId: string;
+    }[] | undefined;
+}, {
+    title: string;
+    taskId: string;
+    specRevision: number;
+    objective: string;
+    acceptanceCriteria: string[];
+    repositoryIds: string[];
+    dependencyTaskIds: string[];
+    completionClaim: boolean;
+    requiredCapabilities: string[];
+    assignment: {
+        mode: "direct";
+        candidateId: string;
+    } | {
+        mode: "pool";
+        poolId: string;
+    };
+    candidates: {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }[];
+    dependencyOptions?: {
+        title: string;
+        taskId: string;
+    }[] | undefined;
+}>, {
+    title: string;
+    taskId: string;
+    specRevision: number;
+    objective: string;
+    acceptanceCriteria: string[];
+    repositoryIds: string[];
+    dependencyTaskIds: string[];
+    completionClaim: boolean;
+    requiredCapabilities: string[];
+    assignment: {
+        mode: "direct";
+        candidateId: string;
+    } | {
+        mode: "pool";
+        poolId: string;
+    };
+    candidates: {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }[];
+    dependencyOptions?: {
+        title: string;
+        taskId: string;
+    }[] | undefined;
+}, {
+    title: string;
+    taskId: string;
+    specRevision: number;
+    objective: string;
+    acceptanceCriteria: string[];
+    repositoryIds: string[];
+    dependencyTaskIds: string[];
+    completionClaim: boolean;
+    requiredCapabilities: string[];
+    assignment: {
+        mode: "direct";
+        candidateId: string;
+    } | {
+        mode: "pool";
+        poolId: string;
+    };
+    candidates: {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }[];
+    dependencyOptions?: {
+        title: string;
+        taskId: string;
+    }[] | undefined;
+}>, {
+    title: string;
+    taskId: string;
+    specRevision: number;
+    objective: string;
+    acceptanceCriteria: string[];
+    repositoryIds: string[];
+    dependencyTaskIds: string[];
+    completionClaim: boolean;
+    requiredCapabilities: string[];
+    assignment: {
+        mode: "direct";
+        candidateId: string;
+    } | {
+        mode: "pool";
+        poolId: string;
+    };
+    candidates: {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }[];
+    dependencyOptions?: {
+        title: string;
+        taskId: string;
+    }[] | undefined;
+}, {
+    title: string;
+    taskId: string;
+    specRevision: number;
+    objective: string;
+    acceptanceCriteria: string[];
+    repositoryIds: string[];
+    dependencyTaskIds: string[];
+    completionClaim: boolean;
+    requiredCapabilities: string[];
+    assignment: {
+        mode: "direct";
+        candidateId: string;
+    } | {
+        mode: "pool";
+        poolId: string;
+    };
+    candidates: {
+        id: string;
+        capabilities: string[];
+        harness: string;
+        model: string | null;
+        poolIds: string[];
+        repositoryIds: string[];
+        available: boolean;
+        estimatedCostMicrousd: number | null;
+    }[];
+    dependencyOptions?: {
+        title: string;
+        taskId: string;
+    }[] | undefined;
+}>;
+export declare const TrackingRoutingPolicySchema: z.ZodObject<{
+    version: z.ZodString;
+    minConfidence: z.ZodNumber;
+    costCeilingMicrousd: z.ZodNullable<z.ZodNumber>;
+    cacheTtlMs: z.ZodNumber;
+    shadow: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    version: string;
+    minConfidence: number;
+    costCeilingMicrousd: number | null;
+    cacheTtlMs: number;
+    shadow: boolean;
+}, {
+    version: string;
+    minConfidence: number;
+    costCeilingMicrousd: number | null;
+    cacheTtlMs: number;
+    shadow: boolean;
+}>;
+export declare const TrackingPlanningPhaseSchema: z.ZodEnum<["verify_existing_claim", "needs_specification", "awaiting_dependency_artifacts", "ready_for_lead"]>;
+export declare const TrackingWorkKindSchema: z.ZodEnum<["implementation", "verification", "documentation", "unknown"]>;
+export declare const TrackingAssessmentSourceSchema: z.ZodEnum<["deterministic", "jev_shadow", "jev_recommendation", "fallback"]>;
+/** Exact official TypeSafe API usage fields. They are observations, not estimates. */
+export declare const JevProviderUsageSchema: z.ZodObject<{
+    input_tokens: z.ZodNumber;
+    output_tokens: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    input_tokens: number;
+    output_tokens: number;
+}, {
+    input_tokens: number;
+    output_tokens: number;
+}>;
+export declare const JevChoiceAnswerSchema: z.ZodEffects<z.ZodObject<{
+    type: z.ZodLiteral<"choice">;
+    choice: z.ZodString;
+    confidence: z.ZodNumber;
+    probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "choice";
+    confidence: number;
+    choice: string;
+    probabilities: Record<string, number>;
+}, {
+    type: "choice";
+    confidence: number;
+    choice: string;
+    probabilities: Record<string, number>;
+}>, {
+    type: "choice";
+    confidence: number;
+    choice: string;
+    probabilities: Record<string, number>;
+}, {
+    type: "choice";
+    confidence: number;
+    choice: string;
+    probabilities: Record<string, number>;
+}>;
+export declare function validateJevChoice(value: unknown, eligibleOptions: string[]): z.infer<typeof JevChoiceAnswerSchema>;
+/** A timeout, a non-success HTTP status, a request or answer outside the typed contract, or an unknown outcome. */
+export declare const TrackingProviderFailureSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"timeout">;
+}, "strict", z.ZodTypeAny, {
+    kind: "timeout";
+}, {
+    kind: "timeout";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"http_error">;
+    status: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    status: number;
+    kind: "http_error";
+}, {
+    status: number;
+    kind: "http_error";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"invalid">;
+}, "strict", z.ZodTypeAny, {
+    kind: "invalid";
+}, {
+    kind: "invalid";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"unknown">;
+}, "strict", z.ZodTypeAny, {
+    kind: "unknown";
+}, {
+    kind: "unknown";
+}>]>;
+export declare const TrackingRoutingAssessmentSchema: z.ZodObject<{
+    inputDigest: z.ZodString;
+    policyDigest: z.ZodString;
+    phase: z.ZodEnum<["verify_existing_claim", "needs_specification", "awaiting_dependency_artifacts", "ready_for_lead"]>;
+    workKind: z.ZodEnum<["implementation", "verification", "documentation", "unknown"]>;
+    effortBand: z.ZodDefault<z.ZodEnum<["small", "medium", "large", "unknown"]>>;
+    source: z.ZodEnum<["deterministic", "jev_shadow", "jev_recommendation", "fallback"]>;
+    baselineCandidate: z.ZodNullable<z.ZodString>;
+    recommendedCandidate: z.ZodNullable<z.ZodString>;
+    shadowCandidate: z.ZodNullable<z.ZodString>;
+    confidence: z.ZodNullable<z.ZodNumber>;
+    abstentionReason: z.ZodNullable<z.ZodString>;
+    requestedModel: z.ZodNullable<z.ZodString>;
+    resolvedModel: z.ZodNullable<z.ZodString>;
+    usage: z.ZodNullable<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number;
+        output_tokens: number;
+    }, {
+        input_tokens: number;
+        output_tokens: number;
+    }>>;
+    latencyMs: z.ZodNumber;
+    cacheHit: z.ZodBoolean;
+    judgments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+        type: z.ZodLiteral<"choice">;
+        choice: z.ZodString;
+        confidence: z.ZodNumber;
+        probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "choice";
+        confidence: number;
+        choice: string;
+        probabilities: Record<string, number>;
+    }, {
+        type: "choice";
+        confidence: number;
+        choice: string;
+        probabilities: Record<string, number>;
+    }>, {
+        type: "choice";
+        confidence: number;
+        choice: string;
+        probabilities: Record<string, number>;
+    }, {
+        type: "choice";
+        confidence: number;
+        choice: string;
+        probabilities: Record<string, number>;
+    }>>>;
+    /** The capability the task needs most, when judged confidently. */
+    capability: z.ZodOptional<z.ZodString>;
+    /** A suggested prerequisite; it changes nothing until a reviewer applies it. */
+    suggestedPrerequisite: z.ZodOptional<z.ZodString>;
+    /** Eligible candidates by suitability, then urgency, then cache affinity. */
+    ranking: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+    /** Why JEV's judgment is missing when it was asked for and the approved baseline stands for that reason. */
+    providerFailure: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"timeout">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "timeout";
+    }, {
+        kind: "timeout";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"http_error">;
+        status: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        status: number;
+        kind: "http_error";
+    }, {
+        status: number;
+        kind: "http_error";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"invalid">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "invalid";
+    }, {
+        kind: "invalid";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"unknown">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "unknown";
+    }, {
+        kind: "unknown";
+    }>]>>;
+}, "strict", z.ZodTypeAny, {
+    confidence: number | null;
+    source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    } | null;
+    phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+    inputDigest: string;
+    policyDigest: string;
+    workKind: "unknown" | "verification" | "implementation" | "documentation";
+    effortBand: "unknown" | "small" | "medium" | "large";
+    baselineCandidate: string | null;
+    recommendedCandidate: string | null;
+    shadowCandidate: string | null;
+    abstentionReason: string | null;
+    requestedModel: string | null;
+    resolvedModel: string | null;
+    latencyMs: number;
+    cacheHit: boolean;
+    judgments?: Record<string, {
+        type: "choice";
+        confidence: number;
+        choice: string;
+        probabilities: Record<string, number>;
+    }> | undefined;
+    capability?: string | undefined;
+    suggestedPrerequisite?: string | undefined;
+    ranking?: string[] | undefined;
+    providerFailure?: {
+        kind: "timeout";
+    } | {
+        status: number;
+        kind: "http_error";
+    } | {
+        kind: "invalid";
+    } | {
+        kind: "unknown";
+    } | undefined;
+}, {
+    confidence: number | null;
+    source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    } | null;
+    phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+    inputDigest: string;
+    policyDigest: string;
+    workKind: "unknown" | "verification" | "implementation" | "documentation";
+    baselineCandidate: string | null;
+    recommendedCandidate: string | null;
+    shadowCandidate: string | null;
+    abstentionReason: string | null;
+    requestedModel: string | null;
+    resolvedModel: string | null;
+    latencyMs: number;
+    cacheHit: boolean;
+    effortBand?: "unknown" | "small" | "medium" | "large" | undefined;
+    judgments?: Record<string, {
+        type: "choice";
+        confidence: number;
+        choice: string;
+        probabilities: Record<string, number>;
+    }> | undefined;
+    capability?: string | undefined;
+    suggestedPrerequisite?: string | undefined;
+    ranking?: string[] | undefined;
+    providerFailure?: {
+        kind: "timeout";
+    } | {
+        status: number;
+        kind: "http_error";
+    } | {
+        kind: "invalid";
+    } | {
+        kind: "unknown";
+    } | undefined;
+}>;
+export declare const TrackingTaskPlanningDraftSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    specRevision: z.ZodNumber;
+    missingFields: z.ZodArray<z.ZodString, "many">;
+    assessment: z.ZodObject<{
+        inputDigest: z.ZodString;
+        policyDigest: z.ZodString;
+        phase: z.ZodEnum<["verify_existing_claim", "needs_specification", "awaiting_dependency_artifacts", "ready_for_lead"]>;
+        workKind: z.ZodEnum<["implementation", "verification", "documentation", "unknown"]>;
+        effortBand: z.ZodDefault<z.ZodEnum<["small", "medium", "large", "unknown"]>>;
+        source: z.ZodEnum<["deterministic", "jev_shadow", "jev_recommendation", "fallback"]>;
+        baselineCandidate: z.ZodNullable<z.ZodString>;
+        recommendedCandidate: z.ZodNullable<z.ZodString>;
+        shadowCandidate: z.ZodNullable<z.ZodString>;
+        confidence: z.ZodNullable<z.ZodNumber>;
+        abstentionReason: z.ZodNullable<z.ZodString>;
+        requestedModel: z.ZodNullable<z.ZodString>;
+        resolvedModel: z.ZodNullable<z.ZodString>;
+        usage: z.ZodNullable<z.ZodObject<{
+            input_tokens: z.ZodNumber;
+            output_tokens: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            input_tokens: number;
+            output_tokens: number;
+        }, {
+            input_tokens: number;
+            output_tokens: number;
+        }>>;
+        latencyMs: z.ZodNumber;
+        cacheHit: z.ZodBoolean;
+        judgments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            type: z.ZodLiteral<"choice">;
+            choice: z.ZodString;
+            confidence: z.ZodNumber;
+            probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }>, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }>>>;
+        /** The capability the task needs most, when judged confidently. */
+        capability: z.ZodOptional<z.ZodString>;
+        /** A suggested prerequisite; it changes nothing until a reviewer applies it. */
+        suggestedPrerequisite: z.ZodOptional<z.ZodString>;
+        /** Eligible candidates by suitability, then urgency, then cache affinity. */
+        ranking: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+        /** Why JEV's judgment is missing when it was asked for and the approved baseline stands for that reason. */
+        providerFailure: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"timeout">;
+        }, "strict", z.ZodTypeAny, {
+            kind: "timeout";
+        }, {
+            kind: "timeout";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"http_error">;
+            status: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            status: number;
+            kind: "http_error";
+        }, {
+            status: number;
+            kind: "http_error";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"invalid">;
+        }, "strict", z.ZodTypeAny, {
+            kind: "invalid";
+        }, {
+            kind: "invalid";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"unknown">;
+        }, "strict", z.ZodTypeAny, {
+            kind: "unknown";
+        }, {
+            kind: "unknown";
+        }>]>>;
+    }, "strict", z.ZodTypeAny, {
+        confidence: number | null;
+        source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+        } | null;
+        phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+        inputDigest: string;
+        policyDigest: string;
+        workKind: "unknown" | "verification" | "implementation" | "documentation";
+        effortBand: "unknown" | "small" | "medium" | "large";
+        baselineCandidate: string | null;
+        recommendedCandidate: string | null;
+        shadowCandidate: string | null;
+        abstentionReason: string | null;
+        requestedModel: string | null;
+        resolvedModel: string | null;
+        latencyMs: number;
+        cacheHit: boolean;
+        judgments?: Record<string, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }> | undefined;
+        capability?: string | undefined;
+        suggestedPrerequisite?: string | undefined;
+        ranking?: string[] | undefined;
+        providerFailure?: {
+            kind: "timeout";
+        } | {
+            status: number;
+            kind: "http_error";
+        } | {
+            kind: "invalid";
+        } | {
+            kind: "unknown";
+        } | undefined;
+    }, {
+        confidence: number | null;
+        source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+        } | null;
+        phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+        inputDigest: string;
+        policyDigest: string;
+        workKind: "unknown" | "verification" | "implementation" | "documentation";
+        baselineCandidate: string | null;
+        recommendedCandidate: string | null;
+        shadowCandidate: string | null;
+        abstentionReason: string | null;
+        requestedModel: string | null;
+        resolvedModel: string | null;
+        latencyMs: number;
+        cacheHit: boolean;
+        effortBand?: "unknown" | "small" | "medium" | "large" | undefined;
+        judgments?: Record<string, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }> | undefined;
+        capability?: string | undefined;
+        suggestedPrerequisite?: string | undefined;
+        ranking?: string[] | undefined;
+        providerFailure?: {
+            kind: "timeout";
+        } | {
+            status: number;
+            kind: "http_error";
+        } | {
+            kind: "invalid";
+        } | {
+            kind: "unknown";
+        } | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    taskId: string;
+    specRevision: number;
+    missingFields: string[];
+    assessment: {
+        confidence: number | null;
+        source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+        } | null;
+        phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+        inputDigest: string;
+        policyDigest: string;
+        workKind: "unknown" | "verification" | "implementation" | "documentation";
+        effortBand: "unknown" | "small" | "medium" | "large";
+        baselineCandidate: string | null;
+        recommendedCandidate: string | null;
+        shadowCandidate: string | null;
+        abstentionReason: string | null;
+        requestedModel: string | null;
+        resolvedModel: string | null;
+        latencyMs: number;
+        cacheHit: boolean;
+        judgments?: Record<string, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }> | undefined;
+        capability?: string | undefined;
+        suggestedPrerequisite?: string | undefined;
+        ranking?: string[] | undefined;
+        providerFailure?: {
+            kind: "timeout";
+        } | {
+            status: number;
+            kind: "http_error";
+        } | {
+            kind: "invalid";
+        } | {
+            kind: "unknown";
+        } | undefined;
+    };
+}, {
+    taskId: string;
+    specRevision: number;
+    missingFields: string[];
+    assessment: {
+        confidence: number | null;
+        source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+        } | null;
+        phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+        inputDigest: string;
+        policyDigest: string;
+        workKind: "unknown" | "verification" | "implementation" | "documentation";
+        baselineCandidate: string | null;
+        recommendedCandidate: string | null;
+        shadowCandidate: string | null;
+        abstentionReason: string | null;
+        requestedModel: string | null;
+        resolvedModel: string | null;
+        latencyMs: number;
+        cacheHit: boolean;
+        effortBand?: "unknown" | "small" | "medium" | "large" | undefined;
+        judgments?: Record<string, {
+            type: "choice";
+            confidence: number;
+            choice: string;
+            probabilities: Record<string, number>;
+        }> | undefined;
+        capability?: string | undefined;
+        suggestedPrerequisite?: string | undefined;
+        ranking?: string[] | undefined;
+        providerFailure?: {
+            kind: "timeout";
+        } | {
+            status: number;
+            kind: "http_error";
+        } | {
+            kind: "invalid";
+        } | {
+            kind: "unknown";
+        } | undefined;
+    };
+}>;
+export declare const TrackingPlanningDraftSchema: z.ZodObject<{
+    id: z.ZodString;
+    trackId: z.ZodString;
+    sourceDigest: z.ZodString;
+    generation: z.ZodNumber;
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        specRevision: z.ZodNumber;
+        missingFields: z.ZodArray<z.ZodString, "many">;
+        assessment: z.ZodObject<{
+            inputDigest: z.ZodString;
+            policyDigest: z.ZodString;
+            phase: z.ZodEnum<["verify_existing_claim", "needs_specification", "awaiting_dependency_artifacts", "ready_for_lead"]>;
+            workKind: z.ZodEnum<["implementation", "verification", "documentation", "unknown"]>;
+            effortBand: z.ZodDefault<z.ZodEnum<["small", "medium", "large", "unknown"]>>;
+            source: z.ZodEnum<["deterministic", "jev_shadow", "jev_recommendation", "fallback"]>;
+            baselineCandidate: z.ZodNullable<z.ZodString>;
+            recommendedCandidate: z.ZodNullable<z.ZodString>;
+            shadowCandidate: z.ZodNullable<z.ZodString>;
+            confidence: z.ZodNullable<z.ZodNumber>;
+            abstentionReason: z.ZodNullable<z.ZodString>;
+            requestedModel: z.ZodNullable<z.ZodString>;
+            resolvedModel: z.ZodNullable<z.ZodString>;
+            usage: z.ZodNullable<z.ZodObject<{
+                input_tokens: z.ZodNumber;
+                output_tokens: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                input_tokens: number;
+                output_tokens: number;
+            }, {
+                input_tokens: number;
+                output_tokens: number;
+            }>>;
+            latencyMs: z.ZodNumber;
+            cacheHit: z.ZodBoolean;
+            judgments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+                type: z.ZodLiteral<"choice">;
+                choice: z.ZodString;
+                confidence: z.ZodNumber;
+                probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }>, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }>>>;
+            /** The capability the task needs most, when judged confidently. */
+            capability: z.ZodOptional<z.ZodString>;
+            /** A suggested prerequisite; it changes nothing until a reviewer applies it. */
+            suggestedPrerequisite: z.ZodOptional<z.ZodString>;
+            /** Eligible candidates by suitability, then urgency, then cache affinity. */
+            ranking: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], string[]>>;
+            /** Why JEV's judgment is missing when it was asked for and the approved baseline stands for that reason. */
+            providerFailure: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"timeout">;
+            }, "strict", z.ZodTypeAny, {
+                kind: "timeout";
+            }, {
+                kind: "timeout";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"http_error">;
+                status: z.ZodNumber;
+            }, "strict", z.ZodTypeAny, {
+                status: number;
+                kind: "http_error";
+            }, {
+                status: number;
+                kind: "http_error";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"invalid">;
+            }, "strict", z.ZodTypeAny, {
+                kind: "invalid";
+            }, {
+                kind: "invalid";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"unknown">;
+            }, "strict", z.ZodTypeAny, {
+                kind: "unknown";
+            }, {
+                kind: "unknown";
+            }>]>>;
+        }, "strict", z.ZodTypeAny, {
+            confidence: number | null;
+            source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+            usage: {
+                input_tokens: number;
+                output_tokens: number;
+            } | null;
+            phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+            inputDigest: string;
+            policyDigest: string;
+            workKind: "unknown" | "verification" | "implementation" | "documentation";
+            effortBand: "unknown" | "small" | "medium" | "large";
+            baselineCandidate: string | null;
+            recommendedCandidate: string | null;
+            shadowCandidate: string | null;
+            abstentionReason: string | null;
+            requestedModel: string | null;
+            resolvedModel: string | null;
+            latencyMs: number;
+            cacheHit: boolean;
+            judgments?: Record<string, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }> | undefined;
+            capability?: string | undefined;
+            suggestedPrerequisite?: string | undefined;
+            ranking?: string[] | undefined;
+            providerFailure?: {
+                kind: "timeout";
+            } | {
+                status: number;
+                kind: "http_error";
+            } | {
+                kind: "invalid";
+            } | {
+                kind: "unknown";
+            } | undefined;
+        }, {
+            confidence: number | null;
+            source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+            usage: {
+                input_tokens: number;
+                output_tokens: number;
+            } | null;
+            phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+            inputDigest: string;
+            policyDigest: string;
+            workKind: "unknown" | "verification" | "implementation" | "documentation";
+            baselineCandidate: string | null;
+            recommendedCandidate: string | null;
+            shadowCandidate: string | null;
+            abstentionReason: string | null;
+            requestedModel: string | null;
+            resolvedModel: string | null;
+            latencyMs: number;
+            cacheHit: boolean;
+            effortBand?: "unknown" | "small" | "medium" | "large" | undefined;
+            judgments?: Record<string, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }> | undefined;
+            capability?: string | undefined;
+            suggestedPrerequisite?: string | undefined;
+            ranking?: string[] | undefined;
+            providerFailure?: {
+                kind: "timeout";
+            } | {
+                status: number;
+                kind: "http_error";
+            } | {
+                kind: "invalid";
+            } | {
+                kind: "unknown";
+            } | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        taskId: string;
+        specRevision: number;
+        missingFields: string[];
+        assessment: {
+            confidence: number | null;
+            source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+            usage: {
+                input_tokens: number;
+                output_tokens: number;
+            } | null;
+            phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+            inputDigest: string;
+            policyDigest: string;
+            workKind: "unknown" | "verification" | "implementation" | "documentation";
+            effortBand: "unknown" | "small" | "medium" | "large";
+            baselineCandidate: string | null;
+            recommendedCandidate: string | null;
+            shadowCandidate: string | null;
+            abstentionReason: string | null;
+            requestedModel: string | null;
+            resolvedModel: string | null;
+            latencyMs: number;
+            cacheHit: boolean;
+            judgments?: Record<string, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }> | undefined;
+            capability?: string | undefined;
+            suggestedPrerequisite?: string | undefined;
+            ranking?: string[] | undefined;
+            providerFailure?: {
+                kind: "timeout";
+            } | {
+                status: number;
+                kind: "http_error";
+            } | {
+                kind: "invalid";
+            } | {
+                kind: "unknown";
+            } | undefined;
+        };
+    }, {
+        taskId: string;
+        specRevision: number;
+        missingFields: string[];
+        assessment: {
+            confidence: number | null;
+            source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+            usage: {
+                input_tokens: number;
+                output_tokens: number;
+            } | null;
+            phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+            inputDigest: string;
+            policyDigest: string;
+            workKind: "unknown" | "verification" | "implementation" | "documentation";
+            baselineCandidate: string | null;
+            recommendedCandidate: string | null;
+            shadowCandidate: string | null;
+            abstentionReason: string | null;
+            requestedModel: string | null;
+            resolvedModel: string | null;
+            latencyMs: number;
+            cacheHit: boolean;
+            effortBand?: "unknown" | "small" | "medium" | "large" | undefined;
+            judgments?: Record<string, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }> | undefined;
+            capability?: string | undefined;
+            suggestedPrerequisite?: string | undefined;
+            ranking?: string[] | undefined;
+            providerFailure?: {
+                kind: "timeout";
+            } | {
+                status: number;
+                kind: "http_error";
+            } | {
+                kind: "invalid";
+            } | {
+                kind: "unknown";
+            } | undefined;
+        };
+    }>, "many">;
+    requiresLeadReview: z.ZodLiteral<true>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    trackId: string;
+    tasks: {
+        taskId: string;
+        specRevision: number;
+        missingFields: string[];
+        assessment: {
+            confidence: number | null;
+            source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+            usage: {
+                input_tokens: number;
+                output_tokens: number;
+            } | null;
+            phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+            inputDigest: string;
+            policyDigest: string;
+            workKind: "unknown" | "verification" | "implementation" | "documentation";
+            effortBand: "unknown" | "small" | "medium" | "large";
+            baselineCandidate: string | null;
+            recommendedCandidate: string | null;
+            shadowCandidate: string | null;
+            abstentionReason: string | null;
+            requestedModel: string | null;
+            resolvedModel: string | null;
+            latencyMs: number;
+            cacheHit: boolean;
+            judgments?: Record<string, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }> | undefined;
+            capability?: string | undefined;
+            suggestedPrerequisite?: string | undefined;
+            ranking?: string[] | undefined;
+            providerFailure?: {
+                kind: "timeout";
+            } | {
+                status: number;
+                kind: "http_error";
+            } | {
+                kind: "invalid";
+            } | {
+                kind: "unknown";
+            } | undefined;
+        };
+    }[];
+    sourceDigest: string;
+    generation: number;
+    requiresLeadReview: true;
+}, {
+    id: string;
+    trackId: string;
+    tasks: {
+        taskId: string;
+        specRevision: number;
+        missingFields: string[];
+        assessment: {
+            confidence: number | null;
+            source: "deterministic" | "jev_shadow" | "jev_recommendation" | "fallback";
+            usage: {
+                input_tokens: number;
+                output_tokens: number;
+            } | null;
+            phase: "verify_existing_claim" | "needs_specification" | "awaiting_dependency_artifacts" | "ready_for_lead";
+            inputDigest: string;
+            policyDigest: string;
+            workKind: "unknown" | "verification" | "implementation" | "documentation";
+            baselineCandidate: string | null;
+            recommendedCandidate: string | null;
+            shadowCandidate: string | null;
+            abstentionReason: string | null;
+            requestedModel: string | null;
+            resolvedModel: string | null;
+            latencyMs: number;
+            cacheHit: boolean;
+            effortBand?: "unknown" | "small" | "medium" | "large" | undefined;
+            judgments?: Record<string, {
+                type: "choice";
+                confidence: number;
+                choice: string;
+                probabilities: Record<string, number>;
+            }> | undefined;
+            capability?: string | undefined;
+            suggestedPrerequisite?: string | undefined;
+            ranking?: string[] | undefined;
+            providerFailure?: {
+                kind: "timeout";
+            } | {
+                status: number;
+                kind: "http_error";
+            } | {
+                kind: "invalid";
+            } | {
+                kind: "unknown";
+            } | undefined;
+        };
+    }[];
+    sourceDigest: string;
+    generation: number;
+    requiresLeadReview: true;
+}>;
+export type TrackingRoutingCandidate = z.infer<typeof TrackingRoutingCandidateSchema>;
+export type TrackingRoutingAssessment = z.infer<typeof TrackingRoutingAssessmentSchema>;
+export type TrackingPlanningDraft = z.infer<typeof TrackingPlanningDraftSchema>;