@edgemodders/edgedeck-mcp 0.27.3 → 0.28.0

package/README.md

@@ -23,19 +23,20 @@ Tools:
 | `edgedeck_list` | Every mod: on or off, version, kinds, status, size; the frameworks line after a game patch |
 | `edgedeck_mod` | One mod in detail: files, versions, Nexus info |
 | `edgedeck_add` | Add a zip, 7z, rar, single mod file or folder to the library |
-| `edgedeck_install_project` | Add or refresh a REDcode or WolvenKit project's packed output |
+| `edgedeck_install_project` | Add or refresh a REDcode or WolvenKit project's packed output; `sameName` (`follow` or `version`) settles a mod of the same name from another folder |
 | `edgedeck_turn` | Turn a mod on or off |
 | `edgedeck_move` | Move a mod up or down; higher wins a conflict |
+| `edgedeck_rename` | A new name for a mod in EDGEdeck, for all its versions; empty puts the first name back |
 | `edgedeck_remove` | Remove a mod from the library |
 | `edgedeck_pending` | What the next deploy would add, replace, put back or remove, and why |
-| `edgedeck_deploy` | Put the active loadout in the game (refuses while the game runs) |
+| `edgedeck_deploy` | Put the active loadout in the game (refuses while the game runs); `mod` deploys that mod's changes only |
 | `edgedeck_undo` | Take everything EDGEdeck deployed out again, putting backups back |
 | `edgedeck_changes` | Deployed files changed or missing in the game folder since |
 | `edgedeck_conflicts` | Files two enabled mods both have, and who wins |
 | `edgedeck_loadout` | Save, switch to (load) or list loadouts |
 | `edgedeck_vortex` | List and import the mods Vortex has for the game (Vortex is not changed) |
 
-Nothing touches the game folder until `edgedeck_deploy` or `edgedeck_undo`; the server tells the assistant to ask the player first.
+Nothing touches the game folder until `edgedeck_deploy` or `edgedeck_undo`; the server tells the assistant to ask the player first. These two and `edgedeck_remove` also carry `_meta: { "anthropic/requiresUserInteraction": true }`, so Claude Code asks you before every call, in every permission mode, auto mode included.
 
 ## The command line
 
