npm - @agent-plan/core - Versions diffs - 0.2.19 → 0.2.21 - Mend

@agent-plan/core 0.2.19 → 0.2.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/dist/display-status.d.ts +5 -3
package/dist/display-status.d.ts.map +1 -1
package/dist/display-status.js +14 -5
package/dist/plan-store.d.ts +11 -3
package/dist/plan-store.d.ts.map +1 -1
package/dist/plan-store.js +151 -22
package/dist/recap.d.ts.map +1 -1
package/dist/recap.js +63 -5
package/dist/schema.d.ts +1159 -248
package/dist/schema.d.ts.map +1 -1
package/dist/schema.js +39 -7
package/dist/task-selection.d.ts.map +1 -1
package/dist/task-selection.js +30 -22
package/package.json +1 -1

package/dist/schema.d.ts CHANGED Viewed

@@ -272,6 +272,39 @@ export declare const AcceptedDecisionSchema: z.ZodObject<{
     rationale?: string | undefined;
     implementationNotes?: string | undefined;
 }>;
+export declare const TaskPauseSnapshotSchema: z.ZodObject<{
+    id: z.ZodString;
+    /** Why work stopped or changed focus. */
+    reason: z.ZodString;
+    /** Concrete checkpoint: what was underway when the task was paused. */
+    whatWasBeingDone: z.ZodString;
+    /** File, symbol, command, or other exact location from which to continue. */
+    resumeLocation: z.ZodString;
+    /** Ordered, actionable instructions for resuming the task. */
+    howToResume: z.ZodString;
+    /** Optional temporary/prerequisite task that caused the pause. */
+    relatedTaskId: z.ZodDefault<z.ZodString>;
+    pausedAt: z.ZodString;
+    pausedBy: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    reason: string;
+    whatWasBeingDone: string;
+    resumeLocation: string;
+    howToResume: string;
+    relatedTaskId: string;
+    pausedAt: string;
+    pausedBy: string;
+}, {
+    id: string;
+    reason: string;
+    whatWasBeingDone: string;
+    resumeLocation: string;
+    howToResume: string;
+    pausedAt: string;
+    relatedTaskId?: string | undefined;
+    pausedBy?: string | undefined;
+}>;
 export declare const WorkDeviationSchema: z.ZodObject<{
     id: z.ZodString;
     /** Task the priority selector recommended when the deviation was approved. */
@@ -281,24 +314,75 @@ export declare const WorkDeviationSchema: z.ZodObject<{
     /** Task to surface explicitly after the temporary work is resolved. */
     resumeTaskId: z.ZodString;
     reason: z.ZodDefault<z.ZodString>;
+    /** Durable checkpoint captured when the resume task was paused. */
+    snapshot: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        /** Why work stopped or changed focus. */
+        reason: z.ZodString;
+        /** Concrete checkpoint: what was underway when the task was paused. */
+        whatWasBeingDone: z.ZodString;
+        /** File, symbol, command, or other exact location from which to continue. */
+        resumeLocation: z.ZodString;
+        /** Ordered, actionable instructions for resuming the task. */
+        howToResume: z.ZodString;
+        /** Optional temporary/prerequisite task that caused the pause. */
+        relatedTaskId: z.ZodDefault<z.ZodString>;
+        pausedAt: z.ZodString;
+        pausedBy: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        relatedTaskId: string;
+        pausedAt: string;
+        pausedBy: string;
+    }, {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        pausedAt: string;
+        relatedTaskId?: string | undefined;
+        pausedBy?: string | undefined;
+    }>>>;
     requestedBy: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
     approvedBy: z.ZodDefault<z.ZodString>;
-    state: z.ZodDefault<z.ZodEnum<["approved", "active", "resolved", "canceled"]>>;
+    state: z.ZodDefault<z.ZodEnum<["approved", "active", "resume-required", "resolved", "resumed", "canceled"]>>;
     createdAt: z.ZodString;
     activatedAt: z.ZodDefault<z.ZodString>;
+    /** When temporary work ended and the resume target became mandatory. */
+    resumeRequiredAt: z.ZodDefault<z.ZodString>;
+    /** Legacy temporary-work completion timestamp. */
     resolvedAt: z.ZodDefault<z.ZodString>;
+    /** When the preserved resume target was actually started again. */
+    resumedAt: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     createdAt: string;
+    reason: string;
     recommendedTaskId: string;
     temporaryTaskId: string;
     resumeTaskId: string;
-    reason: 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" | "resolved" | "canceled";
+    state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
     activatedAt: string;
+    resumeRequiredAt: string;
     resolvedAt: string;
+    resumedAt: string;
 }, {
     id: string;
     createdAt: string;
@@ -306,11 +390,23 @@ export declare const WorkDeviationSchema: z.ZodObject<{
     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" | "resolved" | "canceled" | undefined;
+    state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
     activatedAt?: string | undefined;
+    resumeRequiredAt?: string | undefined;
     resolvedAt?: string | undefined;
+    resumedAt?: string | undefined;
 }>;
 export declare const ProjectSchema: z.ZodObject<{
     name: z.ZodString;
@@ -374,24 +470,75 @@ export declare const ProjectSchema: z.ZodObject<{
         /** Task to surface explicitly after the temporary work is resolved. */
         resumeTaskId: z.ZodString;
         reason: z.ZodDefault<z.ZodString>;
+        /** Durable checkpoint captured when the resume task was paused. */
+        snapshot: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            /** Why work stopped or changed focus. */
+            reason: z.ZodString;
+            /** Concrete checkpoint: what was underway when the task was paused. */
+            whatWasBeingDone: z.ZodString;
+            /** File, symbol, command, or other exact location from which to continue. */
+            resumeLocation: z.ZodString;
+            /** Ordered, actionable instructions for resuming the task. */
+            howToResume: z.ZodString;
+            /** Optional temporary/prerequisite task that caused the pause. */
+            relatedTaskId: z.ZodDefault<z.ZodString>;
+            pausedAt: z.ZodString;
+            pausedBy: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        }, {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        }>>>;
         requestedBy: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
         approvedBy: z.ZodDefault<z.ZodString>;
-        state: z.ZodDefault<z.ZodEnum<["approved", "active", "resolved", "canceled"]>>;
+        state: z.ZodDefault<z.ZodEnum<["approved", "active", "resume-required", "resolved", "resumed", "canceled"]>>;
         createdAt: z.ZodString;
         activatedAt: z.ZodDefault<z.ZodString>;
+        /** When temporary work ended and the resume target became mandatory. */
+        resumeRequiredAt: z.ZodDefault<z.ZodString>;
+        /** Legacy temporary-work completion timestamp. */
         resolvedAt: z.ZodDefault<z.ZodString>;
+        /** When the preserved resume target was actually started again. */
+        resumedAt: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         createdAt: string;
+        reason: string;
         recommendedTaskId: string;
         temporaryTaskId: string;
         resumeTaskId: string;
-        reason: 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" | "resolved" | "canceled";
+        state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
         activatedAt: string;
+        resumeRequiredAt: string;
         resolvedAt: string;
+        resumedAt: string;
     }, {
         id: string;
         createdAt: string;
@@ -399,11 +546,23 @@ export declare const ProjectSchema: z.ZodObject<{
         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" | "resolved" | "canceled" | undefined;
+        state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
         activatedAt?: string | undefined;
+        resumeRequiredAt?: string | undefined;
         resolvedAt?: string | undefined;
+        resumedAt?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
@@ -437,15 +596,27 @@ export declare const ProjectSchema: z.ZodObject<{
     workDeviations: {
         id: string;
         createdAt: string;
+        reason: string;
         recommendedTaskId: string;
         temporaryTaskId: string;
         resumeTaskId: string;
-        reason: 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" | "resolved" | "canceled";
+        state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
         activatedAt: string;
+        resumeRequiredAt: string;
         resolvedAt: string;
+        resumedAt: string;
     }[];
 }, {
     name: string;
@@ -483,34 +654,46 @@ export declare const ProjectSchema: z.ZodObject<{
         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" | "resolved" | "canceled" | undefined;
+        state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
         activatedAt?: string | undefined;
+        resumeRequiredAt?: string | undefined;
         resolvedAt?: string | undefined;
+        resumedAt?: string | undefined;
     }[] | undefined;
 }>;
-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 FeatureStatusSchema: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+export declare const SubtaskStatusSchema: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+export declare const TaskStatusSchema: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+export declare const PhaseStatusSchema: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+export declare const RequirementStatusSchema: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+export declare const FeatureStatusSchema: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
 export declare const SubtaskSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
-    status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+    status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     description: z.ZodDefault<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
     title: string;
     description: string;
 }, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
@@ -548,8 +731,8 @@ export declare function needsMotivation(fromStatus: string, toStatus: string): b
 export declare const StatusLogEntrySchema: z.ZodObject<{
     id: z.ZodString;
     date: z.ZodString;
-    fromStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-    toStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+    fromStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+    toStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     title: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -557,14 +740,14 @@ export declare const StatusLogEntrySchema: z.ZodObject<{
     date: string;
     title: string;
     description: string;
-    fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-    toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
 }, {
     id: string;
     date: string;
     title: string;
-    fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-    toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     description?: string | undefined;
 }>;
 /** Like StatusLogEntrySchema but for the DERIVED PHASE status, which includes
@@ -572,8 +755,8 @@ export declare const StatusLogEntrySchema: z.ZodObject<{
 export declare const PhaseStatusLogEntrySchema: z.ZodObject<{
     id: z.ZodString;
     date: z.ZodString;
-    fromStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-    toStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+    fromStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+    toStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     title: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -581,14 +764,14 @@ export declare const PhaseStatusLogEntrySchema: z.ZodObject<{
     date: string;
     title: string;
     description: string;
-    fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-    toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+    fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+    toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
 }, {
     id: string;
     date: string;
     title: string;
-    fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-    toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+    fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+    toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
     description?: string | undefined;
 }>;
 export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
@@ -602,14 +785,16 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     shortName: z.ZodString;
     title: z.ZodString;
-    status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+    status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     description: z.ZodDefault<z.ZodString>;
+    /** Updated only when this task's description changes; distinct from entity updatedAt. */
+    descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
     notes: z.ZodDefault<z.ZodString>;
     statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         date: z.ZodString;
-        fromStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-        toStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        fromStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        toStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         title: z.ZodString;
         description: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -617,14 +802,14 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         date: string;
         title: string;
         description: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     }, {
         id: string;
         date: string;
         title: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         description?: string | undefined;
     }>, "many">>;
     decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -672,19 +857,19 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     subtasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
-        status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         description: z.ZodDefault<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
         description: string;
     }, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -692,13 +877,81 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         description?: string | undefined;
     }>, "many">>;
     dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Current durable checkpoint while this task is paused. */
