@byh3071/vhk 0.5.1 → 0.5.3

package/README.md

@@ -1,12 +1,14 @@
 ---
 id: vhk-readme
 date: 2026-05-23
-tags: [vhk, cli, readme, v0.5.1]
+tags: [vhk, cli, readme, v0.5.3]
 ---
 
 # 🔧 VHK — Vibe Harness Kit
 
-> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.5.1)
+> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.5.3)
+>
+> 🍽️ **VHK는 VHK로 부트스트랩됨** — 이 레포의 `docs/`, `CLAUDE.md`, `.cursorrules`도 `vhk init`이 만들었습니다.
 
 명령어를 외우지 않아도 됩니다. `vhk`만 치면 메뉴가 나오고, 한국어로 말해도 알아듣습니다.
 
@@ -103,6 +105,15 @@ vhk 기획 끝났고 바로 시작
 |------|------|
 | `--since YYYY-MM-DD` | 분석 시작일 (기본: 오늘) |
 
+## v0.5.3 하이라이트
+
+| 기능 | 설명 |
+|------|------|
+| **셀프호스팅** | `vhk init`이 vhk-cli 레포 자체를 부트스트랩 — 자기 도구로 자기 레포 만들기 |
+| **CHANGELOG.md** | 변경 이력 표준 파일 신설. `vhk ship`이 `[Unreleased]` → `[버전]` 자동 이동 |
+| **doctor 업데이트 알림** | `vhk doctor`가 npm 최신 버전 비교 후 `🆕 v0.X.X 사용 가능` 한 줄 표시 |
+| **init 안전성** | 옵션값 포함 명령 라우팅 버그 픽스, 사용자 정의 `package.json` scripts 보존 |
+
 ## v0.5.0 하이라이트
 
 | 기능 | 설명 |

package/dist/index.js

