@algosuite/vo-mcp 0.2.0-beta.29 → 0.2.0-beta.33

package/dist/runner-cli.js

@@ -77,11 +77,11 @@ __export(credential_store_exports, {
   readStoredCredentialKeychainOnly: () => readStoredCredentialKeychainOnly,
   writeStoredCredential: () => writeStoredCredential
 });
-import { homedir } from "node:os";
+import { homedir as homedir2 } from "node:os";
 import { join, dirname } from "node:path";
 import {
-  existsSync,
-  mkdirSync,
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
   readFileSync,
   writeFileSync,
   chmodSync,
@@ -90,7 +90,7 @@ import {
 function credentialPath(env2 = process.env) {
   const override = env2["VO_MCP_CREDENTIALS_PATH"]?.trim();
   if (override) return override;
-  return join(homedir(), ".config", "vo-mcp", "credentials.json");
+  return join(homedir2(), ".config", "vo-mcp", "credentials.json");
 }
 function keychainEnabled(env2, keychain) {
   const disabled = (env2["VO_MCP_DISABLE_KEYCHAIN"] ?? "").trim().toLowerCase();
@@ -119,7 +119,7 @@ function deserialize(raw) {
 function readFromFile(env2) {
   try {
     const p = credentialPath(env2);
-    if (!existsSync(p)) return null;
+    if (!existsSync2(p)) return null;
     return deserialize(readFileSync(p, "utf8"));
   } catch {
     return null;
@@ -146,7 +146,7 @@ function deleteFile(env2) {
 }
 function writeToFile(payload, env2) {
   const p = credentialPath(env2);
-  mkdirSync(dirname(p), { recursive: true });
+  mkdirSync2(dirname(p), { recursive: true });
   writeFileSync(p, `${JSON.stringify(payload, null, 2)}
 `, { mode: 384 });
   try {
@@ -505,7 +505,8 @@ async function runProcess(command, args = [], options = {}) {
   });
 }
 async function commandExists(command, options = {}) {
-  const checker = process.platform === "win32" ? "where" : "which";
+  const platform = options.platform || process.platform;
+  const checker = platform === "win32" ? "where" : "which";
   const result = await (options.runner || runProcess)(checker, [command], {
     timeoutMs: 1e4
   });
@@ -841,9 +842,141 @@ var init_pnpm_canonical_health = __esm({
   }
 });
 
+// src/runner/pnpm-command.mjs
+import fs2 from "node:fs";
+import path3 from "node:path";
+function isWindowsDriveOrUnc(value) {
+  return WINDOWS_DRIVE_OR_UNC_RE.test(String(value || ""));
+}
+function portableDirname(value) {
+  if (isWindowsDriveOrUnc(value)) return path3.win32.dirname(value);
+  if (path3.posix.isAbsolute(value)) return path3.posix.dirname(value);
+  return path3.dirname(value);
+}
+function portableJoin(root, ...segments) {
+  if (isWindowsDriveOrUnc(root)) return path3.win32.join(root, ...segments);
+  if (path3.posix.isAbsolute(root)) return path3.posix.join(root, ...segments);
+  return path3.join(root, ...segments);
+}
+function readPackageManager(root) {
+  const packagePath = path3.join(root, "package.json");
+  if (!fs2.existsSync(packagePath)) return "";
+  try {
+    return String(JSON.parse(fs2.readFileSync(packagePath, "utf8"))?.packageManager || "").trim();
+  } catch {
+    return "";
+  }
+}
+function validatedPnpmVersionToken(root) {
+  const raw = readPackageManager(root);
+  const match = /^pnpm@(.+)$/iu.exec(raw);
+  if (!match) return "";
+  const version = match[1].trim();
+  if (!version || /\s/u.test(version) || !SAFE_PNPM_VERSION_RE.test(version)) return "";
+  return version;
+}
+function pnpmSelector(root) {
+  const packageManager = readPackageManager(root);
+  const version = validatedPnpmVersionToken(root);
+  if (packageManager && !version) {
+    throw new Error(`[vo-mcp runner] invalid pnpm packageManager token in ${path3.join(root, "package.json")}`);
+  }
+  return version ? `pnpm@${version}` : "pnpm";
+}
+function whereResults(result) {
+  if (result?.status !== 0) return [];
+  return String(result.stdout || "").split(/\r?\n/u).map((line) => line.trim()).filter((line) => path3.win32.isAbsolute(line));
+}
+async function resolveWindowsNativeCommand(command, runner) {
+  const result = await runner("where", [command], { timeoutMs: 1e4 });
+  return whereResults(result).find((candidate) => WINDOWS_NATIVE_EXECUTABLE_RE.test(candidate)) || "";
+}
+function trustedCorepackCandidates(options) {
+  const env2 = options.env || process.env;
+  const execPath = options.execPath || process.execPath;
+  const roots = [portableDirname(execPath)];
+  for (const key of ["ProgramW6432", "ProgramFiles", "ProgramFiles(x86)"]) {
+    const programFiles = String(env2[key] || "").trim();
+    if (isWindowsDriveOrUnc(programFiles) || path3.posix.isAbsolute(programFiles)) {
+      roots.push(portableJoin(programFiles, "nodejs"));
+    }
+  }
+  return [...new Set(roots)].map((root) => portableJoin(root, "node_modules", "corepack", "dist", "corepack.js"));
+}
+function resolveTrustedCorepackJs(options) {
+  const existsSync7 = options.existsSync || fs2.existsSync;
+  return trustedCorepackCandidates(options).find((candidate) => existsSync7(candidate)) || "";
+}
+async function resolvePnpmInstallCommand(root, options = {}) {
+  const runner = options.runner || runProcess;
+  const platform = options.platform || process.platform;
+  const selector = pnpmSelector(root);
+  if (platform !== "win32") {
+    if (await commandExists("pnpm", { runner, platform })) {
+      return {
+        command: "pnpm",
+        args: [...DEFAULT_PNPM_INSTALL_ARGS],
+        displayCommand: ["pnpm", ...DEFAULT_PNPM_INSTALL_ARGS]
+      };
+    }
+    if (await commandExists("corepack", { runner, platform })) {
+      return {
+        command: "corepack",
+        args: [selector, ...DEFAULT_PNPM_INSTALL_ARGS],
+        displayCommand: ["corepack", selector, ...DEFAULT_PNPM_INSTALL_ARGS]
+      };
+    }
+    throw new Error("[vo-mcp runner] pnpm hydration requires `pnpm` or `corepack` on PATH.");
+  }
+  const pnpmExecutable = await resolveWindowsNativeCommand("pnpm", runner);
+  if (pnpmExecutable) {
+    return {
+      command: pnpmExecutable,
+      args: [...DEFAULT_PNPM_INSTALL_ARGS],
+      displayCommand: ["pnpm", ...DEFAULT_PNPM_INSTALL_ARGS]
+    };
+  }
+  const corepackExecutable = await resolveWindowsNativeCommand("corepack", runner);
+  if (corepackExecutable) {
+    return {
+      command: corepackExecutable,
+      args: [selector, ...DEFAULT_PNPM_INSTALL_ARGS],
+      displayCommand: ["corepack", selector, ...DEFAULT_PNPM_INSTALL_ARGS]
+    };
+  }
+  const corepackJs = resolveTrustedCorepackJs(options);
+  if (corepackJs) {
+    return {
+      command: options.execPath || process.execPath,
+      args: [corepackJs, selector, ...DEFAULT_PNPM_INSTALL_ARGS],
+      displayCommand: ["corepack", selector, ...DEFAULT_PNPM_INSTALL_ARGS]
+    };
+  }
+  throw new Error(
+    "[vo-mcp runner] pnpm hydration on Windows requires a native pnpm/corepack executable or a trusted Corepack installation."
+  );
+}
+var DEFAULT_PNPM_INSTALL_ARGS, SAFE_PNPM_VERSION_RE, WINDOWS_NATIVE_EXECUTABLE_RE, WINDOWS_DRIVE_OR_UNC_RE;
+var init_pnpm_command = __esm({
+  "src/runner/pnpm-command.mjs"() {
+    "use strict";
+    init_process_runner();
+    DEFAULT_PNPM_INSTALL_ARGS = Object.freeze([
+      "install",
+      "--frozen-lockfile",
+      "--prefer-offline",
+      "--ignore-scripts",
+      "--config.confirmModulesPurge=false"
+    ]);
+    SAFE_PNPM_VERSION_RE = /^[0-9A-Za-z._+-]+$/u;
+    WINDOWS_NATIVE_EXECUTABLE_RE = /\.(?:com|exe)$/iu;
+    WINDOWS_DRIVE_OR_UNC_RE = /^(?:[A-Za-z]:[\\/]|\\\\)/u;
+  }
+});
+
 // src/runner/pnpm-materialize.mjs
 import fsp4 from "node:fs/promises";
-import path3 from "node:path";
+import path4 from "node:path";
 function linkType() {
   return process.platform === "win32" ? "junction" : "dir";
 }
@@ -855,13 +988,13 @@ async function realpathOrThrow(target, fsApi) {
   }
 }
 function shouldMapToWorktree(resolvedTarget, canonicalRoot) {
-  const relative = path3.relative(canonicalRoot, resolvedTarget).replace(/\\/g, "/");
+  const relative = path4.relative(canonicalRoot, resolvedTarget).replace(/\\/g, "/");
   return Boolean(relative && !relative.startsWith("..") && !relative.split("/").includes("node_modules"));
 }
 async function resolveEntryTarget(sourceEntry, canonicalRoot, worktreeRoot, fsApi) {
   const resolved = await realpathOrThrow(sourceEntry, fsApi);
   if (!shouldMapToWorktree(resolved, canonicalRoot)) return resolved;
-  const mapped = path3.join(worktreeRoot, path3.relative(canonicalRoot, resolved));
+  const mapped = path4.join(worktreeRoot, path4.relative(canonicalRoot, resolved));
   if (!await fsApi.pathExists(mapped)) {
     throw new Error(`[vo-mcp runner] task-local workspace target is missing for dependency link: ${mapped}`);
   }
@@ -872,7 +1005,7 @@ async function ensureLinkedDirectory(source, target, fsApi) {
     if (await fsApi.realpath(target) === await fsApi.realpath(source)) return;
     throw new Error(`[vo-mcp runner] refusing to overwrite existing dependency path: ${target}`);
   }
-  await fsApi.mkdir(path3.dirname(target), { recursive: true });
+  await fsApi.mkdir(path4.dirname(target), { recursive: true });
   await fsApi.symlink(source, target, linkType());
   if (await fsApi.realpath(target) !== await fsApi.realpath(source)) {
     throw new Error(`[vo-mcp runner] dependency link validation failed for ${target}`);
@@ -886,8 +1019,8 @@ async function maybeYield2(state) {
 async function copyDirRecursive(sourceDir, targetDir, fsApi, yieldState) {
   await fsApi.mkdir(targetDir, { recursive: true });
   for (const entry of await fsApi.readdir(sourceDir, { withFileTypes: true })) {
-    const source = path3.join(sourceDir, entry.name);
-    const target = path3.join(targetDir, entry.name);
+    const source = path4.join(sourceDir, entry.name);
+    const target = path4.join(targetDir, entry.name);
     await maybeYield2(yieldState);
     if (entry.isDirectory()) {
       await copyDirRecursive(source, target, fsApi, yieldState);
@@ -899,17 +1032,17 @@ async function copyDirRecursive(sourceDir, targetDir, fsApi, yieldState) {
 async function materializeEntry(sourceEntry, targetEntry, canonicalRoot, worktreeRoot, options) {
   await options.beforeEntry?.(sourceEntry, targetEntry);
   const stat2 = await options.fsApi.lstat(sourceEntry);
-  if (stat2.isDirectory() && !stat2.isSymbolicLink() && path3.basename(sourceEntry) === ".bin") {
+  if (stat2.isDirectory() && !stat2.isSymbolicLink() && path4.basename(sourceEntry) === ".bin") {
     await copyDirRecursive(sourceEntry, targetEntry, options.fsApi, options.yieldState);
     return;
   }
-  if (stat2.isDirectory() && !stat2.isSymbolicLink() && path3.basename(sourceEntry).startsWith("@")) {
+  if (stat2.isDirectory() && !stat2.isSymbolicLink() && path4.basename(sourceEntry).startsWith("@")) {
     await options.fsApi.mkdir(targetEntry, { recursive: true });
     for (const nested of await options.fsApi.readdir(sourceEntry, { withFileTypes: true })) {
       await maybeYield2(options.yieldState);
       await materializeEntry(
-        path3.join(sourceEntry, nested.name),
-        path3.join(targetEntry, nested.name),
+        path4.join(sourceEntry, nested.name),
+        path4.join(targetEntry, nested.name),
         canonicalRoot,
         worktreeRoot,
         options
@@ -922,7 +1055,7 @@ async function materializeEntry(sourceEntry, targetEntry, canonicalRoot, worktre
     await ensureLinkedDirectory(resolvedTarget, targetEntry, options.fsApi);
     return;
   }
-  await options.fsApi.mkdir(path3.dirname(targetEntry), { recursive: true });
+  await options.fsApi.mkdir(path4.dirname(targetEntry), { recursive: true });
   await options.fsApi.copyFile(sourceEntry, targetEntry);
 }
 function createPnpmFsApi(pathExists6) {
@@ -946,8 +1079,8 @@ async function materializeNodeModulesForest(sourceNodeModules, targetNodeModules
   for (const entry of await options.fsApi.readdir(sourceNodeModules, { withFileTypes: true })) {
     await maybeYield2(options.yieldState);
     await materializeEntry(
-      path3.join(sourceNodeModules, entry.name),
-      path3.join(targetNodeModules, entry.name),
+      path4.join(sourceNodeModules, entry.name),
+      path4.join(targetNodeModules, entry.name),
       canonicalRoot,
       worktreeRoot,
       options
@@ -962,20 +1095,20 @@ var init_pnpm_materialize = __esm({
 
 // src/runner/pnpm-hydration.mjs
 import { createHash } from "node:crypto";
-import fs2 from "node:fs";
+import fs3 from "node:fs";
 import fsp5 from "node:fs/promises";
-import path4 from "node:path";
+import path5 from "node:path";
 function hashText(text) {
   return createHash("sha256").update(String(text)).digest("hex");
 }
 function statePath(root) {
-  return path4.join(root, ".agent-worktrees", "runner-pnpm-hydration.json");
+  return path5.join(root, ".agent-worktrees", "runner-pnpm-hydration.json");
 }
 function packageJson(root) {
-  const packagePath = path4.join(root, "package.json");
-  if (!fs2.existsSync(packagePath)) return null;
+  const packagePath = path5.join(root, "package.json");
+  if (!fs3.existsSync(packagePath)) return null;
   try {
-    return JSON.parse(fs2.readFileSync(packagePath, "utf8"));
+    return JSON.parse(fs3.readFileSync(packagePath, "utf8"));
   } catch {
     return null;
   }
@@ -989,23 +1122,23 @@ async function pathExists4(target) {
   }
 }
 function lockfileHash(root) {
-  const lockPath = path4.join(root, "pnpm-lock.yaml");
-  if (!fs2.existsSync(lockPath)) return "";
-  return hashText(fs2.readFileSync(lockPath, "utf8"));
+  const lockPath = path5.join(root, "pnpm-lock.yaml");
+  if (!fs3.existsSync(lockPath)) return "";
+  return hashText(fs3.readFileSync(lockPath, "utf8"));
 }
 function readHydrationState(root) {
   const file = statePath(root);
-  if (!fs2.existsSync(file)) return null;
+  if (!fs3.existsSync(file)) return null;
   try {
-    return JSON.parse(fs2.readFileSync(file, "utf8"));
+    return JSON.parse(fs3.readFileSync(file, "utf8"));
   } catch {
     return null;
   }
 }
 function writeHydrationState(root, state) {
   const file = statePath(root);
-  fs2.mkdirSync(path4.dirname(file), { recursive: true });
-  fs2.writeFileSync(file, `${JSON.stringify({
+  fs3.mkdirSync(path5.dirname(file), { recursive: true });
+  fs3.writeFileSync(file, `${JSON.stringify({
     ...state,
     stateVersion: 2,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -1013,7 +1146,7 @@ function writeHydrationState(root, state) {
 `, "utf8");
 }
 function voDepsStatePath(root) {
-  return path4.join(root, "node_modules", ".vo-deps-state.json");
+  return path5.join(root, "node_modules", ".vo-deps-state.json");
 }
 async function ensureVoDepsState(root, expectedHash, fsApi = fsp5) {
   const marker = voDepsStatePath(root);
@@ -1023,7 +1156,7 @@ async function ensureVoDepsState(root, expectedHash, fsApi = fsp5) {
   } catch {
   }
   const temp = `${marker}.tmp-${process.pid}-${Date.now()}`;
-  await fsApi.mkdir(path4.dirname(marker), { recursive: true });
+  await fsApi.mkdir(path5.dirname(marker), { recursive: true });
   await fsApi.writeFile(temp, `${JSON.stringify({ lockfileHash: expectedHash, updatedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)}
 `, "utf8");
   await fsApi.rename(temp, marker);
@@ -1043,14 +1176,6 @@ async function assertVoDepsState(root, expectedHash, fsApi = fsp5) {
   }
   throw new Error(`[vo-mcp runner] linked vo:deps state marker mismatch for ${root}`);
 }
-function validatedPnpmVersionToken(root) {
-  const raw = String(packageJson(root)?.packageManager || "").trim();
-  const match = /^pnpm@(.+)$/iu.exec(raw);
-  if (!match) return "";
-  const version = match[1].trim();
-  if (!version || /\s/u.test(version) || !SAFE_PNPM_VERSION_RE.test(version)) return "";
-  return version;
-}
 function workspacePatternsFromPackageJson(root) {
   const workspaces = packageJson(root)?.workspaces;
   if (Array.isArray(workspaces)) return workspaces.map(String);
@@ -1058,9 +1183,9 @@ function workspacePatternsFromPackageJson(root) {
   return [];
 }
 function workspacePatternsFromPnpmWorkspace(root) {
-  const workspacePath = path4.join(root, "pnpm-workspace.yaml");
-  if (!fs2.existsSync(workspacePath)) return [];
-  const lines = fs2.readFileSync(workspacePath, "utf8").split(/\r?\n/u);
+  const workspacePath = path5.join(root, "pnpm-workspace.yaml");
+  if (!fs3.existsSync(workspacePath)) return [];
+  const lines = fs3.readFileSync(workspacePath, "utf8").split(/\r?\n/u);
   const patterns = [];
   let inPackages = false;
   for (const rawLine of lines) {
@@ -1117,16 +1242,16 @@ function collectPackageDirs(root, options = {}) {
   while (stack.length > 0) {
     const current = stack.pop();
     if (!current) continue;
-    const relativeDir = path4.relative(root, current.dir).replace(/\\/g, "/");
-    if (relativeDir && fs2.existsSync(path4.join(current.dir, "package.json"))) {
+    const relativeDir = path5.relative(root, current.dir).replace(/\\/g, "/");
+    if (relativeDir && fs3.existsSync(path5.join(current.dir, "package.json"))) {
       found.push(relativeDir);
       if (found.length >= maxDirs) break;
     }
     if (current.depth >= maxDepth) continue;
-    for (const entry of fs2.readdirSync(current.dir, { withFileTypes: true })) {
+    for (const entry of fs3.readdirSync(current.dir, { withFileTypes: true })) {
       if (!entry.isDirectory()) continue;
       if (IGNORED_SCAN_DIRS.has(entry.name)) continue;
-      stack.push({ dir: path4.join(current.dir, entry.name), depth: current.depth + 1 });
+      stack.push({ dir: path5.join(current.dir, entry.name), depth: current.depth + 1 });
     }
   }
   return found.sort();
@@ -1136,35 +1261,22 @@ function discoverWorkspacePackageDirs(root, options = {}) {
   if (patterns.length === 0) return [];
   return collectPackageDirs(root, options).filter((relativeDir) => patterns.some((pattern) => matchesWorkspacePattern(relativeDir, pattern)));
 }
-async function resolveInstallCommand(root, runner) {
-  if (await commandExists("pnpm", { runner })) {
-    return { command: "pnpm", args: [...DEFAULT_INSTALL_ARGS] };
-  }
-  if (await commandExists("corepack", { runner })) {
-    const version = validatedPnpmVersionToken(root);
-    if (String(packageJson(root)?.packageManager || "").trim() && !version) {
-      throw new Error(`[vo-mcp runner] invalid pnpm packageManager token in ${path4.join(root, "package.json")}`);
-    }
-    return { command: "corepack", args: [version ? `pnpm@${version}` : "pnpm", ...DEFAULT_INSTALL_ARGS] };
-  }
-  throw new Error("[vo-mcp runner] pnpm hydration requires `pnpm` or `corepack` on PATH.");
-}
 async function runInstall(root, options = {}) {
   const runner = options.runner || runProcess;
-  const tuple = await resolveInstallCommand(root, runner);
+  const tuple = await resolvePnpmInstallCommand(root, { ...options, runner });
   const result = await runner(tuple.command, tuple.args, {
     cwd: root,
     timeoutMs: options.timeoutMs ?? DEFAULT_INSTALL_TIMEOUT_MS
   });
   if (result.status !== 0) {
     throw new Error(
-      `[vo-mcp runner] pnpm hydration failed for ${root}: ${summarizeProcessFailure(result)} (command: ${[tuple.command, ...tuple.args].join(" ")})`
+      `[vo-mcp runner] pnpm hydration failed for ${root}: ${summarizeProcessFailure(result)} (command: ${tuple.displayCommand.join(" ")})`
     );
   }
 }
 async function hasReadyNodeModules(root) {
-  const nodeModules = path4.join(root, "node_modules");
-  return await pathExists4(path4.join(nodeModules, ".modules.yaml")) || await pathExists4(path4.join(nodeModules, ".pnpm"));
+  const nodeModules = path5.join(root, "node_modules");
+  return await pathExists4(path5.join(nodeModules, ".modules.yaml")) || await pathExists4(path5.join(nodeModules, ".pnpm"));
 }
 function hydrationFsApi(overrides = {}) {
   return { ...createPnpmFsApi(pathExists4), ...overrides };
@@ -1201,7 +1313,7 @@ async function ensurePnpmHydration(root, options = {}) {
     expectedHash: hash,
     requireMarker: false
   });
-  if (!health.healthy && await fsApi.pathExists(path4.join(root, "node_modules"))) {
+  if (!health.healthy && await fsApi.pathExists(path5.join(root, "node_modules"))) {
     quarantine = await quarantineCanonicalNodeModules(root, health.issues, {
       fsApi,
       logger: options.logger
@@ -1213,7 +1325,7 @@ async function ensurePnpmHydration(root, options = {}) {
   }
   const linkedWorkspaceDirs = [];
   for (const relativeDir of workspaceDirs) {
-    if (await pathExists4(path4.join(root, relativeDir, "node_modules"))) {
+    if (await pathExists4(path5.join(root, relativeDir, "node_modules"))) {
       linkedWorkspaceDirs.push(relativeDir);
     }
   }
@@ -1249,18 +1361,18 @@ async function linkHydratedNodeModules({ root, worktreeDir, hydration, options =
       yieldEvery: Math.max(1, options.yieldEvery ?? DEFAULT_YIELD_EVERY2)
     }
   };
-  recordOwnedNodeModulesRoot(dependencyOwnership, path4.join(worktreeDir, "node_modules"));
+  recordOwnedNodeModulesRoot(dependencyOwnership, path5.join(worktreeDir, "node_modules"));
   await materializeNodeModulesForest(
-    path4.join(root, "node_modules"),
-    path4.join(worktreeDir, "node_modules"),
+    path5.join(root, "node_modules"),
+    path5.join(worktreeDir, "node_modules"),
     root,
     worktreeDir,
     materializeOptions
   );
   for (const relativeDir of hydration.linkedWorkspaceDirs) {
-    const sourceNodeModules = path4.join(root, relativeDir, "node_modules");
-    const targetNodeModules = path4.join(worktreeDir, relativeDir, "node_modules");
-    if (!await fsApi.pathExists(path4.join(worktreeDir, relativeDir))) continue;
+    const sourceNodeModules = path5.join(root, relativeDir, "node_modules");
+    const targetNodeModules = path5.join(worktreeDir, relativeDir, "node_modules");
+    if (!await fsApi.pathExists(path5.join(worktreeDir, relativeDir))) continue;
     recordOwnedNodeModulesRoot(dependencyOwnership, targetNodeModules);
     await materializeNodeModulesForest(sourceNodeModules, targetNodeModules, root, worktreeDir, materializeOptions);
   }
@@ -1271,22 +1383,16 @@ async function linkHydratedNodeModules({ root, worktreeDir, hydration, options =
     workspaceCount: hydration.linkedWorkspaceDirs.length
   };
 }
-var DEFAULT_INSTALL_TIMEOUT_MS, DEFAULT_INSTALL_ARGS, DEFAULT_YIELD_EVERY2, IGNORED_SCAN_DIRS, SAFE_PNPM_VERSION_RE;
+var DEFAULT_INSTALL_TIMEOUT_MS, DEFAULT_YIELD_EVERY2, IGNORED_SCAN_DIRS;
 var init_pnpm_hydration = __esm({
   "src/runner/pnpm-hydration.mjs"() {
     "use strict";
     init_pnpm_canonical_health();
+    init_pnpm_command();
     init_pnpm_materialize();
     init_process_runner();
     init_pnpm_link_detach();
     DEFAULT_INSTALL_TIMEOUT_MS = 20 * 60 * 1e3;
-    DEFAULT_INSTALL_ARGS = Object.freeze([
-      "install",
-      "--frozen-lockfile",
-      "--prefer-offline",
-      "--ignore-scripts",
-      "--config.confirmModulesPurge=false"
-    ]);
     DEFAULT_YIELD_EVERY2 = 25;
     IGNORED_SCAN_DIRS = /* @__PURE__ */ new Set([
       ".agent-worktrees",
@@ -1299,34 +1405,33 @@ var init_pnpm_hydration = __esm({
       "dist",
       "node_modules"
     ]);
-    SAFE_PNPM_VERSION_RE = /^[0-9A-Za-z._+-]+$/u;
   }
 });
 
 // src/runner/worktree-paths.mjs
 import { createHash as createHash2 } from "node:crypto";
-import path5 from "node:path";
+import path6 from "node:path";
 function samePath(left, right) {
-  const a = path5.resolve(left);
-  const b = path5.resolve(right);
+  const a = path6.resolve(left);
+  const b = path6.resolve(right);
   return process.platform === "win32" ? a.toLowerCase() === b.toLowerCase() : a === b;
 }
 function worktreePoolForRoot(root, { clonesRootDir = process.env.VO_CODE_RUNNER_CLONES_ROOT || "" } = {}) {
-  const canonicalRoot = path5.resolve(root);
+  const canonicalRoot = path6.resolve(root);
   if (clonesRootDir) {
-    const clonePool = path5.resolve(clonesRootDir);
-    if (samePath(path5.dirname(canonicalRoot), clonePool)) {
-      return path5.join(clonePool, ".agent-worktrees", path5.basename(canonicalRoot));
+    const clonePool = path6.resolve(clonesRootDir);
+    if (samePath(path6.dirname(canonicalRoot), clonePool)) {
+      return path6.join(clonePool, ".agent-worktrees", path6.basename(canonicalRoot));
     }
   }
-  return path5.join(canonicalRoot, ".agent-worktrees");
+  return path6.join(canonicalRoot, ".agent-worktrees");
 }
 function worktreeDirForName(root, worktreeName, options = {}) {
   const leaf = createHash2("sha256").update(String(worktreeName)).digest("hex").slice(0, 16);
-  return path5.join(worktreePoolForRoot(root, options), leaf);
+  return path6.join(worktreePoolForRoot(root, options), leaf);
 }
 function recoveryLedgerPathForRoot(root, options = {}) {
-  return path5.join(worktreePoolForRoot(root, options), "recovery-ledger.jsonl");
+  return path6.join(worktreePoolForRoot(root, options), "recovery-ledger.jsonl");
 }
 var init_worktree_paths = __esm({
   "src/runner/worktree-paths.mjs"() {
@@ -1335,9 +1440,9 @@ var init_worktree_paths = __esm({
 });
 
 // src/runner/worktree-cleanup.mjs
-import fs3 from "node:fs";
+import fs4 from "node:fs";
 import fsp6 from "node:fs/promises";
-import path6 from "node:path";
+import path7 from "node:path";
 function stateFromEntry(entry) {
   return {
     root: entry.root,
@@ -1378,14 +1483,14 @@ function pruneSuccessfulStates(nowMs = Date.now()) {
 function assertTrackedCleanupPath(entry) {
   const poolRoot = worktreePoolForRoot(entry.root);
   const expected = worktreeDirForName(entry.root, entry.worktreeName);
-  const resolvedPool = path6.resolve(poolRoot);
-  const resolvedTarget = path6.resolve(entry.worktreeDir);
-  if (!resolvedTarget.startsWith(`${resolvedPool}${path6.sep}`)) {
+  const resolvedPool = path7.resolve(poolRoot);
+  const resolvedTarget = path7.resolve(entry.worktreeDir);
+  if (!resolvedTarget.startsWith(`${resolvedPool}${path7.sep}`)) {
     const error = new Error(`cleanup refused outside managed pool: ${entry.worktreeDir}`);
     error.cleanupFatal = true;
     throw error;
   }
-  if (resolvedTarget !== path6.resolve(expected)) {
+  if (resolvedTarget !== path7.resolve(expected)) {
     const error = new Error(`cleanup refused for unexpected tracked path: ${entry.worktreeDir}`);
     error.cleanupFatal = true;
     throw error;
@@ -1399,8 +1504,8 @@ async function worktreeStillRegistered2(root, worktreeDir, gitRunner) {
   if (result.status !== 0) {
     throw new Error(`git worktree list --porcelain failed during cleanup verification: ${summarizeProcessFailure(result)}`);
   }
-  const registered = String(result.stdout || "").split(/\r?\n/u).filter((line) => line.startsWith("worktree ")).map((line) => path6.resolve(line.slice("worktree ".length).trim()));
-  return registered.includes(path6.resolve(worktreeDir));
+  const registered = String(result.stdout || "").split(/\r?\n/u).filter((line) => line.startsWith("worktree ")).map((line) => path7.resolve(line.slice("worktree ".length).trim()));
+  return registered.includes(path7.resolve(worktreeDir));
 }
 function cleanupBackoff(attempt) {
   return 250 * attempt;
@@ -1419,7 +1524,7 @@ async function runCleanupCycle(entry, options) {
     await (options.assertDetachedDependencyLinks || assertDetachedDependencyLinks)(entry.dependencyOwnership);
   }
   const gitRunner = options.gitRunner || runProcess;
-  const pathExists6 = options.pathExists || ((target) => fs3.existsSync(target));
+  const pathExists6 = options.pathExists || ((target) => fs4.existsSync(target));
   const removeResult = await gitRunner("git", ["worktree", "remove", "--force", entry.worktreeDir], {
     cwd: entry.root,
     timeoutMs: 12e4
@@ -1510,7 +1615,7 @@ function scheduleTrackedCleanup(entry, options = {}) {
 }
 function pendingCleanupDirs() {
   return new Set(
-    [...CLEANUP_STATES.values()].filter((state) => state.status === "pending").map((state) => path6.resolve(state.worktreeDir))
+    [...CLEANUP_STATES.values()].filter((state) => state.status === "pending").map((state) => path7.resolve(state.worktreeDir))
   );
 }
 var CLEANUP_STATES, CLEANUP_PROMISES, SUCCESS_HISTORY_LIMIT, SUCCESS_HISTORY_TTL_MS, DEFAULT_CLEANUP_ATTEMPTS;
@@ -1529,15 +1634,15 @@ var init_worktree_cleanup = __esm({
 });
 
 // src/runner/task-root-prepare.mjs
-import fs4 from "node:fs";
+import fs5 from "node:fs";
 import fsp7 from "node:fs/promises";
-import path7 from "node:path";
+import path8 from "node:path";
 function prepLockDir(root) {
-  return path7.join(root, ".agent-worktrees", "runner-root-prep.lock");
+  return path8.join(root, ".agent-worktrees", "runner-root-prep.lock");
 }
 function readLockMeta(lockDir) {
   try {
-    return JSON.parse(fs4.readFileSync(path7.join(lockDir, "owner.json"), "utf8"));
+    return JSON.parse(fs5.readFileSync(path8.join(lockDir, "owner.json"), "utf8"));
   } catch {
     return null;
   }
@@ -1557,13 +1662,13 @@ async function acquirePrepLock(root, options = {}) {
   const staleMs = options.lockStaleMs ?? PREP_LOCK_STALE_MS;
   const sleep3 = options.sleep || sleepMs;
   const lockDir = prepLockDir(root);
-  const ownerPath = path7.join(lockDir, "owner.json");
+  const ownerPath = path8.join(lockDir, "owner.json");
   const deadline = nowMs() + waitMs;
-  fs4.mkdirSync(path7.dirname(lockDir), { recursive: true });
+  fs5.mkdirSync(path8.dirname(lockDir), { recursive: true });
   for (; ; ) {
     try {
-      fs4.mkdirSync(lockDir);
-      fs4.writeFileSync(ownerPath, `${JSON.stringify({
+      fs5.mkdirSync(lockDir);
+      fs5.writeFileSync(ownerPath, `${JSON.stringify({
         pid: process.pid,
         createdAt: new Date(nowMs()).toISOString(),
         root
@@ -1609,16 +1714,16 @@ async function gitText(root, args, options = {}) {
 }
 function canonicalRecoveryDir(root, options = {}) {
   const now = options.now || (() => /* @__PURE__ */ new Date());
-  return path7.join(
-    options.managedPool || path7.join(root, ".agent-worktrees"),
+  return path8.join(
+    options.managedPool || path8.join(root, ".agent-worktrees"),
     ".canonical-recovery",
     `preexisting-${now().toISOString().replace(/[:.]/gu, "-")}`
   );
 }
 function canonicalPath(root, relative) {
-  const resolvedRoot = path7.resolve(root);
-  const target = path7.resolve(root, relative);
-  const prefix = `${resolvedRoot}${path7.sep}`;
+  const resolvedRoot = path8.resolve(root);
+  const target = path8.resolve(root, relative);
+  const prefix = `${resolvedRoot}${path8.sep}`;
   if (!target.startsWith(prefix)) {
     throw new Error(`canonical recovery path escaped the runner clone: ${relative}`);
   }
@@ -1646,7 +1751,7 @@ async function recoverManagedCanonicalResidue(root, options = {}) {
   if (patchResult.status !== 0) {
     throw new Error(`could not preserve canonical tracked changes: ${summarizeProcessFailure(patchResult)}`);
   }
-  await fsp7.writeFile(path7.join(quarantineDir, "tracked.patch"), String(patchResult.stdout || ""), "utf8");
+  await fsp7.writeFile(path8.join(quarantineDir, "tracked.patch"), String(patchResult.stdout || ""), "utf8");
   const symlinks = [];
   for (const relative of paths.untracked) {
     const source = canonicalPath(root, relative);
@@ -1658,13 +1763,13 @@ async function recoverManagedCanonicalResidue(root, options = {}) {
     if (!stat2.isFile()) {
       throw new Error(`canonical recovery refuses unsupported untracked entry: ${relative}`);
     }
-    const target = canonicalPath(path7.join(quarantineDir, "untracked"), relative);
-    await fsp7.mkdir(path7.dirname(target), { recursive: true });
+    const target = canonicalPath(path8.join(quarantineDir, "untracked"), relative);
+    await fsp7.mkdir(path8.dirname(target), { recursive: true });
     await fsp7.copyFile(source, target);
   }
-  await fsp7.writeFile(path7.join(quarantineDir, "manifest.json"), `${JSON.stringify({
+  await fsp7.writeFile(path8.join(quarantineDir, "manifest.json"), `${JSON.stringify({
     recoveredAt: (/* @__PURE__ */ new Date()).toISOString(),
-    canonicalRoot: path7.resolve(root),
+    canonicalRoot: path8.resolve(root),
     canonicalHead: headSha,
     tracked: paths.tracked,
     untracked: paths.untracked,
@@ -1736,19 +1841,19 @@ async function registeredWorktreeDirs(root, options = {}) {
     throw new Error(`git worktree list --porcelain failed while checking managed residue: ${summarizeProcessFailure(listed)}`);
   }
   return new Set(
-    String(listed.stdout || "").split(/\r?\n/u).filter((line) => line.startsWith("worktree ")).map((line) => path7.resolve(line.slice("worktree ".length).trim()))
+    String(listed.stdout || "").split(/\r?\n/u).filter((line) => line.startsWith("worktree ")).map((line) => path8.resolve(line.slice("worktree ".length).trim()))
   );
 }
 async function reportLegacyResiduals(root, options = {}) {
-  const managedRoot = path7.join(root, ".agent-worktrees");
-  if (!fs4.existsSync(managedRoot)) return [];
+  const managedRoot = path8.join(root, ".agent-worktrees");
+  if (!fs5.existsSync(managedRoot)) return [];
   const registered = await registeredWorktreeDirs(root, options);
   const pending = pendingCleanupDirs();
   const found = [];
-  for (const entry of fs4.readdirSync(managedRoot, { withFileTypes: true })) {
+  for (const entry of fs5.readdirSync(managedRoot, { withFileTypes: true })) {
     if (!entry.isDirectory()) continue;
     if (shouldIgnoreManagedEntry(entry.name)) continue;
-    const absolute = path7.resolve(path7.join(managedRoot, entry.name));
+    const absolute = path8.resolve(path8.join(managedRoot, entry.name));
     if (registered.has(absolute)) continue;
     if (pending.has(absolute)) continue;
     found.push(absolute);
@@ -1781,6 +1886,7 @@ var init_task_root_prepare = __esm({
   "src/runner/task-root-prepare.mjs"() {
     "use strict";
     init_pnpm_hydration();
+    init_pnpm_command();
     init_process_runner();
     init_worktree_cleanup();
     PREP_LOCK_WAIT_MS = 20 * 60 * 1e3;
@@ -1816,7 +1922,7 @@ var init_worktree_github_auth = __esm({
 
 // src/runner/worktree-recovery-start.mjs
 import fsp8 from "node:fs/promises";
-import path8 from "node:path";
+import path9 from "node:path";
 async function recordWorktreeStarted(worktreeTarget, meta = {}) {
   if (!worktreeTarget?.worktreeName || !meta.taskId) return null;
   const entry = {
@@ -1831,7 +1937,7 @@ async function recordWorktreeStarted(worktreeTarget, meta = {}) {
     reason: "worktree allocated before execution"
   };
   const ledger = recoveryLedgerPathForRoot(worktreeTarget.root || process.cwd());
-  await fsp8.mkdir(path8.dirname(ledger), { recursive: true });
+  await fsp8.mkdir(path9.dirname(ledger), { recursive: true });
   await fsp8.appendFile(ledger, `${JSON.stringify(entry)}
 `, "utf8");
   return { entry, ledger };
@@ -1844,9 +1950,9 @@ var init_worktree_recovery_start = __esm({
 });
 
 // src/runner/worktree-helper.mjs
-import fs5 from "node:fs";
+import fs6 from "node:fs";
 import fsp9 from "node:fs/promises";
-import path9 from "node:path";
+import path10 from "node:path";
 function repoRoot() {
   return process.env.VO_CODE_RUNNER_REPO || process.cwd();
 }
@@ -1862,7 +1968,7 @@ function cloneDirForSlug(repoSlug, clonesRootDir) {
   const [owner, name] = String(repoSlug).split("/");
   if (owner === "." || owner === ".." || name === "." || name === "..") return null;
   if (owner.startsWith("-") || name.startsWith("-")) return null;
-  return path9.join(clonesRootDir, `${sanitize(owner, "owner")}__${sanitize(name, "repo")}`);
+  return path10.join(clonesRootDir, `${sanitize(owner, "owner")}__${sanitize(name, "repo")}`);
 }
 function cloneLockDir(dir) {
   return `${dir}.clone-lock`;
@@ -1877,7 +1983,7 @@ async function pathExists5(target) {
 }
 async function readLockMeta2(lockDir) {
   try {
-    return JSON.parse(await fsp9.readFile(path9.join(lockDir, "owner.json"), "utf8"));
+    return JSON.parse(await fsp9.readFile(path10.join(lockDir, "owner.json"), "utf8"));
   } catch {
     return null;
   }
@@ -1898,11 +2004,11 @@ async function acquireCloneLock(dir, options = {}) {
   const sleep3 = options.sleep || sleepMs;
   const lockDir = cloneLockDir(dir);
   const deadline = nowMs() + waitMs;
-  await fsp9.mkdir(path9.dirname(lockDir), { recursive: true });
+  await fsp9.mkdir(path10.dirname(lockDir), { recursive: true });
   for (; ; ) {
     try {
       await fsp9.mkdir(lockDir);
-      await fsp9.writeFile(path9.join(lockDir, "owner.json"), `${JSON.stringify({
+      await fsp9.writeFile(path10.join(lockDir, "owner.json"), `${JSON.stringify({
         pid: process.pid,
         createdAt: new Date(nowMs()).toISOString(),
         dir
@@ -1931,7 +2037,7 @@ async function acquireCloneLock(dir, options = {}) {
   }
 }
 async function isUsableGitClone(dir, runner = runProcess) {
-  if (!await pathExists5(path9.join(dir, ".git"))) return false;
+  if (!await pathExists5(path10.join(dir, ".git"))) return false;
   const result = await runner("git", ["-C", dir, "rev-parse", "HEAD"], { timeoutMs: 1e4 });
   return result.status === 0 && Boolean(String(result.stdout || "").trim());
 }
@@ -1952,7 +2058,7 @@ async function ensureUsableClone(repoSlug, dir, options = {}) {
     const maxAttempts = options.maxAttempts || 5;
     const raceWaitMs = options.raceWaitMs ?? 1e4;
     let lastError = null;
-    await fsp9.mkdir(path9.dirname(dir), { recursive: true });
+    await fsp9.mkdir(path10.dirname(dir), { recursive: true });
     for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
       if (await pathExists5(dir)) {
         if (await waitForUsableClone(dir, runner, sleep3, raceWaitMs)) return dir;
@@ -1964,7 +2070,7 @@ async function ensureUsableClone(repoSlug, dir, options = {}) {
         ["clone", "--no-tags", `https://github.com/${owner}/${name}.git`, tmpDir],
         { timeoutMs: 6e5, env: githubGitAuthEnv(options.githubToken) }
       );
-      if (clone.status !== 0 || !await pathExists5(path9.join(tmpDir, ".git"))) {
+      if (clone.status !== 0 || !await pathExists5(path10.join(tmpDir, ".git"))) {
         await fsp9.rm(tmpDir, { recursive: true, force: true });
         lastError = new Error(`[vo-mcp runner] clone failed for ${repoSlug}: ${describeGitFailure(clone)}`);
         continue;
@@ -1991,7 +2097,7 @@ async function ensureUsableClone(repoSlug, dir, options = {}) {
 }
 async function resolveTaskRoot(repoSlug, options = {}) {
   const root = clonesRoot();
-  if (root && !path9.isAbsolute(root)) {
+  if (root && !path10.isAbsolute(root)) {
     throw new Error(`[vo-mcp runner] VO_CODE_RUNNER_CLONES_ROOT must be an absolute path (got '${root}')`);
   }
   const dir = cloneDirForSlug(repoSlug, root);
@@ -2040,7 +2146,7 @@ async function createFixWorktree(kind, error = {}, options = {}) {
   const dependencyOwnership = createDependencyOwnershipTracker(worktreeDir);
   const prep = await prepare(root, {
     recoverDirtyCanonical: multiRepo,
-    managedPool: path9.dirname(worktreeDir)
+    managedPool: path10.dirname(worktreeDir)
   });
   await processRunner("git", ["config", "core.longpaths", "true"], { cwd: root, timeoutMs: 3e4 });
   const add = await addWorktree({ root, branchName, worktreeDir });
@@ -2106,8 +2212,8 @@ function preserveFailedWorktree(worktreeName, meta = {}) {
   };
   try {
     const ledger = recoveryLedgerPathForRoot(root);
-    fs5.mkdirSync(path9.dirname(ledger), { recursive: true });
-    fs5.appendFileSync(ledger, `${JSON.stringify(entry)}
+    fs6.mkdirSync(path10.dirname(ledger), { recursive: true });
+    fs6.appendFileSync(ledger, `${JSON.stringify(entry)}
 `, "utf8");
     console.error(`[vo-mcp runner] Preserved worktree ${worktreeName} (reason: ${entry.reason})`);
   } catch (error) {
@@ -2152,9 +2258,9 @@ function partitionRecoveryLedger(lines, { nowMs, ttlMs = PRESERVED_WORKTREE_TTL_
   return decisions;
 }
 function isManagedPreservedDir(dir, root = repoRoot()) {
-  const normalized = path9.resolve(String(dir || ""));
-  const pool = path9.resolve(worktreePoolForRoot(root));
-  return normalized.startsWith(pool + path9.sep);
+  const normalized = path10.resolve(String(dir || ""));
+  const pool = path10.resolve(worktreePoolForRoot(root));
+  return normalized.startsWith(pool + path10.sep);
 }
 function mergeAppendedSinceRead(originalRaw, currentRaw, keptLines) {
   const originalSet = new Set(String(originalRaw || "").split(/\r?\n/u).map((l) => l.trim()).filter(Boolean));
@@ -2173,15 +2279,15 @@ function writeLedgerAtomic(ledger, lines, logger) {
   const payload = lines.length ? `${lines.join("\n")}
 ` : "";
   const tmp = `${ledger}.tmp-${process.pid}-${Date.now()}`;
-  fs5.writeFileSync(tmp, payload, "utf8");
+  fs6.writeFileSync(tmp, payload, "utf8");
   for (let attempt = 1; ; attempt += 1) {
     try {
-      fs5.renameSync(tmp, ledger);
+      fs6.renameSync(tmp, ledger);
       return true;
     } catch (error) {
       if (attempt >= 3) {
         try {
-          fs5.rmSync(tmp, { force: true });
+          fs6.rmSync(tmp, { force: true });
         } catch {
         }
         logger(`[vo-mcp runner] GC could not compact recovery ledger: ${String(error?.message || error)}`);
@@ -2203,14 +2309,14 @@ async function sweepPreservedWorktrees({
   const ledger = recoveryLedgerPathForRoot(root);
   let raw;
   try {
-    raw = fs5.readFileSync(ledger, "utf8");
+    raw = fs6.readFileSync(ledger, "utf8");
   } catch {
     return { removed: 0, compacted: 0 };
   }
   const decisions = partitionRecoveryLedger(raw.split(/\r?\n/u), {
     nowMs,
     ttlMs,
-    dirExists: (dir) => fs5.existsSync(dir)
+    dirExists: (dir) => fs6.existsSync(dir)
   });
   let removed = 0;
   let compacted = 0;
@@ -2250,7 +2356,7 @@ async function sweepPreservedWorktrees({
   if (compacted > 0) {
     let currentRaw = raw;
     try {
-      currentRaw = fs5.readFileSync(ledger, "utf8");
+      currentRaw = fs6.readFileSync(ledger, "utf8");
     } catch {
     }
     writeLedgerAtomic(ledger, mergeAppendedSinceRead(raw, currentRaw, output), logger);
@@ -2476,6 +2582,11 @@ var init_control_plane_auth_stub = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/control-plane-client.mjs
+var control_plane_client_exports = {};
+__export(control_plane_client_exports, {
+  ClaimAuthorityChangedError: () => ClaimAuthorityChangedError,
+  createControlPlaneClient: () => createControlPlaneClient
+});
 async function resolveBearer(env2) {
   const adminToken = env2.VO_CONTROL_PLANE_ADMIN_TOKEN;
   if (adminToken) return adminToken;
@@ -2508,11 +2619,11 @@ function createControlPlaneClient({
   const resolvedBaseUrl = baseUrl ?? env2.VO_CONTROL_PLANE_URL ?? "";
   if (!resolvedBaseUrl) throw new Error("VO_CONTROL_PLANE_URL is required for the code-runner daemon");
   const root = resolvedBaseUrl.replace(/\/+$/, "");
-  async function req(method, path19, body, { timeoutMs } = {}) {
+  async function req(method, path23, body, { timeoutMs } = {}) {
     const bearer = await resolveBearer(env2);
     const controller = timeoutMs ? new AbortController() : null;
     let timeoutId;
-    const request = Promise.resolve(fetchImpl(`${root}${path19}`, {
+    const request = Promise.resolve(fetchImpl(`${root}${path23}`, {
       method,
       headers: {
         "content-type": "application/json",
@@ -2525,7 +2636,7 @@ function createControlPlaneClient({
     const timeout = new Promise((_, reject) => {
       timeoutId = setTimeout(() => {
         controller.abort();
-        reject(new Error(`control-plane ${path19} timed out after ${timeoutMs}ms`));
+        reject(new Error(`control-plane ${path23} timed out after ${timeoutMs}ms`));
       }, timeoutMs);
     });
     try {
@@ -2534,7 +2645,7 @@ function createControlPlaneClient({
       clearTimeout(timeoutId);
     }
   }
-  const taskReq = (method, path19, body, options = {}) => req(method, path19, body, { timeoutMs: taskRequestTimeoutMs, ...options });
+  const taskReq = (method, path23, body, options = {}) => req(method, path23, body, { timeoutMs: taskRequestTimeoutMs, ...options });
   return {
     ...makeAutonomousDispatchAdmissionClient(
       req,
@@ -2657,8 +2768,8 @@ function createControlPlaneClient({
       return listAllPrOpenedTasks(taskReq);
     },
     async downloadTaskAttachment(taskId, attachmentId) {
-      const path19 = `/api/v1/code-task/${encodeURIComponent(taskId)}/attachment/${encodeURIComponent(attachmentId)}`;
-      const res = await taskReq("GET", path19);
+      const path23 = `/api/v1/code-task/${encodeURIComponent(taskId)}/attachment/${encodeURIComponent(attachmentId)}`;
+      const res = await taskReq("GET", path23);
       if (res.status === 401) cachedFirebaseToken = null;
       if (!res.ok) throw new Error(`attachment download failed: HTTP ${res.status}`);
       return Buffer.from(await res.arrayBuffer());
@@ -2852,8 +2963,8 @@ var init_control_plane_client = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/windows-claude-launch.mjs
-import { existsSync as existsSync2, realpathSync } from "node:fs";
-import { win32 as path10 } from "node:path";
+import { existsSync as existsSync3, realpathSync } from "node:fs";
+import { win32 as path11 } from "node:path";
 import { spawnSync } from "node:child_process";
 function pathValue(env2) {
   for (const key of ["Path", "PATH", "path"]) {
@@ -2874,38 +2985,38 @@ function envValue(env2, name) {
 function userClaudeCandidates(bin, env2) {
   if (!/^claude(?:\.(?:exe|cmd|ps1))?$/iu.test(bin)) return [];
   const userProfile = envValue(env2, "USERPROFILE");
-  const appData = envValue(env2, "APPDATA") || (userProfile ? path10.join(userProfile, "AppData", "Roaming") : "");
-  const localAppData = envValue(env2, "LOCALAPPDATA") || (userProfile ? path10.join(userProfile, "AppData", "Local") : "");
+  const appData = envValue(env2, "APPDATA") || (userProfile ? path11.join(userProfile, "AppData", "Roaming") : "");
+  const localAppData = envValue(env2, "LOCALAPPDATA") || (userProfile ? path11.join(userProfile, "AppData", "Local") : "");
   const candidates = [];
   if (appData) {
-    const npmBin = path10.join(appData, "npm");
+    const npmBin = path11.join(appData, "npm");
     candidates.push(
-      path10.join(npmBin, "claude.exe"),
-      path10.join(npmBin, "claude.cmd"),
-      path10.join(npmBin, "claude.ps1"),
-      path10.join(npmBin, "claude"),
-      path10.join(npmBin, ...NATIVE_CLAUDE_PARTS)
+      path11.join(npmBin, "claude.exe"),
+      path11.join(npmBin, "claude.cmd"),
+      path11.join(npmBin, "claude.ps1"),
+      path11.join(npmBin, "claude"),
+      path11.join(npmBin, ...NATIVE_CLAUDE_PARTS)
     );
   }
-  if (userProfile) candidates.push(path10.join(userProfile, ".local", "bin", "claude.exe"));
+  if (userProfile) candidates.push(path11.join(userProfile, ".local", "bin", "claude.exe"));
   if (localAppData) {
     candidates.push(
-      path10.join(localAppData, "Microsoft", "WinGet", "Links", "claude.exe"),
-      path10.join(localAppData, "Microsoft", "WindowsApps", "claude.exe")
+      path11.join(localAppData, "Microsoft", "WinGet", "Links", "claude.exe"),
+      path11.join(localAppData, "Microsoft", "WindowsApps", "claude.exe")
     );
   }
   return candidates;
 }
 function pathCandidates(bin, env2) {
-  if (path10.isAbsolute(bin) || /[\\/]/u.test(bin)) {
-    return [path10.resolve(bin)];
-  }
-  const extension = path10.extname(bin);
-  const fromPath = pathValue(env2).split(";").map(cleanPathSegment).filter(Boolean).flatMap((directory) => extension ? [path10.join(directory, bin)] : [
-    path10.join(directory, `${bin}.exe`),
-    path10.join(directory, `${bin}.cmd`),
-    path10.join(directory, `${bin}.ps1`),
-    path10.join(directory, bin)
+  if (path11.isAbsolute(bin) || /[\\/]/u.test(bin)) {
+    return [path11.resolve(bin)];
+  }
+  const extension = path11.extname(bin);
+  const fromPath = pathValue(env2).split(";").map(cleanPathSegment).filter(Boolean).flatMap((directory) => extension ? [path11.join(directory, bin)] : [
+    path11.join(directory, `${bin}.exe`),
+    path11.join(directory, `${bin}.cmd`),
+    path11.join(directory, `${bin}.ps1`),
+    path11.join(directory, bin)
   ]);
   const seen = /* @__PURE__ */ new Set();
   return [...fromPath, ...userClaudeCandidates(bin, env2)].filter((candidate) => {
@@ -2926,7 +3037,7 @@ function canonicalExistingPath(candidate, exists, canonicalize) {
 function resolveWindowsClaudeExecutable({
   bin = "claude",
   env: env2 = process.env,
-  exists = existsSync2,
+  exists = existsSync3,
   canonicalize = realpathSync
 } = {}) {
   const requested = String(bin || "").trim();
@@ -2936,8 +3047,8 @@ function resolveWindowsClaudeExecutable({
   for (const candidate of pathCandidates(requested, env2)) {
     const found = canonicalExistingPath(candidate, exists, canonicalize);
     if (!found) continue;
-    if (path10.extname(found).toLowerCase() === ".exe") return found;
-    const native = path10.join(path10.dirname(found), ...NATIVE_CLAUDE_PARTS);
+    if (path11.extname(found).toLowerCase() === ".exe") return found;
+    const native = path11.join(path11.dirname(found), ...NATIVE_CLAUDE_PARTS);
     const resolvedNative = canonicalExistingPath(native, exists, canonicalize);
     if (resolvedNative) return resolvedNative;
   }
@@ -3404,14 +3515,14 @@ var init_terminal_process_cleanup = __esm({
 
 // ../../scripts/virtual-office/code-runner/orphan-agent-reaper.mjs
 import { spawnSync as spawnSync5 } from "node:child_process";
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readdirSync, readFileSync as readFileSync2, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import os from "node:os";
-import path11 from "node:path";
+import path12 from "node:path";
 function registryRoot(tmp = os.tmpdir()) {
-  return path11.join(tmp, REGISTRY_ROOT_NAME);
+  return path12.join(tmp, REGISTRY_ROOT_NAME);
 }
 function instanceDir(root, instanceId) {
-  return path11.join(root, String(instanceId).replace(/[^A-Za-z0-9_-]/g, ""));
+  return path12.join(root, String(instanceId).replace(/[^A-Za-z0-9_-]/g, ""));
 }
 function registerDaemonInstance({
   root = registryRoot(),
@@ -3421,8 +3532,8 @@ function registerDaemonInstance({
 } = {}) {
   if (!instanceId) return null;
   const dir = instanceDir(root, instanceId);
-  mkdirSync2(dir, { recursive: true });
-  const file = path11.join(dir, DAEMON_RECORD);
+  mkdirSync3(dir, { recursive: true });
+  const file = path12.join(dir, DAEMON_RECORD);
   writeFileSync2(file, JSON.stringify({ daemonPid, daemonStartedAtMs, instanceId }), {
     encoding: "utf8",
     mode: 384
@@ -3439,9 +3550,9 @@ function recordAgentPid({
   if (!instanceId || !Number.isInteger(pid) || pid <= 0) return false;
   try {
     const dir = instanceDir(root, instanceId);
-    mkdirSync2(dir, { recursive: true });
+    mkdirSync3(dir, { recursive: true });
     writeFileSync2(
-      path11.join(dir, `${pid}.json`),
+      path12.join(dir, `${pid}.json`),
       JSON.stringify({ pid, agentId, startedAtMs, instanceId }),
       { encoding: "utf8", mode: 384 }
     );
@@ -3457,7 +3568,7 @@ function unrecordAgentPid({
 } = {}) {
   if (!instanceId || !Number.isInteger(pid)) return false;
   try {
-    rmSync2(path11.join(instanceDir(root, instanceId), `${pid}.json`), { force: true });
+    rmSync2(path12.join(instanceDir(root, instanceId), `${pid}.json`), { force: true });
     return true;
   } catch {
     return false;
@@ -3475,7 +3586,7 @@ function bootstrapOrphanReaper({ instanceId, log: log2 = () => {
 }
 function readRegistry({ root = registryRoot(), currentInstanceId } = {}) {
   const instances = [];
-  if (!existsSync3(root)) return instances;
+  if (!existsSync4(root)) return instances;
   let dirents;
   try {
     dirents = readdirSync(root, { withFileTypes: true });
@@ -3485,7 +3596,7 @@ function readRegistry({ root = registryRoot(), currentInstanceId } = {}) {
   for (const dirent of dirents) {
     if (!dirent.isDirectory()) continue;
     if (currentInstanceId && dirent.name === instanceDirName(currentInstanceId)) continue;
-    const dir = path11.join(root, dirent.name);
+    const dir = path12.join(root, dirent.name);
     let daemon = null;
     const agents = [];
     let files;
@@ -3497,7 +3608,7 @@ function readRegistry({ root = registryRoot(), currentInstanceId } = {}) {
     for (const name of files) {
       let parsed;
       try {
-        parsed = JSON.parse(readFileSync2(path11.join(dir, name), "utf8"));
+        parsed = JSON.parse(readFileSync2(path12.join(dir, name), "utf8"));
       } catch {
         continue;
       }
@@ -3545,7 +3656,7 @@ function windowsSystemRoot(env2 = process.env) {
   return env2.SystemRoot || env2.WINDIR || "C:\\Windows";
 }
 function windowsPowershellExe(env2 = process.env) {
-  return path11.join(windowsSystemRoot(env2), "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
+  return path12.join(windowsSystemRoot(env2), "System32", "WindowsPowerShell", "v1.0", "powershell.exe");
 }
 function listProcessCreationTimes({ platform = process.platform, spawn: spawn5 = spawnSync5, env: env2 = process.env, warn = console.warn } = {}) {
   const map = /* @__PURE__ */ new Map();
@@ -3590,7 +3701,7 @@ function parsePosixPsLine(line) {
 function killProcessTree(pid, { platform = process.platform, spawn: spawn5 = spawnSync5, env: env2 = process.env } = {}) {
   if (!Number.isInteger(pid) || pid <= 0) return false;
   if (platform === "win32") {
-    const taskkill = path11.join(windowsSystemRoot(env2), "System32", "taskkill.exe");
+    const taskkill = path12.join(windowsSystemRoot(env2), "System32", "taskkill.exe");
     const r = spawn5(taskkill, ["/PID", String(pid), "/T", "/F"], { windowsHide: true, stdio: "ignore", timeout: 15e3 });
     return !r.error && r.status === 0;
   }
@@ -4379,15 +4490,15 @@ var init_flat_token_usage = __esm({
 
 // ../../scripts/virtual-office/code-runner/codex-runner.mjs
 import { spawnSync as spawnSync6 } from "node:child_process";
-import { existsSync as existsSync4 } from "node:fs";
-import { win32 } from "node:path";
+import { existsSync as existsSync5 } from "node:fs";
+import { win32 as win322 } from "node:path";
 function isTruthyFlag2(value) {
   return ["1", "true", "yes", "on"].includes(String(value ?? "").trim().toLowerCase());
 }
 function resolveCodexBinary({
   env: env2 = process.env,
   platform = process.platform,
-  exists = existsSync4
+  exists = existsSync5
 } = {}) {
   if (platform !== "win32") return "codex";
   const appData = String(env2.APPDATA || "").trim();
@@ -4395,7 +4506,7 @@ function resolveCodexBinary({
   const localAppData = String(env2.LOCALAPPDATA || "").trim();
   const candidates = [];
   if (appData) {
-    candidates.push(win32.join(
+    candidates.push(win322.join(
       appData,
       "npm",
       "node_modules",
@@ -4411,11 +4522,11 @@ function resolveCodexBinary({
     ));
   }
   if (userProfile) {
-    candidates.push(win32.join(userProfile, ".local", "bin", "codex.exe"));
-    candidates.push(win32.join(userProfile, ".codex", "bin", "codex.exe"));
+    candidates.push(win322.join(userProfile, ".local", "bin", "codex.exe"));
+    candidates.push(win322.join(userProfile, ".codex", "bin", "codex.exe"));
   }
   if (localAppData) {
-    candidates.push(win32.join(localAppData, "Microsoft", "WindowsApps", "codex.exe"));
+    candidates.push(win322.join(localAppData, "Microsoft", "WindowsApps", "codex.exe"));
   }
   const absolute = candidates.find((candidate) => exists(candidate));
   if (absolute) return absolute;
@@ -4764,6 +4875,188 @@ var init_cursor_runner = __esm({
   }
 });
 
+// ../../scripts/virtual-office/code-runner/ollama-agent-tools.mjs
+var MAX_READ_BYTES, MAX_WRITE_BYTES, TOOL_DEFS, TOOL_NAMES, READ_ONLY_TOOL_NAMES, READ_ONLY_TOOL_DEFS;
+var init_ollama_agent_tools = __esm({
+  "../../scripts/virtual-office/code-runner/ollama-agent-tools.mjs"() {
+    "use strict";
+    MAX_READ_BYTES = 64 * 1024;
+    MAX_WRITE_BYTES = 512 * 1024;
+    TOOL_DEFS = [
+      {
+        type: "function",
+        function: {
+          name: "read_file",
+          description: "Read a UTF-8 text file inside the working directory. Returns up to 64 KiB.",
+          parameters: {
+            type: "object",
+            properties: {
+              path: { type: "string", description: "File path relative to the working directory." }
+            },
+            required: ["path"]
+          }
+        }
+      },
+      {
+        type: "function",
+        function: {
+          name: "list_files",
+          description: "List entries in a directory inside the working directory (files and subdirs).",
+          parameters: {
+            type: "object",
+            properties: {
+              path: { type: "string", description: 'Directory path relative to the working directory. Default ".".' }
+            }
+          }
+        }
+      },
+      {
+        type: "function",
+        function: {
+          name: "write_file",
+          description: "Create or overwrite a UTF-8 text file inside the working directory. Parent dirs are created.",
+          parameters: {
+            type: "object",
+            properties: {
+              path: { type: "string", description: "File path relative to the working directory." },
+              content: { type: "string", description: "Full new file contents." }
+            },
+            required: ["path", "content"]
+          }
+        }
+      }
+    ];
+    TOOL_NAMES = TOOL_DEFS.map((t) => t.function.name);
+    READ_ONLY_TOOL_NAMES = Object.freeze(["read_file", "list_files"]);
+    READ_ONLY_TOOL_DEFS = Object.freeze(
+      TOOL_DEFS.filter((tool) => READ_ONLY_TOOL_NAMES.includes(tool.function.name))
+    );
+  }
+});
+
+// ../../scripts/virtual-office/code-runner/ollama-agent-core.mjs
+function parseOllamaAgentEvent(line) {
+  const trimmed = String(line || "").trim();
+  if (!trimmed) return null;
+  let evt;
+  try {
+    evt = JSON.parse(trimmed);
+  } catch {
+    return null;
+  }
+  if (!evt || typeof evt !== "object") return null;
+  if (evt.type === "progress") {
+    const text = String(evt.text || "").trim();
+    return text ? { kind: "progress", text } : null;
+  }
+  if (evt.type === "tool") {
+    const via = evt.recovered ? " (recovered from text)" : "";
+    const label = `${evt.ok === false ? "tool failed" : "tool"}: ${evt.name}${evt.path ? ` ${evt.path}` : ""}${via}`;
+    return { kind: "progress", text: label };
+  }
+  if (evt.type === "result") {
+    const usage = evt.usage || null;
+    const tokenUsage = usage ? { inputTokens: usage.inputTokens ?? null, outputTokens: usage.outputTokens ?? null, totalTokens: usage.totalTokens ?? null } : void 0;
+    return {
+      kind: "result",
+      isError: Boolean(evt.isError),
+      costUsd: 0,
+      // sovereign local inference is free — no meter.
+      summary: String(evt.summary || (evt.isError ? "local run failed" : "completed")),
+      numTurns: Number.isInteger(evt.numTurns) ? evt.numTurns : null,
+      ...tokenUsage ? { tokenUsage } : {},
+      // Pass the sovereign receipt through to the daemon. Omitted entirely when
+      // absent so the event shape is unchanged for every other transport.
+      ...evt.receipt ? { receipt: evt.receipt } : {}
+    };
+  }
+  return null;
+}
+var MAX_TURNS_DEFAULT, NUM_CTX_DEFAULT;
+var init_ollama_agent_core = __esm({
+  "../../scripts/virtual-office/code-runner/ollama-agent-core.mjs"() {
+    "use strict";
+    init_ollama_agent_tools();
+    init_ollama_agent_tools();
+    MAX_TURNS_DEFAULT = 20;
+    NUM_CTX_DEFAULT = 16384;
+  }
+});
+
+// ../../scripts/virtual-office/code-runner/ollama-native-transport.mjs
+import { fileURLToPath } from "node:url";
+import { dirname as dirname2, join as join2 } from "node:path";
+function resolveLocalNativeProfile(env2 = process.env) {
+  const profile = String(env2.VO_CODE_RUNNER_LOCAL_PROFILE || "").trim().toLowerCase() || DEFAULT_LOCAL_NATIVE_PROFILE;
+  if (!LOCAL_NATIVE_PROFILES.includes(profile)) {
+    throw new Error(`local-model runner (native): unknown profile "${profile}" (coding|verification).`);
+  }
+  return profile;
+}
+function resolveLocalTransport(env2 = process.env) {
+  return String(env2.VO_CODE_RUNNER_LOCAL_TRANSPORT || "").trim().toLowerCase() === "native" ? "native" : DEFAULT_LOCAL_TRANSPORT;
+}
+function ollamaAgentScriptPath() {
+  return join2(dirname2(fileURLToPath(import.meta.url)), "ollama-agent.mjs");
+}
+function posIntOr(raw, fallback) {
+  const n = Number(String(raw ?? "").trim());
+  return Number.isInteger(n) && n > 0 ? n : fallback;
+}
+function buildOllamaAgentArgs({ model, numCtx, maxTurns, profile = DEFAULT_LOCAL_NATIVE_PROFILE } = {}) {
+  return [
+    ollamaAgentScriptPath(),
+    "--model",
+    String(model),
+    "--profile",
+    String(profile),
+    "--num-ctx",
+    String(posIntOr(numCtx, NUM_CTX_DEFAULT)),
+    "--max-turns",
+    String(posIntOr(maxTurns, MAX_TURNS_DEFAULT))
+  ];
+}
+function buildLocalNativeArgs(opts = {}, env2 = process.env) {
+  const provider = resolveLocalProvider(env2);
+  if (provider !== "ollama") {
+    throw new Error(
+      `local-model runner (native): the native tool-loop executor speaks Ollama's /api/chat; provider "${provider}" is not supported on native transport. Set VO_CODE_RUNNER_LOCAL_PROVIDER=ollama, or use VO_CODE_RUNNER_LOCAL_TRANSPORT=codex for LM Studio.`
+    );
+  }
+  const model = resolveLocalModel(env2);
+  if (!model) {
+    throw new Error(
+      "local-model runner (native): set VO_CODE_RUNNER_LOCAL_MODEL to a coding model your Ollama server already has (e.g. qwen2.5-coder:7b). Refusing to run with no explicit model (fail-closed)."
+    );
+  }
+  if (!isValidLocalModel(model)) {
+    throw new Error(`local-model runner (native): "${model}" is not a valid local model id.`);
+  }
+  const baseUrl = resolveLocalBaseUrl(env2);
+  if (baseUrl && !isLoopbackBaseUrl(baseUrl)) {
+    throw new Error(
+      "local-model runner (native): VO_CODE_RUNNER_LOCAL_BASE_URL must be a loopback http(s) URL (localhost / 127.0.0.1 / [::1]). Remote endpoints are refused \u2014 use the Model Firewall lanes."
+    );
+  }
+  return buildOllamaAgentArgs({
+    model,
+    profile: resolveLocalNativeProfile(env2),
+    numCtx: env2.VO_CODE_RUNNER_LOCAL_NUM_CTX,
+    maxTurns: env2.VO_CODE_RUNNER_LOCAL_MAX_TURNS
+  });
+}
+var DEFAULT_LOCAL_TRANSPORT, LOCAL_NATIVE_PROFILES, DEFAULT_LOCAL_NATIVE_PROFILE;
+var init_ollama_native_transport = __esm({
+  "../../scripts/virtual-office/code-runner/ollama-native-transport.mjs"() {
+    "use strict";
+    init_ollama_agent_core();
+    init_local_model_runner();
+    DEFAULT_LOCAL_TRANSPORT = "codex";
+    LOCAL_NATIVE_PROFILES = Object.freeze(["coding", "verification"]);
+    DEFAULT_LOCAL_NATIVE_PROFILE = "coding";
+  }
+});
+
 // ../../scripts/virtual-office/code-runner/local-model-runner.mjs
 function resolveLocalProvider(env2 = process.env) {
   return String(env2.VO_CODE_RUNNER_LOCAL_PROVIDER || "").trim().toLowerCase() || DEFAULT_LOCAL_PROVIDER;
@@ -4837,20 +5130,37 @@ function buildLocalArgs(opts = {}, env2 = process.env) {
 }
 function applyLocalAuthEnv(baseEnv = process.env, configEnv = process.env) {
   const out = withAgentKey("local", baseEnv);
+  for (const key of Object.keys(out)) {
+    if (FORBIDDEN_LOCAL_CHILD_CREDENTIALS.has(key.toUpperCase())) delete out[key];
+  }
   const baseUrl = resolveLocalBaseUrl(configEnv);
   if (baseUrl && isLoopbackBaseUrl(baseUrl) && resolveLocalProvider(configEnv) === "ollama" && !String(out.OLLAMA_HOST || "").trim()) {
     out.OLLAMA_HOST = baseUrl.replace(/\/+$/, "");
   }
   return out;
 }
-var LOCAL_API_KEY_ENV, LOCAL_PROVIDERS, DEFAULT_LOCAL_PROVIDER, LOCAL_PROBE_URLS, remoteDesiredLocalModel, LOCAL_MODEL_RE, LocalModelRunner, localModelRunner;
+var LOCAL_API_KEY_ENV, FORBIDDEN_LOCAL_CHILD_CREDENTIALS, LOCAL_PROVIDERS, DEFAULT_LOCAL_PROVIDER, LOCAL_PROBE_URLS, remoteDesiredLocalModel, LOCAL_MODEL_RE, LocalModelRunner, localModelRunner;
 var init_local_model_runner = __esm({
   "../../scripts/virtual-office/code-runner/local-model-runner.mjs"() {
     "use strict";
     init_codex_runner();
     init_agent_key_store();
     init_agent_auth_tier();
+    init_ollama_agent_core();
+    init_ollama_native_transport();
     LOCAL_API_KEY_ENV = "VO_CODE_RUNNER_LOCAL_API_KEY";
+    FORBIDDEN_LOCAL_CHILD_CREDENTIALS = /* @__PURE__ */ new Set([
+      "ANTHROPIC_API_KEY",
+      "AWS_ACCESS_KEY_ID",
+      "AWS_SECRET_ACCESS_KEY",
+      "AWS_SESSION_TOKEN",
+      "FIREBASE_TOKEN",
+      "GH_TOKEN",
+      "GITHUB_TOKEN",
+      "GOOGLE_API_KEY",
+      "GOOGLE_APPLICATION_CREDENTIALS",
+      "OPENAI_API_KEY"
+    ]);
     LOCAL_PROVIDERS = ["ollama", "lmstudio"];
     DEFAULT_LOCAL_PROVIDER = "ollama";
     LOCAL_PROBE_URLS = {
@@ -4871,19 +5181,25 @@ var init_local_model_runner = __esm({
         this.env = env2;
         this.fetchImpl = fetchImpl;
       }
-      /** Codex is the transport binary; the model/endpoint are the user's. */
+      /**
+       * Transport binary. codex transport → the codex CLI. native transport →
+       * this daemon's own node (process.execPath), which runs ollama-agent.mjs; no
+       * external CLI is involved on the native path.
+       */
       get binary() {
-        return this.resolveBinary();
+        return resolveLocalTransport(this.env) === "native" ? process.execPath : this.resolveBinary();
       }
       buildArgs(opts = {}) {
-        return buildLocalArgs(opts, this.env);
+        return resolveLocalTransport(this.env) === "native" ? buildLocalNativeArgs(opts, this.env) : buildLocalArgs(opts, this.env);
       }
       /**
-       * Codex JSONL events map identically, except a sovereign local model has no
-       * vendor bill. Codex omits total_cost_usd for OSS runs; turn that known fact
-       * into a measured zero at the producer so readers never have to guess.
+       * native transport → parse the executor's own JSONL contract. codex transport
+       * → codex JSONL maps identically, except a sovereign local model has no vendor
+       * bill: codex omits total_cost_usd for OSS runs, so turn that known fact into a
+       * measured zero at the producer. (The native parser already stamps costUsd:0.)
        */
       parseEvent(line) {
+        if (resolveLocalTransport(this.env) === "native") return parseOllamaAgentEvent(line);
         const event = parseCodexEvent(line);
         return event?.kind === "result" ? { ...event, costUsd: 0 } : event;
       }
@@ -5244,9 +5560,9 @@ var init_rate_limit_detector_core = __esm({
 
 // ../../scripts/virtual-office/code-runner/rate-limit-resume-state.mjs
 import fsp10 from "node:fs/promises";
-import path12 from "node:path";
+import path13 from "node:path";
 async function atomicWrite(file, content) {
-  await fsp10.mkdir(path12.dirname(file), { recursive: true });
+  await fsp10.mkdir(path13.dirname(file), { recursive: true });
   const temp = `${file}.tmp-${process.pid}-${Date.now()}`;
   const handle = await fsp10.open(temp, "wx");
   try {
@@ -5307,7 +5623,7 @@ function writeResumeAttempts(file, store) {
 }
 async function acquireLock(lockFile, { now = Date.now, sleep: sleep3 = delay } = {}) {
   const deadline = now() + LOCK_WAIT_MS;
-  await fsp10.mkdir(path12.dirname(lockFile), { recursive: true });
+  await fsp10.mkdir(path13.dirname(lockFile), { recursive: true });
   for (; ; ) {
     let handle;
     try {
@@ -5381,10 +5697,10 @@ var init_rate_limit_resume_state = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/rate-limit-resume.mjs
-import { homedir as homedir2 } from "node:os";
-import { join as join2 } from "node:path";
+import { homedir as homedir3 } from "node:os";
+import { join as join3 } from "node:path";
 function resumeQueuePath() {
-  return join2(homedir2(), ".claude", "resume-queue.jsonl");
+  return join3(homedir3(), ".claude", "resume-queue.jsonl");
 }
 function buildResumeEntry({ task = {}, resumeAfter = null, summary = "", at } = {}) {
   return {
@@ -5585,8 +5901,8 @@ var init_auto_merge = __esm({
 
 // ../../scripts/virtual-office/code-runner/pr-overlap-gate.mjs
 import { spawnSync as spawnSync8 } from "node:child_process";
-import { existsSync as existsSync5 } from "node:fs";
-import { fileURLToPath } from "node:url";
+import { existsSync as existsSync6 } from "node:fs";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 function stripCredentials(env2 = process.env) {
   const safe = { ...env2 };
   for (const key of CREDENTIAL_ENV_KEYS) delete safe[key];
@@ -5596,7 +5912,7 @@ function resolveOverlapScript({
   worktreeDir,
   trustedPath = null,
   trustedPaths = TRUSTED_OVERLAP_CANDIDATES,
-  existsFn = existsSync5,
+  existsFn = existsSync6,
   joinFn = (dir) => `${dir}/scripts/ci/check-local-pr-overlap.mjs`
 } = {}) {
   const candidates = trustedPath ? [trustedPath] : trustedPaths;
@@ -5612,7 +5928,7 @@ var init_pr_overlap_gate = __esm({
     TRUSTED_OVERLAP_CANDIDATES = [
       new URL("../../ci/check-local-pr-overlap.mjs", import.meta.url),
       new URL("./ci/check-local-pr-overlap.js", import.meta.url)
-    ].map((candidate) => fileURLToPath(candidate));
+    ].map((candidate) => fileURLToPath2(candidate));
     CREDENTIAL_ENV_KEYS = Object.freeze([
       "GH_TOKEN",
       "GITHUB_TOKEN",
@@ -5665,14 +5981,14 @@ function parsePorcelainZ(out) {
   for (let i = 0; i < tokens.length; i += 1) {
     const token2 = tokens[i];
     if (!token2) continue;
-    const path19 = token2.slice(3);
-    if (path19) files.push(path19);
+    const path23 = token2.slice(3);
+    if (path23) files.push(path23);
     if (token2[0] === "R" || token2[0] === "C") i += 1;
   }
   return files;
 }
-function isAgentScratch(path19) {
-  const normalized = String(path19 || "");
+function isAgentScratch(path23) {
+  const normalized = String(path23 || "");
   return SCRATCH_PATTERNS.some((pattern) => pattern.test(normalized));
 }
 var SCRATCH_PATTERNS;
@@ -5739,6 +6055,540 @@ var init_publish = __esm({
   }
 });
 
+// ../../scripts/virtual-office/test-gen/auto-tier.mjs
+function lower(s) {
+  return typeof s === "string" ? s.toLowerCase() : "";
+}
+function isAlgoProduct(product) {
+  return /^algo/i.test(String(product || ""));
+}
+function isAdminRoute(route) {
+  return /(^|\/)admin(\/|$)/i.test(String(route || ""));
+}
+function importsMatch(imports, re) {
+  return Array.isArray(imports) && imports.some((i) => re.test(String(i || "")));
+}
+function classifyTier(contract = {}) {
+  const product = lower(contract.product);
+  const callable = String(contract.callable || "");
+  const route = String(contract.route || "");
+  const imports = contract.imports;
+  const ov = contract.tier_override;
+  if (ov === 1 || ov === 2 || ov === 3 || ov === 4) {
+    return { tier: ov, rationale: `operator override \u2192 Tier ${ov}`, tier_override: true };
+  }
+  const algo = isAlgoProduct(product);
+  let tier;
+  let why;
+  const legalDomain = LEGAL_PRODUCTS.has(product);
+  const hasGovernedSource = Boolean(contract.authoritative_source_url) || importsMatch(imports, LEGAL_IMPORT_RE);
+  if (legalDomain && hasGovernedSource) {
+    tier = 4;
+    why = `legal-correctness domain (${product}) with a governed source \u2192 source-grounded Tier 4`;
+  } else if (isAdminRoute(route) || MONEY_OR_SAFETY_RE.test(callable)) {
+    tier = 3;
+    why = isAdminRoute(route) ? "admin/safety-critical route \u2192 real-time monitor Tier 3" : `money-moving or grading callable (${callable}) \u2192 real-time monitor Tier 3`;
+  } else if (importsMatch(imports, GENERATIVE_RE) || GENERATIVE_CALLABLE_RE.test(callable)) {
+    const long = Number(contract.workflow_seconds) > 30;
+    tier = long ? 3 : 2;
+    why = `generative/AI feature \u2192 E2E with verified results${long ? " + monitor (long workflow) Tier 3" : " Tier 2"}`;
+  } else if (callable || route) {
+    tier = 2;
+    why = "standard business logic \u2192 E2E with verified results (read-back) Tier 2";
+  } else {
+    tier = 1;
+    why = "pure navigation/surface, no backend effect \u2192 surface smoke Tier 1";
+  }
+  if (algo && tier < 2) {
+    return {
+      tier: 2,
+      rationale: `${why}; raised to Tier 2 (E2E floor: Algo* apps never auto-pick surface-smoke-only)`,
+      tier_override: false
+    };
+  }
+  return { tier, rationale: why, tier_override: false };
+}
+function tierLabel(tier) {
+  return {
+    1: "Tier 1 \u2014 surface & navigation smoke",
+    2: "Tier 2 \u2014 E2E with verified results",
+    3: "Tier 3 \u2014 real-time monitor / sentinel",
+    4: "Tier 4 \u2014 source-grounded governed-fact verification"
+  }[tier] || `Tier ${tier}`;
+}
+var LEGAL_PRODUCTS, LEGAL_IMPORT_RE, GENERATIVE_RE, GENERATIVE_CALLABLE_RE, MONEY_OR_SAFETY_RE;
+var init_auto_tier = __esm({
+  "../../scripts/virtual-office/test-gen/auto-tier.mjs"() {
+    "use strict";
+    LEGAL_PRODUCTS = /* @__PURE__ */ new Set(["algotax", "algolaw", "algoteach", "algolegal"]);
+    LEGAL_IMPORT_RE = /functions-core-(tax|law)|cornell|irs|\bstatute\b/i;
+    GENERATIVE_RE = /@google\/generative-ai|@anthropic|anthropic|openai|@google\/genai|consensus|\bllm\b/i;
+    GENERATIVE_CALLABLE_RE = /generate|summari[sz]e|\bai\b|consensus|draft|classify/i;
+    MONEY_OR_SAFETY_RE = /grade|payment|transfer|trade|charge|refund|payout|disburse|withdraw|remit/i;
+  }
+});
+
+// ../../scripts/virtual-office/test-gen/dispatch.mjs
+import { spawnSync as spawnSync10 } from "node:child_process";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+import path14 from "node:path";
+function buildGenerationPrompt({ contract = {}, tier }) {
+  const label = tierLabel(tier);
+  const target = contract.callable ? `the \`${contract.callable}\` callable` : contract.route ? `the \`${contract.route}\` route` : contract.feature_name || "the feature";
+  return [
+    `Write a ${label} test for ${target} in product "${contract.product || "unknown"}".`,
+    contract.source_file ? `Source: ${contract.source_file}.` : "",
+    contract.expected_behavior ? `Expected behavior: ${contract.expected_behavior}.` : "",
+    "",
+    `TIER REQUIREMENT \u2014 ${TIER_GUIDANCE[tier] || TIER_GUIDANCE[2]}`,
+    "",
+    "Follow the AlgoSuite test-honesty standard: NO fake-green (no bare toBeTruthy, no broad",
+    "try/catch that swallows failures, no treating INVALID_ARGUMENT / empty / null / SKIP as a",
+    "pass). Use a real fixture (smoke@algosuite.ai) and real data shapes.",
+    "",
+    "After writing the test, it will be GATED server-side: deterministic ratchets, then",
+    "multi-model consensus that it proves the behavior with VERIFIED-CORRECT expected values.",
+    "A test that does not pass BOTH gates will NOT ship \u2014 so make the assertions real and the",
+    "expected values known-correct. Leave the test file UNCOMMITTED; the runner opens the PR."
+  ].filter((l) => l !== "").join("\n");
+}
+function planTestGenDispatch({ contract = {} }) {
+  const { tier, rationale } = classifyTier(contract);
+  return {
+    contract,
+    tier,
+    tier_label: tierLabel(tier),
+    tier_rationale: rationale,
+    generation_prompt: buildGenerationPrompt({ contract, tier })
+  };
+}
+function buildTestGenTaskPrompt(dispatch = {}) {
+  const contractJson = JSON.stringify(dispatch.contract ?? {});
+  return `${TEST_GEN_MARKER} ${contractJson}
+
+${dispatch.generation_prompt ?? ""}`;
+}
+function pickNextTarget({ gaps = [] }) {
+  if (!Array.isArray(gaps) || gaps.length === 0) return null;
+  const ranked = [...gaps].sort((a, b) => {
+    const al = LEGAL.has(String(a.product)) ? 0 : 1;
+    const bl = LEGAL.has(String(b.product)) ? 0 : 1;
+    return al - bl;
+  });
+  return ranked[0];
+}
+function resolveRepo(argv, env2) {
+  const repoArg = argv.indexOf("--repo");
+  if (repoArg >= 0 && argv[repoArg + 1]) return argv[repoArg + 1];
+  if (env2.VO_TEST_GEN_REPO) return env2.VO_TEST_GEN_REPO;
+  const remote = spawnSync10("git", ["remote", "get-url", "origin"], { encoding: "utf8" });
+  if (remote.status === 0) {
+    const m = String(remote.stdout).trim().match(/[:/]([^/]+\/[^/]+?)(?:\.git)?$/);
+    if (m) return m[1];
+  }
+  return null;
+}
+async function main(argv = process.argv.slice(2)) {
+  const countArg = argv.indexOf("--count");
+  const count3 = countArg >= 0 ? Math.max(1, Number(argv[countArg + 1]) || 1) : 1;
+  const enqueue = argv.includes("--enqueue");
+  const here = path14.dirname(fileURLToPath3(import.meta.url));
+  const scan = spawnSync10("node", [path14.join(here, "coverage-scan.mjs"), "--limit", String(count3 * 8)], {
+    encoding: "utf8",
+    maxBuffer: 64 * 1024 * 1024
+  });
+  if (scan.status !== 0) {
+    console.error(`[dispatch] coverage-scan failed: ${scan.stderr || scan.stdout}`);
+    process.exit(1);
+  }
+  let gaps = [];
+  try {
+    gaps = JSON.parse(scan.stdout).gaps || [];
+  } catch (err) {
+    console.error(`[dispatch] could not parse scan output: ${err.message}`);
+    process.exit(1);
+  }
+  const dispatches = [];
+  const seen = /* @__PURE__ */ new Set();
+  let pool = gaps;
+  while (dispatches.length < count3 && pool.length > 0) {
+    const target = pickNextTarget({ gaps: pool });
+    if (!target) break;
+    const key = `${target.product}:${target.callable}`;
+    if (!seen.has(key)) {
+      seen.add(key);
+      dispatches.push(planTestGenDispatch({ contract: target }));
+    }
+    pool = pool.filter((g) => `${g.product}:${g.callable}` !== key);
+  }
+  if (!enqueue) {
+    console.log(JSON.stringify({ requested: count3, emitted: dispatches.length, dispatches }, null, 2));
+    return;
+  }
+  const repo = resolveRepo(argv, process.env);
+  if (!repo) {
+    console.error("[dispatch] --enqueue needs a repo: pass --repo owner/name or set VO_TEST_GEN_REPO (could not derive from git origin)");
+    process.exit(1);
+  }
+  const { createControlPlaneClient: createControlPlaneClient2 } = await Promise.resolve().then(() => (init_control_plane_client(), control_plane_client_exports));
+  const client = createControlPlaneClient2({ env: process.env });
+  const enqueued = [];
+  for (const d of dispatches) {
+    const task = await client.enqueueCodeTask({
+      repo,
+      prompt: buildTestGenTaskPrompt(d),
+      max_turns: 40
+    });
+    const taskId = task && task.code_task_id ? task.code_task_id : "(unknown)";
+    enqueued.push({ task_id: taskId, product: d.contract.product, callable: d.contract.callable, tier: d.tier_label });
+    console.error(`[dispatch] enqueued ${d.tier_label} test-gen for ${d.contract.product}:${d.contract.callable} \u2192 task ${taskId}`);
+  }
+  console.log(JSON.stringify({ requested: count3, enqueued: enqueued.length, repo, tasks: enqueued }, null, 2));
+}
+var TEST_GEN_MARKER, TIER_GUIDANCE, LEGAL, invokedDirectly;
+var init_dispatch = __esm({
+  "../../scripts/virtual-office/test-gen/dispatch.mjs"() {
+    "use strict";
+    init_auto_tier();
+    TEST_GEN_MARKER = "[VO-TEST-GEN]";
+    TIER_GUIDANCE = {
+      1: "Surface/navigation smoke: assert the surface renders and the key controls are present. No backend effect needed.",
+      2: "E2E with VERIFIED RESULTS: drive the real user/callable workflow, then READ BACK the produced artifact and assert KNOWN-CORRECT expected values (not just a 200 / truthiness).",
+      3: "Real-time monitor / sentinel: drive the workflow AND verify the state transitions + safety rails (no money moved / graded / admin action without the guard). Assert the post-conditions, not just the response.",
+      4: "Source-grounded governed-fact: assert expected values that are GROUNDED in the cited authoritative source (the contract's authoritative_source_url). The fixture and the expected number/string must trace to that source."
+    };
+    LEGAL = /* @__PURE__ */ new Set(["algotax", "algolaw", "algoteach", "algolegal"]);
+    invokedDirectly = process.argv[1] && fileURLToPath3(import.meta.url) === path14.resolve(process.argv[1]);
+    if (invokedDirectly) {
+      main().catch((err) => {
+        console.error(`[dispatch] ${err.message}`);
+        process.exit(1);
+      });
+    }
+  }
+});
+
+// ../../scripts/virtual-office/test-gen/executor.mjs
+function consensusQuestion(tier) {
+  const tierAsk = tier >= 4 ? " For this governed-fact (Tier 4) test, the expected values MUST be grounded in the cited authoritative source." : tier >= 3 ? " For this safety-critical (Tier 3) test, it must verify state transitions and the safety rails, not just a 200." : "";
+  return "Does this test PROVE the stated behavior with VERIFIED-CORRECT expected values (not fake-green)? It must exercise the real product path (no stub/mock that bypasses the feature) and assert known-correct values, not placeholders." + tierAsk;
+}
+function buildContractSummary(contract, tier) {
+  const parts = [
+    `Feature: ${contract.feature_name || contract.callable || contract.route || "unnamed"}`,
+    `Product: ${contract.product || "unknown"}`,
+    contract.route ? `Route: ${contract.route}` : "",
+    contract.callable ? `Callable: ${contract.callable}` : "",
+    `Auto-selected tier: ${tierLabel(tier)}`,
+    contract.expected_behavior ? `Expected behavior: ${contract.expected_behavior}` : "",
+    contract.authoritative_source_url ? `Authoritative source: ${contract.authoritative_source_url}` : ""
+  ];
+  return parts.filter(Boolean).join("\n");
+}
+async function gateGeneratedTest({ contract = {}, testSource = "", verify, taskId = "autotest" }) {
+  if (typeof verify !== "function") throw new Error("gateGeneratedTest requires a `verify` transport");
+  const { tier, rationale } = classifyTier(contract);
+  const label = tierLabel(tier);
+  const filename = typeof contract.test_filename === "string" ? contract.test_filename : void 0;
+  const ratchets = await verify({
+    task_id: taskId,
+    gate_type: "ratchets",
+    excerpt: testSource,
+    ...filename ? { context: { filename } } : {}
+  });
+  if (!ratchets || ratchets.approved !== true) {
+    return {
+      ship: false,
+      tier,
+      tierLabel: label,
+      stage: "ratchets",
+      reason: ratchets?.reason || "ratchets gate did not approve",
+      ratchets: ratchets || null,
+      consensus: null
+    };
+  }
+  const consensus = await verify({
+    task_id: taskId,
+    gate_type: CONSENSUS_GATE_TYPE,
+    excerpt: `${buildContractSummary(contract, tier)}
+
+--- TEST ---
+${testSource}`,
+    question: consensusQuestion(tier)
+  });
+  const consensusBlocks = consensus?.available === true && consensus?.approved !== true;
+  if (consensusBlocks) {
+    return {
+      ship: false,
+      tier,
+      tierLabel: label,
+      stage: "consensus",
+      reason: consensus?.reason || "consensus did not confirm verified-correct expected values",
+      ratchets,
+      consensus
+    };
+  }
+  return {
+    ship: true,
+    tier,
+    tierLabel: label,
+    stage: "passed",
+    reason: consensus?.available === true ? `Passed ratchets + consensus (${label}). ${rationale}` : `Passed ratchets; consensus unavailable so not blocking (${label}). ${rationale}`,
+    ratchets,
+    consensus
+  };
+}
+function makeHttpVerify({ baseUrl, token: token2, fetchImpl = fetch }) {
+  if (!baseUrl) throw new Error("makeHttpVerify requires a baseUrl");
+  const url = `${baseUrl.replace(/\/$/, "")}/api/v1/verify`;
+  return async function httpVerify(req) {
+    let res;
+    try {
+      res = await fetchImpl(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...token2 ? { Authorization: `Bearer ${token2}` } : {} },
+        body: JSON.stringify(req)
+      });
+    } catch (err) {
+      return { ok: false, available: false, approved: false, reason: `transport error: ${err?.message || err}` };
+    }
+    let body = {};
+    try {
+      body = await res.json();
+    } catch {
+    }
+    if (!res.ok) {
+      return { ok: false, available: false, approved: false, reason: body?.error || `http ${res.status}` };
+    }
+    return body;
+  };
+}
+var CONSENSUS_GATE_TYPE;
+var init_executor = __esm({
+  "../../scripts/virtual-office/test-gen/executor.mjs"() {
+    "use strict";
+    init_auto_tier();
+    CONSENSUS_GATE_TYPE = "test_correctness_consensus";
+  }
+});
+
+// ../../scripts/virtual-office/code-runner/test-gen-gate.mjs
+import fs7 from "node:fs";
+import path15 from "node:path";
+async function postFailed(client, id, message, result) {
+  try {
+    await client.postProgress(id, {
+      status: "failed",
+      message: String(message).slice(0, 1500),
+      result
+    });
+  } catch {
+  }
+}
+async function gateTestGenTaskOrFail({ client, id, task, files, worktreeDir, env: env2 = process.env, log: log2 = () => {
+}, verify: verifyInjected } = {}) {
+  const prompt = String(task && task.prompt || "");
+  if (!prompt.startsWith(TEST_GEN_MARKER)) return false;
+  let contract;
+  try {
+    const after = prompt.slice(TEST_GEN_MARKER.length).trimStart();
+    contract = JSON.parse(after.split("\n\n")[0]);
+  } catch (err) {
+    log2(`task ${id}: test-gen contract parse failed: ${err.message}`);
+    await postFailed(client, id, `test-gen contract parse failed: ${err.message}`, "gate_contract_unparseable");
+    return true;
+  }
+  const testFile = (files || []).find((f) => TEST_FILE_RE.test(f));
+  if (!testFile) {
+    await postFailed(client, id, "test-gen task produced no *.test.* file", "gate_no_test_file");
+    return true;
+  }
+  const baseUrl = env2.VO_MOAT_PLANE_URL;
+  if (!verifyInjected && !baseUrl) {
+    log2(`task ${id}: VO_MOAT_PLANE_URL unset \u2014 skipping test-gen gate (fail-safe, ADR-002 opt-out)`);
+    return false;
+  }
+  let testSource = "";
+  try {
+    testSource = fs7.readFileSync(path15.join(worktreeDir, testFile), "utf8");
+  } catch (err) {
+    await postFailed(client, id, `could not read generated test ${testFile}: ${err.message}`, "gate_test_unreadable");
+    return true;
+  }
+  const verify = verifyInjected || makeHttpVerify({ baseUrl: String(baseUrl).replace(/\/$/, ""), token: env2.VO_MOAT_PLANE_TOKEN || "" });
+  let verdict;
+  try {
+    verdict = await gateGeneratedTest({
+      contract: { ...contract, test_filename: testFile },
+      testSource,
+      verify,
+      taskId: id
+    });
+  } catch (err) {
+    log2(`task ${id}: test-gen gate could not run: ${err.message}`);
+    await postFailed(client, id, `test-gen gate could not run (${err.message}) \u2014 not shipping un-gated`, "gate_transport_error");
+    return true;
+  }
+  if (!verdict.ship) {
+    log2(`task ${id}: test-gen gate REJECTED at ${verdict.stage}`);
+    await postFailed(
+      client,
+      id,
+      `test-gen gate rejected (${verdict.stage}): ${verdict.reason || "did not pass ratchets + consensus"}`,
+      "gate_rejected"
+    );
+    return true;
+  }
+  try {
+    await client.postProgress(id, {
+      message: `test-gen gate PASSED (${verdict.tierLabel || "tier"}): ${verdict.reason || "ratchets + consensus"}`
+    });
+  } catch {
+  }
+  return false;
+}
+var TEST_FILE_RE;
+var init_test_gen_gate = __esm({
+  "../../scripts/virtual-office/code-runner/test-gen-gate.mjs"() {
+    "use strict";
+    init_dispatch();
+    init_executor();
+    TEST_FILE_RE = /\.(test|spec)\.(ts|tsx|mjs|js)$/;
+  }
+});
+
+// ../../scripts/virtual-office/code-runner/completion-gate.mjs
+import { execFile } from "node:child_process";
+import fs8 from "node:fs";
+import path16 from "node:path";
+function resolveCompletionGate(task) {
+  const raw = task?.completion_gate;
+  if (raw === void 0 || raw === null) return null;
+  if (typeof raw !== "string" || raw.trim() === "") {
+    return { invalid: true, reason: "completion_gate must be a non-empty string" };
+  }
+  const trimmed = raw.trim();
+  if (trimmed.length > 500) {
+    return { invalid: true, reason: "completion_gate exceeds 500 characters" };
+  }
+  if (SHELL_METACHARACTERS.test(trimmed)) {
+    return { invalid: true, reason: "completion_gate contains shell metacharacters (no-shell contract: plain argv only, no pipes/redirects/quotes)" };
+  }
+  const [command, ...args] = trimmed.split(/\s+/);
+  const allowedCommand = ALLOWED_GATE_COMMANDS.get(command);
+  if (allowedCommand === void 0) {
+    const shown = command.length > 40 ? `${command.slice(0, 40)}...` : command;
+    return {
+      invalid: true,
+      reason: `completion_gate command ${shown} is not an allowed gate runner (${[...ALLOWED_GATE_COMMANDS.keys()].join(", ")})`
+    };
+  }
+  return { argv: [allowedCommand, ...args] };
+}
+function boundedTail(text) {
+  const s = String(text ?? "");
+  return s.length <= COMPLETION_GATE_OUTPUT_CAP ? s : s.slice(s.length - COMPLETION_GATE_OUTPUT_CAP);
+}
+function workspaceFingerprint(worktreeDir, execFileImpl = execFile) {
+  return new Promise((resolve2) => {
+    execFileImpl("git", ["rev-parse", "HEAD^{tree}"], { cwd: worktreeDir }, (err, stdout) => {
+      resolve2(err ? null : String(stdout).trim() || null);
+    });
+  });
+}
+function readState(worktreeDir) {
+  try {
+    return JSON.parse(fs8.readFileSync(path16.join(worktreeDir, COMPLETION_GATE_STATE_FILE), "utf8"));
+  } catch {
+    return null;
+  }
+}
+function writeState(worktreeDir, state) {
+  try {
+    fs8.writeFileSync(path16.join(worktreeDir, COMPLETION_GATE_STATE_FILE), `${JSON.stringify(state)}
+`, "utf8");
+  } catch {
+  }
+}
+function runGateCommand({ argv, worktreeDir, timeoutMs = COMPLETION_GATE_TIMEOUT_MS, execFileImpl = execFile }) {
+  return new Promise((resolve2) => {
+    const command = ALLOWED_GATE_COMMANDS.get(argv?.[0]);
+    if (command === void 0) {
+      return resolve2({
+        exitCode: 1,
+        output: `completion_gate executable is not an allowed gate runner (${[...ALLOWED_GATE_COMMANDS.keys()].join(", ")})`,
+        timedOut: false
+      });
+    }
+    execFileImpl(
+      command,
+      argv.slice(1),
+      { cwd: worktreeDir, timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024, windowsHide: true },
+      (err, stdout, stderr) => {
+        const output = boundedTail(`${stdout ?? ""}
+${stderr ?? ""}`.trim());
+        if (!err) return resolve2({ exitCode: 0, output, timedOut: false });
+        const timedOut = err.killed === true || err.signal === "SIGTERM";
+        const exitCode = typeof err.code === "number" ? err.code : 1;
+        resolve2({ exitCode, output: output || boundedTail(err.message), timedOut });
+      }
+    );
+  });
+}
+async function postFailed2(client, id, message, result) {
+  try {
+    await client.postProgress(id, { status: "failed", message: String(message).slice(0, 1500), result });
+  } catch {
+  }
+}
+function messageExcerpt(output) {
+  const s = String(output ?? "");
+  return s.length > 1200 ? `...${s.slice(-1200)}` : s;
+}
+async function enforceCompletionGateOrFail({ client, id, task, worktreeDir, log: log2 = () => {
+}, execFileImpl = execFile } = {}) {
+  const resolved = resolveCompletionGate(task);
+  if (resolved === null) return false;
+  if (resolved.invalid) {
+    log2(`task ${id}: completion_gate invalid \u2014 ${resolved.reason}`);
+    await postFailed2(client, id, `completion_gate invalid (${resolved.reason}) \u2014 failing closed, not publishing`, "completion_gate_invalid");
+    return true;
+  }
+  const fingerprint = await workspaceFingerprint(worktreeDir, execFileImpl);
+  const cached2 = readState(worktreeDir);
+  if (fingerprint && cached2 && cached2.fingerprint === fingerprint && cached2.exitCode !== 0) {
+    log2(`task ${id}: completion gate skip-on-unchanged (tree ${fingerprint.slice(0, 12)}) \u2014 reusing recorded failure exit ${cached2.exitCode}`);
+    await postFailed2(client, id, `completion gate '${task.completion_gate}' previously failed (exit ${cached2.exitCode}) and the workspace is unchanged:
+${messageExcerpt(cached2.output)}`, "completion_gate_failed");
+    return true;
+  }
+  log2(`task ${id}: running completion gate: ${resolved.argv.join(" ")}`);
+  const outcome = await runGateCommand({ argv: resolved.argv, worktreeDir, execFileImpl });
+  if (fingerprint) writeState(worktreeDir, { fingerprint, exitCode: outcome.exitCode, output: outcome.output, at: (/* @__PURE__ */ new Date()).toISOString() });
+  if (outcome.exitCode === 0) {
+    log2(`task ${id}: completion gate PASSED`);
+    return false;
+  }
+  const kind = outcome.timedOut ? `timed out after ${COMPLETION_GATE_TIMEOUT_MS}ms` : `exited ${outcome.exitCode}`;
+  log2(`task ${id}: completion gate FAILED (${kind}) \u2014 not publishing`);
+  await postFailed2(client, id, `completion gate '${task.completion_gate}' ${kind} \u2014 task may not claim completion:
+${messageExcerpt(outcome.output)}`, "completion_gate_failed");
+  return true;
+}
+var COMPLETION_GATE_TIMEOUT_MS, COMPLETION_GATE_OUTPUT_CAP, COMPLETION_GATE_STATE_FILE, SHELL_METACHARACTERS, ALLOWED_GATE_COMMANDS;
+var init_completion_gate = __esm({
+  "../../scripts/virtual-office/code-runner/completion-gate.mjs"() {
+    "use strict";
+    COMPLETION_GATE_TIMEOUT_MS = 5 * 6e4;
+    COMPLETION_GATE_OUTPUT_CAP = 8 * 1024;
+    COMPLETION_GATE_STATE_FILE = ".vo-completion-gate-state.json";
+    SHELL_METACHARACTERS = /[|&;<>$`(){}[\]*?~#\\'"]/;
+    ALLOWED_GATE_COMMANDS = new Map(
+      ["pnpm", "npm", "yarn", "node", "git", "make", "python", "python3", "cargo", "go"].map((name) => [name, name])
+    );
+  }
+});
+
 // ../../scripts/virtual-office/code-runner/process-runner.mjs
 import { spawn as spawn3 } from "node:child_process";
 function buildStepLabel(cmd, args = []) {
@@ -6232,8 +7082,8 @@ var init_publish_async = __esm({
 
 // ../../scripts/virtual-office/code-runner/skill-catalog.mjs
 import { readdirSync as readdirSync2, readFileSync as readFileSync3, statSync } from "node:fs";
-import { dirname as dirname2, join as join3 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { dirname as dirname3, join as join4 } from "node:path";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
 function parseFrontmatterNameDescription(raw) {
   const text = String(raw).replace(/\r\n/g, "\n");
   if (!text.startsWith("---\n")) return null;
@@ -6252,15 +7102,15 @@ function parseFrontmatterNameDescription(raw) {
   return name && description ? { name, description } : null;
 }
 function resolveDefaultRepoRoot() {
-  const starts = [dirname2(fileURLToPath2(import.meta.url)), process.cwd()];
+  const starts = [dirname3(fileURLToPath4(import.meta.url)), process.cwd()];
   for (const start of starts) {
     let dir = start;
     for (let i = 0; i < 8; i += 1) {
       try {
-        if (statSync(join3(dir, ".claude", "skills")).isDirectory()) return dir;
+        if (statSync(join4(dir, ".claude", "skills")).isDirectory()) return dir;
       } catch {
       }
-      const parent = dirname2(dir);
+      const parent = dirname3(dir);
       if (parent === dir) break;
       dir = parent;
     }
@@ -6269,14 +7119,14 @@ function resolveDefaultRepoRoot() {
 }
 function loadSkillCatalog({ repoRoot: repoRoot2 = resolveDefaultRepoRoot() } = {}) {
   try {
-    const skillsDir = join3(repoRoot2, ".claude", "skills");
+    const skillsDir = join4(repoRoot2, ".claude", "skills");
     const catalog = [];
     for (const entry of readdirSync2(skillsDir)) {
-      const dir = join3(skillsDir, entry);
+      const dir = join4(skillsDir, entry);
       try {
         if (!statSync(dir).isDirectory()) continue;
         const parsed = parseFrontmatterNameDescription(
-          readFileSync3(join3(dir, "SKILL.md"), "utf8")
+          readFileSync3(join4(dir, "SKILL.md"), "utf8")
         );
         if (parsed) catalog.push(parsed);
       } catch {
@@ -6505,10 +7355,10 @@ var init_task_prompt = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/task-attachments.mjs
-import { createHash as createHash3, randomUUID } from "node:crypto";
+import { createHash as createHash3, randomUUID as randomUUID2 } from "node:crypto";
 import { chmod, mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
 import os2 from "node:os";
-import path13 from "node:path";
+import path17 from "node:path";
 function safeTaskToken(taskId) {
   return String(taskId || "task").replace(/[^0-9A-Za-z_-]/gu, "_").slice(0, 48) || "task";
 }
@@ -6518,25 +7368,25 @@ function sanitizeTaskAttachmentName(name, index = 0) {
   return `${String(index + 1).padStart(2, "0")}-${normalized}`;
 }
 function assertGeneratedDirectory(directory, tempRoot) {
-  const resolvedDirectory = path13.resolve(directory);
-  const resolvedRoot = path13.resolve(tempRoot);
-  if (path13.dirname(resolvedDirectory) !== resolvedRoot || !path13.basename(resolvedDirectory).startsWith(DIRECTORY_PREFIX)) {
+  const resolvedDirectory = path17.resolve(directory);
+  const resolvedRoot = path17.resolve(tempRoot);
+  if (path17.dirname(resolvedDirectory) !== resolvedRoot || !path17.basename(resolvedDirectory).startsWith(DIRECTORY_PREFIX)) {
     throw new Error("refusing to clean an unverified task-attachment directory");
   }
   return resolvedDirectory;
 }
 async function createAttachmentDirectory(taskId, tempRoot) {
-  const root = path13.resolve(tempRoot);
+  const root = path17.resolve(tempRoot);
   await mkdir(root, { recursive: true });
-  const directory = await mkdtemp(path13.join(root, `${DIRECTORY_PREFIX}${safeTaskToken(taskId)}-`));
-  const marker = JSON.stringify({ owner: MARKER_OWNER, token: randomUUID(), directory: path13.basename(directory), created_at: (/* @__PURE__ */ new Date()).toISOString() });
-  await writeFile(path13.join(directory, MARKER_FILE), marker, { encoding: "utf8", mode: 384 });
+  const directory = await mkdtemp(path17.join(root, `${DIRECTORY_PREFIX}${safeTaskToken(taskId)}-`));
+  const marker = JSON.stringify({ owner: MARKER_OWNER, token: randomUUID2(), directory: path17.basename(directory), created_at: (/* @__PURE__ */ new Date()).toISOString() });
+  await writeFile(path17.join(directory, MARKER_FILE), marker, { encoding: "utf8", mode: 384 });
   return { directory, marker, tempRoot: root };
 }
 async function cleanupGeneratedDirectory(state) {
   if (!state || state.cleaned) return;
   const directory = assertGeneratedDirectory(state.directory, state.tempRoot);
-  const marker = await readFile(path13.join(directory, MARKER_FILE), "utf8").catch(() => "");
+  const marker = await readFile(path17.join(directory, MARKER_FILE), "utf8").catch(() => "");
   if (marker !== state.marker) throw new Error("refusing to clean a task-attachment directory without its exact marker");
   await rm(directory, { recursive: true, force: true });
   state.cleaned = true;
@@ -6555,7 +7405,7 @@ async function sweepStaleTaskAttachmentDirectories({
   now = Date.now(),
   maxAgeMs = DEFAULT_STALE_AGE_MS
 } = {}) {
-  const root = path13.resolve(tempRoot);
+  const root = path17.resolve(tempRoot);
   if (!Number.isFinite(maxAgeMs) || maxAgeMs <= 0) throw new Error("stale attachment age must be positive");
   const entries = await readdir(root, { withFileTypes: true }).catch((error) => {
     if (error?.code === "ENOENT") return [];
@@ -6564,8 +7414,8 @@ async function sweepStaleTaskAttachmentDirectories({
   let removed = 0;
   for (const entry of entries) {
     if (!entry.isDirectory() || !entry.name.startsWith(DIRECTORY_PREFIX)) continue;
-    const directory = assertGeneratedDirectory(path13.join(root, entry.name), root);
-    const markerRaw = await readFile(path13.join(directory, MARKER_FILE), "utf8").catch(() => "");
+    const directory = assertGeneratedDirectory(path17.join(root, entry.name), root);
+    const markerRaw = await readFile(path17.join(directory, MARKER_FILE), "utf8").catch(() => "");
     const marker = parseOwnedMarker(markerRaw, entry.name);
     if (!marker) continue;
     const directoryStat = await stat(directory);
@@ -6608,10 +7458,10 @@ async function materializeTaskAttachments(client, task, { tempRoot = os2.tmpdir(
       const sha256 = createHash3("sha256").update(content).digest("hex");
       if (sha256 !== ref.sha256) throw new Error(`attachment ${ref.attachment_id} sha256 mismatch`);
       const name = sanitizeTaskAttachmentName(ref.name, index);
-      const filePath = path13.join(state.directory, name);
+      const filePath = path17.join(state.directory, name);
       await writeFile(filePath, content, { flag: "wx", mode: 384 });
       await chmod(filePath, 384);
-      files.push({ attachmentId: ref.attachment_id, name, mime: ref.mime, sizeBytes: ref.size_bytes, sha256, path: path13.resolve(filePath) });
+      files.push({ attachmentId: ref.attachment_id, name, mime: ref.mime, sizeBytes: ref.size_bytes, sha256, path: path17.resolve(filePath) });
     }
     return { directory: state.directory, files, manifestMarkdown: buildManifest(files), cleanup: () => cleanupGeneratedDirectory(state) };
   } catch (error) {
@@ -6633,8 +7483,8 @@ var init_task_attachments = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/session-spool-forwarder.mjs
-import { homedir as homedir3 } from "node:os";
-import { join as join4 } from "node:path";
+import { homedir as homedir4 } from "node:os";
+import { join as join5 } from "node:path";
 import { readdir as readdir2, readFile as readFile2, unlink, writeFile as writeFile2 } from "node:fs/promises";
 import { createHash as createHash4 } from "node:crypto";
 function deriveUuid(seed) {
@@ -6666,18 +7516,18 @@ async function readSpool(spoolDir = SPOOL_DIR) {
   for (const f of files) {
     if (!f.endsWith(".json")) continue;
     try {
-      const record = JSON.parse(await readFile2(join4(spoolDir, f), "utf8"));
+      const record = JSON.parse(await readFile2(join5(spoolDir, f), "utf8"));
       if (record && typeof record.session_key === "string") {
-        out.push({ full: join4(spoolDir, f), record });
+        out.push({ full: join5(spoolDir, f), record });
       }
     } catch {
     }
   }
   return out;
 }
-async function readCloudMap(path19) {
+async function readCloudMap(path23) {
   try {
-    return JSON.parse(await readFile2(path19, "utf8"));
+    return JSON.parse(await readFile2(path23, "utf8"));
   } catch {
     return {};
   }
@@ -6750,8 +7600,8 @@ var SPOOL_DIR, CLOUD_MAP_FILE, STALE_MS, ACTIVE_SILENCE_MS;
 var init_session_spool_forwarder = __esm({
   "../../scripts/virtual-office/code-runner/session-spool-forwarder.mjs"() {
     "use strict";
-    SPOOL_DIR = join4(homedir3(), ".vo", "session-spool");
-    CLOUD_MAP_FILE = join4(homedir3(), ".vo", "session-cloud-map.json");
+    SPOOL_DIR = join5(homedir4(), ".vo", "session-spool");
+    CLOUD_MAP_FILE = join5(homedir4(), ".vo", "session-cloud-map.json");
     STALE_MS = 60 * 60 * 1e3;
     ACTIVE_SILENCE_MS = 10 * 60 * 1e3;
   }
@@ -6822,7 +7672,7 @@ var init_rate_limit_resume_scheduler_core = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/rate-limit-resume-scheduler.mjs
-import { dirname as dirname3, join as join5, resolve } from "node:path";
+import { dirname as dirname4, join as join6, resolve } from "node:path";
 function defaultLog(message) {
   console.log(`[rate-limit-scheduler ${(/* @__PURE__ */ new Date()).toISOString()}] ${message}`);
 }
@@ -6904,7 +7754,7 @@ async function runLockedScheduler({
 async function runScheduler({
   env: env2 = process.env,
   queuePath = resumeQueuePath(),
-  attemptsPath = join5(dirname3(queuePath), "resume-attempts.json"),
+  attemptsPath = join6(dirname4(queuePath), "resume-attempts.json"),
   client,
   now,
   log: log2 = defaultLog
@@ -7196,7 +8046,7 @@ var init_runner_capacity = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/agent-auth-probe-process.mjs
-import { fileURLToPath as fileURLToPath3 } from "node:url";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
 async function probeAgentInChild(agent, timeoutMs) {
   const stdout = await runProcess2(process.execPath, [probeCli, agent], {
     timeout: timeoutMs,
@@ -7209,7 +8059,7 @@ var init_agent_auth_probe_process = __esm({
   "../../scripts/virtual-office/code-runner/agent-auth-probe-process.mjs"() {
     "use strict";
     init_process_runner2();
-    probeCli = fileURLToPath3(new URL("./agent-auth-probe-cli.mjs", import.meta.url));
+    probeCli = fileURLToPath5(new URL("./agent-auth-probe-cli.mjs", import.meta.url));
   }
 });
 
@@ -7434,7 +8284,7 @@ var init_local_model_remote_config = __esm({
 
 // ../../scripts/virtual-office/code-runner/account-usage/shared.mjs
 import crypto from "node:crypto";
-import fs6 from "node:fs";
+import fs9 from "node:fs";
 function accountKey(agent, rawId) {
   const id = typeof rawId === "string" ? rawId.trim() : "";
   if (!id) return null;
@@ -7498,7 +8348,7 @@ var init_shared = __esm({
     };
     readJson = (p) => {
       try {
-        return JSON.parse(fs6.readFileSync(p, "utf8"));
+        return JSON.parse(fs9.readFileSync(p, "utf8"));
       } catch {
         return null;
       }
@@ -7508,9 +8358,9 @@ var init_shared = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/account-usage/claude.mjs
-import fs7 from "node:fs";
+import fs10 from "node:fs";
 import os3 from "node:os";
-import path14 from "node:path";
+import path18 from "node:path";
 function fileCaptureTime(filePath, explicit, statFn) {
   if (typeof explicit === "string" && explicit) return explicit;
   try {
@@ -7524,7 +8374,7 @@ function usageBaseUrl(env2 = process.env) {
   return String(raw).replace(/\/+$/, "");
 }
 function readOAuthToken({ homeDir = os3.homedir(), read = readJson, now = Date.now() } = {}) {
-  const creds = read(path14.join(homeDir, ".claude", ".credentials.json"));
+  const creds = read(path18.join(homeDir, ".claude", ".credentials.json"));
   const oauth = creds && typeof creds === "object" ? creds.claudeAiOauth : null;
   if (!oauth || typeof oauth !== "object") return null;
   const token2 = typeof oauth.accessToken === "string" ? oauth.accessToken.trim() : "";
@@ -7534,7 +8384,7 @@ function readOAuthToken({ homeDir = os3.homedir(), read = readJson, now = Date.n
   return token2;
 }
 function readAccountId({ homeDir = os3.homedir(), read = readJson } = {}) {
-  const cfg = read(path14.join(homeDir, ".claude.json"));
+  const cfg = read(path18.join(homeDir, ".claude.json"));
   const account = cfg && typeof cfg === "object" ? cfg.oauthAccount : null;
   return account && typeof account.accountUuid === "string" ? account.accountUuid : null;
 }
@@ -7627,7 +8477,7 @@ async function readClaudeOAuthUsage({
 function readClaudeFileUsage({
   homeDir = os3.homedir(),
   read: rawRead = readJson,
-  statFn = fs7.statSync,
+  statFn = fs10.statSync,
   now = () => Date.now()
 } = {}) {
   const read = (p) => {
@@ -7644,7 +8494,7 @@ function readClaudeFileUsage({
     if (age === null || age > MAX_FILE_AGE_MS) return null;
     return row;
   };
-  const statusPath = path14.join(homeDir, ".claude", "claude-usage.json");
+  const statusPath = path18.join(homeDir, ".claude", "claude-usage.json");
   const status = read(statusPath);
   if (status && (status.seven_day || status.five_hour)) {
     const row = fresh(makeUsageRow({
@@ -7659,7 +8509,7 @@ function readClaudeFileUsage({
     }));
     if (row) return row;
   }
-  const weeklyPath = path14.join(homeDir, ".claude", "claude-weekly-usage.json");
+  const weeklyPath = path18.join(homeDir, ".claude", "claude-weekly-usage.json");
   const weekly = read(weeklyPath);
   if (weekly) {
     const row = fresh(makeUsageRow({
@@ -8098,9 +8948,9 @@ var init_watcher_coordination = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/watcher-state.mjs
-import { randomUUID as randomUUID2 } from "node:crypto";
+import { randomUUID as randomUUID3 } from "node:crypto";
 import { mkdir as mkdir2, open, readFile as readFile3, rename, unlink as unlink2 } from "node:fs/promises";
-import { dirname as dirname4 } from "node:path";
+import { dirname as dirname5 } from "node:path";
 async function readWatcherState(stateFile) {
   let raw;
   try {
@@ -8116,9 +8966,9 @@ async function readWatcherState(stateFile) {
   return parsed;
 }
 async function writeWatcherState(stateFile, state) {
-  const directory = dirname4(stateFile);
+  const directory = dirname5(stateFile);
   await mkdir2(directory, { recursive: true });
-  const temp = `${stateFile}.${process.pid}.${randomUUID2()}.tmp`;
+  const temp = `${stateFile}.${process.pid}.${randomUUID3()}.tmp`;
   let handle;
   try {
     handle = await open(temp, "wx");
@@ -8329,7 +9179,7 @@ var init_pr_watcher_github = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/enqueue-autonomous-code-task.mjs
-import { randomUUID as randomUUID3 } from "node:crypto";
+import { randomUUID as randomUUID4 } from "node:crypto";
 async function enqueueAutonomousCodeTask(client, task, log2 = () => {
 }) {
   const requestedBudgetUsd = task?.max_budget_usd;
@@ -8343,7 +9193,7 @@ async function enqueueAutonomousCodeTask(client, task, log2 = () => {
   if (typeof client?.reserveAutonomousDispatchBudget !== "function" || typeof client?.releaseAutonomousDispatchBudget !== "function") {
     throw new Error("autonomous dispatch admission client unavailable");
   }
-  const reservationId = randomUUID3();
+  const reservationId = randomUUID4();
   const admission = await client.reserveAutonomousDispatchBudget({
     requestedBudgetUsd,
     reservationId,
@@ -8361,8 +9211,8 @@ var init_enqueue_autonomous_code_task = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/pr-watcher.mjs
-import { homedir as homedir4 } from "node:os";
-import { join as join6 } from "node:path";
+import { homedir as homedir5 } from "node:os";
+import { join as join7 } from "node:path";
 function parsePrCiStatus(view) {
   const state = (view && typeof view.state === "string" ? view.state : "UNKNOWN").toUpperCase();
   const rollup = view && Array.isArray(view.statusCheckRollup) ? view.statusCheckRollup : [];
@@ -8705,7 +9555,7 @@ var init_pr_watcher = __esm({
     init_watcher_state();
     init_superseded_pr_source();
     init_ci_fix_prompt();
-    DEFAULT_STATE_FILE = join6(homedir4(), ".vo", "dispatched-prs.json");
+    DEFAULT_STATE_FILE = join7(homedir5(), ".vo", "dispatched-prs.json");
     FAIL_CONCLUSIONS = /* @__PURE__ */ new Set([
       "FAILURE",
       "TIMED_OUT",
@@ -8935,9 +9785,9 @@ function buildControlHandler({ getStatus, requestStop, allowedOrigin }) {
       res.end();
       return;
     }
-    const path19 = String(req.url || "").split("?")[0];
+    const path23 = String(req.url || "").split("?")[0];
     res.setHeader("content-type", "application/json");
-    if (req.method === "GET" && path19 === "/status") {
+    if (req.method === "GET" && path23 === "/status") {
       let status;
       try {
         status = getStatus();
@@ -8948,7 +9798,7 @@ function buildControlHandler({ getStatus, requestStop, allowedOrigin }) {
       res.end(JSON.stringify({ ok: true, ...status }));
       return;
     }
-    if (req.method === "POST" && path19 === "/stop") {
+    if (req.method === "POST" && path23 === "/stop") {
       if (!isControlOriginAllowed(req.headers.origin, allowedOrigin) || !req.headers["x-vo-control"]) {
         res.statusCode = 403;
         res.end(JSON.stringify({ ok: false, error: "forbidden" }));
@@ -9111,18 +9961,35 @@ var init_effort_mode_config = __esm({
 });
 
 // ../../scripts/virtual-office/model-registry.mjs
-import fs8 from "node:fs";
-import path15 from "node:path";
-import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { randomUUID as randomUUID5 } from "node:crypto";
+import fs11 from "node:fs";
+import os4 from "node:os";
+import path19 from "node:path";
+import { fileURLToPath as fileURLToPath6 } from "node:url";
+function userCacheRoot() {
+  try {
+    const home = os4.homedir();
+    if (home) return path19.join(home, ".claude");
+  } catch {
+  }
+  return path19.join(os4.tmpdir(), `vo-model-registry-${randomUUID5()}`);
+}
+function resolveCacheBaseDir(env2 = process.env, moduleDir = __dirname) {
+  if (env2.VO_MODEL_REGISTRY_CACHE_DIR) return env2.VO_MODEL_REGISTRY_CACHE_DIR;
+  if (env2.VO_RUNNER_RUNTIME_ROOT) return env2.VO_RUNNER_RUNTIME_ROOT;
+  const segments = moduleDir.split(path19.sep);
+  const isRepoCheckout = segments.at(-1) === "virtual-office" && segments.at(-2) === "scripts";
+  return isRepoCheckout ? path19.resolve(moduleDir, "..", "..") : userCacheRoot();
+}
 function uniqueModels(models = []) {
   return [...new Set(models.map((model) => String(model || "").trim()).filter(Boolean))];
 }
 function normalizeProvider(value = "") {
-  const lower = String(value || "").trim().toLowerCase();
-  if (lower.includes("anthropic")) return "anthropic";
-  if (lower.includes("openai")) return "openai";
-  if (lower.includes("google") || lower.includes("gemini")) return "google";
-  return lower;
+  const lower2 = String(value || "").trim().toLowerCase();
+  if (lower2.includes("anthropic")) return "anthropic";
+  if (lower2.includes("openai")) return "openai";
+  if (lower2.includes("google") || lower2.includes("gemini")) return "google";
+  return lower2;
 }
 function stripProviderPrefix(id = "") {
   const raw = String(id || "").trim();
@@ -9164,15 +10031,15 @@ function normalizeCatalogModel(model = {}) {
   };
 }
 function parseVersionScore(id = "") {
-  const lower = String(id || "").toLowerCase();
-  const numbers = [...lower.matchAll(/\d+/g)].map((match) => Number(match[0])).filter(Number.isFinite);
+  const lower2 = String(id || "").toLowerCase();
+  const numbers = [...lower2.matchAll(/\d+/g)].map((match) => Number(match[0])).filter(Number.isFinite);
   let score = 0;
   for (let i = 0; i < numbers.length; i++) score += numbers[i] / Math.pow(1e3, i);
-  if (/opus|pro|flagship/.test(lower)) score += 10;
-  if (/sonnet/.test(lower)) score += 5;
-  if (/preview|latest/.test(lower)) score += 0.25;
-  if (/\[1m\]|\(1m\)/i.test(lower)) score += 1;
-  if (/mini|nano|haiku|lite/.test(lower)) score -= 20;
+  if (/opus|pro|flagship/.test(lower2)) score += 10;
+  if (/sonnet/.test(lower2)) score += 5;
+  if (/preview|latest/.test(lower2)) score += 0.25;
+  if (/\[1m\]|\(1m\)/i.test(lower2)) score += 1;
+  if (/mini|nano|haiku|lite/.test(lower2)) score -= 20;
   return score;
 }
 function familyMatches(model, family) {
@@ -9224,9 +10091,9 @@ async function fetchGoogleModels(fetchImpl, env2 = process.env) {
   return (data?.models || []).map((model) => normalizeCatalogModel({ ...model, provider: "google", source: "google" })).filter(Boolean);
 }
 function readCache(cacheFile = DEFAULT_CACHE_FILE, nowMs = Date.now(), ttlMs = DEFAULT_TTL_MS3) {
-  if (!fs8.existsSync(cacheFile)) return null;
+  if (!fs11.existsSync(cacheFile)) return null;
   try {
-    const parsed = JSON.parse(fs8.readFileSync(cacheFile, "utf-8"));
+    const parsed = JSON.parse(fs11.readFileSync(cacheFile, "utf-8"));
     if (nowMs - Number(parsed.checkedAtMs || 0) > ttlMs) return null;
     if (!Array.isArray(parsed.models)) return null;
     return parsed;
@@ -9235,8 +10102,8 @@ function readCache(cacheFile = DEFAULT_CACHE_FILE, nowMs = Date.now(), ttlMs = D
   }
 }
 function writeCache(cacheFile = DEFAULT_CACHE_FILE, payload) {
-  fs8.mkdirSync(path15.dirname(cacheFile), { recursive: true });
-  fs8.writeFileSync(cacheFile, JSON.stringify(payload, null, 2));
+  fs11.mkdirSync(path19.dirname(cacheFile), { recursive: true });
+  fs11.writeFileSync(cacheFile, JSON.stringify(payload, null, 2));
 }
 async function fetchRegistryCatalog({
   fetchImpl = fetch,
@@ -9289,14 +10156,17 @@ async function resolveModelFamily(family, options = {}) {
   const resolved = selectBestFamilyModel(catalog.models || [], family);
   return resolved || def.fallbacks[0];
 }
-var __dirname, ROOT, DEFAULT_CACHE_DIR, DEFAULT_CACHE_FILE, DEFAULT_TTL_MS3, ANTHROPIC_API_VERSION, FAMILY_DEFINITIONS, memoryCache;
+var __dirname, DEFAULT_CACHE_DIR, DEFAULT_CACHE_FILE, DEFAULT_TTL_MS3, ANTHROPIC_API_VERSION, FAMILY_DEFINITIONS, memoryCache;
 var init_model_registry = __esm({
   "../../scripts/virtual-office/model-registry.mjs"() {
     "use strict";
-    __dirname = path15.dirname(fileURLToPath4(import.meta.url));
-    ROOT = path15.resolve(__dirname, "..", "..");
-    DEFAULT_CACHE_DIR = path15.join(ROOT, ".virtual-office-cache", "model-registry");
-    DEFAULT_CACHE_FILE = path15.join(DEFAULT_CACHE_DIR, "catalog.json");
+    __dirname = path19.dirname(fileURLToPath6(import.meta.url));
+    DEFAULT_CACHE_DIR = path19.join(
+      resolveCacheBaseDir(),
+      ".virtual-office-cache",
+      "model-registry"
+    );
+    DEFAULT_CACHE_FILE = path19.join(DEFAULT_CACHE_DIR, "catalog.json");
     DEFAULT_TTL_MS3 = 60 * 60 * 1e3;
     ANTHROPIC_API_VERSION = "2023-06-01";
     FAMILY_DEFINITIONS = {
@@ -9401,17 +10271,17 @@ function modelCompatibleWithAgent(agent, model) {
   if (!model) return true;
   return AGENT_MODEL_COMPATIBILITY[agent]?.(model) ?? false;
 }
-function classifyTier(prompt) {
+function classifyTier2(prompt) {
   const text = String(prompt || "").trim();
   if (!text) return "mid";
-  const lower = text.toLowerCase();
+  const lower2 = text.toLowerCase();
   if (/lint|format|typo|missing import|update deps|chore|maintenance|runner|daemon/.test(
-    lower
+    lower2
   )) {
     return "cheap";
   }
   if (/generate roadmap|new feature|implement .* feature|major refactor|strategic/.test(
-    lower
+    lower2
   ) || text.length > 1500) {
     return "best";
   }
@@ -9432,7 +10302,7 @@ async function resolveModelForTier(tier, { agent = DEFAULT_AGENT2, resolveModelF
   return fallbacks[effectiveTier];
 }
 async function resolveTaskModel(task, { agent = DEFAULT_AGENT2 } = {}) {
-  const tier = task.tier && task.tier !== "auto" ? task.tier : classifyTier(task.prompt);
+  const tier = task.tier && task.tier !== "auto" ? task.tier : classifyTier2(task.prompt);
   const pinned = typeof task.model === "string" ? task.model.trim() : "";
   if (pinned && modelCompatibleWithAgent(normalizeAgent(agent), pinned)) {
     return { tier, model: pinned };
@@ -9904,8 +10774,8 @@ var init_classify_task = __esm({
 
 // ../../scripts/virtual-office/code-runner/auto-router/effort-policy.mjs
 import { readFileSync as readFileSync4 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
-import { join as join7 } from "node:path";
+import { homedir as homedir6 } from "node:os";
+import { join as join8 } from "node:path";
 function difficultyToRung(difficulty, thresholds) {
   const b = thresholds.rungBounds;
   if (difficulty >= b.R5) return "R5";
@@ -9930,9 +10800,9 @@ function operatorTierToRung(tier, difficulty, thresholds) {
   if (tier === "best" && difficulty >= thresholds.rungBounds.R5) return "R5";
   return base;
 }
-function readCodexModelsCache({ path: path19 = DEFAULT_CODEX_MODELS_CACHE, read = readFileSync4 } = {}) {
+function readCodexModelsCache({ path: path23 = DEFAULT_CODEX_MODELS_CACHE, read = readFileSync4 } = {}) {
   try {
-    const parsed = JSON.parse(read(path19, "utf8"));
+    const parsed = JSON.parse(read(path23, "utf8"));
     return Array.isArray(parsed?.models) ? parsed : null;
   } catch {
     return null;
@@ -9982,7 +10852,7 @@ var init_effort_policy = __esm({
     init_meta_model_catalog();
     RUNG_ORDER = ["R1", "R2", "R3", "R4", "R5"];
     rungIndex = (rung) => RUNG_ORDER.indexOf(rung);
-    DEFAULT_CODEX_MODELS_CACHE = join7(homedir5(), ".codex", "models_cache.json");
+    DEFAULT_CODEX_MODELS_CACHE = join8(homedir6(), ".codex", "models_cache.json");
   }
 });
 
@@ -10112,18 +10982,18 @@ var init_role_cost_shadow = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/auto-router/auto-router.mjs
-import { readFileSync as readFileSync5, appendFileSync, mkdirSync as mkdirSync3 } from "node:fs";
-import { homedir as homedir6 } from "node:os";
-import { join as join8, dirname as dirname5 } from "node:path";
-import { fileURLToPath as fileURLToPath5 } from "node:url";
+import { readFileSync as readFileSync5, appendFileSync, mkdirSync as mkdirSync4 } from "node:fs";
+import { homedir as homedir7 } from "node:os";
+import { join as join9, dirname as dirname6 } from "node:path";
+import { fileURLToPath as fileURLToPath7 } from "node:url";
 function getAutoRouterMode(env2 = process.env) {
   const raw = String(env2.VO_CODE_RUNNER_AUTO_ROUTER || "").trim().toLowerCase();
   return MODES.has(raw) ? raw : "off";
 }
 function loadThresholds() {
   if (!cachedThresholds) {
-    const here = dirname5(fileURLToPath5(import.meta.url));
-    cachedThresholds = JSON.parse(readFileSync5(join8(here, "thresholds.json"), "utf8"));
+    const here = dirname6(fileURLToPath7(import.meta.url));
+    cachedThresholds = JSON.parse(readFileSync5(join9(here, "thresholds.json"), "utf8"));
   }
   return cachedThresholds;
 }
@@ -10189,15 +11059,15 @@ function formatDecisionReason(decision, maxLen = 480) {
   const s = `[${decision.routerVersion}] ${decision.taskClass} d=${decision.difficulty} c=${decision.confidence} \u2192 ${decision.rung}/${decision.tier}${decision.effort ? ` effort=${decision.effort}` : ""} turns=${decision.maxTurns} $${decision.maxBudgetUsd}${decision.flags.length ? ` [${decision.flags.join(",")}]` : ""} :: ${decision.reasons.join("; ")}`;
   return s.length > maxLen ? `${s.slice(0, maxLen - 1)}\u2026` : s;
 }
-function appendDecisionFallback(decision, { path: path19 = DECISION_FALLBACK_PATH, append = appendFileSync, mkdir: mkdir4 = mkdirSync3, task, thresholds, roleCostInputs } = {}) {
+function appendDecisionFallback(decision, { path: path23 = DECISION_FALLBACK_PATH, append = appendFileSync, mkdir: mkdir4 = mkdirSync4, task, thresholds, roleCostInputs } = {}) {
   try {
-    mkdir4(dirname5(path19), { recursive: true });
-    append(path19, `${JSON.stringify(decision)}
+    mkdir4(dirname6(path23), { recursive: true });
+    append(path23, `${JSON.stringify(decision)}
 `, "utf8");
     if (isRouterDecision(decision)) {
       try {
         const records = buildShadowRecords({ decision, task, thresholds: thresholds || loadThresholds(), roleCostInputs });
-        for (const record of records) append(path19, `${JSON.stringify(record)}
+        for (const record of records) append(path23, `${JSON.stringify(record)}
 `, "utf8");
       } catch {
       }
@@ -10215,7 +11085,7 @@ var init_auto_router = __esm({
     init_effort_policy();
     init_role_cost_shadow();
     ROUTER_VERSION = "0.1.0";
-    DECISION_FALLBACK_PATH = join8(homedir6(), ".claude", "vo-auto-router-decisions.jsonl");
+    DECISION_FALLBACK_PATH = join9(homedir7(), ".claude", "vo-auto-router-decisions.jsonl");
     MODES = /* @__PURE__ */ new Set(["off", "shadow", "on"]);
     cachedThresholds = null;
     isRouterDecision = (d) => Boolean(d && typeof d === "object" && typeof d.taskClass === "string" && typeof d.confidence === "number");
@@ -11188,9 +12058,9 @@ var init_inference_task_runner = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/isolation-audit.mjs
-import fs9 from "node:fs";
+import fs12 from "node:fs";
 import fsp11 from "node:fs/promises";
-import path16 from "node:path";
+import path20 from "node:path";
 async function defaultRun(command, args, cwd, options = {}) {
   return runProcess2(command, args, { cwd, timeout: 6e4, ...options });
 }
@@ -11203,7 +12073,7 @@ async function canonicalRootForWorktree(worktreeDir, run) {
     "--path-format=absolute",
     "--git-common-dir"
   ])).trim();
-  const root = path16.dirname(commonDir);
+  const root = path20.dirname(commonDir);
   return samePath2(root, worktreeDir) ? null : root;
 }
 async function snapshot(root, run) {
@@ -11245,21 +12115,21 @@ async function changedPaths(root, run) {
 }
 async function quarantineCanonicalWrites({ baseline, worktreeDir, taskId, run, now }) {
   const paths = await changedPaths(baseline.root, run);
-  const quarantineDir = path16.join(
-    path16.dirname(worktreeDir),
+  const quarantineDir = path20.join(
+    path20.dirname(worktreeDir),
     ".canonical-recovery",
     `${String(taskId || "unknown").replace(/[^a-z0-9-]/gi, "-")}-${now().toISOString().replace(/[:.]/g, "-")}`
   );
   await fsp11.mkdir(quarantineDir, { recursive: true });
   const patch = await git2(run, baseline.root, ["diff", "--binary", "HEAD"], { raw: true });
-  await fsp11.writeFile(path16.join(quarantineDir, "tracked.patch"), patch, "utf8");
+  await fsp11.writeFile(path20.join(quarantineDir, "tracked.patch"), patch, "utf8");
   for (const relative of paths.untracked) {
-    const source = path16.join(baseline.root, relative);
-    const target = path16.join(quarantineDir, "untracked", relative);
-    await fsp11.mkdir(path16.dirname(target), { recursive: true });
+    const source = path20.join(baseline.root, relative);
+    const target = path20.join(quarantineDir, "untracked", relative);
+    await fsp11.mkdir(path20.dirname(target), { recursive: true });
     await fsp11.copyFile(source, target);
   }
-  await fsp11.writeFile(path16.join(quarantineDir, "manifest.json"), `${JSON.stringify({
+  await fsp11.writeFile(path20.join(quarantineDir, "manifest.json"), `${JSON.stringify({
     taskId,
     canonicalRoot: baseline.root,
     canonicalHead: baseline.head,
@@ -11281,9 +12151,9 @@ async function restoreExactCanonicalPaths(baseline, evidence, run) {
     ]);
   }
   for (const relative of evidence.untracked) {
-    const target = path16.resolve(baseline.root, relative);
-    const prefix = `${path16.resolve(baseline.root)}${path16.sep}`;
-    if (!target.startsWith(prefix) || !fs9.existsSync(target)) continue;
+    const target = path20.resolve(baseline.root, relative);
+    const prefix = `${path20.resolve(baseline.root)}${path20.sep}`;
+    if (!target.startsWith(prefix) || !fs12.existsSync(target)) continue;
     await fsp11.rm(target, { force: true });
   }
 }
@@ -11319,7 +12189,7 @@ var init_isolation_audit = __esm({
     init_process_runner2();
     splitZ2 = (value) => String(value || "").split("\0").map((item) => item.trim()).filter(Boolean);
     samePath2 = (left, right) => {
-      const [a, b] = [left, right].map((value) => path16.resolve(value));
+      const [a, b] = [left, right].map((value) => path20.resolve(value));
       return process.platform === "win32" ? a.toLowerCase() === b.toLowerCase() : a === b;
     };
   }
@@ -11679,7 +12549,7 @@ var init_publication_outcome = __esm({
 
 // ../../scripts/virtual-office/code-runner/committed-scratch-cleanup.mjs
 import fsp12 from "node:fs/promises";
-import path17 from "node:path";
+import path21 from "node:path";
 function defaultRun2(command, args, cwd, options = {}) {
   return runProcess2(command, args, { cwd, ...options });
 }
@@ -11687,13 +12557,13 @@ async function resolveSafeScratchTarget(worktreeDir, file) {
   if (!isAgentScratch(file)) {
     throw new Error(`refusing to remove non-scratch publication path: ${file}`);
   }
-  const root = path17.resolve(worktreeDir);
-  const target = path17.resolve(root, file);
-  const relative = path17.relative(root, target);
-  if (!relative || relative.startsWith(`..${path17.sep}`) || path17.isAbsolute(relative)) {
+  const root = path21.resolve(worktreeDir);
+  const target = path21.resolve(root, file);
+  const relative = path21.relative(root, target);
+  if (!relative || relative.startsWith(`..${path21.sep}`) || path21.isAbsolute(relative)) {
     throw new Error(`refusing to remove publication scratch outside worktree: ${file}`);
   }
-  for (let cursor = target; cursor !== root; cursor = path17.dirname(cursor)) {
+  for (let cursor = target; cursor !== root; cursor = path21.dirname(cursor)) {
     try {
       if ((await fsp12.lstat(cursor)).isSymbolicLink()) {
         throw new Error(`refusing to follow symlink while removing publication scratch: ${file}`);
@@ -11813,9 +12683,9 @@ var init_publication_scope = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/recovery-ledger.mjs
-import fs10 from "node:fs";
+import fs13 from "node:fs";
 import fsp13 from "node:fs/promises";
-import path18 from "node:path";
+import path22 from "node:path";
 function recoveryTaskId(prompt) {
   const match = String(prompt || "").match(/VO_RECOVERY_FROM_CODE_TASK:\s*([0-9a-f-]{36})/i);
   return match ? match[1].toLowerCase() : null;
@@ -11829,10 +12699,10 @@ function cloneLeaf(repo) {
 function recoveryLedgerCandidates(repo, clonesRoot2) {
   const leaf = cloneLeaf(repo);
   if (!leaf || !clonesRoot2) return [];
-  const canonical = path18.join(clonesRoot2, leaf);
+  const canonical = path22.join(clonesRoot2, leaf);
   return [
-    path18.join(clonesRoot2, ".agent-worktrees", leaf, "recovery-ledger.jsonl"),
-    path18.join(canonical, ".agent-worktrees", "recovery-ledger.jsonl")
+    path22.join(clonesRoot2, ".agent-worktrees", leaf, "recovery-ledger.jsonl"),
+    path22.join(canonical, ".agent-worktrees", "recovery-ledger.jsonl")
   ];
 }
 async function readLedger(file, readFile5) {
@@ -11851,7 +12721,7 @@ async function readLedger(file, readFile5) {
 async function findPreservedRecovery(task, {
   clonesRoot: clonesRoot2 = process.env.VO_CODE_RUNNER_CLONES_ROOT || "",
   readFile: readFile5 = fsp13.readFile,
-  exists = fs10.existsSync
+  exists = fs13.existsSync
 } = {}) {
   const resumedFrom = /^[0-9a-f-]{36}$/iu.test(String(task.resumed_from || "")) ? String(task.resumed_from).toLowerCase() : null;
   const originalTaskId = recoveryTaskId(task.prompt) ?? resumedFrom;
@@ -12165,8 +13035,8 @@ var init_cancellation_probe = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/detached-economics-spool.mjs
-import { homedir as homedir7 } from "node:os";
-import { dirname as dirname6, join as join9 } from "node:path";
+import { homedir as homedir8 } from "node:os";
+import { dirname as dirname7, join as join10 } from "node:path";
 import { mkdir as mkdir3, readFile as readFile4, rename as rename2, writeFile as writeFile3 } from "node:fs/promises";
 function withLock(operation) {
   const result = serialized.then(operation, operation);
@@ -12184,7 +13054,7 @@ async function readEntries(file) {
   }
 }
 async function writeEntries(file, entries) {
-  await mkdir3(dirname6(file), { recursive: true });
+  await mkdir3(dirname7(file), { recursive: true });
   const temp = `${file}.${process.pid}.tmp`;
   await writeFile3(temp, `${JSON.stringify(entries)}
 `, "utf8");
@@ -12230,13 +13100,13 @@ var DEFAULT_FILE, serialized;
 var init_detached_economics_spool = __esm({
   "../../scripts/virtual-office/code-runner/detached-economics-spool.mjs"() {
     "use strict";
-    DEFAULT_FILE = join9(homedir7(), ".vo", "detached-run-economics.json");
+    DEFAULT_FILE = join10(homedir8(), ".vo", "detached-run-economics.json");
     serialized = Promise.resolve();
   }
 });
 
 // ../../scripts/virtual-office/code-runner/killed-run-outcome.mjs
-import { randomUUID as randomUUID4 } from "node:crypto";
+import { randomUUID as randomUUID6 } from "node:crypto";
 async function handleKilledRun({
   client,
   id,
@@ -12273,7 +13143,7 @@ async function handleKilledRun({
     };
   }
   if (reason === "claim_authority_changed") {
-    const occurrenceId = randomUUID4();
+    const occurrenceId = randomUUID6();
     const economics = {
       occurrence_id: occurrenceId,
       runner_id: runnerId,
@@ -12373,13 +13243,13 @@ var init_runner_runtime_limits = __esm({
 });
 
 // ../../scripts/virtual-office/code-runner/daemon-config.mjs
-import os4 from "node:os";
+import os5 from "node:os";
 function loadCodeRunnerConfig(env2 = process.env, { log: log2 = () => {
 } } = {}) {
   const servedOperators = parseList(env2.VO_CODE_RUNNER_OPERATOR_IDS);
   const allowAmbientGithub = env2.VO_CODE_RUNNER_ALLOW_AMBIENT_GH === "1";
   return {
-    runnerId: env2.VO_CODE_RUNNER_ID || `vo-code-runner-${os4.hostname()}`,
+    runnerId: env2.VO_CODE_RUNNER_ID || `vo-code-runner-${os5.hostname()}`,
     ...resolveRunner(env2, { warn: (message) => log2(`agent-select: ${message}`) }),
     permissionMode: env2.VO_CODE_RUNNER_PERMISSION_MODE || "acceptEdits",
     maxConcurrency: Math.max(1, Number(env2.VO_CODE_TASK_MAX_CONCURRENCY || 2) || 2),
@@ -12389,7 +13259,7 @@ function loadCodeRunnerConfig(env2 = process.env, { log: log2 = () => {
     requireGithubAppAuth: !allowAmbientGithub && servedOperators.length > 0,
     allowAmbientGithub,
     sessionForwardSec: Math.max(0, Number(env2.VO_SESSION_FORWARD_SEC ?? 30) || 0),
-    operatorSeed: env2.VO_LOCAL_OPERATOR_SEED || env2.VO_CODE_RUNNER_ID || `local-${os4.hostname()}`,
+    operatorSeed: env2.VO_LOCAL_OPERATOR_SEED || env2.VO_CODE_RUNNER_ID || `local-${os5.hostname()}`,
     cancelPollMs: Math.max(1e3, Number(env2.VO_CODE_RUNNER_CANCEL_POLL_MS || 2500) || 2500),
     maxWallClockMs: resolveMaxWallClockMs(env2.VO_CODE_RUNNER_MAX_WALL_CLOCK_MS),
     watchEnabled: env2.VO_CODE_RUNNER_WATCH !== "0",
@@ -12568,10 +13438,10 @@ var init_task_worktree_preparation = __esm({
 // ../../scripts/virtual-office/code-runner-daemon.mjs
 var code_runner_daemon_exports = {};
 __export(code_runner_daemon_exports, {
-  main: () => main
+  main: () => main2
 });
-import { randomUUID as randomUUID5 } from "node:crypto";
-import { fileURLToPath as fileURLToPath6 } from "node:url";
+import { randomUUID as randomUUID7 } from "node:crypto";
+import { fileURLToPath as fileURLToPath8 } from "node:url";
 function log(msg) {
   console.log(`[code-runner ${(/* @__PURE__ */ new Date()).toISOString()}] ${msg}`);
 }
@@ -12713,16 +13583,12 @@ async function processOneTask(client, task, cfg, runnerInstanceId, swarmAdmissio
       return;
     }
     if (await taskWasCancelled({ client, id, run, safeProgress, log })) return;
+    if (await gateTestGenTaskOrFail({ client, id, task, files, worktreeDir: wt.worktreeDir, log })) return;
+    if (await enforceCompletionGateOrFail({ client, id, task, worktreeDir: wt.worktreeDir, log })) return;
     const publicationTarget = await resolvePublicationTarget({ task, continuationRestore, worktreeDir: wt.worktreeDir, githubToken, allowAmbientGithubFallback: cfg.allowAmbientGithub });
     const localBranch = await resolveOrCreateBranchAsync(wt.worktreeDir, "vo/code-task");
     const publicationBranch = publicationTarget.targetBranch || localBranch;
-    if (!await recordPublicationIntent({
-      client,
-      id,
-      branch: publicationBranch,
-      safeProgress,
-      log
-    })) {
+    if (!await recordPublicationIntent({ client, id, branch: publicationBranch, safeProgress, log })) {
       await reportCancelledRun({ client, id, run, safeProgress, log });
       return;
     }
@@ -12797,10 +13663,10 @@ Closes #${publicationTarget.supersedesPrNumber}` : "";
     }
   }
 }
-async function main({ env: env2 = process.env, once: once2 = false } = {}) {
+async function main2({ env: env2 = process.env, once: once2 = false } = {}) {
   const cfg = loadCodeRunnerConfig(env2, { log });
   await sweepStaleTaskAttachmentDirectories().catch((error) => log(`stale attachment cleanup failed: ${error.message}`));
-  const runnerInstanceId = randomUUID5();
+  const runnerInstanceId = randomUUID7();
   const client = createControlPlaneClient({
     env: env2,
     runnerId: cfg.runnerId,
@@ -12943,7 +13809,7 @@ async function main({ env: env2 = process.env, once: once2 = false } = {}) {
   if (controlServer) controlServer.close();
   log("stopped");
 }
-var RATE_LIMIT_RESUME_ENABLED, sleep2, safeProgress, invokedDirectly;
+var RATE_LIMIT_RESUME_ENABLED, sleep2, safeProgress, invokedDirectly2;
 var init_code_runner_daemon = __esm({
   "../../scripts/virtual-office/code-runner-daemon.mjs"() {
     "use strict";
@@ -12954,6 +13820,8 @@ var init_code_runner_daemon = __esm({
     init_resolve_runner();
     init_rate_limit_resume();
     init_publish();
+    init_test_gen_gate();
+    init_completion_gate();
     init_orphan_agent_reaper();
     init_publish_async();
     init_task_prompt();
@@ -12991,11 +13859,11 @@ var init_code_runner_daemon = __esm({
     RATE_LIMIT_RESUME_ENABLED = process.env.VO_RATE_LIMIT_RESUME !== "0";
     sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
     safeProgress = makeSafeProgress(log);
-    invokedDirectly = process.argv[1] && fileURLToPath6(import.meta.url) === process.argv[1] && // Bundle-safe: self-start only when THIS file is the real entry (not inlined into vo-mcp's runner-cli.js ⇒ double-claim).
+    invokedDirectly2 = process.argv[1] && fileURLToPath8(import.meta.url) === process.argv[1] && // Bundle-safe: self-start only when THIS file is the real entry (not inlined into vo-mcp's runner-cli.js ⇒ double-claim).
     import.meta.url.endsWith("code-runner-daemon.mjs");
-    if (invokedDirectly) {
+    if (invokedDirectly2) {
       const once2 = process.argv.includes("--once");
-      main({ once: once2 }).catch((err) => {
+      main2({ once: once2 }).catch((err) => {
         console.error("[code-runner] fatal:", err);
         process.exit(1);
       });
@@ -13129,6 +13997,98 @@ function pairedOperatorScope(readiness) {
   return readiness?.ok === true && readiness?.paired === true && typeof readiness.operatorId === "string" && readiness.operatorId.trim() ? readiness.operatorId.trim() : null;
 }
 
+// src/runner/root-config.mjs
+import { closeSync, existsSync, mkdirSync, openSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { posix, win32 } from "node:path";
+import { randomUUID } from "node:crypto";
+var APP_IDENTIFIER = "ai.algosuite.vo-runner";
+var CLONES_DIR = "clones";
+function pathsFor(platform) {
+  return platform === "win32" ? win32 : posix;
+}
+function absoluteOrNull(value, pathApi) {
+  const normalized = String(value || "").trim();
+  return normalized && pathApi.isAbsolute(normalized) ? pathApi.resolve(normalized) : null;
+}
+function defaultClonesRoot({
+  platform = process.platform,
+  env: env2 = process.env,
+  home = homedir()
+} = {}) {
+  const pathApi = pathsFor(platform);
+  if (platform === "win32") {
+    const appData = absoluteOrNull(env2.APPDATA, pathApi);
+    return appData ? pathApi.join(appData, APP_IDENTIFIER, CLONES_DIR) : null;
+  }
+  const absoluteHome = absoluteOrNull(home, pathApi);
+  if (!absoluteHome) return null;
+  if (platform === "darwin") {
+    return pathApi.join(absoluteHome, "Library", "Application Support", APP_IDENTIFIER, CLONES_DIR);
+  }
+  const xdg = absoluteOrNull(env2.XDG_CONFIG_HOME, pathApi);
+  return pathApi.join(xdg || pathApi.join(absoluteHome, ".config"), APP_IDENTIFIER, CLONES_DIR);
+}
+function findGitRoot(cwd, { platform, exists = existsSync }) {
+  const pathApi = pathsFor(platform);
+  let cursor = pathApi.resolve(cwd);
+  for (; ; ) {
+    if (exists(pathApi.join(cursor, ".git"))) return cursor;
+    const parent = pathApi.dirname(cursor);
+    if (parent === cursor) return null;
+    cursor = parent;
+  }
+}
+function resolveRunnerRootConfig({
+  env: env2 = process.env,
+  cwd = process.cwd(),
+  platform = process.platform,
+  home = homedir(),
+  exists = existsSync
+} = {}) {
+  const pathApi = pathsFor(platform);
+  const explicitRepoValue = String(env2.VO_CODE_RUNNER_REPO || "").trim();
+  const explicitClonesValue = String(env2.VO_CODE_RUNNER_CLONES_ROOT || "").trim();
+  if (explicitRepoValue && !pathApi.isAbsolute(explicitRepoValue)) {
+    throw new Error(`VO_CODE_RUNNER_REPO must be an absolute path (got '${explicitRepoValue}')`);
+  }
+  if (explicitClonesValue && !pathApi.isAbsolute(explicitClonesValue)) {
+    throw new Error(`VO_CODE_RUNNER_CLONES_ROOT must be an absolute path (got '${explicitClonesValue}')`);
+  }
+  const repoRoot2 = explicitRepoValue ? pathApi.resolve(explicitRepoValue) : findGitRoot(cwd, { platform, exists });
+  const clonesRoot2 = explicitClonesValue ? pathApi.resolve(explicitClonesValue) : repoRoot2 ? null : defaultClonesRoot({ platform, env: env2, home });
+  if (!repoRoot2 && !clonesRoot2) {
+    throw new Error(
+      "No safe runner root is available. Set VO_CODE_RUNNER_REPO or VO_CODE_RUNNER_CLONES_ROOT to an absolute path."
+    );
+  }
+  return { repoRoot: repoRoot2, clonesRoot: clonesRoot2 };
+}
+function runnerWorkingDirectory({ repoRoot: repoRoot2, clonesRoot: clonesRoot2 }) {
+  const root = repoRoot2 || clonesRoot2;
+  if (!root) throw new Error("Runner root configuration has no working directory");
+  return root;
+}
+function assertWritableRunnerDirectory(root) {
+  mkdirSync(root, { recursive: true });
+  const probe = pathsFor(process.platform).join(root, `.vo-runner-write-probe-${process.pid}-${randomUUID()}`);
+  let handle;
+  try {
+    handle = openSync(probe, "wx", 384);
+  } catch (error) {
+    throw new Error(
+      `Runner clones root is not writable: ${root} (${error instanceof Error ? error.message : String(error)})`,
+      { cause: error }
+    );
+  } finally {
+    if (handle !== void 0) closeSync(handle);
+    try {
+      unlinkSync(probe);
+    } catch {
+    }
+  }
+}
+
 // src/runner-cli.mjs
 var DEFAULT_CONTROL_PLANE_URL = "https://vo-control-plane-bzjphrajaq-uc.a.run.app";
 function packageVersion() {
@@ -13143,11 +14103,45 @@ if (process.argv.includes("--version") || process.argv.includes("-v")) {
 `);
   process.exit(0);
 }
+var USAGE = `vo-mcp runner \u2014 bring-your-own agent runner daemon
+
+Usage:
+  vo-mcp runner              poll for tasks forever (default)
+  vo-mcp runner --once       claim + run one task, then exit
+  vo-mcp runner --status     print pairing/readiness JSON, then exit
+  vo-mcp runner --version    print the version, then exit
+  vo-mcp runner --help       print this help, then exit
+
+Env (all optional):
+  VO_CONTROL_PLANE_ADMIN_TOKEN  explicit bearer (wins over the stored credential)
+  VO_CONTROL_PLANE_URL          control-plane base URL (default: production)
+  VO_CODE_RUNNER_REPO           path to your repo clone (default: Git cwd)
+  VO_CODE_RUNNER_CLONES_ROOT    managed clone directory (default outside Git cwd)
+  VO_CODE_RUNNER_OPERATOR_IDS   operator id(s) this runner serves (your own)
+  VO_CODE_RUNNER_REPOS          owner/name repo(s) this runner builds
+
+Pair this computer first with \`vo-mcp login\`.
+`;
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+  process.stdout.write(USAGE);
+  process.exit(0);
+}
 var { readStoredCredential: readStoredCredential2 } = await Promise.resolve().then(() => (init_credential_store(), credential_store_exports));
 var storedCredential = readStoredCredential2();
 var explicitAdminToken = process.env.VO_CONTROL_PLANE_ADMIN_TOKEN?.trim();
 var token = explicitAdminToken || storedCredential?.vo_credential;
 var statusOnly = process.argv.includes("--status");
+function configureRunnerFilesystem() {
+  const config = resolveRunnerRootConfig();
+  if (config.repoRoot) process.env.VO_CODE_RUNNER_REPO = config.repoRoot;
+  else delete process.env.VO_CODE_RUNNER_REPO;
+  if (config.clonesRoot) {
+    assertWritableRunnerDirectory(config.clonesRoot);
+    process.env.VO_CODE_RUNNER_CLONES_ROOT = config.clonesRoot;
+  } else delete process.env.VO_CODE_RUNNER_CLONES_ROOT;
+  process.chdir(runnerWorkingDirectory(config));
+  return config;
+}
 if (statusOnly) {
   if (!storedCredential?.vo_credential) {
     process.stdout.write(`${JSON.stringify({
@@ -13156,6 +14150,7 @@ if (statusOnly) {
       operatorId: null,
       tenantId: null,
       githubReady: null,
+      filesystemReady: null,
       error: "credential_missing",
       message: "This computer is not paired. Pair it to your AlgoHQ account first."
     })}
@@ -13166,9 +14161,28 @@ if (statusOnly) {
     controlPlaneUrl: process.env.VO_CONTROL_PLANE_URL || DEFAULT_CONTROL_PLANE_URL,
     token: storedCredential.vo_credential
   });
-  process.stdout.write(`${JSON.stringify(readiness)}
+  if (!readiness.ok) {
+    process.stdout.write(`${JSON.stringify({ ...readiness, filesystemReady: null })}
 `);
-  process.exit(readiness.ok ? 0 : 1);
+    process.exit(1);
+  }
+  try {
+    configureRunnerFilesystem();
+    process.stdout.write(`${JSON.stringify({ ...readiness, filesystemReady: true })}
+`);
+    process.exit(0);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    process.stdout.write(`${JSON.stringify({
+      ...readiness,
+      ok: false,
+      filesystemReady: false,
+      error: "filesystem_not_ready",
+      message: `Filesystem readiness failed: ${detail}`
+    })}
+`);
+    process.exit(1);
+  }
 }
 if (!token) {
   console.error("[vo-mcp runner] No credential found. Run `vo-mcp login` first.");
@@ -13193,6 +14207,13 @@ if (!explicitAdminToken) {
     process.exit(1);
   }
 }
+var rootConfig;
+try {
+  rootConfig = configureRunnerFilesystem();
+} catch (error) {
+  console.error(`[vo-mcp runner] Filesystem readiness failed: ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+}
 var env = {
   ...process.env,
   VO_CONTROL_PLANE_ADMIN_TOKEN: token,
@@ -13201,15 +14222,16 @@ var env = {
   // VO_CODE_RUNNER_VERSION, which a desktop host may set to its own shell
   // release even after runner-control updates this package in place.
   VO_CODE_RUNNER_DAEMON_VERSION: `vo-mcp/${packageVersion()}`,
-  VO_CODE_RUNNER_REPO: process.env.VO_CODE_RUNNER_REPO || process.cwd(),
+  ...rootConfig.repoRoot ? { VO_CODE_RUNNER_REPO: rootConfig.repoRoot } : {},
+  ...rootConfig.clonesRoot ? { VO_CODE_RUNNER_CLONES_ROOT: rootConfig.clonesRoot } : {},
   // Server-resolved identity replaces stale/hardcoded desktop scope. Besides
   // filtering heartbeat/claims, this keeps GitHub App auth required for the
   // entire task lifecycle (never ambient-gh fallback after a paired preflight).
   ...pairedOperatorId ? { VO_CODE_RUNNER_OPERATOR_IDS: pairedOperatorId } : {}
 };
 var once = process.argv.includes("--once");
-var { main: main2 } = await Promise.resolve().then(() => (init_code_runner_daemon(), code_runner_daemon_exports));
-main2({ env, once }).catch((err) => {
+var { main: main3 } = await Promise.resolve().then(() => (init_code_runner_daemon(), code_runner_daemon_exports));
+main3({ env, once }).catch((err) => {
   console.error("[vo-mcp runner] fatal:", err);
   process.exit(1);
 });