Function checkChrome

packages/cli/src/browser/preflight.ts:156–206

(browserPath?: string)

}

async function checkChrome(browserPath?: string): Promise<EnvironmentCheckOutcome> {
  if (browserPath) {
    if (existsSync(browserPath)) {
      return chromeSharedLibOutcome(browserPath, {
        name: "Chrome",
        ok: true,
        level: "ok",
        detail: `explicit: ${browserPath}`,
        path: browserPath,
      });
    }
    return {
      name: "Chrome",
      ok: false,
      level: "error",
      title: "Chrome not found",
      detail: `Chrome binary not found at "${browserPath}".`,
      hint: "Run: npx hyperframes browser ensure",
    };
  }

  // A corrupt/partial browser cache (stub files where a version dir is
  // expected, missing executable, malformed metadata) makes findBrowser throw.
  // That is the exact condition this check exists to report, so treat any
  // failure as "Chrome not found" rather than letting it crash the caller
  // (notably `doctor`, which is documented to exit 0 even when checks fail).
  let info: Awaited<ReturnType<typeof findBrowser>>;
  try {
    info = await findBrowser();
  } catch {
    info = undefined;
  }
  if (info) {
    return chromeSharedLibOutcome(info.executablePath, {
      name: "Chrome",
      ok: true,
      level: "ok",
      detail: `${info.source}: ${info.executablePath}`,
      path: info.executablePath,
    });
  }

  return {
    name: "Chrome",
    ok: false,
    level: "error",
    title: "Chrome not found",
    detail: "Chrome Headless Shell is required for local rendering.",
    hint: "Run: npx hyperframes browser ensure",
  };
}

function checkDisk(projectDir = "."): EnvironmentCheckOutcome {
  const freeMb = getFreeDiskMb(projectDir);