@byh3071/vhk 2.4.0 → 2.4.1

package/dist/{chunk-MN6LSPN6.js → chunk-Y7SJVHGS.js}

@@ -1692,8 +1692,42 @@ ${ko.sync.done}`));
   });
 }
 
-// src/commands/deploy.ts
+// src/lib/version.ts
 import { existsSync as existsSync2 } from "fs";
+import { dirname, join as join2 } from "path";
+import { fileURLToPath } from "url";
+
+// src/lib/read-json.ts
+import { readFileSync as readFileSync2 } from "fs";
+function stripBom(text) {
+  return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
+}
+function readJsonFile(filePath) {
+  const raw = stripBom(readFileSync2(filePath, "utf-8"));
+  return JSON.parse(raw);
+}
+
+// src/lib/version.ts
+function getVhkVersion() {
+  const dir = dirname(fileURLToPath(import.meta.url));
+  for (const pkgPath of [
+    join2(dir, "../../package.json"),
+    join2(dir, "../package.json")
+  ]) {
+    try {
+      if (existsSync2(pkgPath)) {
+        const pkg = readJsonFile(pkgPath);
+        if (pkg.version) return pkg.version;
+      }
+    } catch {
+      continue;
+    }
+  }
+  return "0.0.0";
+}
+
+// src/commands/deploy.ts
+import { existsSync as existsSync3 } from "fs";
 import chalk4 from "chalk";
 import inquirer2 from "inquirer";
 
@@ -1794,7 +1828,7 @@ var PLATFORMS = {
 function detectPlatform() {
   for (const [key, config] of Object.entries(PLATFORMS)) {
     for (const file of config.detectFiles) {
-      if (existsSync2(file)) return key;
+      if (existsSync3(file)) return key;
     }
   }
   return null;
@@ -1863,8 +1897,8 @@ ${t("deploy.deploying")}
 }
 
 // src/commands/env.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync, appendFileSync, readdirSync } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync4, readFileSync as readFileSync3, writeFileSync, appendFileSync, readdirSync } from "fs";
+import { join as join3 } from "path";
 import chalk5 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);
@@ -1881,7 +1915,7 @@ function loadDefinedEnvKeys(dir = ".") {
     if (!name.startsWith(".env")) continue;
     if (name.endsWith(".example") || name.endsWith(".sample")) continue;
     try {
-      for (const k of parseEnvKeys(readFileSync2(join2(dir, name), "utf-8"))) keys.add(k);
+      for (const k of parseEnvKeys(readFileSync3(join3(dir, name), "utf-8"))) keys.add(k);
     } catch {
     }
   }
@@ -1889,8 +1923,8 @@ function loadDefinedEnvKeys(dir = ".") {
 }
 function ensureGitignore() {
   const gitignorePath = ".gitignore";
-  if (existsSync3(gitignorePath)) {
-    const content = readFileSync2(gitignorePath, "utf-8");
+  if (existsSync4(gitignorePath)) {
+    const content = readFileSync3(gitignorePath, "utf-8");
     if (!content.split("\n").some((l) => l.trim() === ".env")) {
       appendFileSync(gitignorePath, "\n.env\n");
       console.log(chalk5.green("\n\u{1F512} .gitignore\uC5D0 .env \uCD94\uAC00\uB428"));
@@ -1903,12 +1937,12 @@ function ensureGitignore() {
 async function env() {
   console.log(chalk5.bold("\n\u{1F510} " + t("env.title")));
   console.log(chalk5.gray("\u2500".repeat(40)));
-  if (!existsSync3(".env")) {
+  if (!existsSync4(".env")) {
     console.log(chalk5.yellow("\n\u26A0\uFE0F  .env \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
     console.log(chalk5.gray("   .env \uD30C\uC77C\uC744 \uBA3C\uC800 \uB9CC\uB4E4\uC5B4\uC8FC\uC138\uC694."));
     return;
   }
-  const envContent = readFileSync2(".env", "utf-8");
+  const envContent = readFileSync3(".env", "utf-8");
   const keys = parseEnvKeys(envContent);
   if (keys.length === 0) {
     console.log(chalk5.yellow("\n\u{1F4ED} .env\uC5D0 \uD658\uACBD\uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
@@ -1929,11 +1963,11 @@ async function env() {
 async function envCheck() {
   console.log(chalk5.bold("\n\u{1F50D} " + t("env.checkTitle")));
   console.log(chalk5.gray("\u2500".repeat(40)));
-  if (!existsSync3(".env.example")) {
+  if (!existsSync4(".env.example")) {
     console.log(chalk5.yellow("\n\u26A0\uFE0F  .env.example\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 vhk env\uB97C \uC2E4\uD589\uD558\uC138\uC694."));
     return;
   }
-  const requiredKeys = parseEnvKeys(readFileSync2(".env.example", "utf-8"));
+  const requiredKeys = parseEnvKeys(readFileSync3(".env.example", "utf-8"));
   const currentKeys = loadDefinedEnvKeys();
   const missing = requiredKeys.filter((k) => !currentKeys.includes(k));
   const extra = currentKeys.filter((k) => !requiredKeys.includes(k));
@@ -1956,22 +1990,10 @@ async function envCheck() {
 }
 
 // src/commands/publish.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
 import chalk6 from "chalk";
 import inquirer3 from "inquirer";
 import ora from "ora";
-
-// src/lib/read-json.ts
-import { readFileSync as readFileSync3 } from "fs";
-function stripBom(text) {
-  return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-}
-function readJsonFile(filePath) {
-  const raw = stripBom(readFileSync3(filePath, "utf-8"));
-  return JSON.parse(raw);
-}
-
-// src/commands/publish.ts
 function bumpVersion(current, type) {
   const [major, minor, patch] = current.split(".").map((n) => parseInt(n, 10) || 0);
   switch (type) {
@@ -2001,7 +2023,9 @@ function bumpClaudeMdVersion(content, newVersion) {
   return content.replace(/(\*\*버전:\*\*\s*v)\d+\.\d+\.\d+/, `$1${newVersion}`);
 }
 function gitPostRelease(newVersion) {
-  const filesToAdd = existsSync4("CHANGELOG.md") ? ["package.json", "CHANGELOG.md"] : ["package.json"];
+  const filesToAdd = ["package.json"];
+  if (existsSync5("CHANGELOG.md")) filesToAdd.push("CHANGELOG.md");
+  if (existsSync5("CLAUDE.md")) filesToAdd.push("CLAUDE.md");
   const add = safeExecFile("git", ["add", ...filesToAdd]);
   if (!add.ok) {
     return {
@@ -2067,7 +2091,7 @@ async function publish() {
 \u274C ${msg}`));
     return;
   }
