@byh3071/vhk 0.7.1 → 0.8.1

package/README.md

@@ -1,12 +1,12 @@
 ---
 id: vhk-readme
 date: 2026-05-24
-tags: [vhk, cli, readme, v0.6.0]
+tags: [vhk, cli, readme, v0.8.0]
 ---
 
 # 🔧 VHK — Vibe Harness Kit
 
-> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.6.0)
+> AI 코딩 에이전트를 부리는 사람을 위한 **한국어 풀사이클 CLI** (v0.8.0)
 >
 > 🍽️ **VHK는 VHK로 부트스트랩됨** — 이 레포의 `docs/`, `CLAUDE.md`, `.cursorrules`도 `vhk init`이 만들었습니다.
 
@@ -95,6 +95,10 @@ vhk 기획 끝났고 바로 시작
 | `vhk env` | `환경변수` | `.env` → `.env.example` 동기화 + `.gitignore`에 `.env` 자동 추가 |
 | `vhk env-check` | `환경변수점검` | `.env.example` 기준 누락 환경변수 검사 |
 | `vhk publish` | `출시` | npm 배포 자동화 (버전 범프 → 빌드 → 테스트 → publish → git tag) |
+| `vhk design` | `디자인` | 디자인 토큰 생성 (Tailwind config 또는 CSS 변수) |
+| `vhk design-palette` | `팔레트` | 컬러 팔레트 프리셋 선택 + 적용 |
+| `vhk theme` | `테마` | 다크/라이트 모드 CSS + 토글 유틸리티 생성 |
+| `vhk ref` | `레퍼런스` | 레퍼런스 URL 관리 (`add` / `list` / `open`) |
 
 ### init 옵션
 
@@ -129,6 +133,31 @@ MCP 서버를 수동으로 띄우려면:
 vhk mcp                # stdio 서버 시작 (Cursor가 자동으로 호출)
 ```
 
+## v0.8.0 하이라이트
+
+| 기능 | 설명 |
+|------|------|
+| **design** | 팔레트 프리셋 4종(Minimal/Vibrant/Corporate/Pastel) 선택 → `src/styles/tokens.css` 또는 `src/styles/vhk-colors.ts` (Tailwind config가 있으면 TS) 생성 |
+| **theme** | `src/styles/theme.css` (다크/라이트 + `prefers-color-scheme` + `data-theme` 셀렉터) + `src/lib/theme-toggle.ts` (`getTheme`/`setTheme`/`toggleTheme`/`initTheme`) 생성 |
+| **ref** | `.vhk/refs.json` 기반 레퍼런스 URL 관리. `ref add <url> --memo "..."` / `ref list` / `ref open <번호>` (Windows/macOS/Linux 브라우저 자동 오픈) |
+| **자연어 확장** | `"디자인 토큰 만들어줘"` / `"팔레트 골라줘"` / `"다크 모드 적용"` / `"레퍼런스 보여줘"` 인식. `ref add`/`open`은 인자 추출 인프라가 없어 의도적으로 NL 배제 — commander 서브커맨드만 사용 |
+
+```powershell
+vhk design              # 팔레트 선택 → src/styles/tokens.css 또는 vhk-colors.ts
+vhk theme               # src/styles/theme.css + src/lib/theme-toggle.ts
+vhk ref add https://example.com --memo "참고 사이트"
+vhk ref list            # 저장된 레퍼런스 목록
+vhk ref open 1          # 1번 레퍼런스를 브라우저로 열기
+```
+
+## v0.7.0 하이라이트
+
+| 기능 | 설명 |
+|------|------|
+| **deploy** | Vercel / Netlify / Cloudflare Workers 자동 감지 + 프로덕션 배포 |
+| **env / env-check** | `.env` → `.env.example` 동기화 + 누락 환경변수 검사. MCP 도구로도 노출 (v0.7.1) |
+| **publish** | semver 범프 + 빌드 + 테스트 + `npm publish` + git tag 자동화 |
+
 ## v0.6.0 하이라이트
 
 | 기능 | 설명 |
@@ -191,6 +220,10 @@ vhk mcp                # stdio 서버 시작 (Cursor가 자동으로 호출)
 | 보안 스캔 돌려 | `vhk 보안` |
 | 배포하고 싶어 | `vhk 배포` |
 | 뭔가 안 돼 | `vhk doctor` |
+| 디자인 토큰 만들어줘 | `vhk design` |
+| 팔레트 골라줘 | `vhk design-palette` |
+| 다크 모드 적용 | `vhk theme` |
+| 레퍼런스 보여줘 | `vhk ref` (list) |
 
 ## 특징
 

package/dist/{chunk-3HHU7V77.js → chunk-X3CIIDO2.js}

@@ -272,6 +272,17 @@ var ko = {
     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."
   },
+  design: {
+    title: "\uB514\uC790\uC778 \uD1A0\uD070 \uC0DD\uC131",
+    selectPalette: "\uCEEC\uB7EC \uD314\uB808\uD2B8\uB97C \uC120\uD0DD\uD558\uC138\uC694:"
+  },
+  theme: {
+    title: "\uD14C\uB9C8 \uC124\uC815 (\uB2E4\uD06C/\uB77C\uC774\uD2B8 \uBAA8\uB4DC)"
+  },
+  ref: {
+    addTitle: "\uB808\uD37C\uB7F0\uC2A4 \uCD94\uAC00",
+    listTitle: "\uB808\uD37C\uB7F0\uC2A4 \uBAA9\uB85D"
+  },
   mcp: {
     initTitle: "Cursor MCP \uC5F0\uB3D9 \uC124\uC815",
     serverStarted: "VHK MCP \uC11C\uBC84 \uC2DC\uC791\uB428"
@@ -431,9 +442,16 @@ function platformCmd(cmd) {
   }
   return cmd;
 }
+function resolveCmd(cmd, args) {
+  if (process.platform === "win32" && SHIM_BINARIES.has(cmd)) {
+    return { bin: "cmd.exe", argv: ["/d", "/s", "/c", `${cmd}.cmd`, ...args] };
+  }
+  return { bin: platformCmd(cmd), argv: args };
+}
 function safeExecFile(cmd, args) {
+  const { bin, argv } = resolveCmd(cmd, args);
   try {
-    const out = execFileSync(platformCmd(cmd), args, {
+    const out = execFileSync(bin, argv, {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     }).toString();
@@ -444,8 +462,9 @@ function safeExecFile(cmd, args) {
   }
 }
 function safeExecFileStream(cmd, args) {
+  const { bin, argv } = resolveCmd(cmd, args);
   try {
-    execFileSync(platformCmd(cmd), args, {
+    execFileSync(bin, argv, {
       encoding: "utf-8",
       stdio: "inherit"
     });

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   safeExecFileStream,
   startMcpServer,
   t
-} from "./chunk-3HHU7V77.js";
+} from "./chunk-X3CIIDO2.js";
 
 // node_modules/.pnpm/ignore@7.0.5/node_modules/ignore/index.js
 var require_ignore = __commonJS({
@@ -310,7 +310,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(path15, checkUnignored, mode) {
+      test(path16, checkUnignored, mode) {
         let ignored = false;
         let unignored = false;
         let matchedRule;
@@ -319,7 +319,7 @@ var require_ignore = __commonJS({
           if (unignored === negative && ignored !== unignored || negative && !ignored && !unignored && !checkUnignored) {
             return;
           }
-          const matched = rule[mode].test(path15);
+          const matched = rule[mode].test(path16);
           if (!matched) {
             return;
           }
@@ -340,17 +340,17 @@ var require_ignore = __commonJS({
     var throwError = (message, Ctor) => {
       throw new Ctor(message);
     };
-    var checkPath = (path15, originalPath, doThrow) => {
-      if (!isString(path15)) {
+    var checkPath = (path16, originalPath, doThrow) => {
+      if (!isString(path16)) {
         return doThrow(
           `path must be a string, but got \`${originalPath}\``,
           TypeError
         );
       }
