@kynver-app/runtime 0.1.92 → 0.1.95

package/dist/index.js

@@ -35,306 +35,21 @@ function handleCliVersionFlag(argv, moduleUrl = import.meta.url, binName) {
 }
 
 // src/memory-cost-package-version-guard.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import path from "node:path";
-var MEMORY_COST_PACKAGE_MIN_VERSIONS = {
-  "@kynver-app/runtime": "0.1.83",
-  "@kynver-app/openclaw-agent-os": "0.1.43",
-  "@kynver-app/mcp-agent-os": "0.3.34"
-};
-var MEMORY_COST_MANAGED_PACKAGES = Object.keys(
-  MEMORY_COST_PACKAGE_MIN_VERSIONS
-);
-var DISPLAY_NAMES = {
-  "@kynver-app/runtime": "Kynver runtime",
-  "@kynver-app/openclaw-agent-os": "OpenClaw AgentOS plugin",
-  "@kynver-app/mcp-agent-os": "AgentOS MCP server"
-};
-var REPO_PACKAGE_JSON_RELATIVE = {
-  "@kynver-app/runtime": "packages/kynver-runtime/package.json",
-  "@kynver-app/openclaw-agent-os": "packages/kynver-openclaw-agent-os/package.json",
-  "@kynver-app/mcp-agent-os": "packages/kynver-mcp-agent-os/package.json"
-};
-function parseSemverParts(version) {
-  const core = version.trim().split("-")[0]?.split("+")[0];
-  if (!core) return null;
-  const parts = core.split(".");
-  if (parts.length < 1 || parts.length > 3) return null;
-  const nums = parts.map((p) => Number.parseInt(p, 10));
-  if (nums.some((n) => !Number.isFinite(n) || n < 0)) return null;
-  while (nums.length < 3) nums.push(0);
-  return [nums[0], nums[1], nums[2]];
-}
-function compareSemver(a, b) {
-  const pa = parseSemverParts(a);
-  const pb = parseSemverParts(b);
-  if (!pa || !pb) return 0;
-  for (let i = 0; i < 3; i += 1) {
-    if (pa[i] > pb[i]) return 1;
-    if (pa[i] < pb[i]) return -1;
-  }
-  return 0;
-}
-function semverAtLeast(version, minimum) {
-  return compareSemver(version, minimum) >= 0;
-}
-function maxSemver(versions) {
-  let best = null;
-  for (const version of versions) {
-    if (!best || compareSemver(version, best) > 0) best = version;
-  }
-  return best;
-}
-function readPackageJsonVersion(packageJsonPath) {
-  try {
-    const parsed = JSON.parse(readFileSync2(packageJsonPath, "utf8"));
-    return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : null;
-  } catch {
-    return null;
-  }
-}
-function resolveRepoRoot(cwd, explicitRepoRoot) {
-  const candidates = [explicitRepoRoot, process.env.KYNVER_REPO, cwd].filter(
-    (value) => Boolean(value?.trim())
-  );
-  for (const candidate of candidates) {
-    const resolved = path.resolve(candidate);
-    if (existsSync2(path.join(resolved, "packages/kynver-runtime/package.json")) && existsSync2(path.join(resolved, "package.json"))) {
-      return resolved;
-    }
-  }
-  return null;
-}
-function probeRepoPackageVersions(input = {}) {
-  const cwd = input.cwd ?? process.cwd();
-  const repoRoot = resolveRepoRoot(cwd, input.repoRoot);
-  if (!repoRoot) return {};
-  const out = {};
-  for (const packageName of MEMORY_COST_MANAGED_PACKAGES) {
-    const packageJsonPath = path.join(repoRoot, REPO_PACKAGE_JSON_RELATIVE[packageName]);
-    const version = readPackageJsonVersion(packageJsonPath);
-    if (!version) continue;
-    out[packageName] = { version, source: "repo", path: packageJsonPath };
-  }
-  return out;
-}
-function repoSourceCommands(packageName) {
-  if (packageName === "@kynver-app/runtime") {
-    return ["npm run kynver:build", "npm run kynver"];
-  }
-  return [`npm run build -w ${packageName}`];
-}
-function buildRemediation(input) {
-  const { packageName, minimumVersion, effectiveVersion, effectiveSource, repoVersion } = input;
-  const lines = [];
-  if (repoVersion && semverAtLeast(repoVersion, minimumVersion)) {
-    lines.push(
-      `Use the monorepo checkout (${repoVersion}) instead of a stale npm install: ${repoSourceCommands(packageName).join("; ")}.`
-    );
-    lines.push("Do not publish npm packages or wait on an operator release.");
-    return lines;
-  }
-  if (effectiveVersion) {
-    lines.push(
-      `Upgrade ${packageName} from ${effectiveVersion} to >= ${minimumVersion} (npm install -g ${packageName}@latest or align OpenClaw npm prefix).`
-    );
-  } else {
-    lines.push(`Install ${packageName} >= ${minimumVersion} before running memory-heavy AgentOS paths.`);
-  }
-  if (packageName === "@kynver-app/runtime") {
-    lines.push("Repo-source alternative: npm run kynver:build && npm run kynver");
-  }
-  if (effectiveSource === "installed" && repoVersion) {
-    lines.push(`Repo checkout reports ${repoVersion}; rebuild/link repo source if you develop from the monorepo.`);
-  }
-  return lines;
-}
-function pickEffectiveCandidate(candidates) {
-  if (candidates.length === 0) return { version: null, source: "unknown" };
-  const best = maxSemver(candidates.map((candidate) => candidate.version));
-  if (!best) return { version: null, source: "unknown" };
-  const winner = candidates.find((candidate) => candidate.version === best) ?? candidates[0];
-  return { version: winner.version, source: winner.source };
-}
-function evaluateMemoryCostPackageVersionGuard(input = {}) {
-  const normalize2 = (value, fallbackSource) => {
-    if (!value) return null;
-    if (typeof value === "string") return { version: value, source: fallbackSource };
-    return value;
-  };
-  const packages = MEMORY_COST_MANAGED_PACKAGES.map((packageName) => {
-    const minimumVersion = MEMORY_COST_PACKAGE_MIN_VERSIONS[packageName];
-    const candidates = [];
-    const installed = normalize2(input.installed?.[packageName], "installed");
-    const repo = normalize2(input.repo?.[packageName], "repo");
-    const self = normalize2(input.self?.[packageName], "self");
-    if (installed) candidates.push(installed);
-    if (repo) candidates.push(repo);
-    if (self) candidates.push(self);
-    const { version: effectiveVersion, source: effectiveSource } = pickEffectiveCandidate(candidates);
-    const repoVersion = repo?.version ?? null;
-    const ok2 = effectiveVersion ? semverAtLeast(effectiveVersion, minimumVersion) : false;
-    const remediation = ok2 ? [] : buildRemediation({
-      packageName,
-      minimumVersion,
-      effectiveVersion,
-      effectiveSource,
-      repoVersion
-    });
-    const summary2 = ok2 ? `${DISPLAY_NAMES[packageName]} ${effectiveVersion} meets memory-cost minimum ${minimumVersion} (${effectiveSource}).` : `${DISPLAY_NAMES[packageName]} is below memory-cost minimum ${minimumVersion}` + (effectiveVersion ? ` (effective ${effectiveVersion} via ${effectiveSource})` : " (no version detected)") + ".";
-    return {
-      packageName,
-      displayName: DISPLAY_NAMES[packageName],
-      minimumVersion,
-      effectiveVersion,
-      effectiveSource,
-      ok: ok2,
-      summary: summary2,
-      remediation
-    };
-  });
-  const violations = packages.filter((row) => !row.ok);
-  const ok = violations.length === 0;
-  const summary = ok ? "All managed AgentOS packages meet memory-cost minimum versions." : `Memory-cost package guard blocked ${violations.length} stale package(s): ${violations.map((row) => `${row.packageName} < ${row.minimumVersion}`).join("; ")}.`;
-  return { ok, summary, packages };
-}
-var MemoryCostPackageVersionGuardError = class extends Error {
-  result;
-  constructor(result) {
-    const lines = [
-      result.summary,
-      ...result.packages.filter((row) => !row.ok).flatMap((row) => [`- ${row.summary}`, ...row.remediation.map((line) => `  \u2192 ${line}`)])
-    ];
-    super(lines.join("\n"));
-    this.name = "MemoryCostPackageVersionGuardError";
-    this.result = result;
-  }
-};
-function assertMemoryCostPackageVersionGuard(input = {}) {
-  const result = evaluateMemoryCostPackageVersionGuard(input);
-  if (!result.ok) throw new MemoryCostPackageVersionGuardError(result);
-  return result;
-}
-function formatMemoryCostPackageGuardError(result) {
-  return new MemoryCostPackageVersionGuardError(result).message;
-}
-
-// src/installed-package-versions.ts
-import { readFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import path2 from "node:path";
-var MANAGED_PACKAGES = [
-  "@kynver-app/runtime",
-  "@kynver-app/openclaw-agent-os",
-  "@kynver-app/mcp-agent-os"
-];
-function trim(value) {
-  const out = value?.trim();
-  return out ? out : null;
-}
-function unique(values) {
-  return [...new Set(values.filter((value) => Boolean(value)))];
-}
-function moduleRoots() {
-  const home = homedir();
-  const openClawPrefix = trim(process.env.KYNVER_OPENCLAW_NPM_ROOT) ?? trim(process.env.OPENCLAW_NPM_ROOT) ?? path2.join(home, ".openclaw", "npm");
-  const npmGlobalRoot = trim(process.env.KYNVER_NPM_GLOBAL_ROOT) ?? trim(process.env.KYNVER_NPM_GLOBAL_MODULES_ROOT) ?? (trim(process.env.NPM_CONFIG_PREFIX) ? path2.join(trim(process.env.NPM_CONFIG_PREFIX), "lib", "node_modules") : path2.join(home, ".npm-global", "lib", "node_modules"));
-  return unique([
-    path2.join(openClawPrefix, "lib", "node_modules"),
-    path2.join(openClawPrefix, "node_modules"),
-    npmGlobalRoot.endsWith("node_modules") ? npmGlobalRoot : path2.join(npmGlobalRoot, "lib", "node_modules")
-  ]);
-}
-async function readVersion(packageJsonPath) {
-  try {
-    const parsed = JSON.parse(await readFile(packageJsonPath, "utf8"));
-    return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : null;
-  } catch {
-    return null;
-  }
-}
-async function collectInstalledPackageVersions(observedAt = (/* @__PURE__ */ new Date()).toISOString()) {
-  const roots = moduleRoots();
-  const out = {};
-  for (const packageName of MANAGED_PACKAGES) {
-    for (const root of roots) {
-      const packageJsonPath = path2.join(root, packageName, "package.json");
-      const version = await readVersion(packageJsonPath);
-      if (!version) continue;
-      out[packageName] = { version, observedAt, path: packageJsonPath };
-      break;
-    }
-  }
-  return out;
-}
-
-// src/memory-cost-package-version-guard-enforce.ts
-function installedVersionMap(observed) {
-  const out = {};
-  for (const [packageName, row] of Object.entries(observed)) {
-    if (!row?.version) continue;
-    out[packageName] = {
-      version: row.version,
-      source: "installed",
-      path: row.path
-    };
-  }
-  return out;
-}
-async function buildMemoryCostPackageGuardInput(input = {}) {
-  const [installed, repo] = await Promise.all([
-    collectInstalledPackageVersions(),
-    Promise.resolve(probeRepoPackageVersions({ cwd: input.cwd, repoRoot: input.repoRoot }))
-  ]);
-  const self = {};
-  if (input.selfPackageName && input.selfVersion) {
-    self[input.selfPackageName] = { version: input.selfVersion, source: "self" };
-  } else {
-    self["@kynver-app/runtime"] = { version: PACKAGE_VERSION, source: "self" };
-  }
-  return {
-    installed: installedVersionMap(installed),
-    repo,
-    self
-  };
-}
-async function evaluateMemoryCostPackageGuardAtStartup(input = {}) {
-  const guardInput = await buildMemoryCostPackageGuardInput(input);
-  return evaluateMemoryCostPackageVersionGuard(guardInput);
-}
-async function enforceMemoryCostPackageGuardAtStartup(input = {}) {
-  const guardInput = await buildMemoryCostPackageGuardInput(input);
-  return assertMemoryCostPackageVersionGuard(guardInput);
-}
-function shouldEnforceMemoryCostPackageGuardCli(scope, action) {
-  if (!scope) return false;
-  if (scope === "daemon") return true;
-  if (scope === "worker") return true;
-  if (scope === "monitor") return true;
-  if (scope === "run" && (action === "dispatch" || action === "sweep" || action === "reconcile" || action === "unblock")) {
-    return true;
-  }
-  if (scope === "cron" && action === "tick") return true;
-  return false;
-}
-
-// src/config.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync2, readFileSync as readFileSync9, writeFileSync as writeFileSync2 } from "node:fs";
-import { homedir as homedir5, totalmem } from "node:os";
-import path10 from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
+import path4 from "node:path";
 
 // src/default-repo-discovery.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import path5 from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import path3 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // src/git.ts
 import { spawnSync } from "node:child_process";
 
 // src/util.ts
-import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync3, readdirSync, statSync, writeFileSync } from "node:fs";
-import path3 from "node:path";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, readdirSync, statSync, writeFileSync } from "node:fs";
+import path from "node:path";
 function fail(message) {
   console.error(message);
   process.exit(1);
@@ -356,14 +71,14 @@ function safeJson(line) {
 }
 function readJson(file, fallback) {
   try {
-    return JSON.parse(readFileSync3(file, "utf8"));
+    return JSON.parse(readFileSync2(file, "utf8"));
   } catch (error) {
     if (arguments.length > 1) return fallback;
     fail(`failed to read ${file}: ${error.message}`);
   }
 }
 function writeJson(file, value) {
-  mkdirSync(path3.dirname(file), { recursive: true });
+  mkdirSync(path.dirname(file), { recursive: true });
   writeFileSync(file, `${JSON.stringify(value, null, 2)}
 `);
 }
@@ -394,12 +109,12 @@ function fileMtime(file) {
   }
 }
 function tailFile(file, lines) {
-  if (!existsSync3(file)) return "";
-  const data = readFileSync3(file, "utf8");
+  if (!existsSync2(file)) return "";
+  const data = readFileSync2(file, "utf8");
   return data.split("\n").slice(-lines).join("\n");
 }
 function readMaybeFile(file) {
-  return file ? readFileSync3(path3.resolve(file), "utf8") : "";
+  return file ? readFileSync2(path.resolve(file), "utf8") : "";
 }
 function sleepMs(ms) {
   Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
@@ -586,124 +301,433 @@ function computeGitAncestry(worktreePath, baseOrOptions = "origin/main") {
       ...error ? { error } : {}
     };
   }
