@exaudeus/workrail 3.75.0 → 3.77.0

package/dist/coordinators/pipeline-run-context.d.ts

@@ -0,0 +1,1811 @@
+import { z } from 'zod';
+import type { Result } from 'neverthrow';
+import { type DiscoveryHandoffArtifactV1, type ShapingHandoffArtifactV1, type CodingHandoffArtifactV1, type ReviewVerdictArtifactV1 } from '../v2/durable-core/schemas/artifacts/index.js';
+export type PhaseResult<TArtifact> = {
+    readonly kind: 'full';
+    readonly artifact: TArtifact;
+    readonly confidenceBand: 'high' | 'medium' | 'low' | null;
+    readonly recapMarkdown: string | null;
+} | {
+    readonly kind: 'partial';
+    readonly recapMarkdown: string;
+} | {
+    readonly kind: 'fallback';
+    readonly recapMarkdown: string | null;
+};
+export declare const MIN_NOTES_LENGTH_FOR_PHASE_RESULT = 50;
+export declare function buildPhaseResult<TArtifact>(artifact: TArtifact | null, recapMarkdown: string | null): PhaseResult<TArtifact>;
+export interface DiscoveryPhaseRecord {
+    readonly completedAt: string;
+    readonly sessionHandle: string;
+    readonly result: PhaseResult<DiscoveryHandoffArtifactV1>;
+}
+export interface ShapingPhaseRecord {
+    readonly completedAt: string;
+    readonly sessionHandle: string;
+    readonly result: PhaseResult<ShapingHandoffArtifactV1>;
+}
+export interface CodingPhaseRecord {
+    readonly completedAt: string;
+    readonly sessionHandle: string;
+    readonly result: PhaseResult<CodingHandoffArtifactV1>;
+}
+export interface ReviewPhaseRecord {
+    readonly completedAt: string;
+    readonly sessionHandle: string;
+    readonly result: PhaseResult<ReviewVerdictArtifactV1>;
+}
+export type PhaseRecord = {
+    readonly phase: 'discovery';
+    readonly record: DiscoveryPhaseRecord;
+} | {
+    readonly phase: 'shaping';
+    readonly record: ShapingPhaseRecord;
+} | {
+    readonly phase: 'coding';
+    readonly record: CodingPhaseRecord;
+} | {
+    readonly phase: 'review';
+    readonly record: ReviewPhaseRecord;
+};
+export interface PipelineRunContext {
+    readonly runId: string;
+    readonly goal: string;
+    readonly workspace: string;
+    readonly startedAt: string;
+    readonly pipelineMode: 'FULL' | 'IMPLEMENT' | 'REVIEW_ONLY' | 'QUICK_REVIEW';
+    readonly status?: 'in_progress' | 'completed';
+    readonly phases: {
+        readonly discovery?: DiscoveryPhaseRecord;
+        readonly shaping?: ShapingPhaseRecord;
+        readonly coding?: CodingPhaseRecord;
+        readonly review?: ReviewPhaseRecord;
+    };
+}
+export declare const DiscoveryPhaseRecordSchema: z.ZodObject<{
+    completedAt: z.ZodString;
+    sessionHandle: z.ZodString;
+    result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"full">;
+        artifact: z.ZodObject<{
+            kind: z.ZodLiteral<"wr.discovery_handoff">;
+            version: z.ZodLiteral<1>;
+            selectedDirection: z.ZodString;
+            designDocPath: z.ZodString;
+            confidenceBand: z.ZodEnum<["high", "medium", "low"]>;
+            keyInvariants: z.ZodArray<z.ZodString, "many">;
+            rejectedDirections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                direction: z.ZodString;
+                reason: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                reason: string;
+                direction: string;
+            }, {
+                reason: string;
+                direction: string;
+            }>, "many">>;
+            implementationConstraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            keyCodebaseLocations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                path: z.ZodString;
+                relevance: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                relevance: string;
+            }, {
+                path: string;
+                relevance: string;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "wr.discovery_handoff";
+            version: 1;
+            selectedDirection: string;
+            designDocPath: string;
+            confidenceBand: "low" | "high" | "medium";
+            keyInvariants: string[];
+            rejectedDirections?: {
+                reason: string;
+                direction: string;
+            }[] | undefined;
+            implementationConstraints?: string[] | undefined;
+            keyCodebaseLocations?: {
+                path: string;
+                relevance: string;
+            }[] | undefined;
+        }, {
+            kind: "wr.discovery_handoff";
+            version: 1;
+            selectedDirection: string;
+            designDocPath: string;
+            confidenceBand: "low" | "high" | "medium";
+            keyInvariants: string[];
+            rejectedDirections?: {
+                reason: string;
+                direction: string;
+            }[] | undefined;
+            implementationConstraints?: string[] | undefined;
+            keyCodebaseLocations?: {
+                path: string;
+                relevance: string;
+            }[] | undefined;
+        }>;
+        confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "full";
+        artifact: {
+            kind: "wr.discovery_handoff";
+            version: 1;
+            selectedDirection: string;
+            designDocPath: string;
+            confidenceBand: "low" | "high" | "medium";
+            keyInvariants: string[];
+            rejectedDirections?: {
+                reason: string;
+                direction: string;
+            }[] | undefined;
+            implementationConstraints?: string[] | undefined;
+            keyCodebaseLocations?: {
+                path: string;
+                relevance: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }, {
+        kind: "full";
+        artifact: {
+            kind: "wr.discovery_handoff";
+            version: 1;
+            selectedDirection: string;
+            designDocPath: string;
+            confidenceBand: "low" | "high" | "medium";
+            keyInvariants: string[];
+            rejectedDirections?: {
+                reason: string;
+                direction: string;
+            }[] | undefined;
+            implementationConstraints?: string[] | undefined;
+            keyCodebaseLocations?: {
+                path: string;
+                relevance: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"partial">;
+        recapMarkdown: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "partial";
+        recapMarkdown: string;
+    }, {
+        kind: "partial";
+        recapMarkdown: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"fallback">;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.discovery_handoff";
+            version: 1;
+            selectedDirection: string;
+            designDocPath: string;
+            confidenceBand: "low" | "high" | "medium";
+            keyInvariants: string[];
+            rejectedDirections?: {
+                reason: string;
+                direction: string;
+            }[] | undefined;
+            implementationConstraints?: string[] | undefined;
+            keyCodebaseLocations?: {
+                path: string;
+                relevance: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.discovery_handoff";
+            version: 1;
+            selectedDirection: string;
+            designDocPath: string;
+            confidenceBand: "low" | "high" | "medium";
+            keyInvariants: string[];
+            rejectedDirections?: {
+                reason: string;
+                direction: string;
+            }[] | undefined;
+            implementationConstraints?: string[] | undefined;
+            keyCodebaseLocations?: {
+                path: string;
+                relevance: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}>;
+export declare const ShapingPhaseRecordSchema: z.ZodObject<{
+    completedAt: z.ZodString;
+    sessionHandle: z.ZodString;
+    result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"full">;
+        artifact: z.ZodObject<{
+            kind: z.ZodLiteral<"wr.shaping_handoff">;
+            version: z.ZodLiteral<1>;
+            pitchPath: z.ZodString;
+            selectedShape: z.ZodString;
+            appetite: z.ZodString;
+            keyConstraints: z.ZodArray<z.ZodString, "many">;
+            rabbitHoles: z.ZodArray<z.ZodString, "many">;
+            outOfScope: z.ZodArray<z.ZodString, "many">;
+            validationChecklist: z.ZodArray<z.ZodString, "many">;
+        }, "strict", z.ZodTypeAny, {
+            kind: "wr.shaping_handoff";
+            version: 1;
+            pitchPath: string;
+            selectedShape: string;
+            appetite: string;
+            keyConstraints: string[];
+            rabbitHoles: string[];
+            outOfScope: string[];
+            validationChecklist: string[];
+        }, {
+            kind: "wr.shaping_handoff";
+            version: 1;
+            pitchPath: string;
+            selectedShape: string;
+            appetite: string;
+            keyConstraints: string[];
+            rabbitHoles: string[];
+            outOfScope: string[];
+            validationChecklist: string[];
+        }>;
+        confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "full";
+        artifact: {
+            kind: "wr.shaping_handoff";
+            version: 1;
+            pitchPath: string;
+            selectedShape: string;
+            appetite: string;
+            keyConstraints: string[];
+            rabbitHoles: string[];
+            outOfScope: string[];
+            validationChecklist: string[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }, {
+        kind: "full";
+        artifact: {
+            kind: "wr.shaping_handoff";
+            version: 1;
+            pitchPath: string;
+            selectedShape: string;
+            appetite: string;
+            keyConstraints: string[];
+            rabbitHoles: string[];
+            outOfScope: string[];
+            validationChecklist: string[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"partial">;
+        recapMarkdown: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "partial";
+        recapMarkdown: string;
+    }, {
+        kind: "partial";
+        recapMarkdown: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"fallback">;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.shaping_handoff";
+            version: 1;
+            pitchPath: string;
+            selectedShape: string;
+            appetite: string;
+            keyConstraints: string[];
+            rabbitHoles: string[];
+            outOfScope: string[];
+            validationChecklist: string[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.shaping_handoff";
+            version: 1;
+            pitchPath: string;
+            selectedShape: string;
+            appetite: string;
+            keyConstraints: string[];
+            rabbitHoles: string[];
+            outOfScope: string[];
+            validationChecklist: string[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}>;
+export declare const CodingPhaseRecordSchema: z.ZodObject<{
+    completedAt: z.ZodString;
+    sessionHandle: z.ZodString;
+    result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"full">;
+        artifact: z.ZodObject<{
+            kind: z.ZodLiteral<"wr.coding_handoff">;
+            version: z.ZodLiteral<1>;
+            branchName: z.ZodString;
+            keyDecisions: z.ZodArray<z.ZodString, "many">;
+            knownLimitations: z.ZodArray<z.ZodString, "many">;
+            testsAdded: z.ZodArray<z.ZodString, "many">;
+            filesChanged: z.ZodArray<z.ZodString, "many">;
+            correctedAssumptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                assumed: z.ZodString;
+                actual: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                assumed: string;
+                actual: string;
+            }, {
+                assumed: string;
+                actual: string;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            kind: "wr.coding_handoff";
+            version: 1;
+            branchName: string;
+            keyDecisions: string[];
+            knownLimitations: string[];
+            testsAdded: string[];
+            filesChanged: string[];
+            correctedAssumptions?: {
+                assumed: string;
+                actual: string;
+            }[] | undefined;
+        }, {
+            kind: "wr.coding_handoff";
+            version: 1;
+            branchName: string;
+            keyDecisions: string[];
+            knownLimitations: string[];
+            testsAdded: string[];
+            filesChanged: string[];
+            correctedAssumptions?: {
+                assumed: string;
+                actual: string;
+            }[] | undefined;
+        }>;
+        confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "full";
+        artifact: {
+            kind: "wr.coding_handoff";
+            version: 1;
+            branchName: string;
+            keyDecisions: string[];
+            knownLimitations: string[];
+            testsAdded: string[];
+            filesChanged: string[];
+            correctedAssumptions?: {
+                assumed: string;
+                actual: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }, {
+        kind: "full";
+        artifact: {
+            kind: "wr.coding_handoff";
+            version: 1;
+            branchName: string;
+            keyDecisions: string[];
+            knownLimitations: string[];
+            testsAdded: string[];
+            filesChanged: string[];
+            correctedAssumptions?: {
+                assumed: string;
+                actual: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"partial">;
+        recapMarkdown: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "partial";
+        recapMarkdown: string;
+    }, {
+        kind: "partial";
+        recapMarkdown: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"fallback">;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.coding_handoff";
+            version: 1;
+            branchName: string;
+            keyDecisions: string[];
+            knownLimitations: string[];
+            testsAdded: string[];
+            filesChanged: string[];
+            correctedAssumptions?: {
+                assumed: string;
+                actual: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.coding_handoff";
+            version: 1;
+            branchName: string;
+            keyDecisions: string[];
+            knownLimitations: string[];
+            testsAdded: string[];
+            filesChanged: string[];
+            correctedAssumptions?: {
+                assumed: string;
+                actual: string;
+            }[] | undefined;
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}>;
+export declare const ReviewPhaseRecordSchema: z.ZodObject<{
+    completedAt: z.ZodString;
+    sessionHandle: z.ZodString;
+    result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"full">;
+        artifact: z.ZodObject<{
+            kind: z.ZodLiteral<"wr.review_verdict">;
+            verdict: z.ZodEnum<["clean", "minor", "blocking"]>;
+            confidence: z.ZodEnum<["high", "medium", "low"]>;
+            findings: z.ZodArray<z.ZodObject<{
+                severity: z.ZodEnum<["critical", "major", "minor", "nit"]>;
+                summary: z.ZodString;
+                findingCategory: z.ZodOptional<z.ZodEnum<["correctness", "security", "architecture", "ux", "performance", "testing", "style"]>>;
+            }, "strict", z.ZodTypeAny, {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }, {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }>, "many">;
+            summary: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "wr.review_verdict";
+            summary: string;
+            confidence: "low" | "high" | "medium";
+            verdict: "clean" | "minor" | "blocking";
+            findings: {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }[];
+        }, {
+            kind: "wr.review_verdict";
+            summary: string;
+            confidence: "low" | "high" | "medium";
+            verdict: "clean" | "minor" | "blocking";
+            findings: {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }[];
+        }>;
+        confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "full";
+        artifact: {
+            kind: "wr.review_verdict";
+            summary: string;
+            confidence: "low" | "high" | "medium";
+            verdict: "clean" | "minor" | "blocking";
+            findings: {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }, {
+        kind: "full";
+        artifact: {
+            kind: "wr.review_verdict";
+            summary: string;
+            confidence: "low" | "high" | "medium";
+            verdict: "clean" | "minor" | "blocking";
+            findings: {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"partial">;
+        recapMarkdown: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "partial";
+        recapMarkdown: string;
+    }, {
+        kind: "partial";
+        recapMarkdown: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"fallback">;
+        recapMarkdown: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }, {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.review_verdict";
+            summary: string;
+            confidence: "low" | "high" | "medium";
+            verdict: "clean" | "minor" | "blocking";
+            findings: {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}, {
+    result: {
+        kind: "full";
+        artifact: {
+            kind: "wr.review_verdict";
+            summary: string;
+            confidence: "low" | "high" | "medium";
+            verdict: "clean" | "minor" | "blocking";
+            findings: {
+                severity: "critical" | "minor" | "major" | "nit";
+                summary: string;
+                findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+            }[];
+        };
+        confidenceBand: "low" | "high" | "medium" | null;
+        recapMarkdown: string | null;
+    } | {
+        kind: "partial";
+        recapMarkdown: string;
+    } | {
+        kind: "fallback";
+        recapMarkdown: string | null;
+    };
+    completedAt: string;
+    sessionHandle: string;
+}>;
+export declare const PipelineRunContextSchema: z.ZodObject<{
+    runId: z.ZodString;
+    goal: z.ZodString;
+    workspace: z.ZodString;
+    startedAt: z.ZodString;
+    pipelineMode: z.ZodEnum<["FULL", "IMPLEMENT", "REVIEW_ONLY", "QUICK_REVIEW"]>;
+    status: z.ZodOptional<z.ZodEnum<["in_progress", "completed"]>>;
+    phases: z.ZodObject<{
+        discovery: z.ZodOptional<z.ZodObject<{
+            completedAt: z.ZodString;
+            sessionHandle: z.ZodString;
+            result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"full">;
+                artifact: z.ZodObject<{
+                    kind: z.ZodLiteral<"wr.discovery_handoff">;
+                    version: z.ZodLiteral<1>;
+                    selectedDirection: z.ZodString;
+                    designDocPath: z.ZodString;
+                    confidenceBand: z.ZodEnum<["high", "medium", "low"]>;
+                    keyInvariants: z.ZodArray<z.ZodString, "many">;
+                    rejectedDirections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        direction: z.ZodString;
+                        reason: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        reason: string;
+                        direction: string;
+                    }, {
+                        reason: string;
+                        direction: string;
+                    }>, "many">>;
+                    implementationConstraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                    keyCodebaseLocations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        path: z.ZodString;
+                        relevance: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        path: string;
+                        relevance: string;
+                    }, {
+                        path: string;
+                        relevance: string;
+                    }>, "many">>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                }, {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                }>;
+                confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"partial">;
+                recapMarkdown: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "partial";
+                recapMarkdown: string;
+            }, {
+                kind: "partial";
+                recapMarkdown: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"fallback">;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }>>;
+        shaping: z.ZodOptional<z.ZodObject<{
+            completedAt: z.ZodString;
+            sessionHandle: z.ZodString;
+            result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"full">;
+                artifact: z.ZodObject<{
+                    kind: z.ZodLiteral<"wr.shaping_handoff">;
+                    version: z.ZodLiteral<1>;
+                    pitchPath: z.ZodString;
+                    selectedShape: z.ZodString;
+                    appetite: z.ZodString;
+                    keyConstraints: z.ZodArray<z.ZodString, "many">;
+                    rabbitHoles: z.ZodArray<z.ZodString, "many">;
+                    outOfScope: z.ZodArray<z.ZodString, "many">;
+                    validationChecklist: z.ZodArray<z.ZodString, "many">;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                }, {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                }>;
+                confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"partial">;
+                recapMarkdown: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "partial";
+                recapMarkdown: string;
+            }, {
+                kind: "partial";
+                recapMarkdown: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"fallback">;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }>>;
+        coding: z.ZodOptional<z.ZodObject<{
+            completedAt: z.ZodString;
+            sessionHandle: z.ZodString;
+            result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"full">;
+                artifact: z.ZodObject<{
+                    kind: z.ZodLiteral<"wr.coding_handoff">;
+                    version: z.ZodLiteral<1>;
+                    branchName: z.ZodString;
+                    keyDecisions: z.ZodArray<z.ZodString, "many">;
+                    knownLimitations: z.ZodArray<z.ZodString, "many">;
+                    testsAdded: z.ZodArray<z.ZodString, "many">;
+                    filesChanged: z.ZodArray<z.ZodString, "many">;
+                    correctedAssumptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        assumed: z.ZodString;
+                        actual: z.ZodString;
+                    }, "strip", z.ZodTypeAny, {
+                        assumed: string;
+                        actual: string;
+                    }, {
+                        assumed: string;
+                        actual: string;
+                    }>, "many">>;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                }, {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                }>;
+                confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"partial">;
+                recapMarkdown: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "partial";
+                recapMarkdown: string;
+            }, {
+                kind: "partial";
+                recapMarkdown: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"fallback">;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }>>;
+        review: z.ZodOptional<z.ZodObject<{
+            completedAt: z.ZodString;
+            sessionHandle: z.ZodString;
+            result: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"full">;
+                artifact: z.ZodObject<{
+                    kind: z.ZodLiteral<"wr.review_verdict">;
+                    verdict: z.ZodEnum<["clean", "minor", "blocking"]>;
+                    confidence: z.ZodEnum<["high", "medium", "low"]>;
+                    findings: z.ZodArray<z.ZodObject<{
+                        severity: z.ZodEnum<["critical", "major", "minor", "nit"]>;
+                        summary: z.ZodString;
+                        findingCategory: z.ZodOptional<z.ZodEnum<["correctness", "security", "architecture", "ux", "performance", "testing", "style"]>>;
+                    }, "strict", z.ZodTypeAny, {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }, {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }>, "many">;
+                    summary: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                }, {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                }>;
+                confidenceBand: z.ZodNullable<z.ZodEnum<["high", "medium", "low"]>>;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }, {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"partial">;
+                recapMarkdown: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "partial";
+                recapMarkdown: string;
+            }, {
+                kind: "partial";
+                recapMarkdown: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"fallback">;
+                recapMarkdown: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }, {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }, {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        coding?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        review?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        discovery?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        shaping?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+    }, {
+        coding?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        review?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        discovery?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        shaping?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    runId: string;
+    goal: string;
+    workspace: string;
+    startedAt: string;
+    pipelineMode: "QUICK_REVIEW" | "REVIEW_ONLY" | "IMPLEMENT" | "FULL";
+    phases: {
+        coding?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        review?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        discovery?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        shaping?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+    };
+    status?: "completed" | "in_progress" | undefined;
+}, {
+    runId: string;
+    goal: string;
+    workspace: string;
+    startedAt: string;
+    pipelineMode: "QUICK_REVIEW" | "REVIEW_ONLY" | "IMPLEMENT" | "FULL";
+    phases: {
+        coding?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.coding_handoff";
+                    version: 1;
+                    branchName: string;
+                    keyDecisions: string[];
+                    knownLimitations: string[];
+                    testsAdded: string[];
+                    filesChanged: string[];
+                    correctedAssumptions?: {
+                        assumed: string;
+                        actual: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        review?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.review_verdict";
+                    summary: string;
+                    confidence: "low" | "high" | "medium";
+                    verdict: "clean" | "minor" | "blocking";
+                    findings: {
+                        severity: "critical" | "minor" | "major" | "nit";
+                        summary: string;
+                        findingCategory?: "correctness" | "security" | "architecture" | "ux" | "performance" | "testing" | "style" | undefined;
+                    }[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        discovery?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.discovery_handoff";
+                    version: 1;
+                    selectedDirection: string;
+                    designDocPath: string;
+                    confidenceBand: "low" | "high" | "medium";
+                    keyInvariants: string[];
+                    rejectedDirections?: {
+                        reason: string;
+                        direction: string;
+                    }[] | undefined;
+                    implementationConstraints?: string[] | undefined;
+                    keyCodebaseLocations?: {
+                        path: string;
+                        relevance: string;
+                    }[] | undefined;
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+        shaping?: {
+            result: {
+                kind: "full";
+                artifact: {
+                    kind: "wr.shaping_handoff";
+                    version: 1;
+                    pitchPath: string;
+                    selectedShape: string;
+                    appetite: string;
+                    keyConstraints: string[];
+                    rabbitHoles: string[];
+                    outOfScope: string[];
+                    validationChecklist: string[];
+                };
+                confidenceBand: "low" | "high" | "medium" | null;
+                recapMarkdown: string | null;
+            } | {
+                kind: "partial";
+                recapMarkdown: string;
+            } | {
+                kind: "fallback";
+                recapMarkdown: string | null;
+            };
+            completedAt: string;
+            sessionHandle: string;
+        } | undefined;
+    };
+    status?: "completed" | "in_progress" | undefined;
+}>;
+export declare function parsePipelineRunContext(raw: unknown): Result<PipelineRunContext, string>;