@uzysjung/agent-harness 26.161.0 → 26.163.0

package/README.ko.md

@@ -16,21 +16,20 @@ AI 코딩 도구에 꼭 필요한 룰·훅·스킬만 남기고 나머지는 모
 
 ## 빠른 시작
 
-Node 20 이상이 필요하다. 프로젝트 폴더에서 다음 명령을 실행한다:
+Node 20.12 이상이 필요하다. 프로젝트 폴더에서 다음 명령을 실행한다:
 
 ```bash
 npx -y @uzysjung/agent-harness
 ```
 
-위저드가 다음 여섯 단계를 안내한다:
+위저드가 다음 다섯 단계를 안내한다:
 
 ```
-1/6  Tracks          무엇을 만드는지(스택) — 항목을 미리 체크해 줄 뿐이다
-2/6  CLI             claude / codex / opencode / antigravity — 여러 개 가능
-3/6  Install items   트랙에 맞는 항목이 미리 체크되어 있다. 원치 않는 것은 해제
-4/6  Scope           Project(기본값, 이 폴더에만) 또는 Global
-5/6  Confirm         요약과 함께, 이 선택이 매 세션에 얹는 컨텍스트 크기를 보여 준다
-6/6  Installing
+1/5  Tracks          무엇을 만드는지(스택) — 항목을 미리 체크해 줄 뿐이다
+2/5  CLI             claude / codex / opencode / antigravity — 여러 개 가능
+3/5  Install items   트랙에 맞는 항목이 미리 체크되어 있다. 원치 않는 것은 해제
+4/5  Confirm         요약과 함께, 이 선택이 매 세션에 얹는 컨텍스트 크기를 보여 준다
+5/5  Installing
 ```
 
 그다음 같은 폴더에서 AI 코딩 도구를 실행하면, 첫 세션부터 룰과 스킬이 바로 적용된다:
@@ -51,7 +50,7 @@ claude    # 또는 codex / opencode / agy
 | **훅** | CLI 가 스스로 실행하는 스크립트. Claude Code 에는 2개가 들어간다: 하나는 세션을 시작할 때 스펙과 변경 기록을 불러오고, 다른 하나는 `.env` · lock 파일 · 인증서 편집을 막는다 — 하네스에서 "안 된다"고 제한하는 유일한 장치이며, 편집을 막을 때마다 로그를 한 줄 남긴다 | 자동으로 — 세션을 시작할 때, 편집하기 직전에 |
 | **스킬** | 작업에 필요할 때 에이전트가 열어보는 단계별 절차서. 이 저장소에서 관리하는 방법론 스킬과 트랙에 필요한 기술 스택 스킬이 들어 있다(예: `csr-supabase` 의 React · shadcn · Supabase · Postgres) | 필요할 때만 — 한 줄짜리 설명만 항상 띄워 두고, 본문은 사용할 때만 읽는다 |
 | **에이전트** | 메인 에이전트가 작업을 맡기는 조수. 모든 트랙에 독립 검증자 `reviewer` 가 있고, 개발 트랙에는 `implementer` 가 있으며, 그것을 쓰는 트랙에만 `data-analyst` · `strategist` 가 들어간다 | 메인 에이전트가 작업을 위임할 때 |
-| **앵커** | CLI 가 매 세션마다 읽는 작업 원칙 파일. 원래 있던 내 `CLAUDE.md` 파일은 그대로 유지된다 — 하네스는 import 구문 한 줄만 추가할 뿐 나머지는 건드리지 않는다([어느 파일이 누구 것인가](docs/CONTEXT-FILES.md)) | 매 세션 |
+| **앵커** | CLI 가 매 세션마다 읽는 작업 원칙 파일. 원래 있던 내 `CLAUDE.md` 파일은 그대로 유지된다 — 하네스는 표식으로 감싼 import 블록(`@CLAUDE-uzys-harness.md` 참조와 그 아래 스킬 안내)만 추가할 뿐 나머지는 건드리지 않는다([어느 파일이 누구 것인가](docs/CONTEXT-FILES.md)) | 매 세션 |
 
 모든 트랙에 공통으로 들어가는 방법론 스킬은 4가지다: `north-star` · `objective-brief` · `gh-issue-workflow` · `audit-harness-fit`. 번들 스킬은 `--with` 나 `--without` 뒤에 이름을 적어 추가하거나 뺄 수 있다.
 
