@gethmy/harness 1.3.0 → 1.5.0

package/dist/index.js

@@ -556,6 +556,13 @@ var init_playbookStage = __esm(() => {
 
 // ../harmony-shared/dist/projectTemplates.js
 var init_projectTemplates = () => {};
+
+// ../harmony-shared/dist/realtimeChannel.js
+var inFlightDetach;
+var init_realtimeChannel = __esm(() => {
+  init_logger();
+  inFlightDetach = new WeakMap;
+});
 // ../harmony-shared/dist/reviewTools.js
 var REVIEW_DISALLOWED_TOOLS;
 var init_reviewTools = __esm(() => {
@@ -577,7 +584,6 @@ var init_stageHandoff = __esm(() => {
 
 // ../harmony-shared/dist/types.js
 var init_types = () => {};
-
 // ../harmony-shared/dist/index.js
 var init_dist = __esm(() => {
   init_agentStaleness();
@@ -597,11 +603,498 @@ var init_dist = __esm(() => {
   init_playbookCatalog();
   init_playbookStage();
   init_projectTemplates();
+  init_realtimeChannel();
   init_reviewTools();
   init_stageHandoff();
   init_types();
 });
 
+// src/confine-to-repo.ts
+import { realpathSync } from "node:fs";
+import { dirname, isAbsolute, parse, resolve, sep } 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 (isAbsolute(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 = isAbsolute(p) ? p : resolve(p);
+  const { root } = parse(abs);
+  let real = root;
+  for (const part of abs.slice(root.length).split(sep)) {
+    if (part === "" || part === ".")
+      continue;
+    if (part === "..") {
+      real = dirname(real);
+      continue;
+    }
+    const next = real.endsWith(sep) ? real + part : real + sep + 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 + sep);
+}
+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 = isAbsolute(value) ? value : `${repoRoot}${sep}${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 } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { createRequire as createRequire2 } from "node:module";
+import { homedir, tmpdir } from "node:os";
+import { dirname as dirname2, isAbsolute as isAbsolute2, join } from "node:path";
+import { getConfigDir as getConfigDir2 } from "@gethmy/mcp/src/config.js";
+function credentialDirectories() {
+  const home = homedir();
+  return [
+    getConfigDir2(),
+    join(home, ".claude"),
+    join(home, ".claude.json"),
+    join(home, ".ssh"),
+    join(home, ".gnupg"),
+    join(home, ".aws"),
+    join(home, ".codex"),
+    join(home, ".gemini"),
+    join(home, ".config", "gh"),
+    join(home, ".config", "gcloud"),
+    join(home, ".config", "anthropic"),
+    join(home, ".config", "op"),
+    join(home, ".docker"),
+    join(home, ".kube"),
+    join(home, ".netrc"),
+    join(home, ".npmrc"),
+    join(home, ".git-credentials")
+  ];
+}
+function writeOnlyDenyPaths() {
+  const paths = [join(homedir(), ".gitconfig")];
+  const xdg = process.env.XDG_CONFIG_HOME;
+  paths.push(xdg && isAbsolute2(xdg) ? join(xdg, "git") : join(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-${createHash("sha256").update(worktree).digest("hex").slice(0, 16)}`;
+  const candidate = process.env.TMPDIR ?? tmpdir();
+  const tmpRoot = isAbsolute2(candidate) ? candidate : "/tmp";
+  return [
+    join(home, ".bun", "install", "cache"),
+    join(home, ".npm", "_cacache"),
+    join(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 = join(worktree, ".claude", name);
+    let raw;
+    try {
+      raw = readFileSync(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 = join(worktree, ".git");
+  const require2 = createRequire2(import.meta.url);
+  const { execFileSync } = require2("node:child_process");
+  const { statSync } = 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(isAbsolute2(trimmed) ? trimmed : join(worktree, trimmed));
+    }
+  } catch {}
+  gitDirs.add(dotGit);
+  for (const dir of gitDirs) {
+    paths.add(join(dir, "config"));
+    paths.add(join(dir, "config.worktree"));
+    paths.add(join(dir, "hooks"));
+  }
+  try {
+    if (statSync(dotGit).isFile())
+      paths.add(dotGit);
+  } catch {}
+  return [...paths];
+}
+function hostPersistencePaths() {
+  const home = homedir();
+  return [
+    join(home, ".zshenv"),
+    join(home, ".zprofile"),
+    join(home, ".zshrc"),
+    join(home, ".zlogin"),
+    join(home, ".bashrc"),
+    join(home, ".bash_profile"),
+    join(home, ".bash_login"),
+    join(home, ".profile"),
+    join(home, ".config", "fish", "config.fish"),
+    join(home, ".config", "fish", "conf.d"),
+    join(home, "Library", "LaunchAgents"),
+    join(home, ".config", "systemd", "user"),
+    join(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 = isAbsolute2(value) ? value : join(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 = isAbsolute2(value) ? value : join(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 = join(dirname2(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/git-pr.ts
 var exports_git_pr = {};
 __export(exports_git_pr, {
@@ -644,7 +1137,7 @@ function execFileAsync2() {
 }
 function detectGitProvider(cwd) {
   try {
-    const url = execFileSync7("git", ["remote", "get-url", "origin"], {
+    const url = execFileSync7("git", [...GIT_NO_HOOKS, "remote", "get-url", "origin"], {
       cwd,
       encoding: "utf-8"
     }).trim();
@@ -942,7 +1435,7 @@ async function mergePullRequest(prUrl, cwd, provider, strategy, deleteBranch) {
 }
 function getHeadSha(cwd) {
   try {
-    return execFileSync7("git", ["rev-parse", "HEAD"], {
+    return execFileSync7("git", [...GIT_NO_HOOKS, "rev-parse", "HEAD"], {
       cwd,
       encoding: "utf-8"
     }).trim();
@@ -1119,7 +1612,13 @@ function resolvePrUrl(description, branchName, cwd, provider) {
 }
 function remoteBranchExists(branchName, cwd) {
   try {
-    execFileSync7("git", ["ls-remote", "--exit-code", "origin", `refs/heads/${branchName}`], { cwd, stdio: "pipe" });
+    execFileSync7("git", [
+      ...GIT_NO_HOOKS,
+      "ls-remote",
+      "--exit-code",
+      "origin",
+      `refs/heads/${branchName}`
+    ], { cwd, stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -1130,21 +1629,21 @@ function pushBranch(branchName, cwd) {
     log.info(TAG13, `Remote branch ${branchName} exists (rework), force-pushing`);
     let expectedSha = null;
     try {
-      execFileSync7("git", ["fetch", "origin", branchName], {
+      execFileSync7("git", [...GIT_NO_HOOKS, "fetch", "origin", branchName], {
         cwd,
         stdio: "pipe"
       });
-      expectedSha = execFileSync7("git", ["rev-parse", `refs/remotes/origin/${branchName}`], { cwd, encoding: "utf-8" }).trim();
+      expectedSha = execFileSync7("git", [...GIT_NO_HOOKS, "rev-parse", `refs/remotes/origin/${branchName}`], { cwd, encoding: "utf-8" }).trim();
     } catch (err) {
       log.warn(TAG13, `could not resolve remote tip for ${branchName}, falling back to weak lease: ${err instanceof Error ? err.message : err}`);
     }
     const lease = expectedSha ? `--force-with-lease=refs/heads/${branchName}:${expectedSha}` : "--force-with-lease";
-    execFileSync7("git", ["push", lease, "-u", "origin", branchName], {
+    execFileSync7("git", [...GIT_NO_HOOKS, "push", lease, "-u", "origin", branchName], {
       cwd,
       stdio: "pipe"
     });
   } else {
-    execFileSync7("git", ["push", "-u", "origin", branchName], {
+    execFileSync7("git", [...GIT_NO_HOOKS, "push", "-u", "origin", branchName], {
       cwd,
       stdio: "pipe"
     });
@@ -1155,7 +1654,7 @@ function renameRemoteBranch(oldRef, newRef, cwd) {
     return;
   let sha;
   try {
-    sha = execFileSync7("git", ["rev-parse", "HEAD"], {
+    sha = execFileSync7("git", [...GIT_NO_HOOKS, "rev-parse", "HEAD"], {
       cwd,
       encoding: "utf-8"
     }).trim();
@@ -1163,9 +1662,15 @@ function renameRemoteBranch(oldRef, newRef, cwd) {
     throw new Error(`renameRemoteBranch: could not resolve HEAD: ${err instanceof Error ? err.message : err}`);
   }
   log.info(TAG13, `Renaming remote ${oldRef} → ${newRef}`);
-  execFileSync7("git", ["push", "origin", `${sha}:refs/heads/${newRef}`, "--force-with-lease"], { cwd, stdio: "pipe" });
+  execFileSync7("git", [
+    ...GIT_NO_HOOKS,
+    "push",
+    "origin",
+    `${sha}:refs/heads/${newRef}`,
+    "--force-with-lease"
+  ], { cwd, stdio: "pipe" });
   try {
-    execFileSync7("git", ["push", "origin", `:refs/heads/${oldRef}`], {
+    execFileSync7("git", [...GIT_NO_HOOKS, "push", "origin", `:refs/heads/${oldRef}`], {
       cwd,
       stdio: "pipe"
     });
@@ -1173,7 +1678,7 @@ function renameRemoteBranch(oldRef, newRef, cwd) {
     log.warn(TAG13, `renameRemoteBranch: could not delete old ref ${oldRef}: ${err instanceof Error ? err.message : err}`);
   }
   try {
-    execFileSync7("git", ["branch", "-m", oldRef, newRef], {
+    execFileSync7("git", [...GIT_NO_HOOKS, "branch", "-m", oldRef, newRef], {
       cwd,
       stdio: "pipe"
     });
@@ -1181,7 +1686,7 @@ function renameRemoteBranch(oldRef, newRef, cwd) {
 }
 function getBranchWebUrl(branchName, cwd) {
   try {
-    const remoteUrl = execFileSync7("git", ["remote", "get-url", "origin"], {
+    const remoteUrl = execFileSync7("git", [...GIT_NO_HOOKS, "remote", "get-url", "origin"], {
       cwd,
       encoding: "utf-8"
     }).trim();
@@ -1234,7 +1739,12 @@ function createPullRequest(card, branchName, worktreePath, config, provider, exi
   }
   let commitLog = "";
   try {
-    commitLog = execFileSync7("git", ["log", "--oneline", `origin/${config.worktree.baseBranch}..HEAD`], { cwd: worktreePath, encoding: "utf-8" }).trim();
+    commitLog = execFileSync7("git", [
+      ...GIT_NO_HOOKS,
+      "log",
+      "--oneline",
+      `origin/${config.worktree.baseBranch}..HEAD`
+    ], { cwd: worktreePath, encoding: "utf-8" }).trim();
   } catch {
     commitLog = "(unable to retrieve commit log)";
   }
@@ -1342,6 +1852,7 @@ var cachedExecFileAsync2, TAG13 = "git-pr", VALID_PR_URL_RE, PR_URL_RE, REVIEWED
 var init_git_pr = __esm(() => {
   init_dist();
   init_log();
+  init_run_containment();
   VALID_PR_URL_RE = /^https:\/\/(github\.com|gitlab\.com|dev\.azure\.com|bitbucket\.org)\//;
   PR_URL_RE = /PR:\s*(https?:\/\/[^\s)]+)/;
   REVIEWED_SHA_RE = /^Reviewed-SHA:\s*([0-9a-f]{7,40})\s*$/im;
@@ -1627,6 +2138,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;
       },
@@ -2043,6 +2555,7 @@ class ArtifactCollector {
 }
 // src/ci-failure.ts
 init_log();
+init_run_containment();
 import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";
 function createExecFileAsync() {
@@ -2070,7 +2583,7 @@ function isPrOnOrigin(prUrl, cwd) {
   if (!prSlug)
     return false;
   try {
-    const remote = execFileSync("git", ["remote", "get-url", "origin"], {
+    const remote = execFileSync("git", [...GIT_NO_HOOKS, "remote", "get-url", "origin"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -2222,14 +2735,14 @@ var MAX_METRIC_TIMEOUT_MS = 900000;
 var METRIC_SIGINT_GRACE_MS = 2000;
 var METRIC_SIGTERM_GRACE_MS = 3000;
 var STDIO_DRAIN_GRACE_MS = 500;
-function parseParseMode(parse) {
-  if (typeof parse !== "string" || parse.length === 0) {
+function parseParseMode(parse2) {
+  if (typeof parse2 !== "string" || parse2.length === 0) {
     return { kind: "invalid", reason: "`parse` must be a non-empty string" };
   }
-  if (parse === "number")
+  if (parse2 === "number")
     return { kind: "number" };
-  if (parse.startsWith("json:")) {
-    const path = parse.slice("json:".length).trim();
+  if (parse2.startsWith("json:")) {
+    const path = parse2.slice("json:".length).trim();
     if (!path) {
       return { kind: "invalid", reason: '`parse` "json:" is missing a path' };
     }
@@ -2237,7 +2750,7 @@ function parseParseMode(parse) {
   }
   return {
     kind: "invalid",
-    reason: `unknown \`parse\` mode "${parse}" (expected "number" or "json:<path>")`
+    reason: `unknown \`parse\` mode "${parse2}" (expected "number" or "json:<path>")`
   };
 }
 function parseMetricValue(mode, stdout) {
@@ -2283,7 +2796,7 @@ function parseMetricValue(mode, stdout) {
   return { ok: true, value: resolved };
 }
 function runMetricCommand(args) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     let child;
     try {
       child = spawnInGroup(args.command, args.args, {
@@ -2314,7 +2827,7 @@ function runMetricCommand(args) {
       if (failure)
         reject(failure);
       else
-        resolve(Buffer.concat(chunks).toString("utf8"));
+        resolve2(Buffer.concat(chunks).toString("utf8"));
     };
     const killTree = (reason) => {
       if (settled || killReason)
@@ -2462,123 +2975,20 @@ function describeRunFailure(err, timeoutMs) {
 function truncate(value, max) {
   return value.length <= max ? value : `${value.slice(0, max)}…[truncated]`;
 }
-// src/confine-to-repo.ts
-import { realpathSync } from "node:fs";
-import { dirname, isAbsolute, parse, resolve, sep } from "node:path";
-var READ_PATH_ARGS = {
-  Read: ["file_path", "path", "notebook_path"],
-  Grep: ["path"],
-  Glob: ["path"]
-};
-var WRITE_PATH_ARGS = {
-  Write: ["file_path"],
-  Edit: ["file_path"],
-  MultiEdit: ["file_path"],
-  NotebookEdit: ["notebook_path"]
-};
-var CONFINED_READ_TOOLS = Object.freeze(Object.keys(READ_PATH_ARGS));
-var CONFINED_WRITE_TOOLS = Object.freeze([
-  ...Object.keys(READ_PATH_ARGS),
-  ...Object.keys(WRITE_PATH_ARGS).filter((t) => t !== "MultiEdit")
-]);
-var PATTERN_ARG_BY_TOOL = {
-  Glob: ["pattern"],
-  Grep: ["glob"]
-};
-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 (isAbsolute(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 = isAbsolute(p) ? p : resolve(p);
-  const { root } = parse(abs);
-  let real = root;
-  for (const part of abs.slice(root.length).split(sep)) {
-    if (part === "" || part === ".")
-      continue;
-    if (part === "..") {
-      real = dirname(real);
-      continue;
-    }
-    const next = real.endsWith(sep) ? real + part : real + sep + 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 + sep);
-}
-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 = isAbsolute(value) ? value : `${repoRoot}${sep}${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);
-}
+
+// src/index.ts
+init_confine_to_repo();
+
 // src/gate-collectors.ts
 init_dist();
 init_log();
 
 // src/oracle-collector.ts
-import { createHash } from "node:crypto";
+import { createHash as createHash2 } from "node:crypto";
 init_log();
 
 // src/oracle.ts
-import { lstatSync, readFileSync, statSync } from "node:fs";
+import { lstatSync, readFileSync as readFileSync2, statSync } from "node:fs";
 import {
   chmod,
   lstat,
@@ -2588,13 +2998,13 @@ import {
   rm,
   writeFile
 } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { dirname as dirname2, isAbsolute as isAbsolute2, join, resolve as resolve2, sep as sep2 } from "node:path";
+import { tmpdir as tmpdir2 } from "node:os";
+import { dirname as dirname3, isAbsolute as isAbsolute3, join as join2, resolve as resolve2, sep as sep2 } from "node:path";
 import { StringDecoder } from "node:string_decoder";
 init_log();
 var TAG5 = "oracle";
 async function resolveContained(repoPath, relativePath) {
-  if (isAbsolute2(relativePath)) {
+  if (isAbsolute3(relativePath)) {
     throw new Error(`refusing to place an oracle at an absolute path: ${relativePath}`);
   }
   if (relativePath === "" || relativePath === ".") {
@@ -2617,7 +3027,7 @@ async function resolveContained(repoPath, relativePath) {
 }
 async function place(repoPath, oracle) {
   const target = await resolveContained(repoPath, oracle.path);
-  await mkdir(dirname2(target), { recursive: true });
+  await mkdir(dirname3(target), { recursive: true });
   await writeFile(target, oracle.content, "utf8");
 }
 async function remove(repoPath, oracle) {
@@ -2725,8 +3135,8 @@ function argvPath(path) {
 }
 async function runHeldOracle(repoPath, oracle, timeoutMs = DEFAULT_METRIC_TIMEOUT_MS) {
   const spec = resolveOracleRunnerSpec(oracle);
-  const reportDir = await mkdtemp(join(tmpdir(), reportDirPrefix()));
-  const reportPath = join(reportDir, spec.report.file);
+  const reportDir = await mkdtemp(join2(tmpdir2(), reportDirPrefix()));
+  const reportPath = join2(reportDir, spec.report.file);
   try {
     return await spawnHeldOracle(spec, repoPath, oracle, reportPath, timeoutMs);
   } finally {
@@ -2737,7 +3147,7 @@ function reportDirPrefix() {
   return "harmony-oracle-report-";
 }
 function assertUntampered(reportPath) {
-  const dir = statSync(dirname2(reportPath));
+  const dir = statSync(dirname3(reportPath));
   if ((dir.mode & 511) !== 448) {
     throw new Error(`the oracle report directory's mode changed to ${(dir.mode & 511).toString(8)} — refusing the report`);
   }
@@ -2800,7 +3210,7 @@ ${output}` : output;
     const captureReport = () => {
       try {
         assertUntampered(reportPath);
-        report = spec.report.parse(readFileSync(reportPath, "utf8"));
+        report = spec.report.parse(readFileSync2(reportPath, "utf8"));
       } catch (err) {
         report = null;
         const message = err instanceof Error ? err.message : String(err);
@@ -2918,7 +3328,7 @@ class HeldOracleCollector {
   async runHeld(oracle) {
     const identity = {
       oracleId: oracle.id ?? null,
-      contentHash: createHash("sha256").update(oracle.content).digest("hex")
+      contentHash: createHash2("sha256").update(oracle.content).digest("hex")
     };
     await this.deps.place(this.deps.repoPath, oracle);
     try {
@@ -3034,6 +3444,7 @@ import { execFileSync as execFileSync5, spawn as spawn2 } from "node:child_proce
 
 // src/pm.ts
 init_log();
+init_run_containment();
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { existsSync } from "node:fs";
 var TAG7 = "pm";
@@ -3043,7 +3454,7 @@ function detectPackageManager() {
     return cached;
   let repoRoot;
   try {
-    repoRoot = execFileSync2("git", ["rev-parse", "--show-toplevel"], {
+    repoRoot = execFileSync2("git", [...GIT_NO_HOOKS, "rev-parse", "--show-toplevel"], {
       encoding: "utf-8"
     }).trim();
   } catch {
@@ -3086,7 +3497,7 @@ function spawnRunArgs(script, ...extra) {
 // src/project-type.ts
 init_log();
 import { execFileSync as execFileSync3 } 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 TAG8 = "project-type";
 var _cache = new Map;
 function _resetCache() {
@@ -3189,7 +3600,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(TAG8, `Could not read package.json in ${dir}: ${err instanceof Error ? err.message : err}`);
@@ -3206,7 +3617,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(TAG8, `Could not read package.json in ${dir}: ${err instanceof Error ? err.message : err}`);
@@ -3263,6 +3674,7 @@ function resolveXcodeScheme(pt) {
 
 // src/revert-guard.ts
 init_log();
+init_run_containment();
 import { execFileSync as execFileSync4 } from "node:child_process";
 var TAG9 = "revert-guard";
 var TEST_FILE = /(?:^|\/)__tests__\/|\.(?:test|spec)\.[cm]?[jt]sx?$/;
@@ -3274,7 +3686,7 @@ function filterTestFiles(paths) {
 }
 function refetchBase(worktreePath, baseBranch) {
   try {
-    execFileSync4("git", ["fetch", "origin", baseBranch], {
+    execFileSync4("git", [...GIT_NO_HOOKS, "fetch", "origin", baseBranch], {
       cwd: worktreePath,
       stdio: "pipe"
     });
@@ -3284,7 +3696,13 @@ function refetchBase(worktreePath, baseBranch) {
 }
 function listDeletedFilesAgainstBase(worktreePath, baseBranch) {
   try {
-    const out = execFileSync4("git", ["diff", "--diff-filter=D", "--name-only", `origin/${baseBranch}...HEAD`], { cwd: worktreePath, encoding: "utf-8" });
+    const out = execFileSync4("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) {
@@ -3298,6 +3716,7 @@ function findDeletedTestFiles(worktreePath, baseBranch) {
 }
 
 // src/verification.ts
+init_run_containment();
 var TAG10 = "verification";
 var MAX_OUTPUT_BUFFER2 = 64 * 1024 * 1024;
 async function runVerification(worktreePath, config, workerId) {
@@ -3371,7 +3790,8 @@ function runBuild(worktreePath, timeout) {
       cwd: worktreePath,
       timeout,
       stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
+      maxBuffer: MAX_OUTPUT_BUFFER2,
+      env: containedEnv()
     });
     return [];
   } catch (err) {
@@ -3389,7 +3809,8 @@ function runTests(worktreePath, timeout) {
       cwd: worktreePath,
       timeout,
       stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
+      maxBuffer: MAX_OUTPUT_BUFFER2,
+      env: containedEnv()
     });
     return [];
   } catch (err) {
@@ -3408,7 +3829,8 @@ function runFormatFix(worktreePath, timeout, workerId) {
       cwd: worktreePath,
       timeout,
       stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
+      maxBuffer: MAX_OUTPUT_BUFFER2,
+      env: containedEnv()
     });
     log.info(TAG10, `[worker:${workerId}] Auto-formatted worktree before commit/push`);
   } catch (err) {
@@ -3426,7 +3848,8 @@ function runLint(worktreePath, timeout) {
       cwd: worktreePath,
       timeout,
       stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
+      maxBuffer: MAX_OUTPUT_BUFFER2,
+      env: containedEnv()
     });
     return [];
   } catch (err) {
@@ -3444,7 +3867,8 @@ 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);
@@ -3455,7 +3879,7 @@ async function runDeepReview(worktreePath, config, workerId) {
     }
     let diff = "";
     try {
-      diff = execFileSync5("git", ["diff", `origin/${config.worktree.baseBranch}..HEAD`], {
+      diff = execFileSync5("git", [...GIT_NO_HOOKS, "diff", `origin/${config.worktree.baseBranch}..HEAD`], {
         cwd: worktreePath,
         encoding: "utf-8",
         timeout: 30000,
@@ -3476,14 +3900,16 @@ async function runDeepReview(worktreePath, config, workerId) {
       "```"
     ].join(`
 `);
-    const leanSources = config.claude.leanSettingSources;
     const output = execFileSync5("claude", [
       "--print",
       "--model",
       "sonnet",
       "--max-turns",
       "10",
-      ...leanSources ? ["--setting-sources", leanSources] : [],
+      ...implementRunContainmentCliArgs({
+        worktree: worktreePath,
+        readOnly: true
+      }),
       "--",
       reviewPrompt
     ], {
@@ -3491,7 +3917,8 @@ async function runDeepReview(worktreePath, config, workerId) {
       encoding: "utf-8",
       timeout: config.verification.timeout,
       stdio: "pipe",
-      maxBuffer: MAX_OUTPUT_BUFFER2
+      maxBuffer: MAX_OUTPUT_BUFFER2,
+      env: containedEnv()
     });
     return parseReviewFindings(output);
   } catch (err) {
@@ -3521,7 +3948,6 @@ function attemptAutoFix(worktreePath, config, errors) {
     "```"
   ].join(`
 `);
-  const leanSources = config.claude.leanSettingSources;
   const args = [
     "--print",
     "--model",
@@ -3530,7 +3956,7 @@ function attemptAutoFix(worktreePath, config, errors) {
     "50",
     "--allowedTools",
     "Bash,Read,Write,Edit,Glob,Grep",
-    ...leanSources ? ["--setting-sources", leanSources] : [],
+    ...implementRunContainmentCliArgs({ worktree: worktreePath }),
     "--",
     fixPrompt
   ];
@@ -3539,7 +3965,8 @@ function attemptAutoFix(worktreePath, config, errors) {
     cwd: worktreePath,
     timeout: config.verification.timeout,
     stdio: "pipe",
-    maxBuffer: MAX_OUTPUT_BUFFER2
+    maxBuffer: MAX_OUTPUT_BUFFER2,
+    env: containedEnv()
   });
 }
 async function reportFindings(client, cardId, result, recovery) {
@@ -3872,6 +4299,7 @@ async function collectGateEvidence(registry, context) {
 }
 // src/git-diff-stat.ts
 init_log();
+init_run_containment();
 import { execFileSync as execFileSync6 } from "node:child_process";
 var TAG12 = "git-diff-stat";
 var MAX_CHANGED_FILES = 30;
@@ -3952,7 +4380,7 @@ function formatDiffSummary(diff, maxFiles = 100) {
 }
 function captureDiffStat(worktreePath, baseBranch, maxFiles = MAX_CHANGED_FILES) {
   try {
-    const raw = execFileSync6("git", ["diff", "--numstat", `${baseBranch}...HEAD`], { cwd: worktreePath, encoding: "utf-8", timeout: 30000 });
+    const raw = execFileSync6("git", [...GIT_NO_HOOKS, "diff", "--numstat", `${baseBranch}...HEAD`], { cwd: worktreePath, encoding: "utf-8", timeout: 30000 });
     return parseNumstat(raw, maxFiles);
   } catch (err) {
     log.warn(TAG12, "git diff --numstat failed", {
@@ -4196,54 +4624,14 @@ async function runInSandbox(args) {
     return { passed: false, output };
   }
 }
-// src/run-sizing.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/index.ts
+init_run_containment();
 
 // src/run-sizing.ts
+init_dist();
+init_confine_to_repo();
+init_runner();
 var SIZING_MODEL = "haiku";
 var SIZING_MAX_TURNS = 25;
 var SIZING_MAX_BUDGET_USD = 0.75;
@@ -4417,6 +4805,10 @@ async function sizeRun(deps) {
       clearTimeout(timer);
   }
 }
+
+// src/index.ts
+init_runner();
+
 // src/stage-run.ts
 async function runStage(request, deps) {
   const events = [];
@@ -4446,6 +4838,7 @@ init_log();
 import { execFileSync as execFileSync8, execSync } from "node:child_process";
 import { existsSync as existsSync3, readdirSync as readdirSync2, rmSync } from "node:fs";
 import { resolve as resolve3 } from "node:path";
+init_run_containment();
 var TAG16 = "worktree";
 
 class WorktreeBaseError extends Error {
@@ -4454,7 +4847,7 @@ class WorktreeBaseError extends Error {
     this.name = "WorktreeBaseError";
   }
 }
-function fetchBaseBranch(repoRoot, baseBranch, attempts = 3, fetchImpl = (root, branch) => execFileSync8("git", ["fetch", "origin", branch], {
+function fetchBaseBranch(repoRoot, baseBranch, attempts = 3, fetchImpl = (root, branch) => execFileSync8("git", [...GIT_NO_HOOKS, "fetch", "origin", branch], {
   cwd: root,
   stdio: "pipe"
 })) {
@@ -4480,7 +4873,41 @@ function resolveWorktreeStartRef(baseBranch, branchName, continueExisting, branc
   }
   return `origin/${baseBranch}`;
 }
-function fetchExistingBranch(repoRoot, branchName, attempts = 3, lsRemoteImpl = (root, branch) => execFileSync8("git", ["ls-remote", "--exit-code", "origin", `refs/heads/${branch}`], { cwd: root, stdio: "pipe" }), fetchImpl = (root, branch) => execFileSync8("git", [
+function resolveContinuationTarget(branchName, continueRequested, failedBranchPrefix, approvedBranchPrefix, branchExistsOnOrigin) {
+  if (branchExistsOnOrigin(branchName)) {
+    return {
+      branchName,
+      continueExisting: true,
+      existsOnOrigin: true,
+      reason: continueRequested ? "requested" : "exists_on_origin"
+    };
+  }
+  if (failedBranchPrefix && approvedBranchPrefix && branchName.startsWith(failedBranchPrefix)) {
+    const sibling = approvedBranchPrefix + branchName.slice(failedBranchPrefix.length);
+    if (branchExistsOnOrigin(sibling)) {
+      return {
+        branchName: sibling,
+        continueExisting: true,
+        existsOnOrigin: true,
+        reason: "approved_rename"
+      };
+    }
+  }
+  return {
+    branchName,
+    continueExisting: continueRequested,
+    existsOnOrigin: false,
+    reason: "fresh"
+  };
+}
+function fetchExistingBranch(repoRoot, branchName, attempts = 3, lsRemoteImpl = (root, branch) => execFileSync8("git", [
+  ...GIT_NO_HOOKS,
+  "ls-remote",
+  "--exit-code",
+  "origin",
+  `refs/heads/${branch}`
+], { cwd: root, stdio: "pipe" }), fetchImpl = (root, branch) => execFileSync8("git", [
+  ...GIT_NO_HOOKS,
   "fetch",
   "origin",
   `+refs/heads/${branch}:refs/remotes/origin/${branch}`
@@ -4514,7 +4941,7 @@ function fetchExistingBranch(repoRoot, branchName, attempts = 3, lsRemoteImpl =
 }
 function readWorktreeHead(worktreePath) {
   try {
-    return execFileSync8("git", ["rev-parse", "HEAD"], {
+    return execFileSync8("git", [...GIT_NO_HOOKS, "rev-parse", "HEAD"], {
       cwd: worktreePath,
       encoding: "utf-8"
     }).trim();
@@ -4523,7 +4950,7 @@ function readWorktreeHead(worktreePath) {
   }
 }
 function createWorktree(basePath, baseBranch, branchName, opts = {}) {
-  const repoRoot = execFileSync8("git", ["rev-parse", "--show-toplevel"], {
+  const repoRoot = execFileSync8("git", [...GIT_NO_HOOKS, "rev-parse", "--show-toplevel"], {
     encoding: "utf-8"
   }).trim();
   const worktreeDir = resolve3(repoRoot, basePath, branchName);
@@ -4532,46 +4959,63 @@ function createWorktree(basePath, baseBranch, branchName, opts = {}) {
     cleanupWorktree(worktreeDir, branchName);
   }
   try {
-    execFileSync8("git", ["worktree", "prune", "--expire=now"], {
+    execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "prune", "--expire=now"], {
       cwd: repoRoot,
       stdio: "pipe"
     });
   } catch {}
   fetchBaseBranch(repoRoot, baseBranch);
-  const startRef = resolveWorktreeStartRef(baseBranch, branchName, opts.continueExisting ?? false, () => fetchExistingBranch(repoRoot, branchName));
+  const startRef = resolveWorktreeStartRef(baseBranch, branchName, opts.continueExisting ?? false, () => opts.branchExistsOnOrigin ?? fetchExistingBranch(repoRoot, branchName));
   log.info(TAG16, `Creating worktree: ${worktreeDir} (branch: ${branchName}, base: ${startRef})`);
   try {
-    execFileSync8("git", ["worktree", "add", "-B", branchName, worktreeDir, startRef], { cwd: repoRoot, stdio: "pipe" });
+    execFileSync8("git", [
+      ...GIT_NO_HOOKS,
+      "worktree",
+      "add",
+      "-B",
+      branchName,
+      worktreeDir,
+      startRef
+    ], { cwd: repoRoot, stdio: "pipe" });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     log.warn(TAG16, `worktree add failed, attempting forced recovery: ${msg}`);
     removeWorktreeHoldingBranch(repoRoot, branchName, worktreeDir);
     try {
-      execFileSync8("git", ["worktree", "remove", worktreeDir, "--force"], {
+      execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "remove", worktreeDir, "--force"], {
         cwd: repoRoot,
         stdio: "pipe"
       });
     } catch {}
     try {
-      execFileSync8("git", ["worktree", "prune", "--expire=now"], {
+      execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "prune", "--expire=now"], {
         cwd: repoRoot,
         stdio: "pipe"
       });
     } catch {}
     try {
-      execFileSync8("git", ["branch", "-D", branchName], {
+      execFileSync8("git", [...GIT_NO_HOOKS, "branch", "-D", branchName], {
         cwd: repoRoot,
         stdio: "pipe"
       });
     } catch {}
-    execFileSync8("git", ["worktree", "add", "-B", branchName, worktreeDir, startRef], { cwd: repoRoot, stdio: "pipe" });
+    execFileSync8("git", [
+      ...GIT_NO_HOOKS,
+      "worktree",
+      "add",
+      "-B",
+      branchName,
+      worktreeDir,
+      startRef
+    ], { cwd: repoRoot, stdio: "pipe" });
   }
   log.info(TAG16, "Installing dependencies in worktree...");
   try {
-    execSync(installCommand(), {
+    execSync(installCommand(true), {
       cwd: worktreeDir,
       stdio: "pipe",
-      timeout: 60000
+      timeout: 60000,
+      env: containedEnv()
     });
   } catch {
     log.warn(TAG16, "Install failed (may be fine if deps are hoisted)");
@@ -4590,7 +5034,7 @@ function containsForeignWorktrees(dir) {
   return children.some((child) => existsSync3(resolve3(dir, child, ".git")));
 }
 function cleanupWorktree(worktreePath, branchName) {
-  const repoRoot = execFileSync8("git", ["rev-parse", "--show-toplevel"], {
+  const repoRoot = execFileSync8("git", [...GIT_NO_HOOKS, "rev-parse", "--show-toplevel"], {
     encoding: "utf-8"
   }).trim();
   if (existsSync3(worktreePath)) {
@@ -4598,7 +5042,7 @@ function cleanupWorktree(worktreePath, branchName) {
       throw new Error(`Refusing to remove ${worktreePath}: it is not a git worktree itself, ` + `but git worktrees live directly beneath it. Removing it would ` + `destroy them — pass the individual worktree paths instead (#928).`);
     }
     try {
-      execFileSync8("git", ["worktree", "remove", worktreePath, "--force"], {
+      execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "remove", worktreePath, "--force"], {
         cwd: repoRoot,
         stdio: "pipe"
       });
@@ -4609,7 +5053,7 @@ function cleanupWorktree(worktreePath, branchName) {
         rmSync(worktreePath, { recursive: true, force: true });
       }
       try {
-        execFileSync8("git", ["worktree", "prune", "--expire=now"], {
+        execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "prune", "--expire=now"], {
           cwd: repoRoot,
           stdio: "pipe"
         });
@@ -4617,7 +5061,7 @@ function cleanupWorktree(worktreePath, branchName) {
     }
   } else {
     try {
-      execFileSync8("git", ["worktree", "prune", "--expire=now"], {
+      execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "prune", "--expire=now"], {
         cwd: repoRoot,
         stdio: "pipe"
       });
@@ -4625,7 +5069,7 @@ function cleanupWorktree(worktreePath, branchName) {
   }
   if (branchName) {
     try {
-      execFileSync8("git", ["branch", "-D", branchName], {
+      execFileSync8("git", [...GIT_NO_HOOKS, "branch", "-D", branchName], {
         cwd: repoRoot,
         stdio: "pipe"
       });
@@ -4635,7 +5079,7 @@ function cleanupWorktree(worktreePath, branchName) {
 function removeWorktreeHoldingBranch(repoRoot, branchName, exceptDir) {
   let listing;
   try {
-    listing = execFileSync8("git", ["worktree", "list", "--porcelain"], {
+    listing = execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "list", "--porcelain"], {
       cwd: repoRoot,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -4663,7 +5107,7 @@ function removeWorktreeHoldingBranch(repoRoot, branchName, exceptDir) {
   if (exceptDir && resolve3(holderPath) === resolve3(exceptDir))
     return null;
   try {
-    execFileSync8("git", ["worktree", "remove", holderPath, "--force"], {
+    execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "remove", holderPath, "--force"], {
       cwd: repoRoot,
       stdio: "pipe"
     });
@@ -4673,7 +5117,7 @@ function removeWorktreeHoldingBranch(repoRoot, branchName, exceptDir) {
     return null;
   }
   try {
-    execFileSync8("git", ["worktree", "prune", "--expire=now"], {
+    execFileSync8("git", [...GIT_NO_HOOKS, "worktree", "prune", "--expire=now"], {
       cwd: repoRoot,
       stdio: "pipe"
     });
@@ -4681,13 +5125,19 @@ function removeWorktreeHoldingBranch(repoRoot, branchName, exceptDir) {
   return holderPath;
 }
 function resolveRepoRoot() {
-  return execFileSync8("git", ["rev-parse", "--show-toplevel"], {
+  return execFileSync8("git", [...GIT_NO_HOOKS, "rev-parse", "--show-toplevel"], {
     encoding: "utf-8"
   }).trim();
 }
 function localBranchExists(branchName, repoRoot) {
   try {
-    execFileSync8("git", ["show-ref", "--verify", "--quiet", `refs/heads/${branchName}`], { cwd: repoRoot, stdio: "ignore" });
+    execFileSync8("git", [
+      ...GIT_NO_HOOKS,
+      "show-ref",
+      "--verify",
+      "--quiet",
+      `refs/heads/${branchName}`
+    ], { cwd: repoRoot, stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -4697,7 +5147,7 @@ function branchAheadOfItsRemote(branchName, repoRoot = resolveRepoRoot()) {
   if (!localBranchExists(branchName, repoRoot))
     return false;
   try {
-    const out = execFileSync8("git", ["rev-list", branchName, "--not", "--remotes=origin"], { cwd: repoRoot, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+    const out = execFileSync8("git", [...GIT_NO_HOOKS, "rev-list", branchName, "--not", "--remotes=origin"], { cwd: repoRoot, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).trim();
     return out.length > 0;
   } catch {
     return false;
@@ -4750,11 +5200,13 @@ function makeBranchName(shortId, title, prefix = "agent-attempts/") {
 // src/index.ts
 var MOTOR_NAME = "harmony-harness";
 export {
+  writeOnlyDenyPaths,
   waitForDevServer,
   validateGitProviderCli,
   upsertReviewedSha,
   upsertCiReviewRequestedSha,
   updateExistingPr,
+  toolchainCacheDirectories,
   testCommand,
   terminateGroup,
   teardownWorktree,
@@ -4767,6 +5219,7 @@ export {
   sizingEventSource,
   sizeRun,
   signalGroup,
+  secretEnvKeysToStrip,
   sanitizeCiText,
   sandboxRunArgs,
   sandboxAvailable,
@@ -4787,6 +5240,7 @@ export {
   resolvePrUrl,
   resolvePrHeadBranch,
   resolveOracleRunner,
+  resolveContinuationTarget,
   rescueUnpushedBranch,
   rerunFailedJobs,
   requestIndependentReview,
@@ -4820,7 +5274,13 @@ export {
   isPrOnOrigin,
   isInsideTree,
   installCommand,
+  implementRunToolPolicy,
+  implementRunContainmentCliArgs,
+  implementRunContainment,
+  hostPersistencePaths,
+  harmonyMcpServer,
   gradeOracleRed,
+  gitMetadataDenyPaths,
   getPrStatus,
   getPrFailedChecks,
   getHeadSha,
@@ -4850,10 +5310,14 @@ export {
   deriveCiStatus,
   decidePrBranch,
   decideConfinedTool,
+  credentialWriteToolDeny,
+  credentialToolDeny,
+  credentialDirectories,
   credentialAccessDeny,
   createWorktree,
   createPullRequest,
   cooldownMsFor,
+  containedEnv,
   confineToRepo,
   collectSizingOutput,
   collectGateEvidence,
@@ -4872,6 +5336,7 @@ export {
   buildCommand,
   branchAheadOfItsRemote,
   attemptAutoFix,
+  assertNoProjectSandboxOverride,
   _resetCache,
   __resetSandboxProbe,
   WorktreeBaseError,
@@ -4880,6 +5345,7 @@ export {
   SDK_ALLOWED_TOOLS,
   SANDBOX_MOUNT,
   ReviewPassedCollector,
+  ProjectSandboxOverrideError,
   OracleRedCollector,
   OracleCollector,
   ORACLE_RUNNER_HINTS,
@@ -4889,8 +5355,10 @@ export {
   MAX_IMPLEMENT_MODEL,
   MAX_CHANGED_FILES,
   JUDGE_MODEL,
+  IMPLEMENT_ALLOWED_DOMAINS,
   HarmonyClient,
   HARMONY_CREDENTIAL_KEYS,
+  GIT_NO_HOOKS,
   GATE_CONFIG_ERROR_MARK,
   GATE_CONFIG_ERROR_KEY,
   DevServerReadinessError,