feat: add kanban filtering, AI summaries, cloud sync, session persistence, and export

Five desktop app enhancements with full TDD coverage (77 new tests):
- Kanban search & filtering: filterTasks pure function + KanbanFilters component (24 tests)
- AI task summaries: TaskSummary component + Rust route stub (9 tests)
- Cloud sync: useCloudSync hook with debounced push + pull on mount (10 tests)
- Session persistence: ResumePrompt + useSessionPersistence hook (14 tests)
- Export/reporting: JSON/CSV export utils + ExportButton dropdown (20 tests)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: h4x0r

crates/shepherd-server/src/routes/mod.rs

@@ -10,6 +10,7 @@ pub mod northstar;
 pub mod plugins;
 pub mod pr;
 pub mod replay;
+pub mod summaries;
 pub mod sync;
 pub mod tasks;
 pub mod templates;

crates/shepherd-server/src/routes/summaries.rs

@@ -0,0 +1,19 @@
+use axum::{extract::Path, http::StatusCode, Json};
+use serde::Serialize;
+
+#[derive(Serialize)]
+pub struct SummaryResponse {
+    pub summary: String,
+    pub generated_at: String,
+}
+
+pub async fn get_task_summary(
+    Path(task_id): Path<i64>,
+) -> Result<Json<SummaryResponse>, StatusCode> {
+    // Stub: return a placeholder summary for now
+    // Full LLM integration will come when the LLM module is wired
+    Ok(Json(SummaryResponse {
+        summary: format!("Task {} completed successfully.", task_id),
+        generated_at: chrono::Utc::now().to_rfc3339(),
+    }))
+}

src/App.tsx

@@ -14,6 +14,7 @@ import { useWebSocket } from "./hooks/useWebSocket";
 import { useKeyboardShortcuts } from "./hooks/useKeyboardShortcuts";
 import { useNotifications, notifyFromServer } from "./hooks/useNotifications";
 import { useAuthCallback } from "./hooks/useAuthCallback";
+import { useCloudSync } from "./hooks/useCloudSync";
 import { useStore } from "./store";
 import type { ServerEvent } from "./types";
 import type { ConnectionStatus } from "./lib/ws";
