@byh3071/vhk 1.8.1 → 2.0.1

package/dist/index.js

@@ -43,13 +43,13 @@ import {
   stripBom,
   sync,
   t
-} from "./chunk-RXDOM4QT.js";
+} from "./chunk-HCNU6K7D.js";
 
 // src/index.ts
 import { Command, Help } from "commander";
 import { pathToFileURL } from "url";
-import chalk34 from "chalk";
-import inquirer13 from "inquirer";
+import chalk35 from "chalk";
+import inquirer14 from "inquirer";
 
 // src/lib/nlp-router.ts
 function normalize(input) {
@@ -129,6 +129,12 @@ var RULES = [
     confidence: "high",
     test: (t2) => /적대\s*검증|자기\s*검증|거짓\s*완료|완료\s*심문|^review$|^검토$/.test(t2)
   },
+  {
+    command: "mission",
+    explanation: "\uBBF8\uC158 \uACC4\uC57D \u2014 \uC791\uC5C5 \uBC94\uC704\xB7\uAE08\uC9C0\uC120 \uC120\uC5B8/\uAC80\uC99D (vhk mission)",
+    confidence: "high",
+    test: (t2) => /미션\s*계약|작업\s*범위|범위\s*검증|^mission$|^미션$/.test(t2)
+  },
   {
     command: "init",
     explanation: "\uBB38\uC11C/\uD558\uB124\uC2A4 \uD30C\uC77C\uB9CC \uC0DD\uC131 (vhk init) \u2014 git/MCP/context\uB294 \uC81C\uC678",
@@ -177,11 +183,20 @@ var RULES = [
     confidence: "high",
     test: (t2) => /감사|취약점|audit|vulnerability|보안\s*감사|보안\s*취약|의존성\s*취약/.test(t2)
   },
+  // memory 마이그레이션은 패키지매니저 migrate 보다 **먼저** 평가 — "기억/메모리 마이그레이트" 가
+  // pnpm 전환(vhk migrate)으로 새지 않도록. 기억/메모리/memory 한정이라 bare "마이그레이트"는 안 가로챔.
+  {
+    command: "memory",
+    args: ["migrate"],
+    explanation: "memory.json v1 \u2192 v2 \uB9C8\uC774\uADF8\uB808\uC774\uC158 (vhk memory migrate)",
+    confidence: "high",
+    test: (t2) => /(기억|메모리|memory)\s*(을|를)?\s*(마이그레이|migrat)/.test(t2)
+  },
   {
     command: "migrate",
     explanation: "\uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800 \uC804\uD658 (vhk migrate)",
     confidence: "high",
-    test: (t2) => /전환|마이그레이트|migrate|패키지\s*매니저|npm.*pnpm|pnpm.*npm|yarn.*전환|npm.*전환|pnpm.*전환/.test(t2)
+    test: (t2) => /전환|마이그레이(트|션)|migrate|패키지\s*매니저|npm.*pnpm|pnpm.*npm|yarn.*전환|npm.*전환|pnpm.*전환/.test(t2) && !/(기억|메모리|memory)\s*(을|를)?\s*(마이그레이|migrat)/.test(t2)
   },
   {
     command: "update",
@@ -205,7 +220,9 @@ var RULES = [
     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)
+    // 보관(archive)/해결(resolve)/마이그레이션은 list 가 아니다 → **제외 토큰 한 곳**에서 오라우팅 차단.
+    // archive/resolve 는 <번호> 인자가 필요해 NL 미지원 → 매칭 안 되면 notMatched 가 정직(잘못된 list 실행 금지).
+    test: (t2) => /^기억$|기억\s*(목록|보|확인|뭐)|memory.*list|결정사항\s*(목록|확인|보여)/.test(t2) && !/(추가|add|삭제|remove|저장|기록해|보관|아카이브|archive|마이그레이|migrat|해결|복구)/.test(t2)
   },
   {
     command: "brief",
@@ -366,12 +383,13 @@ function extractNotionUrl(input) {
 var CONTAINER_SUBCOMMANDS = {
   goal: ["list", "next", "check", "init", "done", "sync"],
   ref: ["add", "list", "open"],
-  memory: ["add", "list", "remove"],
+  memory: ["add", "list", "remove", "archive", "resolve", "unarchive", "migrate"],
   cloud: ["push", "pull"],
   secure: ["scan"],
   design: ["palette"],
   env: ["check"],
-  mode: ["lite", "standard", "strict"]
+  mode: ["lite", "standard", "strict"],
+  mission: ["set", "check", "clear"]
 };
 var CONTAINER_ALIASES = {
   \uBAA9\uD45C: "goal",
@@ -381,7 +399,8 @@ var CONTAINER_ALIASES = {
   \uBCF4\uC548: "secure",
   \uB514\uC790\uC778: "design",
   \uD658\uACBD\uBCC0\uC218: "env",
-  \uBAA8\uB4DC: "mode"
+  \uBAA8\uB4DC: "mode",
+  \uBBF8\uC158: "mission"
 };
 
 // src/lib/cli-args.ts
@@ -476,6 +495,8 @@ var KNOWN_COMMAND_TOKENS = /* @__PURE__ */ new Set([
   "\uC0AC\uC804\uC810\uAC80",
   "review",
   "\uAC80\uD1A0",
+  "mission",
+  "\uBBF8\uC158",
   "help"
 ]);
 function isOptionToken(token) {
@@ -513,8 +534,8 @@ function detectNaturalLanguageInput(argv) {
 }
 
 // src/lib/nlp-run.ts
-import chalk32 from "chalk";
-import inquirer12 from "inquirer";
+import chalk33 from "chalk";
+import inquirer13 from "inquirer";
 
 // src/commands/gate.ts
 import inquirer from "inquirer";
@@ -1695,32 +1716,6 @@ ${line}
   }
   return { count, hardStopTripped };
 }
-function appendLearning(lesson, goalId) {
-  ensureStateDir();
-  const tag = goalId !== void 0 ? `goal-${goalId}` : "no-goal";
-  const line = `- [${isoDate()} ${tag}] ${lesson.trim()}`;
-  if (!existsSync(LEARNINGS_PATH)) {
-    writeFileSync(
-      LEARNINGS_PATH,
-      `# Learnings
-
-_Append-only. \uD55C \uC904 = \uD55C \uAD50\uD6C8._
-
-${line}
-`,
-      "utf-8"
-    );
-  } else {
-    appendFileSync(LEARNINGS_PATH, `${line}
-`, "utf-8");
-  }
-}
-function getRecentLearnings(limit = 3) {
-  if (!existsSync(LEARNINGS_PATH)) return [];
-  const lines = readFileSync(LEARNINGS_PATH, "utf-8").split(/\r?\n/);
-  const entries = lines.filter((l) => l.startsWith("- ["));
-  return entries.slice(-limit);
-}
 function getActiveBlockers(limit = 3) {
   if (!existsSync(BLOCKERS_PATH)) return [];
   const lines = readFileSync(BLOCKERS_PATH, "utf-8").split(/\r?\n/);
@@ -4434,15 +4429,432 @@ async function update() {
 
 // src/commands/context.ts
 import {
-  existsSync as existsSync11,
-  mkdirSync as mkdirSync7,
-  readFileSync as readFileSync4,
+  existsSync as existsSync12,
+  mkdirSync as mkdirSync8,
+  readFileSync as readFileSync5,
   readdirSync as readdirSync2,
   statSync as statSync2,
-  writeFileSync as writeFileSync7
+  writeFileSync as writeFileSync8
 } from "fs";
+import { join as join8 } from "path";
+import chalk24 from "chalk";
+
+// src/commands/memory.ts
+import { existsSync as existsSync11, mkdirSync as mkdirSync7, writeFileSync as writeFileSync7, copyFileSync, readFileSync as readFileSync4, renameSync, rmSync as rmSync3 } from "fs";
 import { join as join7 } from "path";
 import chalk23 from "chalk";
+var MEMORY_PATH_REL = join7(".vhk", "memory.json");
+var MEMORY_SCHEMA_VERSION = 2;
+function emptyV2() {
+  return { schemaVersion: MEMORY_SCHEMA_VERSION, decisions: [], failures: [], successes: [], patterns: [] };
+}
+function isV2(raw) {
+  return !!raw && typeof raw === "object" && raw.schemaVersion === 2;
+}
+var BUCKET_PREFIX = { decision: "d", failure: "f", success: "s" };
+function arr(v) {
+  return Array.isArray(v) ? v : [];
+}
+function normalizeV2(raw) {
+  return {
+    schemaVersion: MEMORY_SCHEMA_VERSION,
+    decisions: arr(raw.decisions),
+    failures: arr(raw.failures),
+    successes: arr(raw.successes),
+    patterns: arr(raw.patterns)
+  };
+}
+function parseLearnings(rawLearnings) {
+  const out = [];
+  for (const line of rawLearnings.split(/\r?\n/)) {
+    const m = line.match(/^-\s*\[(\d{4}-\d{2}-\d{2})\s+([^\]]*)\]\s*(.+)$/);
+    if (m) out.push({ date: m[1], tag: m[2].trim(), lesson: m[3].trim() });
+  }
+  return out;
+}
+function migrateMemory(rawMemory, rawLearnings) {
+  if (isV2(rawMemory)) return normalizeV2(rawMemory);
+  const v2 = emptyV2();
+  if (Array.isArray(rawMemory)) {
+    rawMemory.forEach((m, i) => {
+      const item = m;
+      if (item && typeof item.content === "string") {
+        v2.decisions.push({
+          id: `d${i + 1}`,
+          content: item.content,
+          tags: arr(item.tags),
+          createdAt: typeof item.addedAt === "string" ? item.addedAt : "",
+          status: "active"
+        });
+      }
+    });
+  }
+  if (rawLearnings) {
+    parseLearnings(rawLearnings).forEach((l, i) => {
+      v2.failures.push({
+        id: `f${i + 1}`,
+        content: "",
+        tags: l.tag ? [l.tag] : [],
+        createdAt: l.date,
+        status: "active",
+        lesson: l.lesson
+      });
+    });
+  }
+  return v2;
+}
+function readRaw(cwd) {
+  const p = join7(cwd, MEMORY_PATH_REL);
+  if (!existsSync11(p)) return { kind: "missing" };
+  try {
+    return { kind: "parsed", value: readJsonFile(p) };
+  } catch {
+    return { kind: "error" };
+  }
+}
+function warnUnreadable(cwd) {
+  const p = join7(cwd, MEMORY_PATH_REL);
+  console.error(chalk23.red(`
+\u26A0\uFE0F  ${MEMORY_PATH_REL} \uB97C \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC190\uC0C1/\uBD80\uBD84 \uC4F0\uAE30 \uC758\uC2EC).`));
+  console.error(chalk23.yellow(`   \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uACE0 \uBE48 \uBA54\uBAA8\uB9AC\uB85C \uC9C4\uD589\uD569\uB2C8\uB2E4 \u2014 \uC6D0\uBCF8 \uBCF4\uC874\uB428.`));
+  console.error(chalk23.dim(`   \uD655\uC778/\uBCF5\uAD6C: ${p}  (\uBC31\uC5C5: ${p}.bak / ${p}.v1.bak)`));
+}
+function warnUnrecognized(cwd) {
+  const p = join7(cwd, MEMORY_PATH_REL);
+  console.error(chalk23.red(`
+\u26A0\uFE0F  ${MEMORY_PATH_REL} \uAC00 \uC778\uC2DD \uAC00\uB2A5\uD55C \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4 (v1 \uBC30\uC5F4/v2 \uAC1D\uCCB4 \uC544\uB2D8).`));
+  console.error(chalk23.yellow(`   \uBBF8\uB798 \uC2A4\uD0A4\uB9C8/\uC218\uB3D9 \uD3B8\uC9D1 \uC758\uC2EC \u2014 \uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uC6D0\uBCF8 \uBCF4\uC874). \uD655\uC778 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4.`));
+  console.error(chalk23.dim(`   \uD655\uC778: ${p}`));
+}
+function readLearningsRaw(cwd) {
+  const p = join7(cwd, "docs", "state", "learnings.md");
+  if (!existsSync11(p)) return void 0;
+  try {
+    return stripBom(readFileSync4(p, "utf-8"));
+  } catch {
+    return void 0;
+  }
+}
+function readMemory(cwd = process.cwd()) {
+  const raw = readRaw(cwd);
+  if (raw.kind === "error") {
+    warnUnreadable(cwd);
+    return emptyV2();
+  }
+  if (raw.kind === "parsed") {
+    if (isV2(raw.value)) return normalizeV2(raw.value);
+    if (Array.isArray(raw.value)) {
+      const v2 = migrateMemory(raw.value, readLearningsRaw(cwd));
+      try {
+        writeMemory(cwd, v2);
+      } catch {
+        console.error(chalk23.yellow(`   (v2 \uC601\uAD6C\uD654 \uBCF4\uB958 \u2014 ${MEMORY_PATH_REL} \uC7A0\uAE08 \uC758\uC2EC. \uC774\uBC88\uC5D4 \uBA54\uBAA8\uB9AC\uC0C1\uC73C\uB85C\uB9CC \uC9C4\uD589)`));
+      }
+      return v2;
+    }
+    warnUnrecognized(cwd);
+    return emptyV2();
+  }
+  return migrateMemory(null, readLearningsRaw(cwd));
+}
+function loadForMutation(cwd) {
+  const raw = readRaw(cwd);
+  if (raw.kind === "error") {
+    warnUnreadable(cwd);
+    return { ok: false };
+  }
+  if (raw.kind === "parsed") {
+    if (isV2(raw.value)) return { ok: true, mem: normalizeV2(raw.value) };
+    if (Array.isArray(raw.value)) return { ok: true, mem: migrateMemory(raw.value, readLearningsRaw(cwd)) };
+    warnUnrecognized(cwd);
+    return { ok: false };
+  }
+  return { ok: true, mem: migrateMemory(null, readLearningsRaw(cwd)) };
+}
+function isActive(e) {
+  return e.status !== "archived" && e.status !== "resolved";
+}
+function writeMemory(cwd, mem) {
+  const p = join7(cwd, MEMORY_PATH_REL);
+  mkdirSync7(join7(cwd, ".vhk"), { recursive: true });
+  if (existsSync11(p)) {
+    const cur = readRaw(cwd);
+    const curIsV2 = cur.kind === "parsed" && isV2(cur.value);
+    if (cur.kind !== "error" && !curIsV2 && !existsSync11(p + ".v1.bak")) {
+      try {
+        copyFileSync(p, p + ".v1.bak");
+      } catch {
+      }
+    }
+    if (cur.kind !== "error") {
+      try {
+        copyFileSync(p, p + ".bak");
+      } catch {
+      }
+    }
+  }
+  const tmpPath = p + ".tmp";
+  writeFileSync7(tmpPath, JSON.stringify(mem, null, 2) + "\n", "utf-8");
+  try {
+    renameSync(tmpPath, p);
+  } catch (err) {
+    try {
+      rmSync3(tmpPath, { force: true });
+    } catch {
+    }
+    throw err;
+  }
+}
+function nextId(bucket, mem) {
+  const prefix = BUCKET_PREFIX[bucket];
+  const list = bucket === "decision" ? mem.decisions : bucket === "failure" ? mem.failures : mem.successes;
+  const idRe = new RegExp(`^${prefix}(\\d+)$`);
+  let max = 0;
+  for (const e of list) {
+    const m = e.id.match(idRe);
+    if (m) max = Math.max(max, Number(m[1]));
+  }
+  return `${prefix}${max + 1}`;
+}
+function orderedAll(mem) {
+  return [
+    ...mem.decisions.map((entry) => ({ bucket: "decision", entry })),
+    ...mem.failures.map((entry) => ({ bucket: "failure", entry })),
+    ...mem.successes.map((entry) => ({ bucket: "success", entry }))
+  ];
+}
+var VALID_BUCKETS = ["decision", "failure", "success"];
+async function memoryAdd(content, opts = {}) {
+  console.log(chalk23.bold("\n\u{1F9E0} " + t("memory.addTitle")));
+  console.log(chalk23.gray("\u2500".repeat(40)));
+  if (!content || !content.trim()) {
+    console.log(chalk23.red("\u274C \uAE30\uC5B5\uD560 \uB0B4\uC6A9\uC744 \uC785\uB825\uD574\uC8FC\uC138\uC694."));
+    console.log(chalk23.gray('   \uC608: vhk memory add "API\uB294 tRPC \uC0AC\uC6A9" --type decision'));
+    process.exitCode = 1;
+    return;
+  }
+  const typeRaw = opts.type ?? "decision";
+  if (!VALID_BUCKETS.includes(typeRaw)) {
+    console.log(chalk23.red(`\u274C --type \uC740 decision|failure|success \uC911 \uD558\uB098\uC5EC\uC57C \uD569\uB2C8\uB2E4 (\uBC1B\uC740 \uAC12: ${typeRaw}).`));
+    process.exitCode = 1;
+    return;
+  }
+  const type = typeRaw;
+  if (type === "decision" && (opts.why || opts.lesson)) {
+    console.log(chalk23.yellow("\u26A0\uFE0F  --why/--lesson \uC740 --type failure|success \uC5D0\uC11C\uB9CC \uC800\uC7A5\uB429\uB2C8\uB2E4 \u2014 decision \uC5D0\uC11C\uB294 \uBB34\uC2DC\uB428."));
+  }
+  const cwd = process.cwd();
+  const loaded = loadForMutation(cwd);
+  if (!loaded.ok) {
+    console.log(chalk23.red("\u274C memory.json \uC190\uC0C1 \uC758\uC2EC \u2014 \uC800\uC7A5 \uC911\uB2E8 (\uC6D0\uBCF8 \uBCF4\uC874). \uBC31\uC5C5 \uD655\uC778 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694."));
+    process.exitCode = 1;
+    return;
+  }
+  const mem = loaded.mem;
+  const base = {
+    id: nextId(type, mem),
+    content: content.trim(),
+    tags: opts.tags && opts.tags.length > 0 ? opts.tags : [],
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    status: "active"
+  };
+  if (type === "failure") mem.failures.push({ ...base, why: opts.why, lesson: opts.lesson });
+  else if (type === "success") mem.successes.push({ ...base, why: opts.why });
+  else mem.decisions.push(base);
+  writeMemory(cwd, mem);
+  console.log(chalk23.green(`
+\u2705 \uAE30\uC5B5 \uC800\uC7A5\uB428 (${type} #${base.id})`));
+  console.log(chalk23.cyan(`   \u{1F4DD} ${base.content}`));
+  printNextStep({ message: "\uAE30\uC5B5 \uC800\uC7A5 \uC644\uB8CC!", command: "vhk memory list", cursorHint: "\uAE30\uC5B5 \uBAA9\uB85D \uBCF4\uC5EC\uC918" });
+}
+var STATUS_ICON2 = { active: "\u{1F7E2}", resolved: "\u2705", archived: "\u{1F4E6}" };
+var BUCKET_LABEL = { decision: "\uACB0\uC815", failure: "\uC2E4\uD328", success: "\uC131\uACF5" };
+async function memoryList(opts = {}) {
+  console.log(chalk23.bold("\n\u{1F9E0} " + t("memory.listTitle")));
+  console.log(chalk23.gray("\u2500".repeat(40)));
+  const mem = readMemory(process.cwd());
+  const all = orderedAll(mem);
+  const visible = all.map((x, i) => ({ ...x, n: i + 1 })).filter((x) => (opts.all || isActive(x.entry)) && (!opts.type || x.bucket === opts.type));
+  if (visible.length === 0) {
+    console.log(chalk23.yellow("\n\u{1F4ED} \uD45C\uC2DC\uD560 \uAE30\uC5B5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk23.gray('   vhk memory add "\uB0B4\uC6A9" --type decision|failure|success'));
+    return;
+  }
+  console.log(chalk23.cyan(`
+${visible.length}\uAC1C${opts.all ? " (\uBCF4\uAD00 \uD3EC\uD568)" : " (\uD65C\uC131)"}:
+`));
+  for (const x of visible) {
+    const e = x.entry;
+    const fail = e;
+    console.log(`  [${x.n}] ${STATUS_ICON2[e.status] ?? "\u{1F7E2}"} (${BUCKET_LABEL[x.bucket]}) ${e.content || (fail.lesson ? "\u{1F4A1} " + fail.lesson : "(\uB0B4\uC6A9 \uC5C6\uC74C)")}`);
+    if (fail.lesson && e.content) console.log(chalk23.dim(`      \u{1F4A1} \uAD50\uD6C8: ${fail.lesson}`));
+    if (fail.why) console.log(chalk23.dim(`      \u21B3 ${fail.why}`));
+    if (e.tags.length > 0) console.log(chalk23.blue(`      \u{1F3F7}\uFE0F  ${e.tags.join(", ")}`));
+  }
+}
+function resolveIndex(indexStr, len) {
+  const idx = parseInt(indexStr, 10) - 1;
+  if (Number.isNaN(idx) || idx < 0 || idx >= len) return null;
+  return idx;
+}
+async function memoryRemove(indexStr) {
+  const cwd = process.cwd();
+  const loaded = loadForMutation(cwd);
+  if (!loaded.ok) {
+    console.log(chalk23.red("\u274C memory.json \uC190\uC0C1 \uC758\uC2EC \u2014 \uC0AD\uC81C \uC911\uB2E8 (\uC6D0\uBCF8 \uBCF4\uC874)."));
+    process.exitCode = 1;
+    return;
+  }
+  const mem = loaded.mem;
+  const all = orderedAll(mem);
+  const idx = resolveIndex(indexStr, all.length);
+  if (idx === null) {
+    console.log(chalk23.red(`\u274C \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uBC88\uD638\uC785\uB2C8\uB2E4. (1~${all.length || 0})`));
+    process.exitCode = 1;
+    return;
+  }
+  const { bucket, entry } = all[idx];
+  const list = bucket === "decision" ? mem.decisions : bucket === "failure" ? mem.failures : mem.successes;
+  const pos = list.findIndex((e) => e === entry);
+  if (pos >= 0) list.splice(pos, 1);
+  writeMemory(cwd, mem);
+  console.log(chalk23.green("\n\u2705 \uAE30\uC5B5 \uC0AD\uC81C\uB428:"));
+  console.log(chalk23.gray(`   ${entry.content || entry.lesson || entry.id}`));
+}
+function resolveEntryForMutation(indexStr) {
+  const cwd = process.cwd();
+  const loaded = loadForMutation(cwd);
+  if (!loaded.ok) {
+    console.log(chalk23.red("\u274C memory.json \uC190\uC0C1 \uC758\uC2EC \u2014 \uC791\uC5C5 \uC911\uB2E8 (\uC6D0\uBCF8 \uBCF4\uC874)."));
+    process.exitCode = 1;
+    return null;
+  }
+  const mem = loaded.mem;
+  const all = orderedAll(mem);
+  const idx = resolveIndex(indexStr, all.length);
+  if (idx === null) {
+    console.log(chalk23.red(`\u274C \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uBC88\uD638\uC785\uB2C8\uB2E4. (1~${all.length || 0})`));
+    process.exitCode = 1;
+    return null;
+  }
+  return { cwd, mem, entry: all[idx].entry };
+}
+function entryLabel(entry) {
+  return entry.content || entry.lesson || entry.id;
+}
+async function memoryArchive(indexStr) {
+  const r = resolveEntryForMutation(indexStr);
+  if (!r) return;
+  r.entry.status = "archived";
+  r.entry.archivedAt = (/* @__PURE__ */ new Date()).toISOString();
+  delete r.entry.resolvedAt;
+  writeMemory(r.cwd, r.mem);
+  console.log(chalk23.green(`
+\u{1F4E6} \uBCF4\uAD00\uB428: ${entryLabel(r.entry)}`));
+  console.log(chalk23.dim("   (\uD328\uD134 \uAC10\uC9C0\xB7\uC9C4\uD654\uC5D0\uC11C \uC81C\uC678\uB429\uB2C8\uB2E4 \u2014 \uC120\uC21C\uD658). \uB418\uB3CC\uB9AC\uAE30: vhk memory unarchive <\uBC88\uD638>"));
+}
+async function memoryResolve(indexStr) {
+  const r = resolveEntryForMutation(indexStr);
+  if (!r) return;
+  r.entry.status = "resolved";
+  r.entry.resolvedAt = (/* @__PURE__ */ new Date()).toISOString();
+  delete r.entry.archivedAt;
+  writeMemory(r.cwd, r.mem);
+  console.log(chalk23.green(`
+\u2705 \uD574\uACB0\uB428: ${entryLabel(r.entry)}`));
+  console.log(chalk23.dim("   (vhk memory list --all \uB85C \uD655\uC778. \uB418\uB3CC\uB9AC\uAE30: vhk memory unarchive <\uBC88\uD638>)"));
+}
+async function memoryUnarchive(indexStr) {
+  const r = resolveEntryForMutation(indexStr);
+  if (!r) return;
+  if (isActive(r.entry)) {
+    console.log(chalk23.dim(`  \uC774\uBBF8 \uD65C\uC131 \uD56D\uBAA9\uC785\uB2C8\uB2E4 \u2014 \uBCC0\uACBD \uC5C6\uC74C: ${entryLabel(r.entry)}`));
+    return;
+  }
+  r.entry.status = "active";
+  delete r.entry.archivedAt;
+  delete r.entry.resolvedAt;
+  writeMemory(r.cwd, r.mem);
+  console.log(chalk23.green(`
+\u{1F7E2} \uD65C\uC131\uC73C\uB85C \uBCF5\uAD6C\uB428: ${entryLabel(r.entry)}`));
+}
+async function memoryMigrate() {
+  const cwd = process.cwd();
+  const raw = readRaw(cwd);
+  if (raw.kind === "error") {
+    warnUnreadable(cwd);
+    console.log(chalk23.red("  \u274C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC911\uB2E8 (\uC190\uC0C1 \uC758\uC2EC). \uC6D0\uBCF8 \uD655\uC778 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694."));
+    process.exitCode = 1;
+    return;
+  }
+  if (raw.kind === "parsed" && isV2(raw.value)) {
+    console.log(chalk23.dim("  \uC774\uBBF8 memory schema v2 \uC785\uB2C8\uB2E4 \u2014 \uBCC0\uACBD \uC5C6\uC74C(\uBA71\uB4F1)."));
+    return;
+  }
+  if (raw.kind === "parsed" && !Array.isArray(raw.value)) {
+    warnUnrecognized(cwd);
+    console.log(chalk23.red("  \u274C v1(\uD3C9\uBA74 \uBC30\uC5F4) \uD615\uC2DD\uC774 \uC544\uB2C8\uB77C \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uB300\uC0C1\uC774 \uC544\uB2D9\uB2C8\uB2E4 \u2014 \uC911\uB2E8(\uC6D0\uBCF8 \uBCF4\uC874)."));
+    process.exitCode = 1;
+    return;
+  }
+  const learnings = readLearningsRaw(cwd);
+  const hadFile = raw.kind === "parsed";
+  if (raw.kind === "missing" && !learnings) {
+    console.log(chalk23.yellow("  \u2139\uFE0F  \uB9C8\uC774\uADF8\uB808\uC774\uC158\uD560 v1 memory.json / learnings.md \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uBCC0\uACBD \uC5C6\uC74C."));
+    return;
+  }
+  const v2 = migrateMemory(raw.kind === "parsed" ? raw.value : null, learnings);
+  writeMemory(cwd, v2);
+  const backupNote = hadFile ? " (.v1.bak \uC6D0\uBCF8 \uC601\uAD6C \uBC31\uC5C5)" : " (\uC2E0\uADDC \uC0DD\uC131 \u2014 \uC6D0\uBCF8 \uC5C6\uC74C, \uBC31\uC5C5 \uC5C6\uC74C)";
+  console.log(chalk23.green(`
+\u2705 memory.json \u2192 v2 \uB9C8\uC774\uADF8\uB808\uC774\uC158 \uC644\uB8CC${backupNote}`));
+  console.log(
+    chalk23.dim(
+      `   decisions ${v2.decisions.length} \xB7 failures ${v2.failures.length} \xB7 successes ${v2.successes.length}` + (learnings ? " (learnings.md \uAD50\uD6C8 \uD761\uC218 \u2014 \uC774\uD6C4 vhk learn \uC740 memory \uC5D0 \uAE30\uB85D)" : "")
+    )
+  );
+}
+function activeMemoryLines(mem, limit = 5) {
+  const lines = [];
+  const fmt = (e) => {
+    const f = e;
+    const base = e.content || (f.lesson ? `\u{1F4A1} ${f.lesson}` : e.id);
+    return e.content && f.lesson ? `${base} \u2014 \u{1F4A1} ${f.lesson}` : base;
+  };
+  const section = (label, list) => {
+    const act = list.filter(isActive);
+    if (act.length === 0) return;
+    lines.push(`**${label}** (${act.length})`);
+    for (const e of act.slice(-limit)) lines.push(`- ${fmt(e)}`);
+    if (act.length > limit) lines.push(`- \u2026 \uC678 ${act.length - limit}\uAC1C`);
+    lines.push("");
+  };
+  section("\uACB0\uC815 (decisions)", mem.decisions);
+  section("\uC2E4\uD328\xB7\uAD50\uD6C8 (failures)", mem.failures);
+  section("\uC131\uACF5 (successes)", mem.successes);
+  const pats = mem.patterns.length;
+  if (pats > 0) lines.push(`**\uD328\uD134 \uD6C4\uBCF4 (patterns)**: ${pats}\uAC1C \u2014 \`vhk pattern\``, "");
+  return lines;
+}
+function recordLesson(cwd, lesson, goalId) {
+  const loaded = loadForMutation(cwd);
+  if (!loaded.ok) return null;
+  const mem = loaded.mem;
+  const tag = goalId !== void 0 ? `goal-${goalId}` : "no-goal";
+  const entry = {
+    id: nextId("failure", mem),
+    content: "",
+    tags: [tag],
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    status: "active",
+    lesson: lesson.trim()
+  };
+  mem.failures.push(entry);
+  writeMemory(cwd, mem);
+  return entry;
+}
+
+// src/commands/context.ts
 var CONTEXT_PATH = ".vhk/context.md";
 var IGNORE_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
@@ -4467,7 +4879,7 @@ function buildTree(dir, prefix = "", maxDepth = 3, depth = 0) {
     filtered.forEach((entry, index) => {
       const isLast = index === filtered.length - 1;
       const connector = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
-      const fullPath = join7(dir, entry);
+      const fullPath = join8(dir, entry);
       const stat = statSync2(fullPath);
       const isDir = stat.isDirectory();
       lines.push(`${prefix}${connector}${entry}${isDir ? "/" : ""}`);
@@ -4499,8 +4911,8 @@ function extractTechStack() {
     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";
+    if (existsSync12("pnpm-lock.yaml")) stack["\uD328\uD0A4\uC9C0 \uB9E4\uB2C8\uC800"] = "pnpm";
+    else if (existsSync12("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;
@@ -4543,8 +4955,8 @@ function getVhkCommands() {
 }
 async function context(opts = {}) {
   const compact = opts.compact === true;
-  console.log(chalk23.bold("\n\u{1F9E0} " + t("context.title")));
-  console.log(chalk23.gray("\u2500".repeat(40)));
+  console.log(chalk24.bold("\n\u{1F9E0} " + t("context.title")));
+  console.log(chalk24.gray("\u2500".repeat(40)));
   const stack = extractTechStack();
   const tree = buildTree(".", "", compact ? 2 : 3).join("\n");
   const commands = getVhkCommands();
@@ -4579,27 +4991,14 @@ async function context(opts = {}) {
     }
     lines.push("");
   }
-  if (existsSync11(".vhk/memory.json")) {
-    try {
-      const memories = readJsonFile(
-        ".vhk/memory.json"
-      );
-      if (Array.isArray(memories) && memories.length > 0) {
-        const recentMemories = memories.slice(-5);
-        lines.push("## \uC800\uC7A5\uB41C \uACB0\uC815\uC0AC\uD56D");
-        lines.push("");
-        if (memories.length > recentMemories.length) {
-          lines.push(`_\uCD5C\uADFC ${recentMemories.length}\uAC1C\uB9CC \uD45C\uC2DC (\uC804\uCCB4 ${memories.length}\uAC1C)_`);
-          lines.push("");
-        }
-        for (const m of recentMemories) {
-          const date = new Date(m.addedAt).toLocaleDateString("ko-KR");
-          lines.push(`- ${m.content} _(${date})_`);
-        }
-        lines.push("");
-      }
-    } catch {
+  try {
+    const memLines = activeMemoryLines(readMemory(process.cwd()));
+    if (memLines.length > 0) {
+      lines.push("## \uC800\uC7A5\uB41C \uAE30\uC5B5 (memory v2)");
+      lines.push("");
+      lines.push(...memLines);
     }
+  } catch {
   }
   const goals = listGoals("goals");
   const activeId = selectActiveId(goals);
@@ -4616,13 +5015,6 @@ async function context(opts = {}) {
       lines.push("");
     }
   }
-  const recent = getRecentLearnings(3);
-  if (recent.length > 0) {
-    lines.push("## Recent Learnings");
-    lines.push("");
-    for (const r of recent) lines.push(r);
-    lines.push("");
-  }
   const activeBlockers = getActiveBlockers(3);
   if (activeBlockers.length > 0) {
     lines.push("## Active Blockers");
@@ -4657,12 +5049,12 @@ async function context(opts = {}) {
   } catch {
   }
   lines.push("");
-  mkdirSync7(".vhk", { recursive: true });
-  writeFileSync7(CONTEXT_PATH, lines.join("\n"), "utf-8");
-  console.log(chalk23.green(`
+  mkdirSync8(".vhk", { recursive: true });
+  writeFileSync8(CONTEXT_PATH, lines.join("\n"), "utf-8");
+  console.log(chalk24.green(`
 \u2705 ${CONTEXT_PATH} \uC0DD\uC131 \uC644\uB8CC!`));
-  console.log(chalk23.gray(`   \uAE30\uC220 \uC2A4\uD0DD ${Object.keys(stack).length}\uAC1C \uAC10\uC9C0`));
-  console.log(chalk23.gray("   AI \uC5B4\uC2DC\uC2A4\uD134\uD2B8\uC5D0\uAC8C \uC774 \uD30C\uC77C\uC744 \uCC38\uC870\uD558\uAC8C \uD558\uC138\uC694."));
+  console.log(chalk24.gray(`   \uAE30\uC220 \uC2A4\uD0DD ${Object.keys(stack).length}\uAC1C \uAC10\uC9C0`));
+  console.log(chalk24.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",
@@ -4670,110 +5062,33 @@ async function context(opts = {}) {
   });
 }
 async function contextShow() {
-  console.log(chalk23.bold("\n\u{1F4C4} " + t("context.showTitle")));
-  console.log(chalk23.gray("\u2500".repeat(40)));
-  if (!existsSync11(CONTEXT_PATH)) {
-    console.log(chalk23.yellow("\n\u26A0\uFE0F  \uCEE8\uD14D\uC2A4\uD2B8 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    console.log(chalk23.gray("   vhk context\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694."));
-    return;
-  }
-  const content = readFileSync4(CONTEXT_PATH, "utf-8");
-  console.log("\n" + content);
-}
-
-// src/commands/memory.ts
-import { existsSync as existsSync12, mkdirSync as mkdirSync8, writeFileSync as writeFileSync8 } from "fs";
-import chalk24 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) {
-  mkdirSync8(".vhk", { recursive: true });
-  writeFileSync8(MEMORY_PATH, JSON.stringify(memories, null, 2) + "\n", "utf-8");
-}
-async function memoryAdd(content, tags) {
-  console.log(chalk24.bold("\n\u{1F9E0} " + t("memory.addTitle")));
-  console.log(chalk24.gray("\u2500".repeat(40)));
-  if (!content) {
-    console.log(chalk24.red("\u274C \uAE30\uC5B5\uD560 \uB0B4\uC6A9\uC744 \uC785\uB825\uD574\uC8FC\uC138\uC694."));
-    console.log(chalk24.gray('   \uC608: vhk memory add "API\uB294 tRPC \uC0AC\uC6A9\uD558\uAE30\uB85C \uACB0\uC815"'));
-    process.exitCode = 1;
-    return;
-  }
-  const memories = loadMemories();
-  memories.push({
-    content,
-    addedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    tags: tags && tags.length > 0 ? tags : []
-  });
-  saveMemories(memories);
-  console.log(chalk24.green(`
-\u2705 \uAE30\uC5B5 \uC800\uC7A5\uB428 (#${memories.length})`));
-  console.log(chalk24.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(chalk24.bold("\n\u{1F9E0} " + t("memory.listTitle")));
+  console.log(chalk24.bold("\n\u{1F4C4} " + t("context.showTitle")));
   console.log(chalk24.gray("\u2500".repeat(40)));
-  const memories = loadMemories();
-  if (memories.length === 0) {
-    console.log(chalk24.yellow("\n\u{1F4ED} \uC800\uC7A5\uB41C \uAE30\uC5B5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    console.log(chalk24.gray('   vhk memory add "\uB0B4\uC6A9"\uC73C\uB85C \uCD94\uAC00\uD558\uC138\uC694.'));
-    return;
-  }
-  console.log(chalk24.cyan(`
-\uCD1D ${memories.length}\uAC1C\uC758 \uAE30\uC5B5:
-`));
-  memories.forEach((m, index) => {
-    const date = new Date(m.addedAt).toLocaleDateString("ko-KR");
-    console.log(chalk24.white(`  [${index + 1}] ${m.content}`));
-    if (m.tags && m.tags.length > 0) {
-      console.log(chalk24.blue(`      \u{1F3F7}\uFE0F  ${m.tags.join(", ")}`));
-    }
-    console.log(chalk24.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(chalk24.red(`\u274C \uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uBC88\uD638\uC785\uB2C8\uB2E4. (1~${memories.length || 0})`));
+  if (!existsSync12(CONTEXT_PATH)) {
+    console.log(chalk24.yellow("\n\u26A0\uFE0F  \uCEE8\uD14D\uC2A4\uD2B8 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk24.gray("   vhk context\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694."));
     return;
   }
-  const removed = memories.splice(idx, 1)[0];
-  saveMemories(memories);
-  console.log(chalk24.green("\n\u2705 \uAE30\uC5B5 \uC0AD\uC81C\uB428:"));
-  console.log(chalk24.gray(`   ${removed.content}`));
+  const content = readFileSync5(CONTEXT_PATH, "utf-8");
+  console.log("\n" + content);
 }
 
 // src/commands/brief.ts
-import { existsSync as existsSync13, mkdirSync as mkdirSync9, writeFileSync as writeFileSync9, readFileSync as readFileSync5 } from "fs";
+import { existsSync as existsSync13, mkdirSync as mkdirSync9, writeFileSync as writeFileSync9, readFileSync as readFileSync6 } from "fs";
 import chalk25 from "chalk";
 var BRIEF_PATH = ".vhk/brief.md";
 function readProjectIdentity() {
   const out = {};
   try {
     if (existsSync13("RULES.md")) {
-      const r = readFileSync5("RULES.md", "utf-8");
+      const r = readFileSync6("RULES.md", "utf-8");
       const m = r.split("\n")[0].match(/^#\s*(.+?)(?:\s*—.*)?$/);
       if (m) out.name = m[1].trim();
       const d = r.match(/한 줄 설명:\s*(.+)/);
       if (d) out.description = d[1].trim();
     }
     if (!out.name && existsSync13("CLAUDE.md")) {
-      const m = readFileSync5("CLAUDE.md", "utf-8").match(/#\s*기록 규칙\s*\((.+?)\)/);
+      const m = readFileSync6("CLAUDE.md", "utf-8").match(/#\s*기록 규칙\s*\((.+?)\)/);
       if (m) out.name = m[1].trim();
     }
   } catch {
@@ -4823,22 +5138,14 @@ async function brief() {
     `- **\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 {
+  try {
+    const memLines = activeMemoryLines(readMemory(process.cwd()));
+    if (memLines.length > 0) {
+      lines.push("## \uC800\uC7A5\uB41C \uAE30\uC5B5 (memory v2)");
+      lines.push("");
+      lines.push(...memLines);
     }
+  } catch {
   }
   if (existsSync13(".vhk/refs.json")) {
     try {
@@ -4885,7 +5192,7 @@ import chalk26 from "chalk";
 import inquirer11 from "inquirer";
 import { simpleGit as simpleGit2 } from "simple-git";
 import { existsSync as existsSync14 } from "fs";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 var VHK_FOOTPRINT_FILES = [
   "CLAUDE.md",
   ".cursorrules",
@@ -4894,7 +5201,7 @@ var VHK_FOOTPRINT_FILES = [
   "docs/PRD.md"
 ];
 function detectExistingFootprint(cwd) {
-  return VHK_FOOTPRINT_FILES.filter((rel) => existsSync14(join8(cwd, rel)));
+  return VHK_FOOTPRINT_FILES.filter((rel) => existsSync14(join9(cwd, rel)));
 }
 async function runGitInit(cwd) {
   try {
@@ -5300,7 +5607,7 @@ import chalk29 from "chalk";
 
 // src/lib/config.ts
 import { existsSync as existsSync15, mkdirSync as mkdirSync10, writeFileSync as writeFileSync10 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // src/lib/safety-mode.ts
 var SAFETY_MODES = ["lite", "standard", "strict"];
@@ -5316,10 +5623,10 @@ function isSafetyMode(value) {
 
 // src/lib/config.ts
 var CONFIG_DIR = ".vhk";
-var CONFIG_PATH = join9(CONFIG_DIR, "config.json");
+var CONFIG_PATH = join10(CONFIG_DIR, "config.json");
 var DEFAULT_CONFIG = { safetyMode: DEFAULT_SAFETY_MODE };
 function readConfig(rootDir = process.cwd()) {
-  const full = join9(rootDir, CONFIG_PATH);
+  const full = join10(rootDir, CONFIG_PATH);
   if (!existsSync15(full)) return { ...DEFAULT_CONFIG };
   try {
     const raw = readJsonFile(full);
@@ -5331,8 +5638,8 @@ function readConfig(rootDir = process.cwd()) {
   }
 }
 function writeConfig(config, rootDir = process.cwd()) {
-  mkdirSync10(join9(rootDir, CONFIG_DIR), { recursive: true });
-  writeFileSync10(join9(rootDir, CONFIG_PATH), JSON.stringify(config, null, 2) + "\n", "utf-8");
+  mkdirSync10(join10(rootDir, CONFIG_DIR), { recursive: true });
+  writeFileSync10(join10(rootDir, CONFIG_PATH), JSON.stringify(config, null, 2) + "\n", "utf-8");
 }
 
 // src/commands/mode.ts
@@ -5372,7 +5679,7 @@ async function mode(target) {
 // src/commands/verify.ts
 import { execFileSync as execFileSync4 } from "child_process";
 import { existsSync as existsSync16, mkdirSync as mkdirSync11, writeFileSync as writeFileSync11 } from "fs";
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 import chalk30 from "chalk";
 
 // src/commands/verify-report.ts
@@ -5481,13 +5788,13 @@ ${actions}
 
 // src/commands/verify.ts
 var REPORT_SCHEMA_VERSION = 1;
-var REPORT_DIR_REL = join10(".vhk", "reports");
-var REPORT_PATH_REL = join10(REPORT_DIR_REL, "latest.json");
-var REPORT_HTML_PATH_REL = join10(REPORT_DIR_REL, "latest.html");
+var REPORT_DIR_REL = join11(".vhk", "reports");
+var REPORT_PATH_REL = join11(REPORT_DIR_REL, "latest.json");
+var REPORT_HTML_PATH_REL = join11(REPORT_DIR_REL, "latest.html");
 var SHIM = /* @__PURE__ */ new Set(["pnpm", "npm", "npx", "yarn"]);
 function detectPm(cwd) {
-  if (existsSync16(join10(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync16(join10(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync16(join11(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync16(join11(cwd, "yarn.lock"))) return "yarn";
   return "npm";
 }
 function execGate(cmd, args, cwd) {
@@ -5530,7 +5837,7 @@ function runScriptGate(id, label, cwd, pm, argvFor) {
   };
 }
 function readPackageScripts(cwd) {
-  const pkgPath = join10(cwd, "package.json");
+  const pkgPath = join11(cwd, "package.json");
   if (!existsSync16(pkgPath)) return {};
   try {
     const pkg = readJsonFile(pkgPath);
@@ -5546,7 +5853,7 @@ function runGates(cwd) {
   gates.push(
     runScriptGate("typecheck", "tsc --noEmit", cwd, pm, () => {
       if (scripts.typecheck) return ["run", "typecheck"];
-      if (existsSync16(join10(cwd, "tsconfig.json"))) return pm === "npm" ? ["exec", "--", "tsc", "--noEmit"] : ["exec", "tsc", "--noEmit"];
+      if (existsSync16(join11(cwd, "tsconfig.json"))) return pm === "npm" ? ["exec", "--", "tsc", "--noEmit"] : ["exec", "tsc", "--noEmit"];
       return null;
     })
   );
@@ -5625,9 +5932,9 @@ function buildReport(gates, generatedAt, date) {
 function verifyEvidence(cwd = process.cwd()) {
   const gates = runGates(cwd);
   const report = buildReport(gates, (/* @__PURE__ */ new Date()).toISOString(), localDate());
-  const dir = join10(cwd, REPORT_DIR_REL);
+  const dir = join11(cwd, REPORT_DIR_REL);
   mkdirSync11(dir, { recursive: true });
-  const path14 = join10(cwd, REPORT_PATH_REL);
+  const path14 = join11(cwd, REPORT_PATH_REL);
   writeFileSync11(path14, JSON.stringify(report, null, 2) + "\n", "utf-8");
   try {
     ensureVhkIgnored(cwd, "reports/");
@@ -5641,7 +5948,7 @@ var STATUS_BADGE = {
   FAIL: chalk30.red.bold("FAIL")
 };
 async function renderVerifyReport(cwd, opts) {
-  const jsonPath = join10(cwd, REPORT_PATH_REL);
+  const jsonPath = join11(cwd, REPORT_PATH_REL);
   let report;
   if (existsSync16(jsonPath)) {
     try {
@@ -5655,9 +5962,9 @@ async function renderVerifyReport(cwd, opts) {
     report = verifyEvidence(cwd).report;
   }
   const html = renderReportHtml(report);
-  const htmlPath = join10(cwd, REPORT_HTML_PATH_REL);
+  const htmlPath = join11(cwd, REPORT_HTML_PATH_REL);
   try {
-    mkdirSync11(join10(cwd, REPORT_DIR_REL), { recursive: true });
+    mkdirSync11(join11(cwd, REPORT_DIR_REL), { recursive: true });
     writeFileSync11(htmlPath, html, "utf-8");
   } catch (e) {
     console.error(
@@ -5741,7 +6048,7 @@ async function verify(opts = {}) {
 
 // src/commands/review.ts
 import { existsSync as existsSync17, writeFileSync as writeFileSync12 } from "fs";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 import chalk31 from "chalk";
 var GOALS_DIR2 = "goals";
 var COVERAGE_MIN = 0.5;
@@ -5899,7 +6206,7 @@ async function review(opts = {}) {
   if (opts.id === void 0 && goalStatus === "NOT_STARTED") {
     console.error(chalk31.yellow(`  \u26A0\uFE0F  active goal ${goalId} \uAC00 NOT_STARTED \u2014 \uC644\uB8CC \uC8FC\uC7A5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uAC80\uC99D \uB300\uC0C1\uC740 --id \uB85C \uC9C0\uC815\uD558\uC138\uC694.`));
   }
-  const jsonPath = join11(cwd, REPORT_PATH_REL);
+  const jsonPath = join12(cwd, REPORT_PATH_REL);
   if (!existsSync17(jsonPath)) {
     console.error(chalk31.yellow(`  \u26A0\uFE0F  \uC99D\uAC70 \uBD80\uC7AC \u2014 ${REPORT_PATH_REL} \uC5C6\uC74C. review \uB97C \uC911\uB2E8\uD569\uB2C8\uB2E4(\uC0C8 \uC99D\uAC70 \uC548 \uB9CC\uB4E6).`));
     printNextStep({
@@ -6009,6 +6316,183 @@ ${result.disclaimer}`));
   }
 }
 
+// src/commands/mission.ts
+import { existsSync as existsSync18, mkdirSync as mkdirSync12, writeFileSync as writeFileSync13, rmSync as rmSync4 } from "fs";
+import { join as join13 } from "path";
+import chalk32 from "chalk";
+import inquirer12 from "inquirer";
+import { simpleGit as simpleGit3 } from "simple-git";
+var MISSION_PATH_REL = join13(".vhk", "mission.json");
+var MISSION_SCHEMA_VERSION = 1;
+var MISSION_DISCLAIMER = "\u26A0\uFE0F  mission check \uB294 \uACBD\uB85C glob \uAE30\uC900\uC785\uB2C8\uB2E4 \u2014 objective \uC758\uBBF8 \uBD80\uD569\uC740 \uAC80\uC99D\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4(\uC2E0\uB8B0\uB3C4 \uC2E0\uD638, \uBCF4\uC7A5 \uC544\uB2D8).";
+function globToRegExp(glob) {
+  let re = "";
+  for (let i = 0; i < glob.length; i++) {
+    const c = glob[i];
+    if (c === "*") {
+      if (glob[i + 1] === "*") {
+        re += ".*";
+        i++;
+        if (glob[i + 1] === "/") i++;
+      } else {
+        re += "[^/]*";
+      }
+    } else if (c === "?") {
+      re += "[^/]";
+    } else if (".+^${}()|[]\\".includes(c)) {
+      re += "\\" + c;
+    } else {
+      re += c;
+    }
+  }
+  return new RegExp("^" + re + "$");
+}
+function matchesAny(file, globs) {
+  const norm = file.replace(/\\/g, "/");
+  for (const g of globs) {
+    if (globToRegExp(g).test(norm)) return g;
+  }
+  return null;
+}
+function checkMission(changedFiles, mission) {
+  const violations = [];
+  const warnings = [];
+  for (const file of changedFiles) {
+    const forbiddenHit = matchesAny(file, mission.forbidden);
+    if (forbiddenHit) {
+      violations.push({ file, pattern: forbiddenHit });
+      continue;
+    }
+    if (mission.scope.length > 0 && !matchesAny(file, mission.scope)) {
+      warnings.push({ file });
+    }
+  }
+  return { violations, warnings, disclaimer: MISSION_DISCLAIMER };
+}
+function readMission(cwd = process.cwd()) {
+  const p = join13(cwd, MISSION_PATH_REL);
+  if (!existsSync18(p)) return null;
+  try {
+    const m = readJsonFile(p);
+    if (m && typeof m.objective === "string") return m;
+    return null;
+  } catch {
+    return null;
+  }
+}
+function writeMission(cwd, mission) {
+  mkdirSync12(join13(cwd, ".vhk"), { recursive: true });
+  writeFileSync13(join13(cwd, MISSION_PATH_REL), JSON.stringify(mission, null, 2) + "\n", "utf-8");
+}
+async function collectChangedFiles(cwd) {
+  const status2 = await simpleGit3(cwd).status();
+  const set = /* @__PURE__ */ new Set();
+  for (const f of status2.files) if (f.path) set.add(f.path.replace(/\\/g, "/"));
+  return [...set];
+}
+async function missionSet(opts = {}) {
+  if (!ensureNotHardStopped("mission set")) return;
+  const cwd = process.cwd();
+  const existing = readMission(cwd);
+  let objective = opts.objective ?? existing?.objective ?? "";
+  if (!objective) {
+    if (isInteractive(opts)) {
+      const ans = await inquirer12.prompt([
+        { type: "input", name: "obj", message: "\uBBF8\uC158 \uBAA9\uD45C(objective)\uB294?" }
+      ]);
+      objective = ans.obj.trim();
+    }
+    if (!objective) {
+      console.error(chalk32.red('  \u274C objective \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. --objective "..." \uB85C \uC9C0\uC815\uD558\uC138\uC694(\uBE44\uB300\uD654\uD615).'));
+      process.exitCode = 1;
+      return;
+    }
+  }
+  const scope = opts.clearScope ? [] : opts.scope ?? existing?.scope ?? [];
+  const forbidden = opts.clearForbidden ? [] : opts.forbidden ?? existing?.forbidden ?? [];
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const mission = {
+    schemaVersion: MISSION_SCHEMA_VERSION,
+    objective,
+    scope,
+    forbidden,
+    createdAt: existing?.createdAt ?? now,
+    updatedAt: now
+  };
+  try {
+    writeMission(cwd, mission);
+  } catch (e) {
+    console.error(chalk32.red(`  \u274C mission.json \uAE30\uB85D \uC2E4\uD328: ${e instanceof Error ? e.message : String(e)}`));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(chalk32.bold("\n\u{1F3AF} \uBBF8\uC158 \uACC4\uC57D \uC800\uC7A5"));
+  console.log(chalk32.dim(`  \u{1F4C4} ${MISSION_PATH_REL}`));
+  console.log(`  objective: ${mission.objective}`);
+  console.log(`  scope: ${mission.scope.length ? mission.scope.join(", ") : "(\uC81C\uD55C \uC5C6\uC74C)"}`);
+  console.log(`  forbidden: ${mission.forbidden.length ? mission.forbidden.join(", ") : "(\uC5C6\uC74C)"}`);
+  printNextStep({ message: "\uBCC0\uACBD\uC774 \uACC4\uC57D \uC548\uC778\uC9C0 \uAC80\uC99D\uD558\uB824\uBA74:", command: "vhk mission check", cursorHint: "\uBBF8\uC158 \uAC80\uC99D\uD574\uC918" });
+}
+async function missionShow() {
+  const cwd = process.cwd();
+  const mission = readMission(cwd);
+  if (!mission) {
+    console.error(chalk32.yellow("  \u26A0\uFE0F  \uBBF8\uC158 \uACC4\uC57D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 (.vhk/mission.json)."));
+    printNextStep({ message: "\uBA3C\uC800 \uBBF8\uC158\uC744 \uC120\uC5B8\uD558\uC138\uC694:", command: 'vhk mission set --objective "..."', cursorHint: "\uBBF8\uC158 \uC815\uD574\uC918" });
+    process.exitCode = 1;
+    return;
+  }
+  console.log(chalk32.bold("\n\u{1F3AF} \uD604\uC7AC \uBBF8\uC158 \uACC4\uC57D"));
+  console.log(`  objective: ${mission.objective}`);
+  console.log(`  scope: ${mission.scope.length ? mission.scope.join(", ") : "(\uC81C\uD55C \uC5C6\uC74C)"}`);
+  console.log(`  forbidden: ${mission.forbidden.length ? mission.forbidden.join(", ") : "(\uC5C6\uC74C)"}`);
+  console.log(chalk32.dim(`  \uC0DD\uC131 ${mission.createdAt} \xB7 \uAC31\uC2E0 ${mission.updatedAt}`));
+}
+async function missionCheck() {
+  const cwd = process.cwd();
+  const mission = readMission(cwd);
+  if (!mission) {
+    console.error(chalk32.yellow("  \u26A0\uFE0F  \uBBF8\uC158 \uACC4\uC57D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uBA3C\uC800 vhk mission set \uC73C\uB85C \uC120\uC5B8\uD558\uC138\uC694."));
+    process.exitCode = 1;
+    return;
+  }
+  const changed = await collectChangedFiles(cwd);
+  const result = checkMission(changed, mission);
+  console.log(chalk32.bold("\n\u{1F3AF} \uBBF8\uC158 \uACC4\uC57D \uAC80\uC99D (mission check)"));
+  console.log(chalk32.dim(`  objective: ${mission.objective}  \xB7  \uBCC0\uACBD \uD30C\uC77C ${changed.length}\uAC1C`));
+  if (result.violations.length > 0) {
+    console.log(chalk32.red.bold(`
+  \u{1F6AB} forbidden \uC704\uBC18 ${result.violations.length}\uAC74`));
+    for (const v of result.violations) console.log(chalk32.red(`   \u2717 ${v.file}  (\uAE08\uC9C0: ${v.pattern})`));
+  }
+  if (result.warnings.length > 0) {
+    console.log(chalk32.yellow.bold(`
+  \u26A0\uFE0F  scope \uBC16 \uBCC0\uACBD ${result.warnings.length}\uAC74 (\uACBD\uACE0)`));
+    for (const w of result.warnings) console.log(chalk32.yellow(`   ? ${w.file}`));
+  }
+  if (result.violations.length === 0 && result.warnings.length === 0) {
+    console.log(chalk32.green("\n  \u2713 \uBCC0\uACBD\uC774 \uACC4\uC57D(scope/forbidden) \uC548\uC785\uB2C8\uB2E4."));
+  }
+  console.log(chalk32.yellow(`
+  ${result.disclaimer}`));
+  process.exitCode = result.violations.length > 0 ? 1 : 0;
+}
+async function missionClear() {
+  const cwd = process.cwd();
+  const p = join13(cwd, MISSION_PATH_REL);
+  if (!existsSync18(p)) {
+    console.log(chalk32.dim("  \uBBF8\uC158 \uACC4\uC57D\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uC9C0\uC6B8 \uAC83 \uC5C6\uC74C."));
+    return;
+  }
+  try {
+    rmSync4(p);
+    console.log(chalk32.green("  \u2705 \uBBF8\uC158 \uACC4\uC57D \uC0AD\uC81C\uB428 (.vhk/mission.json)."));
+  } catch (e) {
+    console.error(chalk32.red(`  \u274C \uC0AD\uC81C \uC2E4\uD328: ${e instanceof Error ? e.message : String(e)}`));
+    process.exitCode = 1;
+  }
+}
+
 // src/lib/risk-policy.ts
 var HIGH_RISK_ACTIONS = [
   "undo",
@@ -6150,6 +6634,7 @@ async function dispatchNlpRoute(route, input) {
     case "context-show":
       return contextShow();
     case "memory":
+      if (route.args?.[0] === "migrate") return memoryMigrate();
       return memoryList();
     case "brief":
       return brief();
@@ -6176,6 +6661,8 @@ async function dispatchNlpRoute(route, input) {
       return verify();
     case "review":
       return review();
+    case "mission":
+      return missionShow();
   }
 }
 var STATE_CHANGING_COMMANDS = /* @__PURE__ */ new Set([
@@ -6189,23 +6676,23 @@ function requiresConfirmation(route) {
 async function runNaturalLanguageRoute(input) {
   const route = routeNaturalLanguage(input);
   if (!route) {
-    console.log(chalk32.yellow(`
+    console.log(chalk33.yellow(`
   \u2753 "${input}" \u2014 ${ko.nlp.notMatched}
 `));
     return;
   }
   console.log("");
-  console.log(chalk32.cyan(`  \u{1F4AC} "${input}"`));
-  console.log(chalk32.cyan(`  \u2192 ${route.explanation}`));
+  console.log(chalk33.cyan(`  \u{1F4AC} "${input}"`));
+  console.log(chalk33.cyan(`  \u2192 ${route.explanation}`));
   if (requiresConfirmation(route)) {
-    const { confirm } = await inquirer12.prompt([{
+    const { confirm } = await inquirer13.prompt([{
       type: "confirm",
       name: "confirm",
       message: `${route.explanation} \u2014 ${ko.nlp.matched}`,
       default: true
     }]);
     if (!confirm) {
-      console.log(chalk32.dim(`  ${ko.nlp.menuHint}`));
+      console.log(chalk33.dim(`  ${ko.nlp.menuHint}`));
       return;
     }
   }
@@ -6214,7 +6701,7 @@ async function runNaturalLanguageRoute(input) {
   if (riskAction) {
     await runGuarded(
       riskAction,
-      { channel: "nl", approved: false, log: (m) => console.log(chalk32.yellow(`  ${m}`)) },
+      { channel: "nl", approved: false, log: (m) => console.log(chalk33.yellow(`  ${m}`)) },
       () => dispatchNlpRoute(route, input)
     );
     return;
@@ -6223,77 +6710,80 @@ async function runNaturalLanguageRoute(input) {
 }
 
 // src/commands/agent.ts
-import chalk33 from "chalk";
+import chalk34 from "chalk";
 function activeGoalId() {
   const goals = listGoals("goals");
   const id = selectActiveId(goals);
   return id ?? void 0;
 }
 async function blocker(description) {
-  console.log(chalk33.bold(`
+  console.log(chalk34.bold(`
 ${ko.agent.blockerTitle}
 `));
   if (!description || !description.trim()) {
-    console.log(chalk33.red("  \u274C \uBE14\uB85C\uCEE4 \uC124\uBA85\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
-    console.log(chalk33.dim('  \uC608: vhk blocker "tsc \uC5D0\uB7EC \u2014 simple-git \uD0C0\uC785 \uD638\uD658"'));
+    console.log(chalk34.red("  \u274C \uBE14\uB85C\uCEE4 \uC124\uBA85\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
+    console.log(chalk34.dim('  \uC608: vhk blocker "tsc \uC5D0\uB7EC \u2014 simple-git \uD0C0\uC785 \uD638\uD658"'));
     process.exitCode = 1;
     return;
   }
   const goalId = activeGoalId();
   const r = appendBlocker(description, goalId);
-  console.log(chalk33.green(`  \u2705 blocker \uAE30\uB85D (\uD604\uC7AC \uD65C\uC131 ${r.count}\uAC74)`));
+  console.log(chalk34.green(`  \u2705 blocker \uAE30\uB85D (\uD604\uC7AC \uD65C\uC131 ${r.count}\uAC74)`));
   if (r.hardStopTripped) {
-    console.log(chalk33.red.bold("  \u{1F6D1} HARD_STOP \uC790\uB3D9 \uC0DD\uC131 \u2014 \uBAA8\uB4E0 \uC790\uB3D9\uD654 \uC911\uB2E8."));
-    console.log(chalk33.yellow("     \uC0AC\uB78C \uAC80\uD1A0 \uD6C4 `vhk resume --confirm` \uC73C\uB85C\uB9CC \uD574\uC81C."));
+    console.log(chalk34.red.bold("  \u{1F6D1} HARD_STOP \uC790\uB3D9 \uC0DD\uC131 \u2014 \uBAA8\uB4E0 \uC790\uB3D9\uD654 \uC911\uB2E8."));
+    console.log(chalk34.yellow("     \uC0AC\uB78C \uAC80\uD1A0 \uD6C4 `vhk resume --confirm` \uC73C\uB85C\uB9CC \uD574\uC81C."));
     process.exitCode = 2;
   }
 }
 async function learn(lesson) {
-  console.log(chalk33.bold(`
+  console.log(chalk34.bold(`
 ${ko.agent.learnTitle}
 `));
   if (!lesson || !lesson.trim()) {
-    console.log(chalk33.red("  \u274C \uAD50\uD6C8 \uB0B4\uC6A9\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
-    console.log(chalk33.dim('  \uC608: vhk learn "PowerShell \uC5D0\uC11C\uB294 ; \uC0AC\uC6A9 (&& \uBBF8\uC9C0\uC6D0)"'));
+    console.log(chalk34.red("  \u274C \uAD50\uD6C8 \uB0B4\uC6A9\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
+    console.log(chalk34.dim('  \uC608: vhk learn "PowerShell \uC5D0\uC11C\uB294 ; \uC0AC\uC6A9 (&& \uBBF8\uC9C0\uC6D0)"'));
     process.exitCode = 1;
     return;
   }
   const goalId = activeGoalId();
-  appendLearning(lesson, goalId);
-  console.log(chalk33.green("  \u2705 learnings.md append."));
-  console.log(
-    chalk33.dim("  \uACB0\uC815\uC0AC\uD56D(decision)\uC740 `vhk memory add` \uB85C \uBCC4\uB3C4 \uAE30\uB85D \u2014 SoT \uBD84\uB9AC.")
-  );
+  const entry = recordLesson(process.cwd(), lesson, goalId);
+  if (!entry) {
+    console.log(chalk34.red("  \u274C memory.json \uC190\uC0C1 \uC758\uC2EC \u2014 \uAD50\uD6C8 \uAE30\uB85D \uC911\uB2E8. \uC6D0\uBCF8/\uBC31\uC5C5 \uD655\uC778 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694."));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(chalk34.green(`  \u2705 \uAD50\uD6C8 \uAE30\uB85D \u2192 memory failures.lesson (${entry.id})`));
+  console.log(chalk34.dim("  \uAD50\uD6C8\xB7\uACB0\uC815\xB7\uC2E4\uD328\xB7\uC131\uACF5 \uBAA8\uB450 vhk memory (\uB2E8\uC77C SoT). vhk memory list \uB85C \uD655\uC778."));
 }
 async function resume(opts = {}) {
-  console.log(chalk33.bold(`
+  console.log(chalk34.bold(`
 ${ko.agent.resumeTitle}
 `));
   if (!isHardStopActive()) {
-    console.log(chalk33.dim("  HARD_STOP \uD65C\uC131 \uC544\uB2D8 \u2014 \uD560 \uC77C \uC5C6\uC74C."));
+    console.log(chalk34.dim("  HARD_STOP \uD65C\uC131 \uC544\uB2D8 \u2014 \uD560 \uC77C \uC5C6\uC74C."));
     return;
   }
   const reason = readHardStopReason();
   if (reason) {
-    console.log(chalk33.yellow("  \u{1F4CB} HARD_STOP \uC0AC\uC720:"));
-    console.log(chalk33.dim(`     ${reason.split("\n").join("\n     ")}`));
+    console.log(chalk34.yellow("  \u{1F4CB} HARD_STOP \uC0AC\uC720:"));
+    console.log(chalk34.dim(`     ${reason.split("\n").join("\n     ")}`));
     console.log("");
   }
   if (!opts.confirm) {
     console.log(
-      chalk33.red(
+      chalk34.red(
         "  \u274C --confirm \uD50C\uB798\uADF8 \uC5C6\uC774\uB294 \uD574\uC81C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uC790\uB3D9 \uD638\uCD9C \uAE08\uC9C0)."
       )
     );
-    console.log(chalk33.yellow("     \uC0AC\uC720\uB97C \uD655\uC778\uD55C \uD6C4 \uB2E4\uC2DC: vhk resume --confirm"));
+    console.log(chalk34.yellow("     \uC0AC\uC720\uB97C \uD655\uC778\uD55C \uD6C4 \uB2E4\uC2DC: vhk resume --confirm"));
     process.exitCode = 1;
     return;
   }
   const removed = clearHardStop();
   if (removed) {
-    console.log(chalk33.green("  \u2705 HARD_STOP \uD574\uC81C. \uC790\uB3D9\uD654 \uC7AC\uAC1C \uAC00\uB2A5."));
+    console.log(chalk34.green("  \u2705 HARD_STOP \uD574\uC81C. \uC790\uB3D9\uD654 \uC7AC\uAC1C \uAC00\uB2A5."));
   } else {
-    console.log(chalk33.dim("  \uD30C\uC77C\uC774 \uC774\uBBF8 \uC5C6\uC74C \u2014 no-op."));
+    console.log(chalk34.dim("  \uD30C\uC77C\uC774 \uC774\uBBF8 \uC5C6\uC74C \u2014 no-op."));
   }
 }
 
@@ -6306,7 +6796,7 @@ async function guardCli(action, approved, run) {
       channel: "cli",
       approved,
       confirm: async () => {
-        const { ok } = await inquirer13.prompt([{
+        const { ok } = await inquirer14.prompt([{
           type: "confirm",
           name: "ok",
           message: `\u26A0\uFE0F \uC704\uD5D8 \uC791\uC5C5(${action})\uC744 \uC2E4\uD589\uD560\uAE4C\uC694?`,
@@ -6314,7 +6804,7 @@ async function guardCli(action, approved, run) {
         }]);
         return ok;
       },
-      log: (m) => console.log(chalk34.yellow(`  ${m}`))
+      log: (m) => console.log(chalk35.yellow(`  ${m}`))
     },
     run
   );
@@ -6327,7 +6817,7 @@ async function guardCliDefer(action, approved, run) {
       approved,
       // TTY 면 통과(명령이 자체 확인), 비대화형은 confirm 불가 → 가드가 차단.
       confirm: async () => !!process.stdout.isTTY,
-      log: (m) => console.log(chalk34.yellow(`  ${m}`))
+      log: (m) => console.log(chalk35.yellow(`  ${m}`))
     },
     run
   );
@@ -6367,6 +6857,7 @@ var KO_ALIASES = {
   brief: "\uBE0C\uB9AC\uD551",
   goal: "\uBAA9\uD45C",
   review: "\uAC80\uD1A0",
+  mission: "\uBBF8\uC158",
   blocker: "\uBE14\uB85C\uCEE4",
   learn: "\uAD50\uD6C8",
   resume: "\uC7AC\uAC1C"
@@ -6494,22 +6985,48 @@ program.command("verify").alias("\uC0AC\uC804\uC810\uAC80").option("--json", "\u
 program.command("review").alias("\uAC80\uD1A0").option("--id <id>", "\uB300\uC0C1 goal id (\uC5C6\uC73C\uBA74 active goal)").description("\uC801\uB300\uC801 \uC790\uAE30\uAC80\uC99D \u2014 latest.json \u2194 goal \uC644\uB8CC\uC870\uAC74 \uAD50\uCC28\uAC80\uC99D (\uAC70\uC9D3\uC644\uB8CC \uC758\uC2EC \uD0D0\uC9C0, \uBCF4\uC7A5 \uC544\uB2D8)").action(async (opts) => {
   await review(opts);
 });
+var collectGlob = (v, prev = []) => prev.concat([v]);
+var missionCmd = program.command("mission").alias("\uBBF8\uC158").description("\uBBF8\uC158 \uACC4\uC57D \u2014 \uC791\uC5C5 \uBAA9\uD45C\xB7\uD5C8\uC6A9/\uAE08\uC9C0 \uBC94\uC704 \uC120\uC5B8\xB7\uAC80\uC99D (scope \uAC00\uB4DC, .vhk/mission.json)").action(async () => {
+  await missionShow();
+});
+missionCmd.command("set").option("--objective <text>", "\uBBF8\uC158 \uBAA9\uD45C(objective)").option("--scope <glob>", "\uD5C8\uC6A9 \uACBD\uB85C glob (\uBC18\uBCF5 \uAC00\uB2A5, \uC81C\uACF5 \uC2DC \uAD50\uCCB4)", collectGlob).option("--forbidden <glob>", "\uAE08\uC9C0 \uACBD\uB85C glob (\uBC18\uBCF5 \uAC00\uB2A5, \uC81C\uACF5 \uC2DC \uAD50\uCCB4)", collectGlob).option("--clear-scope", "scope \uB97C \uBE44\uC6C0(\uBA85\uC2DC\uC801)").option("--clear-forbidden", "forbidden \uC744 \uBE44\uC6C0(\uBA85\uC2DC\uC801)").option("-y, --yes", "\uB300\uD654\uD615 \uD504\uB86C\uD504\uD2B8 \uC2A4\uD0B5 (\uBE44\uB300\uD654\uD615)").description("\uBBF8\uC158 \uACC4\uC57D \uC120\uC5B8/\uAC31\uC2E0 (\uC635\uC158 \uBBF8\uC9C0\uC815 \uC2DC \uAE30\uC874 scope/forbidden \uBCF4\uC874)").action(async (opts) => {
+  await missionSet(opts);
+});
+missionCmd.command("check").description("\uBCC0\uACBD \uD30C\uC77C\uC774 \uACC4\uC57D(scope/forbidden) \uC548\uC778\uC9C0 \uAC80\uC99D \u2014 forbidden \uC704\uBC18 \uC2DC exit 1").action(async () => {
+  await missionCheck();
+});
+missionCmd.command("clear").description("\uBBF8\uC158 \uACC4\uC57D \uC0AD\uC81C (.vhk/mission.json)").action(async () => {
+  await missionClear();
+});
 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 () => {
+var memoryCmd = program.command("memory").alias("\uAE30\uC5B5").description("\uAE30\uC5B5 \uAD00\uB9AC v2 (decisions/failures/successes 4\uBC84\uD0B7) \u2014 add/list/remove/archive/resolve/unarchive/migrate").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) => {
+memoryCmd.command("add <content>").option("--type <type>", "\uBC84\uD0B7: decision|failure|success (\uAE30\uBCF8 decision)").option("--tags <tags>", "\uD0DC\uADF8 (\uC27C\uD45C \uAD6C\uBD84)").option("--why <why>", "\uC6D0\uC778 (failure/success)").option("--lesson <lesson>", "\uAD50\uD6C8 (failure)").description("\uAE30\uC5B5 \uC800\uC7A5 (--type \uC73C\uB85C \uACB0\uC815/\uC2E4\uD328/\uC131\uACF5 \uAD6C\uBD84)").action(async (content, opts) => {
   const tags = opts.tags ? opts.tags.split(",").map((s) => s.trim()) : void 0;
-  await memoryAdd(content, tags);
+  await memoryAdd(content, { type: opts.type, tags, why: opts.why, lesson: opts.lesson });
 });
-memoryCmd.command("list").alias("\uBAA9\uB85D").description("\uC800\uC7A5\uB41C \uAE30\uC5B5 \uBAA9\uB85D").action(async () => {
-  await memoryList();
+memoryCmd.command("list").alias("\uBAA9\uB85D").option("--type <type>", "\uBC84\uD0B7 \uD544\uD130: decision|failure|success").option("--all", "\uBCF4\uAD00(archived)\xB7\uD574\uACB0(resolved) \uD3EC\uD568").description("\uC800\uC7A5\uB41C \uAE30\uC5B5 \uBAA9\uB85D (\uAE30\uBCF8 \uD65C\uC131\uB9CC)").action(async (opts) => {
+  const type = opts.type === "decision" || opts.type === "failure" || opts.type === "success" ? opts.type : void 0;
+  await memoryList({ type, all: opts.all });
 });
 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);
 });
+memoryCmd.command("archive <index>").alias("\uBCF4\uAD00").description("\uAE30\uC5B5 \uBCF4\uAD00 (\uD65C\uC131\u2192archived, \uD328\uD134/\uC9C4\uD654\uC5D0\uC11C \uC81C\uC678)").action(async (index) => {
+  await memoryArchive(index);
+});
+memoryCmd.command("resolve <index>").alias("\uD574\uACB0").description("\uAE30\uC5B5 \uD574\uACB0 \uD45C\uC2DC (\uD65C\uC131\u2192resolved, \uD328\uD134/\uC9C4\uD654\uC5D0\uC11C \uC81C\uC678)").action(async (index) => {
+  await memoryResolve(index);
+});
+memoryCmd.command("unarchive <index>").alias("\uBCF5\uAD6C").description("\uBCF4\uAD00/\uD574\uACB0 \uD56D\uBAA9\uC744 \uB2E4\uC2DC \uD65C\uC131\uC73C\uB85C \uBCF5\uAD6C (archive/resolve \uC5ED\uC804)").action(async (index) => {
+  await memoryUnarchive(index);
+});
+memoryCmd.command("migrate").alias("\uB9C8\uC774\uADF8\uB808\uC774\uC158").description("memory.json v1 \u2192 v2 \uB9C8\uC774\uADF8\uB808\uC774\uC158 (\uAE30\uC874 v1 \uC788\uC73C\uBA74 .v1.bak \uC6D0\uBCF8 \uBC31\uC5C5, \uBA71\uB4F1)").action(async () => {
+  await memoryMigrate();
+});
 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();
 });
@@ -6537,7 +7054,7 @@ goalCmd.command("sync").alias("\uB3D9\uAE30\uD654").description("goals/*.md \uC2
 program.command("blocker <description>").alias("\uBE14\uB85C\uCEE4").description("\uBE14\uB85C\uCEE4 \uAE30\uB85D \u2192 docs/state/blockers.md append (3\uAC74 \uB204\uC801 \uC2DC HARD_STOP \uC790\uB3D9 \uC0DD\uC131)").action(async (description) => {
   await blocker(description);
 });
-program.command("learn <lesson>").alias("\uAD50\uD6C8").description("\uAD50\uD6C8 \uAE30\uB85D \u2192 docs/state/learnings.md append (memory.json \uACFC \uBCC4\uB3C4 SoT)").action(async (lesson) => {
+program.command("learn <lesson>").alias("\uAD50\uD6C8").description("\uAD50\uD6C8 \uAE30\uB85D \u2192 memory v2 failures.lesson \uB2E8\uC77C SoT (v2.0 \uD1B5\uD569 \u2014 vhk memory list \uB85C \uD655\uC778)").action(async (lesson) => {
   await learn(lesson);
 });
 program.command("resume").alias("\uC7AC\uAC1C").option("--confirm", "\uC0AC\uB78C \uD655\uC778 \u2014 \uC790\uB3D9 \uD638\uCD9C \uAE08\uC9C0 (Forbidden \uC704\uBC18)").description(".vhk/HARD_STOP \uD574\uC81C (\uC0AC\uC6A9\uC790\uAC00 \uC0AC\uC720 \uD655\uC778 \uD6C4 --confirm \uD544\uC694)").action(async (opts) => {
@@ -6551,7 +7068,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 inquirer13.prompt([{
+  const { choice } = await inquirer14.prompt([{
     type: "list",
     name: "choice",
     message: "\uBB58 \uB3C4\uC640\uB4DC\uB9B4\uAE4C\uC694?",
@@ -6608,9 +7125,9 @@ if (isMainModule) {
     }
   } catch (err) {
     if (isPromptAbortError(err)) {
-      console.error(chalk34.yellow("\n  \u26A0\uFE0F  \uB300\uD654\uD615 \uC785\uB825\uC774 \uCDE8\uC18C/\uC885\uB8CC\uB410\uC2B5\uB2C8\uB2E4. (\uBE44\uB300\uD654\uD615 \uD658\uACBD\uC5D0\uC11C\uB294 \uD574\uB2F9 \uBA85\uB839\uC744 \uC4F8 \uC218 \uC5C6\uC5B4\uC694)"));
+      console.error(chalk35.yellow("\n  \u26A0\uFE0F  \uB300\uD654\uD615 \uC785\uB825\uC774 \uCDE8\uC18C/\uC885\uB8CC\uB410\uC2B5\uB2C8\uB2E4. (\uBE44\uB300\uD654\uD615 \uD658\uACBD\uC5D0\uC11C\uB294 \uD574\uB2F9 \uBA85\uB839\uC744 \uC4F8 \uC218 \uC5C6\uC5B4\uC694)"));
     } else {
-      console.error(chalk34.red(`
+      console.error(chalk35.red(`
 \u274C ${err instanceof Error ? err.message : String(err)}`));
     }
     process.exitCode = 1;