@uzysjung/agent-harness 26.167.0 → 26.169.0

package/README.ko.md

@@ -173,7 +173,7 @@ your-project/
 | `project-management` | PM 업무 | 없음 |
 | `growth-marketing` | 그로스·콘텐츠 마케팅 | 없음 (`marketingskills` 선택 가능) |
 
-MCP 서버도 함께 들어간다. 모든 트랙에 `context7`(최신 라이브러리 문서)가 들어가고, 웹 트랙(`csr-*`, `ssr-*`, `full`)에는 Google 사용 통계를 끈 `chrome-devtools`가 더해진다. `csr-*`와 `ssr-htmx` 트랙에는 `railway-mcp-server`(Railway 원격 서버 — 처음 쓸 때 로그인한다)가, `csr-supabase`에는 `supabase`가 더해진다. `full`은 둘 다 받는다. `ssr-nextjs`에서는 Railway MCP가 기본이 아니고, 직접 고르면 들어간다. Vercel·GitHub 공식 원격 서버(`vercel`, `github-mcp`)는 미리 체크되지 않는다 — `--with`로 더한다.
+MCP 서버도 함께 들어간다. 모든 트랙에 `context7`(최신 라이브러리 문서)가 들어가고, 웹 트랙(`csr-*`, `ssr-*`, `full`)에는 Google 사용 통계를 끈 `chrome-devtools`가 더해진다. `csr-*`와 `ssr-htmx` 트랙에는 `railway-mcp-server`(Railway 원격 서버 — 처음 쓸 때 로그인한다)가, `csr-supabase`에는 `supabase`(Supabase 원격 서버 — 처음 쓸 때 로그인한다)가 더해진다. `full`은 둘 다 받는다. `ssr-nextjs`에서는 Railway MCP가 기본이 아니고, 직접 고르면 들어간다. Vercel·GitHub 공식 원격 서버(`vercel`, `github-mcp`)는 미리 체크되지 않는다 — `--with`로 더한다. 서버마다 위저드 3단계에 한 줄씩 보이고, 체크를 풀거나 `--without <이름>`(예: `--without context7`)을 주면 `.mcp.json`·Codex·OpenCode 에서 빠진다.
 
 미리 체크되지는 않지만 3단계나 `--with <id>`로 더할 수 있는 것도 있다.
 
