Function pickInstallTarget

apps/desktop/src/main/cli-install.ts:162–212

()

}

async function pickInstallTarget(): Promise<InstallTarget> {
  const onPath = pathDirsOnPath()
  const home = os.homedir()
  const candidates = candidateDirs()

  // Pass 1: a candidate that is BOTH on PATH AND user-writable.
  // This is the no-sudo, no-shell-edit happy path.
  for (const dir of candidates) {
    if (!onPath.has(dir)) continue
    if (await isWritableDir(dir)) {
      return {
        linkPath: path.join(dir, CLI_NAME),
        onPath: true,
        requiresSudo: false,
        pathHint: null
      }
    }
  }

  // Pass 2: a user-writable candidate even if it's not on PATH yet.
  // We can usually create ~/.local/bin or ~/bin on the fly. Tell the
  // user how to put it on PATH after install.
  const userLocal = path.join(home, '.local', 'bin')
  const userHomeBin = path.join(home, 'bin')
  for (const dir of [userLocal, userHomeBin]) {
    try {
      await fsp.mkdir(dir, { recursive: true })
    } catch {
      continue
    }
    if (await isWritableDir(dir)) {
      return {
        linkPath: path.join(dir, CLI_NAME),
        onPath: false,
        requiresSudo: false,
        pathHint: pathExportSnippet(dir)
      }
    }
  }

  // Pass 3: fall back to /usr/local/bin with a sudo prompt. This is
  // the historical install location and still on PATH almost
  // everywhere, so the binary will be callable immediately.
  const target = path.join(SUDO_FALLBACK_DIR, CLI_NAME)
  return {
    linkPath: target,
    onPath: onPath.has(SUDO_FALLBACK_DIR),
    requiresSudo: true,
    pathHint: onPath.has(SUDO_FALLBACK_DIR) ? null : pathExportSnippet(SUDO_FALLBACK_DIR)
  }
}

function pathExportSnippet(dir: string): string {
  return `echo 'export PATH="${dir}:$PATH"' >> ~/.zshrc && source ~/.zshrc`