@gethmy/harness 1.4.0 → 1.6.0

package/dist/cli.js

@@ -501,7 +501,6 @@ var init_stageHandoff = __esm(() => {
 
 // ../harmony-shared/dist/types.js
 var init_types = () => {};
-
 // ../harmony-shared/dist/index.js
 var init_dist = __esm(() => {
   init_agentStaleness();
@@ -611,6 +610,492 @@ var init_log = __esm(() => {
   };
 });
 
+// src/confine-to-repo.ts
+import { realpathSync } from "node:fs";
+import { dirname as dirname2, isAbsolute as isAbsolute2, parse, resolve as resolve2, sep as sep2 } from "node:path";
+function isGitMetadata(repoRoot, candidate) {
+  const rel = candidate.startsWith(repoRoot) ? candidate.slice(repoRoot.length) : candidate;
+  return rel.split(/[\\/]/).some((segment) => segment.toLowerCase() === ".git");
+}
+function patternEscapes(pattern) {
+  if (isAbsolute2(pattern))
+    return true;
+  if (/[{}[\]~()!+@]/.test(pattern))
+    return true;
+  return pattern.split(/[\\/]/).some((segment) => segment === "..");
+}
+function pathArgsFor(mode) {
+  return mode === "write" ? { ...READ_PATH_ARGS, ...WRITE_PATH_ARGS } : READ_PATH_ARGS;
+}
+function realPathOrNearest(p) {
+  const abs = isAbsolute2(p) ? p : resolve2(p);
+  const { root } = parse(abs);
+  let real = root;
+  for (const part of abs.slice(root.length).split(sep2)) {
+    if (part === "" || part === ".")
+      continue;
+    if (part === "..") {
+      real = dirname2(real);
+      continue;
+    }
+    const next = real.endsWith(sep2) ? real + part : real + sep2 + part;
+    try {
+      real = realpathSync(next);
+    } catch {
+      real = next;
+    }
+  }
+  return real;
+}
+function isInsideTree(root, target) {
+  const normalizedRoot = realPathOrNearest(root);
+  const normalizedTarget = realPathOrNearest(target);
+  if (normalizedTarget === normalizedRoot)
+    return true;
+  return normalizedTarget.startsWith(normalizedRoot + sep2);
+}
+function decideConfinedTool(repoRoot, toolName, input, mode = "read") {
+  const pathArgs = pathArgsFor(mode)[toolName];
+  if (!pathArgs) {
+    return {
+      behavior: "deny",
+      message: `${toolName} is not available to this run.`
+    };
+  }
+  const verb = toolName in WRITE_PATH_ARGS ? "write" : "read";
+  for (const key of PATTERN_ARG_BY_TOOL[toolName] ?? []) {
+    const value = input[key];
+    if (typeof value !== "string" || value.length === 0)
+      continue;
+    if (patternEscapes(value)) {
+      return {
+        behavior: "deny",
+        message: `${toolName} patterns must stay inside the repository — no absolute path and no "..". Refused: ${value}`
+      };
+    }
+  }
+  for (const key of pathArgs) {
+    const value = input[key];
+    if (typeof value !== "string" || value.length === 0)
+      continue;
+    const candidate = isAbsolute2(value) ? value : `${repoRoot}${sep2}${value}`;
+    if (isGitMetadata(repoRoot, candidate)) {
+      return {
+        behavior: "deny",
+        message: `${toolName} may not touch the repository's git metadata. Refused: ${value}`
+      };
+    }
+    if (!isInsideTree(repoRoot, candidate)) {
+      return {
+        behavior: "deny",
+        message: `${toolName} may only ${verb} inside the repository. Refused: ${value}`
+      };
+    }
+  }
+  return { behavior: "allow" };
+}
+function confineToRepo(repoRoot, mode = "read") {
+  return async (toolName, input) => decideConfinedTool(repoRoot, toolName, input, mode);
+}
+var READ_PATH_ARGS, WRITE_PATH_ARGS, CONFINED_READ_TOOLS, CONFINED_WRITE_TOOLS, PATTERN_ARG_BY_TOOL;
+var init_confine_to_repo = __esm(() => {
+  READ_PATH_ARGS = {
+    Read: ["file_path", "path", "notebook_path"],
+    Grep: ["path"],
+    Glob: ["path"]
+  };
+  WRITE_PATH_ARGS = {
+    Write: ["file_path"],
+    Edit: ["file_path"],
+    MultiEdit: ["file_path"],
+    NotebookEdit: ["notebook_path"]
+  };
+  CONFINED_READ_TOOLS = Object.freeze(Object.keys(READ_PATH_ARGS));
+  CONFINED_WRITE_TOOLS = Object.freeze([
+    ...Object.keys(READ_PATH_ARGS),
+    ...Object.keys(WRITE_PATH_ARGS).filter((t) => t !== "MultiEdit")
+  ]);
+  PATTERN_ARG_BY_TOOL = {
+    Glob: ["pattern"],
+    Grep: ["glob"]
+  };
+});
+
+// src/runner.ts
+import { getConfigDir } from "@gethmy/mcp/src/config.js";
+function mayHoldCredentials(role) {
+  return role === "author" || role === "reviewer";
+}
+function credentialReadDeny() {
+  return `Read(/${getConfigDir()}/**)`;
+}
+function credentialAccessDeny() {
+  const dir = `/${getConfigDir()}/**`;
+  return [`Read(${dir})`, `Grep(${dir})`, `Glob(${dir})`];
+}
+function buildRoleLaunch(args) {
+  const role = normalizeStageRole(args.role);
+  const keep = mayHoldCredentials(role);
+  const env = {};
+  for (const [key, value] of Object.entries(args.parentEnv)) {
+    if (value === undefined)
+      continue;
+    if (!keep && HARMONY_CREDENTIAL_KEYS.includes(key))
+      continue;
+    env[key] = value;
+  }
+  return {
+    role,
+    prompt: args.prompt,
+    repoPath: args.repoPath,
+    env,
+    disallowedTools: keep ? [] : [credentialReadDeny()]
+  };
+}
+function envKeysDroppedByLaunch(parentEnv, launch) {
+  return Object.keys(parentEnv).filter((key) => parentEnv[key] !== undefined && !Object.hasOwn(launch.env, key));
+}
+var HARMONY_CREDENTIAL_KEYS;
+var init_runner = __esm(() => {
+  init_dist();
+  HARMONY_CREDENTIAL_KEYS = [
+    "HARMONY_API_KEY",
+    "HARMONY_API_URL",
+    "HARMONY_WORKSPACE_ID",
+    "SUPABASE_ANON_KEY",
+    "SUPABASE_SERVICE_ROLE_KEY",
+    "SUPABASE_URL"
+  ];
+});
+
+// src/run-containment.ts
+import { createHash as createHash2 } from "node:crypto";
+import { readFileSync as readFileSync2 } from "node:fs";
+import { createRequire as createRequire2 } from "node:module";
+import { homedir, tmpdir as tmpdir2 } from "node:os";
+import { dirname as dirname3, isAbsolute as isAbsolute3, join as join2 } from "node:path";
+import { getConfigDir as getConfigDir2 } from "@gethmy/mcp/src/config.js";
+function credentialDirectories() {
+  const home = homedir();
+  return [
+    getConfigDir2(),
+    join2(home, ".claude"),
+    join2(home, ".claude.json"),
+    join2(home, ".ssh"),
+    join2(home, ".gnupg"),
+    join2(home, ".aws"),
+    join2(home, ".codex"),
+    join2(home, ".gemini"),
+    join2(home, ".config", "gh"),
+    join2(home, ".config", "gcloud"),
+    join2(home, ".config", "anthropic"),
+    join2(home, ".config", "op"),
+    join2(home, ".docker"),
+    join2(home, ".kube"),
+    join2(home, ".netrc"),
+    join2(home, ".npmrc"),
+    join2(home, ".git-credentials")
+  ];
+}
+function writeOnlyDenyPaths() {
+  const paths = [join2(homedir(), ".gitconfig")];
+  const xdg = process.env.XDG_CONFIG_HOME;
+  paths.push(xdg && isAbsolute3(xdg) ? join2(xdg, "git") : join2(homedir(), ".config", "git"));
+  return paths;
+}
+function credentialToolDeny() {
+  return credentialDirectories().flatMap((dir) => [
+    `Read(/${dir})`,
+    `Read(/${dir}/**)`
+  ]);
+}
+function toolchainCacheDirectories(worktree) {
+  const home = homedir();
+  const scratch = `harmony-run-${createHash2("sha256").update(worktree).digest("hex").slice(0, 16)}`;
+  const candidate = process.env.TMPDIR ?? tmpdir2();
+  const tmpRoot = isAbsolute3(candidate) ? candidate : "/tmp";
+  return [
+    join2(home, ".bun", "install", "cache"),
+    join2(home, ".npm", "_cacache"),
+    join2(tmpRoot, scratch)
+  ];
+}
+function secretEnvKeysToStrip(parentEnv = process.env) {
+  const stripped = new Set(HARMONY_CREDENTIAL_KEYS);
+  for (const key of Object.keys(parentEnv)) {
+    if (KEEP_ENV_KEYS.has(key))
+      continue;
+    if (SECRET_ENV_PATTERN.test(key))
+      stripped.add(key);
+  }
+  return [...stripped];
+}
+function assertNoProjectSandboxOverride(worktree) {
+  for (const name of ["settings.json", "settings.local.json"]) {
+    const path = join2(worktree, ".claude", name);
+    let raw;
+    try {
+      raw = readFileSync2(path, "utf-8");
+    } catch {
+      continue;
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      continue;
+    }
+    if (parsed === null || typeof parsed !== "object")
+      continue;
+    const offending = Object.keys(parsed).filter((key) => !INERT_PROJECT_SETTING_KEYS.has(key));
+    if (offending.length > 0) {
+      throw new ProjectSandboxOverrideError(path, offending);
+    }
+  }
+}
+function containedEnv(parentEnv = process.env) {
+  const strip = new Set(secretEnvKeysToStrip(parentEnv));
+  const out = {};
+  for (const [key, value] of Object.entries(parentEnv)) {
+    if (value === undefined || strip.has(key))
+      continue;
+    out[key] = value;
+  }
+  return out;
+}
+function gitMetadataDenyPaths(worktree) {
+  const paths = new Set;
+  const dotGit = join2(worktree, ".git");
+  const require2 = createRequire2(import.meta.url);
+  const { execFileSync } = require2("node:child_process");
+  const { statSync: statSync2 } = require2("node:fs");
+  const gitDirs = new Set;
+  try {
+    const out = execFileSync("git", [...GIT_NO_HOOKS, "rev-parse", "--git-dir", "--git-common-dir"], { cwd: worktree, encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] });
+    for (const line of out.split(`
+`)) {
+      const trimmed = line.trim();
+      if (!trimmed)
+        continue;
+      gitDirs.add(isAbsolute3(trimmed) ? trimmed : join2(worktree, trimmed));
+    }
+  } catch {}
+  gitDirs.add(dotGit);
+  for (const dir of gitDirs) {
+    paths.add(join2(dir, "config"));
+    paths.add(join2(dir, "config.worktree"));
+    paths.add(join2(dir, "hooks"));
+  }
+  try {
+    if (statSync2(dotGit).isFile())
+      paths.add(dotGit);
+  } catch {}
+  return [...paths];
+}
+function hostPersistencePaths() {
+  const home = homedir();
+  return [
+    join2(home, ".zshenv"),
+    join2(home, ".zprofile"),
+    join2(home, ".zshrc"),
+    join2(home, ".zlogin"),
+    join2(home, ".bashrc"),
+    join2(home, ".bash_profile"),
+    join2(home, ".bash_login"),
+    join2(home, ".profile"),
+    join2(home, ".config", "fish", "config.fish"),
+    join2(home, ".config", "fish", "conf.d"),
+    join2(home, "Library", "LaunchAgents"),
+    join2(home, ".config", "systemd", "user"),
+    join2(home, ".config", "autostart")
+  ];
+}
+function credentialWriteToolDeny(worktree) {
+  return [
+    ...credentialDirectories(),
+    ...writeOnlyDenyPaths(),
+    ...hostPersistencePaths(),
+    ...gitMetadataDenyPaths(worktree)
+  ].flatMap((p) => [`Edit(/${p})`, `Edit(/${p}/**)`]);
+}
+function implementRunToolPolicy(args) {
+  const writable = [args.worktree, ...toolchainCacheDirectories(args.worktree)];
+  const gitMeta = gitMetadataDenyPaths(args.worktree);
+  const secrets = credentialDirectories();
+  return async (toolName, input) => {
+    const allow = { behavior: "allow", updatedInput: input };
+    const deny = (message) => ({ behavior: "deny", message });
+    if (toolName.startsWith("mcp__"))
+      return allow;
+    if (toolName === "Bash" || toolName === "BashOutput") {
+      return allow;
+    }
+    const writePaths = WRITE_TOOL_PATHS[toolName];
+    if (writePaths) {
+      if (args.readOnly === true) {
+        return deny(`${toolName} is not available to a review run.`);
+      }
+      for (const key of writePaths) {
+        const value = input[key];
+        if (typeof value !== "string" || value.length === 0)
+          continue;
+        const target = isAbsolute3(value) ? value : join2(args.worktree, value);
+        if (gitMeta.some((p) => isInsideTree(p, target) || p === target)) {
+          return deny(`${toolName} may not touch git metadata. Refused: ${value}`);
+        }
+        if (!writable.some((root) => isInsideTree(root, target))) {
+          return deny(`${toolName} may only write inside this run's worktree. Refused: ${value}`);
+        }
+      }
+      return allow;
+    }
+    const readPaths = READ_TOOL_PATHS[toolName];
+    if (readPaths) {
+      for (const key of readPaths) {
+        const value = input[key];
+        if (typeof value !== "string" || value.length === 0)
+          continue;
+        const target = isAbsolute3(value) ? value : join2(args.worktree, value);
+        if (secrets.some((dir) => isInsideTree(dir, target))) {
+          return deny(`${toolName} may not read the credential directories. Refused: ${value}`);
+        }
+      }
+      return allow;
+    }
+    return allow;
+  };
+}
+function harmonyMcpServer() {
+  const require2 = createRequire2(import.meta.url);
+  const cli = join2(dirname3(require2.resolve("@gethmy/mcp")), "cli.js");
+  return {
+    harmony: {
+      type: "stdio",
+      command: process.execPath,
+      args: [cli, "serve"]
+    }
+  };
+}
+function implementRunContainment(args) {
+  assertNoProjectSandboxOverride(args.worktree);
+  return {
+    sandbox: {
+      enabled: true,
+      failIfUnavailable: true,
+      allowUnsandboxedCommands: false,
+      autoAllowBashIfSandboxed: args.readOnly !== true,
+      network: {
+        allowedDomains: [...IMPLEMENT_ALLOWED_DOMAINS],
+        allowLocalBinding: false
+      },
+      filesystem: {
+        allowWrite: [
+          args.worktree,
+          ...toolchainCacheDirectories(args.worktree)
+        ],
+        denyRead: credentialDirectories(),
+        denyWrite: [
+          ...credentialDirectories(),
+          ...writeOnlyDenyPaths(),
+          ...hostPersistencePaths(),
+          ...gitMetadataDenyPaths(args.worktree)
+        ]
+      }
+    },
+    canUseTool: implementRunToolPolicy(args),
+    gateEveryToolCall: true,
+    settingSources: args.readOnly === true ? [] : ["project"],
+    mcpServers: harmonyMcpServer(),
+    strictMcpConfig: true,
+    stripEnvKeys: secretEnvKeysToStrip(),
+    disallowedTools: [
+      ...args.extraDisallowedTools ?? [],
+      ...credentialToolDeny(),
+      ...credentialWriteToolDeny(args.worktree)
+    ]
+  };
+}
+function implementRunContainmentCliArgs(args) {
+  const containment = implementRunContainment(args);
+  return [
+    "--settings",
+    JSON.stringify({ sandbox: containment.sandbox }),
+    "--setting-sources",
+    containment.settingSources.join(","),
+    "--mcp-config",
+    JSON.stringify({ mcpServers: containment.mcpServers }),
+    "--strict-mcp-config",
+    "--disallowedTools",
+    containment.disallowedTools.join(",")
+  ];
+}
+var SECRET_ENV_PATTERN, KEEP_ENV_KEYS, ProjectSandboxOverrideError, INERT_PROJECT_SETTING_KEYS, WRITE_TOOL_PATHS, READ_TOOL_PATHS, GIT_NO_HOOKS, IMPLEMENT_ALLOWED_DOMAINS;
+var init_run_containment = __esm(() => {
+  init_confine_to_repo();
+  init_runner();
+  SECRET_ENV_PATTERN = /(TOKEN|SECRET|PASSWORD|PASSWD|CREDENTIAL|API_?KEY|_PAT$|^PAT_|PRIVATE_KEY|ACCESS_KEY)/i;
+  KEEP_ENV_KEYS = new Set([
+    "ANTHROPIC_API_KEY",
+    "ANTHROPIC_AUTH_TOKEN",
+    "ANTHROPIC_BASE_URL",
+    "CLAUDE_CODE_OAUTH_TOKEN",
+    "SSH_AUTH_SOCK",
+    "GIT_AUTHOR_NAME",
+    "GIT_AUTHOR_EMAIL",
+    "GIT_COMMITTER_NAME",
+    "GIT_COMMITTER_EMAIL",
+    "XAUTHORITY"
+  ]);
+  ProjectSandboxOverrideError = class ProjectSandboxOverrideError extends Error {
+    settingsPath;
+    offendingKeys;
+    constructor(settingsPath, offendingKeys) {
+      super(`Refusing to spawn: ${settingsPath} sets ${offendingKeys.map((k) => `"${k}"`).join(", ")}. ` + "Project settings are loaded so the run can read CLAUDE.md, and that same layer " + "can widen the sandbox (`sandbox.filesystem.allowWrite`) or execute commands " + "outside it (`hooks`, `env`). A run that can write this file could therefore " + "widen its own bounds, so only keys known not to affect execution are accepted. " + "Remove the key, or the run stays refused.");
+      this.settingsPath = settingsPath;
+      this.offendingKeys = offendingKeys;
+      this.name = "ProjectSandboxOverrideError";
+    }
+  };
+  INERT_PROJECT_SETTING_KEYS = new Set([
+    "$schema",
+    "cleanupPeriodDays",
+    "includeCoAuthoredBy",
+    "language",
+    "outputStyle",
+    "spinnerTipsEnabled",
+    "theme",
+    "verbose"
+  ]);
+  WRITE_TOOL_PATHS = {
+    Write: ["file_path"],
+    Edit: ["file_path"],
+    MultiEdit: ["file_path"],
+    NotebookEdit: ["notebook_path"]
+  };
+  READ_TOOL_PATHS = {
+    Read: ["file_path", "path", "notebook_path"],
+    Grep: ["path"],
+    Glob: ["path"]
+  };
+  GIT_NO_HOOKS = [
+    "-c",
+    "core.hooksPath=",
+    "-c",
+    "core.fsmonitor=",
+    "-c",
+    "core.pager=cat"
+  ];
+  IMPLEMENT_ALLOWED_DOMAINS = [
+    "api.anthropic.com",
+    "*.anthropic.com",
+    "registry.npmjs.org",
+    "*.npmjs.org",
+    "github.com",
+    "*.github.com",
+    "*.githubusercontent.com"
+  ];
+});
+
 // src/cli.ts
 init_dist();
 
@@ -896,6 +1381,7 @@ class SdkAgentRunner {
       ...this.cfg.settingSources ? { settingSources: this.cfg.settingSources } : {},
       ...this.cfg.mcpServers ? { mcpServers: this.cfg.mcpServers } : {},
       ...this.cfg.strictMcpConfig ? { strictMcpConfig: true } : {},
+      ...this.cfg.sandbox ? { sandbox: this.cfg.sandbox } : {},
       stderr: (data) => {
         this.capturedStderr += data;
       },
@@ -1316,6 +1802,7 @@ init_dist();
 
 // src/exec-types.ts
 var DEFAULT_METRIC_TIMEOUT_MS = 300000;
+var SANDBOX_STARTUP_GRACE_MS = 60000;
 
 // src/gate-config-error.ts
 init_dist();
@@ -2030,11 +2517,12 @@ function errText(err) {
 }
 
 // src/verification.ts
-init_log();
 import { execFileSync as execFileSync4, spawn as spawn2 } from "node:child_process";
+init_log();
 
 // src/pm.ts
 init_log();
+init_run_containment();
 import { execFileSync } from "node:child_process";
 import { existsSync } from "node:fs";
 var TAG6 = "pm";
@@ -2044,7 +2532,7 @@ function detectPackageManager() {
     return cached;
   let repoRoot;
   try {
-    repoRoot = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+    repoRoot = execFileSync("git", [...GIT_NO_HOOKS, "rev-parse", "--show-toplevel"], {
       encoding: "utf-8"
     }).trim();
   } catch {
@@ -2087,7 +2575,7 @@ function spawnRunArgs(script, ...extra) {
 // src/project-type.ts
 init_log();
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync3 } from "node:fs";
 var TAG7 = "project-type";
 var _cache = new Map;
 function _resetCache() {
@@ -2190,7 +2678,7 @@ var NPM_PLACEHOLDER_TEST = /no test specified/i;
 function hasNodeTestScript(dir) {
   let script;
   try {
-    const pkg = JSON.parse(readFileSync2(`${dir}/package.json`, "utf-8"));
+    const pkg = JSON.parse(readFileSync3(`${dir}/package.json`, "utf-8"));
     script = pkg.scripts?.test;
   } catch (err) {
     log.warn(TAG7, `Could not read package.json in ${dir}: ${err instanceof Error ? err.message : err}`);
@@ -2207,7 +2695,7 @@ function hasNodeTestScript(dir) {
 function firstNodeScript(dir, candidates) {
   let scripts;
   try {
-    const pkg = JSON.parse(readFileSync2(`${dir}/package.json`, "utf-8"));
+    const pkg = JSON.parse(readFileSync3(`${dir}/package.json`, "utf-8"));
     scripts = pkg.scripts ?? {};
   } catch (err) {
     log.warn(TAG7, `Could not read package.json in ${dir}: ${err instanceof Error ? err.message : err}`);
@@ -2262,10 +2750,108 @@ function resolveXcodeScheme(pt) {
   }
 }
 
+// src/repair-sandbox.ts
+init_log();
+import { randomUUID } from "node:crypto";
+import { promisify } from "node:util";
+var TAG8 = "repair-sandbox";
+async function dockerExec(argv, opts) {
+  const { execFile } = await import("node:child_process");
+  return promisify(execFile)("docker", argv, {
+    encoding: "utf-8",
+    ...opts
+  });
+}
+var MAX_OUTPUT_BUFFER2 = 20971520;
+var PROBE_TIMEOUT_MS = 1e4;
+var SANDBOX_MOUNT = "/repo";
+var SANDBOX_MEMORY = "4g";
+var SANDBOX_PIDS = "512";
+var dockerProbe = null;
+async function sandboxAvailable() {
+  if (dockerProbe === true)
+    return true;
+  try {
+    await dockerExec(["version", "--format", "{{.Server.Version}}"], {
+      timeout: PROBE_TIMEOUT_MS
+    });
+    dockerProbe = true;
+  } catch {
+    dockerProbe = false;
+  }
+  return dockerProbe;
+}
+function __resetSandboxProbe() {
+  dockerProbe = null;
+}
+async function removeContainer(name) {
+  try {
+    await dockerExec(["rm", "--force", name], { timeout: PROBE_TIMEOUT_MS });
+    log.warn(TAG8, `removed the timed-out sandbox container ${name}`);
+  } catch {}
+}
+function sandboxRunArgs(image, worktree, command, name) {
+  return [
+    "run",
+    "--rm",
+    ...name ? ["--name", name] : [],
+    "--network=none",
+    "--cap-drop=ALL",
+    "--security-opt=no-new-privileges",
+    `--memory=${SANDBOX_MEMORY}`,
+    `--pids-limit=${SANDBOX_PIDS}`,
+    ...typeof process.getuid === "function" && typeof process.getgid === "function" ? ["--user", `${process.getuid()}:${process.getgid()}`] : [],
+    "--env",
+    "HOME=/tmp",
+    "--volume",
+    `${worktree}:${SANDBOX_MOUNT}`,
+    "--workdir",
+    SANDBOX_MOUNT,
+    "--entrypoint",
+    command.cmd,
+    image,
+    ...command.args
+  ];
+}
+async function runInSandbox(args) {
+  const name = `harmony-repair-${randomUUID()}`;
+  const argv = sandboxRunArgs(args.image, args.worktree, args.command, name);
+  log.info(TAG8, `sandbox: ${args.command.cmd} ${args.command.args.join(" ")} (image ${args.image})`);
+  try {
+    const { stdout } = await dockerExec(argv, {
+      timeout: args.timeoutMs,
+      maxBuffer: MAX_OUTPUT_BUFFER2
+    });
+    return { passed: true, output: stdout ?? "" };
+  } catch (err) {
+    const e = err;
+    const output = `${e.stdout ?? ""}${e.stderr ?? ""}`;
+    if (typeof e.code !== "number") {
+      const timedOut = e.killed === true || e.signal != null;
+      if (timedOut)
+        await removeContainer(name);
+      return {
+        passed: false,
+        output,
+        sandboxError: timedOut ? `the sandbox timed out after ${args.timeoutMs}ms` : `the sandbox did not run: ${e.message ?? "unknown error"}`
+      };
+    }
+    if (e.code === 125) {
+      return {
+        passed: false,
+        output,
+        sandboxError: `the sandbox could not start (image "${args.image}" missing or unusable)`
+      };
+    }
+    return { passed: false, output };
+  }
+}
+
 // src/revert-guard.ts
 init_log();
+init_run_containment();
 import { execFileSync as execFileSync3 } from "node:child_process";
-var TAG8 = "revert-guard";
+var TAG9 = "revert-guard";
 var TEST_FILE = /(?:^|\/)__tests__\/|\.(?:test|spec)\.[cm]?[jt]sx?$/;
 function isTestFile(path) {
   return TEST_FILE.test(path);
@@ -2275,21 +2861,27 @@ function filterTestFiles(paths) {
 }
 function refetchBase(worktreePath, baseBranch) {
   try {
-    execFileSync3("git", ["fetch", "origin", baseBranch], {
+    execFileSync3("git", [...GIT_NO_HOOKS, "fetch", "origin", baseBranch], {
       cwd: worktreePath,
       stdio: "pipe"
     });
   } catch {
-    log.warn(TAG8, "Failed to re-fetch base for revert guard — using last fetch");
+    log.warn(TAG9, "Failed to re-fetch base for revert guard — using last fetch");
   }
 }
 function listDeletedFilesAgainstBase(worktreePath, baseBranch) {
   try {
-    const out = execFileSync3("git", ["diff", "--diff-filter=D", "--name-only", `origin/${baseBranch}...HEAD`], { cwd: worktreePath, encoding: "utf-8" });
+    const out = execFileSync3("git", [
+      ...GIT_NO_HOOKS,
+      "diff",
+      "--diff-filter=D",
+      "--name-only",
+      `origin/${baseBranch}...HEAD`
+    ], { cwd: worktreePath, encoding: "utf-8" });
     return out.split(`
 `).map((l) => l.trim()).filter((l) => l.length > 0);
   } catch (err) {
-    log.warn(TAG8, `Failed to list deleted files: ${err instanceof Error ? err.message : err}`);
+    log.warn(TAG9, `Failed to list deleted files: ${err instanceof Error ? err.message : err}`);
     return [];
   }
 }
@@ -2299,8 +2891,9 @@ function findDeletedTestFiles(worktreePath, baseBranch) {
 }
 
 // src/verification.ts
-var TAG9 = "verification";
-var MAX_OUTPUT_BUFFER2 = 64 * 1024 * 1024;
+init_run_containment();
+var TAG10 = "verification";
+var MAX_OUTPUT_BUFFER3 = 64 * 1024 * 1024;
 async function runVerification(worktreePath, config, workerId) {
   const result = {
     passed: true,
@@ -2310,133 +2903,163 @@ async function runVerification(worktreePath, config, workerId) {
     reviewFindings: [],
     revertWarnings: []
   };
+  const sandbox = verificationSandbox(config);
   if (config.verification.revertGuard) {
-    log.info(TAG9, `[worker:${workerId}] Checking for reverted merged work...`);
+    log.info(TAG10, `[worker:${workerId}] Checking for reverted merged work...`);
     const deletedTests = findDeletedTestFiles(worktreePath, config.worktree.baseBranch);
     if (deletedTests.length > 0) {
       result.revertWarnings = deletedTests.map((f) => `Branch deletes test file '${f}' relative to current ${config.worktree.baseBranch} — ` + "likely an accidental revert of already-merged work. Restore the test or rebase on current main.");
-      log.warn(TAG9, `[worker:${workerId}] Revert guard tripped: ${deletedTests.length} deleted test file(s)`);
+      log.warn(TAG10, `[worker:${workerId}] Revert guard tripped: ${deletedTests.length} deleted test file(s)`);
       result.passed = false;
     } else {
-      log.info(TAG9, `[worker:${workerId}] Revert guard passed`);
+      log.info(TAG10, `[worker:${workerId}] Revert guard passed`);
     }
   }
   if (config.verification.build) {
-    log.info(TAG9, `[worker:${workerId}] Running build...`);
-    result.buildErrors = runBuild(worktreePath, config.verification.timeout);
+    log.info(TAG10, `[worker:${workerId}] Running build...`);
+    result.buildErrors = await runBuild(worktreePath, config.verification.timeout, sandbox);
     if (result.buildErrors.length > 0) {
-      log.warn(TAG9, `[worker:${workerId}] Build failed with ${result.buildErrors.length} error(s)`);
+      log.warn(TAG10, `[worker:${workerId}] Build failed with ${result.buildErrors.length} error(s)`);
       result.passed = false;
     } else {
-      log.info(TAG9, `[worker:${workerId}] Build passed`);
+      log.info(TAG10, `[worker:${workerId}] Build passed`);
     }
   }
   if (config.verification.test && result.buildErrors.length === 0) {
-    log.info(TAG9, `[worker:${workerId}] Running tests...`);
-    result.testFailures = runTests(worktreePath, config.verification.testTimeout);
+    log.info(TAG10, `[worker:${workerId}] Running tests...`);
+    result.testFailures = await runTests(worktreePath, config.verification.testTimeout, sandbox);
     if (result.testFailures.length > 0) {
-      log.warn(TAG9, `[worker:${workerId}] Tests failed with ${result.testFailures.length} failure(s)`);
+      log.warn(TAG10, `[worker:${workerId}] Tests failed with ${result.testFailures.length} failure(s)`);
       result.passed = false;
     } else {
-      log.info(TAG9, `[worker:${workerId}] Tests passed`);
+      log.info(TAG10, `[worker:${workerId}] Tests passed`);
     }
   }
   if (config.verification.lint) {
-    log.info(TAG9, `[worker:${workerId}] Running lint...`);
-    result.lintWarnings = runLint(worktreePath, config.verification.timeout);
+    log.info(TAG10, `[worker:${workerId}] Running lint...`);
+    result.lintWarnings = await runLint(worktreePath, config.verification.timeout, sandbox);
     if (result.lintWarnings.length > 0) {
-      log.warn(TAG9, `[worker:${workerId}] Lint found ${result.lintWarnings.length} issue(s)`);
+      log.warn(TAG10, `[worker:${workerId}] Lint found ${result.lintWarnings.length} issue(s)`);
     } else {
-      log.info(TAG9, `[worker:${workerId}] Lint passed`);
+      log.info(TAG10, `[worker:${workerId}] Lint passed`);
     }
   }
   if (config.verification.deepReview) {
-    log.info(TAG9, `[worker:${workerId}] Running deep review...`);
+    log.info(TAG10, `[worker:${workerId}] Running deep review...`);
     result.reviewFindings = await runDeepReview(worktreePath, config, workerId);
     if (result.reviewFindings.length > 0) {
-      log.warn(TAG9, `[worker:${workerId}] Deep review found ${result.reviewFindings.length} finding(s)`);
+      log.warn(TAG10, `[worker:${workerId}] Deep review found ${result.reviewFindings.length} finding(s)`);
     } else {
-      log.info(TAG9, `[worker:${workerId}] Deep review passed`);
+      log.info(TAG10, `[worker:${workerId}] Deep review passed`);
     }
   }
   return result;
 }
-function runBuild(worktreePath, timeout) {
-  const command = buildCommand(worktreePath);
-  if (!command) {
-    log.warn(TAG9, `No known build toolchain for ${worktreePath} — skipping build`);
-    return [];
+function verificationSandbox(config) {
+  const image = config.verification.sandboxImage?.trim();
+  if (!image)
+    return;
+  return { image };
+}
+async function execStep(command, args) {
+  const { worktreePath, timeout } = args;
+  const sandbox = args.sandbox?.image.trim() ? args.sandbox : undefined;
+  if (sandbox) {
+    if (!await sandboxAvailable()) {
+      return {
+        ok: false,
+        sandboxError: `verification.sandboxImage is set to "${sandbox.image}" but no container runtime answered — ` + "start Docker or unset the image to verify on the host"
+      };
+    }
+    const result = await runInSandbox({
+      image: sandbox.image,
+      worktree: worktreePath,
+      command,
+      timeoutMs: timeout + SANDBOX_STARTUP_GRACE_MS
+    });
+    if (result.sandboxError) {
+      return { ok: false, sandboxError: result.sandboxError };
+    }
+    if (result.passed)
+      return { ok: true };
+    return { ok: false, err: { stdout: result.output, stderr: "" } };
   }
   try {
     execFileSync4(command.cmd, command.args, {
       cwd: worktreePath,
       timeout,
       stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
+      maxBuffer: MAX_OUTPUT_BUFFER3,
+      env: containedEnv()
     });
-    return [];
+    return { ok: true };
   } catch (err) {
-    return parseErrorOutput(err);
+    return { ok: false, err };
   }
 }
-function runTests(worktreePath, timeout) {
+async function runBuild(worktreePath, timeout, sandbox) {
+  const command = buildCommand(worktreePath);
+  if (!command) {
+    log.warn(TAG10, `No known build toolchain for ${worktreePath} — skipping build`);
+    return [];
+  }
+  const outcome = await execStep(command, { worktreePath, timeout, sandbox });
+  if (outcome.ok)
+    return [];
+  if (outcome.sandboxError) {
+    log.error(TAG10, `Build not verified: ${outcome.sandboxError}`);
+    return [`Build did not run: ${outcome.sandboxError}`];
+  }
+  return parseErrorOutput(outcome.err);
+}
+async function runTests(worktreePath, timeout, sandbox) {
   const command = testCommand(worktreePath);
   if (!command) {
-    log.warn(TAG9, `No test command for detected toolchain in ${worktreePath} — skipping tests`);
+    log.warn(TAG10, `No test command for detected toolchain in ${worktreePath} — skipping tests`);
     return [];
   }
-  try {
-    execFileSync4(command.cmd, command.args, {
-      cwd: worktreePath,
-      timeout,
-      stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
-    });
+  const outcome = await execStep(command, { worktreePath, timeout, sandbox });
+  if (outcome.ok)
     return [];
-  } catch (err) {
-    const output = combineOutput(err);
-    log.warn(TAG9, `Test run failed:
-${output.slice(-4000) || "(no output captured)"}`);
-    return parseTestFailures(err, timeout);
+  if (outcome.sandboxError) {
+    log.error(TAG10, `Tests not verified: ${outcome.sandboxError}`);
+    return [`Test run did not happen: ${outcome.sandboxError}`];
   }
+  const output = combineOutput(outcome.err);
+  log.warn(TAG10, `Test run failed:
+${output.slice(-4000) || "(no output captured)"}`);
+  return parseTestFailures(outcome.err, timeout);
 }
-function runFormatFix(worktreePath, timeout, workerId) {
+async function runFormatFix(worktreePath, timeout, workerId, sandbox) {
   const command = formatFixCommand(worktreePath);
   if (!command)
     return;
-  try {
-    execFileSync4(command.cmd, command.args, {
-      cwd: worktreePath,
-      timeout,
-      stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
-    });
-    log.info(TAG9, `[worker:${workerId}] Auto-formatted worktree before commit/push`);
-  } catch (err) {
-    log.warn(TAG9, `[worker:${workerId}] Auto-format step exited non-zero (non-fatal): ${err instanceof Error ? err.message : String(err)}`);
+  const outcome = await execStep(command, { worktreePath, timeout, sandbox });
+  if (outcome.ok) {
+    log.info(TAG10, `[worker:${workerId}] Auto-formatted worktree before commit/push`);
+    return;
   }
+  const why = outcome.sandboxError ? outcome.sandboxError : outcome.err instanceof Error ? outcome.err.message : String(outcome.err);
+  log.warn(TAG10, `[worker:${workerId}] Auto-format step did not complete (non-fatal): ${why}`);
 }
-function runLint(worktreePath, timeout) {
+async function runLint(worktreePath, timeout, sandbox) {
   const command = lintCommand(worktreePath);
   if (!command) {
-    log.info(TAG9, `No lint step for detected toolchain in ${worktreePath} — skipping lint`);
+    log.info(TAG10, `No lint step for detected toolchain in ${worktreePath} — skipping lint`);
     return [];
   }
-  try {
-    execFileSync4(command.cmd, command.args, {
-      cwd: worktreePath,
-      timeout,
-      stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
-    });
+  const outcome = await execStep(command, { worktreePath, timeout, sandbox });
+  if (outcome.ok)
     return [];
-  } catch (err) {
-    return parseErrorOutput(err);
+  if (outcome.sandboxError) {
+    log.error(TAG10, `Lint not verified: ${outcome.sandboxError}`);
+    return [`Lint did not run: ${outcome.sandboxError}`];
   }
+  return parseErrorOutput(outcome.err);
 }
 async function runDeepReview(worktreePath, config, workerId) {
   if (!supportsDevServer(worktreePath)) {
-    log.info(TAG9, `[worker:${workerId}] Detected non-web toolchain — skipping deep review`);
+    log.info(TAG10, `[worker:${workerId}] Detected non-web toolchain — skipping deep review`);
     return [];
   }
   const port = config.verification.devServerBasePort + workerId;
@@ -2445,22 +3068,23 @@ async function runDeepReview(worktreePath, config, workerId) {
     const [cmd, args] = spawnRunArgs("dev", "--port", String(port));
     devServer = spawn2(cmd, args, {
       cwd: worktreePath,
-      stdio: ["ignore", "pipe", "pipe"]
+      stdio: ["ignore", "pipe", "pipe"],
+      env: containedEnv()
     });
     try {
       await waitForDevServer(devServer, 30000);
       await probeDevServer(port);
     } catch (err) {
-      log.error(TAG9, `Dev server did not become ready: ${err instanceof Error ? err.message : err}`);
+      log.error(TAG10, `Dev server did not become ready: ${err instanceof Error ? err.message : err}`);
       return [];
     }
     let diff = "";
     try {
-      diff = execFileSync4("git", ["diff", `origin/${config.worktree.baseBranch}..HEAD`], {
+      diff = execFileSync4("git", [...GIT_NO_HOOKS, "diff", `origin/${config.worktree.baseBranch}..HEAD`], {
         cwd: worktreePath,
         encoding: "utf-8",
         timeout: 30000,
-        maxBuffer: MAX_OUTPUT_BUFFER2
+        maxBuffer: MAX_OUTPUT_BUFFER3
       });
     } catch {
       diff = "(unable to retrieve diff)";
@@ -2477,14 +3101,16 @@ async function runDeepReview(worktreePath, config, workerId) {
       "```"
     ].join(`
 `);
-    const leanSources = config.claude.leanSettingSources;
     const output = execFileSync4("claude", [
       "--print",
       "--model",
       "sonnet",
       "--max-turns",
       "10",
-      ...leanSources ? ["--setting-sources", leanSources] : [],
+      ...implementRunContainmentCliArgs({
+        worktree: worktreePath,
+        readOnly: true
+      }),
       "--",
       reviewPrompt
     ], {
@@ -2492,11 +3118,12 @@ async function runDeepReview(worktreePath, config, workerId) {
       encoding: "utf-8",
       timeout: config.verification.timeout,
       stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
+      maxBuffer: MAX_OUTPUT_BUFFER3,
+      env: containedEnv()
     });
     return parseReviewFindings(output);
   } catch (err) {
-    log.error(TAG9, `Deep review failed: ${err instanceof Error ? err.message : err}`);
+    log.error(TAG10, `Deep review failed: ${err instanceof Error ? err.message : err}`);
     return [];
   } finally {
     if (devServer && !devServer.killed) {
@@ -2522,7 +3149,6 @@ function attemptAutoFix(worktreePath, config, errors) {
     "```"
   ].join(`
 `);
-  const leanSources = config.claude.leanSettingSources;
   const args = [
     "--print",
     "--model",
@@ -2531,16 +3157,17 @@ function attemptAutoFix(worktreePath, config, errors) {
     "50",
     "--allowedTools",
     "Bash,Read,Write,Edit,Glob,Grep",
-    ...leanSources ? ["--setting-sources", leanSources] : [],
+    ...implementRunContainmentCliArgs({ worktree: worktreePath }),
     "--",
     fixPrompt
   ];
-  log.info(TAG9, "Spawning Claude for auto-fix...");
+  log.info(TAG10, "Spawning Claude for auto-fix...");
   execFileSync4("claude", args, {
     cwd: worktreePath,
     timeout: config.verification.timeout,
     stdio: "pipe",
-    maxBuffer: MAX_OUTPUT_BUFFER2
+    maxBuffer: MAX_OUTPUT_BUFFER3,
+    env: containedEnv()
   });
 }
 async function reportFindings(client, cardId, result, recovery) {
@@ -2573,7 +3200,7 @@ async function reportFindings(client, cardId, result, recovery) {
     try {
       await client.createSubtask(cardId, title);
     } catch (err) {
-      log.error(TAG9, `Failed to create subtask: ${err instanceof Error ? err.message : err}`);
+      log.error(TAG10, `Failed to create subtask: ${err instanceof Error ? err.message : err}`);
     }
   }));
   if (overflow > 0) {
@@ -2581,7 +3208,7 @@ async function reportFindings(client, cardId, result, recovery) {
       await client.createSubtask(cardId, `...and ${overflow} more issues`);
     } catch {}
   }
-  log.info(TAG9, `Reported ${Math.min(items.length, maxSubtasks)} finding(s) as subtasks on card ${cardId}`);
+  log.info(TAG10, `Reported ${Math.min(items.length, maxSubtasks)} finding(s) as subtasks on card ${cardId}`);
 }
 function combineOutput(err) {
   const stderr = err?.stderr?.toString() ?? "";
@@ -2614,7 +3241,7 @@ function parseTestFailures(err, timeout) {
   }
   if (e?.code === "ENOBUFS") {
     return [
-      `Test output exceeded the ${MAX_OUTPUT_BUFFER2 / (1024 * 1024)}MB capture limit and the run was killed — ` + "the suite's real result is unknown. Quieten the reporter or raise the limit."
+      `Test output exceeded the ${MAX_OUTPUT_BUFFER3 / (1024 * 1024)}MB capture limit and the run was killed — ` + "the suite's real result is unknown. Quieten the reporter or raise the limit."
     ];
   }
   const combined = combineOutput(err);
@@ -2641,7 +3268,7 @@ class DevServerReadinessError extends Error {
   }
 }
 function waitForDevServer(proc, timeout) {
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     let settled = false;
     const cleanup = () => {
       proc.stdout?.off("data", onData);
@@ -2655,7 +3282,7 @@ function waitForDevServer(proc, timeout) {
         return;
       settled = true;
       cleanup();
-      resolve2();
+      resolve3();
     };
     const settleReject = (err) => {
       if (settled)
@@ -2705,7 +3332,7 @@ async function probeDevServer(port, timeoutMs = 5000) {
 }
 
 // src/gate-collectors.ts
-var TAG10 = "gate-collectors";
+var TAG11 = "gate-collectors";
 async function resolveStageGate(client, card) {
   const currentStage = card.current_stage;
   const playbookId = card.playbook_id;
@@ -2723,7 +3350,7 @@ async function resolveStageGate(client, card) {
       return null;
     return { stage: resolution.stage, gate };
   } catch (err) {
-    log.warn(TAG10, `resolveStageGate failed for stage "${currentStage}": ${err instanceof Error ? err.message : err}`);
+    log.warn(TAG11, `resolveStageGate failed for stage "${currentStage}": ${err instanceof Error ? err.message : err}`);
     return null;
   }
 }
@@ -2758,8 +3385,8 @@ class BuildGreenCollector {
   async collect(_context) {
     const doBuild = this.deps.runBuild ?? runBuild;
     const doLint = this.deps.runLint ?? runLint;
-    const buildErrors = doBuild(this.deps.worktreePath, this.deps.buildTimeout);
-    const lintWarnings = doLint(this.deps.worktreePath, this.deps.lintTimeout);
+    const buildErrors = await doBuild(this.deps.worktreePath, this.deps.buildTimeout, this.deps.sandbox);
+    const lintWarnings = await doLint(this.deps.worktreePath, this.deps.lintTimeout, this.deps.sandbox);
     const buildPassed = buildErrors.length === 0;
     const lintPassed = lintWarnings.length === 0;
     const result = buildPassed ? "passed" : "failed";
@@ -2855,7 +3482,7 @@ function buildGateCollectorRegistry(deps) {
 async function collectGateEvidence(registry, context) {
   const collector = registry[context.gate.kind];
   if (!collector) {
-    log.info(TAG10, `No collector for gate kind "${context.gate.kind}" — reporting blocked`);
+    log.info(TAG11, `No collector for gate kind "${context.gate.kind}" — reporting blocked`);
     return {
       result: "blocked",
       structured: {
@@ -2867,14 +3494,14 @@ async function collectGateEvidence(registry, context) {
     return await collector.collect(context);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    log.warn(TAG10, `Collector for "${context.gate.kind}" threw: ${msg} — reporting blocked`);
+    log.warn(TAG11, `Collector for "${context.gate.kind}" threw: ${msg} — reporting blocked`);
     return { result: "blocked", structured: { error: msg } };
   }
 }
 
 // src/harmony-client.ts
 init_log();
-var TAG11 = "harmony-client";
+var TAG12 = "harmony-client";
 function readClientConfig(env) {
   const apiUrl = env.HARMONY_API_URL?.trim();
   const apiKey = env.HARMONY_API_KEY?.trim();
@@ -2926,7 +3553,7 @@ class HarmonyClient {
       purpose: "gate_evaluation"
     });
     if (!response.ok) {
-      log.warn(TAG11, `Oracle fetch for stage ${stageId} returned ${response.status} — no oracle read, the gate will report blocked`);
+      log.warn(TAG12, `Oracle fetch for stage ${stageId} returned ${response.status} — no oracle read, the gate will report blocked`);
       return null;
     }
     const body = await response.json();
@@ -3009,52 +3636,7 @@ function relayAgentEvent(draft) {
 
 // src/stage-cli.ts
 init_dist();
-
-// src/runner.ts
-init_dist();
-import { getConfigDir } from "@gethmy/mcp/src/config.js";
-var HARMONY_CREDENTIAL_KEYS = [
-  "HARMONY_API_KEY",
-  "HARMONY_API_URL",
-  "HARMONY_WORKSPACE_ID",
-  "SUPABASE_ANON_KEY",
-  "SUPABASE_SERVICE_ROLE_KEY",
-  "SUPABASE_URL"
-];
-function mayHoldCredentials(role) {
-  return role === "author" || role === "reviewer";
-}
-function credentialReadDeny() {
-  return `Read(/${getConfigDir()}/**)`;
-}
-function credentialAccessDeny() {
-  const dir = `/${getConfigDir()}/**`;
-  return [`Read(${dir})`, `Grep(${dir})`, `Glob(${dir})`];
-}
-function buildRoleLaunch(args) {
-  const role = normalizeStageRole(args.role);
-  const keep = mayHoldCredentials(role);
-  const env = {};
-  for (const [key, value] of Object.entries(args.parentEnv)) {
-    if (value === undefined)
-      continue;
-    if (!keep && HARMONY_CREDENTIAL_KEYS.includes(key))
-      continue;
-    env[key] = value;
-  }
-  return {
-    role,
-    prompt: args.prompt,
-    repoPath: args.repoPath,
-    env,
-    disallowedTools: keep ? [] : [credentialReadDeny()]
-  };
-}
-function envKeysDroppedByLaunch(parentEnv, launch) {
-  return Object.keys(parentEnv).filter((key) => parentEnv[key] !== undefined && !Object.hasOwn(launch.env, key));
-}
-
-// src/stage-cli.ts
+init_runner();
 var STAGE_RUN_USAGE = "usage: harmony-harness stage run --card <id> --stage <id> --workspace <id> --repo <path> --session <id> [--metrics <json-path>]";
 function readFlag(argv, name) {
   const index = argv.indexOf(`--${name}`);
@@ -3255,7 +3837,7 @@ async function runStage(request, deps) {
 }
 
 // src/cli.ts
-var TAG12 = "cli";
+var TAG13 = "cli";
 var GATE_VERIFICATION_TIMEOUT_MS = 600000;
 var SHUTDOWN_HARD_EXIT_MS = 15000;
 var activeRunner = null;
@@ -3286,12 +3868,12 @@ async function runRole(request, prompt, emit2) {
   });
   const runner = new SdkAgentRunner(launch.config);
   activeRunner = runner;
-  log.info(TAG12, `Running stage ${request.stageId} as role ${launch.role ?? "(none — fail-closed)"}`);
+  log.info(TAG13, `Running stage ${request.stageId} as role ${launch.role ?? "(none — fail-closed)"}`);
   const timeoutMs = stageTimeoutMs(process.env);
   let timedOut = false;
   const clock = timeoutMs > 0 ? setTimeout(() => {
     timedOut = true;
-    log.warn(TAG12, `stage ${request.stageId} exceeded ${timeoutMs}ms — stopping the subagent`);
+    log.warn(TAG13, `stage ${request.stageId} exceeded ${timeoutMs}ms — stopping the subagent`);
     runner.stop("timeout");
   }, timeoutMs) : null;
   clock?.unref?.();
@@ -3307,9 +3889,9 @@ async function runRole(request, prompt, emit2) {
       if (relayed)
         emit2(relayed);
       if (event.kind === "error") {
-        log.warn(TAG12, `subagent error: ${event.payload.message}`);
+        log.warn(TAG13, `subagent error: ${event.payload.message}`);
       } else {
-        log.event(TAG12, `subagent ${event.kind}`);
+        log.event(TAG13, `subagent ${event.kind}`);
       }
     }
   } finally {
@@ -3340,8 +3922,8 @@ ${STAGE_RUN_USAGE}
   const { cardId, stageId, workspaceId, repoPath, sessionId, metricsPath } = parsed.args;
   let driverMetrics = {};
   if (metricsPath !== null) {
-    const { readFileSync: readFileSync3 } = await import("node:fs");
-    driverMetrics = parseMetricsAllowlist(readFileSync3(metricsPath, "utf8"), metricsPath);
+    const { readFileSync: readFileSync4 } = await import("node:fs");
+    driverMetrics = parseMetricsAllowlist(readFileSync4(metricsPath, "utf8"), metricsPath);
   }
   const client = new HarmonyClient(readClientConfig(process.env));
   const card = await client.fetchStageCard(cardId);