@byh3071/vhk 0.4.0 → 0.5.0

package/README.md

@@ -1,58 +1,168 @@
+---
+id: vhk-readme
+date: 2026-05-23
+tags: [vhk, cli, readme, v0.4.0]
+---
+
 # 🔧 VHK — Vibe Harness Kit
 
-> AI 코딩 에이전트를 부리는 사람을 위한 풀사이클 CLI
+> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.4.0)
+
+명령어를 외우지 않아도 됩니다. `vhk`만 치면 메뉴가 나오고, 한국어로 말해도 알아듣습니다.
 
 ## 설치
 
 ```bash
-npm i -g vhk
+npm install -g @byh3071/vhk
 ```
 
 ```bash
-# 또는
-npx vhk init
+# 한 번만 쓸 때
+npx @byh3071/vhk
+```
+
+로컬 개발 중:
+
+```powershell
+cd vhk-cli
+pnpm install
+pnpm build
+pnpm link --global
+vhk --version
+```
+
+## 빠른 시작
+
+```bash
+vhk
+```
+
+인자 없이 실행하면 **「뭘 도와드릴까요?」** 메뉴가 열립니다.
+
+```bash
+# 자연어로도 가능
+vhk 프로젝트 만들고 싶어
+vhk 기획 끝났고 바로 시작
+vhk 오늘 한 일 정리
+vhk 뭔가 안 돼
+```
+
+## 워크플로우 (권장 순서)
+
+```text
+vhk 검증 (gate)     → 아이디어 GO/다듬기/다른 아이디어
+vhk 시작 (init)     → 하네스 파일 생성 (CLAUDE.md, PRD, ADR 템플릿 등)
+   개발 ...
+vhk 정리 (recap)    → 세션 로그 + ADR/트러블슈팅 제안
+vhk 점검 (check)    → RULES.md 규칙 린트
+vhk 보안 scan       → 시크릿·키 유출 검사
+vhk 배포 (ship)     → 배포 체크리스트 + 회고 → docs/build-log/
 ```
 
-## 커맨드
+기획이 이미 끝났다면:
+
+```bash
+vhk 시작 --skip-gate
+# 또는
+vhk 기획 끝났고 바로 시작
+```
 
-| 커맨드 | 설명 |
+## 전체 커맨드
+
+| 영어 | 한국어 별칭 | 설명 |
+|------|-------------|------|
+| `vhk` | — | 시작 메뉴 (명령 없음) |
+| `vhk gate` | `검증`, `아이디어` | 아이디어 검증 (퀵 5문항 / 풀 13문항 / 스킵) |
+| `vhk init` | `시작`, `만들기` | 프로젝트 초기화 + 하네스 생성 |
+| `vhk recap` | `정리`, `오늘` | Git 변경 → `docs/log/` 세션 로그 |
+| `vhk sync` | `규칙`, `맞추기` | RULES.md → `.cursorrules` + CLAUDE.md |
+| `vhk check` | `점검`, `린트` | RULES.md 규칙 위반 검사 |
+| `vhk secure scan` | `보안`, `스캔` | 코드 내 시크릿·키 패턴 스캔 |
+| `vhk ship` | `배포`, `릴리즈` | 배포 체크리스트 + 회고 + 빌드 로그 |
+| `vhk doctor` | `진단`, `환경` | Node / npm / pnpm / Git 환경 점검 |
+
+### init 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| `--skip-gate` | 아이디어 검증(gate) 생략 |
+| `--from-notion <url>` | Notion PRD 페이지에서 import |
+| `--name`, `--description`, `--type` | 비대화형 입력 |
+| `-y, --yes` | 스택 확인 스킵 |
+
+### recap 옵션
+
+| 옵션 | 설명 |
+|------|------|
+| `--since YYYY-MM-DD` | 분석 시작일 (기본: 오늘) |
+
+## v0.4.0 하이라이트
+
+| 기능 | 설명 |
+|------|------|
+| **시작 메뉴** | `vhk`만 입력해도 다음 작업 선택 |
+| **한국어 별칭** | `vhk 검증`, `vhk 시작`, `vhk 정리` 등 |
+| **자연어 라우팅** | `vhk "프로젝트 만들고 싶어"` → init 실행 |
+| **doctor** | Node / npm / pnpm / Git + 프로젝트 파일 점검 |
+| **ship** | 배포 전 체크리스트, 회고, `docs/build-log/` 생성 |
+| **다음에 이것만 하세요** | 각 명령 끝에 복붙 명령 + Cursor 힌트 |
+| **check / secure** | RULES 린트, 시크릿 스캔 (대형 lock·node_modules 제외) |
+
+## init이 만드는 것 (요약)
+
+- `CLAUDE.md`, `.cursorrules`
+- `docs/PRD.md`, `docs/ARCHITECTURE.md`
+- `docs/adr/`, `docs/log/`, `docs/troubleshooting/`
+- `COMMANDS.md`, `BACKLOG.md` (프로젝트 유형에 따라)
+
+## 자연어 예시
+
+| 말하면 | 실행 |
 |--------|------|
-| `vhk gate` | 아이디어 13단계 검증 → GO/REFINE/DROP |
-| `vhk init` | 프로젝트 초기화 + 하네스 파일 자동 생성 |
-| `vhk recap` | Git diff → 세션 로그 자동 생성 |
-| `vhk sync` | RULES.md → `.cursorrules` + `CLAUDE.md` 동기화 |
+| 프로젝트 만들고 싶어 | `vhk 시작` |
+| 기획 끝났고 바로 시작 | `vhk 시작 --skip-gate` |
+| 오늘 한 일 정리 | `vhk 정리` |
+| 보안 스캔 돌려 | `vhk 보안 scan` |
+| 배포하고 싶어 | `vhk 배포` |
+| 뭔가 안 돼 | `vhk doctor` |
 
 ## 특징
 
-- 🇰🇷 **한국어 퍼스트** — 터미널 전체가 한국어로 동작
-- ⚡ **제로 설정** — `npx vhk init` 한 방이면 끝
-- 📁 **로컬 퍼스트** — 데이터는 프로젝트 폴더에 저장
-- 🐕 **독푸딩** — VHK 자체가 VHK로 만들어짐
+- 🇰🇷 **한국어 퍼스트** — 질문·판정·다음 단계 안내가 한국어
+- 🗣️ **자연어 친화** — 명령어 몰라도 문장으로 시작
+- 📁 **로컬 퍼스트** — 로그·ADR·빌드 로그는 프로젝트 폴더에 저장
+- 🔒 **보안 기본** — `.gitignore`·시크릿 스캔·민감 파일 경고
 
 ## 요구 사항
 
 - Node.js >= 20