@@ -43,7 +44,7 @@ Nothing touches the game folder until `edgedeck_deploy` or `edgedeck_undo`; the
 npx -p @edgemodders/edgedeck-mcp edgedeck list
 ```
 
-or, installed with `npm i -g @edgemodders/edgedeck-mcp`, just `edgedeck list`. Commands: `list`, `mod`, `add`, `install-project`, `on`, `off`, `up`, `down`, `remove`, `pending`, `deploy`, `undo`, `changes`, `conflicts`, `loadout save|load|list`, `vortex list|import`, `mcp`. Options `--library`, `--game`, and `--json` for machine output.
+or, installed with `npm i -g @edgemodders/edgedeck-mcp`, just `edgedeck list`. Commands: `list`, `mod`, `add`, `install-project`, `on`, `off`, `up`, `down`, `rename`, `remove`, `pending`, `deploy`, `undo`, `changes`, `conflicts`, `loadout save|load|list`, `vortex list|import`, `mcp`. Options `--library`, `--game`, and `--json` for machine output.
 
 ## More
 

package/bin/edgedeck.mjs

@@ -5,11 +5,15 @@
 //   edgedeck list [--size]              what is in the library, its size and status (--size: largest first)
 //   edgedeck mod <id>                   one mod in full: files, sizes, source, Nexus data, conflicts
 //   edgedeck add <file|folder> [--name N] [--option FOLDER]
-//   edgedeck install-project <.cpmodproj>  add a REDcode or WolvenKit project's packed output, or refresh it, and turn it on
+//   edgedeck install-project <.cpmodproj> [--follow | --keep-both]
+//                                       add a REDcode or WolvenKit project's packed output, or refresh it, and turn it on;
+//                                       beside a mod of the same name: --follow makes that mod follow this project,
+//                                       --keep-both adds the project as another version of it, on in its place
 //   edgedeck on <id> | off <id>         turn a mod on or off
 //   edgedeck up <id> | down <id>        change the order (first wins conflicts)
+//   edgedeck rename <id> [name...]    a new name in EDGEdeck, for all its versions (no name: the first one back)
 //   edgedeck remove <id>
-//   edgedeck deploy [--keep PATH...] [--restore PATH...]
+//   edgedeck deploy [--keep PATH...] [--restore PATH...] [--mod ID]   --mod: that mod's changes only
 //   edgedeck undo
 //   edgedeck changes                    files changed in the game folder since the deploy
 //   edgedeck pending                    what the next deploy adds, replaces, puts back or removes, and why
@@ -66,13 +70,14 @@ if (cmd === "mcp") {
       case "list": out(await v.list(s, !!flags.size)); break;
       case "mod": out(v.mod(s, need(rest[0], "a mod id"))); break;
       case "add": out(await v.add(s, need(rest[0], "a file or folder"), flags.name, flags.option)); break;
-      case "install-project": out(v.installProject(s, need(rest[0], "a .cpmodproj file"))); break;
+      case "install-project": out(v.installProject(s, need(rest[0], "a .cpmodproj file"), flags.follow ? "follow" : flags["keep-both"] ? "version" : undefined)); break;
       case "on":
       case "off": out(v.turn(s, need(rest[0], "a mod id"), cmd === "on")); break;
       case "up":
       case "down": out(v.move(s, need(rest[0], "a mod id"), cmd)); break;
+      case "rename": out(v.rename(s, need(rest[0], "a mod id"), rest.slice(1).join(" "))); break;
       case "remove": out(v.remove(s, need(rest[0], "a mod id"))); break;
-      case "deploy": out(await v.deploy(s, flags.keep ?? [], flags.restore ?? [])); break;
+      case "deploy": out(await v.deploy(s, flags.keep ?? [], flags.restore ?? [], typeof flags.mod === "string" ? flags.mod : undefined)); break;
       case "undo": out(v.undo(s)); break;
       case "changes": out(v.changes(s)); break;
       case "pending": out(v.pending(s)); break;

package/dist/core.js

@@ -3739,6 +3739,7 @@ __export(core_exports, {
   deploy: () => deploy,
   deployRedmod: () => deployRedmod,
   deployReportsFolder: () => deployReportsFolder,
+  deployedRedmodPackages: () => deployedRedmodPackages,
   describeHandler: () => describeHandler,
   detectChanges: () => detectChanges,
   dotnet10Root: () => dotnet10Root,
@@ -3784,6 +3785,7 @@ __export(core_exports, {
   isGameFolder: () => isGameFolder,
   keepDownload: () => keepDownload,
   latestBridgeRelease: () => latestBridgeRelease,
+  launchTarget: () => launchTarget,
   libraryFolder: () => libraryFolder,
   librarySize: () => librarySize,
   listLoadouts: () => listLoadouts,
@@ -3792,8 +3794,10 @@ __export(core_exports, {
   loadoutNameProblem: () => loadoutNameProblem,
   loadoutState: () => loadoutState,
   loadoutsFolder: () => loadoutsFolder,
+  lostFiles: () => lostFiles,
   makeActive: () => makeActive,
   md5Of: () => md5Of,
+  modDeployPaths: () => modDeployPaths,
   modFolder: () => modFolder,
   modPageUrl: () => modPageUrl,
   modSize: () => modSize,
@@ -3817,6 +3821,7 @@ __export(core_exports, {
   placeAbove: () => placeAbove,
   placeNextTo: () => placeNextTo,
   plan: () => plan,
+  projectMod: () => projectMod,
   projectName: () => projectName,
   putInSection: () => putInSection,
   readLoadout: () => readLoadout,
@@ -3828,8 +3833,10 @@ __export(core_exports, {
   registerNxmHandler: () => registerNxmHandler,
   removeMod: () => removeMod,
   removeOlderBridges: () => removeOlderBridges,
+  renameFamily: () => renameFamily,
   renameLoadout: () => renameLoadout,
   renameSection: () => renameSection,
+  sameNameMod: () => sameNameMod,
   saveLibrary: () => saveLibrary,
   saveLoadout: () => saveLoadout,
   saveMod: () => saveMod,
@@ -3847,6 +3854,7 @@ __export(core_exports, {
   steamLibraries: () => steamLibraries,
   syncActiveLoadout: () => syncActiveLoadout,
   syncProjects: () => syncProjects,
+  takeFamilyName: () => takeFamilyName,
   tokenUser: () => tokenUser,
   undo: () => undo,
   unpackOrCopy: () => unpackOrCopy,
@@ -4467,6 +4475,11 @@ function gameRunning() {
     return false;
   }
 }
+function launchTarget(gamePath, how) {
+  const steam = how === "steam" || how === "auto" && /[\\/]steamapps[\\/]common[\\/]/i.test(gamePath);
+  if (steam) return { kind: "steam", url: "steam://run/1091500//-modded/" };
+  return { kind: "exe", exe: gameExe(gamePath), args: ["-modded"] };
+}
 function isGameFolder(gamePath) {
   return !!gamePath && fs6.existsSync(gameExe(gamePath));
 }
@@ -4757,6 +4770,18 @@ function detectChanges(gamePath) {
   }
   return changes;
 }
+function lostFiles(p) {
+  const out = /* @__PURE__ */ new Map();
+  for (const c of p.conflicts) {
+    for (const loser of c.losers) {
+      const k = `${loser}\0${c.winner}`;
+      const l = out.get(k) ?? { mod: loser, files: 0, winner: c.winner };
+      l.files++;
+      out.set(k, l);
+    }
+  }
+  return [...out.values()];
+}
 function modsTouched(result) {
   return [...new Set(result.changes.filter((c) => c.kind !== "removed" && c.mod !== Generated).map((c) => c.mod))];
 }
@@ -4849,28 +4874,46 @@ function cleanDirs(gamePath, manifest) {
   }
   manifest.dirs = manifest.dirs.filter((d) => fs8.existsSync(path7.join(gamePath, ...d.split("/"))));
 }
-function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress, gameVersion2) {
+function modDeployPaths(gamePath, p, id) {
+  const paths = new Set((readManifest(gamePath)?.files ?? []).filter((e) => e.mod === id).map((e) => key(e.path)));
+  for (const d of p.desired) if (d.mod?.id === id) paths.add(key(d.rel));
+  return paths;
+}
+function modlistFor(lib, files) {
+  const rank = new Map(lib.mods.map((m, i) => [m.id, i]));
+  const archives = files.filter((e) => e.mod !== Generated && e.path.toLowerCase().startsWith("archive/pc/mod/") && e.path.toLowerCase().endsWith(".archive")).sort((a, b) => (rank.get(a.mod) ?? 1e9) - (rank.get(b.mod) ?? 1e9) || (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+  return archives.length ? archives.map((e) => path7.posix.basename(e.path)).join("\r\n") + "\r\n" : "";
+}
+function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress, gameVersion2, only) {
   if (vortexManages(gamePath)) throw new Error("Vortex manages this game folder. Purge in Vortex first (Mods > Purge), then deploy with EDGEdeck.");
   if (!isGameFolder(gamePath)) throw new Error(`${gamePath} does not look like the Cyberpunk 2077 folder (no bin\\x64\\Cyberpunk2077.exe).`);
   const p = plan(lib, gamePath);
   const manifest = readManifest(gamePath) ?? { version: 1, library: lib.root, gamePath, method: p.method, time: "", files: [], dirs: [] };
   manifest.library = lib.root;
-  const result = { linked: 0, removed: 0, kept: 0, backedUp: 0, method: manifest.method, skipped: [], changes: [], modsInGame: 0 };
+  const result = { linked: 0, removed: 0, kept: 0, backedUp: 0, method: manifest.method, skipped: [], changes: [], modsInGame: 0, lost: lostFiles(p) };
   const entries = new Map(manifest.files.map((e) => [key(e.path), e]));
+  const scope = only ? modDeployPaths(gamePath, p, only) : void 0;
+  const inScope = (rel) => !scope || scope.has(key(rel));
+  const stale = p.stale.filter((e) => inScope(e.path) && !(scope && e.mod === Generated));
+  const add = p.add.filter((d) => inScope(d.rel) && !(scope && d.content !== void 0));
+  if (scope) {
+    const waiting = new Set([...p.stale.map((e) => e.path), ...p.add.map((d) => d.rel)].filter((r) => !scope.has(key(r)) && key(r) !== key(ModListPath)).map(key));
+    result.waiting = waiting.size;
+  }
   for (const [rel, decision] of decisions) {
     const d = p.desired.find((x) => key(x.rel) === key(rel));
     if (decision === "keep" && d?.mod) {
       fs8.copyFileSync(gameFile(gamePath, rel), d.src);
     }
   }
-  const total = p.stale.length + p.add.length;
+  const total = stale.length + add.length;
   let done = 0;
   const save = () => {
     manifest.time = (/* @__PURE__ */ new Date()).toISOString();
     if (gameVersion2) manifest.gameVersion = gameVersion2;
     writeManifest(gamePath, manifest);
   };
-  for (const entry of p.stale) {
+  const takeOut = (entry) => {
     const decided = decisions.get(entry.path);
     if (removeDeployed(lib, gamePath, manifest, entry, decided !== void 0, result.skipped)) {
       entries.delete(key(entry.path));
@@ -4878,10 +4921,8 @@ function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress,
       result.changes.push({ path: entry.path, mod: entry.mod, kind: "removed", ...entry.backup ? { backup: true } : {} });
     }
     manifest.files = [...entries.values()];
-    progress?.(++done, total);
-  }
-  if (p.stale.length) cleanDirs(gamePath, manifest);
-  for (const d of p.add) {
+  };
+  const putIn = (d) => {
     const target = gameFile(gamePath, d.rel);
     const existing = entries.get(key(d.rel));
     let backup = existing?.backup ?? false;
@@ -4889,7 +4930,7 @@ function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress,
       const state = stillOurs(existing, manifest.method, gamePath);
       if (state === "changed" && !decisions.has(d.rel)) {
         result.skipped.push(d.rel);
-        continue;
+        return;
       }
       fs8.rmSync(target, { force: true });
     } else if (fs8.existsSync(target)) {
@@ -4915,10 +4956,29 @@ function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress,
     manifest.files = [...entries.values()];
     result.linked++;
     result.changes.push({ path: d.rel, mod: entry.mod, kind: existing ? "replaced" : "added", ...backup && !existing ? { backup: true } : {} });
+  };
+  for (const entry of stale) {
+    takeOut(entry);
+    progress?.(++done, total);
+  }
+  if (stale.length) cleanDirs(gamePath, manifest);
+  for (const d of add) {
+    putIn(d);
     progress?.(++done, total);
     if (done % 200 === 0) save();
   }
-  result.kept = p.desired.length - result.linked - result.skipped.length;
+  if (scope) {
+    const content = modlistFor(lib, manifest.files);
+    const e = entries.get(key(ModListPath));
+    if (!content && e) {
+      takeOut(e);
+      cleanDirs(gamePath, manifest);
+    } else if (content && (!e || generatedDiffers(gameFile(gamePath, ModListPath), content))) {
+      putIn({ rel: ModListPath, mod: void 0, src: "", content });
+    }
+  }
+  result.kept = (scope ? p.desired.filter((d) => scope.has(key(d.rel))).length : p.desired.length) - result.linked - result.skipped.length;
+  if (scope) result.kept = Math.max(0, result.kept);
   result.modsInGame = new Set(manifest.files.map((e) => e.mod).filter((m) => m !== Generated)).size;
   save();
   return result;
@@ -4992,6 +5052,7 @@ function rednodePackageId(mod) {
   return void 0;
 }
 function familyKey(mod) {
+  if (mod.family) return mod.family;
   if (mod.source.modId) return `nexus:${mod.source.modId}`;
   const pkg = rednodePackageId(mod);
   if (pkg) return `rednode:${pkg}`;
@@ -5044,6 +5105,7 @@ function settleNewVersion(lib, mod) {
   const fam = familyOf(lib, mod);
   const others = fam.mods.filter((m) => m.id !== mod.id);
   if (!others.length) return {};
+  takeFamilyName(lib, mod, others);
   const previous = others.find((m) => m.enabled) ?? [...others].sort(newestFirst)[0];
   if (mod.version && previous.version && versionNewer(previous.version, mod.version)) {
     if (mod.enabled) {
@@ -5066,6 +5128,31 @@ function settleNewVersion(lib, mod) {
   }
   return { replaced: previous };
 }
+function renameFamily(lib, mod, name) {
+  const fam = familyOf(lib, mod);
+  const to = name.trim();
+  for (const m of fam.mods) {
+    m.family = fam.key;
+    if (!to) {
+      if (m.renamedFrom !== void 0) m.name = m.renamedFrom;
+      delete m.renamedFrom;
+    } else if (m.name !== to) {
+      m.renamedFrom ??= m.name;
+      m.name = to;
+      if (m.renamedFrom === to) delete m.renamedFrom;
+    }
+    saveMod(lib, m);
+  }
+  return familyOf(lib, mod);
+}
+function takeFamilyName(lib, mod, others) {
+  const renamed = others.find((m) => m.renamedFrom !== void 0);
+  if (!renamed || mod.name === renamed.name) return;
+  mod.family = familyKey(renamed);
+  mod.renamedFrom = mod.name;
+  mod.name = renamed.name;
+  saveMod(lib, mod);
+}
 function familiesWithTwoOn(lib) {
   return families(lib).filter((f) => f.mods.filter((m) => m.enabled).length > 1);
 }
@@ -5671,11 +5758,48 @@ function syncProjects(lib) {
   }
   return refreshed;
 }
-function installProject(lib, projectFile) {
+function projectMod(lib, projectFile) {
+  return lib.mods.find((m) => m.source.type === "project" && m.source.path?.toLowerCase() === projectFile.toLowerCase());
+}
+function sameNameMod(lib, projectFile) {
+  if (projectMod(lib, projectFile)) return void 0;
+  const name = baseName(projectName(projectFile));
+  const match = name ? lib.mods.find((m) => baseName(m.name) === name || m.renamedFrom !== void 0 && baseName(m.renamedFrom) === name) : void 0;
+  return match && familyOf(lib, match).active;
+}
+function devVersion(lib, family) {
+  const taken = new Set(lib.mods.filter((m) => familyKey(m) === family).map((m) => m.version.toLowerCase()));
+  if (!taken.has("dev")) return "dev";
+  let n = 2;
+  while (taken.has(`dev ${n}`)) n++;
+  return `dev ${n}`;
+}
+function installProject(lib, projectFile, beside) {
   const c = classifyProject(projectFile);
   if (!c.placements.length) throw new Error(`${projectName(projectFile)} has no packed output yet. Pack the project first (packed/ next to the project file).`);
-  const existing = lib.mods.find((m) => m.source.type === "project" && m.source.path?.toLowerCase() === projectFile.toLowerCase());
+  let existing = projectMod(lib, projectFile);
+  if (!existing && beside?.how === "follow") {
+    existing = beside.mod;
+    existing.family = familyKey(existing);
+    existing.source = { type: "project", path: projectFile };
+  }
   if (!existing) {
+    if (beside?.how === "version") {
+      const family = familyKey(beside.mod);
+      const previous = familyOf(lib, beside.mod);
+      const mod2 = addMod(lib, c.placements, { name: projectName(projectFile), version: devVersion(lib, family), source: { type: "project", path: projectFile } });
+      mod2.family = family;
+      takeFamilyName(lib, mod2, previous.mods);
+      placeAbove(lib, mod2, previous.active);
+      for (const m of previous.mods) {
+        if (m.enabled) {
+          m.enabled = false;
+          saveMod(lib, m);
+        }
+      }
+      saveMod(lib, mod2);
+      return { mod: mod2, added: true, beside };
+    }
     const mod = addMod(lib, c.placements, { name: projectName(projectFile), version: "dev", source: { type: "project", path: projectFile } });
     return { mod, added: true };
   }
@@ -5689,9 +5813,10 @@ function installProject(lib, projectFile) {
   for (const f of existing.files) if (!keep.has(f)) fs10.rmSync(sourcePath(lib, existing, f), { force: true });
   existing.files = [...keep].sort();
   existing.kinds = c.kinds;
+  activateVersion(lib, existing);
   existing.enabled = true;
   saveMod(lib, existing);
-  return { mod: existing, added: false };
+  return { mod: existing, added: false, ...beside ? { beside } : {} };
 }
 
 // src/redmod.ts
@@ -5714,8 +5839,18 @@ function enabledRedmodPackages(lib) {
   }
   return names;
 }
-async function deployRedmod(lib, gamePath, log) {
-  const packages = enabledRedmodPackages(lib);
+function deployedRedmodPackages(lib, gamePath) {
+  const inGame = new Set((readManifest(gamePath)?.files ?? []).map((e) => /^mods\/([^/]+)\//i.exec(e.path)?.[1]).filter((n) => !!n));
+  const names = [];
+  for (const mod of lib.mods) {
+    for (const f of mod.files) {
+      const m = /^mods\/([^/]+)\//i.exec(f);
+      if (m && inGame.has(m[1]) && !names.includes(m[1])) names.push(m[1]);
+    }
+  }
+  return names;
+}
+async function deployRedmod(lib, gamePath, log, packages = enabledRedmodPackages(lib)) {
   const exe = redModExe(gamePath);
   if (!packages.length) return { ran: false, packages, output: "no REDmod packages enabled" };
   if (!fs11.existsSync(exe)) return { ran: false, packages, output: `redMod.exe not found at ${exe}; the REDmod tools are a free DLC on the game's store page` };
