import { access, chmod, mkdtemp, readFile, rm, stat } from "node:fs/promises"; import { tmpdir } from "node:os"; import { join } from "node:path"; import { fileURLToPath } from "node:url"; import { afterEach, beforeAll, describe, expect, it, vi } from "vitest"; import { ghidraHeadlessArguments, GhidraHeadlessLauncher, } from "../src/ghidra/GhidraLauncher.js"; const fixturePath = fileURLToPath( new URL("./fixtures/captureGhidraLaunch.mjs", import.meta.url), ); const roots: string[] = []; beforeAll(() => chmod(fixturePath, 0o755)); afterEach(async () => { vi.unstubAllEnvs(); await Promise.all( roots.splice(0).map((path) => rm(path, { recursive: true, force: true })), ); }); describe("Ghidra headless launcher", () => { it("builds a bounded read-only import in deterministic order", () => { expect( ghidraHeadlessArguments({ projectRoot: "/tmp/project", targetPath: "/tmp/target", bridgeScriptPath: "/package/bridge/ReaGhidraBridge.java", descriptorPath: "/tmp/session.json", ghidraLogPath: "/tmp/ghidra.log", scriptLogPath: "/tmp/script.log", }), ).toEqual([ "/tmp/project", "rea-project", "-import", "/tmp/target", "-readOnly", "-deleteProject", "-analysisTimeoutPerFile", "300", "-max-cpu", "2", "-log", "/tmp/ghidra.log", "-scriptlog", "/tmp/script.log", "-scriptPath", "/package/bridge", "-postScript", "ReaGhidraBridge.java", "/tmp/session.json", ]); }); it("keeps authority in a private descriptor and isolates Ghidra state", async () => { vi.stubEnv("GHIDRA_JAVA_OPTIONS", "-javaagent:/unapproved/agent.jar"); vi.stubEnv("JAVA_TOOL_OPTIONS", "-Duser.home=/unapproved/home"); vi.stubEnv("JDK_JAVA_OPTIONS", "-XX:MaxRAMPercentage=99"); vi.stubEnv("_JAVA_OPTIONS", "-Xmx99G"); const runtimeRoot = await mkdtemp(join(tmpdir(), "rea-launcher-test-")); roots.push(runtimeRoot); const token = "secret-token-that-must-not-leak"; const launcher = new GhidraHeadlessLauncher({ analyzeHeadlessPath: fixturePath, javaHome: "/opt/jdk-21", bridgeScriptPath: "/package/bridge/ReaGhidraBridge.java", }); const launched = await launcher.launch({ runtimeRoot, socketPath: join(runtimeRoot, "bridge.sock"), token, runId: "d6fcbb66-e829-4ff6-a535-0035aec63139", targetPath: "/tmp/fixture", providerVersion: "12.1.2", profileDigest: "a".repeat(64), }); expect(launched.ok).toBe(true); if (!launched.ok) return; const capturePath = join(runtimeRoot, "launch-capture.json"); await waitFor(capturePath); const capture = JSON.parse(await readFile(capturePath, "utf8")); const encodedArguments = JSON.stringify(capture.arguments); const encodedEnvironment = JSON.stringify(capture.environment); expect(encodedArguments).not.toContain(token); expect(encodedEnvironment).not.toContain(token); expect(capture).toMatchObject({ descriptor_mode: 0o600, descriptor_has_token: true, environment: { HOME: join(runtimeRoot, "home"), TMPDIR: join(runtimeRoot, "tmp"), XDG_CACHE_HOME: join(runtimeRoot, "cache"), XDG_CONFIG_HOME: join(runtimeRoot, "config"), XDG_DATA_HOME: join(runtimeRoot, "data"), GHIDRA_HEADLESS_MAXMEM: "2G", GHIDRA_JAVA_OPTIONS: "", JAVA_TOOL_OPTIONS: "", JDK_JAVA_OPTIONS: "", _JAVA_OPTIONS: "", JAVA_HOME: "/opt/jdk-21", REA_PROCESS_RUN_ID: "d6fcbb66-e829-4ff6-a535-0035aec63139", }, }); expect(capture.environment.PATH).toMatch(/^\/opt\/jdk-21\/bin:/u); expect(capture.environment.GHIDRA_HEADLESS_JAVA_OPTIONS).toContain( `-Duser.home=${join(runtimeRoot, "home")}`, ); expect((await stat(join(runtimeRoot, "ownership.json"))).mode & 0o777).toBe( 0o600, ); const cleaned = await launched.value.cleanup?.(); expect(cleaned).toMatchObject({ cleaned: true }); await expect(access(join(runtimeRoot, "project"))).resolves.toBeUndefined(); }); }); const waitFor = async (path: string): Promise => { for (let attempt = 0; attempt < 100; attempt += 1) { try { await access(path); return; } catch { await new Promise((resolve) => setTimeout(resolve, 10)); } } throw new Error(`Timed out waiting for ${path}`); };