+    pauseSnapshot: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        /** Why work stopped or changed focus. */
+        reason: z.ZodString;
+        /** Concrete checkpoint: what was underway when the task was paused. */
+        whatWasBeingDone: z.ZodString;
+        /** File, symbol, command, or other exact location from which to continue. */
+        resumeLocation: z.ZodString;
+        /** Ordered, actionable instructions for resuming the task. */
+        howToResume: z.ZodString;
+        /** Optional temporary/prerequisite task that caused the pause. */
+        relatedTaskId: z.ZodDefault<z.ZodString>;
+        pausedAt: z.ZodString;
+        pausedBy: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        relatedTaskId: string;
+        pausedAt: string;
+        pausedBy: string;
+    }, {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        pausedAt: string;
+        relatedTaskId?: string | undefined;
+        pausedBy?: string | undefined;
+    }>>>;
+    /** Append-only checkpoint history retained after each resume. */
+    pauseHistory: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        /** Why work stopped or changed focus. */
+        reason: z.ZodString;
+        /** Concrete checkpoint: what was underway when the task was paused. */
+        whatWasBeingDone: z.ZodString;
+        /** File, symbol, command, or other exact location from which to continue. */
+        resumeLocation: z.ZodString;
+        /** Ordered, actionable instructions for resuming the task. */
+        howToResume: z.ZodString;
+        /** Optional temporary/prerequisite task that caused the pause. */
+        relatedTaskId: z.ZodDefault<z.ZodString>;
+        pausedAt: z.ZodString;
+        pausedBy: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        relatedTaskId: string;
+        pausedAt: string;
+        pausedBy: string;
+    }, {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        pausedAt: string;
+        relatedTaskId?: string | undefined;
+        pausedBy?: string | undefined;
+    }>, "many">>;
     startedAt: z.ZodDefault<z.ZodString>;
     completedAt: z.ZodDefault<z.ZodString>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     number: number;
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     notes: string;
     id: string;
