Function runClean

packages/computer/src/git/cli.ts:2069–2110

(
  client: GitClient,
  args: string[],
  input: GitCliInput,
)

// ---------------------------------------------------------------

async function runClean(
  client: GitClient,
  args: string[],
  input: GitCliInput,
): Promise<GitCliResult> {
  // `git clean -f [-d] [-n|--dry-run]`. Real git refuses to act
  // without `-f`; mirror that so a bare `git clean` is a no-op
  // error rather than a destructive surprise. The flags are all
  // boolean, so expand any combined short cluster (`-fd`, `-fdn`)
  // into separate tokens before parsing.
  const expanded = expandShortBoolCluster(args, new Set(["f", "d", "n"]));
  const parsed = parseFlags(expanded, {
    force: { kind: "bool", alias: ["f"] },
    d: { kind: "bool" },
    "dry-run": { kind: "bool", alias: ["n"] },
  });
  if ("error" in parsed) {
    return { stdout: "", stderr: `git clean: ${parsed.error}\n`, exitCode: 129 };
  }
  const dryRun = parsed.flags["dry-run"] === true;
  if (parsed.flags.force !== true && !dryRun) {
    return {
      stdout: "",
      stderr: "git clean: refusing to clean without -f (or use -n to preview)\n",
      exitCode: 129,
    };
  }
  const dir = resolveDir(undefined, input.cwd);
  try {
    const removed = await client.clean({
      dir,
      directories: parsed.flags.d === true,
      dryRun,
    });
    if (removed.length === 0) return { stdout: "", stderr: "", exitCode: 0 };
    const verb = dryRun ? "Would remove" : "Removing";
    const lines = removed.map((p) => `${verb} ${p}`);
    return { stdout: `${lines.join("\n")}\n`, stderr: "", exitCode: 0 };
  } catch (cause) {
    return mapGitError("clean", cause);
  }
}

// ---------------------------------------------------------------
// shared error mapping