@byh3071/vhk 0.7.1 → 0.8.0

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-NQ4V3VN4.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"

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   safeExecFileStream,
   startMcpServer,
   t
-} from "./chunk-3HHU7V77.js";
+} from "./chunk-NQ4V3VN4.js";
 
 // node_modules/.pnpm/ignore@7.0.5/node_modules/ignore/index.js
 var require_ignore = __commonJS({
@@ -472,7 +472,7 @@ var require_ignore = __commonJS({
 
 // src/index.ts
 import { Command, Help } from "commander";
-import inquirer10 from "inquirer";
+import inquirer12 from "inquirer";
 
 // src/lib/nlp-router.ts
 function normalize(input) {
@@ -516,6 +516,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)
+  },
+  {
+    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)
+  },
+  {
+    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 +698,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 +729,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";
@@ -3571,6 +3603,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 +3966,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;
     }
   }
@@ -3659,9 +4022,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("0.8.0");
 program.configureHelp({
   formatHelp(cmd, helper) {
     if (cmd.parent) {
@@ -3722,6 +4089,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 +4118,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-NQ4V3VN4.js";
 
 // src/mcp/index.ts
 startMcpServer().catch((err) => {

package/package.json

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