@@ -6045,6 +6180,13 @@ function importFromVortex(lib, mods) {
 }
 
 // src/verbs.ts
+function lostProjectsText(lib, lost) {
+  const lines = lost.flatMap((l) => {
+    const mod = lib.mods.find((m) => m.id === l.mod);
+    return mod?.source.type === "project" ? [`the game still has ${l.winner} for ${l.files} file(s), not the project ${l.mod} (move ${l.mod} up to let it win)`] : [];
+  });
+  return lines.length ? `; ${lines.join("; ")}` : "";
+}
 var DefaultGame = "C:\\Program Files (x86)\\Steam\\steamapps\\common\\Cyberpunk 2077";
 function openSession(opts) {
   const libraryRoot = opts.library ?? defaultLibraryPath();
@@ -6139,12 +6281,20 @@ ${mod.files.join("\n")}`;
     }
   },
   /** Adds a REDcode or WolvenKit project's packed output, or refreshes the mod that follows it, and turns it on. */
-  installProject(s, projectFile) {
+  /**
+   * `sameName` answers for a mod of the same name that does not follow this project: follow (it
+   * follows this project from now on) or version (the project is another version of it, on in its
+   * place). Without it, the project is a mod of its own and the text says what it sits beside.
+   */
+  installProject(s, projectFile, sameName) {
     if (!fs14.existsSync(projectFile)) throw new Error(`${projectFile} does not exist`);
-    const { mod, added } = installProject(s.lib, projectFile);
+    const other = sameNameMod(s.lib, projectFile);
+    const before = other && `${other.id}${other.source.type === "project" && other.source.path ? ` (${path13.dirname(other.source.path)})` : ""}`;
+    const { mod, added, beside } = installProject(s.lib, projectFile, other && sameName ? { mod: other, how: sameName } : void 0);
+    const note = beside?.how === "follow" ? `; ${before} follows this project now` : beside ? `; another version of ${before}, on in its place` : other ? `; note: the library also has ${before} under the same name, a separate mod; the one higher in the list wins the files they share (call again with sameName follow or version to settle it)` : "";
     return {
-      data: { id: mod.id, name: mod.name, version: mod.version, kinds: mod.kinds, files: mod.files.length, added },
-      text: `${added ? "added" : "refreshed"} ${mod.id} from its project (${mod.files.length} files, ${mod.kinds.join(", ")}); it is on, deploy to put it in the game`
+      data: { id: mod.id, name: mod.name, version: mod.version, kinds: mod.kinds, files: mod.files.length, added, sameName: other?.id, beside: beside?.how },
+      text: `${added ? "added" : "refreshed"} ${mod.id} from its project (${mod.files.length} files, ${mod.kinds.join(", ")}); it is on, deploy to put it in the game${note}`
     };
   },
   turn(s, id, on) {
@@ -6158,22 +6308,37 @@ ${mod.files.join("\n")}`;
     moveMod(s.lib, mod, direction === "up" ? -1 : 1);
     return { data: { order: s.lib.info.order }, text: s.lib.info.order.join("\n") };
   },
