Files
fusion/packages/dashboard/app/components/__tests__/ResearchView.test.tsx
Fusion 5701596315 feat(FN-2994): merge fusion/fn-2994
Commits merged:
- fix(FN-2994): gate unavailable research workflow and humanize provider labels
- fix(FN-2994): polish research view form and history interactions
- feat(FN-2994): complete Step 5 — document research view architecture
- fix(FN-2994): align status-dot variant and hook/test conventions
- fix(FN-2994): address lint and typecheck issues
- test(FN-2994): cover research lifecycle actions and pending status
- fix(FN-2994): polish research actions and cited reader behavior
- feat(FN-2994): complete Step 3 — add lifecycle actions and task flows
- fix(FN-2994): ensure research enables header overflow gate
- feat(FN-2994): complete Step 2 — implement research view shell layout
- feat(FN-2994): complete Step 2 — gate research navigation and view
- feat(FN-2994): complete Step 1 — add research api surface and hook

Files changed:
docs/architecture.md                               |   7 +-
 docs/dashboard-guide.md                            |  21 ++
 packages/dashboard/app/App.tsx                     |  11 +-
 packages/dashboard/app/api/legacy.ts               | 143 ++++-----
 packages/dashboard/app/components/Header.tsx       |  29 +-
 packages/dashboard/app/components/MobileNavBar.tsx |  22 +-
 packages/dashboard/app/components/ResearchView.css | 247 +++++++++------
 packages/dashboard/app/components/ResearchView.tsx | 347 ++++++++++++++-------
 .../app/components/__tests__/ResearchView.test.tsx | 183 ++++++-----
 .../app/hooks/__tests__/useResearch.test.ts        |  66 ++++
 packages/dashboard/app/hooks/useResearch.ts        | 162 ++++++++++
 packages/dashboard/app/research-types.ts           |  43 +++
 packages/dashboard/app/styles.css                  |   4 +
 .../src/__tests__/research-routes.test.ts          |  65 ++++
 packages/dashboard/src/research-routes.ts          | 195 ++++++++++--
 15 files changed, 1111 insertions(+), 434 deletions(-)

Fusion-Task-Id: FN-2994
2026-04-30 03:43:21 -07:00

171 lines
6.2 KiB
TypeScript

