import { describe, expect, it } from "vitest"; import { AnalysisError } from "../domain/analysisErrorBase.js"; import { projectAnalysisError } from "../domain/analysisErrorProjection.js"; import { ConfigurationError } from "../domain/configurationErrors.js"; import { SUPPORTED_NODE_VERSION_PROSE } from "../domain/runtimeVersion.js"; import { FakeSetupHost, options } from "./Setup.fixture.js"; import { runSetup } from "./Setup.js"; import type { SetupProgressEvent } from "./SetupTypes.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("reports a failed config rollback with its destination and recovery backup", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.clients = [{ name: "codex", configPath: "/fixture/codex.json" }]; host.clientResults.set("codex", { status: "failed", reason: "rollback", backupPath: "/fixture/codex.json.rea.backup", failure: { kind: "restore", path: "/fixture/codex.json", detail: "permission denied", }, }); const result = await runSetup( { ...options(true), clientIds: ["codex"] }, host, ); expect(result.clients.codex).toEqual({ status: "failed", reason: "rollback", backupPath: "/fixture/codex.json.rea.backup", failure: { kind: "restore", path: "/fixture/codex.json", detail: "permission denied", }, }); expect(result.remediation).toContain("permission denied"); expect(result.remediation).toContain("/fixture/codex.json.rea.backup"); }); it("explains skill installation recovery", async () => { const host = new FakeSetupHost(); host.hopper = "/Applications/Hopper"; host.skill = "failed"; const progress: SetupProgressEvent[] = []; const result = await runSetup( { ...options(true), installSkill: true, clientIds: [], onProgress: (event) => { if (event.actionId === "install_skill") progress.push(event); }, }, host, ); expect(result.status).toBe("needs_human"); expect(result.code).toBe("skill_install_failed"); expect(result.remediation).toContain("REA skill write failed at"); expect(result.remediation).toContain("injected skill write failure"); expect(result.remediation).toContain("Check permissions and rerun setup."); expect(progress.at(-1)).toMatchObject({ state: "failed", detail: expect.stringContaining("injected skill write failure"), }); }); 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 failure cleanup projection", () => { it("projects a configuration failure together with failed host cleanup", async () => { const configPath = "/fixture/home/vscode/settings.json"; const primary = new ConfigurationError("Client config could not be read", { settings: [ { setting: configPath, constraint: "The selected config could not be read.", }, ], cleanup: { reason: "The admitted config handle remains open.", resources: [configPath], }, }); class SetupHostWithCleanupFailure extends FakeSetupHost { close = async (): Promise => "Setup could not release its client configuration resources."; } const host = new SetupHostWithCleanupFailure(); host.clients = [{ name: "codex", configPath }]; host.inspectClientConfiguration = async () => { throw primary; }; const failure = await runSetup( { ...options(true), clientIds: ["codex"] }, host, ).then( () => undefined, (cause: unknown) => cause, ); expect(failure).toBeInstanceOf(AnalysisError); if (!(failure instanceof AnalysisError)) throw new Error("Expected setup to preserve a typed analysis failure"); const projected = projectAnalysisError(failure); expect(projected).toMatchObject({ code: "cleanup_incomplete", details: { cleanup: "incomplete", resources: [configPath], diagnostics: { primary_error: { code: "cleanup_incomplete", details: { resources: [configPath] }, }, cleanup_error: { code: "cleanup_incomplete", details: { resources: [configPath] }, }, }, }, }); expect(projected.details).toMatchObject({ diagnostics: { primary_error: { message: expect.stringContaining("selected config") }, cleanup_error: { details: { diagnostics: { reason: "Setup could not release its client configuration resources.", }, }, }, }, }); }); }); 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, skillClients: ["codex"], }); }); 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+, Nobara 44+, 64-bit Arch Linux, CachyOS, and Omarchy; 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", }); }); });