Function run

e2e/desktop/sidecar-crash-screen.test.ts:39–125

(runDir: string)

);

const run = async (runDir: string) => {
  // Throwaway HOME = fresh ~/.executor data dir, fresh electron-store
  // settings, no collision with a real desktop install on this machine.
  const home = mkdtempSync(join(tmpdir(), "executor-desktop-e2e-"));
  const videoTmp = join(runDir, ".video-tmp");
  let stepIndex = 0;

  const app = await _electron.launch({
    executablePath: electronBinary,
    args: [appDir],
    cwd: appDir,
    env: { ...process.env, HOME: home },
    recordVideo: { dir: videoTmp, size: { width: 1280, height: 800 } },
    timeout: 120_000,
  });

  try {
    // firstWindow resolves only after the sidecar boots (the window is
    // created with the server's URL) — this wait IS the boot assertion.
    const page = await app.firstWindow({ timeout: 120_000 });
    const step = async (label: string, body: () => Promise<void>) => {
      await body();
      stepIndex += 1;
      const slug = label.toLowerCase().replace(/[^a-z0-9]+/g, "-");
      await page.screenshot({
        path: join(runDir, `${String(stepIndex).padStart(2, "0")}-${slug}.png`),
      });
    };

    await step("app boots into the web console", async () => {
      await page.getByText("Settings").first().waitFor({ timeout: 120_000 });
    });

    let sidecarPid = 0;
    await step("the local server is killed (SIGKILL)", async () => {
      const manifestPath = join(home, ".executor/server-control/server.json");
      const manifest = JSON.parse(readFileSync(manifestPath, "utf8")) as { pid: number };
      sidecarPid = manifest.pid;
      expect(sidecarPid, "sidecar pid recorded in the server manifest").toBeGreaterThan(0);
      process.kill(sidecarPid, "SIGKILL");
      await page.getByText("stopped unexpectedly").waitFor({ timeout: 30_000 });
    });

    await step("crash screen offers restart, update, and diagnostics", async () => {
      await page.locator("#restart").waitFor({ timeout: 5_000 });
      await page.locator("#update").waitFor({ timeout: 5_000 });
      await page.locator("#export").waitFor({ timeout: 5_000 });
    });

    await step("restart server heals the app", async () => {
      await page.locator("#restart").click();
      await page.getByText("Settings").first().waitFor({ timeout: 120_000 });
    });

    const healedManifest = JSON.parse(
      readFileSync(join(home, ".executor/server-control/server.json"), "utf8"),
    ) as { pid: number };
    expect(healedManifest.pid, "restarted sidecar is a new process").not.toBe(sidecarPid);