@byh3071/vhk 0.5.1 → 0.5.2

package/README.md

@@ -1,12 +1,12 @@
 ---
 id: vhk-readme
 date: 2026-05-23
-tags: [vhk, cli, readme, v0.5.1]
+tags: [vhk, cli, readme, v0.5.2]
 ---
 
 # 🔧 VHK — Vibe Harness Kit
 
-> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.5.1)
+> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.5.2)
 
 명령어를 외우지 않아도 됩니다. `vhk`만 치면 메뉴가 나오고, 한국어로 말해도 알아듣습니다.
 

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;
+  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.slice(1).every(isOptionToken)) 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: {
@@ -3203,104 +3265,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 +3320,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 +3341,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,33 +3368,185 @@ 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
 var program = new Command();
 var defaultHelp = new Help();
@@ -3431,7 +3564,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.2");
 program.configureHelp({
   formatHelp(cmd, helper) {
     if (cmd.parent) {
@@ -3472,62 +3605,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 +3658,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,6 +1,6 @@
 {
   "name": "@byh3071/vhk",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
   "bin": {
     "vhk": "./dist/index.js"