@agent-plan/core 0.2.24 → 0.2.26

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;
@@ -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>;
@@ -978,6 +1055,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 +1119,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[];
     startedAt: string;
     completedAt: string;
-    sessionInfo: {
-        createdAt: string;
-        sessionId: string;
-    }[];
+    descriptionRef?: string | undefined;
 }, {
     status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
@@ -1052,7 +1130,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 +1193,6 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
-    sessionInfo?: {
-        createdAt: string;
-        sessionId: string;
-    }[] | undefined;
 }>, {
     checklist: {
         id: string;
@@ -1128,6 +1207,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 +1265,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[];
     startedAt: string;
     completedAt: string;
-    sessionInfo: {
-        createdAt: string;
-        sessionId: string;
-    }[];
+    descriptionRef?: string | undefined;
 }, {
     status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
@@ -1196,7 +1276,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 +1339,6 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
-    sessionInfo?: {
-        createdAt: string;
-        sessionId: string;
-    }[] | undefined;
 }>;
 export declare const HandoffHistoryEntrySchema: z.ZodObject<{
     /** Relative path under .planner/.local/handoff-archive/ (e.g. <phaseId>-<ISO>.md). */
@@ -1274,6 +1355,102 @@ 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 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">;
+    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;
+    verifiedAt: z.ZodString;
+}, "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;
+}, {
+    entries: {
+        status: "captured" | "not-applicable";
+        category: string;
+        detail: string;
+    }[];
+    contentHash: string;
+    contentLength: number;
+    version: number;
+    verifiedAt: string;
+    supportingDocuments?: {
+        path: string;
+        description: string;
+        contentHash: string;
+        contentLength: number;
+    }[] | 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 +1468,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 +1516,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>;
@@ -1519,6 +1698,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 +1762,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
+        descriptionRef?: string | undefined;
     }, {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
@@ -1593,7 +1773,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 +1836,6 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: string;
-        }[] | undefined;
     }>, {
         checklist: {
             id: string;
@@ -1669,6 +1850,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 +1908,7 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
-        sessionInfo: {
-            createdAt: string;
-            sessionId: string;
-        }[];
+        descriptionRef?: string | undefined;
     }, {
         status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
@@ -1737,7 +1919,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 +1982,79 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: 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">;
+        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;
+        verifiedAt: z.ZodString;
+    }, "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;
+    }, {
+        entries: {
+            status: "captured" | "not-applicable";
+            category: string;
+            detail: string;
+        }[];
+        contentHash: string;
+        contentLength: number;
+        version: number;
+        verifiedAt: string;
+        supportingDocuments?: {
+            path: string;
+            description: string;
+            contentHash: string;
+            contentLength: number;
+        }[] | 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 +2122,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 +2148,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,6 +2172,10 @@ export declare const PhaseSchema: z.ZodObject<{
         id: string;
         createdAt: string;
         title: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
         description: string;
         decisions: string[];
         acceptedDecisions: {
@@ -1975,19 +2230,34 @@ export declare const PhaseSchema: z.ZodObject<{
         }[];
         startedAt: string;
         completedAt: string;
-        sessionInfo: {
-            createdAt: string;
-            sessionId: 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;
+    } | null;
     handoffReadAt: string;
     handoffHistory: {
         file: string;
         reason: string;
         clearedAt: string;
     }[];
+    descriptionRef?: string | undefined;
     featureId?: string | undefined;
 }, {
     number: number;
@@ -1999,7 +2269,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 +2296,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 +2316,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 +2379,26 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
-        sessionInfo?: {
-            createdAt: string;
-            sessionId: 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;
+        supportingDocuments?: {
+            path: string;
+            description: string;
+            contentHash: string;
+            contentLength: number;
+        }[] | undefined;
+    } | null | undefined;
     handoffReadAt?: string | undefined;
     handoffHistory?: {
         clearedAt: string;
@@ -2125,6 +2414,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 +2490,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 +2515,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 +2523,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 +2556,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 +2574,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 +2650,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 +2675,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 +2683,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 +2716,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,7 +2732,11 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         updatedAt: string;
         id: string;
         createdAt: string;
-        description: string;
+        sessionInfo: {
+            createdAt: string;
+            sessionId: string;
+        }[];
+        description: string;
         acceptedDecisions: {
             id: string;
             title: string;
@@ -2458,10 +2757,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 +2765,7 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         workDone: string;
         workRemaining: string;
         phaseIds: string[];
+        descriptionRef?: string | undefined;
     }[];
 }, {
     features: {
@@ -2478,7 +2774,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 +2800,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;
@@ -2582,11 +2879,11 @@ export declare const RequirementSchema: z.ZodObject<{
     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;
@@ -2602,11 +2899,11 @@ export declare const RequirementSchema: z.ZodObject<{
     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;
@@ -2665,11 +2962,11 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         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;
@@ -2685,11 +2982,11 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         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;
@@ -2707,11 +3004,11 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         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;
@@ -2729,11 +3026,11 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         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 +3042,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 +3228,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 +3413,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 +3471,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             resolvedAt: string;
             resumedAt: string;
         }[];
+        descriptionRef?: string | undefined;
     }, {
         name: string;
         workflowRules: {
@@ -2984,6 +3481,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 +3545,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 +3621,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 +3646,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 +3654,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 +3687,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 +3703,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 +3728,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 +3736,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             workDone: string;
             workRemaining: string;
             phaseIds: string[];
+            descriptionRef?: string | undefined;
         }[];
     }, {
         features: {
@@ -3235,7 +3745,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 +3771,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;
@@ -3318,11 +3829,11 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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;
@@ -3338,11 +3849,11 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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;
@@ -3360,11 +3871,11 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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;
@@ -3382,11 +3893,11 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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 +3909,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 +4017,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 +4065,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>;
@@ -3643,6 +4247,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 +4311,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
+            descriptionRef?: string | undefined;
         }, {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -3717,7 +4322,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 +4385,6 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: string;
-            }[] | undefined;
         }>, {
             checklist: {
                 id: string;
@@ -3793,6 +4399,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 +4457,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: string;
-            }[];
+            descriptionRef?: string | undefined;
         }, {
             status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
@@ -3861,7 +4468,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 +4531,79 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: 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">;
+            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;
+            verifiedAt: z.ZodString;
+        }, "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;
+        }, {
+            entries: {
+                status: "captured" | "not-applicable";
+                category: string;
+                detail: string;
+            }[];
+            contentHash: string;
+            contentLength: number;
+            version: number;
+            verifiedAt: string;
+            supportingDocuments?: {
+                path: string;
+                description: string;
+                contentHash: string;
+                contentLength: number;
+            }[] | 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 +4671,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 +4697,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 +4721,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 +4779,34 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: 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;
+        } | null;
         handoffReadAt: string;
         handoffHistory: {
             file: string;
             reason: string;
             clearedAt: string;
         }[];
+        descriptionRef?: string | undefined;
         featureId?: string | undefined;
     }, {
         number: number;
@@ -4123,7 +4818,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 +4845,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 +4865,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 +4928,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: 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;
+            supportingDocuments?: {
+                path: string;
+                description: string;
+                contentHash: string;
+                contentLength: number;
+            }[] | undefined;
+        } | null | undefined;
         handoffReadAt?: string | undefined;
         handoffHistory?: {
             clearedAt: string;
@@ -4242,6 +4956,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 +5027,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 +5052,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,6 +5060,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             workDone: string;
             workRemaining: string;
             phaseIds: string[];
+            descriptionRef?: string | undefined;
         }[];
     };
     requirements: {
@@ -4291,11 +5070,11 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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 +5086,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 +5111,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 +5120,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 +5146,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 +5170,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 +5228,101 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             startedAt: string;
             completedAt: string;
-            sessionInfo: {
-                createdAt: string;
-                sessionId: 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;
+        } | 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 +5330,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 +5356,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;
@@ -4547,11 +5373,11 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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 +5396,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 +5406,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 +5433,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 +5453,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 +5516,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
-            sessionInfo?: {
-                createdAt: string;
-                sessionId: 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;
+            supportingDocuments?: {
+                path: string;
+                description: string;
+                contentHash: string;
+                contentLength: number;
+            }[] | undefined;
+        } | null | undefined;
         handoffReadAt?: string | undefined;
         handoffHistory?: {
             clearedAt: string;
@@ -4753,6 +5543,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>;
@@ -4776,6 +5584,9 @@ 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 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 +5601,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;