@byh3071/vhk 2.1.0 → 2.3.0

package/dist/{chunk-ODNKCGUG.js → chunk-WQWPM364.js}

@@ -918,6 +918,28 @@ var ko = {
     detectTitle: "\uD328\uD134 \uAC10\uC9C0",
     listTitle: "\uD328\uD134 \uBAA9\uB85D",
     dismissTitle: "\uD328\uD134 dismiss"
+  },
+  evolve: {
+    suggestTitle: "\uC9C4\uD654 \uC81C\uC548 \uC0DD\uC131",
+    listTitle: "\uC9C4\uD654 \uD6C4\uBCF4 \uBAA9\uB85D",
+    applyTitle: "\uB8F0 \uBC18\uC601",
+    rejectTitle: "\uD6C4\uBCF4 \uAE30\uAC01",
+    undoTitle: "\uCD5C\uADFC \uBC18\uC601 \uB418\uB3CC\uB9AC\uAE30",
+    noRules: "RULES.md \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. vhk init\uC73C\uB85C \uC0DD\uC131 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.",
+    noPatterns: "patterns[]\uAC00 \uBE44\uC5B4\uC788\uAC70\uB098 active avoid \uD328\uD134\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. vhk pattern detect \uB85C \uBA3C\uC800 \uAC10\uC9C0\uD558\uC138\uC694.",
+    noQueue: "\uD6C4\uBCF4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. vhk evolve suggest \uB85C \uBA3C\uC800 \uC0DD\uC131\uD558\uC138\uC694.",
+    notFound: (id) => `\uD6C4\uBCF4 '${id}' \uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. vhk evolve list \uB85C \uD655\uC778\uD558\uC138\uC694.`,
+    alreadyApplied: "\uC774\uBBF8 \uBC18\uC601\uB41C \uD6C4\uBCF4\uC785\uB2C8\uB2E4.",
+    dismissed: "\uC18C\uC2A4 \uD328\uD134\uC774 dismiss\uB428 \u2014 apply \uAC70\uBD80 (dismiss\uB41C \uD328\uD134 \uAE30\uBC18 \uB8F0\uC740 \uBC18\uC601 \uC548 \uB428)",
+    alreadyAppliedPattern: "\uC18C\uC2A4 \uD328\uD134\uC774 \uC774\uBBF8 \uBC18\uC601\uB428 \u2014 apply \uAC70\uBD80",
+    duplicateRule: (draft) => `\uC911\uBCF5 \uB8F0 \uAC10\uC9C0 \u2014 RULES.md\uC5D0 \uC774\uBBF8 \uC720\uC0AC\uD55C \uB8F0\uC774 \uC788\uC2B5\uB2C8\uB2E4:
+  ${draft}`,
+    pendingApplyExists: "\uBBF8\uD574\uC18C apply\uAC00 \uC788\uC2B5\uB2C8\uB2E4. vhk evolve undo \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uAC70\uB098 \uADF8\uB300\uB85C \uC720\uC9C0\uD558\uC138\uC694.",
+    noAppliedToUndo: "undo\uD560 \uBC18\uC601 \uD56D\uBAA9\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+    noBackup: ".bak \uD30C\uC77C\uC774 \uC5C6\uC5B4 undo \uBD88\uAC00\uD569\uB2C8\uB2E4. RULES.md\uB97C \uC218\uB3D9 \uBCF5\uC6D0\uD558\uC138\uC694.",
+    allSuggested: "\uBAA8\uB4E0 \uD328\uD134\uC774 \uC774\uBBF8 \uC81C\uC548\uB410\uAC70\uB098 reject\uB410\uC2B5\uB2C8\uB2E4.",
+    newCandidates: (n) => `\uC2E0\uADDC \uD6C4\uBCF4: ${n}\uAC1C \uCD94\uAC00\uB428`,
+    suggestHint: "vhk evolve suggest \uB85C \uC0DD\uC131\uD558\uC138\uC694."
   }
 };
 function lookup(path7) {
@@ -3031,6 +3053,28 @@ ${cliStatus}
       return runVhkCli(args, "pattern list");
     }
   );
+  server.registerTool(
+    "evolve-suggest",
+    {
+      description: "active avoid \uD328\uD134 \u2192 \uB8F0 \uCD08\uC548 \uD6C4\uBCF4 \uC0DD\uC131\xB7\uD050 \uC801\uC7AC (Goal 20)",
+      inputSchema: {}
+    },
+    async () => runVhkCli(["evolve", "suggest", "--json"], "evolve suggest")
+  );
+  server.registerTool(
+    "evolve-list",
+    {
+      description: "\uC9C4\uD654 \uD6C4\uBCF4 \uBAA9\uB85D \uC870\uD68C (pending|rejected|applied \u2014 Goal 20)",
+      inputSchema: {
+        status: z.enum(["pending", "rejected", "applied"]).optional().describe("\uC0C1\uD0DC \uD544\uD130")
+      }
+    },
+    async ({ status }) => {
+      const args = ["evolve", "list", "--json"];
+      if (status) args.push("--status", status);
+      return runVhkCli(args, "evolve list");
+    }
+  );
   return server;
 }
 async function startMcpServer() {

package/dist/index.js

@@ -43,14 +43,14 @@ import {
   stripBom,
   sync,
   t
-} from "./chunk-ODNKCGUG.js";
+} from "./chunk-WQWPM364.js";
 
 // src/index.ts
 import { Command, Help } from "commander";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import fs13 from "fs";
