Function chromeLaunchRemediation

packages/cli/src/browser/linuxDeps.ts:328–350

(errorMessage: string)

 * isn't a shared-library/launch failure this module can help with.
 */
export function chromeLaunchRemediation(errorMessage: string): string | undefined {
  const isLaunchFailure =
    /Failed to launch the browser process/i.test(errorMessage) ||
    isSharedLibLaunchError(errorMessage);
  if (!isLaunchFailure) return undefined;
  if (process.platform !== "linux") return undefined;
  // On Linux ARM64 the render browser is system Chromium (see
  // ensureLinuxArmBrowser in manager.ts), so a launch failure there is almost
  // always a missing/mis-pathed chromium — NOT the headless-shell .so set. The
  // shared-lib install line would be wrong advice, so defer to that path's own
  // guidance instead of emitting it here.
  if (process.arch === "arm64") return undefined;

  const distro = detectLinuxDistro();
  const lines: string[] = [];
  lines.push(
    `Chrome could not launch on ${distroLabel(distro)} — this is almost always missing system libraries (e.g. libnss3).`,
  );
  lines.push("Install the Chrome headless dependencies:");
  lines.push(`  ${chromeDepsInstallCommand(distro.family)}`);
  lines.push("Then verify with: npx hyperframes doctor");
  return lines.join("\n");
}