@agent-plan/core 0.2.25 → 0.2.27

package/dist/schema.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 export declare const TimestampSchema: z.ZodString;
 export declare const SlugSchema: z.ZodString;
+export declare const DescriptionRefSchema: z.ZodEffects<z.ZodString, string, string>;
 export declare const CodebaseFileSchema: z.ZodObject<{
     path: z.ZodString;
     kind: z.ZodDefault<z.ZodString>;
@@ -169,14 +170,14 @@ export declare const ActivityEntrySchema: z.ZodObject<{
     ref: z.ZodDefault<z.ZodString>;
     summary: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: string;
     at: string;
+    type: string;
     id: string;
     ref: string;
     summary: string;
 }, {
-    type: string;
     at: string;
+    type: string;
     id: string;
     ref?: string | undefined;
     summary?: string | undefined;
@@ -189,30 +190,30 @@ export declare const ActivityLogSchema: z.ZodObject<{
         ref: z.ZodDefault<z.ZodString>;
         summary: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        type: string;
         at: string;
+        type: string;
         id: string;
         ref: string;
         summary: string;
     }, {
-        type: string;
         at: string;
+        type: string;
         id: string;
         ref?: string | undefined;
         summary?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     entries: {
-        type: string;
         at: string;
+        type: string;
         id: string;
         ref: string;
         summary: string;
     }[];
 }, {
     entries?: {
-        type: string;
         at: string;
+        type: string;
         id: string;
         ref?: string | undefined;
         summary?: string | undefined;
@@ -408,10 +409,67 @@ export declare const WorkDeviationSchema: z.ZodObject<{
     resolvedAt?: string | undefined;
     resumedAt?: string | undefined;
 }>;
+export declare const ProjectGuidelinesSchema: z.ZodObject<{
+    content: z.ZodDefault<z.ZodString>;
+    updatedAt: z.ZodDefault<z.ZodString>;
+    sessionInfo: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        sessionId: z.ZodString;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        createdAt: string;
+        sessionId: string;
+    }, {
+        createdAt: string;
+        sessionId: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    updatedAt: string;
+    content: string;
+    sessionInfo: {
+        createdAt: string;
+        sessionId: string;
+    }[];
+}, {
+    updatedAt?: string | undefined;
+    content?: string | undefined;
+    sessionInfo?: {
+        createdAt: string;
+        sessionId: string;
+    }[] | undefined;
+}>;
 export declare const ProjectSchema: z.ZodObject<{
     name: z.ZodString;
     goal: z.ZodDefault<z.ZodString>;
     description: z.ZodDefault<z.ZodString>;
+    descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    projectGuidelines: z.ZodDefault<z.ZodObject<{
+        content: z.ZodDefault<z.ZodString>;
+        updatedAt: z.ZodDefault<z.ZodString>;
+        sessionInfo: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            sessionId: z.ZodString;
+            createdAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            createdAt: string;
+            sessionId: string;
+        }, {
+            createdAt: string;
+            sessionId: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        updatedAt: string;
+        content: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
+    }, {
+        updatedAt?: string | undefined;
+        content?: string | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
+    }>>;
     webPort: z.ZodDefault<z.ZodNumber>;
     scope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     outOfScope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -568,6 +626,14 @@ export declare const ProjectSchema: z.ZodObject<{
     name: string;
     goal: string;
     description: string;
+    projectGuidelines: {
+        updatedAt: string;
+        content: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
+    };
     webPort: number;
     scope: string[];
     outOfScope: string[];
@@ -618,6 +684,7 @@ export declare const ProjectSchema: z.ZodObject<{
         resolvedAt: string;
         resumedAt: string;
     }[];
+    descriptionRef?: string | undefined;
 }, {
     name: string;
     workflowRules: {
@@ -627,6 +694,15 @@ export declare const ProjectSchema: z.ZodObject<{
     };
     goal?: string | undefined;
     description?: string | undefined;
+    descriptionRef?: string | undefined;
+    projectGuidelines?: {
+        updatedAt?: string | undefined;
+        content?: string | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
+    } | undefined;
     webPort?: number | undefined;
     scope?: string[] | undefined;
     outOfScope?: string[] | undefined;
@@ -676,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;
@@ -797,6 +873,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     title: z.ZodString;
     status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     description: z.ZodDefault<z.ZodString>;
+    descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     /** Updated only when this task's description changes; distinct from entity updatedAt. */
     descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
     notes: z.ZodDefault<z.ZodString>;
@@ -970,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";
@@ -978,6 +1057,10 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     createdAt: string;
     title: string;
+    sessionInfo: {
+        createdAt: string;
+        sessionId: string;
+    }[];
     description: string;
     decisions: string[];
     acceptedDecisions: {
@@ -1038,10 +1121,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[];
     startedAt: string;
     completedAt: string;
-    sessionInfo: {
-        createdAt: string;
-        sessionId: string;
-    }[];
+    activeOwnerSession: string;
+    descriptionRef?: string | undefined;
 }, {
     status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
@@ -1052,7 +1133,12 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     shortName: string;
     number?: number | undefined;
     notes?: string | undefined;
+    sessionInfo?: {
+        createdAt: string;
+        sessionId: string;
+    }[] | undefined;
     description?: string | undefined;
+    descriptionRef?: string | undefined;
     decisions?: string[] | undefined;
     acceptedDecisions?: {
         id: string;
@@ -1110,10 +1196,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
-    sessionInfo?: {
-        createdAt: string;
-        sessionId: string;
-    }[] | undefined;
+    activeOwnerSession?: string | undefined;
 }>, {
     checklist: {
         id: string;
@@ -1128,6 +1211,10 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     id: string;
     createdAt: string;
     title: string;
+    sessionInfo: {
+        createdAt: string;
+        sessionId: string;
+    }[];
     description: string;
     decisions: string[];
     acceptedDecisions: {
@@ -1182,10 +1269,8 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[];
     startedAt: string;
     completedAt: string;
-    sessionInfo: {
-        createdAt: string;
-        sessionId: string;
-    }[];
+    activeOwnerSession: string;
+    descriptionRef?: string | undefined;
 }, {
     status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
@@ -1196,7 +1281,12 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     shortName: string;
     number?: number | undefined;
     notes?: string | undefined;
+    sessionInfo?: {
+        createdAt: string;
+        sessionId: string;
+    }[] | undefined;
     description?: string | undefined;
+    descriptionRef?: string | undefined;
     decisions?: string[] | undefined;
     acceptedDecisions?: {
         id: string;
@@ -1254,10 +1344,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
-    sessionInfo?: {
-        createdAt: string;
-        sessionId: string;
-    }[] | undefined;
+    activeOwnerSession?: string | undefined;
 }>;
 export declare const HandoffHistoryEntrySchema: z.ZodObject<{
     /** Relative path under .planner/.local/handoff-archive/ (e.g. <phaseId>-<ISO>.md). */
@@ -1274,6 +1361,268 @@ export declare const HandoffHistoryEntrySchema: z.ZodObject<{
     file?: string | undefined;
     reason?: string | undefined;
 }>;
+export declare const HandoffCompletenessEntrySchema: z.ZodObject<{
+    category: z.ZodString;
+    status: z.ZodEnum<["captured", "not-applicable"]>;
+    detail: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "captured" | "not-applicable";
+    category: string;
+    detail: string;
+}, {
+    status: "captured" | "not-applicable";
+    category: string;
+    detail: string;
+}>;
+export declare const HandoffSupportingDocumentSchema: z.ZodObject<{
+    path: z.ZodString;
+    description: z.ZodString;
+    contentHash: z.ZodString;
+    contentLength: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    description: string;
+    contentHash: string;
+    contentLength: number;
+}, {
+    path: string;
+    description: string;
+    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<{
+        category: z.ZodString;
+        status: z.ZodEnum<["captured", "not-applicable"]>;
+        detail: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "captured" | "not-applicable";
+        category: string;
+        detail: string;
+    }, {
+        status: "captured" | "not-applicable";
+        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;
+        contentHash: z.ZodString;
+        contentLength: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        description: string;
+        contentHash: string;
+        contentLength: number;
+    }, {
+        path: string;
+        description: string;
+        contentHash: string;
+        contentLength: number;
+    }>, "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";
+        category: string;
+        detail: string;
+    }[];
+    contentHash: string;
+    contentLength: number;
+    version: number;
+    supportingDocuments: {
+        path: string;
+        description: string;
+        contentHash: string;
+        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";
+        category: string;
+        detail: string;
+    }[];
+    contentHash: string;
+    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;
     /** MUST be a feature UUID (not a ref like "F005"). Validated at the schema
@@ -1291,6 +1640,7 @@ export declare const PhaseSchema: z.ZodObject<{
     contextReadyReason: z.ZodDefault<z.ZodString>;
     summary: z.ZodDefault<z.ZodString>;
     description: z.ZodDefault<z.ZodString>;
+    descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     /** Updated only when this phase's description changes; distinct from entity updatedAt. */
     descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
     notes: z.ZodDefault<z.ZodString>;
@@ -1338,6 +1688,7 @@ export declare const PhaseSchema: z.ZodObject<{
         title: z.ZodString;
         status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         description: z.ZodDefault<z.ZodString>;
+        descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         /** Updated only when this task's description changes; distinct from entity updatedAt. */
         descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
         notes: z.ZodDefault<z.ZodString>;
@@ -1511,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";
@@ -1519,6 +1872,10 @@ export declare const PhaseSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         title: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
         description: string;
         decisions: string[];
         acceptedDecisions: {
@@ -1579,10 +1936,8 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
+        activeOwnerSession: string;
+        descriptionRef?: string | undefined;
     }, {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
@@ -1593,7 +1948,12 @@ export declare const PhaseSchema: z.ZodObject<{
         shortName: string;
         number?: number | undefined;
         notes?: string | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
         decisions?: string[] | undefined;
         acceptedDecisions?: {
             id: string;
@@ -1651,10 +2011,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
+        activeOwnerSession?: string | undefined;
     }>, {
         checklist: {
             id: string;
@@ -1669,6 +2026,10 @@ export declare const PhaseSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         title: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
         description: string;
         decisions: string[];
         acceptedDecisions: {
@@ -1723,10 +2084,8 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
+        activeOwnerSession: string;
+        descriptionRef?: string | undefined;
     }, {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
@@ -1737,7 +2096,12 @@ export declare const PhaseSchema: z.ZodObject<{
         shortName: string;
         number?: number | undefined;
         notes?: string | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
         decisions?: string[] | undefined;
         acceptedDecisions?: {
             id: string;
@@ -1795,15 +2159,175 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
+        activeOwnerSession?: string | undefined;
     }>, "many">>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     handoff: z.ZodDefault<z.ZodString>;
     handoffUpdatedAt: z.ZodDefault<z.ZodString>;
+    /** Durable proof that the active handoff passed the versioned completeness and read-back contract. */
+    handoffAudit: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        version: z.ZodNumber;
+        entries: z.ZodArray<z.ZodObject<{
+            category: z.ZodString;
+            status: z.ZodEnum<["captured", "not-applicable"]>;
+            detail: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "captured" | "not-applicable";
+            category: string;
+            detail: string;
+        }, {
+            status: "captured" | "not-applicable";
+            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;
+            contentHash: z.ZodString;
+            contentLength: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            description: string;
+            contentHash: string;
+            contentLength: number;
+        }, {
+            path: string;
+            description: string;
+            contentHash: string;
+            contentLength: number;
+        }>, "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";
+            category: string;
+            detail: string;
+        }[];
+        contentHash: string;
+        contentLength: number;
+        version: number;
+        supportingDocuments: {
+            path: string;
+            description: string;
+            contentHash: string;
+            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";
+            category: string;
+            detail: string;
+        }[];
+        contentHash: string;
+        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
      *  non-mutating: content remains until every task is done/canceled, a later
@@ -1871,6 +2395,10 @@ export declare const PhaseSchema: z.ZodObject<{
     summary: string;
     createdAt: string;
     title: string;
+    sessionInfo: {
+        createdAt: string;
+        sessionId: string;
+    }[];
     description: string;
     decisions: string[];
     acceptedDecisions: {
@@ -1893,10 +2421,6 @@ export declare const PhaseSchema: z.ZodObject<{
         toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
     }[];
     dependsOn: string[];
-    sessionInfo: {
-        createdAt: string;
-        sessionId: string;
-    }[];
     slug: string;
     discussedAt: string;
     contextReady: boolean;
@@ -1921,7 +2445,11 @@ export declare const PhaseSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         title: string;
-        description: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
+        description: string;
         decisions: string[];
         acceptedDecisions: {
             id: string;
@@ -1975,19 +2503,52 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
+        activeOwnerSession: string;
+        descriptionRef?: string | undefined;
     }[];
     handoff: string;
     handoffUpdatedAt: string;
+    handoffAudit: {
+        entries: {
+            status: "captured" | "not-applicable";
+            category: string;
+            detail: string;
+        }[];
+        contentHash: string;
+        contentLength: number;
+        version: number;
+        supportingDocuments: {
+            path: string;
+            description: string;
+            contentHash: string;
+            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: {
         file: string;
         reason: string;
         clearedAt: string;
     }[];
+    descriptionRef?: string | undefined;
     featureId?: string | undefined;
 }, {
     number: number;
@@ -1999,7 +2560,12 @@ export declare const PhaseSchema: z.ZodObject<{
     dependencies?: string[] | undefined;
     notes?: string | undefined;
     summary?: string | undefined;
+    sessionInfo?: {
+        createdAt: string;
+        sessionId: string;
+    }[] | undefined;
     description?: string | undefined;
+    descriptionRef?: string | undefined;
     decisions?: string[] | undefined;
     acceptedDecisions?: {
         id: string;
@@ -2021,10 +2587,6 @@ export declare const PhaseSchema: z.ZodObject<{
         description?: string | undefined;
     }[] | undefined;
     dependsOn?: string[] | undefined;
-    sessionInfo?: {
-        createdAt: string;
-        sessionId: string;
-    }[] | undefined;
     featureId?: string | undefined;
     discussedAt?: string | undefined;
     contextReady?: boolean | undefined;
@@ -2045,7 +2607,12 @@ export declare const PhaseSchema: z.ZodObject<{
         shortName: string;
         number?: number | undefined;
         notes?: string | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
         decisions?: string[] | undefined;
         acceptedDecisions?: {
             id: string;
@@ -2103,13 +2670,44 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
+        activeOwnerSession?: string | undefined;
     }[] | undefined;
     handoff?: string | undefined;
     handoffUpdatedAt?: string | undefined;
+    handoffAudit?: {
+        entries: {
+            status: "captured" | "not-applicable";
+            category: string;
+            detail: string;
+        }[];
+        contentHash: string;
+        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?: {
         clearedAt: string;
@@ -2125,6 +2723,7 @@ export declare const FeatureSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     name: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
+    descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     /** Updated only when this feature's description changes; distinct from entity updatedAt. */
     descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
     discussedAt: z.ZodDefault<z.ZodString>;
@@ -2200,6 +2799,10 @@ export declare const FeatureSchema: z.ZodObject<{
     updatedAt: string;
     id: string;
     createdAt: string;
+    sessionInfo: {
+        createdAt: string;
+        sessionId: string;
+    }[];
     description: string;
     acceptedDecisions: {
         id: string;
@@ -2221,10 +2824,6 @@ export declare const FeatureSchema: z.ZodObject<{
         toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     }[];
     dependsOn: string[];
-    sessionInfo: {
-        createdAt: string;
-        sessionId: string;
-    }[];
     discussedAt: string;
     contextReady: boolean;
     contextReadyReason: string;
@@ -2233,13 +2832,19 @@ export declare const FeatureSchema: z.ZodObject<{
     workDone: string;
     workRemaining: string;
     phaseIds: string[];
+    descriptionRef?: string | undefined;
 }, {
     name: string;
     updatedAt: string;
     id: string;
     createdAt: string;
     number?: number | undefined;
+    sessionInfo?: {
+        createdAt: string;
+        sessionId: string;
+    }[] | undefined;
     description?: string | undefined;
+    descriptionRef?: string | undefined;
     acceptedDecisions?: {
         id: string;
         title: string;
@@ -2260,10 +2865,6 @@ export declare const FeatureSchema: z.ZodObject<{
         description?: string | undefined;
     }[] | undefined;
     dependsOn?: string[] | undefined;
-    sessionInfo?: {
-        createdAt: string;
-        sessionId: string;
-    }[] | undefined;
     discussedAt?: string | undefined;
     contextReady?: boolean | undefined;
     contextReadyReason?: string | undefined;
@@ -2282,6 +2883,7 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         priority: z.ZodDefault<z.ZodNumber>;
         name: z.ZodString;
         description: z.ZodDefault<z.ZodString>;
+        descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         /** Updated only when this feature's description changes; distinct from entity updatedAt. */
         descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
         discussedAt: z.ZodDefault<z.ZodString>;
@@ -2357,6 +2959,10 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         updatedAt: string;
         id: string;
         createdAt: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
         description: string;
         acceptedDecisions: {
             id: string;
@@ -2378,10 +2984,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }[];
         dependsOn: string[];
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
         discussedAt: string;
         contextReady: boolean;
         contextReadyReason: string;
@@ -2390,13 +2992,19 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         workDone: string;
         workRemaining: string;
         phaseIds: string[];
+        descriptionRef?: string | undefined;
     }, {
         name: string;
         updatedAt: string;
         id: string;
         createdAt: string;
         number?: number | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
         acceptedDecisions?: {
             id: string;
             title: string;
@@ -2417,10 +3025,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
         discussedAt?: string | undefined;
         contextReady?: boolean | undefined;
         contextReadyReason?: string | undefined;
@@ -2437,6 +3041,10 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         updatedAt: string;
         id: string;
         createdAt: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
         description: string;
         acceptedDecisions: {
             id: string;
@@ -2458,10 +3066,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }[];
         dependsOn: string[];
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
         discussedAt: string;
         contextReady: boolean;
         contextReadyReason: string;
@@ -2470,6 +3074,7 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         workDone: string;
         workRemaining: string;
         phaseIds: string[];
+        descriptionRef?: string | undefined;
     }[];
 }, {
     features: {
@@ -2478,7 +3083,12 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         number?: number | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
         acceptedDecisions?: {
             id: string;
             title: string;
@@ -2499,10 +3109,6 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
         discussedAt?: string | undefined;
         contextReady?: boolean | undefined;
         contextReadyReason?: string | undefined;
@@ -2539,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;
@@ -2577,16 +3182,15 @@ 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;
     title: string;
-    description: string;
     sessionInfo: {
         createdAt: string;
         sessionId: string;
     }[];
+    description: string;
     macroTasks: {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
@@ -2597,16 +3201,15 @@ export declare const RequirementSchema: z.ZodObject<{
     }[];
     linkedPhaseIds: string[];
 }, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
     title: string;
-    description?: string | undefined;
     sessionInfo?: {
         createdAt: string;
         sessionId: string;
     }[] | undefined;
+    description?: string | undefined;
     macroTasks?: {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
@@ -2622,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;
@@ -2660,16 +3262,15 @@ 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;
         title: string;
-        description: string;
         sessionInfo: {
             createdAt: string;
             sessionId: string;
         }[];
+        description: string;
         macroTasks: {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -2680,16 +3281,15 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         }[];
         linkedPhaseIds: string[];
     }, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
-        description?: string | undefined;
         sessionInfo?: {
             createdAt: string;
             sessionId: string;
         }[] | undefined;
+        description?: string | undefined;
         macroTasks?: {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -2702,16 +3302,15 @@ 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;
         title: string;
-        description: string;
         sessionInfo: {
             createdAt: string;
             sessionId: string;
         }[];
+        description: string;
         macroTasks: {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -2724,16 +3323,15 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
     }[];
 }, {
     requirements: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
-        description?: string | undefined;
         sessionInfo?: {
             createdAt: string;
             sessionId: string;
         }[] | undefined;
+        description?: string | undefined;
         macroTasks?: {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -2745,6 +3343,168 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         linkedPhaseIds?: string[] | undefined;
     }[];
 }>;
+export declare const IdeaPromotionTargetTypeSchema: z.ZodEnum<["feature", "phase", "task"]>;
+export declare const IdeaPromotionSchema: z.ZodObject<{
+    targetType: z.ZodEnum<["feature", "phase", "task"]>;
+    targetId: z.ZodString;
+    targetRef: z.ZodString;
+    promotedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    targetType: "feature" | "phase" | "task";
+    targetId: string;
+    targetRef: string;
+    promotedAt: string;
+}, {
+    targetType: "feature" | "phase" | "task";
+    targetId: string;
+    targetRef: string;
+    promotedAt: string;
+}>;
+export declare const IdeaSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** Global Ideas sequence, independent from feature/phase/task numbering. */
+    number: z.ZodNumber;
+    shortId: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    promotion: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        targetType: z.ZodEnum<["feature", "phase", "task"]>;
+        targetId: z.ZodString;
+        targetRef: z.ZodString;
+        promotedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        targetType: "feature" | "phase" | "task";
+        targetId: string;
+        targetRef: string;
+        promotedAt: string;
+    }, {
+        targetType: "feature" | "phase" | "task";
+        targetId: string;
+        targetRef: string;
+        promotedAt: string;
+    }>>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    number: number;
+    updatedAt: string;
+    id: string;
+    createdAt: string;
+    title: string;
+    description: string;
+    shortId: string;
+    promotion: {
+        targetType: "feature" | "phase" | "task";
+        targetId: string;
+        targetRef: string;
+        promotedAt: string;
+    } | null;
+}, {
+    number: number;
+    updatedAt: string;
+    id: string;
+    createdAt: string;
+    title: string;
+    shortId: string;
+    description?: string | undefined;
+    promotion?: {
+        targetType: "feature" | "phase" | "task";
+        targetId: string;
+        targetRef: string;
+        promotedAt: string;
+    } | null | undefined;
+}>;
+export declare const IdeasDocumentSchema: z.ZodObject<{
+    nextIdeaNumber: z.ZodDefault<z.ZodNumber>;
+    ideas: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        /** Global Ideas sequence, independent from feature/phase/task numbering. */
+        number: z.ZodNumber;
+        shortId: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodString>;
+        promotion: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            targetType: z.ZodEnum<["feature", "phase", "task"]>;
+            targetId: z.ZodString;
+            targetRef: z.ZodString;
+            promotedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            targetType: "feature" | "phase" | "task";
+            targetId: string;
+            targetRef: string;
+            promotedAt: string;
+        }, {
+            targetType: "feature" | "phase" | "task";
+            targetId: string;
+            targetRef: string;
+            promotedAt: string;
+        }>>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        number: number;
+        updatedAt: string;
+        id: string;
+        createdAt: string;
+        title: string;
+        description: string;
+        shortId: string;
+        promotion: {
+            targetType: "feature" | "phase" | "task";
+            targetId: string;
+            targetRef: string;
+            promotedAt: string;
+        } | null;
+    }, {
+        number: number;
+        updatedAt: string;
+        id: string;
+        createdAt: string;
+        title: string;
+        shortId: string;
+        description?: string | undefined;
+        promotion?: {
+            targetType: "feature" | "phase" | "task";
+            targetId: string;
+            targetRef: string;
+            promotedAt: string;
+        } | null | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    nextIdeaNumber: number;
+    ideas: {
+        number: number;
+        updatedAt: string;
+        id: string;
+        createdAt: string;
+        title: string;
+        description: string;
+        shortId: string;
+        promotion: {
+            targetType: "feature" | "phase" | "task";
+            targetId: string;
+            targetRef: string;
+            promotedAt: string;
+        } | null;
+    }[];
+}, {
+    nextIdeaNumber?: number | undefined;
+    ideas?: {
+        number: number;
+        updatedAt: string;
+        id: string;
+        createdAt: string;
+        title: string;
+        shortId: string;
+        description?: string | undefined;
+        promotion?: {
+            targetType: "feature" | "phase" | "task";
+            targetId: string;
+            targetRef: string;
+            promotedAt: string;
+        } | null | undefined;
+    }[] | undefined;
+}>;
 export declare const PlanWorkspaceSchema: z.ZodObject<{
     manifest: z.ZodObject<{
         schemaVersion: z.ZodLiteral<1>;
@@ -2769,6 +3529,35 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         name: z.ZodString;
         goal: z.ZodDefault<z.ZodString>;
         description: z.ZodDefault<z.ZodString>;
+        descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        projectGuidelines: z.ZodDefault<z.ZodObject<{
+            content: z.ZodDefault<z.ZodString>;
+            updatedAt: z.ZodDefault<z.ZodString>;
+            sessionInfo: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                sessionId: z.ZodString;
+                createdAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                createdAt: string;
+                sessionId: string;
+            }, {
+                createdAt: string;
+                sessionId: string;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            updatedAt: string;
+            content: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
+        }, {
+            updatedAt?: string | undefined;
+            content?: string | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
+        }>>;
         webPort: z.ZodDefault<z.ZodNumber>;
         scope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         outOfScope: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -2925,6 +3714,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         name: string;
         goal: string;
         description: string;
+        projectGuidelines: {
+            updatedAt: string;
+            content: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
+        };
         webPort: number;
         scope: string[];
         outOfScope: string[];
@@ -2975,6 +3772,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             resolvedAt: string;
             resumedAt: string;
         }[];
+        descriptionRef?: string | undefined;
     }, {
         name: string;
         workflowRules: {
@@ -2984,6 +3782,15 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         };
         goal?: string | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
+        projectGuidelines?: {
+            updatedAt?: string | undefined;
+            content?: string | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
+        } | undefined;
         webPort?: number | undefined;
         scope?: string[] | undefined;
         outOfScope?: string[] | undefined;
@@ -3039,6 +3846,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             priority: z.ZodDefault<z.ZodNumber>;
             name: z.ZodString;
             description: z.ZodDefault<z.ZodString>;
+            descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
             /** Updated only when this feature's description changes; distinct from entity updatedAt. */
             descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
             discussedAt: z.ZodDefault<z.ZodString>;
@@ -3114,6 +3922,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             updatedAt: string;
             id: string;
             createdAt: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
             description: string;
             acceptedDecisions: {
                 id: string;
@@ -3135,10 +3947,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             dependsOn: string[];
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
             discussedAt: string;
             contextReady: boolean;
             contextReadyReason: string;
@@ -3147,13 +3955,19 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             workDone: string;
             workRemaining: string;
             phaseIds: string[];
+            descriptionRef?: string | undefined;
         }, {
             name: string;
             updatedAt: string;
             id: string;
             createdAt: string;
             number?: number | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
             description?: string | undefined;
+            descriptionRef?: string | undefined;
             acceptedDecisions?: {
                 id: string;
                 title: string;
@@ -3174,10 +3988,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
             discussedAt?: string | undefined;
             contextReady?: boolean | undefined;
             contextReadyReason?: string | undefined;
@@ -3194,6 +4004,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             updatedAt: string;
             id: string;
             createdAt: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
             description: string;
             acceptedDecisions: {
                 id: string;
@@ -3215,10 +4029,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             dependsOn: string[];
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
             discussedAt: string;
             contextReady: boolean;
             contextReadyReason: string;
@@ -3227,6 +4037,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             workDone: string;
             workRemaining: string;
             phaseIds: string[];
+            descriptionRef?: string | undefined;
         }[];
     }, {
         features: {
@@ -3235,7 +4046,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: string;
             createdAt: string;
             number?: number | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
             description?: string | undefined;
+            descriptionRef?: string | undefined;
             acceptedDecisions?: {
                 id: string;
                 title: string;
@@ -3256,10 +4072,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
             discussedAt?: string | undefined;
             contextReady?: boolean | undefined;
             contextReadyReason?: string | undefined;
@@ -3275,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;
@@ -3313,16 +4124,15 @@ 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;
             title: string;
-            description: string;
             sessionInfo: {
                 createdAt: string;
                 sessionId: string;
             }[];
+            description: string;
             macroTasks: {
                 status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
@@ -3333,16 +4143,15 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             linkedPhaseIds: string[];
         }, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
-            description?: string | undefined;
             sessionInfo?: {
                 createdAt: string;
                 sessionId: string;
             }[] | undefined;
+            description?: string | undefined;
             macroTasks?: {
                 status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
@@ -3355,16 +4164,15 @@ 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;
             title: string;
-            description: string;
             sessionInfo: {
                 createdAt: string;
                 sessionId: string;
             }[];
+            description: string;
             macroTasks: {
                 status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
@@ -3377,16 +4185,15 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[];
     }, {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
-            description?: string | undefined;
             sessionInfo?: {
                 createdAt: string;
                 sessionId: string;
             }[] | undefined;
+            description?: string | undefined;
             macroTasks?: {
                 status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
@@ -3398,6 +4205,97 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             linkedPhaseIds?: string[] | undefined;
         }[];
     }>;
+    ideas: z.ZodDefault<z.ZodObject<{
+        nextIdeaNumber: z.ZodDefault<z.ZodNumber>;
+        ideas: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            /** Global Ideas sequence, independent from feature/phase/task numbering. */
+            number: z.ZodNumber;
+            shortId: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            promotion: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                targetType: z.ZodEnum<["feature", "phase", "task"]>;
+                targetId: z.ZodString;
+                targetRef: z.ZodString;
+                promotedAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            }, {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            }>>>;
+            createdAt: z.ZodString;
+            updatedAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number;
+            updatedAt: string;
+            id: string;
+            createdAt: string;
+            title: string;
+            description: string;
+            shortId: string;
+            promotion: {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            } | null;
+        }, {
+            number: number;
+            updatedAt: string;
+            id: string;
+            createdAt: string;
+            title: string;
+            shortId: string;
+            description?: string | undefined;
+            promotion?: {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            } | null | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        nextIdeaNumber: number;
+        ideas: {
+            number: number;
+            updatedAt: string;
+            id: string;
+            createdAt: string;
+            title: string;
+            description: string;
+            shortId: string;
+            promotion: {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            } | null;
+        }[];
+    }, {
+        nextIdeaNumber?: number | undefined;
+        ideas?: {
+            number: number;
+            updatedAt: string;
+            id: string;
+            createdAt: string;
+            title: string;
+            shortId: string;
+            description?: string | undefined;
+            promotion?: {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            } | null | undefined;
+        }[] | undefined;
+    }>>;
     phases: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         /** MUST be a feature UUID (not a ref like "F005"). Validated at the schema
@@ -3415,6 +4313,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         contextReadyReason: z.ZodDefault<z.ZodString>;
         summary: z.ZodDefault<z.ZodString>;
         description: z.ZodDefault<z.ZodString>;
+        descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         /** Updated only when this phase's description changes; distinct from entity updatedAt. */
         descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
         notes: z.ZodDefault<z.ZodString>;
@@ -3462,6 +4361,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             title: z.ZodString;
             status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             description: z.ZodDefault<z.ZodString>;
+            descriptionRef: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
             /** Updated only when this task's description changes; distinct from entity updatedAt. */
             descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
             notes: z.ZodDefault<z.ZodString>;
@@ -3635,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";
@@ -3643,6 +4545,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: string;
             createdAt: string;
             title: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
             description: string;
             decisions: string[];
             acceptedDecisions: {
@@ -3703,10 +4609,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
+            activeOwnerSession: string;
+            descriptionRef?: string | undefined;
         }, {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -3717,7 +4621,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortName: string;
             number?: number | undefined;
             notes?: string | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
             description?: string | undefined;
+            descriptionRef?: string | undefined;
             decisions?: string[] | undefined;
             acceptedDecisions?: {
                 id: string;
@@ -3775,10 +4684,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
+            activeOwnerSession?: string | undefined;
         }>, {
             checklist: {
                 id: string;
@@ -3793,6 +4699,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: string;
             createdAt: string;
             title: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
             description: string;
             decisions: string[];
             acceptedDecisions: {
@@ -3847,10 +4757,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
+            activeOwnerSession: string;
+            descriptionRef?: string | undefined;
         }, {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -3861,7 +4769,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortName: string;
             number?: number | undefined;
             notes?: string | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
             description?: string | undefined;
+            descriptionRef?: string | undefined;
             decisions?: string[] | undefined;
             acceptedDecisions?: {
                 id: string;
@@ -3919,15 +4832,175 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
+            activeOwnerSession?: string | undefined;
         }>, "many">>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
         handoff: z.ZodDefault<z.ZodString>;
         handoffUpdatedAt: z.ZodDefault<z.ZodString>;
+        /** Durable proof that the active handoff passed the versioned completeness and read-back contract. */
+        handoffAudit: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            version: z.ZodNumber;
+            entries: z.ZodArray<z.ZodObject<{
+                category: z.ZodString;
+                status: z.ZodEnum<["captured", "not-applicable"]>;
+                detail: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                status: "captured" | "not-applicable";
+                category: string;
+                detail: string;
+            }, {
+                status: "captured" | "not-applicable";
+                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;
+                contentHash: z.ZodString;
+                contentLength: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                path: string;
+                description: string;
+                contentHash: string;
+                contentLength: number;
+            }, {
+                path: string;
+                description: string;
+                contentHash: string;
+                contentLength: number;
+            }>, "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";
+                category: string;
+                detail: string;
+            }[];
+            contentHash: string;
+            contentLength: number;
+            version: number;
+            supportingDocuments: {
+                path: string;
+                description: string;
+                contentHash: string;
+                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";
+                category: string;
+                detail: string;
+            }[];
+            contentHash: string;
+            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
          *  non-mutating: content remains until every task is done/canceled, a later
@@ -3995,6 +5068,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         summary: string;
         createdAt: string;
         title: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
         description: string;
         decisions: string[];
         acceptedDecisions: {
@@ -4017,10 +5094,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         }[];
         dependsOn: string[];
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
         slug: string;
         discussedAt: string;
         contextReady: boolean;
@@ -4045,6 +5118,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: string;
             createdAt: string;
             title: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
             description: string;
             decisions: string[];
             acceptedDecisions: {
@@ -4099,19 +5176,52 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
+            activeOwnerSession: string;
+            descriptionRef?: string | undefined;
         }[];
         handoff: string;
         handoffUpdatedAt: string;
+        handoffAudit: {
+            entries: {
+                status: "captured" | "not-applicable";
+                category: string;
+                detail: string;
+            }[];
+            contentHash: string;
+            contentLength: number;
+            version: number;
+            supportingDocuments: {
+                path: string;
+                description: string;
+                contentHash: string;
+                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: {
             file: string;
             reason: string;
             clearedAt: string;
         }[];
+        descriptionRef?: string | undefined;
         featureId?: string | undefined;
     }, {
         number: number;
@@ -4123,7 +5233,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         dependencies?: string[] | undefined;
         notes?: string | undefined;
         summary?: string | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
         decisions?: string[] | undefined;
         acceptedDecisions?: {
             id: string;
@@ -4145,10 +5260,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
         featureId?: string | undefined;
         discussedAt?: string | undefined;
         contextReady?: boolean | undefined;
@@ -4169,7 +5280,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortName: string;
             number?: number | undefined;
             notes?: string | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
             description?: string | undefined;
+            descriptionRef?: string | undefined;
             decisions?: string[] | undefined;
             acceptedDecisions?: {
                 id: string;
@@ -4227,13 +5343,44 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
+            activeOwnerSession?: string | undefined;
         }[] | undefined;
         handoff?: string | undefined;
         handoffUpdatedAt?: string | undefined;
+        handoffAudit?: {
+            entries: {
+                status: "captured" | "not-applicable";
+                category: string;
+                detail: string;
+            }[];
+            contentHash: string;
+            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?: {
             clearedAt: string;
@@ -4242,6 +5389,70 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[] | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
+    project: {
+        name: string;
+        goal: string;
+        description: string;
+        projectGuidelines: {
+            updatedAt: string;
+            content: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
+        };
+        webPort: number;
+        scope: string[];
+        outOfScope: string[];
+        decisions: string[];
+        globalRules: string[];
+        technologies: string[];
+        tools: string[];
+        contentLanguage: string;
+        chatLanguage: string;
+        workflowRules: {
+            beforePhaseStart: string[];
+            beforeTaskStart: string[];
+            afterPhaseComplete: string[];
+        };
+        acceptedDecisions: {
+            id: string;
+            title: string;
+            decision: string;
+            rationale: string;
+            implementationNotes: string;
+            acceptedAt: string;
+        }[];
+        nextFeatureNumber: number;
+        nextPhaseNumber: number;
+        nextTaskNumber: number;
+        workDeviations: {
+            id: string;
+            createdAt: string;
+            reason: string;
+            recommendedTaskId: string;
+            temporaryTaskId: string;
+            resumeTaskId: string;
+            snapshot: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            } | null;
+            requestedBy: "agent" | "user";
+            approvedBy: string;
+            state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
+            activatedAt: string;
+            resumeRequiredAt: string;
+            resolvedAt: string;
+            resumedAt: string;
+        }[];
+        descriptionRef?: string | undefined;
+    };
     features: {
         features: {
             number: number;
@@ -4249,6 +5460,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             updatedAt: string;
             id: string;
             createdAt: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
             description: string;
             acceptedDecisions: {
                 id: string;
@@ -4270,10 +5485,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             dependsOn: string[];
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
             discussedAt: string;
             contextReady: boolean;
             contextReadyReason: string;
@@ -4282,20 +5493,20 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             workDone: string;
             workRemaining: string;
             phaseIds: string[];
+            descriptionRef?: string | undefined;
         }[];
     };
     requirements: {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
-            description: string;
             sessionInfo: {
                 createdAt: string;
                 sessionId: string;
             }[];
+            description: string;
             macroTasks: {
                 status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
@@ -4307,6 +5518,24 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             linkedPhaseIds: string[];
         }[];
     };
+    ideas: {
+        nextIdeaNumber: number;
+        ideas: {
+            number: number;
+            updatedAt: string;
+            id: string;
+            createdAt: string;
+            title: string;
+            description: string;
+            shortId: string;
+            promotion: {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            } | null;
+        }[];
+    };
     manifest: {
         updatedAt: string;
         schemaVersion: 1;
@@ -4314,61 +5543,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         projectName: string;
         createdAt: string;
     };
-    project: {
-        name: string;
-        goal: string;
-        description: string;
-        webPort: number;
-        scope: string[];
-        outOfScope: string[];
-        decisions: string[];
-        globalRules: string[];
-        technologies: string[];
-        tools: string[];
-        contentLanguage: string;
-        chatLanguage: string;
-        workflowRules: {
-            beforePhaseStart: string[];
-            beforeTaskStart: string[];
-            afterPhaseComplete: string[];
-        };
-        acceptedDecisions: {
-            id: string;
-            title: string;
-            decision: string;
-            rationale: string;
-            implementationNotes: string;
-            acceptedAt: string;
-        }[];
-        nextFeatureNumber: number;
-        nextPhaseNumber: number;
-        nextTaskNumber: number;
-        workDeviations: {
-            id: string;
-            createdAt: string;
-            reason: string;
-            recommendedTaskId: string;
-            temporaryTaskId: string;
-            resumeTaskId: string;
-            snapshot: {
-                id: string;
-                reason: string;
-                whatWasBeingDone: string;
-                resumeLocation: string;
-                howToResume: string;
-                relatedTaskId: string;
-                pausedAt: string;
-                pausedBy: string;
-            } | null;
-            requestedBy: "agent" | "user";
-            approvedBy: string;
-            state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
-            activatedAt: string;
-            resumeRequiredAt: string;
-            resolvedAt: string;
-            resumedAt: string;
-        }[];
-    };
     phases: {
         number: number;
         dependencies: string[];
@@ -4378,6 +5552,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         summary: string;
         createdAt: string;
         title: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
         description: string;
         decisions: string[];
         acceptedDecisions: {
@@ -4400,10 +5578,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         }[];
         dependsOn: string[];
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
         slug: string;
         discussedAt: string;
         contextReady: boolean;
@@ -4428,6 +5602,10 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: string;
             createdAt: string;
             title: string;
+            sessionInfo: {
+                createdAt: string;
+                sessionId: string;
+            }[];
             description: string;
             decisions: string[];
             acceptedDecisions: {
@@ -4482,22 +5660,119 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
+            activeOwnerSession: string;
+            descriptionRef?: string | undefined;
         }[];
         handoff: string;
         handoffUpdatedAt: string;
+        handoffAudit: {
+            entries: {
+                status: "captured" | "not-applicable";
+                category: string;
+                detail: string;
+            }[];
+            contentHash: string;
+            contentLength: number;
+            version: number;
+            supportingDocuments: {
+                path: string;
+                description: string;
+                contentHash: string;
+                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: {
             file: string;
             reason: string;
             clearedAt: string;
         }[];
+        descriptionRef?: string | undefined;
         featureId?: string | undefined;
     }[];
 }, {
+    project: {
+        name: string;
+        workflowRules: {
+            beforePhaseStart?: string[] | undefined;
+            beforeTaskStart?: string[] | undefined;
+            afterPhaseComplete?: string[] | undefined;
+        };
+        goal?: string | undefined;
+        description?: string | undefined;
+        descriptionRef?: string | undefined;
+        projectGuidelines?: {
+            updatedAt?: string | undefined;
+            content?: string | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
+        } | undefined;
+        webPort?: number | undefined;
+        scope?: string[] | undefined;
+        outOfScope?: string[] | undefined;
+        decisions?: string[] | undefined;
+        globalRules?: string[] | undefined;
+        technologies?: string[] | undefined;
+        tools?: string[] | undefined;
+        contentLanguage?: string | undefined;
+        chatLanguage?: string | undefined;
+        acceptedDecisions?: {
+            id: string;
+            title: string;
+            acceptedAt: string;
+            decision?: string | undefined;
+            rationale?: string | undefined;
+            implementationNotes?: string | undefined;
+        }[] | undefined;
+        nextFeatureNumber?: number | undefined;
+        nextPhaseNumber?: number | undefined;
+        nextTaskNumber?: number | undefined;
+        workDeviations?: {
+            id: string;
+            createdAt: string;
+            recommendedTaskId: string;
+            temporaryTaskId: string;
+            resumeTaskId: string;
+            reason?: string | undefined;
+            snapshot?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            } | null | undefined;
+            requestedBy?: "agent" | "user" | undefined;
+            approvedBy?: string | undefined;
+            state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
+            activatedAt?: string | undefined;
+            resumeRequiredAt?: string | undefined;
+            resolvedAt?: string | undefined;
+            resumedAt?: string | undefined;
+        }[] | undefined;
+    };
     features: {
         features: {
             name: string;
@@ -4505,7 +5780,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             id: string;
             createdAt: string;
             number?: number | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
             description?: string | undefined;
+            descriptionRef?: string | undefined;
             acceptedDecisions?: {
                 id: string;
                 title: string;
@@ -4526,10 +5806,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
             discussedAt?: string | undefined;
             contextReady?: boolean | undefined;
             contextReadyReason?: string | undefined;
@@ -4542,16 +5818,15 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     };
     requirements: {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
-            description?: string | undefined;
             sessionInfo?: {
                 createdAt: string;
                 sessionId: string;
             }[] | undefined;
+            description?: string | undefined;
             macroTasks?: {
                 status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
@@ -4570,61 +5845,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         projectName: string;
         createdAt: string;
     };
-    project: {
-        name: string;
-        workflowRules: {
-            beforePhaseStart?: string[] | undefined;
-            beforeTaskStart?: string[] | undefined;
-            afterPhaseComplete?: string[] | undefined;
-        };
-        goal?: string | undefined;
-        description?: string | undefined;
-        webPort?: number | undefined;
-        scope?: string[] | undefined;
-        outOfScope?: string[] | undefined;
-        decisions?: string[] | undefined;
-        globalRules?: string[] | undefined;
-        technologies?: string[] | undefined;
-        tools?: string[] | undefined;
-        contentLanguage?: string | undefined;
-        chatLanguage?: string | undefined;
-        acceptedDecisions?: {
-            id: string;
-            title: string;
-            acceptedAt: string;
-            decision?: string | undefined;
-            rationale?: string | undefined;
-            implementationNotes?: string | undefined;
-        }[] | undefined;
-        nextFeatureNumber?: number | undefined;
-        nextPhaseNumber?: number | undefined;
-        nextTaskNumber?: number | undefined;
-        workDeviations?: {
-            id: string;
-            createdAt: string;
-            recommendedTaskId: string;
-            temporaryTaskId: string;
-            resumeTaskId: string;
-            reason?: string | undefined;
-            snapshot?: {
-                id: string;
-                reason: string;
-                whatWasBeingDone: string;
-                resumeLocation: string;
-                howToResume: string;
-                pausedAt: string;
-                relatedTaskId?: string | undefined;
-                pausedBy?: string | undefined;
-            } | null | undefined;
-            requestedBy?: "agent" | "user" | undefined;
-            approvedBy?: string | undefined;
-            state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
-            activatedAt?: string | undefined;
-            resumeRequiredAt?: string | undefined;
-            resolvedAt?: string | undefined;
-            resumedAt?: string | undefined;
-        }[] | undefined;
-    };
     phases: {
         number: number;
         updatedAt: string;
@@ -4635,7 +5855,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         dependencies?: string[] | undefined;
         notes?: string | undefined;
         summary?: string | undefined;
+        sessionInfo?: {
+            createdAt: string;
+            sessionId: string;
+        }[] | undefined;
         description?: string | undefined;
+        descriptionRef?: string | undefined;
         decisions?: string[] | undefined;
         acceptedDecisions?: {
             id: string;
@@ -4657,10 +5882,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
         featureId?: string | undefined;
         discussedAt?: string | undefined;
         contextReady?: boolean | undefined;
@@ -4681,7 +5902,12 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortName: string;
             number?: number | undefined;
             notes?: string | undefined;
+            sessionInfo?: {
+                createdAt: string;
+                sessionId: string;
+            }[] | undefined;
             description?: string | undefined;
+            descriptionRef?: string | undefined;
             decisions?: string[] | undefined;
             acceptedDecisions?: {
                 id: string;
@@ -4739,13 +5965,44 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
+            activeOwnerSession?: string | undefined;
         }[] | undefined;
         handoff?: string | undefined;
         handoffUpdatedAt?: string | undefined;
+        handoffAudit?: {
+            entries: {
+                status: "captured" | "not-applicable";
+                category: string;
+                detail: string;
+            }[];
+            contentHash: string;
+            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?: {
             clearedAt: string;
@@ -4753,6 +6010,24 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             reason?: string | undefined;
         }[] | undefined;
     }[];
+    ideas?: {
+        nextIdeaNumber?: number | undefined;
+        ideas?: {
+            number: number;
+            updatedAt: string;
+            id: string;
+            createdAt: string;
+            title: string;
+            shortId: string;
+            description?: string | undefined;
+            promotion?: {
+                targetType: "feature" | "phase" | "task";
+                targetId: string;
+                targetRef: string;
+                promotedAt: string;
+            } | null | undefined;
+        }[] | undefined;
+    } | undefined;
 }>;
 export type Timestamp = z.infer<typeof TimestampSchema>;
 export type SessionInfo = z.infer<typeof SessionInfoSchema>;
@@ -4771,11 +6046,17 @@ 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>;
 export type TaskPauseSnapshot = z.infer<typeof TaskPauseSnapshotSchema>;
@@ -4790,6 +6071,10 @@ export type Phase = z.infer<typeof PhaseSchema> & {
 export type MacroTask = z.infer<typeof MacroTaskSchema>;
 export type Requirement = z.infer<typeof RequirementSchema>;
 export type RequirementsDocument = z.infer<typeof RequirementsDocumentSchema>;
+export type IdeaPromotionTargetType = z.infer<typeof IdeaPromotionTargetTypeSchema>;
+export type IdeaPromotion = z.infer<typeof IdeaPromotionSchema>;
+export type Idea = z.infer<typeof IdeaSchema>;
+export type IdeasDocument = z.infer<typeof IdeasDocumentSchema>;
 export type PlanWorkspace = Omit<z.infer<typeof PlanWorkspaceSchema>, "phases" | "features"> & {
     phases: Phase[];
     features: FeaturesDocument;