AI Alert Copilot UX

Summary

Implemented the AI alert Copilot UX refinement: markdown rendering, in-place loading and cancellation, current-session task caching for alert actions, and regenerate controls for completed outputs.

Important Implementation Details

• Markdown is rendered through ReactMarkdown without raw HTML support, so embedded HTML is not executed as markup.
• Alert action cache keys combine IslandflowAiTaskKind with underlying_id, source_ts, and event_id.
• Completed cached alert actions select the existing task instead of starting a new run. Regenerate intentionally replaces the cached task id for that action.
• Cancellation marks the task cancelled locally, removes its active thread mapping, ignores later deltas/completion, and best-effort calls turn/cancel on the app-server.
• Replay and screen compiler panels reuse the improved result surface, cancellation, and regenerate wording where they already share task output behavior.

Relevant Diff Snippets

Patch-style snippets prepared for Diffs-style review. Reference: Diffs rendering docs.

Task result surface

@@ apps/web/app/desktop-ai-panels.tsx
+import ReactMarkdown from "react-markdown";
+
+export const getCopilotTaskSurfaceState = (...) => {
+  if (!task) return "empty";
+  if (RUNNING_TASK_STATUSES.includes(task.status)) return "running";
+  if (task.status === "completed") return "completed";
+  if (task.status === "failed") return "failed";
+  return "cancelled";
+};
+
+{surfaceState === "running" ? (
+  <div className="copilot-task-running-row">
+    <span className="copilot-spinner" aria-hidden="true" />
+    <p className="copilot-note">Generating analysis as deltas arrive.</p>
+    <button className="terminal-button" onClick={() => onCancel(task.taskId)}>Cancel</button>
+  </div>
+) : null}
+{task.text ? (
+  <div className="copilot-markdown">
+    <ReactMarkdown>{task.text}</ReactMarkdown>
+  </div>
+) : null}

Desktop cancellation bridge

@@ apps/desktop/src/desktop-ai-ipc.ts
+export const DESKTOP_AI_CANCEL_TASK = "islandflow:desktop-ai:cancel-task";

@@ apps/desktop/src/main.ts
+ipcMain.handle(DESKTOP_AI_CANCEL_TASK, async (event, taskId) => {
+  guard(event);
+  await service.cancelTask(String(taskId));
+});

@@ apps/desktop/src/desktop-ai.ts
+async cancelTask(taskId: string): Promise<void> {
+  const task = this.state.tasks.find((candidate) => candidate.taskId === taskId);
+  if (!task || (task.status !== "queued" && task.status !== "running")) return;
+  this.locallyCancelledTaskIds.add(taskId);
+  this.patchTask(taskId, { status: "cancelled", error: null });
+  if (task.threadId) {
+    this.activeTasksByThreadId.delete(task.threadId);
+    await this.client.request("turn/cancel", { threadId: task.threadId, turnId: task.turnId ?? undefined }).catch(() => undefined);
+  }
+}

Expected Impact for End-Users

• Generated Copilot analysis is easier to read because headings, lists, code, and inline emphasis render with Islandflow typography.
• Users get immediate feedback while a task is queued or running, instead of an empty-looking panel.
• Users can cancel a running Copilot task from the same surface where the output appears.
• Switching between alert AI actions no longer discards completed outputs during the same app session.
• Regenerate makes fresh model runs deliberate rather than accidental.

Validation

Issues, Limitations, and Mitigations

• The app-server cancellation protocol is treated as best-effort. If turn/cancel is unsupported, Islandflow still marks the task cancelled locally and ignores late output.
• Session result caching is intentionally in-memory panel state only. It does not survive a desktop restart or full page reload.
• The web build remains blocked by the existing shared-types TypeScript extension configuration issue, not by this Copilot UX implementation.

Follow-up Work

• Consider a dedicated Beads issue to resolve the shared-types .ts import extension build blocker.
• Consider moving task caches into a small shared hook if replay and screen compiler need context-key reuse beyond the active result.
• Consider adding visual browser coverage for markdown-heavy Copilot output once a stable desktop/web test harness is available.