+  /** A new name in EDGEdeck for a mod and all its versions; an empty name puts the first name back. */
+  rename(s, id, name) {
+    const mod = find(s, id);
+    const before = familyOf(s.lib, mod).name;
+    const fam = renameFamily(s.lib, mod, name);
+    return {
+      data: { id: mod.id, name: fam.name, versions: fam.mods.map((m) => m.id) },
+      text: `${before} is now ${fam.name}${fam.mods.length > 1 ? ` (${fam.mods.length} versions)` : ""}; its files and the game do not change`
+    };
+  },
   remove(s, id) {
     const mod = find(s, id);
     removeMod(s.lib, mod);
     return { data: { removed: mod.id }, text: `removed ${mod.id} from the library; its deployed files leave on the next deploy` };
   },
-  /** Deploys. A file changed outside EDGEdeck is skipped unless named in keep (import it) or restore (overwrite it). */
-  async deploy(s, keep = [], restore = []) {
+  /**
+   * Deploys. A file changed outside EDGEdeck is skipped unless named in keep (import it) or restore
+   * (overwrite it). With `only` (a mod id), deploys that mod's changes and leaves the rest waiting.
+   */
+  async deploy(s, keep = [], restore = [], only) {
     gameReady(s);
     if (gameRunning()) throw new Error("Cyberpunk 2077 is running; it keeps mod files open. Quit the game, then deploy");
+    if (only) find(s, only);
     const decisions = /* @__PURE__ */ new Map();
     for (const p of keep) decisions.set(p, "keep");
     for (const p of restore) decisions.set(p, "restore");
-    const result = deploy(s.lib, s.game, decisions, void 0, await gameVersion(s.game));
-    const redmod = enabledRedmodPackages(s.lib).length ? await deployRedmod(s.lib, s.game) : void 0;
+    const result = deploy(s.lib, s.game, decisions, void 0, await gameVersion(s.game), only);
+    const packages = only ? result.changes.some((c) => c.path.toLowerCase().startsWith("mods/")) ? deployedRedmodPackages(s.lib, s.game) : [] : enabledRedmodPackages(s.lib);
+    const redmod = packages.length ? await deployRedmod(s.lib, s.game, void 0, packages) : void 0;
     const report = writeDeployReport(s.lib, s.game, result);
-    const text = `deployed (${result.method}): ${result.linked} added for ${modsTouched(result).length} mod(s), ${result.removed} removed, ${result.kept} unchanged; ${result.modsInGame} mod(s) in the game; report ${report}${result.skipped.length ? `; skipped (changed in game folder, answer with keep or restore): ${result.skipped.join(", ")}` : ""}${redmod ? `; REDmod: ${redmod.ran ? `${redmod.packages.length} prepared` : redmod.output}` : ""}`;
+    const text = `deployed${only ? ` ${only} only` : ""} (${result.method}): ${result.linked} added for ${modsTouched(result).length} mod(s), ${result.removed} removed, ${result.kept} unchanged; ${result.modsInGame} mod(s) in the game; report ${report}${result.skipped.length ? `; skipped (changed in game folder, answer with keep or restore): ${result.skipped.join(", ")}` : ""}${redmod ? `; REDmod: ${redmod.ran ? `${redmod.packages.length} prepared` : redmod.output}` : ""}${result.waiting ? `; ${result.waiting} file(s) of other mods' changes still waiting` : ""}${lostProjectsText(s.lib, result.lost)}`;
     return { data: { ...result, redmod, report }, text };
   },
   undo(s) {
@@ -6271,6 +6436,7 @@ ${mod.files.join("\n")}`;
   deploy,
   deployRedmod,
   deployReportsFolder,
+  deployedRedmodPackages,
   describeHandler,
   detectChanges,
   dotnet10Root,
@@ -6316,6 +6482,7 @@ ${mod.files.join("\n")}`;
   isGameFolder,
   keepDownload,
   latestBridgeRelease,
+  launchTarget,
   libraryFolder,
   librarySize,
   listLoadouts,
@@ -6324,8 +6491,10 @@ ${mod.files.join("\n")}`;
   loadoutNameProblem,
   loadoutState,
   loadoutsFolder,
+  lostFiles,
   makeActive,
   md5Of,
+  modDeployPaths,
   modFolder,
   modPageUrl,
   modSize,
@@ -6349,6 +6518,7 @@ ${mod.files.join("\n")}`;
   placeAbove,
   placeNextTo,
   plan,
+  projectMod,
   projectName,
   putInSection,
   readLoadout,
@@ -6360,8 +6530,10 @@ ${mod.files.join("\n")}`;
   registerNxmHandler,
   removeMod,
   removeOlderBridges,
+  renameFamily,
   renameLoadout,
   renameSection,
+  sameNameMod,
   saveLibrary,
   saveLoadout,
   saveMod,
@@ -6379,6 +6551,7 @@ ${mod.files.join("\n")}`;
   steamLibraries,
   syncActiveLoadout,
   syncProjects,
+  takeFamilyName,
   tokenUser,
   undo,
   unpackOrCopy,

package/dist/mcp.js

@@ -36932,6 +36932,7 @@ function rednodePackageId(mod) {
   return void 0;
 }
 function familyKey(mod) {
+  if (mod.family) return mod.family;
   if (mod.source.modId) return `nexus:${mod.source.modId}`;
   const pkg = rednodePackageId(mod);
   if (pkg) return `rednode:${pkg}`;
@@ -36963,10 +36964,25 @@ function families(lib) {
 function familyOf(lib, mod) {
   return families(lib).find((f) => f.key === familyKey(mod)) ?? { key: familyKey(mod), name: mod.name, nexusId: mod.source.modId, mods: [mod], active: mod, on: mod.enabled };
 }
+function activateVersion(lib, chosen) {
+  const fam = familyOf(lib, chosen);
+  const previous = fam.active;
+  const on = fam.on;
+  if (previous.id !== chosen.id) placeAbove(lib, chosen, previous);
+  for (const m of fam.mods) {
+    const want = m.id === chosen.id ? on : false;
+    if (m.enabled !== want) {
+      m.enabled = want;
+      saveMod(lib, m);
+    }
+  }
+  return { previous, on };
+}
 function settleNewVersion(lib, mod) {
   const fam = familyOf(lib, mod);
   const others = fam.mods.filter((m) => m.id !== mod.id);
   if (!others.length) return {};
+  takeFamilyName(lib, mod, others);
   const previous = others.find((m) => m.enabled) ?? [...others].sort(newestFirst)[0];
   if (mod.version && previous.version && versionNewer(previous.version, mod.version)) {
     if (mod.enabled) {
@@ -36989,6 +37005,31 @@ function settleNewVersion(lib, mod) {
   }
   return { replaced: previous };
 }
+function renameFamily(lib, mod, name) {
+  const fam = familyOf(lib, mod);
+  const to = name.trim();
+  for (const m of fam.mods) {
+    m.family = fam.key;
+    if (!to) {
+      if (m.renamedFrom !== void 0) m.name = m.renamedFrom;
+      delete m.renamedFrom;
+    } else if (m.name !== to) {
+      m.renamedFrom ??= m.name;
+      m.name = to;
+      if (m.renamedFrom === to) delete m.renamedFrom;
+    }
+    saveMod(lib, m);
+  }
+  return familyOf(lib, mod);
+}
+function takeFamilyName(lib, mod, others) {
+  const renamed = others.find((m) => m.renamedFrom !== void 0);
+  if (!renamed || mod.name === renamed.name) return;
+  mod.family = familyKey(renamed);
+  mod.renamedFrom = mod.name;
+  mod.name = renamed.name;
+  saveMod(lib, mod);
+}
 
 // src/deploy.ts
 var fs4 = __toESM(require("node:fs"));
@@ -37178,6 +37219,18 @@ function detectChanges(gamePath) {
   }
   return changes;
 }
+function lostFiles(p) {
+  const out = /* @__PURE__ */ new Map();
+  for (const c of p.conflicts) {
+    for (const loser of c.losers) {
+      const k = `${loser}\0${c.winner}`;
+      const l = out.get(k) ?? { mod: loser, files: 0, winner: c.winner };
+      l.files++;
+      out.set(k, l);
+    }
+  }
+  return [...out.values()];
+}
 function modsTouched(result) {
   return [...new Set(result.changes.filter((c) => c.kind !== "removed" && c.mod !== Generated).map((c) => c.mod))];
 }
@@ -37267,28 +37320,46 @@ function cleanDirs(gamePath, manifest) {
   }
   manifest.dirs = manifest.dirs.filter((d) => fs4.existsSync(path4.join(gamePath, ...d.split("/"))));
 }
-function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress, gameVersion2) {
+function modDeployPaths(gamePath, p, id) {
+  const paths = new Set((readManifest(gamePath)?.files ?? []).filter((e) => e.mod === id).map((e) => key(e.path)));
+  for (const d of p.desired) if (d.mod?.id === id) paths.add(key(d.rel));
+  return paths;
+}
+function modlistFor(lib, files) {
+  const rank = new Map(lib.mods.map((m, i) => [m.id, i]));
+  const archives = files.filter((e) => e.mod !== Generated && e.path.toLowerCase().startsWith("archive/pc/mod/") && e.path.toLowerCase().endsWith(".archive")).sort((a, b) => (rank.get(a.mod) ?? 1e9) - (rank.get(b.mod) ?? 1e9) || (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+  return archives.length ? archives.map((e) => path4.posix.basename(e.path)).join("\r\n") + "\r\n" : "";
+}
+function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress, gameVersion2, only) {
   if (vortexManages(gamePath)) throw new Error("Vortex manages this game folder. Purge in Vortex first (Mods > Purge), then deploy with EDGEdeck.");
   if (!isGameFolder(gamePath)) throw new Error(`${gamePath} does not look like the Cyberpunk 2077 folder (no bin\\x64\\Cyberpunk2077.exe).`);
   const p = plan(lib, gamePath);
   const manifest = readManifest(gamePath) ?? { version: 1, library: lib.root, gamePath, method: p.method, time: "", files: [], dirs: [] };
   manifest.library = lib.root;
-  const result = { linked: 0, removed: 0, kept: 0, backedUp: 0, method: manifest.method, skipped: [], changes: [], modsInGame: 0 };
+  const result = { linked: 0, removed: 0, kept: 0, backedUp: 0, method: manifest.method, skipped: [], changes: [], modsInGame: 0, lost: lostFiles(p) };
   const entries = new Map(manifest.files.map((e) => [key(e.path), e]));
+  const scope = only ? modDeployPaths(gamePath, p, only) : void 0;
+  const inScope = (rel) => !scope || scope.has(key(rel));
+  const stale = p.stale.filter((e) => inScope(e.path) && !(scope && e.mod === Generated));
+  const add = p.add.filter((d) => inScope(d.rel) && !(scope && d.content !== void 0));
+  if (scope) {
+    const waiting = new Set([...p.stale.map((e) => e.path), ...p.add.map((d) => d.rel)].filter((r) => !scope.has(key(r)) && key(r) !== key(ModListPath)).map(key));
+    result.waiting = waiting.size;
+  }
   for (const [rel, decision] of decisions) {
     const d = p.desired.find((x) => key(x.rel) === key(rel));
     if (decision === "keep" && d?.mod) {
       fs4.copyFileSync(gameFile(gamePath, rel), d.src);
     }
   }
-  const total = p.stale.length + p.add.length;
+  const total = stale.length + add.length;
   let done = 0;
   const save = () => {
     manifest.time = (/* @__PURE__ */ new Date()).toISOString();
     if (gameVersion2) manifest.gameVersion = gameVersion2;
     writeManifest(gamePath, manifest);
   };
-  for (const entry of p.stale) {
+  const takeOut = (entry) => {
     const decided = decisions.get(entry.path);
     if (removeDeployed(lib, gamePath, manifest, entry, decided !== void 0, result.skipped)) {
       entries.delete(key(entry.path));
@@ -37296,10 +37367,8 @@ function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress,
       result.changes.push({ path: entry.path, mod: entry.mod, kind: "removed", ...entry.backup ? { backup: true } : {} });
     }
     manifest.files = [...entries.values()];
-    progress?.(++done, total);
-  }
-  if (p.stale.length) cleanDirs(gamePath, manifest);
-  for (const d of p.add) {
+  };
+  const putIn = (d) => {
     const target = gameFile(gamePath, d.rel);
     const existing = entries.get(key(d.rel));
     let backup = existing?.backup ?? false;
@@ -37307,7 +37376,7 @@ function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress,
       const state = stillOurs(existing, manifest.method, gamePath);
       if (state === "changed" && !decisions.has(d.rel)) {
         result.skipped.push(d.rel);
-        continue;
+        return;
       }
       fs4.rmSync(target, { force: true });
     } else if (fs4.existsSync(target)) {
@@ -37333,10 +37402,29 @@ function deploy(lib, gamePath, decisions = /* @__PURE__ */ new Map(), progress,
     manifest.files = [...entries.values()];
     result.linked++;
     result.changes.push({ path: d.rel, mod: entry.mod, kind: existing ? "replaced" : "added", ...backup && !existing ? { backup: true } : {} });
+  };
+  for (const entry of stale) {
+    takeOut(entry);
+    progress?.(++done, total);
+  }
+  if (stale.length) cleanDirs(gamePath, manifest);
+  for (const d of add) {
+    putIn(d);
     progress?.(++done, total);
     if (done % 200 === 0) save();
   }
-  result.kept = p.desired.length - result.linked - result.skipped.length;
+  if (scope) {
+    const content = modlistFor(lib, manifest.files);
+    const e = entries.get(key(ModListPath));
+    if (!content && e) {
+      takeOut(e);
+      cleanDirs(gamePath, manifest);
+    } else if (content && (!e || generatedDiffers(gameFile(gamePath, ModListPath), content))) {
+      putIn({ rel: ModListPath, mod: void 0, src: "", content });
+    }
+  }
+  result.kept = (scope ? p.desired.filter((d) => scope.has(key(d.rel))).length : p.desired.length) - result.linked - result.skipped.length;
+  if (scope) result.kept = Math.max(0, result.kept);
   result.modsInGame = new Set(manifest.files.map((e) => e.mod).filter((m) => m !== Generated)).size;
   save();
   return result;
@@ -37620,11 +37708,48 @@ function classifyProject(projectFile) {
   if (!fs7.existsSync(packed)) return { placements: [], kinds: [], unplaced: [], ignored: [] };
   return classify(packed, projectName(projectFile));
 }
-function installProject(lib, projectFile) {
+function projectMod(lib, projectFile) {
+  return lib.mods.find((m) => m.source.type === "project" && m.source.path?.toLowerCase() === projectFile.toLowerCase());
+}
+function sameNameMod(lib, projectFile) {
+  if (projectMod(lib, projectFile)) return void 0;
+  const name = baseName(projectName(projectFile));
+  const match = name ? lib.mods.find((m) => baseName(m.name) === name || m.renamedFrom !== void 0 && baseName(m.renamedFrom) === name) : void 0;
+  return match && familyOf(lib, match).active;
+}
+function devVersion(lib, family) {
+  const taken = new Set(lib.mods.filter((m) => familyKey(m) === family).map((m) => m.version.toLowerCase()));
+  if (!taken.has("dev")) return "dev";
+  let n = 2;
+  while (taken.has(`dev ${n}`)) n++;
+  return `dev ${n}`;
+}
+function installProject(lib, projectFile, beside) {
   const c = classifyProject(projectFile);
   if (!c.placements.length) throw new Error(`${projectName(projectFile)} has no packed output yet. Pack the project first (packed/ next to the project file).`);
-  const existing = lib.mods.find((m) => m.source.type === "project" && m.source.path?.toLowerCase() === projectFile.toLowerCase());
+  let existing = projectMod(lib, projectFile);
+  if (!existing && beside?.how === "follow") {
+    existing = beside.mod;
+    existing.family = familyKey(existing);
+    existing.source = { type: "project", path: projectFile };
+  }
   if (!existing) {
+    if (beside?.how === "version") {
+      const family = familyKey(beside.mod);
+      const previous = familyOf(lib, beside.mod);
+      const mod2 = addMod(lib, c.placements, { name: projectName(projectFile), version: devVersion(lib, family), source: { type: "project", path: projectFile } });
+      mod2.family = family;
+      takeFamilyName(lib, mod2, previous.mods);
+      placeAbove(lib, mod2, previous.active);
+      for (const m of previous.mods) {
+        if (m.enabled) {
+          m.enabled = false;
+          saveMod(lib, m);
+        }
+      }
+      saveMod(lib, mod2);
+      return { mod: mod2, added: true, beside };
+    }
     const mod = addMod(lib, c.placements, { name: projectName(projectFile), version: "dev", source: { type: "project", path: projectFile } });
     return { mod, added: true };
   }
@@ -37638,9 +37763,10 @@ function installProject(lib, projectFile) {
   for (const f of existing.files) if (!keep.has(f)) fs7.rmSync(sourcePath(lib, existing, f), { force: true });
   existing.files = [...keep].sort();
   existing.kinds = c.kinds;
+  activateVersion(lib, existing);
   existing.enabled = true;
   saveMod(lib, existing);
-  return { mod: existing, added: false };
+  return { mod: existing, added: false, ...beside ? { beside } : {} };
 }
 
 // src/redmod.ts
@@ -37663,8 +37789,18 @@ function enabledRedmodPackages(lib) {
   }
   return names;
 }
-async function deployRedmod(lib, gamePath, log) {
-  const packages = enabledRedmodPackages(lib);
+function deployedRedmodPackages(lib, gamePath) {
+  const inGame = new Set((readManifest(gamePath)?.files ?? []).map((e) => /^mods\/([^/]+)\//i.exec(e.path)?.[1]).filter((n) => !!n));
+  const names = [];
+  for (const mod of lib.mods) {
+    for (const f of mod.files) {
+      const m = /^mods\/([^/]+)\//i.exec(f);
+      if (m && inGame.has(m[1]) && !names.includes(m[1])) names.push(m[1]);
+    }
+  }
+  return names;
+}
+async function deployRedmod(lib, gamePath, log, packages = enabledRedmodPackages(lib)) {
   const exe = redModExe(gamePath);
   if (!packages.length) return { ran: false, packages, output: "no REDmod packages enabled" };
   if (!fs8.existsSync(exe)) return { ran: false, packages, output: `redMod.exe not found at ${exe}; the REDmod tools are a free DLC on the game's store page` };
@@ -37879,6 +38015,13 @@ function importFromVortex(lib, mods) {
 }
 
 // src/verbs.ts
+function lostProjectsText(lib, lost) {
+  const lines = lost.flatMap((l) => {
+    const mod = lib.mods.find((m) => m.id === l.mod);
+    return mod?.source.type === "project" ? [`the game still has ${l.winner} for ${l.files} file(s), not the project ${l.mod} (move ${l.mod} up to let it win)`] : [];
+  });
+  return lines.length ? `; ${lines.join("; ")}` : "";
+}
 var DefaultGame = "C:\\Program Files (x86)\\Steam\\steamapps\\common\\Cyberpunk 2077";
 function openSession(opts) {
   const libraryRoot = opts.library ?? defaultLibraryPath();
@@ -37973,12 +38116,20 @@ ${mod.files.join("\n")}`;
     }
   },
   /** Adds a REDcode or WolvenKit project's packed output, or refreshes the mod that follows it, and turns it on. */
-  installProject(s, projectFile) {
+  /**
+   * `sameName` answers for a mod of the same name that does not follow this project: follow (it
+   * follows this project from now on) or version (the project is another version of it, on in its
+   * place). Without it, the project is a mod of its own and the text says what it sits beside.
+   */
+  installProject(s, projectFile, sameName) {
     if (!fs11.existsSync(projectFile)) throw new Error(`${projectFile} does not exist`);
-    const { mod, added } = installProject(s.lib, projectFile);
+    const other = sameNameMod(s.lib, projectFile);
+    const before = other && `${other.id}${other.source.type === "project" && other.source.path ? ` (${path11.dirname(other.source.path)})` : ""}`;
+    const { mod, added, beside } = installProject(s.lib, projectFile, other && sameName ? { mod: other, how: sameName } : void 0);
+    const note = beside?.how === "follow" ? `; ${before} follows this project now` : beside ? `; another version of ${before}, on in its place` : other ? `; note: the library also has ${before} under the same name, a separate mod; the one higher in the list wins the files they share (call again with sameName follow or version to settle it)` : "";
     return {
-      data: { id: mod.id, name: mod.name, version: mod.version, kinds: mod.kinds, files: mod.files.length, added },
-      text: `${added ? "added" : "refreshed"} ${mod.id} from its project (${mod.files.length} files, ${mod.kinds.join(", ")}); it is on, deploy to put it in the game`
+      data: { id: mod.id, name: mod.name, version: mod.version, kinds: mod.kinds, files: mod.files.length, added, sameName: other?.id, beside: beside?.how },
+      text: `${added ? "added" : "refreshed"} ${mod.id} from its project (${mod.files.length} files, ${mod.kinds.join(", ")}); it is on, deploy to put it in the game${note}`
     };
   },
   turn(s, id, on) {
@@ -37992,22 +38143,37 @@ ${mod.files.join("\n")}`;
     moveMod(s.lib, mod, direction === "up" ? -1 : 1);
     return { data: { order: s.lib.info.order }, text: s.lib.info.order.join("\n") };
   },
+  /** A new name in EDGEdeck for a mod and all its versions; an empty name puts the first name back. */
+  rename(s, id, name) {
+    const mod = find(s, id);
+    const before = familyOf(s.lib, mod).name;
+    const fam = renameFamily(s.lib, mod, name);
+    return {
+      data: { id: mod.id, name: fam.name, versions: fam.mods.map((m) => m.id) },
+      text: `${before} is now ${fam.name}${fam.mods.length > 1 ? ` (${fam.mods.length} versions)` : ""}; its files and the game do not change`
+    };
+  },
   remove(s, id) {
     const mod = find(s, id);
     removeMod(s.lib, mod);
     return { data: { removed: mod.id }, text: `removed ${mod.id} from the library; its deployed files leave on the next deploy` };
   },
-  /** Deploys. A file changed outside EDGEdeck is skipped unless named in keep (import it) or restore (overwrite it). */
-  async deploy(s, keep = [], restore = []) {
+  /**
+   * Deploys. A file changed outside EDGEdeck is skipped unless named in keep (import it) or restore
+   * (overwrite it). With `only` (a mod id), deploys that mod's changes and leaves the rest waiting.
+   */
+  async deploy(s, keep = [], restore = [], only) {
     gameReady(s);
     if (gameRunning()) throw new Error("Cyberpunk 2077 is running; it keeps mod files open. Quit the game, then deploy");
+    if (only) find(s, only);
     const decisions = /* @__PURE__ */ new Map();
     for (const p of keep) decisions.set(p, "keep");
     for (const p of restore) decisions.set(p, "restore");
-    const result = deploy(s.lib, s.game, decisions, void 0, await gameVersion(s.game));
-    const redmod = enabledRedmodPackages(s.lib).length ? await deployRedmod(s.lib, s.game) : void 0;
+    const result = deploy(s.lib, s.game, decisions, void 0, await gameVersion(s.game), only);
+    const packages = only ? result.changes.some((c) => c.path.toLowerCase().startsWith("mods/")) ? deployedRedmodPackages(s.lib, s.game) : [] : enabledRedmodPackages(s.lib);
+    const redmod = packages.length ? await deployRedmod(s.lib, s.game, void 0, packages) : void 0;
     const report = writeDeployReport(s.lib, s.game, result);
-    const text = `deployed (${result.method}): ${result.linked} added for ${modsTouched(result).length} mod(s), ${result.removed} removed, ${result.kept} unchanged; ${result.modsInGame} mod(s) in the game; report ${report}${result.skipped.length ? `; skipped (changed in game folder, answer with keep or restore): ${result.skipped.join(", ")}` : ""}${redmod ? `; REDmod: ${redmod.ran ? `${redmod.packages.length} prepared` : redmod.output}` : ""}`;
+    const text = `deployed${only ? ` ${only} only` : ""} (${result.method}): ${result.linked} added for ${modsTouched(result).length} mod(s), ${result.removed} removed, ${result.kept} unchanged; ${result.modsInGame} mod(s) in the game; report ${report}${result.skipped.length ? `; skipped (changed in game folder, answer with keep or restore): ${result.skipped.join(", ")}` : ""}${redmod ? `; REDmod: ${redmod.ran ? `${redmod.packages.length} prepared` : redmod.output}` : ""}${result.waiting ? `; ${result.waiting} file(s) of other mods' changes still waiting` : ""}${lostProjectsText(s.lib, result.lost)}`;
     return { data: { ...result, redmod, report }, text };
   },
   undo(s) {
@@ -38093,6 +38259,7 @@ ${JSON.stringify(v.data, null, 2)}` }] };
   };
 }
 var session = () => openSession(options);
+var AskFirst = { "anthropic/requiresUserInteraction": true };
 var server = new McpServer({ name: "edgedeck", version: version2 }, { instructions: Instructions });
 server.registerTool(
   "edgedeck_list",
@@ -38127,10 +38294,13 @@ server.registerTool(
   "edgedeck_install_project",
   {
     title: "Install a project",
-    description: "Takes a REDcode or WolvenKit project's packed/ folder into the library: adds it as version dev the first time, and on later calls replaces the files of the mod that follows the project. The mod is turned on; deploy to put it in the game. Pack the project first.",
-    inputSchema: { project: external_exports.string().describe("Full path of the .cpmodproj file") }
+    description: "Takes a REDcode or WolvenKit project's packed/ folder into the library: adds it as version dev the first time, and on later calls replaces the files of the mod that follows the project. The mod is turned on; deploy to put it in the game. Pack the project first. When the library has a mod of the same name that does not follow this project (another project folder, or a download), the result says so; ask the player and call again with sameName.",
+    inputSchema: {
+      project: external_exports.string().describe("Full path of the .cpmodproj file"),
+      sameName: external_exports.enum(["follow", "version"]).optional().describe("For a mod of the same name: follow = it follows this project from now on (no second mod); version = the project becomes another version of it, on in its place")
+    }
   },
-  ({ project }) => run4(() => verbs.installProject(session(), project))()
+  ({ project, sameName }) => run4(() => verbs.installProject(session(), project, sameName))()
 );
 server.registerTool(
   "edgedeck_turn",
@@ -38151,13 +38321,23 @@ server.registerTool(
   },
   ({ id, direction }) => run4(() => verbs.move(session(), id, direction))()
 );
+server.registerTool(
+  "edgedeck_rename",
+  {
+    title: "Rename a mod",
+    description: "Gives a mod a new name in EDGEdeck, for all its versions; its files and the game do not change. New versions of it take the name too. An empty name puts the first name back.",
+    inputSchema: { id: external_exports.string(), name: external_exports.string().describe("The new name, or empty for the first one") }
+  },
+  ({ id, name }) => run4(() => verbs.rename(session(), id, name))()
+);
 server.registerTool(
   "edgedeck_remove",
   {
     title: "Remove a mod",
     description: "Deletes a mod from the library. Its deployed files leave the game on the next deploy. The kept download, if any, stays.",
     inputSchema: { id: external_exports.string() },
-    annotations: { destructiveHint: true }
+    annotations: { destructiveHint: true },
+    _meta: AskFirst
   },
   ({ id }) => run4(() => verbs.remove(session(), id))()
 );
@@ -38175,17 +38355,23 @@ server.registerTool(
   {
     title: "Deploy",
     description: "Hardlinks (or copies, on another drive) the files of every mod that is on into the game folder, writes the archive load order, prepares REDmod packages and records a manifest. A file changed in the game folder since the last deploy is skipped and named; call again with keep (import the changed file into the library) or restore (put the mod's file back). Refuses while Vortex manages the game folder.",
-    inputSchema: { keep: external_exports.array(external_exports.string()).optional().describe("Game-folder paths whose changed file to keep"), restore: external_exports.array(external_exports.string()).optional().describe("Game-folder paths to overwrite with the mod's file") },
-    annotations: { destructiveHint: true }
+    inputSchema: {
+      keep: external_exports.array(external_exports.string()).optional().describe("Game-folder paths whose changed file to keep"),
+      restore: external_exports.array(external_exports.string()).optional().describe("Game-folder paths to overwrite with the mod's file"),
+      mod: external_exports.string().optional().describe("A mod id: deploy only that mod's changes and leave other mods' changes waiting")
+    },
+    annotations: { destructiveHint: true },
+    _meta: AskFirst
   },
-  ({ keep, restore }) => run4(() => verbs.deploy(session(), keep, restore))()
+  ({ keep, restore, mod }) => run4(() => verbs.deploy(session(), keep, restore, mod))()
 );
 server.registerTool(
   "edgedeck_undo",
   {
     title: "Undo deploy",
     description: "Removes every file EDGEdeck deployed, and nothing else, and puts backed-up files back.",
-    annotations: { destructiveHint: true }
+    annotations: { destructiveHint: true },
+    _meta: AskFirst
   },
   run4(() => verbs.undo(session()))
 );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edgemodders/edgedeck-mcp",
-  "version": "0.27.3",
+  "version": "0.28.0",
   "description": "EDGEdeck's MCP server and command line: manage Cyberpunk 2077 mods (add, turn on or off, order, deploy, undo, conflicts, loadouts) from an AI assistant or a script.",
   "license": "MIT",
   "author": "Edgemodders",