@@ -198,7 +198,7 @@ MCP 서버도 함께 들어간다. 모든 트랙에 `context7`(최신 라이브
 
 `update`는 하네스가 설치한 것을 새 버전으로 바꾸고, 새 버전에 추가된 것을 넣고, 없어진 하네스 파일(훅 스크립트, `.mcp.json`의 서버, `AGENTS.md`의 하네스 절 등)을 되살린다. `--without`으로 일부러 뺀 항목은 계속 빠져 있고, 고르지 않은 도구는 설치하지 않는다. `update --only skills`처럼 한 묶음만 업데이트할 수도 있다.
 
-터미널에서 `uninstall`을 실행하면 무엇을 지울지(도구 하나, 고른 항목, 전부) 고를 수 있고, `--dry-run`을 붙이면 지우기 전에 계획을 먼저 보여 준다. 전부 지울 때 `.claude/`, `.codex/`, `.opencode/` 폴더는 삭제하지 않고 `.claude.backup-<시각>`처럼 이름을 바꿔 옆에 남긴다. 그 안에 내가 넣어 둔 파일도 함께 옮겨지니, 필요한 것은 백업 폴더에서 다시 꺼내 쓰면 된다.
+터미널에서 `uninstall`을 실행하면 무엇을 지울지(도구 하나, 고른 항목, 전부) 고를 수 있고, `--dry-run`을 붙이면 지우기 전에 계획을 먼저 보여 준다. 전부 지울 때는 하네스가 쓴 파일만 하나씩 지운다. `.claude/`, `.codex/`, `.opencode/` 안에 내가 넣어 둔 파일은 제자리에 그대로 남고, 하네스가 대신 자리를 차지했던 내 파일은 원래 자리로 되돌려 놓는다.
 
 **이미 진행 중인 프로젝트에 설치해도 된다.** 내가 고친 파일을 바꿔야 할 때는 같은 폴더에 시간이 적힌 백업을 먼저 만들고 그 경로를 알려 준다. 내가 쓰거나 고친 파일은 백업 없이 지우지 않고, 기존 `.mcp.json`의 서버도 덮어쓰지 않고 합친다([기존 프로젝트에 설치하기](docs/USAGE.md#installing-into-an-existing-project)).
 

package/README.md

@@ -166,7 +166,7 @@ A track is a starting setup for a dev stack or a kind of work: the top nine rows
 | `project-management` | PM work | None |
 | `growth-marketing` | Growth and content marketing | None (`marketingskills` available) |
 
-MCP servers come too. Every track gets `context7` (current library docs). Web tracks (`csr-*`, `ssr-*`, `full`) add `chrome-devtools`, with Google's usage statistics turned off. The `csr-*` and `ssr-htmx` tracks add `railway-mcp-server` (Railway's remote server — you sign in on first use), and `csr-supabase` adds `supabase`. `full` gets both. On `ssr-nextjs`, Railway MCP is not a default; pick it if you want it. Vercel's and GitHub's official remote servers (`vercel`, `github-mcp`) are never pre-checked — add them with `--with`.
+MCP servers come too. Every track gets `context7` (current library docs). Web tracks (`csr-*`, `ssr-*`, `full`) add `chrome-devtools`, with Google's usage statistics turned off. The `csr-*` and `ssr-htmx` tracks add `railway-mcp-server` (Railway's remote server — you sign in on first use), and `csr-supabase` adds `supabase` (Supabase's remote server — you sign in on first use). `full` gets both. On `ssr-nextjs`, Railway MCP is not a default; pick it if you want it. Vercel's and GitHub's official remote servers (`vercel`, `github-mcp`) are never pre-checked — add them with `--with`. Each server is a row in step 3 of the wizard: uncheck it or pass `--without <name>` (e.g. `--without context7`) to leave it out of `.mcp.json`, Codex and OpenCode.
 
 More external assets are never pre-checked but can be added at step 3 or with `--with <id>`:
 
@@ -191,7 +191,7 @@ Each track's full set is in [docs/TRACKS.md](docs/TRACKS.md). Every asset's sour
 
 `update` refreshes what the harness installed, adds what a newer release introduced, and puts back harness files that went missing — a hook script, a server in `.mcp.json`, a section of `AGENTS.md`. What you dropped on purpose with `--without` stays out. It never installs a tool you did not choose. `update --only skills` limits it to one group.
 
-In a terminal, `uninstall` offers three choices (one tool, selected assets, or everything), and `--dry-run` shows the plan first. When you remove everything, `.claude/`, `.codex/`, and `.opencode/` are not deleted but renamed to something like `.claude.backup-<time>`. Files you put in them move along, so take back what you need from the backup.
+In a terminal, `uninstall` offers three choices (one tool, selected assets, or everything), and `--dry-run` shows the plan first. When you remove everything, only the files the harness wrote are removed, one by one; your own files in `.claude/`, `.codex/` and `.opencode/` stay where they are, and a file of yours the harness had replaced is put back.
 
 **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)).
 

package/dist/{chunk-KVXCTS6D.js → chunk-SU2RUN2W.js}

@@ -280,6 +280,53 @@ var EXTERNAL_ASSETS = [
     condition: { kind: "has-dev-track" },
     method: { kind: "internal", key: "external-model-consult" }
   },
