Function canOpenBrowser

src/artifacts/open-browser.ts:20–30

(env: NodeJS.ProcessEnv = process.env, platform: string = process.platform)

 * headless cases so a server run or CI job doesn't try to spawn a GUI.
 */
export function canOpenBrowser(env: NodeJS.ProcessEnv = process.env, platform: string = process.platform): boolean {
  // Explicit opt-out (any of the common spellings) always wins.
  if (env.QODEX_NO_BROWSER || env.QODEX_NO_OPEN || env.NO_BROWSER) return false;
  // CI systems have no human at a screen.
  if (env.CI) return false;
  // On Linux/BSD a GUI needs an X11 or Wayland display; without one, opening fails.
  if (platform === 'linux' || platform === 'freebsd' || platform === 'openbsd') {
    if (!env.DISPLAY && !env.WAYLAND_DISPLAY) return false;
  }
  return true;
}

/** The platform-appropriate opener command + args for a URL. */
function openerFor(url: string, platform: string): { cmd: string; args: string[] } {