@@ -718,13 +971,14 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     shortId: string;
     priority: number;
     shortName: string;
+    descriptionUpdatedAt: string;
     statusLog: {
         id: string;
         date: string;
         title: string;
         description: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     }[];
     checklist: (string | {
         number: number;
@@ -733,7 +987,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         checked: boolean;
     })[];
     subtasks: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -741,10 +995,30 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         description: string;
     }[];
     dependsOn: string[];
+    pauseSnapshot: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        relatedTaskId: string;
+        pausedAt: string;
+        pausedBy: string;
+    } | null;
+    pauseHistory: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        relatedTaskId: string;
+        pausedAt: string;
+        pausedBy: string;
+    }[];
     startedAt: string;
     completedAt: string;
 }, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
@@ -765,12 +1039,13 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     shortId?: string | undefined;
     priority?: number | undefined;
+    descriptionUpdatedAt?: string | undefined;
     statusLog?: {
         id: string;
         date: string;
         title: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         description?: string | undefined;
     }[] | undefined;
     checklist?: (string | {
@@ -780,7 +1055,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         checked?: boolean | undefined;
     })[] | undefined;
     subtasks?: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -788,6 +1063,26 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         description?: string | undefined;
     }[] | undefined;
     dependsOn?: string[] | undefined;
+    pauseSnapshot?: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        pausedAt: string;
+        relatedTaskId?: string | undefined;
+        pausedBy?: string | undefined;
+    } | null | undefined;
+    pauseHistory?: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        pausedAt: string;
+        relatedTaskId?: string | undefined;
+        pausedBy?: string | undefined;
+    }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
 }>, {
@@ -798,7 +1093,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         checked: boolean;
     }[];
     number: number;
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     notes: string;
     id: string;
@@ -818,16 +1113,17 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     shortId: string;
     priority: number;
     shortName: string;
+    descriptionUpdatedAt: string;
     statusLog: {
         id: string;
         date: string;
         title: string;
         description: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     }[];
     subtasks: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -835,10 +1131,30 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         description: string;
     }[];
     dependsOn: string[];
+    pauseSnapshot: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        relatedTaskId: string;
+        pausedAt: string;
+        pausedBy: string;
+    } | null;
+    pauseHistory: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        relatedTaskId: string;
+        pausedAt: string;
+        pausedBy: string;
+    }[];
     startedAt: string;
     completedAt: string;
 }, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
@@ -859,12 +1175,13 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     shortId?: string | undefined;
     priority?: number | undefined;
+    descriptionUpdatedAt?: string | undefined;
     statusLog?: {
         id: string;
         date: string;
         title: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         description?: string | undefined;
     }[] | undefined;
     checklist?: (string | {
@@ -874,7 +1191,7 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         checked?: boolean | undefined;
     })[] | undefined;
     subtasks?: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -882,6 +1199,26 @@ export declare const TaskSchema: z.ZodEffects<z.ZodObject<{
         description?: string | undefined;
     }[] | undefined;
     dependsOn?: string[] | undefined;
+    pauseSnapshot?: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        pausedAt: string;
+        relatedTaskId?: string | undefined;
+        pausedBy?: string | undefined;
+    } | null | undefined;
+    pauseHistory?: {
+        id: string;
+        reason: string;
+        whatWasBeingDone: string;
+        resumeLocation: string;
+        howToResume: string;
+        pausedAt: string;
+        relatedTaskId?: string | undefined;
+        pausedBy?: string | undefined;
+    }[] | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
 }>;
@@ -917,6 +1254,8 @@ export declare const PhaseSchema: z.ZodObject<{
     contextReadyReason: z.ZodDefault<z.ZodString>;
     summary: z.ZodDefault<z.ZodString>;
     description: z.ZodDefault<z.ZodString>;
+    /** Updated only when this phase's description changes; distinct from entity updatedAt. */
+    descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
     notes: z.ZodDefault<z.ZodString>;
     goals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     nonGoals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -960,14 +1299,16 @@ export declare const PhaseSchema: z.ZodObject<{
         priority: z.ZodDefault<z.ZodNumber>;
         shortName: z.ZodString;
         title: z.ZodString;
-        status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         description: z.ZodDefault<z.ZodString>;
+        /** Updated only when this task's description changes; distinct from entity updatedAt. */
+        descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
         notes: z.ZodDefault<z.ZodString>;
         statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             date: z.ZodString;
-            fromStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-            toStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            fromStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            toStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             title: z.ZodString;
             description: z.ZodDefault<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
@@ -975,14 +1316,14 @@ export declare const PhaseSchema: z.ZodObject<{
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }, {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             description?: string | undefined;
         }>, "many">>;
         decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -1030,19 +1371,19 @@ export declare const PhaseSchema: z.ZodObject<{
         subtasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             title: z.ZodString;
-            status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             description: z.ZodDefault<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description: string;
         }, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1050,13 +1391,81 @@ export declare const PhaseSchema: z.ZodObject<{
             description?: string | undefined;
         }>, "many">>;
         dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Current durable checkpoint while this task is paused. */
+        pauseSnapshot: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            /** Why work stopped or changed focus. */
+            reason: z.ZodString;
+            /** Concrete checkpoint: what was underway when the task was paused. */
+            whatWasBeingDone: z.ZodString;
+            /** File, symbol, command, or other exact location from which to continue. */
+            resumeLocation: z.ZodString;
+            /** Ordered, actionable instructions for resuming the task. */
+            howToResume: z.ZodString;
+            /** Optional temporary/prerequisite task that caused the pause. */
+            relatedTaskId: z.ZodDefault<z.ZodString>;
+            pausedAt: z.ZodString;
+            pausedBy: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        }, {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        }>>>;
+        /** Append-only checkpoint history retained after each resume. */
+        pauseHistory: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            /** Why work stopped or changed focus. */
+            reason: z.ZodString;
+            /** Concrete checkpoint: what was underway when the task was paused. */
+            whatWasBeingDone: z.ZodString;
+            /** File, symbol, command, or other exact location from which to continue. */
+            resumeLocation: z.ZodString;
+            /** Ordered, actionable instructions for resuming the task. */
+            howToResume: z.ZodString;
+            /** Optional temporary/prerequisite task that caused the pause. */
+            relatedTaskId: z.ZodDefault<z.ZodString>;
+            pausedAt: z.ZodString;
+            pausedBy: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        }, {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        }>, "many">>;
         startedAt: z.ZodDefault<z.ZodString>;
         completedAt: z.ZodDefault<z.ZodString>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         number: number;
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         notes: string;
         id: string;
