@uzysjung/agent-harness 26.153.0 → 26.155.0

package/dist/{chunk-OYNSK6QF.js → chunk-SC6ORMHV.js}

@@ -40,6 +40,8 @@ var init_esm_shims = __esm({
 // src/types.ts
 init_esm_shims();
 var TRACKS = [
+  // #456 (2026-09-20) — 스택 무관: 원칙·방법론·테스트 스킬만. 스택을 아직 안 정한 프로젝트용.
+  "base",
   "tooling",
   "csr-supabase",
   "csr-fastify",
@@ -70,6 +72,14 @@ var DEFAULT_OPTIONS = {
   withPrune: false,
   withCodexTrust: false
 };
+var UPDATE_GROUPS = [
+  "skills",
+  "new-skills",
+  "rules",
+  "anchor",
+  "hooks",
+  "external"
+];
 
 // src/external-assets.ts
 init_esm_shims();
@@ -83,7 +93,7 @@ function anyTrack(tracks, pattern) {
   return tracks.some((t) => matchTrack(t, pattern));
 }
 function hasDevTrack(tracks) {
-  return anyTrack(tracks, "csr-*|ssr-*|data|full|tooling");
+  return anyTrack(tracks, "csr-*|ssr-*|data|full|tooling|base");
 }
 function hasUiTrack(tracks) {
   return anyTrack(tracks, "csr-*|ssr-*|full");
@@ -94,6 +104,7 @@ function globToRegex(pattern) {
 }
 
 // src/external-assets.ts
+var DEV_TRACKS_WITH_STACK = TRACKS.filter((t) => t !== "base" && hasDevTrack([t]));
 var CSR_SSR_NEXTJS_FULL = [
   "csr-supabase",
   "csr-fastify",
@@ -487,7 +498,7 @@ var EXTERNAL_ASSETS = [
     description: "frontend-design \u2014 distinctive production-grade UI generation (Anthropic official, avoids generic AI aesthetics)",
     category: "frontend",
     source: "anthropics",
-    condition: { kind: "has-dev-track" },
+    condition: { kind: "any-track", tracks: DEV_TRACKS_WITH_STACK },
     method: { kind: "skill", source: "anthropics/skills", skill: "frontend-design" }
   },
   // 2026-08-02 정비 — 프론트엔드 품질 3종 (사용자 지시). 전부 opt-in: frontend-design 이 기본
@@ -598,7 +609,7 @@ var EXTERNAL_ASSETS = [
     description: "find-skills \u2014 search \xB7 rank all installed skills (vercel-labs, all dev tracks)",
     category: "dev-tools",
     source: "vercel-labs",
-    condition: { kind: "has-dev-track" },
+    condition: { kind: "any-track", tracks: DEV_TRACKS_WITH_STACK },
     method: { kind: "skill", source: "vercel-labs/skills", skill: "find-skills" }
   },
   // v26.110.0 (ADR-039) — context7 플러그인은 **미등록** (검토 후 철회): templates/mcp.json ·
@@ -613,7 +624,7 @@ var EXTERNAL_ASSETS = [
     // v26.78.0 — Understanding 으로 재분류: 웹 지각(screenshot·DOM). 영상/코드 지각과 같은 축.
     category: "understanding",
     source: "vercel-labs",
-    condition: { kind: "has-dev-track" },
+    condition: { kind: "any-track", tracks: DEV_TRACKS_WITH_STACK },
     method: { kind: "npm", pkg: "agent-browser", version: "0.31.0" }
   },
   // v26.78.0 — Understanding 신규 3종 (plugin, opt-in). 에이전트 인지 증강: 영상·코드 지각 + 메모리.
@@ -1120,135 +1131,513 @@ function filterApplicableAssets(assets, ctx) {
   return assets.filter((a) => shouldInstallAsset(a, ctx));
 }
 
-// src/manifest.ts
+// src/context-cost.ts
 init_esm_shims();
+import { existsSync, readFileSync } from "fs";
+import { join, resolve } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
-// src/install-log.ts
+// src/project-claude-merge.ts
 init_esm_shims();
-import { createHash } from "crypto";
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, rmSync, writeFileSync } from "fs";
-import { dirname as dirname2, join as join2 } from "path";
+var HARNESS_ANCHOR_FILE = "CLAUDE-uzys-harness.md";
+var HARNESS_IMPORT_LINE = `@${HARNESS_ANCHOR_FILE}`;
+var IMPORT_MARKER_START = "<!-- uzys-harness:import:start -->";
+var IMPORT_MARKER_END = "<!-- uzys-harness:import:end -->";
+function renderContinuousSkillsNote(selectedInternalSkills) {
+  const lines = CONTINUOUS_SKILLS.filter((s) => selectedInternalSkills.includes(s.id)).map(
+    (s) => `- \`${s.id}\` \u2014 ${s.whenToApply}.`
+  );
+  if (lines.length === 0) return "";
+  return [
+    "## Skills that apply continuously",
+    "",
+    "These installed skills apply to every response or delegation; no prompt ever looks like their job, so open them from this list:",
+    "",
+    ...lines
+  ].join("\n");
+}
+function withContinuousSkillsNote(scaffold, selectedInternalSkills) {
+  const note = renderContinuousSkillsNote(selectedInternalSkills);
+  return note ? `${scaffold}
 
-// src/fs-ops.ts
-init_esm_shims();
-import {
-  copyFileSync,
-  cpSync,
-  existsSync,
-  constants as fsConstants,
-  mkdirSync,
-  readdirSync,
-  readFileSync,
-  realpathSync,
-  renameSync,
-  rmdirSync
-} from "fs";
-import { dirname, join } from "path";
-function ensureDir(path2) {
-  mkdirSync(path2, { recursive: true });
+${note}` : scaffold;
 }
-function copyFile(source, target) {
-  if (!existsSync(source)) {
-    throw new Error(`Source not found: ${source}`);
-  }
-  mkdirSync(dirname(target), { recursive: true });
-  copyFileSync(source, target);
+function importBlock(continuousSkills) {
+  const note = renderContinuousSkillsNote(continuousSkills);
+  const body = note ? `${HARNESS_IMPORT_LINE}
+
+${note}` : HARNESS_IMPORT_LINE;
+  return `${IMPORT_MARKER_START}
+${body}
+${IMPORT_MARKER_END}`;
 }
-function copyDir(source, target, foreignOf) {
-  if (!existsSync(source)) {
-    throw new Error(`Source dir not found: ${source}`);
+var TRACK_DISPLAY_NAMES = {
+  base: "Base",
+  tooling: "Tooling",
+  "csr-supabase": "CSR Supabase",
+  "csr-fastify": "CSR Fastify",
+  "csr-fastapi": "CSR FastAPI",
+  "ssr-htmx": "SSR HTMX",
+  "ssr-nextjs": "SSR Next.js",
+  data: "Data",
+  executive: "Executive",
+  full: "Full",
+  "project-management": "Project Management",
+  "growth-marketing": "Growth Marketing"
+};
+var FULL_EXPANSION = TRACKS.filter((t) => t !== "full");
+var FILL_SECTIONS = [
+  "identity",
+  "stack",
+  "architecture",
+  "installed-assets",
+  "boundaries",
+  "verify"
+];
+var FILL_SPECS = {
+  identity: {
+    title: "Identity & Purpose",
+    prompt: `Replace the H1 title above with this project's real name, then state in 1-2 plain sentences what it does, who uses it, and why it exists. Sources: README.md, the package.json / pyproject.toml "description", docs/. Do NOT describe the harness itself. Delete this comment when done.`,
+    placeholder: "what this project is, who it is for, and why it exists"
+  },
+  stack: {
+    title: "Stack & Commands",
+    prompt: "Replace the list below with this project's REAL stack. Inspect package.json / pyproject.toml / go.mod / Cargo.toml / Gemfile + lockfiles and any Makefile/justfile/package scripts. List the language(s)+versions, framework(s), package manager, and the exact install/build/test/run commands. Verify each command exists before writing it \u2014 never guess. Delete lines that do not apply, then delete this comment.",
+    placeholder: "languages, runtimes, package manager, and the install/build/test/run commands"
+  },
+  architecture: {
+    title: "Architecture & Layout",
+    prompt: "Map this repository. List each top-level source directory and what it holds, the entry point(s), the 3-5 files a newcomer reads first, and how data/requests flow between the main layers. View the real tree (e.g. `git ls-files | sed 's#/.*##' | sort -u`) \u2014 do not assume a framework's conventional layout. Flag any generated/vendored directories that must never be hand-edited. If this is a single small module, say so in one line. Delete this comment when done.",
+    placeholder: "where things live, the entry points, and how data flows between layers"
+  },
+  "installed-assets": {
+    title: "Installed Harness Assets",
+    prompt: "List the harness assets installed in this project (rules / skills / agents / commands) and add one line each on when to reach for it here. Verify against .claude/rules/*.md, .claude/skills/, .claude/agents/, .claude/commands/ (or this CLI's equivalent) and list ONLY assets whose file exists on disk \u2014 do not invent any. Do NOT restate the harness's working principles (they live in this project's harness anchor and rules layer) \u2014 cross-reference them instead. Delete this comment when done.",
+    placeholder: "the installed rules/skills/agents/commands and when to use each"
+  },
+  boundaries: {
+    title: "Boundaries \u2014 Always / Ask First / Never",
+    prompt: `Fill the Always / Ask First / Never lists with this repo's real red lines. Read the CI config, CODEOWNERS, .gitignore, and release/deploy scripts. Never must include secrets, generated files, force-push, and direct commits to the default branch, plus any repo-specific "do not touch" directories. Every entry must be specific and enforceable here. Delete this comment when done.`,
+    placeholder: "what to always do, ask before doing, and never do in this repo"
+  },
+  verify: {
+    title: "Verification Gate",
+    prompt: 'State the single command (or short sequence) that PROVES a change is safe here \u2014 the test/lint/typecheck/build gate you run before committing \u2014 plus the coverage/CI threshold and what "done" means. Sources: package scripts, CI workflow files, CONTRIBUTING. An agent must be able to self-verify without guessing. Delete this comment when done.',
+    placeholder: "the single command that proves a change is safe, and the done bar"
   }
-  mkdirSync(target, { recursive: true });
-  const skipped = [];
-  for (const rel of listFilesRecursive(source)) {
-    const foreign = foreignOf(rel);
-    if (foreign !== null) {
-      skipped.push(foreign);
-      continue;
-    }
-    copyFile(join(source, rel), join(target, rel));
+};
+function anchorLine(surface) {
+  if (surface === "claude") {
+    return `> The working principles live in this project's harness anchor \`${HARNESS_ANCHOR_FILE}\`, imported at the bottom of this file. Everything above that import is **project-specific context only**.`;
   }
-  return skipped;
+  const self = surface === "antigravity-rule" ? "`.agents/rules/uzys-harness.md`" : "`AGENTS.md`";
+  return `> **This file (${self}) is the harness anchor** \u2014 it carries the working principles in full, further down. Only the \`## \u2026\` sections immediately below are project-specific context for you to fill in.`;
 }
-var MAX_BACKUP_CLAIMS = 100;
-function claimBackupPath(base, claim) {
-  for (let n = 1; n <= MAX_BACKUP_CLAIMS; n++) {
-    const candidate = n === 1 ? base : `${base}-${n}`;
-    try {
-      claim(candidate);
-      return candidate;
-    } catch (err) {
-      if (err.code !== "EEXIST") throw err;
-    }
-  }
-  throw new Error(`Cannot allocate a backup path for ${base} (${MAX_BACKUP_CLAIMS} taken)`);
+function scaffoldBanner(surface) {
+  return [
+    "> \u2699\uFE0F **SCAFFOLD \u2014 not filled in yet.** The sections below are a fill-in template for THIS project, not verified facts.",
+    "> To fill: open this file and paste each `<!-- FILL: \u2026 -->` comment's instruction into your coding agent (e.g. Claude Code) \u2014 it will inspect the real repo and write the section. You can also fill them by hand; the comments are the instructions.",
+    anchorLine(surface)
+  ].join("\n");
 }
-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 renderFillScaffold(surface = "claude") {
+  const blocks = FILL_SECTIONS.map((id) => {
+    const spec = FILL_SPECS[id];
+    return `## ${spec.title}
+
+<!-- FILL:${id} \u2014 ${spec.prompt} -->
+
+_(not filled yet \u2014 ${spec.placeholder})_`;
+  });
+  return `${scaffoldBanner(surface)}
+
+${blocks.join("\n\n")}`;
 }
-function copyBackupDir(target, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync(target)) {
-    return null;
-  }
-  const backup = claimBackupPath(`${target}.backup-${formatStamp(now)}`, (c) => mkdirSync(c));
-  cpSync(realpathSync(target), backup, { recursive: true });
-  return backup;
+function mergeProjectClaude(opts) {
+  const expanded = expandTracks(opts.tracks);
+  const trackList = expanded.map((t) => TRACK_DISPLAY_NAMES[t]).join(", ");
+  const header = `# ${opts.projectName}
+
+> Active track(s): ${trackList}`;
+  return `${header}
+
+${renderFillScaffold()}
+`;
 }
-function backupFileIfChanged(target, newContent, now = /* @__PURE__ */ new Date()) {
-  if (!existsSync(target)) {
-    return null;
+function upsertHarnessImport(existing, opts) {
+  const block = importBlock(opts.continuousSkills ?? []);
+  if (existing === null) {
+    return `${mergeProjectClaude(opts)}
+${block}
+`;
   }
-  if (readFileSync(target, "utf-8") === newContent) {
-    return null;
+  const start = existing.indexOf(IMPORT_MARKER_START);
+  if (start !== -1) {
+    const endAt = existing.indexOf(IMPORT_MARKER_END, start);
+    if (endAt === -1) return existing;
+    const current = existing.slice(start, endAt + IMPORT_MARKER_END.length);
+    if (current === block) return existing;
+    return `${existing.slice(0, start)}${block}${existing.slice(endAt + IMPORT_MARKER_END.length)}`;
   }
-  return backupFile(target, now);
+  if (hasHarnessImport(existing)) {
+    return existing;
+  }
+  const body = existing.endsWith("\n") ? existing : `${existing}
+`;
+  return `${body}
+${block}
+`;
 }
-function backupFile(target, now = /* @__PURE__ */ new Date()) {
-  return claimBackupPath(
-    `${target}.backup-${formatStamp(now)}`,
-    (c) => copyFileSync(target, c, fsConstants.COPYFILE_EXCL)
-  );
+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}`;
 }
-function listFilesRecursive(dir, prefix = "") {
-  if (!existsSync(dir)) return [];
-  const out = [];
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
-    if (entry.isDirectory()) {
-      out.push(...listFilesRecursive(join(dir, entry.name), rel));
-    } else if (entry.isFile()) {
-      out.push(rel);
+function hasHarnessImport(text) {
+  if (text.includes(IMPORT_MARKER_START)) return true;
+  let inFence = false;
+  for (const line of text.split("\n")) {
+    if (/^\s*(?:```|~~~)/.test(line)) {
+      inFence = !inFence;
+      continue;
     }
+    if (!inFence && line.trim() === HARNESS_IMPORT_LINE) return true;
   }
-  return out;
-}
-function formatStamp(now) {
-  return now.toISOString().replace(/[-:]/g, "").replace(/\.\d+Z$/, "Z").slice(0, 15);
+  return false;
 }
-function ensureProjectSkeleton(projectDir) {
-  const dirs = [
-    ".claude/commands/uzys",
-    ".claude/rules",
-    ".claude/skills",
-    ".claude/agents",
-    ".claude/hooks",
-    "docs/decisions"
-  ];
-  for (const d of dirs) {
-    mkdirSync(join(projectDir, d), { recursive: true });
+function expandTracks(tracks) {
+  if (tracks.includes("full")) {
+    return FULL_EXPANSION;
   }
+  return tracks;
 }
 
-// src/install-log.ts
-var INSTALL_LOG_FILENAME = ".harness-install.json";
-var INSTALL_LOG_DIR = ".uzys-agent-harness";
-var LEGACY_INSTALL_LOG_DIR = ".claude";
+// src/context-cost.ts
+var CHARS_PER_TOKEN = 4;
+function estimateTokens(chars) {
+  return Math.ceil(chars / CHARS_PER_TOKEN);
+}
+function resolveBundleRoot() {
+  return resolve(fileURLToPath2(new URL(".", import.meta.url)), "..");
+}
+function extractFrontmatter(content) {
+  const m = content.match(/^?---\r?\n([\s\S]*?)\r?\n---/);
+  return m?.[1] ?? null;
+}
+function assetDescriptorTokens(assetId, root = resolveBundleRoot()) {
+  const asset = EXTERNAL_ASSETS.find((a) => a.id === assetId);
+  if (!asset || asset.method.kind !== "internal") return null;
+  const skillMd = join(root, "templates", "skills", asset.method.key, "SKILL.md");
+  if (!existsSync(skillMd)) return null;
+  const fm = extractFrontmatter(readFileSync(skillMd, "utf8"));
+  return fm === null ? null : estimateTokens(fm.length);
+}
+function assetBodyTokens(assetId, root = resolveBundleRoot()) {
+  const asset = EXTERNAL_ASSETS.find((a) => a.id === assetId);
+  if (!asset || asset.method.kind !== "internal") return null;
+  const skillMd = join(root, "templates", "skills", asset.method.key, "SKILL.md");
+  if (!existsSync(skillMd)) return null;
+  const content = readFileSync(skillMd, "utf8");
+  const fm = extractFrontmatter(content);
+  if (fm === null) return estimateTokens(content.length);
+  const close = content.indexOf("\n---", content.indexOf(fm) + fm.length);
+  const body = close === -1 ? "" : content.slice(close + "\n---".length);
+  return estimateTokens(body.trim().length);
+}
+function assetCostRows(assetIds, root = resolveBundleRoot()) {
+  return assetIds.map((id) => ({
+    id,
+    descriptorTokens: assetDescriptorTokens(id, root),
+    bodyTokens: assetBodyTokens(id, root)
+  })).sort((a, b) => (b.bodyTokens ?? -1) - (a.bodyTokens ?? -1));
+}
+function makeResidentCost(base) {
+  return {
+    ...base,
+    perSkillDescriptor: base.perSkillDescriptor ?? {},
+    total: base.rules + base.projectClaudeMd + base.skillDescriptors + base.agentDescriptors,
+    directive: {
+      items: base.items.rules + base.items.claudeMd,
+      tokens: base.rules + base.projectClaudeMd
+    },
+    firing: {
+      items: base.items.skills + base.items.agents,
+      tokens: base.skillDescriptors + base.agentDescriptors
+    }
+  };
+}
+function fileTokens(path2) {
+  return existsSync(path2) ? estimateTokens(readFileSync(path2, "utf8").trim().length) : 0;
+}
+function descriptorTokens(path2) {
+  if (!existsSync(path2)) return 0;
+  const fm = extractFrontmatter(readFileSync(path2, "utf8"));
+  return fm === null ? 0 : estimateTokens(fm.length);
+}
+function landsOnDisk(target, cli) {
+  if (target.startsWith(".claude/agents/")) return cli.includes("claude");
+  return true;
+}
+function residentCost(entries, root = resolveBundleRoot()) {
+  const tpl = (source) => join(root, "templates", source);
+  const measured = (e) => e.file ?? tpl(e.source);
+  const perSkill = {};
+  let rules = 0;
+  let skillDescriptors = 0;
+  let agentDescriptors = 0;
+  let ruleItems = 0;
+  let skillItems = 0;
+  let agentItems = 0;
+  for (const e of entries) {
+    if (e.target.startsWith(".claude/rules/")) {
+      rules += fileTokens(measured(e));
+      ruleItems += 1;
+    } else if (e.target.startsWith(".claude/agents/")) {
+      agentDescriptors += descriptorTokens(measured(e));
+      agentItems += 1;
+    } else if (e.target.startsWith(".claude/skills/")) {
+      const t = descriptorTokens(join(measured(e), "SKILL.md"));
+      skillDescriptors += t;
+      skillItems += 1;
+      const id = /\.claude\/skills\/([^/]+)/.exec(e.target)?.[1];
+      if (id !== void 0) perSkill[id] = (perSkill[id] ?? 0) + t;
+    }
+  }
+  const harnessAnchor = fileTokens(join(root, "templates", "CLAUDE.md"));
+  const projectScaffold = estimateTokens(
+    withContinuousSkillsNote(
+      renderFillScaffold(),
+      CONTINUOUS_SKILLS.map((s) => s.id)
+    ).trim().length
+  );
+  const projectClaudeMd = harnessAnchor + projectScaffold;
+  const claudeMdItems = (harnessAnchor > 0 ? 1 : 0) + (projectScaffold > 0 ? 1 : 0);
+  return makeResidentCost({
+    rules,
+    projectClaudeMd,
+    skillDescriptors,
+    agentDescriptors,
+    perSkillDescriptor: perSkill,
+    items: {
+      rules: ruleItems,
+      skills: skillItems,
+      agents: agentItems,
+      claudeMd: claudeMdItems,
+      total: ruleItems + skillItems + agentItems + claudeMdItems
+    }
+  });
+}
+function summarizeContextCost(assetIds, root = resolveBundleRoot()) {
+  let measuredTokens = 0;
+  let measuredCount = 0;
+  let unmeasuredCount = 0;
+  for (const id of assetIds) {
+    const tokens = assetDescriptorTokens(id, root);
+    if (tokens === null) unmeasuredCount += 1;
+    else {
+      measuredTokens += tokens;
+      measuredCount += 1;
+    }
+  }
+  return { measuredTokens, measuredCount, unmeasuredCount };
+}
+function formatResidentCostLine(r, unmeasuredCount) {
+  if (r.total === 0) return null;
+  const parts = [
+    `directives ${r.directive.items} ~${r.directive.tokens}`,
+    `[rules ${r.items.rules} ~${r.rules} \xB7 CLAUDE.md ${r.items.claudeMd} ~${r.projectClaudeMd}]`,
+    `triggers ${r.firing.items} ~${r.firing.tokens}`,
+    `[skills ${r.items.skills} ~${r.skillDescriptors} \xB7 agents ${r.items.agents} ~${r.agentDescriptors}]`
+  ].join(" \xB7 ");
+  const external = unmeasuredCount > 0 ? ` \xB7 ${unmeasuredCount} external asset${unmeasuredCount === 1 ? "" : "s"} unmeasured` : "";
+  return `session-start context cost: ${r.items.total} items resident \xB7 ~${r.total} tokens/session (${parts}${external})`;
+}
+var RESIDENT_ROWS = [
+  {
+    // ADR-083 — 축 소계를 **행으로** 낸다. 소계가 없으면 읽는 사람이 네 줄을 머리로 더해야
+    // 하고, 그러면 "무엇을 줄여야 하나"가 표에서 안 보인다.
+    label: "\uC9C0\uC2DC\uBB38",
+    gap: 13,
+    count: (r) => r.directive.items,
+    tokens: (r) => r.directive.tokens
+  },
+  { label: "  rules", gap: 12, count: (r) => r.items.rules, tokens: (r) => r.rules },
+  {
+    // 한 행에 두 파일(앵커 + 스캐폴드). 개수 열이 2 를 뱉어 그 사실을 드러낸다 — 라벨로
+    // 하나만 이름 붙이면 v26.140.0 이전과 같은 거짓 라벨이 된다.
+    label: "  CLAUDE.md",
+    gap: 8,
+    count: (r) => r.items.claudeMd,
+    tokens: (r) => r.projectClaudeMd
+  },
+  {
+    label: "\uBC1C\uD654 \uD45C\uBA74",
+    gap: 10,
+    count: (r) => r.firing.items,
+    tokens: (r) => r.firing.tokens
+  },
+  {
+    label: "  skill descriptors",
+    gap: 0,
+    count: (r) => r.items.skills,
+    tokens: (r) => r.skillDescriptors
+  },
+  {
+    label: "  agent descriptors",
+    gap: 0,
+    count: (r) => r.items.agents,
+    tokens: (r) => r.agentDescriptors
+  }
+];
+function formatResidentCostBlock(r) {
+  const n = (v) => String(v).padStart(3);
+  return [
+    "                       \uAC1C\uC218    \uD1A0\uD070",
+    ...RESIDENT_ROWS.map(
+      (row) => `  ${row.label}${" ".repeat(row.gap)}${n(row.count(r))}\uAC1C  ~${row.tokens(r)}`
+    ),
+    "  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+    `  \uC0C1\uC8FC \uD569\uACC4          ${n(r.items.total)}\uAC1C \uC0C1\uC8FC \xB7 ~${r.total} tokens/\uC138\uC158`,
+    "",
+    "  \uC9C0\uC2DC\uBB38 = \uC6B0\uB9AC\uAC00 \uD56D\uC0C1 \uC77D\uD788\uAC8C \uB123\uC740 \uAC83. **\uC791\uC744\uC218\uB85D \uC88B\uC740 \uAC12\uC774 \uC544\uB2C8\uB2E4** \u2014 \uD310\uB2E8\uC740",
+    "           '\uBD88\uD544\uC694\uD55C \uC9C0\uC2DC\uBB38\uC774 \uC788\uB098'\uB85C \uD55C\uB2E4. ratchet \uC740 \uC870\uC6A9\uD55C \uC99D\uAC00\uB9CC \uB9C9\uB294\uB2E4.",
+    "  \uBC1C\uD654 \uD45C\uBA74 = \uC2A4\uD0AC\xB7\uC5D0\uC774\uC804\uD2B8\uAC00 \uBD88\uB9AC\uB824\uACE0 \uC0C1\uC8FC\uC2DC\uD0A4\uB294 descriptor. \uAE4E\uC73C\uBA74 \uC548 \uBD88\uB9B0\uB2E4."
+  ];
+}
+
+// src/manifest.ts
+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 { dirname as dirname2, join as join3 } from "path";
+
+// src/fs-ops.ts
+init_esm_shims();
+import {
+  copyFileSync,
+  cpSync,
+  existsSync as existsSync2,
+  constants as fsConstants,
+  mkdirSync,
+  readdirSync,
+  readFileSync as readFileSync2,
+  realpathSync,
+  renameSync,
+  rmdirSync
+} from "fs";
+import { dirname, join as join2 } from "path";
+function ensureDir(path2) {
+  mkdirSync(path2, { recursive: true });
+}
+function copyFile(source, target) {
+  if (!existsSync2(source)) {
+    throw new Error(`Source not found: ${source}`);
+  }
+  mkdirSync(dirname(target), { recursive: true });
+  copyFileSync(source, target);
+}
+function copyDir(source, target, foreignOf) {
+  if (!existsSync2(source)) {
+    throw new Error(`Source dir not found: ${source}`);
+  }
+  mkdirSync(target, { recursive: true });
+  const skipped = [];
+  for (const rel of listFilesRecursive(source)) {
+    const foreign = foreignOf(rel);
+    if (foreign !== null) {
+      skipped.push(foreign);
+      continue;
+    }
+    copyFile(join2(source, rel), join2(target, rel));
+  }
+  return skipped;
+}
+var MAX_BACKUP_CLAIMS = 100;
+function claimBackupPath(base, claim) {
+  for (let n = 1; n <= MAX_BACKUP_CLAIMS; n++) {
+    const candidate = n === 1 ? base : `${base}-${n}`;
+    try {
+      claim(candidate);
+      return candidate;
+    } catch (err) {
+      if (err.code !== "EEXIST") throw err;
+    }
+  }
+  throw new Error(`Cannot allocate a backup path for ${base} (${MAX_BACKUP_CLAIMS} taken)`);
+}
+function backupDir(target, now = /* @__PURE__ */ new Date()) {
+  if (!existsSync2(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 (!existsSync2(target)) {
+    return null;
+  }
+  const backup = claimBackupPath(`${target}.backup-${formatStamp(now)}`, (c) => mkdirSync(c));
+  cpSync(realpathSync(target), backup, { recursive: true });
+  return backup;
+}
+function backupFileIfChanged(target, newContent, now = /* @__PURE__ */ new Date()) {
+  if (!existsSync2(target)) {
+    return null;
+  }
+  if (readFileSync2(target, "utf-8") === newContent) {
+    return null;
+  }
+  return backupFile(target, now);
+}
+function backupFile(target, now = /* @__PURE__ */ new Date()) {
+  return claimBackupPath(
+    `${target}.backup-${formatStamp(now)}`,
+    (c) => copyFileSync(target, c, fsConstants.COPYFILE_EXCL)
+  );
+}
+function listFilesRecursive(dir, prefix = "") {
+  if (!existsSync2(dir)) return [];
+  const out = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) {
+      out.push(...listFilesRecursive(join2(dir, entry.name), rel));
+    } else if (entry.isFile()) {
+      out.push(rel);
+    }
+  }
+  return out;
+}
+function formatStamp(now) {
+  return now.toISOString().replace(/[-:]/g, "").replace(/\.\d+Z$/, "Z").slice(0, 15);
+}
+function ensureProjectSkeleton(projectDir) {
+  const dirs = [
+    ".claude/commands/uzys",
+    ".claude/rules",
+    ".claude/skills",
+    ".claude/agents",
+    ".claude/hooks",
+    "docs/decisions"
+  ];
+  for (const d of dirs) {
+    mkdirSync(join2(projectDir, d), { recursive: true });
+  }
+}
+
+// src/install-log.ts
+var INSTALL_LOG_FILENAME = ".harness-install.json";
+var INSTALL_LOG_DIR = ".uzys-agent-harness";
+var LEGACY_INSTALL_LOG_DIR = ".claude";
 var INSTALL_LOG_VERSION = 1;
 var POLICY_DIRS = [
   { dir: "rules", ext: ".md" },
@@ -1371,247 +1760,69 @@ function isHarnessOwned(baseline, key, current) {
 function mergeExternalFiles(projectDir, previous, current) {
   const byPath = /* @__PURE__ */ new Map();
   for (const file of [...previous ?? [], ...current]) byPath.set(file.path, file);
-  return [...byPath.values()].filter((f) => existsSync2(join2(projectDir, f.path)));
+  return [...byPath.values()].filter((f) => existsSync3(join3(projectDir, f.path)));
 }
-function collectSkillHashes(projectDir) {
-  const skillsDir = join2(projectDir, ".claude/skills");
-  return listFilesRecursive(skillsDir).map((rel) => ({
+function collectSkillHashes(projectDir, templatesDir) {
+  const skillsDir = join3(projectDir, ".claude/skills");
+  return listFilesRecursive(skillsDir).filter((rel) => existsSync3(join3(templatesDir, "skills", rel))).map((rel) => ({
     path: rel,
-    sha256: hashContent(readFileSync2(join2(skillsDir, rel), "utf8"))
+    sha256: hashContent(readFileSync3(join3(skillsDir, rel), "utf8"))
   }));
 }
 function collectPolicyHashes(projectDir, templatesDir) {
   const out = [];
   for (const { dir, ext } of POLICY_DIRS) {
-    const targetDir = join2(projectDir, ".claude", dir);
-    const sourceDir = join2(templatesDir, dir);
+    const targetDir = join3(projectDir, ".claude", dir);
+    const sourceDir = join3(templatesDir, dir);
     for (const rel of listFilesRecursive(targetDir)) {
       if (!rel.endsWith(ext)) continue;
-      if (!existsSync2(join2(sourceDir, rel))) continue;
+      if (!existsSync3(join3(sourceDir, rel))) continue;
       out.push({
         path: `${dir}/${rel}`,
-        sha256: hashContent(readFileSync2(join2(targetDir, rel), "utf8"))
+        sha256: hashContent(readFileSync3(join3(targetDir, rel), "utf8"))
       });
     }
-  }
-  return out;
-}
-function writeInstallLog(projectDir, log) {
-  const path2 = installLogPath(projectDir);
-  mkdirSync2(dirname2(path2), { recursive: true });
-  writeFileSync(path2, `${JSON.stringify(log, null, 2)}
-`, "utf8");
-  migrateAwayLegacyLog(projectDir);
-  return path2;
-}
-function migrateAwayLegacyLog(projectDir) {
-  const legacy = legacyInstallLogPath(projectDir);
-  if (!existsSync2(legacy)) return;
-  try {
-    rmSync(legacy);
-  } catch {
-  }
-}
-function readInstallLog(projectDir) {
-  const path2 = [installLogPath(projectDir), legacyInstallLogPath(projectDir)].find(
-    (p) => existsSync2(p)
-  );
-  if (!path2) return null;
-  try {
-    const parsed = JSON.parse(readFileSync2(path2, "utf8"));
-    if (Array.isArray(parsed.assets)) {
-      parsed.assets = parsed.assets.map(
-        (a) => a.method === "npm-global" ? { ...a, method: "npm" } : a
-      );
-    }
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-function installLogPath(projectDir) {
-  return join2(projectDir, INSTALL_LOG_DIR, INSTALL_LOG_FILENAME);
-}
-function legacyInstallLogPath(projectDir) {
-  return join2(projectDir, LEGACY_INSTALL_LOG_DIR, INSTALL_LOG_FILENAME);
-}
-
-// src/project-claude-merge.ts
-init_esm_shims();
-var HARNESS_ANCHOR_FILE = "CLAUDE-uzys-harness.md";
-var HARNESS_IMPORT_LINE = `@${HARNESS_ANCHOR_FILE}`;
-var IMPORT_MARKER_START = "<!-- uzys-harness:import:start -->";
-var IMPORT_MARKER_END = "<!-- uzys-harness:import:end -->";
-function renderContinuousSkillsNote(selectedInternalSkills) {
-  const lines = CONTINUOUS_SKILLS.filter((s) => selectedInternalSkills.includes(s.id)).map(
-    (s) => `- \`${s.id}\` \u2014 ${s.whenToApply}.`
-  );
-  if (lines.length === 0) return "";
-  return [
-    "## Skills that apply continuously",
-    "",
-    "These installed skills apply to every response or delegation; no prompt ever looks like their job, so open them from this list:",
-    "",
-    ...lines
-  ].join("\n");
-}
-function withContinuousSkillsNote(scaffold, selectedInternalSkills) {
-  const note = renderContinuousSkillsNote(selectedInternalSkills);
-  return note ? `${scaffold}
-
-${note}` : scaffold;
-}
-function importBlock(continuousSkills) {
-  const note = renderContinuousSkillsNote(continuousSkills);
-  const body = note ? `${HARNESS_IMPORT_LINE}
-
-${note}` : HARNESS_IMPORT_LINE;
-  return `${IMPORT_MARKER_START}
-${body}
-${IMPORT_MARKER_END}`;
-}
-var TRACK_DISPLAY_NAMES = {
-  tooling: "Tooling",
-  "csr-supabase": "CSR Supabase",
-  "csr-fastify": "CSR Fastify",
-  "csr-fastapi": "CSR FastAPI",
-  "ssr-htmx": "SSR HTMX",
-  "ssr-nextjs": "SSR Next.js",
-  data: "Data",
-  executive: "Executive",
-  full: "Full",
-  "project-management": "Project Management",
-  "growth-marketing": "Growth Marketing"
-};
-var FULL_EXPANSION = TRACKS.filter((t) => t !== "full");
-var FILL_SECTIONS = [
-  "identity",
-  "stack",
-  "architecture",
-  "installed-assets",
-  "boundaries",
-  "verify"
-];
-var FILL_SPECS = {
-  identity: {
-    title: "Identity & Purpose",
-    prompt: `Replace the H1 title above with this project's real name, then state in 1-2 plain sentences what it does, who uses it, and why it exists. Sources: README.md, the package.json / pyproject.toml "description", docs/. Do NOT describe the harness itself. Delete this comment when done.`,
-    placeholder: "what this project is, who it is for, and why it exists"
-  },
-  stack: {
-    title: "Stack & Commands",
-    prompt: "Replace the list below with this project's REAL stack. Inspect package.json / pyproject.toml / go.mod / Cargo.toml / Gemfile + lockfiles and any Makefile/justfile/package scripts. List the language(s)+versions, framework(s), package manager, and the exact install/build/test/run commands. Verify each command exists before writing it \u2014 never guess. Delete lines that do not apply, then delete this comment.",
-    placeholder: "languages, runtimes, package manager, and the install/build/test/run commands"
-  },
-  architecture: {
-    title: "Architecture & Layout",
-    prompt: "Map this repository. List each top-level source directory and what it holds, the entry point(s), the 3-5 files a newcomer reads first, and how data/requests flow between the main layers. View the real tree (e.g. `git ls-files | sed 's#/.*##' | sort -u`) \u2014 do not assume a framework's conventional layout. Flag any generated/vendored directories that must never be hand-edited. If this is a single small module, say so in one line. Delete this comment when done.",
-    placeholder: "where things live, the entry points, and how data flows between layers"
-  },
-  "installed-assets": {
-    title: "Installed Harness Assets",
-    prompt: "List the harness assets installed in this project (rules / skills / agents / commands) and add one line each on when to reach for it here. Verify against .claude/rules/*.md, .claude/skills/, .claude/agents/, .claude/commands/ (or this CLI's equivalent) and list ONLY assets whose file exists on disk \u2014 do not invent any. Do NOT restate the harness's working principles (they live in this project's harness anchor and rules layer) \u2014 cross-reference them instead. Delete this comment when done.",
-    placeholder: "the installed rules/skills/agents/commands and when to use each"
-  },
-  boundaries: {
-    title: "Boundaries \u2014 Always / Ask First / Never",
-    prompt: `Fill the Always / Ask First / Never lists with this repo's real red lines. Read the CI config, CODEOWNERS, .gitignore, and release/deploy scripts. Never must include secrets, generated files, force-push, and direct commits to the default branch, plus any repo-specific "do not touch" directories. Every entry must be specific and enforceable here. Delete this comment when done.`,
-    placeholder: "what to always do, ask before doing, and never do in this repo"
-  },
-  verify: {
-    title: "Verification Gate",
-    prompt: 'State the single command (or short sequence) that PROVES a change is safe here \u2014 the test/lint/typecheck/build gate you run before committing \u2014 plus the coverage/CI threshold and what "done" means. Sources: package scripts, CI workflow files, CONTRIBUTING. An agent must be able to self-verify without guessing. Delete this comment when done.',
-    placeholder: "the single command that proves a change is safe, and the done bar"
-  }
-};
-function anchorLine(surface) {
-  if (surface === "claude") {
-    return `> The working principles live in this project's harness anchor \`${HARNESS_ANCHOR_FILE}\`, imported at the bottom of this file. Everything above that import is **project-specific context only**.`;
-  }
-  const self = surface === "antigravity-rule" ? "`.agents/rules/uzys-harness.md`" : "`AGENTS.md`";
-  return `> **This file (${self}) is the harness anchor** \u2014 it carries the working principles in full, further down. Only the \`## \u2026\` sections immediately below are project-specific context for you to fill in.`;
-}
-function scaffoldBanner(surface) {
-  return [
-    "> \u2699\uFE0F **SCAFFOLD \u2014 not filled in yet.** The sections below are a fill-in template for THIS project, not verified facts.",
-    "> To fill: open this file and paste each `<!-- FILL: \u2026 -->` comment's instruction into your coding agent (e.g. Claude Code) \u2014 it will inspect the real repo and write the section. You can also fill them by hand; the comments are the instructions.",
-    anchorLine(surface)
-  ].join("\n");
-}
-function renderFillScaffold(surface = "claude") {
-  const blocks = FILL_SECTIONS.map((id) => {
-    const spec = FILL_SPECS[id];
-    return `## ${spec.title}
-
-<!-- FILL:${id} \u2014 ${spec.prompt} -->
-
-_(not filled yet \u2014 ${spec.placeholder})_`;
-  });
-  return `${scaffoldBanner(surface)}
-
-${blocks.join("\n\n")}`;
-}
-function mergeProjectClaude(opts) {
-  const expanded = expandTracks(opts.tracks);
-  const trackList = expanded.map((t) => TRACK_DISPLAY_NAMES[t]).join(", ");
-  const header = `# ${opts.projectName}
-
-> Active track(s): ${trackList}`;
-  return `${header}
-
-${renderFillScaffold()}
-`;
-}
-function upsertHarnessImport(existing, opts) {
-  const block = importBlock(opts.continuousSkills ?? []);
-  if (existing === null) {
-    return `${mergeProjectClaude(opts)}
-${block}
-`;
-  }
-  const start = existing.indexOf(IMPORT_MARKER_START);
-  if (start !== -1) {
-    const endAt = existing.indexOf(IMPORT_MARKER_END, start);
-    if (endAt === -1) return existing;
-    const current = existing.slice(start, endAt + IMPORT_MARKER_END.length);
-    if (current === block) return existing;
-    return `${existing.slice(0, start)}${block}${existing.slice(endAt + IMPORT_MARKER_END.length)}`;
-  }
-  if (hasHarnessImport(existing)) {
-    return existing;
-  }
-  const body = existing.endsWith("\n") ? existing : `${existing}
-`;
-  return `${body}
-${block}
-`;
+  }
+  return out;
 }
-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}`;
+function writeInstallLog(projectDir, log) {
+  const path2 = installLogPath(projectDir);
+  mkdirSync2(dirname2(path2), { recursive: true });
+  writeFileSync(path2, `${JSON.stringify(log, null, 2)}
+`, "utf8");
+  migrateAwayLegacyLog(projectDir);
+  return path2;
 }
-function hasHarnessImport(text) {
-  if (text.includes(IMPORT_MARKER_START)) return true;
-  let inFence = false;
-  for (const line of text.split("\n")) {
-    if (/^\s*(?:```|~~~)/.test(line)) {
-      inFence = !inFence;
-      continue;
-    }
-    if (!inFence && line.trim() === HARNESS_IMPORT_LINE) return true;
+function migrateAwayLegacyLog(projectDir) {
+  const legacy = legacyInstallLogPath(projectDir);
+  if (!existsSync3(legacy)) return;
+  try {
+    rmSync(legacy);
+  } catch {
   }
-  return false;
 }
-function expandTracks(tracks) {
-  if (tracks.includes("full")) {
-    return FULL_EXPANSION;
+function readInstallLog(projectDir) {
+  const path2 = [installLogPath(projectDir), legacyInstallLogPath(projectDir)].find(
+    (p) => existsSync3(p)
+  );
+  if (!path2) return null;
+  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;
+  } catch {
+    return null;
   }
-  return tracks;
+}
+function installLogPath(projectDir) {
+  return join3(projectDir, INSTALL_LOG_DIR, INSTALL_LOG_FILENAME);
+}
+function legacyInstallLogPath(projectDir) {
+  return join3(projectDir, LEGACY_INSTALL_LOG_DIR, INSTALL_LOG_FILENAME);
 }
 
 // src/manifest.ts
@@ -1634,6 +1845,8 @@ var COMMON_RULES = ["git-policy", "change-management", "doc-governance"];
 var DEV_RULES = ["test-policy", "ship-checklist"];
 var UI_RULES = [];
 var TRACK_RULES = {
+  base: [],
+  // #456 — 공통 룰만. cli-development 는 tooling·full 전용
   "csr-supabase": [],
   "csr-fastify": [],
   "csr-fastapi": [],
@@ -1893,199 +2106,6 @@ var CATEGORY_TITLES = {
   "ecc-suite": "\u{1F4E6} ECC Suite"
 };
 
-// src/context-cost.ts
-init_esm_shims();
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { join as join3, resolve } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var CHARS_PER_TOKEN = 4;
-function estimateTokens(chars) {
-  return Math.ceil(chars / CHARS_PER_TOKEN);
-}
-function resolveBundleRoot() {
-  return resolve(fileURLToPath2(new URL(".", import.meta.url)), "..");
-}
-function extractFrontmatter(content) {
-  const m = content.match(/^?---\r?\n([\s\S]*?)\r?\n---/);
-  return m?.[1] ?? null;
-}
-function assetDescriptorTokens(assetId, root = resolveBundleRoot()) {
-  const asset = EXTERNAL_ASSETS.find((a) => a.id === assetId);
-  if (!asset || asset.method.kind !== "internal") return null;
-  const skillMd = join3(root, "templates", "skills", asset.method.key, "SKILL.md");
-  if (!existsSync3(skillMd)) return null;
-  const fm = extractFrontmatter(readFileSync3(skillMd, "utf8"));
-  return fm === null ? null : estimateTokens(fm.length);
-}
-function assetBodyTokens(assetId, root = resolveBundleRoot()) {
-  const asset = EXTERNAL_ASSETS.find((a) => a.id === assetId);
-  if (!asset || asset.method.kind !== "internal") return null;
-  const skillMd = join3(root, "templates", "skills", asset.method.key, "SKILL.md");
-  if (!existsSync3(skillMd)) return null;
-  const content = readFileSync3(skillMd, "utf8");
-  const fm = extractFrontmatter(content);
-  if (fm === null) return estimateTokens(content.length);
-  const close = content.indexOf("\n---", content.indexOf(fm) + fm.length);
-  const body = close === -1 ? "" : content.slice(close + "\n---".length);
-  return estimateTokens(body.trim().length);
-}
-function assetCostRows(assetIds, root = resolveBundleRoot()) {
-  return assetIds.map((id) => ({
-    id,
-    descriptorTokens: assetDescriptorTokens(id, root),
-    bodyTokens: assetBodyTokens(id, root)
-  })).sort((a, b) => (b.bodyTokens ?? -1) - (a.bodyTokens ?? -1));
-}
-function makeResidentCost(base) {
-  return {
-    ...base,
-    perSkillDescriptor: base.perSkillDescriptor ?? {},
-    total: base.rules + base.projectClaudeMd + base.skillDescriptors + base.agentDescriptors,
-    directive: {
-      items: base.items.rules + base.items.claudeMd,
-      tokens: base.rules + base.projectClaudeMd
-    },
-    firing: {
-      items: base.items.skills + base.items.agents,
-      tokens: base.skillDescriptors + base.agentDescriptors
-    }
-  };
-}
-function fileTokens(path2) {
-  return existsSync3(path2) ? estimateTokens(readFileSync3(path2, "utf8").trim().length) : 0;
-}
-function descriptorTokens(path2) {
-  if (!existsSync3(path2)) return 0;
-  const fm = extractFrontmatter(readFileSync3(path2, "utf8"));
-  return fm === null ? 0 : estimateTokens(fm.length);
-}
-function residentCost(entries, root = resolveBundleRoot()) {
-  const tpl = (source) => join3(root, "templates", source);
-  const measured = (e) => e.file ?? tpl(e.source);
-  const perSkill = {};
-  let rules = 0;
-  let skillDescriptors = 0;
-  let agentDescriptors = 0;
-  let ruleItems = 0;
-  let skillItems = 0;
-  let agentItems = 0;
-  for (const e of entries) {
-    if (e.target.startsWith(".claude/rules/")) {
-      rules += fileTokens(measured(e));
-      ruleItems += 1;
-    } else if (e.target.startsWith(".claude/agents/")) {
-      agentDescriptors += descriptorTokens(measured(e));
-      agentItems += 1;
-    } else if (e.target.startsWith(".claude/skills/")) {
-      const t = descriptorTokens(join3(measured(e), "SKILL.md"));
-      skillDescriptors += t;
-      skillItems += 1;
-      const id = /\.claude\/skills\/([^/]+)/.exec(e.target)?.[1];
-      if (id !== void 0) perSkill[id] = (perSkill[id] ?? 0) + t;
-    }
-  }
-  const harnessAnchor = fileTokens(join3(root, "templates", "CLAUDE.md"));
-  const projectScaffold = estimateTokens(
-    withContinuousSkillsNote(
-      renderFillScaffold(),
-      CONTINUOUS_SKILLS.map((s) => s.id)
-    ).trim().length
-  );
-  const projectClaudeMd = harnessAnchor + projectScaffold;
-  const claudeMdItems = (harnessAnchor > 0 ? 1 : 0) + (projectScaffold > 0 ? 1 : 0);
-  return makeResidentCost({
-    rules,
-    projectClaudeMd,
-    skillDescriptors,
-    agentDescriptors,
-    perSkillDescriptor: perSkill,
-    items: {
-      rules: ruleItems,
-      skills: skillItems,
-      agents: agentItems,
-      claudeMd: claudeMdItems,
-      total: ruleItems + skillItems + agentItems + claudeMdItems
-    }
-  });
-}
-function summarizeContextCost(assetIds, root = resolveBundleRoot()) {
-  let measuredTokens = 0;
-  let measuredCount = 0;
-  let unmeasuredCount = 0;
-  for (const id of assetIds) {
-    const tokens = assetDescriptorTokens(id, root);
-    if (tokens === null) unmeasuredCount += 1;
-    else {
-      measuredTokens += tokens;
-      measuredCount += 1;
-    }
-  }
-  return { measuredTokens, measuredCount, unmeasuredCount };
-}
-function formatResidentCostLine(r, unmeasuredCount) {
-  if (r.total === 0) return null;
-  const parts = [
-    `directives ${r.directive.items} ~${r.directive.tokens}`,
-    `[rules ${r.items.rules} ~${r.rules} \xB7 CLAUDE.md ${r.items.claudeMd} ~${r.projectClaudeMd}]`,
-    `triggers ${r.firing.items} ~${r.firing.tokens}`,
-    `[skills ${r.items.skills} ~${r.skillDescriptors} \xB7 agents ${r.items.agents} ~${r.agentDescriptors}]`
-  ].join(" \xB7 ");
-  const external = unmeasuredCount > 0 ? ` \xB7 ${unmeasuredCount} external asset${unmeasuredCount === 1 ? "" : "s"} unmeasured` : "";
-  return `session-start context cost: ${r.items.total} items resident \xB7 ~${r.total} tokens/session (${parts}${external})`;
-}
-var RESIDENT_ROWS = [
-  {
-    // ADR-083 — 축 소계를 **행으로** 낸다. 소계가 없으면 읽는 사람이 네 줄을 머리로 더해야
-    // 하고, 그러면 "무엇을 줄여야 하나"가 표에서 안 보인다.
-    label: "\uC9C0\uC2DC\uBB38",
-    gap: 13,
-    count: (r) => r.directive.items,
-    tokens: (r) => r.directive.tokens
-  },
-  { label: "  rules", gap: 12, count: (r) => r.items.rules, tokens: (r) => r.rules },
-  {
-    // 한 행에 두 파일(앵커 + 스캐폴드). 개수 열이 2 를 뱉어 그 사실을 드러낸다 — 라벨로
-    // 하나만 이름 붙이면 v26.140.0 이전과 같은 거짓 라벨이 된다.
-    label: "  CLAUDE.md",
-    gap: 8,
-    count: (r) => r.items.claudeMd,
-    tokens: (r) => r.projectClaudeMd
-  },
-  {
-    label: "\uBC1C\uD654 \uD45C\uBA74",
-    gap: 10,
-    count: (r) => r.firing.items,
-    tokens: (r) => r.firing.tokens
-  },
-  {
-    label: "  skill descriptors",
-    gap: 0,
-    count: (r) => r.items.skills,
-    tokens: (r) => r.skillDescriptors
-  },
-  {
-    label: "  agent descriptors",
-    gap: 0,
-    count: (r) => r.items.agents,
-    tokens: (r) => r.agentDescriptors
-  }
-];
-function formatResidentCostBlock(r) {
-  const n = (v) => String(v).padStart(3);
-  return [
-    "                       \uAC1C\uC218    \uD1A0\uD070",
-    ...RESIDENT_ROWS.map(
-      (row) => `  ${row.label}${" ".repeat(row.gap)}${n(row.count(r))}\uAC1C  ~${row.tokens(r)}`
-    ),
-    "  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
-    `  \uC0C1\uC8FC \uD569\uACC4          ${n(r.items.total)}\uAC1C \uC0C1\uC8FC \xB7 ~${r.total} tokens/\uC138\uC158`,
-    "",
-    "  \uC9C0\uC2DC\uBB38 = \uC6B0\uB9AC\uAC00 \uD56D\uC0C1 \uC77D\uD788\uAC8C \uB123\uC740 \uAC83. **\uC791\uC744\uC218\uB85D \uC88B\uC740 \uAC12\uC774 \uC544\uB2C8\uB2E4** \u2014 \uD310\uB2E8\uC740",
-    "           '\uBD88\uD544\uC694\uD55C \uC9C0\uC2DC\uBB38\uC774 \uC788\uB098'\uB85C \uD55C\uB2E4. ratchet \uC740 \uC870\uC6A9\uD55C \uC99D\uAC00\uB9CC \uB9C9\uB294\uB2E4.",
-    "  \uBC1C\uD654 \uD45C\uBA74 = \uC2A4\uD0AC\xB7\uC5D0\uC774\uC804\uD2B8\uAC00 \uBD88\uB9AC\uB824\uACE0 \uC0C1\uC8FC\uC2DC\uD0A4\uB294 descriptor. \uAE4E\uC73C\uBA74 \uC548 \uBD88\uB9B0\uB2E4."
-  ];
-}
-
 export {
   __commonJS,
   __toESM,
@@ -2099,6 +2119,7 @@ export {
   isInstallScope,
   resolveScope,
   DEFAULT_OPTIONS,
+  UPDATE_GROUPS,
   EXTERNAL_ASSETS,
   DEV_METHOD_SKILL_IDS,
   INTERNAL_BUNDLED_SKILL_IDS,
@@ -2112,6 +2133,21 @@ export {
   assetCliSupport,
   assetReachesCli,
   filterApplicableAssets,
+  HARNESS_ANCHOR_FILE,
+  HARNESS_IMPORT_LINE,
+  withContinuousSkillsNote,
+  renderFillScaffold,
+  upsertHarnessImport,
+  stripHarnessImport,
+  estimateTokens,
+  resolveBundleRoot,
+  extractFrontmatter,
+  assetCostRows,
+  landsOnDisk,
+  residentCost,
+  summarizeContextCost,
+  formatResidentCostLine,
+  formatResidentCostBlock,
   ensureDir,
   copyFile,
   copyDir,
@@ -2133,12 +2169,6 @@ export {
   readInstallLog,
   installLogPath,
   legacyInstallLogPath,
-  HARNESS_ANCHOR_FILE,
-  HARNESS_IMPORT_LINE,
-  withContinuousSkillsNote,
-  renderFillScaffold,
-  upsertHarnessImport,
-  stripHarnessImport,
   buildAssetSpec,
   resolveRules,
   ALL_RULES,
@@ -2148,13 +2178,6 @@ export {
   isCliNeutralTarget,
   buildManifest,
   CATEGORIES,
-  CATEGORY_TITLES,
-  estimateTokens,
-  resolveBundleRoot,
-  assetCostRows,
-  residentCost,
-  summarizeContextCost,
-  formatResidentCostLine,
-  formatResidentCostBlock
+  CATEGORY_TITLES
 };
-//# sourceMappingURL=chunk-OYNSK6QF.js.map
+//# sourceMappingURL=chunk-SC6ORMHV.js.map