+- Git (recap·ship 권장)
+
+## 개발
+
+```powershell
+pnpm install
+pnpm build
+pnpm test --run
+pnpm dev
+pnpm dev 검증
+```
+
+> Windows PowerShell 5.x에서는 `&&` 대신 `;` 사용: `pnpm build; pnpm test --run`
 
 ## 라이선스
 
-MIT
+MIT — [LICENSE](LICENSE)
 
 ## 배포 (maintainers)
 
 ```bash
-# 1. npm 로그인 (최초 1회)
 npm login
-
-# 2. 빌드 + 테스트
-pnpm build
-pnpm test
-
-# 3. 배포
-npm publish
-
-# 4. 확인
-npm info vhk
-npx vhk --help
+pnpm run prepublishOnly
+npm publish --access public
+npm info @byh3071/vhk
 ```
 
-`package.json`의 `prepublishOnly` 스크립트가 publish 전에 빌드·테스트를 자동 실행합니다.
+`prepublishOnly`가 publish 전에 `pnpm build && pnpm test:run`을 실행합니다.
+
+Repository: https://github.com/byh3071-cpu/vhk

package/dist/index.js

@@ -323,7 +323,7 @@ var require_ignore = __commonJS({
       //   path matching.
       // - check `string` either `MODE_IGNORE` or `MODE_CHECK_IGNORE`
       // @returns {TestResult} true if a file is ignored
-      test(path14, checkUnignored, mode) {
+      test(path15, checkUnignored, mode) {
         let ignored = false;
         let unignored = false;
         let matchedRule;
@@ -332,7 +332,7 @@ var require_ignore = __commonJS({
           if (unignored === negative && ignored !== unignored || negative && !ignored && !unignored && !checkUnignored) {
             return;
           }
-          const matched = rule[mode].test(path14);
+          const matched = rule[mode].test(path15);
           if (!matched) {
             return;
           }
@@ -353,17 +353,17 @@ var require_ignore = __commonJS({
     var throwError = (message, Ctor) => {
       throw new Ctor(message);
     };
-    var checkPath = (path14, originalPath, doThrow) => {
-      if (!isString(path14)) {
+    var checkPath = (path15, originalPath, doThrow) => {
+      if (!isString(path15)) {
         return doThrow(
           `path must be a string, but got \`${originalPath}\``,
           TypeError
         );
       }
-      if (!path14) {
+      if (!path15) {
         return doThrow(`path must not be empty`, TypeError);
       }
-      if (checkPath.isNotRelative(path14)) {
+      if (checkPath.isNotRelative(path15)) {
         const r = "`path.relative()`d";
         return doThrow(
           `path should be a ${r} string, but got "${originalPath}"`,
@@ -372,7 +372,7 @@ var require_ignore = __commonJS({
       }
       return true;
     };
-    var isNotRelative = (path14) => REGEX_TEST_INVALID_PATH.test(path14);
+    var isNotRelative = (path15) => REGEX_TEST_INVALID_PATH.test(path15);
     checkPath.isNotRelative = isNotRelative;
     checkPath.convert = (p) => p;
     var Ignore = class {
@@ -402,19 +402,19 @@ var require_ignore = __commonJS({
       }
       // @returns {TestResult}
       _test(originalPath, cache, checkUnignored, slices) {
-        const path14 = originalPath && checkPath.convert(originalPath);
+        const path15 = originalPath && checkPath.convert(originalPath);
         checkPath(
-          path14,
+          path15,
           originalPath,
           this._strictPathCheck ? throwError : RETURN_FALSE
         );
-        return this._t(path14, cache, checkUnignored, slices);
+        return this._t(path15, cache, checkUnignored, slices);
       }
-      checkIgnore(path14) {
-        if (!REGEX_TEST_TRAILING_SLASH.test(path14)) {
-          return this.test(path14);
+      checkIgnore(path15) {
+        if (!REGEX_TEST_TRAILING_SLASH.test(path15)) {
+          return this.test(path15);
         }
-        const slices = path14.split(SLASH).filter(Boolean);
+        const slices = path15.split(SLASH).filter(Boolean);
         slices.pop();
         if (slices.length) {
           const parent = this._t(
@@ -427,18 +427,18 @@ var require_ignore = __commonJS({
             return parent;
           }
         }
-        return this._rules.test(path14, false, MODE_CHECK_IGNORE);
+        return this._rules.test(path15, false, MODE_CHECK_IGNORE);
       }
-      _t(path14, cache, checkUnignored, slices) {
-        if (path14 in cache) {
-          return cache[path14];
+      _t(path15, cache, checkUnignored, slices) {
+        if (path15 in cache) {
+          return cache[path15];
         }
         if (!slices) {
-          slices = path14.split(SLASH).filter(Boolean);
+          slices = path15.split(SLASH).filter(Boolean);
         }
         slices.pop();
         if (!slices.length) {
-          return cache[path14] = this._rules.test(path14, checkUnignored, MODE_IGNORE);
+          return cache[path15] = this._rules.test(path15, checkUnignored, MODE_IGNORE);
         }
         const parent = this._t(
           slices.join(SLASH) + SLASH,
@@ -446,29 +446,29 @@ var require_ignore = __commonJS({
           checkUnignored,
           slices
         );
-        return cache[path14] = parent.ignored ? parent : this._rules.test(path14, checkUnignored, MODE_IGNORE);
+        return cache[path15] = parent.ignored ? parent : this._rules.test(path15, checkUnignored, MODE_IGNORE);
       }
-      ignores(path14) {
-        return this._test(path14, this._ignoreCache, false).ignored;
+      ignores(path15) {
+        return this._test(path15, this._ignoreCache, false).ignored;
       }
       createFilter() {
-        return (path14) => !this.ignores(path14);
+        return (path15) => !this.ignores(path15);
       }
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
       // @returns {TestResult}
-      test(path14) {
-        return this._test(path14, this._testCache, true);
+      test(path15) {
+        return this._test(path15, this._testCache, true);
       }
     };
     var factory = (options) => new Ignore(options);
-    var isPathValid = (path14) => checkPath(path14 && checkPath.convert(path14), path14, RETURN_FALSE);
+    var isPathValid = (path15) => checkPath(path15 && checkPath.convert(path15), path15, RETURN_FALSE);
     var setupWindows = () => {
       const makePosix = (str) => /^\\\\\?\\/.test(str) || /["<>|\u0000-\u001F]+/u.test(str) ? str : str.replace(/\\/g, "/");
       checkPath.convert = makePosix;
       const REGEX_TEST_WINDOWS_PATH_ABSOLUTE = /^[a-z]:\//i;
-      checkPath.isNotRelative = (path14) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path14) || isNotRelative(path14);
+      checkPath.isNotRelative = (path15) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path15) || isNotRelative(path15);
     };
     if (
       // Detect `process` so that it can run in browsers.
@@ -485,75 +485,110 @@ var require_ignore = __commonJS({
 
 // src/index.ts
 import { Command, Help } from "commander";
-import chalk11 from "chalk";
-import inquirer5 from "inquirer";
+import chalk15 from "chalk";
+import inquirer7 from "inquirer";
 
 // src/lib/nlp-router.ts
 function normalize(input) {
   return input.trim().toLowerCase().replace(/\s+/g, " ");
 }
+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", "\uD655\uC778"],
+  diff: ["\uBCC0\uACBD", "\uBC14\uB010", "\uBB50\uBC14\uB01C", "\uCC28\uC774", "\uB2EC\uB77C\uC9C4", "\uC218\uC815\uB41C"]
+};
+function matchesKeywords(text, command) {
+  const keywords = NLP_KEYWORDS[command];
+  if (!keywords) return false;
+  return keywords.some((kw) => text.includes(kw.toLowerCase()));
+}
 var RULES = [
   {
     command: "init",
     explanation: "\uAC80\uC99D \uC2A4\uD0B5\uD558\uACE0 \uBC14\uB85C \uD504\uB85C\uC81D\uD2B8 \uC2DC\uC791 (vhk \uC2DC\uC791 --skip-gate)",
     confidence: "high",
     args: ["--skip-gate"],
-    test: (t) => /기획.*(끝|완료)|노션.*(기획|완료)|검증.*(스킵|건너)|gate.*(스킵|건너)|바로.*시작/.test(t)
+    test: (t2) => /기획.*(끝|완료)|노션.*(기획|완료)|검증.*(스킵|건너)|gate.*(스킵|건너)|바로.*시작/.test(t2)
   },
   {
     command: "init",
     explanation: "Notion\uC5D0\uC11C \uAC00\uC838\uC640 \uD504\uB85C\uC81D\uD2B8 \uC2DC\uC791 (vhk \uC2DC\uC791 --from-notion)",
     confidence: "low",
     args: ["--from-notion"],
-    test: (t) => /노션|notion/.test(t) && /(시작|만들|import|가져)/.test(t)
+    test: (t2) => /노션|notion/.test(t2) && /(시작|만들|import|가져)/.test(t2)
   },
   {
     command: "init",
     explanation: "\uD504\uB85C\uC81D\uD2B8 \uC2DC\uC791 (vhk \uC2DC\uC791)",
     confidence: "high",
-    test: (t) => /프로젝트.*(만들|시작)|폴더.*만들|만들고\s*싶|하네스|초기화/.test(t) || /^시작$/.test(t)
+    test: (t2) => /프로젝트.*(만들|시작)|폴더.*만들|만들고\s*싶|하네스|초기화/.test(t2) || /^시작$/.test(t2)
+  },
+  {
+    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)
+  },
+  {
+    command: "undo",
+    explanation: "\uCD5C\uADFC \uCEE4\uBC0B \uB418\uB3CC\uB9AC\uAE30 (vhk \uB418\uB3CC\uB9AC\uAE30)",
+    confidence: "high",
+    test: (t2) => matchesKeywords(t2, "undo") || /undo|커밋\s*취/.test(t2)
+  },
+  {
+    command: "status",
+    explanation: "\uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uD655\uC778 (vhk \uC0C1\uD0DC)",
+    confidence: "high",
+    test: (t2) => matchesKeywords(t2, "status") || /^status$/.test(t2) || /브랜치.*(뭐|어디)|git\s*상태|동기화\s*상태/.test(t2)
+  },
+  {
+    command: "save",
+    explanation: "Git\uC5D0 \uC800\uC7A5 (vhk \uC800\uC7A5)",
+    confidence: "high",
+    test: (t2) => (matchesKeywords(t2, "save") || /깃허브|github/.test(t2)) && !/정리|recap|되돌|취소|rollback|reset|리셋|롤백|원래대로/.test(t2)
   },
   {
     command: "recap",
     explanation: "\uC624\uB298 \uD55C \uC77C \uC815\uB9AC (vhk \uC815\uB9AC)",
     confidence: "high",
-    test: (t) => /오늘.*(정리|기록)|한\s*일|세션|회고|recap|정리해/.test(t)
+    test: (t2) => /오늘.*(정리|기록)|한\s*일|세션|회고|recap|정리해/.test(t2)
   },
   {
     command: "doctor",
     explanation: "\uD658\uACBD \uC810\uAC80 (vhk doctor)",
     confidence: "high",
-    test: (t) => /뭔가\s*안|안\s*돼|안돼|환경\s*(점검|진단)|진단|doctor|설치.*확인|왜\s*안/.test(t)
+    test: (t2) => /뭔가\s*안|안\s*돼|안돼|환경\s*(점검|진단)|진단|doctor|설치.*확인|왜\s*안/.test(t2)
   },
   {
     command: "gate",
     explanation: "\uC544\uC774\uB514\uC5B4 \uAC80\uC99D (vhk \uAC80\uC99D)",
     confidence: "high",
-    test: (t) => /아이디어|검증|gate|go\/refine|pain\s*point/.test(t)
+    test: (t2) => /아이디어|검증|gate|go\/refine|pain\s*point/.test(t2)
   },
   {
     command: "secure",
     explanation: "\uBCF4\uC548 \uC2A4\uCE94 (vhk \uBCF4\uC548 scan)",
     confidence: "high",
-    test: (t) => /보안|시크릿|비밀|키\s*유출|secure|scan/.test(t)
+    test: (t2) => /보안|시크릿|비밀|키\s*유출|secure|scan/.test(t2)
   },
   {
     command: "check",
     explanation: "\uADDC\uCE59 \uC810\uAC80 (vhk \uC810\uAC80)",
     confidence: "high",
-    test: (t) => /규칙.*(점검|위반)|린트|check|위반/.test(t)
+    test: (t2) => /규칙.*(점검|위반)|린트|check|위반/.test(t2)
   },
   {
     command: "sync",
     explanation: "\uADDC\uCE59 \uD30C\uC77C \uB3D9\uAE30\uD654 (vhk \uADDC\uCE59)",
     confidence: "high",
-    test: (t) => /규칙.*(맞|동기)|sync|cursorrules|claude\.md.*맞/.test(t)
+    test: (t2) => /규칙.*(맞|동기)|sync|cursorrules|claude\.md.*맞/.test(t2)
   },
   {
     command: "ship",
     explanation: "\uBC30\uD3EC \uCCB4\uD06C + \uD68C\uACE0 (vhk ship)",
     confidence: "high",
-    test: (t) => /배포|출시|릴리스|ship|빌드\s*전/.test(t)
+    test: (t2) => /배포|출시|릴리스|ship|빌드\s*전/.test(t2)
   }
 ];
 function routeNaturalLanguage(input) {
@@ -578,6 +613,60 @@ function extractNotionUrl(input) {
 
 // src/i18n/ko.ts
 var ko = {
+  status: {
+    title: "\uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC",
+    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):",
+    noCommits: "\uCEE4\uBC0B \uC5C6\uC74C",
+    remote: "\uC6D0\uACA9:",
+    noUpstream: "upstream \uC5C6\uC74C",
+    inSync: "\uB3D9\uAE30\uD654\uB428",
+    ahead: (n) => `\u2191${n} ahead`,
+    behind: (n) => `\u2193${n} behind`,
+    package: "package.json:",
+    noPackage: "package.json \uC5C6\uC74C",
+    detached: "(detached HEAD)",
+    unknownBranch: "(\uC54C \uC218 \uC5C6\uC74C)"
+  },
+  save: {
+    title: "\uC800\uC7A5\uD558\uAE30",
+    notGitRepo: "git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4. \uBA3C\uC800 git init\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
+    noChanges: "\uC800\uC7A5\uD560 \uBCC0\uACBD\uC0AC\uD56D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+    filesHeader: (n) => `\uBCC0\uACBD\uB41C \uD30C\uC77C (${n}\uAC1C):`,
+    commitMessage: "\uCEE4\uBC0B \uBA54\uC2DC\uC9C0 (Enter\uB85C \uAE30\uBCF8\uAC12 \uC0AC\uC6A9):",
+    saving: "\uC800\uC7A5 \uC911...",
+    pushing: "\uC6D0\uACA9 \uC800\uC7A5\uC18C\uC5D0 \uC62C\uB9AC\uB294 \uC911...",
+    successWithPush: "\uC800\uC7A5 + \uC6D0\uACA9 \uC5C5\uB85C\uB4DC \uC644\uB8CC!",
+    successLocal: "\uB85C\uCEEC \uC800\uC7A5 \uC644\uB8CC!",
+    noRemote: "\uC6D0\uACA9 \uC800\uC7A5\uC18C\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC544 push\uB97C \uAC74\uB108\uB6F0\uC5C8\uC2B5\uB2C8\uB2E4.",
+    failed: "\uC800\uC7A5 \uC2E4\uD328",
+    done: (n) => `${n}\uAC1C \uD30C\uC77C \uC800\uC7A5 \uC644\uB8CC!`
+  },
+  undo: {
+    title: "\uB418\uB3CC\uB9AC\uAE30",
+    notGitRepo: "git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4.",
+    noCommits: "\uB418\uB3CC\uB9B4 \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+    recentHeader: "\u{1F4CB} \uCD5C\uADFC \uCEE4\uBC0B:",
+    howMany: "\uBA87 \uAC1C\uC758 \uCEE4\uBC0B\uC744 \uB418\uB3CC\uB9B4\uAE4C\uC694?",
+    alreadyPushed: "\uC774 \uCEE4\uBC0B\uC740 \uC774\uBBF8 \uC6D0\uACA9\uC5D0 \uC62C\uB77C\uAC14\uC2B5\uB2C8\uB2E4. \uB418\uB3CC\uB9AC\uBA74 \uCDA9\uB3CC\uC774 \uC0DD\uAE38 \uC218 \uC788\uC5B4\uC694.",
+    confirmMessage: "\uCD5C\uADFC \uCEE4\uBC0B\uC744 \uB418\uB3CC\uB9AC\uC2DC\uACA0\uC2B5\uB2C8\uAE4C?",
+    cancelled: "\uCDE8\uC18C\uB428",
+    success: "\uB418\uB3CC\uB9AC\uAE30 \uC644\uB8CC! \uBCC0\uACBD\uC0AC\uD56D\uC740 \uADF8\uB300\uB85C \uB0A8\uC544\uC788\uC2B5\uB2C8\uB2E4.",
+    stagedHint: "\uBCC0\uACBD\uC0AC\uD56D\uC740 \uC2A4\uD14C\uC774\uC9D5 \uC601\uC5ED\uC5D0 \uB0A8\uC544 \uC788\uC5B4\uC694.",
+    failed: "\uB418\uB3CC\uB9AC\uAE30 \uC2E4\uD328"
+  },
+  diff: {
+    title: "\uBCC0\uACBD\uC0AC\uD56D \uD655\uC778",
+    notGitRepo: "git \uC800\uC7A5\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4.",
+    noChanges: "\uBCC0\uACBD\uC0AC\uD56D \uC5C6\uC74C! \uAE68\uB057\uD569\uB2C8\uB2E4.",
+    stagedHeader: "\u{1F4E6} \uCEE4\uBC0B \uB300\uAE30 (staged):",
+    unstagedHeader: "\u270F\uFE0F  \uC218\uC815\uB428 (unstaged):",
+    untrackedHeader: (n) => `\u2795 \uC0C8 \uD30C\uC77C (${n}\uAC1C):`,
+    summaryHeader: "\u{1F4CA} \uCD1D \uBCC0\uACBD \uC694\uC57D (\uC791\uC5C5 \uD2B8\uB9AC vs HEAD)",
+    filesLine: (n) => `\uD30C\uC77C: ${n}\uAC1C`
+  },
   start: {
     title: "\u{1F527} VHK \u2014 \uBB34\uC5C7\uC744 \uB3C4\uC640\uB4DC\uB9B4\uAE4C\uC694?",
     subtitle: "\uBC88\uD638\uB9CC \uACE0\uB974\uBA74 \uB429\uB2C8\uB2E4. \uBA85\uB839\uC5B4\uB97C \uC678\uC6B8 \uD544\uC694 \uC5C6\uC5B4\uC694.",
@@ -749,6 +838,23 @@ var ko = {
     hintCommit: "git status \uD655\uC778"
   }
 };
+function lookup(path15) {
+  const parts = path15.split(".");
+  let cur = ko;
+  for (const part of parts) {
+    if (cur === null || typeof cur !== "object") return void 0;
+    cur = cur[part];
+  }
+  return cur;
+}
+function t(key, ...args) {
+  const value = lookup(key);
+  if (typeof value === "function") {
+    return value(...args);
+  }
+  if (typeof value === "string") return value;
+  return key;
+}
 
 // src/commands/gate.ts
 import inquirer from "inquirer";
@@ -861,7 +967,7 @@ ${ko.gate.checklistStart}
       name: "answer",
       message: `[${i + 1}/${total}] ${q.stage}: ${q.question}`
     }]);
-    const { status } = await inquirer.prompt([{
+    const { status: status2 } = await inquirer.prompt([{
       type: "list",
       name: "status",
       message: ko.gate.verdictPrompt(q.failIf),
@@ -871,10 +977,10 @@ ${ko.gate.checklistStart}
         { name: ko.gate.statusFailChoice, value: "fail" }
       ]
     }]);
-    if (status === "fail") failCount++;
-    if (status === "hold") holdCount++;
-    results.push({ id: q.id, stage: q.stage, status, answer });
-    const icon = status === "pass" ? chalk2.green(ko.gate.statusPassLine) : status === "hold" ? chalk2.yellow(ko.gate.statusHoldLine) : chalk2.red(ko.gate.statusFailLine);
+    if (status2 === "fail") failCount++;
+    if (status2 === "hold") holdCount++;
+    results.push({ id: q.id, stage: q.stage, status: status2, answer });
+    const icon = status2 === "pass" ? chalk2.green(ko.gate.statusPassLine) : status2 === "hold" ? chalk2.yellow(ko.gate.statusHoldLine) : chalk2.red(ko.gate.statusFailLine);
     console.log(icon);
   }
   console.log(chalk2.bold(`
@@ -1176,7 +1282,7 @@ function extractPageId(url) {
 function getPageTitle(page) {
   for (const prop of Object.values(page.properties)) {
     if (prop.type === "title") {
-      return prop.title.map((t) => t.plain_text).join("");
+      return prop.title.map((t2) => t2.plain_text).join("");
     }
   }
   return "Untitled";
@@ -1206,7 +1312,7 @@ function extractText(block) {
   const type = block.type;
   const data = block[type];
   if (!data?.rich_text) return "";
-  return data.rich_text.map((t) => t.plain_text).join("");
+  return data.rich_text.map((t2) => t2.plain_text).join("");
 }
 function parseBlocks(blocks) {
   const sections = {};
@@ -1298,7 +1404,7 @@ var PROJECT_TYPES = [
   { name: "\u{1F916} \uB178\uC158 \uD1B5\uD569/MCP \uC11C\uBC84", value: "notion" },
   { name: "\u{1F4F1} \uBAA8\uBC14\uC77C \uC571 (Flutter)", value: "mobile" }
 ];
-var VALID_TYPES = PROJECT_TYPES.map((t) => t.value);
+var VALID_TYPES = PROJECT_TYPES.map((t2) => t2.value);
 var STACK_PRESETS = {
   webapp: ["Next.js", "TypeScript", "Tailwind CSS", "shadcn/ui", "Supabase", "Vercel"],
   extension: ["Vite", "TypeScript", "@crxjs/vite-plugin", "Chrome Extension Manifest V3"],
@@ -1621,10 +1727,10 @@ var ADR_RULES = [
     test: (f) => /\.env\.example$|auth\/|middleware\.(ts|js)$/.test(f)
   }
 ];
-function detectAdrCandidates(diff) {
+function detectAdrCandidates(diff2) {
   const candidates = [];
   for (const rule of ADR_RULES) {
-    const matched = diff.files.map((f) => f.file).filter(rule.test);
+    const matched = diff2.files.map((f) => f.file).filter(rule.test);
     if (matched.length > 0) {
       candidates.push({
         title: rule.title,
@@ -1691,23 +1797,23 @@ ${ko.recap.title}
   console.log(chalk5.dim(`${ko.recap.analyzing}
 `));
   const since = options.since || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const diff = await getSessionDiff(since);
+  const diff2 = await getSessionDiff(since);
   const commits = await getRecentCommits(10, since);
-  if (diff.filesChanged === 0 && commits.length === 0) {
+  if (diff2.filesChanged === 0 && commits.length === 0) {
     console.log(chalk5.yellow(ko.recap.noChanges));
     return;
   }
   console.log(chalk5.bold("\u{1F4CA} \uBCC0\uACBD \uC694\uC57D:"));
-  console.log(`  \uD30C\uC77C: ${chalk5.cyan(String(diff.filesChanged))}\uAC1C \uBCC0\uACBD`);
-  console.log(`  \uCD94\uAC00: ${chalk5.green("+" + diff.insertions)} / \uC0AD\uC81C: ${chalk5.red("-" + diff.deletions)}`);
-  if (diff.files.length > 0) {
+  console.log(`  \uD30C\uC77C: ${chalk5.cyan(String(diff2.filesChanged))}\uAC1C \uBCC0\uACBD`);
+  console.log(`  \uCD94\uAC00: ${chalk5.green("+" + diff2.insertions)} / \uC0AD\uC81C: ${chalk5.red("-" + diff2.deletions)}`);
+  if (diff2.files.length > 0) {
     console.log(chalk5.dim("\n  \uBCC0\uACBD \uD30C\uC77C:"));
-    diff.files.slice(0, 15).forEach((f) => {
+    diff2.files.slice(0, 15).forEach((f) => {
       const icon = f.status === "new" ? chalk5.green("\u{1F195}") : f.status === "deleted" ? chalk5.red("\u{1F5D1}\uFE0F") : chalk5.yellow("\u270F\uFE0F");
       console.log(`  ${icon} ${f.file}`);
     });
-    if (diff.files.length > 15) {
-      console.log(chalk5.dim(`  ... \uC678 ${diff.files.length - 15}\uAC1C`));
+    if (diff2.files.length > 15) {
+      console.log(chalk5.dim(`  ... \uC678 ${diff2.files.length - 15}\uAC1C`));
     }
   }
   if (commits.length > 0) {
@@ -1748,7 +1854,7 @@ ${ko.recap.title}
   const sessionNum = existing.length + 1;
   const fileName = `${today}-session-${sessionNum}.md`;
   const filePath = path6.join(logDir, fileName);
-  const fileList = diff.files.map((f) => `| ${f.file} | ${f.status} |`).join("\n");
+  const fileList = diff2.files.map((f) => `| ${f.file} | ${f.status} |`).join("\n");
   const commitList = commits.slice(0, 10).map((c) => `- \`${c.hash.slice(0, 7)}\` ${c.message}`).join("\n");
   const content = [
     `# \uC138\uC158 \uB85C\uADF8 \u2014 ${today} #${sessionNum}`,
@@ -1766,7 +1872,7 @@ ${ko.recap.title}
     answers.blockers,
     "",
     "## \uBCC0\uACBD \uD30C\uC77C",
-    `\uCD1D ${diff.filesChanged}\uAC1C \uD30C\uC77C (+${diff.insertions} -${diff.deletions})`,
+    `\uCD1D ${diff2.filesChanged}\uAC1C \uD30C\uC77C (+${diff2.insertions} -${diff2.deletions})`,
     "",
     "| \uD30C\uC77C | \uC0C1\uD0DC |",
     "|------|------|",
@@ -1779,7 +1885,7 @@ ${ko.recap.title}
     `*Generated by \`vhk recap\` at ${(/* @__PURE__ */ new Date()).toISOString()}*`
   ].join("\n");
   fs5.writeFileSync(filePath, content, "utf-8");
-  const adrCandidates = detectAdrCandidates(diff);
+  const adrCandidates = detectAdrCandidates(diff2);
   if (adrCandidates.length > 0) {
     console.log(chalk5.cyan.bold(`
 ${ko.recap.adrDetected} (${adrCandidates.length}\uAC74)`));
@@ -2732,6 +2838,384 @@ ${ko.ship.title}
   });
 }
 
+// src/commands/save.ts
+import { execFileSync, execSync as execSync2 } from "child_process";
+import chalk11 from "chalk";
+import ora from "ora";
+import inquirer5 from "inquirer";
+function gitOut(args) {
+  return execFileSync("git", args, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+}
+function gitRun(args) {
+  execFileSync("git", args, { stdio: "pipe" });
+}
+function formatDefaultCommitMessage(date = /* @__PURE__ */ new Date()) {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, "0");
+  const d = String(date.getDate()).padStart(2, "0");
+  const h = String(date.getHours()).padStart(2, "0");
+  const min = String(date.getMinutes()).padStart(2, "0");
+  return `\u2728 vhk save: ${y}-${m}-${d} ${h}:${min}`;
+}
+function statusIcon(code) {
+  if (code.includes("M")) return "\u270F\uFE0F";
+  if (code.includes("A") || code.includes("?")) return "\u2795";
+  if (code.includes("D")) return "\u{1F5D1}\uFE0F";
+  return "\u{1F4C4}";
+}
+async function save() {
+  console.log(chalk11.bold(`
+\u{1F4BE} ${t("save.title")}`));
+  console.log(chalk11.gray("\u2500".repeat(40)));
+  try {
+    execSync2("git rev-parse --is-inside-work-tree", { stdio: "pipe" });
+  } catch {
+    console.log(chalk11.red(`\u274C ${t("save.notGitRepo")}`));
+    return;
+  }
+  const status2 = gitOut(["status", "--porcelain"]).trim();
+  if (!status2) {
+    console.log(chalk11.yellow(`\u{1F4ED} ${t("save.noChanges")}`));
+    return;
+  }
+  const files = status2.split("\n").filter(Boolean);
+  console.log(chalk11.cyan(`
+\u{1F4CB} ${t("save.filesHeader", files.length)}`));
+  files.forEach((line) => {
+    const code = line.substring(0, 2);
+    const name = line.substring(3);
+    console.log(`   ${statusIcon(code)} ${name}`);
+  });
+  const { message } = await inquirer5.prompt([{
+    type: "input",
+    name: "message",
+    message: t("save.commitMessage"),
+    default: formatDefaultCommitMessage()
+  }]);
+  const spinner = ora(t("save.saving")).start();
+  try {
+    gitRun(["add", "."]);
+    gitRun(["commit", "-m", message]);
+    spinner.text = t("save.pushing");
+    try {
+      gitRun(["push"]);
+      spinner.succeed(t("save.successWithPush"));
+    } catch {
+      spinner.succeed(t("save.successLocal"));
+      console.log(chalk11.yellow(`   \u{1F4A1} ${t("save.noRemote")}`));
+    }
+    console.log(chalk11.green(`
+\u2705 ${t("save.done", files.length)}`));
+  } catch (err) {
+    spinner.fail(t("save.failed"));
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(chalk11.red(msg));
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/undo.ts
+import { execFileSync as execFileSync2, execSync as execSync3 } from "child_process";
+import chalk12 from "chalk";
+import inquirer6 from "inquirer";
+function gitOut2(args) {
+  return execFileSync2("git", args, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+}
+function gitRun2(args) {
+  execFileSync2("git", args, { stdio: "pipe" });
+}
+function parseRecentCommits(logOutput) {
+  return logOutput.split("\n").map((l) => l.trim()).filter(Boolean);
+}
+function countUnpushedCommits() {
+  try {
+    const out = gitOut2(["rev-list", "--count", "@{u}..HEAD"]).trim();
+    return parseInt(out, 10) || 0;
+  } catch {
+    return -1;
+  }
+}
+function willUndoPushedCommits(undoCount, unpushedCount) {
+  if (unpushedCount < 0) return false;
+  return undoCount > unpushedCount;
+}
+async function undo() {
+  console.log(chalk12.bold(`
+\u23EA ${t("undo.title")}`));
+  console.log(chalk12.gray("\u2500".repeat(40)));
+  try {
+    execSync3("git rev-parse --is-inside-work-tree", { stdio: "pipe" });
+  } catch {
+    console.log(chalk12.red(`\u274C ${t("undo.notGitRepo")}`));
+    return;
+  }
+  let logOutput;
+  try {
+    logOutput = gitOut2(["log", "--oneline", "-5"]).trim();
+  } catch {
+    console.log(chalk12.yellow(`\u{1F4ED} ${t("undo.noCommits")}`));
+    return;
+  }
+  const commits = parseRecentCommits(logOutput);
+  if (commits.length === 0) {
+    console.log(chalk12.yellow(`\u{1F4ED} ${t("undo.noCommits")}`));
+    return;
+  }
+  console.log(chalk12.cyan(`
+${t("undo.recentHeader")}`));
+  commits.forEach((c, i) => {
+    console.log(`   ${i === 0 ? "\u{1F449}" : "  "} ${c}`);
+  });
+  const maxUndo = commits.length;
+  const { count } = await inquirer6.prompt([{
+    type: "number",
+    name: "count",
+    message: t("undo.howMany"),
+    default: 1,
+    min: 1,
+    max: maxUndo
+  }]);
+  const undoCount = Math.min(Math.max(1, count || 1), maxUndo);
+  const unpushed = countUnpushedCommits();
+  if (willUndoPushedCommits(undoCount, unpushed)) {
+    console.log(chalk12.red(`
+\u26A0\uFE0F  ${t("undo.alreadyPushed")}`));
+  }
+  const { confirm } = await inquirer6.prompt([{
+    type: "confirm",
+    name: "confirm",
+    message: t("undo.confirmMessage", undoCount),
+    default: false
+  }]);
+  if (!confirm) {
+    console.log(chalk12.gray(t("undo.cancelled")));
+    return;
+  }
+  try {
+    gitRun2(["reset", "--soft", `HEAD~${undoCount}`]);
+    console.log(chalk12.green(`
+\u2705 ${t("undo.success", undoCount)}`));
+    console.log(chalk12.gray(`   \u{1F4A1} ${t("undo.stagedHint")}`));
+  } catch (err) {
+    console.log(chalk12.red(`\u274C ${t("undo.failed")}`));
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(chalk12.red(msg));
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/diff.ts
+import { execFileSync as execFileSync3, execSync as execSync4 } from "child_process";
+import chalk13 from "chalk";
+function gitOut3(args) {
+  try {
+    return execFileSync3("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 ? chalk13.green(`+${f.additions}`) : "";
+  const dels = f.deletions > 0 ? chalk13.red(`-${f.deletions}`) : "";
+  const change = [adds, dels].filter(Boolean).join(" ");
+  console.log(`   ${f.name} ${change}`);
+}
+async function diff() {
+  console.log(chalk13.bold(`
+\u{1F50D} ${t("diff.title")}`));
+  console.log(chalk13.gray("\u2500".repeat(40)));
+  try {
+    execSync4("git rev-parse --is-inside-work-tree", { stdio: "pipe" });
+  } catch {
+    console.log(chalk13.red(`\u274C ${t("diff.notGitRepo")}`));
+    return;
+  }
+  const unstaged = gitOut3(["diff", "--stat"]);
+  const staged = gitOut3(["diff", "--cached", "--stat"]);
+  const untracked = gitOut3(["ls-files", "--others", "--exclude-standard"]);
+  if (!unstaged && !staged && !untracked) {
+    console.log(chalk13.green(`
+\u2705 ${t("diff.noChanges")}`));
+    return;
+  }
+  if (staged) {
+    console.log(chalk13.cyan(`
+${t("diff.stagedHeader")}`));
+    parseDiffStat(staged).forEach((f) => printFile(f));
+  }
+  if (unstaged) {
+    console.log(chalk13.cyan(`
+${t("diff.unstagedHeader")}`));
+    parseDiffStat(unstaged).forEach((f) => printFile(f));
+  }
+  if (untracked) {
+    const files = untracked.split("\n").filter(Boolean);
+    console.log(chalk13.cyan(`
+${t("diff.untrackedHeader", files.length)}`));
+    files.forEach((f) => console.log(`   ${chalk13.green("+")} ${f}`));
+  }
+  const numstat = gitOut3(["diff", "--numstat", "HEAD"]);
+  if (numstat) {
+    const { fileCount, totalAdd, totalDel } = summarizeNumstat(numstat);
+    console.log(chalk13.cyan(`
+${t("diff.summaryHeader")}`));
+    console.log(`   ${t("diff.filesLine", fileCount)}`);
+    console.log(`   \uCD94\uAC00: ${chalk13.green(`+${totalAdd}`)}\uC904`);
+    console.log(`   \uC0AD\uC81C: ${chalk13.red(`-${totalDel}`)}\uC904`);
+  }
+  console.log("");
+}
+
+// src/commands/status.ts
+import { execFileSync as execFileSync4, execSync as execSync5 } from "child_process";
+import fs13 from "fs";
+import path14 from "path";
+import chalk14 from "chalk";
+function gitOut4(args) {
+  return execFileSync4("git", args, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+}
+function countFileChanges(porcelain) {
+  const lines = porcelain.split("\n").filter(Boolean);
+  let staged = 0;
+  let unstaged = 0;
+  let untracked = 0;
+  for (const line of lines) {
+    const x = line[0];
+    const y = line[1];
+    if (x === "?" && y === "?") {
+      untracked++;
+      continue;
+    }
+    if (x !== " ") staged++;
+    if (y !== " ") unstaged++;
+  }
+  return { staged, unstaged, untracked };
+}
+function parseSyncCounts(revListOutput) {
+  const parts = revListOutput.trim().split(/\s+/);
+  return {
+    ahead: parseInt(parts[0] ?? "0", 10) || 0,
+    behind: parseInt(parts[1] ?? "0", 10) || 0,
+    hasUpstream: true
+  };
+}
+function formatSyncLabel(sync2) {
+  if (!sync2.hasUpstream) return t("status.noUpstream");
+  if (sync2.ahead === 0 && sync2.behind === 0) return t("status.inSync");
+  const parts = [];
+  if (sync2.ahead > 0) parts.push(t("status.ahead", sync2.ahead));
+  if (sync2.behind > 0) parts.push(t("status.behind", sync2.behind));
+  return parts.join(" \xB7 ");
+}
+function parseRecentCommitLines(logOutput) {
+  return logOutput.split("\n").map((l) => l.trim()).filter(Boolean);
+}
+function readProjectPackage(cwd = process.cwd()) {
+  const pkgPath = path14.join(cwd, "package.json");
+  if (!fs13.existsSync(pkgPath)) return null;
+  try {
+    const pkg = JSON.parse(fs13.readFileSync(pkgPath, "utf-8"));
+    if (!pkg.name && !pkg.version) return null;
+    return {
+      name: pkg.name ?? "(no name)",
+      version: pkg.version ?? "(no version)"
+    };
+  } catch {
+    return null;
+  }
+}
+function getSyncCounts() {
+  try {
+    const out = gitOut4(["rev-list", "--left-right", "--count", "HEAD...@{u}"]);
+    return parseSyncCounts(out);
+  } catch {
+    return { ahead: 0, behind: 0, hasUpstream: false };
+  }
+}
+async function status() {
+  console.log(chalk14.bold(`
+\u{1F4CA} ${t("status.title")}`));
+  console.log(chalk14.gray("\u2500".repeat(40)));
+  try {
+    execSync5("git rev-parse --is-inside-work-tree", { stdio: "pipe" });
+  } catch {
+    console.log(chalk14.red(`\u274C ${t("status.notGitRepo")}`));
+    return;
+  }
+  let branch;
+  try {
+    branch = gitOut4(["branch", "--show-current"]).trim() || t("status.detached");
+  } catch {
+    branch = t("status.unknownBranch");
+  }
+  const porcelain = gitOut4(["status", "--porcelain"]).trim();
+  const counts = countFileChanges(porcelain);
+  const sync2 = getSyncCounts();
+  let commits = [];
+  try {
+    commits = parseRecentCommitLines(gitOut4(["log", "--oneline", "-3"]).trim());
+  } catch {
+    commits = [];
+  }
+  const pkg = readProjectPackage();
+  console.log(chalk14.cyan(`
+\u{1F33F} ${t("status.branch")}`) + chalk14.white(` ${branch}`));
+  console.log(
+    chalk14.cyan(`\u{1F4C1} ${t("status.changes")}`) + chalk14.white(
+      ` staged ${counts.staged} \xB7 unstaged ${counts.unstaged} \xB7 untracked ${counts.untracked}`
+    )
+  );
+  console.log(chalk14.cyan(`
+\u{1F4CB} ${t("status.recentCommits")}`));
+  if (commits.length === 0) {
+    console.log(chalk14.dim(`   ${t("status.noCommits")}`));
+  } else {
+    commits.forEach((c) => console.log(`   ${chalk14.dim("\u2022")} ${c}`));
+  }
+  console.log(
+    chalk14.cyan(`
+\u{1F504} ${t("status.remote")}`) + chalk14.white(` ${formatSyncLabel(sync2)}`)
+  );
+  console.log(chalk14.gray("\n" + "\u2500".repeat(40)));
+  if (pkg) {
+    console.log(chalk14.cyan(`\u{1F4E6} ${t("status.package")}`) + chalk14.white(` ${pkg.name} v${pkg.version}`));
+  } else {
+    console.log(chalk14.dim(`\u{1F4E6} ${t("status.noPackage")}`));
+  }
+  console.log("");
+}
+
 // src/index.ts
 var program = new Command();
 var defaultHelp = new Help();
@@ -2743,9 +3227,13 @@ var KO_ALIASES = {
   check: "\uC810\uAC80",
   secure: "\uBCF4\uC548",
   ship: "\uBC30\uD3EC",
-  doctor: "\uD658\uACBD"
+  doctor: "\uD658\uACBD",
+  save: "\uC800\uC7A5",
+  undo: "\uB418\uB3CC\uB9AC\uAE30",
+  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.4.0");
+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.0");
 program.configureHelp({
   formatHelp(cmd, helper) {
     if (cmd.parent) {
@@ -2753,7 +3241,7 @@ program.configureHelp({
     }
     const subs = helper.visibleCommands(cmd).filter((c) => c.name() !== "help");
     const terms = subs.map((c) => `${c.name()} (${KO_ALIASES[c.name()]})`);
-    const termWidth = Math.max(...terms.map((t) => t.length), 0);
+    const termWidth = Math.max(...terms.map((t2) => t2.length), 0);
     const lines = [
       helper.commandDescription(cmd),
       "",
@@ -2775,22 +3263,32 @@ var secureCmd = program.command("secure").alias("\uBCF4\uC548").description("\uB
 secureCmd.command("scan").alias("\uC2A4\uCE94").description("\uC2DC\uD06C\uB9BF/\uD0A4 \uC720\uCD9C \uC2A4\uCE94").action(secure);
 program.command("ship").alias("\uBC30\uD3EC").alias("\uB9B4\uB9AC\uC988").description("\uBC30\uD3EC \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 + \uD68C\uACE0 + \uBE4C\uB4DC \uB85C\uADF8 \uC0DD\uC131").action(ship);
 program.command("doctor").alias("\uD658\uACBD").alias("\uC9C4\uB2E8").description("\uAC1C\uBC1C \uD658\uACBD \uC810\uAC80 \u2014 Node/Git/npm \uC0C1\uD0DC \uD655\uC778").action(doctor);
+program.command("save").alias("\uC800\uC7A5").description("\uBCC0\uACBD\uC0AC\uD56D \uC800\uC7A5 (git add \u2192 commit \u2192 push)").action(async () => {
+  await save();
+});
+program.command("undo").alias("\uB418\uB3CC\uB9AC\uAE30").description("\uCD5C\uADFC \uCEE4\uBC0B \uB418\uB3CC\uB9AC\uAE30").action(async () => {
+  await undo();
+});
+program.command("status").alias("\uC0C1\uD0DC").description("\uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uB300\uC2DC\uBCF4\uB4DC").action(async () => {
+  await status();
+});
+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(chalk11.cyan(`  \u{1F4AC} "${input}"`));
-    console.log(chalk11.cyan(`  \u2192 ${route.explanation}`));
+    console.log(chalk15.cyan(`  \u{1F4AC} "${input}"`));
+    console.log(chalk15.cyan(`  \u2192 ${route.explanation}`));
     if (route.confidence === "low") {
-      const { confirm } = await inquirer5.prompt([{
+      const { confirm } = await inquirer7.prompt([{
         type: "confirm",
         name: "confirm",
         message: `${route.explanation} \u2014 ${ko.nlp.matched}`,
         default: true
       }]);
       if (!confirm) {
-        console.log(chalk11.dim(`  ${ko.nlp.menuHint}`));
+        console.log(chalk15.dim(`  ${ko.nlp.menuHint}`));
         return;
       }
     }
@@ -2815,15 +3313,23 @@ program.on("command:*", async (operands) => {
         return ship();
       case "doctor":
         return doctor();
+      case "save":
+        return save();
+      case "undo":
+        return undo();
+      case "status":
+        return status();
+      case "diff":
+        return diff();
     }
   }
-  console.log(chalk11.yellow(`
+  console.log(chalk15.yellow(`
   \u2753 "${input}" \u2014 ${ko.nlp.notMatched}
 `));
 });
 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 inquirer5.prompt([{
+  const { choice } = await inquirer7.prompt([{
     type: "list",
     name: "choice",
     message: "\uBB58 \uB3C4\uC640\uB4DC\uB9B4\uAE4C\uC694?",
@@ -2835,7 +3341,11 @@ program.action(async () => {
       { 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{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" }
     ]
   }]);
   switch (choice) {
@@ -2855,6 +3365,14 @@ program.action(async () => {
       return doctor();
     case "ship":
       return ship();
+    case "save":
+      return save();
+    case "undo":
+      return undo();
+    case "status":
+      return status();
+    case "diff":
+      return diff();
   }
 });
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byh3071/vhk",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
   "bin": {
     "vhk": "./dist/index.js"
@@ -41,6 +41,7 @@
     "commander": "^14.0.3",
     "handlebars": "^4.7.9",
     "inquirer": "^9.3.8",
+    "ora": "^9.4.0",
     "simple-git": "^3.36.0"
   },
   "devDependencies": {