-      if (!path15) {
+      if (!path16) {
         return doThrow(`path must not be empty`, TypeError);
       }
-      if (checkPath.isNotRelative(path15)) {
+      if (checkPath.isNotRelative(path16)) {
         const r = "`path.relative()`d";
         return doThrow(
           `path should be a ${r} string, but got "${originalPath}"`,
@@ -359,7 +359,7 @@ var require_ignore = __commonJS({
       }
       return true;
     };
-    var isNotRelative = (path15) => REGEX_TEST_INVALID_PATH.test(path15);
+    var isNotRelative = (path16) => REGEX_TEST_INVALID_PATH.test(path16);
     checkPath.isNotRelative = isNotRelative;
     checkPath.convert = (p) => p;
     var Ignore = class {
@@ -389,19 +389,19 @@ var require_ignore = __commonJS({
       }
       // @returns {TestResult}
       _test(originalPath, cache, checkUnignored, slices) {
-        const path15 = originalPath && checkPath.convert(originalPath);
+        const path16 = originalPath && checkPath.convert(originalPath);
         checkPath(
-          path15,
+          path16,
           originalPath,
           this._strictPathCheck ? throwError : RETURN_FALSE
         );
-        return this._t(path15, cache, checkUnignored, slices);
+        return this._t(path16, cache, checkUnignored, slices);
       }
-      checkIgnore(path15) {
-        if (!REGEX_TEST_TRAILING_SLASH.test(path15)) {
-          return this.test(path15);
+      checkIgnore(path16) {
+        if (!REGEX_TEST_TRAILING_SLASH.test(path16)) {
+          return this.test(path16);
         }
-        const slices = path15.split(SLASH).filter(Boolean);
+        const slices = path16.split(SLASH).filter(Boolean);
         slices.pop();
         if (slices.length) {
           const parent = this._t(
@@ -414,18 +414,18 @@ var require_ignore = __commonJS({
             return parent;
           }
         }
-        return this._rules.test(path15, false, MODE_CHECK_IGNORE);
+        return this._rules.test(path16, false, MODE_CHECK_IGNORE);
       }
-      _t(path15, cache, checkUnignored, slices) {
-        if (path15 in cache) {
-          return cache[path15];
+      _t(path16, cache, checkUnignored, slices) {
+        if (path16 in cache) {
+          return cache[path16];
         }
         if (!slices) {
-          slices = path15.split(SLASH).filter(Boolean);
+          slices = path16.split(SLASH).filter(Boolean);
         }
         slices.pop();
         if (!slices.length) {
-          return cache[path15] = this._rules.test(path15, checkUnignored, MODE_IGNORE);
+          return cache[path16] = this._rules.test(path16, checkUnignored, MODE_IGNORE);
         }
         const parent = this._t(
           slices.join(SLASH) + SLASH,
@@ -433,29 +433,29 @@ var require_ignore = __commonJS({
           checkUnignored,
           slices
         );
-        return cache[path15] = parent.ignored ? parent : this._rules.test(path15, checkUnignored, MODE_IGNORE);
+        return cache[path16] = parent.ignored ? parent : this._rules.test(path16, checkUnignored, MODE_IGNORE);
       }
-      ignores(path15) {
-        return this._test(path15, this._ignoreCache, false).ignored;
+      ignores(path16) {
+        return this._test(path16, this._ignoreCache, false).ignored;
       }
       createFilter() {
-        return (path15) => !this.ignores(path15);
+        return (path16) => !this.ignores(path16);
       }
       filter(paths) {
         return makeArray(paths).filter(this.createFilter());
       }
       // @returns {TestResult}
-      test(path15) {
-        return this._test(path15, this._testCache, true);
+      test(path16) {
+        return this._test(path16, this._testCache, true);
       }
     };
     var factory = (options) => new Ignore(options);
-    var isPathValid = (path15) => checkPath(path15 && checkPath.convert(path15), path15, RETURN_FALSE);
+    var isPathValid = (path16) => checkPath(path16 && checkPath.convert(path16), path16, 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 = (path15) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path15) || isNotRelative(path15);
+      checkPath.isNotRelative = (path16) => REGEX_TEST_WINDOWS_PATH_ABSOLUTE.test(path16) || isNotRelative(path16);
     };
     if (
       // Detect `process` so that it can run in browsers.
@@ -472,7 +472,10 @@ var require_ignore = __commonJS({
 
 // src/index.ts
 import { Command, Help } from "commander";
-import inquirer10 from "inquirer";
+import inquirer12 from "inquirer";
+import fs16 from "fs";
+import path15 from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/lib/nlp-router.ts
 function normalize(input) {
@@ -508,7 +511,7 @@ var RULES = [
     command: "init",
     explanation: "\uD504\uB85C\uC81D\uD2B8 \uC2DC\uC791 (vhk \uC2DC\uC791)",
     confidence: "high",
-    test: (t2) => /프로젝트.*(만들|시작)|폴더.*만들|만들고\s*싶|하네스|초기화/.test(t2) || /^시작$/.test(t2)
+    test: (t2) => (/프로젝트.*(만들|시작)|폴더.*만들|만들고\s*싶|하네스|초기화/.test(t2) || /^시작$/.test(t2)) && !/디자인|design|팔레트|palette|테마|theme|레퍼런스|reference|다크\s*모드|라이트\s*모드|색상\s*모드/.test(t2)
   },
   {
     command: "mcp-init",
@@ -516,6 +519,30 @@ var RULES = [
     confidence: "high",
     test: (t2) => /mcp.*(설정|연동|초기|init)|커서.*(연동|설정|mcp)|cursor.*mcp/.test(t2)
   },
+  {
+    command: "design-palette",
+    explanation: "\uCEEC\uB7EC \uD314\uB808\uD2B8 \uC120\uD0DD (vhk design-palette)",
+    confidence: "high",
+    test: (t2) => /팔레트|palette|컬러\s*(고|선택|바꿔|변경)|색상\s*(고|선택|변경)|색깔\s*선택/.test(t2)
+  },
+  {
+    command: "design",
+    explanation: "\uB514\uC790\uC778 \uD1A0\uD070 \uC0DD\uC131 (vhk design)",
+    confidence: "high",
+    test: (t2) => /디자인\s*(토큰|시스템|만들|생성|셋업|설정)|design\s*(token|system|setup)|토큰\s*만들|css\s*변수.*만들|tailwind\s*(컬러|설정)/.test(t2) && !/배포|deploy|vercel|netlify|cloudflare|wrangler|출시|publish|npm/.test(t2)
+  },
+  {
+    command: "theme",
+    explanation: "\uB2E4\uD06C/\uB77C\uC774\uD2B8 \uD14C\uB9C8 \uC801\uC6A9 (vhk theme)",
+    confidence: "high",
+    test: (t2) => /테마(?!\s*(파일|이름))|theme|다크\s*모드|라이트\s*모드|dark\s*mode|light\s*mode|색상\s*모드|모드\s*전환/.test(t2) && !/보안|시크릿|비밀|키\s*유출|secure|scan|스캔|배포|deploy/.test(t2)
+  },
+  {
+    command: "ref",
+    explanation: "\uB808\uD37C\uB7F0\uC2A4 \uBAA9\uB85D (vhk ref list)",
+    confidence: "high",
+    test: (t2) => /^레퍼런스$|^ref$|레퍼런스.*(보|목록|확인|있|뭐)|참고\s*(사이트|목록|링크)|reference.*list/.test(t2) && !/(add|추가|open|열|https?:\/\/)/.test(t2)
+  },
   {
     command: "secure",
     explanation: "\uBCF4\uC548 \uC2A4\uCE94 (vhk \uBCF4\uC548)",
@@ -674,6 +701,14 @@ var KNOWN_COMMAND_TOKENS = /* @__PURE__ */ new Set([
   "publish",
   "\uCD9C\uC2DC",
   "\uCD9C\uD558",
+  "design",
+  "\uB514\uC790\uC778",
+  "design-palette",
+  "\uD314\uB808\uD2B8",
+  "theme",
+  "\uD14C\uB9C8",
+  "ref",
+  "\uB808\uD37C\uB7F0\uC2A4",
   "help"
 ]);
 function isOptionToken(token) {
@@ -697,8 +732,8 @@ function detectNaturalLanguageInput(argv) {
 }
 
 // src/lib/nlp-run.ts
-import chalk18 from "chalk";
-import inquirer9 from "inquirer";
+import chalk21 from "chalk";
+import inquirer11 from "inquirer";
 
 // src/commands/gate.ts
 import inquirer from "inquirer";
@@ -3535,17 +3570,21 @@ async function publish() {
     console.log(chalk17.gray("\uCDE8\uC18C\uB428. \uBC84\uC804\uC774 \uC6D0\uB798\uB300\uB85C \uBCF5\uAD6C\uB429\uB2C8\uB2E4."));
     return;
   }
-  const pubSpinner = ora2(t("publish.publishing")).start();
-  const pubResult = safeExecFile("npm", ["publish", "--access", "public"]);
+  console.log(chalk17.cyan(`
+\u{1F4E4} ${t("publish.publishing")}`));
+  console.log(chalk17.gray("   2FA \uD65C\uC131\uD654 \uC2DC: OTP 6\uC790\uB9AC \uC785\uB825 \uB610\uB294 \uBE0C\uB77C\uC6B0\uC800 \uC778\uC99D URL \uD074\uB9AD (Windows Hello / PIN \uC9C0\uC6D0)"));
+  const pubResult = safeExecFileStream("npm", ["publish", "--access", "public"]);
   if (!pubResult.ok) {
-    pubSpinner.fail(t("publish.publishFailed"));
+    console.log(chalk17.red(`
+\u2716 ${t("publish.publishFailed")}`));
     console.log(chalk17.red(pubResult.err.slice(0, 500)));
     pkg.version = currentVersion;
     writeFileSync2("package.json", JSON.stringify(pkg, null, 2) + "\n", "utf-8");
     console.log(chalk17.gray(`\u{1F4E6} package.json \uBC84\uC804\uC744 v${currentVersion}\uB85C \uBCF5\uAD6C\uD588\uC2B5\uB2C8\uB2E4.`));
     return;
   }
-  pubSpinner.succeed(t("publish.publishSuccess"));
+  console.log(chalk17.green(`
+\u2714 ${t("publish.publishSuccess")}`));
   const addResult = safeExecFile("git", ["add", "package.json"]);
   if (addResult.ok) {
     safeExecFile("git", ["commit", "-m", `chore: release v${newVersion}`]);
@@ -3571,6 +3610,329 @@ async function publish() {
   });
 }
 
+// src/commands/design.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
+import chalk18 from "chalk";
+import inquirer9 from "inquirer";
+var PALETTES = [
+  {
+    name: "Minimal",
+    colors: {
+      primary: "#1a1a1a",
+      secondary: "#6b7280",
+      accent: "#3b82f6",
+      background: "#ffffff",
+      surface: "#f9fafb",
+      text: "#111827",
+      muted: "#9ca3af"
+    }
+  },
+  {
+    name: "Vibrant",
+    colors: {
+      primary: "#7c3aed",
+      secondary: "#ec4899",
+      accent: "#f59e0b",
+      background: "#ffffff",
+      surface: "#faf5ff",
+      text: "#1e1b4b",
+      muted: "#8b5cf6"
+    }
+  },
+  {
+    name: "Corporate",
+    colors: {
+      primary: "#1e40af",
+      secondary: "#0f766e",
+      accent: "#ca8a04",
+      background: "#ffffff",
+      surface: "#f0f9ff",
+      text: "#0f172a",
+      muted: "#64748b"
+    }
+  },
+  {
+    name: "Pastel",
+    colors: {
+      primary: "#a78bfa",
+      secondary: "#f9a8d4",
+      accent: "#fcd34d",
+      background: "#fffbeb",
+      surface: "#fef3c7",
+      text: "#44403c",
+      muted: "#a8a29e"
+    }
+  }
+];
+function hasTailwind() {
+  return existsSync4("tailwind.config.js") || existsSync4("tailwind.config.ts") || existsSync4("tailwind.config.mjs") || existsSync4("tailwind.config.cjs");
+}
+function generateCSSTokens(palette) {
+  const lines = Object.entries(palette.colors).map(([key, value]) => `  --color-${key}: ${value};`).join("\n");
+  return `:root {
+${lines}
+}
+`;
+}
+function generateTailwindExtend(palette) {
+  const entries = Object.entries(palette.colors).map(([key, value]) => `  '${key}': '${value}',`).join("\n");
+  return `// vhk design \u2014 Tailwind config \uD655\uC7A5\uC6A9 \uCEEC\uB7EC \uD1A0\uD070
+// tailwind.config\uC758 theme.extend.colors\uC5D0 spread \uD558\uC138\uC694.
+const vhkColors = {
+${entries}
+}
+
+export default vhkColors
+`;
+}
+async function design() {
+  console.log(chalk18.bold("\n\u{1F3A8} " + t("design.title")));
+  console.log(chalk18.gray("\u2500".repeat(40)));
+  const { paletteIndex } = await inquirer9.prompt([
+    {
+      type: "list",
+      name: "paletteIndex",
+      message: t("design.selectPalette"),
+      choices: PALETTES.map((p, i) => ({
+        name: `${p.name} \u2014 primary ${p.colors.primary}`,
+        value: i
+      }))
+    }
+  ]);
+  const palette = PALETTES[paletteIndex];
+  console.log(chalk18.cyan(`
+\u{1F3A8} \uC120\uD0DD\uB41C \uD314\uB808\uD2B8: ${palette.name}`));
+  const targetPath = hasTailwind() ? "src/styles/vhk-colors.ts" : "src/styles/tokens.css";
+  const content = hasTailwind() ? generateTailwindExtend(palette) : generateCSSTokens(palette);
+  if (existsSync4(targetPath)) {
+    const { overwrite } = await inquirer9.prompt([{
+      type: "confirm",
+      name: "overwrite",
+      message: `${targetPath} \uC774\uBBF8 \uC788\uC5B4\uC694. \uB36E\uC5B4\uC4F8\uAE4C\uC694?`,
+      default: false
+    }]);
+    if (!overwrite) {
+      console.log(chalk18.yellow("\n\u23ED\uFE0F  \uC0DD\uC131 \uCDE8\uC18C \u2014 \uAE30\uC874 \uD30C\uC77C \uC720\uC9C0."));
+      return;
+    }
+  }
+  mkdirSync2("src/styles", { recursive: true });
+  writeFileSync3(targetPath, content, "utf-8");
+  if (hasTailwind()) {
+    console.log(chalk18.green("\n\u2705 src/styles/vhk-colors.ts \uC0DD\uC131"));
+    console.log(chalk18.gray("   tailwind.config\uC758 extend.colors\uC5D0 import \uD574\uC11C \uC0AC\uC6A9\uD558\uC138\uC694."));
+  } else {
+    console.log(chalk18.green("\n\u2705 src/styles/tokens.css \uC0DD\uC131"));
+    console.log(chalk18.gray("   HTML\uC5D0 <link>\uB85C \uCD94\uAC00\uD558\uAC70\uB098 CSS\uC5D0\uC11C @import \uD558\uC138\uC694."));
+  }
+  console.log(chalk18.bold("\n\u{1F308} \uCEEC\uB7EC \uBBF8\uB9AC\uBCF4\uAE30:"));
+  for (const [key, value] of Object.entries(palette.colors)) {
+    console.log(`   ${key.padEnd(12)} ${value}`);
+  }
+  printNextStep({
+    message: "\uB514\uC790\uC778 \uD1A0\uD070 \uC0DD\uC131 \uC644\uB8CC!",
+    command: "vhk theme",
+    cursorHint: "\uD14C\uB9C8 \uC124\uC815\uD574\uC918"
+  });
+}
+async function designPalette() {
+  await design();
+}
+
+// src/commands/theme.ts
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
+import chalk19 from "chalk";
+import inquirer10 from "inquirer";
+function generateDarkCSS() {
+  return `/* vhk theme \u2014 \uB2E4\uD06C/\uB77C\uC774\uD2B8 \uBAA8\uB4DC CSS \uBCC0\uC218 */
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --color-background: #0f172a;
+    --color-surface: #1e293b;
+    --color-text: #f1f5f9;
+    --color-muted: #64748b;
+  }
+}
+
+[data-theme="dark"] {
+  --color-background: #0f172a;
+  --color-surface: #1e293b;
+  --color-text: #f1f5f9;
+  --color-muted: #64748b;
+}
+
+[data-theme="light"] {
+  --color-background: #ffffff;
+  --color-surface: #f9fafb;
+  --color-text: #111827;
+  --color-muted: #9ca3af;
+}
+`;
+}
+function generateToggleUtil() {
+  return `// vhk theme \u2014 \uB2E4\uD06C/\uB77C\uC774\uD2B8 \uBAA8\uB4DC \uD1A0\uAE00 \uC720\uD2F8\uB9AC\uD2F0
+
+export function getTheme(): 'light' | 'dark' {
+  if (typeof window === 'undefined') return 'light'
+  const stored = localStorage.getItem('vhk-theme') as 'light' | 'dark' | null
+  if (stored === 'light' || stored === 'dark') return stored
+  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'
+}
+
+export function setTheme(theme: 'light' | 'dark'): void {
+  if (typeof document === 'undefined') return
+  document.documentElement.setAttribute('data-theme', theme)
+  localStorage.setItem('vhk-theme', theme)
+}
+
+export function toggleTheme(): 'light' | 'dark' {
+  const next = getTheme() === 'light' ? 'dark' : 'light'
+  setTheme(next)
+  return next
+}
+
+export function initTheme(): void {
+  setTheme(getTheme())
+}
+`;
+}
+async function theme() {
+  console.log(chalk19.bold("\n\u{1F319} " + t("theme.title")));
+  console.log(chalk19.gray("\u2500".repeat(40)));
+  const cssPath = "src/styles/theme.css";
+  const togglePath = "src/lib/theme-toggle.ts";
+  const conflicts = [cssPath, togglePath].filter((p) => existsSync5(p));
+  if (conflicts.length > 0) {
+    const { overwrite } = await inquirer10.prompt([{
+      type: "confirm",
+      name: "overwrite",
+      message: `\uB2E4\uC74C \uD30C\uC77C\uC774 \uC774\uBBF8 \uC788\uC5B4\uC694. \uB36E\uC5B4\uC4F8\uAE4C\uC694?
+   ${conflicts.join("\n   ")}`,
+      default: false
+    }]);
+    if (!overwrite) {
+      console.log(chalk19.yellow("\n\u23ED\uFE0F  \uC0DD\uC131 \uCDE8\uC18C \u2014 \uAE30\uC874 \uD30C\uC77C \uC720\uC9C0."));
+      return;
+    }
+  }
+  mkdirSync3("src/styles", { recursive: true });
+  mkdirSync3("src/lib", { recursive: true });
+  writeFileSync4(cssPath, generateDarkCSS(), "utf-8");
+  console.log(chalk19.green("\n\u2705 src/styles/theme.css \uC0DD\uC131 (\uB2E4\uD06C/\uB77C\uC774\uD2B8 \uBAA8\uB4DC)"));
+  writeFileSync4(togglePath, generateToggleUtil(), "utf-8");
+  console.log(chalk19.green("\u2705 src/lib/theme-toggle.ts \uC0DD\uC131 (\uD1A0\uAE00 \uC720\uD2F8\uB9AC\uD2F0)"));
+  console.log(chalk19.bold("\n\u{1F4D6} \uC0AC\uC6A9\uBC95:"));
+  console.log(chalk19.gray("   1. theme.css\uB97C \uAE00\uB85C\uBC8C \uC2A4\uD0C0\uC77C\uC5D0 \uCD94\uAC00"));
+  console.log(chalk19.gray('   2. import { initTheme, toggleTheme } from "./lib/theme-toggle"'));
+  console.log(chalk19.gray("   3. \uC571 \uC9C4\uC785\uC810\uC5D0\uC11C initTheme() \uD638\uCD9C"));
+  console.log(chalk19.gray("   4. \uD1A0\uAE00 \uBC84\uD2BC\uC5D0\uC11C toggleTheme() \uD638\uCD9C"));
+  printNextStep({
+    message: "\uD14C\uB9C8 \uC124\uC815 \uC644\uB8CC!",
+    command: "vhk ref list",
+    cursorHint: "\uB808\uD37C\uB7F0\uC2A4 \uD655\uC778\uD574\uC918"
+  });
+}
+
+// src/commands/ref.ts
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync3, 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);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch {
+    return [];
+  }
+}
+function saveRefs(refs) {
+  mkdirSync4(".vhk", { recursive: true });
+  writeFileSync5(REFS_PATH, JSON.stringify(refs, null, 2) + "\n", "utf-8");
+}
+async function refAdd(url, memo = "") {
+  console.log(chalk20.bold("\n\u{1F517} " + t("ref.addTitle")));
+  console.log(chalk20.gray("\u2500".repeat(40)));
+  if (!url) {
+    console.log(chalk20.red("\u274C URL\uC744 \uC785\uB825\uD574\uC8FC\uC138\uC694."));
+    console.log(chalk20.gray('   \uC608: vhk ref add https://example.com --memo "\uCC38\uACE0 \uC0AC\uC774\uD2B8"'));
+    return;
+  }
+  const refs = loadRefs();
+  if (refs.some((r) => r.url === url)) {
+    console.log(chalk20.yellow("\u26A0\uFE0F  \uC774\uBBF8 \uC800\uC7A5\uB41C URL\uC785\uB2C8\uB2E4."));
+    return;
+  }
+  refs.push({ url, memo, addedAt: (/* @__PURE__ */ new Date()).toISOString() });
+  saveRefs(refs);
+  console.log(chalk20.green(`
+\u2705 \uB808\uD37C\uB7F0\uC2A4 \uCD94\uAC00\uB428 (#${refs.length})`));
+  console.log(chalk20.cyan(`   ${url}`));
+  if (memo) console.log(chalk20.gray(`   \u{1F4DD} ${memo}`));
+  printNextStep({
+    message: "\uB808\uD37C\uB7F0\uC2A4 \uC800\uC7A5 \uC644\uB8CC!",
+    command: "vhk ref list",
+    cursorHint: "\uB808\uD37C\uB7F0\uC2A4 \uBAA9\uB85D \uBCF4\uC5EC\uC918"
+  });
+}
+async function refList() {
+  console.log(chalk20.bold("\n\u{1F4DA} " + t("ref.listTitle")));
+  console.log(chalk20.gray("\u2500".repeat(40)));
+  const refs = loadRefs();
+  if (refs.length === 0) {
+    console.log(chalk20.yellow("\n\u{1F4ED} \uC800\uC7A5\uB41C \uB808\uD37C\uB7F0\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk20.gray('   vhk ref add <url> --memo "\uBA54\uBAA8"\uB85C \uCD94\uAC00\uD558\uC138\uC694.'));
+    return;
+  }
+  console.log(chalk20.cyan(`
+\uCD1D ${refs.length}\uAC1C\uC758 \uB808\uD37C\uB7F0\uC2A4:
+`));
+  refs.forEach((ref, index) => {
+    const date = new Date(ref.addedAt).toLocaleDateString("ko-KR");
+    console.log(chalk20.white(`  [${index + 1}] ${ref.url}`));
+    if (ref.memo) console.log(chalk20.gray(`      \u{1F4DD} ${ref.memo}`));
+    console.log(chalk20.gray(`      \u{1F4C5} ${date}`));
+    console.log("");
+  });
+}
+async function refOpen(indexStr) {
+  const refs = loadRefs();
+  const idx = parseInt(indexStr, 10) - 1;
+  if (Number.isNaN(idx) || idx < 0 || idx >= refs.length) {
+    console.log(chalk20.red(`\u274C \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uBC88\uD638\uC785\uB2C8\uB2E4. (1~${refs.length || 0})`));
+    return;
+  }
+  const ref = refs[idx];
+  let parsed;
+  try {
+    parsed = new URL(ref.url);
+  } catch {
+    console.log(chalk20.red(`\u274C \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 URL: ${ref.url}`));
+    return;
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    console.log(chalk20.red(`\u274C http(s) URL\uB9CC \uC5F4 \uC218 \uC788\uC2B5\uB2C8\uB2E4 (${parsed.protocol})`));
+    return;
+  }
+  console.log(chalk20.cyan(`
+\u{1F310} \uC5F4\uAE30: ${ref.url}`));
+  let result;
+  if (process.platform === "darwin") {
+    result = safeExecFile("open", [ref.url]);
+  } else if (process.platform === "win32") {
+    result = safeExecFile("cmd.exe", ["/c", "start", "", ref.url]);
+  } else {
+    result = safeExecFile("xdg-open", [ref.url]);
+  }
+  if (result.ok) {
+    console.log(chalk20.green("\u2705 \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uC5F4\uC5C8\uC2B5\uB2C8\uB2E4."));
+  } else {
+    console.log(chalk20.yellow("\u26A0\uFE0F  \uBE0C\uB77C\uC6B0\uC800\uB97C \uC5F4 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. URL\uC744 \uC9C1\uC811 \uBC29\uBB38\uD574\uC8FC\uC138\uC694."));
+  }
+}
+
 // src/lib/nlp-run.ts
 async function dispatchNlpRoute(route, input) {
   switch (route.command) {
@@ -3611,28 +3973,36 @@ async function dispatchNlpRoute(route, input) {
       return envCheck();
     case "publish":
       return publish();
+    case "design":
+      return design();
+    case "design-palette":
+      return designPalette();
+    case "theme":
+      return theme();
+    case "ref":
+      return refList();
   }
 }
 async function runNaturalLanguageRoute(input) {
   const route = routeNaturalLanguage(input);
   if (!route) {
-    console.log(chalk18.yellow(`
+    console.log(chalk21.yellow(`
   \u2753 "${input}" \u2014 ${ko.nlp.notMatched}
 `));
     return;
   }
   console.log("");
-  console.log(chalk18.cyan(`  \u{1F4AC} "${input}"`));
-  console.log(chalk18.cyan(`  \u2192 ${route.explanation}`));
+  console.log(chalk21.cyan(`  \u{1F4AC} "${input}"`));
+  console.log(chalk21.cyan(`  \u2192 ${route.explanation}`));
   if (route.confidence === "low") {
-    const { confirm } = await inquirer9.prompt([{
+    const { confirm } = await inquirer11.prompt([{
       type: "confirm",
       name: "confirm",
       message: `${route.explanation} \u2014 ${ko.nlp.matched}`,
       default: true
     }]);
     if (!confirm) {
-      console.log(chalk18.dim(`  ${ko.nlp.menuHint}`));
+      console.log(chalk21.dim(`  ${ko.nlp.menuHint}`));
       return;
     }
   }
@@ -3641,6 +4011,20 @@ async function runNaturalLanguageRoute(input) {
 }
 
 // src/index.ts
+function getVersion() {
+  const dir = path15.dirname(fileURLToPath3(import.meta.url));
+  for (const pkgPath of [path15.join(dir, "../package.json"), path15.join(dir, "../../package.json")]) {
+    try {
+      if (fs16.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs16.readFileSync(pkgPath, "utf-8"));
+        if (pkg.version) return pkg.version;
+      }
+    } catch {
+      continue;
+    }
+  }
+  return "0.0.0";
+}
 var program = new Command();
 var defaultHelp = new Help();
 var KO_ALIASES = {
@@ -3659,9 +4043,13 @@ var KO_ALIASES = {
   deploy: "\uBC30\uD3EC",
   env: "\uD658\uACBD\uBCC0\uC218",
   "env-check": "\uD658\uACBD\uBCC0\uC218\uC810\uAC80",
-  publish: "\uCD9C\uC2DC"
+  publish: "\uCD9C\uC2DC",
+  design: "\uB514\uC790\uC778",
+  "design-palette": "\uD314\uB808\uD2B8",
+  theme: "\uD14C\uB9C8",
+  ref: "\uB808\uD37C\uB7F0\uC2A4"
 };
-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.7.1");
+program.name("vhk").description("VHK \u2014 \uBC14\uC774\uBE0C\uCF54\uB529 \uD504\uB85C\uC81D\uD2B8 \uCF54\uCE58 (\uD55C\uAD6D\uC5B4\uB85C \uC548\uB0B4\uD569\uB2C8\uB2E4)").version(getVersion());
 program.configureHelp({
   formatHelp(cmd, helper) {
     if (cmd.parent) {
@@ -3722,6 +4110,27 @@ program.command("env-check").alias("\uD658\uACBD\uBCC0\uC218\uC810\uAC80").descr
 program.command("publish").alias("\uCD9C\uC2DC").description("npm \uBC30\uD3EC (\uBC84\uC804 \uBC94\uD504 \u2192 \uBE4C\uB4DC \u2192 \uD14C\uC2A4\uD2B8 \u2192 publish)").action(async () => {
   await publish();
 });
+program.command("design").alias("\uB514\uC790\uC778").description("\uB514\uC790\uC778 \uD1A0\uD070 \uC0DD\uC131 (Tailwind config \uB610\uB294 CSS \uBCC0\uC218)").action(async () => {
+  await design();
+});
+program.command("design-palette").alias("\uD314\uB808\uD2B8").description("\uCEEC\uB7EC \uD314\uB808\uD2B8 \uD504\uB9AC\uC14B \uC120\uD0DD + \uC801\uC6A9").action(async () => {
+  await designPalette();
+});
+program.command("theme").alias("\uD14C\uB9C8").description("\uB2E4\uD06C/\uB77C\uC774\uD2B8 \uBAA8\uB4DC CSS + \uD1A0\uAE00 \uC720\uD2F8\uB9AC\uD2F0 \uC0DD\uC131").action(async () => {
+  await theme();
+});
+var refCmd = program.command("ref").alias("\uB808\uD37C\uB7F0\uC2A4").description("\uB808\uD37C\uB7F0\uC2A4 URL \uAD00\uB9AC (add / list / open)").action(async () => {
+  await refList();
+});
+refCmd.command("add <url>").option("--memo <memo>", "\uBA54\uBAA8 \uCD94\uAC00").description("\uB808\uD37C\uB7F0\uC2A4 URL \uCD94\uAC00").action(async (url, opts) => {
+  await refAdd(url, opts.memo);
+});
+refCmd.command("list").alias("\uBAA9\uB85D").description("\uC800\uC7A5\uB41C \uB808\uD37C\uB7F0\uC2A4 \uBAA9\uB85D").action(async () => {
+  await refList();
+});
+refCmd.command("open <index>").alias("\uC5F4\uAE30").description("\uB808\uD37C\uB7F0\uC2A4\uB97C \uBE0C\uB77C\uC6B0\uC800\uC5D0\uC11C \uC5F4\uAE30").action(async (index) => {
+  await refOpen(index);
+});
 program.on("command:*", async (operands) => {
   const unknown = operands[0] ?? "";
   const rest = operands.slice(1);
@@ -3730,7 +4139,7 @@ program.on("command:*", async (operands) => {
 });
 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 inquirer10.prompt([{
+  const { choice } = await inquirer12.prompt([{
     type: "list",
     name: "choice",
     message: "\uBB58 \uB3C4\uC640\uB4DC\uB9B4\uAE4C\uC694?",

package/dist/mcp/index.js

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

package/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "@byh3071/vhk",
-  "version": "0.7.1",
-  "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
-  "bin": {
-    "vhk": "dist/index.js",
-    "vhk-mcp": "dist/mcp/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": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@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",
-    "zod": "^4.4.3"
-  },
-  "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.8.1",
+  "description": "Vibe Harness Kit — 바이브코딩 풀사이클 CLI",
+  "bin": {
+    "vhk": "dist/index.js",
+    "vhk-mcp": "dist/mcp/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": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@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",
+    "zod": "^4.4.3"
+  },
+  "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"
+  }
+}