@@ -1076,13 +1485,14 @@ export declare const PhaseSchema: z.ZodObject<{
         shortId: string;
         priority: number;
         shortName: string;
+        descriptionUpdatedAt: string;
         statusLog: {
             id: string;
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }[];
         checklist: (string | {
             number: number;
@@ -1091,7 +1501,7 @@ export declare const PhaseSchema: z.ZodObject<{
             checked: boolean;
         })[];
         subtasks: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1099,10 +1509,30 @@ export declare const PhaseSchema: z.ZodObject<{
             description: string;
         }[];
         dependsOn: string[];
+        pauseSnapshot: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        } | null;
+        pauseHistory: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        }[];
         startedAt: string;
         completedAt: string;
     }, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -1123,12 +1553,13 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         shortId?: string | undefined;
         priority?: number | undefined;
+        descriptionUpdatedAt?: string | undefined;
         statusLog?: {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             description?: string | undefined;
         }[] | undefined;
         checklist?: (string | {
@@ -1138,7 +1569,7 @@ export declare const PhaseSchema: z.ZodObject<{
             checked?: boolean | undefined;
         })[] | undefined;
         subtasks?: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1146,6 +1577,26 @@ export declare const PhaseSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
+        pauseSnapshot?: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        } | null | undefined;
+        pauseHistory?: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
     }>, {
@@ -1156,7 +1607,7 @@ export declare const PhaseSchema: z.ZodObject<{
             checked: boolean;
         }[];
         number: number;
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         notes: string;
         id: string;
@@ -1176,16 +1627,17 @@ export declare const PhaseSchema: z.ZodObject<{
         shortId: string;
         priority: number;
         shortName: string;
+        descriptionUpdatedAt: string;
         statusLog: {
             id: string;
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }[];
         subtasks: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1193,10 +1645,30 @@ export declare const PhaseSchema: z.ZodObject<{
             description: string;
         }[];
         dependsOn: string[];
+        pauseSnapshot: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        } | null;
+        pauseHistory: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        }[];
         startedAt: string;
         completedAt: string;
     }, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -1217,12 +1689,13 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         shortId?: string | undefined;
         priority?: number | undefined;
+        descriptionUpdatedAt?: string | undefined;
         statusLog?: {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             description?: string | undefined;
         }[] | undefined;
         checklist?: (string | {
@@ -1232,7 +1705,7 @@ export declare const PhaseSchema: z.ZodObject<{
             checked?: boolean | undefined;
         })[] | undefined;
         subtasks?: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1240,6 +1713,26 @@ export declare const PhaseSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
+        pauseSnapshot?: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        } | null | undefined;
+        pauseHistory?: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
     }>, "many">>;
@@ -1275,8 +1768,8 @@ export declare const PhaseSchema: z.ZodObject<{
     statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         date: z.ZodString;
-        fromStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-        toStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        fromStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        toStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         title: z.ZodString;
         description: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -1284,14 +1777,14 @@ export declare const PhaseSchema: z.ZodObject<{
         date: string;
         title: string;
         description: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
     }, {
         id: string;
         date: string;
         title: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         description?: string | undefined;
     }>, "many">>;
 }, "strip", z.ZodTypeAny, {
@@ -1315,13 +1808,14 @@ export declare const PhaseSchema: z.ZodObject<{
     }[];
     shortId: string;
     priority: number;
+    descriptionUpdatedAt: string;
     statusLog: {
         id: string;
         date: string;
         title: string;
         description: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
     }[];
     dependsOn: string[];
     slug: string;
@@ -1342,7 +1836,7 @@ export declare const PhaseSchema: z.ZodObject<{
             checked: boolean;
         }[];
         number: number;
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         notes: string;
         id: string;
@@ -1362,16 +1856,17 @@ export declare const PhaseSchema: z.ZodObject<{
         shortId: string;
         priority: number;
         shortName: string;
+        descriptionUpdatedAt: string;
         statusLog: {
             id: string;
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }[];
         subtasks: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1379,6 +1874,26 @@ export declare const PhaseSchema: z.ZodObject<{
             description: string;
         }[];
         dependsOn: string[];
+        pauseSnapshot: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        } | null;
+        pauseHistory: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            relatedTaskId: string;
+            pausedAt: string;
+            pausedBy: string;
+        }[];
         startedAt: string;
         completedAt: string;
     }[];
@@ -1413,12 +1928,13 @@ export declare const PhaseSchema: z.ZodObject<{
     }[] | undefined;
     shortId?: string | undefined;
     priority?: number | undefined;
