@gamecrate/cli 1.3.0 → 1.4.0

package/dist/gamecrate.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { existsSync as existsSync11 } from "node:fs";
-import { chown, cp, mkdir as mkdir6, readdir as readdir10, readFile as readFile12, rm as rm4, rmdir, stat as stat6, writeFile as writeFile7 } from "node:fs/promises";
+import { existsSync as existsSync12 } from "node:fs";
+import { chown, cp, mkdir as mkdir6, readdir as readdir11, readFile as readFile12, rm as rm5, rmdir, stat as stat6, writeFile as writeFile7 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
-import { basename as basename11, dirname as dirname9, join as join22 } from "node:path";
+import { basename as basename11, dirname as dirname10, join as join22 } from "node:path";
 import { setTimeout as sleep7 } from "node:timers/promises";
 
 // src/cli/args.ts
@@ -150,7 +150,7 @@ var SUBCOMMANDS = [
     summary: "tiered wipe of a profile",
     usage: "<game> [profile]",
     positionals: ["game", "profile"],
-    flags: ["--staging", "--logs", "--all", "--yes", "--instance", "--worktree", "--no-worktree"]
+    flags: ["--staging", "--logs", "--all", "--downloads", "--yes", "--instance", "--worktree", "--no-worktree"]
   },
   {
     name: "clone",
@@ -291,7 +291,7 @@ function enumOption(flags, summary, values) {
 }
 function buildProgram() {
   const program = new Command;
-  program.name("gamecrate").exitOverride().helpOption(false).allowExcessArguments(true).showSuggestionAfterError(false).configureOutput({ writeOut: () => {}, writeErr: () => {} }).argument("[args...]").option("--mod <id>", "add a mod to the profile set", collect, []).option("--without <id>", "drop a mod from the resolved set", collect, []).option("--only <id>", "restrict the resolved set to these mods", collect, []).option("--worktree <path>", "promote mods from this git worktree, in its own instance ($GAMECRATE_WORKTREE)", collect, []).option("--use <packageId>=<path>", "force one mod to load from this directory, whatever the profile pins", collect, []).option("--no-worktree", "ignore the current worktree and $GAMECRATE_WORKTREE").option("--instance <name>", "run under a named sub-profile with its own saves, logs and container").addOption(enumOption(`--mode <${MODES.join("|")}>`, "how the game is displayed", MODES)).option("--marker <str>", "exit 0 as soon as this string appears in the log").option("--timeout <seconds>", "bound a marker run, or a headless run with no marker", (v) => seconds("--timeout", v)).option("--render-wait <seconds>", "settle time before a screenshot is taken", (v) => seconds("--render-wait", v)).option("--resolution <width>x<height>", "override the game resolution", parseResolution).addOption(enumOption(`--network <${NETWORK_POLICIES.join("|")}>`, "the container's network mode", NETWORK_POLICIES)).option("--log <path>", "route launch stdout and stderr to one file").addOption(enumOption(`--pull <${PULL_POLICIES.join("|")}>`, "when to pull the runtime image", PULL_POLICIES)).option("--build", "build local C# mods before launching").option("--no-build", "never build, even when an assembly is stale").option("--no-stale-check", "do not warn when a mod's sources are newer than its assemblies").option("--replace", "stop whatever is holding this profile and instance, then launch").option("--no-replace", "refuse when this profile and instance are already running").option("--detach", "start the run in the background and return the prompt").option("--no-detach", "stay in the foreground, whatever the profile or project config asks for").addOption(new Option("--supervised <instanceDir>").hideHelp()).addOption(enumOption(`--sort <${SORTS.join("|")}>`, "load order: the profile order, or a topological sort", SORTS)).option("--docker-arg <arg>", "one extra argv element for docker run", collect, []).option("--dry-run", "resolve and validate fully, write nothing").option("--print-plan", "print the resolved launch plan instead of launching").option("--json", "machine-readable output").option("--root", "run as root instead of mapping the host uid").option("--staging", "clean: wipe .stage only (the default)").option("--logs", "clean: wipe the captured run logs").option("--all", "clean: wipe the whole profile, saves included (needs --yes)").option("-f, --follow", "keep printing as the run writes").option("-y, --yes", "skip destructive-action confirmation").option("--path <dir>", "mods add: take the mod from this directory").option("--workshop <id>", "mods add: take the mod from this steam workshop item", workshopId).option("--git <url>", "mods add: clone the mod from this repository").option("--branch <name>", "mods add: track this git branch").option("--tag <name>", "mods add: pin this git tag").option("--commit <sha>", "mods add: pin this git commit").option("--subdir <path>", "mods add: the mod folder inside the repository").option("--global", "write to the global config").option("--project", "write to the project config").option("--force", "overwrite an entry that is already there").option("-h, --help", "this help");
+  program.name("gamecrate").exitOverride().helpOption(false).allowExcessArguments(true).showSuggestionAfterError(false).configureOutput({ writeOut: () => {}, writeErr: () => {} }).argument("[args...]").option("--mod <id>", "add a mod to the profile set", collect, []).option("--without <id>", "drop a mod from the resolved set", collect, []).option("--only <id>", "restrict the resolved set to these mods", collect, []).option("--worktree <path>", "promote mods from this git worktree, in its own instance ($GAMECRATE_WORKTREE)", collect, []).option("--use <packageId>=<path>", "force one mod to load from this directory, whatever the profile pins", collect, []).option("--no-worktree", "ignore the current worktree and $GAMECRATE_WORKTREE").option("--instance <name>", "run under a named sub-profile with its own saves, logs and container").addOption(enumOption(`--mode <${MODES.join("|")}>`, "how the game is displayed", MODES)).option("--marker <str>", "exit 0 as soon as this string appears in the log").option("--timeout <seconds>", "bound a marker run, or a headless run with no marker", (v) => seconds("--timeout", v)).option("--render-wait <seconds>", "settle time before a screenshot is taken", (v) => seconds("--render-wait", v)).option("--resolution <width>x<height>", "override the game resolution", parseResolution).addOption(enumOption(`--network <${NETWORK_POLICIES.join("|")}>`, "the container's network mode", NETWORK_POLICIES)).option("--log <path>", "route launch stdout and stderr to one file").addOption(enumOption(`--pull <${PULL_POLICIES.join("|")}>`, "when to pull the runtime image", PULL_POLICIES)).option("--build", "build local C# mods before launching").option("--no-build", "never build, even when an assembly is stale").option("--no-stale-check", "do not warn when a mod's sources are newer than its assemblies").option("--replace", "stop whatever is holding this profile and instance, then launch").option("--no-replace", "refuse when this profile and instance are already running").option("--detach", "start the run in the background and return the prompt").option("--no-detach", "stay in the foreground, whatever the profile or project config asks for").addOption(new Option("--supervised <instanceDir>").hideHelp()).addOption(enumOption(`--sort <${SORTS.join("|")}>`, "load order: the profile order, or a topological sort", SORTS)).option("--docker-arg <arg>", "one extra argv element for docker run", collect, []).option("--dry-run", "resolve and validate fully, write nothing").option("--print-plan", "print the resolved launch plan instead of launching").option("--json", "machine-readable output").option("--root", "run as root instead of mapping the host uid").option("--staging", "clean: wipe .stage only (the default)").option("--logs", "clean: wipe the captured run logs").option("--all", "clean: wipe the whole profile and the game downloads (needs --yes)").option("--downloads", "clean: wipe this game's workshop downloads, keeping steamcmd").option("-f, --follow", "keep printing as the run writes").option("-y, --yes", "skip destructive-action confirmation").option("--path <dir>", "mods add: take the mod from this directory").option("--workshop <id>", "mods add: take the mod from this steam workshop item", workshopId).option("--git <url>", "mods add: clone the mod from this repository").option("--branch <name>", "mods add: track this git branch").option("--tag <name>", "mods add: pin this git tag").option("--commit <sha>", "mods add: pin this git commit").option("--subdir <path>", "mods add: the mod folder inside the repository").option("--global", "write to the global config").option("--project", "write to the project config").option("--force", "overwrite an entry that is already there").option("-h, --help", "this help");
   return program;
 }
 function checkValueTokens(program, head) {
@@ -336,7 +336,7 @@ function parseArgs(argv, opts = {}) {
       counts.set(long, (counts.get(long) ?? 0) + 1);
       if (long === "--worktree" && value !== undefined)
         worktree.push(value);
-      if (long === "--staging" || long === "--logs" || long === "--all") {
+      if (long === "--staging" || long === "--logs" || long === "--all" || long === "--downloads") {
         cleanTier = long.slice(2);
       }
     });
@@ -796,9 +796,9 @@ function list(args, config, defaults) {
 }
 
 // src/cli/mods.ts
-import { existsSync as existsSync5 } from "node:fs";
-import { mkdir as mkdir2, readFile as readFile7, readdir as readdir5, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname6, join as join12, relative as relative2, resolve as resolve4 } from "node:path";
+import { existsSync as existsSync6 } from "node:fs";
+import { mkdir as mkdir2, readFile as readFile7, readdir as readdir6, writeFile as writeFile3 } from "node:fs/promises";
+import { dirname as dirname7, join as join12, relative as relative2, resolve as resolve4 } from "node:path";
 
 // src/config/load.ts
 import { z as z2 } from "zod";
@@ -3143,8 +3143,9 @@ async function prepareSources(game, profileName, args, dataRoot, allowFetch) {
 
 // src/mods/steamcmd.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { accessSync, constants, mkdirSync as mkdirSync3, statSync as statSync2 } from "node:fs";
-import { delimiter, join as join10 } from "node:path";
+import { accessSync, constants, existsSync as existsSync5, mkdirSync as mkdirSync3, statSync as statSync2 } from "node:fs";
+import { readdir as readdir5, rm as rm2 } from "node:fs/promises";
+import { delimiter, dirname as dirname5, join as join10 } from "node:path";
 import { setTimeout as sleep4 } from "node:timers/promises";
 var STEAMCMD_IMAGE = "steamcmd/steamcmd";
 function steamHome(dataRoot) {
@@ -3153,6 +3154,14 @@ function steamHome(dataRoot) {
 function downloadRoot(dataRoot, game) {
   return join10(steamHome(dataRoot), "steamapps", "workshop", "content", String(game.steamAppId));
 }
+async function removeDownloads(root, steamAppId) {
+  if (!existsSync5(root))
+    return `no workshop downloads at ${root}`;
+  const items = (await readdir5(root).catch(() => [])).length;
+  await rm2(root, { recursive: true, force: true });
+  await rm2(join10(dirname5(dirname5(root)), `appworkshop_${steamAppId}.acf`), { force: true });
+  return `removed ${root} (${items} item(s))`;
+}
 function resolveSteamcmd(config) {
   const home = steamHome(config.dataRoot);
   const configured = config.steamcmd?.path === undefined ? undefined : expandHome(config.steamcmd.path);
@@ -3283,7 +3292,7 @@ ${r.stderr ?? ""}`.replace(ANSI, "");
 
 // src/mods/workshopapi.ts
 import { readFile as readFile6, stat as stat4 } from "node:fs/promises";
-import { basename as basename5, dirname as dirname5, join as join11 } from "node:path";
+import { basename as basename5, dirname as dirname6, join as join11 } from "node:path";
 
 // src/mods/acf.ts
 var MAX_DEPTH = 100;
@@ -3324,50 +3333,66 @@ function quoted(text, start) {
   }
   return null;
 }
-function body(text, start, depth) {
+function root2(text) {
+  const node = {};
+  let i = skip(text, 0);
+  while (i < text.length) {
+    if (text[i] !== '"')
+      return null;
+    const next = readEntry(text, i, 0, node);
+    if (next === null)
+      return null;
+    i = skip(text, next);
+  }
+  return node;
+}
+function block(text, start, depth) {
   if (depth > MAX_DEPTH)
     return null;
   const node = {};
-  let i = start;
-  for (;; ) {
-    i = skip(text, i);
-    if (i >= text.length)
-      return depth === 0 ? { node, next: i } : null;
+  let i = skip(text, start);
+  while (i < text.length) {
     if (text[i] === "}")
-      return depth === 0 ? null : { node, next: i + 1 };
+      return { node, next: i + 1 };
     if (text[i] !== '"')
       return null;
-    const key = quoted(text, i);
-    if (key === null)
-      return null;
-    i = skip(text, key.next);
-    if (i >= text.length)
-      return null;
-    if (text[i] === "{") {
-      const child = body(text, i + 1, depth + 1);
-      if (child === null)
-        return null;
-      node[key.value] = child.node;
-      i = child.next;
-      continue;
-    }
-    if (text[i] !== '"')
+    const next = readEntry(text, i, depth, node);
+    if (next === null)
       return null;
-    const value = quoted(text, i);
-    if (value === null)
+    i = skip(text, next);
+  }
+  return null;
+}
+function readEntry(text, start, depth, node) {
+  const key = quoted(text, start);
+  if (key === null)
+    return null;
+  const i = skip(text, key.next);
+  if (i >= text.length)
+    return null;
+  if (text[i] === "{") {
+    const child = block(text, i + 1, depth + 1);
+    if (child === null)
       return null;
-    node[key.value] = value.value;
-    i = value.next;
+    node[key.value] = child.node;
+    return child.next;
   }
+  if (text[i] !== '"')
+    return null;
+  const value = quoted(text, i);
+  if (value === null)
+    return null;
+  node[key.value] = value.value;
+  return value.next;
 }
 function parseAcf(text) {
-  return body(text, 0, 0)?.node ?? {};
+  return root2(text) ?? {};
 }
-function section(root, name) {
-  const direct = root[name];
+function section(node, name) {
+  const direct = node[name];
   if (typeof direct === "object")
     return direct;
-  for (const child of Object.values(root)) {
+  for (const child of Object.values(node)) {
     if (typeof child === "object" && typeof child[name] === "object")
       return child[name];
   }
@@ -3491,7 +3516,7 @@ function readDetails(payload) {
   return out;
 }
 function acfPath(root) {
-  return join11(dirname5(dirname5(root)), `appworkshop_${basename5(root)}.acf`);
+  return join11(dirname6(dirname6(root)), `appworkshop_${basename5(root)}.acf`);
 }
 async function exists(dir) {
   try {
@@ -3553,8 +3578,8 @@ overwrite them with --force`);
       edits.push({ path: [...target.prefix, old], value: undefined });
     edits.push({ path: [...target.prefix, pin.id], value: pin.entry });
   }
-  if (!existsSync5(target.file)) {
-    await mkdir2(dirname6(target.file), { recursive: true });
+  if (!existsSync6(target.file)) {
+    await mkdir2(dirname7(target.file), { recursive: true });
     await writeFile3(target.file, "");
   }
   await writeConfig(target.file, edits);
@@ -3777,7 +3802,7 @@ async function walk(root, manifestFile, plugin) {
       out.push({ id, dir });
       return;
     }
-    const entries = await readdir5(dir, { withFileTypes: true }).catch(() => []);
+    const entries = await readdir6(dir, { withFileTypes: true }).catch(() => []);
     for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
       if (entry.isDirectory() && !entry.name.startsWith("."))
         await descend(join12(dir, entry.name));
@@ -3872,8 +3897,8 @@ function gameHelp(name, game) {
       notes.push(`alias for ${config.alias}`);
     if (config.extends)
       notes.push(`extends ${config.extends}`);
-    if (config.autoDependencies)
-      notes.push("auto dependencies");
+    if (config.autoDependencies === false)
+      notes.push("no auto dependencies");
     const count = config.mods?.length ?? 0;
     if (!config.alias)
       notes.push(count === 1 ? "1 entry" : `${count} entries`);
@@ -3995,7 +4020,7 @@ function hostUserName(uid) {
 }
 
 // src/docker/preflight.ts
-import { existsSync as existsSync6, readFileSync as readFileSync3 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync3 } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { basename as basename6, join as join13 } from "node:path";
 var CDI_SPEC = "/etc/cdi/nvidia.yaml";
@@ -4097,7 +4122,7 @@ function checkDisplay(plan, problems) {
   });
 }
 function checkCdi(problems) {
-  if (!existsSync6(CDI_SPEC)) {
+  if (!existsSync7(CDI_SPEC)) {
     problems.push({
       where: CDI_SPEC,
       message: "no CDI spec, so --device nvidia.com/gpu=all cannot resolve",
@@ -4129,12 +4154,12 @@ function checkGameDir(plan, problems) {
     problems.push({ where, message: 'gameFiles.source is "mount" but no host path is set' });
     return;
   }
-  if (!existsSync6(files.host)) {
+  if (!existsSync7(files.host)) {
     problems.push({ where, message: `game directory does not exist: ${files.host}` });
     return;
   }
   const executable = join13(files.host, basename6(plan.gameConfig.executable));
-  if (!existsSync6(executable)) {
+  if (!existsSync7(executable)) {
     problems.push({
       where,
       message: `${files.host} does not contain ${basename6(plan.gameConfig.executable)}`,
@@ -4157,7 +4182,7 @@ function checkBindSources(plan, problems) {
   for (const mount of mounts) {
     if (mount.type !== "bind" || !mount.source)
       continue;
-    if (existsSync6(mount.source))
+    if (existsSync7(mount.source))
       continue;
     if (mount.source.startsWith(plan.profileDir))
       continue;
@@ -4331,8 +4356,8 @@ function parseAtoms(stdout) {
 }
 
 // src/launch/generate.ts
-import { mkdir as mkdir3, readdir as readdir6, readFile as readFile8, writeFile as writeFile4 } from "node:fs/promises";
-import { dirname as dirname7, join as join14 } from "node:path";
+import { mkdir as mkdir3, readdir as readdir7, readFile as readFile8, writeFile as writeFile4 } from "node:fs/promises";
+import { dirname as dirname8, join as join14 } from "node:path";
 async function readInstallVersion(game, plugin) {
   const host = game.gameFiles.host;
   if (game.gameFiles.source !== "mount" || host === undefined)
@@ -4354,7 +4379,7 @@ async function readKnownExpansions(game, plugin, warnings) {
   const dataDir = join14(expandHome(host), "Data");
   let entries;
   try {
-    entries = await readdir6(dataDir, { withFileTypes: true });
+    entries = await readdir7(dataDir, { withFileTypes: true });
   } catch {
     warnings.push(`could not read ${dataDir}; falling back to the configured dlc list`);
     return [...game.dlc];
@@ -4382,7 +4407,7 @@ async function readKnownExpansions(game, plugin, warnings) {
 async function generateModsConfig(plan) {
   const game = plan.gameConfig;
   const target = join14(plan.dataDirHost, game.modsConfig.file);
-  await mkdir3(dirname7(target), { recursive: true });
+  await mkdir3(dirname8(target), { recursive: true });
   const installed = await readInstallVersion(game, plan.plugin);
   if (installed === null) {
     plan.warnings.push(`could not read Version.txt for ${plan.game}; ModsConfig version may be rejected`);
@@ -4433,7 +4458,7 @@ function ownedPrefs(plan) {
 }
 async function mergePrefs(plan) {
   const target = join14(plan.dataDirHost, plan.gameConfig.prefs.file);
-  await mkdir3(dirname7(target), { recursive: true });
+  await mkdir3(dirname8(target), { recursive: true });
   let existing = null;
   try {
     existing = await readFile8(target, "utf8");
@@ -4446,8 +4471,8 @@ async function mergePrefs(plan) {
 }
 
 // src/launch/supervisor.ts
-import { existsSync as existsSync7 } from "node:fs";
-import { readFile as readFile9, readlink, rm as rm2, writeFile as writeFile5 } from "node:fs/promises";
+import { existsSync as existsSync8 } from "node:fs";
+import { readFile as readFile9, readlink, rm as rm3, writeFile as writeFile5 } from "node:fs/promises";
 import { basename as basename8, join as join15 } from "node:path";
 import { setTimeout as sleep6 } from "node:timers/promises";
 async function forkSupervisor(plan, argv) {
@@ -4506,7 +4531,7 @@ async function supervisorFailed(dir, code) {
   const record = { at: new Date().toISOString(), code, reason: "failed" };
   const wrote = await writeExit(dir, record).then(() => true, () => false);
   if (wrote)
-    await rm2(join15(dir, ".gamecrate", "lock"), { force: true }).catch(() => {});
+    await rm3(join15(dir, ".gamecrate", "lock"), { force: true }).catch(() => {});
   return code;
 }
 async function writeExit(instanceDir, record) {
@@ -4564,7 +4589,7 @@ async function awaitRunLog(instanceDir, lock, poll = RUN_LOG_POLL_MS, notice = W
     });
     const began = target === undefined ? undefined : runStartedAt(basename8(target));
     const current = began !== undefined && (Number.isNaN(written) || began >= written);
-    if (current && existsSync7(currentLog(instanceDir)))
+    if (current && existsSync8(currentLog(instanceDir)))
       return true;
     if (!isRunning(lock.pid, lock.startedAt))
       return false;
@@ -4584,7 +4609,7 @@ import { basename as basename9, join as join16 } from "node:path";
 
 // src/mods/worktree.ts
 import { spawnSync as spawnSync3 } from "node:child_process";
-import { existsSync as existsSync8, realpathSync as realpathSync2 } from "node:fs";
+import { existsSync as existsSync9, realpathSync as realpathSync2 } from "node:fs";
 import { isAbsolute as isAbsolute2, resolve as resolve5, sep } from "node:path";
 function inspect(dir) {
   const r = spawnSync3("git", ["-C", dir, "rev-parse", "--path-format=absolute", "--show-toplevel", "--git-dir", "--git-common-dir", "--abbrev-ref", "HEAD"], { encoding: "utf8" });
@@ -4607,7 +4632,7 @@ function canonical(p) {
 function resolveWorktree(dir, source, order) {
   const raw = expandHome(dir);
   const abs = isAbsolute2(raw) ? raw : resolve5(process.cwd(), raw);
-  if (!existsSync8(abs)) {
+  if (!existsSync9(abs)) {
     return { where: abs, message: `--worktree path does not exist`, suggestion: "check the path, or drop the flag" };
   }
   const info = inspect(abs);
@@ -4702,10 +4727,10 @@ import { join as join18 } from "node:path";
 
 // src/mods/modindex.ts
 import { createHash as createHash3 } from "node:crypto";
-import { existsSync as existsSync9, readFileSync as readFileSync5, statSync as statSync3 } from "node:fs";
-import { mkdir as mkdir4, readdir as readdir7, readFile as readFile10, writeFile as writeFile6 } from "node:fs/promises";
+import { existsSync as existsSync10, readFileSync as readFileSync5, statSync as statSync3 } from "node:fs";
+import { mkdir as mkdir4, readdir as readdir8, readFile as readFile10, writeFile as writeFile6 } from "node:fs/promises";
 import { homedir as homedir4 } from "node:os";
-import { dirname as dirname8, join as join17, relative as relative3, sep as sep2, resolve as resolvePath } from "node:path";
+import { dirname as dirname9, join as join17, relative as relative3, sep as sep2, resolve as resolvePath } from "node:path";
 import picomatch from "picomatch";
 function cacheDir() {
   return join17(process.env["XDG_CACHE_HOME"] ?? join17(homedir4(), ".cache"), "gamecrate");
@@ -4721,7 +4746,7 @@ function inLinkedWorktree(dir, stopAt) {
   let current = dir;
   for (;; ) {
     const git = join17(current, ".git");
-    if (existsSync9(git)) {
+    if (existsSync10(git)) {
       try {
         if (statSync3(git).isFile())
           return true;
@@ -4732,7 +4757,7 @@ function inLinkedWorktree(dir, stopAt) {
     }
     if (current === stopAt)
       return false;
-    const parent = dirname8(current);
+    const parent = dirname9(current);
     if (parent === current)
       return false;
     current = parent;
@@ -4743,7 +4768,7 @@ async function scanLocalRoot(root, rootIndex, manifestFile, found) {
   const exclude = [...root.exclude ?? [], ...rootIndex === -1 ? [] : ALWAYS_EXCLUDE];
   const walk = async (dir, depth) => {
     const manifest = join17(dir, manifestFile);
-    if (existsSync9(manifest)) {
+    if (existsSync10(manifest)) {
       found.push({
         dir,
         kind: "local",
@@ -4756,7 +4781,7 @@ async function scanLocalRoot(root, rootIndex, manifestFile, found) {
       return;
     let entries;
     try {
-      entries = await readdir7(dir, { withFileTypes: true });
+      entries = await readdir8(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -4769,7 +4794,7 @@ async function scanLocalRoot(root, rootIndex, manifestFile, found) {
       await walk(child, depth + 1);
     }
   };
-  if (!existsSync9(base))
+  if (!existsSync10(base))
     return;
   await walk(base, 0);
 }
@@ -4777,7 +4802,7 @@ async function scanWorkshopRoot(workshopRoot, rootIndex, manifestFile, found) {
   const base = resolvePath(expandHome(workshopRoot));
   let entries;
   try {
-    entries = await readdir7(base, { withFileTypes: true });
+    entries = await readdir8(base, { withFileTypes: true });
   } catch {
     return;
   }
@@ -4785,7 +4810,7 @@ async function scanWorkshopRoot(workshopRoot, rootIndex, manifestFile, found) {
     if (!entry.isDirectory() || !/^\d+$/.test(entry.name))
       continue;
     const dir = join17(base, entry.name);
-    if (!existsSync9(join17(dir, manifestFile)))
+    if (!existsSync10(join17(dir, manifestFile)))
       continue;
     found.push({ dir, kind: "workshop", rootIndex, linkedWorktree: false, workshopId: Number(entry.name) });
   }
@@ -4797,7 +4822,7 @@ async function scanGameData(game, rootIndex, found) {
   const data = join17(resolvePath(expandHome(host)), "Data");
   let entries;
   try {
-    entries = await readdir7(data, { withFileTypes: true });
+    entries = await readdir8(data, { withFileTypes: true });
   } catch {
     return;
   }
@@ -4805,14 +4830,14 @@ async function scanGameData(game, rootIndex, found) {
     if (!entry.isDirectory())
       continue;
     const dir = join17(data, entry.name);
-    if (!existsSync9(join17(dir, game.manifest.file)))
+    if (!existsSync10(join17(dir, game.manifest.file)))
       continue;
     found.push({ dir, kind: "official", rootIndex, linkedWorktree: false });
   }
 }
 var CACHE_VERSION = 4;
 function acfPath2(root, steamAppId) {
-  return join17(dirname8(dirname8(resolvePath(expandHome(root)))), `appworkshop_${steamAppId}.acf`);
+  return join17(dirname9(dirname9(resolvePath(expandHome(root)))), `appworkshop_${steamAppId}.acf`);
 }
 function contentPairs(acf) {
   let text;
@@ -4836,7 +4861,7 @@ function workshopStamp(game, dataRoot) {
       return null;
     pairs.push(...found);
   }
-  const download = createHash3("sha1").update(pairs.sort().join(`
+  const download = createHash3("sha256").update(pairs.toSorted().join(`
 `)).digest("hex");
   if (game.workshopRoot === null)
     return download;
@@ -4950,7 +4975,7 @@ async function applySourceOverrides(index, overrides, config) {
     const wanted = spec.slice(0, eq);
     const dir = resolvePath(expandHome(spec.slice(eq + 1)));
     const file = join17(dir, config.manifest.file);
-    if (!existsSync9(file)) {
+    if (!existsSync10(file)) {
       problems.push({
         where: spec,
         message: `no ${config.manifest.file} under ${dir}`,
@@ -5155,7 +5180,7 @@ function byPath(index, raw, game) {
       return hit;
   }
   const file = join17(dir, game.manifest.file);
-  if (!existsSync9(file))
+  if (!existsSync10(file))
     return null;
   try {
     const manifest = index.plugin.parseManifest(readFileSync5(file, "utf8"));
@@ -5415,7 +5440,7 @@ async function resolvePlan(options) {
       staged.push({ record, explicit: true });
     }
   }
-  if (profile.autoDependencies === true)
+  if (profile.autoDependencies !== false)
     insertDependencies(staged, present, index, game, problems);
   if (unfetched.size > 0) {
     for (const problem of problems) {
@@ -5493,7 +5518,7 @@ async function resolvePlan(options) {
 }
 
 // src/run/registry.ts
-import { readdir as readdir8 } from "node:fs/promises";
+import { readdir as readdir9 } from "node:fs/promises";
 import { join as join19 } from "node:path";
 var FORMAT = '{{.Names}}\t{{.Label "gamecrate.game"}}\t{{.Label "gamecrate.profile"}}\t{{.Label "gamecrate.instance"}}\t{{.Status}}';
 function parseDockerRuns(stdout) {
@@ -5532,7 +5557,7 @@ async function walkLocks(dataRoot) {
   return out;
 }
 async function entries(dir) {
-  const found = await readdir8(dir, { withFileTypes: true }).catch(() => []);
+  const found = await readdir9(dir, { withFileTypes: true }).catch(() => []);
   return found.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
 }
 async function push(out, path) {
@@ -5582,10 +5607,10 @@ async function listRuns(dataRoot, docker = dockerPs) {
 }
 
 // src/launch/stage.ts
-import { lstat, mkdir as mkdir5, readdir as readdir9, realpath as realpath2, rm as rm3, stat as stat5 } from "node:fs/promises";
+import { lstat, mkdir as mkdir5, readdir as readdir10, realpath as realpath2, rm as rm4, stat as stat5 } from "node:fs/promises";
 import { basename as basename10, join as join20 } from "node:path";
 async function stageMods(plan) {
-  await rm3(plan.stageDirHost, { recursive: true, force: true });
+  await rm4(plan.stageDirHost, { recursive: true, force: true });
   await mkdir5(plan.stageDirHost, { recursive: true });
   const mounts = [];
   for (const mod of plan.mods) {
@@ -5646,7 +5671,7 @@ async function detectForeignOwnership(dir, uid, limit = 100) {
     if (!info.isDirectory())
       continue;
     try {
-      for (const entry of await readdir9(current))
+      for (const entry of await readdir10(current))
         queue.push(join20(current, entry));
     } catch {
       continue;
@@ -5656,7 +5681,7 @@ async function detectForeignOwnership(dir, uid, limit = 100) {
 }
 
 // src/mods/workshop.ts
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 import { readFile as readFile11 } from "node:fs/promises";
 import { join as join21, resolve as resolvePath2 } from "node:path";
 var ROUNDS = 5;
@@ -5671,26 +5696,9 @@ async function prepareWorkshop(game, profileName, args, config, allowFetch, plug
   for (let round = 0;round < ROUNDS && frontier.length > 0; round++) {
     for (const id of frontier)
       ids.add(id);
-    if (allowFetch) {
-      try {
-        const drift = await checkDrift(frontier, roots);
-        warnings.push(...drift.warnings);
-        const downloaded = await downloadItems(config, game, config.dataRoot, drift.needed);
-        warnings.push(...downloaded.warnings);
-      } catch (error) {
-        warnings.push(`could not download workshop items: ${error instanceof Error ? error.message : String(error)}`);
-      }
-    }
-    const next = new Set;
-    for (const id of frontier) {
-      const manifest = await manifestOf(roots, id, game, plugin, problems);
-      for (const dep of manifest?.modDependencies ?? []) {
-        const depId = workshopUrlId(dep.steamWorkshopUrl);
-        if (depId !== undefined && !ids.has(depId))
-          next.add(depId);
-      }
-    }
-    frontier = [...next];
+    if (allowFetch)
+      warnings.push(...await fetchRound(config, game, roots, frontier));
+    frontier = await dependenciesOf(frontier, ids, roots, game, plugin, problems);
   }
   if (frontier.length > 0) {
     problems.push({
@@ -5701,11 +5709,32 @@ async function prepareWorkshop(game, profileName, args, config, allowFetch, plug
   }
   return { ids, warnings, problems, unfetched: [...ids].filter((id) => itemDir(roots, id) === undefined) };
 }
+async function fetchRound(config, game, roots, frontier) {
+  try {
+    const drift = await checkDrift(frontier, roots);
+    const downloaded = await downloadItems(config, game, config.dataRoot, drift.needed);
+    return [...drift.warnings, ...downloaded.warnings];
+  } catch (error) {
+    return [`could not download workshop items: ${error instanceof Error ? error.message : String(error)}`];
+  }
+}
+async function dependenciesOf(frontier, seen, roots, game, plugin, problems) {
+  const next = new Set;
+  for (const id of frontier) {
+    const manifest = await manifestOf(roots, id, game, plugin, problems);
+    for (const dep of manifest?.modDependencies ?? []) {
+      const depId = workshopUrlId(dep.steamWorkshopUrl);
+      if (depId !== undefined && !seen.has(depId))
+        next.add(depId);
+    }
+  }
+  return [...next];
+}
 function mountedRoots(dataRoot, game) {
   return [downloadRoot(dataRoot, game), ...game.workshopRoot === null ? [] : [game.workshopRoot]];
 }
 function itemDir(roots, id) {
-  return roots.map((root) => join21(root, id)).find((dir) => existsSync10(dir));
+  return roots.map((root) => join21(root, id)).find((dir) => existsSync11(dir));
 }
 async function manifestOf(roots, id, game, plugin, problems) {
   const dir = itemDir(roots, id);
@@ -5713,7 +5742,7 @@ async function manifestOf(roots, id, game, plugin, problems) {
 }
 async function manifestAt(dir, game, plugin, problems) {
   const file = join21(dir, game.manifest.file);
-  if (!existsSync10(file))
+  if (!existsSync11(file))
     return null;
   try {
     return plugin.parseManifest(await readFile11(file, "utf8"));
@@ -5737,26 +5766,26 @@ async function localSeeds(game, profile, args, sources, plugin, problems) {
 function localDirs(game, profile, args, sources) {
   const out = new Set;
   for (const entry of reachedEntries(game, profile, args)) {
-    if (typeof entry !== "string" && "match" in entry)
-      continue;
-    const object = typeof entry === "string" ? { id: entry } : entry;
-    if (object.path !== undefined) {
-      out.add(resolvePath2(expandHome(object.path)));
-      continue;
-    }
-    if (object.id.includes(":"))
-      continue;
-    const pin = libraryPin(game, object.id);
-    const clone = sources.get(object.id.toLowerCase());
-    if (clone !== undefined) {
-      out.add(pin?.subdir === undefined ? clone : join21(clone, pin.subdir));
-      continue;
-    }
-    if (pin?.path !== undefined)
-      out.add(resolvePath2(expandHome(pin.path)));
+    const dir = localDirOf(entry, game, sources);
+    if (dir !== undefined)
+      out.add(dir);
   }
   return [...out];
 }
+function localDirOf(entry, game, sources) {
+  if (typeof entry !== "string" && "match" in entry)
+    return;
+  const object = typeof entry === "string" ? { id: entry } : entry;
+  if (object.path !== undefined)
+    return resolvePath2(expandHome(object.path));
+  if (object.id.includes(":"))
+    return;
+  const pin = libraryPin(game, object.id);
+  const clone = sources.get(object.id.toLowerCase());
+  if (clone !== undefined)
+    return pin?.subdir === undefined ? clone : join21(clone, pin.subdir);
+  return pin?.path === undefined ? undefined : resolvePath2(expandHome(pin.path));
+}
 function wantedIds(game, profile, args) {
   const out = new Set;
   for (const entry of reachedEntries(game, profile, args)) {
@@ -5788,7 +5817,7 @@ function published2(value) {
 }
 
 // src/index.ts
-var VERSION = "1.3.0";
+var VERSION = "1.4.0";
 async function main(argv) {
   const supervised = supervisedDir(argv);
   try {
@@ -6122,7 +6151,7 @@ async function copyOutLogs(plan) {
   if (spec.mode !== "copy-out")
     return;
   const source = join22(plan.dataDirHost, spec.from);
-  if (!existsSync11(source))
+  if (!existsSync12(source))
     return;
   const target = join22(plan.runDirHost, basename11(spec.from.replace(/\/+$/, "")));
   try {
@@ -6190,7 +6219,7 @@ async function doctor(config, plugins) {
         });
       }
       const root = downloadRoot(config.dataRoot, gameConfig);
-      status(`${game}: workshop downloads ${root}${existsSync11(root) ? "" : " (not created yet)"}`);
+      status(`${game}: workshop downloads ${root}${existsSync12(root) ? "" : " (not created yet)"}`);
     }
     const all = [...problems, ...await preflight(plan), ...steamcmd];
     if (all.length === 0) {
@@ -6217,12 +6246,12 @@ async function logs(args, config, defaults) {
   if (args.follow)
     return await follow(dir, false, `${game} ${profile}`);
   const runs = join22(dir, "logs", "runs");
-  const latest = (await readdir10(runs, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort().at(-1);
+  const latest = (await readdir11(runs, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort().at(-1);
   if (latest === undefined) {
     throw new GamecrateError(`no runs recorded for ${game} ${profile}`, Exit.Usage, runs);
   }
   const runDir = join22(runs, latest);
-  const files = (await readdir10(runDir, { withFileTypes: true })).filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
+  const files = (await readdir11(runDir, { withFileTypes: true })).filter((entry) => entry.isFile()).map((entry) => entry.name).sort();
   if (args.json) {
     process.stdout.write(`${JSON.stringify({ run: latest, dir: runDir, files }, null, 2)}
 `);
@@ -6357,18 +6386,24 @@ async function clean(args, config, defaults) {
   const dir = profileDataDir(config, game, profile);
   const tier = args.cleanTier ?? "staging";
   const saveSuffixes = config.games[game].saveExtensions.map((ext) => `.${ext.replace(/^\./, "")}`.toLowerCase());
+  const downloads = downloadRoot(config.dataRoot, config.games[game]);
+  if (tier === "downloads") {
+    status(await removeDownloads(downloads, config.games[game].steamAppId));
+    return Exit.Ok;
+  }
   if (tier !== "all") {
     const target = join22(instanceDir(args, config, game, profile), tier === "logs" ? "logs" : ".stage");
-    await rm4(target, { recursive: true, force: true });
+    await rm5(target, { recursive: true, force: true });
     status(`removed ${target}`);
     return Exit.Ok;
   }
   const saves = await countSaves(dir, saveSuffixes);
   if (!args.yes) {
-    throw new GamecrateError(`clean --all would delete ${dir}, including ${saves} save file(s)`, Exit.Usage, "add --yes to confirm");
+    throw new GamecrateError(`clean --all would delete ${dir}, including ${saves} save file(s), and ${game}'s workshop downloads`, Exit.Usage, "add --yes to confirm, or --downloads to drop only the downloads");
   }
-  await rm4(dir, { recursive: true, force: true });
+  await rm5(dir, { recursive: true, force: true });
   status(`removed ${dir} (${saves} save file(s))`);
+  status(await removeDownloads(downloads, config.games[game].steamAppId));
   return Exit.Ok;
 }
 async function countSaves(dir, suffixes) {
@@ -6378,7 +6413,7 @@ async function countSaves(dir, suffixes) {
     const current = queue.shift();
     let entries;
     try {
-      entries = await readdir10(current, { withFileTypes: true });
+      entries = await readdir11(current, { withFileTypes: true });
     } catch {
       continue;
     }
@@ -6399,9 +6434,9 @@ async function clone(args, config) {
   }
   const from = join22(profileDataDir(config, game, src), "game");
   const to = join22(profileDataDir(config, game, dst), "game");
-  if (!existsSync11(from))
+  if (!existsSync12(from))
     throw new GamecrateError(`${from} does not exist`, Exit.Usage);
-  if (existsSync11(to) && !args.yes) {
+  if (existsSync12(to) && !args.yes) {
     throw new GamecrateError(`${to} already exists`, Exit.Usage, "add --yes to overwrite");
   }
   await mkdir6(to, { recursive: true });
@@ -6467,7 +6502,7 @@ async function follow(dir, fromStart, what) {
   const held = lock !== undefined && isRunning(lock.pid, lock.startedAt);
   const live = held && await awaitRunLog(dir, lock);
   const file = currentLog(dir);
-  if (!existsSync11(file)) {
+  if (!existsSync12(file)) {
     throw new GamecrateError(`no captured output for ${what}`, Exit.Usage, file);
   }
   return await spawnStatus(tailArgv(file, fromStart, live ? lock.pid : undefined), true);
@@ -6501,8 +6536,8 @@ async function configEdit(args) {
     throw new GamecrateError("config takes one word: edit", Exit.Usage);
   const existing = await findGlobalConfig();
   const path = existing ?? join22(globalConfigDir(), "profiles.yml");
-  await mkdir6(dirname9(path), { recursive: true });
-  if (!existsSync11(path)) {
+  await mkdir6(dirname10(path), { recursive: true });
+  if (!existsSync12(path)) {
     await writeFile7(path, `# gamecrate config. see https://github.com/RimWorks/gamecrate
 ` + `plugins: []
 ` + `games: {}
@@ -6522,7 +6557,7 @@ async function fixPerms(args, config) {
   const identity = resolveIdentity(false);
   const found = [];
   for (const dir of await profileDirs(config, game, args.profile)) {
-    if (!existsSync11(dir))
+    if (!existsSync12(dir))
       continue;
     found.push(...await detectForeignOwnership(dir, identity.uid, 1e4));
   }
@@ -6565,7 +6600,7 @@ async function removeIfEmptyDir(path) {
   const info = await stat6(path).catch(() => null);
   if (info === null || !info.isDirectory())
     return false;
-  const entries = await readdir10(path).catch(() => null);
+  const entries = await readdir11(path).catch(() => null);
   if (entries === null || entries.length > 0)
     return false;
   return rmdir(path).then(() => true, () => false);

package/dist/types/mods/steamcmd.d.ts

@@ -22,6 +22,11 @@ export declare function steamHome(dataRoot: string): string;
  * and a plain Valve tarball writes $HOME/Steam. Pinning makes all three land here.
  */
 export declare function downloadRoot(dataRoot: string, game: GameConfig): string;
+/**
+ * Drops a game's downloaded items and the .acf beside them. Never the steamcmd install above
+ * those: that is 200MB of bootstrap which would re-download for nothing. Returns what it did.
+ */
+export declare function removeDownloads(root: string, steamAppId: number): Promise<string>;
 /**
  * Configured path if set, else PATH, else the docker image. A configured path that is not an
  * executable file is an error, not a fallback. Docker gets `--user`: without it the tree

package/dist/types/types.d.ts

@@ -145,6 +145,7 @@ export interface ProfileConfig {
     extends?: string;
     exclude?: string[];
     includeBase?: boolean;
+    /** Default true. False keeps the mod list literal, dependencies and all. */
     autoDependencies?: boolean;
     settings?: Partial<Settings>;
     instances?: Record<string, InstanceConfig>;
@@ -389,7 +390,7 @@ export interface ParsedArgs {
     build?: BuildPolicy;
     sort?: 'topo' | 'none';
     /** `clean` only: --staging is the default, --all additionally requires --yes. */
-    cleanTier?: 'staging' | 'logs' | 'all';
+    cleanTier?: 'staging' | 'logs' | 'all' | 'downloads';
     dockerArgs: string[];
     gameArgs: string[];
     dryRun: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamecrate/cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Run a modded game in a container, with mods resolved from your local checkouts.",
   "license": "MIT",
   "type": "module",