fix: resolve Kanban board stuck task state synchronization

apps/frontend/src/main/ipc-handlers/agent-events-handlers.ts

@@ -96,6 +96,17 @@ export function registerAgenteventsHandlers(
 
     taskStateManager.handleProcessExited(taskId, code, exitTask, exitProject);
 
+    // Fallback safety net: If XState failed to transition the task out of in_progress,
+    // force it to human_review after a short delay. This prevents tasks from getting stuck
+    // in in_progress state when the process exits without XState properly handling it.
+    setTimeout(() => {
+      const { task: checkTask } = findTaskAndProject(taskId, projectId);
+      if (checkTask && checkTask.status === 'in_progress') {
+        console.warn(`[agent-events-handlers] Task ${taskId} still in_progress 500ms after exit, forcing to human_review`);
+        taskStateManager.forceTransition(taskId, 'human_review', 'errors', checkTask, exitProject);
+      }
+    }, 500);
+
     // Send final plan state to renderer BEFORE unwatching
     // This ensures the renderer has the final subtask data (fixes 0/0 subtask bug)
     const finalPlan = fileWatcher.getCurrentPlan(taskId);
@@ -225,9 +236,12 @@ export function registerAgenteventsHandlers(
       console.debug(`[agent-events-handlers] Skipping persistPlanPhaseSync for ${taskId}: XState in '${currentXState}', not overwriting with phase '${progress.phase}'`);
     }
 
-    // Skip sending execution-progress to renderer when XState has settled.
-    // XState's emitPhaseFromState already sent the correct phase to the renderer.
-    if (xstateInTerminalState) {
+    // Skip sending execution-progress to renderer when XState has settled,
+    // UNLESS this is a final phase update (complete/failed).
+    // Final phase updates must still propagate to renderer even after XState settles,
+    // otherwise the UI never receives the final progress state.
+    const isFinalPhaseUpdate = progress.phase === 'complete' || progress.phase === 'failed';
+    if (xstateInTerminalState && !isFinalPhaseUpdate) {
       console.debug(`[agent-events-handlers] Skipping execution-progress to renderer for ${taskId}: XState in '${currentXState}', ignoring phase '${progress.phase}'`);
       return;
     }

apps/frontend/src/renderer/components/SortableTaskCard.tsx

@@ -41,7 +41,10 @@ export const SortableTaskCard = memo(function SortableTaskCard({ task, onClick,
     transition,
     isDragging,
     isOver
-  } = useSortable({ id: task.id });
+  } = useSortable({
+    id: task.id,
+    disabled: task.status === 'in_progress' // Prevent dragging tasks that are currently running or stuck
+  });
 
   const style = {
     transform: CSS.Transform.toString(transform),

apps/frontend/src/renderer/components/TaskCard.tsx

@@ -228,7 +228,9 @@ export const TaskCard = memo(function TaskCard({
 
   const handleStartStop = async (e: React.MouseEvent) => {
     e.stopPropagation();
-    if (isRunning && !isStuck) {
+    if (isRunning) {
+      // Allow stopping both running and stuck tasks
+      // User should be able to force-stop a stuck task
       stopTask(task.id);
     } else {
       const result = await startTaskOrQueue(task.id);

apps/frontend/src/renderer/stores/task-store.ts

@@ -309,6 +309,10 @@ export const useTaskStore = create<TaskState>((set, get) => ({
             // When starting a task and no phase is set yet, default to planning
             // This prevents the "no active phase" UI state during startup race condition
             executionProgress = { phase: 'planning' as ExecutionPhase, phaseProgress: 0, overallProgress: 0 };
+          } else if (status === 'human_review' || status === 'error' || status === 'done' || status === 'pr_created') {
+            // Reset execution progress when task reaches terminal states
+            // This prevents stuck tasks from showing stale progress indicators
+            executionProgress = { phase: 'idle' as ExecutionPhase, phaseProgress: 0, overallProgress: 0 };
           }
 
           // Log status transitions to help diagnose flip-flop issues