+    descriptionUpdatedAt?: string | undefined;
     statusLog?: {
         id: string;
         date: string;
         title: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         description?: string | undefined;
     }[] | undefined;
     dependsOn?: string[] | undefined;
@@ -1433,7 +1949,7 @@ export declare const PhaseSchema: z.ZodObject<{
     completionCriteria?: string[] | undefined;
     taskIds?: string[] | undefined;
     tasks?: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -1454,12 +1970,13 @@ export declare const PhaseSchema: z.ZodObject<{
         }[] | undefined;
         shortId?: string | undefined;
         priority?: number | undefined;
+        descriptionUpdatedAt?: string | undefined;
         statusLog?: {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             description?: string | undefined;
         }[] | undefined;
         checklist?: (string | {
@@ -1469,7 +1986,7 @@ export declare const PhaseSchema: z.ZodObject<{
             checked?: boolean | undefined;
         })[] | undefined;
         subtasks?: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1477,6 +1994,26 @@ export declare const PhaseSchema: z.ZodObject<{
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
+        pauseSnapshot?: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        } | null | undefined;
+        pauseHistory?: {
+            id: string;
+            reason: string;
+            whatWasBeingDone: string;
+            resumeLocation: string;
+            howToResume: string;
+            pausedAt: string;
+            relatedTaskId?: string | undefined;
+            pausedBy?: string | undefined;
+        }[] | undefined;
         startedAt?: string | undefined;
         completedAt?: string | undefined;
     }[] | undefined;
@@ -1497,6 +2034,8 @@ export declare const FeatureSchema: z.ZodObject<{
     priority: z.ZodDefault<z.ZodNumber>;
     name: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
+    /** Updated only when this feature's description changes; distinct from entity updatedAt. */
+    descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
     discussedAt: z.ZodDefault<z.ZodString>;
     contextReady: z.ZodDefault<z.ZodBoolean>;
     contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -1532,8 +2071,8 @@ export declare const FeatureSchema: z.ZodObject<{
     statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         date: z.ZodString;
-        fromStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-        toStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        fromStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+        toStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         title: z.ZodString;
         description: z.ZodDefault<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -1541,14 +2080,14 @@ export declare const FeatureSchema: z.ZodObject<{
         date: string;
         title: string;
         description: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     }, {
         id: string;
         date: string;
         title: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         description?: string | undefined;
     }>, "many">>;
     createdAt: z.ZodString;
@@ -1570,13 +2109,14 @@ export declare const FeatureSchema: z.ZodObject<{
     }[];
     shortId: string;
     priority: number;
+    descriptionUpdatedAt: string;
     statusLog: {
         id: string;
         date: string;
         title: string;
         description: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     }[];
     dependsOn: string[];
     discussedAt: string;
@@ -1604,12 +2144,13 @@ export declare const FeatureSchema: z.ZodObject<{
     }[] | undefined;
     shortId?: string | undefined;
     priority?: number | undefined;
+    descriptionUpdatedAt?: string | undefined;
     statusLog?: {
         id: string;
         date: string;
         title: string;
-        fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-        toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         description?: string | undefined;
     }[] | undefined;
     dependsOn?: string[] | undefined;
@@ -1631,6 +2172,8 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         priority: z.ZodDefault<z.ZodNumber>;
         name: z.ZodString;
         description: z.ZodDefault<z.ZodString>;
+        /** Updated only when this feature's description changes; distinct from entity updatedAt. */
+        descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
         discussedAt: z.ZodDefault<z.ZodString>;
         contextReady: z.ZodDefault<z.ZodBoolean>;
         contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -1666,8 +2209,8 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             date: z.ZodString;
-            fromStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-            toStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            fromStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            toStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             title: z.ZodString;
             description: z.ZodDefault<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
@@ -1675,14 +2218,14 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }, {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             description?: string | undefined;
         }>, "many">>;
         createdAt: z.ZodString;
@@ -1704,13 +2247,14 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         }[];
         shortId: string;
         priority: number;
+        descriptionUpdatedAt: string;
         statusLog: {
             id: string;
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }[];
         dependsOn: string[];
         discussedAt: string;
@@ -1738,12 +2282,13 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         }[] | undefined;
         shortId?: string | undefined;
         priority?: number | undefined;
+        descriptionUpdatedAt?: string | undefined;
         statusLog?: {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
@@ -1774,13 +2319,14 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         }[];
         shortId: string;
         priority: number;
+        descriptionUpdatedAt: string;
         statusLog: {
             id: string;
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         }[];
         dependsOn: string[];
         discussedAt: string;
@@ -1810,12 +2356,13 @@ export declare const FeaturesDocumentSchema: z.ZodObject<{
         }[] | undefined;
         shortId?: string | undefined;
         priority?: number | undefined;
+        descriptionUpdatedAt?: string | undefined;
         statusLog?: {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
@@ -1833,18 +2380,18 @@ export declare const MacroTaskSchema: 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"]>;
+    status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
     title: string;
     description: string;
 }, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
@@ -1855,23 +2402,23 @@ 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"]>;
+    status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
     macroTasks: z.ZodDefault<z.ZodArray<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"]>;