-  if (!existsSync4("package.json")) {
+  if (!existsSync5("package.json")) {
     console.log(chalk6.red("\u274C package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
     return;
   }
@@ -2099,7 +2123,7 @@ 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;
+  const claudeMdOriginal = existsSync5("CLAUDE.md") ? readFileSync4("CLAUDE.md", "utf-8") : null;
   if (claudeMdOriginal !== null) {
     const bumped = bumpClaudeMdVersion(claudeMdOriginal, newVersion);
     if (bumped !== claudeMdOriginal) {
@@ -2157,7 +2181,7 @@ async function publish() {
   }
   console.log(chalk6.green(`
 \u2714 ${t("publish.publishSuccess")}`));
-  if (existsSync4("CHANGELOG.md")) {
+  if (existsSync5("CHANGELOG.md")) {
     const cl = readFileSync4("CHANGELOG.md", "utf-8");
     const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
     const updated = insertChangelogStub(cl, newVersion, date);
@@ -2188,13 +2212,13 @@ async function publish() {
 }
 
 // src/commands/audit.ts
-import { existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 import chalk7 from "chalk";
 import inquirer4 from "inquirer";
 import ora2 from "ora";
 function detectCurrentPM() {
-  if (existsSync5("pnpm-lock.yaml")) return "pnpm";
-  if (existsSync5("yarn.lock")) return "yarn";
+  if (existsSync6("pnpm-lock.yaml")) return "pnpm";
+  if (existsSync6("yarn.lock")) return "yarn";
   return "npm";
 }
 function parseAuditOutput(output, pm) {
@@ -2277,28 +2301,6 @@ async function audit(autoFix = false) {
   });
 }
 
-// src/lib/version.ts
-import { existsSync as existsSync6 } from "fs";
-import { dirname, join as join3 } from "path";
-import { fileURLToPath } from "url";
-function getVhkVersion() {
-  const dir = dirname(fileURLToPath(import.meta.url));
-  for (const pkgPath of [
-    join3(dir, "../../package.json"),
-    join3(dir, "../package.json")
-  ]) {
-    try {
-      if (existsSync6(pkgPath)) {
-        const pkg = readJsonFile(pkgPath);
-        if (pkg.version) return pkg.version;
-      }
-    } catch {
-      continue;
-    }
-  }
-  return "0.0.0";
-}
-
 // src/mcp/cli-path.ts
 import { existsSync as existsSync7 } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -3251,12 +3253,12 @@ export {
   MAX_SECRET_FINDINGS,
   scanProjectForSecrets,
   filterSevereFindings,
+  getVhkVersion,
   deploy,
   env,
   envCheck,
   publish,
   audit,
-  getVhkVersion,
   resolveVhkCliInvocation,
   startMcpServer
 };

package/dist/index.js

@@ -43,12 +43,12 @@ import {
   stripBom,
   sync,
   t
-} from "./chunk-MN6LSPN6.js";
+} from "./chunk-Y7SJVHGS.js";
 
 // src/index.ts
 import { Command, Help } from "commander";
 import { fileURLToPath as fileURLToPath4 } from "url";
-import fs13 from "fs";
+import fs14 from "fs";
 import chalk38 from "chalk";
 import inquirer15 from "inquirer";
 
@@ -2978,9 +2978,92 @@ ${ko.secure.title}
 
 // src/commands/doctor.ts
 import chalk9 from "chalk";
+import fs9 from "fs";
+import path10 from "path";
+import { fileURLToPath } from "url";
+
+// src/lib/version-check.ts
 import fs8 from "fs";
+import os from "os";
 import path9 from "path";
-import { fileURLToPath } from "url";
+var PACKAGE_NAME = "@byh3071/vhk";
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var COOLDOWN_MS = 60 * 60 * 1e3;
+var MENU_FETCH_TIMEOUT_MS = 1500;
+function fetchLatestNpmVersion(packageName, timeoutMs = NETWORK_EXEC_TIMEOUT_MS) {
+  const result = safeExecFile("npm", ["view", packageName, "version"], { timeoutMs });
+  if (!result.ok) return void 0;
+  const out = result.out;
+  if (/^\d+\.\d+\.\d+/.test(out)) return out;
+  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;
+}
+function getCacheDir() {
+  return path9.join(os.homedir(), ".vhk");
+}
+function getCachePath() {
+  return path9.join(getCacheDir(), "version-check.json");
+}
+function readCache() {
+  try {
+    const p = getCachePath();
+    if (!fs8.existsSync(p)) return null;
+    const data = readJsonFile(p);
+    if (!data || typeof data.checkedAt !== "number" || data.latest !== void 0 && typeof data.latest !== "string") {
+      return null;
+    }
+    return { latest: data.latest, checkedAt: data.checkedAt, lastTriedAt: data.lastTriedAt };
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    fs8.mkdirSync(getCacheDir(), { recursive: true });
+    fs8.writeFileSync(getCachePath(), JSON.stringify(cache, null, 2), "utf-8");
+  } catch {
+  }
+}
+function isStale(cache, now = Date.now()) {
+  return now - cache.checkedAt > CACHE_TTL_MS;
+}
+function recordLatest(latest, now = Date.now()) {
+  writeCache({ latest, checkedAt: now, lastTriedAt: now });
+}
+function getUpdateInfo(now = Date.now()) {
+  const current = getVhkVersion();
+  const cache = readCache();
+  let latest;
+  if (cache && !isStale(cache, now)) {
+    latest = cache.latest;
+  } else {
+    const lastTried = cache?.lastTriedAt ?? 0;
+    const cooledDown = now - lastTried > COOLDOWN_MS;
+    if (cooledDown) {
+      const fetched = fetchLatestNpmVersion(PACKAGE_NAME, MENU_FETCH_TIMEOUT_MS);
+      if (fetched) {
+        writeCache({ latest: fetched, checkedAt: now, lastTriedAt: now });
+        latest = fetched;
+      } else {
+        writeCache({ latest: cache?.latest, checkedAt: cache?.checkedAt ?? 0, lastTriedAt: now });
+        latest = cache?.latest;
+      }
+    } else {
+      latest = cache?.latest;
+    }
+  }
+  const updateAvailable = latest ? compareSemver(latest, current) > 0 : false;
+  return { current, latest, updateAvailable };
+}
+
+// src/commands/doctor.ts
 function checkCommand(name, command, hint) {
   const result = safeExecFile(command, ["--version"]);
   if (!result.ok) return { name, command, ok: false, hint };
@@ -2988,14 +3071,14 @@ function checkCommand(name, command, hint) {
   return { name, command, version, ok: true, hint };
 }
 function getVhkVersion2() {
-  const dir = path9.dirname(fileURLToPath(import.meta.url));
+  const dir = path10.dirname(fileURLToPath(import.meta.url));
   const candidates = [
-    path9.join(dir, "../package.json"),
-    path9.join(dir, "../../package.json")
+    path10.join(dir, "../package.json"),
+    path10.join(dir, "../../package.json")
   ];
   for (const pkgPath of candidates) {
     try {
-      if (fs8.existsSync(pkgPath)) {
+      if (fs9.existsSync(pkgPath)) {
         const pkg = readJsonFile(pkgPath);
         return pkg.version;
       }
@@ -3005,23 +3088,6 @@ function getVhkVersion2() {
   }
   return void 0;
 }
-function fetchLatestNpmVersion(packageName) {
-  const result = safeExecFile("npm", ["view", packageName, "version"], {
-    timeoutMs: NETWORK_EXEC_TIMEOUT_MS
-  });
-  if (!result.ok) return void 0;
-  const out = result.out;
-  if (/^\d+\.\d+\.\d+/.test(out)) return out;
-  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(opts = {}) {
   console.log(chalk9.bold(`
 ${ko.doctor.title}
@@ -3051,6 +3117,7 @@ ${ko.doctor.title}
   }
   if (vhkVersion) {
     const latest = fetchLatestNpmVersion("@byh3071/vhk");
+    if (latest) recordLatest(latest);
     if (latest && compareSemver(latest, vhkVersion) > 0) {
       console.log(chalk9.yellow(`  ${ko.doctor.updateAvailable(latest)}`));
     } else if (latest) {
@@ -3068,19 +3135,19 @@ ${ko.doctor.title}
     { name: ".env", hint: ".gitignore\uC5D0 \uD3EC\uD568\uB418\uC5B4 \uC788\uB294\uC9C0 \uD655\uC778" }
   ];
   for (const file of projectFiles) {
-    const exists = fs8.existsSync(path9.join(cwd, file.name));
+    const exists = fs9.existsSync(path10.join(cwd, file.name));
     if (exists) {
       console.log(chalk9.green(`    \u2705 ${file.name}`));
       if (file.name === ".env") {
-        const gitignorePath = path9.join(cwd, ".gitignore");
-        if (fs8.existsSync(gitignorePath)) {
-          const gitignore = fs8.readFileSync(gitignorePath, "utf-8");
+        const gitignorePath = path10.join(cwd, ".gitignore");
+        if (fs9.existsSync(gitignorePath)) {
+          const gitignore = fs9.readFileSync(gitignorePath, "utf-8");
           if (!gitignore.includes(".env")) {
             console.log(chalk9.yellow(`    ${ko.doctor.envNotIgnored}`));
           }
         }
       }
-    } else if (file.name === ".env" && fs8.existsSync(path9.join(cwd, ".env.local"))) {
+    } else if (file.name === ".env" && fs9.existsSync(path10.join(cwd, ".env.local"))) {
       console.log(chalk9.green("    \u2705 .env.local") + chalk9.dim(" \u2014 \uB85C\uCEF4 env \uC0AC\uC6A9 \uC911 (.env \uC5C6\uC5B4\uB3C4 \uC815\uC0C1)"));
     } else {
       console.log(chalk9.dim(`    \u26AB ${file.name}`) + chalk9.dim(` \u2014 ${file.hint}`));
@@ -3132,8 +3199,8 @@ ${ko.doctor.title}
 // src/commands/ship.ts
 import chalk10 from "chalk";
 import inquirer4 from "inquirer";
-import fs9 from "fs";
-import path10 from "path";
+import fs10 from "fs";
+import path11 from "path";
 var CHECKLIST = [
   { id: "build", questionKey: "checkBuild", hintKey: "hintBuild" },
   { id: "test", questionKey: "checkTest", hintKey: "hintTest" },
@@ -3146,9 +3213,9 @@ 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 = path10.join(cwd, "CHANGELOG.md");
-  if (!fs9.existsSync(changelogPath)) return { status: "missing" };
-  const content = fs9.readFileSync(changelogPath, "utf-8");
+  const changelogPath = path11.join(cwd, "CHANGELOG.md");
+  if (!fs10.existsSync(changelogPath)) return { status: "missing" };
+  const content = fs10.readFileSync(changelogPath, "utf-8");
   const unreleasedHeading = /^## \[Unreleased\][^\n]*$/m;
   if (!unreleasedHeading.test(content)) return { status: "no-unreleased" };
   const blankUnreleased = [
@@ -3165,7 +3232,7 @@ function updateChangelogUnreleased(cwd, version, date) {
     `## [${version}] \u2014 ${date}`
   ].join("\n");
   const updated = content.replace(unreleasedHeading, blankUnreleased);
-  fs9.writeFileSync(changelogPath, updated, "utf-8");
+  fs10.writeFileSync(changelogPath, updated, "utf-8");
   return { status: "updated", version };
 }
 async function ship() {
@@ -3224,12 +3291,12 @@ ${ko.ship.title}
     { type: "input", name: "learned", message: ko.ship.questionLearned },
     { type: "input", name: "nextVersion", message: ko.ship.questionNext }
   ]);
-  const buildLogDir = path10.join(cwd, "docs", "build-log");
-  if (!fs9.existsSync(buildLogDir)) fs9.mkdirSync(buildLogDir, { recursive: true });
+  const buildLogDir = path11.join(cwd, "docs", "build-log");
+  if (!fs10.existsSync(buildLogDir)) fs10.mkdirSync(buildLogDir, { recursive: true });
   const today = localDate();
   const versionSlug = sanitizeVersion(retro.version);
   const fileName = `${today}-v${versionSlug}.md`;
-  const filePath = path10.join(buildLogDir, fileName);
+  const filePath = path11.join(buildLogDir, fileName);
   const content = [
     `# \uBE4C\uB4DC \uB85C\uADF8: v${versionSlug}`,
     "",
@@ -3258,9 +3325,9 @@ ${ko.ship.title}
     "---",
     `*Generated by \`vhk ship\` at ${(/* @__PURE__ */ new Date()).toISOString()}*`
   ].join("\n");
-  fs9.writeFileSync(filePath, content, "utf-8");
+  fs10.writeFileSync(filePath, content, "utf-8");
   console.log(chalk10.green(`
-  ${ko.ship.buildLogDone(path10.relative(cwd, filePath))}`));
+  ${ko.ship.buildLogDone(path11.relative(cwd, filePath))}`));
   const changelogResult = updateChangelogUnreleased(cwd, versionSlug, today);
   if (changelogResult.status === "updated") {
     log.success(ko.ship.changelogUpdated(changelogResult.version));
@@ -3594,8 +3661,8 @@ ${ko.restore.notFound(targetId)}`));
 
 // src/commands/status.ts
 import { execFileSync as execFileSync3 } from "child_process";
-import fs10 from "fs";
-import path11 from "path";
+import fs11 from "fs";
+import path12 from "path";
 import chalk14 from "chalk";
 function countFileChanges(porcelain) {
   const lines = porcelain.split("\n").filter(Boolean);
@@ -3634,8 +3701,8 @@ function parseRecentCommitLines(logOutput) {
   return logOutput.split("\n").map((l) => l.trim()).filter(Boolean);
 }
 function readProjectPackage(cwd = process.cwd()) {
-  const pkgPath = path11.join(cwd, "package.json");
-  if (!fs10.existsSync(pkgPath)) return null;
+  const pkgPath = path12.join(cwd, "package.json");
+  if (!fs11.existsSync(pkgPath)) return null;
   try {
     const pkg = readJsonFile(pkgPath);
     if (!pkg.name && !pkg.version) return null;
@@ -4488,6 +4555,7 @@ async function update() {
 \u{1F4CC} \uD604\uC7AC \uBC84\uC804: v${current}`));
   const spinner = ora4("\uCD5C\uC2E0 \uBC84\uC804 \uD655\uC778 \uC911...").start();
   const latest = getLatestVersion();
+  if (latest) recordLatest(latest);
   if (!latest) {
     spinner.fail("\uCD5C\uC2E0 \uBC84\uC804\uC744 \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
     console.log(chalk22.yellow("   \uB124\uD2B8\uC6CC\uD06C\uB97C \uD655\uC778\uD558\uAC70\uB098 \uC218\uB3D9\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694:"));
@@ -5586,15 +5654,15 @@ ${ko.start.allDone}
 }
 
 // src/commands/cloud.ts
-import fs12 from "fs";
-import os from "os";
-import path13 from "path";
+import fs13 from "fs";
+import os2 from "os";
+import path14 from "path";
 import chalk28 from "chalk";
 
 // src/lib/vhk-cloud.ts
 var import_ignore = __toESM(require_ignore(), 1);
-import fs11 from "fs";
-import path12 from "path";
+import fs12 from "fs";
+import path13 from "path";
 var DEFAULT_CLOUD_EXCLUDES = [
   "memory.json",
   // 개인 의사결정 메모
@@ -5612,17 +5680,17 @@ var CLOUD_CONFIG_FILE = "cloud.json";
 function loadVhkignore(rootDir) {
   const ig = (0, import_ignore.default)();
   ig.add(DEFAULT_CLOUD_EXCLUDES);
-  const ignorePath = path12.join(rootDir, ".vhkignore");
-  if (fs11.existsSync(ignorePath)) {
-    ig.add(fs11.readFileSync(ignorePath, "utf-8"));
+  const ignorePath = path13.join(rootDir, ".vhkignore");
+  if (fs12.existsSync(ignorePath)) {
+    ig.add(fs12.readFileSync(ignorePath, "utf-8"));
   }
   return ig;
 }
 function collectVhkFiles(rootDir, ig = loadVhkignore(rootDir)) {
-  const vhkDir = path12.join(rootDir, VHK_DIR3);
+  const vhkDir = path13.join(rootDir, VHK_DIR3);
   let entries;
   try {
-    entries = fs11.readdirSync(vhkDir, { withFileTypes: true });
+    entries = fs12.readdirSync(vhkDir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -5638,8 +5706,8 @@ function partitionGistFiles(gistFiles, ig) {
   return { keep, excluded };
 }
 function readCloudConfig(rootDir) {
-  const p = path12.join(rootDir, VHK_DIR3, CLOUD_CONFIG_FILE);
-  if (!fs11.existsSync(p)) return null;
+  const p = path13.join(rootDir, VHK_DIR3, CLOUD_CONFIG_FILE);
+  if (!fs12.existsSync(p)) return null;
   try {
     const parsed = readJsonFile(p);
     if (parsed && typeof parsed.gistId === "string" && parsed.gistId) {
@@ -5651,17 +5719,17 @@ function readCloudConfig(rootDir) {
   }
 }
 function writeCloudConfig(rootDir, config) {
-  const vhkDir = path12.join(rootDir, VHK_DIR3);
-  fs11.mkdirSync(vhkDir, { recursive: true });
-  const p = path12.join(vhkDir, CLOUD_CONFIG_FILE);
-  fs11.writeFileSync(p, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  const vhkDir = path13.join(rootDir, VHK_DIR3);
+  fs12.mkdirSync(vhkDir, { recursive: true });
+  const p = path13.join(vhkDir, CLOUD_CONFIG_FILE);
+  fs12.writeFileSync(p, JSON.stringify(config, null, 2) + "\n", "utf-8");
   ensureCloudConfigIgnored(vhkDir);
 }
 function ensureCloudConfigIgnored(vhkDir) {
-  const giPath = path12.join(vhkDir, ".gitignore");
+  const giPath = path13.join(vhkDir, ".gitignore");
   let content = "";
   try {
-    if (fs11.existsSync(giPath)) content = fs11.readFileSync(giPath, "utf-8");
+    if (fs12.existsSync(giPath)) content = fs12.readFileSync(giPath, "utf-8");
   } catch {
     return;
   }
@@ -5672,7 +5740,7 @@ ${CLOUD_CONFIG_FILE}
 `;
   const base = content.length === 0 ? "" : content.endsWith("\n") ? content : content + "\n";
   try {
-    fs11.writeFileSync(giPath, base + block, "utf-8");
+    fs12.writeFileSync(giPath, base + block, "utf-8");
   } catch {
   }
 }
@@ -5705,7 +5773,7 @@ async function cloudPush() {
 ${ko.cloud.pushTitle}
 `));
   const cwd = process.cwd();
-  if (!fs12.existsSync(path13.join(cwd, VHK_DIR3))) {
+  if (!fs13.existsSync(path14.join(cwd, VHK_DIR3))) {
     console.log(chalk28.yellow(`  ${ko.cloud.noVhkDir}`));
     return;
   }
@@ -5719,11 +5787,11 @@ ${ko.cloud.pushTitle}
     process.exitCode = 1;
     return;
   }
-  const filePaths = files.map((f) => path13.join(cwd, VHK_DIR3, f));
+  const filePaths = files.map((f) => path14.join(cwd, VHK_DIR3, f));
   console.log(chalk28.dim(`  \u{1F4E6} \uBC31\uC5C5 \uB300\uC0C1 ${files.length}\uAC1C: ${files.join(", ")}
 `));
   const existing = readCloudConfig(cwd);
-  const desc = `vhk .vhk backup \u2014 ${path13.basename(cwd)}`;
+  const desc = `vhk .vhk backup \u2014 ${path14.basename(cwd)}`;
   if (existing) {
     const gistFiles = listGistFiles(existing.gistId);
     for (let i = 0; i < files.length; i++) {
@@ -5810,8 +5878,8 @@ ${ko.cloud.pullTitle}
     console.log(chalk28.yellow(`  \uBCF5\uC6D0 \uB300\uC0C1\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 (gist \uD30C\uC77C\uC774 \uBAA8\uB450 \uC81C\uC678 \uADDC\uCE59\uC5D0 \uD574\uB2F9).`));
     return;
   }
-  const vhkDir = path13.join(cwd, VHK_DIR3);
-  fs12.mkdirSync(vhkDir, { recursive: true });
+  const vhkDir = path14.join(cwd, VHK_DIR3);
+  fs13.mkdirSync(vhkDir, { recursive: true });
   let restored = 0;
   for (const name of names) {
     const res = safeExecFile("gh", ["gist", "view", gistId, "-f", name, "--raw"]);
@@ -5820,7 +5888,7 @@ ${ko.cloud.pullTitle}
       console.log(chalk28.dim(`    ${res.err}`));
       continue;
     }
-    fs12.writeFileSync(path13.join(vhkDir, name), ensureTrailingNewline(res.out), "utf-8");
+    fs13.writeFileSync(path14.join(vhkDir, name), ensureTrailingNewline(res.out), "utf-8");
     restored++;
   }
   writeCloudConfig(cwd, { gistId });
@@ -5837,9 +5905,9 @@ function purgeExcludedFromGist(gistId, names) {
   const body = JSON.stringify({
     files: Object.fromEntries(names.map((n) => [n, null]))
   });
-  const tmp = path13.join(os.tmpdir(), `vhk-gist-purge-${process.pid}.json`);
+  const tmp = path14.join(os2.tmpdir(), `vhk-gist-purge-${process.pid}.json`);
   try {
-    fs12.writeFileSync(tmp, body, "utf-8");
+    fs13.writeFileSync(tmp, body, "utf-8");
     for (let attempt = 0; attempt < 2; attempt++) {
       const res = safeExecFile(
         "gh",
@@ -5851,7 +5919,7 @@ function purgeExcludedFromGist(gistId, names) {
     return false;
   } finally {
     try {
-      fs12.unlinkSync(tmp);
+      fs13.unlinkSync(tmp);
     } catch {
     }
   }
@@ -6228,8 +6296,8 @@ function verifyEvidence(cwd = process.cwd()) {
   const report = buildReport(gates, (/* @__PURE__ */ new Date()).toISOString(), localDate());
   const dir = join12(cwd, REPORT_DIR_REL);
   mkdirSync12(dir, { recursive: true });
-  const path14 = join12(cwd, REPORT_PATH_REL);
-  writeFileSync12(path14, JSON.stringify(report, null, 2) + "\n", "utf-8");
+  const path15 = join12(cwd, REPORT_PATH_REL);
+  writeFileSync12(path15, JSON.stringify(report, null, 2) + "\n", "utf-8");
   try {
     ensureVhkIgnored(cwd, "reports/");
   } catch {
@@ -6302,7 +6370,7 @@ async function verify(opts = {}) {
     await renderVerifyReport(cwd, opts);
     return;
   }
-  const { report, path: path14 } = verifyEvidence(cwd);
+  const { report, path: path15 } = verifyEvidence(cwd);
   if (opts.json) {
     console.log(JSON.stringify(report, null, 2));
     process.exitCode = report.status === "FAIL" ? 1 : 0;
@@ -6322,7 +6390,7 @@ async function verify(opts = {}) {
     `
   \uACB0\uACFC: ${STATUS_BADGE[report.status]}  ` + chalk31.dim(`(pass ${s.pass} / fail ${s.fail} / skip ${s.skip}, \uCD1D ${s.total})`)
   );
-  console.log(chalk31.dim(`  \u{1F4C4} \uC99D\uAC70: ${path14}`));
+  console.log(chalk31.dim(`  \u{1F4C4} \uC99D\uAC70: ${path15}`));
   process.exitCode = report.status === "FAIL" ? 1 : 0;
   if (report.status === "FAIL") {
     printNextStep({
@@ -8016,27 +8084,49 @@ program.on("command:*", async (operands) => {
   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 info = getUpdateInfo();
+  console.log("\n\u{1F3AF} VHK \u2014 \uBC14\uC774\uBE0C\uCF54\uB529 \uD504\uB85C\uC81D\uD2B8 \uCF54\uCE58  " + chalk38.dim(`v${info.current}`));
+  if (info.updateAvailable && info.latest) {
+    console.log(chalk38.yellow(`\u{1F195} \uC5C5\uB370\uC774\uD2B8 \uAC00\uB2A5: v${info.latest}`) + chalk38.dim("  \u2192  vhk update"));
+  }
+  const sample = QUICK_ACTIONS[0]?.say ?? "\uC0C1\uD0DC \uC54C\uB824\uC918";
+  console.log(
+    chalk38.dim("\u{1F4AC} \uBA85\uB839 \uC9C1\uC811 \uC785\uB825\uB3C4 \uB3FC\uC694 \u2014 \uC608: ") + chalk38.cyan("vhk status") + chalk38.dim("  \xB7  \uC790\uC5F0\uC5B4 OK: ") + chalk38.cyan(`"${sample}"`)
+  );
+  console.log("");
+  const choices = [
+    { name: "\u{1F680} \uC791\uC5C5 \uC2DC\uC791/\uC774\uC5B4\uD558\uAE30 (work)", value: "work" },
+    { name: "\u{1F4A1} \uC0C8 \uC544\uC774\uB514\uC5B4 \uAC80\uC99D\uD558\uAE30", value: "gate" },
+    { name: "\u{1F195} \uC0C8 \uD504\uB85C\uC81D\uD2B8 \uC2DC\uC791 \uB9C8\uBC95\uC0AC (start)", value: "start" },
+    { name: "\u{1F3AF} \uB2E4\uC74C \uBAA9\uD45C \uBCF4\uAE30 (goal)", value: "goal-next" },
+    { name: "\u{1F4DD} \uC624\uB298 \uD55C \uC77C \uC815\uB9AC\uD558\uAE30", value: "recap" },
+    { name: "\u{1F50D} \uADDC\uCE59 \uD30C\uC77C \uC810\uAC80\uD558\uAE30", value: "check" },
+    { name: "\u{1F512} \uBCF4\uC548 \uC2A4\uCE94 \uB3CC\uB9AC\uAE30", value: "secure" },
+    { name: "\u{1F504} \uADDC\uCE59 \uD30C\uC77C \uB3D9\uAE30\uD654", value: "sync" },
+    { name: "\u{1F680} \uBC30\uD3EC\uD558\uAE30", value: "ship" },
+    { name: "\u{1FA7A} \uD658\uACBD \uC810\uAC80\uD558\uAE30", value: "doctor" },
+    { name: "\u{1F4BE} Git\uC5D0 \uC800\uC7A5\uD558\uAE30", value: "save" },
+    { name: "\u23EA \uCD5C\uADFC \uCEE4\uBC0B \uB418\uB3CC\uB9AC\uAE30", value: "undo" },
+    { name: "\u{1F50D} \uBCC0\uACBD\uC0AC\uD56D \uBCF4\uAE30", value: "diff" },
+    { name: "\u{1F4CA} \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uBCF4\uAE30", value: "status" },
+    { name: "\u23F8\uFE0F  \uC791\uC5C5 \uC911\uB2E8 \uC815\uB9AC (handoff)", value: "work-handoff" }
+  ];
   const { choice } = await inquirer15.prompt([{
     type: "list",
     name: "choice",
     message: "\uBB58 \uB3C4\uC640\uB4DC\uB9B4\uAE4C\uC694?",
-    choices: [
-      { name: "\u{1F4A1} \uC0C8 \uC544\uC774\uB514\uC5B4 \uAC80\uC99D\uD558\uAE30", value: "gate" },
-      { name: "\u{1F680} \uC0C8 \uD504\uB85C\uC81D\uD2B8 \uC2DC\uC791 \uB9C8\uBC95\uC0AC (start)", value: "start" },
-      { name: "\u{1F4DD} \uC624\uB298 \uD55C \uC77C \uC815\uB9AC\uD558\uAE30", value: "recap" },
-      { name: "\u{1F50D} \uADDC\uCE59 \uD30C\uC77C \uC810\uAC80\uD558\uAE30", value: "check" },
-      { name: "\u{1F512} \uBCF4\uC548 \uC2A4\uCE94 \uB3CC\uB9AC\uAE30", value: "secure" },
-      { name: "\u{1F504} \uADDC\uCE59 \uD30C\uC77C \uB3D9\uAE30\uD654", value: "sync" },
-      { name: "\u{1F680} \uBC30\uD3EC\uD558\uAE30", value: "ship" },
-      { name: "\u{1FA7A} \uD658\uACBD \uC810\uAC80\uD558\uAE30", value: "doctor" },
-      { name: "\u{1F4BE} Git\uC5D0 \uC800\uC7A5\uD558\uAE30", value: "save" },
-      { name: "\u23EA \uCD5C\uADFC \uCEE4\uBC0B \uB418\uB3CC\uB9AC\uAE30", value: "undo" },
-      { name: "\u{1F50D} \uBCC0\uACBD\uC0AC\uD56D \uBCF4\uAE30", value: "diff" },
-      { name: "\u{1F4CA} \uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uBCF4\uAE30", value: "status" }
-    ]
+    pageSize: choices.length,
+    // 스크롤 잔상/잘림 방지(Windows conhost): 한 화면에 전부
+    loop: false,
+    choices
   }]);
   switch (choice) {
+    case "work":
+      return work();
+    case "work-handoff":
+      return workHandoff();
+    case "goal-next":
+      return goalNext();
     case "gate":
       return gate();
     case "start":
@@ -8065,7 +8155,7 @@ program.action(async () => {
 });
 var getRealPath = (p) => {
   try {
-    return fs13.realpathSync(p);
+    return fs14.realpathSync(p);
   } catch {
     return p;
   }

package/dist/mcp/index.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byh3071/vhk",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "packageManager": "pnpm@11.2.2",
   "description": "Vibe Harness Kit — AI 코딩 도구·기기를 바꿔도 규칙·맥락이 따라가는 포터빌리티 CLI (sync: Cursor·Claude·Windsurf·Copilot·Antigravity / cloud 백업)",
   "bin": {