@kynver-app/runtime 0.1.95 → 0.1.99

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { mkdirSync as mkdirSync8, realpathSync } from "node:fs";
+import { mkdirSync as mkdirSync10, realpathSync } from "node:fs";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
 // src/config.ts
-import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as readFileSync7, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync9, mkdirSync as mkdirSync2, readFileSync as readFileSync8, writeFileSync as writeFileSync2 } from "node:fs";
 import { homedir as homedir4, totalmem } from "node:os";
 import path8 from "node:path";
 
@@ -461,6 +461,7 @@ function readMemAvailableBytes(meminfoText) {
 
 // src/resource-gate.ts
 import path7 from "node:path";
+import { readFileSync as readFileSync7 } from "node:fs";
 
 // src/disk-gate.ts
 import { statfsSync as statfsSync2 } from "node:fs";
@@ -485,23 +486,23 @@ function isWslHost() {
 function observeWslHostDisk(options = {}) {
   const wsl = options.forceWsl === void 0 ? isWslHost() : options.forceWsl;
   if (!wsl) return null;
-  const path67 = options.wslHostMount?.trim() || process.env.KYNVER_WSL_HOST_MOUNT?.trim() || DEFAULT_WSL_HOST_MOUNT;
+  const path69 = options.wslHostMount?.trim() || process.env.KYNVER_WSL_HOST_MOUNT?.trim() || DEFAULT_WSL_HOST_MOUNT;
   const warnBelowBytes = options.wslHostFreeWarnBytes ?? DEFAULT_WSL_HOST_WARN_FREE_BYTES;
   const criticalBelowBytes = options.wslHostFreeCriticalBytes ?? DEFAULT_WSL_HOST_CRITICAL_FREE_BYTES;
   const statfs = options.statfs ?? statfsSync;
   let stats;
   try {
-    stats = statfs(path67);
+    stats = statfs(path69);
   } catch (error) {
     return {
       ok: false,
-      path: path67,
+      path: path69,
       freeBytes: 0,
       totalBytes: 0,
       usedPercent: 100,
       warnBelowBytes,
       criticalBelowBytes,
-      reason: `Windows host disk probe failed at ${path67}: ${error.message}`,
+      reason: `Windows host disk probe failed at ${path69}: ${error.message}`,
       probeError: error.message
     };
   }
@@ -515,11 +516,11 @@ function observeWslHostDisk(options = {}) {
   let reason = null;
   if (!ok) {
     const tag = criticalFree ? "critical" : "warning";
-    reason = `Windows host disk ${path67} at ${tag}: ${freeGiB} GiB free (<${(criticalFree ? criticalBelowBytes : warnBelowBytes) / 1024 / 1024 / 1024} GiB); WSL VHDX cannot grow safely. ${summarizeWslRecoverySteps()}`;
+    reason = `Windows host disk ${path69} at ${tag}: ${freeGiB} GiB free (<${(criticalFree ? criticalBelowBytes : warnBelowBytes) / 1024 / 1024 / 1024} GiB); WSL VHDX cannot grow safely. ${summarizeWslRecoverySteps()}`;
   }
   return {
     ok,
-    path: path67,
+    path: path69,
     freeBytes,
     totalBytes,
     usedPercent,
@@ -539,12 +540,12 @@ var DEFAULT_CRITICAL_FREE_BYTES = 15 * 1024 * 1024 * 1024;
 var DEFAULT_MAX_USED_PERCENT = 80;
 var DEFAULT_HARD_MAX_USED_PERCENT = 90;
 function observeRunnerDiskGate(input = {}) {
-  const path67 = input.diskPath?.trim() || "/";
+  const path69 = input.diskPath?.trim() || "/";
   const warnBelowBytes = input.diskFreeWarnBytes ?? DEFAULT_WARN_FREE_BYTES;
   const criticalBelowBytes = input.diskFreeCriticalBytes ?? DEFAULT_CRITICAL_FREE_BYTES;
   const maxUsedPercent = input.diskMaxUsedPercent ?? DEFAULT_MAX_USED_PERCENT;
   const hardMaxUsedPercent = input.diskHardMaxUsedPercent ?? DEFAULT_HARD_MAX_USED_PERCENT;
-  const stats = statfsSync2(path67);
+  const stats = statfsSync2(path69);
   const freeBytes = Number(stats.bavail) * Number(stats.bsize);
   const totalBytes = Number(stats.blocks) * Number(stats.bsize);
   const usedPercent = totalBytes > 0 ? (totalBytes - freeBytes) / totalBytes * 100 : 100;
@@ -567,7 +568,7 @@ function observeRunnerDiskGate(input = {}) {
   }
   return {
     ok,
-    path: path67,
+    path: path69,
     freeBytes,
     totalBytes,
     usedPercent,
@@ -1991,11 +1992,29 @@ function computeAutoMaxWorkers(totalMemBytes, opts = {}) {
 function readAvailableMemBytes() {
   return readMemAvailableBytes();
 }
+function pidCommandLine(pid) {
+  if (!pid || process.platform !== "linux") return null;
+  try {
+    return readFileSync7(`/proc/${pid}/cmdline`, "utf8").replace(/\0/g, " ");
+  } catch {
+    return null;
+  }
+}
+function workerProcessMatchesRecord(worker) {
+  if (!worker.pid || process.platform !== "linux") return true;
+  const cmdline = pidCommandLine(worker.pid);
+  if (!cmdline) return false;
+  const probes = [worker.worktreePath, worker.workerDir, worker.heartbeatPath].filter(
+    (value) => typeof value === "string" && value.trim().length > 0
+  );
+  return probes.some((probe) => cmdline.includes(probe));
+}
 function isActiveHarnessWorker(worker) {
   if (typeof worker.completionBlocker === "string" && worker.completionBlocker.trim()) {
     return false;
   }
   const status = computeWorkerStatus(worker);
+  if (status.alive && !workerProcessMatchesRecord(worker)) return false;
   return status.alive && !status.finalResult && status.attention.state !== "done";
 }
 function countActiveWorkersForRun(run) {
@@ -2146,7 +2165,7 @@ var CREDENTIALS_FILE = path8.join(CONFIG_DIR, "credentials");
 function loadUserConfig() {
   if (!existsSync9(CONFIG_FILE)) return {};
   try {
-    return JSON.parse(readFileSync7(CONFIG_FILE, "utf8"));
+    return JSON.parse(readFileSync8(CONFIG_FILE, "utf8"));
   } catch {
     return {};
   }
@@ -2223,7 +2242,7 @@ function resolveSetupWorkerConfig(existing, args, totalMemBytes = totalmem()) {
 function loadCredentialsFile() {
   if (!existsSync9(CREDENTIALS_FILE)) return {};
   try {
-    return JSON.parse(readFileSync7(CREDENTIALS_FILE, "utf8"));
+    return JSON.parse(readFileSync8(CREDENTIALS_FILE, "utf8"));
   } catch {
     return {};
   }
@@ -2493,15 +2512,30 @@ async function withTimeout(fn) {
     clearTimeout(timeout);
   }
 }
+function callbackFetchError(error) {
+  return {
+    ok: false,
+    status: 0,
+    response: {
+      error: error instanceof Error ? error.message : String(error),
+      timeoutMs: callbackTimeoutMs()
+    }
+  };
+}
 async function postJson(url, secret, body) {
-  const res = await withTimeout(
-    (signal) => fetch(url, {
-      method: "POST",
-      headers: buildHarnessCallbackHeaders(secret),
-      body: JSON.stringify(body),
-      signal
-    })
-  );
+  let res;
+  try {
+    res = await withTimeout(
+      (signal) => fetch(url, {
+        method: "POST",
+        headers: buildHarnessCallbackHeaders(secret),
+        body: JSON.stringify(body),
+        signal
+      })
+    );
+  } catch (error) {
+    return callbackFetchError(error);
+  }
   let response = null;
   try {
     response = await res.json();
@@ -2519,13 +2553,18 @@ async function postJsonWithCredentialRefresh(url, secret, body, opts) {
   return { ...retry, refreshedAuth: true };
 }
 async function getJson(url, secret) {
-  const res = await withTimeout(
-    (signal) => fetch(url, {
-      method: "GET",
-      headers: buildHarnessCallbackHeaders(secret),
-      signal
-    })
-  );
+  let res;
+  try {
+    res = await withTimeout(
+      (signal) => fetch(url, {
+        method: "GET",
+        headers: buildHarnessCallbackHeaders(secret),
+        signal
+      })
+    );
+  } catch (error) {
+    return callbackFetchError(error);
+  }
   let response = null;
   try {
     response = await res.json();
@@ -2535,41 +2574,6 @@ async function getJson(url, secret) {
   return { ok: res.ok, status: res.status, response };
 }
 
-// src/dispatch-lane-normalization.ts
-function trimLower(value) {
-  return (value ?? "").trim().toLowerCase();
-}
-function roleLaneToDispatchLane(roleLane) {
-  switch (trimLower(roleLane)) {
-    case "implementer":
-    case "repair_implementer":
-    case "plan_author":
-    case "runtime_verifier":
-      return "implementation";
-    case "plan_reviewer":
-    case "report_reviewer":
-    case "deep_reviewer":
-      return "review";
-    default:
-      return null;
-  }
-}
-function normalizeDispatchNextLaneFilter(raw) {
-  const key = trimLower(raw);
-  if (!key) return void 0;
-  if (key === "implementation" || key === "review" || key === "landing" || key === "any") {
-    return key;
-  }
-  const mapped = roleLaneToDispatchLane(key);
-  if (mapped) return mapped;
-  if (key === "implement" || key === "repair" || key === "coding") return "implementation";
-  if (key === "land" || key === "merge") return "landing";
-  return void 0;
-}
-function resolveDispatchNextLaneFilter(raw) {
-  return normalizeDispatchNextLaneFilter(raw) ?? "any";
-}
-
 // src/worker-persona-catalog.ts
 var WORKER_PERSONA_CATALOG = [
   {
@@ -2672,6 +2676,41 @@ function workerPersonaReviewSlugs() {
   );
 }
 
+// src/dispatch-lane-normalization.ts
+function trimLower(value) {
+  return (value ?? "").trim().toLowerCase();
+}
+function roleLaneToDispatchLane(roleLane) {
+  switch (trimLower(roleLane)) {
+    case "implementer":
+    case "repair_implementer":
+    case "plan_author":
+    case "runtime_verifier":
+      return "implementation";
+    case "plan_reviewer":
+    case "report_reviewer":
+    case "deep_reviewer":
+      return "review";
+    default:
+      return null;
+  }
+}
+function normalizeDispatchNextLaneFilter(raw) {
+  const key = trimLower(raw);
+  if (!key) return void 0;
+  if (key === "implementation" || key === "review" || key === "landing" || key === "any") {
+    return key;
+  }
+  const mapped = roleLaneToDispatchLane(key);
+  if (mapped) return mapped;
+  if (key === "implement" || key === "repair" || key === "coding") return "implementation";
+  if (key === "land" || key === "merge") return "landing";
+  return void 0;
+}
+function resolveDispatchNextLaneFilter(raw) {
+  return normalizeDispatchNextLaneFilter(raw) ?? "any";
+}
+
 // src/model-routing-task-enrich.ts
 function taskString(task, key) {
   const v = task[key];
@@ -3129,7 +3168,7 @@ function probeCursorOAuthBinding(nowIso = (/* @__PURE__ */ new Date()).toISOStri
 }
 
 // src/orchestration-providers/hermes-cli-adapter.ts
-import { existsSync as existsSync14, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync14, readFileSync as readFileSync9 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
 import path13 from "node:path";
 var PROFILE_ENV_KEYS = [
@@ -3145,7 +3184,7 @@ function hermesProfileEnvPath() {
 }
 function profileEnvKeyPresence(envPath) {
   try {
-    const text = readFileSync8(envPath, "utf8");
+    const text = readFileSync9(envPath, "utf8");
     const present = [];
     for (const key of PROFILE_ENV_KEYS) {
       const re = new RegExp(`^${key}=`, "m");
@@ -4106,7 +4145,7 @@ function buildPrompt(input) {
     "Completion handoff (required): before you stop, ensure the harness records a final result \u2014 summarize outcome in your last message and append a heartbeat line with phase `complete`. If you leave uncommitted changes or committed work without a PR, the orchestrator blocks completion until a GitHub PR exists (or you discard/commit cleanly). One-off helper scripts must be removed (`kynver worker discard-disposable --path <file>`) or committed before completion \u2014 maintenance/board-drain workers are not exempt. Exiting with only dirty files and no PR routes to salvage review, not production review.",
     "PR-ready handoff: for substantial implementation work, commit, push, and open a GitHub PR (draft OK) on your branch before finishing \u2014 or rely on the harness to run `gh pr create` at completion when `gh` is authenticated.",
     "Expert review / production-review workers (Dalton/Lorentz, plan-review-task, scheduledJob reviewer children): do NOT open new implementation PRs \u2014 review the parent task's existing PR and record reviewVerdict in finalResult; landing-contract targetPrReconciliation does not apply.",
-    "Worker resource guard: do not run full monorepo verification (`npm run typecheck`, `npm run build`, or equivalent) from this worker lane unless an operator explicitly requests it. Use targeted checks for touched paths and rely on CI/operator lanes for heavy gates.",
+    "Worker resource guard: do not run full monorepo verification (`npm run typecheck`, `npm run build`, or equivalent) from this worker lane unless an operator explicitly requests it. Use targeted checks for touched paths and rely on CI/operator lanes for heavy gates. When heavy verification is required, route through `node scripts/verify-pr-local.mjs` or `kynver harness verify` \u2014 they acquire the global heavy-verification lease so parallel workers do not launch simultaneous typechecks.",
     "npm publish boundary: do not run `npm publish`, do not republish `@kynver-app/*` packages, and do not block on an operator to publish. When you need newer runtime code than npm, use this repo checkout (`npm run kynver:build`, `npm run kynver`) and record evidence: packages/kynver-runtime/package.json version + git ref in your completion report.",
     "If verification fails (including OOM), append a heartbeat line immediately with the last command, failure reason, dirty-file status, commit/PR handoff state, and next action so recovery does not require log spelunking.",
     "Landing-wrapper cleanup on a git ref: use `node scripts/agent-os-land-pr-cleanup-verify.mjs --ref origin/main` (JSON, exit 0). Do not use `git show <ref>:scripts/agent-os-land-pr.mjs | rg \u2026` \u2014 ripgrep exit 1 when markers are absent is reported as a failed command in Telegram/status tooling.",
@@ -4982,8 +5021,8 @@ function dirtyPathsCoveredByDisposableRemoval(changedFiles, removed) {
   if (removed.length === 0) return false;
   const removedSet = new Set(removed.map((p) => normalizeRelativePath(p)));
   return material.every((line) => {
-    const path67 = normalizeRelativePath(pathFromGitStatusLine(line));
-    return removedSet.has(path67);
+    const path69 = normalizeRelativePath(pathFromGitStatusLine(line));
+    return removedSet.has(path69);
   });
 }
 
@@ -6277,7 +6316,7 @@ function collectRunActiveHarnessWorkers(runId) {
       path22.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json"),
       void 0
     );
-    if (!worker?.taskId || !isPidAlive(worker.pid)) continue;
+    if (!worker?.taskId || !workerProcessMatchesRecord(worker)) continue;
     out.push({
       runId: run.id,
       workerName: name,
@@ -6516,7 +6555,7 @@ function isTmpOnlyPath(filePath) {
 // src/plan-persist/outbox-store.ts
 import {
   existsSync as existsSync21,
-  readFileSync as readFileSync9,
+  readFileSync as readFileSync10,
   renameSync,
   readdirSync as readdirSync5,
   writeFileSync as writeFileSync3,
@@ -6544,7 +6583,7 @@ function findOutboxByIdempotencyKey(key) {
 function readOutboxItem(jsonPath) {
   if (!existsSync21(jsonPath)) return null;
   try {
-    return JSON.parse(readFileSync9(jsonPath, "utf8"));
+    return JSON.parse(readFileSync10(jsonPath, "utf8"));
   } catch {
     return null;
   }
@@ -6552,7 +6591,7 @@ function readOutboxItem(jsonPath) {
 function readOutboxBody(item) {
   const { outboxDir } = ensurePlanOutboxDirs();
   const bodyFile = path24.join(outboxDir, item.bodyPath);
-  return readFileSync9(bodyFile, "utf8");
+  return readFileSync10(bodyFile, "utf8");
 }
 function writeOutboxItem(input, opts) {
   const { outboxDir } = ensurePlanOutboxDirs();
@@ -7373,7 +7412,7 @@ import { existsSync as existsSync25, mkdirSync as mkdirSync6 } from "node:fs";
 import path34 from "node:path";
 
 // src/run-list.ts
-import { existsSync as existsSync24, readFileSync as readFileSync10 } from "node:fs";
+import { existsSync as existsSync24, readFileSync as readFileSync11 } from "node:fs";
 import path33 from "node:path";
 
 // src/stale-reconcile.ts
@@ -8092,7 +8131,7 @@ function reconcileRunsCli() {
 function heartbeatByteLength(heartbeatPath) {
   if (!heartbeatPath || !existsSync24(heartbeatPath)) return 0;
   try {
-    return readFileSync10(heartbeatPath, "utf8").trim().length;
+    return readFileSync11(heartbeatPath, "utf8").trim().length;
   } catch {
     return 0;
   }
@@ -8427,12 +8466,12 @@ async function fireKynverCronJob(input) {
 }
 
 // src/cron/cron-lock.ts
-import { closeSync as closeSync6, existsSync as existsSync28, openSync as openSync6, readFileSync as readFileSync11, unlinkSync as unlinkSync3, writeFileSync as writeFileSync4 } from "node:fs";
+import { closeSync as closeSync6, existsSync as existsSync28, openSync as openSync6, readFileSync as readFileSync12, unlinkSync as unlinkSync3, writeFileSync as writeFileSync4 } from "node:fs";
 var STALE_LOCK_MS = 10 * 6e4;
 function readLockInfo(lockPath) {
   if (!existsSync28(lockPath)) return null;
   try {
-    const parsed = JSON.parse(readFileSync11(lockPath, "utf8"));
+    const parsed = JSON.parse(readFileSync12(lockPath, "utf8"));
     if (typeof parsed.pid === "number" && typeof parsed.at === "string") return parsed;
   } catch {
     return null;
@@ -9208,11 +9247,11 @@ var LIVE_SKIP_REASONS = /* @__PURE__ */ new Set([
 function collectPreservedLivePaths(actions, skips) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
-  const push = (path67, reason, detail) => {
-    const key = `${path67}\0${reason}`;
+  const push = (path69, reason, detail) => {
+    const key = `${path69}\0${reason}`;
     if (seen.has(key) || out.length >= MAX_PRESERVED_LIVE_PATH_SAMPLES) return;
     seen.add(key);
-    out.push({ path: path67, reason, ...detail ? { detail } : {} });
+    out.push({ path: path69, reason, ...detail ? { detail } : {} });
   };
   for (const skip2 of skips) {
     if (!LIVE_SKIP_REASONS.has(skip2.reason)) continue;
@@ -10693,7 +10732,7 @@ import { homedir as homedir13 } from "node:os";
 import path54 from "node:path";
 
 // src/memory-cost-package-version-guard.ts
-import { existsSync as existsSync40, readFileSync as readFileSync12 } from "node:fs";
+import { existsSync as existsSync40, readFileSync as readFileSync13 } from "node:fs";
 import path53 from "node:path";
 var MEMORY_COST_PACKAGE_MIN_VERSIONS = {
   "@kynver-app/runtime": "0.1.83",
@@ -10745,7 +10784,7 @@ function maxSemver(versions) {
 }
 function readPackageJsonVersion(packageJsonPath) {
   try {
-    const parsed = JSON.parse(readFileSync12(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync13(packageJsonPath, "utf8"));
     return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : null;
   } catch {
     return null;
@@ -11146,17 +11185,17 @@ async function runDaemon(args) {
         idleStreak = 0;
       }
       const backoff = idleStreak >= MAX_IDLE_STREAK ? IDLE_INTERVAL_MS : intervalMs;
-      sleepMs(backoff);
+      await sleepMs(backoff);
     } catch (error) {
       console.error(JSON.stringify({ event: "daemon_tick_error", error: error.message }));
-      sleepMs(intervalMs);
+      await sleepMs(intervalMs);
     }
   }
   console.error(JSON.stringify({ event: "daemon_stop", runId, agentOsId }));
 }
 
 // src/plan-progress.ts
-import path57 from "node:path";
+import path59 from "node:path";
 
 // src/bounded-build/constants.ts
 var DEFAULT_BUILD_MEM_BUDGET_BYTES = 1536 * 1024 * 1024;
@@ -11286,14 +11325,235 @@ function waitForBuildAdmission(timeoutMs, pollMs = 2e3, opts = {}) {
 }
 
 // src/bounded-build/exec.ts
+import { spawnSync as spawnSync8 } from "node:child_process";
+
+// src/heavy-verification/slot.ts
+import {
+  closeSync as closeSync7,
+  existsSync as existsSync41,
+  mkdirSync as mkdirSync8,
+  openSync as openSync7,
+  readdirSync as readdirSync15,
+  readFileSync as readFileSync14,
+  unlinkSync as unlinkSync4,
+  writeFileSync as writeFileSync5
+} from "node:fs";
+import path57 from "node:path";
+
+// src/heavy-verification/paths.ts
+import { mkdirSync as mkdirSync7 } from "node:fs";
+import path56 from "node:path";
+function resolveHeavyVerificationRoot() {
+  return path56.join(resolveKynverStateRoot(), "heavy-verification");
+}
+function heavyVerificationSlotsDir() {
+  return path56.join(resolveHeavyVerificationRoot(), "slots");
+}
+function ensureHeavyVerificationDirs() {
+  const dir = heavyVerificationSlotsDir();
+  mkdirSync7(dir, { recursive: true });
+  return dir;
+}
+
+// src/heavy-verification/slot.ts
+var DEFAULT_HEAVY_VERIFICATION_STALE_MS = 2 * 60 * 6e4;
+var DEFAULT_HEAVY_VERIFICATION_MAX_CONCURRENT = 1;
+function positiveInt5(value, fallback) {
+  const n = Number(value);
+  if (!Number.isFinite(n) || n <= 0) return fallback;
+  return Math.floor(n);
+}
+function isHeavyVerificationGateSkipped() {
+  const v = process.env.KYNVER_HEAVY_VERIFICATION_SKIP?.trim().toLowerCase();
+  return v === "1" || v === "true" || v === "yes";
+}
+function resolveHeavyVerificationMaxConcurrent() {
+  const env = process.env.KYNVER_HEAVY_VERIFICATION_MAX_CONCURRENT;
+  if (env) return positiveInt5(env, DEFAULT_HEAVY_VERIFICATION_MAX_CONCURRENT);
+  return DEFAULT_HEAVY_VERIFICATION_MAX_CONCURRENT;
+}
+function indexedSlotId(index) {
+  return `slot-${index}`;
+}
+function slotFilePath(slotId, slotsDir = heavyVerificationSlotsDir()) {
+  return path57.join(slotsDir, `${slotId}.json`);
+}
+function readSlotRecord(filePath) {
+  if (!existsSync41(filePath)) return null;
+  try {
+    const parsed = JSON.parse(readFileSync14(filePath, "utf8"));
+    if (typeof parsed.slotId === "string" && typeof parsed.pid === "number" && typeof parsed.acquiredAt === "string" && typeof parsed.command === "string") {
+      return parsed;
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
+function slotIsStale(record, staleMs = DEFAULT_HEAVY_VERIFICATION_STALE_MS) {
+  if (!record) return true;
+  if (!isPidAlive(record.pid)) return true;
+  const atMs = Date.parse(record.acquiredAt);
+  if (Number.isNaN(atMs)) return true;
+  return Date.now() - atMs > staleMs;
+}
+function reclaimStaleSlot(filePath, staleMs) {
+  const record = readSlotRecord(filePath);
+  if (!slotIsStale(record, staleMs)) return;
+  try {
+    unlinkSync4(filePath);
+  } catch {
+  }
+}
+function ensureSlotsDir(slotsDir) {
+  mkdirSync8(slotsDir, { recursive: true });
+  return slotsDir;
+}
+function reclaimStaleHeavyVerificationSlots(opts = {}) {
+  const slotsDir = ensureSlotsDir(opts.slotsDir ?? ensureHeavyVerificationDirs());
+  const staleMs = opts.staleMs ?? DEFAULT_HEAVY_VERIFICATION_STALE_MS;
+  let reclaimed = 0;
+  for (const name of readdirSync15(slotsDir)) {
+    if (!name.endsWith(".json")) continue;
+    const filePath = path57.join(slotsDir, name);
+    const before = existsSync41(filePath);
+    reclaimStaleSlot(filePath, staleMs);
+    if (before && !existsSync41(filePath)) reclaimed += 1;
+  }
+  return reclaimed;
+}
+function listActiveHeavyVerificationSlots(opts = {}) {
+  const slotsDir = opts.slotsDir ?? ensureHeavyVerificationDirs();
+  const staleMs = opts.staleMs ?? DEFAULT_HEAVY_VERIFICATION_STALE_MS;
+  reclaimStaleHeavyVerificationSlots({ slotsDir, staleMs });
+  const active = [];
+  for (const name of readdirSync15(slotsDir)) {
+    if (!name.endsWith(".json")) continue;
+    const record = readSlotRecord(path57.join(slotsDir, name));
+    if (record && !slotIsStale(record, staleMs)) active.push(record);
+  }
+  return active;
+}
+function countActiveHeavyVerificationSlots(opts = {}) {
+  return listActiveHeavyVerificationSlots(opts).length;
+}
+function tryAcquireHeavyVerificationSlot(command, opts = {}) {
+  if (isHeavyVerificationGateSkipped()) {
+    return {
+      admitted: true,
+      slotId: null,
+      activeSlots: 0,
+      maxSlots: resolveHeavyVerificationMaxConcurrent(),
+      reason: null
+    };
+  }
+  const slotsDir = opts.slotsDir ?? ensureHeavyVerificationDirs();
+  const staleMs = opts.staleMs ?? DEFAULT_HEAVY_VERIFICATION_STALE_MS;
+  const maxSlots = opts.maxSlots ?? resolveHeavyVerificationMaxConcurrent();
+  reclaimStaleHeavyVerificationSlots({ slotsDir, staleMs });
+  for (let index = 0; index < maxSlots; index += 1) {
+    const slotId = indexedSlotId(index);
+    const filePath = slotFilePath(slotId, slotsDir);
+    const existing = readSlotRecord(filePath);
+    if (existing && slotIsStale(existing, staleMs)) {
+      try {
+        unlinkSync4(filePath);
+      } catch {
+      }
+    } else if (existing && !slotIsStale(existing, staleMs)) {
+      continue;
+    }
+    const record = {
+      slotId,
+      pid: process.pid,
+      acquiredAt: (/* @__PURE__ */ new Date()).toISOString(),
+      command
+    };
+    try {
+      const fd = openSync7(filePath, "wx");
+      writeFileSync5(fd, JSON.stringify(record, null, 2), "utf8");
+      closeSync7(fd);
+      const activeSlots2 = countActiveHeavyVerificationSlots({ slotsDir, staleMs });
+      return {
+        admitted: true,
+        slotId,
+        activeSlots: activeSlots2,
+        maxSlots,
+        reason: null
+      };
+    } catch (err) {
+      if (err.code === "EEXIST") {
+        continue;
+      }
+      throw err;
+    }
+  }
+  const activeSlots = countActiveHeavyVerificationSlots({ slotsDir, staleMs });
+  return {
+    admitted: false,
+    slotId: null,
+    activeSlots,
+    maxSlots,
+    reason: `heavy verification at capacity (${activeSlots}/${maxSlots} slots)`
+  };
+}
+function releaseHeavyVerificationSlot(slotId, opts = {}) {
+  if (!slotId) return;
+  const filePath = slotFilePath(slotId, opts.slotsDir ?? heavyVerificationSlotsDir());
+  try {
+    unlinkSync4(filePath);
+  } catch {
+  }
+}
+function assessHeavyVerificationGate(command, opts = {}) {
+  if (isHeavyVerificationGateSkipped()) {
+    return {
+      admitted: true,
+      slotId: null,
+      activeSlots: 0,
+      maxSlots: resolveHeavyVerificationMaxConcurrent(),
+      reason: null
+    };
+  }
+  const slotsDir = opts.slotsDir ?? ensureHeavyVerificationDirs();
+  const staleMs = opts.staleMs ?? DEFAULT_HEAVY_VERIFICATION_STALE_MS;
+  const maxSlots = opts.maxSlots ?? resolveHeavyVerificationMaxConcurrent();
+  reclaimStaleHeavyVerificationSlots({ slotsDir, staleMs });
+  const activeSlots = countActiveHeavyVerificationSlots({ slotsDir, staleMs });
+  const admitted = activeSlots < maxSlots;
+  return {
+    admitted,
+    slotId: null,
+    activeSlots,
+    maxSlots,
+    reason: admitted ? null : `heavy verification at capacity (${activeSlots}/${maxSlots} slots); waiting for ${command}`
+  };
+}
+
+// src/heavy-verification/gate.ts
 import { spawnSync as spawnSync7 } from "node:child_process";
+function sleepMs3(ms) {
+  if (ms <= 0) return;
+  spawnSync7(process.execPath, ["-e", `const d=Date.now()+${Math.floor(ms)};while(Date.now()<d);`], {
+    stdio: "ignore"
+  });
+}
+function waitForHeavyVerificationSlot(command, timeoutMs, pollMs = 2e3, opts = {}) {
+  const deadline = Date.now() + Math.max(0, timeoutMs);
+  let verdict = tryAcquireHeavyVerificationSlot(command, opts);
+  while (!verdict.admitted && Date.now() < deadline) {
+    sleepMs3(Math.min(pollMs, deadline - Date.now()));
+    verdict = tryAcquireHeavyVerificationSlot(command, opts);
+  }
+  return verdict;
+}
 
 // src/harness-worktree-build-guard.ts
-import path56 from "node:path";
+import path58 from "node:path";
 function isPathUnderHarnessWorktree(cwd) {
   const worktreesDir = harnessWorktreesDir(resolveHarnessRoot());
-  const rel = path56.relative(worktreesDir, path56.resolve(cwd));
-  return rel.length > 0 && !rel.startsWith("..") && !path56.isAbsolute(rel);
+  const rel = path58.relative(worktreesDir, path58.resolve(cwd));
+  return rel.length > 0 && !rel.startsWith("..") && !path58.isAbsolute(rel);
 }
 function assessHarnessWorktreeBuildGuard(cwd) {
   if (!isPathUnderHarnessWorktree(cwd)) return { ok: true };
@@ -11317,7 +11577,7 @@ function envArgv(env) {
   return out;
 }
 function runSpawn(argv, opts) {
-  const res = spawnSync7(argv[0], argv.slice(1), {
+  const res = spawnSync8(argv[0], argv.slice(1), {
     cwd: opts.cwd,
     env: opts.env,
     encoding: "utf8",
@@ -11333,8 +11593,25 @@ function runSpawn(argv, opts) {
 }
 function runBoundedBuildCheck(input) {
   const waitMs = input.waitForAdmissionMs ?? 6e5;
+  const verificationGate = waitMs > 0 ? waitForHeavyVerificationSlot(input.command, waitMs) : tryAcquireOrAssessVerificationGate(input.command);
+  if (!verificationGate.admitted) {
+    return {
+      ok: false,
+      exitCode: 1,
+      stdout: "",
+      stderr: verificationGate.reason ?? "heavy verification gate denied",
+      admitted: false,
+      wrappedWithSystemd: false,
+      nodeOptionsFlag: formatNodeOptionsFlag(),
+      admission: assessBuildAdmission(),
+      verificationGate,
+      command: input.command
+    };
+  }
+  const slotId = verificationGate.slotId;
   const admission = waitMs > 0 ? waitForBuildAdmission(waitMs) : assessBuildAdmission();
   if (!admission.admitted) {
+    releaseHeavyVerificationSlot(slotId);
     return {
       ok: false,
       exitCode: 1,
@@ -11344,11 +11621,13 @@ function runBoundedBuildCheck(input) {
       wrappedWithSystemd: false,
       nodeOptionsFlag: formatNodeOptionsFlag(),
       admission,
+      verificationGate,
       command: input.command
     };
   }
   const worktreeGuard = assessHarnessWorktreeBuildGuard(input.cwd);
   if (!worktreeGuard.ok) {
+    releaseHeavyVerificationSlot(slotId);
     return {
       ok: false,
       exitCode: 1,
@@ -11358,6 +11637,7 @@ function runBoundedBuildCheck(input) {
       wrappedWithSystemd: false,
       nodeOptionsFlag: formatNodeOptionsFlag(),
       admission,
+      verificationGate,
       command: input.command
     };
   }
@@ -11390,12 +11670,19 @@ function runBoundedBuildCheck(input) {
       wrappedWithSystemd: useSystemd,
       nodeOptionsFlag,
       admission,
+      verificationGate,
       command: input.command
     };
   } finally {
     registerBuildEnd();
+    releaseHeavyVerificationSlot(slotId);
   }
 }
+function tryAcquireOrAssessVerificationGate(command) {
+  const acquired = waitForHeavyVerificationSlot(command, 0);
+  if (acquired.admitted) return acquired;
+  return { ...assessHeavyVerificationGate(command), slotId: null };
+}
 
 // src/harness-verify.ts
 var DEFAULT_HARNESS_VERIFY_COMMANDS = ["npm run typecheck", "npm run test"];
@@ -11478,7 +11765,7 @@ async function emitPlanProgress(args) {
 }
 function verifyPlanLocal(args) {
   const worktree = required(args.worktree ? String(args.worktree) : void 0, "worktree");
-  const cwd = path57.resolve(worktree);
+  const cwd = path59.resolve(worktree);
   const summary = runHarnessVerifyCommands(cwd);
   const emitJson = args.json === true || args.json === "true";
   const payload = { passed: summary.passed, worktree: cwd, steps: summary.steps };
@@ -11527,9 +11814,9 @@ async function verifyPlan(args) {
 }
 
 // src/harness-verify-cli.ts
-import path58 from "node:path";
+import path60 from "node:path";
 function runHarnessVerifyCli(args) {
-  const cwd = path58.resolve(required(args.worktree ? String(args.worktree) : void 0, "worktree"));
+  const cwd = path60.resolve(required(args.worktree ? String(args.worktree) : void 0, "worktree"));
   const emitJson = args.json === true || args.json === "true" || args.emitJson === true || args.emitJson === "true";
   const commands = [];
   const rawCmd = args.command;
@@ -11557,6 +11844,7 @@ function runHarnessVerifyCli(args) {
       wrappedWithSystemd: s.result.wrappedWithSystemd,
       nodeOptionsFlag: s.result.nodeOptionsFlag,
       admission: s.result.admission,
+      verificationGate: s.result.verificationGate,
       stderr: s.result.stderr.slice(0, 4e3)
     }))
   };
@@ -11573,7 +11861,7 @@ function runHarnessVerifyCli(args) {
 }
 
 // src/plan-persist-cli.ts
-import { readFileSync as readFileSync13 } from "node:fs";
+import { readFileSync as readFileSync15 } from "node:fs";
 var OPERATIONS = ["create", "add_version", "update_metadata"];
 var FAILURE_KINDS = [
   "approval_guard",
@@ -11585,7 +11873,7 @@ var FAILURE_KINDS = [
 function readBodyArg(args) {
   const bodyFile = args.bodyFile ? String(args.bodyFile) : void 0;
   if (bodyFile) {
-    return { body: readFileSync13(bodyFile, "utf8"), bodyPathHint: bodyFile };
+    return { body: readFileSync15(bodyFile, "utf8"), bodyPathHint: bodyFile };
   }
   const inline = args.body ? String(args.body) : void 0;
   if (inline) return { body: inline };
@@ -11736,7 +12024,7 @@ function formatMonitorTickNotice(tick) {
 }
 
 // src/monitor/monitor.service.ts
-import path60 from "node:path";
+import path62 from "node:path";
 
 // src/monitor/monitor.classify.ts
 function classifyWorkerHealth(input) {
@@ -11788,19 +12076,19 @@ function classifyWorkerHealth(input) {
 }
 
 // src/monitor/monitor.store.ts
-import { existsSync as existsSync41, mkdirSync as mkdirSync7, readdirSync as readdirSync15, unlinkSync as unlinkSync4 } from "node:fs";
-import path59 from "node:path";
+import { existsSync as existsSync42, mkdirSync as mkdirSync9, readdirSync as readdirSync16, unlinkSync as unlinkSync5 } from "node:fs";
+import path61 from "node:path";
 function monitorsDir() {
   const { harnessRoot } = getHarnessPaths();
-  const dir = path59.join(harnessRoot, "monitors");
-  mkdirSync7(dir, { recursive: true });
+  const dir = path61.join(harnessRoot, "monitors");
+  mkdirSync9(dir, { recursive: true });
   return dir;
 }
 function monitorIdFor(runId, workerName) {
   return workerName ? `${safeSlug(runId)}--${safeSlug(workerName)}` : safeSlug(runId);
 }
 function monitorPath(monitorId) {
-  return path59.join(monitorsDir(), `${monitorId}.json`);
+  return path61.join(monitorsDir(), `${monitorId}.json`);
 }
 function loadMonitorSession(monitorId) {
   return readJson(monitorPath(monitorId), void 0);
@@ -11810,18 +12098,18 @@ function saveMonitorSession(session) {
 }
 function deleteMonitorSession(monitorId) {
   const file = monitorPath(monitorId);
-  if (!existsSync41(file)) return false;
-  unlinkSync4(file);
+  if (!existsSync42(file)) return false;
+  unlinkSync5(file);
   return true;
 }
 function listMonitorSessions() {
   const dir = monitorsDir();
-  if (!existsSync41(dir)) return [];
+  if (!existsSync42(dir)) return [];
   const entries = [];
-  for (const name of readdirSync15(dir)) {
+  for (const name of readdirSync16(dir)) {
     if (!name.endsWith(".json")) continue;
     const session = readJson(
-      path59.join(dir, name),
+      path61.join(dir, name),
       void 0
     );
     if (!session?.monitorId) continue;
@@ -11912,7 +12200,7 @@ async function fetchTaskLeasesForWorkers(input) {
 // src/monitor/monitor.service.ts
 function workerRecord2(runId, name) {
   return readJson(
-    path60.join(runDirectory(runId), "workers", safeSlug(name), "worker.json"),
+    path62.join(runDirectory(runId), "workers", safeSlug(name), "worker.json"),
     void 0
   );
 }
@@ -12118,21 +12406,21 @@ async function runMonitorLoop(args) {
 
 // src/monitor/monitor-spawn.ts
 import { spawn as spawn6 } from "node:child_process";
-import { closeSync as closeSync7, existsSync as existsSync42, openSync as openSync7 } from "node:fs";
-import path61 from "node:path";
+import { closeSync as closeSync8, existsSync as existsSync43, openSync as openSync8 } from "node:fs";
+import path63 from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function resolveDefaultCliPath2() {
-  return path61.join(fileURLToPath3(new URL(".", import.meta.url)), "cli.js");
+  return path63.join(fileURLToPath3(new URL(".", import.meta.url)), "cli.js");
 }
 function spawnMonitorSidecar(opts) {
   const cliPath = opts.cliPath ?? resolveDefaultCliPath2();
-  if (!existsSync42(cliPath)) return void 0;
+  if (!existsSync43(cliPath)) return void 0;
   const monitorId = monitorIdFor(opts.runId, opts.workerName);
   const { harnessRoot } = getHarnessPaths();
-  const logPath = path61.join(harnessRoot, "monitors", `${monitorId}.log`);
+  const logPath = path63.join(harnessRoot, "monitors", `${monitorId}.log`);
   let logFd;
   try {
-    logFd = openSync7(logPath, "a");
+    logFd = openSync8(logPath, "a");
   } catch {
     logFd = void 0;
   }
@@ -12172,7 +12460,7 @@ function spawnMonitorSidecar(opts) {
         env: process.env
       })
     );
-    if (logFd !== void 0) closeSync7(logFd);
+    if (logFd !== void 0) closeSync8(logFd);
     child.unref();
     const session = {
       monitorId,
@@ -12189,7 +12477,7 @@ function spawnMonitorSidecar(opts) {
   } catch {
     if (logFd !== void 0) {
       try {
-        closeSync7(logFd);
+        closeSync8(logFd);
       } catch {
       }
     }
@@ -12249,13 +12537,13 @@ async function monitorTickCli(args) {
 }
 
 // src/package-version.ts
-import { existsSync as existsSync43, readFileSync as readFileSync14 } from "node:fs";
+import { existsSync as existsSync44, readFileSync as readFileSync16 } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 function resolvePackageRoot(moduleUrl) {
   let dir = dirname(fileURLToPath4(moduleUrl));
   for (let depth = 0; depth < 6; depth += 1) {
-    if (existsSync43(join(dir, "package.json"))) return dir;
+    if (existsSync44(join(dir, "package.json"))) return dir;
     const parent = dirname(dir);
     if (parent === dir) break;
     dir = parent;
@@ -12264,7 +12552,7 @@ function resolvePackageRoot(moduleUrl) {
 }
 function readOwnPackageVersion(moduleUrl = import.meta.url) {
   const pkgPath = join(resolvePackageRoot(moduleUrl), "package.json");
-  const pkg = JSON.parse(readFileSync14(pkgPath, "utf8"));
+  const pkg = JSON.parse(readFileSync16(pkgPath, "utf8"));
   if (typeof pkg.version !== "string" || !pkg.version.trim()) {
     throw new Error(`Missing package.json version at ${pkgPath}`);
   }
@@ -12331,7 +12619,7 @@ function shouldEnforceMemoryCostPackageGuardCli(scope, action) {
 }
 
 // src/post-restart-unblock.ts
-import path62 from "node:path";
+import path64 from "node:path";
 function skip(runId, worker, taskId, agentOsId, leaseOwner, reason) {
   return { runId, worker, taskId, agentOsId, leaseOwner, action: "skipped", reason };
 }
@@ -12344,7 +12632,7 @@ async function postRestartUnblock(args) {
   const errors = [];
   for (const run of listRunRecords()) {
     for (const name of Object.keys(run.workers ?? {})) {
-      const workerPath = path62.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json");
+      const workerPath = path64.join(runDirectory(run.id), "workers", safeSlug(name), "worker.json");
       const worker = readJson(workerPath, void 0);
       if (!worker) {
         skipped.push(skip(run.id, name, "", "", "", "worker.json missing"));
@@ -12456,9 +12744,9 @@ async function postRestartUnblockCli(args) {
 }
 
 // src/default-repo-cli.ts
-import path63 from "node:path";
+import path65 from "node:path";
 import { homedir as homedir14 } from "node:os";
-var CONFIG_FILE2 = path63.join(homedir14(), ".kynver", "config.json");
+var CONFIG_FILE2 = path65.join(homedir14(), ".kynver", "config.json");
 function ensureDefaultRepo(opts) {
   const existing = loadUserConfig();
   const resolved = resolveDefaultRepo({ ...opts, config: existing });
@@ -12539,16 +12827,16 @@ function summarizeResolvedDefaultRepo(resolved) {
 }
 
 // src/doctor/runtime-takeover.ts
-import path65 from "node:path";
+import path67 from "node:path";
 
 // src/doctor/runtime-takeover.probes.ts
-import { accessSync, constants, existsSync as existsSync44, readFileSync as readFileSync15 } from "node:fs";
+import { accessSync, constants, existsSync as existsSync45, readFileSync as readFileSync17 } from "node:fs";
 import { homedir as homedir15 } from "node:os";
-import path64 from "node:path";
-import { spawnSync as spawnSync8 } from "node:child_process";
+import path66 from "node:path";
+import { spawnSync as spawnSync9 } from "node:child_process";
 function captureCommand(bin, args) {
   try {
-    const res = spawnSync8(bin, args, { encoding: "utf8" });
+    const res = spawnSync9(bin, args, { encoding: "utf8" });
     const stdout = (res.stdout || "").trim();
     const stderr = (res.stderr || "").trim();
     const ok = res.status === 0;
@@ -12573,7 +12861,7 @@ function tokenPrefix(token) {
   return trimmed.length <= 12 ? `${trimmed}\u2026` : `${trimmed.slice(0, 12)}\u2026`;
 }
 function isWritable(target) {
-  if (!existsSync44(target)) return false;
+  if (!existsSync45(target)) return false;
   try {
     accessSync(target, constants.W_OK);
     return true;
@@ -12586,15 +12874,15 @@ var defaultRuntimeTakeoverProbes = {
   commandOnPath: (bin) => captureCommand(process.platform === "win32" ? "where" : "which", [bin]),
   kynverVersion: (bin) => captureCommand(bin, ["--version"]),
   loadConfig: () => loadUserConfig(),
-  configFilePath: () => path64.join(homedir15(), ".kynver", "config.json"),
-  credentialsFilePath: () => path64.join(homedir15(), ".kynver", "credentials"),
+  configFilePath: () => path66.join(homedir15(), ".kynver", "config.json"),
+  credentialsFilePath: () => path66.join(homedir15(), ".kynver", "credentials"),
   readCredentials: () => {
-    const credPath = path64.join(homedir15(), ".kynver", "credentials");
-    if (!existsSync44(credPath)) {
+    const credPath = path66.join(homedir15(), ".kynver", "credentials");
+    if (!existsSync45(credPath)) {
       return { hasApiKey: false };
     }
     try {
-      const parsed = JSON.parse(readFileSync15(credPath, "utf8"));
+      const parsed = JSON.parse(readFileSync17(credPath, "utf8"));
       return {
         hasApiKey: Boolean(parsed.apiKey?.trim()),
         runnerTokenPrefix: tokenPrefix(parsed.runnerToken),
@@ -12624,8 +12912,8 @@ var defaultRuntimeTakeoverProbes = {
     })()
   }),
   harnessRoot: () => resolveHarnessRoot(),
-  legacyOpenclawHarnessRoot: () => path64.join(homedir15(), ".openclaw", "harness"),
-  pathExists: (target) => existsSync44(target),
+  legacyOpenclawHarnessRoot: () => path66.join(homedir15(), ".openclaw", "harness"),
+  pathExists: (target) => existsSync45(target),
   pathWritable: (target) => isWritable(target)
 };
 
@@ -13031,8 +13319,8 @@ function assessVercelDeployEvidence(probes) {
 }
 function assessHarnessDirs(probes) {
   const harnessRoot = probes.harnessRoot();
-  const runsDir = path65.join(harnessRoot, "runs");
-  const worktreesDir = path65.join(harnessRoot, "worktrees");
+  const runsDir = path67.join(harnessRoot, "runs");
+  const worktreesDir = path67.join(harnessRoot, "worktrees");
   const displayHarnessRoot = redactHomePath(harnessRoot);
   const displayRunsDir = redactHomePath(runsDir);
   const displayWorktreesDir = redactHomePath(worktreesDir);
@@ -13296,9 +13584,9 @@ function applySchedulerCutoverAttestation(config) {
 }
 
 // src/scheduler-cutover-cli.ts
-import path66 from "node:path";
+import path68 from "node:path";
 import { homedir as homedir16 } from "node:os";
-var CONFIG_FILE3 = path66.join(homedir16(), ".kynver", "config.json");
+var CONFIG_FILE3 = path68.join(homedir16(), ".kynver", "config.json");
 function runSchedulerCutoverCheckCli(json = false) {
   const config = loadUserConfig();
   const report = assessSchedulerCutover(config);
@@ -13510,8 +13798,8 @@ async function main(argv = process.argv.slice(2)) {
   if (action && isHelpFlag(action) || rest.some(isHelpFlag)) return usage(0);
   const args = parseArgs(rest);
   const { runsDir, worktreesDir } = getPaths();
-  mkdirSync8(runsDir, { recursive: true });
-  mkdirSync8(worktreesDir, { recursive: true });
+  mkdirSync10(runsDir, { recursive: true });
+  mkdirSync10(worktreesDir, { recursive: true });
   if (shouldEnforceMemoryCostPackageGuardCli(scope, action)) {
     let repoRoot;
     const runId = args.run ? String(args.run).trim() : "";