+        status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
         description: string;
     }, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -1882,14 +2429,14 @@ export declare const RequirementSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
     title: string;
     description: string;
     macroTasks: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -1898,14 +2445,14 @@ export declare const RequirementSchema: z.ZodObject<{
     }[];
     linkedPhaseIds: string[];
 }, {
-    status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+    status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
     updatedAt: string;
     id: string;
     createdAt: string;
     title: string;
     description?: string | undefined;
     macroTasks?: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
@@ -1919,23 +2466,23 @@ 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"]>;
+        status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
         macroTasks: z.ZodDefault<z.ZodArray<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"]>;
+            status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description: string;
         }, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1946,14 +2493,14 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         createdAt: z.ZodString;
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
         description: string;
         macroTasks: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1962,14 +2509,14 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
         }[];
         linkedPhaseIds: string[];
     }, {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
         description?: string | undefined;
         macroTasks?: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1980,14 +2527,14 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     requirements: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
         description: string;
         macroTasks: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -1998,14 +2545,14 @@ export declare const RequirementsDocumentSchema: z.ZodObject<{
     }[];
 }, {
     requirements: {
-        status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+        status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
         updatedAt: string;
         id: string;
         createdAt: string;
         title: string;
         description?: string | undefined;
         macroTasks?: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -2097,24 +2644,75 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             /** Task to surface explicitly after the temporary work is resolved. */
             resumeTaskId: z.ZodString;
             reason: z.ZodDefault<z.ZodString>;
+            /** Durable checkpoint captured when the resume task was paused. */
+            snapshot: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                /** Why work stopped or changed focus. */
+                reason: z.ZodString;
+                /** Concrete checkpoint: what was underway when the task was paused. */
+                whatWasBeingDone: z.ZodString;
+                /** File, symbol, command, or other exact location from which to continue. */
+                resumeLocation: z.ZodString;
+                /** Ordered, actionable instructions for resuming the task. */
+                howToResume: z.ZodString;
+                /** Optional temporary/prerequisite task that caused the pause. */
+                relatedTaskId: z.ZodDefault<z.ZodString>;
+                pausedAt: z.ZodString;
+                pausedBy: z.ZodDefault<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            }, {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            }>>>;
             requestedBy: z.ZodDefault<z.ZodEnum<["agent", "user"]>>;
             approvedBy: z.ZodDefault<z.ZodString>;
-            state: z.ZodDefault<z.ZodEnum<["approved", "active", "resolved", "canceled"]>>;
+            state: z.ZodDefault<z.ZodEnum<["approved", "active", "resume-required", "resolved", "resumed", "canceled"]>>;
             createdAt: z.ZodString;
             activatedAt: z.ZodDefault<z.ZodString>;
+            /** When temporary work ended and the resume target became mandatory. */
+            resumeRequiredAt: z.ZodDefault<z.ZodString>;
+            /** Legacy temporary-work completion timestamp. */
             resolvedAt: z.ZodDefault<z.ZodString>;
+            /** When the preserved resume target was actually started again. */
+            resumedAt: z.ZodDefault<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             id: string;
             createdAt: string;
+            reason: string;
             recommendedTaskId: string;
             temporaryTaskId: string;
             resumeTaskId: string;
-            reason: 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" | "resolved" | "canceled";
+            state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
             activatedAt: string;
+            resumeRequiredAt: string;
             resolvedAt: string;
+            resumedAt: string;
         }, {
             id: string;
             createdAt: string;
@@ -2122,11 +2720,23 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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" | "resolved" | "canceled" | undefined;
+            state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
             activatedAt?: string | undefined;
+            resumeRequiredAt?: string | undefined;
             resolvedAt?: string | undefined;
+            resumedAt?: string | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
@@ -2160,15 +2770,27 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         workDeviations: {
             id: string;
             createdAt: string;
+            reason: string;
             recommendedTaskId: string;
             temporaryTaskId: string;
             resumeTaskId: string;
-            reason: 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" | "resolved" | "canceled";
+            state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
             activatedAt: string;
+            resumeRequiredAt: string;
             resolvedAt: string;
+            resumedAt: string;
         }[];
     }, {
         name: string;
@@ -2206,11 +2828,23 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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" | "resolved" | "canceled" | undefined;
+            state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
             activatedAt?: string | undefined;
+            resumeRequiredAt?: string | undefined;
             resolvedAt?: string | undefined;
+            resumedAt?: string | undefined;
         }[] | undefined;
     }>;
     features: z.ZodObject<{
@@ -2222,6 +2856,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             priority: z.ZodDefault<z.ZodNumber>;
             name: z.ZodString;
             description: z.ZodDefault<z.ZodString>;
+            /** Updated only when this feature's description changes; distinct from entity updatedAt. */
+            descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
             discussedAt: z.ZodDefault<z.ZodString>;
             contextReady: z.ZodDefault<z.ZodBoolean>;
             contextReadyReason: z.ZodDefault<z.ZodString>;
@@ -2257,8 +2893,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 date: z.ZodString;
-                fromStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-                toStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+                fromStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+                toStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
                 title: z.ZodString;
                 description: z.ZodDefault<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
@@ -2266,14 +2902,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }, {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }>, "many">>;
             createdAt: z.ZodString;
@@ -2295,13 +2931,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             shortId: string;
             priority: number;
