Function cleanWith

packages/computer/src/git/worktree.ts:232–280

(opts: CleanWithDeps)

 * untracked path is a candidate.
 */
export async function cleanWith(opts: CleanWithDeps): Promise<string[]> {
  const dir = opts.dir ?? "/";
  let matrix: StatusMatrixRow[];
  try {
    matrix = await opts.git.statusMatrix({ fs: opts.fs, dir, cache: opts.cache });
  } catch (cause) {
    if (isNotARepositoryCause(cause)) throw new NotARepositoryError(dir, { cause });
    throw new GitError("ECLEANFAIL", `git clean failed: ${errorMessage(cause)}`, { cause });
  }

  // Tracked directories: every ancestor of a path present in HEAD
  // or the index. The repo root (".") is tracked whenever any
  // file is. Untracked files whose parent is tracked are loose
  // files; those nested under an untracked directory are grouped
  // under that directory.
  const trackedDirs = new Set<string>(["."]);
  const untrackedFiles: string[] = [];
  for (const [path, head, _workdir, stage] of matrix) {
    if (head === 1 || stage !== 0) {
      for (const ancestor of ancestorDirs(path)) trackedDirs.add(ancestor);
    } else {
      untrackedFiles.push(path);
    }
  }

  const looseFiles: string[] = [];
  const untrackedTopDirs = new Set<string>();
  for (const path of untrackedFiles) {
    const parent = dirname(path);
    if (trackedDirs.has(parent)) {
      looseFiles.push(path);
    } else {
      untrackedTopDirs.add(topmostUntrackedDir(path, trackedDirs));
    }
  }

  const removed = [...looseFiles];
  if (opts.directories) removed.push(...untrackedTopDirs);
  removed.sort();

  if (opts.dryRun) return removed;

  const fs = opts.fs as RemoveFsClient;
  for (const rel of removed) {
    const abs = dir === "/" ? `/${rel}` : `${dir}/${rel}`;
    await removePath(fs, abs);
  }
  return removed;
}

async function removePath(fs: RemoveFsClient, abs: string): Promise<void> {
  if (typeof fs.promises.rm === "function") {