Function buildSpawnEnv

src/workspaces/spawn-env.ts:67–104

(
  parent: NodeJS.ProcessEnv,
  extras: { [key: string]: string } = {},
  cwd?: string,
)

] as const;

export function buildSpawnEnv(
  parent: NodeJS.ProcessEnv,
  extras: { [key: string]: string } = {},
  cwd?: string,
): { [key: string]: string } {
  const out: { [key: string]: string } = {};
  for (const [k, v] of Object.entries(parent)) {
    if (typeof v !== 'string') continue;
    if (shouldStrip(k)) continue;
    out[k] = v;
  }
  // Announce ourselves honestly so well-behaved TUI apps can detect us.
  out['TERM'] = 'xterm-256color';
  out['COLORTERM'] = 'truecolor';
  out['TERM_PROGRAM'] = 'openalice-workspaces';
  out['TERM_PROGRAM_VERSION'] = SELF_VERSION;
  if (!out['LANG']) out['LANG'] = 'en_US.UTF-8';
  if (!out['LC_CTYPE'] && !out['LC_ALL']) out['LC_CTYPE'] = 'en_US.UTF-8';
  // Override PWD to match the spawn cwd. PTY spawn does chdir() to `cwd`,
  // but env PWD is just the parent's PWD passed verbatim. Claude Code CLI
  // selects its `~/.claude/projects/<projectKey>/` from $PWD (not from
  // process.cwd()), so without this override claude writes the workspace's
  // session jsonl into the backend's projectKey — mixing it with whatever
  // happens to be running there. On resume, `--continue` looks in the
  // workspace's own projectKey, finds it empty, and exits 1 → PTY respawn
  // loop into the circuit breaker. Verified end-to-end against the
  // `path.trace` log: pre-fix `envPWD` was the OpenAlice repo root while
  // `spawnCwd` was the workspace dir.
  if (cwd) out['PWD'] = cwd;
  // Caller-supplied per-session env (e.g. AQ_WS_ID, AQ_LAUNCHER_REPO_ROOT)
  // wins over the inherited env so .mcp.json `${VAR}` expansion at Claude
  // startup resolves to the right values.
  for (const [k, v] of Object.entries(extras)) {
    out[k] = v;
  }
  out['PATH'] = buildCliPath(out);
  return out;
}

/**
 * Build a PATH suitable for launching user-installed agent CLIs from a GUI app.