+            descriptionUpdatedAt: string;
             statusLog: {
                 id: string;
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             dependsOn: string[];
             discussedAt: string;
@@ -2329,12 +2966,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             shortId?: string | undefined;
             priority?: number | undefined;
+            descriptionUpdatedAt?: string | undefined;
             statusLog?: {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
@@ -2365,13 +3003,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             shortId: string;
             priority: number;
+            descriptionUpdatedAt: string;
             statusLog: {
                 id: string;
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             dependsOn: string[];
             discussedAt: string;
@@ -2401,12 +3040,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             shortId?: string | undefined;
             priority?: number | undefined;
+            descriptionUpdatedAt?: string | undefined;
             statusLog?: {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
@@ -2425,23 +3065,23 @@ 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"]>;
+            status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             macroTasks: z.ZodDefault<z.ZodArray<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"]>;
+                status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
                 title: string;
                 description: string;
             }, {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2452,14 +3092,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description: string;
             macroTasks: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2468,14 +3108,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             linkedPhaseIds: string[];
         }, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description?: string | undefined;
             macroTasks?: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2486,14 +3126,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description: string;
             macroTasks: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2504,14 +3144,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[];
     }, {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description?: string | undefined;
             macroTasks?: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2538,6 +3178,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         contextReadyReason: z.ZodDefault<z.ZodString>;
         summary: z.ZodDefault<z.ZodString>;
         description: z.ZodDefault<z.ZodString>;
+        /** Updated only when this phase's description changes; distinct from entity updatedAt. */
+        descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
         notes: z.ZodDefault<z.ZodString>;
         goals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         nonGoals: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -2581,14 +3223,16 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             priority: z.ZodDefault<z.ZodNumber>;
             shortName: z.ZodString;
             title: z.ZodString;
-            status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             description: z.ZodDefault<z.ZodString>;
+            /** Updated only when this task's description changes; distinct from entity updatedAt. */
+            descriptionUpdatedAt: z.ZodDefault<z.ZodString>;
             notes: z.ZodDefault<z.ZodString>;
             statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 date: z.ZodString;
-                fromStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-                toStatus: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+                fromStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+                toStatus: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
                 title: z.ZodString;
                 description: z.ZodDefault<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
@@ -2596,14 +3240,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }, {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }>, "many">>;
             decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
@@ -2651,19 +3295,19 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             subtasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 title: z.ZodString;
-                status: z.ZodEnum<["planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+                status: z.ZodEnum<["planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
                 description: z.ZodDefault<z.ZodString>;
                 createdAt: z.ZodString;
                 updatedAt: z.ZodString;
             }, "strip", z.ZodTypeAny, {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
                 title: string;
                 description: string;
             }, {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2671,13 +3315,81 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }>, "many">>;
             dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            /** Current durable checkpoint while this task is paused. */
+            pauseSnapshot: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                id: z.ZodString;
+                /** Why work stopped or changed focus. */
+                reason: z.ZodString;
+                /** Concrete checkpoint: what was underway when the task was paused. */
+                whatWasBeingDone: z.ZodString;
+                /** File, symbol, command, or other exact location from which to continue. */
+                resumeLocation: z.ZodString;
+                /** Ordered, actionable instructions for resuming the task. */
+                howToResume: z.ZodString;
+                /** Optional temporary/prerequisite task that caused the pause. */
+                relatedTaskId: z.ZodDefault<z.ZodString>;
+                pausedAt: z.ZodString;
+                pausedBy: z.ZodDefault<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            }, {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            }>>>;
+            /** Append-only checkpoint history retained after each resume. */
+            pauseHistory: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                /** Why work stopped or changed focus. */
+                reason: z.ZodString;
+                /** Concrete checkpoint: what was underway when the task was paused. */
+                whatWasBeingDone: z.ZodString;
+                /** File, symbol, command, or other exact location from which to continue. */
+                resumeLocation: z.ZodString;
+                /** Ordered, actionable instructions for resuming the task. */
+                howToResume: z.ZodString;
+                /** Optional temporary/prerequisite task that caused the pause. */
+                relatedTaskId: z.ZodDefault<z.ZodString>;
+                pausedAt: z.ZodString;
+                pausedBy: z.ZodDefault<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            }, {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            }>, "many">>;
             startedAt: z.ZodDefault<z.ZodString>;
             completedAt: z.ZodDefault<z.ZodString>;
             createdAt: z.ZodString;
             updatedAt: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             number: number;
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             notes: string;
             id: string;
@@ -2697,13 +3409,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortId: string;
             priority: number;
             shortName: string;
+            descriptionUpdatedAt: string;
             statusLog: {
                 id: string;
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             checklist: (string | {
                 number: number;
@@ -2712,7 +3425,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked: boolean;
             })[];
             subtasks: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2720,10 +3433,30 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description: string;
             }[];
             dependsOn: string[];
+            pauseSnapshot: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            } | null;
+            pauseHistory: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            }[];
             startedAt: string;
             completedAt: string;
         }, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -2744,12 +3477,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             shortId?: string | undefined;
             priority?: number | undefined;
+            descriptionUpdatedAt?: string | undefined;
             statusLog?: {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }[] | undefined;
             checklist?: (string | {
@@ -2759,7 +3493,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked?: boolean | undefined;
             })[] | undefined;
             subtasks?: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2767,6 +3501,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
+            pauseSnapshot?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            } | null | undefined;
+            pauseHistory?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
         }>, {
@@ -2777,7 +3531,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked: boolean;
             }[];
             number: number;
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             notes: string;
             id: string;
@@ -2797,16 +3551,17 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortId: string;
             priority: number;
             shortName: string;
+            descriptionUpdatedAt: string;
             statusLog: {
                 id: string;
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             subtasks: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2814,10 +3569,30 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description: string;
             }[];
             dependsOn: string[];
+            pauseSnapshot: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            } | null;
+            pauseHistory: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            }[];
             startedAt: string;
             completedAt: string;
         }, {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -2838,12 +3613,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             shortId?: string | undefined;
             priority?: number | undefined;
+            descriptionUpdatedAt?: string | undefined;
             statusLog?: {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }[] | undefined;
             checklist?: (string | {
@@ -2853,7 +3629,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked?: boolean | undefined;
             })[] | undefined;
             subtasks?: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -2861,6 +3637,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
+            pauseSnapshot?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            } | null | undefined;
+            pauseHistory?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
         }>, "many">>;
@@ -2896,8 +3692,8 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         statusLog: z.ZodDefault<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             date: z.ZodString;
-            fromStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
-            toStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            fromStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
+            toStatus: z.ZodEnum<["draft", "discovery", "planned", "in-progress", "paused", "done", "blocked", "canceled", "rejected", "deferred", "waiting"]>;
             title: z.ZodString;
             description: z.ZodDefault<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
@@ -2905,14 +3701,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         }, {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
             description?: string | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
@@ -2936,13 +3732,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[];
         shortId: string;
         priority: number;
+        descriptionUpdatedAt: string;
         statusLog: {
             id: string;
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         }[];
         dependsOn: string[];
         slug: string;
@@ -2963,7 +3760,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked: boolean;
             }[];
             number: number;
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             notes: string;
             id: string;
@@ -2983,16 +3780,17 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortId: string;
             priority: number;
             shortName: string;
+            descriptionUpdatedAt: string;
             statusLog: {
                 id: string;
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             subtasks: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -3000,6 +3798,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description: string;
             }[];
             dependsOn: string[];
+            pauseSnapshot: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            } | null;
+            pauseHistory: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            }[];
             startedAt: string;
             completedAt: string;
         }[];
