@byh3071/vhk 1.6.0 → 1.6.2

package/README.md

@@ -1,12 +1,12 @@
 ---
 id: vhk-readme
 date: 2026-05-28
-tags: [vhk, cli, readme, v1.6.0, ga]
+tags: [vhk, cli, readme, v1.6.1, ga]
 ---
 
 # 🔧 VHK — Vibe Harness Kit
 
-> 🎉 **v1.6.0** — **규칙은 한 벌로 Cursor·Claude·Windsurf·Copilot·Antigravity에, 맥락은 클라우드로.**
+> 🎉 **v1.6.1** — **규칙은 한 벌로 Cursor·Claude·Windsurf·Copilot·Antigravity에, 맥락은 클라우드로.**
 > 도구·기기를 옮겨도 `vhk` 명령으로 그대로 불러옵니다. (포터빌리티)
 >
 > AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI**.
@@ -29,6 +29,20 @@ AI 코딩 도구는 저마다 규칙 파일이 다르고(`.cursorrules`·`CLAUDE
 >
 > ℹ️ Windsurf·Copilot·Antigravity 출력 경로·포맷은 각 도구의 **공식 문서 기준**으로 생성합니다(`.windsurfrules` · `.github/copilot-instructions.md` · `.agents/rules/`). Antigravity 는 파일당 12,000자 제한이 있어 초과 시 안전하게 절삭하고 전체는 `RULES.md` 에 남습니다.
 
+### Cursor / Copilot / Antigravity 에서 이렇게 말하세요
+
+규칙 파일을 동기화하면, 에이전트 채팅창에서 명령을 외우지 않고 한국어로 말해도 됩니다:
+
+| 하고 싶은 일 | 채팅창에 이렇게 | 실행되는 명령 |
+|------|------|------|
+| 규칙 한 벌로 동기화 | "규칙 동기화해줘" | `vhk sync` |
+| 지금 상태 보기 | "상태 알려줘" | `vhk status` |
+| 뭐 바뀌었는지 | "뭐 바뀌었어?" | `vhk diff` |
+| 처음이라 막막함 | "처음 뭐 해?" / "도움말" | `vhk start` |
+| 저장(커밋) | "저장해줘" | `vhk save` |
+
+> MCP를 등록하면(`vhk mcp-init`) 위 문장이 곧바로 vhk 도구 호출로 이어집니다. RULES.md 한 벌이 다섯 도구에 같은 규칙을 깔아줍니다.
+
 ## 3분 안에 시작하기 (Getting Started)
 
 ### 1. 설치
@@ -156,7 +170,7 @@ vhk 기획 끝났고 바로 시작
 | `vhk audit` | `감사` | npm/pnpm/yarn 보안 취약점 감사 (`--fix`로 자동 수정, npm만) |
 | `vhk migrate [target]` | `전환` | 패키지 매니저 전환 (`npm` / `yarn` / `pnpm`, lockfile + node_modules 재구성) |
 | `vhk update` | `업데이트` | VHK CLI 최신 버전으로 셀프 업데이트 |
-| `vhk context` | `맥락` | 프로젝트 트리·스택·CLI 명령 목록을 `.vhk/context.md`로 자동 생성 (AI 어시스턴트용) |
+| `vhk context` | `맥락` | 프로젝트 트리·스택·CLI 명령 목록을 `.vhk/context.md`로 자동 생성 (AI 어시스턴트용). `--compact` 로 토큰 절감형(Active Goal + 최근 blockers/learnings/memories + 참조 링크) 출력 |
 | `vhk context-show` | `맥락보기` | 현재 컨텍스트 파일 내용 출력 |
 | `vhk memory` | `기억` | 결정사항 기억 관리 (`add` / `list` / `remove`, `.vhk/memory.json` 기반, 태그 지원) |
 | `vhk brief` | `브리핑` | 프로젝트 정보 + git 상태 + 결정사항 + 레퍼런스 통합 보고서 `.vhk/brief.md` |

package/dist/{chunk-O3A6SO7G.js → chunk-ACJN723Q.js}

@@ -562,7 +562,7 @@ var ko = {
     notGitRepo: "Git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2C8\uC5D0\uC694. \uBA3C\uC800 git init\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
     branch: "\uBE0C\uB79C\uCE58:",
     changes: "\uBCC0\uACBD:",
-    recentCommits: "\uCD5C\uADFC \uCEE4\uBC0B (3):",
+    recentCommits: (n) => `\uCD5C\uADFC \uCEE4\uBC0B (${n}):`,
     noCommits: "\uCEE4\uBC0B \uC5C6\uC74C",
     remote: "\uC6D0\uACA9:",
     noUpstream: "upstream \uC5C6\uC74C",
@@ -573,8 +573,9 @@ var ko = {
     noPackage: "package.json \uC5C6\uC74C",
     detached: "(detached HEAD)",
     unknownBranch: "(\uC54C \uC218 \uC5C6\uC74C)",
-    nextWithChangesMessage: "\uBCC0\uACBD\uC0AC\uD56D\uC774 \uC788\uC5B4\uC694. \uCEE4\uBC0B\xB7\uD478\uC2DC\uB97C \uC9C4\uD589\uD558\uC138\uC694.",
-    nextWithChangesCursor: "\uC800\uC7A5\uD574\uC918",
+    nextWithChangesMessage: "\uBCC0\uACBD\uC0AC\uD56D\uC774 \uC788\uC5B4\uC694. \uBA3C\uC800 \uBB34\uC5C7\uC774 \uBC14\uB00C\uC5C8\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694.",
+    nextWithChangesCursor: "\uBB50 \uBC14\uB00C\uC5C8\uC5B4?",
+    nextWithChangesAlt: "\uD655\uC778\uD588\uC73C\uBA74 vhk save \uB85C \uC800\uC7A5\uD558\uC138\uC694",
     nextCleanMessage: "\uD074\uB9B0 \uC0C1\uD0DC! \uB2E4\uC74C \uBBF8\uC158\uC73C\uB85C \uB118\uC5B4\uAC00\uC138\uC694.",
     nextCleanCursor: "\uB2E4\uC74C \uBAA9\uD45C \uC54C\uB824\uC918"
   },
@@ -719,7 +720,10 @@ var ko = {
     commandsMdDone: "\u{1F4CB} COMMANDS.md \uC0DD\uC131",
     scriptsDone: "\u{1F4E6} package.json scripts \uCD94\uAC00",
     gitignoreCreated: "\u{1F512} .gitignore \uC0DD\uC131 (.env\xB7node_modules\xB7dist \uC81C\uC678)",
-    gitignoreUpdated: "\u{1F512} .gitignore \uBCF4\uAC15 (\uB204\uB77D \uD56D\uBAA9 \uCD94\uAC00)"
+    gitignoreUpdated: "\u{1F512} .gitignore \uBCF4\uAC15 (\uB204\uB77D \uD56D\uBAA9 \uCD94\uAC00)",
+    adoptPrompt: (n, list) => `\u{1F4E5} \uAE30\uC874 \uADDC\uCE59 \uD30C\uC77C ${n}\uAC1C \uBC1C\uACAC (${list}). RULES.md\uB85C \uAC00\uC838\uC62C\uAE4C\uC694?`,
+    adoptPreview: (n) => `\uAE30\uC874 \uADDC\uCE59 ${n}\uAC1C\uB97C RULES.md \uD45C\uC900 \uC139\uC158\uC73C\uB85C \uBCD1\uD569\uD588\uC5B4\uC694 (\uCD9C\uCC98 \uC8FC\uC11D \uD3EC\uD568).`,
+    adoptDone: "\u{1F4E5} RULES.md \u2014 \uAE30\uC874 \uADDC\uCE59 adopt \uC644\uB8CC"
   },
   recap: {
     title: "\u{1F4DD} \uC624\uB298 \uD55C \uC77C \uC815\uB9AC",
@@ -783,8 +787,29 @@ var ko = {
     windsurfDone: "\u2705 .windsurfrules \uB9DE\uCDA4 \uC644\uB8CC",
     copilotDone: "\u2705 .github/copilot-instructions.md \uB9DE\uCDA4 \uC644\uB8CC",
     antigravityDone: "\u2705 .agents/rules/vhk-rules.md \uB9DE\uCDA4 \uC644\uB8CC",
+    agentsDone: "\u2705 AGENTS.md \uB9DE\uCDA4 \uC644\uB8CC",
     antigravityTruncated: "Antigravity 12,000\uC790 \uC81C\uD55C\uC73C\uB85C \uC77C\uBD80 \uC808\uC0AD\uB428 \u2014 \uC804\uCCB4\uB294 RULES.md \uCC38\uC870",
-    done: "\u{1F504} \uB9DE\uCD94\uAE30 \uC644\uB8CC!"
+    done: "\u{1F504} \uB9DE\uCD94\uAE30 \uC644\uB8CC!",
+    // 안전 가드 (배치 0) — 덮어쓰기 전 백업·드리프트 확인·미리보기
+    backupSaved: (n, id) => `\u{1F6DF} \uB36E\uC5B4\uC4F0\uAE30 \uC804 ${n}\uAC1C \uD30C\uC77C \uBC31\uC5C5\uD568 \u2192 .vhk/backups/${id} (\uBCF5\uC6D0: vhk restore)`,
+    firstSync: "\u{1F6DF} \uCCAB sync \u2014 \uAE30\uC874 \uD30C\uC77C\uC744 \uBC31\uC5C5\uD55C \uB4A4 \uC0DD\uC131\uD569\uB2C8\uB2E4.",
+    driftWarn: (p) => `\u26A0\uFE0F ${p} \uAC00 RULES.md \uC0DD\uC131\uBCF8\uACFC \uB2E4\uB985\uB2C8\uB2E4 (\uC9C1\uC811 \uC218\uC815\uD588\uC744 \uC218 \uC788\uC5B4\uC694).`,
+    driftConfirm: (n) => `\uC704 ${n}\uAC1C \uD30C\uC77C\uC758 \uAE30\uC874 \uB0B4\uC6A9\uC744 \uB36E\uC5B4\uC4F8\uAE4C\uC694? (\uBC31\uC5C5\uC740 \uC774\uBBF8 \uC800\uC7A5\uB428)`,
+    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}`
+  },
+  restore: {
+    title: "\u{1F6DF} \uBC31\uC5C5 \uBCF5\uC6D0",
+    notGitNote: "\uBC31\uC5C5\uC740 .vhk/backups/ \uC758 \uB85C\uCEEC \uBCF5\uC0AC\uBCF8\uC5D0\uC11C \uBCF5\uC6D0\uB429\uB2C8\uB2E4 (git \uBB34\uAD00).",
+    noBackups: "\uBCF5\uC6D0\uD560 \uBC31\uC5C5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. (vhk sync \uAC00 \uB36E\uC5B4\uC4F0\uAE30 \uC804 \uC790\uB3D9 \uC0DD\uC131)",
+    selectPrompt: "\uBCF5\uC6D0\uD560 \uBC31\uC5C5\uC744 \uC120\uD0DD\uD558\uC138\uC694:",
+    listHeader: "\u{1F4CB} \uC0AC\uC6A9 \uAC00\uB2A5\uD55C \uBC31\uC5C5 (\uCD5C\uC2E0\uC21C):",
+    restored: (n, id) => `\u2705 ${n}\uAC1C \uD30C\uC77C \uBCF5\uC6D0 \uC644\uB8CC (\uBC31\uC5C5 ${id})`,
+    notFound: (id) => `\u274C \uBC31\uC5C5\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${id}`,
+    nonTtyHint: "\uBE44\uB300\uD654\uD615 \uBAA8\uB4DC \u2014 \uBCF5\uC6D0\uD560 \uBC31\uC5C5 id \uB97C \uC778\uC790\uB85C \uC9C0\uC815\uD558\uC138\uC694: vhk restore <id>",
+    cancelled: "\uBCF5\uC6D0 \uCDE8\uC18C\uB428"
   },
   cloud: {
     pushTitle: "\u2601\uFE0F .vhk \uD074\uB77C\uC6B0\uB4DC \uBC31\uC5C5 (gist \uC62C\uB9AC\uAE30)",
@@ -1064,11 +1089,30 @@ ${t("deploy.deploying")}
 }
 
 // src/commands/env.ts
