@byh3071/vhk 2.3.1 → 2.4.0

package/dist/{chunk-WQWPM364.js → chunk-MN6LSPN6.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",
@@ -869,7 +874,10 @@ var ko = {
     testFailed: "\uD14C\uC2A4\uD2B8 \uC2E4\uD328",
     publishing: "npm \uBC30\uD3EC \uC911...",
     publishSuccess: "npm \uBC30\uD3EC \uC131\uACF5!",
-    publishFailed: "npm \uBC30\uD3EC \uC2E4\uD328"
+    publishFailed: "npm \uBC30\uD3EC \uC2E4\uD328",
+    // 발행 전 안전 가드 — feature 브랜치/미커밋 발행로 픽스 누락본이 latest 로 나가는 사고 방지(v2.3.1 사례)
+    preflightWrongBranch: (branch, def) => `\uBC1C\uD589 \uC911\uB2E8 \u2014 \uD604\uC7AC '${branch}' \uBE0C\uB79C\uCE58\uC785\uB2C8\uB2E4. \uBC1C\uD589\uC740 '${def}' \uC5D0\uC11C\uB9CC \uD558\uC138\uC694 (feature \uBE0C\uB79C\uCE58 \uBC1C\uD589 \u2192 \uD53D\uC2A4 \uB204\uB77D\uBCF8\uC774 npm latest \uB85C \uB098\uAC00\uB294 \uC0AC\uACE0 \uBC29\uC9C0). git checkout ${def} && git pull \uD6C4 \uC7AC\uC2DC\uB3C4.`,
+    preflightDirty: "\uBC1C\uD589 \uC911\uB2E8 \u2014 \uCEE4\uBC0B \uC548 \uB41C \uBCC0\uACBD\uC774 \uC788\uC2B5\uB2C8\uB2E4. \uBC1C\uD589 \uC804 \uCEE4\uBC0B/\uC815\uB9AC\uD558\uC138\uC694 (untracked \uD30C\uC77C\uC740 \uBB34\uC2DC)."
   },
   harness: {
     title: "\uD1B5\uD569 \uD488\uC9C8 \uC810\uAC80"
@@ -914,6 +922,10 @@ var ko = {
     learnTitle: "\u{1F9E0} Learning \uAE30\uB85D",
     resumeTitle: "\u25B6\uFE0F  HARD_STOP \uD574\uC81C"
   },
+  work: {
+    workTitle: "\u{1F680} vhk work \u2014 \uC791\uC5C5 \uC2DC\uC791/\uC774\uC5B4\uD558\uAE30",
+    handoffTitle: "\u23F8\uFE0F  vhk work handoff \u2014 \uC911\uB2E8 \uC815\uB9AC"
+  },
   pattern: {
     detectTitle: "\uD328\uD134 \uAC10\uC9C0",
     listTitle: "\uD328\uD134 \uBAA9\uB85D",
@@ -1378,29 +1390,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 +1535,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 +1548,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 +1559,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 +1593,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 +1642,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}`));
@@ -1882,7 +1956,7 @@ async function envCheck() {
 }
 
 // src/commands/publish.ts
-import { existsSync as existsSync4, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
 import chalk6 from "chalk";
 import inquirer3 from "inquirer";
 import ora from "ora";
@@ -1909,8 +1983,26 @@ function bumpVersion(current, type) {
       return `${major}.${minor}.${patch + 1}`;
   }
 }
+function insertChangelogStub(content, version, date) {
+  const escaped = version.replace(/\./g, "\\.");
+  if (new RegExp(`^## \\[${escaped}\\]`, "m").test(content)) return content;
+  const stub = `## [${version}] - ${date}
+
+_\uBCC0\uACBD \uB0B4\uC5ED \uC791\uC131 \uD544\uC694._
+
+`;
+  const firstEntry = content.match(/^## \[\d+\.\d+\.\d+\]/m);
+  if (firstEntry && firstEntry.index !== void 0) {
+    return content.slice(0, firstEntry.index) + stub + content.slice(firstEntry.index);
+  }
+  return content.trimEnd() + "\n\n" + stub;
+}
+function bumpClaudeMdVersion(content, newVersion) {
+  return content.replace(/(\*\*버전:\*\*\s*v)\d+\.\d+\.\d+/, `$1${newVersion}`);
+}
 function gitPostRelease(newVersion) {
-  const add = safeExecFile("git", ["add", "package.json"]);
+  const filesToAdd = existsSync4("CHANGELOG.md") ? ["package.json", "CHANGELOG.md"] : ["package.json"];
+  const add = safeExecFile("git", ["add", ...filesToAdd]);
   if (!add.ok) {
     return {
       added: false,
@@ -1951,9 +2043,30 @@ function gitPostRelease(newVersion) {
     pushed: push.ok && pushTags.ok
   };
 }
+function evaluatePublishPreflight(branch, trackedStatus, defaultBranch) {
+  if (branch !== defaultBranch) return { ok: false, code: "wrong-branch" };
+  if (trackedStatus.trim()) return { ok: false, code: "dirty" };
+  return { ok: true };
+}
+function publishPreflight() {
+  const br = safeExecFile("git", ["branch", "--show-current"]);
+  const branch = br.ok ? br.out.trim() : "";
+  const head = safeExecFile("git", ["symbolic-ref", "--short", "refs/remotes/origin/HEAD"]);
+  const defaultBranch = head.ok ? head.out.trim().split("/").pop() || "main" : "main";
+  const st = safeExecFile("git", ["status", "--porcelain", "--untracked-files=no"]);
+  const trackedStatus = st.ok ? st.out : "";
+  return { ...evaluatePublishPreflight(branch, trackedStatus, defaultBranch), branch, defaultBranch };
+}
 async function publish() {
   console.log(chalk6.bold("\n\u{1F4E6} " + t("publish.title")));
   console.log(chalk6.gray("\u2500".repeat(40)));
+  const pre = publishPreflight();
+  if (!pre.ok) {
+    const msg = pre.code === "wrong-branch" ? t("publish.preflightWrongBranch", pre.branch || "(detached)", pre.defaultBranch) : t("publish.preflightDirty");
+    console.log(chalk6.red(`
+\u274C ${msg}`));
+    return;
+  }
   if (!existsSync4("package.json")) {
     console.log(chalk6.red("\u274C package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
     return;
@@ -1986,13 +2099,25 @@ async function publish() {
   pkg.version = newVersion;
   writeFileSync2("package.json", JSON.stringify(pkg, null, 2) + "\n", "utf-8");
   console.log(chalk6.green("\u2705 package.json \uBC84\uC804 \uC5C5\uB370\uC774\uD2B8"));
+  const claudeMdOriginal = existsSync4("CLAUDE.md") ? readFileSync4("CLAUDE.md", "utf-8") : null;
+  if (claudeMdOriginal !== null) {
+    const bumped = bumpClaudeMdVersion(claudeMdOriginal, newVersion);
+    if (bumped !== claudeMdOriginal) {
+      writeFileSync2("CLAUDE.md", bumped, "utf-8");
+      console.log(chalk6.green("\u2705 CLAUDE.md \uBC84\uC804\uC904 \uB3D9\uAE30\uD654"));
+    }
+  }
+  const rollbackVersion = () => {
+    pkg.version = currentVersion;
+    writeFileSync2("package.json", JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+    if (claudeMdOriginal !== null) writeFileSync2("CLAUDE.md", claudeMdOriginal, "utf-8");
+  };
   const buildSpinner = ora(t("publish.building")).start();
   const buildResult = safeExecFile("pnpm", ["build"]);
   if (!buildResult.ok) {
     buildSpinner.fail(t("publish.buildFailed"));
     console.log(chalk6.red(buildResult.err.slice(0, 500)));
-    pkg.version = currentVersion;
-    writeFileSync2("package.json", JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+    rollbackVersion();
     return;
   }
   buildSpinner.succeed(t("publish.buildSuccess"));
@@ -2001,8 +2126,7 @@ async function publish() {
   if (!testResult.ok) {
     testSpinner.fail(t("publish.testFailed"));
     console.log(chalk6.red(testResult.err.slice(0, 500)));
-    pkg.version = currentVersion;
-    writeFileSync2("package.json", JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+    rollbackVersion();
     return;
   }
   testSpinner.succeed(t("publish.testSuccess"));
@@ -2015,8 +2139,7 @@ async function publish() {
     }
   ]);
   if (!confirm) {
-    pkg.version = currentVersion;
-    writeFileSync2("package.json", JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+    rollbackVersion();
     console.log(chalk6.gray("\uCDE8\uC18C\uB428. \uBC84\uC804\uC774 \uC6D0\uB798\uB300\uB85C \uBCF5\uAD6C\uB429\uB2C8\uB2E4."));
     return;
   }
@@ -2028,13 +2151,21 @@ async function publish() {
     console.log(chalk6.red(`
 \u2716 ${t("publish.publishFailed")}`));
     console.log(chalk6.red(pubResult.err.slice(0, 500)));
-    pkg.version = currentVersion;
-    writeFileSync2("package.json", JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+    rollbackVersion();
     console.log(chalk6.gray(`\u{1F4E6} package.json \uBC84\uC804\uC744 v${currentVersion}\uB85C \uBCF5\uAD6C\uD588\uC2B5\uB2C8\uB2E4.`));
     return;
   }
   console.log(chalk6.green(`
 \u2714 ${t("publish.publishSuccess")}`));
+  if (existsSync4("CHANGELOG.md")) {
+    const cl = readFileSync4("CHANGELOG.md", "utf-8");
+    const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    const updated = insertChangelogStub(cl, newVersion, date);
+    if (updated !== cl) {
+      writeFileSync2("CHANGELOG.md", updated, "utf-8");
+      console.log(chalk6.green(`\u2705 CHANGELOG.md \uC5D0 [${newVersion}] \uC2A4\uD141 \uCD94\uAC00 \u2014 \uBCF8\uBB38 \uBCF4\uAC15 \uD544\uC694`));
+    }
+  }
   const git = gitPostRelease(newVersion);
   if (git.warning) {
     console.log(chalk6.yellow(`