pai-zero 0.12.1 → 0.13.1

package/dist/bin/pai.js

@@ -54,6 +54,13 @@ var init_logger = __esm({
 });
 
 // src/core/config.ts
+var config_exports = {};
+__export(config_exports, {
+  createDefaultConfig: () => createDefaultConfig,
+  loadConfig: () => loadConfig,
+  normalizeMode: () => normalizeMode,
+  saveConfig: () => saveConfig
+});
 import path from "path";
 import { createRequire } from "module";
 import fs from "fs-extra";
@@ -2087,34 +2094,33 @@ async function provisionGitHub(ctx) {
   await Promise.all(dirs.map((d) => fs7.ensureDir(join4(ctx.cwd, d))));
   const handoffPath = join4(ctx.cwd, "handoff.md");
   if (!await fs7.pathExists(handoffPath)) {
-    const now = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
+    const now2 = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
     await fs7.writeFile(handoffPath, [
       `# Handoff \u2014 ${ctx.projectName}`,
       "",
-      `> \uB9C8\uC9C0\uB9C9 \uC5C5\uB370\uC774\uD2B8: ${now}`,
+      `> \uB9C8\uC9C0\uB9C9 \uC5C5\uB370\uC774\uD2B8: ${now2}`,
+      `> **\uCC38\uACE0**: \`<!-- roboco:start -->\` \uBE14\uB85D\uC740 \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 \uC2DC \uC790\uB3D9 \uAC31\uC2E0\uB429\uB2C8\uB2E4.`,
+      `>          \uADF8 \uC678 \uC139\uC158(\uB2E4\uC74C \uB2E8\uACC4, \uBA54\uBAA8)\uC740 \uC790\uC720\uB86D\uAC8C \uC218\uB3D9 \uD3B8\uC9D1 \uAC00\uB2A5.`,
       "",
-      "## \uC9C4\uD589 \uC911",
-      "- [ ] Ideation \uBB38\uC11C \uC791\uC131 \u2014 \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uD1B5\uD574 \uC544\uC774\uB514\uC5B4\uB97C \uAD6C\uCCB4\uD654 (\uB2F4\uB2F9: PAI > Design)",
+      "<!-- roboco:start -->",
+      "## \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 \uC0C1\uD0DC (roboco \uC790\uB3D9 \uAD00\uB9AC)",
       "",
-      "## \uB2E4\uC74C \uB2E8\uACC4",
-      "- [ ] Ideation \uAE30\uBC18 PRD \uC791\uC131 \u2014 \uC2EC\uCE35 \uC778\uD130\uBDF0\uB85C \uB9E5\uB77D/\uAE30\uC220 \uC81C\uC57D \uBCF4\uAC15",
-      "- [ ] \uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1 \uAD6C\uC131 \uD655\uC778 \u2014 \uC5D0\uC774\uC804\uD2B8 \uC791\uC5C5 \uD658\uACBD \uAC80\uC99D",
-      "- [ ] AI \uCF54\uB4DC \uC0DD\uC131 \uC2DC\uC791",
+      "\uD604\uC7AC \uB2E8\uACC4: **environment**",
       "",
-      "## \uC644\uB8CC",
-      `- [x] \uD504\uB85C\uC81D\uD2B8 \uCD08\uAE30\uD654 (${now}) (\uB2F4\uB2F9: PAI > Environment)`,
+      "### \uC644\uB8CC",
+      `- [x] environment (pai init, ${now2.slice(0, 10)})`,
+      "<!-- roboco:end -->",
       "",
-      "## \uC791\uC5C5 \uD30C\uC774\uD504\uB77C\uC778",
-      "```",
-      "1. /pai design \u2192 Ideation \uC2EC\uCE35 \uC778\uD130\uBDF0 \u2192 docs/ideation.md \uC0DD\uC131",
-      "2. /pai design \u2192 PRD \uC2EC\uCE35 \uC778\uD130\uBDF0 \u2192 docs/openspec.md \uC791\uC131",
-      "3. /pai design \u2192 \uAE30\uC220 \uC81C\uC57D \uC2EC\uCE35 \uC778\uD130\uBDF0 \u2192 \uD558\uB124\uC2A4 \uC5D4\uC9C0\uB2C8\uC5B4\uB9C1 \uD655\uC778",
-      "4. AI \uCF54\uB4DC \uC0DD\uC131 \u2192 \uAC80\uC99D \u2192 \uD3C9\uAC00",
-      "```",
+      "## \uB2E4\uC74C \uB2E8\uACC4",
+      "- [ ] `/pai design` \u2014 Ideation + PRD \uC2EC\uCE35 \uC778\uD130\uBDF0",
+      "- [ ] Claude Code\uB85C \uCF54\uB4DC \uC0DD\uC131",
+      "- [ ] `pai test` \u2014 \uD14C\uC2A4\uD2B8 + \uD558\uB124\uC2A4 \uAC80\uC99D",
+      "- [ ] `pai grade` \u2014 AI \uC900\uBE44\uB3C4 6\uCE74\uD14C\uACE0\uB9AC \uD3C9\uAC00",
       "",
       "## \uBA54\uBAA8",
       `- \uBAA8\uB4DC: ${ctx.mode}`,
-      "- \uCEE8\uD14D\uC2A4\uD2B8\uAC00 \uBD80\uC871\uD558\uBA74 AI\uAC00 \uC790\uB3D9\uC73C\uB85C \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4"
+      "- \uCEE8\uD14D\uC2A4\uD2B8\uAC00 \uBD80\uC871\uD558\uBA74 AI\uAC00 \uC790\uB3D9\uC73C\uB85C \uC2EC\uCE35 \uC778\uD130\uBDF0\uB97C \uC9C4\uD589\uD569\uB2C8\uB2E4",
+      "- \uB77D \uCDA9\uB3CC \uC2DC \uC989\uC2DC \uC2E4\uD328 (\uB2E4\uB978 PAI \uBA85\uB839\uC774 \uC9C4\uD589 \uC911\uC774\uBA74 \uC644\uB8CC \uD6C4 \uC7AC\uC2DC\uB3C4)"
     ].join("\n") + "\n");
   }
   const contribPath = join4(ctx.cwd, "CONTRIBUTING.md");
@@ -2485,13 +2491,20 @@ async function provisionGstack(ctx) {
 }
 async function provisionRoboco(ctx) {
   await fs7.ensureDir(join4(ctx.cwd, ".pai"));
-  const robocoPath = join4(ctx.cwd, ".pai", "roboco.json");
-  if (await fs7.pathExists(robocoPath)) return;
-  await fs7.writeJson(robocoPath, {
-    version: "1.0",
-    checks: ["github", "vercel", "supabase", "openspec", "omc"],
-    reportOutput: "AI_READINESS_REPORT.md",
-    note: "PAI Zero\uC5D0 \uB0B4\uC7AC\uD654\uB428. `pai evaluate`\uB85C \uC9C4\uB2E8 \uAC00\uB2A5."
+  const robocoPath2 = join4(ctx.cwd, ".pai", "roboco.json");
+  if (await fs7.pathExists(robocoPath2)) {
+    try {
+      const existing = await fs7.readJson(robocoPath2);
+      if (existing?.version === "2.0") return;
+    } catch {
+    }
+  }
+  await fs7.writeJson(robocoPath2, {
+    version: "2.0",
+    currentStage: "environment",
+    stageHistory: [],
+    lock: null,
+    gates: {}
   }, { spaces: 2 });
 }
 async function provisionHarness(ctx) {
@@ -3592,6 +3605,540 @@ var init_detector = __esm({
   }
 });
 
+// src/core/roboco.ts
+import os2 from "os";
+import path5 from "path";
+import fs10 from "fs-extra";
+function robocoPath(cwd) {
+  return path5.join(cwd, ROBOCO_PATH);
+}
+async function loadRobocoState(cwd) {
+  const p = robocoPath(cwd);
+  if (!await fs10.pathExists(p)) return freshState();
+  try {
+    const raw = await fs10.readJson(p);
+    if (raw?.version !== "2.0") return freshState();
+    return raw;
+  } catch {
+    return freshState();
+  }
+}
+async function saveRobocoState(cwd, state) {
+  const p = robocoPath(cwd);
+  await fs10.ensureDir(path5.dirname(p));
+  await fs10.writeJson(p, state, { spaces: 2 });
+}
+function freshState() {
+  return {
+    version: "2.0",
+    currentStage: "environment",
+    stageHistory: [],
+    lock: null,
+    gates: {}
+  };
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isLockStale(lock, now2 = /* @__PURE__ */ new Date()) {
+  if (!isProcessAlive(lock.pid)) return true;
+  if (new Date(lock.expiresAt).getTime() < now2.getTime()) return true;
+  return false;
+}
+async function acquireLock(cwd, stage, command, ttlMs = DEFAULT_TTL_MS) {
+  const state = await loadRobocoState(cwd);
+  if (state.lock) {
+    if (!isLockStale(state.lock)) {
+      throw new RobocoLockError(formatLockError(state.lock), state.lock);
+    }
+  }
+  const now2 = /* @__PURE__ */ new Date();
+  const newLock = {
+    pid: process.pid,
+    stage,
+    command,
+    acquiredAt: now2.toISOString(),
+    expiresAt: new Date(now2.getTime() + ttlMs).toISOString(),
+    host: os2.hostname()
+  };
+  state.lock = newLock;
+  await saveRobocoState(cwd, state);
+  return state;
+}
+async function releaseLock(cwd) {
+  const state = await loadRobocoState(cwd);
+  if (state.lock && state.lock.pid === process.pid) {
+    state.lock = null;
+    await saveRobocoState(cwd, state);
+  }
+}
+function formatLockError(lock) {
+  const started = new Date(lock.acquiredAt);
+  const mins = Math.round((Date.now() - started.getTime()) / 6e4);
+  return [
+    "\uB2E4\uB978 PAI \uBA85\uB839\uC774 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4",
+    `  stage:    ${lock.stage}`,
+    `  command:  ${lock.command}`,
+    `  \uC2DC\uC791:     ${mins}\uBD84 \uC804 (PID ${lock.pid}${lock.host ? ", host " + lock.host : ""})`,
+    "  \uB300\uAE30\uD558\uC9C0 \uC54A\uACE0 \uC989\uC2DC \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4. \uC644\uB8CC \uD6C4 \uC7AC\uC2DC\uB3C4\uD558\uC138\uC694."
+  ].join("\n");
+}
+async function markStageStart(cwd, stage, command) {
+  const state = await loadRobocoState(cwd);
+  state.currentStage = stage;
+  state.stageHistory.push({
+    stage,
+    status: "in_progress",
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    by: command
+  });
+  await saveRobocoState(cwd, state);
+}
+async function markStageEnd(cwd, stage, success2, reason) {
+  const state = await loadRobocoState(cwd);
+  for (let i = state.stageHistory.length - 1; i >= 0; i--) {
+    const entry = state.stageHistory[i];
+    if (entry.stage === stage && entry.status === "in_progress") {
+      entry.status = success2 ? "done" : "failed";
+      entry.endedAt = (/* @__PURE__ */ new Date()).toISOString();
+      if (reason) entry.reason = reason;
+      break;
+    }
+  }
+  await saveRobocoState(cwd, state);
+}
+async function saveGateResult(cwd, key, result) {
+  const state = await loadRobocoState(cwd);
+  state.gates[key] = result;
+  await saveRobocoState(cwd, state);
+}
+async function withRoboco(cwd, stage, command, options, fn) {
+  await acquireLock(cwd, stage, command, options.ttlMs);
+  try {
+    if (options.gate && !options.force) {
+      const result = await options.gate(cwd);
+      await saveGateResult(cwd, `${stage}.entry`, result);
+      if (!result.passed && !options.skipGates) {
+        await markStageEnd(cwd, stage, false, `\uAC8C\uC774\uD2B8 \uC2E4\uD328: ${result.name}`);
+        throw new GateFailedError(result);
+      }
+      if (!result.passed && options.skipGates) {
+      }
+    }
+    await markStageStart(cwd, stage, command);
+    const value = await fn();
+    await markStageEnd(cwd, stage, true);
+    return value;
+  } catch (err) {
+    if (!(err instanceof GateFailedError)) {
+      const msg = err instanceof Error ? err.message : String(err);
+      await markStageEnd(cwd, stage, false, msg).catch(() => {
+      });
+    }
+    throw err;
+  } finally {
+    await releaseLock(cwd).catch(() => {
+    });
+  }
+}
+async function syncHandoff(cwd) {
+  const handoffPath = path5.join(cwd, "handoff.md");
+  if (!await fs10.pathExists(handoffPath)) return;
+  const state = await loadRobocoState(cwd);
+  const block = buildHandoffBlock(state);
+  const content = await fs10.readFile(handoffPath, "utf8");
+  const startIdx = content.indexOf(HANDOFF_START);
+  const endIdx = content.indexOf(HANDOFF_END);
+  let next;
+  if (startIdx >= 0 && endIdx > startIdx) {
+    next = content.slice(0, startIdx) + block + content.slice(endIdx + HANDOFF_END.length);
+  } else {
+    const sep = content.endsWith("\n") ? "\n" : "\n\n";
+    next = content + sep + block + "\n";
+  }
+  await fs10.writeFile(handoffPath, next);
+}
+function buildHandoffBlock(state) {
+  const lines = [HANDOFF_START, "## \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 \uC0C1\uD0DC (roboco \uC790\uB3D9 \uAD00\uB9AC)", ""];
+  const done = state.stageHistory.filter((h) => h.status === "done");
+  const inProgress = state.stageHistory.filter((h) => h.status === "in_progress");
+  const failed = state.stageHistory.filter((h) => h.status === "failed");
+  if (inProgress.length > 0) {
+    lines.push("### \uC9C4\uD589 \uC911");
+    for (const h of inProgress) {
+      lines.push(`- [ ] ${h.stage} (${h.by}, \uC2DC\uC791 ${fmtDate(h.startedAt)})`);
+    }
+    lines.push("");
+  }
+  if (failed.length > 0) {
+    lines.push("### \uC2E4\uD328");
+    for (const h of failed) {
+      lines.push(`- [x] ${h.stage} \u2014 ${h.reason ?? "\uC6D0\uC778 \uBD88\uBA85"} (${fmtDate(h.startedAt)})`);
+    }
+    lines.push("");
+  }
+  if (done.length > 0) {
+    lines.push("### \uC644\uB8CC");
+    for (const h of done) {
+      lines.push(`- [x] ${h.stage} (${h.by}, ${fmtDate(h.endedAt ?? h.startedAt)})`);
+    }
+    lines.push("");
+  }
+  lines.push(`\uD604\uC7AC \uB2E8\uACC4: **${state.currentStage}**`);
+  lines.push(HANDOFF_END);
+  return lines.join("\n");
+}
+function fmtDate(iso) {
+  try {
+    const d = new Date(iso);
+    return d.toISOString().slice(0, 16).replace("T", " ");
+  } catch {
+    return iso;
+  }
+}
+var ROBOCO_PATH, DEFAULT_TTL_MS, RobocoLockError, GateFailedError, HANDOFF_START, HANDOFF_END;
+var init_roboco = __esm({
+  "src/core/roboco.ts"() {
+    "use strict";
+    ROBOCO_PATH = path5.join(".pai", "roboco.json");
+    DEFAULT_TTL_MS = 10 * 60 * 1e3;
+    RobocoLockError = class extends Error {
+      constructor(message, holder) {
+        super(message);
+        this.holder = holder;
+        this.name = "RobocoLockError";
+      }
+      holder;
+    };
+    GateFailedError = class extends Error {
+      constructor(result) {
+        super(`\uAC8C\uC774\uD2B8 \uC2E4\uD328 (${result.name}): ${result.violations.length}\uAC74 \uC704\uBC18`);
+        this.result = result;
+        this.name = "GateFailedError";
+      }
+      result;
+    };
+    HANDOFF_START = "<!-- roboco:start -->";
+    HANDOFF_END = "<!-- roboco:end -->";
+  }
+});
+
+// src/core/gates.ts
+var gates_exports = {};
+__export(gates_exports, {
+  STAGE_GATES: () => STAGE_GATES,
+  countBusinessRules: () => countBusinessRules,
+  countDomainObjects: () => countDomainObjects,
+  countEndpoints: () => countEndpoints,
+  designEntryGate: () => designEntryGate,
+  evaluationEntryGate: () => evaluationEntryGate,
+  executionEntryGate: () => executionEntryGate,
+  validateEdges: () => validateEdges,
+  validationEntryGate: () => validationEntryGate
+});
+import path6 from "path";
+import fs11 from "fs-extra";
+function now() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function makeResult(name, violations) {
+  return {
+    name,
+    passed: violations.length === 0,
+    checkedAt: now(),
+    violations
+  };
+}
+async function designEntryGate(cwd) {
+  const violations = [];
+  const claudeMd = path6.join(cwd, "CLAUDE.md");
+  if (!await fs11.pathExists(claudeMd)) {
+    violations.push({
+      rule: "claude-md-exists",
+      message: "CLAUDE.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 `pai init`\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
+      location: "CLAUDE.md"
+    });
+  }
+  const configJson = path6.join(cwd, ".pai", "config.json");
+  if (!await fs11.pathExists(configJson)) {
+    violations.push({
+      rule: "pai-config-exists",
+      message: "PAI \uC124\uC815\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `pai init`\uC744 \uC2E4\uD589\uD558\uC138\uC694.",
+      location: ".pai/config.json"
+    });
+  }
+  return makeResult("design.entry", violations);
+}
+async function executionEntryGate(cwd) {
+  const violations = [];
+  const openspec = path6.join(cwd, "docs", "openspec.md");
+  const hasOpenspec = await fs11.pathExists(openspec);
+  if (!hasOpenspec) {
+    violations.push({
+      rule: "openspec-exists",
+      message: "docs/openspec.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+      location: "docs/openspec.md"
+    });
+  } else {
+    const content = await fs11.readFile(openspec, "utf8");
+    const endpointCount = countEndpoints(content);
+    if (endpointCount < 1) {
+      violations.push({
+        rule: "openspec-endpoints-min",
+        message: `openspec.md\uC5D0 \uC815\uC758\uB41C API \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uAC00 0\uAC1C\uC785\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694. /pai design \uC2E4\uD589 \uAD8C\uC7A5.`,
+        location: "docs/openspec.md \xA7 5. API \uC5D4\uB4DC\uD3EC\uC778\uD2B8"
+      });
+    }
+  }
+  const omc = path6.join(cwd, ".pai", "omc.md");
+  if (await fs11.pathExists(omc)) {
+    const content = await fs11.readFile(omc, "utf8");
+    const domainCount = countDomainObjects(content);
+    if (domainCount < 1) {
+      violations.push({
+        rule: "omc-domain-min",
+        message: "omc.md\uC5D0 \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uAC00 0\uAC1C\uC785\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694.",
+        location: ".pai/omc.md \xA7 \uB3C4\uBA54\uC778 \uAC1D\uCCB4"
+      });
+    }
+  }
+  const edgeViolations = await validateEdges(cwd);
+  for (const ev of edgeViolations) {
+    violations.push({
+      rule: `edge-${ev.edge.from}-${ev.edge.to}`,
+      message: ev.message,
+      location: ev.edge.path
+    });
+  }
+  return makeResult("execution.entry", violations);
+}
+async function validationEntryGate(cwd) {
+  const violations = [];
+  const srcDir = path6.join(cwd, "src");
+  if (!await fs11.pathExists(srcDir)) {
+    violations.push({
+      rule: "src-dir-exists",
+      message: "src/ \uB514\uB809\uD1A0\uB9AC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+      location: "src/"
+    });
+  } else {
+    const codeFileCount = await countCodeFiles(srcDir);
+    if (codeFileCount === 0) {
+      violations.push({
+        rule: "code-files-min",
+        message: "src/ \uB0B4\uBD80\uC5D0 \uCF54\uB4DC \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uCD5C\uC18C 1\uAC1C \uD544\uC694.",
+        location: "src/"
+      });
+    }
+  }
+  const edgeViolations = await validateEdges(cwd);
+  for (const ev of edgeViolations) {
+    violations.push({
+      rule: `edge-${ev.edge.from}-${ev.edge.to}`,
+      message: ev.message,
+      location: ev.edge.path
+    });
+  }
+  return makeResult("validation.entry", violations);
+}
+async function evaluationEntryGate(cwd) {
+  const violations = [];
+  const state = await loadRobocoState(cwd);
+  const recentValidation = [...state.stageHistory].reverse().find((h) => h.stage === "validation");
+  if (!recentValidation) {
+    violations.push({
+      rule: "validation-executed",
+      message: "validation \uB2E8\uACC4\uAC00 \uD55C \uBC88\uB3C4 \uC2E4\uD589\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 `pai test`\uB97C \uC2E4\uD589\uD558\uC138\uC694."
+    });
+  } else if (recentValidation.status !== "done") {
+    violations.push({
+      rule: "validation-passed",
+      message: `\uCD5C\uADFC validation\uC774 ${recentValidation.status} \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uD14C\uC2A4\uD2B8\uB97C \uC131\uACF5\uC2DC\uD0A8 \uB4A4 \uC2DC\uB3C4\uD558\uC138\uC694.`
+    });
+  } else {
+    const endedAt = recentValidation.endedAt ?? recentValidation.startedAt;
+    const age = Date.now() - new Date(endedAt).getTime();
+    if (age > EVAL_GATE_WINDOW_MS) {
+      const mins = Math.round(age / 6e4);
+      violations.push({
+        rule: "validation-recent",
+        message: `\uCD5C\uADFC validation \uD1B5\uACFC\uAC00 ${mins}\uBD84 \uC804\uC785\uB2C8\uB2E4 (1\uC2DC\uAC04 \uC774\uB0B4\uC5EC\uC57C \uD568). --force\uB85C \uC6B0\uD68C \uAC00\uB2A5.`
+      });
+    }
+  }
+  return makeResult("evaluation.entry", violations);
+}
+function countEndpoints(openspecContent) {
+  const lines = openspecContent.split("\n");
+  let inTable = false;
+  let count = 0;
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (/^##\s*5\.|^##\s*API|API 엔드포인트/i.test(line)) {
+      inTable = true;
+      continue;
+    }
+    if (!inTable) continue;
+    if (/^##\s/.test(line) && !/5\.|API/i.test(line)) {
+      inTable = false;
+      continue;
+    }
+    if (/^\|\s*Method/i.test(line)) continue;
+    if (/^\|\s*[-:]+\s*\|/.test(line)) continue;
+    const m = line.match(/^\|\s*(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\s*\|\s*(\/\S+)\s*\|/i);
+    if (m) count++;
+  }
+  return count;
+}
+function countDomainObjects(omcContent) {
+  const lines = omcContent.split("\n");
+  let count = 0;
+  let inDomainSection = false;
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (/^##\s*도메인 객체|^##\s*Domain Objects/i.test(line)) {
+      inDomainSection = true;
+      continue;
+    }
+    if (!inDomainSection) continue;
+    if (/^##\s/.test(line) && !/도메인|Domain/i.test(line)) {
+      inDomainSection = false;
+      continue;
+    }
+    if (/^###\s+\w/.test(line)) count++;
+  }
+  return count;
+}
+async function validateEdges(cwd) {
+  const config = await loadConfig(cwd);
+  if (!config?.edges || config.edges.length === 0) return [];
+  const violations = [];
+  for (const edge of config.edges) {
+    if (edge.path) {
+      const fullPath = path6.join(cwd, edge.path);
+      if (!await fs11.pathExists(fullPath)) {
+        violations.push({
+          edge,
+          message: `${edge.from}\u2192${edge.to} \uACC4\uC57D \uD30C\uC77C \uC5C6\uC74C: ${edge.path}`
+        });
+        continue;
+      }
+    }
+    switch (edge.via) {
+      case "specFile":
+      case "endpoints": {
+        const specPath = edge.path ? path6.join(cwd, edge.path) : path6.join(cwd, "docs", "openspec.md");
+        if (await fs11.pathExists(specPath)) {
+          const content = await fs11.readFile(specPath, "utf8");
+          const count = countEndpoints(content);
+          if (count === 0) {
+            violations.push({
+              edge,
+              message: `${edge.from}\u2192${edge.to}: openspec.md\uC5D0 \uC815\uC758\uB41C \uC5D4\uB4DC\uD3EC\uC778\uD2B8\uAC00 0\uAC1C (\uCD5C\uC18C 1\uAC1C \uD544\uC694)`
+            });
+          }
+        }
+        break;
+      }
+      case "domain": {
+        const omcPath = edge.path ? path6.join(cwd, edge.path) : path6.join(cwd, ".pai", "omc.md");
+        if (await fs11.pathExists(omcPath)) {
+          const content = await fs11.readFile(omcPath, "utf8");
+          const count = countDomainObjects(content);
+          if (count === 0) {
+            violations.push({
+              edge,
+              message: `${edge.from}\u2192${edge.to}: omc.md\uC5D0 \uB3C4\uBA54\uC778 \uAC1D\uCCB4\uAC00 0\uAC1C (\uCD5C\uC18C 1\uAC1C \uD544\uC694)`
+            });
+          }
+        }
+        break;
+      }
+      case "businessRules": {
+        const omcPath = edge.path ? path6.join(cwd, edge.path) : path6.join(cwd, ".pai", "omc.md");
+        if (await fs11.pathExists(omcPath)) {
+          const content = await fs11.readFile(omcPath, "utf8");
+          const ruleCount = countBusinessRules(content);
+          if (ruleCount === 0) {
+            violations.push({
+              edge,
+              message: `${edge.from}\u2192${edge.to}: omc.md\uC5D0 \uBE44\uC988\uB2C8\uC2A4 \uADDC\uCE59\uC774 0\uAC1C \u2014 harness \uAC80\uC99D \uB300\uC0C1 \uC5C6\uC74C`
+            });
+          }
+        }
+        break;
+      }
+    }
+  }
+  return violations;
+}
+function countBusinessRules(omcContent) {
+  const lines = omcContent.split("\n");
+  let inSection = false;
+  let count = 0;
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (/^##\s*비즈니스 규칙|^##\s*Business Rules/i.test(line)) {
+      inSection = true;
+      continue;
+    }
+    if (!inSection) continue;
+    if (/^##\s/.test(line) && !/비즈니스|Business/i.test(line)) {
+      inSection = false;
+      continue;
+    }
+    if (/^-\s+\*\*/.test(line) || /^-\s+[^\s]/.test(line)) count++;
+  }
+  return count;
+}
+async function countCodeFiles(srcDir) {
+  const exts = /* @__PURE__ */ new Set([".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".rs", ".java", ".kt"]);
+  let count = 0;
+  async function walk(dir) {
+    let entries;
+    try {
+      entries = await fs11.readdir(dir);
+    } catch {
+      return;
+    }
+    for (const name of entries) {
+      if (name.startsWith(".") || name === "node_modules") continue;
+      const full = path6.join(dir, name);
+      const stat = await fs11.stat(full).catch(() => null);
+      if (!stat) continue;
+      if (stat.isDirectory()) {
+        await walk(full);
+      } else if (exts.has(path6.extname(name))) {
+        count++;
+      }
+    }
+  }
+  await walk(srcDir);
+  return count;
+}
+var EVAL_GATE_WINDOW_MS, STAGE_GATES;
+var init_gates = __esm({
+  "src/core/gates.ts"() {
+    "use strict";
+    init_roboco();
+    init_config();
+    EVAL_GATE_WINDOW_MS = 60 * 60 * 1e3;
+    STAGE_GATES = {
+      environment: async () => makeResult("environment.entry", []),
+      // 항상 통과
+      design: designEntryGate,
+      execution: executionEntryGate,
+      validation: validationEntryGate,
+      evaluation: evaluationEntryGate
+    };
+  }
+});
+
 // src/stages/environment/doctor.ts
 var doctor_exports = {};
 __export(doctor_exports, {
@@ -3599,7 +4146,7 @@ __export(doctor_exports, {
 });
 import { join as join6 } from "path";
 import { homedir } from "os";
-import fs10 from "fs-extra";
+import fs12 from "fs-extra";
 async function runDoctor() {
   section("PAI Doctor \u2014 \uD658\uACBD \uC9C4\uB2E8");
   const checks = [];
@@ -3619,7 +4166,7 @@ async function runDoctor() {
     fix: claudeCheck.ok ? void 0 : "npm install -g @anthropic-ai/claude-code"
   });
   const globalConfigPath = join6(homedir(), ".pai", "config.json");
-  const hasGlobalConfig = await fs10.pathExists(globalConfigPath);
+  const hasGlobalConfig = await fs12.pathExists(globalConfigPath);
   checks.push({
     label: "\uAE00\uB85C\uBC8C \uC124\uC815",
     ok: true,
@@ -3637,6 +4184,25 @@ async function runDoctor() {
     // optional이므로 항상 OK
     detail: hasSdk ? "\uC124\uCE58\uB428 (AI \uAE30\uB2A5 \uD65C\uC131\uD654)" : "\uBBF8\uC124\uCE58 (\uC815\uC801 \uBD84\uC11D \uBAA8\uB4DC)"
   });
+  const { validateEdges: validateEdges2 } = await Promise.resolve().then(() => (init_gates(), gates_exports));
+  const edgeViolations = await validateEdges2(process.cwd());
+  if (edgeViolations.length > 0) {
+    checks.push({
+      label: "\uACC4\uC57D \uBB34\uACB0\uC131 (edges)",
+      ok: false,
+      detail: `${edgeViolations.length}\uAC74 \uC704\uBC18`,
+      fix: edgeViolations.map((v) => v.message).join("; ")
+    });
+  } else {
+    const { loadConfig: loadCfg } = await Promise.resolve().then(() => (init_config(), config_exports));
+    const cfg = await loadCfg(process.cwd());
+    const edgeCount = cfg?.edges?.length ?? 0;
+    checks.push({
+      label: "\uACC4\uC57D \uBB34\uACB0\uC131 (edges)",
+      ok: true,
+      detail: edgeCount > 0 ? `${edgeCount}\uAC1C \uC5E3\uC9C0 \uBAA8\uB450 \uC720\uD6A8` : "\uC5E3\uC9C0 \uC5C6\uC74C (\uC815\uC0C1)"
+    });
+  }
   console.log("");
   let passed = 0;
   for (const check of checks) {
@@ -3675,8 +4241,8 @@ var init_doctor = __esm({
 });
 
 // src/utils/github-fetch.ts
-import path5 from "path";
-import fs11 from "fs-extra";
+import path7 from "path";
+import fs13 from "fs-extra";
 async function httpGet(url, timeoutMs, accept) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -3707,8 +4273,8 @@ async function downloadFile(downloadUrl, destPath, timeoutMs) {
     throw new Error(`Download failed ${res.status} ${res.statusText} (${downloadUrl})`);
   }
   const buf = Buffer.from(await res.arrayBuffer());
-  await fs11.ensureDir(path5.dirname(destPath));
-  await fs11.writeFile(destPath, buf);
+  await fs13.ensureDir(path7.dirname(destPath));
+  await fs13.writeFile(destPath, buf);
 }
 async function fetchGithubDir(opts) {
   const {
@@ -3732,10 +4298,10 @@ async function fetchGithubDir(opts) {
     for (const entry of entries) {
       const relName = entry.name;
       if (entry.type === "dir") {
-        await walk(`${currentSrc}/${relName}`, path5.join(currentDest, relName));
+        await walk(`${currentSrc}/${relName}`, path7.join(currentDest, relName));
       } else if (entry.type === "file") {
-        const destFile = path5.join(currentDest, relName);
-        if (!overwrite && await fs11.pathExists(destFile)) {
+        const destFile = path7.join(currentDest, relName);
+        if (!overwrite && await fs13.pathExists(destFile)) {
           result.skipped.push(destFile);
           continue;
         }
@@ -3767,8 +4333,8 @@ var fetch_cmd_exports = {};
 __export(fetch_cmd_exports, {
   fetchCommand: () => fetchCommand
 });
-import path6 from "path";
-import fs12 from "fs-extra";
+import path8 from "path";
+import fs14 from "fs-extra";
 import chalk4 from "chalk";
 async function fetchCommand(cwd, recipeKey, options) {
   if (options.list) {
@@ -3806,7 +4372,7 @@ async function fetchCommand(cwd, recipeKey, options) {
   const installed = [];
   for (const key of keys) {
     const recipe = RECIPES[key];
-    const targetDir = path6.join(cwd, recipe.target);
+    const targetDir = path8.join(cwd, recipe.target);
     console.log("");
     console.log(`  ${colors.accent(key)} \u2014 ${recipe.label}`);
     const result = await withSpinner(`\uB2E4\uC6B4\uB85C\uB4DC \uC911...`, async () => {
@@ -3828,7 +4394,7 @@ async function fetchCommand(cwd, recipeKey, options) {
     if (result.written.length > 0) {
       success(`${result.written.length}\uAC1C \uD30C\uC77C \uC800\uC7A5`);
       for (const f of result.written) {
-        console.log(chalk4.gray(`    ${path6.relative(cwd, f)}`));
+        console.log(chalk4.gray(`    ${path8.relative(cwd, f)}`));
       }
     }
     if (result.skipped.length > 0) {
@@ -3864,10 +4430,10 @@ async function fetchCommand(cwd, recipeKey, options) {
 }
 async function appendEnvKeys(cwd, recipe) {
   if (recipe.envKeys.length === 0) return;
-  const envPath = path6.join(cwd, ".env.local");
+  const envPath = path8.join(cwd, ".env.local");
   let content = "";
-  if (await fs12.pathExists(envPath)) {
-    content = await fs12.readFile(envPath, "utf8");
+  if (await fs14.pathExists(envPath)) {
+    content = await fs14.readFile(envPath, "utf8");
   }
   const missingKeys = recipe.envKeys.filter((ek) => !content.includes(`${ek.key}=`));
   if (missingKeys.length === 0) return;
@@ -3880,13 +4446,13 @@ async function appendEnvKeys(cwd, recipe) {
     if (ek.hint) lines.push(`# ${ek.hint}`);
     lines.push(`${ek.key}=${ek.default ?? ""}`);
   }
-  await fs12.ensureFile(envPath);
-  await fs12.appendFile(envPath, lines.join("\n") + "\n");
+  await fs14.ensureFile(envPath);
+  await fs14.appendFile(envPath, lines.join("\n") + "\n");
 }
 async function upsertRecipesSkill(cwd, installedKeys) {
-  const skillDir = path6.join(cwd, ".claude", "skills", "recipes");
-  await fs12.ensureDir(skillDir);
-  const skillPath = path6.join(skillDir, "SKILL.md");
+  const skillDir = path8.join(cwd, ".claude", "skills", "recipes");
+  await fs14.ensureDir(skillDir);
+  const skillPath = path8.join(skillDir, "SKILL.md");
   const recipes = installedKeys.map((k) => RECIPES[k]);
   const triggers = recipes.map((r) => r.skillDescription ?? `${r.label} \uAD00\uB828 \uAE30\uB2A5 \uAD6C\uD604 \uC2DC ${r.target}/ \uCC38\uC870`).join("\n- ");
   const body = [
@@ -3925,10 +4491,10 @@ async function upsertRecipesSkill(cwd, installedKeys) {
     "5. \uAC00\uC774\uB4DC \uC21C\uC11C\uC5D0 \uB530\uB77C \uAD6C\uD604 \u2014 \uB808\uC2DC\uD53C \uADDC\uCE59\uC744 \uC808\uB300 \uC6B0\uD68C\uD558\uC9C0 \uB9D0 \uAC83",
     ""
   ].join("\n");
-  await fs12.writeFile(skillPath, body);
+  await fs14.writeFile(skillPath, body);
 }
 async function upsertClaudeMdBlock(cwd, installedKeys) {
-  const claudeMdPath = path6.join(cwd, "CLAUDE.md");
+  const claudeMdPath = path8.join(cwd, "CLAUDE.md");
   const BLOCK_START = "<!-- pai:recipes:start -->";
   const BLOCK_END = "<!-- pai:recipes:end -->";
   const lines = [];
@@ -3948,8 +4514,8 @@ async function upsertClaudeMdBlock(cwd, installedKeys) {
   lines.push(BLOCK_END);
   const block = lines.join("\n");
   let content = "";
-  if (await fs12.pathExists(claudeMdPath)) {
-    content = await fs12.readFile(claudeMdPath, "utf8");
+  if (await fs14.pathExists(claudeMdPath)) {
+    content = await fs14.readFile(claudeMdPath, "utf8");
   }
   const startIdx = content.indexOf(BLOCK_START);
   const endIdx = content.indexOf(BLOCK_END);
@@ -3962,8 +4528,8 @@ async function upsertClaudeMdBlock(cwd, installedKeys) {
     if (content.length > 0) content += "\n";
     content += block + "\n";
   }
-  await fs12.ensureFile(claudeMdPath);
-  await fs12.writeFile(claudeMdPath, content);
+  await fs14.ensureFile(claudeMdPath);
+  await fs14.writeFile(claudeMdPath, content);
 }
 var init_fetch_cmd = __esm({
   "src/cli/commands/fetch.cmd.ts"() {
@@ -4197,7 +4763,7 @@ __export(analyzer_exports2, {
   analyzeRepository: () => analyzeRepository
 });
 import { join as join7 } from "path";
-import fs13 from "fs-extra";
+import fs15 from "fs-extra";
 async function analyzeRepository(repoPath) {
   try {
     return await aiAnalysis(repoPath);
@@ -4258,14 +4824,14 @@ async function checkTestCoverage(repoPath) {
     ".nycrc"
   ];
   for (const f of testConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, f));
+    const found = await fs15.pathExists(join7(repoPath, f));
     findings.push({ item: f, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += 20;
   }
   const testDirs = ["tests", "test", "__tests__", "spec"];
   let hasTestDir = false;
   for (const d of testDirs) {
-    if (await fs13.pathExists(join7(repoPath, d))) {
+    if (await fs15.pathExists(join7(repoPath, d))) {
       findings.push({ item: d, found: true, details: "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" });
       hasTestDir = true;
       score += 30;
@@ -4288,8 +4854,8 @@ async function checkCiCd(repoPath) {
     { path: "Jenkinsfile", label: "Jenkins" },
     { path: ".circleci", label: "CircleCI" }
   ];
-  for (const { path: path8, label } of ciConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  for (const { path: path10, label } of ciConfigs) {
+    const found = await fs15.pathExists(join7(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += 40;
   }
@@ -4307,8 +4873,8 @@ async function checkHooks(repoPath) {
     { path: "commitlint.config.js", label: "commitlint" },
     { path: ".claude/settings.json", label: "Claude Code settings" }
   ];
-  for (const { path: path8, label } of hookConfigs) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  for (const { path: path10, label } of hookConfigs) {
+    const found = await fs15.pathExists(join7(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += 20;
   }
@@ -4325,8 +4891,8 @@ async function checkRepoStructure(repoPath) {
     { path: ".env.example", label: "\uD658\uACBD\uBCC0\uC218 \uC608\uC2DC" },
     { path: ".gitignore", label: ".gitignore" }
   ];
-  for (const { path: path8, label } of structureChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  for (const { path: path10, label } of structureChecks) {
+    const found = await fs15.pathExists(join7(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += 25;
   }
@@ -4342,8 +4908,8 @@ async function checkDocumentation(repoPath) {
     { path: "docs", label: "docs/ \uB514\uB809\uD1A0\uB9AC", points: 25 },
     { path: "docs/openspec.md", label: "OpenSpec PRD", points: 25 }
   ];
-  for (const { path: path8, label, points } of docChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  for (const { path: path10, label, points } of docChecks) {
+    const found = await fs15.pathExists(join7(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += points;
   }
@@ -4361,8 +4927,8 @@ async function checkHarnessEngineering(repoPath) {
     { path: ".claude/commands", label: ".claude/commands/", points: 10 },
     { path: ".pai/config.json", label: "PAI config", points: 10 }
   ];
-  for (const { path: path8, label, points } of harnessChecks) {
-    const found = await fs13.pathExists(join7(repoPath, path8));
+  for (const { path: path10, label, points } of harnessChecks) {
+    const found = await fs15.pathExists(join7(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += points;
   }
@@ -4587,13 +5153,13 @@ function buildMarkdownReport(result) {
   return lines.join("\n") + "\n";
 }
 function buildDetailedReport(result, projectName) {
-  const now = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
+  const now2 = (/* @__PURE__ */ new Date()).toLocaleString("ko-KR");
   const mustCats = result.categories.filter((c2) => c2.tier === "must");
   const niceCats = result.categories.filter((c2) => c2.tier === "nice");
   const lines = [
     `# ${projectName} \uBC14\uC774\uBE0C \uCF54\uB529 \uC900\uBE44\uB3C4 \uBD84\uC11D \uB9AC\uD3EC\uD2B8`,
     "",
-    `> \uC2A4\uCE94 \uC77C\uC2DC: ${now}`,
+    `> \uC2A4\uCE94 \uC77C\uC2DC: ${now2}`,
     `> \uBD84\uC11D \uB300\uC0C1: ${projectName}`,
     "",
     "---",
@@ -4747,54 +5313,54 @@ __export(shell_cd_exports, {
 });
 import { join as join8 } from "path";
 import { homedir as homedir2 } from "os";
-import fs14 from "fs-extra";
+import fs16 from "fs-extra";
 async function requestCdAfter(targetDir) {
-  await fs14.ensureDir(PAI_DIR);
-  await fs14.writeFile(CD_FILE, targetDir);
+  await fs16.ensureDir(PAI_DIR);
+  await fs16.writeFile(CD_FILE, targetDir);
 }
 async function installShellHelper() {
-  await fs14.ensureDir(PAI_DIR);
+  await fs16.ensureDir(PAI_DIR);
   if (isWindows) {
     return installPowerShellHelper();
   }
   return installBashHelper();
 }
 async function installBashHelper() {
-  await fs14.writeFile(HELPER_FILE_SH, BASH_HELPER);
+  await fs16.writeFile(HELPER_FILE_SH, BASH_HELPER);
   const rcFile = getShellRcPath();
   const sourceLine = 'source "$HOME/.pai/shell-helper.sh"';
-  if (await fs14.pathExists(rcFile)) {
-    const content = await fs14.readFile(rcFile, "utf8");
+  if (await fs16.pathExists(rcFile)) {
+    const content = await fs16.readFile(rcFile, "utf8");
     if (content.includes("shell-helper.sh")) {
       return true;
     }
-    await fs14.appendFile(rcFile, `
+    await fs16.appendFile(rcFile, `
 # PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
 ${sourceLine}
 `);
     return false;
   }
-  await fs14.writeFile(rcFile, `${sourceLine}
+  await fs16.writeFile(rcFile, `${sourceLine}
 `);
   return false;
 }
 async function installPowerShellHelper() {
-  await fs14.writeFile(HELPER_FILE_PS1, POWERSHELL_HELPER);
+  await fs16.writeFile(HELPER_FILE_PS1, POWERSHELL_HELPER);
   const rcFile = getShellRcPath();
   const sourceLine = '. "$env:USERPROFILE\\.pai\\shell-helper.ps1"';
-  await fs14.ensureDir(join8(rcFile, ".."));
-  if (await fs14.pathExists(rcFile)) {
-    const content = await fs14.readFile(rcFile, "utf8");
+  await fs16.ensureDir(join8(rcFile, ".."));
+  if (await fs16.pathExists(rcFile)) {
+    const content = await fs16.readFile(rcFile, "utf8");
     if (content.includes("shell-helper.ps1")) {
       return true;
     }
-    await fs14.appendFile(rcFile, `
+    await fs16.appendFile(rcFile, `
 # PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
 ${sourceLine}
 `);
     return false;
   }
-  await fs14.writeFile(rcFile, `${sourceLine}
+  await fs16.writeFile(rcFile, `${sourceLine}
 `);
   return false;
 }
@@ -4856,11 +5422,11 @@ __export(claude_settings_exports, {
   isAlreadyEnabled: () => isAlreadyEnabled,
   mergeOmcIntoSettings: () => mergeOmcIntoSettings
 });
-import os2 from "os";
-import path7 from "path";
-import fs15 from "fs-extra";
-function getClaudeSettingsPath(homeDir = os2.homedir()) {
-  return path7.join(homeDir, ".claude", "settings.json");
+import os3 from "os";
+import path9 from "path";
+import fs17 from "fs-extra";
+function getClaudeSettingsPath(homeDir = os3.homedir()) {
+  return path9.join(homeDir, ".claude", "settings.json");
 }
 function parseJsonWithBom(raw) {
   const stripped = raw.charCodeAt(0) === 65279 ? raw.slice(1) : raw;
@@ -4875,13 +5441,13 @@ async function enableOmcPlugin(options = {}) {
   const pluginId = options.pluginId ?? DEFAULT_PLUGIN_ID;
   const wantBackup = options.backup ?? true;
   const settingsPath = getClaudeSettingsPath();
-  await fs15.ensureDir(path7.dirname(settingsPath));
-  if (!await fs15.pathExists(settingsPath)) {
+  await fs17.ensureDir(path9.dirname(settingsPath));
+  if (!await fs17.pathExists(settingsPath)) {
     const skeleton = buildSkeleton(marketplaceId, marketplaceUrl, pluginId);
-    await fs15.writeFile(settingsPath, JSON.stringify(skeleton, null, 2) + "\n", "utf8");
+    await fs17.writeFile(settingsPath, JSON.stringify(skeleton, null, 2) + "\n", "utf8");
     return { action: "created", settingsPath };
   }
-  const raw = await fs15.readFile(settingsPath, "utf8");
+  const raw = await fs17.readFile(settingsPath, "utf8");
   let parsed;
   try {
     const value = parseJsonWithBom(raw);
@@ -4891,7 +5457,7 @@ async function enableOmcPlugin(options = {}) {
     parsed = value;
   } catch (err) {
     const backupPath2 = `${settingsPath}.backup-${timestampSuffix()}`;
-    await fs15.copy(settingsPath, backupPath2);
+    await fs17.copy(settingsPath, backupPath2);
     throw new ClaudeSettingsError(
       `settings.json \uD30C\uC2F1 \uC2E4\uD328: ${err.message}. \uBC31\uC5C5: ${backupPath2}`,
       backupPath2
@@ -4903,10 +5469,10 @@ async function enableOmcPlugin(options = {}) {
   let backupPath;
   if (wantBackup) {
     backupPath = `${settingsPath}.backup-${timestampSuffix()}`;
-    await fs15.copy(settingsPath, backupPath);
+    await fs17.copy(settingsPath, backupPath);
   }
   const merged = mergeOmcIntoSettings(parsed, marketplaceId, marketplaceUrl, pluginId);
-  await fs15.writeFile(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+  await fs17.writeFile(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
   return { action: "added", settingsPath, backupPath };
 }
 function buildSkeleton(marketplaceId, marketplaceUrl, pluginId) {
@@ -5005,13 +5571,13 @@ function getCachedResult(repoPath) {
 function setCachedResult(repoPath, llmOutput) {
   const store = loadCache(repoPath);
   const repoHash = computeRepoHash(repoPath);
-  const now = Date.now();
+  const now2 = Date.now();
   for (const [key, entry] of Object.entries(store.entries)) {
-    if (now - entry.timestamp > CACHE_TTL_MS) {
+    if (now2 - entry.timestamp > CACHE_TTL_MS) {
       delete store.entries[key];
     }
   }
-  store.entries[repoHash] = { repoPath, repoHash, timestamp: now, llmOutput };
+  store.entries[repoHash] = { repoPath, repoHash, timestamp: now2, llmOutput };
   saveCache(repoPath, store);
 }
 var CACHE_DIR, CACHE_FILE, CACHE_TTL_MS, FILES_TO_HASH;
@@ -5042,59 +5608,270 @@ var init_cache = __esm({
   }
 });
 
-// src/cli/commands/evaluate.cmd.ts
-var evaluate_cmd_exports = {};
-__export(evaluate_cmd_exports, {
-  evaluateCommand: () => evaluateCommand
-});
-import { join as join10, basename } from "path";
-import fs16 from "fs-extra";
-async function evaluateCommand(cwd, options) {
-  const useCache = options.cache !== false;
-  let llmOutput = useCache ? getCachedResult(cwd) : null;
-  if (llmOutput) {
-    info("\uCE90\uC2DC\uB41C \uACB0\uACFC \uC0AC\uC6A9 (24\uC2DC\uAC04 \uC774\uB0B4)");
-  } else {
-    llmOutput = await analyzeRepository(cwd);
-    if (useCache) {
-      setCachedResult(cwd, llmOutput);
+// src/stages/validation/runner.ts
+import { join as join10 } from "path";
+import fs18 from "fs-extra";
+async function runTests(cwd) {
+  const start = Date.now();
+  const gstackPath = join10(cwd, ".pai", "gstack.json");
+  let runner = "npm test";
+  if (await fs18.pathExists(gstackPath)) {
+    try {
+      const config = await fs18.readJson(gstackPath);
+      if (config.testRunner === "vitest") runner = "npx vitest run";
+      else if (config.testRunner === "jest") runner = "npx jest";
+      else if (config.testRunner === "mocha") runner = "npx mocha";
+    } catch {
     }
   }
-  const result = computeResult(llmOutput);
-  printReport(result);
-  if (options.verbose) {
-    printVerboseFindings(result);
-  }
-  const config = await loadConfig(cwd);
-  const projectName = config?.projectName ?? basename(cwd);
-  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const reportDir = join10(cwd, "docs", "p-reports");
-  const reportPath = join10(reportDir, `${today}.md`);
-  await fs16.ensureDir(reportDir);
-  const detailedReport = buildDetailedReport(result, projectName);
-  await fs16.writeFile(reportPath, detailedReport, "utf8");
-  console.log("");
-  success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
-  console.log("");
-  console.log(detailedReport);
-  if (options.output) {
-    await fs16.writeFile(options.output, detailedReport, "utf8");
-    success(`\uCD94\uAC00 \uC800\uC7A5: ${options.output}`);
+  const pkgPath = join10(cwd, "package.json");
+  if (await fs18.pathExists(pkgPath)) {
+    try {
+      const pkg5 = await fs18.readJson(pkgPath);
+      if (!pkg5.scripts?.test || pkg5.scripts.test.includes("no test specified")) {
+        return {
+          runner,
+          passed: false,
+          output: "\uD14C\uC2A4\uD2B8 \uC2A4\uD06C\uB9BD\uD2B8\uAC00 \uC815\uC758\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. package.json\uC758 scripts.test\uB97C \uC124\uC815\uD558\uC138\uC694.",
+          duration: Date.now() - start
+        };
+      }
+    } catch {
+    }
   }
-  if (options.failUnder && result.totalScore < options.failUnder) {
-    error(`\uC810\uC218 ${result.totalScore}\uC774 \uCD5C\uC18C \uAE30\uC900 ${options.failUnder}\uC5D0 \uBBF8\uB2EC\uD569\uB2C8\uB2E4.`);
-    process.exitCode = 1;
+  try {
+    const { execa } = await import("execa");
+    const { stdout, stderr } = await execa("npm", ["test"], {
+      cwd,
+      timeout: 12e4,
+      env: { ...process.env, CI: "true" }
+    });
+    return {
+      runner,
+      passed: true,
+      output: stdout || stderr,
+      duration: Date.now() - start
+    };
+  } catch (err) {
+    const output = err instanceof Error ? err.message : String(err);
+    return {
+      runner,
+      passed: false,
+      output,
+      duration: Date.now() - start
+    };
   }
 }
-var init_evaluate_cmd = __esm({
-  "src/cli/commands/evaluate.cmd.ts"() {
+var init_runner = __esm({
+  "src/stages/validation/runner.ts"() {
     "use strict";
-    init_ui();
-    init_analyzer2();
-    init_scorer();
+  }
+});
+
+// src/stages/validation/harness.ts
+import { join as join11 } from "path";
+import fs19 from "fs-extra";
+async function runHarnessCheck(cwd) {
+  const harnessPath = join11(cwd, ".pai", "harness.json");
+  if (!await fs19.pathExists(harnessPath)) {
+    return { enabled: false, specFile: null, rules: [], checks: [] };
+  }
+  let config;
+  try {
+    config = await fs19.readJson(harnessPath);
+  } catch {
+    return { enabled: false, specFile: null, rules: [], checks: [] };
+  }
+  const specFile = config.specFile ?? "docs/openspec.md";
+  const rules = config.rules ?? [];
+  const checks = [];
+  if (rules.includes("spec-implementation-match")) {
+    const specExists = await fs19.pathExists(join11(cwd, specFile));
+    const srcExists = await fs19.pathExists(join11(cwd, "src"));
+    checks.push({
+      rule: "spec-implementation-match",
+      passed: specExists && srcExists,
+      detail: specExists && srcExists ? "\uC124\uACC4 \uBB38\uC11C\uC640 \uC18C\uC2A4 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : `${!specExists ? specFile + " \uC5C6\uC74C" : ""} ${!srcExists ? "src/ \uC5C6\uC74C" : ""}`.trim()
+    });
+  }
+  if (rules.includes("api-contract-test")) {
+    const testDir = await fs19.pathExists(join11(cwd, "tests"));
+    const testDir2 = await fs19.pathExists(join11(cwd, "test"));
+    checks.push({
+      rule: "api-contract-test",
+      passed: testDir || testDir2,
+      detail: testDir || testDir2 ? "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC(tests/ \uB610\uB294 test/) \uC5C6\uC74C"
+    });
+  }
+  return { enabled: true, specFile, rules, checks };
+}
+var init_harness = __esm({
+  "src/stages/validation/harness.ts"() {
+    "use strict";
+  }
+});
+
+// src/cli/commands/validate.cmd.ts
+var validate_cmd_exports = {};
+__export(validate_cmd_exports, {
+  handleRobocoCliError: () => handleRobocoError,
+  validateCommand: () => validateCommand
+});
+async function validateCommand(cwd, options = {}) {
+  try {
+    await withRoboco(
+      cwd,
+      "validation",
+      "pai test",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.validation },
+      async () => {
+        section("\uD14C\uC2A4\uD2B8 \uC2E4\uD589");
+        const testResult = await runTests(cwd);
+        if (testResult.passed) {
+          success(`\uD14C\uC2A4\uD2B8 \uD1B5\uACFC (${testResult.runner}, ${testResult.duration}ms)`);
+        } else {
+          error("\uD14C\uC2A4\uD2B8 \uC2E4\uD328");
+          info(testResult.output.slice(0, 300));
+        }
+        section("\uD558\uB124\uC2A4 \uAC80\uC99D");
+        const harness = await runHarnessCheck(cwd);
+        if (!harness.enabled) {
+          info("Harness \uC124\uC815 \uC5C6\uC74C \u2014 \uAC74\uB108\uB700");
+          info("\uC124\uC815 \uCD94\uAC00: `pai add` \uC5D0\uC11C Harness Engineering \uC120\uD0DD");
+        } else {
+          for (const check of harness.checks) {
+            if (check.passed) {
+              success(`${check.rule}: ${check.detail}`);
+            } else {
+              warn(`${check.rule}: ${check.detail}`);
+            }
+          }
+        }
+        const allPassed = testResult.passed && harness.checks.every((c2) => c2.passed);
+        console.log("");
+        if (allPassed) {
+          success("\uAC80\uC99D \uD1B5\uACFC!");
+        } else if (!testResult.passed) {
+          error("\uAC80\uC99D \uC2E4\uD328 \u2014 \uD14C\uC2A4\uD2B8\uB97C \uC218\uC815\uD558\uC138\uC694.");
+          throw new Error("tests-failed");
+        } else {
+          warn("\uBD80\uBD84 \uD1B5\uACFC \u2014 \uD558\uB124\uC2A4 \uAC80\uC99D \uD56D\uBAA9\uC744 \uD655\uC778\uD558\uC138\uC694.");
+        }
+      }
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
+  }
+}
+function handleRobocoError(err) {
+  if (err instanceof RobocoLockError) {
+    error(err.message);
+    process.exitCode = 1;
+    return;
+  }
+  if (err instanceof GateFailedError) {
+    error(`\uB2E8\uACC4 \uC9C4\uC785 \uC2E4\uD328 (${err.result.name})`);
+    for (const v of err.result.violations) {
+      warn(`  \xB7 ${v.message}${v.location ? ` [${v.location}]` : ""}`);
+    }
+    hint("\uC6B0\uD68C \uC635\uC158: --skip-gates (\uACBD\uACE0\uB9CC) / --force (\uAC8C\uC774\uD2B8 \uBB34\uC2DC)");
+    process.exitCode = 1;
+    return;
+  }
+  if (err instanceof Error) {
+    if (err.message === "tests-failed") {
+      process.exitCode = 1;
+      return;
+    }
+    error(err.message);
+    process.exitCode = 1;
+    return;
+  }
+  throw err;
+}
+var init_validate_cmd = __esm({
+  "src/cli/commands/validate.cmd.ts"() {
+    "use strict";
+    init_ui();
+    init_runner();
+    init_harness();
+    init_roboco();
+    init_gates();
+  }
+});
+
+// src/cli/commands/evaluate.cmd.ts
+var evaluate_cmd_exports = {};
+__export(evaluate_cmd_exports, {
+  evaluateCommand: () => evaluateCommand
+});
+import { join as join12, basename } from "path";
+import fs20 from "fs-extra";
+async function evaluateCommand(cwd, options) {
+  const useCache = options.cache !== false;
+  try {
+    await withRoboco(
+      cwd,
+      "evaluation",
+      "pai grade",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.evaluation },
+      async () => {
+        let llmOutput = useCache ? getCachedResult(cwd) : null;
+        if (llmOutput) {
+          info("\uCE90\uC2DC\uB41C \uACB0\uACFC \uC0AC\uC6A9 (24\uC2DC\uAC04 \uC774\uB0B4)");
+        } else {
+          llmOutput = await analyzeRepository(cwd);
+          if (useCache) setCachedResult(cwd, llmOutput);
+        }
+        const result = computeResult(llmOutput);
+        printReport(result);
+        if (options.verbose) printVerboseFindings(result);
+        const config = await loadConfig(cwd);
+        const projectName = config?.projectName ?? basename(cwd);
+        const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+        const reportDir = join12(cwd, "docs", "p-reports");
+        const reportPath = join12(reportDir, `${today}.md`);
+        await fs20.ensureDir(reportDir);
+        const detailedReport = buildDetailedReport(result, projectName);
+        await fs20.writeFile(reportPath, detailedReport, "utf8");
+        console.log("");
+        success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
+        console.log("");
+        console.log(detailedReport);
+        if (options.output) {
+          await fs20.writeFile(options.output, detailedReport, "utf8");
+          success(`\uCD94\uAC00 \uC800\uC7A5: ${options.output}`);
+        }
+        if (options.failUnder && result.totalScore < options.failUnder) {
+          error(`\uC810\uC218 ${result.totalScore}\uC774 \uCD5C\uC18C \uAE30\uC900 ${options.failUnder}\uC5D0 \uBBF8\uB2EC\uD569\uB2C8\uB2E4.`);
+          throw new Error("score-below-threshold");
+        }
+      }
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    if (err instanceof Error && err.message === "score-below-threshold") {
+      process.exitCode = 1;
+      return;
+    }
+    handleRobocoError(err);
+  }
+}
+var init_evaluate_cmd = __esm({
+  "src/cli/commands/evaluate.cmd.ts"() {
+    "use strict";
+    init_ui();
+    init_analyzer2();
+    init_scorer();
     init_cache();
     init_reporter();
     init_config();
+    init_roboco();
+    init_gates();
+    init_validate_cmd();
   }
 });
 
@@ -5105,7 +5882,22 @@ __export(env_cmd_exports, {
   envSetupCommand: () => envSetupCommand,
   envStatusCommand: () => envStatusCommand
 });
-async function envSetupCommand(cwd) {
+async function envSetupCommand(cwd, options = {}) {
+  try {
+    await withRoboco(
+      cwd,
+      "environment",
+      "pai add",
+      { skipGates: options.skipGates, force: options.force },
+      async () => envSetupCommandInner(cwd)
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
+  }
+}
+async function envSetupCommandInner(cwd) {
   const { default: inquirer } = await import("inquirer");
   const { basename: basename5 } = await import("path");
   section("\uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 \xB7 \uBAA8\uB4DC \uC2B9\uACA9");
@@ -5231,6 +6023,54 @@ async function envStatusCommand(cwd) {
       hint(`\uC2B9\uACA9 \uACBD\uB85C: ${state.projectMode} \u2192 ${next} (pai add \uC5D0\uC11C \uC2B9\uACA9 \uAC00\uB2A5)`);
     }
   }
+  const robo = await loadRobocoState(cwd);
+  console.log("");
+  console.log(colors.accent("  \uD30C\uC774\uD504\uB77C\uC778 \uC9C4\uD589 (roboco)"));
+  console.log(colors.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  const stages = ["environment", "design", "execution", "validation", "evaluation"];
+  for (const s of stages) {
+    const latest = [...robo.stageHistory].reverse().find((h) => h.stage === s);
+    const gate = robo.gates[`${s}.entry`];
+    let mark = "\u25CB";
+    let label = "\uB300\uAE30";
+    if (latest?.status === "done") {
+      mark = "\u2713";
+      label = "\uC644\uB8CC";
+    } else if (latest?.status === "in_progress") {
+      mark = "\u25B8";
+      label = "\uC9C4\uD589 \uC911";
+    } else if (latest?.status === "failed") {
+      mark = "\u2717";
+      label = `\uC2E4\uD328 (${latest.reason ?? "\uC6D0\uC778 \uBD88\uBA85"})`;
+    } else if (gate && !gate.passed) {
+      mark = "\u25CB";
+      label = `\uB300\uAE30 (\uAC8C\uC774\uD2B8 ${gate.violations.length}\uAC74 \uBBF8\uD1B5\uACFC)`;
+    }
+    console.log(`  ${mark} ${s.padEnd(12)} ${colors.dim(label)}`);
+  }
+  const failedGates = Object.values(robo.gates).filter((g) => !g.passed);
+  if (failedGates.length > 0) {
+    console.log("");
+    console.log(colors.accent("  \uBBF8\uD1B5\uACFC \uAC8C\uC774\uD2B8"));
+    for (const g of failedGates) {
+      console.log(`  \u2717 ${g.name}`);
+      for (const v of g.violations) {
+        console.log(colors.dim(`      \xB7 ${v.message}`));
+      }
+    }
+  }
+  console.log("");
+  if (robo.lock) {
+    const stale = isLockStale(robo.lock);
+    const mins = Math.round((Date.now() - new Date(robo.lock.acquiredAt).getTime()) / 6e4);
+    if (stale) {
+      warn(`\uB77D stale (${robo.lock.command}, PID ${robo.lock.pid}) \u2014 \uB2E4\uC74C \uBA85\uB839 \uC2DC \uC790\uB3D9 \uD574\uC81C\uB428`);
+    } else {
+      warn(`\uC9C4\uD589 \uC911: ${robo.lock.command} (PID ${robo.lock.pid}, ${mins}\uBD84 \uC804)`);
+    }
+  } else {
+    success("\uB77D \uC5C6\uC74C (\uC5B4\uB290 \uBA85\uB839\uC774\uB4E0 \uC2E4\uD589 \uAC00\uB2A5)");
+  }
 }
 var init_env_cmd = __esm({
   "src/cli/commands/env.cmd.ts"() {
@@ -5242,6 +6082,8 @@ var init_env_cmd = __esm({
     init_doctor();
     init_analyzer();
     init_logger();
+    init_roboco();
+    init_validate_cmd();
   }
 });
 
@@ -5250,8 +6092,8 @@ var init_cmd_exports = {};
 __export(init_cmd_exports, {
   initCommand: () => initCommand
 });
-import { join as join11, basename as basename2 } from "path";
-import fs17 from "fs-extra";
+import { join as join13, basename as basename2 } from "path";
+import fs21 from "fs-extra";
 async function initCommand(cwd, nameArg) {
   printWelcomeBanner();
   const { isWindows: isWindows2, diagnoseWindowsEnv: diagnoseWindowsEnv2 } = await Promise.resolve().then(() => (init_platform(), platform_exports));
@@ -5309,11 +6151,11 @@ async function initCommand(cwd, nameArg) {
           const evalResult = computeResult2(llmOutput);
           printReport2(evalResult);
           const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-          const reportDir = join11(cwd, "docs", "p-reports");
-          await fs17.ensureDir(reportDir);
+          const reportDir = join13(cwd, "docs", "p-reports");
+          await fs21.ensureDir(reportDir);
           const legacyName = basename2(cwd);
           const detailedReport = buildDetailedReport3(evalResult, legacyName);
-          await fs17.writeFile(join11(reportDir, `${today}.md`), detailedReport, "utf8");
+          await fs21.writeFile(join13(reportDir, `${today}.md`), detailedReport, "utf8");
           console.log("");
           success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
         } catch {
@@ -5358,8 +6200,8 @@ async function initCommand(cwd, nameArg) {
     }]);
     projectName = answer.name.trim();
   }
-  const projectDir = join11(cwd, projectName);
-  if (await fs17.pathExists(projectDir)) {
+  const projectDir = join13(cwd, projectName);
+  if (await fs21.pathExists(projectDir)) {
     const existingConfig = await loadConfig(projectDir);
     if (existingConfig) {
       console.log("");
@@ -5372,7 +6214,7 @@ async function initCommand(cwd, nameArg) {
     warn(`${projectName}/ \uD3F4\uB354\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4.`);
     hint("\uC774 \uD3F4\uB354\uC5D0 PAI\uB97C \uC124\uCE58\uD569\uB2C8\uB2E4.");
   } else {
-    await fs17.ensureDir(projectDir);
+    await fs21.ensureDir(projectDir);
     success(`${projectName}/ \uD3F4\uB354 \uC0DD\uC131`);
   }
   await setupInDirectory(projectDir, projectName);
@@ -5457,7 +6299,7 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
     ...extraTools.includes("omc") ? [{ label: "OMC \uB7F0\uD0C0\uC784", path: ".omc" }] : []
   ];
   for (const check of checks) {
-    const exists = await fs17.pathExists(join11(projectDir, check.path));
+    const exists = await fs21.pathExists(join13(projectDir, check.path));
     console.log(`  ${exists ? colors.success("\u2713") : colors.err("\u2717")} ${check.label.padEnd(16)} ${colors.dim(check.path)}`);
   }
   console.log("");
@@ -5482,10 +6324,10 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
       printReport2(evalResult);
       await sleep2(500);
       const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-      const reportDir = join11(projectDir, "docs", "p-reports");
-      await fs17.ensureDir(reportDir);
+      const reportDir = join13(projectDir, "docs", "p-reports");
+      await fs21.ensureDir(reportDir);
       const detailedReport = buildDetailedReport3(evalResult, projectName);
-      await fs17.writeFile(join11(reportDir, `${today}.md`), detailedReport, "utf8");
+      await fs21.writeFile(join13(reportDir, `${today}.md`), detailedReport, "utf8");
       await sleep2(500);
       console.log("");
       success(`\uB9AC\uD3EC\uD2B8 \uC800\uC7A5: docs/p-reports/${today}.md`);
@@ -5536,7 +6378,7 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
   const shellRc = getShellRcPath2();
   let yoloAlreadyAliased = false;
   try {
-    const rcContent = await fs17.readFile(shellRc, "utf8");
+    const rcContent = await fs21.readFile(shellRc, "utf8");
     yoloAlreadyAliased = checkYolo(rcContent);
   } catch {
   }
@@ -5556,10 +6398,10 @@ async function showCompletion(projectName, projectDir, extraTools, isCurrentDir)
     try {
       const { getYoloAliasLine: getYoloAliasLine2 } = await Promise.resolve().then(() => (init_platform(), platform_exports));
       const aliasLine = getYoloAliasLine2();
-      const rcContent = await fs17.readFile(shellRc, "utf8").catch(() => "");
+      const rcContent = await fs21.readFile(shellRc, "utf8").catch(() => "");
       if (!rcContent.includes("claude-yolo")) {
-        await fs17.ensureDir(join11(shellRc, ".."));
-        await fs17.appendFile(shellRc, `
+        await fs21.ensureDir(join13(shellRc, ".."));
+        await fs21.appendFile(shellRc, `
 # PAI \u2014 claude-YOLO mode
 ${aliasLine}
 `);
@@ -5752,9 +6594,9 @@ async function installOrchestratorOnly(projectDir, projectName) {
     const evalResult = computeResult2(llmOutput);
     printReport2(evalResult);
     const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const reportDir = join11(projectDir, "docs", "p-reports");
-    await fs17.ensureDir(reportDir);
-    await fs17.writeFile(join11(reportDir, `${today}.md`), buildDetailedReport3(evalResult, projectName), "utf8");
+    const reportDir = join13(projectDir, "docs", "p-reports");
+    await fs21.ensureDir(reportDir);
+    await fs21.writeFile(join13(reportDir, `${today}.md`), buildDetailedReport3(evalResult, projectName), "utf8");
     console.log("");
     hint(`\uC0C1\uC138 \uB9AC\uD3EC\uD2B8: docs/p-reports/${today}.md`);
   } catch {
@@ -5804,7 +6646,7 @@ async function detectLegacyProject(cwd) {
     ".gitignore"
   ];
   for (const signal of signals) {
-    if (await fs17.pathExists(join11(cwd, signal))) return true;
+    if (await fs21.pathExists(join13(cwd, signal))) return true;
   }
   return false;
 }
@@ -5895,17 +6737,17 @@ var init_help_cmd = __esm({
 });
 
 // src/stages/design/openspec.ts
-import { join as join12 } from "path";
-import fs18 from "fs-extra";
+import { join as join14 } from "path";
+import fs22 from "fs-extra";
 async function initOpenSpec(cwd, projectName) {
-  const docsDir = join12(cwd, "docs");
-  await fs18.ensureDir(docsDir);
-  const openspecPath = join12(docsDir, "openspec.md");
-  if (await fs18.pathExists(openspecPath)) {
+  const docsDir = join14(cwd, "docs");
+  await fs22.ensureDir(docsDir);
+  const openspecPath = join14(docsDir, "openspec.md");
+  if (await fs22.pathExists(openspecPath)) {
     info("docs/openspec.md \uC774\uBBF8 \uC874\uC7AC \u2014 \uAC74\uB108\uB700");
     return;
   }
-  await fs18.writeFile(openspecPath, [
+  await fs22.writeFile(openspecPath, [
     `# OpenSpec \u2014 ${projectName}`,
     "",
     "## 1. \uBAA9\uC801 (Purpose)",
@@ -5933,13 +6775,13 @@ async function initOpenSpec(cwd, projectName) {
 }
 async function validateOpenSpec(cwd) {
   const candidates = [
-    join12(cwd, "docs", "openspec.md"),
-    join12(cwd, "openspec.md"),
-    join12(cwd, ".pai", "openspec.md")
+    join14(cwd, "docs", "openspec.md"),
+    join14(cwd, "openspec.md"),
+    join14(cwd, ".pai", "openspec.md")
   ];
   let specPath = null;
   for (const p of candidates) {
-    if (await fs18.pathExists(p)) {
+    if (await fs22.pathExists(p)) {
       specPath = p;
       break;
     }
@@ -5953,7 +6795,7 @@ async function validateOpenSpec(cwd) {
       warnings: ["openspec.md \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `pai design init` \uC744 \uC2E4\uD589\uD558\uC138\uC694."]
     };
   }
-  const content = await fs18.readFile(specPath, "utf8");
+  const content = await fs22.readFile(specPath, "utf8");
   const missing = [];
   let filled = 0;
   for (const section2 of REQUIRED_SECTIONS) {
@@ -6001,17 +6843,17 @@ var init_openspec = __esm({
 });
 
 // src/stages/design/omc.ts
-import { join as join13 } from "path";
-import fs19 from "fs-extra";
+import { join as join15 } from "path";
+import fs23 from "fs-extra";
 async function initOMC(cwd, projectName) {
-  const paiDir = join13(cwd, ".pai");
-  await fs19.ensureDir(paiDir);
-  const omcPath = join13(paiDir, "omc.md");
-  if (await fs19.pathExists(omcPath)) {
+  const paiDir = join15(cwd, ".pai");
+  await fs23.ensureDir(paiDir);
+  const omcPath = join15(paiDir, "omc.md");
+  if (await fs23.pathExists(omcPath)) {
     info(".pai/omc.md \uC774\uBBF8 \uC874\uC7AC \u2014 \uAC74\uB108\uB700");
     return;
   }
-  await fs19.writeFile(omcPath, [
+  await fs23.writeFile(omcPath, [
     `# OMC \u2014 Object Model Context (${projectName})`,
     "",
     "> AI\uAC00 \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uB3C4\uBA54\uC778\uC744 \uC774\uD574\uD558\uAE30 \uC704\uD55C \uD575\uC2EC \uAC1D\uCCB4 \uBAA8\uB378",
@@ -6051,195 +6893,71 @@ __export(design_cmd_exports, {
   designValidateCommand: () => designValidateCommand
 });
 import { basename as basename3 } from "path";
-async function designInitCommand(cwd) {
-  section("\uC124\uACC4 \uD15C\uD50C\uB9BF \uC0DD\uC131");
-  const config = await loadConfig(cwd);
-  const projectName = config?.projectName ?? basename3(cwd);
-  await initOpenSpec(cwd, projectName);
-  await initOMC(cwd, projectName);
-  info("");
-  info("\uB2E4\uC74C \uB2E8\uACC4: docs/openspec.md\uB97C \uC5F4\uC5B4 PRD\uB97C \uC791\uC131\uD558\uC138\uC694.");
-}
-async function designValidateCommand(cwd) {
-  section("PRD \uC644\uC131\uB3C4 \uAC80\uC99D");
-  const result = await validateOpenSpec(cwd);
-  info(`\uC139\uC158 \uC644\uC131\uB3C4: ${result.filledSections}/${result.totalSections}`);
-  if (result.missing.length > 0) {
-    console.log("");
-    warn("\uBBF8\uC791\uC131 \uC139\uC158:");
-    for (const m of result.missing) {
-      warn(`  - ${m}`);
-    }
-  }
-  for (const w of result.warnings) {
-    warn(w);
-  }
-  if (result.complete) {
-    console.log("");
-    success("PRD \uC644\uC131\uB3C4 \uAC80\uC99D \uD1B5\uACFC!");
-  } else {
-    console.log("");
-    info("docs/openspec.md\uB97C \uC5F4\uC5B4 \uBBF8\uC791\uC131 \uC139\uC158\uC744 \uCC44\uC6CC\uC8FC\uC138\uC694.");
-  }
-}
-var init_design_cmd = __esm({
-  "src/cli/commands/design.cmd.ts"() {
-    "use strict";
-    init_ui();
-    init_openspec();
-    init_omc();
-    init_config();
-  }
-});
-
-// src/stages/validation/runner.ts
-import { join as join14 } from "path";
-import fs20 from "fs-extra";
-async function runTests(cwd) {
-  const start = Date.now();
-  const gstackPath = join14(cwd, ".pai", "gstack.json");
-  let runner = "npm test";
-  if (await fs20.pathExists(gstackPath)) {
-    try {
-      const config = await fs20.readJson(gstackPath);
-      if (config.testRunner === "vitest") runner = "npx vitest run";
-      else if (config.testRunner === "jest") runner = "npx jest";
-      else if (config.testRunner === "mocha") runner = "npx mocha";
-    } catch {
-    }
-  }
-  const pkgPath = join14(cwd, "package.json");
-  if (await fs20.pathExists(pkgPath)) {
-    try {
-      const pkg5 = await fs20.readJson(pkgPath);
-      if (!pkg5.scripts?.test || pkg5.scripts.test.includes("no test specified")) {
-        return {
-          runner,
-          passed: false,
-          output: "\uD14C\uC2A4\uD2B8 \uC2A4\uD06C\uB9BD\uD2B8\uAC00 \uC815\uC758\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. package.json\uC758 scripts.test\uB97C \uC124\uC815\uD558\uC138\uC694.",
-          duration: Date.now() - start
-        };
-      }
-    } catch {
-    }
-  }
+async function designInitCommand(cwd, options = {}) {
   try {
-    const { execa } = await import("execa");
-    const { stdout, stderr } = await execa("npm", ["test"], {
+    await withRoboco(
       cwd,
-      timeout: 12e4,
-      env: { ...process.env, CI: "true" }
+      "design",
+      "pai design init",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.design },
+      async () => {
+        section("\uC124\uACC4 \uD15C\uD50C\uB9BF \uC0DD\uC131");
+        const config = await loadConfig(cwd);
+        const projectName = config?.projectName ?? basename3(cwd);
+        await initOpenSpec(cwd, projectName);
+        await initOMC(cwd, projectName);
+        info("");
+        info("\uB2E4\uC74C \uB2E8\uACC4: docs/openspec.md\uB97C \uC5F4\uC5B4 PRD\uB97C \uC791\uC131\uD558\uC138\uC694.");
+      }
+    );
+    await syncHandoff(cwd).catch(() => {
     });
-    return {
-      runner,
-      passed: true,
-      output: stdout || stderr,
-      duration: Date.now() - start
-    };
   } catch (err) {
-    const output = err instanceof Error ? err.message : String(err);
-    return {
-      runner,
-      passed: false,
-      output,
-      duration: Date.now() - start
-    };
+    handleRobocoError(err);
   }
 }
-var init_runner = __esm({
-  "src/stages/validation/runner.ts"() {
-    "use strict";
-  }
-});
-
-// src/stages/validation/harness.ts
-import { join as join15 } from "path";
-import fs21 from "fs-extra";
-async function runHarnessCheck(cwd) {
-  const harnessPath = join15(cwd, ".pai", "harness.json");
-  if (!await fs21.pathExists(harnessPath)) {
-    return { enabled: false, specFile: null, rules: [], checks: [] };
-  }
-  let config;
+async function designValidateCommand(cwd, options = {}) {
   try {
-    config = await fs21.readJson(harnessPath);
-  } catch {
-    return { enabled: false, specFile: null, rules: [], checks: [] };
-  }
-  const specFile = config.specFile ?? "docs/openspec.md";
-  const rules = config.rules ?? [];
-  const checks = [];
-  if (rules.includes("spec-implementation-match")) {
-    const specExists = await fs21.pathExists(join15(cwd, specFile));
-    const srcExists = await fs21.pathExists(join15(cwd, "src"));
-    checks.push({
-      rule: "spec-implementation-match",
-      passed: specExists && srcExists,
-      detail: specExists && srcExists ? "\uC124\uACC4 \uBB38\uC11C\uC640 \uC18C\uC2A4 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : `${!specExists ? specFile + " \uC5C6\uC74C" : ""} ${!srcExists ? "src/ \uC5C6\uC74C" : ""}`.trim()
-    });
-  }
-  if (rules.includes("api-contract-test")) {
-    const testDir = await fs21.pathExists(join15(cwd, "tests"));
-    const testDir2 = await fs21.pathExists(join15(cwd, "test"));
-    checks.push({
-      rule: "api-contract-test",
-      passed: testDir || testDir2,
-      detail: testDir || testDir2 ? "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" : "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC(tests/ \uB610\uB294 test/) \uC5C6\uC74C"
-    });
-  }
-  return { enabled: true, specFile, rules, checks };
-}
-var init_harness = __esm({
-  "src/stages/validation/harness.ts"() {
-    "use strict";
-  }
-});
-
-// src/cli/commands/validate.cmd.ts
-var validate_cmd_exports = {};
-__export(validate_cmd_exports, {
-  validateCommand: () => validateCommand
-});
-async function validateCommand(cwd) {
-  section("\uD14C\uC2A4\uD2B8 \uC2E4\uD589");
-  const testResult = await runTests(cwd);
-  if (testResult.passed) {
-    success(`\uD14C\uC2A4\uD2B8 \uD1B5\uACFC (${testResult.runner}, ${testResult.duration}ms)`);
-  } else {
-    error("\uD14C\uC2A4\uD2B8 \uC2E4\uD328");
-    info(testResult.output.slice(0, 300));
-  }
-  section("\uD558\uB124\uC2A4 \uAC80\uC99D");
-  const harness = await runHarnessCheck(cwd);
-  if (!harness.enabled) {
-    info("Harness \uC124\uC815 \uC5C6\uC74C \u2014 \uAC74\uB108\uB700");
-    info("\uC124\uC815 \uCD94\uAC00: `pai env setup` \uC5D0\uC11C Harness Engineering \uC120\uD0DD");
-  } else {
-    for (const check of harness.checks) {
-      if (check.passed) {
-        success(`${check.rule}: ${check.detail}`);
-      } else {
-        warn(`${check.rule}: ${check.detail}`);
+    await withRoboco(
+      cwd,
+      "design",
+      "pai design validate",
+      { skipGates: options.skipGates, force: options.force, gate: STAGE_GATES.design },
+      async () => {
+        section("PRD \uC644\uC131\uB3C4 \uAC80\uC99D");
+        const result = await validateOpenSpec(cwd);
+        info(`\uC139\uC158 \uC644\uC131\uB3C4: ${result.filledSections}/${result.totalSections}`);
+        if (result.missing.length > 0) {
+          console.log("");
+          warn("\uBBF8\uC791\uC131 \uC139\uC158:");
+          for (const m of result.missing) warn(`  - ${m}`);
+        }
+        for (const w of result.warnings) warn(w);
+        if (result.complete) {
+          console.log("");
+          success("PRD \uC644\uC131\uB3C4 \uAC80\uC99D \uD1B5\uACFC!");
+        } else {
+          console.log("");
+          info("docs/openspec.md\uB97C \uC5F4\uC5B4 \uBBF8\uC791\uC131 \uC139\uC158\uC744 \uCC44\uC6CC\uC8FC\uC138\uC694.");
+        }
       }
-    }
-  }
-  const allPassed = testResult.passed && harness.checks.every((c2) => c2.passed);
-  console.log("");
-  if (allPassed) {
-    success("\uAC80\uC99D \uD1B5\uACFC!");
-  } else if (!testResult.passed) {
-    error("\uAC80\uC99D \uC2E4\uD328 \u2014 \uD14C\uC2A4\uD2B8\uB97C \uC218\uC815\uD558\uC138\uC694.");
-    process.exitCode = 1;
-  } else {
-    warn("\uBD80\uBD84 \uD1B5\uACFC \u2014 \uD558\uB124\uC2A4 \uAC80\uC99D \uD56D\uBAA9\uC744 \uD655\uC778\uD558\uC138\uC694.");
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
   }
 }
-var init_validate_cmd = __esm({
-  "src/cli/commands/validate.cmd.ts"() {
+var init_design_cmd = __esm({
+  "src/cli/commands/design.cmd.ts"() {
     "use strict";
     init_ui();
-    init_runner();
-    init_harness();
+    init_openspec();
+    init_omc();
+    init_config();
+    init_roboco();
+    init_gates();
+    init_validate_cmd();
   }
 });
 
@@ -6295,13 +7013,13 @@ var init_context = __esm({
 
 // src/stages/design/index.ts
 import { join as join16 } from "path";
-import fs22 from "fs-extra";
+import fs24 from "fs-extra";
 async function autoInstallHarness(cwd) {
   const harnessPath = join16(cwd, ".pai", "harness.json");
-  if (await fs22.pathExists(harnessPath)) return;
+  if (await fs24.pathExists(harnessPath)) return;
   await withSpinner("Harness Engineering \uC790\uB3D9 \uC124\uC815 \uC911...", async () => {
-    await fs22.ensureDir(join16(cwd, ".pai"));
-    await fs22.writeJson(harnessPath, {
+    await fs24.ensureDir(join16(cwd, ".pai"));
+    await fs24.writeJson(harnessPath, {
       version: "1.0",
       specFile: "docs/openspec.md",
       checkOn: ["pre-commit", "ci"],
@@ -6621,22 +7339,41 @@ __export(pipeline_cmd_exports, {
 });
 async function pipelineCommand(cwd, options) {
   printBanner();
-  const config = await loadConfig(cwd) ?? createDefaultConfig("my-project", "mockup");
-  const pipelineOpts = {};
-  if (options.from) {
-    pipelineOpts.from = options.from;
-  }
-  if (options.only) {
-    pipelineOpts.only = options.only.split(",").map((s) => s.trim());
+  try {
+    await withRoboco(
+      cwd,
+      "environment",
+      "pai run",
+      {
+        skipGates: options.skipGates,
+        force: options.force,
+        ttlMs: PIPELINE_TTL_MS
+      },
+      async () => {
+        const config = await loadConfig(cwd) ?? createDefaultConfig("my-project", "prototype");
+        const pipelineOpts = {};
+        if (options.from) pipelineOpts.from = options.from;
+        if (options.only) pipelineOpts.only = options.only.split(",").map((s) => s.trim());
+        await runPipeline(cwd, config, pipelineOpts);
+      }
+    );
+    await syncHandoff(cwd).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
   }
-  await runPipeline(cwd, config, pipelineOpts);
 }
+var PIPELINE_TTL_MS;
 var init_pipeline_cmd = __esm({
   "src/cli/commands/pipeline.cmd.ts"() {
     "use strict";
+    init_ui();
     init_pipeline();
     init_config();
     init_ui();
+    init_roboco();
+    init_validate_cmd();
+    PIPELINE_TTL_MS = 30 * 60 * 1e3;
   }
 });
 
@@ -6658,7 +7395,7 @@ __export(remove_cmd_exports, {
   removeCommand: () => removeCommand
 });
 import { basename as basename4, dirname } from "path";
-import fs23 from "fs-extra";
+import fs25 from "fs-extra";
 async function removeCommand(cwd, options) {
   section("\uD504\uB85C\uC81D\uD2B8 \uC0AD\uC81C");
   const config = await loadConfig(cwd);
@@ -6676,7 +7413,7 @@ async function removeCommand(cwd, options) {
   console.log(colors.err(`  ${folderName}/ \uD3F4\uB354 \uC804\uCCB4\uAC00 \uC0AD\uC81C\uB429\uB2C8\uB2E4.`));
   hint("\uC774 \uC791\uC5C5\uC740 \uB418\uB3CC\uB9B4 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
   console.log("");
-  const items = await fs23.readdir(cwd);
+  const items = await fs25.readdir(cwd);
   const fileCount = items.filter((i) => !i.startsWith(".")).length;
   const hiddenCount = items.filter((i) => i.startsWith(".")).length;
   info(`\uD30C\uC77C/\uD3F4\uB354 ${fileCount}\uAC1C, \uC228\uAE40 \uD56D\uBAA9 ${hiddenCount}\uAC1C`);
@@ -6695,7 +7432,7 @@ async function removeCommand(cwd, options) {
   }
   process.chdir(parentDir);
   try {
-    await fs23.remove(cwd);
+    await fs25.remove(cwd);
     console.log("");
     success(`${folderName}/ \uD504\uB85C\uC81D\uD2B8\uAC00 \uC0AD\uC81C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.`);
     try {
@@ -6974,7 +7711,7 @@ __export(savetoken_cmd_exports, {
   savetokenCommand: () => savetokenCommand
 });
 import { join as join17, relative } from "path";
-import fs24 from "fs-extra";
+import fs26 from "fs-extra";
 import chalk7 from "chalk";
 async function savetokenCommand(cwd) {
   const { createSpinner: createSpinner2 } = await Promise.resolve().then(() => (init_progress(), progress_exports));
@@ -7044,10 +7781,10 @@ async function savetokenCommand(cwd) {
   console.log(`  ${chalk7.red("\u25CF")} \uB192\uC74C   \uCF54\uB4DC \uC0DD\uC131, \uBCF5\uC7A1\uD55C \uCD94\uB860, \uCC3D\uC758\uC801 \uC0DD\uC131`);
   console.log(`         \u2192 ${colors.dim("AI \uD544\uC218 \u2014 \uD504\uB86C\uD504\uD2B8 \uCD5C\uC801\uD654\uB85C \uD1A0\uD070 \uC808\uAC10")}`);
   const reportDir = join17(cwd, ".pai");
-  await fs24.ensureDir(reportDir);
+  await fs26.ensureDir(reportDir);
   const report = buildReport(callSites, cwd);
   const reportPath = join17(reportDir, "savetoken-report.md");
-  await fs24.writeFile(reportPath, report, "utf8");
+  await fs26.writeFile(reportPath, report, "utf8");
   console.log("");
   success("\uC2A4\uCE94 \uB9AC\uD3EC\uD2B8 \uC800\uC7A5: .pai/savetoken-report.md");
   console.log("");
@@ -7205,7 +7942,7 @@ __export(wakeup_cmd_exports, {
 });
 import { join as join18 } from "path";
 import { homedir as homedir3, platform as osPlatform } from "os";
-import fs25 from "fs-extra";
+import fs27 from "fs-extra";
 import chalk8 from "chalk";
 async function wakeupCommand(timeOrAction, schedule = "\uD3C9\uC77C") {
   if (timeOrAction === "off") {
@@ -7252,9 +7989,9 @@ async function wakeupCommand(timeOrAction, schedule = "\uD3C9\uC77C") {
     projectDir,
     launchMode
   };
-  await fs25.ensureDir(PAI_DIR2);
-  await fs25.writeJson(CONFIG_FILE2, config, { spaces: 2 });
-  await fs25.writeJson(MESSAGES_FILE, MESSAGES);
+  await fs27.ensureDir(PAI_DIR2);
+  await fs27.writeJson(CONFIG_FILE2, config, { spaces: 2 });
+  await fs27.writeJson(MESSAGES_FILE, MESSAGES);
   await createWakeupScript(config);
   if (osPlatform() === "darwin") {
     await setupMacOS(config);
@@ -7285,7 +8022,7 @@ async function setupMacOS(config) {
   const { execa } = await import("execa");
   const [hour, minute] = config.time.split(":").map(Number);
   const plistDir = join18(homedir3(), "Library", "LaunchAgents");
-  await fs25.ensureDir(plistDir);
+  await fs27.ensureDir(plistDir);
   const weekdays = scheduleToWeekdays(config.schedule);
   let calendarEntries;
   if (weekdays.length === 7) {
@@ -7321,7 +8058,7 @@ ${calendarEntries}
   <string>${PAI_DIR2}/wakeup.log</string>
 </dict>
 </plist>`;
-  await fs25.writeFile(PLIST_PATH, plist);
+  await fs27.writeFile(PLIST_PATH, plist);
   await execa("launchctl", ["unload", PLIST_PATH]).catch(() => {
   });
   await execa("launchctl", ["load", PLIST_PATH]);
@@ -7344,7 +8081,7 @@ async function setupWindows(config) {
   const { execa } = await import("execa");
   const [hour, minute] = config.time.split(":").map(Number);
   const psScriptDir = join18(homedir3(), ".pai");
-  await fs25.ensureDir(psScriptDir);
+  await fs27.ensureDir(psScriptDir);
   const psScriptPath = join18(psScriptDir, "wakeup.ps1");
   const claudeCmd = config.launchMode === "yolo" ? "claude --dangerously-skip-permissions" : "claude";
   const psScript = `# PAI Wakeup \u2014 Claude Code \uC138\uC158 \uC790\uB3D9 \uC2DC\uC791
@@ -7374,7 +8111,7 @@ $notifier.Show([Windows.UI.Notifications.ToastNotification]::new($xml))
 # Open PowerShell with Claude Code
 Start-Process powershell -ArgumentList "-NoExit", "-Command", "Get-Content '$todayFile'; Write-Host ''; Set-Location '${config.projectDir}'; ${claudeCmd}"
 `;
-  await fs25.writeFile(psScriptPath, psScript, "utf8");
+  await fs27.writeFile(psScriptPath, psScript, "utf8");
   const daysMap = {
     "\uD3C9\uC77C": "MON,TUE,WED,THU,FRI",
     "\uB9E4\uC77C": "MON,TUE,WED,THU,FRI,SAT,SUN",
@@ -7422,7 +8159,7 @@ async function disableWakeup() {
   if (osPlatform() === "darwin") {
     await execa("launchctl", ["unload", PLIST_PATH]).catch(() => {
     });
-    await fs25.remove(PLIST_PATH).catch(() => {
+    await fs27.remove(PLIST_PATH).catch(() => {
     });
     success("launchd \uC2A4\uCF00\uC904 \uC81C\uAC70");
     console.log("");
@@ -7443,14 +8180,14 @@ async function disableWakeup() {
   } else {
     await removeCronEntry();
   }
-  await fs25.remove(CONFIG_FILE2).catch(() => {
+  await fs27.remove(CONFIG_FILE2).catch(() => {
   });
   console.log("");
   success("\u2600\uFE0F \uC6E8\uC774\uD06C\uC5C5 \uD574\uC81C \uC644\uB8CC");
 }
 async function showStatus() {
-  if (await fs25.pathExists(CONFIG_FILE2)) {
-    const config = await fs25.readJson(CONFIG_FILE2);
+  if (await fs27.pathExists(CONFIG_FILE2)) {
+    const config = await fs27.readJson(CONFIG_FILE2);
     console.log("");
     success("\u2600\uFE0F \uC6E8\uC774\uD06C\uC5C5 \uD65C\uC131\uD654");
     console.log(`  \uC2DC\uAC04       ${chalk8.white(config.time)}`);
@@ -7458,7 +8195,7 @@ async function showStatus() {
     console.log(`  \uD504\uB85C\uC81D\uD2B8   ${chalk8.white(config.projectDir)}`);
     console.log(`  \uBAA8\uB4DC       ${chalk8.white(config.launchMode === "yolo" ? "claude-YOLO mode" : "\uC77C\uBC18 \uBAA8\uB4DC")}`);
     if (osPlatform() === "darwin") {
-      const plistExists = await fs25.pathExists(PLIST_PATH);
+      const plistExists = await fs27.pathExists(PLIST_PATH);
       console.log(`  launchd    ${plistExists ? chalk8.green("\uD65C\uC131") : chalk8.red("\uBE44\uD65C\uC131")}`);
     }
     console.log("");
@@ -7611,7 +8348,7 @@ fi
 
 echo "[$(date)] PAI Wakeup completed" >> "$LOG_FILE"
 `;
-  await fs25.writeFile(SCRIPT_FILE, script, { mode: 493 });
+  await fs27.writeFile(SCRIPT_FILE, script, { mode: 493 });
 }
 var PAI_DIR2, CONFIG_FILE2, MESSAGES_FILE, SCRIPT_FILE, PLIST_NAME, PLIST_PATH, CRON_MARKER, MESSAGES;
 var init_wakeup_cmd = __esm({
@@ -7711,9 +8448,9 @@ function createProgram() {
     const { initCommand: initCommand2 } = await Promise.resolve().then(() => (init_init_cmd(), init_cmd_exports));
     await initCommand2(process.cwd(), projectName);
   });
-  program2.command("add").description("\uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 (Mockup \u2192 Production \uD655\uC7A5)").action(async () => {
+  program2.command("add").description("\uD50C\uB7EC\uADF8\uC778 \uCD94\uAC00 (Mockup \u2192 Production \uD655\uC7A5)").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { addCommand } = await Promise.resolve().then(() => (init_add_cmd(), add_cmd_exports));
-    await addCommand(process.cwd());
+    await addCommand(process.cwd(), options);
   });
   program2.command("check").description("\uD658\uACBD \uC810\uAC80 (Node / Git / Claude Code)").action(async () => {
     const { checkCommand: checkCommand2 } = await Promise.resolve().then(() => (init_check_cmd(), check_cmd_exports));
@@ -7728,23 +8465,23 @@ function createProgram() {
     await helpCommand2();
   });
   const design = program2.command("design").description("\uC124\uACC4 \uAD00\uB9AC (OpenSpec / OMC)");
-  design.command("init").description("PRD/OMC \uD15C\uD50C\uB9BF \uC0DD\uC131").action(async () => {
+  design.command("init").description("PRD/OMC \uD15C\uD50C\uB9BF \uC0DD\uC131").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { designInitCommand: designInitCommand2 } = await Promise.resolve().then(() => (init_design_cmd(), design_cmd_exports));
-    await designInitCommand2(process.cwd());
+    await designInitCommand2(process.cwd(), options);
   });
-  design.command("validate").description("PRD \uC644\uC131\uB3C4 \uAC80\uC99D").action(async () => {
+  design.command("validate").description("PRD \uC644\uC131\uB3C4 \uAC80\uC99D").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { designValidateCommand: designValidateCommand2 } = await Promise.resolve().then(() => (init_design_cmd(), design_cmd_exports));
-    await designValidateCommand2(process.cwd());
+    await designValidateCommand2(process.cwd(), options);
   });
-  program2.command("test").description("\uD14C\uC2A4\uD2B8 / \uD558\uB124\uC2A4 \uAC80\uC99D \uC2E4\uD589").action(async () => {
+  program2.command("test").description("\uD14C\uC2A4\uD2B8 / \uD558\uB124\uC2A4 \uAC80\uC99D \uC2E4\uD589").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { testCommand } = await Promise.resolve().then(() => (init_test_cmd(), test_cmd_exports));
-    await testCommand(process.cwd());
+    await testCommand(process.cwd(), options);
   });
-  program2.command("grade").description("AI \uAC1C\uBC1C \uC900\uBE44\uB3C4 \uD3C9\uAC00 (6\uCE74\uD14C\uACE0\uB9AC \uC810\uC218)").option("--fail-under <score>", "\uCD5C\uC18C \uC810\uC218 (\uBBF8\uB2EC \uC2DC exit 1)", parseInt).option("--verbose", "\uC0C1\uC138 findings \uCD9C\uB825").option("-o, --output <file>", "\uACB0\uACFC\uB97C \uD30C\uC77C\uB85C \uC800\uC7A5").option("--no-cache", "\uCE90\uC2DC \uBB34\uC2DC\uD558\uACE0 \uC0C8\uB85C \uBD84\uC11D").action(async (options) => {
+  program2.command("grade").description("AI \uAC1C\uBC1C \uC900\uBE44\uB3C4 \uD3C9\uAC00 (6\uCE74\uD14C\uACE0\uB9AC \uC810\uC218)").option("--fail-under <score>", "\uCD5C\uC18C \uC810\uC218 (\uBBF8\uB2EC \uC2DC exit 1)", parseInt).option("--verbose", "\uC0C1\uC138 findings \uCD9C\uB825").option("-o, --output <file>", "\uACB0\uACFC\uB97C \uD30C\uC77C\uB85C \uC800\uC7A5").option("--no-cache", "\uCE90\uC2DC \uBB34\uC2DC\uD558\uACE0 \uC0C8\uB85C \uBD84\uC11D").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC (\uCD5C\uADFC validation \uC5C6\uC5B4\uB3C4 \uC2E4\uD589)").action(async (options) => {
     const { gradeCommand } = await Promise.resolve().then(() => (init_grade_cmd(), grade_cmd_exports));
     await gradeCommand(process.cwd(), options);
   });
-  program2.command("run").description("\uC804\uCCB4 5\uB2E8\uACC4 \uD30C\uC774\uD504\uB77C\uC778 \uC2E4\uD589").option("--from <stage>", "\uD2B9\uC815 \uB2E8\uACC4\uBD80\uD130 \uC2E4\uD589").option("--only <stages>", "\uC120\uD0DD\uC801 \uB2E8\uACC4 \uC2E4\uD589 (\uC27C\uD45C \uAD6C\uBD84)").action(async (options) => {
+  program2.command("run").description("\uC804\uCCB4 5\uB2E8\uACC4 \uD30C\uC774\uD504\uB77C\uC778 \uC2E4\uD589").option("--from <stage>", "\uD2B9\uC815 \uB2E8\uACC4\uBD80\uD130 \uC2E4\uD589").option("--only <stages>", "\uC120\uD0DD\uC801 \uB2E8\uACC4 \uC2E4\uD589 (\uC27C\uD45C \uAD6C\uBD84)").option("--skip-gates", "\uAC8C\uC774\uD2B8 \uACBD\uACE0\uB9CC \uCD9C\uB825\uD558\uACE0 \uC9C4\uD589").option("--force", "\uAC8C\uC774\uD2B8 \uC804\uBA74 \uBB34\uC2DC").action(async (options) => {
     const { runCommand } = await Promise.resolve().then(() => (init_run_cmd(), run_cmd_exports));
     await runCommand(process.cwd(), options);
   });