@uzysjung/agent-harness 26.151.0 → 26.153.0

package/dist/index.js

@@ -14,9 +14,11 @@ import {
   INTERNAL_BUNDLED_SKILL_IDS,
   POLICY_DIRS,
   RENAMED_SKILL_IDS,
+  RETIRED_AGENTS,
   RETIRED_AGENT_IDS,
   RETIRED_SKILL_IDS,
   TRACKS,
+  TRACK_AGENTS,
   __commonJS,
   __toESM,
   anyTrack,
@@ -62,7 +64,7 @@ import {
   upsertHarnessImport,
   withContinuousSkillsNote,
   writeInstallLog
-} from "./chunk-3QBHZUVB.js";
+} from "./chunk-OYNSK6QF.js";
 
 // node_modules/sisteransi/src/index.js
 var require_src = __commonJS({
@@ -747,7 +749,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.151.0",
+  version: "26.153.0",
   description: "Curate vetted AI-coding skills & plugins by your tech stack \u2014 install only what you need, across Claude Code, Codex, OpenCode & Antigravity",
   type: "module",
   publishConfig: {
@@ -986,14 +988,13 @@ function padDisplay(s, width) {
 init_esm_shims();
 import {
   chmodSync as chmodSync3,
-  existsSync as existsSync14,
+  existsSync as existsSync13,
   mkdirSync as mkdirSync4,
   readdirSync as readdirSync4,
-  readFileSync as readFileSync13,
-  unlinkSync as unlinkSync3,
+  readFileSync as readFileSync12,
   writeFileSync as writeFileSync6
 } from "fs";
-import { basename as basename5, dirname as dirname4, join as join13, resolve } from "path";
+import { basename as basename5, dirname as dirname4, join as join12, resolve } from "path";
 
 // src/ci-scaffold.ts
 init_esm_shims();
@@ -2089,53 +2090,18 @@ function writeMcpJson(path, mcp) {
 `);
 }
 
-// src/superseded.ts
-init_esm_shims();
-import { existsSync as existsSync12, readFileSync as readFileSync11 } from "fs";
-import { join as join11 } from "path";
-function sameTracks(a, b2) {
-  if (a.length !== b2.length) return false;
-  const sa = [...a].sort();
-  const sb = [...b2].sort();
-  return sa.every((t, i) => t === sb[i]);
-}
-function policyKey(claudeRelative) {
-  return POLICY_DIRS.some(
-    ({ dir, ext }) => claudeRelative.startsWith(`${dir}/`) && claudeRelative.endsWith(ext)
-  ) ? claudeRelative : null;
-}
-function findSuperseded(projectDir, spec, previous) {
-  if (!previous) return [];
-  if (!sameTracks(previous.spec.tracks, spec.tracks)) return [];
-  const baseline = new Map((previous.policyFiles ?? []).map((f) => [f.path, f.sha256]));
-  if (baseline.size === 0) return [];
-  const out = [];
-  for (const entry of buildManifest(spec)) {
-    if (entry.applies(spec)) continue;
-    const id = classifyBaselineTarget(entry.target)?.id;
-    if (!id) continue;
-    const key = policyKey(entry.target.slice(".claude/".length));
-    if (!key) continue;
-    const abs = join11(projectDir, entry.target);
-    if (!existsSync12(abs)) continue;
-    if (!isHarnessOwned(baseline, key, readFileSync11(abs, "utf-8"))) continue;
-    out.push({ target: entry.target, id, source: entry.source });
-  }
-  return out;
-}
-
 // src/update-mode.ts
 init_esm_shims();
 import {
   copyFileSync,
-  existsSync as existsSync13,
+  existsSync as existsSync12,
   mkdirSync as mkdirSync3,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync11,
   unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync5
 } from "fs";
-import { basename as basename4, dirname as dirname3, join as join12 } from "path";
+import { basename as basename4, dirname as dirname3, join as join11 } from "path";
 var LEGACY_ANCHOR_FILE = ".claude/CLAUDE.md";
 function buildUpdateSpec(projectDir, tracks) {
   return {
@@ -2147,7 +2113,7 @@ function buildUpdateSpec(projectDir, tracks) {
   };
 }
 function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}) {
-  const claudeDir = join12(projectDir, ".claude");
+  const claudeDir = join11(projectDir, ".claude");
   const report = {
     updated: {},
     pruned: {},
@@ -2171,6 +2137,7 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}) {
     restored: [],
     needsReinstall: [],
     retiredAgents: [],
+    demotedAgents: [],
     mcpAllowlistRetired: null
   };
   const fresh = installNewAssets(projectDir, templatesDir);
@@ -2179,8 +2146,8 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}) {
   report.needsReinstall = fresh.needsReinstall;
   const policyBase = policyBaseline(projectDir);
   for (const { dir, ext } of POLICY_DIRS) {
-    const target = join12(claudeDir, dir);
-    const source = join12(templatesDir, dir);
+    const target = join11(claudeDir, dir);
+    const source = join11(templatesDir, dir);
     const label = `.claude/${dir}`;
     const ctx = { prefix: dir, baseline: policyBase };
     const synced = updateDir(target, source, ext, ctx);
@@ -2190,8 +2157,8 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}) {
   }
   refreshPolicyBaseline(projectDir, templatesDir);
   const skillSync = syncSkills(
-    join12(claudeDir, "skills"),
-    join12(templatesDir, "skills"),
+    join11(claudeDir, "skills"),
+    join11(templatesDir, "skills"),
     skillBaseline(projectDir),
     /* @__PURE__ */ new Date(),
     (relInSkills) => foreignOwnedTarget(projectDir, `.claude/skills/${relInSkills}`)
@@ -2201,15 +2168,16 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}) {
   report.skillsSkippedLinks = skillSync.skippedLinks;
   refreshSkillBaseline(projectDir);
   const installLog = readInstallLog(projectDir);
-  if (existsSync13(claudeDir) && (installLog === null || installLog.spec.cli.includes("claude"))) {
+  if (existsSync12(claudeDir) && (installLog === null || installLog.spec.cli.includes("claude"))) {
     syncHarnessAnchor(projectDir, templatesDir, report);
   }
-  const settingsPath = join12(claudeDir, "settings.json");
-  if (existsSync13(settingsPath)) {
+  const settingsPath = join11(claudeDir, "settings.json");
+  if (existsSync12(settingsPath)) {
     report.staleHookRefs = cleanStaleHookRefs(settingsPath, claudeDir);
   }
   report.mcpAllowlistRetired = retireMcpAllowlist(projectDir);
   report.retiredAgents = staleAgentFiles(claudeDir);
+  report.demotedAgents = demotedAgentFiles(claudeDir, installedTracks(projectDir));
   const external = refreshExternalCli(projectDir, harnessRoot);
   report.externalUpdated = external.externalUpdated;
   report.externalBackedUp = external.externalBackedUp;
@@ -2234,16 +2202,25 @@ function runUpdateMode(projectDir, templatesDir, harnessRoot, deps = {}) {
   return report;
 }
 function staleSkillDirs(claudeDir) {
-  const dir = join12(claudeDir, "skills");
-  if (!existsSync13(dir)) return [];
+  const dir = join11(claudeDir, "skills");
+  if (!existsSync12(dir)) return [];
   const stale = (id) => RENAMED_SKILL_IDS[id] !== void 0 || RETIRED_SKILL_IDS.includes(id);
   return readdirSync3(dir, { withFileTypes: true }).filter((e2) => e2.isDirectory() && stale(e2.name)).map((e2) => e2.name);
 }
 function staleAgentFiles(claudeDir) {
-  const dir = join12(claudeDir, "agents");
-  if (!existsSync13(dir)) return [];
+  const dir = join11(claudeDir, "agents");
+  if (!existsSync12(dir)) return [];
   return readdirSync3(dir, { withFileTypes: true }).filter((e2) => e2.isFile() && e2.name.endsWith(".md")).map((e2) => basename4(e2.name, ".md")).filter((id) => RETIRED_AGENT_IDS.includes(id));
 }
+function demotedAgentFiles(claudeDir, tracks) {
+  if (tracks.length === 0) return [];
+  const dir = join11(claudeDir, "agents");
+  if (!existsSync12(dir)) return [];
+  const demoted = TRACK_AGENTS.filter(([, pattern]) => !anyTrack(tracks, pattern)).map(
+    ([id]) => id
+  );
+  return readdirSync3(dir, { withFileTypes: true }).filter((e2) => e2.isFile() && e2.name.endsWith(".md")).map((e2) => basename4(e2.name, ".md")).filter((id) => demoted.includes(id));
+}
 function installNewAssets(projectDir, templatesDir) {
   const installed = [];
   const restored = [];
@@ -2256,15 +2233,15 @@ function installNewAssets(projectDir, templatesDir) {
   for (const entry of trackOnlyFileAssets(installedTracks(projectDir))) {
     if (entry.target === HARNESS_ANCHOR_FILE) continue;
     if (isBaselineExcluded(entry.target, baselineExcluded)) continue;
-    const target = join12(projectDir, entry.target);
+    const target = join11(projectDir, entry.target);
     const foreign = foreignOwnedTarget(projectDir, entry.target);
     if (foreign !== null) {
       if (!foreignOwned.includes(foreign)) foreignOwned.push(foreign);
       continue;
     }
-    if (existsSync13(target)) continue;
-    const source = join12(templatesDir, entry.source);
-    if (!existsSync13(source)) continue;
+    if (existsSync12(target)) continue;
+    const source = join11(templatesDir, entry.source);
+    if (!existsSync12(source)) continue;
     if (entry.target.startsWith(".claude/")) {
       if (!claudeSelected) continue;
       if (entry.target.startsWith(".claude/hooks/") || entry.target === ".claude/settings.json") {
@@ -2289,13 +2266,13 @@ function trackOnlyFileAssets(tracks) {
   );
 }
 function syncHarnessAnchor(projectDir, templatesDir, report) {
-  if (existsSync13(join12(projectDir, LEGACY_ANCHOR_FILE))) {
+  if (existsSync12(join11(projectDir, LEGACY_ANCHOR_FILE))) {
     report.legacyAnchor = LEGACY_ANCHOR_FILE;
   }
-  const templateMd = join12(templatesDir, "CLAUDE.md");
-  if (!existsSync13(templateMd)) return;
-  const anchor = join12(projectDir, HARNESS_ANCHOR_FILE);
-  const existed = existsSync13(anchor);
+  const templateMd = join11(templatesDir, "CLAUDE.md");
+  if (!existsSync12(templateMd)) return;
+  const anchor = join11(projectDir, HARNESS_ANCHOR_FILE);
+  const existed = existsSync12(anchor);
   copyFileSync(templateMd, anchor);
   if (existed) {
     report.claudeMdUpdated = true;
@@ -2307,15 +2284,15 @@ function syncHarnessAnchor(projectDir, templatesDir, report) {
   recordAnchorBaseline(projectDir, anchor);
 }
 function upsertRootImport(projectDir) {
-  const target = join12(projectDir, "CLAUDE.md");
-  const existing = existsSync13(target) ? readFileSync12(target, "utf8") : null;
+  const target = join11(projectDir, "CLAUDE.md");
+  const existing = existsSync12(target) ? readFileSync11(target, "utf8") : null;
   const next = upsertHarnessImport(existing, {
     projectName: basename4(projectDir),
     tracks: installedTracks(projectDir),
     // ADR-085 — update 는 선택 목록을 인자로 받지 않는다. `syncSkills` 와 같은 판정을 쓴다:
     // `.claude/skills/<id>` 가 있으면 그 스킬은 이 설치가 고른 것이다.
     continuousSkills: CONTINUOUS_SKILLS.map((s) => s.id).filter(
-      (id) => existsSync13(join12(projectDir, ".claude/skills", id))
+      (id) => existsSync12(join11(projectDir, ".claude/skills", id))
     )
   });
   if (next === existing) return false;
@@ -2335,7 +2312,7 @@ function recordAnchorBaseline(projectDir, anchor) {
       ...log.templates,
       rootClaudeMd: {
         path: HARNESS_ANCHOR_FILE,
-        sha256: hashContent(readFileSync12(anchor, "utf8"))
+        sha256: hashContent(readFileSync11(anchor, "utf8"))
       }
     }
   };
@@ -2377,16 +2354,16 @@ function isHarnessOwned2(ctx, rel, current) {
   return isHarnessOwned(ctx.baseline, `${ctx.prefix}/${rel}`, current);
 }
 function updateDir(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync13(target) || !existsSync13(source)) return { updated: 0, backedUp: [] };
+  if (!existsSync12(target) || !existsSync12(source)) return { updated: 0, backedUp: [] };
   let updated = 0;
   const backedUp = [];
   for (const file of readdirSync3(target)) {
     if (!file.endsWith(ext)) continue;
-    const targetFile = join12(target, file);
-    const sourceFile = join12(source, file);
-    if (!existsSync13(sourceFile)) continue;
-    const next = readFileSync12(sourceFile, "utf8");
-    const current = readFileSync12(targetFile, "utf8");
+    const targetFile = join11(target, file);
+    const sourceFile = join11(source, file);
+    if (!existsSync12(sourceFile)) continue;
+    const next = readFileSync11(sourceFile, "utf8");
+    const current = readFileSync11(targetFile, "utf8");
     if (current === next) continue;
     if (!isHarnessOwned2(ctx, file, current)) {
       backupFile(targetFile, now);
@@ -2398,7 +2375,7 @@ function updateDir(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
   return { updated, backedUp };
 }
 function syncSkills(targetDir, sourceDir, baseline, now = /* @__PURE__ */ new Date(), foreignOf) {
-  if (!existsSync13(targetDir) || !existsSync13(sourceDir))
+  if (!existsSync12(targetDir) || !existsSync12(sourceDir))
     return { updated: 0, backedUp: [], skippedLinks: [], foreignOwned: [] };
   let updated = 0;
   const backedUp = [];
@@ -2406,27 +2383,27 @@ function syncSkills(targetDir, sourceDir, baseline, now = /* @__PURE__ */ new Da
   const foreignOwned = [];
   for (const skill of readdirSync3(sourceDir, { withFileTypes: true })) {
     if (!skill.isDirectory()) continue;
-    const targetSkill = join12(targetDir, skill.name);
+    const targetSkill = join11(targetDir, skill.name);
     if (occupiedByNonDirectory(targetSkill)) {
       skippedLinks.push(skill.name);
       continue;
     }
-    if (!existsSync13(targetSkill)) continue;
-    for (const rel of listFilesRecursive(join12(sourceDir, skill.name))) {
-      const targetFile = join12(targetSkill, rel);
+    if (!existsSync12(targetSkill)) continue;
+    for (const rel of listFilesRecursive(join11(sourceDir, skill.name))) {
+      const targetFile = join11(targetSkill, rel);
       const foreign = foreignOf(`${skill.name}/${rel}`);
       if (foreign !== null) {
         if (!foreignOwned.includes(foreign)) foreignOwned.push(foreign);
         continue;
       }
-      const next = readFileSync12(join12(sourceDir, skill.name, rel), "utf8");
-      if (!existsSync13(targetFile)) {
+      const next = readFileSync11(join11(sourceDir, skill.name, rel), "utf8");
+      if (!existsSync12(targetFile)) {
         mkdirSync3(dirname3(targetFile), { recursive: true });
         writeFileSync5(targetFile, next);
         updated++;
         continue;
       }
-      const current = readFileSync12(targetFile, "utf8");
+      const current = readFileSync11(targetFile, "utf8");
       if (current === next) continue;
       const recorded = baseline.get(`${skill.name}/${rel}`);
       if (recorded === void 0 || hashContent(current) !== recorded) {
@@ -2472,16 +2449,16 @@ function refreshSkillBaseline(projectDir) {
   }
 }
 function pruneOrphans(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync13(target) || !existsSync13(source)) return [];
+  if (!existsSync12(target) || !existsSync12(source)) return [];
   const removed = [];
   for (const file of readdirSync3(target)) {
     if (!file.endsWith(ext)) continue;
-    const sourceFile = join12(source, file);
-    if (!existsSync13(sourceFile)) {
-      const targetFile = join12(target, file);
+    const sourceFile = join11(source, file);
+    if (!existsSync12(sourceFile)) {
+      const targetFile = join11(target, file);
       if (!ctx.baseline.has(`${ctx.prefix}/${file}`)) continue;
       try {
-        const current = readFileSync12(targetFile, "utf8");
+        const current = readFileSync11(targetFile, "utf8");
         if (!isHarnessOwned2(ctx, file, current)) backupFile(targetFile, now);
         unlinkSync2(targetFile);
         removed.push(file);
@@ -2492,8 +2469,8 @@ function pruneOrphans(target, source, ext, ctx, now = /* @__PURE__ */ new Date()
   return removed;
 }
 function retireMcpAllowlist(projectDir, now = /* @__PURE__ */ new Date()) {
-  const target = join12(projectDir, ".mcp-allowlist");
-  if (!existsSync13(target)) return null;
+  const target = join11(projectDir, ".mcp-allowlist");
+  if (!existsSync12(target)) return null;
   try {
     const backup = backupFile(target, now);
     unlinkSync2(target);
@@ -2505,7 +2482,7 @@ function retireMcpAllowlist(projectDir, now = /* @__PURE__ */ new Date()) {
 function cleanStaleHookRefs(settingsPath, claudeDir) {
   let settings;
   try {
-    settings = JSON.parse(readFileSync12(settingsPath, "utf8"));
+    settings = JSON.parse(readFileSync11(settingsPath, "utf8"));
   } catch {
     return [];
   }
@@ -2532,7 +2509,7 @@ function cleanStaleHookRefs(settingsPath, claudeDir) {
 function keepHookRef(hook, claudeDir, removed) {
   const relPath = projectAnchoredRef(hook?.command ?? "", claudeDir);
   if (relPath === void 0) return true;
-  const exists = existsSync13(join12(claudeDir, relPath));
+  const exists = existsSync12(join11(claudeDir, relPath));
   if (!exists && !removed.includes(relPath)) removed.push(relPath);
   return exists;
 }
@@ -2559,14 +2536,14 @@ function projectAnchoredRef(command, claudeDir) {
 function runInstall(ctx) {
   const { harnessRoot, projectDir, spec } = ctx;
   const mode = ctx.mode ?? "fresh";
-  const templatesDir = join13(harnessRoot, "templates");
-  if (!existsSync14(templatesDir)) {
+  const templatesDir = join12(harnessRoot, "templates");
+  if (!existsSync13(templatesDir)) {
     throw new Error(`Templates dir not found: ${templatesDir}`);
   }
-  const claudeDir = join13(projectDir, ".claude");
+  const claudeDir = join12(projectDir, ".claude");
   const previousLog = readInstallLog(projectDir);
   const claudeWasSelected = previousLog?.spec.cli.includes("claude") ?? false;
-  if (mode === "update" && !existsSync14(claudeDir) && (previousLog === null || claudeWasSelected)) {
+  if (mode === "update" && !existsSync13(claudeDir) && (previousLog === null || claudeWasSelected)) {
     throw new Error(
       claudeWasSelected ? `Update mode found a broken install at ${projectDir} \u2014 this project installed Claude Code assets but \`.claude/\` is gone. Reinstall instead: agent-harness install --track <name>` : `Update mode requires an existing install at ${projectDir}`
     );
@@ -2578,7 +2555,6 @@ function runInstall(ctx) {
   const manifestSpec = buildManifestSpec(spec);
   const policyBase = new Map((previousLog?.policyFiles ?? []).map((f) => [f.path, f.sha256]));
   const baselineExcluded = new Set(spec.baselineExclude ?? []);
-  const supersededFound = findSuperseded(projectDir, manifestSpec, previousLog);
   const base = spec.cli.includes("claude") ? installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBase, baselineExcluded) : (
     // claude 미선택이어도 CLI 중립 자산은 깔린다. manifest 전체가 `.claude/` baseline 안에서만
     // 돌던 탓에 이 자산들이 claude 설치에만 도달했는데, **배포 룰 본문이 이 스크립트들을
@@ -2634,10 +2610,7 @@ function runInstall(ctx) {
     baselineForeignOwned: [
       ...base.foreignOwned,
       ...externalForeignOwned.filter((f) => !base.foreignOwned.includes(f))
-    ],
-    // 밀려난 자산 정리는 **manifest 복사가 끝난 뒤**에 한다. 앞에서 지우면 이번 설치가 다시
-    // 깔 수도 있는 파일을 지웠다 되돌리는 셈이라, 무엇이 최종 상태인지 보고가 흐려진다.
-    superseded: applySupersededCleanup(spec, projectDir, supersededFound)
+    ]
   };
   ctx.onProgress?.({ type: "baseline-complete", baseline });
   const external = runExternalPhase(ctx);
@@ -2653,26 +2626,11 @@ function runInstall(ctx) {
   );
   return { ...baseline, external, staleHookRefs };
 }
-function applySupersededCleanup(spec, projectDir, found) {
-  if (found.length === 0) return { removed: [], kept: [] };
-  if (!spec.cleanSuperseded) return { removed: [], kept: found.map((f) => f.target) };
-  const removed = [];
-  const kept = [];
-  for (const asset of found) {
-    try {
-      unlinkSync3(join13(projectDir, asset.target));
-      removed.push(asset.target);
-    } catch {
-      kept.push(asset.target);
-    }
-  }
-  return { removed, kept };
-}
 function healStaleHookRefs(spec, projectDir) {
   if (!spec.cli.includes("claude")) return [];
-  const settingsPath = join13(projectDir, ".claude/settings.json");
-  if (!existsSync14(settingsPath)) return [];
-  return cleanStaleHookRefs(settingsPath, join13(projectDir, ".claude"));
+  const settingsPath = join12(projectDir, ".claude/settings.json");
+  if (!existsSync13(settingsPath)) return [];
+  return cleanStaleHookRefs(settingsPath, join12(projectDir, ".claude"));
 }
 function resolveBackupPath(ctx, mode, claudeDir) {
   const wantBackup = ctx.backup ?? (mode === "update" || mode === "reinstall");
@@ -2688,9 +2646,6 @@ function runUpdateInstall(ctx, templatesDir, backupPath) {
     baselineExcluded: [],
     baselineExcludedOnDisk: [],
     baselineForeignOwned: [],
-    // update 는 밀려난 자산을 다루지 않는다 — 그 판정은 사용자가 옵션을 고르는 설치 경로의
-    // 것이고, update 는 무엇을 골랐는지 다시 묻지 않는다.
-    superseded: { removed: [], kept: [] },
     backup: backupPath,
     installedTracks: [...ctx.spec.tracks].sort(),
     mcpServers: [],
@@ -2741,12 +2696,12 @@ function installCliNeutralAssets(manifestSpec, projectDir, templatesDir, baselin
       continue;
     }
     if (!isCliNeutralTarget(entry.target)) continue;
-    const source = join13(templatesDir, entry.source);
-    if (!existsSync14(source)) {
+    const source = join12(templatesDir, entry.source);
+    if (!existsSync13(source)) {
       result.skipped += 1;
       continue;
     }
-    copyFile(source, join13(projectDir, entry.target));
+    copyFile(source, join12(projectDir, entry.target));
     result.filesCopied += 1;
   }
   return result;
@@ -2758,9 +2713,9 @@ function backupEditedPolicyFile(entryTarget, target, source, baseline) {
   if (!POLICY_DIRS.some(({ dir, ext }) => rel.startsWith(`${dir}/`) && rel.endsWith(ext))) {
     return null;
   }
-  if (!existsSync14(target)) return null;
-  const current = readFileSync13(target, "utf-8");
-  if (current === readFileSync13(source, "utf-8")) return null;
+  if (!existsSync13(target)) return null;
+  const current = readFileSync12(target, "utf-8");
+  if (current === readFileSync12(source, "utf-8")) return null;
   const recorded = baseline.get(rel);
   if (recorded !== void 0 && recorded === hashContent(current)) return null;
   return backupFile(target);
@@ -2773,14 +2728,14 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
     if (!entry.applies(manifestSpec)) {
       continue;
     }
-    const target = join13(projectDir, entry.target);
+    const target = join12(projectDir, entry.target);
     if (isBaselineExcluded(entry.target, baselineExcluded)) {
       result.excluded.push(entry.target);
-      if (existsSync14(target)) result.excludedOnDisk.push(entry.target);
+      if (existsSync13(target)) result.excludedOnDisk.push(entry.target);
       continue;
     }
-    const source = join13(templatesDir, entry.source);
-    if (!existsSync14(source)) {
+    const source = join12(templatesDir, entry.source);
+    if (!existsSync13(source)) {
       result.skipped += 1;
       continue;
     }
@@ -2791,7 +2746,7 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
     }
     if (entry.type === "file") {
       if (entry.target === ".claude/settings.json") {
-        const backup = backupFileIfChanged(target, readFileSync13(source, "utf-8"));
+        const backup = backupFileIfChanged(target, readFileSync12(source, "utf-8"));
         if (backup) {
           result.backups.push(backup);
         }
@@ -2815,8 +2770,8 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
     }
     accumulateCategory(result.categories, entry);
   }
-  const hookDir = join13(projectDir, ".claude/hooks");
-  if (existsSync14(hookDir)) {
+  const hookDir = join12(projectDir, ".claude/hooks");
+  if (existsSync13(hookDir)) {
     chmodHooksSync(hookDir);
   }
   writeInstalledTracks(projectDir, manifestSpec.tracks);
@@ -2830,9 +2785,9 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBas
   return result;
 }
 function harnessAnchorLog(projectDir) {
-  const anchor = join13(projectDir, HARNESS_ANCHOR_FILE);
-  if (!existsSync14(anchor)) return null;
-  return { path: HARNESS_ANCHOR_FILE, sha256: hashContent(readFileSync13(anchor, "utf-8")) };
+  const anchor = join12(projectDir, HARNESS_ANCHOR_FILE);
+  if (!existsSync13(anchor)) return null;
+  return { path: HARNESS_ANCHOR_FILE, sha256: hashContent(readFileSync12(anchor, "utf-8")) };
 }
 function writeEnvironmentFiles(projectDir, tracks) {
   return {
@@ -2891,7 +2846,7 @@ function writeInstallLogSafe(ctx, externalFiles, external, rootClaudeMdLog, prev
       rootFiles
     );
     const skillFiles = collectSkillHashes(ctx.projectDir);
-    const policyFiles = collectPolicyHashes(ctx.projectDir, join13(ctx.harnessRoot, "templates"));
+    const policyFiles = collectPolicyHashes(ctx.projectDir, join12(ctx.harnessRoot, "templates"));
     const merged = mergeExternalFiles(ctx.projectDir, previousLog?.externalFiles, externalFiles);
     writeInstallLog(ctx.projectDir, {
       ...log,
@@ -2907,11 +2862,11 @@ function writeInstallLogSafe(ctx, externalFiles, external, rootClaudeMdLog, prev
   }
 }
 function composeAndWriteMcp(harnessRoot, projectDir, spec) {
-  const mcpPath = join13(projectDir, ".mcp.json");
-  const created = !existsSync14(mcpPath);
+  const mcpPath = join12(projectDir, ".mcp.json");
+  const created = !existsSync13(mcpPath);
   const composed = composeMcpJson({
-    templateMcpPath: join13(harnessRoot, "templates/mcp.json"),
-    trackMapPath: join13(harnessRoot, "templates/track-mcp-map.tsv"),
+    templateMcpPath: join12(harnessRoot, "templates/mcp.json"),
+    trackMapPath: join12(harnessRoot, "templates/track-mcp-map.tsv"),
     existingPath: mcpPath,
     tracks: spec.tracks
   });
@@ -2964,15 +2919,15 @@ function accumulateCategory(cats, entry) {
   }
 }
 function writeInstalledTracks(projectDir, tracks) {
-  const path = join13(projectDir, ".claude/.installed-tracks");
+  const path = join12(projectDir, ".claude/.installed-tracks");
   mkdirSync4(dirname4(path), { recursive: true });
   const sorted = [...new Set(tracks)].sort().join("\n");
   writeFileSync6(path, `${sorted}
 `);
 }
 function writeRootClaudeMd(projectDir, tracks, continuousSkills) {
-  const target = join13(projectDir, "CLAUDE.md");
-  const existing = existsSync14(target) ? readFileSync13(target, "utf-8") : null;
+  const target = join12(projectDir, "CLAUDE.md");
+  const existing = existsSync13(target) ? readFileSync12(target, "utf-8") : null;
   const content = upsertHarnessImport(existing, {
     projectName: basename5(projectDir),
     tracks,
@@ -2997,6 +2952,8 @@ function listHookFiles(hookDir) {
 
 // src/commands/install-render.ts
 init_esm_shims();
+import { existsSync as existsSync14, readdirSync as readdirSync5 } from "fs";
+import { join as join13 } from "path";
 
 // src/preset-recommend.ts
 init_esm_shims();
@@ -3062,12 +3019,14 @@ function renderInstallHeader(log, spec, mode) {
     for (const [cat, ids] of groupAssetsByCategory(finalAssets)) {
       log(`              ${c.dim(`\xB7 ${cat}:`)} ${ids.join(", ")}`);
     }
-    const assetSpec = buildManifestSpec(spec);
-    const cost = formatResidentCostLine(
-      residentCost(buildManifest(assetSpec).filter((e2) => e2.applies(assetSpec))),
-      summarizeContextCost(finalAssets).unmeasuredCount
-    );
-    if (cost) log(`              ${c.dim(`\xB7 ${cost}`)}`);
+    if (mode !== "update") {
+      const assetSpec = buildManifestSpec(spec);
+      const cost = formatResidentCostLine(
+        residentCost(buildManifest(assetSpec).filter((e2) => e2.applies(assetSpec))),
+        summarizeContextCost(finalAssets).unmeasuredCount
+      );
+      if (cost) log(`              ${c.dim(`\xB7 ${cost}`)}`);
+    }
   }
   log("");
 }
@@ -3121,7 +3080,7 @@ function createInstallRenderer(log, spec, verbose) {
   };
   return { callbacks, phase2HeaderPrinted: () => phase2HeaderPrinted };
 }
-function renderUpdateSummary(log, report) {
+function renderUpdateSummary(log, spec, report) {
   log("");
   log(unifiedSection("Summary"));
   log("");
@@ -3131,8 +3090,26 @@ function renderUpdateSummary(log, report) {
     log(infoRow("BACKUP", shortenPath(report.backup)));
     log(infoRow("ROLLBACK", `rm -rf .claude && mv ${shortenPath(report.backup)} .claude`));
   }
+  const cost = formatResidentCostLine(
+    residentCost(residentEntriesOnDisk(spec)),
+    summarizeContextCost(finalSelectedAssets(spec.tracks, spec.userOverride)).unmeasuredCount
+  );
+  if (cost) log(infoRow("CONTEXT", cost));
   log("");
 }
+function residentEntriesOnDisk(spec) {
+  const assetSpec = buildManifestSpec(spec);
+  const planned = buildManifest(assetSpec).filter((e2) => e2.applies(assetSpec));
+  const agentsDir = join13(spec.projectDir, ".claude", "agents");
+  const onDisk = existsSync14(agentsDir) ? readdirSync5(agentsDir, { withFileTypes: true }).filter((e2) => e2.isFile() && e2.name.endsWith(".md")).map((e2) => ({
+    source: `agents/${e2.name}`,
+    target: `.claude/agents/${e2.name}`,
+    // 배포판이 아니라 **이 프로젝트의 파일**을 잰다 — 사용자가 고친 descriptor 도,
+    // 배포판에 더는 없는 에이전트도 실제로 상주하는 것은 이쪽이다.
+    file: join13(agentsDir, e2.name)
+  })) : [];
+  return [...planned.filter((e2) => !e2.target.startsWith(".claude/agents/")), ...onDisk];
+}
 function renderCliArtifacts(log, spec, report) {
   const hasArtifacts = Boolean(report.codex || report.opencode || report.antigravity);
   const cliSelected = targetsInclude(spec.cli, "codex") || targetsInclude(spec.cli, "opencode") || targetsInclude(spec.cli, "antigravity");
@@ -3401,11 +3378,22 @@ function renderPhase1Rows(log, baseline, verbose = false, withEcc = false, claud
       );
     }
     for (const id of baseline.updateMode.retiredAgents) {
+      const instead = RETIRED_AGENTS.find((a) => a.id === id)?.instead;
+      log(
+        assetRow(
+          "skip",
+          "agents",
+          `${id} \xB7 \uC774 \uB9B4\uB9AC\uC988\uC5D0\uC11C \uC740\uD1F4 \u2014 .claude/agents/${id}.md \uB97C \uC9C0\uC6CC\uB3C4 \uB41C\uB2E4` + (instead === void 0 ? "" : ` \xB7 ${instead}`)
+        )
+      );
+    }
+    for (const [id, pattern] of TRACK_AGENTS) {
+      if (!baseline.updateMode.demotedAgents.includes(id)) continue;
       log(
         assetRow(
           "skip",
           "agents",
-          `${id} \xB7 \uC774 \uB9B4\uB9AC\uC988\uC5D0\uC11C \uC740\uD1F4 \u2014 .claude/agents/${id}.md \uB97C \uC9C0\uC6CC\uB3C4 \uB41C\uB2E4 \xB7 Claude Code \uC758 \`/code-review\` \xB7 \`/security-review\` \uAC00 \uAC19\uC740 \uC77C\uC744 \uD55C\uB2E4`
+          `${id} \xB7 \uC774 \uD2B8\uB799\uC5D0\uC11C\uB294 \uB354 \uC774\uC0C1 \uC124\uCE58\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 ${pattern.split("|").join(" \xB7 ")} \uD2B8\uB799 \uC804\uC6A9 \xB7 .claude/agents/${id}.md \uB97C \uC9C0\uC6CC\uB3C4 \uB41C\uB2E4`
         )
       );
     }
@@ -3532,7 +3520,7 @@ function renderPhase1Rows(log, baseline, verbose = false, withEcc = false, claud
       phase1Row(
         "agents",
         cats.agents.length,
-        "SOD reviewer (opus, independent verifier) + 3 base",
+        "independent verifier \xB7 implementation lane \xB7 domain lanes (track)",
         cats.agents
       );
     }
@@ -3546,7 +3534,7 @@ function renderPhase1Rows(log, baseline, verbose = false, withEcc = false, claud
       phase1Row(
         "skills",
         cats.skills.length,
-        "deep-research \xB7 ui-visual-review \xB7 eval-harness (modified)",
+        "bundled methodology skills (track \xB7 opt-in)",
         cats.skills
       );
     }
@@ -3577,24 +3565,6 @@ function renderPhase1Rows(log, baseline, verbose = false, withEcc = false, claud
       )
     );
   }
-  if (baseline.superseded.removed.length > 0) {
-    log(
-      assetRow(
-        "success",
-        "superseded \u2014 cleaned",
-        `${baseline.superseded.removed.length} \u2014 ${baseline.superseded.removed.map((t) => t.replace(/^\.claude\//, "")).join(", ")} \xB7 \uB418\uB3CC\uB9AC\uB824\uBA74 \uADF8 \uC790\uC0B0 \uC5C6\uC774 \uC7AC\uC124\uCE58`
-      )
-    );
-  }
-  if (baseline.superseded.kept.length > 0) {
-    log(
-      assetRow(
-        "skip",
-        "superseded \u2014 kept",
-        `${baseline.superseded.kept.length} \u2014 ${baseline.superseded.kept.map((t) => t.replace(/^\.claude\//, "")).join(", ")} \xB7 \uC774\uBC88 \uC120\uD0DD\uC774 \uB300\uCCB4\uD588\uC9C0\uB9CC \uC9C0\uC6B0\uC9C0 \uC54A\uC558\uB2E4 (\uC81C\uAC70: agent-harness uninstall)`
-      )
-    );
-  }
   const TEMPLATES_COL = 28;
   if (baseline.rootClaudeMd) {
     const n = baseline.rootClaudeMd.tracks.length;
@@ -3809,7 +3779,7 @@ function executeSpec(spec, deps = {}) {
     return;
   }
   if (report.updateMode) {
-    renderUpdateSummary(log, report);
+    renderUpdateSummary(log, spec, report);
     return;
   }
   if (renderer.phase2HeaderPrinted()) {
@@ -3874,7 +3844,7 @@ function registerInstallCommand(cli2) {
 
 // src/commands/list.ts
 init_esm_shims();
-import { existsSync as existsSync15, readFileSync as readFileSync14 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync13 } from "fs";
 import { join as join14, resolve as resolve3 } from "path";
 function listAction(options = {}, deps = {}) {
   const log = deps.log ?? console.log;
@@ -3939,7 +3909,7 @@ function formatTemplateRows(log, projectDir) {
   const rootMd = log.templates.rootClaudeMd;
   if (rootMd) {
     const path = join14(projectDir, rootMd.path);
-    const modified = existsSync15(path) && hashContent(readFileSync14(path, "utf8")) !== rootMd.sha256;
+    const modified = existsSync15(path) && hashContent(readFileSync13(path, "utf8")) !== rootMd.sha256;
     rows.push(
       modified ? `    ${c.dim(rootMd.path)}  ${c.yellow("(\uC218\uC815\uB428 \u2014 uninstall \uC2DC \uBCF4\uC874)")}` : `    ${c.dim(rootMd.path)}`
     );
@@ -3967,8 +3937,8 @@ import { spawnSync as spawnSync2 } from "child_process";
 import {
   existsSync as existsSync16,
   lstatSync as lstatSync2,
-  readdirSync as readdirSync5,
-  readFileSync as readFileSync15,
+  readdirSync as readdirSync6,
+  readFileSync as readFileSync14,
   rmdirSync,
   rmSync,
   writeFileSync as writeFileSync7
@@ -5384,7 +5354,7 @@ function removeExternalFiles(log, projectDir, rm) {
     const abs = join15(projectDir, path);
     if (!existsSync16(abs)) continue;
     if (!lstatSync2(abs).isFile()) continue;
-    if (hashContent(readFileSync15(abs, "utf8")) !== sha256) {
+    if (hashContent(readFileSync14(abs, "utf8")) !== sha256) {
       kept.push(path);
       continue;
     }
@@ -5400,7 +5370,7 @@ function pruneEmptyDirsUpward(projectDir, startDir) {
     const rel = relative2(projectDir, cursor);
     if (rel === "" || rel.startsWith(`..${sep2}`) || rel === "..") return;
     try {
-      if (readdirSync5(cursor).length > 0) return;
+      if (readdirSync6(cursor).length > 0) return;
       rmdirSync(cursor);
     } catch {
       return;
@@ -5425,7 +5395,7 @@ function previewExternalLines(installLog, projectDir) {
   for (const { path, sha256 } of installLog.externalFiles ?? []) {
     const abs = join15(projectDir, path);
     if (!existsSync16(abs)) continue;
-    if (hashContent(readFileSync15(abs, "utf8")) !== sha256) {
+    if (hashContent(readFileSync14(abs, "utf8")) !== sha256) {
       lines.push(`  \u25CB keep ${path} (modified since install \u2014 preserved)`);
       continue;
     }
@@ -5454,7 +5424,7 @@ function readRootClaudeMd(projectDir) {
   const path = join15(projectDir, "CLAUDE.md");
   if (!existsSync16(path)) return null;
   try {
-    return readFileSync15(path, "utf8");
+    return readFileSync14(path, "utf8");
   } catch {
     return null;
   }
@@ -5464,7 +5434,7 @@ function rootClaudeMdModified(log, projectDir) {
   if (!rootMd) return false;
   const path = join15(projectDir, rootMd.path);
   if (!existsSync16(path)) return false;
-  return hashContent(readFileSync15(path, "utf8")) !== rootMd.sha256;
+  return hashContent(readFileSync14(path, "utf8")) !== rootMd.sha256;
 }
 function formatTemplateList(log) {
   const items = [log.templates.claudeDir];
@@ -5524,7 +5494,7 @@ import { resolve as resolve5 } from "path";
 
 // src/state.ts
 init_esm_shims();
-import { existsSync as existsSync17, readFileSync as readFileSync16 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync15 } from "fs";
 import { join as join16 } from "path";
 var META_FILE = ".claude/.installed-tracks";
 var LEGACY_SIGNATURES = [
@@ -5561,7 +5531,7 @@ function tracksFromLog(tracks) {
   return [...new Set(tracks.filter(isTrack))].sort();
 }
 function readMetafile(path) {
-  const raw = readFileSync16(path, "utf8");
+  const raw = readFileSync15(path, "utf8");
   const seen = /* @__PURE__ */ new Set();
   for (const line of raw.split(/\s+/)) {
     const trimmed = line.trim();
@@ -5890,23 +5860,6 @@ Proceed?`,
     });
     return q(result) ? null : result;
   },
-  confirmSupersededCleanup: async (items, context) => {
-    const names = items.map((i) => i.target.replace(/^\.claude\//, "")).join("\n      ");
-    const result = await ue({
-      message: [
-        `${context.by.join(" \xB7 ")} \uC744(\uB97C) \uACE8\uB77C\uC11C \uC544\uB798 ${items.length}\uAC1C\uAC00 \uC124\uCE58 \uB300\uC0C1\uC5D0\uC11C \uBE60\uC84C\uC2B5\uB2C8\uB2E4.`,
-        "\uADF8\uB7F0\uB370 \uC774\uC804 \uC124\uCE58\uBCF8\uC774 \uB514\uC2A4\uD06C\uC5D0 \uADF8\uB300\uB85C \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4:",
-        `      ${names}`,
-        "",
-        `\uADF8\uB300\uB85C \uB450\uBA74 \uAC19\uC740 \uC77C\uC744 \uD558\uB294 \uC5D0\uC774\uC804\uD2B8\uAC00 \uB450 \uBC8C\uC774\uACE0, \uB9E4 \uC138\uC158 ~${context.tokens} tok \uB97C \uACC4\uC18D \uBB45\uB2C8\uB2E4.`,
-        "(\uD558\uB124\uC2A4\uAC00 \uAE54\uC558\uACE0 \uC218\uC815\uB418\uC9C0 \uC54A\uC740 \uD30C\uC77C\uB9CC \uB300\uC0C1\uC785\uB2C8\uB2E4 \u2014 \uC9C1\uC811 \uACE0\uCE5C \uD30C\uC77C\uC740 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4)",
-        "",
-        "\uC815\uB9AC\uD560\uAE4C\uC694?"
-      ].join("\n"),
-      initialValue: true
-    });
-    return q(result) ? null : result;
-  },
   selectInstallTargets: async (initialChecked, step, recap) => {
     const pages = INSTALL_TARGET_PAGES;
     const baselineTargets = listBaselineTargets({ tracks: recap?.tracks ?? [] });
@@ -6172,50 +6125,11 @@ ${summary}`
         ...userOverride ? { userOverride } : {},
         ...baselineExclude.length > 0 ? { baselineExclude } : {}
       };
-      const superseded = findSuperseded(
-        projectDir,
-        buildManifestSpec(spec),
-        readInstallLog(projectDir)
-      );
-      let cleanSuperseded = false;
-      if (superseded.length > 0) {
-        const cause = supersededCause(projectDir, spec, readInstallLog(projectDir), superseded);
-        const answer = await prompts.confirmSupersededCleanup(superseded, {
-          by: cause.length > 0 ? cause : ["\uC774\uBC88 \uC120\uD0DD"],
-          tokens: supersededTokens(superseded)
-        });
-        if (answer === null) {
-          step = "confirm";
-          continue;
-        }
-        cleanSuperseded = answer;
-      }
       prompts.outro(stepLabel(WIZARD.INSTALL, "Installing..."));
-      return {
-        ok: true,
-        mode,
-        spec: { ...spec, ...cleanSuperseded ? { cleanSuperseded } : {} }
-      };
+      return { ok: true, mode, spec };
     }
   }
 }
-function supersededTokens(items) {
-  const r = residentCost(items.map((i) => ({ source: i.source, target: i.target })));
-  return r.rules + r.agentDescriptors + r.skillDescriptors;
-}
-function supersededCause(projectDir, spec, log, found) {
-  const selected = spec.userOverride?.forceInclude ?? [];
-  return selected.filter((id) => {
-    const without = {
-      ...spec,
-      userOverride: {
-        forceInclude: selected.filter((x) => x !== id),
-        forceExclude: [...spec.userOverride?.forceExclude ?? [], id]
-      }
-    };
-    return findSuperseded(projectDir, buildManifestSpec(without), log).length < found.length;
-  });
-}
 function tracksEqual(a, b2) {
   if (a.length !== b2.length) return false;
   const sortedA = [...a].sort();