Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
// @vitest-environment jsdom
import React from "react";
import { SWRConfig } from "swr";
import { cleanup, fireEvent, render, screen, waitFor, within } from "@testing-library/react";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import type { SetupResponse } from "@/lib/api/setup";
import { doneFixture, setupFixture } from "./setup-fixture";
const mocks = vi.hoisted(() => ({
getRepoSetup: vi.fn(),
setSetupHook: vi.fn(),
updateOnboardingState: vi.fn(),
toastError: vi.fn(),
toastSuccess: vi.fn(),
}));
vi.mock("@/lib/api/setup", () => ({
getRepoSetup: mocks.getRepoSetup,
setSetupHook: mocks.setSetupHook,
updateOnboardingState: mocks.updateOnboardingState,
connectSetupAgent: vi.fn(),
disconnectSetupAgent: vi.fn(),
addSetupCoverage: vi.fn(),
getOnboardingState: vi.fn(),
}));
vi.mock("sonner", () => ({ toast: { error: mocks.toastError, success: mocks.toastSuccess } }));
// The sheet pulls in the providers and bulk generate flows; Setup only opens it.
vi.mock("@/components/model-upgrade/model-upgrade", () => ({
useModelUpgrade: () => ({ openSheet: vi.fn(), sheet: null }),
}));
import { SetupPage } from "./setup-page";
import { hostedCardVisible } from "./hosted-setup-card";
function renderPage(setup: SetupResponse) {
mocks.getRepoSetup.mockResolvedValue(setup);
return render(
<SWRConfig value={{ provider: () => new Map() }}>
<SetupPage repoId="r1" repoName="orbit-api" />
</SWRConfig>,
);
}
beforeEach(() => {
window.localStorage.clear();
});
afterEach(() => {
cleanup();
vi.clearAllMocks();
});
describe("SetupPage", () => {
it("shows the essentials count and the tour link", async () => {
renderPage(setupFixture());
expect(await screen.findByText(/2 of 3 essentials done/)).toBeTruthy();
expect(screen.getByRole("link", { name: "Take the tour" }).getAttribute("href")).toBe(
"/repos/r1/overview?tour=1",
);
});
it("links each row to the settings page that holds its control, once", async () => {
renderPage(setupFixture());
expect(await screen.findByText(/2 of 3 essentials done/)).toBeTruthy();
// The switches and buttons live on the settings pages, not here too.
expect(screen.queryByRole("switch")).toBeNull();
expect(screen.queryByRole("button", { name: "Connect Cursor" })).toBeNull();
const hrefs = screen
.getAllByRole("link", { name: /^Change in / })
.map((a) => a.getAttribute("href"));
expect(hrefs).toContain("/repos/r1/settings/sync");
expect(hrefs).toContain("/repos/r1/settings/agents");
});
it("gives a Needs attention row the copy action, a status for screen readers and no preview box", async () => {
const writeText = vi.fn().mockResolvedValue(undefined);
Object.assign(navigator, { clipboard: { writeText } });
const s = setupFixture();
renderPage({ ...s, index: { ...s.index, parse_error_count: 1, parse_error_files: ["gen.py"] } });
expect(await screen.findByText("Needs attention")).toBeTruthy();
expect(screen.queryByText("Prompt preview")).toBeNull();
const row = document.querySelector("[data-row='index-parse']") as HTMLElement;
expect(row.className).not.toMatch(/warning-muted/);
expect(row.querySelector("h3 .sr-only")?.textContent).toContain("1");
const copy = screen.getByRole("button", { name: "Copy prompt: Files that could not be parsed" });
fireEvent.click(copy);
await waitFor(() => expect(writeText).toHaveBeenCalled());
const prompt = writeText.mock.calls[0]![0] as string;
expect(prompt).toContain("repowise reports for orbit-api: Files that could not be parsed.");
expect(prompt).toContain("- `gen.py`");
expect(prompt).not.toMatch(/to confirm|until I confirm/);
expect(await screen.findByText("Copied", { selector: "[aria-live='polite']" })).toBeTruthy();
});
it("clamps long doctor detail to one line behind a Show details toggle", async () => {
// jsdom does not lay out text, so report the clamped line as overflowing.
const height = vi.spyOn(HTMLElement.prototype, "scrollHeight", "get").mockReturnValue(40);
renderPage(
setupFixture({
checks: [
{ id: "vector-store", name: "Vector store", level: "fail", detail: "missing (run repowise reindex)", fix: "repowise reindex" },
],
}),
);
await screen.findByText("Vector store");
const row = within(document.querySelector("[data-row='check-vector-store']") as HTMLElement);
const toggle = row.getByRole("button", { name: "Show details" });
expect(toggle.getAttribute("aria-expanded")).toBe("false");
// The "(run X)" hint repeats the command chip, so it is gone from the detail.
expect(row.getByText("missing")).toBeTruthy();
fireEvent.click(toggle);
expect(row.getByRole("button", { name: "Hide details" }).getAttribute("aria-expanded")).toBe("true");
height.mockRestore();
});
});
describe("unreadable sections", () => {
it("says doctor couldn't run instead of showing an empty Needs attention", async () => {
renderPage(setupFixture({ checks_available: false, checks: [] }));
expect(await screen.findByText("Needs attention")).toBeTruthy();
expect(
screen.getByText("Couldn't read this here. Run repowise doctor in a terminal to check."),
).toBeTruthy();
});
it("shows the unreadable line for coverage in place of its empty state", async () => {
renderPage(setupFixture({ coverage_available: false }));
expect(
await screen.findByText("Couldn't read this here. Run repowise coverage status in a terminal to check."),
).toBeTruthy();
expect(screen.queryByRole("button", { name: "Use this report" })).toBeNull();
});
});
describe("hosted card", () => {
it("appears once the essentials are done, and × hides it on this machine", async () => {
mocks.updateOnboardingState.mockResolvedValue({ ...doneFixture().onboarding, hosted_card_hidden: true });
renderPage(doneFixture());
expect(await screen.findByText("You're set up")).toBeTruthy();
expect(screen.getByText("All of this, run for you and your team")).toBeTruthy();
expect(screen.getByRole("link", { name: "Start free" }).getAttribute("href")).toContain(
"src=local_web_setup_card",
);
fireEvent.click(screen.getByRole("button", { name: "Hide on this machine" }));
expect(screen.queryByText("All of this, run for you and your team")).toBeNull();
expect(mocks.updateOnboardingState).toHaveBeenCalledWith({ hosted_card_hidden: true });
});
it("is not shown before the essentials are done", async () => {
renderPage(setupFixture());
await screen.findByText(/2 of 3 essentials done/);
expect(screen.queryByText("All of this, run for you and your team")).toBeNull();
});
it("stays hidden with tips off, when signed in, or when hidden before", () => {
const on = doneFixture().onboarding;
expect(hostedCardVisible(on, false)).toBe(true);
expect(hostedCardVisible({ ...on, hints_enabled: false }, false)).toBe(false);
expect(hostedCardVisible({ ...on, signed_in: true }, false)).toBe(false);
expect(hostedCardVisible({ ...on, hosted_card_hidden: true }, false)).toBe(false);
expect(hostedCardVisible(on, true)).toBe(false);
});
});