auto-claude: subtask-1-2 - Create roadmap feature state machine

Add roadmap-feature-machine.ts with states: under_review, planned, in_progress, done. Handles LINK_SPEC auto-transition to in_progress, task completion events from in_progress only, REVERT from done restoring previousStatus via guards, and context cleanup on non-done transitions. Co-Authored-By: Claude Opus 4.6 <[email protected]>
2026-02-17 15:32:30 +01:00
parent 11e300c75d
commit 906b1f29c4
1 changed files with 149 additions and 0 deletions
@@ -0,0 +1,149 @@
+import { assign, createMachine } from 'xstate';
+
+export interface RoadmapFeatureContext {
+  linkedSpecId?: string;
+  taskOutcome?: string;
+  previousStatus?: string;
+}
+
+export type RoadmapFeatureEvent =
+  | { type: 'PLAN' }
+  | { type: 'START_PROGRESS' }
+  | { type: 'MARK_DONE' }
+  | { type: 'LINK_SPEC'; specId: string }
+  | { type: 'TASK_COMPLETED' }
+  | { type: 'TASK_DELETED' }
+  | { type: 'TASK_ARCHIVED' }
+  | { type: 'REVERT' }
+  | { type: 'MOVE_TO_REVIEW' };
+
+export const roadmapFeatureMachine = createMachine(
+  {
+    id: 'roadmapFeature',
+    initial: 'under_review',
+    types: {} as {
+      context: RoadmapFeatureContext;
+      events: RoadmapFeatureEvent;
+    },
+    context: {
+      linkedSpecId: undefined,
+      taskOutcome: undefined,
+      previousStatus: undefined
+    },
+    states: {
+      under_review: {
+        on: {
+          PLAN: 'planned',
+          START_PROGRESS: 'in_progress',
+          LINK_SPEC: {
+            target: 'in_progress',
+            actions: 'setLinkedSpec'
+          },
+          MARK_DONE: {
+            target: 'done',
+            actions: 'savePreviousUnderReview'
+          }
+        }
+      },
+      planned: {
+        on: {
+          START_PROGRESS: 'in_progress',
+          LINK_SPEC: {
+            target: 'in_progress',
+            actions: 'setLinkedSpec'
+          },
+          MARK_DONE: {
+            target: 'done',
+            actions: 'savePreviousPlanned'
+          },
+          MOVE_TO_REVIEW: 'under_review'
+        }
+      },
+      in_progress: {
+        on: {
+          TASK_COMPLETED: {
+            target: 'done',
+            actions: ['savePreviousInProgress', 'setTaskOutcomeCompleted']
+          },
+          TASK_DELETED: {
+            target: 'done',
+            actions: ['savePreviousInProgress', 'setTaskOutcomeDeleted']
+          },
+          TASK_ARCHIVED: {
+            target: 'done',
+            actions: ['savePreviousInProgress', 'setTaskOutcomeArchived']
+          },
+          MARK_DONE: {
+            target: 'done',
+            actions: 'savePreviousInProgress'
+          },
+          MOVE_TO_REVIEW: {
+            target: 'under_review',
+            actions: 'clearDoneContext'
+          },
+          PLAN: {
+            target: 'planned',
+            actions: 'clearDoneContext'
+          },
+          LINK_SPEC: {
+            actions: 'setLinkedSpec'
+          }
+        }
+      },
+      done: {
+        on: {
+          REVERT: [
+            {
+              target: 'in_progress',
+              guard: 'previousWasInProgress',
+              actions: 'clearDoneContext'
+            },
+            {
+              target: 'planned',
+              guard: 'previousWasPlanned',
+              actions: 'clearDoneContext'
+            },
+            {
+              target: 'under_review',
+              actions: 'clearDoneContext'
+            }
+          ],
+          MOVE_TO_REVIEW: {
+            target: 'under_review',
+            actions: 'clearDoneContext'
+          },
+          PLAN: {
+            target: 'planned',
+            actions: 'clearDoneContext'
+          },
+          START_PROGRESS: {
+            target: 'in_progress',
+            actions: 'clearDoneContext'
+          }
+        }
+      }
+    }
+  },
+  {
+    guards: {
+      previousWasInProgress: ({ context }) => context.previousStatus === 'in_progress',
+      previousWasPlanned: ({ context }) => context.previousStatus === 'planned'
+    },
+    actions: {
+      setLinkedSpec: assign({
+        linkedSpecId: ({ event }) =>
+          event.type === 'LINK_SPEC' ? event.specId : undefined
+      }),
+      savePreviousUnderReview: assign({ previousStatus: () => 'under_review' }),
+      savePreviousPlanned: assign({ previousStatus: () => 'planned' }),
+      savePreviousInProgress: assign({ previousStatus: () => 'in_progress' }),
+      setTaskOutcomeCompleted: assign({ taskOutcome: () => 'completed' }),
+      setTaskOutcomeDeleted: assign({ taskOutcome: () => 'deleted' }),
+      setTaskOutcomeArchived: assign({ taskOutcome: () => 'archived' }),
+      clearDoneContext: assign({
+        taskOutcome: () => undefined,
+        previousStatus: () => undefined
+      })
+    }
+  }
+);