@byh3071/vhk 1.8.1 → 1.9.0

package/README.md

@@ -175,6 +175,7 @@ vhk 기획 끝났고 바로 시작
 | `vhk memory` | `기억` | 결정사항 기억 관리 (`add` / `list` / `remove`, `.vhk/memory.json` 기반, 태그 지원) |
 | `vhk brief` | `브리핑` | 프로젝트 정보 + git 상태 + 결정사항 + 레퍼런스 통합 보고서 `.vhk/brief.md` |
 | `vhk goal` | `목표` | Goal 단계별 미션 관리 (`init` / `list` / `next` / `check` / `done`) — vspec/vooster 패턴 |
+| `vhk mission` | `미션` | 미션 계약(`set` / `check` / `clear`) — 작업 범위·금지선 선언·검증 (`.vhk/mission.json`, 경로 glob) |
 | `vhk blocker <설명>` | `블로커` | 블로커 1건 → `docs/state/blockers.md` append. 3건 누적 시 `.vhk/HARD_STOP` 자동 생성 |
 | `vhk learn <교훈>` | `교훈` | 교훈 1건 → `docs/state/learnings.md` append (memory.json 과 별도 SoT) |
 | `vhk resume --confirm` | `재개` | `.vhk/HARD_STOP` 해제 (사람 확인 필요, 자동 호출 금지) |

package/dist/index.js

@@ -48,8 +48,8 @@ import {
 // 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",
@@ -371,7 +377,8 @@ var CONTAINER_SUBCOMMANDS = {
   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 +388,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 +484,8 @@ var KNOWN_COMMAND_TOKENS = /* @__PURE__ */ new Set([
   "\uC0AC\uC804\uC810\uAC80",
   "review",
   "\uAC80\uD1A0",
+  "mission",
+  "\uBBF8\uC158",
   "help"
 ]);
 function isOptionToken(token) {
@@ -513,8 +523,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";
@@ -6009,6 +6019,183 @@ ${result.disclaimer}`));
   }
 }
 
+// src/commands/mission.ts
+import { existsSync as existsSync18, mkdirSync as mkdirSync12, writeFileSync as writeFileSync13, rmSync as rmSync3 } from "fs";
+import { join as join12 } from "path";
+import chalk32 from "chalk";
+import inquirer12 from "inquirer";
+import { simpleGit as simpleGit3 } from "simple-git";
+var MISSION_PATH_REL = join12(".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 = join12(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(join12(cwd, ".vhk"), { recursive: true });
+  writeFileSync13(join12(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 = join12(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 {
+    rmSync3(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",
@@ -6176,6 +6363,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 +6378,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 +6403,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 +6412,77 @@ 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(chalk34.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.")
+    chalk34.dim("  \uACB0\uC815\uC0AC\uD56D(decision)\uC740 `vhk memory add` \uB85C \uBCC4\uB3C4 \uAE30\uB85D \u2014 SoT \uBD84\uB9AC.")
   );
 }
 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 +6495,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 +6503,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 +6516,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 +6556,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,6 +6684,19 @@ 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();
 });
@@ -6551,7 +6754,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 +6811,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;

package/package.json

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