import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"; import { fetchTaskDetail, updateTask, archiveTask, unarchiveTask, fetchAuthStatus, loginProvider, logoutProvider, fetchModels, addSteeringComment, addTaskComment, updateTaskComment, deleteTaskComment, fetchTaskComments, fetchGitRemotes, refineTask, fetchBatchStatus, fetchWorkspaces, fetchWorkspaceFileList, fetchWorkspaceFileContent, saveWorkspaceFileContent, startPlanningStreaming, fetchTasks, summarizeTitle, fetchProjects, registerProject, unregisterProject, fetchProjectHealth, fetchActivityFeed, pauseProject, resumeProject, fetchFirstRunStatus, fetchGlobalConcurrency, fetchProjectTasks, fetchProjectConfig, fetchExecutorStats, type ProjectInfo, type ProjectHealth, type ActivityFeedEntry, type FirstRunStatus, type GlobalConcurrencyState, type ExecutorStats, type ExecutorState, } from "./api"; import type { Task, TaskDetail, BatchStatusResponse } from "@fusion/core"; const FAKE_DETAIL: TaskDetail = { id: "FN-001", description: "Test", column: "in-progress", dependencies: [], steps: [], currentStep: 0, log: [], createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z", prompt: "# FN-001", }; function mockFetchResponse( ok: boolean, body: unknown, status = ok ? 200 : 500, contentType = "application/json" ) { const bodyText = JSON.stringify(body); return Promise.resolve({ ok, status, statusText: ok ? "OK" : "Error", headers: { get: (name: string) => name.toLowerCase() === "content-type" ? contentType : null, }, json: () => Promise.resolve(body), text: () => Promise.resolve(bodyText), } as unknown as Response); } describe("fetchTaskDetail", () => { const originalFetch = globalThis.fetch; beforeEach(() => { vi.useFakeTimers({ shouldAdvanceTime: true }); }); afterEach(() => { globalThis.fetch = originalFetch; vi.useRealTimers(); }); it("returns data on first success", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_DETAIL)); const result = await fetchTaskDetail("FN-001"); expect(result.id).toBe("FN-001"); expect(globalThis.fetch).toHaveBeenCalledTimes(1); }); it("retries once on failure then succeeds", async () => { globalThis.fetch = vi.fn() .mockReturnValueOnce(mockFetchResponse(false, { error: "Transient error" })) .mockReturnValueOnce(mockFetchResponse(true, FAKE_DETAIL)); const result = await fetchTaskDetail("FN-001"); expect(result.id).toBe("FN-001"); expect(globalThis.fetch).toHaveBeenCalledTimes(2); }); it("throws after retry exhaustion", async () => { globalThis.fetch = vi.fn() .mockReturnValue(mockFetchResponse(false, { error: "Server error" })); await expect(fetchTaskDetail("FN-001")).rejects.toThrow("Server error"); expect(globalThis.fetch).toHaveBeenCalledTimes(2); // initial + 1 retry }); }); describe("updateTask", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); const FAKE_TASK: Task = { id: "FN-001", description: "Test", column: "in-progress", dependencies: ["FN-002"], steps: [], currentStep: 0, log: [], createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z", }; it("sends PATCH with dependencies and returns updated task", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_TASK)); const result = await updateTask("FN-001", { dependencies: ["FN-002"] }); expect(result.dependencies).toEqual(["FN-002"]); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001", { headers: { "Content-Type": "application/json" }, method: "PATCH", body: JSON.stringify({ dependencies: ["FN-002"] }), }); }); it("throws on error response", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Not found" })); await expect(updateTask("FN-001", { dependencies: [] })).rejects.toThrow("Not found"); }); }); describe("task comments api", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); const FAKE_TASK: Task = { id: "FN-001", description: "Test", column: "todo", dependencies: [], steps: [], currentStep: 0, log: [], createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z", comments: [{ id: "c1", text: "Hello", author: "user", createdAt: "2026-01-01T00:00:00.000Z" }], }; it("fetches task comments", async () => { const comments = FAKE_TASK.comments!; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, comments)); const result = await fetchTaskComments("FN-001"); expect(result).toEqual(comments); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/comments", { headers: { "Content-Type": "application/json" }, }); }); it("adds a task comment", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_TASK)); const result = await addTaskComment("FN-001", "Hello", "user"); expect(result).toEqual(FAKE_TASK); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/comments", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ text: "Hello", author: "user" }), }); }); it("updates a task comment", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_TASK)); await updateTaskComment("FN-001", "c1", "Updated"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/comments/c1", { headers: { "Content-Type": "application/json" }, method: "PATCH", body: JSON.stringify({ text: "Updated" }), }); }); it("deletes a task comment", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_TASK)); await deleteTaskComment("FN-001", "c1"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/comments/c1", { headers: { "Content-Type": "application/json" }, method: "DELETE", }); }); }); describe("fetchModels", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns available models with favorites", async () => { const response = { models: [ { provider: "anthropic", id: "claude-sonnet-4-5", name: "Claude Sonnet 4.5", reasoning: true, contextWindow: 200000 }, ], favoriteProviders: ["anthropic"], favoriteModels: ["anthropic/claude-sonnet-4-5"], }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await fetchModels(); expect(result).toEqual(response); expect(globalThis.fetch).toHaveBeenCalledWith("/api/models", { headers: { "Content-Type": "application/json" }, }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Server error" })); await expect(fetchModels()).rejects.toThrow("Server error"); }); }); describe("fetchBatchStatus", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("posts task ids and unwraps the results envelope", async () => { const response: BatchStatusResponse = { results: { "FN-001": { issueInfo: { url: "https://github.com/owner/repo/issues/101", number: 101, state: "closed", title: "Issue 101", stateReason: "completed", lastCheckedAt: "2026-03-30T12:00:00.000Z", }, stale: false, }, }, }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await fetchBatchStatus(["FN-001"]); expect(result).toEqual(response.results); expect(globalThis.fetch).toHaveBeenCalledWith("/api/github/batch/status", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ taskIds: ["FN-001"] }), }); }); it("propagates API errors", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "rate limit exceeded" }, 429)); await expect(fetchBatchStatus(["FN-001"])).rejects.toThrow("rate limit exceeded"); }); }); describe("batchUpdateTaskModels", () => { const originalFetch = globalThis.fetch; beforeEach(() => { globalThis.fetch = vi.fn(); }); afterEach(() => { globalThis.fetch = originalFetch; }); it("calls API with correct parameters for executor model update", async () => { const mockResponse = { updated: [{ id: "FN-001", modelProvider: "openai", modelId: "gpt-4o" }], count: 1, }; (globalThis.fetch as ReturnType).mockResolvedValue( mockFetchResponse(true, mockResponse) ); const { batchUpdateTaskModels } = await import("./api"); const result = await batchUpdateTaskModels(["FN-001"], "openai", "gpt-4o"); expect(result.count).toBe(1); expect(result.updated).toHaveLength(1); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/tasks/batch-update-models", expect.objectContaining({ method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ taskIds: ["FN-001"], modelProvider: "openai", modelId: "gpt-4o", }), }) ); }); it("calls API with correct parameters for validator model update", async () => { const mockResponse = { updated: [], count: 0 }; (globalThis.fetch as ReturnType).mockResolvedValue( mockFetchResponse(true, mockResponse) ); const { batchUpdateTaskModels } = await import("./api"); await batchUpdateTaskModels( ["FN-001", "FN-002"], undefined, undefined, "anthropic", "claude-sonnet-4-5" ); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/tasks/batch-update-models", expect.objectContaining({ body: JSON.stringify({ taskIds: ["FN-001", "FN-002"], validatorModelProvider: "anthropic", validatorModelId: "claude-sonnet-4-5", }), }) ); }); it("calls API with null values to clear models", async () => { const mockResponse = { updated: [{ id: "FN-001" }], count: 1 }; (globalThis.fetch as ReturnType).mockResolvedValue( mockFetchResponse(true, mockResponse) ); const { batchUpdateTaskModels } = await import("./api"); await batchUpdateTaskModels(["FN-001"], null, null); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/tasks/batch-update-models", expect.objectContaining({ body: JSON.stringify({ taskIds: ["FN-001"], modelProvider: null, modelId: null, }), }) ); }); it("throws on 400 validation error", async () => { (globalThis.fetch as ReturnType).mockResolvedValue( mockFetchResponse(false, { error: "taskIds must be an array" }, 400) ); const { batchUpdateTaskModels } = await import("./api"); await expect(batchUpdateTaskModels([], "openai", "gpt-4o")).rejects.toThrow( "taskIds must be an array" ); }); it("throws on 404 when task not found", async () => { (globalThis.fetch as ReturnType).mockResolvedValue( mockFetchResponse(false, { error: "Task KB-999 not found" }, 404) ); const { batchUpdateTaskModels } = await import("./api"); await expect(batchUpdateTaskModels(["KB-999"], "openai", "gpt-4o")).rejects.toThrow( "Task KB-999 not found" ); }); it("throws on network error", async () => { (globalThis.fetch as ReturnType).mockRejectedValue(new Error("Network failed")); const { batchUpdateTaskModels } = await import("./api"); await expect(batchUpdateTaskModels(["FN-001"], "openai", "gpt-4o")).rejects.toThrow( "Network failed" ); }); }); describe("fetchAuthStatus", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns providers with auth status", async () => { const response = { providers: [{ id: "anthropic", name: "Anthropic", authenticated: true }] }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await fetchAuthStatus(); expect(result.providers).toEqual([{ id: "anthropic", name: "Anthropic", authenticated: true }]); expect(globalThis.fetch).toHaveBeenCalledWith("/api/auth/status", { headers: { "Content-Type": "application/json" }, }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Server error" })); await expect(fetchAuthStatus()).rejects.toThrow("Server error"); }); }); describe("loginProvider", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("sends POST and returns auth URL", async () => { const response = { url: "https://auth.example.com/login", instructions: "Open in browser" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await loginProvider("anthropic"); expect(result.url).toBe("https://auth.example.com/login"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/auth/login", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ provider: "anthropic" }), }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Unknown provider" })); await expect(loginProvider("bad")).rejects.toThrow("Unknown provider"); }); }); describe("logoutProvider", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("sends POST to logout", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { success: true })); const result = await logoutProvider("anthropic"); expect(result.success).toBe(true); expect(globalThis.fetch).toHaveBeenCalledWith("/api/auth/logout", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ provider: "anthropic" }), }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "logout failed" })); await expect(logoutProvider("anthropic")).rejects.toThrow("logout failed"); }); }); describe("addSteeringComment", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); const FAKE_TASK: Task = { id: "FN-001", description: "Test", column: "in-progress", dependencies: [], steps: [], currentStep: 0, log: [], createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z", steeringComments: [ { id: "1234567890-abc123", text: "Please handle the edge case", createdAt: "2026-01-01T00:00:00.000Z", author: "user", }, ], }; it("sends POST with text and returns updated task", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_TASK)); const result = await addSteeringComment("FN-001", "Please handle the edge case"); expect(result.id).toBe("FN-001"); expect(result.steeringComments).toHaveLength(1); expect(result.steeringComments![0].text).toBe("Please handle the edge case"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/steer", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ text: "Please handle the edge case" }), }); }); it("throws on error response", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Task not found" }) ); await expect(addSteeringComment("FN-001", "Test comment")).rejects.toThrow("Task not found"); }); }); describe("fetchGitRemotes", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns array of GitHub remotes", async () => { const remotes = [ { name: "origin", owner: "dustinbyrne", repo: "kb", url: "https://github.com/dustinbyrne/kb.git" }, ]; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, remotes)); const result = await fetchGitRemotes(); expect(result).toEqual(remotes); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/remotes", { headers: { "Content-Type": "application/json" }, }); }); it("returns empty array when no remotes", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, [])); const result = await fetchGitRemotes(); expect(result).toEqual([]); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Failed to execute git command" })); await expect(fetchGitRemotes()).rejects.toThrow("Failed to execute git command"); }); }); import { fetchGitRemotesDetailed, addGitRemote, removeGitRemote, renameGitRemote, updateGitRemoteUrl, } from "./api"; describe("fetchGitRemotesDetailed", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns array of remotes with fetch and push URLs", async () => { const remotes = [ { name: "origin", fetchUrl: "https://github.com/dustinbyrne/kb.git", pushUrl: "https://github.com/dustinbyrne/kb.git" }, { name: "upstream", fetchUrl: "https://github.com/upstream/kb.git", pushUrl: "git@github.com:upstream/kb.git" }, ]; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, remotes)); const result = await fetchGitRemotesDetailed(); expect(result).toEqual(remotes); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/remotes/detailed", { headers: { "Content-Type": "application/json" }, }); }); it("returns empty array when no remotes", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, [])); const result = await fetchGitRemotesDetailed(); expect(result).toEqual([]); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Not a git repository" }, 400)); await expect(fetchGitRemotesDetailed()).rejects.toThrow("Not a git repository"); }); }); describe("addGitRemote", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("adds a new remote successfully", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { name: "origin", added: true }, 201)); await addGitRemote("origin", "https://github.com/dustinbyrne/kb.git"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/remotes", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ name: "origin", url: "https://github.com/dustinbyrne/kb.git" }), }); }); it("throws on invalid name", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Invalid remote name" }, 400)); await expect(addGitRemote("invalid;cmd", "https://github.com/test/repo.git")).rejects.toThrow("Invalid remote name"); }); it("throws on invalid URL", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Invalid git URL format" }, 400)); await expect(addGitRemote("origin", "not-a-valid-url")).rejects.toThrow("Invalid git URL format"); }); it("throws on duplicate remote", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Remote 'origin' already exists" }, 409)); await expect(addGitRemote("origin", "https://github.com/test/repo.git")).rejects.toThrow("Remote 'origin' already exists"); }); }); describe("removeGitRemote", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("removes a remote successfully", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { name: "origin", removed: true })); await removeGitRemote("origin"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/remotes/origin", { method: "DELETE", headers: { "Content-Type": "application/json" }, }); }); it("throws on invalid name", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Invalid remote name" }, 400)); await expect(removeGitRemote("invalid;cmd")).rejects.toThrow("Invalid remote name"); }); it("throws when remote does not exist", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Remote 'origin' does not exist" }, 404)); await expect(removeGitRemote("origin")).rejects.toThrow("Remote 'origin' does not exist"); }); }); describe("renameGitRemote", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("renames a remote successfully", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { oldName: "origin", newName: "upstream", renamed: true })); await renameGitRemote("origin", "upstream"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/remotes/origin", { method: "PATCH", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ newName: "upstream" }), }); }); it("throws on invalid name", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Invalid remote name" }, 400)); await expect(renameGitRemote("invalid;cmd", "upstream")).rejects.toThrow("Invalid remote name"); }); it("throws when remote does not exist", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Remote 'origin' does not exist" }, 404)); await expect(renameGitRemote("origin", "upstream")).rejects.toThrow("Remote 'origin' does not exist"); }); it("throws when new name already exists", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Remote 'upstream' already exists" }, 409)); await expect(renameGitRemote("origin", "upstream")).rejects.toThrow("Remote 'upstream' already exists"); }); }); describe("updateGitRemoteUrl", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("updates remote URL successfully", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { name: "origin", url: "https://new-url.com/repo.git", updated: true })); await updateGitRemoteUrl("origin", "https://new-url.com/repo.git"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/remotes/origin/url", { method: "PUT", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ url: "https://new-url.com/repo.git" }), }); }); it("throws on invalid name", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Invalid remote name" }, 400)); await expect(updateGitRemoteUrl("invalid;cmd", "https://github.com/test/repo.git")).rejects.toThrow("Invalid remote name"); }); it("throws on invalid URL", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Invalid git URL format" }, 400)); await expect(updateGitRemoteUrl("origin", "not-a-valid-url")).rejects.toThrow("Invalid git URL format"); }); it("throws when remote does not exist", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Remote 'origin' does not exist" }, 404)); await expect(updateGitRemoteUrl("origin", "https://github.com/test/repo.git")).rejects.toThrow("Remote 'origin' does not exist"); }); }); // --- Plan approval API tests --- import { approvePlan, rejectPlan } from "./api"; describe("approvePlan", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("approves plan and returns updated task", async () => { const approvedTask: Task = { ...FAKE_DETAIL, column: "todo", status: undefined, }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, approvedTask)); const result = await approvePlan("FN-001"); expect(result.column).toBe("todo"); expect(result.status).toBeUndefined(); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/approve-plan", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); it("throws on error response", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Task must be in 'triage' column to approve plan" }, 400) ); await expect(approvePlan("FN-001")).rejects.toThrow("triage"); }); }); describe("rejectPlan", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("rejects plan and returns updated task", async () => { const rejectedTask: Task = { ...FAKE_DETAIL, column: "triage", status: undefined, }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, rejectedTask)); const result = await rejectPlan("FN-001"); expect(result.column).toBe("triage"); expect(result.status).toBeUndefined(); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/reject-plan", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); it("throws on error response", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Task must have status 'awaiting-approval' to reject plan" }, 400) ); await expect(rejectPlan("FN-001")).rejects.toThrow("awaiting-approval"); }); }); // --- Refinement API tests --- describe("refineTask", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); const FAKE_REFINED_TASK: Task = { id: "FN-002", description: "Refinement of FN-001", column: "triage", dependencies: ["FN-001"], steps: [], currentStep: 0, log: [], createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z", }; it("sends POST with feedback and returns new refinement task", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_REFINED_TASK)); const result = await refineTask("FN-001", "Need to add more tests and improve error handling"); expect(result.id).toBe("FN-002"); expect(result.column).toBe("triage"); expect(result.dependencies).toContain("FN-001"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/refine", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ feedback: "Need to add more tests and improve error handling" }), }); }); it("throws on error response when task not found", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Task not found" }, 404) ); await expect(refineTask("KB-999", "feedback")).rejects.toThrow("Task not found"); }); it("throws on error response when task not in done/in-review", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Task must be in 'done' or 'in-review' column to refine" }, 400) ); await expect(refineTask("FN-001", "feedback")).rejects.toThrow("done' or 'in-review'"); }); }); // --- Git Management API tests --- import { fetchGitStatus, fetchGitCommits, fetchCommitDiff, fetchGitBranches, fetchGitWorktrees, createBranch, checkoutBranch, deleteBranch, fetchRemote, pullBranch, pushBranch, } from "./api"; describe("Git Management API", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); describe("fetchGitStatus", () => { it("returns git status", async () => { const status = { branch: "main", commit: "abc1234", isDirty: false, ahead: 0, behind: 0 }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, status)); const result = await fetchGitStatus(); expect(result).toEqual(status); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/status", { headers: { "Content-Type": "application/json" }, }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Not a git repository" }, 400)); await expect(fetchGitStatus()).rejects.toThrow("Not a git repository"); }); }); describe("fetchGitCommits", () => { it("returns commits without limit", async () => { const commits = [ { hash: "abc123", shortHash: "abc", message: "Test commit", author: "User", date: "2026-01-01", parents: [] }, ]; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, commits)); const result = await fetchGitCommits(); expect(result).toEqual(commits); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/commits", { headers: { "Content-Type": "application/json" }, }); }); it("includes limit in query string", async () => { const commits = [{ hash: "abc123", shortHash: "abc", message: "Test", author: "User", date: "2026-01-01", parents: [] }]; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, commits)); const result = await fetchGitCommits(50); expect(result).toEqual(commits); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/commits?limit=50", { headers: { "Content-Type": "application/json" }, }); }); }); describe("fetchCommitDiff", () => { it("returns diff for a commit", async () => { const diff = { stat: "1 file changed", patch: "diff content" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, diff)); const result = await fetchCommitDiff("abc123"); expect(result).toEqual(diff); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/commits/abc123/diff", { headers: { "Content-Type": "application/json" }, }); }); it("throws on 404", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Commit not found" }, 404)); await expect(fetchCommitDiff("invalid")).rejects.toThrow("Commit not found"); }); }); describe("fetchGitBranches", () => { it("returns branches array", async () => { const branches = [{ name: "main", isCurrent: true, remote: "origin/main" }]; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, branches)); const result = await fetchGitBranches(); expect(result).toEqual(branches); }); }); describe("fetchGitWorktrees", () => { it("returns worktrees array", async () => { const worktrees = [{ path: "/path/to/repo", branch: "main", isMain: true, isBare: false }]; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, worktrees)); const result = await fetchGitWorktrees(); expect(result).toEqual(worktrees); }); }); describe("createBranch", () => { it("sends POST to create branch", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { created: true }, 201)); await createBranch("feature-branch"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/branches", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ name: "feature-branch", base: undefined }), }); }); it("sends base when provided", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { created: true }, 201)); await createBranch("feature-branch", "main"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/branches", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ name: "feature-branch", base: "main" }), }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Invalid branch name" }, 400)); await expect(createBranch("invalid")).rejects.toThrow("Invalid branch name"); }); }); describe("checkoutBranch", () => { it("sends POST to checkout branch", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { checkedOut: "main" })); await checkoutBranch("main"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/branches/main/checkout", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); it("encodes branch name", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, {})); await checkoutBranch("feature/test"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/branches/feature%2Ftest/checkout", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); }); describe("deleteBranch", () => { it("sends DELETE to remove branch", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { deleted: "feature" })); await deleteBranch("feature"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/branches/feature", { headers: { "Content-Type": "application/json" }, method: "DELETE", }); }); it("includes force query param when true", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { deleted: "feature" })); await deleteBranch("feature", true); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/branches/feature?force=true", { headers: { "Content-Type": "application/json" }, method: "DELETE", }); }); }); describe("fetchRemote", () => { it("sends POST to fetch origin by default", async () => { const result = { fetched: true, message: "Fetched" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, result)); const response = await fetchRemote(); expect(response).toEqual(result); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/fetch", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ remote: undefined }), }); }); it("sends custom remote when provided", async () => { const result = { fetched: true, message: "Fetched from upstream" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, result)); await fetchRemote("upstream"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/fetch", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ remote: "upstream" }), }); }); }); describe("pullBranch", () => { it("sends POST to pull", async () => { const result = { success: true, message: "Pulled 2 commits" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, result)); const response = await pullBranch(); expect(response).toEqual(result); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/pull", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); it("returns conflict info when there are conflicts", async () => { const result = { success: false, message: "Merge conflict", conflict: true }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, result, 409)); const response = await pullBranch(); expect(response.conflict).toBe(true); }); }); describe("pushBranch", () => { it("sends POST to push", async () => { const result = { success: true, message: "Pushed to origin" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, result)); const response = await pushBranch(); expect(response).toEqual(result); expect(globalThis.fetch).toHaveBeenCalledWith("/api/git/push", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); it("throws on rejection", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Push rejected" }, 409)); await expect(pushBranch()).rejects.toThrow("Push rejected"); }); }); describe("archiveTask", () => { it("sends POST to archive endpoint", async () => { const archivedTask: Task = { ...FAKE_DETAIL, column: "archived" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, archivedTask)); const response = await archiveTask("FN-001"); expect(response.column).toBe("archived"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/archive", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Task not in done" }, 400)); await expect(archiveTask("FN-001")).rejects.toThrow("Task not in done"); }); }); describe("unarchiveTask", () => { it("sends POST to unarchive endpoint", async () => { const unarchivedTask: Task = { ...FAKE_DETAIL, column: "done" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, unarchivedTask)); const response = await unarchiveTask("FN-001"); expect(response.column).toBe("done"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/tasks/FN-001/unarchive", { headers: { "Content-Type": "application/json" }, method: "POST", }); }); it("throws on error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Task not in archived" }, 400)); await expect(unarchiveTask("FN-001")).rejects.toThrow("Task not in archived"); }); }); describe("workspace file APIs", () => { it("fetchWorkspaces requests the workspace list", async () => { const payload = { project: "/repo", tasks: [{ id: "FN-001", title: "Task", worktree: "/repo/.worktrees/kb-001" }], }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, payload)); const response = await fetchWorkspaces(); expect(response).toEqual(payload); expect(globalThis.fetch).toHaveBeenCalledWith("/api/workspaces", { headers: { "Content-Type": "application/json" }, }); }); it("fetchWorkspaceFileList sends workspace and path query params", async () => { const payload = { path: "src", entries: [] }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, payload)); const response = await fetchWorkspaceFileList("FN-001", "src"); expect(response).toEqual(payload); expect(globalThis.fetch).toHaveBeenCalledWith("/api/files?workspace=FN-001&path=src", { headers: { "Content-Type": "application/json" }, }); }); it("fetchWorkspaceFileContent sends the workspace query param", async () => { const payload = { content: "hello", mtime: "2026-01-01T00:00:00.000Z", size: 5 }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, payload)); const response = await fetchWorkspaceFileContent("project", "src/index.ts"); expect(response).toEqual(payload); expect(globalThis.fetch).toHaveBeenCalledWith("/api/files/src%2Findex.ts?workspace=project", { headers: { "Content-Type": "application/json" }, }); }); it("saveWorkspaceFileContent posts content to the workspace route", async () => { const payload = { success: true, mtime: "2026-01-01T00:00:00.000Z", size: 5 }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, payload)); const response = await saveWorkspaceFileContent("FN-001", "src/index.ts", "hello"); expect(response).toEqual(payload); expect(globalThis.fetch).toHaveBeenCalledWith("/api/files/src%2Findex.ts?workspace=FN-001", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ content: "hello" }), }); }); it("propagates workspace API errors", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Task not found" }, 404)); await expect(fetchWorkspaceFileList("FN-404")).rejects.toThrow("Task not found"); }); }); }); // --- Planning Mode API Tests --- import { startPlanning, respondToPlanning, cancelPlanning, createTaskFromPlanning } from "./api"; import type { PlanningQuestion, PlanningSummary } from "@fusion/core"; describe("Planning Mode API", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); const FAKE_QUESTION: PlanningQuestion = { id: "q-scope", type: "single_select", question: "What is the scope of this plan?", description: "This helps estimate the size and complexity.", options: [ { id: "small", label: "Small", description: "Quick implementation" }, { id: "large", label: "Large", description: "Complex feature" }, ], }; const FAKE_SUMMARY: PlanningSummary = { title: "Build user authentication", description: "Implement login/logout with JWT tokens", suggestedSize: "M", suggestedDependencies: [], keyDeliverables: ["Login form", "JWT middleware", "Logout endpoint"], }; describe("startPlanning", () => { it("sends POST with initial plan and returns session", async () => { const response = { sessionId: "plan-123", currentQuestion: FAKE_QUESTION, summary: null }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response, 201)); const result = await startPlanning("Build a user auth system"); expect(result.sessionId).toBe("plan-123"); expect(result.currentQuestion).toEqual(FAKE_QUESTION); expect(globalThis.fetch).toHaveBeenCalledWith("/api/planning/start", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ initialPlan: "Build a user auth system" }), }); }); it("throws on rate limit error", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Rate limit exceeded. Maximum 5 planning sessions per hour." }, 429) ); await expect(startPlanning("Build something")).rejects.toThrow("Rate limit exceeded"); }); it("throws on validation error", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "initialPlan must be 500 characters or less" }, 400) ); await expect(startPlanning("a".repeat(600))).rejects.toThrow("500 characters"); }); }); describe("respondToPlanning", () => { it("sends POST with responses and returns next question", async () => { const response = { sessionId: "plan-123", currentQuestion: FAKE_QUESTION, summary: null }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await respondToPlanning("plan-123", { scope: "small" }); expect(result.sessionId).toBe("plan-123"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/planning/respond", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ sessionId: "plan-123", responses: { scope: "small" } }), }); }); it("returns summary when planning is complete", async () => { const response = { sessionId: "plan-123", currentQuestion: null, summary: FAKE_SUMMARY }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await respondToPlanning("plan-123", { final: "yes" }); expect(result.summary).toEqual(FAKE_SUMMARY); expect(result.currentQuestion).toBeNull(); }); it("throws on session not found", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Planning session plan-123 not found or expired" }, 404) ); await expect(respondToPlanning("plan-123", {})).rejects.toThrow("not found"); }); }); describe("cancelPlanning", () => { it("sends POST to cancel endpoint", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { success: true })); await cancelPlanning("plan-123"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/planning/cancel", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ sessionId: "plan-123" }), }); }); it("throws on session not found", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Planning session not found" }, 404) ); await expect(cancelPlanning("plan-123")).rejects.toThrow("not found"); }); }); describe("createTaskFromPlanning", () => { it("sends POST to create-task endpoint and returns task", async () => { const createdTask: Task = { id: "FN-042", title: "Build user authentication", description: "Implement login/logout with JWT tokens", column: "triage", dependencies: [], steps: [], currentStep: 0, log: [], createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z", }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, createdTask, 201)); const result = await createTaskFromPlanning("plan-123"); expect(result.id).toBe("FN-042"); expect(result.column).toBe("triage"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/planning/create-task", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ sessionId: "plan-123" }), }); }); it("throws when session is not complete", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Planning session is not complete" }, 400) ); await expect(createTaskFromPlanning("plan-123")).rejects.toThrow("not complete"); }); it("throws on session not found", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Planning session not found" }, 404) ); await expect(createTaskFromPlanning("plan-123")).rejects.toThrow("not found"); }); }); }); // --- API Error Handling Tests --- import { fetchTasks } from "./api"; /** Mock helper for HTML error responses (e.g., 404 page) */ function mockHtmlErrorResponse(status: number, htmlBody: string) { return Promise.resolve({ ok: false, status, statusText: "Not Found", headers: { get: (name: string) => name.toLowerCase() === "content-type" ? "text/html" : null, }, json: () => Promise.reject(new Error("JSON parse error")), text: () => Promise.resolve(htmlBody), } as unknown as Response); } describe("API Error Handling", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); describe("JSON responses", () => { it("parses successful JSON responses correctly", async () => { const tasks = [{ id: "FN-001", title: "Test Task" }]; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, tasks)); const result = await fetchTasks(); expect(result).toEqual(tasks); }); it("extracts error field from JSON error responses", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Task not found" }, 404) ); await expect(fetchTasks()).rejects.toThrow("Task not found"); }); it("uses status text when JSON error has no error field", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { message: "Different field" }, 500) ); await expect(fetchTasks()).rejects.toThrow("Request failed for /api/tasks: 500 Error"); }); }); describe("Non-JSON error responses", () => { it("throws meaningful error for HTML 404 response", async () => { const html404 = "Not Found"; globalThis.fetch = vi.fn().mockReturnValue(mockHtmlErrorResponse(404, html404)); await expect(fetchTasks()).rejects.toThrow("API returned HTML instead of JSON"); await expect(fetchTasks()).rejects.toThrow("404 Not Found"); }); it("truncates long HTML responses in error message", async () => { const longHtml = "" + "x".repeat(200); globalThis.fetch = vi.fn().mockReturnValue(mockHtmlErrorResponse(500, longHtml)); await expect(fetchTasks()).rejects.toThrow("API returned HTML instead of JSON"); await expect(fetchTasks()).rejects.not.toThrow(longHtml); }); it("handles empty HTML error responses", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockHtmlErrorResponse(500, "")); await expect(fetchTasks()).rejects.toThrow("API returned HTML instead of JSON"); }); }); describe("Non-JSON success responses", () => { it("throws a descriptive HTML fallback error including the endpoint URL", async () => { globalThis.fetch = vi.fn().mockReturnValue( Promise.resolve({ ok: true, status: 200, statusText: "OK", headers: { get: (name: string) => name.toLowerCase() === "content-type" ? "text/html" : null, }, json: () => Promise.reject(new Error("JSON parse error")), text: () => Promise.resolve("Unexpected HTML"), } as unknown as Response) ); await expect(fetchTasks()).rejects.toThrow("API returned HTML instead of JSON for /api/tasks"); }); it("includes planning endpoint URL and status when HTML is returned", async () => { globalThis.fetch = vi.fn().mockReturnValue( Promise.resolve({ ok: true, status: 200, statusText: "OK", headers: { get: (name: string) => name.toLowerCase() === "content-type" ? "text/html" : null, }, json: () => Promise.reject(new Error("JSON parse error")), text: () => Promise.resolve("SPA Fallback"), } as unknown as Response) ); await expect(startPlanningStreaming("Build auth")).rejects.toThrow( "API returned HTML instead of JSON for /api/planning/start-streaming. The endpoint may not be properly configured. (200 OK)" ); }); }); describe("JSON parsing edge cases", () => { it("reports invalid JSON with the endpoint URL", async () => { globalThis.fetch = vi.fn().mockReturnValue( Promise.resolve({ ok: false, status: 500, statusText: "Internal Server Error", headers: { get: (name: string) => name.toLowerCase() === "content-type" ? "application/json" : null, }, json: () => Promise.reject(new Error("Invalid JSON")), text: () => Promise.resolve("{invalid json}"), } as unknown as Response) ); await expect(fetchTasks()).rejects.toThrow( "API returned invalid JSON for /api/tasks. (500 Internal Server Error)" ); }); }); }); // ── AI Text Refinement API Tests ─────────────────────────────────────────── import { refineText, getRefineErrorMessage, REFINE_ERROR_MESSAGES, type RefinementType } from "./api"; describe("refineText", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("sends POST with text and type, returns refined text", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(true, { refined: "Refined task description" }) ); const result = await refineText("Original text", "clarify"); expect(result).toBe("Refined task description"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/ai/refine-text", { headers: { "Content-Type": "application/json" }, method: "POST", body: JSON.stringify({ text: "Original text", type: "clarify" }), }); }); it("works with all four refinement types", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(true, { refined: "Refined" }) ); const types: RefinementType[] = ["clarify", "add-details", "expand", "simplify"]; for (const type of types) { const result = await refineText("Test text", type); expect(result).toBe("Refined"); } }); it("throws on rate limit error (429)", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "Rate limit exceeded. Maximum 10 refinement requests per hour." }, 429) ); await expect(refineText("Test", "clarify")).rejects.toThrow("Rate limit exceeded"); }); it("throws on invalid type error (422)", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "type must be one of: clarify, add-details, expand, simplify" }, 422) ); await expect(refineText("Test", "invalid" as RefinementType)).rejects.toThrow("type must be one of"); }); it("throws on validation error (400)", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "text must be at least 1 character" }, 400) ); await expect(refineText("", "clarify")).rejects.toThrow("text must be at least 1 character"); }); it("throws on server error (500)", async () => { globalThis.fetch = vi.fn().mockReturnValue( mockFetchResponse(false, { error: "AI service error" }, 500) ); await expect(refineText("Test", "clarify")).rejects.toThrow("AI service error"); }); }); describe("getRefineErrorMessage", () => { it("returns rate limit message for rate limit errors", () => { const error = new Error("Rate limit exceeded"); expect(getRefineErrorMessage(error)).toBe(REFINE_ERROR_MESSAGES.RATE_LIMIT); }); it("returns rate limit message for 429 status", () => { const error = new Error("429 Too Many Requests"); expect(getRefineErrorMessage(error)).toBe(REFINE_ERROR_MESSAGES.RATE_LIMIT); }); it("returns invalid type message for invalid type errors", () => { const error = new Error("Invalid type selected"); expect(getRefineErrorMessage(error)).toBe(REFINE_ERROR_MESSAGES.INVALID_TYPE); }); it("passes through text validation errors", () => { const error = new Error("text must be at least 1 character"); expect(getRefineErrorMessage(error)).toBe("text must be at least 1 character"); }); it("passes through text length errors", () => { const error = new Error("text must not exceed 2000 characters"); expect(getRefineErrorMessage(error)).toBe("text must not exceed 2000 characters"); }); it("passes through type required errors", () => { const error = new Error("type is required"); expect(getRefineErrorMessage(error)).toBe("type is required"); }); it("returns network message for unknown errors", () => { const error = new Error("Network failure"); expect(getRefineErrorMessage(error)).toBe(REFINE_ERROR_MESSAGES.NETWORK); }); it("returns network message for non-Error values", () => { expect(getRefineErrorMessage("string error")).toBe(REFINE_ERROR_MESSAGES.NETWORK); expect(getRefineErrorMessage(null)).toBe(REFINE_ERROR_MESSAGES.NETWORK); expect(getRefineErrorMessage(undefined)).toBe(REFINE_ERROR_MESSAGES.NETWORK); }); }); describe("REFINE_ERROR_MESSAGES", () => { it("has the expected error messages", () => { expect(REFINE_ERROR_MESSAGES.RATE_LIMIT).toBe("Too many refinement requests. Please wait an hour."); expect(REFINE_ERROR_MESSAGES.INVALID_TYPE).toBe("Invalid refinement option selected."); expect(REFINE_ERROR_MESSAGES.NETWORK).toBe("Failed to refine text. Please try again."); }); }); // --- Summarize Title Tests --- describe("summarizeTitle", () => { beforeEach(() => { vi.resetAllMocks(); }); it("returns title on successful response", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: true, status: 200, headers: new Headers({ "content-type": "application/json" }), text: vi.fn().mockResolvedValue(JSON.stringify({ title: "Generated Title" })), }); global.fetch = mockFetch; const result = await summarizeTitle("a".repeat(200)); expect(result).toBe("Generated Title"); expect(mockFetch).toHaveBeenCalledWith( "/api/ai/summarize-title", expect.objectContaining({ method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ description: "a".repeat(200), provider: undefined, modelId: undefined }), }) ); }); it("sends provider and modelId when provided", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: true, status: 200, headers: new Headers({ "content-type": "application/json" }), text: vi.fn().mockResolvedValue(JSON.stringify({ title: "Generated Title" })), }); global.fetch = mockFetch; await summarizeTitle("a".repeat(200), "anthropic", "claude-sonnet-4-5"); expect(mockFetch).toHaveBeenCalledWith( "/api/ai/summarize-title", expect.objectContaining({ body: JSON.stringify({ description: "a".repeat(200), provider: "anthropic", modelId: "claude-sonnet-4-5" }), }) ); }); it("throws descriptive error on 400 response", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: false, status: 400, headers: new Headers({ "content-type": "application/json" }), text: vi.fn().mockResolvedValue(JSON.stringify({ error: "Description too short" })), }); global.fetch = mockFetch; await expect(summarizeTitle("short")).rejects.toThrow("Invalid request: Description too short"); }); it("throws descriptive error on 429 response", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: false, status: 429, headers: new Headers({ "content-type": "application/json" }), text: vi.fn().mockResolvedValue(JSON.stringify({ error: "Rate limit exceeded" })), }); global.fetch = mockFetch; await expect(summarizeTitle("a".repeat(200))).rejects.toThrow("Rate limit exceeded: Rate limit exceeded"); }); it("throws descriptive error on 503 response", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: false, status: 503, headers: new Headers({ "content-type": "application/json" }), text: vi.fn().mockResolvedValue(JSON.stringify({ error: "AI service unavailable" })), }); global.fetch = mockFetch; await expect(summarizeTitle("a".repeat(200))).rejects.toThrow("AI service temporarily unavailable: AI service unavailable"); }); it("throws generic error on other failure responses", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: false, status: 500, headers: new Headers({ "content-type": "application/json" }), text: vi.fn().mockResolvedValue(JSON.stringify({ error: "Internal server error" })), }); global.fetch = mockFetch; await expect(summarizeTitle("a".repeat(200))).rejects.toThrow("Internal server error"); }); it("throws error for non-JSON responses", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: true, status: 200, headers: new Headers({ "content-type": "text/html" }), text: vi.fn().mockResolvedValue("Not JSON"), }); global.fetch = mockFetch; await expect(summarizeTitle("a".repeat(200))).rejects.toThrow("API returned non-JSON response"); }); it("throws error when response has no title", async () => { const mockFetch = vi.fn().mockResolvedValue({ ok: true, status: 200, headers: new Headers({ "content-type": "application/json" }), text: vi.fn().mockResolvedValue(JSON.stringify({})), }); global.fetch = mockFetch; await expect(summarizeTitle("a".repeat(200))).rejects.toThrow("API returned empty title"); }); }); // ── Project Management API Tests ─────────────────────────────────────────── const FAKE_PROJECT: ProjectInfo = { id: "proj_abc123", name: "Test Project", path: "/path/to/project", status: "active", isolationMode: "in-process", createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z", lastActivityAt: "2026-01-01T00:00:00.000Z", }; const FAKE_PROJECT_HEALTH: ProjectHealth = { projectId: "proj_abc123", status: "active", activeTaskCount: 5, inFlightAgentCount: 2, lastActivityAt: "2026-01-01T00:00:00.000Z", totalTasksCompleted: 100, totalTasksFailed: 5, averageTaskDurationMs: 600000, updatedAt: "2026-01-01T00:00:00.000Z", }; const FAKE_ACTIVITY_ENTRY: ActivityFeedEntry = { id: "act_123", timestamp: "2026-01-01T00:00:00.000Z", type: "task:created", projectId: "proj_abc123", projectName: "Test Project", taskId: "KB-001", taskTitle: "Test Task", details: "Task created", }; describe("fetchProjects", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns list of projects", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, [FAKE_PROJECT])); const result = await fetchProjects(); expect(result).toHaveLength(1); expect(result[0].id).toBe("proj_abc123"); expect(result[0].name).toBe("Test Project"); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/projects", expect.objectContaining({ headers: { "Content-Type": "application/json" } }) ); }); it("throws on error response", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Database error" })); await expect(fetchProjects()).rejects.toThrow("Database error"); }); }); describe("registerProject", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("registers a new project", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_PROJECT)); const result = await registerProject({ name: "Test Project", path: "/path/to/project", isolationMode: "in-process", }); expect(result.id).toBe("proj_abc123"); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/projects", expect.objectContaining({ method: "POST", body: JSON.stringify({ name: "Test Project", path: "/path/to/project", isolationMode: "in-process", }), }) ); }); it("uses default isolation mode when not specified", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_PROJECT)); await registerProject({ name: "Test Project", path: "/path/to/project", }); expect(globalThis.fetch).toHaveBeenCalledWith( expect.any(String), expect.objectContaining({ body: JSON.stringify({ name: "Test Project", path: "/path/to/project", isolationMode: undefined, }), }) ); }); }); describe("unregisterProject", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("unregisters a project", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, {})); await unregisterProject("proj_abc123"); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/projects/proj_abc123", expect.objectContaining({ method: "DELETE" }) ); }); it("url-encodes project id", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, {})); await unregisterProject("proj/with+special"); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/projects/proj%2Fwith%2Bspecial", expect.any(Object) ); }); }); describe("fetchProjectHealth", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns health metrics for a project", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, FAKE_PROJECT_HEALTH)); const result = await fetchProjectHealth("proj_abc123"); expect(result.projectId).toBe("proj_abc123"); expect(result.activeTaskCount).toBe(5); expect(result.inFlightAgentCount).toBe(2); expect(result.totalTasksCompleted).toBe(100); }); }); describe("fetchActivityFeed", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns activity feed without options", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, [FAKE_ACTIVITY_ENTRY])); const result = await fetchActivityFeed(); expect(result).toHaveLength(1); expect(result[0].type).toBe("task:created"); expect(result[0].projectName).toBe("Test Project"); }); it("passes query parameters", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, [])); await fetchActivityFeed({ limit: 50, since: "2026-01-01T00:00:00.000Z", projectId: "proj_abc123", type: "task:created", }); const call = (globalThis.fetch as ReturnType).mock.calls[0]; expect(call[0]).toContain("limit=50"); expect(call[0]).toContain("since=2026-01-01T00%3A00%3A00.000Z"); expect(call[0]).toContain("projectId=proj_abc123"); expect(call[0]).toContain("type=task%3Acreated"); }); }); describe("pauseProject", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("pauses a project", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { ...FAKE_PROJECT, status: "paused" })); const result = await pauseProject("proj_abc123"); expect(result.status).toBe("paused"); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/projects/proj_abc123/pause", expect.objectContaining({ method: "POST" }) ); }); }); describe("resumeProject", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("resumes a paused project", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { ...FAKE_PROJECT, status: "active" })); const result = await resumeProject("proj_abc123"); expect(result.status).toBe("active"); expect(globalThis.fetch).toHaveBeenCalledWith( "/api/projects/proj_abc123/resume", expect.objectContaining({ method: "POST" }) ); }); }); describe("fetchFirstRunStatus", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns first run status with existing projects", async () => { const mockStatus: FirstRunStatus = { hasProjects: true, singleProjectPath: "/existing/project" }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, mockStatus)); const result = await fetchFirstRunStatus(); expect(result.hasProjects).toBe(true); expect(result.singleProjectPath).toBe("/existing/project"); }); it("returns first run status with no projects", async () => { const mockStatus: FirstRunStatus = { hasProjects: false, singleProjectPath: null }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, mockStatus)); const result = await fetchFirstRunStatus(); expect(result.hasProjects).toBe(false); expect(result.singleProjectPath).toBeNull(); }); }); describe("fetchGlobalConcurrency", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns global concurrency state", async () => { const mockState: GlobalConcurrencyState = { globalMaxConcurrent: 4, currentlyActive: 2, queuedCount: 1, projectsActive: { "proj_abc123": 2 }, }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, mockState)); const result = await fetchGlobalConcurrency(); expect(result.globalMaxConcurrent).toBe(4); expect(result.currentlyActive).toBe(2); expect(result.projectsActive["proj_abc123"]).toBe(2); }); }); describe("fetchProjectTasks", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("fetches tasks for a specific project", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, [{ id: "KB-001", description: "Test", column: "todo", dependencies: [], steps: [], currentStep: 0, createdAt: "2026-01-01T00:00:00.000Z", updatedAt: "2026-01-01T00:00:00.000Z" }])); const result = await fetchProjectTasks("proj_abc123"); expect(result).toHaveLength(1); expect(globalThis.fetch).toHaveBeenCalledWith( expect.stringContaining("/tasks?"), expect.any(Object) ); const call = (globalThis.fetch as ReturnType).mock.calls[0]; expect(call[0]).toContain("projectId=proj_abc123"); }); it("passes pagination parameters", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, [])); await fetchProjectTasks("proj_abc123", 50, 100); const call = (globalThis.fetch as ReturnType).mock.calls[0]; expect(call[0]).toContain("limit=50"); expect(call[0]).toContain("offset=100"); }); }); describe("fetchProjectConfig", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns project config", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, { maxConcurrent: 4, rootDir: "/path/to/project" })); const result = await fetchProjectConfig("proj_abc123"); expect(result.maxConcurrent).toBe(4); expect(result.rootDir).toBe("/path/to/project"); }); }); describe("fetchExecutorStats", () => { const originalFetch = globalThis.fetch; afterEach(() => { globalThis.fetch = originalFetch; }); it("returns executor stats with running state", async () => { const response = { globalPause: false, enginePaused: false, maxConcurrent: 4, lastActivityAt: "2026-04-01T12:00:00.000Z", }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await fetchExecutorStats(); expect(result.globalPause).toBe(false); expect(result.enginePaused).toBe(false); expect(result.maxConcurrent).toBe(4); expect(result.lastActivityAt).toBe("2026-04-01T12:00:00.000Z"); expect(globalThis.fetch).toHaveBeenCalledWith("/api/executor/stats", { headers: { "Content-Type": "application/json" }, }); }); it("returns executor stats with paused state", async () => { const response = { globalPause: false, enginePaused: true, maxConcurrent: 2, lastActivityAt: "2026-04-01T11:00:00.000Z", }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await fetchExecutorStats(); expect(result.globalPause).toBe(false); expect(result.enginePaused).toBe(true); expect(result.maxConcurrent).toBe(2); }); it("returns executor stats with global pause", async () => { const response = { globalPause: true, enginePaused: false, maxConcurrent: 2, }; globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(true, response)); const result = await fetchExecutorStats(); expect(result.globalPause).toBe(true); expect(result.enginePaused).toBe(false); }); it("throws on API error", async () => { globalThis.fetch = vi.fn().mockReturnValue(mockFetchResponse(false, { error: "Internal server error" })); await expect(fetchExecutorStats()).rejects.toThrow("Internal server error"); }); }); describe("ExecutorStats type", () => { it("has correct shape for executor stats object", () => { const stats: ExecutorStats = { runningTaskCount: 3, blockedTaskCount: 2, stuckTaskCount: 1, queuedTaskCount: 10, inReviewCount: 4, executorState: "running", maxConcurrent: 4, lastActivityAt: "2026-04-01T12:00:00.000Z", }; expect(stats.runningTaskCount).toBe(3); expect(stats.blockedTaskCount).toBe(2); expect(stats.stuckTaskCount).toBe(1); expect(stats.queuedTaskCount).toBe(10); expect(stats.inReviewCount).toBe(4); expect(stats.executorState).toBe("running"); expect(stats.maxConcurrent).toBe(4); expect(stats.lastActivityAt).toBe("2026-04-01T12:00:00.000Z"); }); it("accepts all valid executor states", () => { const idleStats: ExecutorStats = { runningTaskCount: 0, blockedTaskCount: 0, stuckTaskCount: 0, queuedTaskCount: 5, inReviewCount: 0, executorState: "idle", maxConcurrent: 2, }; const runningStats: ExecutorStats = { runningTaskCount: 2, blockedTaskCount: 1, stuckTaskCount: 0, queuedTaskCount: 3, inReviewCount: 1, executorState: "running", maxConcurrent: 2, }; const pausedStats: ExecutorStats = { runningTaskCount: 1, blockedTaskCount: 0, stuckTaskCount: 0, queuedTaskCount: 8, inReviewCount: 2, executorState: "paused", maxConcurrent: 2, }; expect(idleStats.executorState).toBe("idle"); expect(runningStats.executorState).toBe("running"); expect(pausedStats.executorState).toBe("paused"); }); it("allows optional lastActivityAt", () => { const stats: ExecutorStats = { runningTaskCount: 0, blockedTaskCount: 0, stuckTaskCount: 0, queuedTaskCount: 0, inReviewCount: 0, executorState: "idle", maxConcurrent: 2, }; expect(stats.lastActivityAt).toBeUndefined(); }); }); describe("ExecutorState type", () => { it("has valid executor state values", () => { const states: ExecutorState[] = ["idle", "running", "paused"]; expect(states).toContain("idle"); expect(states).toContain("running"); expect(states).toContain("paused"); }); });