Function planBinaryRemoval

src/upgrade/remove-binary.ts:134–208

(p: RemoveBinaryProbes)

}

export function planBinaryRemoval(p: RemoveBinaryProbes): BinaryRemovalPlan {
  const P = pathFor(p.platform);
  const plan: BinaryRemovalPlan = {
    paths: [],
    npmGlobal: false,
    npmRoot: null,
    sourceRoot: null,
    summary: [],
  };

  const method = detectInstallMethod({
    filename: p.filename,
    platform: p.platform,
    cwd: p.cwd,
    exists: p.exists,
  });
  if (method.kind === 'source') {
    plan.sourceRoot = method.root;
  }

  // --- Bundle install(s) ----------------------------------------------------
  const installDirs: string[] = [];
  for (const dir of installDirCandidates(p)) {
    // A dir counts as a bundle install only when it carries install artifacts.
    const artifacts = ['versions', 'current']
      .map((a) => P.join(dir, a))
      .filter((a) => p.exists(a) || p.readlink(a) !== null); // `current` is a symlink on unix
    if (artifacts.length === 0) continue;
    installDirs.push(dir);
    if (P.resolve(dir) === P.resolve(stateDir(p))) {
      // Shared with machine-level state: remove artifacts only.
      plan.paths.push(...artifacts);
      plan.summary.push(`bundle install at ${dir} (versions/ and current — state files kept)`);
    } else {
      plan.paths.push(dir);
      plan.summary.push(`bundle install at ${dir}`);
    }
  }

  // --- Bin-dir shim (unix installer's symlink) --------------------------------
  const binDir = p.env.CODEGRAPH_BIN_DIR
    ?? (p.platform === 'win32' ? null : P.join(p.homedir, '.local', 'bin'));
  if (binDir) {
    const shim = P.join(binDir, 'codegraph');
    const target = p.readlink(shim);
    // Only when the link demonstrably points into a bundle install dir —
    // resolved against the link's own directory, since install.sh links an
    // absolute target but a hand-made relative link must still verify.
    if (target !== null) {
      const resolved = P.resolve(binDir, target);
      const ours = installDirs.some((d) => resolved.startsWith(P.resolve(d) + P.sep))
        || resolved.includes(`${P.sep}.codegraph${P.sep}`);
      if (ours) {
        plan.paths.push(shim);
        plan.summary.push(`launcher link at ${shim}`);
      }
    }
  }