@agent-plan/core 0.2.26 → 0.2.27

package/dist/schema.d.ts

@@ -752,7 +752,7 @@ export declare const ProjectSchema: z.ZodObject<{
 export declare const SubtaskStatusSchema: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
 export declare const TaskStatusSchema: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
 export declare const PhaseStatusSchema: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-export declare const RequirementStatusSchema: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+export declare const MacroTaskStatusSchema: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
 export declare const FeatureStatusSchema: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
 export declare const SubtaskSchema: z.ZodObject<{
     id: z.ZodString;
@@ -1047,6 +1047,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         createdAt: string;
         sessionId: string;
     }>, "many">>;
+    /** Session currently owning this in-progress task ("" when not in-progress or legacy). Enables concurrent starts across agent sessions. */
+    activeOwnerSession: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     number: number;
     status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -1119,6 +1121,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[];
     startedAt: string;
     completedAt: string;
+    activeOwnerSession: string;
     descriptionRef?: string | undefined;
 }, {
     status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -1193,6 +1196,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
+    activeOwnerSession?: string | undefined;
 }>, {
     checklist: {
         id: string;
@@ -1265,6 +1269,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[];
     startedAt: string;
     completedAt: string;
+    activeOwnerSession: string;
     descriptionRef?: string | undefined;
 }, {
     status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -1339,6 +1344,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
+    activeOwnerSession?: string | undefined;
 }>;
 export declare const HandoffHistoryEntrySchema: z.ZodObject<{
     /** Relative path under .planner/.local/handoff-archive/ (e.g. <phaseId>-<ISO>.md). */
@@ -1384,6 +1390,77 @@ export declare const HandoffSupportingDocumentSchema: z.ZodObject<{
     contentHash: string;
     contentLength: number;
 }>;
+export declare const HandoffColdStartInventoryEntrySchema: z.ZodObject<{
+    category: z.ZodString;
+    items: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    notApplicableReason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    category: string;
+    items: string[];
+    notApplicableReason?: string | undefined;
+}, {
+    category: string;
+    items?: string[] | undefined;
+    notApplicableReason?: string | undefined;
+}>;
+export declare const HandoffColdStartSourceReviewSchema: z.ZodObject<{
+    source: z.ZodString;
+    detail: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    detail: string;
+    source: string;
+}, {
+    detail: string;
+    source: string;
+}>;
+export declare const HandoffColdStartInventorySchema: z.ZodObject<{
+    version: z.ZodNumber;
+    sourceReviews: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        detail: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        detail: string;
+        source: string;
+    }, {
+        detail: string;
+        source: string;
+    }>, "many">;
+    entries: z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        items: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        notApplicableReason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        category: string;
+        items: string[];
+        notApplicableReason?: string | undefined;
+    }, {
+        category: string;
+        items?: string[] | undefined;
+        notApplicableReason?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        category: string;
+        items: string[];
+        notApplicableReason?: string | undefined;
+    }[];
+    version: number;
+    sourceReviews: {
+        detail: string;
+        source: string;
+    }[];
+}, {
+    entries: {
+        category: string;
+        items?: string[] | undefined;
+        notApplicableReason?: string | undefined;
+    }[];
+    version: number;
+    sourceReviews: {
+        detail: string;
+        source: string;
+    }[];
+}>;
 export declare const HandoffCompletenessAuditSchema: z.ZodObject<{
     version: z.ZodNumber;
     entries: z.ZodArray<z.ZodObject<{
@@ -1399,6 +1476,54 @@ export declare const HandoffCompletenessAuditSchema: z.ZodObject<{
         category: string;
         detail: string;
     }>, "many">;
+    coldStartInventory: z.ZodOptional<z.ZodObject<{
+        version: z.ZodNumber;
+        sourceReviews: z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            detail: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            detail: string;
+            source: string;
+        }, {
+            detail: string;
+            source: string;
+        }>, "many">;
+        entries: z.ZodArray<z.ZodObject<{
+            category: z.ZodString;
+            items: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            notApplicableReason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            category: string;
+            items: string[];
+            notApplicableReason?: string | undefined;
+        }, {
+            category: string;
+            items?: string[] | undefined;
+            notApplicableReason?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        entries: {
+            category: string;
+            items: string[];
+            notApplicableReason?: string | undefined;
+        }[];
+        version: number;
+        sourceReviews: {
+            detail: string;
+            source: string;
+        }[];
+    }, {
+        entries: {
+            category: string;
+            items?: string[] | undefined;
+            notApplicableReason?: string | undefined;
+        }[];
+        version: number;
+        sourceReviews: {
+            detail: string;
+            source: string;
+        }[];
+    }>>;
     supportingDocuments: z.ZodDefault<z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         description: z.ZodString;
@@ -1417,7 +1542,20 @@ export declare const HandoffCompletenessAuditSchema: z.ZodObject<{
     }>, "many">>;
     contentHash: z.ZodString;
     contentLength: z.ZodNumber;
+    /** Structural validation timestamp written with the handoff candidate. */
     verifiedAt: z.ZodString;
+    /** Set only after a separate persisted read-back and source reconciliation. */
+    resumeReadyAt: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
+    readBackSourceReviews: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        detail: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        detail: string;
+        source: string;
+    }, {
+        detail: string;
+        source: string;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     entries: {
         status: "captured" | "not-applicable";
@@ -1434,6 +1572,23 @@ export declare const HandoffCompletenessAuditSchema: z.ZodObject<{
         contentLength: number;
     }[];
     verifiedAt: string;
+    resumeReadyAt: string;
+    readBackSourceReviews: {
+        detail: string;
+        source: string;
+    }[];
+    coldStartInventory?: {
+        entries: {
+            category: string;
+            items: string[];
+            notApplicableReason?: string | undefined;
+        }[];
+        version: number;
+        sourceReviews: {
+            detail: string;
+            source: string;
+        }[];
+    } | undefined;
 }, {
     entries: {
         status: "captured" | "not-applicable";
@@ -1444,12 +1599,29 @@ export declare const HandoffCompletenessAuditSchema: z.ZodObject<{
     contentLength: number;
     version: number;
     verifiedAt: string;
+    coldStartInventory?: {
+        entries: {
+            category: string;
+            items?: string[] | undefined;
+            notApplicableReason?: string | undefined;
+        }[];
+        version: number;
+        sourceReviews: {
+            detail: string;
+            source: string;
+        }[];
+    } | undefined;
     supportingDocuments?: {
         path: string;
         description: string;
         contentHash: string;
         contentLength: number;
     }[] | undefined;
+    resumeReadyAt?: string | undefined;
+    readBackSourceReviews?: {
+        detail: string;
+        source: string;
+    }[] | undefined;
 }>;
 export declare const PhaseSchema: z.ZodObject<{
     id: z.ZodString;
@@ -1690,6 +1862,8 @@ export declare const PhaseSchema: z.ZodObject<{
             createdAt: string;
             sessionId: string;
         }>, "many">>;
+        /** Session currently owning this in-progress task ("" when not in-progress or legacy). Enables concurrent starts across agent sessions. */
+        activeOwnerSession: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         number: number;
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -1762,6 +1936,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
+        activeOwnerSession: string;
         descriptionRef?: string | undefined;
     }, {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -1836,6 +2011,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
+        activeOwnerSession?: string | undefined;
     }>, {
         checklist: {
             id: string;
@@ -1908,6 +2084,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
+        activeOwnerSession: string;
         descriptionRef?: string | undefined;
     }, {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -1982,6 +2159,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
+        activeOwnerSession?: string | undefined;
     }>, "many">>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -2003,6 +2181,54 @@ export declare const PhaseSchema: z.ZodObject<{
             category: string;
             detail: string;
         }>, "many">;
+        coldStartInventory: z.ZodOptional<z.ZodObject<{
+            version: z.ZodNumber;
+            sourceReviews: z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                detail: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                detail: string;
+                source: string;
+            }, {
+                detail: string;
+                source: string;
+            }>, "many">;
+            entries: z.ZodArray<z.ZodObject<{
+                category: z.ZodString;
+                items: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                notApplicableReason: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                category: string;
+                items: string[];
+                notApplicableReason?: string | undefined;
+            }, {
+                category: string;
+                items?: string[] | undefined;
+                notApplicableReason?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            entries: {
+                category: string;
+                items: string[];
+                notApplicableReason?: string | undefined;
+            }[];
+            version: number;
+            sourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+        }, {
+            entries: {
+                category: string;
+                items?: string[] | undefined;
+                notApplicableReason?: string | undefined;
+            }[];
+            version: number;
+            sourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+        }>>;
         supportingDocuments: z.ZodDefault<z.ZodArray<z.ZodObject<{
             path: z.ZodString;
             description: z.ZodString;
@@ -2021,7 +2247,20 @@ export declare const PhaseSchema: z.ZodObject<{
         }>, "many">>;
         contentHash: z.ZodString;
         contentLength: z.ZodNumber;
+        /** Structural validation timestamp written with the handoff candidate. */
         verifiedAt: z.ZodString;
+        /** Set only after a separate persisted read-back and source reconciliation. */
+        resumeReadyAt: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
+        readBackSourceReviews: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            source: z.ZodString;
+            detail: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            detail: string;
+            source: string;
+        }, {
+            detail: string;
+            source: string;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         entries: {
             status: "captured" | "not-applicable";
@@ -2038,6 +2277,23 @@ export declare const PhaseSchema: z.ZodObject<{
             contentLength: number;
         }[];
         verifiedAt: string;
+        resumeReadyAt: string;
+        readBackSourceReviews: {
+            detail: string;
+            source: string;
+        }[];
+        coldStartInventory?: {
+            entries: {
+                category: string;
+                items: string[];
+                notApplicableReason?: string | undefined;
+            }[];
+            version: number;
+            sourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+        } | undefined;
     }, {
         entries: {
             status: "captured" | "not-applicable";
@@ -2048,12 +2304,29 @@ export declare const PhaseSchema: z.ZodObject<{
         contentLength: number;
         version: number;
         verifiedAt: string;
+        coldStartInventory?: {
+            entries: {
+                category: string;
+                items?: string[] | undefined;
+                notApplicableReason?: string | undefined;
+            }[];
+            version: number;
+            sourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+        } | undefined;
         supportingDocuments?: {
             path: string;
             description: string;
             contentHash: string;
             contentLength: number;
         }[] | undefined;
+        resumeReadyAt?: string | undefined;
+        readBackSourceReviews?: {
+            detail: string;
+            source: string;
+        }[] | undefined;
     }>>>;
     /** When the handoff was last read/acknowledged on recap (ISO). Non-empty means
      *  the agent has seen it; the recap won't re-prompt every turn. Reading is
@@ -2230,6 +2503,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
+        activeOwnerSession: string;
         descriptionRef?: string | undefined;
     }[];
     handoff: string;
@@ -2250,6 +2524,23 @@ export declare const PhaseSchema: z.ZodObject<{
             contentLength: number;
         }[];
         verifiedAt: string;
+        resumeReadyAt: string;
+        readBackSourceReviews: {
+            detail: string;
+            source: string;
+        }[];
+        coldStartInventory?: {
+            entries: {
+                category: string;
+                items: string[];
+                notApplicableReason?: string | undefined;
+            }[];
+            version: number;
+            sourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+        } | undefined;
     } | null;
     handoffReadAt: string;
     handoffHistory: {
@@ -2379,6 +2670,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
+        activeOwnerSession?: string | undefined;
     }[] | undefined;
     handoff?: string | undefined;
     handoffUpdatedAt?: string | undefined;
@@ -2392,12 +2684,29 @@ export declare const PhaseSchema: z.ZodObject<{
         contentLength: number;
         version: number;
         verifiedAt: string;
+        coldStartInventory?: {
+            entries: {
+                category: string;
+                items?: string[] | undefined;
+                notApplicableReason?: string | undefined;
+            }[];
+            version: number;
+            sourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+        } | undefined;
         supportingDocuments?: {
             path: string;
             description: string;
             contentHash: string;
             contentLength: number;
         }[] | undefined;
+        resumeReadyAt?: string | undefined;
+        readBackSourceReviews?: {
+            detail: string;
+            source: string;
+        }[] | undefined;
     } | null | undefined;
     handoffReadAt?: string | undefined;
     handoffHistory?: {
@@ -2836,7 +3145,6 @@ export declare const RequirementSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
-    status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     macroTasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
@@ -2874,7 +3182,6 @@ export declare const RequirementSchema: z.ZodObject<{
         sessionId: string;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
@@ -2894,7 +3201,6 @@ export declare const RequirementSchema: z.ZodObject<{
     }[];
     linkedPhaseIds: string[];
 }, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
@@ -2919,7 +3225,6 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         description: z.ZodDefault<z.ZodString>;
-        status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         macroTasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
@@ -2957,7 +3262,6 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
             sessionId: string;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -2977,7 +3281,6 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         }[];
         linkedPhaseIds: string[];
     }, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -2999,7 +3302,6 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     requirements: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -3021,7 +3323,6 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
     }[];
 }, {
     requirements: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -3786,7 +4087,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
             description: z.ZodDefault<z.ZodString>;
-            status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             macroTasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 title: z.ZodString;
@@ -3824,7 +4124,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 sessionId: string;
             }>, "many">>;
         }, "strip", z.ZodTypeAny, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -3844,7 +4143,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             linkedPhaseIds: string[];
         }, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -3866,7 +4164,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -3888,7 +4185,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[];
     }, {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -4239,6 +4535,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 createdAt: string;
                 sessionId: string;
             }>, "many">>;
+            /** Session currently owning this in-progress task ("" when not in-progress or legacy). Enables concurrent starts across agent sessions. */
+            activeOwnerSession: z.ZodDefault<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             number: number;
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -4311,6 +4609,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
+            activeOwnerSession: string;
             descriptionRef?: string | undefined;
         }, {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -4385,6 +4684,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            activeOwnerSession?: string | undefined;
         }>, {
             checklist: {
                 id: string;
@@ -4457,6 +4757,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
+            activeOwnerSession: string;
             descriptionRef?: string | undefined;
         }, {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
@@ -4531,6 +4832,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            activeOwnerSession?: string | undefined;
         }>, "many">>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
@@ -4552,6 +4854,54 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 category: string;
                 detail: string;
             }>, "many">;
+            coldStartInventory: z.ZodOptional<z.ZodObject<{
+                version: z.ZodNumber;
+                sourceReviews: z.ZodArray<z.ZodObject<{
+                    source: z.ZodString;
+                    detail: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    detail: string;
+                    source: string;
+                }, {
+                    detail: string;
+                    source: string;
+                }>, "many">;
+                entries: z.ZodArray<z.ZodObject<{
+                    category: z.ZodString;
+                    items: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+                    notApplicableReason: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    category: string;
+                    items: string[];
+                    notApplicableReason?: string | undefined;
+                }, {
+                    category: string;
+                    items?: string[] | undefined;
+                    notApplicableReason?: string | undefined;
+                }>, "many">;
+            }, "strip", z.ZodTypeAny, {
+                entries: {
+                    category: string;
+                    items: string[];
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            }, {
+                entries: {
+                    category: string;
+                    items?: string[] | undefined;
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            }>>;
             supportingDocuments: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 path: z.ZodString;
                 description: z.ZodString;
@@ -4570,7 +4920,20 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }>, "many">>;
             contentHash: z.ZodString;
             contentLength: z.ZodNumber;
+            /** Structural validation timestamp written with the handoff candidate. */
             verifiedAt: z.ZodString;
+            /** Set only after a separate persisted read-back and source reconciliation. */
+            resumeReadyAt: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodLiteral<"">]>>;
+            readBackSourceReviews: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                detail: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                detail: string;
+                source: string;
+            }, {
+                detail: string;
+                source: string;
+            }>, "many">>;
         }, "strip", z.ZodTypeAny, {
             entries: {
                 status: "captured" | "not-applicable";
@@ -4587,6 +4950,23 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 contentLength: number;
             }[];
             verifiedAt: string;
+            resumeReadyAt: string;
+            readBackSourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+            coldStartInventory?: {
+                entries: {
+                    category: string;
+                    items: string[];
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            } | undefined;
         }, {
             entries: {
                 status: "captured" | "not-applicable";
@@ -4597,12 +4977,29 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             contentLength: number;
             version: number;
             verifiedAt: string;
+            coldStartInventory?: {
+                entries: {
+                    category: string;
+                    items?: string[] | undefined;
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            } | undefined;
             supportingDocuments?: {
                 path: string;
                 description: string;
                 contentHash: string;
                 contentLength: number;
             }[] | undefined;
+            resumeReadyAt?: string | undefined;
+            readBackSourceReviews?: {
+                detail: string;
+                source: string;
+            }[] | undefined;
         }>>>;
         /** When the handoff was last read/acknowledged on recap (ISO). Non-empty means
          *  the agent has seen it; the recap won't re-prompt every turn. Reading is
@@ -4779,6 +5176,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
+            activeOwnerSession: string;
             descriptionRef?: string | undefined;
         }[];
         handoff: string;
@@ -4799,6 +5197,23 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 contentLength: number;
             }[];
             verifiedAt: string;
+            resumeReadyAt: string;
+            readBackSourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+            coldStartInventory?: {
+                entries: {
+                    category: string;
+                    items: string[];
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            } | undefined;
         } | null;
         handoffReadAt: string;
         handoffHistory: {
@@ -4928,6 +5343,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            activeOwnerSession?: string | undefined;
         }[] | undefined;
         handoff?: string | undefined;
         handoffUpdatedAt?: string | undefined;
@@ -4941,12 +5357,29 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             contentLength: number;
             version: number;
             verifiedAt: string;
+            coldStartInventory?: {
+                entries: {
+                    category: string;
+                    items?: string[] | undefined;
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            } | undefined;
             supportingDocuments?: {
                 path: string;
                 description: string;
                 contentHash: string;
                 contentLength: number;
             }[] | undefined;
+            resumeReadyAt?: string | undefined;
+            readBackSourceReviews?: {
+                detail: string;
+                source: string;
+            }[] | undefined;
         } | null | undefined;
         handoffReadAt?: string | undefined;
         handoffHistory?: {
@@ -5065,7 +5498,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     };
     requirements: {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -5228,6 +5660,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
+            activeOwnerSession: string;
             descriptionRef?: string | undefined;
         }[];
         handoff: string;
@@ -5248,6 +5681,23 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 contentLength: number;
             }[];
             verifiedAt: string;
+            resumeReadyAt: string;
+            readBackSourceReviews: {
+                detail: string;
+                source: string;
+            }[];
+            coldStartInventory?: {
+                entries: {
+                    category: string;
+                    items: string[];
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            } | undefined;
         } | null;
         handoffReadAt: string;
         handoffHistory: {
@@ -5368,7 +5818,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     };
     requirements: {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -5516,6 +5965,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
+            activeOwnerSession?: string | undefined;
         }[] | undefined;
         handoff?: string | undefined;
         handoffUpdatedAt?: string | undefined;
@@ -5529,12 +5979,29 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             contentLength: number;
             version: number;
             verifiedAt: string;
+            coldStartInventory?: {
+                entries: {
+                    category: string;
+                    items?: string[] | undefined;
+                    notApplicableReason?: string | undefined;
+                }[];
+                version: number;
+                sourceReviews: {
+                    detail: string;
+                    source: string;
+                }[];
+            } | undefined;
             supportingDocuments?: {
                 path: string;
                 description: string;
                 contentHash: string;
                 contentLength: number;
             }[] | undefined;
+            resumeReadyAt?: string | undefined;
+            readBackSourceReviews?: {
+                detail: string;
+                source: string;
+            }[] | undefined;
         } | null | undefined;
         handoffReadAt?: string | undefined;
         handoffHistory?: {
@@ -5579,13 +6046,16 @@ export type FeaturesDocument = {
 };
 export type PhaseStatus = z.infer<typeof PhaseStatusSchema>;
 export type TaskStatus = z.infer<typeof TaskStatusSchema>;
-export type RequirementStatus = z.infer<typeof RequirementStatusSchema>;
+export type MacroTaskStatus = z.infer<typeof MacroTaskStatusSchema>;
 export type SubtaskStatus = z.infer<typeof SubtaskStatusSchema>;
 export type Manifest = z.infer<typeof ManifestSchema>;
 export type WorkflowRules = z.infer<typeof WorkflowRulesSchema>;
 export type AcceptedDecision = z.infer<typeof AcceptedDecisionSchema>;
 export type HandoffCompletenessEntry = z.infer<typeof HandoffCompletenessEntrySchema>;
 export type HandoffSupportingDocument = z.infer<typeof HandoffSupportingDocumentSchema>;
+export type HandoffColdStartInventoryEntry = z.infer<typeof HandoffColdStartInventoryEntrySchema>;
+export type HandoffColdStartSourceReview = z.infer<typeof HandoffColdStartSourceReviewSchema>;
+export type HandoffColdStartInventory = z.infer<typeof HandoffColdStartInventorySchema>;
 export type HandoffCompletenessAudit = z.infer<typeof HandoffCompletenessAuditSchema>;
 export type Project = z.infer<typeof ProjectSchema>;
 export type WorkDeviation = z.infer<typeof WorkDeviationSchema>;