fusion/packages/dashboard/app/components/__tests__/Board.test.tsx

import React from "react";
import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
import { render, screen, fireEvent, waitFor, act } from "@testing-library/react";
import { Board } from "../Board";
import { COLUMNS } from "@fusion/core";

import type { Task } from "@fusion/core";

const fetchBatchMock = vi.fn();
const pendingWorkflowSteps = () => new Promise<never>(() => {});
const fetchWorkflowStepsMock = vi.fn().mockImplementation(pendingWorkflowSteps);

vi.mock("../../hooks/useBatchBadgeFetch", () => ({
  useBatchBadgeFetch: vi.fn(() => ({
    fetchBatch: fetchBatchMock,
    isLoading: false,
    lastFetchTime: null,
    getBatchData: vi.fn(),
  })),
}));

const pendingBoardWorkflows = () => new Promise<never>(() => {});
const fetchBoardWorkflowsMock = vi.fn().mockImplementation(pendingBoardWorkflows);
const promoteTaskMock = vi.fn().mockResolvedValue({});

vi.mock("../../api", () => ({
  fetchWorkflowSteps: (...args: unknown[]) => fetchWorkflowStepsMock(...args),
  fetchBoardWorkflows: (...args: unknown[]) => fetchBoardWorkflowsMock(...args),
  promoteTask: (...args: unknown[]) => promoteTaskMock(...args),
}));

// Capture SSE event handlers registered via subscribeSse so tests can simulate
// server-pushed `workflow:*` events without a real EventSource.
const sseHandlers: Record<string, (event?: unknown) => void> = {};
const subscribeSseMock = vi.fn(
  (_url: string, opts: { events?: Record<string, (event?: unknown) => void> }) => {
    for (const [name, handler] of Object.entries(opts.events ?? {})) {
      sseHandlers[name] = handler;
    }
    return () => {};
  },
);
vi.mock("../../sse-bus", () => ({
  subscribeSse: (...args: unknown[]) => (subscribeSseMock as (...a: unknown[]) => () => void)(...args),
}));

const columnRenderCounts: Record<string, number> = {};

// Mock child components so we only test Board's own rendering
vi.mock("../Column", () => ({
  Column: React.memo(({ column, tasks, collapsed, onToggleCollapse, onQuickCreate, onNewTask, onToggleAutoMerge, onArchiveAllDone, favoriteProviders, favoriteModels, onToggleFavorite, onToggleModelFavorite, isSearchActive, workflowStepNameLookup }: { column: string; tasks: Task[]; collapsed?: boolean; onToggleCollapse?: () => void; onQuickCreate?: unknown; onNewTask?: unknown; onToggleAutoMerge?: () => void; onArchiveAllDone?: unknown; favoriteProviders?: string[]; favoriteModels?: string[]; onToggleFavorite?: (provider: string) => void; onToggleModelFavorite?: (modelId: string) => void; isSearchActive?: boolean; workflowStepNameLookup?: ReadonlyMap<string, string> }) => {
    columnRenderCounts[column] = (columnRenderCounts[column] ?? 0) + 1;
    return (
      <div data-testid={`column-${column}`} data-tasks={JSON.stringify(tasks)} data-collapsed={collapsed ? "true" : "false"} data-has-quick-create={onQuickCreate ? "yes" : "no"} data-has-new-task={onNewTask ? "yes" : "no"} data-has-auto-merge-toggle={onToggleAutoMerge ? "yes" : "no"} data-has-archive-all={onArchiveAllDone ? "yes" : "no"} data-favorite-providers={JSON.stringify(favoriteProviders ?? [])} data-favorite-models={JSON.stringify(favoriteModels ?? [])} data-has-toggle-favorite={onToggleFavorite ? "yes" : "no"} data-has-toggle-model-favorite={onToggleModelFavorite ? "yes" : "no"} data-is-search-active={isSearchActive ? "true" : "false"} data-workflow-lookup-size={String(workflowStepNameLookup?.size ?? 0)}>
        {onToggleCollapse && <button onClick={onToggleCollapse}>toggle-{column}</button>}
      </div>
    );
  }),
}));

// Mock Lane so the multi-lane Board tests assert grouping/ordering without
// pulling in the full Column tree.
vi.mock("../Lane", () => ({
  Lane: ({ workflow, tasks, collapsed }: { workflow: { id: string; name: string }; tasks: Task[]; collapsed: boolean }) => (
    <section
      data-testid={`lane-${workflow.id}`}
      data-lane-name={workflow.name}
      data-lane-count={String(tasks.length)}
      data-lane-collapsed={collapsed ? "true" : "false"}
      data-lane-task-ids={JSON.stringify(tasks.map((t) => t.id))}
    />
  ),
}));

const BOARD_WORKFLOW_COLLAPSED_KEY = "kb-dashboard-board-workflow-collapsed";

const DEFAULT_WORKFLOW = {
  id: "builtin:coding",
  name: "Coding (built-in)",
  columns: [
    { id: "triage", name: "Triage", flags: { intake: true } },
    { id: "todo", name: "Todo", flags: { hold: true } },
    { id: "in-progress", name: "In progress", flags: { countsTowardWip: true } },
    { id: "in-review", name: "In review", flags: { mergeBlocker: true } },
    { id: "done", name: "Done", flags: { complete: true } },
    { id: "archived", name: "Archived", flags: { archived: true } },
  ],
};

const noop = () => {};
const noopAsync = () => Promise.resolve({} as any);

function clearBoardTestStorage() {
  try {
    window.localStorage.clear();
  } catch {
    /* jsdom localStorage */
  }
}

beforeEach(() => {
  fetchBatchMock.mockReset();
  fetchWorkflowStepsMock.mockReset();
  fetchWorkflowStepsMock.mockImplementation(pendingWorkflowSteps);
  promoteTaskMock.mockClear();
  subscribeSseMock.mockClear();
  for (const key of Object.keys(sseHandlers)) delete sseHandlers[key];
  fetchBoardWorkflowsMock.mockReset();
  fetchBoardWorkflowsMock.mockImplementation(pendingBoardWorkflows);
  clearBoardTestStorage();
  for (const key of Object.keys(columnRenderCounts)) {
    delete columnRenderCounts[key];
  }
});

afterEach(() => {
  clearBoardTestStorage();
});