import { describe, it, expect, vi, beforeEach } from "vitest";
import { fireEvent, render, screen, waitFor } from "@testing-library/react";
import { Header } from "../Header";
import { ResearchView } from "../ResearchView";
const mockUseResearch = vi.fn();
vi.mock("../../hooks/useResearch", () => ({
useResearch: (...args: unknown[]) => mockUseResearch(...args),
}));
vi.mock("../../api", () => ({
fetchScripts: vi.fn().mockResolvedValue({}),
}));
vi.mock("lucide-react", async (importOriginal) => {
const actual = await importOriginal<typeof import("lucide-react")>();
return {
...actual,
Search: () => null,
Loader2: ({ className }: { className?: string }) => <span data-testid="loader-icon" className={className}>Loader</span>,
};
});
function mockMatchMediaDesktop() {
Object.defineProperty(window, "matchMedia", {
writable: true,
value: vi.fn().mockImplementation((query: string) => ({
matches: false,
media: query,
onchange: null,
addEventListener: vi.fn(),
removeEventListener: vi.fn(),
dispatchEvent: vi.fn(),
})),
});
}
describe("Research navigation", () => {
it("shows research in header overflow and activates view change", async () => {
mockMatchMediaDesktop();
const onChangeView = vi.fn();
render(
<Header
onOpenSettings={vi.fn()}
onOpenGitHubImport={vi.fn()}
globalPaused={false}
enginePaused={false}
onToggleGlobalPause={vi.fn()}
onToggleEnginePause={vi.fn()}
view="board"
onChangeView={onChangeView}
experimentalFeatures={{ researchView: true }}
/>,
);
fireEvent.click(screen.getByTestId("view-toggle-overflow-trigger"));
await waitFor(() => expect(screen.getByTestId("view-overflow-research")).toBeInTheDocument());
fireEvent.click(screen.getByTestId("view-overflow-research"));
expect(onChangeView).toHaveBeenCalledWith("research");
});
});
describe("ResearchView", () => {
const baseHookValue = {
runs: [],
selectedRun: null,
selectedRunId: null,
setSelectedRunId: vi.fn(),
availability: { available: true, supportedProviders: ["web-search"], supportedExportFormats: ["markdown", "json", "html"] },
loading: false,
error: null,
searchQuery: "",
setSearchQuery: vi.fn(),
createRun: vi.fn(),
cancelRun: vi.fn().mockResolvedValue({}),
retryRun: vi.fn().mockResolvedValue({}),
exportRun: vi.fn().mockResolvedValue({ filename: "run.md", content: "# test", format: "markdown" }),
createTaskFromRun: vi.fn().mockResolvedValue({}),
attachRunToTask: vi.fn().mockResolvedValue({}),
statusCounts: { pending: 0, running: 0, completed: 0, failed: 0, cancelled: 0 },
refresh: vi.fn(),
};
beforeEach(() => {
vi.clearAllMocks();
mockUseResearch.mockReturnValue(baseHookValue);
});
it("renders empty state", () => {
render(<ResearchView projectId="p1" />);
expect(screen.getByTestId("research-state-empty")).toBeInTheDocument();
});
it("renders selected run details", () => {
mockUseResearch.mockReturnValue({
...baseHookValue,
runs: [{ id: "RR-1", title: "t", query: "q", status: "running" }],
selectedRun: { id: "RR-1", title: "t", query: "q", status: "running", events: [], results: { summary: "Summary", findings: [], citations: [] } },
selectedRunId: "RR-1",
statusCounts: { pending: 0, running: 1, completed: 0, failed: 0, cancelled: 0 },
});
render(<ResearchView projectId="p1" />);
expect(screen.getByTestId("research-state-results")).toHaveTextContent("Summary");
});
it("triggers lifecycle/task/export actions", async () => {
const cancelRun = vi.fn().mockResolvedValue({});
const retryRun = vi.fn().mockResolvedValue({});
const createTaskFromRun = vi.fn().mockResolvedValue({});
const attachRunToTask = vi.fn().mockResolvedValue({});
const exportRun = vi.fn().mockResolvedValue({ filename: "run.md", content: "# test", format: "markdown" });
mockUseResearch.mockReturnValue({
...baseHookValue,
runs: [{ id: "RR-1", title: "t", query: "q", status: "pending" }],
selectedRun: { id: "RR-1", title: "t", query: "q", status: "pending", events: [{ id: "E-1", message: "queued" }], results: { summary: "Summary", findings: [], citations: [] } },
selectedRunId: "RR-1",
cancelRun,
retryRun,
createTaskFromRun,
attachRunToTask,
exportRun,
});
render(<ResearchView projectId="p1" />);
fireEvent.click(screen.getByText("Cancel"));
fireEvent.click(screen.getByText("Retry"));
fireEvent.click(screen.getByText("Create Task"));
fireEvent.change(screen.getByPlaceholderText("Task ID"), { target: { value: "FN-1" } });
fireEvent.click(screen.getByText("Attach to Task"));
fireEvent.click(screen.getByText("Export MD"));
await waitFor(() => {
expect(cancelRun).toHaveBeenCalled();
expect(retryRun).toHaveBeenCalled();
expect(createTaskFromRun).toHaveBeenCalled();
expect(attachRunToTask).toHaveBeenCalled();
expect(exportRun).toHaveBeenCalled();
});
});
it("renders unavailable state without interactive workflow controls", () => {
mockUseResearch.mockReturnValue({ ...baseHookValue, availability: { available: false, reason: "disabled" } });
render(<ResearchView projectId="p1" />);
expect(screen.getByTestId("research-state-unavailable")).toBeInTheDocument();
expect(screen.queryByLabelText("Query")).not.toBeInTheDocument();
expect(screen.queryByText("Create Run")).not.toBeInTheDocument();
});
it("renders human-readable provider labels", () => {
mockUseResearch.mockReturnValue({
...baseHookValue,
availability: { available: true, supportedProviders: ["web-search", "page-fetch", "llm-synthesis"] },
});
render(<ResearchView projectId="p1" />);
expect(screen.getByText("Web Search")).toBeInTheDocument();
expect(screen.getByText("Page Fetch")).toBeInTheDocument();
expect(screen.getByText("LLM Synthesis")).toBeInTheDocument();
});
it("includes mobile layout media rule", async () => {
const css = await import("../ResearchView.css?inline");
expect(css.default).toContain("@media (max-width: 768px)");
expect(css.default).toContain(".research-view__layout");
});
});