-import chalk36 from "chalk";
-import inquirer14 from "inquirer";
+import chalk37 from "chalk";
+import inquirer15 from "inquirer";
 
 // src/lib/nlp-router.ts
 function normalize(input) {
@@ -59,6 +59,7 @@ function normalize(input) {
 var NLP_KEYWORDS = {
   save: ["\uC800\uC7A5", "\uC138\uC774\uBE0C", "\uCEE4\uBC0B", "\uC62C\uB824", "\uC62C\uB9AC\uAE30", "\uD478\uC2DC", "push", "commit"],
   pattern: ["\uD328\uD134", "\uB418\uD480\uC774", "\uBC84\uB987", "pattern"],
+  evolve: ["\uC9C4\uD654", "\uB8F0\uD6C4\uBCF4", "\uC9C4\uD654\uD6C4\uBCF4"],
   undo: ["\uB418\uB3CC\uB824", "\uB418\uB3CC\uB9AC\uAE30", "\uCDE8\uC18C", "\uC6D0\uB798\uB300\uB85C", "\uB864\uBC31", "\uB9AC\uC14B", "reset", "rollback"],
   status: ["\uC0C1\uD0DC", "\uD604\uD669", "\uC5B4\uB5BB\uAC8C", "\uC5B4\uB54C", "\uC9C0\uAE08"],
   diff: ["\uBCC0\uACBD", "\uBC14\uB010", "\uBB50\uBC14\uB01C", "\uBC14\uB00C\uC5C8", "\uCC28\uC774", "\uB2EC\uB77C\uC9C4", "\uC218\uC815\uB41C"]
@@ -328,6 +329,12 @@ var RULES = [
     confidence: "high",
     test: (t2) => matchesKeywords(t2, "pattern") || /^pattern$/.test(t2)
   },
+  {
+    command: "evolve",
+    explanation: "\uC9C4\uD654 \uD6C4\uBCF4 \uBAA9\uB85D (vhk evolve list) \u2014 apply/undo\uB294 \uC9C1\uC811 \uC2E4\uD589",
+    confidence: "high",
+    test: (t2) => matchesKeywords(t2, "evolve") || /^evolve$/.test(t2)
+  },
   // NLP 규칙은 한국어 표현만 매칭. 영문 `goal <sub>` 은 commander 가 직접 처리하도록
   // 가로채기 금지 — vhk goal list / next / check / done 그대로 동작.
   {
@@ -398,7 +405,8 @@ var CONTAINER_SUBCOMMANDS = {
   env: ["check"],
   mode: ["lite", "standard", "strict"],
   mission: ["set", "check", "clear"],
-  pattern: ["detect", "list", "dismiss"]
+  pattern: ["detect", "list", "dismiss"],
+  evolve: ["suggest", "list", "apply", "reject", "undo"]
 };
 var CONTAINER_ALIASES = {
   \uBAA9\uD45C: "goal",
@@ -410,7 +418,8 @@ var CONTAINER_ALIASES = {
   \uD658\uACBD\uBCC0\uC218: "env",
   \uBAA8\uB4DC: "mode",
   \uBBF8\uC158: "mission",
-  \uD328\uD134: "pattern"
+  \uD328\uD134: "pattern",
+  \uC9C4\uD654: "evolve"
 };
 
 // src/lib/cli-args.ts
@@ -544,8 +553,8 @@ function detectNaturalLanguageInput(argv) {
 }
 
 // src/lib/nlp-run.ts
-import chalk34 from "chalk";
-import inquirer13 from "inquirer";
+import chalk35 from "chalk";
+import inquirer14 from "inquirer";
 
 // src/commands/gate.ts
 import inquirer from "inquirer";
@@ -6745,6 +6754,376 @@ async function patternDismiss(idStr) {
   });
 }
 
+// src/commands/evolve.ts
+import { existsSync as existsSync19, mkdirSync as mkdirSync13, writeFileSync as writeFileSync14, readFileSync as readFileSync7, copyFileSync as copyFileSync2, renameSync as renameSync2, rmSync as rmSync5 } from "fs";
+import { join as join14 } from "path";
+import chalk34 from "chalk";
+import inquirer13 from "inquirer";
+var QUEUE_PATH_REL = join14(".vhk", "evolve", "queue.json");
+function buildDraft(p) {
+  const axisLabel = p.axis === "tag" ? `\uD0DC\uADF8 '${p.signal}'` : `\uD0A4\uC6CC\uB4DC '${p.signal}'`;
+  const countDesc = `${p.count}\uAC74 \uBC18\uBCF5`;
+  return `- ${axisLabel} \uAD00\uB828 \uC791\uC5C5 \uC2DC \uC0AC\uC804 \uC810\uAC80 \uD544\uC218 (\uADFC\uAC70: ${countDesc}, ${p.summary})`;
+}
+function buildDedupeKey(patternId, kind) {
+  return `${patternId}:${kind}`;
+}
+function generateCandidates(patterns, existing) {
+  const rejectedKeys = new Set(
+    existing.filter((i) => i.status === "rejected").map((i) => i.dedupeKey)
+  );
+  const occupiedKeys = new Set(
+    existing.filter((i) => i.status === "pending" || i.status === "applied").map((i) => i.dedupeKey)
+  );
+  const eligible = patterns.filter((p) => p.kind === "avoid" && p.status === "active").sort((a, b) => a.id.localeCompare(b.id));
+  const result = [];
+  for (const p of eligible) {
+    const dedupeKey = buildDedupeKey(p.id, "rule");
+    if (rejectedKeys.has(dedupeKey)) continue;
+    if (occupiedKeys.has(dedupeKey)) continue;
+    result.push({
+      patternId: p.id,
+      kind: "rule",
+      status: "pending",
+      draft: buildDraft(p),
+      dedupeKey
+    });
+  }
+  return result;
+}
+function isDuplicateRule(rulesContent, draft) {
+  const normalize2 = (s) => s.trim().replace(/\s+/g, " ").toLowerCase();
+  const normalizedDraft = normalize2(draft);
+  for (const line of rulesContent.split(/\r?\n/)) {
+    if (normalize2(line) === normalizedDraft) return true;
+  }
+  return false;
+}
+function stripBomStr(s) {
+  return s.charCodeAt(0) === 65279 ? s.slice(1) : s;
+}
+function readQueue(cwd) {
+  const p = join14(cwd, QUEUE_PATH_REL);
+  if (!existsSync19(p)) return { version: 1, items: [] };
+  try {
+    const raw = stripBomStr(readFileSync7(p, "utf-8"));
+    const parsed = JSON.parse(raw);
+    if (!parsed || !Array.isArray(parsed.items)) return { version: 1, items: [] };
+    return parsed;
+  } catch {
+    return { version: 1, items: [] };
+  }
+}
+function writeQueue(cwd, queue) {
+  const p = join14(cwd, QUEUE_PATH_REL);
+  mkdirSync13(join14(cwd, ".vhk", "evolve"), { recursive: true });
+  const tmpPath = p + ".tmp";
+  writeFileSync14(tmpPath, JSON.stringify(queue, null, 2) + "\n", "utf-8");
+  try {
+    renameSync2(tmpPath, p);
+  } catch (err) {
+    try {
+      rmSync5(tmpPath, { force: true });
+    } catch {
+    }
+    throw err;
+  }
+}
+function nextQueueId(queue) {
+  const re = /^e(\d+)$/;
+  let max = 0;
+  for (const item of queue.items) {
+    const m = item.id.match(re);
+    if (m) max = Math.max(max, Number(m[1]));
+  }
+  return `e${max + 1}`;
+}
+function checkApplyRef(pattern, queueItems) {
+  if (pattern === void 0 || pattern.status !== "archived") return "ok";
+  const hasApplied = queueItems.some(
+    (i) => i.patternId === pattern.id && i.status === "applied"
+  );
+  return hasApplied ? "already-applied" : "dismissed";
+}
+async function evolveSuggest(opts = {}) {
+  const cwd = process.cwd();
+  if (!existsSync19(join14(cwd, "RULES.md"))) {
+    console.log(chalk34.yellow("\n\u26A0\uFE0F  " + t("evolve.noRules")));
+    process.exitCode = 1;
+    return;
+  }
+  const mem = readMemory(cwd);
+  const patterns = mem.patterns;
+  const queue = readQueue(cwd);
+  const newItems = generateCandidates(patterns, queue.items);
+  if (newItems.length === 0 && !opts.json) {
+    const activeAvoid = patterns.filter((p) => p.kind === "avoid" && p.status === "active");
+    if (activeAvoid.length === 0) {
+      console.log(chalk34.yellow("\n\u{1F4ED} " + t("evolve.noPatterns")));
+      return;
+    }
+    console.log(chalk34.dim("\n  " + t("evolve.allSuggested")));
+    return;
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  for (const c of newItems) {
+    queue.items.push({ ...c, id: nextQueueId(queue), createdAt: now });
+  }
+  writeQueue(cwd, queue);
+  if (opts.json) {
+    const pending2 = queue.items.filter((i) => i.status === "pending");
+    console.log(JSON.stringify(pending2, null, 2));
+    return;
+  }
+  console.log(chalk34.bold("\n\u{1F504} " + t("evolve.suggestTitle")));
+  console.log(chalk34.gray("\u2500".repeat(40)));
+  console.log(chalk34.dim("  " + t("evolve.newCandidates", newItems.length)));
+  const pending = queue.items.filter((i) => i.status === "pending");
+  console.log(chalk34.cyan(`
+\uD6C4\uBCF4 ${pending.length}\uAC1C:
+`));
+  for (const item of pending) {
+    console.log(`  [${item.id}] (${item.status}) \uD328\uD134 ${item.patternId} \u2192 rule`);
+    console.log(chalk34.dim(`      \uCD08\uC548: ${item.draft}`));
+  }
+  printNextStep({
+    message: `\uC9C4\uD654 \uD6C4\uBCF4 ${pending.length}\uAC1C \uC0DD\uC131\uB428!`,
+    command: "vhk evolve list",
+    cursorHint: "\uC9C4\uD654 \uD6C4\uBCF4 \uBCF4\uC5EC\uC918",
+    alternative: "vhk evolve apply <id> \uB85C \uBC18\uC601"
+  });
+}
+async function evolveList(opts = {}) {
+  const cwd = process.cwd();
+  const queue = readQueue(cwd);
+  const VALID = ["pending", "rejected", "applied"];
+  let items = queue.items;
+  if (opts.status && VALID.includes(opts.status)) {
+    items = items.filter((i) => i.status === opts.status);
+  }
+  if (opts.json) {
+    console.log(JSON.stringify(items, null, 2));
+    return;
+  }
+  console.log(chalk34.bold("\n\u{1F504} " + t("evolve.listTitle")));
+  console.log(chalk34.gray("\u2500".repeat(40)));
+  if (items.length === 0) {
+    console.log(chalk34.yellow("\n\u{1F4ED} " + t("evolve.noQueue")));
+    console.log(chalk34.gray("   " + t("evolve.suggestHint")));
+    return;
+  }
+  const STATUS_ICON3 = {
+    pending: "\u23F3",
+    rejected: "\u274C",
+    applied: "\u2705"
+  };
+  console.log(chalk34.cyan(`
+${items.length}\uAC1C:
+`));
+  for (const item of items) {
+    console.log(`  [${item.id}] ${STATUS_ICON3[item.status]} (${item.status}) \u2192 ${item.draft}`);
+    if (item.appliedAt) console.log(chalk34.dim(`      \uBC18\uC601: ${item.appliedAt}`));
+  }
+}
+async function evolveApply(idStr) {
+  if (!ensureInteractive("apply\uB294 TTY \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \uD130\uBBF8\uB110\uC5D0\uC11C \uC9C1\uC811 \uC2E4\uD589\uD558\uC138\uC694.")) return;
+  const cwd = process.cwd();
+  const rulesPath = join14(cwd, "RULES.md");
+  if (!existsSync19(rulesPath)) {
+    console.log(chalk34.red("\n\u274C " + t("evolve.noRules")));
+    process.exitCode = 1;
+    return;
+  }
+  const queue = readQueue(cwd);
+  const item = queue.items.find((i) => i.id === idStr?.trim());
+  if (!item) {
+    console.log(chalk34.red("\n\u274C " + t("evolve.notFound", idStr ?? "")));
+    process.exitCode = 1;
+    return;
+  }
+  if (item.status === "applied") {
+    console.log(chalk34.yellow("\n\u26A0\uFE0F  " + t("evolve.alreadyApplied")));
+    process.exitCode = 1;
+    return;
+  }
+  const hasUnresolved = queue.items.some((i) => i.status === "applied");
+  if (hasUnresolved) {
+    console.log(chalk34.red("\n\u274C " + t("evolve.pendingApplyExists")));
+    process.exitCode = 1;
+    return;
+  }
+  const memLoaded = loadForMutation(cwd);
+  if (!memLoaded.ok) {
+    console.log(chalk34.red("\n\u274C memory.json \uC190\uC0C1 \uC758\uC2EC \u2014 apply \uC911\uB2E8 (\uC6D0\uBCF8 \uBCF4\uC874)."));
+    process.exitCode = 1;
+    return;
+  }
+  const srcPattern = memLoaded.mem.patterns.find((p) => p.id === item.patternId);
+  const refResult = checkApplyRef(srcPattern, queue.items);
+  if (refResult === "dismissed") {
+    console.log(chalk34.red("\n\u274C " + t("evolve.dismissed")));
+    process.exitCode = 1;
+    return;
+  }
+  if (refResult === "already-applied") {
+    console.log(chalk34.red("\n\u274C " + t("evolve.alreadyAppliedPattern")));
+    process.exitCode = 1;
+    return;
+  }
+  const rulesContent = readFileSync7(rulesPath, "utf-8");
+  if (isDuplicateRule(rulesContent, item.draft)) {
+    console.log(chalk34.yellow("\n\u26A0\uFE0F  " + t("evolve.duplicateRule", item.draft)));
+    return;
+  }
+  console.log(chalk34.bold("\n\u{1F504} " + t("evolve.applyTitle")));
+  console.log(chalk34.gray("\u2500".repeat(40)));
+  console.log(chalk34.cyan("\n\uCD94\uAC00\uB420 \uB8F0 \uCD08\uC548:"));
+  console.log(chalk34.white(`  ${item.draft}`));
+  const { editedDraft } = await inquirer13.prompt([{
+    type: "input",
+    name: "editedDraft",
+    message: "\uB8F0 \uBB38\uAD6C \uC218\uC815 (Enter = \uADF8\uB300\uB85C):",
+    default: item.draft
+  }]);
+  const { confirmed } = await inquirer13.prompt([{
+    type: "confirm",
+    name: "confirmed",
+    message: `RULES.md\uC5D0 \uC774 \uB8F0\uC744 \uCD94\uAC00\uD560\uAE4C\uC694?
+  ${editedDraft}`,
+    default: false
+  }]);
+  if (!confirmed) {
+    console.log(chalk34.dim("  \uCDE8\uC18C\uB428."));
+    return;
+  }
+  const backupPath = rulesPath + ".bak";
+  copyFileSync2(rulesPath, backupPath);
+  const appendContent = "\n" + editedDraft + "\n";
+  try {
+    writeFileSync14(rulesPath, rulesContent + appendContent, "utf-8");
+    await sync({ yes: true });
+  } catch (err) {
+    try {
+      copyFileSync2(backupPath, rulesPath);
+    } catch {
+    }
+    console.error(chalk34.red("\n\u274C RULES.md \uBC18\uC601 \uC911 \uC624\uB958 \u2014 \uC6D0\uBCF8 \uBCF5\uC6D0\uB428. \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694."));
+    console.error(chalk34.dim(`   ${err instanceof Error ? err.message : String(err)}`));
+    process.exitCode = 1;
+    return;
+  }
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  item.status = "applied";
+  item.draft = editedDraft;
+  item.appliedAt = now;
+  item.rulesBackupPath = backupPath;
+  writeQueue(cwd, queue);
+  if (srcPattern) {
+    const p = memLoaded.mem.patterns.find((x) => x.id === srcPattern.id);
+    if (p) {
+      p.status = "archived";
+      writeMemory(cwd, memLoaded.mem);
+    } else {
+      console.error(chalk34.yellow("  \u26A0\uFE0F  \uC18C\uC2A4 \uD328\uD134 archived \uCC98\uB9AC \uC2E4\uD328 (memory.json \uC190\uC0C1 \uC758\uC2EC). \uB8F0\uC740 \uBC18\uC601\uB410\uC2B5\uB2C8\uB2E4."));
+    }
+  }
+  console.log(chalk34.green(`
+\u2705 \uB8F0 \uBC18\uC601 \uC644\uB8CC! [${item.id}]`));
+  console.log(chalk34.dim("   RULES.md\uC5D0 \uCD94\uAC00 + vhk sync \uC7AC\uC0DD\uC131\uB428"));
+  printNextStep({
+    message: "\uB8F0 \uBC18\uC601 \uC644\uB8CC!",
+    command: "vhk evolve list --status applied",
+    cursorHint: "\uBC18\uC601\uB41C \uB8F0 \uBAA9\uB85D \uBCF4\uC5EC\uC918",
+    alternative: "vhk evolve undo \u2014 \uB418\uB3CC\uB9AC\uAE30"
+  });
+}
+async function evolveReject(idStr) {
+  const cwd = process.cwd();
+  const queue = readQueue(cwd);
+  const item = queue.items.find((i) => i.id === idStr?.trim());
+  if (!item) {
+    console.log(chalk34.red("\n\u274C " + t("evolve.notFound", idStr ?? "")));
+    process.exitCode = 1;
+    return;
+  }
+  if (item.status === "rejected") {
+    console.log(chalk34.dim(`  \uC774\uBBF8 \uAE30\uAC01\uB41C \uD6C4\uBCF4\uC785\uB2C8\uB2E4 \u2014 \uBCC0\uACBD \uC5C6\uC74C: ${item.id}`));
+    return;
+  }
+  if (item.status === "applied") {
+    console.log(chalk34.red(`
+\u274C \uC774\uBBF8 \uBC18\uC601\uB41C \uD56D\uBAA9\uC740 \uAE30\uAC01\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 vhk evolve undo \uB85C \uB418\uB3CC\uB9AC\uC138\uC694: ${item.id}`));
+    process.exitCode = 1;
+    return;
+  }
+  item.status = "rejected";
+  writeQueue(cwd, queue);
+  console.log(chalk34.green(`
+\u274C \uD6C4\uBCF4 \uAE30\uAC01\uB428: [${item.id}] ${item.draft}`));
+  console.log(chalk34.dim("   (A1: \uB2E4\uC74C suggest\uC5D0\uC11C \uC7AC\uC81C\uC548 \uC548 \uB428)"));
+  printNextStep({
+    message: "\uAE30\uAC01 \uC644\uB8CC!",
+    command: "vhk evolve list",
+    cursorHint: "\uB0A8\uC740 \uD6C4\uBCF4 \uBCF4\uC5EC\uC918"
+  });
+}
+async function evolveUndo() {
+  if (!ensureInteractive("undo\uB294 TTY \uD655\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \uD130\uBBF8\uB110\uC5D0\uC11C \uC9C1\uC811 \uC2E4\uD589\uD558\uC138\uC694.")) return;
+  const cwd = process.cwd();
+  const queue = readQueue(cwd);
+  const applied = queue.items.filter((i) => i.status === "applied");
+  if (applied.length === 0) {
+    console.log(chalk34.yellow("\n\u{1F4ED} " + t("evolve.noAppliedToUndo")));
+    return;
+  }
+  const last = applied.sort(
+    (a, b) => (b.appliedAt ?? "").localeCompare(a.appliedAt ?? "")
+  )[0];
+  if (!last.rulesBackupPath || !existsSync19(last.rulesBackupPath)) {
+    console.log(chalk34.red("\n\u274C " + t("evolve.noBackup")));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(chalk34.bold("\n\u{1F504} " + t("evolve.undoTitle")));
+  console.log(chalk34.dim(`  \uB418\uB3CC\uB9B4 \uD56D\uBAA9: [${last.id}] ${last.draft}`));
+  const { confirmed } = await inquirer13.prompt([{
+    type: "confirm",
+    name: "confirmed",
+    message: "RULES.md\uB97C .bak\uC73C\uB85C \uBCF5\uC6D0\uD558\uACE0 vhk sync\uB97C \uC7AC\uC2E4\uD589\uD560\uAE4C\uC694?",
+    default: false
+  }]);
+  if (!confirmed) {
+    console.log(chalk34.dim("  \uCDE8\uC18C\uB428."));
+    return;
+  }
+  copyFileSync2(last.rulesBackupPath, join14(cwd, "RULES.md"));
+  try {
+    await sync({ yes: true });
+  } catch (err) {
+    console.error(chalk34.red("\n\u274C sync \uC7AC\uC2E4\uD589 \uC911 \uC624\uB958. RULES.md\uB294 \uBCF5\uC6D0\uB410\uC73C\uB098 .cursorrules \uB4F1 \uC7AC\uC0DD\uC131 \uC2E4\uD328."));
+    console.error(chalk34.dim(`   ${err instanceof Error ? err.message : String(err)}`));
+    console.error(chalk34.dim("   \uC218\uB3D9\uC73C\uB85C `vhk sync` \uC2E4\uD589\uD558\uC138\uC694."));
+  }
+  last.status = "pending";
+  delete last.appliedAt;
+  delete last.rulesBackupPath;
+  writeQueue(cwd, queue);
+  const memLoaded = loadForMutation(cwd);
+  if (memLoaded.ok) {
+    const p = memLoaded.mem.patterns.find((x) => x.id === last.patternId);
+    if (p && p.status === "archived") {
+      p.status = "active";
+      writeMemory(cwd, memLoaded.mem);
+    }
+  }
+  console.log(chalk34.green("\n\u2705 \uB418\uB3CC\uB9AC\uAE30 \uC644\uB8CC! RULES.md \uBCF5\uC6D0 + sync \uC7AC\uC2E4\uD589\uB428"));
+  printNextStep({
+    message: "\uB418\uB3CC\uB9AC\uAE30 \uC644\uB8CC!",
+    command: "vhk evolve list",
+    cursorHint: "\uD6C4\uBCF4 \uBAA9\uB85D \uBCF4\uC5EC\uC918"
+  });
+}
+
 // src/lib/risk-policy.ts
 var HIGH_RISK_ACTIONS = [
   "undo",
@@ -6917,6 +7296,8 @@ async function dispatchNlpRoute(route, input) {
       return missionShow();
     case "pattern":
       return patternList();
+    case "evolve":
+      return evolveList();
   }
 }
 var STATE_CHANGING_COMMANDS = /* @__PURE__ */ new Set([
@@ -6930,23 +7311,23 @@ function requiresConfirmation(route) {
 async function runNaturalLanguageRoute(input) {
   const route = routeNaturalLanguage(input);
   if (!route) {
-    console.log(chalk34.yellow(`
+    console.log(chalk35.yellow(`
   \u2753 "${input}" \u2014 ${ko.nlp.notMatched}
 `));
     return;
   }
   console.log("");
-  console.log(chalk34.cyan(`  \u{1F4AC} "${input}"`));
-  console.log(chalk34.cyan(`  \u2192 ${route.explanation}`));
+  console.log(chalk35.cyan(`  \u{1F4AC} "${input}"`));
+  console.log(chalk35.cyan(`  \u2192 ${route.explanation}`));
   if (requiresConfirmation(route)) {
-    const { confirm } = await inquirer13.prompt([{
+    const { confirm } = await inquirer14.prompt([{
       type: "confirm",
       name: "confirm",
       message: `${route.explanation} \u2014 ${ko.nlp.matched}`,
       default: true
     }]);
     if (!confirm) {
-      console.log(chalk34.dim(`  ${ko.nlp.menuHint}`));
+      console.log(chalk35.dim(`  ${ko.nlp.menuHint}`));
       return;
     }
   }
@@ -6955,7 +7336,7 @@ async function runNaturalLanguageRoute(input) {
   if (riskAction) {
     await runGuarded(
       riskAction,
-      { channel: "nl", approved: false, log: (m) => console.log(chalk34.yellow(`  ${m}`)) },
+      { channel: "nl", approved: false, log: (m) => console.log(chalk35.yellow(`  ${m}`)) },
       () => dispatchNlpRoute(route, input)
     );
     return;
@@ -6964,80 +7345,80 @@ async function runNaturalLanguageRoute(input) {
 }
 
 // src/commands/agent.ts
-import chalk35 from "chalk";
+import chalk36 from "chalk";
 function activeGoalId() {
   const goals = listGoals("goals");
   const id = selectActiveId(goals);
   return id ?? void 0;
 }
 async function blocker(description) {
-  console.log(chalk35.bold(`
+  console.log(chalk36.bold(`
 ${ko.agent.blockerTitle}
 `));
   if (!description || !description.trim()) {
-    console.log(chalk35.red("  \u274C \uBE14\uB85C\uCEE4 \uC124\uBA85\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
-    console.log(chalk35.dim('  \uC608: vhk blocker "tsc \uC5D0\uB7EC \u2014 simple-git \uD0C0\uC785 \uD638\uD658"'));
+    console.log(chalk36.red("  \u274C \uBE14\uB85C\uCEE4 \uC124\uBA85\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
+    console.log(chalk36.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(chalk35.green(`  \u2705 blocker \uAE30\uB85D (\uD604\uC7AC \uD65C\uC131 ${r.count}\uAC74)`));
+  console.log(chalk36.green(`  \u2705 blocker \uAE30\uB85D (\uD604\uC7AC \uD65C\uC131 ${r.count}\uAC74)`));
   if (r.hardStopTripped) {
-    console.log(chalk35.red.bold("  \u{1F6D1} HARD_STOP \uC790\uB3D9 \uC0DD\uC131 \u2014 \uBAA8\uB4E0 \uC790\uB3D9\uD654 \uC911\uB2E8."));
-    console.log(chalk35.yellow("     \uC0AC\uB78C \uAC80\uD1A0 \uD6C4 `vhk resume --confirm` \uC73C\uB85C\uB9CC \uD574\uC81C."));
+    console.log(chalk36.red.bold("  \u{1F6D1} HARD_STOP \uC790\uB3D9 \uC0DD\uC131 \u2014 \uBAA8\uB4E0 \uC790\uB3D9\uD654 \uC911\uB2E8."));
+    console.log(chalk36.yellow("     \uC0AC\uB78C \uAC80\uD1A0 \uD6C4 `vhk resume --confirm` \uC73C\uB85C\uB9CC \uD574\uC81C."));
     process.exitCode = 2;
   }
 }
 async function learn(lesson) {
-  console.log(chalk35.bold(`
+  console.log(chalk36.bold(`
 ${ko.agent.learnTitle}
 `));
   if (!lesson || !lesson.trim()) {
-    console.log(chalk35.red("  \u274C \uAD50\uD6C8 \uB0B4\uC6A9\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
-    console.log(chalk35.dim('  \uC608: vhk learn "PowerShell \uC5D0\uC11C\uB294 ; \uC0AC\uC6A9 (&& \uBBF8\uC9C0\uC6D0)"'));
+    console.log(chalk36.red("  \u274C \uAD50\uD6C8 \uB0B4\uC6A9\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694."));
+    console.log(chalk36.dim('  \uC608: vhk learn "PowerShell \uC5D0\uC11C\uB294 ; \uC0AC\uC6A9 (&& \uBBF8\uC9C0\uC6D0)"'));
     process.exitCode = 1;
     return;
   }
   const goalId = activeGoalId();
   const entry = recordLesson(process.cwd(), lesson, goalId);
   if (!entry) {
-    console.log(chalk35.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."));
+    console.log(chalk36.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(chalk35.green(`  \u2705 \uAD50\uD6C8 \uAE30\uB85D \u2192 memory failures.lesson (${entry.id})`));
-  console.log(chalk35.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."));
+  console.log(chalk36.green(`  \u2705 \uAD50\uD6C8 \uAE30\uB85D \u2192 memory failures.lesson (${entry.id})`));
+  console.log(chalk36.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(chalk35.bold(`
+  console.log(chalk36.bold(`
 ${ko.agent.resumeTitle}
 `));
   if (!isHardStopActive()) {
-    console.log(chalk35.dim("  HARD_STOP \uD65C\uC131 \uC544\uB2D8 \u2014 \uD560 \uC77C \uC5C6\uC74C."));
+    console.log(chalk36.dim("  HARD_STOP \uD65C\uC131 \uC544\uB2D8 \u2014 \uD560 \uC77C \uC5C6\uC74C."));
     return;
   }
   const reason = readHardStopReason();
   if (reason) {
-    console.log(chalk35.yellow("  \u{1F4CB} HARD_STOP \uC0AC\uC720:"));
-    console.log(chalk35.dim(`     ${reason.split("\n").join("\n     ")}`));
+    console.log(chalk36.yellow("  \u{1F4CB} HARD_STOP \uC0AC\uC720:"));
+    console.log(chalk36.dim(`     ${reason.split("\n").join("\n     ")}`));
     console.log("");
   }
   if (!opts.confirm) {
     console.log(
-      chalk35.red(
+      chalk36.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(chalk35.yellow("     \uC0AC\uC720\uB97C \uD655\uC778\uD55C \uD6C4 \uB2E4\uC2DC: vhk resume --confirm"));
+    console.log(chalk36.yellow("     \uC0AC\uC720\uB97C \uD655\uC778\uD55C \uD6C4 \uB2E4\uC2DC: vhk resume --confirm"));
     process.exitCode = 1;
     return;
   }
   const removed = clearHardStop();
   if (removed) {
-    console.log(chalk35.green("  \u2705 HARD_STOP \uD574\uC81C. \uC790\uB3D9\uD654 \uC7AC\uAC1C \uAC00\uB2A5."));
+    console.log(chalk36.green("  \u2705 HARD_STOP \uD574\uC81C. \uC790\uB3D9\uD654 \uC7AC\uAC1C \uAC00\uB2A5."));
   } else {
-    console.log(chalk35.dim("  \uD30C\uC77C\uC774 \uC774\uBBF8 \uC5C6\uC74C \u2014 no-op."));
+    console.log(chalk36.dim("  \uD30C\uC77C\uC774 \uC774\uBBF8 \uC5C6\uC74C \u2014 no-op."));
   }
 }
 
@@ -7050,7 +7431,7 @@ async function guardCli(action, approved, run) {
       channel: "cli",
       approved,
       confirm: async () => {
-        const { ok } = await inquirer14.prompt([{
+        const { ok } = await inquirer15.prompt([{
           type: "confirm",
           name: "ok",
           message: `\u26A0\uFE0F \uC704\uD5D8 \uC791\uC5C5(${action})\uC744 \uC2E4\uD589\uD560\uAE4C\uC694?`,
@@ -7058,7 +7439,7 @@ async function guardCli(action, approved, run) {
         }]);
         return ok;
       },
-      log: (m) => console.log(chalk36.yellow(`  ${m}`))
+      log: (m) => console.log(chalk37.yellow(`  ${m}`))
     },
     run
   );
@@ -7071,7 +7452,7 @@ async function guardCliDefer(action, approved, run) {
       approved,
       // TTY 면 통과(명령이 자체 확인), 비대화형은 confirm 불가 → 가드가 차단.
       confirm: async () => !!process.stdout.isTTY,
-      log: (m) => console.log(chalk36.yellow(`  ${m}`))
+      log: (m) => console.log(chalk37.yellow(`  ${m}`))
     },
     run
   );
@@ -7115,7 +7496,8 @@ var KO_ALIASES = {
   blocker: "\uBE14\uB85C\uCEE4",
   learn: "\uAD50\uD6C8",
   resume: "\uC7AC\uAC1C",
-  pattern: "\uD328\uD134"
+  pattern: "\uD328\uD134",
+  evolve: "\uC9C4\uD654"
 };
 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(getVhkVersion());
 program.configureHelp({
@@ -7327,6 +7709,24 @@ patternCmd.command("list").alias("\uBAA9\uB85D").option("--kind <kind>", "avoid|
 patternCmd.command("dismiss <id>").alias("\uBCF4\uAD00").description("\uC624\uD0D0 \uD328\uD134 dismiss (\u2192archived, \uC7AC\uC81C\uC548 \uC548 \uB428)").action(async (id) => {
   await patternDismiss(id);
 });
+var evolveCmd = program.command("evolve").alias("\uC9C4\uD654").description("\uD328\uD134 \u2192 \uB8F0 \uD6C4\uBCF4 \uC81C\uC548\xB7\uBC18\uC601\xB7undo (Evolution Loop \uB3C4\uBBF8\uB178 4) \u2014 apply/undo\uB294 TTY \uD544\uC218").action(async () => {
+  await evolveList();
+});
+evolveCmd.command("suggest").alias("\uC81C\uC548").option("--json", "JSON \uCD9C\uB825 (CI/MCP\uC6A9)").description("active avoid \uD328\uD134 \u2192 \uB8F0 \uCD08\uC548 \uD6C4\uBCF4 \uC0DD\uC131\xB7\uD050 \uC801\uC7AC").action(async (opts) => {
+  await evolveSuggest(opts);
+});
+evolveCmd.command("list").alias("\uBAA9\uB85D").option("--status <status>", "pending|rejected|applied \uD544\uD130").option("--json", "JSON \uCD9C\uB825 (CI/MCP\uC6A9)").description("\uC9C4\uD654 \uD6C4\uBCF4 \uBAA9\uB85D").action(async (opts) => {
+  await evolveList(opts);
+});
+evolveCmd.command("apply <id>").alias("\uBC18\uC601").description("\uD6C4\uBCF4 TTY \uD655\uC778 \u2192 RULES.md append \u2192 sync \uC7AC\uC0DD\uC131 (\uB300\uD654\uD615 \uD544\uC218)").action(async (id) => {
+  await evolveApply(id);
+});
+evolveCmd.command("reject <id>").alias("\uAE30\uAC01").description("\uD6C4\uBCF4 \uAE30\uAC01 (\uC7AC\uC81C\uC548 \uC5B5\uC81C)").action(async (id) => {
+  await evolveReject(id);
+});
+evolveCmd.command("undo").alias("\uB418\uB3CC\uB9AC\uAE30").description("\uCD5C\uADFC apply 1\uAC74 \uB418\uB3CC\uB9AC\uAE30(.bak \uBCF5\uC6D0 + sync \u2014 \uB300\uD654\uD615 \uD544\uC218)").action(async () => {
+  await evolveUndo();
+});
 program.on("command:*", async (operands) => {
   const unknown = operands[0] ?? "";
   const rest = operands.slice(1);
@@ -7335,7 +7735,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 inquirer14.prompt([{
+  const { choice } = await inquirer15.prompt([{
     type: "list",
     name: "choice",
     message: "\uBB58 \uB3C4\uC640\uB4DC\uB9B4\uAE4C\uC694?",
@@ -7399,9 +7799,9 @@ if (isMainModule) {
     }
   } catch (err) {
     if (isPromptAbortError(err)) {
-      console.error(chalk36.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(chalk37.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(chalk36.red(`
+      console.error(chalk37.red(`
 \u274C ${err instanceof Error ? err.message : String(err)}`));
     }
     process.exitCode = 1;

package/dist/mcp/index.js

@@ -2,7 +2,7 @@
 import {
   resolveVhkCliInvocation,
   startMcpServer
-} from "../chunk-ODNKCGUG.js";
+} from "../chunk-WQWPM364.js";
 
 // src/mcp/index.ts
 var cli = resolveVhkCliInvocation();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byh3071/vhk",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "description": "Vibe Harness Kit — AI 코딩 도구·기기를 바꿔도 규칙·맥락이 따라가는 포터빌리티 CLI (sync: Cursor·Claude·Windsurf·Copilot·Antigravity / cloud 백업)",
   "bin": {
     "vhk": "dist/index.js",