@@ -3034,12 +3852,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[] | undefined;
         shortId?: string | undefined;
         priority?: number | undefined;
+        descriptionUpdatedAt?: string | undefined;
         statusLog?: {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
@@ -3054,7 +3873,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         completionCriteria?: string[] | undefined;
         taskIds?: string[] | undefined;
         tasks?: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -3075,12 +3894,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             shortId?: string | undefined;
             priority?: number | undefined;
+            descriptionUpdatedAt?: string | undefined;
             statusLog?: {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }[] | undefined;
             checklist?: (string | {
@@ -3090,7 +3910,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked?: boolean | undefined;
             })[] | undefined;
             subtasks?: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -3098,6 +3918,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
+            pauseSnapshot?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            } | null | undefined;
+            pauseHistory?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
         }[] | undefined;
@@ -3129,13 +3969,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[];
             shortId: string;
             priority: number;
+            descriptionUpdatedAt: string;
             statusLog: {
                 id: string;
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             dependsOn: string[];
             discussedAt: string;
@@ -3150,14 +3991,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     };
     requirements: {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description: string;
             macroTasks: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -3206,15 +4047,27 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         workDeviations: {
             id: string;
             createdAt: string;
+            reason: string;
             recommendedTaskId: string;
             temporaryTaskId: string;
             resumeTaskId: string;
-            reason: 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" | "resolved" | "canceled";
+            state: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled";
             activatedAt: string;
+            resumeRequiredAt: string;
             resolvedAt: string;
+            resumedAt: string;
         }[];
     };
     phases: {
@@ -3238,13 +4091,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[];
         shortId: string;
         priority: number;
+        descriptionUpdatedAt: string;
         statusLog: {
             id: string;
             date: string;
             title: string;
             description: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
         }[];
         dependsOn: string[];
         slug: string;
@@ -3265,7 +4119,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked: boolean;
             }[];
             number: number;
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             notes: string;
             id: string;
@@ -3285,16 +4139,17 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             shortId: string;
             priority: number;
             shortName: string;
+            descriptionUpdatedAt: string;
             statusLog: {
                 id: string;
                 date: string;
                 title: string;
                 description: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             }[];
             subtasks: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -3302,6 +4157,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description: string;
             }[];
             dependsOn: string[];
+            pauseSnapshot: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            } | null;
+            pauseHistory: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                relatedTaskId: string;
+                pausedAt: string;
+                pausedBy: string;
+            }[];
             startedAt: string;
             completedAt: string;
         }[];
@@ -3334,12 +4209,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             shortId?: string | undefined;
             priority?: number | undefined;
+            descriptionUpdatedAt?: string | undefined;
             statusLog?: {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
@@ -3355,14 +4231,14 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
     };
     requirements: {
         requirements: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
             title: string;
             description?: string | undefined;
             macroTasks?: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -3415,11 +4291,23 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             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" | "resolved" | "canceled" | undefined;
+            state?: "approved" | "active" | "resume-required" | "resolved" | "resumed" | "canceled" | undefined;
             activatedAt?: string | undefined;
+            resumeRequiredAt?: string | undefined;
             resolvedAt?: string | undefined;
+            resumedAt?: string | undefined;
         }[] | undefined;
     };
     phases: {
@@ -3444,12 +4332,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         }[] | undefined;
         shortId?: string | undefined;
         priority?: number | undefined;
+        descriptionUpdatedAt?: string | undefined;
         statusLog?: {
             id: string;
             date: string;
             title: string;
-            fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
-            toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
+            toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting" | "draft" | "discovery";
             description?: string | undefined;
         }[] | undefined;
         dependsOn?: string[] | undefined;
@@ -3464,7 +4353,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
         completionCriteria?: string[] | undefined;
         taskIds?: string[] | undefined;
         tasks?: {
-            status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+            status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
             updatedAt: string;
             id: string;
             createdAt: string;
@@ -3485,12 +4374,13 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
             }[] | undefined;
             shortId?: string | undefined;
             priority?: number | undefined;
+            descriptionUpdatedAt?: string | undefined;
             statusLog?: {
                 id: string;
                 date: string;
                 title: string;
-                fromStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
-                toStatus: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                fromStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                toStatus: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 description?: string | undefined;
             }[] | undefined;
             checklist?: (string | {
@@ -3500,7 +4390,7 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 checked?: boolean | undefined;
             })[] | undefined;
             subtasks?: {
-                status: "canceled" | "planned" | "in-progress" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
+                status: "canceled" | "planned" | "in-progress" | "paused" | "done" | "blocked" | "rejected" | "deferred" | "waiting";
                 updatedAt: string;
                 id: string;
                 createdAt: string;
@@ -3508,6 +4398,26 @@ export declare const PlanWorkspaceSchema: z.ZodObject<{
                 description?: string | undefined;
             }[] | undefined;
             dependsOn?: string[] | undefined;
+            pauseSnapshot?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            } | null | undefined;
+            pauseHistory?: {
+                id: string;
+                reason: string;
+                whatWasBeingDone: string;
+                resumeLocation: string;
+                howToResume: string;
+                pausedAt: string;
+                relatedTaskId?: string | undefined;
+                pausedBy?: string | undefined;
+            }[] | undefined;
             startedAt?: string | undefined;
             completedAt?: string | undefined;
         }[] | undefined;
@@ -3544,6 +4454,7 @@ export type WorkflowRules = z.infer<typeof WorkflowRulesSchema>;
 export type AcceptedDecision = z.infer<typeof AcceptedDecisionSchema>;
 export type Project = z.infer<typeof ProjectSchema>;
 export type WorkDeviation = z.infer<typeof WorkDeviationSchema>;
+export type TaskPauseSnapshot = z.infer<typeof TaskPauseSnapshotSchema>;
 export type Subtask = z.infer<typeof SubtaskSchema>;
 export type ChecklistItem = z.infer<typeof ChecklistItemSchema>;
 export type StatusLogEntry = z.infer<typeof StatusLogEntrySchema>;