function createBoardProps(overrides = {}) {
  return {
    tasks: [],
    maxConcurrent: 2,
    onMoveTask: noopAsync,
    onOpenDetail: noop,
    addToast: noop,
    onQuickCreate: noopAsync,
    onNewTask: noop,
    autoMerge: true,
    onToggleAutoMerge: noop,
    globalPaused: false,
    onUpdateTask: undefined,
    onArchiveTask: undefined,
    onUnarchiveTask: undefined,
    ...overrides,
  };
}

function renderBoard(props = {}) {
  return render(<Board {...createBoardProps(props)} />);
}

describe("Board", () => {
  it("renders a <main> element with class 'board'", () => {
    renderBoard();
    const main = screen.getByRole("main");
    expect(main).toBeDefined();
    expect(main.className).toContain("board");
  });

  it("renders with id='board' for scroll targeting", () => {
    renderBoard();
    const main = screen.getByRole("main");
    expect(main.id).toBe("board");
  });

  it("FN-4380: does not eagerly fetch GitHub badge status on board mount", () => {
    vi.useFakeTimers();
    try {
      const tasksWithBadges: Task[] = [
        {
          id: "FN-PR-1",
          title: "Task with PR badge",
          description: "Has prInfo",
          column: "todo",
          dependencies: [],
          steps: [],
          currentStep: 0,
          log: [],
          createdAt: "2024-01-01T00:00:00.000Z",
          updatedAt: "2024-01-01T00:00:00.000Z",
          prInfo: { number: 123, owner: "runfusion", repo: "fusion" } as Task["prInfo"],
        },
        {
          id: "FN-ISSUE-1",
          title: "Task with issue badge",
          description: "Has issueInfo",
          column: "todo",
          dependencies: [],
          steps: [],
          currentStep: 0,
          log: [],
          createdAt: "2024-01-01T00:00:00.000Z",
          updatedAt: "2024-01-01T00:00:00.000Z",
          issueInfo: { number: 456, owner: "runfusion", repo: "fusion" } as Task["issueInfo"],
        },
      ];

      renderBoard({ tasks: tasksWithBadges });
      vi.runAllTimers();
      expect(fetchBatchMock).not.toHaveBeenCalled();
    } finally {
      vi.useRealTimers();
    }
  });

  it("renders all 6 columns", () => {
    renderBoard();
    for (const col of COLUMNS) {
      expect(screen.getByTestId(`column-${col}`)).toBeDefined();
    }
  });

  it("falls back malformed task columns to triage instead of crashing", () => {
    const malformedTask = {
      id: "FN-404",
      description: "Malformed",
      column: "impossible-column",
      dependencies: [],
      steps: [],
      currentStep: 0,
      log: [],
      createdAt: "2024-01-01T00:00:00.000Z",
      updatedAt: "2024-01-01T00:00:00.000Z",
    } as unknown as Task;

    expect(() => renderBoard({ tasks: [malformedTask] })).not.toThrow();

    const triageTasks = JSON.parse(screen.getByTestId("column-triage").getAttribute("data-tasks") || "[]") as Task[];
    expect(triageTasks).toHaveLength(1);
    expect(triageTasks[0]?.id).toBe("FN-404");
  });

  it("forwards board-level workflow name lookup to columns", async () => {
    fetchWorkflowStepsMock.mockResolvedValue([
      { id: "WS-003", name: "Accessibility Audit", enabled: true },
    ]);
    renderBoard();

    await waitFor(() => {
      for (const col of COLUMNS) {
        const columnEl = screen.getByTestId(`column-${col}`);
        expect(columnEl.getAttribute("data-workflow-lookup-size")).toBe("1");
      }
    });
  });

  it("renders all 6 columns as direct children of .board (CSS selector target)", () => {
    renderBoard();
    const board = screen.getByRole("main");
    // The mock Column renders <div data-testid="column-{col}" />, which are direct children
    const directChildren = Array.from(board.children);
    expect(directChildren).toHaveLength(COLUMNS.length);
    // Each direct child should be one of the column test-id elements
    for (const col of COLUMNS) {
      const colEl = screen.getByTestId(`column-${col}`);
      expect(colEl.parentElement).toBe(board);
    }
  });

  it("renders the board element as a <main> tag (semantic structure)", () => {
    renderBoard();
    const board = screen.getByRole("main");
    expect(board.tagName).toBe("MAIN");
  });

  describe("search functionality", () => {
    const createTask = (overrides: Partial<Task> & { id: string; description: string }): Task => ({
      column: "todo",
      dependencies: [],
      steps: [],
      currentStep: 0,
      log: [],
      createdAt: "2024-01-01T00:00:00.000Z",
      updatedAt: "2024-01-01T00:00:00.000Z",
      ...overrides,
    });

    it("renders server-filtered tasks by ID when search query is provided", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "First task", column: "todo" }),
        createTask({ id: "FN-002", description: "Second task", column: "todo" }),
        createTask({ id: "FN-003", description: "Third task", column: "in-progress" }),
      ];

      // Pre-filtered tasks - only FN-002 matches the search
      const filteredTasks = [tasks[1]];

      renderBoard({ tasks: filteredTasks, searchQuery: "FN-002" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");
      expect(todoTasks).toHaveLength(1);
      expect(todoTasks[0].id).toBe("FN-002");

      const inProgressColumn = screen.getByTestId("column-in-progress");
      const inProgressTasks = JSON.parse(inProgressColumn.getAttribute("data-tasks") || "[]");
      expect(inProgressTasks).toHaveLength(0);
    });

    it("renders server-filtered tasks by title when search query is provided", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", title: "Fix login bug", description: "First task", column: "todo" }),
        createTask({ id: "FN-002", title: "Add dashboard feature", description: "Second task", column: "todo" }),
        createTask({ id: "FN-003", title: "Update documentation", description: "Third task", column: "todo" }),
      ];

      // Pre-filtered tasks - only dashboard matches
      const filteredTasks = [tasks[1]];

      renderBoard({ tasks: filteredTasks, searchQuery: "dashboard" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");
      expect(todoTasks).toHaveLength(1);
      expect(todoTasks[0].id).toBe("FN-002");
    });

    it("renders server-filtered tasks by description when search query is provided", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "Implement user authentication", column: "todo" }),
        createTask({ id: "FN-002", description: "Fix database connection issue", column: "todo" }),
        createTask({ id: "FN-003", description: "Add caching layer", column: "todo" }),
      ];

      // Pre-filtered tasks - only database matches
      const filteredTasks = [tasks[1]];

      renderBoard({ tasks: filteredTasks, searchQuery: "database" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");
      expect(todoTasks).toHaveLength(1);
      expect(todoTasks[0].id).toBe("FN-002");
    });

    it("search is case-insensitive (server handles this)", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", title: "Fix Login Bug", description: "First task", column: "todo" }),
        createTask({ id: "FN-002", title: "Add Dashboard Feature", description: "Second task", column: "todo" }),
      ];

      // Pre-filtered tasks - only FN-001 matches
      const filteredTasks = [tasks[0]];

      renderBoard({ tasks: filteredTasks, searchQuery: "login" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");
      expect(todoTasks).toHaveLength(1);
      expect(todoTasks[0].id).toBe("FN-001");
    });

    it("search is case-insensitive for lowercase query matching uppercase content (server handles this)", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-UPPER", title: "UPPERCASE TITLE", description: "DESC", column: "todo" }),
      ];

      // Pre-filtered tasks - FN-UPPER matches
      const filteredTasks = [tasks[0]];

      renderBoard({ tasks: filteredTasks, searchQuery: "upper" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");
      expect(todoTasks).toHaveLength(1);
      expect(todoTasks[0].id).toBe("FN-UPPER");
    });

    it("shows all tasks when search query is empty", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "First task", column: "todo" }),
        createTask({ id: "FN-002", description: "Second task", column: "todo" }),
        createTask({ id: "FN-003", description: "Third task", column: "in-progress" }),
      ];

      renderBoard({ tasks, searchQuery: "" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");
      expect(todoTasks).toHaveLength(2);

      const inProgressColumn = screen.getByTestId("column-in-progress");
      const inProgressTasks = JSON.parse(inProgressColumn.getAttribute("data-tasks") || "[]");
      expect(inProgressTasks).toHaveLength(1);
    });

    it("shows no tasks when search query matches nothing (server returns empty)", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "First task", column: "todo" }),
        createTask({ id: "FN-002", description: "Second task", column: "todo" }),
      ];

      // Pre-filtered tasks - empty array because server found no matches
      const filteredTasks: Task[] = [];

      renderBoard({ tasks: filteredTasks, searchQuery: "nonexistent" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");
      expect(todoTasks).toHaveLength(0);
    });

    it("keeps unaffected columns stable when archived collapse toggles", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "Todo task", column: "todo" }),
        createTask({ id: "FN-002", description: "Archived task", column: "archived" }),
      ];

      renderBoard({ tasks });

      const initialTodoRenders = columnRenderCounts.todo;
      const initialArchivedRenders = columnRenderCounts.archived;

      fireEvent.click(screen.getByRole("button", { name: "toggle-archived" }));

      expect(columnRenderCounts.archived).toBeGreaterThan(initialArchivedRenders);
      expect(columnRenderCounts.todo).toBe(initialTodoRenders);
    });

    it("only re-renders the affected column when a task updates", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "Todo task", column: "todo", title: "Original" }),
        createTask({ id: "FN-002", description: "Done task", column: "done", title: "Done" }),
      ];

      const { rerender } = renderBoard({ tasks });

      const initialTodoRenders = columnRenderCounts.todo;
      const initialDoneRenders = columnRenderCounts.done;

      rerender(
        <Board
          {...createBoardProps({
            tasks: [
              { ...tasks[0], title: "Updated" },
              tasks[1],
            ],
          })}
        />,
      );

      const todoTasks = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]");
      expect(todoTasks[0].title).toBe("Updated");
      expect(columnRenderCounts.todo).toBeGreaterThan(initialTodoRenders);
      expect(columnRenderCounts.done).toBeGreaterThanOrEqual(initialDoneRenders);
    });

    describe("column default ordering priority semantics", () => {
      it("orders done tasks by most recent completion regardless of priority", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-003",
            description: "Older urgent done task",
            column: "done",
            priority: "urgent",
            columnMovedAt: "2024-01-01T09:00:00.000Z",
          }),
          createTask({
            id: "FN-001",
            description: "Newest low-priority done task",
            column: "done",
            priority: "low",
            columnMovedAt: "2024-01-01T11:00:00.000Z",
          }),
          createTask({
            id: "FN-002",
            description: "Middle high-priority done task",
            column: "done",
            priority: "high",
            columnMovedAt: "2024-01-01T10:00:00.000Z",
          }),
        ];

        renderBoard({ tasks });

        const doneTasks = JSON.parse(screen.getByTestId("column-done").getAttribute("data-tasks") || "[]") as Task[];
        expect(doneTasks.map((t: Task) => t.id)).toEqual(["FN-001", "FN-002", "FN-003"]);
      });

      it("falls back to updatedAt and createdAt for legacy done tasks missing columnMovedAt", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-010",
            description: "Has updatedAt fallback",
            column: "done",
            updatedAt: "2024-01-01T10:30:00.000Z",
          }),
          createTask({
            id: "FN-011",
            description: "Has createdAt fallback",
            column: "done",
            createdAt: "2024-01-01T10:45:00.000Z",
          }),
          createTask({
            id: "FN-012",
            description: "Has real completion timestamp",
            column: "done",
            columnMovedAt: "2024-01-01T11:00:00.000Z",
          }),
        ];

        const taskWithCreatedAtOnly = tasks[1];
        delete taskWithCreatedAtOnly.columnMovedAt;
        delete taskWithCreatedAtOnly.updatedAt;

        renderBoard({ tasks });

        const doneTasks = JSON.parse(screen.getByTestId("column-done").getAttribute("data-tasks") || "[]") as Task[];
        expect(doneTasks.map((t: Task) => t.id)).toEqual(["FN-012", "FN-011", "FN-010"]);
      });

      it("orders todo by priority before age", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-003",
            description: "Low but oldest",
            column: "todo",
            priority: "low",
            createdAt: "2024-01-01T08:00:00.000Z",
          }),
          createTask({
            id: "FN-001",
            description: "Urgent but newer",
            column: "todo",
            priority: "urgent",
            createdAt: "2024-01-01T10:00:00.000Z",
          }),
          createTask({
            id: "FN-004",
            description: "Normal",
            column: "todo",
            priority: "normal",
            createdAt: "2024-01-01T09:00:00.000Z",
          }),
          createTask({
            id: "FN-002",
            description: "High",
            column: "todo",
            priority: "high",
            createdAt: "2024-01-01T07:00:00.000Z",
          }),
        ];

        renderBoard({ tasks, searchQuery: "task" });

        const todoTasks = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]") as Task[];
        expect(todoTasks).toHaveLength(4);
        expect(todoTasks.map((t: Task) => t.id)).toEqual(["FN-001", "FN-002", "FN-004", "FN-003"]);
      });

      it("orders same-priority todo tasks by oldest createdAt first", () => {
        const tasks: Task[] = [
          createTask({ id: "FN-020", description: "Newest", column: "todo", priority: "high", createdAt: "2024-01-01T12:00:00.000Z" }),
          createTask({ id: "FN-021", description: "Oldest", column: "todo", priority: "high", createdAt: "2024-01-01T09:00:00.000Z" }),
          createTask({ id: "FN-022", description: "Middle", column: "todo", priority: "high", createdAt: "2024-01-01T10:00:00.000Z" }),
        ];

        renderBoard({ tasks });

        const todoTasks = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]") as Task[];
        expect(todoTasks.map((t: Task) => t.id)).toEqual(["FN-021", "FN-022", "FN-020"]);
      });

      it("uses task ID as deterministic tie-breaker when todo createdAt matches", () => {
        const tasks: Task[] = [
          createTask({ id: "FN-050", description: "Fifty", column: "todo", priority: "normal", createdAt: "2024-01-01T10:00:00.000Z" }),
          createTask({ id: "FN-010", description: "Ten", column: "todo", priority: "normal", createdAt: "2024-01-01T10:00:00.000Z" }),
          createTask({ id: "FN-030", description: "Thirty", column: "todo", priority: "normal", createdAt: "2024-01-01T10:00:00.000Z" }),
        ];

        renderBoard({ tasks });

        const todoTasks = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]") as Task[];
        expect(todoTasks.map((t: Task) => t.id)).toEqual(["FN-010", "FN-030", "FN-050"]);
      });

      it("keeps non-todo columns on priority then task ID ordering", () => {
        const tasks: Task[] = [
          createTask({ id: "FN-050", description: "Fifty", column: "in-progress", priority: "normal", createdAt: "2024-01-01T12:00:00.000Z" }),
          createTask({ id: "FN-010", description: "Ten", column: "in-progress", priority: "normal", createdAt: "2024-01-01T09:00:00.000Z" }),
          createTask({ id: "FN-030", description: "Thirty", column: "in-progress", priority: "normal", createdAt: "2024-01-01T10:00:00.000Z" }),
        ];

        renderBoard({ tasks });

        const ipTasks = JSON.parse(screen.getByTestId("column-in-progress").getAttribute("data-tasks") || "[]") as Task[];
        expect(ipTasks.map((t: Task) => t.id)).toEqual(["FN-010", "FN-030", "FN-050"]);
      });

      it("normalizes missing and invalid legacy priority values to normal", () => {
        const noPriorityTask = createTask({ id: "FN-060", description: "No priority", column: "todo" });
        delete noPriorityTask.priority;

        const legacyPriorityTask = {
          ...createTask({ id: "FN-059", description: "Legacy priority", column: "todo", priority: "normal" }),
          priority: "critical" as unknown as Task["priority"],
        };

        const tasks: Task[] = [
          noPriorityTask,
          createTask({ id: "FN-061", description: "Explicit normal", column: "todo", priority: "normal" }),
          legacyPriorityTask,
          createTask({ id: "FN-062", description: "Urgent", column: "todo", priority: "urgent" }),
        ];

        renderBoard({ tasks });

        const todoTasks = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]") as Task[];
        // FN-060 (missing), FN-059 (legacy invalid), and FN-061 (explicit normal) normalize to normal,
        // so they sort by numeric ID ascending after urgent tasks.
        expect(todoTasks.map((t: Task) => t.id)).toEqual(["FN-062", "FN-059", "FN-060", "FN-061"]);
      });

      it("uses localeCompare fallback for non-numeric task IDs", () => {
        const tasks: Task[] = [
          createTask({ id: "TASK-002", description: "Task two", column: "todo", priority: "normal" }),
          createTask({ id: "TASK-001", description: "Task one", column: "todo", priority: "normal" }),
        ];

        renderBoard({ tasks });

        const todoTasks = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]") as Task[];
        // Both have same priority, numeric parse fails (NaN), localeCompare fallback
        expect(todoTasks.map((t: Task) => t.id)).toEqual(["TASK-001", "TASK-002"]);
      });
    });

    describe("column default ordering merging pinning", () => {
      it("pins merging tasks to top of in-review even when newer non-merging tasks exist", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-010",
            column: "in-review",
            status: "merging",
            columnMovedAt: "2024-01-01T10:00:00.000Z",
          }),
          createTask({
            id: "FN-011",
            column: "in-review",
            status: "review-ready",
            columnMovedAt: "2024-01-01T12:00:00.000Z",
          }),
        ];

        renderBoard({ tasks });

        const inReviewTasks = JSON.parse(screen.getByTestId("column-in-review").getAttribute("data-tasks") || "[]") as Task[];
        expect(inReviewTasks.map((task) => task.id)).toEqual(["FN-010", "FN-011"]);
      });

      it("pins merging-pr tasks to top of in-review even when newer non-merging tasks exist", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-020",
            column: "in-review",
            status: "merging-pr",
            columnMovedAt: "2024-01-01T10:00:00.000Z",
          }),
          createTask({
            id: "FN-021",
            column: "in-review",
            status: "review-ready",
            columnMovedAt: "2024-01-01T13:00:00.000Z",
          }),
        ];

        renderBoard({ tasks });

        const inReviewTasks = JSON.parse(screen.getByTestId("column-in-review").getAttribute("data-tasks") || "[]") as Task[];
        expect(inReviewTasks.map((task) => task.id)).toEqual(["FN-020", "FN-021"]);
      });

      it("pins merging-fix tasks to top of in-review even when newer non-merging tasks exist", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-060",
            column: "in-review",
            status: "merging-fix",
            columnMovedAt: "2024-01-01T10:00:00.000Z",
          }),
          createTask({
            id: "FN-061",
            column: "in-review",
            status: "review-ready",
            columnMovedAt: "2024-01-01T13:00:00.000Z",
          }),
        ];

        renderBoard({ tasks });

        const inReviewTasks = JSON.parse(screen.getByTestId("column-in-review").getAttribute("data-tasks") || "[]") as Task[];
        expect(inReviewTasks.map((task) => task.id)).toEqual(["FN-060", "FN-061"]);
      });

      it("sorts multiple merging tasks by priority then task ID within the pinned group", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-030",
            column: "in-review",
            status: "merging",
            priority: "high",
          }),
          createTask({
            id: "FN-031",
            column: "in-review",
            status: "merging-pr",
            priority: "urgent",
          }),
          createTask({
            id: "FN-032",
            column: "in-review",
            status: "review-ready",
            priority: "urgent",
          }),
        ];

        renderBoard({ tasks });

        const inReviewTasks = JSON.parse(screen.getByTestId("column-in-review").getAttribute("data-tasks") || "[]") as Task[];
        // Pinned group (merging): FN-031 urgent, FN-030 high — sorted by priority desc
        // Non-pinned group: FN-032 urgent
        expect(inReviewTasks.map((task) => task.id)).toEqual(["FN-031", "FN-030", "FN-032"]);
      });

      it("sorts non-in-review columns by priority then task ID regardless of status", () => {
        const tasks: Task[] = [
          createTask({
            id: "FN-040",
            column: "todo",
            status: "merging",
            priority: "high",
          }),
          createTask({
            id: "FN-041",
            column: "todo",
            status: "ready",
            priority: "urgent",
          }),
          createTask({
            id: "FN-042",
            column: "todo",
            status: "ready",
            priority: "high",
          }),
        ];

        renderBoard({ tasks });

        const todoTasks = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]") as Task[];
        // No merge-pinning outside in-review, so pure priority-then-ID sort
        // FN-041 urgent, then FN-040 and FN-042 both high (sorted by ID asc)
        expect(todoTasks.map((task) => task.id)).toEqual(["FN-041", "FN-040", "FN-042"]);
      });

      it("sorts tasks without status by priority then task ID in in-review", () => {
        const statuslessTask = createTask({
          id: "FN-050",
          column: "in-review",
          priority: "normal",
        });
        delete statuslessTask.status;

        const tasks: Task[] = [
          statuslessTask,
          createTask({
            id: "FN-051",
            column: "in-review",
            status: "review-ready",
            priority: "urgent",
          }),
        ];

        renderBoard({ tasks });

        const inReviewTasks = JSON.parse(screen.getByTestId("column-in-review").getAttribute("data-tasks") || "[]") as Task[];
        // Neither is merging, so sort by priority: FN-051 urgent > FN-050 normal
        expect(inReviewTasks.map((task) => task.id)).toEqual(["FN-051", "FN-050"]);
      });
    });

    it("renders server-filtered tasks matching across multiple fields simultaneously", () => {
      const tasks: Task[] = [
        createTask({ id: "SEARCH-123", title: "Searchable title", description: "Normal description", column: "todo" }),
        createTask({ id: "FN-999", title: "Other task", description: "This has searchable content", column: "todo" }),
        createTask({ id: "FN-888", title: "Unrelated", description: "No match here", column: "todo" }),
      ];

      // Pre-filtered tasks - only the two matching tasks
      const filteredTasks = [tasks[0], tasks[1]];

      renderBoard({ tasks: filteredTasks, searchQuery: "search" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");

      // Should have both matching tasks
      expect(todoTasks).toHaveLength(2);
      expect(todoTasks.map((t: Task) => t.id).sort()).toEqual(["FN-999", "SEARCH-123"]);
    });

    it("renders server-filtered branch-target results without additional client filtering", () => {
      const branchFilteredTasks: Task[] = [
        createTask({
          id: "FN-3428",
          description: "Task targeting release branch",
          column: "todo",
          branch: "feature/fn-3428",
          baseBranch: "release/2026-05",
        }),
      ];

      renderBoard({ tasks: branchFilteredTasks, searchQuery: "release/2026-05" });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]") as Task[];
      expect(todoTasks).toHaveLength(1);
      expect(todoTasks[0]?.id).toBe("FN-3428");
      expect(todoTasks[0]?.branch).toBe("feature/fn-3428");
      expect(todoTasks[0]?.baseBranch).toBe("release/2026-05");
    });

    it("shows all tasks for whitespace-only search query (server treats as empty)", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "First task", column: "todo" }),
      ];

      renderBoard({ tasks, searchQuery: "  " });

      const todoColumn = screen.getByTestId("column-todo");
      const todoTasks = JSON.parse(todoColumn.getAttribute("data-tasks") || "[]");

      // Whitespace-only query should be treated as empty, showing all tasks
      expect(todoTasks).toHaveLength(1);
    });

    it("passes isSearchActive=true to columns when search query is non-empty", () => {
      const tasks: Task[] = [
        createTask({ id: "FN-001", description: "First task", column: "todo" }),
      ];

      renderBoard({ tasks, searchQuery: "first" });

      for (const col of COLUMNS) {
        const columnEl = screen.getByTestId(`column-${col}`);
        expect(columnEl.getAttribute("data-is-search-active")).toBe("true");
      }
    });

    it("passes isSearchActive=false to columns when search query is empty", () => {
      renderBoard({ searchQuery: "" });

      for (const col of COLUMNS) {
        const columnEl = screen.getByTestId(`column-${col}`);
        expect(columnEl.getAttribute("data-is-search-active")).toBe("false");
      }
    });

    it("passes isSearchActive=false to columns when search query is whitespace-only", () => {
      renderBoard({ searchQuery: "   " });

      for (const col of COLUMNS) {
        const columnEl = screen.getByTestId(`column-${col}`);
        expect(columnEl.getAttribute("data-is-search-active")).toBe("false");
      }
    });
  });

  it("does not render a .board-project-context badge", () => {
    renderBoard();
    const badge = document.querySelector(".board-project-context");
    expect(badge).toBeNull();
  });

  describe("favorite model prop forwarding (FN-770)", () => {
    it("forwards favoriteProviders and favoriteModels to all columns", () => {
      const favoriteProviders = ["anthropic"];
      const favoriteModels = ["claude-sonnet-4-5"];
      const onToggleFavorite = vi.fn();
      const onToggleModelFavorite = vi.fn();

      renderBoard({
        favoriteProviders,
        favoriteModels,
        onToggleFavorite,
        onToggleModelFavorite,
      });

      // Every column should receive the favorite props
      for (const col of COLUMNS) {
        const columnEl = screen.getByTestId(`column-${col}`);
        expect(columnEl.getAttribute("data-favorite-providers")).toBe(JSON.stringify(favoriteProviders));
        expect(columnEl.getAttribute("data-favorite-models")).toBe(JSON.stringify(favoriteModels));
        expect(columnEl.getAttribute("data-has-toggle-favorite")).toBe("yes");
        expect(columnEl.getAttribute("data-has-toggle-model-favorite")).toBe("yes");
      }
    });

    it("passes empty arrays for favorites when not provided", () => {
      renderBoard();

      for (const col of COLUMNS) {
        const columnEl = screen.getByTestId(`column-${col}`);
        expect(columnEl.getAttribute("data-favorite-providers")).toBe("[]");
        expect(columnEl.getAttribute("data-favorite-models")).toBe("[]");
        expect(columnEl.getAttribute("data-has-toggle-favorite")).toBe("no");
        expect(columnEl.getAttribute("data-has-toggle-model-favorite")).toBe("no");
      }
    });
  });

  describe("multi-lane board (U9, flag ON)", () => {
    const mkTask = (overrides: Partial<Task> & { id: string }): Task => ({
      title: overrides.id,
      description: "d",
      column: "todo",
      dependencies: [],
      steps: [],
      currentStep: 0,
      log: [],
      createdAt: "2024-01-01T00:00:00.000Z",
      updatedAt: "2024-01-01T00:00:00.000Z",
      ...overrides,
    });

    const CUSTOM_WORKFLOW = {
      id: "wf-custom",
      name: "Custom Flow",
      columns: [
        { id: "intake", name: "Intake", flags: { intake: true } },
        { id: "done", name: "Done", flags: { complete: true } },
      ],
    };

    function enableFlag(taskWorkflowIds: Record<string, string>, workflows = [DEFAULT_WORKFLOW]) {
      fetchBoardWorkflowsMock.mockResolvedValue({
        flagEnabled: true,
        defaultWorkflowId: "builtin:coding",
        workflows,
        taskWorkflowIds,
      });
    }

    function workflowToolbarActionNames() {
      const toolbar = document.querySelector(".board-workflow-toolbar");
      expect(toolbar).not.toBeNull();
      return Array.from(toolbar?.querySelectorAll("button") ?? [])
        .filter((button) => !button.classList.contains("board-workflow-collapse-toggle"))
        .map((button) => button.getAttribute("aria-label"));
    }

    it("flag OFF renders the legacy single-lane board byte-identically", async () => {
      fetchBoardWorkflowsMock.mockResolvedValue({
        flagEnabled: false,
        defaultWorkflowId: "builtin:coding",
        workflows: [],
        taskWorkflowIds: {},
      });
      renderBoard({ tasks: [mkTask({ id: "FN-1" })] });
      // Let the board-workflows fetch resolve (flagEnabled:false) so the async
      // state settle is wrapped and the legacy board stays the rendered output.
      await waitFor(() => expect(fetchBoardWorkflowsMock).toHaveBeenCalled());
      const board = screen.getByRole("main");
      expect(board.className).toBe("board");
      // All 6 legacy columns present; no lanes.
      for (const col of COLUMNS) {
        expect(screen.getByTestId(`column-${col}`)).toBeDefined();
      }
      expect(screen.queryByTestId(/^lane-/)).toBeNull();
    });

    it("tasks with no selection render in the default selected workflow", async () => {
      enableFlag({ "FN-1": "builtin:coding", "FN-2": "builtin:coding" });
      renderBoard({ tasks: [mkTask({ id: "FN-1" }), mkTask({ id: "FN-2", column: "in-progress" })] });
      await waitFor(() => expect(screen.getByTestId("column-todo")).toBeDefined());
      expect(JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]").map((task: Task) => task.id)).toEqual(["FN-1"]);
      expect(JSON.parse(screen.getByTestId("column-in-progress").getAttribute("data-tasks") || "[]").map((task: Task) => task.id)).toEqual(["FN-2"]);
      expect(screen.queryByLabelText("Select workflow")).toBeNull();
    });

    it("puts create controls on the workflow intake column instead of the first visible column", async () => {
      const workflow = {
        id: "wf-intake-second",
        name: "Intake second",
        columns: [
          { id: "queue", name: "Queue", flags: { hold: true } },
          { id: "idea", name: "Idea", flags: { intake: true } },
          { id: "shipped", name: "Shipped", flags: { complete: true } },
        ],
      };
      enableFlag({ "FN-1": workflow.id }, [workflow]);
      renderBoard({ tasks: [mkTask({ id: "FN-1", column: "queue" })] });

      await waitFor(() => expect(screen.getByTestId("column-queue")).toBeDefined());

      expect(screen.getByTestId("column-queue").getAttribute("data-has-new-task")).toBe("no");
      expect(screen.getByTestId("column-queue").getAttribute("data-has-quick-create")).toBe("no");
      expect(screen.getByTestId("column-idea").getAttribute("data-has-new-task")).toBe("yes");
      expect(screen.getByTestId("column-idea").getAttribute("data-has-quick-create")).toBe("yes");
    });

    it("passes auto-merge toggle to selected workflow human-review columns", async () => {
      const workflow = {
        ...DEFAULT_WORKFLOW,
        columns: [
          { id: "triage", name: "Triage", flags: { intake: true } },
          { id: "review", name: "Review", flags: { humanReview: true } },
          { id: "done", name: "Done", flags: { complete: true } },
        ],
      };
      enableFlag({ "FN-1": workflow.id }, [workflow]);
      renderBoard({ tasks: [mkTask({ id: "FN-1", column: "review" })] });

      await waitFor(() => expect(screen.getByTestId("column-review")).toBeDefined());
      expect(screen.getByTestId("column-review").getAttribute("data-has-auto-merge-toggle")).toBe("yes");
    });

    it("keeps workflow create and edit actions visible when only one workflow exists", async () => {
      const onCreateWorkflow = vi.fn();
      const onOpenWorkflowEditor = vi.fn();
      enableFlag({ "FN-1": "builtin:coding" }, [DEFAULT_WORKFLOW]);

      renderBoard({
        tasks: [mkTask({ id: "FN-1", column: "triage" })],
        onCreateWorkflow,
        onOpenWorkflowEditor,
      });

      await waitFor(() => expect(screen.getByTestId("column-triage")).toBeDefined());
      expect(screen.queryByLabelText("Select workflow")).toBeNull();
      expect(workflowToolbarActionNames()).toEqual(["Edit workflows", "New workflow"]);

      fireEvent.click(screen.getByRole("button", { name: "New workflow" }));
      fireEvent.click(screen.getByRole("button", { name: "Edit workflows" }));
      expect(onCreateWorkflow).toHaveBeenCalledTimes(1);
      expect(onOpenWorkflowEditor).toHaveBeenCalledTimes(1);
      expect(onOpenWorkflowEditor).toHaveBeenCalledWith("builtin:coding");
    });

    it("preserves workflow toolbar partial action visibility", async () => {
      const onCreateWorkflow = vi.fn();
      enableFlag({}, [DEFAULT_WORKFLOW]);
      const { unmount } = renderBoard({ onCreateWorkflow });

      await waitFor(() => expect(screen.getByTestId("column-triage")).toBeDefined());
      expect(workflowToolbarActionNames()).toEqual(["New workflow"]);
      fireEvent.click(screen.getByRole("button", { name: "New workflow" }));
      expect(onCreateWorkflow).toHaveBeenCalledTimes(1);
      unmount();

      const onOpenWorkflowEditor = vi.fn();
      enableFlag({}, [DEFAULT_WORKFLOW]);
      renderBoard({ onOpenWorkflowEditor });

      await waitFor(() => expect(screen.getByTestId("column-triage")).toBeDefined());
      expect(workflowToolbarActionNames()).toEqual(["Edit workflows"]);
      fireEvent.click(screen.getByRole("button", { name: "Edit workflows" }));
      expect(onOpenWorkflowEditor).toHaveBeenCalledTimes(1);
    });

    describe("workflow toolbar collapsible", () => {
      function renderWorkflowToolbarBoard() {
        const onCreateWorkflow = vi.fn();
        const onOpenWorkflowEditor = vi.fn();
        enableFlag(
          { "FN-1": "builtin:coding", "FN-2": "wf-custom" },
          [DEFAULT_WORKFLOW, CUSTOM_WORKFLOW],
        );
        renderBoard({
          tasks: [mkTask({ id: "FN-1" }), mkTask({ id: "FN-2", column: "intake" })],
          onCreateWorkflow,
          onOpenWorkflowEditor,
        });
        return { onCreateWorkflow, onOpenWorkflowEditor };
      }

      it("defaults to expanded (not collapsed)", async () => {
        renderWorkflowToolbarBoard();

        expect(await screen.findByLabelText("Select workflow")).toBeDefined();
        expect(screen.getByRole("button", { name: "New workflow" })).toBeDefined();
        expect(screen.getByRole("button", { name: "Edit workflows" })).toBeDefined();
        expect(screen.getByTestId("board-workflow-collapse-toggle").getAttribute("aria-expanded")).toBe("true");
      });

      it("clicking the toggle collapses the toolbar", async () => {
        renderWorkflowToolbarBoard();
        await screen.findByLabelText("Select workflow");

        fireEvent.click(screen.getByTestId("board-workflow-collapse-toggle"));

        expect(screen.queryByLabelText("Select workflow")).toBeNull();
        expect(screen.queryByRole("button", { name: "New workflow" })).toBeNull();
        expect(screen.queryByRole("button", { name: "Edit workflows" })).toBeNull();
        expect(screen.getByTestId("board-workflow-collapse-toggle").getAttribute("aria-expanded")).toBe("false");
        expect(screen.getByText("Workflow")).toBeDefined();
      });

      it("clicking the toggle again expands the toolbar", async () => {
        renderWorkflowToolbarBoard();
        await screen.findByLabelText("Select workflow");
        const toggle = screen.getByTestId("board-workflow-collapse-toggle");

        fireEvent.click(toggle);
        expect(screen.queryByLabelText("Select workflow")).toBeNull();
        fireEvent.click(toggle);

        expect(screen.getByLabelText("Select workflow")).toBeDefined();
        expect(screen.getByRole("button", { name: "New workflow" })).toBeDefined();
        expect(screen.getByRole("button", { name: "Edit workflows" })).toBeDefined();
        expect(toggle.getAttribute("aria-expanded")).toBe("true");
      });

      it("persists collapsed state to localStorage", async () => {
        renderWorkflowToolbarBoard();
        await screen.findByLabelText("Select workflow");
        const toggle = screen.getByTestId("board-workflow-collapse-toggle");

        fireEvent.click(toggle);
        expect(window.localStorage.getItem(BOARD_WORKFLOW_COLLAPSED_KEY)).toBe("1");

        fireEvent.click(toggle);
        expect(window.localStorage.getItem(BOARD_WORKFLOW_COLLAPSED_KEY)).toBe("0");
      });

      it("reads collapsed state from localStorage on mount", async () => {
        window.localStorage.setItem(BOARD_WORKFLOW_COLLAPSED_KEY, "1");

        renderWorkflowToolbarBoard();
        await waitFor(() => expect(screen.getByTestId("board-workflow-collapse-toggle")).toBeDefined());

        expect(screen.queryByLabelText("Select workflow")).toBeNull();
        expect(screen.queryByRole("button", { name: "New workflow" })).toBeNull();
        expect(screen.queryByRole("button", { name: "Edit workflows" })).toBeNull();
        expect(screen.getByTestId("board-workflow-collapse-toggle").getAttribute("aria-expanded")).toBe("false");
        expect(screen.getByText("Workflow")).toBeDefined();
      });
    });

    it("renders one selected workflow at a time and switches workflows from the dropdown", async () => {
      const onCreateWorkflow = vi.fn();
      const onOpenWorkflowEditor = vi.fn();
      enableFlag(
        { "FN-1": "builtin:coding", "FN-2": "wf-custom", "FN-3": "wf-custom" },
        [DEFAULT_WORKFLOW, CUSTOM_WORKFLOW],
      );
      renderBoard({
        tasks: [
          mkTask({ id: "FN-1" }),
          mkTask({ id: "FN-2", column: "intake" }),
          mkTask({ id: "FN-3", column: "intake" }),
        ],
        onCreateWorkflow,
        onOpenWorkflowEditor,
      });
      const selector = await screen.findByLabelText("Select workflow") as HTMLSelectElement;
      expect(selector.value).toBe("builtin:coding");
      expect(workflowToolbarActionNames()).toEqual(["Edit workflows", "New workflow"]);
      fireEvent.click(screen.getByRole("button", { name: "New workflow" }));
      fireEvent.click(screen.getByRole("button", { name: "Edit workflows" }));
      expect(onCreateWorkflow).toHaveBeenCalledTimes(1);
      expect(onOpenWorkflowEditor).toHaveBeenCalledTimes(1);
      expect(JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]").map((task: Task) => task.id)).toEqual(["FN-1"]);
      expect(screen.queryByTestId("column-intake")).toBeNull();

      fireEvent.change(selector, { target: { value: "wf-custom" } });
      await waitFor(() => expect(screen.getByTestId("column-intake")).toBeDefined());
      expect(JSON.parse(screen.getByTestId("column-intake").getAttribute("data-tasks") || "[]").map((task: Task) => task.id).sort()).toEqual(["FN-2", "FN-3"]);
      expect(screen.queryByTestId("column-todo")).toBeNull();

      fireEvent.click(screen.getByRole("button", { name: "Edit workflows" }));
      expect(onOpenWorkflowEditor).toHaveBeenCalledWith("wf-custom");
    });

    it("keeps the default workflow first in the dropdown even when another workflow has cards", async () => {
      enableFlag(
        { "FN-2": "wf-custom" },
        [DEFAULT_WORKFLOW, CUSTOM_WORKFLOW],
      );
      renderBoard({ tasks: [mkTask({ id: "FN-2", column: "intake" })] });
      const selector = await screen.findByLabelText("Select workflow") as HTMLSelectElement;
      const options = [...selector.options].map((option) => option.value);
      expect(options).toEqual(["builtin:coding", "wf-custom"]);
      expect(selector.value).toBe("builtin:coding");
      expect(screen.queryByTestId("column-intake")).toBeNull();
    });

    it("orders the default workflow first when workflow payload order differs", async () => {
      enableFlag(
        { "FN-1": "builtin:coding", "FN-2": "wf-custom" },
        [CUSTOM_WORKFLOW, DEFAULT_WORKFLOW],
      );
      renderBoard({ tasks: [mkTask({ id: "FN-1" }), mkTask({ id: "FN-2", column: "intake" })] });
      const selector = await screen.findByLabelText("Select workflow") as HTMLSelectElement;
      expect([...selector.options].map((option) => option.value)).toEqual(["builtin:coding", "wf-custom"]);
    });

    it("renders archived cards in the selected workflow archived column", async () => {
      enableFlag({ "FN-1": "builtin:coding", "FN-9": "builtin:coding" });
      renderBoard({ tasks: [mkTask({ id: "FN-1" }), mkTask({ id: "FN-9", column: "archived" })] });
      await waitFor(() => expect(screen.getByTestId("column-archived")).toBeDefined());
      const todoIds = JSON.parse(screen.getByTestId("column-todo").getAttribute("data-tasks") || "[]").map((task: Task) => task.id);
      expect(todoIds).toEqual(["FN-1"]);
      const archivedIds = JSON.parse(screen.getByTestId("column-archived").getAttribute("data-tasks") || "[]").map((task: Task) => task.id);
      expect(archivedIds).toEqual(["FN-9"]);
    });

    it("renders selected workflow columns as direct children of the horizontal board", async () => {
      enableFlag({ "FN-1": "builtin:coding" }, [DEFAULT_WORKFLOW, CUSTOM_WORKFLOW]);
      renderBoard({ tasks: [mkTask({ id: "FN-1" })] });
      await waitFor(() => expect(screen.getByRole("main").className).toContain("board-workflow-columns"));
      expect([...screen.getByRole("main").children].map((child) => child.getAttribute("data-testid"))).toEqual([
        "column-triage",
        "column-todo",
        "column-in-progress",
        "column-in-review",
        "column-done",
        "column-archived",
      ]);
    });

    it("archived column is collapsible in workflow mode", async () => {
      enableFlag({ "FN-9": "builtin:coding" });
      renderBoard({ tasks: [mkTask({ id: "FN-9", column: "archived" })] });

      const archivedColumn = await screen.findByTestId("column-archived");
      expect(archivedColumn.getAttribute("data-collapsed")).toBe("true");

      fireEvent.click(screen.getByRole("button", { name: "toggle-archived" }));
      expect(screen.getByTestId("column-archived").getAttribute("data-collapsed")).toBe("false");

      fireEvent.click(screen.getByRole("button", { name: "toggle-archived" }));
      expect(screen.getByTestId("column-archived").getAttribute("data-collapsed")).toBe("true");
    });

    it("workflow without archived column does not render one", async () => {
      enableFlag({ "FN-1": CUSTOM_WORKFLOW.id }, [CUSTOM_WORKFLOW]);
      renderBoard({ tasks: [mkTask({ id: "FN-1", column: "intake" })] });

      await waitFor(() => expect(screen.getByTestId("column-intake")).toBeDefined());
      expect(screen.queryByTestId("column-archived")).toBeNull();
    });

    it("done column in workflow mode receives onArchiveAllDone prop", async () => {
      const onArchiveAllDone = vi.fn();
      enableFlag({ "FN-1": "builtin:coding" });
      renderBoard({ tasks: [mkTask({ id: "FN-1", column: "done" })], onArchiveAllDone });

      await waitFor(() => expect(screen.getByTestId("column-done")).toBeDefined());
      expect(screen.getByTestId("column-done").getAttribute("data-has-archive-all")).toBe("yes");
      expect(screen.getByTestId("column-todo").getAttribute("data-has-archive-all")).toBe("no");
    });
  });

  describe("workflow:updated SSE invalidation (#1406)", () => {
    it("re-fetches board-workflows when a workflow:updated SSE event arrives", async () => {
      fetchBoardWorkflowsMock.mockResolvedValue({
        flagEnabled: false,
        defaultWorkflowId: "builtin:coding",
        workflows: [],
        taskWorkflowIds: {},
      });
      renderBoard({ projectId: "proj-1" });
      // Initial mount fetch.
      await waitFor(() => expect(fetchBoardWorkflowsMock).toHaveBeenCalledTimes(1));
      // Board subscribed for workflow lifecycle events.
      expect(subscribeSseMock).toHaveBeenCalled();
      expect(typeof sseHandlers["workflow:updated"]).toBe("function");

      // Simulate a server-pushed workflow:updated event → invalidate + re-fetch.
      await act(async () => {
        sseHandlers["workflow:updated"]?.();
      });
      await waitFor(() => expect(fetchBoardWorkflowsMock).toHaveBeenCalledTimes(2));
    });
  });
});