@byh3071/vhk 0.9.1 → 1.0.1

package/README.md

@@ -1,12 +1,14 @@
 ---
 id: vhk-readme
 date: 2026-05-24
-tags: [vhk, cli, readme, v0.9.0]
+tags: [vhk, cli, readme, v1.0.0, ga]
 ---
 
 # 🔧 VHK — Vibe Harness Kit
 
-> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.9.0)
+> 🎉 **v1.0.0 GA** — 바이브코더의 올인원 CLI. 공개 API 안정성 보장.
+>
+> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v1.0.0)
 >
 > 🍽️ **VHK는 VHK로 부트스트랩됨** — 이 레포의 `docs/`, `CLAUDE.md`, `.cursorrules`도 `vhk init`이 만들었습니다.
 
@@ -100,9 +102,13 @@ vhk 기획 끝났고 바로 시작
 | `vhk theme` | `테마` | 다크/라이트 모드 CSS + 토글 유틸리티 생성 |
 | `vhk ref` | `레퍼런스` | 레퍼런스 URL 관리 (`add` / `list` / `open`) |
 | `vhk harness` | `하네스` | 통합 품질 점검 (lint + type-check + test + build 순차 실행 + 리포트) |
-| `vhk audit` | `감사` | npm 보안 취약점 감사 (`--fix`로 자동 수정) |
+| `vhk audit` | `감사` | npm/pnpm/yarn 보안 취약점 감사 (`--fix`로 자동 수정, npm만) |
 | `vhk migrate [target]` | `전환` | 패키지 매니저 전환 (`npm` / `yarn` / `pnpm`, lockfile + node_modules 재구성) |
 | `vhk update` | `업데이트` | VHK CLI 최신 버전으로 셀프 업데이트 |
+| `vhk context` | `맥락` | 프로젝트 트리·스택·CLI 명령 목록을 `.vhk/context.md`로 자동 생성 (AI 어시스턴트용) |
+| `vhk context-show` | `맥락보기` | 현재 컨텍스트 파일 내용 출력 |
+| `vhk memory` | `기억` | 결정사항 기억 관리 (`add` / `list` / `remove`, `.vhk/memory.json` 기반, 태그 지원) |
+| `vhk brief` | `브리핑` | 프로젝트 정보 + git 상태 + 결정사항 + 레퍼런스 통합 보고서 `.vhk/brief.md` |
 
 ### init 옵션
 
@@ -137,6 +143,45 @@ MCP 서버를 수동으로 띄우려면:
 vhk mcp                # stdio 서버 시작 (Cursor가 자동으로 호출)
 ```
 
+## v1.0.0 GA 하이라이트 🎉
+
+> **공개 API 안정성 약속**. 명령어 이름, CLI 인자, `.vhk/` 파일 포맷은 v2.0까지 breaking change 없음.
+
+| 기능 | 설명 |
+|------|------|
+| **context** | 프로젝트 디렉토리 트리(3-depth) + 기술 스택(Next/Nuxt/Vue/Svelte/TS/Tailwind/tsup/Vite/...) 자동 감지 + 29개+ VHK 명령어 목록을 `.vhk/context.md` 마크다운으로 생성. AI 어시스턴트가 프로젝트 맥락을 즉시 파악 |
+| **memory** | `.vhk/memory.json` 결정사항 기억 관리. `add <content> --tags X,Y` / `list` / `remove <번호>`. NL은 list만 (add/remove는 인자 필수 → commander 전용) |
+| **brief** | 프로젝트 정보 + git 상태(브랜치·마지막 커밋·미커밋 변경) + 최근 결정사항 + 레퍼런스를 한 화면에 + `.vhk/brief.md` 저장. `safeExecFile` 기반 (Windows .cmd shim 안전) |
+| **자연어 확장** | `"맥락 만들어줘"` → context · `"컨텍스트 보여줘"` → context-show · `"기억 목록"` → memory · `"프로젝트 브리핑 만들어줘"` / `"상태 요약"` → brief |
+
+```powershell
+vhk context             # .vhk/context.md (트리 + 스택 + 명령 목록)
+vhk memory add "API는 tRPC 사용" --tags decision,arch
+vhk memory list
+vhk brief               # 콘솔 출력 + .vhk/brief.md
+```
+
+### Cursor 권장 시퀀스 (v1.0 GA)
+
+```text
+vhk init                # 프로젝트 셋업
+vhk design + theme      # 디자인 시스템
+vhk context             # AI 맥락 파일 생성
+... 개발 ...
+vhk memory add "<결정>"  # 결정 누적
+vhk brief               # 세션 종료 시 상태 보고서
+다음 세션 시작: "컨텍스트 보여줘" → 어제 맥락 복원
+```
+
+### v1.0.0 GA 정책
+
+- **공개 API 안정성**: 명령어 이름, CLI 인자, `.vhk/` 파일 포맷은 v2.0까지 breaking change 없음
+- **deprecation 절차**: 명령어/옵션 제거 전 1개 마이너 버전(1.x.0)에서 deprecation 경고
+- **i18n 키**: `ko.ts`의 `t()` 키 이름은 안정. 신규 키 누적, 기존 키 미제거
+- **MCP 서버 도구**: 8개 도구(save/undo/status/diff/ship/doctor/check/recap) 인터페이스 안정
+
+> **`vhk memory` vs Claude Code `auto memory`** — `vhk memory`는 **프로젝트 단위** 결정사항(`.vhk/memory.json`, 팀 공유). Claude Code의 `auto memory`는 **사용자 단위** (`~/.claude/projects/.../memory/`, 개인 컨텍스트). 둘은 별개.
+
 ## v0.9.0 하이라이트
 
 | 기능 | 설명 |
@@ -250,6 +295,10 @@ vhk ref open 1          # 1번 레퍼런스를 브라우저로 열기
 | 보안 감사 해줘 / 취약점 확인 | `vhk audit` |
 | 패키지 매니저 전환 | `vhk migrate` |
 | vhk 업데이트 해줘 | `vhk update` |
+| 맥락 만들어줘 / 컨텍스트 생성 | `vhk context` |
+| 컨텍스트 보여줘 / 맥락 보여줘 | `vhk context-show` |
+| 기억 목록 / 결정사항 확인 | `vhk memory` (list) |
+| 프로젝트 브리핑 / 상태 요약 | `vhk brief` |
 
 ## 특징
 

package/dist/{chunk-UPXCLOBF.js → chunk-SD7O6HO7.js}

@@ -283,6 +283,10 @@ var ko = {
     addTitle: "\uB808\uD37C\uB7F0\uC2A4 \uCD94\uAC00",
     listTitle: "\uB808\uD37C\uB7F0\uC2A4 \uBAA9\uB85D"
   },
+  memory: {
+    addTitle: "\uAE30\uC5B5 \uCD94\uAC00",
+    listTitle: "\uAE30\uC5B5 \uBAA9\uB85D"
+  },
   mcp: {
     initTitle: "Cursor MCP \uC5F0\uB3D9 \uC124\uC815",
     serverStarted: "VHK MCP \uC11C\uBC84 \uC2DC\uC791\uB428"
@@ -323,6 +327,13 @@ var ko = {
   },
   update: {
     title: "VHK CLI \uC5C5\uB370\uC774\uD2B8"
+  },
+  context: {
+    title: "\uD504\uB85C\uC81D\uD2B8 \uCEE8\uD14D\uC2A4\uD2B8 \uC0DD\uC131",
+    showTitle: "\uCEE8\uD14D\uC2A4\uD2B8 \uD30C\uC77C"
+  },
+  brief: {
+    title: "\uD504\uB85C\uC81D\uD2B8 \uBE0C\uB9AC\uD551"
   }
 };
 function lookup(path) {
@@ -444,7 +455,7 @@ async function envCheck() {
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2, appendFileSync as appendFileSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2, appendFileSync as appendFileSync2 } from "fs";
 
 // src/lib/exec.ts
 import { execFileSync } from "child_process";
@@ -490,6 +501,16 @@ function safeExecFileStream(cmd, args) {
   }
 }
 
+// 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/mcp/server.ts
 var SERVER_VERSION = "0.7.1";
 function isGitRepo() {
@@ -571,7 +592,7 @@ function createVhkMcpServer() {
     const lines = [];
     if (existsSync2("package.json")) {
       try {
-        const pkg = JSON.parse(readFileSync2("package.json", "utf-8"));
+        const pkg = readJsonFile("package.json");
         lines.push(`\u{1F4E6} \uD504\uB85C\uC81D\uD2B8: ${pkg.name ?? "(\uC774\uB984 \uC5C6\uC74C)"} v${pkg.version ?? "?"}`);
       } catch {
       }
@@ -656,7 +677,7 @@ function createVhkMcpServer() {
     checks.push(test.ok ? "\u2705 \uD14C\uC2A4\uD2B8 \uD1B5\uACFC" : "\u274C \uD14C\uC2A4\uD2B8 \uC2E4\uD328");
     if (existsSync2("package.json")) {
       try {
-        const pkg = JSON.parse(readFileSync2("package.json", "utf-8"));
+        const pkg = readJsonFile("package.json");
         checks.push(`\u{1F4E6} \uBC84\uC804: ${pkg.version}`);
       } catch {
       }
@@ -733,7 +754,7 @@ ${log.out}` }] };
       if (!existsSync2(".env")) {
         return { content: [{ type: "text", text: "\u26A0\uFE0F  .env \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 .env\uB97C \uB9CC\uB4E4\uC5B4\uC8FC\uC138\uC694." }] };
       }
