Function buildCliPath

src/workspaces/spawn-env.ts:114–140

(env: NodeJS.ProcessEnv = process.env)

 * for `/agents` availability probes and for the actual PTY spawn env.
 */
export function buildCliPath(env: NodeJS.ProcessEnv = process.env): string {
  const path = env['PATH'] ?? env['Path'] ?? '';
  if (process.platform === 'win32') return path;

  const home = env['HOME'] ?? homedir();
  const pathEntries = path.split(delimiter);
  const candidates = [
    ...(env['OPENALICE_EXTRA_AGENT_PATH'] ?? '').split(delimiter),
    ...pathEntries,
    env['PNPM_HOME'],
    ...POSIX_USER_BIN_DIRS.map((p) => join(home, p)),
    ...POSIX_SYSTEM_BIN_DIRS,
  ];

  const seen = new Set<string>();
  const out: string[] = [];
  for (const raw of candidates) {
    const dir = raw?.trim();
    if (!dir || seen.has(dir)) continue;
    seen.add(dir);
    // Keep existing PATH entries even if the directory is currently missing:
    // they came from the host and may be intentional. For inferred fallbacks,
    // include only real directories to avoid bloating every spawned shell.
    if (pathEntries.includes(dir) || existsSync(dir)) out.push(dir);
  }
  return out.join(delimiter);
}

function shouldStrip(name: string): boolean {
  if (STRIP_EXACT.has(name)) return true;