@byh3071/vhk 0.5.2 → 0.5.3

package/README.md

@@ -1,12 +1,14 @@
 ---
 id: vhk-readme
 date: 2026-05-23
-tags: [vhk, cli, readme, v0.5.2]
+tags: [vhk, cli, readme, v0.5.3]
 ---
 
 # 🔧 VHK — Vibe Harness Kit
 
-> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.5.2)
+> 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

@@ -657,11 +657,11 @@ function detectNaturalLanguageInput(argv) {
   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.slice(1).every(isOptionToken)) return null;
   if (firstIsKnown && rest.length > 1) {
     if (routeNaturalLanguage(input)) return input;
     return null;
@@ -854,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?",
@@ -909,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) {
@@ -1730,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;
 }
@@ -2796,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}
@@ -2823,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();
@@ -2885,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}
@@ -2976,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",
@@ -3564,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.2");
+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) {

package/package.json

@@ -1,56 +1,62 @@
-{
-  "name": "@byh3071/vhk",
-  "version": "0.5.2",
-  "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"
+  }
+}