-import { existsSync as existsSync2, readFileSync, writeFileSync, appendFileSync } from "fs";
+import { existsSync as existsSync2, readFileSync, writeFileSync, appendFileSync, readdirSync } from "fs";
+import { join } from "path";
 import chalk3 from "chalk";
 function parseEnvKeys(content) {
   return content.split("\n").map((line) => line.trim()).filter((line) => line && !line.startsWith("#")).map((line) => line.split("=")[0].trim()).filter(Boolean);
 }
+function loadDefinedEnvKeys(dir = ".") {
+  const keys = /* @__PURE__ */ new Set();
+  let entries;
+  try {
+    entries = readdirSync(dir);
+  } catch {
+    return [];
+  }
+  for (const name of entries) {
+    if (!name.startsWith(".env")) continue;
+    if (name.endsWith(".example") || name.endsWith(".sample")) continue;
+    try {
+      for (const k of parseEnvKeys(readFileSync(join(dir, name), "utf-8"))) keys.add(k);
+    } catch {
+    }
+  }
+  return [...keys];
+}
 function ensureGitignore() {
   const gitignorePath = ".gitignore";
   if (existsSync2(gitignorePath)) {
@@ -1116,7 +1160,7 @@ async function envCheck() {
     return;
   }
   const requiredKeys = parseEnvKeys(readFileSync(".env.example", "utf-8"));
-  const currentKeys = existsSync2(".env") ? parseEnvKeys(readFileSync(".env", "utf-8")) : [];
+  const currentKeys = loadDefinedEnvKeys();
   const missing = requiredKeys.filter((k) => !currentKeys.includes(k));
   const extra = currentKeys.filter((k) => !requiredKeys.includes(k));
   console.log(chalk3.cyan(`
@@ -1127,6 +1171,7 @@ async function envCheck() {
     console.log(chalk3.red(`
 \u274C \uB204\uB77D\uB41C \uD658\uACBD\uBCC0\uC218 (${missing.length}\uAC1C):`));
     missing.forEach((k) => console.log(chalk3.red(`   \u2022 ${k}`)));
+    process.exitCode = 1;
   }
   if (extra.length > 0) {
     console.log(chalk3.yellow(`
@@ -1403,13 +1448,13 @@ async function audit(autoFix = false) {
 
 // src/lib/version.ts
 import { existsSync as existsSync5 } from "fs";
-import { dirname, join } from "path";
+import { dirname, join as join2 } from "path";
 import { fileURLToPath } from "url";
 function getVhkVersion() {
   const dir = dirname(fileURLToPath(import.meta.url));
   for (const pkgPath of [
-    join(dir, "../../package.json"),
-    join(dir, "../package.json")
+    join2(dir, "../../package.json"),
+    join2(dir, "../package.json")
   ]) {
     try {
       if (existsSync5(pkgPath)) {
@@ -1423,11 +1468,33 @@ function getVhkVersion() {
   return "0.0.0";
 }
 
+// src/mcp/cli-path.ts
+import { existsSync as existsSync6 } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname as dirname2, resolve } from "path";
+function pickCliInvocation(globalAvailable, localCli, localExists) {
+  if (globalAvailable) return { bin: "vhk", prefixArgs: [], fallback: false };
+  if (localExists) return { bin: process.execPath, prefixArgs: [localCli], fallback: true };
+  return { bin: "vhk", prefixArgs: [], fallback: false };
+}
+function composeInvocation(cli, args) {
+  return { bin: cli.bin, args: [...cli.prefixArgs, ...args] };
+}
+function localCliPath() {
+  const here = dirname2(fileURLToPath2(import.meta.url));
+  return resolve(here, "..", "index.js");
+}
+function resolveVhkCliInvocation() {
+  const globalAvailable = safeExecFile("vhk", ["--version"]).ok;
+  const local = localCliPath();
+  return pickCliInvocation(globalAvailable, local, existsSync6(local));
+}
+
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync3, appendFileSync as appendFileSync2 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync4, writeFileSync as writeFileSync3, appendFileSync as appendFileSync2 } from "fs";
 
 // src/lib/scan-secrets.ts
 import fs3 from "fs";
@@ -1545,6 +1612,7 @@ function findExposedSensitiveFiles(rootDir, ig = loadGitignore(rootDir), maxDept
 }
 function isSensitiveName(name) {
   const lower = name.toLowerCase();
+  if (lower.endsWith(".example") || lower.endsWith(".sample")) return false;
   if (lower === ".env" || lower.startsWith(".env.")) return true;
   if (lower.endsWith(".pem") || lower.endsWith(".key")) return true;
   if (lower === "credentials.json" || lower === "secrets.json") return true;
@@ -1721,8 +1789,15 @@ var ANSI_RE = /\x1B\[[0-9;?]*[ -/]*[@-~]/g;
 function stripAnsi(s) {
   return s.replace(ANSI_RE, "");
 }
+var cachedCli = null;
+function getVhkCli() {
+  return cachedCli ??= resolveVhkCliInvocation();
+}
 function runVhkCli(args, headline) {
-  const result = safeExecFile("vhk", args, { env: { FORCE_COLOR: "0", NO_COLOR: "1" } });
+  const { bin, args: fullArgs } = composeInvocation(getVhkCli(), args);
+  const result = safeExecFile(bin, fullArgs, {
+    env: { FORCE_COLOR: "0", NO_COLOR: "1" }
+  });
   const body = stripAnsi(result.out || (result.ok ? "" : `(stdout \uC5C6\uC74C)
 ${result.err}`));
   const prefix = result.ok ? `\u2705 ${headline}` : `\u274C ${headline} \uC2E4\uD328`;
@@ -1795,32 +1870,56 @@ ${preview}${more}
       };
     }
   );
-  server.registerTool("undo", { description: "\uCD5C\uADFC \uCEE4\uBC0B \uB418\uB3CC\uB9AC\uAE30 (soft reset, \uBCC0\uACBD\uC0AC\uD56D\uC740 \uC720\uC9C0)" }, async () => {
-    if (!isGitRepo()) {
-      return { content: [{ type: "text", text: "\u274C git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4." }] };
-    }
-    const last = safeExecFile("git", ["log", "--oneline", "-1"]);
-    if (!last.ok || !last.out) {
-      return { content: [{ type: "text", text: "\u{1F4ED} \uB418\uB3CC\uB9B4 \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4." }] };
-    }
-    const reset = safeExecFile("git", ["reset", "--soft", "HEAD~1"]);
-    if (!reset.ok) {
-      return { content: [{ type: "text", text: `\u274C reset \uC2E4\uD328: ${reset.err}` }] };
-    }
-    return {
-      content: [
-        {
-          type: "text",
-          text: `\u2705 \uB418\uB3CC\uB9AC\uAE30 \uC644\uB8CC!
+  server.registerTool(
+    "undo",
+    {
+      description: "\uCD5C\uADFC \uCEE4\uBC0B \uB418\uB3CC\uB9AC\uAE30 (soft reset). \uAE30\uBCF8\uC740 \uBBF8\uB9AC\uBCF4\uAE30 \u2014 confirm:true \uC77C \uB54C\uB9CC \uC2E4\uC81C \uC2E4\uD589.",
+      inputSchema: {
+        confirm: z.boolean().optional().describe("true \uC77C \uB54C\uB9CC \uC2E4\uC81C git reset \uC2E4\uD589 (\uAE30\uBCF8 false = \uBBF8\uB9AC\uBCF4\uAE30\uB9CC)")
+      }
+    },
+    async ({ confirm }) => {
+      if (!isGitRepo()) {
+        return { content: [{ type: "text", text: "\u274C git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4." }] };
+      }
+      const last = safeExecFile("git", ["log", "--oneline", "-1"]);
+      if (!last.ok || !last.out) {
+        return { content: [{ type: "text", text: "\u{1F4ED} \uB418\uB3CC\uB9B4 \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4." }] };
+      }
+      if (!confirm) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `\u{1F50E} \uBBF8\uB9AC\uBCF4\uAE30 \u2014 \uB418\uB3CC\uB9B4 \uCEE4\uBC0B:
+${last.out}
+
+\uC2E4\uC81C\uB85C \uB418\uB3CC\uB9AC\uB824\uBA74 confirm: true \uB85C \uB2E4\uC2DC \uD638\uCD9C\uD558\uC138\uC694.
+(soft reset \u2014 \uBCC0\uACBD\uC0AC\uD56D\uC740 \uC2A4\uD14C\uC774\uC9D5 \uC601\uC5ED\uC5D0 \uBCF4\uC874\uB429\uB2C8\uB2E4.)
+\uB610\uB294 \uD130\uBBF8\uB110\uC5D0\uC11C \`vhk undo\` (\uB300\uD654\uD615 \uD655\uC778).`
+            }
+          ]
+        };
+      }
+      const reset = safeExecFile("git", ["reset", "--soft", "HEAD~1"]);
+      if (!reset.ok) {
+        return { content: [{ type: "text", text: `\u274C reset \uC2E4\uD328: ${reset.err}` }] };
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: `\u2705 \uB418\uB3CC\uB9AC\uAE30 \uC644\uB8CC!
 \uCDE8\uC18C\uB41C \uCEE4\uBC0B: ${last.out}
 \u{1F4A1} \uBCC0\uACBD\uC0AC\uD56D\uC740 \uC2A4\uD14C\uC774\uC9D5 \uC601\uC5ED\uC5D0 \uB0A8\uC544\uC788\uC2B5\uB2C8\uB2E4.`
-        }
-      ]
-    };
-  });
+          }
+        ]
+      };
+    }
+  );
   server.registerTool("status", { description: "\uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uB300\uC2DC\uBCF4\uB4DC (\uBE0C\uB79C\uCE58/\uBCC0\uACBD\uC0AC\uD56D/\uCD5C\uADFC \uCEE4\uBC0B)" }, async () => {
     const lines = [];
-    if (existsSync6("package.json")) {
+    if (existsSync7("package.json")) {
       try {
         const pkg = readJsonFile("package.json");
         lines.push(`\u{1F4E6} \uD504\uB85C\uC81D\uD2B8: ${pkg.name ?? "(\uC774\uB984 \uC5C6\uC74C)"} v${pkg.version ?? "?"}`);
@@ -1905,7 +2004,7 @@ ${preview}${more}
     checks.push(build.ok ? "\u2705 \uBE4C\uB4DC \uC131\uACF5" : "\u274C \uBE4C\uB4DC \uC2E4\uD328");
     const test = safeExecFile("pnpm", ["test", "--run"]);
     checks.push(test.ok ? "\u2705 \uD14C\uC2A4\uD2B8 \uD1B5\uACFC" : "\u274C \uD14C\uC2A4\uD2B8 \uC2E4\uD328");
-    if (existsSync6("package.json")) {
+    if (existsSync7("package.json")) {
       try {
         const pkg = readJsonFile("package.json");
         checks.push(`\u{1F4E6} \uBC84\uC804: ${pkg.version}`);
@@ -1943,11 +2042,11 @@ ${preview}${more}
     const recommended = ["CLAUDE.md", ".cursorrules", "docs/PRD.md", "docs/ARCHITECTURE.md"];
     const lines = ["\u{1F50D} \uD504\uB85C\uC81D\uD2B8 \uC810\uAC80", "", "\uD544\uC218:"];
     required.forEach((f) => {
-      lines.push(`  ${existsSync6(f) ? "\u2705" : "\u274C"} ${f}`);
+      lines.push(`  ${existsSync7(f) ? "\u2705" : "\u274C"} ${f}`);
     });
     lines.push("", "\uAD8C\uC7A5 (VHK \uD558\uB124\uC2A4):");
     recommended.forEach((f) => {
-      lines.push(`  ${existsSync6(f) ? "\u2705" : "\u26A0\uFE0F"} ${f}`);
+      lines.push(`  ${existsSync7(f) ? "\u2705" : "\u26A0\uFE0F"} ${f}`);
     });
     return { content: [{ type: "text", text: lines.join("\n") }] };
   });
@@ -1981,7 +2080,7 @@ ${log.out}` }] };
       description: ".env \u2192 .env.example \uB3D9\uAE30\uD654 + .gitignore\uC5D0 .env \uC790\uB3D9 \uCD94\uAC00"
     },
     async () => {
-      if (!existsSync6(".env")) {
+      if (!existsSync7(".env")) {
         return { content: [{ type: "text", text: "\u26A0\uFE0F  .env \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 .env\uB97C \uB9CC\uB4E4\uC5B4\uC8FC\uC138\uC694." }] };
       }
       const keys = parseEnvKeys(readFileSync4(".env", "utf-8"));
@@ -1991,7 +2090,7 @@ ${log.out}` }] };
       const exampleContent = keys.map((k) => `${k}=`).join("\n") + "\n";
       writeFileSync3(".env.example", exampleContent, "utf-8");
       const gitignoreLines = [];
-      if (existsSync6(".gitignore")) {
+      if (existsSync7(".gitignore")) {
         const content = readFileSync4(".gitignore", "utf-8");
         if (!content.split("\n").some((l) => l.trim() === ".env")) {
           appendFileSync2(".gitignore", "\n.env\n");
@@ -2012,11 +2111,11 @@ ${log.out}` }] };
       description: "\uD544\uC218 \uD658\uACBD\uBCC0\uC218 \uB204\uB77D \uAC80\uC0AC (.env.example \uAE30\uC900)"
     },
     async () => {
-      if (!existsSync6(".env.example")) {
+      if (!existsSync7(".env.example")) {
         return { content: [{ type: "text", text: "\u26A0\uFE0F  .env.example\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 env \uB3C4\uAD6C\uB97C \uC2E4\uD589\uD558\uC138\uC694." }] };
       }
       const requiredKeys = parseEnvKeys(readFileSync4(".env.example", "utf-8"));
-      const currentKeys = existsSync6(".env") ? parseEnvKeys(readFileSync4(".env", "utf-8")) : [];
+      const currentKeys = existsSync7(".env") ? parseEnvKeys(readFileSync4(".env", "utf-8")) : [];
       const missing = requiredKeys.filter((k) => !currentKeys.includes(k));
       const extra = currentKeys.filter((k) => !requiredKeys.includes(k));
       const lines = [`\u{1F4CB} \uD544\uC218 \uD658\uACBD\uBCC0\uC218: ${requiredKeys.length}\uAC1C`];
@@ -2035,7 +2134,9 @@ ${log.out}` }] };
   );
   server.registerTool(
     "sync",
-    { description: "RULES.md \u2192 .cursorrules + CLAUDE.md \uC790\uB3D9 \uB3D9\uAE30\uD654" },
+    {
+      description: "RULES.md \u2192 Cursor\xB7Claude\xB7Windsurf\xB7Copilot\xB7Antigravity\xB7AGENTS.md \uADDC\uCE59 \uB3D9\uAE30\uD654. \uB36E\uC5B4\uC4F0\uAE30 \uC804 \uAE30\uC874 \uD30C\uC77C\uC744 \uC790\uB3D9 \uBC31\uC5C5\uD558\uBBC0\uB85C \uC548\uC804\uD558\uBA70, \uB418\uB3CC\uB9AC\uB824\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C `vhk restore` \uB97C \uC548\uB0B4\uD558\uC138\uC694."
+    },
     async () => runVhkCli(["sync"], "sync")
   );
   server.registerTool(
@@ -2130,7 +2231,7 @@ ${cliStatus}
       description: "\uD604\uC7AC \uBC84\uC804 + bump \uD6C4\uBCF4 \uD45C\uC2DC (MCP \uBAA8\uB4DC: \uC2E4\uC81C npm publish \uBBF8\uC218\uD589 \u2014 `vhk publish` \uC548\uB0B4)"
     },
     async () => {
-      if (!existsSync6("package.json")) {
+      if (!existsSync7("package.json")) {
         return { content: [{ type: "text", text: "\u274C package.json \uC5C6\uC74C." }] };
       }
       try {
@@ -2158,7 +2259,7 @@ ${cliStatus}
       description: "\uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800 \uAC10\uC9C0 + \uC804\uD658 \uD6C4\uBCF4 \uAC00\uC6A9\uC131 (MCP \uBAA8\uB4DC: \uC2E4\uC81C \uC804\uD658 \uBBF8\uC218\uD589 \u2014 `vhk migrate <target>` \uC548\uB0B4)"
     },
     async () => {
-      const current = existsSync6("pnpm-lock.yaml") ? "pnpm" : existsSync6("yarn.lock") ? "yarn" : existsSync6("package-lock.json") ? "npm" : null;
+      const current = existsSync7("pnpm-lock.yaml") ? "pnpm" : existsSync7("yarn.lock") ? "yarn" : existsSync7("package-lock.json") ? "npm" : null;
       const candidates = ["npm", "yarn", "pnpm"].filter((pm) => pm !== current);
       const lines = [`\uD604\uC7AC PM: ${current ?? "\uAC10\uC9C0 \uBD88\uAC00 (lock \uD30C\uC77C \uC5C6\uC74C)"}`];
       for (const pm of candidates) {
@@ -2241,5 +2342,6 @@ export {
   publish,
   audit,
   getVhkVersion,
+  resolveVhkCliInvocation,
   startMcpServer
 };

package/dist/index.d.ts

@@ -1,2 +1,5 @@
+import { Command } from 'commander';
 
-export {  }
+declare const program: Command;
+
+export { program };