Function notFoundMessage

packages/cli/src/commands/desktop-dispatch.ts:153–168

(reason: DetectReason = 'no-bundle')

}

export function notFoundMessage(reason: DetectReason = 'no-bundle'): string {
  switch (reason) {
    case 'no-bundle':
      return `Desktop app not found at ${APPLICATIONS_BUNDLE_PATH}. Install via DMG, or omit --mode for browser mode.`;
    case 'darwin-only':
      return 'Desktop app is macOS-only on this release. Use --mode=browser, or omit --mode for the server fallback.';
    case 'headless':
      return 'Desktop launch is gated in headless contexts (CI, SSH, non-TTY stdout). Set OK_FORCE_DESKTOP=1 to override, or use --mode=browser.';
    case 'force-browser':
      return 'OK_FORCE_BROWSER=1 is set — desktop dispatch is disabled. Unset it to use --mode=app.';
    case 'stat-error':
      return `Failed to inspect desktop bundle at ${APPLICATIONS_BUNDLE_PATH} (filesystem error). Check permissions or use --mode=browser.`;
    case 'available':
      return `Desktop app appears available at ${APPLICATIONS_BUNDLE_PATH} but launch dispatch did not fire (caller bug).`;
  }
}