-  const relation = baseIsAncestorOfHead.isAncestor ? "ahead" : headIsAncestorOfBase.isAncestor ? "merged" : "diverged";
-  return {
-    checked: true,
-    base: baseLabel,
-    head: headSha,
-    baseHead: baseSha,
-    baseIsAncestorOfHead: baseIsAncestorOfHead.isAncestor,
-    headIsAncestorOfBase: headIsAncestorOfBase.isAncestor,
-    relation,
-    ...error ? { error } : {}
-  };
+  const relation = baseIsAncestorOfHead.isAncestor ? "ahead" : headIsAncestorOfBase.isAncestor ? "merged" : "diverged";
+  return {
+    checked: true,
+    base: baseLabel,
+    head: headSha,
+    baseHead: baseSha,
+    baseIsAncestorOfHead: baseIsAncestorOfHead.isAncestor,
+    headIsAncestorOfBase: headIsAncestorOfBase.isAncestor,
+    relation,
+    ...error ? { error } : {}
+  };
+}
+function unknownAncestry(base, error, head = null) {
+  return {
+    checked: false,
+    base,
+    head,
+    baseHead: null,
+    baseIsAncestorOfHead: null,
+    headIsAncestorOfBase: null,
+    relation: "unknown",
+    error
+  };
+}
+
+// src/path-values.ts
+import { homedir } from "node:os";
+import path2 from "node:path";
+function expandHomePath(value) {
+  if (value === "~") return homedir();
+  if (value.startsWith("~/") || value.startsWith("~\\")) {
+    return path2.join(homedir(), value.slice(2));
+  }
+  return value;
+}
+function resolveUserPath(value) {
+  return path2.resolve(expandHomePath(value));
+}
+function redactHomePath(value) {
+  const expanded = expandHomePath(value);
+  const resolved = path2.resolve(expanded);
+  const home = path2.resolve(homedir());
+  if (resolved === home) return "~";
+  if (resolved.startsWith(`${home}${path2.sep}`)) {
+    return `~/${path2.relative(home, resolved).split(path2.sep).join("/")}`;
+  }
+  return resolved.replace(/^\/home\/[^/]+(?=\/|$)/, "~").replace(/^\/Users\/[^/]+(?=\/|$)/, "~");
+}
+function displayUserPath(value) {
+  return redactHomePath(value);
+}
+
+// src/default-repo-discovery.ts
+var WELL_KNOWN_REPO_DIRS = [
+  "Kynver",
+  "repos/Kynver",
+  "repos/kynver-source-main",
+  "code/Kynver",
+  "projects/Kynver"
+];
+function readPackageName(repoRoot) {
+  const pkgPath = path3.join(repoRoot, "package.json");
+  if (!existsSync3(pkgPath)) return null;
+  try {
+    const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
+    return typeof pkg.name === "string" ? pkg.name.trim() : null;
+  } catch {
+    return null;
+  }
+}
+function isKynverMonorepoRoot(repoRoot) {
+  return readPackageName(repoRoot) === "kynver";
+}
+function gitRepoRoot(startDir) {
+  const resolvedStart = path3.resolve(startDir);
+  if (!existsSync3(resolvedStart)) return null;
+  const probe = gitCapture(resolvedStart, ["rev-parse", "--show-toplevel"]);
+  if (probe.status !== 0) return null;
+  const root = probe.stdout.trim();
+  return root.length ? path3.resolve(root) : null;
+}
+function resolveRuntimePackageRoot(moduleUrl = import.meta.url) {
+  let dir = path3.dirname(fileURLToPath2(moduleUrl));
+  for (let depth = 0; depth < 8; depth += 1) {
+    const pkgPath = path3.join(dir, "package.json");
+    if (existsSync3(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
+        if (pkg.name === "@kynver-app/runtime") return dir;
+      } catch {
+      }
+    }
+    const parent = path3.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+function pushCandidate(seen, out, repo, source) {
+  if (!repo) return;
+  const resolved = path3.resolve(repo);
+  if (seen.has(resolved)) return;
+  if (!isKynverMonorepoRoot(resolved)) return;
+  seen.add(resolved);
+  out.push({ repo: resolved, source });
+}
+function discoverDefaultRepoCandidates(opts) {
+  const cwd = opts?.cwd ?? process.cwd();
+  const seen = /* @__PURE__ */ new Set();
+  const candidates = [];
+  pushCandidate(seen, candidates, gitRepoRoot(cwd), "cwd_git");
+  const runtimePkgRoot = resolveRuntimePackageRoot(opts?.runtimeModuleUrl ?? import.meta.url);
+  if (runtimePkgRoot) {
+    pushCandidate(seen, candidates, gitRepoRoot(runtimePkgRoot), "runtime_checkout");
+  }
+  const home = homedir2();
+  for (const rel of WELL_KNOWN_REPO_DIRS) {
+    pushCandidate(seen, candidates, resolveUserPath(path3.join(home, rel)), "well_known_path");
+  }
+  return candidates;
+}
+function discoverDefaultRepo(opts) {
+  return discoverDefaultRepoCandidates(opts)[0] ?? null;
+}
+
+// src/memory-cost-package-version-guard.ts
+var MEMORY_COST_PACKAGE_MIN_VERSIONS = {
+  "@kynver-app/runtime": "0.1.83",
+  "@kynver-app/openclaw-agent-os": "0.1.43",
+  "@kynver-app/mcp-agent-os": "0.3.34"
+};
+var MEMORY_COST_MANAGED_PACKAGES = Object.keys(
+  MEMORY_COST_PACKAGE_MIN_VERSIONS
+);
+var DISPLAY_NAMES = {
+  "@kynver-app/runtime": "Kynver runtime",
+  "@kynver-app/openclaw-agent-os": "OpenClaw AgentOS plugin",
+  "@kynver-app/mcp-agent-os": "AgentOS MCP server"
+};
+var REPO_PACKAGE_JSON_RELATIVE = {
+  "@kynver-app/runtime": "packages/kynver-runtime/package.json",
+  "@kynver-app/openclaw-agent-os": "packages/kynver-openclaw-agent-os/package.json",
+  "@kynver-app/mcp-agent-os": "packages/kynver-mcp-agent-os/package.json"
+};
+function parseSemverParts(version) {
+  const core = version.trim().split("-")[0]?.split("+")[0];
+  if (!core) return null;
+  const parts = core.split(".");
+  if (parts.length < 1 || parts.length > 3) return null;
+  const nums = parts.map((p) => Number.parseInt(p, 10));
+  if (nums.some((n) => !Number.isFinite(n) || n < 0)) return null;
+  while (nums.length < 3) nums.push(0);
+  return [nums[0], nums[1], nums[2]];
+}
+function compareSemver(a, b) {
+  const pa = parseSemverParts(a);
+  const pb = parseSemverParts(b);
+  if (!pa || !pb) return 0;
+  for (let i = 0; i < 3; i += 1) {
+    if (pa[i] > pb[i]) return 1;
+    if (pa[i] < pb[i]) return -1;
+  }
+  return 0;
+}
+function semverAtLeast(version, minimum) {
+  return compareSemver(version, minimum) >= 0;
+}
+function maxSemver(versions) {
+  let best = null;
+  for (const version of versions) {
+    if (!best || compareSemver(version, best) > 0) best = version;
+  }
+  return best;
+}
+function readPackageJsonVersion(packageJsonPath) {
+  try {
+    const parsed = JSON.parse(readFileSync4(packageJsonPath, "utf8"));
+    return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : null;
+  } catch {
+    return null;
+  }
+}
+function resolveRepoRoot(cwd, explicitRepoRoot) {
+  const candidates = [explicitRepoRoot, process.env.KYNVER_REPO, cwd].filter(
+    (value) => Boolean(value?.trim())
+  );
+  for (const candidate of candidates) {
+    const resolved = path4.resolve(candidate);
+    if (existsSync4(path4.join(resolved, "packages/kynver-runtime/package.json")) && existsSync4(path4.join(resolved, "package.json"))) {
+      return resolved;
+    }
+  }
+  const discovered = discoverDefaultRepo({ cwd });
+  return discovered?.repo ?? null;
+}
+function probeRepoPackageVersions(input = {}) {
+  const cwd = input.cwd ?? process.cwd();
+  const repoRoot = resolveRepoRoot(cwd, input.repoRoot);
+  if (!repoRoot) return {};
+  const out = {};
+  for (const packageName of MEMORY_COST_MANAGED_PACKAGES) {
+    const packageJsonPath = path4.join(repoRoot, REPO_PACKAGE_JSON_RELATIVE[packageName]);
+    const version = readPackageJsonVersion(packageJsonPath);
+    if (!version) continue;
+    out[packageName] = { version, source: "repo", path: packageJsonPath };
+  }
+  return out;
+}
+function repoSourceCommands(packageName) {
+  if (packageName === "@kynver-app/runtime") {
+    return ["npm run kynver:build", "npm run kynver"];
+  }
+  return [`npm run build -w ${packageName}`];
+}
+function buildRemediation(input) {
+  const { packageName, minimumVersion, effectiveVersion, effectiveSource, repoVersion } = input;
+  const lines = [];
+  if (repoVersion && semverAtLeast(repoVersion, minimumVersion)) {
+    lines.push(
+      `Use the monorepo checkout (${repoVersion}) instead of a stale npm install: ${repoSourceCommands(packageName).join("; ")}.`
+    );
+    lines.push("Do not publish npm packages or wait on an operator release.");
+    return lines;
+  }
+  if (effectiveVersion) {
+    lines.push(
+      `Upgrade ${packageName} from ${effectiveVersion} to >= ${minimumVersion} (npm install -g ${packageName}@latest or align OpenClaw npm prefix).`
+    );
+  } else {
+    lines.push(`Install ${packageName} >= ${minimumVersion} before running memory-heavy AgentOS paths.`);
+  }
+  if (packageName === "@kynver-app/runtime") {
+    lines.push("Repo-source alternative: npm run kynver:build && npm run kynver");
+  }
+  if (effectiveSource === "installed" && repoVersion) {
+    lines.push(`Repo checkout reports ${repoVersion}; rebuild/link repo source if you develop from the monorepo.`);
+  }
+  return lines;
+}
+function pickEffectiveCandidate(candidates) {
+  if (candidates.length === 0) return { version: null, source: "unknown" };
+  const best = maxSemver(candidates.map((candidate) => candidate.version));
+  if (!best) return { version: null, source: "unknown" };
+  const winner = candidates.find((candidate) => candidate.version === best) ?? candidates[0];
+  return { version: winner.version, source: winner.source };
+}
+function evaluateMemoryCostPackageVersionGuard(input = {}) {
+  const normalize2 = (value, fallbackSource) => {
+    if (!value) return null;
+    if (typeof value === "string") return { version: value, source: fallbackSource };
+    return value;
+  };
+  const packages = MEMORY_COST_MANAGED_PACKAGES.map((packageName) => {
+    const minimumVersion = MEMORY_COST_PACKAGE_MIN_VERSIONS[packageName];
+    const candidates = [];
+    const installed = normalize2(input.installed?.[packageName], "installed");
+    const repo = normalize2(input.repo?.[packageName], "repo");
+    const self = normalize2(input.self?.[packageName], "self");
+    if (installed) candidates.push(installed);
+    if (repo) candidates.push(repo);
+    if (self) candidates.push(self);
+    const { version: effectiveVersion, source: effectiveSource } = pickEffectiveCandidate(candidates);
+    const repoVersion = repo?.version ?? null;
+    const ok2 = effectiveVersion ? semverAtLeast(effectiveVersion, minimumVersion) : false;
+    const remediation = ok2 ? [] : buildRemediation({
+      packageName,
+      minimumVersion,
+      effectiveVersion,
+      effectiveSource,
+      repoVersion
+    });
+    const summary2 = ok2 ? `${DISPLAY_NAMES[packageName]} ${effectiveVersion} meets memory-cost minimum ${minimumVersion} (${effectiveSource}).` : `${DISPLAY_NAMES[packageName]} is below memory-cost minimum ${minimumVersion}` + (effectiveVersion ? ` (effective ${effectiveVersion} via ${effectiveSource})` : " (no version detected)") + ".";
+    return {
+      packageName,
+      displayName: DISPLAY_NAMES[packageName],
+      minimumVersion,
+      effectiveVersion,
+      effectiveSource,
+      ok: ok2,
+      summary: summary2,
+      remediation
+    };
+  });
+  const violations = packages.filter((row) => !row.ok);
+  const ok = violations.length === 0;
+  const summary = ok ? "All managed AgentOS packages meet memory-cost minimum versions." : `Memory-cost package guard blocked ${violations.length} stale package(s): ${violations.map((row) => `${row.packageName} < ${row.minimumVersion}`).join("; ")}.`;
+  return { ok, summary, packages };
+}
+var MemoryCostPackageVersionGuardError = class extends Error {
+  result;
+  constructor(result) {
+    const lines = [
+      result.summary,
+      ...result.packages.filter((row) => !row.ok).flatMap((row) => [`- ${row.summary}`, ...row.remediation.map((line) => `  \u2192 ${line}`)])
+    ];
+    super(lines.join("\n"));
+    this.name = "MemoryCostPackageVersionGuardError";
+    this.result = result;
+  }
+};
+function assertMemoryCostPackageVersionGuard(input = {}) {
+  const result = evaluateMemoryCostPackageVersionGuard(input);
+  if (!result.ok) throw new MemoryCostPackageVersionGuardError(result);
+  return result;
 }
-function unknownAncestry(base, error, head = null) {
-  return {
-    checked: false,
-    base,
-    head,
-    baseHead: null,
-    baseIsAncestorOfHead: null,
-    headIsAncestorOfBase: null,
-    relation: "unknown",
-    error
-  };
+function formatMemoryCostPackageGuardError(result) {
+  return new MemoryCostPackageVersionGuardError(result).message;
 }
 
-// src/path-values.ts
-import { homedir as homedir2 } from "node:os";
-import path4 from "node:path";
-function expandHomePath(value) {
-  if (value === "~") return homedir2();
-  if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return path4.join(homedir2(), value.slice(2));
-  }
-  return value;
-}
-function resolveUserPath(value) {
-  return path4.resolve(expandHomePath(value));
+// src/installed-package-versions.ts
+import { readFile } from "node:fs/promises";
+import { homedir as homedir3 } from "node:os";
+import path5 from "node:path";
+var MANAGED_PACKAGES = [
+  "@kynver-app/runtime",
+  "@kynver-app/openclaw-agent-os",
+  "@kynver-app/mcp-agent-os"
+];
+function trim(value) {
+  const out = value?.trim();
+  return out ? out : null;
 }
-function redactHomePath(value) {
-  const expanded = expandHomePath(value);
-  const resolved = path4.resolve(expanded);
-  const home = path4.resolve(homedir2());
-  if (resolved === home) return "~";
-  if (resolved.startsWith(`${home}${path4.sep}`)) {
-    return `~/${path4.relative(home, resolved).split(path4.sep).join("/")}`;
-  }
-  return resolved.replace(/^\/home\/[^/]+(?=\/|$)/, "~").replace(/^\/Users\/[^/]+(?=\/|$)/, "~");
+function unique(values) {
+  return [...new Set(values.filter((value) => Boolean(value)))];
 }
-function displayUserPath(value) {
-  return redactHomePath(value);
+function moduleRoots() {
+  const home = homedir3();
+  const openClawPrefix = trim(process.env.KYNVER_OPENCLAW_NPM_ROOT) ?? trim(process.env.OPENCLAW_NPM_ROOT) ?? path5.join(home, ".openclaw", "npm");
+  const npmGlobalRoot = trim(process.env.KYNVER_NPM_GLOBAL_ROOT) ?? trim(process.env.KYNVER_NPM_GLOBAL_MODULES_ROOT) ?? (trim(process.env.NPM_CONFIG_PREFIX) ? path5.join(trim(process.env.NPM_CONFIG_PREFIX), "lib", "node_modules") : path5.join(home, ".npm-global", "lib", "node_modules"));
+  return unique([
+    path5.join(openClawPrefix, "lib", "node_modules"),
+    path5.join(openClawPrefix, "node_modules"),
+    npmGlobalRoot.endsWith("node_modules") ? npmGlobalRoot : path5.join(npmGlobalRoot, "lib", "node_modules")
+  ]);
 }
-
-// src/default-repo-discovery.ts
-var WELL_KNOWN_REPO_DIRS = ["Kynver", "repos/Kynver", "code/Kynver", "projects/Kynver"];
-function readPackageName(repoRoot) {
-  const pkgPath = path5.join(repoRoot, "package.json");
-  if (!existsSync4(pkgPath)) return null;
+async function readVersion(packageJsonPath) {
   try {
-    const pkg = JSON.parse(readFileSync4(pkgPath, "utf8"));
-    return typeof pkg.name === "string" ? pkg.name.trim() : null;
+    const parsed = JSON.parse(await readFile(packageJsonPath, "utf8"));
+    return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : null;
   } catch {
     return null;
   }
 }
-function isKynverMonorepoRoot(repoRoot) {
-  return readPackageName(repoRoot) === "kynver";
-}
-function gitRepoRoot(startDir) {
-  const resolvedStart = path5.resolve(startDir);
-  if (!existsSync4(resolvedStart)) return null;
-  const probe = gitCapture(resolvedStart, ["rev-parse", "--show-toplevel"]);
-  if (probe.status !== 0) return null;
-  const root = probe.stdout.trim();
-  return root.length ? path5.resolve(root) : null;
+function installedPackageJsonCandidates(packageName) {
+  const roots = moduleRoots();
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const root of roots) {
+    const candidate = path5.join(root, packageName, "package.json");
+    if (seen.has(candidate)) continue;
+    seen.add(candidate);
+    out.push(candidate);
+  }
+  return out;
 }
-function resolveRuntimePackageRoot(moduleUrl = import.meta.url) {
-  let dir = path5.dirname(fileURLToPath2(moduleUrl));
-  for (let depth = 0; depth < 8; depth += 1) {
-    const pkgPath = path5.join(dir, "package.json");
-    if (existsSync4(pkgPath)) {
-      try {
-        const pkg = JSON.parse(readFileSync4(pkgPath, "utf8"));
-        if (pkg.name === "@kynver-app/runtime") return dir;
-      } catch {
+async function collectInstalledPackageVersions(observedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+  const out = {};
+  for (const packageName of MANAGED_PACKAGES) {
+    let best = null;
+    for (const packageJsonPath of installedPackageJsonCandidates(packageName)) {
+      const version = await readVersion(packageJsonPath);
+      if (!version) continue;
+      if (!best || compareSemver(version, best.version) > 0) {
+        best = { version, path: packageJsonPath };
       }
     }
-    const parent = path5.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
+    if (best) {
+      out[packageName] = { version: best.version, observedAt, path: best.path };
+    }
   }
-  return null;
-}
-function pushCandidate(seen, out, repo, source) {
-  if (!repo) return;
-  const resolved = path5.resolve(repo);
-  if (seen.has(resolved)) return;
-  if (!isKynverMonorepoRoot(resolved)) return;
-  seen.add(resolved);
-  out.push({ repo: resolved, source });
+  return out;
 }
-function discoverDefaultRepoCandidates(opts) {
-  const cwd = opts?.cwd ?? process.cwd();
-  const seen = /* @__PURE__ */ new Set();
-  const candidates = [];
-  pushCandidate(seen, candidates, gitRepoRoot(cwd), "cwd_git");
-  const runtimePkgRoot = resolveRuntimePackageRoot(opts?.runtimeModuleUrl ?? import.meta.url);
-  if (runtimePkgRoot) {
-    pushCandidate(seen, candidates, gitRepoRoot(runtimePkgRoot), "runtime_checkout");
+
+// src/memory-cost-package-version-guard-enforce.ts
+function installedVersionMap(observed) {
+  const out = {};
+  for (const [packageName, row] of Object.entries(observed)) {
+    if (!row?.version) continue;
+    out[packageName] = {
+      version: row.version,
+      source: "installed",
+      path: row.path
+    };
   }
-  const home = homedir3();
-  for (const rel of WELL_KNOWN_REPO_DIRS) {
-    pushCandidate(seen, candidates, resolveUserPath(path5.join(home, rel)), "well_known_path");
+  return out;
+}
+async function buildMemoryCostPackageGuardInput(input = {}) {
+  const [installed, repo] = await Promise.all([
+    collectInstalledPackageVersions(),
+    Promise.resolve(probeRepoPackageVersions({ cwd: input.cwd, repoRoot: input.repoRoot }))
+  ]);
+  const self = {};
+  const runtimeSelfVersion = input.selfPackageName === "@kynver-app/runtime" && input.selfVersion ? input.selfVersion : PACKAGE_VERSION;
+  self["@kynver-app/runtime"] = { version: runtimeSelfVersion, source: "self" };
+  if (input.selfPackageName && input.selfVersion && input.selfPackageName !== "@kynver-app/runtime") {
+    self[input.selfPackageName] = { version: input.selfVersion, source: "self" };
   }
-  return candidates;
+  return {
+    installed: installedVersionMap(installed),
+    repo,
+    self
+  };
 }
-function discoverDefaultRepo(opts) {
-  return discoverDefaultRepoCandidates(opts)[0] ?? null;
+async function evaluateMemoryCostPackageGuardAtStartup(input = {}) {
+  const guardInput = await buildMemoryCostPackageGuardInput(input);
+  return evaluateMemoryCostPackageVersionGuard(guardInput);
 }
+async function enforceMemoryCostPackageGuardAtStartup(input = {}) {
+  const guardInput = await buildMemoryCostPackageGuardInput(input);
+  return assertMemoryCostPackageVersionGuard(guardInput);
+}
+function shouldEnforceMemoryCostPackageGuardCli(scope, action) {
+  if (!scope) return false;
+  if (scope === "daemon") return true;
+  if (scope === "worker") return true;
+  if (scope === "monitor") return true;
+  if (scope === "run" && (action === "dispatch" || action === "sweep" || action === "reconcile" || action === "unblock")) {
+    return true;
+  }
+  if (scope === "cron" && action === "tick") return true;
+  return false;
+}
+
+// src/config.ts
+import { existsSync as existsSync11, mkdirSync as mkdirSync2, readFileSync as readFileSync9, writeFileSync as writeFileSync2 } from "node:fs";
+import { homedir as homedir5, totalmem } from "node:os";
+import path10 from "node:path";
 
 // src/box-identity.ts
 function normalizeWorkerPoolBoxKind(raw) {
@@ -4438,14 +4462,15 @@ function buildPrompt(input) {
     input.planId ? `Active planId: ${input.planId}${input.taskId ? ` \xB7 taskId: ${input.taskId}` : ""}` : "No planId on this worker \u2014 still emit progress when you touch plan-scoped work."
   ];
   const mergeGateLines = compact ? [
-    "Merge-gate cost control: do not use Vercel previews/builds for PR verification. Run `node scripts/agent-os-pr-merge-gate.mjs --pr <url> --agent-os-id <id>` (or `verify-pr-local.mjs --from-pr` + POST pr-merge-gate/refresh) before any GitHub Actions run; request merge-gate only via refresh then POST pr-merge-gate/request-run (one Actions run per PR head unless human approves extra)."
+    "Merge-gate cost control: do not use Vercel previews/builds for PR verification. Run `node scripts/agent-os-pr-merge-gate.mjs --pr <url> --agent-os-id <id>` (or `verify-pr-local.mjs --from-pr` + POST pr-merge-gate/refresh) before any GitHub Actions run; request merge-gate only via refresh then POST pr-merge-gate/request-run (one Actions run per PR head unless human approves extra). Per-PR Vercel preview builds are off by default \u2014 production deploy runs via release batch after merge."
   ] : [
     "GitHub Actions merge-gate cost control (Kynver/Hermes PRs):",
     "- Prefer local cached package verification (`node scripts/verify-pr-local.mjs --emit-json`) before GitHub Actions. Do not use Vercel previews/builds as PR evidence.",
     "- Do not push empty commits to re-trigger CI. One budgeted merge-gate Actions run per PR candidate (head SHA) unless a human approves extra.",
     "- Record evidence: POST `/api/agent-os/by-id/<agentOsId>/pr-merge-gate/refresh` with prUrl + local payloads.",
     "- Request the final Actions run only when local verification is green: POST `.../pr-merge-gate/request-run` (applies `merge-gate` label).",
-    "- Empty failed Actions jobs (no runner/steps/logs) are infra/quota \u2014 do not enter repair loops; escalate to operator."
+    "- Empty failed Actions jobs (no runner/steps/logs) are infra/quota \u2014 do not enter repair loops; escalate to operator.",
+    "- After merge, landed PRs accumulate into a release batch; run batch verification then manual Vercel production deploy from Command Center (release train). PR landing completes with: verification complete, awaiting release batch/deploy."
   ];
   const planArtifactLines = compact ? [
     "Plan artifacts: when authoring/revising docs/superpowers/plans/, open a GitHub PR early and iterate from that PR branch; do not leave the canonical plan only in the harness worktree."
@@ -7410,7 +7435,7 @@ async function dispatchRun(args) {
       runnerPresence,
       harnessBoardSnapshot: buildRunBoard(run.id),
       ...args.lane ? { lane: resolveDispatchNextLaneFilter(String(args.lane)) } : {},
-      executor: args.executor ? String(args.executor) : "harness",
+      ...args.executor ? { executor: String(args.executor) } : {},
       ...args.diskPath ? { diskPath: String(args.diskPath) } : {},
       ...args.targetTaskId ? { targetTaskId: String(args.targetTaskId) } : {},
       ...!args.targetTaskId && args.targetTaskIds ? {
@@ -13483,9 +13508,7 @@ var defaultRuntimeTakeoverProbes = {
   harnessRoot: () => resolveHarnessRoot(),
   legacyOpenclawHarnessRoot: () => path66.join(homedir16(), ".openclaw", "harness"),
   pathExists: (target) => existsSync46(target),
-  pathWritable: (target) => isWritable(target),
-  vercelVersion: () => captureCommand("vercel", ["--version"]),
-  vercelWhoami: () => captureCommand("vercel", ["whoami"])
+  pathWritable: (target) => isWritable(target)
 };
 
 // src/doctor/runtime-takeover-scheduler.ts
@@ -13852,29 +13875,38 @@ function assessRunnerToken(probes) {
   ];
   return { id: "runner_token", label: "Runner token readiness", checks };
 }
-function assessVercelCli(probes) {
-  const version = probes.vercelVersion();
-  const whoami = probes.vercelWhoami();
-  const installed = version.ok;
+function assessVercelDeployEvidence(probes) {
+  const globalCli = probes.commandOnPath("vercel");
+  const cliInstalled = globalCli.ok;
+  const githubToken = Boolean(
+    process.env.GITHUB_TOKEN?.trim() || process.env.GH_TOKEN?.trim()
+  );
+  const vercelToken = Boolean(process.env.VERCEL_TOKEN?.trim());
   return {
-    id: "vercel_cli",
-    label: "Vercel CLI",
+    id: "vercel_deploy_evidence",
+    label: "Vercel deploy evidence",
     checks: [
       check2({
-        id: "vercel_installed",
-        label: "Vercel CLI installed",
-        status: installed ? "pass" : "warn",
-        summary: installed ? version.stdout || "vercel CLI found" : version.error ?? "vercel not found on PATH",
-        remediation: installed ? void 0 : "Install Vercel CLI (`npm i -g vercel`) for deploy evidence and env pulls.",
-        details: { stderr: version.stderr || null }
+        id: "vercel_global_cli_absent",
+        label: "Global Vercel CLI not installed",
+        status: cliInstalled ? "warn" : "pass",
+        summary: cliInstalled ? `Global Vercel CLI found (${globalCli.stdout || "on PATH"}) \u2014 uninstall after operator approval` : "No global Vercel CLI on PATH",
+        remediation: cliInstalled ? "Uninstall global Vercel CLI (`npm uninstall -g vercel`) \u2014 use GitHub commit status or scoped VERCEL_TOKEN + REST API instead." : void 0,
+        details: { path: cliInstalled ? globalCli.stdout || null : null }
+      }),
+      check2({
+        id: "github_token_for_vercel_status",
+        label: "GitHub token for Vercel status",
+        status: githubToken ? "pass" : "warn",
+        summary: githubToken ? "GITHUB_TOKEN/GH_TOKEN present for GitHub Vercel StatusContext evidence" : "No GITHUB_TOKEN \u2014 merge-gate Vercel evidence requires GitHub commit status API",
+        remediation: githubToken ? void 0 : "Export GITHUB_TOKEN (or GH_TOKEN) for PR head commit status lookups."
       }),
       check2({
-        id: "vercel_authenticated",
-        label: "Vercel CLI authenticated",
-        status: !installed ? "warn" : whoami.ok ? "pass" : "warn",
-        summary: !installed ? "Skipped \u2014 Vercel CLI not installed" : whoami.ok ? `Authenticated as ${whoami.stdout}` : whoami.stderr || whoami.error || "Not logged in",
-        remediation: installed && !whoami.ok ? "Run `vercel login` and link the Kynver project if needed." : void 0,
-        details: { account: whoami.ok ? whoami.stdout : null }
+        id: "vercel_api_token_optional",
+        label: "Vercel API token (optional fallback)",
+        status: vercelToken ? "pass" : "warn",
+        summary: vercelToken ? "VERCEL_TOKEN configured for optional REST API deployment lookup" : "VERCEL_TOKEN unset \u2014 GitHub status is the default path; API fallback disabled",
+        remediation: vercelToken ? void 0 : "Set ephemeral/scoped VERCEL_TOKEN only when GitHub status is insufficient; avoid persistent ~/.vercel auth on runner hosts."
       })
     ]
   };
@@ -14013,7 +14045,7 @@ function assessRuntimeTakeoverReadiness(probes = defaultRuntimeTakeoverProbes) {
     assessCliPackage(probes),
     assessUserConfig(probes),
     assessRunnerToken(probes),
-    assessVercelCli(probes),
+    assessVercelDeployEvidence(probes),
     assessHarnessDirs(probes),
     assessCallbackAuth(probes),
     assessOpenclawHotspots(probes)
@@ -14363,7 +14395,19 @@ async function main(argv = process.argv.slice(2)) {
   mkdirSync8(runsDir, { recursive: true });
   mkdirSync8(worktreesDir, { recursive: true });
   if (shouldEnforceMemoryCostPackageGuardCli(scope, action)) {
-    await enforceMemoryCostPackageGuardAtStartup();
+    let repoRoot;
+    const runId = args.run ? String(args.run).trim() : "";
+    if (runId) {
+      try {
+        repoRoot = loadRun(runId).repo;
+      } catch {
+        repoRoot = void 0;
+      }
+    }
+    await enforceMemoryCostPackageGuardAtStartup({
+      repoRoot,
+      cwd: repoRoot
+    });
   }
   if (scope === "login") return void await runLogin(args);
   if (scope === "runner" && action === "credential") return void await mintRunnerCredential(args);
@@ -14435,6 +14479,76 @@ if (isCliEntry) {
   });
 }
 
+// src/vercel/vercel-api.ts
+var VERCEL_API = "https://api.vercel.com";
+function resolveToken(explicit) {
+  const trimmed = explicit?.trim();
+  if (trimmed) return trimmed;
+  return process.env.VERCEL_TOKEN?.trim() || null;
+}
+function mapReadyState(state) {
+  return (state ?? "").trim().toUpperCase();
+}
+function previewUrlFromDeployment(url) {
+  if (typeof url !== "string" || !url.trim()) return null;
+  const trimmed = url.trim();
+  return trimmed.startsWith("http") ? trimmed : `https://${trimmed}`;
+}
+async function fetchVercelDeploymentStatus(deploymentIdOrUrl, options = {}) {
+  const target = deploymentIdOrUrl.trim();
+  if (!target) {
+    return { ok: false, readyState: null, previewUrl: null, error: "missing deployment id or URL" };
+  }
+  const token = resolveToken(options.token);
+  if (!token) {
+    return {
+      ok: false,
+      readyState: null,
+      previewUrl: null,
+      error: "VERCEL_TOKEN not configured"
+    };
+  }
+  const teamId = options.teamId?.trim() || process.env.VERCEL_TEAM_ID?.trim();
+  const teamQuery = teamId ? `?teamId=${encodeURIComponent(teamId)}` : "";
+  const fetchImpl = options.fetchImpl ?? fetch;
+  try {
+    const res = await fetchImpl(`${VERCEL_API}/v13/deployments/${encodeURIComponent(target)}${teamQuery}`, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (!res.ok) {
+      const body = await res.text();
+      return {
+        ok: false,
+        readyState: null,
+        previewUrl: null,
+        error: `Vercel API ${res.status}: ${body.slice(0, 200)}`
+      };
+    }
+    const data = await res.json();
+    const readyState = mapReadyState(data.readyState ?? data.state);
+    return {
+      ok: true,
+      readyState: readyState || null,
+      previewUrl: previewUrlFromDeployment(data.url),
+      error: null
+    };
+  } catch (err) {
+    return {
+      ok: false,
+      readyState: null,
+      previewUrl: null,
+      error: err instanceof Error ? err.message : "Vercel API fetch failed"
+    };
+  }
+}
+function mapVercelReadyStateToEvidenceStatus(readyState, githubPending) {
+  const state = mapReadyState(readyState);
+  if (state === "READY") return "ready";
+  if (state === "ERROR" || state === "CANCELED") return "error";
+  if (state === "BUILDING" || state === "QUEUED" || state === "INITIALIZING") return "building";
+  return githubPending ? "building" : "error";
+}
+
 // src/vercel/vercel-url.ts
 var VERCEL_HOST_RE = /(^|\.)vercel\.app$/i;
 var DPL_ID_RE = /^dpl_[a-z0-9]+$/i;
@@ -14565,8 +14679,6 @@ function pickVercelStatusContext(statuses) {
 }
 
 // src/vercel/vercel-evidence.ts
-import { spawnSync as spawnSync10 } from "node:child_process";
-var DEFAULT_INSPECT_WAIT_SECONDS = 120;
 function mapGitHubStateToEvidence(state) {
   if (state === "success") return "ready";
   if (state === "pending") return "building";
@@ -14589,7 +14701,7 @@ function resolveVercelInspectTarget(rawUrl) {
     return {
       target: null,
       classified,
-      reason: classified.deploymentId ? "dashboard deployment id is not CLI-inspectable; trust GitHub Vercel status" : "dashboard URL is not valid for vercel inspect"
+      reason: classified.deploymentId ? "dashboard deployment id is not API-inspectable; trust GitHub Vercel status" : "dashboard URL is not valid for Vercel API lookup"
     };
   }
   return { target: null, classified, reason: "unrecognized Vercel URL" };
@@ -14620,55 +14732,16 @@ function evidenceFromGitHubVercelStatus(statuses, options = {}) {
     summary: evidenceSummary([
       `GitHub ${row.context}=${row.state}`,
       row.description ?? "",
-      row.dashboardUrl ? "dashboard target_url (inspect skipped)" : ""
+      row.dashboardUrl ? "dashboard target_url (API lookup skipped)" : ""
     ]),
     observedAt,
     inspectSkipped: true,
-    inspectReason: row.dashboardUrl && row.state === "success" ? "trusted_github_status_dashboard_url" : row.dashboardUrl ? "dashboard_url_not_inspectable" : "github_status_only",
+    inspectReason: row.dashboardUrl && row.state === "success" ? "trusted_github_status_dashboard_url" : row.dashboardUrl ? "dashboard_url_not_api_inspectable" : "github_status_only",
     githubState: row.state,
     vercelContext: row.context
   };
 }
-function defaultRunVercelInspect(target, waitSeconds) {
-  if (!isInspectableVercelTarget(target)) {
-    return {
-      ok: false,
-      exitCode: 1,
-      stdout: "",
-      stderr: "",
-      error: "refusing vercel inspect on non-inspectable target (dashboard URLs use GitHub status)"
-    };
-  }
-  const args = ["inspect", target, "--wait", String(waitSeconds)];
-  const result = spawnSync10("vercel", args, {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "pipe"]
-  });
-  if (result.error) {
-    return {
-      ok: false,
-      exitCode: result.status,
-      stdout: "",
-      stderr: "",
-      error: result.error.message
-    };
-  }
-  return {
-    ok: result.status === 0,
-    exitCode: result.status ?? 1,
-    stdout: (result.stdout ?? "").trim(),
-    stderr: (result.stderr ?? "").trim(),
-    error: null
-  };
-}
-function parseInspectReady(stdout, stderr) {
-  const blob = `${stdout}
-${stderr}`.toLowerCase();
-  if (/\b(status|state)\s*[:=]\s*(ready|completed)\b/.test(blob)) return true;
-  if (/\bready\b/.test(blob) && !/\bnot ready\b/.test(blob)) return true;
-  return false;
-}
-function collectVercelEvidence(input) {
+async function collectVercelEvidence(input) {
   const observedAt = input.observedAt ?? (/* @__PURE__ */ new Date()).toISOString();
   const base = evidenceFromGitHubVercelStatus(input.statuses ?? [], { observedAt });
   const row = pickVercelStatusContext(input.statuses ?? []);
@@ -14684,7 +14757,7 @@ function collectVercelEvidence(input) {
     return {
       ...base,
       inspectSkipped: true,
-      inspectReason: "inspect_disabled"
+      inspectReason: "api_lookup_disabled"
     };
   }
   const { target, reason } = resolveVercelInspectTarget(row.targetUrl);
@@ -14692,39 +14765,37 @@ function collectVercelEvidence(input) {
     return {
       ...base,
       inspectSkipped: true,
-      inspectReason: reason ?? "not_inspectable",
+      inspectReason: reason ?? "not_api_inspectable",
       summary: evidenceSummary([
         base.summary ?? "",
-        reason ?? "skipped vercel inspect"
+        reason ?? "skipped Vercel API lookup"
       ])
     };
   }
-  const waitSeconds = input.waitSeconds ?? DEFAULT_INSPECT_WAIT_SECONDS;
-  const runInspect = input.runInspect ?? defaultRunVercelInspect;
-  const inspected = runInspect(target, waitSeconds);
+  const runLookup = input.runInspect ?? fetchVercelDeploymentStatus;
+  const lookedUp = await runLookup(target);
   const observed = (/* @__PURE__ */ new Date()).toISOString();
-  if (inspected.error?.includes("ENOENT")) {
+  if (!lookedUp.ok && lookedUp.error?.includes("VERCEL_TOKEN")) {
     return {
       status: "unavailable",
       previewUrl: base.previewUrl,
       deploymentUrl: base.deploymentUrl,
-      summary: "vercel CLI not found on PATH",
+      summary: "VERCEL_TOKEN not configured for API fallback",
       observedAt: observed,
       inspectSkipped: true,
-      inspectReason: "vercel_cli_missing",
+      inspectReason: "vercel_token_missing",
       githubState: row.state,
       vercelContext: row.context
     };
   }
-  if (!inspected.ok) {
-    const detail = [inspected.stderr, inspected.stdout, inspected.error].filter(Boolean).join("\n").trim().slice(0, 500);
+  if (!lookedUp.ok) {
     return {
       status: row.state === "pending" ? "building" : "error",
       previewUrl: base.previewUrl,
       deploymentUrl: target.startsWith("http") ? target : base.deploymentUrl,
       summary: evidenceSummary([
-        `vercel inspect ${target} failed (exit ${inspected.exitCode ?? "?"})`,
-        detail
+        `Vercel API lookup ${target} failed`,
+        lookedUp.error ?? ""
       ]),
       observedAt: observed,
       inspectSkipped: false,
@@ -14733,12 +14804,19 @@ function collectVercelEvidence(input) {
       vercelContext: row.context
     };
   }
-  const ready = parseInspectReady(inspected.stdout, inspected.stderr);
+  const mapped = mapVercelReadyStateToEvidenceStatus(
+    lookedUp.readyState,
+    row.state === "pending"
+  );
+  const previewUrl = lookedUp.previewUrl ?? (target.startsWith("http") ? target : base.previewUrl);
   return {
-    status: ready ? "ready" : row.state === "pending" ? "building" : "error",
-    previewUrl: target.startsWith("http") ? target : base.previewUrl,
-    deploymentUrl: target.startsWith("http") ? target : base.deploymentUrl,
-    summary: ready ? `vercel inspect ${target} ready` : `vercel inspect ${target} completed without ready signal`,
+    status: mapped,
+    previewUrl,
+    deploymentUrl: previewUrl ?? base.deploymentUrl,
+    summary: evidenceSummary([
+      `Vercel API ${target}=${lookedUp.readyState ?? "unknown"}`,
+      mapped === "ready" ? "preview ready" : ""
+    ]),
     observedAt: observed,
     inspectSkipped: false,
     inspectReason: null,