pai-zero 0.13.1 → 0.13.2

package/dist/bin/pai.js

@@ -4706,6 +4706,200 @@ var init_environment = __esm({
   }
 });
 
+// src/stages/validation/runner.ts
+import { join as join7 } from "path";
+import fs15 from "fs-extra";
+async function runTests(cwd) {
+  const start = Date.now();
+  const gstackPath = join7(cwd, ".pai", "gstack.json");
+  let runner = "npm test";
+  if (await fs15.pathExists(gstackPath)) {
+    try {
+      const config = await fs15.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 = join7(cwd, "package.json");
+  if (await fs15.pathExists(pkgPath)) {
+    try {
+      const pkg5 = await fs15.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 {
+    }
+  }
+  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_runner = __esm({
+  "src/stages/validation/runner.ts"() {
+    "use strict";
+  }
+});
+
+// src/stages/validation/harness.ts
+import { join as join8 } from "path";
+import fs16 from "fs-extra";
+async function runHarnessCheck(cwd) {
+  const harnessPath = join8(cwd, ".pai", "harness.json");
+  if (!await fs16.pathExists(harnessPath)) {
+    return { enabled: false, specFile: null, rules: [], checks: [] };
+  }
+  let config;
+  try {
+    config = await fs16.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 fs16.pathExists(join8(cwd, specFile));
+    const srcExists = await fs16.pathExists(join8(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 fs16.pathExists(join8(cwd, "tests"));
+    const testDir2 = await fs16.pathExists(join8(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/stages/evaluation/prompts/analyze.ts
 var analyze_exports = {};
 __export(analyze_exports, {
@@ -4762,8 +4956,8 @@ var analyzer_exports2 = {};
 __export(analyzer_exports2, {
   analyzeRepository: () => analyzeRepository
 });
-import { join as join7 } from "path";
-import fs15 from "fs-extra";
+import { join as join9 } from "path";
+import fs17 from "fs-extra";
 async function analyzeRepository(repoPath) {
   try {
     return await aiAnalysis(repoPath);
@@ -4824,14 +5018,14 @@ async function checkTestCoverage(repoPath) {
     ".nycrc"
   ];
   for (const f of testConfigs) {
-    const found = await fs15.pathExists(join7(repoPath, f));
+    const found = await fs17.pathExists(join9(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 fs15.pathExists(join7(repoPath, d))) {
+    if (await fs17.pathExists(join9(repoPath, d))) {
       findings.push({ item: d, found: true, details: "\uD14C\uC2A4\uD2B8 \uB514\uB809\uD1A0\uB9AC \uC874\uC7AC" });
       hasTestDir = true;
       score += 30;
@@ -4855,7 +5049,7 @@ async function checkCiCd(repoPath) {
     { path: ".circleci", label: "CircleCI" }
   ];
   for (const { path: path10, label } of ciConfigs) {
-    const found = await fs15.pathExists(join7(repoPath, path10));
+    const found = await fs17.pathExists(join9(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += 40;
   }
@@ -4874,7 +5068,7 @@ async function checkHooks(repoPath) {
     { path: ".claude/settings.json", label: "Claude Code settings" }
   ];
   for (const { path: path10, label } of hookConfigs) {
-    const found = await fs15.pathExists(join7(repoPath, path10));
+    const found = await fs17.pathExists(join9(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += 20;
   }
@@ -4892,7 +5086,7 @@ async function checkRepoStructure(repoPath) {
     { path: ".gitignore", label: ".gitignore" }
   ];
   for (const { path: path10, label } of structureChecks) {
-    const found = await fs15.pathExists(join7(repoPath, path10));
+    const found = await fs17.pathExists(join9(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += 25;
   }
@@ -4909,7 +5103,7 @@ async function checkDocumentation(repoPath) {
     { path: "docs/openspec.md", label: "OpenSpec PRD", points: 25 }
   ];
   for (const { path: path10, label, points } of docChecks) {
-    const found = await fs15.pathExists(join7(repoPath, path10));
+    const found = await fs17.pathExists(join9(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += points;
   }
@@ -4928,7 +5122,7 @@ async function checkHarnessEngineering(repoPath) {
     { path: ".pai/config.json", label: "PAI config", points: 10 }
   ];
   for (const { path: path10, label, points } of harnessChecks) {
-    const found = await fs15.pathExists(join7(repoPath, path10));
+    const found = await fs17.pathExists(join9(repoPath, path10));
     findings.push({ item: label, found, details: found ? "\uC874\uC7AC" : "\uC5C6\uC74C" });
     if (found) score += points;
   }
@@ -5311,56 +5505,56 @@ __export(shell_cd_exports, {
   installShellHelper: () => installShellHelper,
   requestCdAfter: () => requestCdAfter
 });
-import { join as join8 } from "path";
+import { join as join10 } from "path";
 import { homedir as homedir2 } from "os";
-import fs16 from "fs-extra";
+import fs18 from "fs-extra";
 async function requestCdAfter(targetDir) {
-  await fs16.ensureDir(PAI_DIR);
-  await fs16.writeFile(CD_FILE, targetDir);
+  await fs18.ensureDir(PAI_DIR);
+  await fs18.writeFile(CD_FILE, targetDir);
 }
 async function installShellHelper() {
-  await fs16.ensureDir(PAI_DIR);
+  await fs18.ensureDir(PAI_DIR);
   if (isWindows) {
     return installPowerShellHelper();
   }
   return installBashHelper();
 }
 async function installBashHelper() {
-  await fs16.writeFile(HELPER_FILE_SH, BASH_HELPER);
+  await fs18.writeFile(HELPER_FILE_SH, BASH_HELPER);
   const rcFile = getShellRcPath();
   const sourceLine = 'source "$HOME/.pai/shell-helper.sh"';
-  if (await fs16.pathExists(rcFile)) {
-    const content = await fs16.readFile(rcFile, "utf8");
+  if (await fs18.pathExists(rcFile)) {
+    const content = await fs18.readFile(rcFile, "utf8");
     if (content.includes("shell-helper.sh")) {
       return true;
     }
-    await fs16.appendFile(rcFile, `
+    await fs18.appendFile(rcFile, `
 # PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
 ${sourceLine}
 `);
     return false;
   }
-  await fs16.writeFile(rcFile, `${sourceLine}
+  await fs18.writeFile(rcFile, `${sourceLine}
 `);
   return false;
 }
 async function installPowerShellHelper() {
-  await fs16.writeFile(HELPER_FILE_PS1, POWERSHELL_HELPER);
+  await fs18.writeFile(HELPER_FILE_PS1, POWERSHELL_HELPER);
   const rcFile = getShellRcPath();
   const sourceLine = '. "$env:USERPROFILE\\.pai\\shell-helper.ps1"';
-  await fs16.ensureDir(join8(rcFile, ".."));
-  if (await fs16.pathExists(rcFile)) {
-    const content = await fs16.readFile(rcFile, "utf8");
+  await fs18.ensureDir(join10(rcFile, ".."));
+  if (await fs18.pathExists(rcFile)) {
+    const content = await fs18.readFile(rcFile, "utf8");
     if (content.includes("shell-helper.ps1")) {
       return true;
     }
-    await fs16.appendFile(rcFile, `
+    await fs18.appendFile(rcFile, `
 # PAI \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9
 ${sourceLine}
 `);
     return false;
   }
-  await fs16.writeFile(rcFile, `${sourceLine}
+  await fs18.writeFile(rcFile, `${sourceLine}
 `);
   return false;
 }
@@ -5369,10 +5563,10 @@ var init_shell_cd = __esm({
   "src/utils/shell-cd.ts"() {
     "use strict";
     init_platform();
-    PAI_DIR = join8(homedir2(), ".pai");
-    CD_FILE = join8(PAI_DIR, ".cd-after");
-    HELPER_FILE_SH = join8(PAI_DIR, "shell-helper.sh");
-    HELPER_FILE_PS1 = join8(PAI_DIR, "shell-helper.ps1");
+    PAI_DIR = join10(homedir2(), ".pai");
+    CD_FILE = join10(PAI_DIR, ".cd-after");
+    HELPER_FILE_SH = join10(PAI_DIR, "shell-helper.sh");
+    HELPER_FILE_PS1 = join10(PAI_DIR, "shell-helper.ps1");
     BASH_HELPER = `# PAI shell helper \u2014 \uC790\uB3D9 \uB514\uB809\uD1A0\uB9AC \uC774\uB3D9 \uC9C0\uC6D0
 pai() {
   local cd_target="$HOME/.pai/.cd-after"
@@ -5424,7 +5618,7 @@ __export(claude_settings_exports, {
 });
 import os3 from "os";
 import path9 from "path";
-import fs17 from "fs-extra";
+import fs19 from "fs-extra";
 function getClaudeSettingsPath(homeDir = os3.homedir()) {
   return path9.join(homeDir, ".claude", "settings.json");
 }
@@ -5441,13 +5635,13 @@ async function enableOmcPlugin(options = {}) {
   const pluginId = options.pluginId ?? DEFAULT_PLUGIN_ID;
   const wantBackup = options.backup ?? true;
   const settingsPath = getClaudeSettingsPath();
-  await fs17.ensureDir(path9.dirname(settingsPath));
-  if (!await fs17.pathExists(settingsPath)) {
+  await fs19.ensureDir(path9.dirname(settingsPath));
+  if (!await fs19.pathExists(settingsPath)) {
     const skeleton = buildSkeleton(marketplaceId, marketplaceUrl, pluginId);
-    await fs17.writeFile(settingsPath, JSON.stringify(skeleton, null, 2) + "\n", "utf8");
+    await fs19.writeFile(settingsPath, JSON.stringify(skeleton, null, 2) + "\n", "utf8");
     return { action: "created", settingsPath };
   }
-  const raw = await fs17.readFile(settingsPath, "utf8");
+  const raw = await fs19.readFile(settingsPath, "utf8");
   let parsed;
   try {
     const value = parseJsonWithBom(raw);
@@ -5457,7 +5651,7 @@ async function enableOmcPlugin(options = {}) {
     parsed = value;
   } catch (err) {
     const backupPath2 = `${settingsPath}.backup-${timestampSuffix()}`;
-    await fs17.copy(settingsPath, backupPath2);
+    await fs19.copy(settingsPath, backupPath2);
     throw new ClaudeSettingsError(
       `settings.json \uD30C\uC2F1 \uC2E4\uD328: ${err.message}. \uBC31\uC5C5: ${backupPath2}`,
       backupPath2
@@ -5469,10 +5663,10 @@ async function enableOmcPlugin(options = {}) {
   let backupPath;
   if (wantBackup) {
     backupPath = `${settingsPath}.backup-${timestampSuffix()}`;
-    await fs17.copy(settingsPath, backupPath);
+    await fs19.copy(settingsPath, backupPath);
   }
   const merged = mergeOmcIntoSettings(parsed, marketplaceId, marketplaceUrl, pluginId);
-  await fs17.writeFile(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+  await fs19.writeFile(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
   return { action: "added", settingsPath, backupPath };
 }
 function buildSkeleton(marketplaceId, marketplaceUrl, pluginId) {
@@ -5527,12 +5721,12 @@ var init_claude_settings = __esm({
 
 // src/stages/evaluation/cache.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
-import { join as join9 } from "path";
+import { join as join11 } from "path";
 import { createHash } from "crypto";
 function computeRepoHash(repoPath) {
   const hash = createHash("sha256");
   for (const file of FILES_TO_HASH) {
-    const fullPath = join9(repoPath, file);
+    const fullPath = join11(repoPath, file);
     try {
       const content = readFileSync(fullPath);
       hash.update(`${file}:${content.length}`);
@@ -5543,7 +5737,7 @@ function computeRepoHash(repoPath) {
   return hash.digest("hex").slice(0, 16);
 }
 function getCachePath(repoPath) {
-  return join9(repoPath, CACHE_DIR, CACHE_FILE);
+  return join11(repoPath, CACHE_DIR, CACHE_FILE);
 }
 function loadCache(repoPath) {
   try {
@@ -5554,7 +5748,7 @@ function loadCache(repoPath) {
   }
 }
 function saveCache(repoPath, store) {
-  const cacheDir = join9(repoPath, CACHE_DIR, "cache");
+  const cacheDir = join11(repoPath, CACHE_DIR, "cache");
   if (!existsSync(cacheDir)) {
     mkdirSync(cacheDir, { recursive: true });
   }
@@ -5608,200 +5802,6 @@ var init_cache = __esm({
   }
 });
 
-// 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 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 {
-    }
-  }
-  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_runner = __esm({
-  "src/stages/validation/runner.ts"() {
-    "use strict";
-  }
-});
-
-// 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, {
@@ -6234,7 +6234,24 @@ async function setupInDirectory(projectDir, projectName) {
     config,
     previousResults: /* @__PURE__ */ new Map()
   };
-  const result = await environmentStage.run(input);
+  let stageResult;
+  try {
+    await withRoboco(
+      projectDir,
+      "environment",
+      "pai init",
+      {},
+      async () => {
+        stageResult = await environmentStage.run(input);
+      }
+    );
+    await syncHandoff(projectDir).catch(() => {
+    });
+  } catch (err) {
+    handleRobocoError(err);
+    return;
+  }
+  const result = stageResult;
   if (result.status === "success") {
     try {
       const { requestCdAfter: requestCdAfter2 } = await Promise.resolve().then(() => (init_shell_cd(), shell_cd_exports));
@@ -6657,6 +6674,8 @@ var init_init_cmd = __esm({
     init_environment();
     init_config();
     init_detector();
+    init_roboco();
+    init_validate_cmd();
     init_ui();
     init_logger();
   }
@@ -7260,6 +7279,29 @@ async function runPipeline(cwd, config, options = {}) {
       config,
       previousResults: ctx.getResults()
     };
+    if (!options.force) {
+      const gateResult = await STAGE_GATES[stageName](cwd).catch(() => null);
+      if (gateResult) {
+        await saveGateResult(cwd, `${stageName}.entry`, gateResult).catch(() => {
+        });
+        if (!gateResult.passed && !options.skipGates) {
+          error(`${stageName} \uAC8C\uC774\uD2B8 \uC2E4\uD328 \u2014 \uD30C\uC774\uD504\uB77C\uC778 \uC911\uB2E8`);
+          for (const v of gateResult.violations) {
+            warn(`  \xB7 ${v.message}${v.location ? ` [${v.location}]` : ""}`);
+          }
+          hint("\uC6B0\uD68C: pai run --skip-gates (\uACBD\uACE0) / --force (\uBB34\uC2DC)");
+          await markStageEnd(cwd, stageName, false, `\uAC8C\uC774\uD2B8 \uC2E4\uD328: ${gateResult.name}`).catch(() => {
+          });
+          shouldStop = true;
+          break;
+        }
+        if (!gateResult.passed && options.skipGates) {
+          for (const v of gateResult.violations) {
+            warn(`  [\uAC8C\uC774\uD2B8 \uACBD\uACE0] ${v.message}`);
+          }
+        }
+      }
+    }
     if (stage.canSkip(input)) {
       info(`${stageName} \u2014 \uAC74\uB108\uB700 (\uC774\uBBF8 \uC644\uB8CC)`);
       ctx.setResult(stageName, {
@@ -7272,8 +7314,14 @@ async function runPipeline(cwd, config, options = {}) {
       });
       continue;
     }
+    await markStageStart(cwd, stageName, "pai run").catch(() => {
+    });
     const result = await stage.run(input);
     ctx.setResult(stageName, result);
+    const stageSuccess = result.status !== "failed";
+    const failReason = result.errors[0]?.message;
+    await markStageEnd(cwd, stageName, stageSuccess, failReason).catch(() => {
+    });
     switch (result.status) {
       case "success":
         success(`${stageName} \uC644\uB8CC (${result.duration}ms)`);
@@ -7321,6 +7369,8 @@ var init_pipeline = __esm({
     init_execution();
     init_validation();
     init_evaluation();
+    init_roboco();
+    init_gates();
     init_ui();
     STAGES = {
       environment: environmentStage,
@@ -7340,23 +7390,17 @@ __export(pipeline_cmd_exports, {
 async function pipelineCommand(cwd, options) {
   printBanner();
   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 acquireLock(cwd, "environment", "pai run", PIPELINE_TTL_MS);
+    try {
+      const config = await loadConfig(cwd) ?? createDefaultConfig("my-project", "prototype");
+      const pipelineOpts = { skipGates: options.skipGates, force: options.force };
+      if (options.from) pipelineOpts.from = options.from;
+      if (options.only) pipelineOpts.only = options.only.split(",").map((s) => s.trim());
+      await runPipeline(cwd, config, pipelineOpts);
+    } finally {
+      await releaseLock(cwd).catch(() => {
+      });
+    }
     await syncHandoff(cwd).catch(() => {
     });
   } catch (err) {