-      const keys = parseEnvKeys(readFileSync2(".env", "utf-8"));
+      const keys = parseEnvKeys(readFileSync3(".env", "utf-8"));
       if (keys.length === 0) {
         return { content: [{ type: "text", text: "\u{1F4ED} .env\uC5D0 \uD658\uACBD\uBCC0\uC218\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4." }] };
       }
@@ -741,7 +762,7 @@ ${log.out}` }] };
       writeFileSync2(".env.example", exampleContent, "utf-8");
       const gitignoreLines = [];
       if (existsSync2(".gitignore")) {
-        const content = readFileSync2(".gitignore", "utf-8");
+        const content = readFileSync3(".gitignore", "utf-8");
         if (!content.split("\n").some((l) => l.trim() === ".env")) {
           appendFileSync2(".gitignore", "\n.env\n");
           gitignoreLines.push("\u{1F512} .gitignore\uC5D0 .env \uCD94\uAC00\uB428");
@@ -764,8 +785,8 @@ ${log.out}` }] };
       if (!existsSync2(".env.example")) {
         return { content: [{ type: "text", text: "\u26A0\uFE0F  .env.example\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 env \uB3C4\uAD6C\uB97C \uC2E4\uD589\uD558\uC138\uC694." }] };
       }
-      const requiredKeys = parseEnvKeys(readFileSync2(".env.example", "utf-8"));
-      const currentKeys = existsSync2(".env") ? parseEnvKeys(readFileSync2(".env", "utf-8")) : [];
+      const requiredKeys = parseEnvKeys(readFileSync3(".env.example", "utf-8"));
+      const currentKeys = existsSync2(".env") ? parseEnvKeys(readFileSync3(".env", "utf-8")) : [];
       const missing = requiredKeys.filter((k) => !currentKeys.includes(k));
       const extra = currentKeys.filter((k) => !requiredKeys.includes(k));
       const lines = [`\u{1F4CB} \uD544\uC218 \uD658\uACBD\uBCC0\uC218: ${requiredKeys.length}\uAC1C`];
