@uzysjung/agent-harness 26.172.0 → 26.173.0

package/dist/index.js

@@ -101,7 +101,7 @@ import {
   targetsInclude,
   upsertHarnessImport,
   writeInstallLog
-} from "./chunk-T2HBTG32.js";
+} from "./chunk-JABFWW6X.js";
 
 // node_modules/sisteransi/src/index.js
 var require_src = __commonJS({
@@ -3713,8 +3713,8 @@ function padDisplay(s, width) {
 
 // src/install-writes.ts
 init_esm_shims();
-import { existsSync as existsSync6, mkdirSync, readFileSync as readFileSync4, statSync, writeFileSync as writeFileSync3 } from "fs";
-import { dirname, join as join7, relative, sep } from "path";
+import { existsSync as existsSync6, mkdirSync, readFileSync as readFileSync4, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { dirname, join as join8, relative, sep } from "path";
 
 // src/env-files.ts
 init_esm_shims();
@@ -3804,7 +3804,8 @@ var LINES = {
   newInRelease: "wrote (new in this release)",
   refreshed: "refreshed",
   sameAsHarness: "kept \u2014 already the same as the harness version (left yours in place)",
-  hadFile: "had a file with this name \u2014 saved as <file>.backup-<time>",
+  // 비켜 둔 설치자 파일은 하네스가 그 자리를 떠날 때(uninstall · 회수) 되돌린다(`displaced` · #782) — 그 약속을 같은 줄에
+  hadFile: "had a file with this name \u2014 saved as <file>.backup-<time> \u2014 yours, put back on uninstall",
   noChecksum: "no checksum on record \u2014 saved a copy once",
   edited: "you edited it \u2014 saved as <file>.backup-<time>",
   removed: "removed",
@@ -3817,6 +3818,9 @@ var LINES = {
   scaffoldKept: "kept \u2014 already there (yours)",
   leftForYou: "left for you (yours now)"
 };
+function withBackup(line, backup) {
+  return line.replace("<file>.backup-<time>", backup);
+}
 function unreadable(adapter, op) {
   const what = op === "write" ? "harness part not added" : "harness part not removed";
   return `could not read it (${ADAPTERS[adapter].unreadable}) \u2014 ${what}`;
@@ -3935,7 +3939,8 @@ var PRIOR_MCP_SERVERS = [
     // #766 — `@supabase/mcp-server` 는 npm 에 없는 이름이라(404) 서버가 뜬 적이 없다
     name: "supabase",
     value: { type: "stdio", command: "npx", args: ["-y", "@supabase/mcp-server"] },
-    updated: "now Supabase's remote server \u2014 sign in on first use, see NEXT"
+    updated: "now Supabase's remote server \u2014 sign in on first use, see NEXT",
+    dead: `runs @supabase/mcp-server, which is not on npm \u2014 this server never started. To use Supabase's official remote server, set it to { "type": "http", "url": "https://mcp.supabase.com/mcp" } (signs in on first use)`
   },
   {
     name: "chrome-devtools",
@@ -4116,7 +4121,7 @@ function recordedMcpAssetIds(log) {
 // src/recorded.ts
 init_esm_shims();
 import { existsSync as existsSync5 } from "fs";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 
 // src/cli-ownership.ts
 init_esm_shims();
@@ -4171,6 +4176,42 @@ function removableFor(cli, remaining) {
   return { exclusive, sharedNowUnowned };
 }
 
+// src/foreign-slot.ts
+init_esm_shims();
+import { lstatSync, realpathSync, statSync } from "fs";
+import { join as join6 } from "path";
+var SKILL_SLOT = /^((?:\.claude|\.agents)\/skills\/[^/]+)(?:\/|$)/;
+function occupiedByNonDirectory(path) {
+  const stat = lstatSync(path, { throwIfNoEntry: false });
+  return stat !== void 0 && !stat.isDirectory();
+}
+function linksToProjectSharedSkill(projectDir, id) {
+  const slot = join6(projectDir, ".claude/skills", id);
+  if (lstatSync(slot, { throwIfNoEntry: false })?.isSymbolicLink() !== true) return false;
+  try {
+    const real = realpathSync(slot);
+    return real === join6(realpathSync(projectDir), ".agents/skills", id) && statSync(real).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function foreignOwnedTarget(projectDir, rel) {
+  const slot = SKILL_SLOT.exec(rel)?.[1];
+  if (slot === void 0) return null;
+  if (occupiedByNonDirectory(join6(projectDir, slot))) return slot;
+  if (rel !== slot) {
+    const parts = rel.slice(slot.length + 1).split("/");
+    let cursor = slot;
+    for (const part of parts.slice(0, -1)) {
+      cursor = `${cursor}/${part}`;
+      if (occupiedByNonDirectory(join6(projectDir, cursor))) return cursor;
+    }
+    const leaf = lstatSync(join6(projectDir, rel), { throwIfNoEntry: false });
+    if (leaf !== void 0 && !leaf.isFile()) return rel;
+  }
+  return null;
+}
+
 // src/recorded.ts
 var CLAUDE_DIR = ".claude/";
 var ADVISORY_PATHS = [".env.example", ".github/workflows/", "skills-lock.json"];
@@ -4190,6 +4231,12 @@ function ownersOf(path) {
     )
   );
 }
+function usersOf(path, projectDir) {
+  const owners = ownersOf(path);
+  const id = /^\.agents\/skills\/([^/]+)\//.exec(path)?.[1];
+  const linked = id !== void 0 && linksToProjectSharedSkill(projectDir, id);
+  return linked && !owners.includes("claude") ? [...owners, "claude"] : owners;
+}
 function bundlePath(path) {
   return path.startsWith(".agents/skills/") ? `${SKILLS_DIR}${path.slice(".agents/skills/".length)}` : path;
 }
@@ -4202,9 +4249,9 @@ function recordedTrackTargets(log) {
     selectedInternalSkills: INTERNAL_BUNDLED_SKILL_IDS
   };
   const entries = buildManifest(spec).filter((e2) => e2.applies(spec));
-  const templates = join6(resolveBundleRoot(), "templates");
+  const templates = join7(resolveBundleRoot(), "templates");
   return (path) => entries.some(
-    (e2) => e2.type === "dir" ? path.startsWith(`${e2.target}/`) && existsSync5(join6(templates, e2.source, path.slice(e2.target.length + 1))) : e2.target === path
+    (e2) => e2.type === "dir" ? path.startsWith(`${e2.target}/`) && existsSync5(join7(templates, e2.source, path.slice(e2.target.length + 1))) : e2.target === path
   );
 }
 function recordedTrackSpots(log) {
@@ -4212,13 +4259,13 @@ function recordedTrackSpots(log) {
     tracks: log.spec.tracks.filter(isTrack),
     selectedInternalSkills: INTERNAL_BUNDLED_SKILL_IDS
   };
-  const templates = join6(resolveBundleRoot(), "templates");
+  const templates = join7(resolveBundleRoot(), "templates");
   const out = [];
   for (const e2 of buildManifest(spec)) {
     if (!e2.applies(spec) || !e2.target.startsWith(CLAUDE_DIR)) continue;
     if (e2.type === "file") out.push(e2.target);
     else
-      for (const rel of listFilesRecursive(join6(templates, e2.source)))
+      for (const rel of listFilesRecursive(join7(templates, e2.source)))
         out.push(`${e2.target}/${rel}`);
   }
   for (const p2 of RETIRED_PATHS) out.push(`${CLAUDE_DIR}${p2}`);
@@ -4297,7 +4344,6 @@ function isScaffoldPath(path) {
 // src/install-writes.ts
 var CLAUDE_DIR2 = ".claude/";
 var SKILLS_DIR2 = ".claude/skills/";
-var BACKUP_PLACEHOLDER = "<file>.backup-<time>";
 function createInstallWriter(args) {
   const { projectDir, previousLog, excluded } = args;
   const now = args.now ?? /* @__PURE__ */ new Date();
@@ -4322,16 +4368,17 @@ function createInstallWriter(args) {
     else external.set(path, sha256);
   }
   function harness(path, from, opts = {}) {
-    const abs = join7(projectDir, path);
+    const abs = join8(projectDir, path);
     if (outside.skip(abs)) return null;
     const next = "source" in from ? readFileSync4(from.source, "utf8") : from.content;
     const disk = existsSync6(abs) ? readFileSync4(abs, "utf8") : null;
     const rec = recorded(previousLog, path, opts);
     const diskSha = rec.state === "no-sha" && disk !== null ? hashContent(disk) : null;
+    const judgedRec = diskSha !== null && isLegacyHarnessFile(path, diskSha) ? { state: "sha", sha256: diskSha } : rec;
     const j4 = judge({
       op: "write",
       kind: "harness",
-      rec: diskSha !== null && isLegacyHarnessFile(path, diskSha) ? { state: "sha", sha256: diskSha } : rec,
+      rec: judgedRec,
       disk,
       next,
       ...args.run === void 0 ? {} : { run: args.run }
@@ -4376,11 +4423,19 @@ function createInstallWriter(args) {
       default:
         throw new Error(`install: '${j4.record}' is not a write record (${path})`);
     }
-    const line = backup === void 0 ? j4.line : j4.line.replace(BACKUP_PLACEHOLDER, backup);
+    const line = backup === void 0 ? j4.line : withBackup(j4.line, backup);
     const backupPair = backup === void 0 || backupAbs === void 0 ? {} : { backup, backupAbs };
-    writes.push({ path, verdict: j4.verdict, record: j4.record, line, ...backupPair });
+    const state = judgedRec.state;
+    writes.push({
+      path,
+      verdict: j4.verdict,
+      record: j4.record,
+      recorded: state,
+      line,
+      ...backupPair
+    });
     if (j4.line === "" || j4.verdict === "create" || j4.verdict === "overwrite") return null;
-    const out = { path, verdict: j4.verdict, line, ...backupPair };
+    const out = { path, verdict: j4.verdict, recorded: state, line, ...backupPair };
     judged.push(out);
     return out;
   }
@@ -4388,7 +4443,7 @@ function createInstallWriter(args) {
     const file = SHARED_FILES[path];
     if (file === void 0) throw new Error(`install: ${path} is not a shared file`);
     const adapter = ADAPTERS[file.adapter];
-    const abs = join7(projectDir, path);
+    const abs = join8(projectDir, path);
     const disk = existsSync6(abs) ? readFileSync4(abs, "utf8") : null;
     const own = new Map(
       (previousLog?.portions ?? []).filter((p2) => p2.path === path).map((p2) => [p2.key, p2.sha256])
@@ -4570,9 +4625,9 @@ function retiredClaims(previous, projectDir, kept) {
   const out = [];
   for (const p2 of RETIRED_PATHS) {
     if (have.has(p2) || recorded(previous, `${CLAUDE_DIR2}${p2}`).state === "none") continue;
-    const abs = join7(projectDir, CLAUDE_DIR2, p2);
+    const abs = join8(projectDir, CLAUDE_DIR2, p2);
     try {
-      if (!statSync(abs).isFile()) continue;
+      if (!statSync2(abs).isFile()) continue;
       out.push({ path: p2, sha256: hashContent(readFileSync4(abs, "utf8")) });
     } catch {
     }
@@ -4677,7 +4732,7 @@ function legacySettingsSeed(text, render, projectDir, opts = {}) {
   } catch {
     return seed;
   }
-  const claudeDir = join7(projectDir, ".claude");
+  const claudeDir = join8(projectDir, ".claude");
   const candidates = new Set([...render.keys()].filter((k2) => k2.startsWith("hooks.")));
   const legacyLines = /* @__PURE__ */ new Set();
   const hooks = isObject2(root) && isObject2(root.hooks) ? root.hooks : {};
@@ -4794,12 +4849,12 @@ function legacyGitignoreSeed(text, render, previous) {
 // src/installer.ts
 init_esm_shims();
 import { chmodSync as chmodSync3, existsSync as existsSync22, readdirSync as readdirSync5, readFileSync as readFileSync23, writeFileSync as writeFileSync8 } from "fs";
-import { basename as basename4, join as join31, relative as relative5, resolve, sep as sep6 } from "path";
+import { basename as basename4, join as join31, relative as relative6, resolve, sep as sep7 } from "path";
 
 // src/anchor-seed.ts
 init_esm_shims();
 import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 
 // src/agents-md-render.ts
 init_esm_shims();
@@ -4906,7 +4961,7 @@ function compose(body, into) {
 ${trimmed.join("\n")}`;
 }
 function seedAgentsMdProjectContext(projectDir) {
-  const root = readIfExists(join8(projectDir, "CLAUDE.md"));
+  const root = readIfExists(join9(projectDir, "CLAUDE.md"));
   if (root === null) return null;
   const withoutImport = stripHarnessImport(root) ?? root;
   const body = dropHarnessQuoteBlocks(dropTitle(withoutImport.split("\n")));
@@ -4914,9 +4969,9 @@ function seedAgentsMdProjectContext(projectDir) {
   return compose(body, "agents-md");
 }
 function seedRootClaudeProjectContext(projectDir, harnessRoot) {
-  const agents = readIfExists(join8(projectDir, "AGENTS.md"));
+  const agents = readIfExists(join9(projectDir, "AGENTS.md"));
   if (agents === null) return null;
-  const template = readIfExists(join8(harnessRoot, AGENTS_MD_TEMPLATE));
+  const template = readIfExists(join9(harnessRoot, AGENTS_MD_TEMPLATE));
   if (template === null) return null;
   const installer = projectContextInstallerLines({ existing: agents, template });
   if (installer === null) return null;
@@ -4928,7 +4983,7 @@ function seedRootClaudeProjectContext(projectDir, harnessRoot) {
 // src/ci-scaffold.ts
 init_esm_shims();
 import { existsSync as existsSync8 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 var PYTHON_TRACKS = "data|csr-fastapi|full";
 var VARIANTS = [
   {
@@ -4952,12 +5007,12 @@ function installCiScaffold(ctx) {
   for (const v2 of VARIANTS) {
     if (!v2.applies(ctx.tracks)) continue;
     const relTarget = `.github/workflows/${v2.target}`;
-    const target = join9(ctx.projectDir, relTarget);
+    const target = join10(ctx.projectDir, relTarget);
     if (existsSync8(target)) {
       report.skippedExisting.push(relTarget);
       continue;
     }
-    copyFile(join9(ctx.harnessRoot, "templates/github-workflows", v2.source), target);
+    copyFile(join10(ctx.harnessRoot, "templates/github-workflows", v2.source), target);
     report.written.push(relTarget);
   }
   return report;
@@ -4975,7 +5030,7 @@ import { basename, join as join14 } from "path";
 
 // src/agents-skill-targets.ts
 init_esm_shims();
-import { join as join10, sep as sep2 } from "path";
+import { join as join11, sep as sep2 } from "path";
 function bundledSkillTargets(projectDir, log = readInstallLog(projectDir)) {
   if (log === null) return [];
   const tracks = log.spec.tracks.filter(
@@ -4989,7 +5044,7 @@ function bundledSkillTargets(projectDir, log = readInstallLog(projectDir)) {
 }
 function allowSkillCreation(writer, projectDir, ids) {
   if (ids.length === 0) return writer;
-  const roots = ids.map((id) => `${join10(projectDir, ".agents", "skills", id)}${sep2}`);
+  const roots = ids.map((id) => `${join11(projectDir, ".agents", "skills", id)}${sep2}`);
   return {
     write(absPath, content, opts) {
       const inTarget = roots.some((root) => absPath.startsWith(root));
@@ -5012,48 +5067,11 @@ function agentsSkillSlot(params) {
 init_esm_shims();
 import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
 import { dirname as dirname2, relative as relative2, sep as sep3 } from "path";
-
-// src/foreign-slot.ts
-init_esm_shims();
-import { lstatSync, realpathSync, statSync as statSync2 } from "fs";
-import { join as join11 } from "path";
-var SKILL_SLOT = /^((?:\.claude|\.agents)\/skills\/[^/]+)(?:\/|$)/;
-function occupiedByNonDirectory(path) {
-  const stat = lstatSync(path, { throwIfNoEntry: false });
-  return stat !== void 0 && !stat.isDirectory();
-}
-function linksToProjectSharedSkill(projectDir, id) {
-  const slot = join11(projectDir, ".claude/skills", id);
-  if (lstatSync(slot, { throwIfNoEntry: false })?.isSymbolicLink() !== true) return false;
-  try {
-    const real = realpathSync(slot);
-    return real === join11(realpathSync(projectDir), ".agents/skills", id) && statSync2(real).isDirectory();
-  } catch {
-    return false;
-  }
-}
-function foreignOwnedTarget(projectDir, rel) {
-  const slot = SKILL_SLOT.exec(rel)?.[1];
-  if (slot === void 0) return null;
-  if (occupiedByNonDirectory(join11(projectDir, slot))) return slot;
-  if (rel !== slot) {
-    const parts = rel.slice(slot.length + 1).split("/");
-    let cursor = slot;
-    for (const part of parts.slice(0, -1)) {
-      cursor = `${cursor}/${part}`;
-      if (occupiedByNonDirectory(join11(projectDir, cursor))) return cursor;
-    }
-    const leaf = lstatSync(join11(projectDir, rel), { throwIfNoEntry: false });
-    if (leaf !== void 0 && !leaf.isFile()) return rel;
-  }
-  return null;
-}
-
-// src/owned-write.ts
 function createOwnedWriter(projectDir, baseline, options = {}) {
   const { now = /* @__PURE__ */ new Date(), refreshOnly = false, journal, owned = () => false } = options;
   const written = /* @__PURE__ */ new Map();
   const backedUp = [];
+  const judged = [];
   const backupPaths = [];
   const foreignOwned = [];
   const restored = [];
@@ -5078,14 +5096,30 @@ function createOwnedWriter(projectDir, baseline, options = {}) {
       const disk = existsSync9(absPath) ? readFileSync6(absPath, "utf8") : null;
       if (disk === null && refreshOnly && !opts?.createInRefresh && rec.state !== "sha")
         return false;
-      const { verdict, record } = judge({ op: "write", kind: "harness", rec, disk, next: content });
+      const { verdict, record, line } = judge({
+        op: "write",
+        kind: "harness",
+        rec,
+        disk,
+        next: content
+      });
       let backupRel = null;
       if (verdict === "backup+overwrite" || verdict === "overwrite" && opts?.backupFirst === true) {
         const backup = backupFile(absPath, now);
         backupPaths.push(backup);
         journal?.backup(backup);
         backupRel = relative2(projectDir, backup).split(sep3).join("/");
-        if (verdict === "backup+overwrite" && rec.state !== "none") backedUp.push(rel);
+        if (verdict === "backup+overwrite") {
+          if (rec.state !== "none") backedUp.push(rel);
+          judged.push({
+            path: rel,
+            verdict,
+            recorded: rec.state,
+            line: withBackup(line, backupRel),
+            backup: backupRel,
+            backupAbs: backup
+          });
+        }
       }
       if (record === "displaced" || record === "displaced+sha") {
         displace({ path: rel, change: "displaced", notes: backupRel === null ? [] : [backupRel] });
@@ -5111,6 +5145,7 @@ function createOwnedWriter(projectDir, baseline, options = {}) {
         outside: outside.list(),
         files: [...written].map(([path, sha256]) => ({ path, sha256 })),
         backedUp: [...backedUp],
+        judged: [...judged],
         backupPaths: [...backupPaths],
         updated,
         restored: [...restored],
@@ -6240,6 +6275,7 @@ function runCliTransforms(params) {
   const externalFiles = [];
   const externalBackups = [];
   const externalBackedUp = [];
+  const externalJudged = [];
   const externalForeignOwned = [];
   const displaced = /* @__PURE__ */ new Map();
   let externalOutside = [];
@@ -6261,6 +6297,7 @@ function runCliTransforms(params) {
     }
     externalBackups.push(...report.ownership.backupPaths);
     externalBackedUp.push(...report.ownership.backedUp);
+    externalJudged.push(...report.ownership.judged ?? []);
     for (const f of report.ownership.displaced ?? [])
       if (!displaced.has(f.path)) displaced.set(f.path, f);
     for (const f of report.ownership.foreignOwned) {
@@ -6368,6 +6405,7 @@ function runCliTransforms(params) {
     externalBackups,
     externalUpdated,
     externalBackedUp,
+    externalJudged,
     displaced: [...displaced.values()],
     externalForeignOwned,
     externalOutside,
@@ -6690,14 +6728,15 @@ function refreshExternalSkills(projectDir, deps = {}) {
     }
     throw e2;
   }
-  const { report, displaced } = settle(ran);
+  const { report, displaced, judged } = settle(ran);
   recordRefreshedFiles(projectDir, log, report, displaced, deps.writeLog ?? writeInstallLog);
   return {
     attempted: report.attempted.length,
     refreshed: report.succeeded,
     failed: report.attempted.filter((r) => !r.ok).map((r) => ({ id: r.asset.id, message: r.message ?? "failed" })),
     notInCatalog,
-    unknown: false
+    unknown: false,
+    judged
   };
 }
 function holdSkillSlots(projectDir, hold) {
@@ -6730,7 +6769,11 @@ function holdSkillSlots(projectDir, hold) {
       hold.clis,
       { log: hold.log, scope: hold.scope }
     );
-    const out = { backups: [], displaced: [] };
+    const out = {
+      backups: [],
+      displaced: [],
+      judged: []
+    };
     const back = /* @__PURE__ */ new Set();
     const failed = [];
     for (const f of moved) {
@@ -6743,6 +6786,16 @@ function holdSkillSlots(projectDir, hold) {
         }
         out.backups.push(r.backup);
         if (r.displaced !== null) out.displaced.push(r.displaced);
+        const backup = toProjectRel(projectDir, r.backup);
+        const line = !f.recorded ? LINES.hadFile : r.gone ? LINES.editedRemoved : LINES.edited;
+        out.judged.push({
+          path: f.rel,
+          verdict: r.gone ? "backup+remove" : "backup+overwrite",
+          recorded: f.recorded ? "sha" : "none",
+          line: withBackup(line, backup),
+          backup,
+          backupAbs: r.backup
+        });
       } catch (e2) {
         failed.push(`${f.rel} (${e2 instanceof Error ? e2.message : String(e2)})`);
       }
@@ -6820,9 +6873,10 @@ function settleAside(projectDir, f, restore) {
   }
   const backup = backupFromCopy(f.abs, f.aside);
   rmSync3(f.aside, { force: true });
-  if (f.recorded || now === null) return { backup, displaced: null };
+  if (f.recorded || now === null) return { backup, gone: now === null, displaced: null };
   return {
     backup,
+    gone: false,
     displaced: { path: f.rel, change: "displaced", notes: [toProjectRel(projectDir, backup)] }
   };
 }
@@ -7074,6 +7128,8 @@ function refreshLinkedSkillBodies(params) {
     notOurs: ids.filter((id) => !baseline.has(bodyKey(id))),
     files: result.files,
     backupPaths: result.backupPaths,
+    backedUp: result.backedUp,
+    judged: result.judged ?? [],
     displaced: result.displaced ?? [],
     foreignOwned: result.foreignOwned,
     outside: result.outside ?? []
@@ -7239,7 +7295,7 @@ import {
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync7
 } from "fs";
-import { basename as basename3, dirname as dirname7, join as join30 } from "path";
+import { basename as basename3, dirname as dirname7, join as join30, relative as relative5, sep as sep6 } from "path";
 var LEGACY_ANCHOR_FILE2 = ".claude/CLAUDE.md";
 function buildUpdateSpec(projectDir, tracks, only) {
   const log = readInstallLog(projectDir);
@@ -7301,11 +7357,12 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
   const logAtStart = readInstallLog(projectDir);
   const claudeManaged = logAtStart === null || installedClis(logAtStart).includes("claude");
   report.claudeUnrecorded = !claudeManaged && logAtStart !== null && existsSync21(claudeDir) ? recordClaudeCommand(logAtStart, installedTracks(projectDir)) : null;
-  const harness = logAtStart === null ? { displaced: [], restored: [], foreignOwned: [], outside: [] } : updateHarnessFiles({ projectDir, templatesDir, log: logAtStart, wants, outside, report });
+  const harness = logAtStart === null ? { displaced: [], restored: [], foreignOwned: [], outside: [], judged: [] } : updateHarnessFiles({ projectDir, templatesDir, log: logAtStart, wants, outside, report });
   const claudeDisplaced = harness.displaced;
+  const judged = [...harness.judged];
   const prunedRestored = harness.restored;
   if (existsSync21(claudeDir) && claudeManaged) {
-    if (wants("anchor")) syncHarnessAnchor(projectDir, templatesDir, report, outside);
+    if (wants("anchor")) syncHarnessAnchor(projectDir, templatesDir, report, outside, judged);
   }
   const harnessMcp = renderHarnessMcp(harnessRoot, {
     spec: { tracks: installedTracks(projectDir), options: DEFAULT_OPTIONS },
@@ -7339,9 +7396,16 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
   if (wants("hooks")) report.mcpAllowlistRetired = retireMcpAllowlist(projectDir);
   report.retiredAgents = staleAgentFiles(claudeDir);
   report.demotedAgents = demotedAgentFiles(claudeDir, installedTracks(projectDir));
-  const external = wants("external") ? refreshExternalCli(projectDir, harnessRoot, legacyDroppedKeys(logAtStart), harnessMcp) : {
+  const external = wants("external") ? refreshExternalCli(
+    projectDir,
+    harnessRoot,
+    legacyDroppedKeys(logAtStart),
+    harnessMcp,
+    report.skillsSkippedLinks.filter((id) => linksToProjectSharedSkill(projectDir, id))
+  ) : {
     externalUpdated: 0,
     externalBackedUp: [],
+    externalJudged: [],
     displaced: [],
     externalForeignOwned: [],
     externalOutside: [],
@@ -7452,10 +7516,17 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}, only) {
   const displacedSame = displacedAll.filter((f) => f.notes.length === 0).map((f) => f.path);
   if (displacedMoved.length > 0) report.displaced = displacedMoved;
   if (displacedSame.length > 0) report.displacedSame = displacedSame;
-  report.backups = collectRunBackups(projectDir, startedAt, backupsAtStart);
-  const onRecord = checksumOnRecord(logAtStart);
-  const firstContact = new Set(displacedMoved);
-  const noChecksum = report.backups.map((b2) => b2.path).filter((p2) => !onRecord(p2) && !firstContact.has(p2));
+  const deadMcp = claudeManaged ? deadMcpLeft(projectDir) : [];
+  if (deadMcp.length > 0) report.deadMcp = deadMcp;
+  judged.push(...external.externalJudged, ...skillRefresh.judged ?? []);
+  if (judged.length > 0) report.judged = judged;
+  const unmeasured = new Set(
+    judged.filter((j4) => j4.recorded === "no-sha" && j4.backup !== void 0).map((j4) => j4.path)
+  );
+  report.backups = collectRunBackups(projectDir, startedAt, backupsAtStart).map(
+    (b2) => existsSync21(join30(projectDir, b2.path)) ? b2 : { ...b2, removed: true }
+  );
+  const noChecksum = report.backups.map((b2) => b2.path).filter((p2) => unmeasured.has(p2));
   if (noChecksum.length > 0) report.noChecksum = noChecksum;
   writeBackupList(projectDir, report.backups, new Set(noChecksum));
   return report;
@@ -7533,19 +7604,16 @@ function reclaimOutOfTrackRecorded(projectDir, outside) {
   }
   return { reclaim: result, displaced };
 }
-function checksumOnRecord(log) {
-  if (log === null) return () => false;
-  const paths = /* @__PURE__ */ new Set([
-    ...(log.policyFiles ?? []).map((f) => `.claude/${f.path}`),
-    ...(log.skillFiles ?? []).map((f) => `.claude/skills/${f.path}`),
-    ...(log.externalFiles ?? []).map((f) => f.path),
-    ...log.assets.flatMap((a) => a.files ?? []).map((f) => f.path),
-    // #800 — 함께 쓰는 파일은 몫마다 sha 가 있다 — 그 백업은 설치자 편집이 확실하다
-    ...(log.portions ?? []).map((p2) => p2.path)
-  ]);
-  const anchor = log.templates.rootClaudeMd;
-  if (anchor !== void 0) paths.add(anchor.path);
-  return (path) => paths.has(path);
+function deadMcpLeft(projectDir) {
+  let servers;
+  try {
+    servers = JSON.parse(readFileSync22(join30(projectDir, ".mcp.json"), "utf8")).mcpServers;
+  } catch {
+    return [];
+  }
+  return PRIOR_MCP_SERVERS.flatMap(
+    (p2) => p2.dead !== void 0 && servers?.[p2.name] !== void 0 && jsonSha(servers[p2.name]) === jsonSha(toClaudeServer(p2.value)) ? [{ name: p2.name, note: p2.dead }] : []
+  );
 }
 function retiredFeaturesPart(projectDir, f) {
   if (f.path !== ".codex/config.toml") return {};
@@ -7739,6 +7807,7 @@ function updateHarnessTargets(projectDir, templatesDir, log, wants, report, fore
 }
 function updateHarnessFiles(args) {
   const { projectDir, templatesDir, log, wants, outside, report } = args;
+  const judged = [];
   const now = /* @__PURE__ */ new Date();
   const claude = installedClis(log).includes("claude");
   const claims = retiredClaims(log, projectDir, log.policyFiles ?? []);
@@ -7759,7 +7828,7 @@ function updateHarnessFiles(args) {
     if (!claude || !wants(dir === "hooks" ? "hooks" : "rules")) continue;
     const label = `.claude/${dir}`;
     report.updated[label] = 0;
-    const ctx = { prefix: dir, outside, recordOf };
+    const ctx = { prefix: dir, outside, recordOf, projectDir, judged };
     report.pruned[label] = pruneOrphans(
       join30(projectDir, label),
       join30(templatesDir, dir),
@@ -7776,7 +7845,8 @@ function updateHarnessFiles(args) {
     targets.refreshedSkills,
     outside,
     recordOf,
-    now
+    now,
+    judged
   );
   report.skillsPruned = skillPrune.pruned;
   report.skillsBackedUp.push(...skillPrune.backedUp);
@@ -7785,6 +7855,11 @@ function updateHarnessFiles(args) {
     write: true
   });
   const ledger = writer.ledger();
+  judged.unshift(
+    ...ledger.writes.flatMap(
+      ({ path, verdict, recorded: recorded2, line, backup, backupAbs }) => backup === void 0 || backupAbs === void 0 ? [] : [{ path, verdict, recorded: recorded2, line, backup, backupAbs }]
+    )
+  );
   recordHarnessWrites(projectDir, ledger, {
     claims,
     prunedPolicy,
@@ -7815,10 +7890,25 @@ function updateHarnessFiles(args) {
     displaced: ledger.rootFiles.filter((f) => f.change === "displaced"),
     restored,
     foreignOwned,
-    outside: ledger.outside
+    outside: ledger.outside,
+    judged
+  };
+}
+function removedRow(projectDir, path, why, judged, backupAbs) {
+  const { line, recorded: recorded2 } = judged;
+  if (backupAbs === null) return { path, verdict: "remove", recorded: recorded2, line: `${why} \u2014 ${line}` };
+  const backup = relative5(projectDir, backupAbs).split(sep6).join("/");
+  return {
+    path,
+    verdict: "backup+remove",
+    recorded: recorded2,
+    line: `${why} \u2014 ${withBackup(line, backup)}`,
+    backup,
+    backupAbs
   };
 }
-function pruneSkillExtras(projectDir, templatesDir, ids, outside, recordOf, now) {
+var NOT_RECORDED_REMOVED = "not on the install record \u2014 saved as <file>.backup-<time>, removed from live";
+function pruneSkillExtras(projectDir, templatesDir, ids, outside, recordOf, now, judged) {
   const pruned = [];
   const backedUp = [];
   for (const id of ids) {
@@ -7829,11 +7919,18 @@ function pruneSkillExtras(projectDir, templatesDir, ids, outside, recordOf, now)
       if (foreignOwnedTarget(projectDir, `.claude/skills/${id}/${rel}`) !== null) continue;
       const targetFile = join30(targetSkill, rel);
       if (outside.skip(targetFile)) continue;
-      const rec = recordOf(`.claude/skills/${id}/${rel}`);
-      if (rec.state !== "sha" || hashContent(readFileSync22(targetFile, "utf8")) !== rec.sha256) {
-        backupFile(targetFile, now);
+      const path = `.claude/skills/${id}/${rel}`;
+      const rec = recordOf(path);
+      const disk = rec.state === "sha" ? readFileSync22(targetFile, "utf8") : "";
+      const line = rec.state === "none" ? NOT_RECORDED_REMOVED : judge({ op: "remove", kind: "harness", rec, disk, next: null }).line;
+      let backupAbs = null;
+      if (rec.state !== "sha" || hashContent(disk) !== rec.sha256) {
+        backupAbs = backupFile(targetFile, now);
         backedUp.push(`${id}/${rel}`);
       }
+      judged.push(
+        removedRow(projectDir, path, "not in bundle", { line, recorded: rec.state }, backupAbs)
+      );
       unlinkSync2(targetFile);
       pruned.push(`${id}/${rel}`);
       for (let d2 = dirname7(targetFile); d2 !== targetSkill && readdirSync4(d2).length === 0; d2 = dirname7(d2))
@@ -7908,7 +8005,7 @@ function writeBackupList(projectDir, backups, noChecksum = /* @__PURE__ */ new S
       `${JSON.stringify(
         {
           updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-          note: "update \uAC00 \uB0A8\uAE34 \uBC31\uC5C5 \uC30D. \uC6D0\uBCF8(path)\uC740 \uCD5C\uC2E0 \uBC88\uB4E4\uD310, \uBC31\uC5C5(backup)\uC740 \uBC14\uAFB8\uAE30 \uC804 \uD310. noChecksum \uC774 \uC5C6\uB294 \uC30D\uC740 \uAE30\uB85D\uACFC \uB2EC\uB77C\uC9C4 \uD30C\uC77C = \uB2F9\uC2E0\uC758 \uD3B8\uC9D1\uBD84\uC774\uB2E4 \u2014 \uC0C8 \uD310\uC5D0 \uB2E4\uC2DC \uC5B9\uC73C\uB824\uBA74 \uB450 \uD30C\uC77C\uC758 diff \uB97C \uBCF4\uB77C. noChecksum: true \uC778 \uC30D\uC740 \uC61B \uD310\uC774 \uCCB4\uD06C\uC12C\uC744 \uAE30\uB85D\uD558\uC9C0 \uC54A\uC544 \uBE44\uAD50 \uC5C6\uC774 \uD55C \uBC88 \uBC31\uC5C5\uD55C \uAC83 \u2014 \uB300\uAC1C \uB9B4\uB9AC\uC988 \uC0AC\uC774 \uD15C\uD50C\uB9BF \uBCC0\uACBD\uBD84\uC774\uB77C \uB2F9\uC2E0\uC758 \uD3B8\uC9D1\uC774 \uC544\uB2D0 \uC218 \uC788\uB2E4.",
+          note: "update \uAC00 \uB0A8\uAE34 \uBC31\uC5C5 \uC30D. \uC6D0\uBCF8(path)\uC740 \uCD5C\uC2E0 \uBC88\uB4E4\uD310, \uBC31\uC5C5(backup)\uC740 \uBC14\uAFB8\uAE30 \uC804 \uD310. noChecksum \uC774 \uC5C6\uB294 \uC30D\uC740 \uAE30\uB85D\uACFC \uB2EC\uB77C\uC9C4 \uD30C\uC77C = \uB2F9\uC2E0\uC758 \uD3B8\uC9D1\uBD84\uC774\uB2E4 \u2014 \uC0C8 \uD310\uC5D0 \uB2E4\uC2DC \uC5B9\uC73C\uB824\uBA74 \uB450 \uD30C\uC77C\uC758 diff \uB97C \uBCF4\uB77C. noChecksum: true \uC778 \uC30D\uC740 \uC61B \uD310\uC774 \uCCB4\uD06C\uC12C\uC744 \uAE30\uB85D\uD558\uC9C0 \uC54A\uC544 \uBE44\uAD50 \uC5C6\uC774 \uD55C \uBC88 \uBC31\uC5C5\uD55C \uAC83 \u2014 \uB300\uAC1C \uB9B4\uB9AC\uC988 \uC0AC\uC774 \uD15C\uD50C\uB9BF \uBCC0\uACBD\uBD84\uC774\uB77C \uB2F9\uC2E0\uC758 \uD3B8\uC9D1\uC774 \uC544\uB2D0 \uC218 \uC788\uB2E4. removed: true \uC778 \uC30D\uC740 \uADF8 \uD30C\uC77C\uC744 \uC9C0\uC6B0\uAE30 \uC804\uC5D0 \uB0A8\uAE34 \uAC83(\uC740\uD1F4\uD55C \uD558\uB124\uC2A4 \uD30C\uC77C \xB7 \uBC88\uB4E4\uC5D0 \uC5C6\uB294 \uC2A4\uD0AC \uD30C\uC77C \uB4F1) \u2014 \uC6D0\uBCF8 \uC790\uB9AC\uC5D0 \uC0C8 \uD310\uC774 \uC5C6\uB2E4. \uB2F9\uC2E0 \uD30C\uC77C\uC774\uC5C8\uB2E4\uBA74 \uBC31\uC5C5\uC744 \uC6D0\uB798 \uC774\uB984\uC73C\uB85C \uB418\uB3CC\uB9AC\uBA74 \uB41C\uB2E4.",
           backups: backups.map((b2) => noChecksum.has(b2.path) ? { ...b2, noChecksum: true } : b2)
         },
         null,
@@ -7927,7 +8024,7 @@ function trackOnlyFileAssets(tracks) {
     (e2) => e2.type === "file" && e2.applies(optedOut) && e2.applies(optedIn)
   );
 }
-function syncHarnessAnchor(projectDir, templatesDir, report, outside, now = /* @__PURE__ */ new Date()) {
+function syncHarnessAnchor(projectDir, templatesDir, report, outside, judged, now = /* @__PURE__ */ new Date()) {
   if (existsSync21(join30(projectDir, LEGACY_ANCHOR_FILE2))) {
     report.legacyAnchor = LEGACY_ANCHOR_FILE2;
   }
@@ -7942,8 +8039,20 @@ function syncHarnessAnchor(projectDir, templatesDir, report, outside, now = /* @
       const recorded2 = readInstallLog(projectDir)?.templates.rootClaudeMd;
       const owned = recorded2?.path === HARNESS_ANCHOR_FILE && hashContent(current) === recorded2.sha256;
       if (!owned) {
-        backupFile(anchor, now);
+        const backup = backupFile(anchor, now);
         report.anchorBackedUp = true;
+        const rel = relative5(projectDir, backup).split(sep6).join("/");
+        const rec = recorded2?.path === HARNESS_ANCHOR_FILE ? { state: "sha", sha256: recorded2.sha256 } : { state: "no-sha" };
+        const next = readFileSync22(templateMd, "utf8");
+        const { line } = judge({ op: "write", kind: "harness", rec, disk: current, next });
+        judged.push({
+          path: HARNESS_ANCHOR_FILE,
+          verdict: "backup+overwrite",
+          recorded: rec.state,
+          line: withBackup(line, rel),
+          backup: rel,
+          backupAbs: backup
+        });
       }
       copyFileSync(templateMd, anchor);
       report.claudeMdUpdated = true;
@@ -8107,7 +8216,7 @@ function changedRemoteMcp(writes) {
   const changed = /* @__PURE__ */ new Set([...mcp.added, ...mcp.replaced ?? []]);
   return (mcp.remote ?? []).filter((r) => changed.has(r.name));
 }
-function refreshExternalCli(projectDir, harnessRoot, droppedKeys, harnessMcp) {
+function refreshExternalCli(projectDir, harnessRoot, droppedKeys, harnessMcp, linkedIds) {
   const log = readInstallLog(projectDir);
   const presentBefore = sharedSkillIdsOnDisk(projectDir);
   const rulesBefore = /* @__PURE__ */ new Set();
@@ -8139,11 +8248,23 @@ function refreshExternalCli(projectDir, harnessRoot, droppedKeys, harnessMcp) {
     // 앞 단계(하네스 파일 쓰기)가 헬퍼만 든 `externalFiles` 를 적어도 같은 답이다 — 헬퍼는 외부 자리로 세지 않는다(B-2)
     owned: recordedOwner(log)
   });
+  const linked = refreshLinkedSkillBodies({
+    harnessRoot,
+    projectDir,
+    ids: linkedIds.filter(
+      (id) => !result.externalFiles.some((f) => f.path === `${SHARED_SKILLS_DIR}/${id}/SKILL.md`)
+    ),
+    baseline: new Map(
+      mergeExternalFiles(log?.externalFiles, result.externalFiles).map((f) => [f.path, f.sha256])
+    )
+  });
+  const written = [...result.externalFiles, ...linked.files];
+  const displaced = [...result.displaced ?? [], ...linked.displaced];
   const anchorPath = result.anchorRetired?.action === "removed" ? result.anchorRetired.path : null;
   const anchorDisplaced = log === null || anchorPath === null ? [] : restoreDisplaced(log, projectDir, { has: (p2) => p2 === anchorPath, write: true });
   if (log) {
     const retiredPath = result.anchorRetired?.forget === true ? result.anchorRetired.path : null;
-    const merged = mergeExternalFiles(log.externalFiles, result.externalFiles).filter(
+    const merged = mergeExternalFiles(log.externalFiles, written).filter(
       (f) => f.path !== retiredPath
     );
     const next = retiredPath === null ? { ...log } : { ...log, spec: { ...log.spec, clis: [...installedClis(log)] } };
@@ -8157,7 +8278,7 @@ function refreshExternalCli(projectDir, harnessRoot, droppedKeys, harnessMcp) {
     if (portions.length > 0) next.portions = portions;
     else delete next.portions;
     const created = result.sharedFiles.filter((f) => f.createdAsRoot === true).map((f) => ({ path: f.path, change: "created", notes: ["\uD558\uB124\uC2A4 \uBAAB\uB9CC(\uBE14\uB85D)"] }));
-    const roots = [...created, ...withoutLostBackups(log.rootFiles, result.displaced ?? [])];
+    const roots = [...created, ...withoutLostBackups(log.rootFiles, displaced)];
     if (roots.length > 0) next.rootFiles = mergeRootFiles(log.rootFiles, roots);
     if (anchorDisplaced.some((d2) => d2.forget))
       next.rootFiles = withoutRestored(next.rootFiles, anchorDisplaced);
@@ -8216,11 +8337,12 @@ function refreshExternalCli(projectDir, harnessRoot, droppedKeys, harnessMcp) {
   const dropped = new Set(droppedKeys);
   return {
     externalUpdated: result.externalUpdated,
-    externalBackedUp: result.externalBackedUp,
-    displaced: result.displaced ?? [],
-    externalForeignOwned: result.externalForeignOwned,
-    externalOutside: result.externalOutside,
-    written: result.externalFiles.map((f) => f.path),
+    externalBackedUp: [...result.externalBackedUp, ...linked.backedUp],
+    externalJudged: [...result.externalJudged, ...linked.judged],
+    displaced,
+    externalForeignOwned: [...result.externalForeignOwned, ...linked.foreignOwned],
+    externalOutside: [...result.externalOutside, ...linked.outside],
+    written: written.map((f) => f.path),
     skillsInstalled,
     skillsRestored,
     rulesRestored,
@@ -8275,14 +8397,24 @@ function pruneOrphans(target, source, ext, ctx, now) {
   for (const file of readdirSync4(target)) {
     if (!file.endsWith(ext) || existsSync21(join30(source, file))) continue;
     const targetFile = join30(target, file);
-    const rec = ctx.recordOf(`.claude/${ctx.prefix}/${file}`);
+    const path = `.claude/${ctx.prefix}/${file}`;
+    const rec = ctx.recordOf(path);
     try {
       const disk = readFileSync22(targetFile, "utf8");
-      const { verdict } = judge({ op: "remove", kind: "harness", rec, disk, next: null });
+      const { verdict, line } = judge({ op: "remove", kind: "harness", rec, disk, next: null });
       if (verdict === "leave" || ctx.outside.skip(targetFile)) continue;
-      if (verdict === "backup+remove") backupFile(targetFile, now);
+      const backupAbs = verdict === "backup+remove" ? backupFile(targetFile, now) : null;
       unlinkSync2(targetFile);
       removed.push(file);
+      ctx.judged.push(
+        removedRow(
+          ctx.projectDir,
+          path,
+          "retired from the harness",
+          { line, recorded: rec.state },
+          backupAbs
+        )
+      );
     } catch {
     }
   }
@@ -8346,7 +8478,7 @@ function runInstall(ctx) {
         JSON.parse(readFileSync23(settingsPath, "utf8"));
       } catch {
         throw new Error(
-          `${relative5(process.cwd(), settingsPath)} is not valid JSON \u2014 left untouched, so no hooks were wired. Fix or delete that file, then run the install again`
+          `${relative6(process.cwd(), settingsPath)} is not valid JSON \u2014 left untouched, so no hooks were wired. Fix or delete that file, then run the install again`
         );
       }
     }
@@ -8415,6 +8547,7 @@ function runInstallStages(ctx, args) {
     externalBackups,
     externalUpdated: _externalUpdated,
     externalBackedUp: _externalBackedUp,
+    externalJudged: _externalJudged,
     displaced: cliDisplaced = [],
     externalForeignOwned,
     externalOutside,
@@ -8967,7 +9100,7 @@ function recordInterruptedInstall(ctx, error, run) {
   const codexTrust = registeredTrust(journal.codexOptIn, ctx.projectDir);
   const written = writtenSoFar(ledger, cliFiles, rootFiles, stage.rootImportWritten);
   if (codexTrust) written.push(`${codexTrust.configPath} (Codex trust entry for this folder)`);
-  const projectRel = (abs) => relative5(ctx.projectDir, abs).split(sep6).join("/");
+  const projectRel = (abs) => relative6(ctx.projectDir, abs).split(sep7).join("/");
   const writtenSet = new Set(written);
   const backups = [...own.backups, ...journal.backups].map((abs) => {
     const original = projectRel(backupOriginal(abs) ?? abs);
@@ -9144,7 +9277,7 @@ function listHookFiles(hookDir) {
 init_esm_shims();
 import { homedir as homedir3 } from "os";
 import { existsSync as existsSync24, readdirSync as readdirSync6, readFileSync as readFileSync25 } from "fs";
-import { join as join33, relative as relative6 } from "path";
+import { join as join33, relative as relative7 } from "path";
 
 // src/preset-recommend.ts
 init_esm_shims();
@@ -9372,9 +9505,11 @@ function renderUpdateSummary(log, spec, report) {
   });
   const backups = report.updateMode?.backups ?? [];
   if (backups.length > 0) {
-    const unmeasured = report.updateMode?.noChecksum?.length ?? 0;
-    const unmeasuredPart = unmeasured === 0 ? "" : unmeasured === backups.length ? " \u2014 no checksum on record for any of them (installed before checksums were kept), so they may not be your edits" : ` \u2014 ${unmeasured} had no checksum on record (marked noChecksum in the list), so those may not be your edits`;
-    const removedBefore = report.updateMode?.outOfTrack?.backedUp.length ?? 0;
+    const replaced = backups.filter((b2) => b2.removed !== true);
+    const removedBefore = backups.length - replaced.length;
+    const noChecksum = new Set(report.updateMode?.noChecksum ?? []);
+    const unmeasured = replaced.filter((b2) => noChecksum.has(b2.path)).length;
+    const unmeasuredPart = unmeasured === 0 ? "" : unmeasured === backups.length ? " \u2014 no checksum on record for any of them (installed before checksums were kept), so they may not be your edits" : ` \u2014 ${unmeasured} ${removedBefore > 0 ? "replaced " : ""}had no checksum on record (marked noChecksum in the list), so those may not be your edits`;
     const how = removedBefore === 0 ? "saved before replacing" : removedBefore === backups.length ? "saved before removing" : `saved before replacing (${removedBefore} before removing)`;
     log(
       infoRow(
@@ -9382,12 +9517,13 @@ function renderUpdateSummary(log, spec, report) {
         `${backups.length} file(s) ${how}, as *.backup-<time>${unmeasuredPart} \xB7 list: .uzys-agent-harness/update-backups.json`
       )
     );
-    const displacedN = report.updateMode?.displaced?.length ?? 0;
-    if (removedBefore + displacedN < backups.length)
+    const displaced = new Set(report.updateMode?.displaced ?? []);
+    const carry = replaced.filter((b2) => !displaced.has(b2.path)).length;
+    if (carry > 0)
       log(
         infoRow(
           "NEXT",
-          unmeasured === backups.length ? 'nothing to carry over unless you remember editing one of them \u2014 then ask audit-harness-fit: "update \uBC31\uC5C5\uBCF8\uC758 \uB0B4 \uD3B8\uC9D1\uC744 \uB0B4 \uD30C\uC77C\uB85C \uC62E\uACA8\uC918"' : 'backups are not loaded \u2014 to keep your edits across updates, ask audit-harness-fit: "update \uBC31\uC5C5\uBCF8\uC758 \uB0B4 \uD3B8\uC9D1\uC744 \uB0B4 \uD30C\uC77C\uB85C \uC62E\uACA8\uC918" (update replaces harness files every time, so edits put back inside them return as backups)'
+          unmeasured === carry ? 'nothing to carry over unless you remember editing one of them \u2014 then ask audit-harness-fit: "update \uBC31\uC5C5\uBCF8\uC758 \uB0B4 \uD3B8\uC9D1\uC744 \uB0B4 \uD30C\uC77C\uB85C \uC62E\uACA8\uC918"' : 'backups are not loaded \u2014 to keep your edits across updates, ask audit-harness-fit: "update \uBC31\uC5C5\uBCF8\uC758 \uB0B4 \uD3B8\uC9D1\uC744 \uB0B4 \uD30C\uC77C\uB85C \uC62E\uACA8\uC918" (update replaces harness files every time, so edits put back inside them return as backups)'
         )
       );
   }
@@ -9779,25 +9915,8 @@ function linkedSkillRows(log, updated, notOurs) {
     );
   }
 }
-function hadFileRow(log, area, paths) {
-  if (paths.length === 0) return;
-  log(
-    assetRow(
-      "skip",
-      `${area} had files with these names`,
-      `${paths.length} backed up as *.backup-<time> \u2014 yours, put back on uninstall \xB7 ${paths.join(", ")}`
-    )
-  );
-}
 function renderPhase1Rows(log, baseline, verbose = false) {
   if (baseline.updateMode) {
-    const noChecksum = new Set(baseline.updateMode.noChecksum ?? []);
-    const displaced = baseline.updateMode.displaced ?? [];
-    const displacedSkills = displaced.filter((p2) => p2.startsWith(".claude/skills/"));
-    const displacedPolicy = displaced.filter(
-      (p2) => p2.startsWith(".claude/") && !p2.startsWith(".claude/skills/")
-    );
-    const displacedExternal = displaced.filter((p2) => !p2.startsWith(".claude/"));
     for (const [dir, count] of Object.entries(baseline.updateMode.updated)) {
       if (count > 0) log(assetRow("success", dir, `${count} files updated`));
     }
@@ -9854,6 +9973,8 @@ function renderPhase1Rows(log, baseline, verbose = false) {
       const row = sharedFileRow(f);
       if (row !== null) log(row);
     }
+    for (const d2 of baseline.updateMode.deadMcp ?? [])
+      log(assetRow("skip", ".mcp.json", `${d2.name} \u2014 ${d2.note}`));
     for (const f of baseline.updateMode.sharedLeft ?? []) {
       log(sharedLeftRow(f));
       if (f.retiredFeatures !== void 0) log(retiredFeaturesRow(f.path, f.retiredFeatures));
@@ -9867,11 +9988,7 @@ function renderPhase1Rows(log, baseline, verbose = false) {
     if (legacy2 !== null) log(legacy2);
     for (const row of legacyReleasedCatalogRows(baseline.updateMode.legacyReleasedCatalog ?? []))
       log(row);
-    for (const [dir, removed] of Object.entries(baseline.updateMode.pruned)) {
-      if (removed.length > 0) {
-        log(assetRow("skip", `${dir} orphan prune`, `${removed.length} removed`));
-      }
-    }
+    for (const j4 of baseline.updateMode.judged ?? []) log(judgedRow(j4));
     if (baseline.updateMode.skippedGroups.length > 0) {
       log(
         assetRow(
@@ -9884,15 +10001,6 @@ function renderPhase1Rows(log, baseline, verbose = false) {
     if (baseline.updateMode.claudeMdUpdated) {
       log(assetRow("success", HARNESS_ANCHOR_FILE, "refreshed from template"));
     }
-    if (baseline.updateMode.anchorBackedUp && !noChecksum.has(HARNESS_ANCHOR_FILE)) {
-      log(
-        assetRow(
-          "skip",
-          `${HARNESS_ANCHOR_FILE} edited`,
-          "your edits backed up as *.backup-<time> \u2014 latest template is now active"
-        )
-      );
-    }
     if (baseline.updateMode.anchorCreated) {
       log(assetRow("success", HARNESS_ANCHOR_FILE, "created from template (anchor migration)"));
     }
@@ -9920,28 +10028,6 @@ function renderPhase1Rows(log, baseline, verbose = false) {
     if (baseline.updateMode.legacyAnchor) {
       log(assetRow("skip", baseline.updateMode.legacyAnchor, LEGACY_ANCHOR_NOTE));
     }
-    const skillsEdited = baseline.updateMode.skillsBackedUp.filter(
-      (p2) => !noChecksum.has(`.claude/skills/${p2}`)
-    );
-    if (skillsEdited.length > 0) {
-      log(
-        assetRow(
-          "skip",
-          ".claude/skills edited files",
-          `${skillsEdited.length} backed up as *.backup-<time>`
-        )
-      );
-    }
-    hadFileRow(log, ".claude/skills", displacedSkills);
-    if (baseline.updateMode.skillsPruned.length > 0) {
-      log(
-        assetRow(
-          "success",
-          ".claude/skills not in bundle",
-          `${baseline.updateMode.skillsPruned.length} files deleted \xB7 ${baseline.updateMode.skillsPruned.join(", ")}`
-        )
-      );
-    }
     linkedSkillRows(
       log,
       baseline.updateMode.skillsLinked ?? [],
@@ -9995,29 +10081,6 @@ function renderPhase1Rows(log, baseline, verbose = false) {
         )
       );
     }
-    const policyEdited = baseline.updateMode.policyBackedUp.filter(
-      (p2) => !noChecksum.has(`.claude/${p2}`)
-    );
-    if (policyEdited.length > 0) {
-      log(
-        assetRow(
-          "skip",
-          "edited policy files",
-          `${policyEdited.length} backed up as *.backup-<time>`
-        )
-      );
-    }
-    hadFileRow(log, "policy files", displacedPolicy);
-    const unmeasured = [...noChecksum].filter((p2) => p2 !== ".mcp-allowlist");
-    if (unmeasured.length > 0) {
-      log(
-        assetRow(
-          "skip",
-          "no checksum on record",
-          `${unmeasured.length} backed up once as *.backup-<time> \u2014 installed before checksums were kept, so these may not be your edits (usually what changed between releases); later updates compare precisely`
-        )
-      );
-    }
     const retiredRefs = baseline.updateMode.retiredHookRefsRemoved ?? [];
     if (retiredRefs.length > 0) {
       log(
@@ -10067,17 +10130,6 @@ function renderPhase1Rows(log, baseline, verbose = false) {
         )
       );
     }
-    const externalEdited = baseline.updateMode.externalBackedUp.filter((p2) => !noChecksum.has(p2));
-    if (externalEdited.length > 0) {
-      log(
-        assetRow(
-          "skip",
-          "edited external CLI files",
-          `${externalEdited.length} backed up as *.backup-<time>`
-        )
-      );
-    }
-    hadFileRow(log, "external CLI files", displacedExternal);
     const displacedSame = baseline.updateMode.displacedSame ?? [];
     if (displacedSame.length > 0) {
       log(
@@ -10538,7 +10590,7 @@ function renderInterruptedInstall(err, e2, cwd = process.cwd()) {
   }
   const { path, error } = e2.record;
   err(
-    path !== null ? `  Already in place before it stopped \u2014 recorded in ${relative6(cwd, path) || path}:` : "  Already in place before it stopped:"
+    path !== null ? `  Already in place before it stopped \u2014 recorded in ${relative7(cwd, path) || path}:` : "  Already in place before it stopped:"
   );
   for (const [key, n] of groups) {
     err(`    ${key.endsWith("/") ? `${key} (${n} file${n === 1 ? "" : "s"})` : key}`);
@@ -11011,7 +11063,7 @@ import {
   statSync as statSync5,
   writeFileSync as writeFileSync9
 } from "fs";
-import { dirname as dirname8, join as join35, relative as relative7, resolve as resolve4, sep as sep7 } from "path";
+import { dirname as dirname8, join as join35, relative as relative8, resolve as resolve4, sep as sep8 } from "path";
 
 // src/uninstall-interactive.ts
 init_esm_shims();
@@ -12940,12 +12992,7 @@ function settleLog(ctx, io) {
     const recordDir = join35(projectDir, INSTALL_LOG_DIR);
     if (outsideLinkAt(projectDir, INSTALL_LOG_DIR) !== null) io.rm(recordDir);
     else {
-      for (const rel of [
-        `${INSTALL_LOG_DIR}/${INSTALL_LOG_FILENAME}`,
-        ...HARNESS_RUNTIME_IGNORES
-      ]) {
-        io.rm(join35(projectDir, rel));
-      }
+      for (const rel of RECORD_FILES) io.rm(join35(projectDir, rel));
       pruneEmptyDirsUpward(projectDir, recordDir);
     }
     if (outsideLinkAt(projectDir, LEGACY_INSTALL_LOG_DIR) === null) {
@@ -13131,13 +13178,16 @@ function resolveCliTarget(ctx, io) {
 function underAny(path, owned) {
   return owned.some((o) => o.endsWith("/") ? path.startsWith(o) : path === o);
 }
-function planCliRemoval(target, remaining) {
+function planCliRemoval(target, remaining, log, projectDir) {
   const { exclusive, sharedNowUnowned } = removableFor(target, remaining);
   const owned = [...exclusive, ...sharedNowUnowned];
   const prefixes = owned.filter((o) => o.kind === "recorded" || o.kind === "anchor").map((o) => o.path);
-  const has = (path) => underAny(path, prefixes);
+  const used = (path) => usersOf(path, projectDir).some((cli) => remaining.includes(cli));
+  const has = (path) => underAny(path, prefixes) && !used(path);
+  const kept = harnessCandidates(log).filter((p2) => underAny(p2, prefixes) && used(p2)).map((p2) => p2.split("/").slice(0, 3).join("/"));
   return {
     target,
+    kept: [...new Set(kept)].sort(),
     scope: {
       has,
       // `.claude/settings.json` 은 claude 의 `.claude/` 아래 · `.codex/config.toml` 은 codex 의 `.codex/` 아래 · `AGENTS.md` ·
@@ -13151,6 +13201,11 @@ function planCliRemoval(target, remaining) {
     }
   };
 }
+function keptForRemainingLines(plan, preview) {
+  if (plan.kept.length === 0) return [];
+  const what = `${plan.kept.join(" \xB7 ")} \u2014 still used by Claude Code through its .claude/skills/ link(s)`;
+  return [preview ? `  \u25CB leave ${what}` : `  ${c.yellow("\u2298")} left  ${what}`];
+}
 function removeCliHeader(target, installed, remaining) {
   return [
     "",
@@ -13172,6 +13227,7 @@ function removeCliDryRunLines(plan, ctx, remaining) {
     harnessRoot
   });
   lines2.push(...harnessRemovalLines(preview, installLog, projectDir, plan.scope, true));
+  lines2.push(...keptForRemainingLines(plan, true));
   lines2.push(...assetsLeftLines(installLog, projectDir, plan.scope));
   const rerender = agentsMdRerenderSet(plan.target, remaining, installLog, projectDir);
   if (rerender !== null) {
@@ -13281,7 +13337,7 @@ function removeCliAction(ctx, io) {
   const { options, installLog, projectDir, harnessRoot } = ctx;
   const installed = installedClis(installLog);
   const remaining = installed.filter((cli) => cli !== target);
-  const plan = planCliRemoval(target, remaining);
+  const plan = planCliRemoval(target, remaining, installLog, projectDir);
   for (const line of removeCliHeader(target, installed, remaining)) io.log(line);
   if (options.dryRun) {
     for (const line of removeCliDryRunLines(plan, ctx, remaining)) io.log(line);
@@ -13296,6 +13352,7 @@ function removeCliAction(ctx, io) {
   for (const line of harnessRemovalLines(done, installLog, projectDir, plan.scope, false)) {
     io.log(line);
   }
+  for (const line of keptForRemainingLines(plan, false)) io.log(line);
   for (const line of assetsLeftLines(installLog, projectDir, plan.scope)) io.log(line);
   const rerenderSet = agentsMdRerenderSet(target, remaining, installLog, projectDir);
   const rerender = rerenderSet === null ? null : rerenderAgentsMd(ctx, rerenderSet);
@@ -13561,11 +13618,16 @@ var LEGACY_LOG = `${LEGACY_INSTALL_LOG_DIR}/${INSTALL_LOG_FILENAME}`;
 var SKILLS_DIR3 = ".claude/skills/";
 var CLI_FOLDERS2 = [".claude", ".codex", ".opencode"];
 var LEFT_FILES_SHOWN = 3;
+var RECORD_FILES = [
+  `${INSTALL_LOG_DIR}/${INSTALL_LOG_FILENAME}`,
+  ...HARNESS_RUNTIME_IGNORES
+];
 var FULL_SCOPE = {
   has: () => true,
   shared: UNINSTALL_SHARED,
   skeleton: PROJECT_SKELETON_DIRS,
-  folders: CLI_FOLDERS2,
+  // #817 — 기록 폴더도 — 헬퍼는 파일 하나씩 회수하고(#812) 설치자 파일은 남으니, 폴더가 왜 남았는지 같은 줄로 말한다
+  folders: [...CLI_FOLDERS2, INSTALL_LOG_DIR],
   importBlock: true,
   anchor: true
 };
@@ -13722,7 +13784,7 @@ function removeRecordedFile(path, ctx) {
   if (verdict.verdict !== "remove" && verdict.verdict !== "backup+remove") return;
   let backup = null;
   if (verdict.verdict === "backup+remove") {
-    backup = io.write ? relative7(projectDir, backupFile(effective)).split(sep7).join("/") : `${relative7(projectDir, effective).split(sep7).join("/")}.backup-<time>`;
+    backup = io.write ? relative8(projectDir, backupFile(effective)).split(sep8).join("/") : `${relative8(projectDir, effective).split(sep8).join("/")}.backup-<time>`;
   }
   if (io.write) {
     if (effective !== abs) io.rm(abs);
@@ -13742,7 +13804,7 @@ function legacyFileCandidates() {
 }
 function mayReclaimLegacy(log, projectDir, path) {
   const clis = installedClis(log);
-  if (!ownersOf(path).some((c3) => clis.includes(c3))) return false;
+  if (!usersOf(path, projectDir).some((c3) => clis.includes(c3))) return false;
   if (isExcludedPath(bundlePath(path), excludedIds(log))) return false;
   return !(log.rootFiles ?? []).some(
     (f) => f.path === path && f.change === "displaced" && !isLegacyDisplaced(log, projectDir, f)
@@ -14025,7 +14087,7 @@ function leftFolderLines(r, log, projectDir, scope, preview) {
     const entries = /* @__PURE__ */ new Map();
     for (const n of yoursUnder(projectDir, dir)) {
       const full = `${dir}/${n.name}`;
-      if (full === LEGACY_LOG) continue;
+      if (full === LEGACY_LOG || RECORD_FILES.includes(full)) continue;
       if (!gone.has(full) && !assetFiles.has(full) && !said(full)) entries.set(n.name, n.shown);
     }
     for (const p2 of back)
@@ -14125,7 +14187,7 @@ function removeAnchor(log, projectDir, io) {
       ]
     };
   }
-  const backup = edited ? relative7(projectDir, backupFile(abs)).split(sep7).join("/") : null;
+  const backup = edited ? relative8(projectDir, backupFile(abs)).split(sep8).join("/") : null;
   io.rm(abs);
   return {
     removed: true,
@@ -14188,7 +14250,7 @@ function removeLegacyAgentsMd(path, abs, effective, strip, ctx) {
   let backup = `${path}.backup-<time>`;
   try {
     if (io.write) {
-      backup = relative7(projectDir, backupFile(effective)).split(sep7).join("/");
+      backup = relative8(projectDir, backupFile(effective)).split(sep8).join("/");
       if (strip.remainder !== null) {
         writeFileSync9(effective, neutralizeScaffoldBanner(strip.remainder), "utf8");
       } else {
@@ -14234,7 +14296,7 @@ function removeToolFiles(files, projectDir, rm) {
     try {
       if (hashContent(readFileSync27(abs, "utf8")) !== sha256) {
         const backup = backupFile(abs);
-        notes.push(`backed up ${path} \u2192 ${relative7(projectDir, backup)} (changed since install)`);
+        notes.push(`backed up ${path} \u2192 ${relative8(projectDir, backup)} (changed since install)`);
       }
       rm(abs);
       removed.push(path);
@@ -14249,8 +14311,8 @@ function removeToolFiles(files, projectDir, rm) {
 function pruneEmptyDirsUpward(projectDir, startDir) {
   let cursor = startDir;
   while (true) {
-    const rel = relative7(projectDir, cursor);
-    if (rel === "" || rel.startsWith(`..${sep7}`) || rel === "..") return;
+    const rel = relative8(projectDir, cursor);
+    if (rel === "" || rel.startsWith(`..${sep8}`) || rel === "..") return;
     try {
       if (readdirSync7(cursor).length > 0) return;
       rmdirSync3(cursor);