@@ -485,8 +485,7 @@ var require_ignore = __commonJS({
 
 // src/index.ts
 import { Command, Help } from "commander";
-import chalk16 from "chalk";
-import inquirer7 from "inquirer";
+import inquirer8 from "inquirer";
 
 // src/lib/nlp-router.ts
 function normalize(input) {
@@ -496,7 +495,7 @@ var NLP_KEYWORDS = {
   save: ["\uC800\uC7A5", "\uC138\uC774\uBE0C", "\uCEE4\uBC0B", "\uC62C\uB824", "\uC62C\uB9AC\uAE30", "\uD478\uC2DC", "push", "commit"],
   undo: ["\uB418\uB3CC\uB824", "\uB418\uB3CC\uB9AC\uAE30", "\uCDE8\uC18C", "\uC6D0\uB798\uB300\uB85C", "\uB864\uBC31", "\uB9AC\uC14B", "reset", "rollback"],
   status: ["\uC0C1\uD0DC", "\uD604\uD669", "\uC5B4\uB5BB\uAC8C", "\uC5B4\uB54C", "\uC9C0\uAE08"],
-  diff: ["\uBCC0\uACBD", "\uBC14\uB010", "\uBB50\uBC14\uB01C", "\uCC28\uC774", "\uB2EC\uB77C\uC9C4", "\uC218\uC815\uB41C"]
+  diff: ["\uBCC0\uACBD", "\uBC14\uB010", "\uBB50\uBC14\uB01C", "\uBC14\uB00C\uC5C8", "\uCC28\uC774", "\uB2EC\uB77C\uC9C4", "\uC218\uC815\uB41C"]
 };
 function matchesKeywords(text, command) {
   const keywords = NLP_KEYWORDS[command];
@@ -546,7 +545,7 @@ var RULES = [
     command: "diff",
     explanation: "\uBCC0\uACBD\uC0AC\uD56D \uC694\uC57D (vhk diff)",
     confidence: "high",
-    test: (t2) => (matchesKeywords(t2, "diff") || /^diff$/.test(t2) || /변경사항|수정\s*내역|차이\s*보/.test(t2)) && !/저장|커밋|push|푸시|상태|현황|세이브|commit/.test(t2)
+    test: (t2) => (matchesKeywords(t2, "diff") || /^diff$/.test(t2) || /변경사항|수정\s*내역|차이\s*보|뭐\s*바뀌/.test(t2)) && !/저장|커밋|push|푸시|상태|현황|세이브|commit/.test(t2)
   },
   {
     command: "undo",
@@ -611,6 +610,69 @@ function extractNotionUrl(input) {
   return m?.[0];
 }
 
+// src/lib/cli-args.ts
+var KNOWN_COMMAND_TOKENS = /* @__PURE__ */ new Set([
+  "gate",
+  "\uAC80\uC99D",
+  "\uC544\uC774\uB514\uC5B4",
+  "init",
+  "\uC2DC\uC791",
+  "\uB9CC\uB4E4\uAE30",
+  "recap",
+  "\uC815\uB9AC",
+  "\uC624\uB298",
+  "sync",
+  "\uB9DE\uCD94\uAE30",
+  "\uADDC\uCE59",
+  "check",
+  "\uC810\uAC80",
+  "\uB9B0\uD2B8",
+  "secure",
+  "\uBCF4\uC548",
+  "scan",
+  "\uC2A4\uCE94",
+  "ship",
+  "\uBC30\uD3EC",
+  "\uB9B4\uB9AC\uC988",
+  "doctor",
+  "\uD658\uACBD",
+  "\uC9C4\uB2E8",
+  "save",
+  "\uC800\uC7A5",
+  "undo",
+  "\uB418\uB3CC\uB9AC\uAE30",
+  "status",
+  "\uC0C1\uD0DC",
+  "\uD604\uD669",
+  "diff",
+  "\uBCC0\uACBD",
+  "\uCC28\uC774",
+  "help"
+]);
+function isOptionToken(token) {
+  return token.startsWith("-");
+}
+function detectNaturalLanguageInput(argv) {
+  const rest = argv.slice(2);
+  if (rest.length === 0) return null;
+  const first = rest[0];
+  if (isOptionToken(first)) return null;
+  if (rest.some(isOptionToken)) return null;
+  const input = rest.join(" ").trim();
+  if (!input) return null;
+  const firstIsKnown = KNOWN_COMMAND_TOKENS.has(first);
+  if (firstIsKnown && rest.length === 1) return null;
+  if (firstIsKnown && rest.length > 1) {
+    if (routeNaturalLanguage(input)) return input;
+    return null;
+  }
+  return input;
+}
+
+// src/lib/nlp-run.ts
+import chalk16 from "chalk";
+import inquirer7 from "inquirer";
+
 // src/i18n/ko.ts
 var ko = {
   status: {
@@ -792,7 +854,9 @@ var ko = {
     projectFiles: "\u{1F4C1} \uD504\uB85C\uC81D\uD2B8 \uD30C\uC77C \uD655\uC778:",
     envNotIgnored: "\u26A0\uFE0F .env\uAC00 .gitignore\uC5D0 \uC5C6\uC74C! \uCD94\uAC00\uD558\uC138\uC694",
     nextOkMessage: "\uD658\uACBD \uC810\uAC80 \uD1B5\uACFC! \uC774\uC81C \uD504\uB85C\uC81D\uD2B8\uB97C \uC2DC\uC791\uD558\uC138\uC694.",
-    nextRetryMessage: "\uC704 \uB3C4\uAD6C\uB97C \uC124\uCE58\uD55C \uD6C4 \uB2E4\uC2DC \uC810\uAC80\uD558\uC138\uC694."
+    nextRetryMessage: "\uC704 \uB3C4\uAD6C\uB97C \uC124\uCE58\uD55C \uD6C4 \uB2E4\uC2DC \uC810\uAC80\uD558\uC138\uC694.",
+    updateAvailable: (latest) => `\u{1F195} v${latest} \uC0AC\uC6A9 \uAC00\uB2A5 \u2014 npm i -g @byh3071/vhk`,
+    updateCurrent: "\uCD5C\uC2E0 \uBC84\uC804\uC744 \uC4F0\uACE0 \uC788\uC5B4\uC694"
   },
   nlp: {
     matched: "\uC774\uAC8C \uB9DE\uB098\uC694?",
@@ -847,7 +911,10 @@ var ko = {
     checkSecurity: "\uBCF4\uC548 \uC2A4\uCE94\uC744 \uB3CC\uB838\uB098\uC694?",
     hintSecurity: "vhk \uBCF4\uC548 scan",
     checkCommit: "\uBAA8\uB4E0 \uBCC0\uACBD\uC774 \uCEE4\uBC0B\uB418\uC5C8\uB098\uC694?",
-    hintCommit: "git status \uD655\uC778"
+    hintCommit: "git status \uD655\uC778",
+    changelogUpdated: (version) => `CHANGELOG.md \uAC31\uC2E0\uB428 \u2014 [Unreleased] \u2192 [${version}] \uC139\uC158\uC73C\uB85C \uC774\uB3D9`,
+    changelogNoUnreleased: "CHANGELOG.md\uC5D0 [Unreleased] \uC139\uC158\uC774 \uC5C6\uC5B4 \uC790\uB3D9 \uAC31\uC2E0\uC744 \uC2A4\uD0B5\uD588\uC5B4\uC694",
+    changelogMissing: "CHANGELOG.md\uAC00 \uC5C6\uC5B4\uC694. \uB9CC\uB4E4\uBA74 ship\uC774 \uC790\uB3D9\uC73C\uB85C [Unreleased] \u2192 \uBC84\uC804 \uC139\uC158\uC73C\uB85C \uC62E\uACA8\uC90D\uB2C8\uB2E4."
   }
 };
 function lookup(path15) {
@@ -1668,7 +1735,7 @@ function enhancePackageScripts(projectDir) {
   const pkgPath = path3.join(projectDir, "package.json");
   if (!fs3.existsSync(pkgPath)) return false;
   const pkg = JSON.parse(fs3.readFileSync(pkgPath, "utf-8"));
-  pkg.scripts = { ...pkg.scripts, ...VHK_PACKAGE_SCRIPTS };
+  pkg.scripts = { ...VHK_PACKAGE_SCRIPTS, ...pkg.scripts };
   fs3.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
   return true;
 }
@@ -2734,6 +2801,27 @@ function getVhkVersion() {
   }
   return void 0;
 }
+function fetchLatestNpmVersion(packageName) {
+  try {
+    const result = execSync(`npm view ${packageName} version`, {
+      encoding: "utf-8",
+      timeout: 5e3,
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    if (/^\d+\.\d+\.\d+/.test(result)) return result;
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
+function compareSemver(a, b) {
+  const parse = (v) => v.replace(/^v/i, "").split("-")[0].split(".").map((n) => parseInt(n, 10) || 0);
+  const [a1 = 0, a2 = 0, a3 = 0] = parse(a);
+  const [b1 = 0, b2 = 0, b3 = 0] = parse(b);
+  if (a1 !== b1) return a1 - b1;
+  if (a2 !== b2) return a2 - b2;
+  return a3 - b3;
+}
 async function doctor() {
   console.log(chalk10.bold(`
 ${ko.doctor.title}
@@ -2761,6 +2849,14 @@ ${ko.doctor.title}
   } else {
     console.log(chalk10.green("  \u2705 VHK") + chalk10.dim(" \u2014 \uC124\uCE58\uB428"));
   }
+  if (vhkVersion) {
+    const latest = fetchLatestNpmVersion("@byh3071/vhk");
+    if (latest && compareSemver(latest, vhkVersion) > 0) {
+      console.log(chalk10.yellow(`  ${ko.doctor.updateAvailable(latest)}`));
+    } else if (latest) {
+      console.log(chalk10.dim(`     ${ko.doctor.updateCurrent}`));
+    }
+  }
   console.log("");
   console.log(chalk10.bold(`  ${ko.doctor.projectFiles}`));
   const cwd = process.cwd();
@@ -2823,6 +2919,29 @@ var CHECKLIST = [
 function sanitizeVersion(version) {
   return version.trim().replace(/^v/i, "").replace(/[^a-zA-Z0-9._-]/g, "-") || "0.0.0";
 }
+function updateChangelogUnreleased(cwd, version, date) {
+  const changelogPath = path13.join(cwd, "CHANGELOG.md");
+  if (!fs13.existsSync(changelogPath)) return { status: "missing" };
+  const content = fs13.readFileSync(changelogPath, "utf-8");
+  const unreleasedHeading = /^## \[Unreleased\][^\n]*$/m;
+  if (!unreleasedHeading.test(content)) return { status: "no-unreleased" };
+  const blankUnreleased = [
+    "## [Unreleased]",
+    "",
+    "### Added",
+    "- ",
+    "",
+    "### Fixed",
+    "- ",
+    "",
+    "---",
+    "",
+    `## [${version}] \u2014 ${date}`
+  ].join("\n");
+  const updated = content.replace(unreleasedHeading, blankUnreleased);
+  fs13.writeFileSync(changelogPath, updated, "utf-8");
+  return { status: "updated", version };
+}
 async function ship() {
   console.log(chalk11.bold(`
 ${ko.ship.title}
@@ -2914,6 +3033,14 @@ ${ko.ship.title}
   fs13.writeFileSync(filePath, content, "utf-8");
   console.log(chalk11.green(`
   ${ko.ship.buildLogDone(path13.relative(cwd, filePath))}`));
+  const changelogResult = updateChangelogUnreleased(cwd, versionSlug, today);
+  if (changelogResult.status === "updated") {
+    log.success(ko.ship.changelogUpdated(changelogResult.version));
+  } else if (changelogResult.status === "no-unreleased") {
+    log.warn(ko.ship.changelogNoUnreleased);
+  } else {
+    log.info(ko.ship.changelogMissing);
+  }
   printNextStep({
     message: ko.ship.deployMessage,
     command: "npm publish --access=public",
@@ -3203,104 +3330,23 @@ ${t("undo.recentHeader")}`));
   }
 }
 
-// src/commands/diff.ts
-import { execFileSync as execFileSync4, execSync as execSync2 } from "child_process";
+// src/commands/status.ts
+import { execFileSync as execFileSync4 } from "child_process";
+import fs15 from "fs";
+import path14 from "path";
 import chalk14 from "chalk";
-function gitOut2(args) {
-  try {
-    return execFileSync4("git", args, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
-  } catch {
-    return "";
-  }
-}
-function parseDiffStat(stat) {
-  const files = [];
-  const lines = stat.split("\n");
-  for (const line of lines) {
-    const match = line.match(/^\s*(.+?)\s*\|\s*(\d+)/);
-    if (!match) continue;
-    const name = match[1].trim();
-    if (name.includes("changed") || name.includes("file")) continue;
-    const plusMatch = line.match(/(\++)/);
-    const minusMatch = line.match(/(\-+)/);
-    files.push({
-      name,
-      additions: plusMatch ? plusMatch[1].length : 0,
-      deletions: minusMatch ? minusMatch[1].length : 0
-    });
-  }
-  return files;
-}
-function summarizeNumstat(numstat) {
-  let totalAdd = 0;
-  let totalDel = 0;
-  let fileCount = 0;
-  for (const line of numstat.split("\n").filter(Boolean)) {
-    const [add, del] = line.split("	");
-    if (add === void 0 || del === void 0) continue;
-    totalAdd += parseInt(add, 10) || 0;
-    totalDel += parseInt(del, 10) || 0;
-    fileCount++;
-  }
-  return { fileCount, totalAdd, totalDel };
-}
-function printFile(f) {
-  const adds = f.additions > 0 ? chalk14.green(`+${f.additions}`) : "";
-  const dels = f.deletions > 0 ? chalk14.red(`-${f.deletions}`) : "";
-  const change = [adds, dels].filter(Boolean).join(" ");
-  console.log(`   ${f.name} ${change}`);
+
+// src/lib/read-json.ts
+import fs14 from "fs";
+function stripBom(text) {
+  return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
 }
-async function diff() {
-  console.log(chalk14.bold(`
-\u{1F50D} ${t("diff.title")}`));
-  console.log(chalk14.gray("\u2500".repeat(40)));
-  try {
-    execSync2("git rev-parse --is-inside-work-tree", { stdio: "pipe" });
-  } catch {
-    console.log(chalk14.red(`\u274C ${t("diff.notGitRepo")}`));
-    return;
-  }
-  const unstaged = gitOut2(["diff", "--stat"]);
-  const staged = gitOut2(["diff", "--cached", "--stat"]);
-  const untracked = gitOut2(["ls-files", "--others", "--exclude-standard"]);
-  if (!unstaged && !staged && !untracked) {
-    console.log(chalk14.green(`
-\u2705 ${t("diff.noChanges")}`));
-    return;
-  }
-  if (staged) {
-    console.log(chalk14.cyan(`
-${t("diff.stagedHeader")}`));
-    parseDiffStat(staged).forEach((f) => printFile(f));
-  }
-  if (unstaged) {
-    console.log(chalk14.cyan(`
-${t("diff.unstagedHeader")}`));
-    parseDiffStat(unstaged).forEach((f) => printFile(f));
-  }
-  if (untracked) {
-    const files = untracked.split("\n").filter(Boolean);
-    console.log(chalk14.cyan(`
-${t("diff.untrackedHeader", files.length)}`));
-    files.forEach((f) => console.log(`   ${chalk14.green("+")} ${f}`));
-  }
-  const numstat = gitOut2(["diff", "--numstat", "HEAD"]);
-  if (numstat) {
-    const { fileCount, totalAdd, totalDel } = summarizeNumstat(numstat);
-    console.log(chalk14.cyan(`
-${t("diff.summaryHeader")}`));
-    console.log(`   ${t("diff.filesLine", fileCount)}`);
-    console.log(`   \uCD94\uAC00: ${chalk14.green(`+${totalAdd}`)}\uC904`);
-    console.log(`   \uC0AD\uC81C: ${chalk14.red(`-${totalDel}`)}\uC904`);
-  }
-  console.log("");
+function readJsonFile(filePath) {
+  const raw = stripBom(fs14.readFileSync(filePath, "utf-8"));
+  return JSON.parse(raw);
 }
 
 // src/commands/status.ts
-import { execFileSync as execFileSync5 } from "child_process";
-import fs14 from "fs";
-import path14 from "path";
-import chalk15 from "chalk";
 function countFileChanges(porcelain) {
   const lines = porcelain.split("\n").filter(Boolean);
   let staged = 0;
@@ -3339,9 +3385,9 @@ function parseRecentCommitLines(logOutput) {
 }
 function readProjectPackage(cwd = process.cwd()) {
   const pkgPath = path14.join(cwd, "package.json");
-  if (!fs14.existsSync(pkgPath)) return null;
+  if (!fs15.existsSync(pkgPath)) return null;
   try {
-    const pkg = JSON.parse(fs14.readFileSync(pkgPath, "utf-8"));
+    const pkg = readJsonFile(pkgPath);
     if (!pkg.name && !pkg.version) return null;
     return {
       name: pkg.name ?? "(no name)",
@@ -3360,15 +3406,15 @@ function getSyncCounts(gitRoot) {
   }
 }
 async function status() {
-  console.log(chalk15.bold(`
+  console.log(chalk14.bold(`
 \u{1F4CA} ${t("status.title")}`));
-  console.log(chalk15.gray("\u2500".repeat(40)));
+  console.log(chalk14.gray("\u2500".repeat(40)));
   let gitRoot;
   try {
-    execFileSync5("git", ["rev-parse", "--is-inside-work-tree"], { stdio: "pipe" });
+    execFileSync4("git", ["rev-parse", "--is-inside-work-tree"], { stdio: "pipe" });
     gitRoot = getGitRoot();
   } catch {
-    console.log(chalk15.red(`\u274C ${t("status.notGitRepo")}`));
+    console.log(chalk14.red(`\u274C ${t("status.notGitRepo")}`));
     return;
   }
   let branch;
@@ -3387,31 +3433,183 @@ async function status() {
     commits = [];
   }
   const pkg = readProjectPackage();
-  console.log(chalk15.cyan(`
-\u{1F33F} ${t("status.branch")}`) + chalk15.white(` ${branch}`));
+  console.log(chalk14.cyan(`
+\u{1F33F} ${t("status.branch")}`) + chalk14.white(` ${branch}`));
   console.log(
-    chalk15.cyan(`\u{1F4C1} ${t("status.changes")}`) + chalk15.white(
+    chalk14.cyan(`\u{1F4C1} ${t("status.changes")}`) + chalk14.white(
       ` staged ${counts.staged} \xB7 unstaged ${counts.unstaged} \xB7 untracked ${counts.untracked}`
     )
   );
-  console.log(chalk15.cyan(`
+  console.log(chalk14.cyan(`
 \u{1F4CB} ${t("status.recentCommits")}`));
   if (commits.length === 0) {
-    console.log(chalk15.dim(`   ${t("status.noCommits")}`));
+    console.log(chalk14.dim(`   ${t("status.noCommits")}`));
   } else {
-    commits.forEach((c) => console.log(`   ${chalk15.dim("\u2022")} ${c}`));
+    commits.forEach((c) => console.log(`   ${chalk14.dim("\u2022")} ${c}`));
   }
   console.log(
-    chalk15.cyan(`
-\u{1F504} ${t("status.remote")}`) + chalk15.white(` ${formatSyncLabel(sync2)}`)
+    chalk14.cyan(`
+\u{1F504} ${t("status.remote")}`) + chalk14.white(` ${formatSyncLabel(sync2)}`)
   );
-  console.log(chalk15.gray("\n" + "\u2500".repeat(40)));
+  console.log(chalk14.gray("\n" + "\u2500".repeat(40)));
   if (pkg) {
-    console.log(chalk15.cyan(`\u{1F4E6} ${t("status.package")}`) + chalk15.white(` ${pkg.name} v${pkg.version}`));
+    console.log(chalk14.cyan(`\u{1F4E6} ${t("status.package")}`) + chalk14.white(` ${pkg.name} v${pkg.version}`));
   } else {
-    console.log(chalk15.dim(`\u{1F4E6} ${t("status.noPackage")}`));
+    console.log(chalk14.dim(`\u{1F4E6} ${t("status.noPackage")}`));
+  }
+  console.log("");
+}
+
+// src/commands/diff.ts
+import { execFileSync as execFileSync5, execSync as execSync2 } from "child_process";
+import chalk15 from "chalk";
+function gitOut2(args) {
+  try {
+    return execFileSync5("git", args, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    return "";
+  }
+}
+function parseDiffStat(stat) {
+  const files = [];
+  const lines = stat.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^\s*(.+?)\s*\|\s*(\d+)/);
+    if (!match) continue;
+    const name = match[1].trim();
+    if (name.includes("changed") || name.includes("file")) continue;
+    const plusMatch = line.match(/(\++)/);
+    const minusMatch = line.match(/(\-+)/);
+    files.push({
+      name,
+      additions: plusMatch ? plusMatch[1].length : 0,
+      deletions: minusMatch ? minusMatch[1].length : 0
+    });
+  }
+  return files;
+}
+function summarizeNumstat(numstat) {
+  let totalAdd = 0;
+  let totalDel = 0;
+  let fileCount = 0;
+  for (const line of numstat.split("\n").filter(Boolean)) {
+    const [add, del] = line.split("	");
+    if (add === void 0 || del === void 0) continue;
+    totalAdd += parseInt(add, 10) || 0;
+    totalDel += parseInt(del, 10) || 0;
+    fileCount++;
+  }
+  return { fileCount, totalAdd, totalDel };
+}
+function printFile(f) {
+  const adds = f.additions > 0 ? chalk15.green(`+${f.additions}`) : "";
+  const dels = f.deletions > 0 ? chalk15.red(`-${f.deletions}`) : "";
+  const change = [adds, dels].filter(Boolean).join(" ");
+  console.log(`   ${f.name} ${change}`);
+}
+async function diff() {
+  console.log(chalk15.bold(`
+\u{1F50D} ${t("diff.title")}`));
+  console.log(chalk15.gray("\u2500".repeat(40)));
+  try {
+    execSync2("git rev-parse --is-inside-work-tree", { stdio: "pipe" });
+  } catch {
+    console.log(chalk15.red(`\u274C ${t("diff.notGitRepo")}`));
+    return;
+  }
+  const unstaged = gitOut2(["diff", "--stat"]);
+  const staged = gitOut2(["diff", "--cached", "--stat"]);
+  const untracked = gitOut2(["ls-files", "--others", "--exclude-standard"]);
+  if (!unstaged && !staged && !untracked) {
+    console.log(chalk15.green(`
+\u2705 ${t("diff.noChanges")}`));
+    return;
+  }
+  if (staged) {
+    console.log(chalk15.cyan(`
+${t("diff.stagedHeader")}`));
+    parseDiffStat(staged).forEach((f) => printFile(f));
+  }
+  if (unstaged) {
+    console.log(chalk15.cyan(`
+${t("diff.unstagedHeader")}`));
+    parseDiffStat(unstaged).forEach((f) => printFile(f));
+  }
+  if (untracked) {
+    const files = untracked.split("\n").filter(Boolean);
+    console.log(chalk15.cyan(`
+${t("diff.untrackedHeader", files.length)}`));
+    files.forEach((f) => console.log(`   ${chalk15.green("+")} ${f}`));
+  }
+  const numstat = gitOut2(["diff", "--numstat", "HEAD"]);
+  if (numstat) {
+    const { fileCount, totalAdd, totalDel } = summarizeNumstat(numstat);
+    console.log(chalk15.cyan(`
+${t("diff.summaryHeader")}`));
+    console.log(`   ${t("diff.filesLine", fileCount)}`);
+    console.log(`   \uCD94\uAC00: ${chalk15.green(`+${totalAdd}`)}\uC904`);
+    console.log(`   \uC0AD\uC81C: ${chalk15.red(`-${totalDel}`)}\uC904`);
+  }
+  console.log("");
+}
+
+// src/lib/nlp-run.ts
+async function dispatchNlpRoute(route, input) {
+  switch (route.command) {
+    case "gate":
+      return gate();
+    case "init":
+      return init({
+        skipGate: route.args?.includes("--skip-gate"),
+        fromNotion: route.args?.includes("--from-notion") ? extractNotionUrl(input) : void 0
+      });
+    case "recap":
+      return recap({});
+    case "sync":
+      return sync();
+    case "check":
+      return check();
+    case "secure":
+      return secure();
+    case "ship":
+      return ship();
+    case "doctor":
+      return doctor();
+    case "save":
+      return save();
+    case "undo":
+      return undo();
+    case "status":
+      return status();
+    case "diff":
+      return diff();
+  }
+}
+async function runNaturalLanguageRoute(input) {
+  const route = routeNaturalLanguage(input);
+  if (!route) {
+    console.log(chalk16.yellow(`
+  \u2753 "${input}" \u2014 ${ko.nlp.notMatched}
+`));
+    return;
   }
   console.log("");
+  console.log(chalk16.cyan(`  \u{1F4AC} "${input}"`));
+  console.log(chalk16.cyan(`  \u2192 ${route.explanation}`));
+  if (route.confidence === "low") {
+    const { confirm } = await inquirer7.prompt([{
+      type: "confirm",
+      name: "confirm",
+      message: `${route.explanation} \u2014 ${ko.nlp.matched}`,
+      default: true
+    }]);
+    if (!confirm) {
+      console.log(chalk16.dim(`  ${ko.nlp.menuHint}`));
+      return;
+    }
+  }
+  console.log("");
+  await dispatchNlpRoute(route, input);
 }
 
 // src/index.ts
@@ -3431,7 +3629,7 @@ var KO_ALIASES = {
   status: "\uC0C1\uD0DC",
   diff: "\uBCC0\uACBD"
 };
-program.name("vhk").description("VHK \u2014 \uBC14\uC774\uBE0C\uCF54\uB529 \uD504\uB85C\uC81D\uD2B8 \uCF54\uCE58 (\uD55C\uAD6D\uC5B4\uB85C \uC548\uB0B4\uD569\uB2C8\uB2E4)").version("0.5.1");
+program.name("vhk").description("VHK \u2014 \uBC14\uC774\uBE0C\uCF54\uB529 \uD504\uB85C\uC81D\uD2B8 \uCF54\uCE58 (\uD55C\uAD6D\uC5B4\uB85C \uC548\uB0B4\uD569\uB2C8\uB2E4)").version("0.5.3");
 program.configureHelp({
   formatHelp(cmd, helper) {
     if (cmd.parent) {
@@ -3472,62 +3670,14 @@ program.command("status").alias("\uC0C1\uD0DC").description("\uD504\uB85C\uC81D\
 });
 program.command("diff").alias("\uBCC0\uACBD").alias("\uCC28\uC774").description("Git \uBCC0\uACBD\uC0AC\uD56D \uD55C\uAD6D\uC5B4 \uC694\uC57D (staged / unstaged / \uC0C8 \uD30C\uC77C)").action(diff);
 program.on("command:*", async (operands) => {
-  const input = operands.join(" ");
-  const route = routeNaturalLanguage(input);
-  if (route) {
-    console.log("");
-    console.log(chalk16.cyan(`  \u{1F4AC} "${input}"`));
-    console.log(chalk16.cyan(`  \u2192 ${route.explanation}`));
-    if (route.confidence === "low") {
-      const { confirm } = await inquirer7.prompt([{
-        type: "confirm",
-        name: "confirm",
-        message: `${route.explanation} \u2014 ${ko.nlp.matched}`,
-        default: true
-      }]);
-      if (!confirm) {
-        console.log(chalk16.dim(`  ${ko.nlp.menuHint}`));
-        return;
-      }
-    }
-    console.log("");
-    switch (route.command) {
-      case "gate":
-        return gate();
-      case "init":
-        return init({
-          skipGate: route.args?.includes("--skip-gate"),
-          fromNotion: route.args?.includes("--from-notion") ? extractNotionUrl(input) : void 0
-        });
-      case "recap":
-        return recap({});
-      case "sync":
-        return sync();
-      case "check":
-        return check();
-      case "secure":
-        return secure();
-      case "ship":
-        return ship();
-      case "doctor":
-        return doctor();
-      case "save":
-        return save();
-      case "undo":
-        return undo();
-      case "status":
-        return status();
-      case "diff":
-        return diff();
-    }
-  }
-  console.log(chalk16.yellow(`
-  \u2753 "${input}" \u2014 ${ko.nlp.notMatched}
-`));
+  const unknown = operands[0] ?? "";
+  const rest = operands.slice(1);
+  const input = [unknown, ...rest].join(" ").trim();
+  await runNaturalLanguageRoute(input);
 });
 program.action(async () => {
   console.log("\n\u{1F3AF} VHK \u2014 \uBC14\uC774\uBE0C\uCF54\uB529 \uD504\uB85C\uC81D\uD2B8 \uCF54\uCE58\n");
-  const { choice } = await inquirer7.prompt([{
+  const { choice } = await inquirer8.prompt([{
     type: "list",
     name: "choice",
     message: "\uBB58 \uB3C4\uC640\uB4DC\uB9B4\uAE4C\uC694?",
@@ -3573,4 +3723,9 @@ program.action(async () => {
       return diff();
   }
 });
-await program.parseAsync(process.argv);
+var nlInput = detectNaturalLanguageInput(process.argv);
+if (nlInput !== null) {
+  await runNaturalLanguageRoute(nlInput);
+} else {
+  await program.parseAsync(process.argv);
+}

package/package.json

@@ -1,56 +1,62 @@
-{
-  "name": "@byh3071/vhk",
-  "version": "0.5.1",
-  "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
-  "bin": {
-    "vhk": "./dist/index.js"
-  },
-  "type": "module",
-  "scripts": {
-    "dev": "tsx src/index.ts",
-    "build": "tsup",
-    "test": "vitest",
-    "test:run": "vitest --run",
-    "prepublishOnly": "pnpm build && pnpm test:run"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "keywords": [
-    "vibe-coding",
-    "harness",
-    "cli",
-    "scaffold",
-    "session-log",
-    "rules-sync"
-  ],
-  "author": "byh3071 <byh3071@gmail.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/byh3071-cpu/vhk.git"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "@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"
-  },
-  "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": "0.5.3",
+  "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
+  "bin": {
+    "vhk": "dist/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"
+  ],
+  "author": "byh3071 <byh3071@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/byh3071-cpu/vhk.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@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"
+  },
+  "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"
+  }
+}