@@ -94,7 +93,7 @@ claude    # 또는 codex / opencode / agy
 
 **기존 프로젝트에 적용해도 안전하다.** 내가 직접 수정한 파일을 교체해야 할 때는 타임스탬프를 붙여 백업본을 남기고 그 경로를 알려 준다. 내가 작성하거나 수정한 파일은 백업 없이 지우지 않으며, 기존에 있던 `.mcp.json` 서버 설정은 덮어쓰지 않고 내용을 병합한다([기존 프로젝트에 설치하기](docs/USAGE.md#installing-into-an-existing-project)).
 
-**기본적으로 현재 프로젝트에만 설치된다.** 위저드 4단계에서 Global 을 선택하지 않는 한 `~/.codex/` · `~/.opencode/` · `~/.gemini/` 디렉터리나 전역 npm 환경에는 아무것도 설치하지 않는다. 유일한 예외는 Claude Code 플러그인이다 — `claude` CLI 는 범위를 불문하고 플러그인 캐시를 `~/.claude/plugins/` 디렉터리에 저장하며 프로젝트는 메타데이터로 구분하기 때문이다. `.claude/` 디렉터리 밖에는 `.mcp.json`, `.gitignore` 파일에 추가하는 몇 줄(파일이 이미 있을 때), Supabase 트랙의 경우 `.env.example`, 그리고 설치 기록을 남기는 `.uzys-agent-harness/` 디렉터리만 생성한다 — [전체 설치 목록 보기](docs/USAGE.md#what-the-harness-writes).
+**현재 프로젝트에만 설치된다.** `~/.opencode/` · `~/.gemini/` 디렉터리나 전역 npm 환경에는 아무것도 설치하지 않는다. 프로젝트 밖에 쓰는 옵트인 예외는 둘뿐이다 — Claude Code 플러그인(`claude` CLI 가 플러그인 캐시를 `~/.claude/plugins/` 에 저장하며 프로젝트는 메타데이터로 구분), 그리고 `--with-codex-trust`(Codex 가 프로젝트 설정을 읽도록 `~/.codex/config.toml` 에 `[projects]` trust 항목 하나 추가 — [자세히](docs/USAGE.md#scope)). `.claude/` 디렉터리 밖에는 `CLAUDE.md`/`AGENTS.md` 스캐폴드와 하네스 앵커, `.mcp.json`, `.gitignore` 파일에 추가하는 몇 줄(파일이 이미 있을 때), `csr-supabase`(및 `full`) 트랙의 `.env.example`, `--with ci-scaffold` 를 줬을 때만 `.github/workflows/`, 그리고 설치 기록을 남기는 `.uzys-agent-harness/` 디렉터리를 생성한다 — [전체 설치 목록 보기](docs/USAGE.md#what-the-harness-writes).
 
 ## 다른 도구를 이미 쓰고 있다면
 

package/README.md

@@ -16,21 +16,20 @@ Works with **Claude Code** · **Codex** · **OpenCode** · **Antigravity**.
 
 ## Quick start
 
-You need Node 20 or newer. Run this in your project folder:
+You need Node 20.12 or newer. Run this in your project folder:
 
 ```bash
 npx -y @uzysjung/agent-harness
 ```
 
-The wizard asks six things:
+The wizard asks five things:
 
 ```
-1/6  Tracks          what you are building (a stack) — this only pre-checks items
-2/6  CLI             claude / codex / opencode / antigravity — one or more
-3/6  Install items   everything is pre-checked for your track; uncheck what you don't want
-4/6  Scope           Project (default, this folder only) or Global
-5/6  Confirm         summary, plus how much context your selection adds to each session
-6/6  Installing
+1/5  Tracks          what you are building (a stack) — this only pre-checks items
+2/5  CLI             claude / codex / opencode / antigravity — one or more
+3/5  Install items   everything is pre-checked for your track; uncheck what you don't want
+4/5  Confirm         summary, plus how much context your selection adds to each session
+5/5  Installing
 ```
 
 Then open your AI coding tool in the same folder. The rules and skills are live from the first session:
@@ -51,7 +50,7 @@ No terminal for the wizard (CI, containers, scripts)? Use flags: `install --trac
 | **Hooks** | Scripts your CLI runs on its own. Two, on Claude Code: one loads your spec and change log at session start; one blocks edits to `.env`, lock files, and certificates — the only thing in the harness that says "no", and it logs one line each time | Automatically, at session start or before an edit |
 | **Skills** | Step-by-step playbooks the agent opens when a task calls for them — the method skills written in this repo, plus the stack skills your track needs (for example React, shadcn, Supabase, Postgres on `csr-supabase`) | Only when relevant — a one-line description stays loaded, the body loads on use |
 | **Agents** | Helpers the main agent can hand work to: an independent `reviewer` on every track, `implementer` on dev tracks, `data-analyst` and `strategist` on the tracks that use them | When the main agent delegates |
-| **Anchor** | One working-principles file your CLI reads every session. Your own `CLAUDE.md` stays yours — the harness adds one import line and never touches the rest ([which file is whose](docs/CONTEXT-FILES.md)) | Every session |
+| **Anchor** | One working-principles file your CLI reads every session. Your own `CLAUDE.md` stays yours — the harness adds one marked import block (the `@CLAUDE-uzys-harness.md` reference and the skills guidance that follows it) and never touches the rest ([which file is whose](docs/CONTEXT-FILES.md)) | Every session |
 
 Four method skills go to every track: `north-star`, `objective-brief`, `gh-issue-workflow`, `audit-harness-fit`. Bundled skills can be added or dropped by name with `--with` / `--without`.
 
@@ -94,7 +93,7 @@ In a terminal, `uninstall` offers three choices — one CLI, selected assets, or
 
 **Safe on an existing project.** Before replacing a file you edited, the harness writes a timestamped backup next to it and prints the path. Nothing you wrote or edited is deleted without a backup beside it, and your existing `.mcp.json` servers are merged, not replaced ([installing into an existing project](docs/USAGE.md#installing-into-an-existing-project)).
 
-**Your project only, by default.** Nothing goes to `~/.codex/`, `~/.opencode/`, `~/.gemini/`, or global npm unless you choose Global at step 4. Claude Code plugins are the one exception: the `claude` CLI keeps its plugin cache under `~/.claude/plugins/` in either scope and isolates projects by metadata. Besides `.claude/`, install writes `.mcp.json`, a few `.gitignore` lines (when that file exists), an `.env.example` on Supabase tracks, and its own record at `.uzys-agent-harness/` — [the full list](docs/USAGE.md#what-the-harness-writes).
+**Your project only.** Nothing goes to `~/.opencode/`, `~/.gemini/`, or global npm. Two opt-in exceptions write outside the project: Claude Code plugins (the `claude` CLI keeps its plugin cache under `~/.claude/plugins/` and isolates projects by metadata), and `--with-codex-trust`, which adds one `[projects]` trust entry to `~/.codex/config.toml` so Codex reads its project config ([details](docs/USAGE.md#scope)). Besides `.claude/`, install writes `CLAUDE.md`/`AGENTS.md` scaffolds and their harness anchor, `.mcp.json`, a few `.gitignore` lines (when that file exists), an `.env.example` on `csr-supabase` (and `full`), `.github/workflows/` only with `--with ci-scaffold`, and its own record at `.uzys-agent-harness/` — [the full list](docs/USAGE.md#what-the-harness-writes).
 
 ## Already using another tool?
 

package/dist/{chunk-MBRLCU5O.js → chunk-5T6MDT67.js}

@@ -156,6 +156,22 @@ var EXTERNAL_ASSETS = [
   // === Repo-bundled internal skills (uzys 1st-party, v26.87.0) ===
   // 2026-08-02 복원 (ADR-062) — 이관(ADR-060) 후 감사에서 본문 열화 104건(dropped 76 ·
   //   damaged 28)이 확인돼 9종을 이 리포 번들로 되돌렸다. 아래 10종 전부 `kind: "internal"`.
+  // #602 — ui-visual-review: TRACKS.md 가 말하는 트랙 추종 번들 스킬("follows the track, not
+  // the catalog"). internal 카탈로그 자산으로 등록해 selectedInternalSkills 흐름에 태우면
+  // .agents/skills(비-Claude 자리)에도 깔린다 — 종전의 .claude/ 전용 배선과 어긋나던 것.
+  {
+    id: "ui-visual-review",
+    tier: "official",
+    // uzys 자사 스킬
+    description: "UI visual review \u2014 screenshot capture, baseline diff, and a review gate for UI changes (ships with UI tracks; ssr-htmx excluded)",
+    category: "frontend",
+    source: "uzys",
+    condition: {
+      kind: "any-track",
+      tracks: ["csr-supabase", "csr-fastify", "csr-fastapi", "ssr-nextjs", "full"]
+    },
+    method: { kind: "internal", key: "ui-visual-review" }
+  },
   {
     id: "compaction-handoff",
     tier: "official",
@@ -870,6 +886,10 @@ var DEV_METHOD_SKILL_IDS = [
 ];
 var INTERNAL_BUNDLED_SKILL_IDS = [
   ...DEV_METHOD_SKILL_IDS,
+  // #602 — 트랙을 따라가는 번들 스킬(csr-*·ssr-*·full). selectedInternalSkills 로 흘러야
+  // .agents/skills(비-Claude 자리)에도 깔린다 — manifest 의 UI_SKILL_DIRS 배선은 .claude/ 만
+  // 알아 TRACKS.md 와 어긋났다. 조건은 buildAssetSpec 이 UI 트랙으로 건다.
+  "ui-visual-review",
   "north-star",
   "gh-issue-workflow",
   "objective-brief",
@@ -1134,13 +1154,31 @@ ${block}
 `;
 }
 function stripHarnessImport(text) {
-  const start = text.indexOf(IMPORT_MARKER_START);
-  if (start === -1) return null;
-  const endAt = text.indexOf(IMPORT_MARKER_END, start);
-  if (endAt === -1) return null;
-  const before = text.slice(0, start).replace(/\n+$/, "\n");
-  const after = text.slice(endAt + IMPORT_MARKER_END.length).replace(/^\n+/, "");
-  return `${before}${after}`;
+  if (!text.includes(IMPORT_MARKER_START) && !text.includes(IMPORT_MARKER_END)) return null;
+  const endsWithNewline = text.endsWith("\n");
+  const out = [];
+  const lines = text.split("\n");
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i] ?? "";
+    if (line.includes(IMPORT_MARKER_START)) {
+      let j = i;
+      while (j < lines.length && !(lines[j] ?? "").includes(IMPORT_MARKER_END)) j++;
+      i = j < lines.length ? j + 1 : i + 1;
+      if (out.length > 0 && out[out.length - 1] === "") out.pop();
+      continue;
+    }
+    if (line.includes(IMPORT_MARKER_END) || line.trim() === HARNESS_IMPORT_LINE) {
+      i++;
+      continue;
+    }
+    out.push(line);
+    i++;
+  }
+  let result = out.join("\n");
+  if (endsWithNewline && result !== "" && !result.endsWith("\n")) result += "\n";
+  if (!endsWithNewline && result.endsWith("\n")) result = result.slice(0, -1);
+  return result === text ? null : result;
 }
 function hasHarnessImport(text) {
   if (text.includes(IMPORT_MARKER_START)) return true;
@@ -1359,8 +1397,8 @@ init_esm_shims();
 
 // src/install-log.ts
 init_esm_shims();
-import { createHash } from "crypto";
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync, writeFileSync } from "fs";
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync as rmSync2, writeFileSync } from "fs";
 import { dirname as dirname2, join as join3 } from "path";
 
 // src/cli-targets.ts
@@ -1414,17 +1452,20 @@ function targetsInclude(targets, base) {
 
 // src/fs-ops.ts
 init_esm_shims();
+import { createHash } from "crypto";
 import {
   copyFileSync,
-  cpSync,
   existsSync as existsSync2,
   constants as fsConstants,
   mkdirSync,
   readdirSync,
   readFileSync as readFileSync2,
+  readlinkSync,
   realpathSync,
   renameSync,
-  rmdirSync
+  rmdirSync,
+  rmSync,
+  symlinkSync
 } from "fs";
 import { dirname, join as join2 } from "path";
 function ensureDir(path2) {
@@ -1480,17 +1521,27 @@ function copyBackupDir(target, now = /* @__PURE__ */ new Date()) {
     return null;
   }
   const backup = claimBackupPath(`${target}.backup-${formatStamp(now)}`, (c) => mkdirSync(c));
-  cpSync(realpathSync(target), backup, { recursive: true });
+  try {
+    copyTreePreservingLinks(realpathSync(target), backup);
+  } catch (e) {
+    rmSync(backup, { recursive: true, force: true });
+    const detail = e instanceof Error ? e.message : String(e);
+    throw new Error(`backup of ${target} failed, partial copy removed \u2014 ${detail}`);
+  }
   return backup;
 }
-function backupFileIfChanged(target, newContent, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync2(target)) {
-    return null;
-  }
-  if (readFileSync2(target, "utf-8") === newContent) {
-    return null;
+function copyTreePreservingLinks(source, target) {
+  mkdirSync(target, { recursive: true });
+  for (const entry of readdirSync(source, { withFileTypes: true })) {
+    const src = join2(source, entry.name);
+    const dst = join2(target, entry.name);
+    if (entry.isSymbolicLink()) {
+      symlinkSync(readlinkSync(src), dst);
+      continue;
+    }
+    if (entry.isDirectory()) copyTreePreservingLinks(src, dst);
+    else if (entry.isFile()) copyFile(src, dst);
   }
-  return backupFile(target, now);
 }
 function backupFile(target, now = /* @__PURE__ */ new Date()) {
   return claimBackupPath(
@@ -1527,6 +1578,45 @@ function ensureProjectSkeleton(projectDir) {
     mkdirSync(join2(projectDir, d), { recursive: true });
   }
 }
+function dirTreesIdentical(a, b) {
+  if (!existsSync2(a) || !existsSync2(b)) return false;
+  const signature = (root, rel = "", out = /* @__PURE__ */ new Map()) => {
+    for (const e of readdirSync(join2(root, rel), { withFileTypes: true })) {
+      const r = rel === "" ? e.name : `${rel}/${e.name}`;
+      if (e.isSymbolicLink()) out.set(r, `link:${readlinkSync(join2(root, r))}`);
+      else if (e.isDirectory()) signature(root, r, out);
+      else if (e.isFile()) {
+        out.set(
+          r,
+          createHash("sha256").update(readFileSync2(join2(root, r))).digest("hex")
+        );
+      }
+    }
+    return out;
+  };
+  const sa = signature(a);
+  const sb = signature(b);
+  if (sa.size !== sb.size) return false;
+  for (const [rel, sha] of sa) {
+    if (sb.get(rel) !== sha) return false;
+  }
+  return true;
+}
+function backupIfLossyUtf8(target, now = /* @__PURE__ */ new Date()) {
+  if (!existsSync2(target)) return null;
+  let raw;
+  try {
+    raw = readFileSync2(target);
+  } catch {
+    return null;
+  }
+  if (Buffer.from(raw.toString("utf8")).equals(raw)) return null;
+  const backup = backupFile(target, now);
+  console.error(
+    `\u26A0 ${target} contains bytes that are not valid UTF-8 \u2014 rewriting would alter them permanently. Original bytes saved as ${backup}`
+  );
+  return backup;
+}
 
 // src/install-log.ts
 var INSTALL_LOG_FILENAME = ".harness-install.json";
@@ -1626,7 +1716,7 @@ function mergeRootFiles(previous, current) {
     const prior = byPath.get(file.path);
     byPath.set(
       file.path,
-      prior ? {
+      prior && file.change !== "displaced" ? {
         path: file.path,
         change: prior.change === "created" ? "created" : file.change,
         notes: [.../* @__PURE__ */ new Set([...prior.notes, ...file.notes])]
@@ -1666,7 +1756,7 @@ function mergeAssets(previous, current) {
   ];
 }
 function hashContent(content) {
-  return createHash("sha256").update(content, "utf8").digest("hex");
+  return createHash2("sha256").update(content, "utf8").digest("hex");
 }
 function isHarnessOwned(baseline, key, current) {
   const recorded = baseline.get(key);
@@ -1712,26 +1802,45 @@ function migrateAwayLegacyLog(projectDir) {
   const legacy = legacyInstallLogPath(projectDir);
   if (!existsSync3(legacy)) return;
   try {
-    rmSync(legacy);
+    rmSync2(legacy);
   } catch {
   }
 }
 function readInstallLog(projectDir) {
+  return readInstallLogStatus(projectDir).log;
+}
+function readInstallLogStatus(projectDir) {
   const path2 = [installLogPath(projectDir), legacyInstallLogPath(projectDir)].find(
     (p) => existsSync3(p)
   );
-  if (!path2) return null;
+  if (!path2) return { status: "missing", log: null };
+  let parsed;
   try {
-    const parsed = JSON.parse(readFileSync3(path2, "utf8"));
-    if (Array.isArray(parsed.assets)) {
-      parsed.assets = parsed.assets.map(
-        (a) => a.method === "npm-global" ? { ...a, method: "npm" } : a
-      );
-    }
-    return parsed;
+    parsed = JSON.parse(readFileSync3(path2, "utf8"));
   } catch {
-    return null;
+    return { status: "corrupted", log: null };
+  }
+  if (!isValidInstallLogShape(parsed)) return { status: "corrupted", log: null };
+  const log = parsed;
+  if (Array.isArray(log.assets)) {
+    log.assets = log.assets.map(
+      (a) => a.method === "npm-global" ? { ...a, method: "npm" } : a
+    );
   }
+  return { status: "ok", log };
+}
+function isValidInstallLogShape(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  const spec = v.spec;
+  if (typeof spec !== "object" || spec === null) return false;
+  if (!Array.isArray(spec.tracks)) return false;
+  if (!Array.isArray(v.assets)) return false;
+  if (typeof v.templates !== "object" || v.templates === null) return false;
+  return true;
+}
+function corruptedInstallLogMessage(projectDir) {
+  return `install log is corrupted at ${installLogPath(projectDir)} \u2014 run install --reinstall to rebuild it`;
 }
 function installLogPath(projectDir) {
   return join3(projectDir, INSTALL_LOG_DIR, INSTALL_LOG_FILENAME);
@@ -1752,7 +1861,6 @@ function buildAssetSpec(ctx) {
 }
 var all = () => true;
 var dev = (s) => hasDevTrack(s.tracks);
-var ui = (s) => hasUiTrack(s.tracks);
 var onTracks = (pattern) => (s) => anyTrack(s.tracks, pattern);
 var COMMON_RULES = ["git-policy", "change-management", "doc-governance"];
 var DEV_RULES = ["test-policy", "ship-checklist"];
@@ -1808,11 +1916,63 @@ var RETIRED_AGENTS = [
   { id: "silent-failure-hunter", instead: "Claude Code \uC758 `/code-review` \uAC00 \uAC19\uC740 \uC77C\uC744 \uD55C\uB2E4" },
   { id: "build-error-resolver", instead: "\uBAA8\uB378\uC774 \uAE30\uBCF8\uC73C\uB85C \uD558\uB294 \uC77C\uC774\uB77C \uB300\uCCB4 \uC790\uC0B0\uC774 \uC5C6\uB2E4" }
 ];
-var RETIRED_AGENT_IDS = RETIRED_AGENTS.map((a) => a.id);
+var RETIRED_PATHS = [
+  // rules (23)
+  "rules/api-contract.md",
+  "rules/benchmark-parity.md",
+  "rules/code-style.md",
+  "rules/commit-policy.md",
+  "rules/data-analysis.md",
+  "rules/database.md",
+  "rules/design-workflow.md",
+  "rules/ecc-git-workflow.md",
+  "rules/ecc-performance-common.md",
+  "rules/ecc-security-common.md",
+  "rules/ecc-testing.md",
+  "rules/error-handling.md",
+  "rules/gates-taxonomy.md",
+  "rules/gsd-planner-antipatterns.md",
+  "rules/htmx.md",
+  "rules/model-routing.md",
+  "rules/nextjs.md",
+  "rules/no-false-ship.md",
+  "rules/playwright-launch.md",
+  "rules/pyside6.md",
+  "rules/seo.md",
+  "rules/shadcn.md",
+  "rules/tauri.md",
+  // agents (5)
+  "agents/build-error-resolver.md",
+  "agents/code-reviewer.md",
+  "agents/plan-checker.md",
+  "agents/security-reviewer.md",
+  "agents/silent-failure-hunter.md",
+  // commands/uzys (7)
+  "commands/uzys/auto.md",
+  "commands/uzys/build.md",
+  "commands/uzys/plan.md",
+  "commands/uzys/review.md",
+  "commands/uzys/ship.md",
+  "commands/uzys/spec.md",
+  "commands/uzys/test.md",
+  // hooks (10)
+  "hooks/agentshield-gate.sh",
+  "hooks/checkpoint-snapshot.sh",
+  "hooks/codebase-map.sh",
+  "hooks/gate-check.sh",
+  "hooks/hito-counter.sh",
+  "hooks/karpathy-gate.sh",
+  "hooks/mcp-pre-exec.sh",
+  "hooks/spec-drift-check.sh",
+  "hooks/task-brief-nudge.sh",
+  "hooks/uncommitted-check.sh"
+];
+var RETIRED_AGENT_IDS = RETIRED_PATHS.filter(
+  (p) => p.startsWith("agents/")
+).map((p) => p.slice("agents/".length).replace(/\.md$/, ""));
 var ALWAYS_HOOKS = ["session-start.sh", "protect-files.sh"];
 var COMMON_SKILL_DIRS = [];
 var DEV_SKILL_DIRS = [];
-var UI_SKILL_DIRS = ["ui-visual-review"];
 function isCliNeutralTarget(target) {
   return target.startsWith(`${INSTALL_LOG_DIR}/`);
 }
@@ -1887,7 +2047,14 @@ function buildManifest(spec) {
       source: `skills/${sd}`,
       target: `.claude/skills/${sd}`,
       type: "dir",
-      applies: (s) => (s.selectedInternalSkills ?? []).includes(sd)
+      // #602 — selectedInternalSkills 가 SSOT(위저드 해제·--without 반영). `tracks` 만 담긴
+      // 스펙(listBaselineTargets·위저드 1단계 등)에서는 카탈로그 조건으로 판정한다 —
+      // buildAssetSpec 와 같은 isAssetSelected 라 두 번 적는 사본이 아니라 같은 원천이다.
+      applies: (s) => s.selectedInternalSkills !== void 0 ? s.selectedInternalSkills.includes(sd) : (
+        // #602 폴백은 트랙 추종 번들 스킬 한정 — 카탈로그 옵트인(compaction-handoff 등)은
+        // 선택 목록 없이는 깔리지 않는다(위저드 해제·--without 의 SSOT 를 우회하는 금이 된다).
+        sd === "ui-visual-review" && isAssetSelected(sd, { tracks: s.tracks, options: { withCodexTrust: false } })
+      )
     });
   }
   for (const sd of DEV_SKILL_DIRS) {
@@ -1898,14 +2065,6 @@ function buildManifest(spec) {
       applies: dev
     });
   }
-  for (const sd of UI_SKILL_DIRS) {
-    m.push({
-      source: `skills/${sd}`,
-      target: `.claude/skills/${sd}`,
-      type: "dir",
-      applies: ui
-    });
-  }
   for (const h of ALWAYS_HOOKS) {
     m.push({
       source: `hooks/${h}`,
@@ -2001,10 +2160,11 @@ export {
   copyDir,
   backupDir,
   copyBackupDir,
-  backupFileIfChanged,
   backupFile,
   listFilesRecursive,
   ensureProjectSkeleton,
+  dirTreesIdentical,
+  backupIfLossyUtf8,
   INSTALL_LOG_FILENAME,
   INSTALL_LOG_DIR,
   POLICY_DIRS,
@@ -2017,17 +2177,19 @@ export {
   collectPolicyHashes,
   writeInstallLog,
   readInstallLog,
+  readInstallLogStatus,
+  corruptedInstallLogMessage,
   installLogPath,
   legacyInstallLogPath,
   buildAssetSpec,
   resolveRules,
-  ALL_RULES,
   TRACK_AGENTS,
   RETIRED_AGENTS,
+  RETIRED_PATHS,
   RETIRED_AGENT_IDS,
   isCliNeutralTarget,
   buildManifest,
   CATEGORIES,
   CATEGORY_TITLES
 };
-//# sourceMappingURL=chunk-MBRLCU5O.js.map
+//# sourceMappingURL=chunk-5T6MDT67.js.map