@@ -72,6 +73,7 @@ const App: React.FC = () => {
   useKeyboardShortcuts(wsRef);
   useNotifications();
   useAuthCallback();
+  useCloudSync();
 
   // Sync the wsClient ref into the store whenever connection status changes.
   // The wsRef.current is set before onStatusChange fires, so it's safe to read here.

src/features/focus/FocusView.tsx

@@ -7,6 +7,7 @@ import { PermissionPrompt } from "./PermissionPrompt";
 import { SessionPicker } from "../iterm2/SessionPicker";
 import { SetupPrompt } from "../iterm2/SetupPrompt";
 import { getClaudeSessions, resumeClaudeSession, startFreshSession } from "../../lib/api";
+import { TaskSummary } from "./TaskSummary";
 
 const Terminal = React.lazy(() =>
   import("./Terminal").then((m) => ({ default: m.Terminal })),
@@ -146,6 +147,9 @@ export const FocusView: React.FC = () => {
           )}
         </div>
 
+        {/* AI summary (only rendered for done tasks) */}
+        <TaskSummary taskId={task.id} taskStatus={task.status} />
+
         {/* Content area: Terminal + DiffViewer side by side */}
         <div className="flex-1 flex min-h-0">
           {/* Center panel: Terminal + Permission prompt */}

src/features/focus/ResumePrompt.tsx

@@ -0,0 +1,68 @@
+import React from "react";
+import type { SessionState } from "../../types/task";
+
+export interface ResumePromptProps {
+  sessions: SessionState[];
+  onResume: (taskId: number) => void;
+  onFresh: (taskId: number) => void;
+  onDismiss: (taskId: number) => void;
+}
+
+function truncatePrompt(prompt: string): string {
+  if (prompt.length <= 80) return prompt;
+  return prompt.slice(0, 80) + "...";
+}
+
+export const ResumePrompt: React.FC<ResumePromptProps> = ({
+  sessions,
+  onResume,
+  onFresh,
+  onDismiss,
+}) => {
+  if (sessions.length === 0) return null;
+
+  return (
+    <div data-testid="resume-prompt" className="space-y-2">
+      {sessions.map((session) => (
+        <div
+          key={session.task_id}
+          className="bg-shepherd-surface border border-shepherd-border rounded-lg p-4 flex items-start justify-between gap-4"
+        >
+          <div className="flex-1 min-w-0">
+            <p className="text-sm font-medium text-shepherd-text truncate">
+              {truncatePrompt(session.last_prompt)}
+            </p>
+            <p className="text-xs text-shepherd-muted-foreground mt-1">
+              <span>{session.working_dir}</span>
+              <span className="mx-2">&#183;</span>
+              <span>{new Date(session.saved_at).toLocaleString()}</span>
+            </p>
+          </div>
+          <div className="flex gap-2 shrink-0">
+            <button
+              data-testid="resume-btn"
+              onClick={() => onResume(session.task_id)}
+              className="px-3 py-1.5 text-xs font-medium rounded bg-shepherd-accent text-white hover:bg-shepherd-accent/90"
+            >
+              Resume
+            </button>
+            <button
+              data-testid="fresh-btn"
+              onClick={() => onFresh(session.task_id)}
+              className="px-3 py-1.5 text-xs font-medium rounded bg-shepherd-surface border border-shepherd-border hover:bg-shepherd-muted"
+            >
+              Start Fresh
+            </button>
+            <button
+              data-testid="dismiss-btn"
+              onClick={() => onDismiss(session.task_id)}
+              className="px-3 py-1.5 text-xs font-medium rounded text-shepherd-muted-foreground hover:text-shepherd-text"
+            >
+              Dismiss
+            </button>
+          </div>
+        </div>
+      ))}
+    </div>
+  );
+};

src/features/focus/TaskSummary.tsx

@@ -0,0 +1,42 @@
+import React, { useState, useEffect, useRef } from "react";
+import type { TaskStatus } from "../../types/task";
+
+interface TaskSummaryProps {
+  taskId: number;
+  taskStatus: TaskStatus;
+}
+
+export const TaskSummary: React.FC<TaskSummaryProps> = ({ taskId, taskStatus }) => {
+  const [summary, setSummary] = useState<string | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const cachedTaskId = useRef<number | null>(null);
+
+  useEffect(() => {
+    if (taskStatus !== "done") return;
+    if (cachedTaskId.current === taskId && summary) return;
+
+    setLoading(true);
+    setError(null);
+    import("../../lib/api")
+      .then(({ getTaskSummary }) => getTaskSummary(taskId))
+      .then((data) => {
+        setSummary(data.summary);
+        cachedTaskId.current = taskId;
+      })
+      .catch((err) => setError(err instanceof Error ? err.message : "Failed to load summary"))
+      .finally(() => setLoading(false));
+  }, [taskId, taskStatus]);
+
+  if (taskStatus !== "done") return null;
+  if (loading) return <div data-testid="summary-loading" className="px-4 py-3 border-b border-shepherd-border bg-shepherd-surface/50 text-sm text-shepherd-muted">Generating summary...</div>;
+  if (error) return <div data-testid="summary-error" className="px-4 py-3 border-b border-shepherd-border bg-shepherd-surface/50 text-sm text-shepherd-red">Summary unavailable</div>;
+  if (!summary) return null;
+
+  return (
+    <div data-testid="task-summary" className="px-4 py-3 border-b border-shepherd-border bg-shepherd-surface/50">
+      <h3 className="text-xs font-semibold text-shepherd-muted uppercase tracking-wider mb-1">Summary</h3>
+      <p className="text-sm text-shepherd-text leading-relaxed">{summary}</p>
+    </div>
+  );
+};

src/features/focus/__tests__/ResumePrompt.test.tsx

@@ -0,0 +1,96 @@
+import { describe, it, expect, vi } from "vitest";
+import { render, screen, fireEvent } from "@testing-library/react";
+import { ResumePrompt } from "../ResumePrompt";
+import type { SessionState } from "../../../types/task";
+
+function makeSession(overrides: Partial<SessionState> = {}): SessionState {
+  return {
+    task_id: 1,
+    session_id: "sess-abc",
+    last_prompt: "Implement the user authentication flow",
+    working_dir: "/home/user/project",
+    saved_at: "2026-03-23T10:00:00Z",
+    ...overrides,
+  };
+}
+
+describe("ResumePrompt", () => {
+  const onResume = vi.fn();
+  const onFresh = vi.fn();
+  const onDismiss = vi.fn();
+
+  it("renders nothing when sessions array is empty", () => {
+    const { container } = render(
+      <ResumePrompt sessions={[]} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    expect(container.innerHTML).toBe("");
+  });
+
+  it("renders a banner for each interrupted session", () => {
+    const sessions = [
+      makeSession({ task_id: 1 }),
+      makeSession({ task_id: 2, last_prompt: "Fix the build pipeline" }),
+    ];
+    render(
+      <ResumePrompt sessions={sessions} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    const resumeButtons = screen.getAllByTestId("resume-btn");
+    expect(resumeButtons).toHaveLength(2);
+  });
+
+  it("shows truncated prompt text (first 80 chars + '...')", () => {
+    const longPrompt =
+      "This is a very long prompt that exceeds eighty characters and should be truncated with an ellipsis at the end";
+    const sessions = [makeSession({ last_prompt: longPrompt })];
+    render(
+      <ResumePrompt sessions={sessions} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    expect(screen.getByText(longPrompt.slice(0, 80) + "...")).toBeInTheDocument();
+  });
+
+  it("shows full prompt if under 80 chars (no ellipsis)", () => {
+    const shortPrompt = "Fix the login bug";
+    const sessions = [makeSession({ last_prompt: shortPrompt })];
+    render(
+      <ResumePrompt sessions={sessions} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    expect(screen.getByText(shortPrompt)).toBeInTheDocument();
+    // Should not have an ellipsis
+    expect(screen.queryByText(shortPrompt + "...")).not.toBeInTheDocument();
+  });
+
+  it("shows working directory", () => {
+    const sessions = [makeSession({ working_dir: "/projects/my-app" })];
+    render(
+      <ResumePrompt sessions={sessions} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    expect(screen.getByText("/projects/my-app")).toBeInTheDocument();
+  });
+
+  it("Resume button calls onResume with correct taskId", () => {
+    const sessions = [makeSession({ task_id: 42 })];
+    render(
+      <ResumePrompt sessions={sessions} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    fireEvent.click(screen.getByTestId("resume-btn"));
+    expect(onResume).toHaveBeenCalledWith(42);
+  });
+
+  it("Fresh button calls onFresh with correct taskId", () => {
+    const sessions = [makeSession({ task_id: 7 })];
+    render(
+      <ResumePrompt sessions={sessions} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    fireEvent.click(screen.getByTestId("fresh-btn"));
+    expect(onFresh).toHaveBeenCalledWith(7);
+  });
+
+  it("Dismiss button calls onDismiss with correct taskId", () => {
+    const sessions = [makeSession({ task_id: 99 })];
+    render(
+      <ResumePrompt sessions={sessions} onResume={onResume} onFresh={onFresh} onDismiss={onDismiss} />,
+    );
+    fireEvent.click(screen.getByTestId("dismiss-btn"));
+    expect(onDismiss).toHaveBeenCalledWith(99);
+  });
+});