+  {
+    // #729 (ADR-109) — 토론 정책(참여자 · 독립성 · 라운드 · 예산 · 재시도 · 대체 · 복귀 · 통합)은 이 스킬만
+    //   소유한다. 하위 경로(external-model-consult · 브라우저 위임 3종)는 실행 매개변수와 결과·상태만 맡는다.
+    // has-dev-track 인 이유: 브라우저 전제가 없다 — external-model-consult 의 CLI 둘만으로 "서로 다른 실제 모델 2개"가
+    //   성립하고, 없는 경로는 실행 시점에 unavailable 로 기록한다. DEV_METHOD 에 넣지 않는다(수단 — ADR-105 D2).
+    id: "multi-model-debate",
+    tier: "official",
+    // uzys 자사 스킬
+    description: "Multi-model debate \u2014 two or three different real models answer independently, then only decision-relevant disagreements are cross-examined and checked; uses whichever installed routes are available (external-model-consult CLIs or the browser delegates)",
+    category: "dev-tools",
+    source: "uzys",
+    condition: { kind: "has-dev-track" },
+    method: { kind: "internal", key: "multi-model-debate" }
+  },
+  // #729 (ADR-109, 사용자 결정 2026-10-12) — 브라우저 위임 3종은 opt-in. 실행 전제(브라우저 도구 · 로그인된 브라우저 ·
+  //   그 서비스 계정)가 하네스 밖에 있고 Codex CLI 에는 브라우저가 없다(공식 문서). #489 가 agent-browser 를 opt-in 으로
+  //   내린 축과 같다. 설치는 디렉터리 복사뿐이다 — `--with <id>` · 위저드 체크로 켠다.
+  {
+    id: "gemini-delegate",
+    tier: "official",
+    // uzys 자사 스킬
+    description: "Gemini delegate \u2014 hand design, review, or Korean polishing to Gemini on the web and collect the answer (needs a browser tool + your logged-in browser)",
+    category: "dev-tools",
+    source: "uzys",
+    condition: { kind: "opt-in" },
+    method: { kind: "internal", key: "gemini-delegate" }
+  },
+  {
+    id: "chatgpt-delegate",
+    tier: "official",
+    // uzys 자사 스킬
+    description: "ChatGPT delegate \u2014 hand design, planning, or review to ChatGPT on the web and collect the answer (needs a browser tool + your logged-in browser)",
+    category: "dev-tools",
+    source: "uzys",
+    condition: { kind: "opt-in" },
+    method: { kind: "internal", key: "chatgpt-delegate" }
+  },
+  {
+    id: "genspark-delegate",
+    tier: "official",
+    // uzys 자사 스킬
+    description: "Genspark delegate \u2014 hand design or planning to Genspark AI Chat, or generate and download images with AI Image (needs a browser tool + your logged-in browser)",
+    category: "dev-tools",
+    source: "uzys",
+    condition: { kind: "opt-in" },
+    method: { kind: "internal", key: "genspark-delegate" }
+  },
   {
     // 복원 9종이 아니라 신설이다 — 이관 이력이 없다.
     // 전 트랙인 이유: 위임과 요청 정규화는 개발 트랙의 행위가 아니라 **전 트랙의 행위**다.
@@ -458,6 +505,32 @@ var EXTERNAL_ASSETS = [
     cliSupportOverride: ["claude", "codex", "opencode"],
     method: { kind: "internal", key: "chrome-devtools" }
   },
+  // #751 — Context7 MCP. 트랙 표 행의 패턴 `*` 가 모든 트랙의 기본이라 위저드 3단계에 늘 체크된 채 보이고, 풀거나
+  //   `--without context7` 이면 `.mcp.json` · Codex · OpenCode 세 자리에서 빠진다(#709 · #722 와 같은 경로). 기본값은 그대로다.
+  {
+    id: "context7",
+    tier: "vetted",
+    // upstash/context7 62.9k (REPO_OVERRIDE)
+    description: "Context7 MCP \u2014 current, version-specific library docs for the agent, in .mcp.json, Codex and OpenCode. Default on every track; uncheck it to leave it out",
+    category: "understanding",
+    source: "upstash",
+    condition: { kind: "opt-in" },
+    cliSupportOverride: ["claude", "codex", "opencode"],
+    method: { kind: "internal", key: "context7" }
+  },
+  // #751 — Supabase MCP. 트랙 표 행이 csr-supabase · full 의 기본이고, 이 항목은 그 밖의 트랙에서 고르게 · 기본 트랙에서
+  //   빼게 한다. 서버 정의(명령 · 인자)는 트랙 표 한 곳이다.
+  {
+    id: "supabase",
+    tier: "vetted",
+    // supabase/mcp 2.9k (REPO_OVERRIDE)
+    description: "Supabase's official remote MCP (https://mcp.supabase.com/mcp, signs in with OAuth on first use) in .mcp.json, Codex and OpenCode. Default on csr-supabase \xB7 full; check it to add it on any other track. Only if this project uses Supabase",
+    category: "backend",
+    source: "supabase",
+    condition: { kind: "opt-in" },
+    cliSupportOverride: ["claude", "codex", "opencode"],
+    method: { kind: "internal", key: "supabase" }
+  },
   // === csr-supabase|full CLI ===
   {
     id: "vercel-cli",
@@ -603,7 +676,7 @@ var EXTERNAL_ASSETS = [
       pluginId: "security-guidance@claude-plugins-official"
     }
   },
-  // v26.110.0 (ADR-039) — context7 플러그인은 **미등록** (검토 후 철회): templates/mcp.json ·
+  // v26.110.0 (ADR-039) — context7 플러그인은 **미등록** (검토 후 철회): 트랙 표(#751 전 templates/mcp.json) ·
   //   codex config.toml.template · opencode 설정이 이미 @upstash/context7-mcp 를 기본 wiring —
   //   플러그인 추가 = 동일 서버 중복 등록이고 도달 범위도 더 좁다(plugin=claude-only vs
   //   템플릿=claude+codex+opencode). "문서 조회 기본 제공" 요구는 기충족.
@@ -935,7 +1008,12 @@ var INTERNAL_BUNDLED_SKILL_IDS = [
   "model-orchestration",
   "external-model-consult",
   "self-hosted-github-runner",
-  "natural-korean"
+  "natural-korean",
+  // #729 (ADR-109) — 토론(개발 트랙 기본) + 브라우저 위임 3종(opt-in). condition 이 설치를 가른다.
+  "multi-model-debate",
+  "gemini-delegate",
+  "chatgpt-delegate",
+  "genspark-delegate"
 ];
 var CONTINUOUS_SKILLS = [
   {
@@ -1038,14 +1116,14 @@ init_esm_shims();
 
 // src/install-log.ts
 init_esm_shims();
-import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync as rmSync2, statSync, writeFileSync } from "fs";
+import { createHash } from "crypto";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync, statSync, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname3, join as join4 } from "path";
 
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.167.0",
+  version: "26.169.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: {
@@ -1183,7 +1261,6 @@ function targetsInclude(targets, base) {
 
 // src/fs-ops.ts
 init_esm_shims();
-import { createHash } from "crypto";
 import {
   copyFileSync,
   existsSync,
@@ -1191,12 +1268,7 @@ import {
   mkdirSync,
   readdirSync,
   readFileSync,
-  readlinkSync as readlinkSync2,
-  realpathSync as realpathSync2,
-  renameSync,
-  rmdirSync,
-  rmSync,
-  symlinkSync
+  writeFileSync
 } from "fs";
 import { dirname as dirname2, join as join2 } from "path";
 
@@ -1325,48 +1397,19 @@ function claimBackupPath(base, claim) {
   }
   throw new Error(`Cannot allocate a backup path for ${base} (${MAX_BACKUP_CLAIMS} taken)`);
 }
-function backupDir(target, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync(target)) {
-    return null;
-  }
-  const backup = claimBackupPath(`${target}.backup-${formatStamp(now)}`, (c) => mkdirSync(c));
-  rmdirSync(backup);
-  renameSync(target, backup);
-  return backup;
-}
-function copyBackupDir(target, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync(target)) {
-    return null;
-  }
-  const backup = claimBackupPath(`${target}.backup-${formatStamp(now)}`, (c) => mkdirSync(c));
-  try {
-    copyTreePreservingLinks(realpathSync2(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 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(readlinkSync2(src), dst);
-      continue;
-    }
-    if (entry.isDirectory()) copyTreePreservingLinks(src, dst);
-    else if (entry.isFile()) copyFile(src, dst);
-  }
-}
 function backupFile(target, now = /* @__PURE__ */ new Date()) {
   return claimBackupPath(
     `${target}.backup-${formatStamp(now)}`,
     (c) => copyFileSync(target, c, fsConstants.COPYFILE_EXCL)
   );
 }
+function backupContent(target, content, now = /* @__PURE__ */ new Date()) {
+  mkdirSync(dirname2(target), { recursive: true });
+  return claimBackupPath(
+    `${target}.backup-${formatStamp(now)}`,
+    (c) => writeFileSync(c, content, { flag: "wx" })
+  );
+}
 function backupOriginal(backupPath) {
   const m = /^(.+)\.backup-\d{8}T\d{6}(?:-\d+)?$/.exec(backupPath);
   return m?.[1] ?? null;
@@ -1387,44 +1430,20 @@ function listFilesRecursive(dir, prefix = "") {
 function formatStamp(now) {
   return now.toISOString().replace(/[-:]/g, "").replace(/\.\d+Z$/, "Z").slice(0, 15);
 }
+var PROJECT_SKELETON_DIRS = [
+  ".claude/commands/uzys",
+  ".claude/rules",
+  ".claude/skills",
+  ".claude/agents",
+  ".claude/hooks",
+  "docs/decisions"
+];
 function ensureProjectSkeleton(projectDir) {
-  const dirs = [
-    ".claude/commands/uzys",
-    ".claude/rules",
-    ".claude/skills",
-    ".claude/agents",
-    ".claude/hooks",
-    "docs/decisions"
-  ];
-  for (const d of dirs) {
+  for (const d of PROJECT_SKELETON_DIRS) {
     if (outsideProjectTarget(projectDir, join2(projectDir, d)) !== null) continue;
     mkdirSync(join2(projectDir, d), { recursive: true });
   }
 }
-function dirTreesIdentical(a, b) {
-  if (!existsSync(a) || !existsSync(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:${readlinkSync2(join2(root, r))}`);
-      else if (e.isDirectory()) signature(root, r, out);
-      else if (e.isFile()) {
-        out.set(
-          r,
-          createHash("sha256").update(readFileSync(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 (!existsSync(target)) return null;
   let raw;
@@ -1641,7 +1660,7 @@ function mergeAssets(previous, current) {
   ];
 }
 function hashContent(content) {
-  return createHash2("sha256").update(content, "utf8").digest("hex");
+  return createHash("sha256").update(content, "utf8").digest("hex");
 }
 function isHarnessOwned(baseline, key, current) {
   const recorded = baseline.get(key);
@@ -1679,7 +1698,7 @@ function writeInstallLog(projectDir, log) {
   const path2 = installLogPath(projectDir);
   mkdirSync2(dirname3(path2), { recursive: true });
   const marked = { ...normalizeLogOrder(log), excludedKeysMigrated: true };
-  writeFileSync(path2, `${JSON.stringify(marked, null, 2)}
+  writeFileSync2(path2, `${JSON.stringify(marked, null, 2)}
 `, "utf8");
   migrateAwayLegacyLog(projectDir);
   return path2;
@@ -1701,7 +1720,7 @@ function migrateAwayLegacyLog(projectDir) {
   const legacy = legacyInstallLogPath(projectDir);
   if (!existsSync2(legacy)) return;
   try {
-    rmSync2(legacy);
+    rmSync(legacy);
   } catch {
   }
 }
@@ -2216,6 +2235,14 @@ var RETIRED_PATHS = [
   "hooks/task-brief-nudge.sh",
   "hooks/uncommitted-check.sh"
 ];
+var RETIRED_HOOK_WIRING_REFS = [
+  // 6617766 (2026-04-14, phase4b) 배선 → c8fdef1 (2026-05-03, CL-v2 observer 중복 fire 제거) 제거.
+  // PreToolUse · PostToolUse 각각 matcher "*" 묶음 하나 — `observe.sh pre|post`, async.
+  "skills/continuous-learning-v2/hooks/observe.sh",
+  // 5defc58 (2026-04-14, wire strategic-compact) 배선 → a125453 (2026-09-13, #444 스킬 3종 은퇴) 제거.
+  // PreToolUse 의 protect-files 묶음 안 두 번째 핸들러, async.
+  "skills/strategic-compact/suggest-compact.sh"
+];
 var RETIRED_AGENT_IDS = RETIRED_PATHS.filter(
   (p) => p.startsWith("agents/")
 ).map((p) => p.slice("agents/".length).replace(/\.md$/, ""));
@@ -2605,13 +2632,12 @@ export {
   ensureDir,
   copyFile,
   copyDir,
-  backupDir,
-  copyBackupDir,
   backupFile,
+  backupContent,
   backupOriginal,
   listFilesRecursive,
+  PROJECT_SKELETON_DIRS,
   ensureProjectSkeleton,
-  dirTreesIdentical,
   backupIfLossyUtf8,
   HARNESS_ANCHOR_FILE,
   HARNESS_IMPORT_LINE,
@@ -2630,6 +2656,7 @@ export {
   TRACK_AGENTS,
   RETIRED_AGENTS,
   RETIRED_PATHS,
+  RETIRED_HOOK_WIRING_REFS,
   RETIRED_AGENT_IDS,
   isCliNeutralTarget,
   buildManifest,
@@ -2641,6 +2668,7 @@ export {
   LEGACY_INSTALL_LOG_DIR,
   POLICY_DIRS,
   installedClis,
+  buildAssetEntries,
   buildInstallLog,
   mergeRootFiles,
   hashContent,
@@ -2671,4 +2699,4 @@ export {
   CATEGORIES,
   CATEGORY_TITLES
 };
-//# sourceMappingURL=chunk-KVXCTS6D.js.map
+//# sourceMappingURL=chunk-SU2RUN2W.js.map