@@ -796,6 +817,7 @@ export {
   ko,
   t,
   printNextStep,
+  readJsonFile,
   safeExecFile,
   safeExecFileStream,
   env,

package/dist/index.js

@@ -6,11 +6,12 @@ import {
   envCheck,
   ko,
   printNextStep,
+  readJsonFile,
   safeExecFile,
   safeExecFileStream,
   startMcpServer,
   t
-} from "./chunk-UPXCLOBF.js";
+} from "./chunk-SD7O6HO7.js";
 
 // node_modules/.pnpm/ignore@7.0.5/node_modules/ignore/index.js
 var require_ignore = __commonJS({
@@ -310,7 +311,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(path16, checkUnignored, mode) {
+      test(path15, checkUnignored, mode) {
         let ignored = false;
         let unignored = false;
         let matchedRule;
@@ -319,7 +320,7 @@ var require_ignore = __commonJS({
           if (unignored === negative && ignored !== unignored || negative && !ignored && !unignored && !checkUnignored) {
             return;
           }
-          const matched = rule[mode].test(path16);
+          const matched = rule[mode].test(path15);
           if (!matched) {
             return;
           }
@@ -340,17 +341,17 @@ var require_ignore = __commonJS({
     var throwError = (message, Ctor) => {
       throw new Ctor(message);
     };
-    var checkPath = (path16, originalPath, doThrow) => {
-      if (!isString(path16)) {
+    var checkPath = (path15, originalPath, doThrow) => {
+      if (!isString(path15)) {
         return doThrow(
           `path must be a string, but got \`${originalPath}\``,
           TypeError
         );
       }
-      if (!path16) {
+      if (!path15) {
         return doThrow(`path must not be empty`, TypeError);
       }
-      if (checkPath.isNotRelative(path16)) {
+      if (checkPath.isNotRelative(path15)) {
         const r = "`path.relative()`d";
         return doThrow(
           `path should be a ${r} string, but got "${originalPath}"`,
@@ -359,7 +360,7 @@ var require_ignore = __commonJS({
       }
       return true;
     };
-    var isNotRelative = (path16) => REGEX_TEST_INVALID_PATH.test(path16);
+    var isNotRelative = (path15) => REGEX_TEST_INVALID_PATH.test(path15);
     checkPath.isNotRelative = isNotRelative;
     checkPath.convert = (p) => p;
     var Ignore = class {
@@ -389,19 +390,19 @@ var require_ignore = __commonJS({
       }
       // @returns {TestResult}
       _test(originalPath, cache, checkUnignored, slices) {
-        const path16 = originalPath && checkPath.convert(originalPath);
+        const path15 = originalPath && checkPath.convert(originalPath);
         checkPath(
-          path16,
+          path15,
           originalPath,
           this._strictPathCheck ? throwError : RETURN_FALSE
         );
-        return this._t(path16, cache, checkUnignored, slices);
+        return this._t(path15, cache, checkUnignored, slices);
       }
-      checkIgnore(path16) {
-        if (!REGEX_TEST_TRAILING_SLASH.test(path16)) {
-          return this.test(path16);
+      checkIgnore(path15) {
+        if (!REGEX_TEST_TRAILING_SLASH.test(path15)) {
+          return this.test(path15);
         }
-        const slices = path16.split(SLASH).filter(Boolean);
+        const slices = path15.split(SLASH).filter(Boolean);
         slices.pop();
         if (slices.length) {
           const parent = this._t(
@@ -414,18 +415,18 @@ var require_ignore = __commonJS({
             return parent;
           }
         }
-        return this._rules.test(path16, false, MODE_CHECK_IGNORE);
+        return this._rules.test(path15, false, MODE_CHECK_IGNORE);
       }
-      _t(path16, cache, checkUnignored, slices) {
-        if (path16 in cache) {
-          return cache[path16];
+      _t(path15, cache, checkUnignored, slices) {
+        if (path15 in cache) {
+          return cache[path15];
         }
         if (!slices) {
-          slices = path16.split(SLASH).filter(Boolean);
+          slices = path15.split(SLASH).filter(Boolean);
         }
         slices.pop();
         if (!slices.length) {
-          return cache[path16] = this._rules.test(path16, checkUnignored, MODE_IGNORE);
+          return cache[path15] = this._rules.test(path15, checkUnignored, MODE_IGNORE);
         }
         const parent = this._t(
           slices.join(SLASH) + SLASH,
@@ -433,29 +434,29 @@ var require_ignore = __commonJS({
           checkUnignored,
           slices
         );
-        return cache[path16] = parent.ignored ? parent : this._rules.test(path16, checkUnignored, MODE_IGNORE);
+        return cache[path15] = parent.ignored ? parent : this._rules.test(path15, checkUnignored, MODE_IGNORE);
       }
-      ignores(path16) {
-        return this._test(path16, this._ignoreCache, false).ignored;
+      ignores(path15) {
+        return this._test(path15, this._ignoreCache, false).ignored;
       }
       createFilter() {
-        return (path16) => !this.ignores(path16);
+        return (path15) => !this.ignores(path15);
       }
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
       // @returns {TestResult}
-      test(path16) {
-        return this._test(path16, this._testCache, true);
+      test(path15) {
+        return this._test(path15, this._testCache, true);
       }
     };
     var factory = (options) => new Ignore(options);
-    var isPathValid = (path16) => checkPath(path16 && checkPath.convert(path16), path16, 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 = (path16) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path16) || isNotRelative(path16);
+      checkPath.isNotRelative = (path15) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path15) || isNotRelative(path15);
     };
     if (
       // Detect `process` so that it can run in browsers.
@@ -473,9 +474,6 @@ var require_ignore = __commonJS({
 // src/index.ts
 import { Command, Help } from "commander";
 import inquirer14 from "inquirer";
-import fs16 from "fs";
-import path15 from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
 
 // src/lib/nlp-router.ts
 function normalize(input) {
@@ -511,7 +509,7 @@ var RULES = [
     command: "init",
     explanation: "\uD504\uB85C\uC81D\uD2B8 \uC2DC\uC791 (vhk \uC2DC\uC791)",
     confidence: "high",
-    test: (t2) => (/프로젝트.*(만들|시작)|폴더.*만들|만들고\s*싶|하네스|초기화/.test(t2) || /^시작$/.test(t2)) && !/디자인|design|팔레트|palette|테마|theme|레퍼런스|reference|다크\s*모드|라이트\s*모드|색상\s*모드/.test(t2)
+    test: (t2) => (/프로젝트.*(만들|시작)|폴더.*만들|만들고\s*싶|하네스|초기화/.test(t2) || /^시작$/.test(t2)) && !/디자인|design|팔레트|palette|테마|theme|레퍼런스|reference|다크\s*모드|라이트\s*모드|색상\s*모드|브리핑|brief|컨텍스트|context|맥락|기억|memory/.test(t2)
   },
   {
     command: "mcp-init",
@@ -567,6 +565,30 @@ var RULES = [
     confidence: "high",
     test: (t2) => /업데이트|update|버전\s*업|최신\s*버전|셀프\s*업데이트|vhk.*최신|vhk.*업데이트/.test(t2)
   },
+  {
+    command: "context-show",
+    explanation: "\uCEE8\uD14D\uC2A4\uD2B8 \uD30C\uC77C \uBCF4\uAE30 (vhk context-show)",
+    confidence: "high",
+    test: (t2) => /맥락\s*(보|확인|보여)|컨텍스트\s*(보|확인|보여)|context\s*show/.test(t2)
+  },
+  {
+    command: "context",
+    explanation: "\uD504\uB85C\uC81D\uD2B8 \uB9E5\uB77D \uC0DD\uC131 (vhk context)",
+    confidence: "high",
+    test: (t2) => /(^맥락$|^컨텍스트$|^context$|맥락\s*(만들|생성|갱신|업데이트)|컨텍스트\s*(만들|생성|갱신|업데이트)|프로젝트\s*맥락|프로젝트\s*정보\s*생성)/.test(t2) && !/보|확인|보여|show/.test(t2)
+  },
+  {
+    command: "memory",
+    explanation: "\uAE30\uC5B5 \uBAA9\uB85D \uC870\uD68C (vhk memory list)",
+    confidence: "high",
+    test: (t2) => /^기억$|기억\s*(목록|보|확인|뭐)|memory.*list|결정사항\s*(목록|확인|보여)/.test(t2) && !/(추가|add|삭제|remove|저장|기록해)/.test(t2)
+  },
+  {
+    command: "brief",
+    explanation: "\uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uC694\uC57D (vhk brief)",
+    confidence: "high",
+    test: (t2) => /브리핑|brief|상태\s*요약|프로젝트\s*요약|요약\s*(보고|리포트|보여|만들)|보고서\s*(만들|생성|보여)/.test(t2)
+  },
   {
     command: "secure",
     explanation: "\uBCF4\uC548 \uC2A4\uCE94 (vhk \uBCF4\uC548)",
@@ -741,6 +763,14 @@ var KNOWN_COMMAND_TOKENS = /* @__PURE__ */ new Set([
   "\uC804\uD658",
   "update",
   "\uC5C5\uB370\uC774\uD2B8",
+  "context",
+  "\uB9E5\uB77D",
+  "context-show",
+  "\uB9E5\uB77D\uBCF4\uAE30",
+  "memory",
+  "\uAE30\uC5B5",
+  "brief",
+  "\uBE0C\uB9AC\uD551",
   "help"
 ]);
 function isOptionToken(token) {
@@ -764,7 +794,7 @@ function detectNaturalLanguageInput(argv) {
 }
 
 // src/lib/nlp-run.ts
-import chalk25 from "chalk";
+import chalk28 from "chalk";
 import inquirer13 from "inquirer";
 
 // src/commands/gate.ts
@@ -1538,7 +1568,7 @@ var VHK_PACKAGE_SCRIPTS = {
 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"));
+  const pkg = readJsonFile(pkgPath);
   pkg.scripts = { ...VHK_PACKAGE_SCRIPTS, ...pkg.scripts };
   fs3.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
   return true;
@@ -1615,19 +1645,27 @@ function buildSessionDiffFromSummary(diffSummary) {
 }
 async function getSessionDiff(since) {
   const sinceDate = since || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-  const diffSummary = await git.diffSummary([`--since=${sinceDate}`]);
-  return buildSessionDiffFromSummary(diffSummary);
+  try {
+    const diffSummary = await git.diffSummary([`--since=${sinceDate}`]);
+    return buildSessionDiffFromSummary(diffSummary);
+  } catch {
+    return { filesChanged: 0, insertions: 0, deletions: 0, files: [] };
+  }
 }
 async function getRecentCommits(count = 10, since) {
   const options = { maxCount: count };
   if (since) options["--since"] = since;
-  const log2 = await git.log(options);
-  return log2.all.map((entry) => ({
-    hash: entry.hash,
-    message: entry.message,
-    date: entry.date,
-    author: entry.author_name
-  }));
+  try {
+    const log2 = await git.log(options);
+    return log2.all.map((entry) => ({
+      hash: entry.hash,
+      message: entry.message,
+      date: entry.date,
+      author: entry.author_name
+    }));
+  } catch {
+    return [];
+  }
 }
 async function isGitRepo() {
   try {
@@ -1637,6 +1675,14 @@ async function isGitRepo() {
     return false;
   }
 }
+async function hasAnyCommits() {
+  try {
+    await git.revparse(["HEAD"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // src/lib/adr.ts
 import fs4 from "fs";
@@ -1690,7 +1736,7 @@ function nextAdrNumber(adrDir) {
 function slugify(title) {
   return title.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9가-힣-]/g, "").slice(0, 40) || "decision";
 }
-function createAdrFile(cwd, title, context, decision, consequences) {
+function createAdrFile(cwd, title, context2, decision, consequences) {
   const adrDir = path5.join(cwd, "docs", "adr");
   if (!fs4.existsSync(adrDir)) fs4.mkdirSync(adrDir, { recursive: true });
   const num = nextAdrNumber(adrDir);
@@ -1708,7 +1754,7 @@ function createAdrFile(cwd, title, context, decision, consequences) {
     `# ADR-${String(num).padStart(3, "0")}: ${title}`,
     "",
     "## \uB9E5\uB77D (Context)",
-    context,
+    context2,
     "",
     "## \uACB0\uC815 (Decision)",
     decision,
@@ -1735,6 +1781,11 @@ ${ko.recap.title}
     console.log(chalk5.red(ko.recap.noRepo));
     return;
   }
+  if (!await hasAnyCommits()) {
+    console.log(chalk5.yellow("\u26A0\uFE0F  \uC544\uC9C1 \uCEE4\uBC0B\uC774 \uC5C6\uC5B4\uC694."));
+    console.log(chalk5.gray("   \uD30C\uC77C\uC744 \uCD94\uAC00\uD558\uACE0 `vhk save` \uB610\uB294 `git commit`\uC73C\uB85C \uCCAB \uCEE4\uBC0B\uC744 \uB9CC\uB4E4\uC5B4 \uBCF4\uC138\uC694."));
+    return;
+  }
   printSecurityWarnings();
   console.log(chalk5.dim(`${ko.recap.analyzing}
 `));
@@ -2596,7 +2647,7 @@ function getVhkVersion() {
   for (const pkgPath of candidates) {
     try {
       if (fs12.existsSync(pkgPath)) {
-        const pkg = JSON.parse(fs12.readFileSync(pkgPath, "utf-8"));
+        const pkg = readJsonFile(pkgPath);
         return pkg.version;
       }
     } catch {
@@ -3136,21 +3187,9 @@ ${t("undo.recentHeader")}`));
 
 // src/commands/status.ts
 import { execFileSync as execFileSync4 } from "child_process";
-import fs15 from "fs";
+import fs14 from "fs";
 import path14 from "path";
 import chalk13 from "chalk";
-
-// src/lib/read-json.ts
-import fs14 from "fs";
-function stripBom(text) {
-  return text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-}
-function readJsonFile(filePath) {
-  const raw = stripBom(fs14.readFileSync(filePath, "utf-8"));
-  return JSON.parse(raw);
-}
-
-// src/commands/status.ts
 function countFileChanges(porcelain) {
   const lines = porcelain.split("\n").filter(Boolean);
   let staged = 0;
@@ -3189,7 +3228,7 @@ function parseRecentCommitLines(logOutput) {
 }
 function readProjectPackage(cwd = process.cwd()) {
   const pkgPath = path14.join(cwd, "package.json");
-  if (!fs15.existsSync(pkgPath)) return null;
+  if (!fs14.existsSync(pkgPath)) return null;
   try {
     const pkg = readJsonFile(pkgPath);
     if (!pkg.name && !pkg.version) return null;
@@ -3358,27 +3397,47 @@ ${t("diff.summaryHeader")}`));
 }
 
 // src/commands/mcp-init.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import chalk15 from "chalk";
-function resolveVhkMcpPath() {
+function resolveMcpEntryPoint() {
+  try {
+    const here = fileURLToPath2(import.meta.url);
+    const dir = dirname(here);
+    for (const rel of [["mcp", "index.js"], ["..", "mcp", "index.js"]]) {
+      const candidate = join(dir, ...rel);
+      if (existsSync(candidate)) return candidate;
+    }
+  } catch {
+  }
+  try {
+    const url = import.meta.resolve?.("@byh3071/vhk/dist/mcp/index.js");
+    if (typeof url === "string") {
+      const p = fileURLToPath2(url);
+      if (existsSync(p)) return p;
+    }
+  } catch {
+  }
   try {
     const pkgPath = join(process.cwd(), "package.json");
     if (existsSync(pkgPath)) {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      const pkg = readJsonFile(pkgPath);
       if (pkg.name === "@byh3071/vhk") {
-        return join(process.cwd(), "dist", "mcp", "index.js");
+        const local = join(process.cwd(), "dist", "mcp", "index.js");
+        if (existsSync(local)) return local;
       }
     }
   } catch {
   }
-  try {
-    const url = import.meta.resolve?.("@byh3071/vhk/dist/mcp/index.js");
-    if (typeof url === "string") return fileURLToPath2(url);
-  } catch {
+  return null;
+}
+function resolveVhkMcpEntry() {
+  const entryPath = resolveMcpEntryPoint();
+  if (entryPath) {
+    return { command: "node", args: [entryPath] };
   }
-  return join(process.cwd(), "node_modules", "@byh3071", "vhk", "dist", "mcp", "index.js");
+  return { command: "vhk-mcp", args: [] };
 }
 async function mcpInit() {
   console.log(chalk15.bold("\n\u{1F50C} " + t("mcp.initTitle")));
@@ -3388,14 +3447,11 @@ async function mcpInit() {
     mkdirSync(cursorDir, { recursive: true });
   }
   const configPath = join(cursorDir, "mcp.json");
-  const vhkEntry = {
-    command: "node",
-    args: [resolveVhkMcpPath()]
-  };
+  const vhkEntry = resolveVhkMcpEntry();
   let config;
   if (existsSync(configPath)) {
     try {
-      const parsed = JSON.parse(readFileSync(configPath, "utf-8"));
+      const parsed = readJsonFile(configPath);
       config = {
         mcpServers: { ...parsed.mcpServers ?? {}, vhk: vhkEntry }
       };
@@ -3518,7 +3574,7 @@ ${t("deploy.deploying")}
 }
 
 // src/commands/publish.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync3, writeFileSync as writeFileSync2 } from "fs";
 import chalk17 from "chalk";
 import inquirer8 from "inquirer";
 import ora2 from "ora";
@@ -3542,7 +3598,7 @@ async function publish() {
   }
   let pkg;
   try {
-    pkg = JSON.parse(readFileSync2("package.json", "utf-8"));
+    pkg = readJsonFile("package.json");
   } catch {
     console.log(chalk17.red("\u274C package.json \uD30C\uC2F1 \uC2E4\uD328"));
     return;
@@ -3867,14 +3923,13 @@ async function theme() {
 }
 
 // src/commands/ref.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "fs";
 import chalk20 from "chalk";
 var REFS_PATH = ".vhk/refs.json";
 function loadRefs() {
   if (!existsSync6(REFS_PATH)) return [];
   try {
-    const raw = readFileSync3(REFS_PATH, "utf-8");
-    const parsed = JSON.parse(raw);
+    const parsed = readJsonFile(REFS_PATH);
     return Array.isArray(parsed) ? parsed : [];
   } catch {
     return [];
@@ -3966,7 +4021,7 @@ async function refOpen(indexStr) {
 }
 
 // src/commands/harness.ts
-import { existsSync as existsSync7, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 import chalk21 from "chalk";
 import ora3 from "ora";
 function detectPM() {
@@ -3981,7 +4036,7 @@ function detectChecks() {
   const checks = [];
   let pkg = {};
   try {
-    pkg = JSON.parse(readFileSync4("package.json", "utf-8"));
+    pkg = readJsonFile("package.json");
   } catch {
     return checks;
   }
@@ -4251,18 +4306,18 @@ async function migrate(target) {
 
 // src/commands/update.ts
 import { execSync as execSync3 } from "child_process";
-import { existsSync as existsSync10, readFileSync as readFileSync5 } from "fs";
-import { dirname, join as join2 } from "path";
+import { existsSync as existsSync10 } from "fs";
+import { dirname as dirname2, join as join2 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import chalk24 from "chalk";
 import ora6 from "ora";
 var PACKAGE = "@byh3071/vhk";
 function getCurrentVersion() {
-  const dir = dirname(fileURLToPath3(import.meta.url));
+  const dir = dirname2(fileURLToPath3(import.meta.url));
   for (const pkgPath of [join2(dir, "../package.json"), join2(dir, "../../package.json")]) {
     try {
       if (existsSync10(pkgPath)) {
-        const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+        const pkg = readJsonFile(pkgPath);
         if (pkg.version) return pkg.version;
       }
     } catch {
@@ -4326,6 +4381,369 @@ async function update() {
   }
 }
 
+// src/commands/context.ts
+import {
+  existsSync as existsSync11,
+  mkdirSync as mkdirSync5,
+  readFileSync as readFileSync2,
+  readdirSync,
+  statSync,
+  writeFileSync as writeFileSync6
+} from "fs";
+import { join as join3 } from "path";
+import chalk25 from "chalk";
+var CONTEXT_PATH = ".vhk/context.md";
+var IGNORE_DIRS2 = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "dist",
+  ".next",
+  ".nuxt",
+  ".output",
+  "coverage",
+  ".cache",
+  ".turbo",
+  ".vhk"
+]);
+function buildTree(dir, prefix = "", maxDepth = 3, depth = 0) {
+  if (depth >= maxDepth) return [];
+  const lines = [];
+  try {
+    const entries = readdirSync(dir);
+    const filtered = entries.filter(
+      (e) => (!e.startsWith(".") || e === ".env.example") && !IGNORE_DIRS2.has(e)
+    );
+    filtered.forEach((entry, index) => {
+      const isLast = index === filtered.length - 1;
+      const connector = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+      const fullPath = join3(dir, entry);
+      const stat = statSync(fullPath);
+      const isDir = stat.isDirectory();
+      lines.push(`${prefix}${connector}${entry}${isDir ? "/" : ""}`);
+      if (isDir) {
+        const nextPrefix = prefix + (isLast ? "    " : "\u2502   ");
+        lines.push(...buildTree(fullPath, nextPrefix, maxDepth, depth + 1));
+      }
+    });
+  } catch {
+  }
+  return lines;
+}
+function extractTechStack() {
+  const stack = {};
+  try {
+    const pkg = readJsonFile("package.json");
+    const all = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+    if (all.next) stack["\uD504\uB808\uC784\uC6CC\uD06C"] = `Next.js ${all.next}`;
+    else if (all.nuxt) stack["\uD504\uB808\uC784\uC6CC\uD06C"] = `Nuxt ${all.nuxt}`;
+    else if (all.react) stack["\uD504\uB808\uC784\uC6CC\uD06C"] = `React ${all.react}`;
+    else if (all.vue) stack["\uD504\uB808\uC784\uC6CC\uD06C"] = `Vue ${all.vue}`;
+    else if (all.svelte) stack["\uD504\uB808\uC784\uC6CC\uD06C"] = `Svelte ${all.svelte}`;
+    if (all.typescript) stack["\uC5B8\uC5B4"] = `TypeScript ${all.typescript}`;
+    if (all.tailwindcss) stack["\uC2A4\uD0C0\uC77C"] = `Tailwind CSS ${all.tailwindcss}`;
+    if (all.tsup) stack["\uBE4C\uB4DC"] = "tsup";
+    else if (all.vite) stack["\uBE4C\uB4DC"] = `Vite ${all.vite}`;
+    else if (all.webpack) stack["\uBE4C\uB4DC"] = "webpack";
+    if (all.vitest) stack["\uD14C\uC2A4\uD2B8"] = "vitest";
+    else if (all.jest) stack["\uD14C\uC2A4\uD2B8"] = "jest";
+    if (all.commander) stack["CLI"] = "commander";
+    if (all.inquirer) stack["\uC778\uD130\uB799\uD2F0\uBE0C"] = "inquirer";
+    if (existsSync11("pnpm-lock.yaml")) stack["\uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800"] = "pnpm";
+    else if (existsSync11("yarn.lock")) stack["\uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800"] = "yarn";
+    else stack["\uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800"] = "npm";
+    if (pkg.name) stack["\uD328\uD0A4\uC9C0 \uC774\uB984"] = pkg.name;
+    if (pkg.version) stack["\uBC84\uC804"] = pkg.version;
+  } catch {
+  }
+  return stack;
+}
+function getVhkCommands() {
+  return [
+    "gate \u2014 \uC544\uC774\uB514\uC5B4 \uAC80\uC99D",
+    "init \u2014 \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654",
+    "recap \u2014 \uC138\uC158 \uC694\uC57D \uC800\uC7A5",
+    "sync \u2014 \uADDC\uCE59 \uD30C\uC77C \uB3D9\uAE30\uD654",
+    "check \u2014 \uADDC\uCE59 \uC810\uAC80",
+    "secure \u2014 \uBCF4\uC548 \uC2A4\uCE94",
+    "ship \u2014 \uBC30\uD3EC \uCCB4\uD06C + \uD68C\uACE0",
+    "doctor \u2014 \uD658\uACBD \uC9C4\uB2E8",
+    "save \u2014 git \uC800\uC7A5 (add+commit+push)",
+    "undo \u2014 \uCD5C\uADFC \uCEE4\uBC0B \uB418\uB3CC\uB9AC\uAE30",
+    "status \u2014 git \uC0C1\uD0DC \uD655\uC778",
+    "diff \u2014 git \uBCC0\uACBD \uC0AC\uD56D \uC694\uC57D",
+    "deploy \u2014 \uD504\uB85C\uB355\uC158 \uBC30\uD3EC",
+    "env \u2014 \uD658\uACBD\uBCC0\uC218 \uAD00\uB9AC",
+    "publish \u2014 npm \uBC30\uD3EC \uC790\uB3D9\uD654",
+    "design \u2014 \uB514\uC790\uC778 \uD1A0\uD070 \uC0DD\uC131",
+    "design-palette \u2014 \uCEEC\uB7EC \uD314\uB808\uD2B8 \uC120\uD0DD",
+    "theme \u2014 \uB2E4\uD06C/\uB77C\uC774\uD2B8 \uBAA8\uB4DC",
+    "ref add|list|open \u2014 \uB808\uD37C\uB7F0\uC2A4 URL \uAD00\uB9AC",
+    "harness \u2014 \uD1B5\uD569 \uD488\uC9C8 \uC810\uAC80",
+    "audit \u2014 \uBCF4\uC548 \uCDE8\uC57D\uC810 \uAC10\uC0AC",
+    "migrate \u2014 \uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800 \uC804\uD658",
+    "update \u2014 VHK CLI \uC140\uD504 \uC5C5\uB370\uC774\uD2B8",
+    "context \u2014 \uD504\uB85C\uC81D\uD2B8 \uB9E5\uB77D \uC0DD\uC131",
+    "context-show \u2014 \uB9E5\uB77D \uD30C\uC77C \uBCF4\uAE30",
+    "memory add|list|remove \u2014 \uACB0\uC815\uC0AC\uD56D \uAE30\uC5B5",
+    "brief \u2014 \uD504\uB85C\uC81D\uD2B8 \uC694\uC57D \uBCF4\uACE0\uC11C",
+    "mcp \u2014 MCP \uC11C\uBC84 \uC2DC\uC791",
+    "mcp-init \u2014 Cursor MCP \uC124\uC815"
+  ];
+}
+async function context() {
+  console.log(chalk25.bold("\n\u{1F9E0} " + t("context.title")));
+  console.log(chalk25.gray("\u2500".repeat(40)));
+  const stack = extractTechStack();
+  const tree = buildTree(".").join("\n");
+  const commands = getVhkCommands();
+  const lines = [];
+  lines.push("# \uD504\uB85C\uC81D\uD2B8 \uCEE8\uD14D\uC2A4\uD2B8");
+  lines.push("");
+  lines.push("> \uC774 \uD30C\uC77C\uC740 `vhk context`\uB85C \uC790\uB3D9 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+  lines.push("> AI \uC5B4\uC2DC\uC2A4\uD134\uD2B8\uC5D0\uAC8C \uD504\uB85C\uC81D\uD2B8 \uB9E5\uB77D\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.");
+  lines.push("");
+  lines.push("## \uAE30\uC220 \uC2A4\uD0DD");
+  lines.push("");
+  for (const [key, value] of Object.entries(stack)) {
+    lines.push(`- **${key}**: ${value}`);
+  }
+  lines.push("");
+  lines.push("## \uB514\uB809\uD1A0\uB9AC \uAD6C\uC870");
+  lines.push("");
+  lines.push("```");
+  lines.push(tree);
+  lines.push("```");
+  lines.push("");
+  lines.push("## VHK CLI \uBA85\uB839\uC5B4");
+  lines.push("");
+  for (const cmd of commands) {
+    lines.push(`- \`vhk ${cmd}\``);
+  }
+  lines.push("");
+  if (existsSync11(".vhk/memory.json")) {
+    try {
+      const memories = readJsonFile(
+        ".vhk/memory.json"
+      );
+      if (Array.isArray(memories) && memories.length > 0) {
+        lines.push("## \uC800\uC7A5\uB41C \uACB0\uC815\uC0AC\uD56D");
+        lines.push("");
+        for (const m of memories) {
+          const date = new Date(m.addedAt).toLocaleDateString("ko-KR");
+          lines.push(`- ${m.content} _(${date})_`);
+        }
+        lines.push("");
+      }
+    } catch {
+    }
+  }
+  lines.push("---");
+  lines.push("");
+  lines.push(`_\uC0DD\uC131: ${(/* @__PURE__ */ new Date()).toLocaleString("ko-KR")}_`);
+  lines.push("");
+  mkdirSync5(".vhk", { recursive: true });
+  writeFileSync6(CONTEXT_PATH, lines.join("\n"), "utf-8");
+  console.log(chalk25.green(`
+\u2705 ${CONTEXT_PATH} \uC0DD\uC131 \uC644\uB8CC!`));
+  console.log(chalk25.gray(`   \uAE30\uC220 \uC2A4\uD0DD ${Object.keys(stack).length}\uAC1C \uAC10\uC9C0`));
+  console.log(chalk25.gray("   AI \uC5B4\uC2DC\uC2A4\uD134\uD2B8\uC5D0\uAC8C \uC774 \uD30C\uC77C\uC744 \uCC38\uC870\uD558\uAC8C \uD558\uC138\uC694."));
+  printNextStep({
+    message: "\uCEE8\uD14D\uC2A4\uD2B8 \uD30C\uC77C \uC0DD\uC131 \uC644\uB8CC!",
+    command: "vhk context-show",
+    cursorHint: "\uCEE8\uD14D\uC2A4\uD2B8 \uBCF4\uC5EC\uC918"
+  });
+}
+async function contextShow() {
+  console.log(chalk25.bold("\n\u{1F4C4} " + t("context.showTitle")));
+  console.log(chalk25.gray("\u2500".repeat(40)));
+  if (!existsSync11(CONTEXT_PATH)) {
+    console.log(chalk25.yellow("\n\u26A0\uFE0F  \uCEE8\uD14D\uC2A4\uD2B8 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk25.gray("   vhk context\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694."));
+    return;
+  }
+  const content = readFileSync2(CONTEXT_PATH, "utf-8");
+  console.log("\n" + content);
+}
+
+// src/commands/memory.ts
+import { existsSync as existsSync12, mkdirSync as mkdirSync6, writeFileSync as writeFileSync7 } from "fs";
+import chalk26 from "chalk";
+var MEMORY_PATH = ".vhk/memory.json";
+function loadMemories() {
+  if (!existsSync12(MEMORY_PATH)) return [];
+  try {
+    const parsed = readJsonFile(MEMORY_PATH);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
+}
+function saveMemories(memories) {
+  mkdirSync6(".vhk", { recursive: true });
+  writeFileSync7(MEMORY_PATH, JSON.stringify(memories, null, 2) + "\n", "utf-8");
+}
+async function memoryAdd(content, tags) {
+  console.log(chalk26.bold("\n\u{1F9E0} " + t("memory.addTitle")));
+  console.log(chalk26.gray("\u2500".repeat(40)));
+  if (!content) {
+    console.log(chalk26.red("\u274C \uAE30\uC5B5\uD560 \uB0B4\uC6A9\uC744 \uC785\uB825\uD574\uC8FC\uC138\uC694."));
+    console.log(chalk26.gray('   \uC608: vhk memory add "API\uB294 tRPC \uC0AC\uC6A9\uD558\uAE30\uB85C \uACB0\uC815"'));
+    return;
+  }
+  const memories = loadMemories();
+  memories.push({
+    content,
+    addedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    tags: tags && tags.length > 0 ? tags : []
+  });
+  saveMemories(memories);
+  console.log(chalk26.green(`
+\u2705 \uAE30\uC5B5 \uC800\uC7A5\uB428 (#${memories.length})`));
+  console.log(chalk26.cyan(`   \u{1F4DD} ${content}`));
+  printNextStep({
+    message: "\uAE30\uC5B5 \uC800\uC7A5 \uC644\uB8CC!",
+    command: "vhk memory list",
+    cursorHint: "\uAE30\uC5B5 \uBAA9\uB85D \uBCF4\uC5EC\uC918"
+  });
+}
+async function memoryList() {
+  console.log(chalk26.bold("\n\u{1F9E0} " + t("memory.listTitle")));
+  console.log(chalk26.gray("\u2500".repeat(40)));
+  const memories = loadMemories();
+  if (memories.length === 0) {
+    console.log(chalk26.yellow("\n\u{1F4ED} \uC800\uC7A5\uB41C \uAE30\uC5B5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk26.gray('   vhk memory add "\uB0B4\uC6A9"\uC73C\uB85C \uCD94\uAC00\uD558\uC138\uC694.'));
+    return;
+  }
+  console.log(chalk26.cyan(`
+\uCD1D ${memories.length}\uAC1C\uC758 \uAE30\uC5B5:
+`));
+  memories.forEach((m, index) => {
+    const date = new Date(m.addedAt).toLocaleDateString("ko-KR");
+    console.log(chalk26.white(`  [${index + 1}] ${m.content}`));
+    if (m.tags && m.tags.length > 0) {
+      console.log(chalk26.blue(`      \u{1F3F7}\uFE0F  ${m.tags.join(", ")}`));
+    }
+    console.log(chalk26.gray(`      \u{1F4C5} ${date}`));
+    console.log("");
+  });
+}
+async function memoryRemove(indexStr) {
+  const memories = loadMemories();
+  const idx = parseInt(indexStr, 10) - 1;
+  if (Number.isNaN(idx) || idx < 0 || idx >= memories.length) {
+    console.log(chalk26.red(`\u274C \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uBC88\uD638\uC785\uB2C8\uB2E4. (1~${memories.length || 0})`));
+    return;
+  }
+  const removed = memories.splice(idx, 1)[0];
+  saveMemories(memories);
+  console.log(chalk26.green("\n\u2705 \uAE30\uC5B5 \uC0AD\uC81C\uB428:"));
+  console.log(chalk26.gray(`   ${removed.content}`));
+}
+
+// src/commands/brief.ts
+import { existsSync as existsSync13, mkdirSync as mkdirSync7, writeFileSync as writeFileSync8 } from "fs";
+import chalk27 from "chalk";
+var BRIEF_PATH = ".vhk/brief.md";
+function git2(args) {
+  const result = safeExecFile("git", args);
+  return result.ok ? result.out : "";
+}
+async function brief() {
+  console.log(chalk27.bold("\n\u{1F4CB} " + t("brief.title")));
+  console.log(chalk27.gray("\u2500".repeat(40)));
+  const lines = [];
+  lines.push("# \uD504\uB85C\uC81D\uD2B8 \uBE0C\uB9AC\uD551");
+  lines.push("");
+  lines.push(`> \uC0DD\uC131: ${(/* @__PURE__ */ new Date()).toLocaleString("ko-KR")}`);
+  lines.push("");
+  try {
+    const pkg = readJsonFile("package.json");
+    lines.push("## \uD504\uB85C\uC81D\uD2B8 \uC815\uBCF4");
+    lines.push("");
+    lines.push(`- **\uC774\uB984**: ${pkg.name ?? "\uBBF8\uC815"}`);
+    lines.push(`- **\uBC84\uC804**: ${pkg.version ?? "\uBBF8\uC815"}`);
+    lines.push(`- **\uC124\uBA85**: ${pkg.description ?? "\uC5C6\uC74C"}`);
+    const deps = Object.keys(pkg.dependencies ?? {}).length;
+    const devDeps = Object.keys(pkg.devDependencies ?? {}).length;
+    lines.push(`- **\uC758\uC874\uC131**: ${deps}\uAC1C (dev: ${devDeps}\uAC1C)`);
+    lines.push("");
+  } catch {
+    lines.push("## \uD504\uB85C\uC81D\uD2B8 \uC815\uBCF4");
+    lines.push("");
+    lines.push("\u26A0\uFE0F package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+    lines.push("");
+  }
+  const branch = git2(["branch", "--show-current"]);
+  const lastCommit = git2(["log", "-1", "--pretty=format:%h %s (%cr)"]);
+  const uncommitted = git2(["status", "--porcelain"]);
+  const totalCommits = git2(["rev-list", "--count", "HEAD"]);
+  lines.push("## Git \uC0C1\uD0DC");
+  lines.push("");
+  lines.push(`- **\uD604\uC7AC \uBE0C\uB79C\uCE58**: ${branch || "\uC54C \uC218 \uC5C6\uC74C"}`);
+  lines.push(`- **\uB9C8\uC9C0\uB9C9 \uCEE4\uBC0B**: ${lastCommit || "\uC5C6\uC74C"}`);
+  lines.push(`- **\uCD1D \uCEE4\uBC0B \uC218**: ${totalCommits || "\uC54C \uC218 \uC5C6\uC74C"}`);
+  lines.push(
+    `- **\uBBF8\uCEE4\uBC0B \uBCC0\uACBD**: ${uncommitted ? `${uncommitted.split("\n").length}\uAC1C \uD30C\uC77C` : "\uC5C6\uC74C \u2705"}`
+  );
+  lines.push("");
+  if (existsSync13(".vhk/memory.json")) {
+    try {
+      const memories = readJsonFile(".vhk/memory.json");
+      if (Array.isArray(memories) && memories.length > 0) {
+        lines.push(`## \uC800\uC7A5\uB41C \uACB0\uC815\uC0AC\uD56D (${memories.length}\uAC1C)`);
+        lines.push("");
+        for (const m of memories.slice(-5)) {
+          lines.push(`- ${m.content}`);
+        }
+        if (memories.length > 5) {
+          lines.push(`- ... \uC678 ${memories.length - 5}\uAC1C`);
+        }
+        lines.push("");
+      }
+    } catch {
+    }
+  }
+  if (existsSync13(".vhk/refs.json")) {
+    try {
+      const refs = readJsonFile(".vhk/refs.json");
+      if (Array.isArray(refs) && refs.length > 0) {
+        lines.push(`## \uB808\uD37C\uB7F0\uC2A4 (${refs.length}\uAC1C)`);
+        lines.push("");
+        for (const r of refs.slice(-3)) {
+          const label = r.memo && r.memo.length > 0 ? r.memo : r.url;
+          lines.push(`- [${label}](${r.url})`);
+        }
+        lines.push("");
+      }
+    } catch {
+    }
+  }
+  lines.push("## \uB2E4\uC74C \uB2E8\uACC4 \uC81C\uC548");
+  lines.push("");
+  const steps = [];
+  if (uncommitted) steps.push("\uBBF8\uCEE4\uBC0B \uBCC0\uACBD \uC0AC\uD56D\uC744 \uCEE4\uBC0B\uD558\uC138\uC694: `vhk save`");
+  steps.push("\uD488\uC9C8 \uC810\uAC80 \uC2E4\uD589: `vhk harness`");
+  steps.push("\uBCF4\uC548 \uAC10\uC0AC: `vhk audit`");
+  steps.push("\uCEE8\uD14D\uC2A4\uD2B8 \uAC31\uC2E0: `vhk context`");
+  steps.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("_VHK CLI \uBE0C\uB9AC\uD551_");
+  lines.push("");
+  mkdirSync7(".vhk", { recursive: true });
+  writeFileSync8(BRIEF_PATH, lines.join("\n"), "utf-8");
+  console.log("\n" + lines.join("\n"));
+  console.log(chalk27.green(`
+\u2705 ${BRIEF_PATH} \uC800\uC7A5 \uC644\uB8CC`));
+  printNextStep({
+    message: "\uBE0C\uB9AC\uD551 \uC0DD\uC131 \uC644\uB8CC!",
+    command: "vhk context",
+    cursorHint: "\uCEE8\uD14D\uC2A4\uD2B8 \uC5C5\uB370\uC774\uD2B8\uD574\uC918"
+  });
+}
+
 // src/lib/nlp-run.ts
 async function dispatchNlpRoute(route, input) {
   switch (route.command) {
@@ -4382,19 +4800,27 @@ async function dispatchNlpRoute(route, input) {
       return migrate();
     case "update":
       return update();
+    case "context":
+      return context();
+    case "context-show":
+      return contextShow();
+    case "memory":
+      return memoryList();
+    case "brief":
+      return brief();
   }
 }
 async function runNaturalLanguageRoute(input) {
   const route = routeNaturalLanguage(input);
   if (!route) {
-    console.log(chalk25.yellow(`
+    console.log(chalk28.yellow(`
   \u2753 "${input}" \u2014 ${ko.nlp.notMatched}
 `));
     return;
   }
   console.log("");
-  console.log(chalk25.cyan(`  \u{1F4AC} "${input}"`));
-  console.log(chalk25.cyan(`  \u2192 ${route.explanation}`));
+  console.log(chalk28.cyan(`  \u{1F4AC} "${input}"`));
+  console.log(chalk28.cyan(`  \u2192 ${route.explanation}`));
   if (route.confidence === "low") {
     const { confirm } = await inquirer13.prompt([{
       type: "confirm",
@@ -4403,7 +4829,7 @@ async function runNaturalLanguageRoute(input) {
       default: true
     }]);
     if (!confirm) {
-      console.log(chalk25.dim(`  ${ko.nlp.menuHint}`));
+      console.log(chalk28.dim(`  ${ko.nlp.menuHint}`));
       return;
     }
   }
@@ -4411,13 +4837,19 @@ async function runNaturalLanguageRoute(input) {
   await dispatchNlpRoute(route, input);
 }
 
-// src/index.ts
-function getVersion() {
-  const dir = path15.dirname(fileURLToPath4(import.meta.url));
-  for (const pkgPath of [path15.join(dir, "../package.json"), path15.join(dir, "../../package.json")]) {
+// src/lib/version.ts
+import { existsSync as existsSync14 } from "fs";
+import { dirname as dirname3, join as join4 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+function getVhkVersion2() {
+  const dir = dirname3(fileURLToPath4(import.meta.url));
+  for (const pkgPath of [
+    join4(dir, "../../package.json"),
+    join4(dir, "../package.json")
+  ]) {
     try {
-      if (fs16.existsSync(pkgPath)) {
-        const pkg = JSON.parse(fs16.readFileSync(pkgPath, "utf-8"));
+      if (existsSync14(pkgPath)) {
+        const pkg = readJsonFile(pkgPath);
         if (pkg.version) return pkg.version;
       }
     } catch {
@@ -4426,6 +4858,8 @@ function getVersion() {
   }
   return "0.0.0";
 }
+
+// src/index.ts
 var program = new Command();
 var defaultHelp = new Help();
 var KO_ALIASES = {
@@ -4452,9 +4886,13 @@ var KO_ALIASES = {
   harness: "\uD558\uB124\uC2A4",
   audit: "\uAC10\uC0AC",
   migrate: "\uC804\uD658",
-  update: "\uC5C5\uB370\uC774\uD2B8"
+  update: "\uC5C5\uB370\uC774\uD2B8",
+  context: "\uB9E5\uB77D",
+  "context-show": "\uB9E5\uB77D\uBCF4\uAE30",
+  memory: "\uAE30\uC5B5",
+  brief: "\uBE0C\uB9AC\uD551"
 };
-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(getVersion());
+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(getVhkVersion2());
 program.configureHelp({
   formatHelp(cmd, helper) {
     if (cmd.parent) {
@@ -4548,6 +4986,28 @@ program.command("migrate [target]").alias("\uC804\uD658").description("\uD328\uD
 program.command("update").alias("\uC5C5\uB370\uC774\uD2B8").description("VHK CLI \uCD5C\uC2E0 \uBC84\uC804 \uC5C5\uB370\uC774\uD2B8").action(async () => {
   await update();
 });
+program.command("context").alias("\uB9E5\uB77D").description("\uD504\uB85C\uC81D\uD2B8 \uB9E5\uB77D \uD30C\uC77C \uC0DD\uC131 (.vhk/context.md)").action(async () => {
+  await context();
+});
+program.command("context-show").alias("\uB9E5\uB77D\uBCF4\uAE30").description("\uD604\uC7AC \uCEE8\uD14D\uC2A4\uD2B8 \uD30C\uC77C \uB0B4\uC6A9 \uCD9C\uB825").action(async () => {
+  await contextShow();
+});
+var memoryCmd = program.command("memory").alias("\uAE30\uC5B5").description("\uACB0\uC815\uC0AC\uD56D \uAE30\uC5B5 \uAD00\uB9AC (add / list / remove)").action(async () => {
+  await memoryList();
+});
+memoryCmd.command("add <content>").option("--tags <tags>", "\uD0DC\uADF8 (\uC27C\uD45C \uAD6C\uBD84)").description("\uACB0\uC815\uC0AC\uD56D \uAE30\uC5B5 \uC800\uC7A5").action(async (content, opts) => {
+  const tags = opts.tags ? opts.tags.split(",").map((s) => s.trim()) : void 0;
+  await memoryAdd(content, tags);
+});
+memoryCmd.command("list").alias("\uBAA9\uB85D").description("\uC800\uC7A5\uB41C \uAE30\uC5B5 \uBAA9\uB85D").action(async () => {
+  await memoryList();
+});
+memoryCmd.command("remove <index>").alias("\uC0AD\uC81C").description("\uAE30\uC5B5 \uC0AD\uC81C (1\uBD80\uD130 \uC2DC\uC791\uD558\uB294 \uBC88\uD638)").action(async (index) => {
+  await memoryRemove(index);
+});
+program.command("brief").alias("\uBE0C\uB9AC\uD551").description("\uD504\uB85C\uC81D\uD2B8 \uC0C1\uD0DC \uC694\uC57D \uBCF4\uACE0\uC11C \uC0DD\uC131 (.vhk/brief.md)").action(async () => {
+  await brief();
+});
 program.on("command:*", async (operands) => {
   const unknown = operands[0] ?? "";
   const rest = operands.slice(1);

package/dist/mcp/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   startMcpServer
-} from "../chunk-UPXCLOBF.js";
+} from "../chunk-SD7O6HO7.js";
 
 // src/mcp/index.ts
 startMcpServer().catch((err) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byh3071/vhk",
-  "version": "0.9.1",
+  "version": "1.0.1",
   "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
   "bin": {
     "vhk": "dist/index.js",