@byh3071/vhk 2.3.1 → 2.3.2

package/dist/{chunk-WQWPM364.js → chunk-OHGVVAKT.js}

@@ -762,7 +762,12 @@ var ko = {
     skipped: (p) => `\u23ED\uFE0F  \uAC74\uB108\uB700: ${p} (\uB36E\uC5B4\uC4F0\uAE30 \uAC70\uBD80 \u2014 \uBC31\uC5C5\uB9CC \uBCF4\uAD00)`,
     dryRunHeader: "\u{1F50E} \uBBF8\uB9AC\uBCF4\uAE30 (--dry-run) \u2014 \uC2E4\uC81C \uD30C\uC77C \uBCC0\uACBD \uC5C6\uC74C",
     dryRunWouldWrite: (p, drift) => `  ${drift ? "\u270F\uFE0F  \uBCC0\uACBD\uB428" : "\xB7  \uB3D9\uC77C"} : ${p}`,
-    nonTtyAuto: (n, id) => `\u{1F916} \uBE44\uB300\uD654\uD615(CI/\uC5D0\uC774\uC804\uD2B8) \u2014 ${n}\uAC1C \uBC31\uC5C5 \uD6C4 \uC9C4\uD589. \uBCF5\uC6D0: vhk restore ${id}`
+    nonTtyAuto: (n, id) => `\u{1F916} \uBE44\uB300\uD654\uD615(CI/\uC5D0\uC774\uC804\uD2B8) \u2014 ${n}\uAC1C \uBC31\uC5C5 \uD6C4 \uC9C4\uD589. \uBCF5\uC6D0: vhk restore ${id}`,
+    // 배치1 — CLAUDE.md 를 vhk 마커(<!-- vhk:rules:start/end -->) 형식으로 1회 정리할 때의 안내.
+    // 사용자 섹션은 보존, RULES.md 기준 옛 자동생성 섹션만 재생성 교체(조용한 드롭 방지).
+    claudeMigrated: (preserved, removed) => `\u2139\uFE0F  CLAUDE.md \uB97C vhk \uB9C8\uCEE4 \uD615\uC2DD\uC73C\uB85C \uC815\uB9AC\uD588\uC5B4\uC694 \u2014 \uB9C8\uCEE4 \uBC16 \uC0AC\uC6A9\uC790 \uC139\uC158\uC740 \uBCF4\uC874\uB429\uB2C8\uB2E4.` + (preserved.length ? `
+     \uBCF4\uC874\uB41C \uC0AC\uC6A9\uC790 \uC139\uC158 ${preserved.length}\uAC1C: ${preserved.join(", ")}` : "") + (removed.length ? `
+     RULES.md \uAE30\uC900\uC73C\uB85C \uC7AC\uC0DD\uC131\xB7\uAD50\uCCB4\uB41C \uC61B \uC790\uB3D9\uC0DD\uC131 \uC139\uC158 ${removed.length}\uAC1C: ${removed.join(", ")} (\uD544\uC694 \uC2DC .vhk/backups \uC5D0\uC11C \uBCF5\uAD6C)` : "")
   },
   restore: {
     title: "\u{1F6DF} \uBC31\uC5C5 \uBCF5\uC6D0",
@@ -1378,29 +1383,80 @@ function toAntigravityRules(sections, projectName) {
   return truncateForAntigravity(buildCodingDoc("Antigravity Rules", sections, projectName));
 }
 var CLAUDE_AUTOGEN_BANNER = "> \u26A1 \uC544\uB798 \uADDC\uCE59 \uC139\uC158\uC740 RULES.md\uC5D0\uC11C \uC790\uB3D9 \uC0DD\uC131\uB428 (vhk sync). \uC9C1\uC811 \uC218\uC815 \uAE08\uC9C0.";
-function toClaudeMd(sections, existing) {
-  const recordSections = sections.filter(
-    (s) => CLAUDE_MD_KEYS.some((k) => s.title.includes(k))
-  );
-  const cleaned = existing.split("\n").filter((line) => line.trim() !== CLAUDE_AUTOGEN_BANNER).join("\n");
-  const statusMatch = cleaned.match(/## 현재 상태[\s\S]*?(?=\n## |$)/);
-  const statusSection = statusMatch ? statusMatch[0].trimEnd() : "";
-  const header = cleaned.split("## ")[0].trim();
-  const lines = [
-    header,
-    "",
-    statusSection,
-    "",
-    CLAUDE_AUTOGEN_BANNER,
-    ""
-  ];
+var VHK_BLOCK_START = "<!-- vhk:rules:start -->";
+var VHK_BLOCK_END = "<!-- vhk:rules:end -->";
+function buildVhkBlock(recordSections) {
+  const lines = [VHK_BLOCK_START, CLAUDE_AUTOGEN_BANNER, ""];
   for (const section of recordSections) {
     lines.push(`## ${section.title}`);
     lines.push(section.content);
     lines.push("");
   }
+  lines.push(VHK_BLOCK_END);
   return lines.join("\n");
 }
+function splitVhkBlock(existing) {
+  const start = existing.indexOf(VHK_BLOCK_START);
+  const end = existing.indexOf(VHK_BLOCK_END);
+  if (start === -1 || end === -1 || end < start) return null;
+  return {
+    before: existing.slice(0, start),
+    after: existing.slice(end + VHK_BLOCK_END.length)
+  };
+}
+function stripLegacyAutogen(existing) {
+  const lines = existing.split("\n").filter((line) => {
+    const t2 = line.trim();
+    return t2 !== CLAUDE_AUTOGEN_BANNER && t2 !== VHK_BLOCK_START && t2 !== VHK_BLOCK_END;
+  });
+  const headerLines = [];
+  const blocks = [];
+  let cur = null;
+  for (const line of lines) {
+    if (line.startsWith("## ")) {
+      if (cur) blocks.push(cur);
+      cur = { title: line.slice(3).trim(), body: [line] };
+    } else if (cur) {
+      cur.body.push(line);
+    } else {
+      headerLines.push(line);
+    }
+  }
+  if (cur) blocks.push(cur);
+  const removed = [];
+  const preserved = [];
+  const keptBodies = [];
+  for (const b of blocks) {
+    if (CLAUDE_MD_KEYS.some((k) => b.title.includes(k))) {
+      removed.push(b.title);
+    } else {
+      preserved.push(b.title);
+      keptBodies.push(b.body.join("\n").trimEnd());
+    }
+  }
+  const header = headerLines.join("\n").trim();
+  const cleaned = [header, ...keptBodies].filter(Boolean).join("\n\n");
+  return { cleaned, removed, preserved };
+}
+function claudeMdMigration(existing) {
+  if (splitVhkBlock(existing)) return { migrated: false, removed: [], preserved: [] };
+  const { removed, preserved } = stripLegacyAutogen(existing);
+  return { migrated: true, removed, preserved };
+}
+function toClaudeMd(sections, existing) {
+  const recordSections = sections.filter(
+    (s) => CLAUDE_MD_KEYS.some((k) => s.title.includes(k))
+  );
+  const vhkBlock = buildVhkBlock(recordSections);
+  const split = splitVhkBlock(existing);
+  if (split) {
+    const before = split.before.replace(/\s+$/, "");
+    const after = split.after.replace(/^\s+/, "").replace(/\s+$/, "");
+    return [before, vhkBlock, after].filter((s) => s.length > 0).join("\n\n") + "\n";
+  }
+  const { cleaned } = stripLegacyAutogen(existing);
+  return [cleaned, vhkBlock].filter((s) => s.length > 0).join("\n\n") + "\n";
+}
 function toAgentsMd(sections, projectName) {
   const codingSections = sections.filter((s) => CURSORRULES_KEYS.some((k) => s.title.includes(k)));
   const recordSections = sections.filter((s) => CLAUDE_MD_KEYS.some((k) => s.title.includes(k)));
@@ -1472,7 +1528,9 @@ function buildSyncPlan(rootDir, sections, projectName) {
     newContent: claudeNew,
     doneMessage: ko.sync.claudeDone,
     exists: claudeExists,
-    drift: claudeDrift
+    drift: claudeDrift,
+    // 기존 CLAUDE.md 가 있을 때만 마이그레이션 집계(첫 생성은 마이그레이션 아님). 추가 I/O 0 — 이미 읽은 existingClaude 재사용.
+    migration: claudeExists ? claudeMdMigration(existingClaude) : void 0
   });
   return plan;
 }
@@ -1483,6 +1541,7 @@ async function syncCore(rootDir, opts, confirmOverwrite) {
   const plan = buildSyncPlan(rootDir, sections, projectName);
   const firstSync = !fs4.existsSync(path4.join(rootDir, SYNCED_MARKER_REL));
   const unmapped = findUnmappedSections(sections);
+  const claudeMigration = plan.find((p) => p.path === "CLAUDE.md")?.migration;
   if (opts.dryRun) {
     return {
       dryRun: true,
@@ -1493,7 +1552,8 @@ async function syncCore(rootDir, opts, confirmOverwrite) {
       skipped: [],
       truncated: [],
       plan,
-      unmapped
+      unmapped,
+      claudeMigration
     };
   }
   const toBackup = plan.filter((p) => p.exists && (p.drift || firstSync)).map((p) => p.path);
@@ -1526,7 +1586,7 @@ async function syncCore(rootDir, opts, confirmOverwrite) {
   fs4.mkdirSync(path4.join(rootDir, ".vhk"), { recursive: true });
   fs4.writeFileSync(path4.join(rootDir, SYNCED_MARKER_REL), (/* @__PURE__ */ new Date()).toISOString() + "\n", "utf-8");
   ensureVhkIgnored(rootDir, ".synced");
-  return { dryRun: false, firstSync, backupId, backedUp, written, skipped, truncated, plan, unmapped };
+  return { dryRun: false, firstSync, backupId, backedUp, written, skipped, truncated, plan, unmapped, claudeMigration };
 }
 async function sync(opts = {}) {
   console.log(chalk3.bold(`
@@ -1575,6 +1635,13 @@ ${ko.sync.title}
       )
     );
   }
+  if (result.claudeMigration?.migrated) {
+    console.log(
+      chalk3.cyan(
+        `  ${ko.sync.claudeMigrated(result.claudeMigration.preserved, result.claudeMigration.removed)}`
+      )
+    );
+  }
   if (result.dryRun) {
     console.log(chalk3.cyan(`
 ${ko.sync.dryRunHeader}`));

package/dist/index.js

@@ -43,7 +43,7 @@ import {
   stripBom,
   sync,
   t
-} from "./chunk-WQWPM364.js";
+} from "./chunk-OHGVVAKT.js";
 
 // src/index.ts
 import { Command, Help } from "commander";
@@ -516,6 +516,10 @@ var KNOWN_COMMAND_TOKENS = /* @__PURE__ */ new Set([
   "\uAC80\uD1A0",
   "mission",
   "\uBBF8\uC158",
+  "pattern",
+  "\uD328\uD134",
+  "evolve",
+  "\uC9C4\uD654",
   "help"
 ]);
 function isOptionToken(token) {
@@ -6592,41 +6596,19 @@ function detectCandidates(mem, minFreq) {
   processBucket(mem.successes, "reinforce", (e) => e.content ?? "");
   return candidates.sort((a, b) => b.count - a.count || a.signal.localeCompare(b.signal));
 }
-function nextPatternId(mem) {
-  const re = /^p(\d+)$/;
-  let max = 0;
-  for (const p of mem.patterns) {
-    const m = p.id.match(re);
-    if (m) max = Math.max(max, Number(m[1]));
-  }
-  return `p${max + 1}`;
-}
-async function patternDetect(opts = {}) {
-  const minFreq = opts.min !== void 0 ? parseInt(opts.min, 10) : MIN_TAG_FREQ;
-  if (!Number.isFinite(minFreq) || minFreq < 1) {
-    console.log(chalk33.red("\u274C --min \uC740 1 \uC774\uC0C1\uC758 \uC815\uC218\uC5EC\uC57C \uD569\uB2C8\uB2E4."));
-    process.exitCode = 1;
-    return;
-  }
-  const cwd = process.cwd();
-  const loaded = loadForMutation(cwd);
-  if (!loaded.ok) {
-    console.log(chalk33.red("\u274C memory.json \uC190\uC0C1 \uC758\uC2EC \u2014 \uAC10\uC9C0 \uC911\uB2E8 (\uC6D0\uBCF8 \uBCF4\uC874). \uBC31\uC5C5 \uD655\uC778 \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694."));
-    process.exitCode = 1;
-    return;
+function reconcilePatterns(patterns, candidates, now) {
+  let added = 0;
+  let updated = 0;
+  let maxId = 0;
+  for (const p of patterns) {
+    const m = p.id.match(/^p(\d+)$/);
+    if (m) maxId = Math.max(maxId, Number(m[1]));
   }
-  const mem = loaded.mem;
-  const candidates = detectCandidates(mem, minFreq);
-  const now = (/* @__PURE__ */ new Date()).toISOString();
-  let added = 0, updated = 0;
   for (const c of candidates) {
     const sig = sigOf(c.kind, c.axis, c.signal);
-    const existing = mem.patterns.find((p) => {
-      const pp = p;
-      const sigMatch = pp._sig === sig;
-      const fieldMatch = pp.kind === c.kind && pp.axis === c.axis && pp.signal === c.signal;
-      return (sigMatch || fieldMatch) && pp.status !== "archived";
-    });
+    const matches = (pp) => pp._sig === sig || pp.kind === c.kind && pp.axis === c.axis && pp.signal === c.signal;
+    if (patterns.some((p) => matches(p) && p.status === "archived")) continue;
+    const existing = patterns.find((p) => matches(p) && p.status !== "archived");
     if (existing) {
       existing._sig = sig;
       existing.count = c.count;
@@ -6635,8 +6617,8 @@ async function patternDetect(opts = {}) {
       existing.tags = c.sourceTags;
       updated++;
     } else {
-      const entry = {
-        id: nextPatternId(mem),
+      patterns.push({
+        id: `p${++maxId}`,
         kind: c.kind,
         axis: c.axis,
         signal: c.signal,
@@ -6647,11 +6629,30 @@ async function patternDetect(opts = {}) {
         status: "active",
         tags: c.sourceTags,
         _sig: sig
-      };
-      mem.patterns.push(entry);
+      });
       added++;
     }
   }
+  return { added, updated };
+}
+async function patternDetect(opts = {}) {
+  const minFreq = opts.min !== void 0 ? parseInt(opts.min, 10) : MIN_TAG_FREQ;
+  if (!Number.isFinite(minFreq) || minFreq < 1) {
+    console.log(chalk33.red("\u274C --min \uC740 1 \uC774\uC0C1\uC758 \uC815\uC218\uC5EC\uC57C \uD569\uB2C8\uB2E4."));
+    process.exitCode = 1;
+    return;
+  }
+  const cwd = process.cwd();
+  const loaded = loadForMutation(cwd);
+  if (!loaded.ok) {
+    console.log(chalk33.red("\u274C memory.json \uC190\uC0C1 \uC758\uC2EC \u2014 \uAC10\uC9C0 \uC911\uB2E8 (\uC6D0\uBCF8 \uBCF4\uC874). \uBC31\uC5C5 \uD655\uC778 \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694."));
+    process.exitCode = 1;
+    return;
+  }
+  const mem = loaded.mem;
+  const candidates = detectCandidates(mem, minFreq);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const { added, updated } = reconcilePatterns(mem.patterns, candidates, now);
   if (added > 0 || updated > 0) {
     writeMemory(cwd, mem);
   }

package/dist/mcp/index.js

@@ -2,7 +2,7 @@
 import {
   resolveVhkCliInvocation,
   startMcpServer
-} from "../chunk-WQWPM364.js";
+} from "../chunk-OHGVVAKT.js";
 
 // src/mcp/index.ts
 var cli = resolveVhkCliInvocation();

package/package.json

@@ -1,72 +1,72 @@
-{
-  "name": "@byh3071/vhk",
-  "version": "2.3.1",
-  "description": "Vibe Harness Kit — AI 코딩 도구·기기를 바꿔도 규칙·맥락이 따라가는 포터빌리티 CLI (sync: Cursor·Claude·Windsurf·Copilot·Antigravity / cloud 백업)",
-  "bin": {
-    "vhk": "dist/index.js",
-    "vhk-mcp": "dist/mcp/index.js"
-  },
-  "type": "module",
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsup",
-    "test": "vitest",
-    "test:run": "vitest --run",
-    "prepublishOnly": "pnpm build && pnpm test:run",
-    "save": "vhk save",
-    "check": "vhk check",
-    "scan": "vhk secure scan",
-    "recap": "vhk recap",
-    "ship": "vhk ship",
-    "doctor": "vhk doctor"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "keywords": [
-    "vibe-coding",
-    "harness",
-    "cli",
-    "scaffold",
-    "session-log",
-    "rules-sync",
-    "portability",
-    "ai-coding",
-    "cursor",
-    "claude",
-    "windsurf",
-    "copilot",
-    "context-sync"
-  ],
-  "author": "byh3071 <byh3071@gmail.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/byh3071-cpu/vhk.git"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@notionhq/client": "^5.22.0",
-    "chalk": "^5.6.2",
-    "commander": "^14.0.3",
-    "handlebars": "^4.7.9",
-    "inquirer": "^9.3.8",
-    "ora": "^9.4.0",
-    "simple-git": "^3.36.0",
-    "zod": "^4.4.3"
-  },
-  "devDependencies": {
-    "@types/inquirer": "^9.0.9",
-    "@types/node": "^25.9.1",
-    "ignore": "^7.0.5",
-    "tsup": "^8.5.1",
-    "tsx": "^4.22.3",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
-  }
-}
+{
+  "name": "@byh3071/vhk",
+  "version": "2.3.2",
+  "description": "Vibe Harness Kit — AI 코딩 도구·기기를 바꿔도 규칙·맥락이 따라가는 포터빌리티 CLI (sync: Cursor·Claude·Windsurf·Copilot·Antigravity / cloud 백업)",
+  "bin": {
+    "vhk": "dist/index.js",
+    "vhk-mcp": "dist/mcp/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup",
+    "test": "vitest",
+    "test:run": "vitest --run",
+    "prepublishOnly": "pnpm build && pnpm test:run",
+    "save": "vhk save",
+    "check": "vhk check",
+    "scan": "vhk secure scan",
+    "recap": "vhk recap",
+    "ship": "vhk ship",
+    "doctor": "vhk doctor"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "vibe-coding",
+    "harness",
+    "cli",
+    "scaffold",
+    "session-log",
+    "rules-sync",
+    "portability",
+    "ai-coding",
+    "cursor",
+    "claude",
+    "windsurf",
+    "copilot",
+    "context-sync"
+  ],
+  "author": "byh3071 <byh3071@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/byh3071-cpu/vhk.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@notionhq/client": "^5.22.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "handlebars": "^4.7.9",
+    "inquirer": "^9.3.8",
+    "ora": "^9.4.0",
+    "simple-git": "^3.36.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.9.1",
+    "ignore": "^7.0.5",
+    "tsup": "^8.5.1",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}