import { describe, expect, it } from "vitest"; import { runSetup, type ClientConfigurationResult, type SetupClient, type SetupHost, type SetupOptions, } from "../src/application/Setup.js"; import type { DoctorCheck } from "../src/application/Doctor.js"; import type { LinuxDistribution } from "../src/application/LinuxHopper.js"; class FakeSetupHost implements SetupHost { readonly platform: NodeJS.Platform; nodeVersion = "25.1.0"; version: string | undefined = "14.5"; distribution: LinuxDistribution | undefined; hopper: string | undefined; hopperInstallSucceeds = true; skill: "installed" | "unchanged" | "failed" = "installed"; clients: readonly SetupClient[] = []; clientResults = new Map(); hopperInstalls = 0; configurations = 0; doctorHealthy: boolean | undefined; constructor(platform: NodeJS.Platform = "darwin") { this.platform = platform; } macosVersion = (): Promise => Promise.resolve(this.version); linuxDistribution = (): Promise => Promise.resolve(this.distribution); hopperPath = (): Promise => Promise.resolve(this.hopper); installHopper = (): Promise => { this.hopperInstalls += 1; if (this.hopperInstallSucceeds) this.hopper = "/manual/Hopper"; return Promise.resolve(this.hopper); }; detectedClients = (): Promise => Promise.resolve(this.clients); configureClient = ( client: SetupClient, ): Promise => { this.configurations += 1; return Promise.resolve( this.clientResults.get(client.name) ?? { status: "configured" }, ); }; installSkill = (): Promise<"installed" | "unchanged" | "failed"> => Promise.resolve(this.skill); doctor = (): Promise<{ healthy: boolean; hopperPath?: string; checks: readonly DoctorCheck[]; }> => Promise.resolve({ healthy: this.doctorHealthy ?? this.hopper !== undefined, ...(this.hopper === undefined ? {} : { hopperPath: this.hopper }), checks: [], }); } const options = (approved: boolean, installHopper = false): SetupOptions => ({ approved, installHopper, structured: true, }); describe("setup workflow", () => { it("returns a complete plan without mutation", async () => { const host = new FakeSetupHost(); host.clients = [{ name: "cursor", configPath: "/cursor.json" }]; const result = await runSetup(options(false), host); expect(result.status).toBe("needs_confirmation"); expect(result.plannedActions.map(({ kind }) => kind)).toEqual([ "install_hopper", "configure_client", "install_skill", ]); expect(host.hopperInstalls).toBe(0); expect(host.configurations).toBe(0); expect(result.remediation).toBe( "Review the setup plan, then rerun interactively or with --yes.", ); }); it("applies an accepted interactive plan including Hopper", async () => { const host = new FakeSetupHost(); const result = await runSetup( { ...options(false), structured: false }, host, () => Promise.resolve(true), ); expect(result.status).toBe("needs_human"); expect(result.appliedActions).toEqual([ "installed_hopper", "installed_skill", ]); expect(host.hopperInstalls).toBe(1); expect(result.remediation).toBe( "Open Hopper, complete its one-time activation, then rerun rea doctor --json.", ); }); it("declines an interactive plan without mutation", async () => { const host = new FakeSetupHost(); const result = await runSetup( { ...options(false), structured: false }, host, () => Promise.resolve(false), ); expect(result.status).toBe("planned"); expect(result.appliedActions).toEqual([]); expect(host.hopperInstalls).toBe(0); }); it("requires the Hopper flag for unattended setup", async () => { const host = new FakeSetupHost(); const result = await runSetup(options(true), host); expect(result.status).toBe("needs_human"); expect(host.hopperInstalls).toBe(0); expect(result.appliedActions).toEqual(["installed_skill"]); expect(result.remediation).toContain("--install-hopper"); expect(result.remediation).toBe( "Hopper is optional for non-Hopper providers. Rerun with --yes --install-hopper for deep native analysis.", ); }); it("installs Hopper when unattended authorization is explicit", async () => { const host = new FakeSetupHost(); const result = await runSetup(options(true, true), host); expect(result.appliedActions).toEqual([ "installed_hopper", "installed_skill", ]); expect(host.hopperInstalls).toBe(1); }); it("reuses existing Hopper and configures detected clients", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.clients = [ { name: "claude", configPath: "/claude.json" }, { name: "cursor", configPath: "/cursor.json" }, ]; const result = await runSetup(options(true), host); expect(result.status).toBe("ready"); expect(result.appliedActions).toEqual([ "configured_claude", "configured_cursor", "installed_skill", ]); expect(host.hopperInstalls).toBe(0); }); it("reports a failed Hopper installation without configuring clients", async () => { const host = new FakeSetupHost(); host.hopperInstallSucceeds = false; host.clients = [{ name: "cursor", configPath: "/cursor.json" }]; const result = await runSetup(options(true, true), host); expect(result.status).toBe("needs_human"); expect(result.remediation).toBe( "Hopper installation failed; install Hopper manually or rerun setup after resolving the reported system error.", ); expect(host.configurations).toBe(0); }); it.each([ [ "backup", "Agent configuration could not be backed up, so no change was made. Check file permissions, then rerun setup.", ], [ "write", "Agent configuration could not be updated. Check file permissions, then rerun setup.", ], [ "readback", "Agent configuration could not be verified after writing. Repair the configuration file or restore its `.rea.backup`, then rerun setup.", ], ] as const)("explains %s configuration recovery", async (reason, message) => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.clients = [{ name: "internal_client_key", configPath: "/agent.json" }]; host.clientResults.set("internal_client_key", { status: "failed", reason }); const result = await runSetup(options(true), host); expect(result.status).toBe("needs_human"); expect(result.remediation).toBe(message); expect(result.remediation).not.toContain("internal_client_key"); }); it("explains skill installation recovery", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.skill = "failed"; const result = await runSetup(options(true), 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), host); expect(result.remediation).toBe( "Run rea doctor and apply each reported remediation.", ); }); it("explains unsupported Node and macOS recovery", async () => { const platformHost = new FakeSetupHost("win32"); expect((await runSetup(options(true), platformHost)).remediation).toBe( "REA supports Hopper on macOS and selected 64-bit Linux distributions.", ); const nodeHost = new FakeSetupHost(); nodeHost.nodeVersion = "20.0.0"; expect((await runSetup(options(true), nodeHost)).remediation).toBe( "Install Node.js 22.19+ or 24.11+ and rerun setup.", ); const macHost = new FakeSetupHost(); macHost.version = "11.7"; expect((await runSetup(options(true), macHost)).remediation).toBe( "Upgrade to macOS 12 or newer.", ); }); 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( "REA supports Hopper on Ubuntu 24.04+, Fedora 41+, and 64-bit Arch Linux.", ); }); });