import { describe, expect, it } from "vitest"; import { SUPPORTED_NODE_VERSION_PROSE } from "../domain/runtimeVersion.js"; import { FakeSetupHost, options } from "./Setup.fixture.js"; import { runSetup } from "./Setup.js"; describe("setup workflow", () => { it("rejects Node 25 before applying setup actions", async () => { const host = new FakeSetupHost(); host.nodeVersion = "25.1.0"; host.clients = [{ name: "codex", configPath: "/codex.toml" }]; const result = await runSetup( { ...options(true, true), installSkill: true, clientIds: ["codex"] }, host, ); expect(result.status).toBe("needs_human"); expect(result.appliedActions).toEqual([]); expect(host.hopperInstalls).toBe(0); expect(host.configurations).toBe(0); expect(host.skillInstalls).toBe(0); }); it("records every detected client outcome after an earlier failure", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.clients = [ { name: "first", configPath: "/first.json" }, { name: "second", configPath: "/second.json" }, { name: "third", configPath: "/third.json" }, ]; host.clientResults.set("first", { status: "failed", reason: "write" }); host.clientResults.set("second", { status: "configured" }); host.clientResults.set("third", { status: "failed", reason: "readback" }); const result = await runSetup( { ...options(true), clientIds: ["first", "second", "third"] }, host, ); expect(host.configurations).toBe(3); expect(result.clients).toEqual({ first: { status: "failed", reason: "write" }, second: { status: "configured" }, third: { status: "failed", reason: "readback" }, }); expect(result.appliedActions).toEqual(["configured_second"]); expect(result.status).toBe("needs_human"); expect(result.remediation).toContain("could not be updated"); }); it("explains skill installation recovery", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.skill = "failed"; const result = await runSetup( { ...options(true), installSkill: true, clientIds: [] }, host, ); expect(result.status).toBe("needs_human"); expect(result.remediation).toBe( "REA analysis skill could not be installed or verified. Check permissions for `~/.agents/skills`, then rerun setup.", ); }); it("delegates remaining unhealthy checks to doctor remediation", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.doctorHealthy = false; const result = await runSetup( { ...options(true), readinessScope: { providers: ["hopper"] } }, host, ); expect(result.remediation).toBe( "Run rea doctor and apply each reported remediation.", ); }); it("uses requested readiness scope without hiding environment drift", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.doctorHealthy = false; host.scopedDoctorHealthy = true; host.clients = [{ name: "codex", configPath: "/codex.toml" }]; const readinessScope = { clients: ["codex"], providers: [] as string[], skill: true, }; const result = await runSetup( { ...options(true), proposeHopper: false, installSkill: false, readinessScope, }, host, ); expect(result).toMatchObject({ status: "ready", doctor: { healthy: true, environment_healthy: false }, }); expect(host.doctorScopes).toEqual(expect.arrayContaining([readinessScope])); }); }); describe("setup scoped readiness", () => { it("limits Hopper host checks to workflows that request Hopper", async () => { const platformHost = new FakeSetupHost("win32"); platformHost.hopper = "/Applications/Hopper"; platformHost.skill = "unchanged"; platformHost.clients = [{ name: "codex", configPath: "/codex.toml" }]; const windowsAgent = await runSetup( { ...options(true), clientIds: ["codex"] }, platformHost, ); expect(windowsAgent.status).toBe("ready"); expect(platformHost.configurations).toBe(1); const nodeHost = new FakeSetupHost(); nodeHost.nodeVersion = "20.0.0"; expect((await runSetup(options(true), nodeHost)).remediation).toBe( `Install ${SUPPORTED_NODE_VERSION_PROSE} and rerun setup.`, ); const macHost = new FakeSetupHost(); macHost.version = "11.7"; expect((await runSetup(options(true), macHost)).status).toBe("ready"); expect((await runSetup(options(true, true), macHost)).remediation).toBe( "Upgrade to macOS 12 or newer.", ); }); it("keeps an unchanged selected client in final readiness checks", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.skill = "unchanged"; host.clients = [{ name: "codex", configPath: "/codex.toml" }]; host.productRegistrations = [ { client: "codex", config_path: "/codex.toml", command: ["rea", "mcp"], state: "aligned", remediation: null, }, ]; host.clientInspections.set("codex", { status: "already_current" }); host.scopedDoctorHealthy = true; const result = await runSetup(options(true), host); expect(result.status).toBe("ready"); expect(result.plannedActions).toEqual([]); expect(host.doctorScopes.at(-1)).toEqual({ clients: ["codex"], providers: [], skill: true, }); }); it("does not advertise an unhealthy Hopper in the selected readiness summary", async () => { const host = new FakeSetupHost("win32"); host.hopper = "C:\\Hopper\\Hopper.exe"; host.unsupportedHopperVersion = true; host.clients = [{ name: "codex", configPath: "C:\\codex.toml" }]; host.scopedDoctorHealthy = true; const result = await runSetup( { ...options(true), clientIds: ["codex"], installSkill: false, }, host, ); expect(result.status).toBe("ready"); expect(result.doctor.availableProviders).toEqual([]); }); it("rejects unsupported hosts before mutation", async () => { const host = new FakeSetupHost("linux"); host.distribution = { id: "debian", versionId: "13", packageFamily: "deb", supported: false, }; const result = await runSetup(options(true, true), host); expect(result.status).toBe("needs_human"); expect(host.hopperInstalls).toBe(0); expect(result.remediation).toBe( "Automated Hopper setup supports Ubuntu 24.04+, Fedora 41+, 64-bit Arch Linux, and CachyOS; configure an existing supported provider instead.", ); }); it("configures BYO Ghidra on Linux outside Hopper's installer matrix", async () => { const host = new FakeSetupHost("linux"); host.distribution = { id: "debian", versionId: "13", packageFamily: "deb", supported: false, }; host.ghidra = "/opt/ghidra_12.1.4_PUBLIC"; host.javaHome = "/usr/lib/jvm/jdk-21"; host.doctorHealthy = true; host.skill = "unchanged"; host.clients = [{ name: "codex", configPath: "/codex.toml" }]; const result = await runSetup( { ...options(true), clientIds: ["codex"] }, host, ); expect(result.status).toBe("ready"); expect(host.hopperInstalls).toBe(0); expect(host.configuredProviderEnvironments).toContainEqual({ GHIDRA_INSTALL_DIR: "/opt/ghidra_12.1.4_PUBLIC", JAVA_HOME: "/usr/lib/jvm/jdk-21", }); }); });