@h-rig/isolation-plugin 0.0.6-alpha.157 → 0.0.6-alpha.158

package/dist/src/isolation/toolchain.js

@@ -0,0 +1,1348 @@
+// @bun
+// packages/isolation-plugin/src/isolation/toolchain.ts
+import {
+  existsSync as existsSync5,
+  lstatSync,
+  mkdirSync as mkdirSync5,
+  readdirSync,
+  readFileSync as readFileSync3,
+  rmSync as rmSync4,
+  statSync as statSync3,
+  symlinkSync
+} from "fs";
+import { mkdir, writeFile } from "fs/promises";
+import { dirname as dirname4, resolve as resolve5 } from "path";
+import { assertPathInsideRoot, safePathSegment } from "@rig/core/safe-identifiers";
+
+// packages/isolation-plugin/src/isolation/runtime-binary-build.ts
+import { chmodSync, copyFileSync, cpSync, existsSync as existsSync2, linkSync, mkdirSync as mkdirSync2, renameSync as renameSync2, rmSync, writeFileSync as writeFileSync2 } from "fs";
+import { basename, dirname, resolve as resolve2 } from "path";
+import { fileURLToPath } from "url";
+import { drainMicrotasks, gcAndSweep } from "bun:jsc";
+import { resolveRigLayout } from "@rig/core/layout";
+import { runtimeProvisioningEnv } from "@rig/core/runtime-provisioning-env";
+
+// packages/isolation-plugin/src/native-extract.ts
+import { existsSync, mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { resolve } from "path";
+
+// packages/isolation-plugin/src/embedded-native-assets.ts
+var embeddedNatives = null;
+
+// packages/isolation-plugin/src/native-extract.ts
+var sharedNativeOutputDir = resolve(tmpdir(), "rig-native");
+var extractionCache = {};
+function hasEmbeddedNatives() {
+  return embeddedNatives != null;
+}
+function extractEmbeddedNative(name) {
+  if (name in extractionCache) {
+    return extractionCache[name] ?? null;
+  }
+  const entry = embeddedNatives?.[name];
+  if (!entry) {
+    extractionCache[name] = null;
+    return null;
+  }
+  try {
+    const targetPath = resolve(sharedNativeOutputDir, entry.fileName);
+    mkdirSync(sharedNativeOutputDir, { recursive: true });
+    const upToDate = existsSync(targetPath) && statSync(targetPath).size === entry.size;
+    if (!upToDate) {
+      const bytes = readFileSync(entry.filePath);
+      const tempPath = `${targetPath}.${process.pid}.${Date.now()}.tmp`;
+      writeFileSync(tempPath, bytes, { mode: 493 });
+      renameSync(tempPath, targetPath);
+    }
+    extractionCache[name] = targetPath;
+  } catch {
+    extractionCache[name] = null;
+  }
+  return extractionCache[name] ?? null;
+}
+
+// packages/isolation-plugin/src/isolation/runtime-binary-build.ts
+var runtimeRigCliBinaryExternals = ["mupdf"];
+var runtimeBinaryBuildQueue = Promise.resolve();
+function materializeSelfExecRole(outputPath, define) {
+  const selfPath = process.execPath;
+  mkdirSync2(dirname(outputPath), { recursive: true });
+  rmSync(outputPath, { force: true });
+  try {
+    linkSync(selfPath, outputPath);
+  } catch {
+    copyFileSync(selfPath, outputPath);
+  }
+  chmodSync(outputPath, 493);
+  const role = basename(outputPath).replace(/\.exe$/i, "");
+  writeFileSync2(`${outputPath}.rig-runconfig.json`, `${JSON.stringify({ role, define: define ?? {} }, null, 2)}
+`, { mode: 384 });
+}
+async function buildBinary(entrypoint, outputPath, cwd, defines, external) {
+  if (hasEmbeddedNatives()) {
+    materializeSelfExecRole(outputPath, defines);
+    return;
+  }
+  await buildRuntimeBinary({
+    sourcePath: entrypoint,
+    outputPath,
+    cwd,
+    ...defines ? { define: defines } : {},
+    env: runtimeProvisioningEnv(),
+    ...external ? { external } : {}
+  });
+}
+async function buildRuntimeBinary(options) {
+  return runSerializedRuntimeBinaryBuild(async () => {
+    const resolved = resolveRuntimeBinaryBuildOptions(options);
+    runBestEffortBuildGc();
+    const manifestPath = runtimeBinaryCacheManifestPath(resolved.outputPath);
+    const buildKey = createRuntimeBinaryBuildKey({
+      entrypoint: resolved.entrypoint,
+      define: resolved.define,
+      env: resolved.env,
+      external: resolved.external
+    });
+    if (await isRuntimeBinaryBuildFresh({ outputPath: resolved.outputPath, manifestPath, buildKey })) {
+      return;
+    }
+    if (shouldUseRuntimeBinaryBuildWorker()) {
+      await buildRuntimeBinaryViaWorker(resolved);
+    } else {
+      await buildRuntimeBinaryInProcess(resolved, { manifestPath, buildKey });
+    }
+    runBestEffortBuildGc();
+  });
+}
+async function buildRuntimeBinaryInProcess(options, manifest) {
+  const tempBuildDir = resolve2(dirname(options.outputPath), `.bun-build-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+  const tempOutputPath = resolve2(tempBuildDir, basename(options.outputPath));
+  mkdirSync2(tempBuildDir, { recursive: true });
+  await withTemporaryEnv({
+    ...options.env,
+    ...options.define ? { RIG_BUILD_CONFIG_JSON: JSON.stringify(options.define) } : {}
+  }, async () => withTemporaryCwd(tempBuildDir, async () => {
+    const buildResult = await Bun.build({
+      entrypoints: [options.entrypoint],
+      compile: {
+        target: currentCompileTarget(),
+        outfile: tempOutputPath
+      },
+      target: "bun",
+      format: "esm",
+      minify: true,
+      bytecode: true,
+      metafile: true,
+      ...options.external ? { external: options.external } : {},
+      ...options.define ? { define: { __RIG_BUILD_CONFIG__: JSON.stringify(options.define) } } : {}
+    });
+    if (!buildResult.success) {
+      const details = buildResult.logs.map((log) => [log.message, log.position?.file ? `${log.position.file}:${log.position.line}:${log.position.column}` : ""].filter(Boolean).join(" ")).filter(Boolean).join(`
+`);
+      throw new Error(`Failed to build ${options.entrypoint}: ${details || "Bun.build() returned errors"}`);
+    }
+    if (!existsSync2(tempOutputPath)) {
+      const emitted = buildResult.outputs.map((output) => output.path).join(", ") || "(none)";
+      throw new Error(`Failed to build ${options.entrypoint}: Bun.build() did not emit ${tempOutputPath}. Emitted: ${emitted}`);
+    }
+    renameSync2(tempOutputPath, options.outputPath);
+    chmodSync(options.outputPath, 493);
+    if (manifest) {
+      await writeRuntimeBinaryCacheManifest({
+        manifestPath: manifest.manifestPath,
+        buildKey: manifest.buildKey,
+        cwd: tempBuildDir,
+        metafile: buildResult.metafile
+      });
+    }
+  })).finally(() => {
+    rmSync(tempBuildDir, { recursive: true, force: true });
+  });
+}
+function runBestEffortBuildGc() {
+  try {
+    drainMicrotasks();
+  } catch {}
+  try {
+    gcAndSweep();
+  } catch {}
+}
+function runtimeBinaryCacheManifestPath(outputPath) {
+  return `${outputPath}.build-manifest.json`;
+}
+function resolveRuntimeBinaryBuildOptions(options) {
+  return {
+    ...options,
+    entrypoint: resolve2(options.cwd, options.sourcePath),
+    outputPath: resolve2(options.outputPath)
+  };
+}
+function shouldUseRuntimeBinaryBuildWorker() {
+  if (process.env.RIG_RUNTIME_BUILD_WORKER === "1") {
+    return false;
+  }
+  if (process.env.RIG_RUNTIME_BUILD_IN_PROCESS === "1") {
+    return false;
+  }
+  return true;
+}
+async function buildRuntimeBinaryViaWorker(options) {
+  const workerSourcePath = resolveRuntimeBinaryBuildWorkerSourcePath(options);
+  if (!workerSourcePath || !existsSync2(workerSourcePath)) {
+    await buildRuntimeBinaryInProcess(options, {
+      manifestPath: runtimeBinaryCacheManifestPath(options.outputPath),
+      buildKey: createRuntimeBinaryBuildKey({
+        entrypoint: options.entrypoint,
+        define: options.define,
+        env: options.env,
+        external: options.external
+      })
+    });
+    return;
+  }
+  const payloadPath = createRuntimeBinaryBuildWorkerPayloadPath(options.outputPath);
+  const bunCli = resolveRuntimeBinaryBuildWorkerInvocation();
+  await Bun.write(payloadPath, `${JSON.stringify(options)}
+`);
+  const build = Bun.spawn([bunCli.command, workerSourcePath, payloadPath], {
+    cwd: options.cwd,
+    stdout: "pipe",
+    stderr: "pipe",
+    env: {
+      ...process.env,
+      ...options.env,
+      ...bunCli.env,
+      RIG_RUNTIME_BUILD_WORKER: "1"
+    }
+  });
+  const [exitCode, stdout, stderr] = await Promise.all([
+    build.exited,
+    new Response(build.stdout).text(),
+    new Response(build.stderr).text()
+  ]);
+  rmSync(payloadPath, { force: true });
+  if (exitCode !== 0) {
+    throw new Error(`Failed to build ${options.entrypoint}: ${(stderr || stdout || `worker exited ${exitCode}`).trim()}`);
+  }
+}
+function createRuntimeBinaryBuildWorkerPayloadPath(outputPath) {
+  return resolve2(dirname(outputPath), `.bun-build-worker-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`);
+}
+function resolveRuntimeBinaryBuildWorkerSourcePath(options) {
+  const envRoots = [
+    options.cwd?.trim(),
+    process.env.RIG_HOST_PROJECT_ROOT?.trim(),
+    process.env.PROJECT_RIG_ROOT?.trim()
+  ].filter(Boolean);
+  for (const root of envRoots) {
+    const candidate = resolve2(root, "packages/isolation-plugin/src/isolation/binary-build-worker.ts");
+    if (existsSync2(candidate)) {
+      return candidate;
+    }
+  }
+  const localCandidate = resolve2(import.meta.dir, "binary-build-worker.ts");
+  return existsSync2(localCandidate) ? localCandidate : null;
+}
+function resolveRuntimeBinaryBuildWorkerInvocation() {
+  const bunPath = Bun.which("bun");
+  if (bunPath) {
+    return { command: bunPath, env: {} };
+  }
+  if (process.execPath?.trim()) {
+    return {
+      command: process.execPath,
+      env: { BUN_BE_BUN: "1" }
+    };
+  }
+  throw new Error("bun is required to run the runtime binary build worker.");
+}
+function currentCompileTarget() {
+  if (process.platform === "darwin") {
+    return process.arch === "arm64" ? "bun-darwin-arm64" : "bun-darwin-x64";
+  }
+  if (process.platform === "linux") {
+    return process.arch === "arm64" ? "bun-linux-arm64" : "bun-linux-x64";
+  }
+  return "bun-windows-x64";
+}
+function createRuntimeBinaryBuildKey(input) {
+  return JSON.stringify({
+    version: 1,
+    bunVersion: Bun.version,
+    platform: process.platform,
+    arch: process.arch,
+    entrypoint: input.entrypoint,
+    define: sortRecord(input.define),
+    external: input.external ? [...input.external].sort() : undefined,
+    env: sortRecord(input.env)
+  });
+}
+async function isRuntimeBinaryBuildFresh(input) {
+  if (!existsSync2(input.outputPath) || !existsSync2(input.manifestPath)) {
+    return false;
+  }
+  let manifest = null;
+  try {
+    manifest = await Bun.file(input.manifestPath).json();
+  } catch {
+    return false;
+  }
+  if (!manifest || manifest.version !== 1 || manifest.buildKey !== input.buildKey) {
+    return false;
+  }
+  for (const [filePath, expectedDigest] of Object.entries(manifest.inputs || {})) {
+    if (!existsSync2(filePath)) {
+      return false;
+    }
+    if (await sha256File(filePath) !== expectedDigest) {
+      return false;
+    }
+  }
+  return true;
+}
+async function writeRuntimeBinaryCacheManifest(input) {
+  const inputs = {};
+  for (const inputPath of Object.keys(input.metafile?.inputs || {}).sort()) {
+    const normalized = normalizeBuildInputPath(input.cwd, inputPath);
+    if (!normalized || !existsSync2(normalized)) {
+      continue;
+    }
+    inputs[normalized] = await sha256File(normalized);
+  }
+  const manifest = {
+    version: 1,
+    buildKey: input.buildKey,
+    inputs
+  };
+  await Bun.write(input.manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+}
+function normalizeBuildInputPath(cwd, inputPath) {
+  if (!inputPath) {
+    return null;
+  }
+  if (inputPath.startsWith("file://")) {
+    return fileURLToPath(inputPath);
+  }
+  if (inputPath.startsWith("<")) {
+    return null;
+  }
+  return resolve2(cwd, inputPath);
+}
+async function sha256File(path) {
+  const hasher = new Bun.CryptoHasher("sha256");
+  hasher.update(await Bun.file(path).arrayBuffer());
+  return hasher.digest("hex");
+}
+function sortRecord(value) {
+  if (!value) {
+    return;
+  }
+  return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)));
+}
+async function runSerializedRuntimeBinaryBuild(action) {
+  const previous = runtimeBinaryBuildQueue;
+  let release;
+  runtimeBinaryBuildQueue = new Promise((resolve3) => {
+    release = resolve3;
+  });
+  await previous;
+  try {
+    return await action();
+  } finally {
+    release();
+  }
+}
+async function withTemporaryEnv(env, action) {
+  if (!env) {
+    return action();
+  }
+  const previousValues = new Map;
+  for (const [key, value] of Object.entries(env)) {
+    previousValues.set(key, process.env[key]);
+    if (value === undefined) {
+      delete process.env[key];
+    } else {
+      process.env[key] = value;
+    }
+  }
+  try {
+    return await action();
+  } finally {
+    for (const [key, value] of previousValues.entries()) {
+      if (value === undefined) {
+        delete process.env[key];
+      } else {
+        process.env[key] = value;
+      }
+    }
+  }
+}
+async function withTemporaryCwd(cwd, action) {
+  const previousCwd = process.cwd();
+  process.chdir(cwd);
+  try {
+    return await action();
+  } finally {
+    process.chdir(previousCwd);
+  }
+}
+
+// packages/isolation-plugin/src/isolation/git-native.ts
+import { chmodSync as chmodSync2, copyFileSync as copyFileSync2, existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, renameSync as renameSync3, rmSync as rmSync2, writeFileSync as writeFileSync3 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { dirname as dirname2, isAbsolute, resolve as resolve3 } from "path";
+var sharedGitNativeOutputDir = resolve3(tmpdir2(), "rig-native");
+var sharedGitNativeOutputPath = resolve3(sharedGitNativeOutputDir, `rig-git-${process.platform}-${process.arch}${process.platform === "win32" ? ".exe" : ""}`);
+var trackerCommandUsageProbe = "usage: rig-git fetch-ref <repo-path> <remote> <branch>";
+function temporaryGitBinaryOutputPath(outputPath) {
+  const suffix = process.platform === "win32" ? ".exe" : "";
+  return resolve3(dirname2(outputPath), `.rig-git-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}${suffix}`);
+}
+function publishGitBinary(tempOutputPath, outputPath) {
+  try {
+    renameSync3(tempOutputPath, outputPath);
+  } catch (error) {
+    if (process.platform === "win32" && existsSync3(outputPath)) {
+      rmSync2(outputPath, { force: true });
+      renameSync3(tempOutputPath, outputPath);
+      return;
+    }
+    throw error;
+  }
+}
+function isSharedGitNativeOutputPath(outputPath) {
+  return resolve3(outputPath) === sharedGitNativeOutputPath;
+}
+async function materializeFromSharedGitBinary(outputPath, buildKey) {
+  if (isSharedGitNativeOutputPath(outputPath))
+    return null;
+  const sharedManifest = nativeBuildManifestPath(sharedGitNativeOutputPath);
+  if (!existsSync3(sharedGitNativeOutputPath) || !await hasMatchingNativeBuildManifest(sharedManifest, buildKey) || !binarySupportsTrackerCommandsSync(sharedGitNativeOutputPath)) {
+    return null;
+  }
+  mkdirSync3(dirname2(outputPath), { recursive: true });
+  copyFileSync2(sharedGitNativeOutputPath, outputPath);
+  chmodSync2(outputPath, 493);
+  await Bun.write(nativeBuildManifestPath(outputPath), `${JSON.stringify({ version: 1, buildKey }, null, 2)}
+`);
+  return outputPath;
+}
+function runtimeRigGitFileName() {
+  return `rig-git${process.platform === "win32" ? ".exe" : ""}`;
+}
+function rigGitSourceCandidates() {
+  const execDir = process.execPath?.trim() ? dirname2(process.execPath.trim()) : "";
+  const cwd = process.cwd()?.trim() || "";
+  const projectRoot = process.env.PROJECT_RIG_ROOT?.trim() || "";
+  const hostProjectRoot = process.env.RIG_HOST_PROJECT_ROOT?.trim() || "";
+  const moduleRelativeSource = resolve3(import.meta.dir, "../../native/rig-git.zig");
+  return [...new Set([
+    process.env.RIG_NATIVE_GIT_SOURCE?.trim() || "",
+    moduleRelativeSource,
+    projectRoot ? resolve3(projectRoot, "packages/isolation-plugin/native/rig-git.zig") : "",
+    hostProjectRoot ? resolve3(hostProjectRoot, "packages/isolation-plugin/native/rig-git.zig") : "",
+    cwd ? resolve3(cwd, "packages/isolation-plugin/native/rig-git.zig") : "",
+    execDir ? resolve3(execDir, "..", "..", "packages/isolation-plugin/native/rig-git.zig") : "",
+    execDir ? resolve3(execDir, "..", "native", "rig-git.zig") : ""
+  ].filter(Boolean))];
+}
+function nativePackageBinaryCandidates(fromDir, fileName) {
+  const candidates = [];
+  let cursor = resolve3(fromDir);
+  for (let index = 0;index < 8; index += 1) {
+    candidates.push(resolve3(cursor, "native", `${process.platform}-${process.arch}`, fileName), resolve3(cursor, "native", `${process.platform}-${process.arch}`, "bin", fileName), resolve3(cursor, "native", fileName), resolve3(cursor, "native", "bin", fileName));
+    const parent = dirname2(cursor);
+    if (parent === cursor)
+      break;
+    cursor = parent;
+  }
+  return candidates;
+}
+function rigGitBinaryCandidates() {
+  const execDir = process.execPath?.trim() ? dirname2(process.execPath.trim()) : "";
+  const fileName = runtimeRigGitFileName();
+  const explicit = process.env.RIG_NATIVE_GIT_BIN?.trim() || "";
+  return [...new Set([
+    explicit,
+    ...nativePackageBinaryCandidates(import.meta.dir, fileName),
+    execDir ? resolve3(execDir, fileName) : "",
+    execDir ? resolve3(execDir, "..", fileName) : "",
+    execDir ? resolve3(execDir, "..", "bin", fileName) : "",
+    sharedGitNativeOutputPath
+  ].filter(Boolean))];
+}
+function resolveGitSourcePath() {
+  for (const candidate of rigGitSourceCandidates()) {
+    if (candidate && existsSync3(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function resolveGitBinaryPath() {
+  if (process.env.RIG_DISABLE_ZIG_NATIVE === "1") {
+    return null;
+  }
+  for (const candidate of rigGitBinaryCandidates()) {
+    if (candidate && existsSync3(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function binarySupportsTrackerCommandsSync(binaryPath) {
+  try {
+    const probe = Bun.spawnSync([binaryPath, "fetch-ref", "."], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const stdout = probe.stdout.toString().trim();
+    const stderr = probe.stderr.toString().trim();
+    if (stdout.includes('"error":"unknown command"')) {
+      return false;
+    }
+    return probe.exitCode === 2 && stderr.includes(trackerCommandUsageProbe);
+  } catch {
+    return false;
+  }
+}
+function nativeBuildManifestPath(outputPath) {
+  return `${outputPath}.build-manifest.json`;
+}
+async function hasMatchingNativeBuildManifest(manifestPath, buildKey) {
+  if (!existsSync3(manifestPath)) {
+    return false;
+  }
+  try {
+    const manifest = await Bun.file(manifestPath).json();
+    return manifest.version === 1 && manifest.buildKey === buildKey;
+  } catch {
+    return false;
+  }
+}
+async function sha256File2(path) {
+  const hasher = new Bun.CryptoHasher("sha256");
+  hasher.update(await Bun.file(path).arrayBuffer());
+  return hasher.digest("hex");
+}
+async function ensureRigGitBinaryPath(outputPath = sharedGitNativeOutputPath) {
+  if (process.env.RIG_DISABLE_ZIG_NATIVE === "1") {
+    throw new Error("Zig native git is disabled via RIG_DISABLE_ZIG_NATIVE=1");
+  }
+  const explicitBin = process.env.RIG_NATIVE_GIT_BIN?.trim();
+  if (explicitBin && existsSync3(explicitBin)) {
+    return explicitBin;
+  }
+  const embedded = extractEmbeddedNative("rig-git");
+  if (embedded) {
+    return embedded;
+  }
+  const sourcePath = resolveGitSourcePath();
+  if (!sourcePath) {
+    const binaryPath = resolveGitBinaryPath();
+    if (binaryPath) {
+      return binaryPath;
+    }
+    throw new Error("rig-git.zig source file not found.");
+  }
+  const zigBinary = Bun.which("zig");
+  if (!zigBinary) {
+    throw new Error("zig is required to build native Rig git tools.");
+  }
+  mkdirSync3(dirname2(outputPath), { recursive: true });
+  const sourceDigest = await sha256File2(sourcePath);
+  const buildKey = JSON.stringify({
+    version: 1,
+    zigBinary,
+    platform: process.platform,
+    arch: process.arch,
+    sourcePath,
+    sourceDigest
+  });
+  const manifestPath = nativeBuildManifestPath(outputPath);
+  const needsBuild = !existsSync3(outputPath) || !await hasMatchingNativeBuildManifest(manifestPath, buildKey) || !binarySupportsTrackerCommandsSync(outputPath);
+  if (!needsBuild) {
+    chmodSync2(outputPath, 493);
+    return outputPath;
+  }
+  const materialized = await materializeFromSharedGitBinary(outputPath, buildKey);
+  if (materialized)
+    return materialized;
+  const tempOutputPath = temporaryGitBinaryOutputPath(outputPath);
+  const build = Bun.spawn([
+    zigBinary,
+    "build-exe",
+    sourcePath,
+    "-O",
+    "ReleaseFast",
+    `-femit-bin=${tempOutputPath}`
+  ], {
+    cwd: dirname2(sourcePath),
+    stdout: "pipe",
+    stderr: "pipe"
+  });
+  const [exitCode, stdout, stderr] = await Promise.all([
+    build.exited,
+    new Response(build.stdout).text(),
+    new Response(build.stderr).text()
+  ]);
+  if (exitCode !== 0 || !existsSync3(tempOutputPath)) {
+    const details = [stderr.trim(), stdout.trim()].filter(Boolean).join(`
+`);
+    throw new Error(`Failed to build native Rig git tools: ${details || `zig exited with code ${exitCode}`}`);
+  }
+  chmodSync2(tempOutputPath, 493);
+  if (existsSync3(outputPath) && await hasMatchingNativeBuildManifest(manifestPath, buildKey)) {
+    rmSync2(tempOutputPath, { force: true });
+    chmodSync2(outputPath, 493);
+    return outputPath;
+  }
+  publishGitBinary(tempOutputPath, outputPath);
+  if (!binarySupportsTrackerCommandsSync(outputPath)) {
+    rmSync2(outputPath, { force: true });
+    throw new Error("Failed to build native Rig git tools: tracker command probe failed");
+  }
+  await Bun.write(manifestPath, `${JSON.stringify({ version: 1, buildKey }, null, 2)}
+`);
+  return outputPath;
+}
+async function materializeRigGitBinary(targetDir) {
+  const sourcePath = await ensureRigGitBinaryPath();
+  const targetPath = resolve3(targetDir, runtimeRigGitFileName());
+  mkdirSync3(targetDir, { recursive: true });
+  const sourceDigest = await sha256File2(sourcePath);
+  const buildKey = JSON.stringify({
+    version: 1,
+    sourcePath,
+    sourceDigest
+  });
+  const needsCopy = !existsSync3(targetPath) || !await hasMatchingNativeBuildManifest(nativeBuildManifestPath(targetPath), buildKey);
+  if (needsCopy) {
+    copyFileSync2(sourcePath, targetPath);
+    chmodSync2(targetPath, 493);
+    await Bun.write(nativeBuildManifestPath(targetPath), `${JSON.stringify({ version: 1, buildKey }, null, 2)}
+`);
+  }
+  return targetPath;
+}
+
+// packages/isolation-plugin/src/runtime-native.ts
+import { dlopen, ptr, suffix, toBuffer } from "bun:ffi";
+import { copyFileSync as copyFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync4, renameSync as renameSync4, rmSync as rmSync3, statSync as statSync2 } from "fs";
+import { tmpdir as tmpdir3 } from "os";
+import { dirname as dirname3, resolve as resolve4 } from "path";
+
+// packages/isolation-plugin/src/sidecar-arg.ts
+var RIG_NATIVE_RUNTIME_SIDECAR_ARG = "__rig_native_runtime_sidecar";
+
+// packages/isolation-plugin/src/runtime-native.ts
+var sharedNativeRuntimeOutputDir = resolve4(tmpdir3(), "rig-native");
+var sharedNativeRuntimeOutputPath = resolve4(sharedNativeRuntimeOutputDir, `runtime-native-${process.platform}-${process.arch}.${suffix}`);
+var colocatedNativeRuntimeFileName = `runtime-native.${suffix}`;
+var nativeRuntimeLibrary = await loadNativeRuntimeLibrary();
+function runtimePrepareTrackedPathsNative(input) {
+  const response = runNativeRuntimeSidecar({
+    op: "prepare-paths",
+    input
+  });
+  if (!response.ok) {
+    throw new Error(response.error);
+  }
+}
+function runtimeLinkDependencyLayerNative(sourceDir, targetDir) {
+  const response = runNativeRuntimeSidecar({
+    op: "link-dependency-layer",
+    input: { sourceDir, targetDir }
+  });
+  if (!response.ok) {
+    throw new Error(response.error);
+  }
+}
+async function ensureNativeRuntimeLibraryPath(outputPath = sharedNativeRuntimeOutputPath, options = {}) {
+  const explicitLib = process.env.RIG_NATIVE_RUNTIME_LIB?.trim();
+  if (explicitLib && existsSync4(explicitLib)) {
+    return explicitLib;
+  }
+  const embeddedPath = extractEmbeddedNative("snapshot");
+  if (embeddedPath) {
+    return embeddedPath;
+  }
+  if (await buildNativeRuntimeLibrary(outputPath, options)) {
+    return outputPath;
+  }
+  return !options.force && existsSync4(outputPath) ? outputPath : null;
+}
+async function materializeNativeRuntimeLibrary(targetDir) {
+  const sourcePath = await ensureNativeRuntimeLibraryPath();
+  if (!sourcePath) {
+    return null;
+  }
+  const targetPath = resolve4(targetDir, colocatedNativeRuntimeFileName);
+  mkdirSync4(targetDir, { recursive: true });
+  const needsCopy = !existsSync4(targetPath) || statSync2(sourcePath).mtimeMs > statSync2(targetPath).mtimeMs;
+  if (needsCopy) {
+    copyFileSync3(sourcePath, targetPath);
+  }
+  return targetPath;
+}
+async function loadNativeRuntimeLibrary() {
+  if (process.env.RIG_DISABLE_ZIG_NATIVE === "1") {
+    return null;
+  }
+  const explicitLib = process.env.RIG_NATIVE_RUNTIME_LIB?.trim();
+  if (explicitLib && existsSync4(explicitLib)) {
+    const loaded = tryDlopenNativeRuntimeLibrary(explicitLib);
+    if (loaded) {
+      return loaded;
+    }
+  }
+  const embeddedPath = extractEmbeddedNative("snapshot");
+  if (embeddedPath) {
+    const loaded = tryDlopenNativeRuntimeLibrary(embeddedPath);
+    if (loaded) {
+      return loaded;
+    }
+  }
+  for (const candidate of nativeRuntimeLibraryCandidates()) {
+    if (!candidate || !existsSync4(candidate)) {
+      continue;
+    }
+    const loaded = tryDlopenNativeRuntimeLibrary(candidate);
+    if (loaded) {
+      return loaded;
+    }
+  }
+  const builtLibraryPath = await ensureNativeRuntimeLibraryPath(sharedNativeRuntimeOutputPath, { force: true });
+  if (!builtLibraryPath) {
+    return null;
+  }
+  return tryDlopenNativeRuntimeLibrary(builtLibraryPath);
+}
+function nativePackageLibraryCandidates(fromDir, names) {
+  const candidates = [];
+  let cursor = resolve4(fromDir);
+  for (let index = 0;index < 8; index += 1) {
+    for (const name of names) {
+      candidates.push(resolve4(cursor, "native", `${process.platform}-${process.arch}`, name), resolve4(cursor, "native", `${process.platform}-${process.arch}`, "lib", name), resolve4(cursor, "native", name), resolve4(cursor, "native", "lib", name));
+    }
+    const parent = dirname3(cursor);
+    if (parent === cursor)
+      break;
+    cursor = parent;
+  }
+  return candidates;
+}
+function nativeRuntimeLibraryCandidates() {
+  const explicit = process.env.RIG_NATIVE_RUNTIME_LIB?.trim() || "";
+  const execDir = process.execPath?.trim() ? dirname3(process.execPath.trim()) : "";
+  const platformSpecific = `runtime-native-${process.platform}-${process.arch}.${suffix}`;
+  return [...new Set([
+    explicit,
+    ...nativePackageLibraryCandidates(import.meta.dir, [colocatedNativeRuntimeFileName, platformSpecific]),
+    execDir ? resolve4(execDir, colocatedNativeRuntimeFileName) : "",
+    execDir ? resolve4(execDir, platformSpecific) : "",
+    execDir ? resolve4(execDir, "..", colocatedNativeRuntimeFileName) : "",
+    execDir ? resolve4(execDir, "..", platformSpecific) : "",
+    execDir ? resolve4(execDir, "lib", colocatedNativeRuntimeFileName) : "",
+    execDir ? resolve4(execDir, "..", "lib", colocatedNativeRuntimeFileName) : "",
+    sharedNativeRuntimeOutputPath
+  ].filter(Boolean))];
+}
+function resolveNativeRuntimeSourcePath() {
+  const explicit = process.env.RIG_NATIVE_RUNTIME_SOURCE?.trim();
+  if (explicit && existsSync4(explicit)) {
+    return explicit;
+  }
+  const bundled = resolve4(import.meta.dir, "../native/snapshot.zig");
+  return existsSync4(bundled) ? bundled : null;
+}
+function resolveNativeRuntimeSidecarSourcePath() {
+  const envRoots = [
+    process.cwd()?.trim(),
+    process.env.RIG_HOST_PROJECT_ROOT?.trim(),
+    process.env.PROJECT_RIG_ROOT?.trim()
+  ].filter(Boolean);
+  for (const root of envRoots) {
+    for (const relative of [
+      "packages/isolation-plugin/src/runtime-native-sidecar.ts",
+      "packages/isolation-plugin/dist/src/runtime-native-sidecar.js"
+    ]) {
+      const candidate = resolve4(root, relative);
+      if (existsSync4(candidate)) {
+        return candidate;
+      }
+    }
+  }
+  for (const localCandidate of [
+    resolve4(import.meta.dir, "runtime-native-sidecar.js"),
+    resolve4(import.meta.dir, "runtime-native-sidecar.ts")
+  ]) {
+    if (existsSync4(localCandidate))
+      return localCandidate;
+  }
+  return null;
+}
+async function buildNativeRuntimeLibrary(outputPath, options = {}) {
+  if (process.env.RIG_DISABLE_ZIG_NATIVE === "1") {
+    return false;
+  }
+  const zigBinary = Bun.which("zig");
+  const sourcePath = resolveNativeRuntimeSourcePath();
+  if (!zigBinary || !sourcePath) {
+    return false;
+  }
+  const tempOutputPath = `${outputPath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
+  try {
+    mkdirSync4(dirname3(outputPath), { recursive: true });
+    const needsBuild = options.force === true || !existsSync4(outputPath) || statSync2(sourcePath).mtimeMs > statSync2(outputPath).mtimeMs;
+    if (!needsBuild) {
+      return true;
+    }
+    const build = Bun.spawn([
+      zigBinary,
+      "build-lib",
+      sourcePath,
+      "-dynamic",
+      "-O",
+      "ReleaseFast",
+      `-femit-bin=${tempOutputPath}`
+    ], {
+      cwd: import.meta.dir,
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const exitCode = await build.exited;
+    if (exitCode !== 0 || !existsSync4(tempOutputPath)) {
+      rmSync3(tempOutputPath, { force: true });
+      return false;
+    }
+    renameSync4(tempOutputPath, outputPath);
+    return true;
+  } catch {
+    rmSync3(tempOutputPath, { force: true });
+    return false;
+  }
+}
+function tryDlopenNativeRuntimeLibrary(outputPath) {
+  try {
+    return dlopen(outputPath, {
+      rig_scope_match: {
+        args: ["ptr", "ptr"],
+        returns: "u8"
+      },
+      snapshot_capture: {
+        args: ["ptr", "u64", "ptr", "u64"],
+        returns: "ptr"
+      },
+      snapshot_delta: {
+        args: ["ptr", "ptr"],
+        returns: "ptr"
+      },
+      snapshot_store_delta: {
+        args: ["ptr", "ptr", "ptr", "u64", "ptr", "u64", "ptr", "u64", "ptr", "u64"],
+        returns: "ptr"
+      },
+      snapshot_inspect_delta: {
+        args: ["ptr", "u64"],
+        returns: "ptr"
+      },
+      snapshot_apply_delta: {
+        args: ["ptr", "u64", "ptr", "u64"],
+        returns: "ptr"
+      },
+      snapshot_release: {
+        args: ["ptr"],
+        returns: "void"
+      },
+      runtime_hash_file: {
+        args: ["ptr", "u64"],
+        returns: "ptr"
+      },
+      runtime_hash_tree: {
+        args: ["ptr", "u64"],
+        returns: "ptr"
+      },
+      runtime_prepare_paths: {
+        args: ["ptr", "u64", "ptr", "u64", "ptr", "u64", "ptr", "u64", "ptr", "u64"],
+        returns: "ptr"
+      },
+      runtime_link_dependency_layer: {
+        args: ["ptr", "u64", "ptr", "u64"],
+        returns: "ptr"
+      },
+      runtime_scan_worktrees: {
+        args: ["ptr", "u64"],
+        returns: "ptr"
+      }
+    });
+  } catch {
+    return null;
+  }
+}
+function resolveNativeRuntimeSidecarCommand(request) {
+  if (hasEmbeddedNatives()) {
+    return {
+      argv: [process.execPath, RIG_NATIVE_RUNTIME_SIDECAR_ARG, JSON.stringify(request)],
+      env: {}
+    };
+  }
+  const hostBinary = process.env.RIG_NATIVE_HOST_BINARY?.trim();
+  if (hostBinary) {
+    return {
+      argv: [hostBinary, RIG_NATIVE_RUNTIME_SIDECAR_ARG, JSON.stringify(request)],
+      env: {}
+    };
+  }
+  const sidecarSourcePath = resolveNativeRuntimeSidecarSourcePath();
+  if (!sidecarSourcePath) {
+    throw new Error("runtime-native-sidecar.ts source file not found.");
+  }
+  const bunCli = resolveNativeRuntimeSidecarInvocation();
+  return {
+    argv: [bunCli.command, sidecarSourcePath, JSON.stringify(request)],
+    env: bunCli.env
+  };
+}
+function runNativeRuntimeSidecar(request) {
+  const { argv, env } = resolveNativeRuntimeSidecarCommand(request);
+  const proc = Bun.spawnSync(argv, {
+    cwd: process.env.RIG_HOST_PROJECT_ROOT?.trim() || process.cwd(),
+    stdout: "pipe",
+    stderr: "pipe",
+    env: {
+      ...process.env,
+      ...env,
+      RIG_NATIVE_RUNTIME_SIDECAR: "1"
+    }
+  });
+  if (proc.exitCode !== 0) {
+    throw new Error(proc.stderr.toString() || proc.stdout.toString() || `runtime native sidecar exited ${proc.exitCode}`);
+  }
+  const stdout = proc.stdout.toString().trim();
+  if (!stdout) {
+    throw new Error("runtime native sidecar returned empty output.");
+  }
+  const responseLine = stdout.split(`
+`).map((line) => line.trim()).filter((line) => line.startsWith("{")).at(-1);
+  if (!responseLine) {
+    throw new Error(`runtime native sidecar returned no JSON response: ${stdout}`);
+  }
+  return JSON.parse(responseLine);
+}
+function resolveNativeRuntimeSidecarInvocation() {
+  const bunPath = Bun.which("bun");
+  if (bunPath) {
+    return { command: bunPath, env: {} };
+  }
+  if (process.execPath?.trim()) {
+    return {
+      command: process.execPath,
+      env: { BUN_BE_BUN: "1" }
+    };
+  }
+  throw new Error("bun is required to run the runtime native sidecar.");
+}
+
+// packages/isolation-plugin/src/isolation/toolchain.ts
+import {
+  GUARD_TOOLCHAIN_SOURCES,
+  LIFECYCLE_TOOLCHAIN_SOURCES,
+  TOOL_MATERIALIZER
+} from "@rig/contracts";
+import { defineCapability } from "@rig/core/capability";
+import { buildProjectPluginHost, requireInstalledCapability } from "@rig/core/capability-loaders";
+import { resolveBunBinaryPath } from "@rig/core/runtime-paths";
+
+// packages/isolation-plugin/src/isolation/shared.ts
+import { agentId, safeGitRefComponent, taskRuntimeId } from "@rig/core/safe-identifiers";
+import { resolveCheckoutRoot } from "@rig/core/checkout-root";
+var generatedCredentialFiles = new Set;
+function resolveMonorepoRoot(projectRoot) {
+  return resolveCheckoutRoot(projectRoot);
+}
+function sha256Hex(input) {
+  const hasher = new Bun.CryptoHasher("sha256");
+  hasher.update(input);
+  return hasher.digest("hex");
+}
+
+// packages/isolation-plugin/src/isolation/toolchain.ts
+var ToolMaterializerCap = defineCapability(TOOL_MATERIALIZER);
+var GuardToolchainSourcesCap = defineCapability(GUARD_TOOLCHAIN_SOURCES);
+var LifecycleToolchainSourcesCap = defineCapability(LIFECYCLE_TOOLCHAIN_SOURCES);
+var SNAPSHOT_SIDECAR_SOURCE = ["packages", "isolation-plugin", "src", "snapshot-sidecar.ts"].join("/");
+async function resolveContributedToolchainSources(projectRoot) {
+  const host = await buildProjectPluginHost(projectRoot);
+  const contributions = [];
+  if (host) {
+    for (const cap of [GuardToolchainSourcesCap, LifecycleToolchainSourcesCap]) {
+      const contribution = await cap.resolve(host);
+      if (contribution)
+        contributions.push(contribution);
+    }
+  }
+  const hookSources = contributions.flatMap((c) => (c.hookBinaries ?? []).map((hb) => [hb.name, hb.source]));
+  const namedSources = {};
+  for (const c of contributions) {
+    for (const [key, value] of Object.entries(c.namedSources ?? {}))
+      namedSources[key] = value;
+  }
+  return { hookSources, namedSources };
+}
+var toolMaterializer = () => requireInstalledCapability(ToolMaterializerCap, "tool-materializer capability unavailable: load @rig/provider-plugin (default bundle) before provisioning runtimes.");
+var GIT_INDEX_LOCK_MAX_RETRIES = 20;
+var GIT_INDEX_LOCK_RETRY_DELAY_MS = 250;
+var GIT_INDEX_LOCK_STALE_AFTER_MS = 5000;
+function resolveRigSourceRoot(projectRoot) {
+  const hostProjectRoot = process.env.RIG_HOST_PROJECT_ROOT?.trim();
+  if (hostProjectRoot && existsSync5(resolve5(hostProjectRoot, "packages/cli/bin/rig-agent.ts"))) {
+    return hostProjectRoot;
+  }
+  const fromModule = resolve5(import.meta.dir, "../../../../../..");
+  if (existsSync5(resolve5(fromModule, "packages/cli/bin/rig-agent.ts"))) {
+    return fromModule;
+  }
+  return projectRoot;
+}
+function prepareTrackedRuntimePaths(logsDir, stateDir, sessionDir) {
+  for (const path of [logsDir, stateDir, sessionDir, resolve5(sessionDir, "session.json")]) {
+    removeSymbolicLink(path);
+  }
+  runtimePrepareTrackedPathsNative({
+    logsDir,
+    stateDir,
+    sessionDir,
+    controlledBashLogFile: resolve5(logsDir, "controlled-bash.jsonl"),
+    eventsFile: resolve5(logsDir, "control-plane.events.jsonl")
+  });
+}
+async function initializeRuntimeStateFiles(stateDir, sessionDir, taskId) {
+  await mkdir(stateDir, { recursive: true });
+  await mkdir(sessionDir, { recursive: true });
+  const failedApproachesPath = resolve5(stateDir, "failed_approaches.md");
+  if (!existsSync5(failedApproachesPath)) {
+    await writeFile(failedApproachesPath, `# Failed Approaches
+
+`);
+  }
+  const hookTripsPath = resolve5(stateDir, "hook_trips.log");
+  if (!existsSync5(hookTripsPath)) {
+    await writeFile(hookTripsPath, "");
+  }
+  const sessionFile = resolve5(sessionDir, "session.json");
+  if (taskId) {
+    await writeFile(sessionFile, JSON.stringify({ activeTaskIds: [taskId] }));
+  }
+}
+async function resetEphemeralTaskArtifacts(workspaceDir, taskId) {
+  const artifactsRoot = resolve5(workspaceDir, "artifacts");
+  const taskSegment = safePathSegment(taskId, { fallback: "task", maxLength: 96 });
+  const artifactDir = assertPathInsideRoot(artifactsRoot, resolve5(artifactsRoot, taskSegment), "task artifact directory");
+  const runtimeSnapshotDir = assertPathInsideRoot(artifactDir, resolve5(artifactDir, "runtime-snapshots"), "runtime snapshot directory");
+  let preservedTrackedFiles = false;
+  for (const file of [
+    "changed-files.txt",
+    "pr-state.json",
+    "review-state.json",
+    "review-feedback.md",
+    "review-greptile-raw.json",
+    "review-status.txt",
+    "validation-summary.json"
+  ]) {
+    const relativePath = `artifacts/${taskSegment}/${file}`;
+    if (await resetTrackedArtifactPath(workspaceDir, relativePath)) {
+      preservedTrackedFiles = true;
+      continue;
+    }
+    rmSync4(assertPathInsideRoot(artifactDir, resolve5(artifactDir, file), "task artifact file"), { force: true });
+  }
+  const runtimeSnapshotRelativePath = `artifacts/${taskSegment}/runtime-snapshots`;
+  if (await resetTrackedArtifactPath(workspaceDir, runtimeSnapshotRelativePath)) {
+    preservedTrackedFiles = true;
+  } else {
+    rmSync4(runtimeSnapshotDir, { recursive: true, force: true });
+  }
+  if (preservedTrackedFiles) {
+    console.log(`[rig-agent] Preserved tracked runtime artifact files in ${taskId}; skipped ephemeral cleanup for committed paths.`);
+  }
+}
+function prepareRuntimeWorkspace(projectRoot, workspaceDir) {
+  const monorepoRoot = resolveMonorepoRoot(projectRoot);
+  linkRuntimeDependencyLayers(monorepoRoot, workspaceDir);
+  syncRuntimeWorkspaceSources(projectRoot, workspaceDir);
+}
+async function materializeRuntimeHostToolWrappers(binDir) {
+  const mat = toolMaterializer();
+  await mat.materializeRuntimeToolGateway(binDir);
+  await mat.materializeRuntimeFileTools(binDir);
+}
+async function buildRuntimeToolchain(options) {
+  const { hookSources, namedSources } = await resolveContributedToolchainSources(options.projectRoot);
+  const controlledBashSource = namedSources["controlled-bash"];
+  const runtimeBins = ensureRuntimeBinTrees(options.binDir);
+  const nativeRuntimeLibraryPath = await materializeNativeRuntimeLibrary(options.binDir);
+  if (!nativeRuntimeLibraryPath) {
+    throw new Error("Failed to provision the native Zig runtime library.");
+  }
+  const rigSourceRoot = resolveRigSourceRoot(options.projectRoot);
+  await buildBinary("packages/cli/bin/rig.ts", resolve5(options.binDir, "rig"), rigSourceRoot, undefined, runtimeRigCliBinaryExternals);
+  await buildBinary("packages/cli/bin/rig-agent.ts", resolve5(options.binDir, "rig-agent"), rigSourceRoot, {
+    ...options.runtimeSecretDefines,
+    AGENT_TASK_ID: options.taskId,
+    AGENT_PROJECT_ROOT: options.projectRoot,
+    AGENT_RUNTIME_ID: options.runtimeId,
+    AGENT_SCOPE_HASH: options.bakedScopeHash,
+    AGENT_MANIFEST_PATH: options.manifestPath,
+    AGENT_BINARY_PATH: resolve5(options.binDir, "rig-agent"),
+    AGENT_INFO_OUTPUT: options.bakedInfoOutput,
+    AGENT_DEPS_OUTPUT: options.bakedDepsOutput,
+    AGENT_STATUS_OUTPUT: options.bakedStatusOutput
+  });
+  if (controlledBashSource) {
+    await buildBinary(controlledBashSource, resolve5(options.binDir, "controlled-bash"), rigSourceRoot, {
+      AGENT_PROJECT_ROOT: options.projectRoot,
+      AGENT_LOGS_DIR: options.logsDir,
+      AGENT_MONOREPO_ROOT: resolveMonorepoRoot(options.projectRoot),
+      AGENT_TS_API_TESTS_DIR: resolve5(options.workspaceDir, "TSAPITests"),
+      AGENT_RIG_AGENT_BIN: resolve5(options.binDir, "rig-agent")
+    });
+  }
+  await buildBinary("packages/cli/bin/rig-browser-tool.ts", resolve5(options.binDir, toolMaterializer().runtimeBrowserToolBinaryName()), rigSourceRoot);
+  await buildBinary(SNAPSHOT_SIDECAR_SOURCE, resolve5(options.binDir, "snapshot-sidecar"), rigSourceRoot, {
+    AGENT_PROJECT_ROOT: options.projectRoot,
+    AGENT_BUN_PATH: resolveBunBinaryPath()
+  });
+  const hookDefines = {
+    AGENT_PROJECT_ROOT: options.projectRoot,
+    AGENT_BUN_PATH: resolveBunBinaryPath()
+  };
+  for (const [hookName, hookSource] of hookSources) {
+    await buildBinary(hookSource, resolve5(runtimeBins.hooksDir, hookName), rigSourceRoot, hookDefines);
+  }
+  const pluginsDir = resolve5(options.projectRoot, "rig/plugins");
+  if (existsSync5(pluginsDir)) {
+    for (const entry of readdirSync(pluginsDir, { withFileTypes: true })) {
+      const match = entry.name.match(/^(.+)\.plugin\.(ts|js|mjs|cjs)$/);
+      if (!match)
+        continue;
+      await buildBinary(`rig/plugins/${entry.name}`, resolve5(runtimeBins.pluginsDir, match[1]), options.projectRoot);
+    }
+  }
+  await materializeRigGitBinary(options.binDir);
+  const mat = toolMaterializer();
+  await mat.materializeClaudeToolRouterBinary(rigSourceRoot, options.binDir);
+  await materializeRuntimeHostToolWrappers(options.binDir);
+  await mat.materializeRuntimeBrowserTools(options.binDir);
+}
+async function writeRuntimeManifest(config) {
+  const scopeHash = sha256Hex(JSON.stringify(config.scopes));
+  const binarySha256 = sha256Hex(readFileSync3(config.binaryPath));
+  const manifestPath = resolve5(config.runtimeRoot, "manifest.json");
+  const manifest = {
+    runtimeId: config.runtimeId,
+    taskId: config.taskId,
+    scopeHash,
+    builtAt: new Date().toISOString(),
+    workspaceDir: config.workspaceDir,
+    binDir: config.binDir,
+    binary: {
+      path: config.binaryPath,
+      sha256: binarySha256
+    }
+  };
+  await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`, "utf-8");
+}
+function syncRuntimeWorkspaceSources(projectRoot, workspaceDir) {}
+function removeSymbolicLink(path) {
+  try {
+    if (!lstatSync(path).isSymbolicLink()) {
+      return;
+    }
+  } catch {
+    return;
+  }
+  rmSync4(path, { force: true, recursive: true });
+}
+async function resetTrackedArtifactPath(workspaceDir, relativePath) {
+  const tracked = await runGitLsFiles(workspaceDir, relativePath);
+  if (!tracked) {
+    return false;
+  }
+  await restoreTrackedArtifactPathWithRetry(workspaceDir, relativePath, async () => {
+    const restore = await Bun.$`git -C ${workspaceDir} checkout -- ${relativePath}`.quiet().nothrow();
+    return {
+      exitCode: restore.exitCode,
+      output: restore.stderr.toString() || restore.stdout.toString()
+    };
+  }, { sleep: Bun.sleep });
+  return true;
+}
+async function runGitLsFiles(workspaceDir, relativePath) {
+  const tracked = await Bun.$`git -C ${workspaceDir} ls-files --error-unmatch -- ${relativePath}`.quiet().nothrow();
+  return tracked.exitCode === 0;
+}
+async function restoreTrackedArtifactPathWithRetry(workspaceDir, relativePath, restorePath, options = {}) {
+  const sleep = options.sleep ?? Bun.sleep;
+  const maxRetries = options.maxRetries ?? GIT_INDEX_LOCK_MAX_RETRIES;
+  const retryDelayMs = options.retryDelayMs ?? GIT_INDEX_LOCK_RETRY_DELAY_MS;
+  const now = options.now ?? Date.now;
+  const statMtimeMs = options.statMtimeMs ?? readFileMtimeMs;
+  const removeFile = options.removeFile ?? ((path) => rmSync4(path, { force: true }));
+  const log = options.log ?? console.warn;
+  let lastOutput = "";
+  for (let attempt = 0;attempt <= maxRetries; attempt += 1) {
+    const restore = await restorePath();
+    if (restore.exitCode === 0) {
+      return;
+    }
+    lastOutput = restore.output;
+    if (!isGitIndexLockError(lastOutput)) {
+      break;
+    }
+    const lockPath = parseGitIndexLockPath(lastOutput);
+    if (attempt === maxRetries) {
+      if (lockPath && tryClearStaleGitIndexLock(lockPath, {
+        now,
+        statMtimeMs,
+        removeFile,
+        log
+      })) {
+        const recovered = await restorePath();
+        if (recovered.exitCode === 0) {
+          return;
+        }
+        lastOutput = recovered.output;
+      }
+      break;
+    }
+    await sleep(retryDelayMs);
+  }
+  throw new Error(`Failed to restore tracked runtime artifact path ${relativePath} in ${workspaceDir}: ${lastOutput}`);
+}
+function isGitIndexLockError(output) {
+  return /index\.lock|Unable to create '.+index\.lock'.*File exists/i.test(output);
+}
+function parseGitIndexLockPath(output) {
+  const match = output.match(/Unable to create '([^']+index\.lock)'/i);
+  return match?.[1] ?? null;
+}
+function tryClearStaleGitIndexLock(lockPath, options) {
+  const mtimeMs = options.statMtimeMs(lockPath);
+  if (mtimeMs === null) {
+    return false;
+  }
+  if (options.now() - mtimeMs < GIT_INDEX_LOCK_STALE_AFTER_MS) {
+    return false;
+  }
+  options.removeFile(lockPath);
+  options.log(`[rig-agent] Cleared stale git index lock during run recovery: ${lockPath}`);
+  return true;
+}
+function readFileMtimeMs(path) {
+  try {
+    return statSync3(path).mtimeMs;
+  } catch {
+    return null;
+  }
+}
+function linkRuntimeDependencyLayers(monorepoRoot, workspaceDir) {
+  linkGenericNodeModulesLayers(monorepoRoot, workspaceDir);
+  const sourceNodeModules = resolve5(monorepoRoot, "humoongate", "node_modules");
+  if (!existsSync5(sourceNodeModules)) {} else {
+    const runtimeHumoongate = resolve5(workspaceDir, "humoongate");
+    if (existsSync5(resolve5(runtimeHumoongate, "package.json"))) {
+      const targetNodeModules = resolve5(runtimeHumoongate, "node_modules");
+      runtimeLinkDependencyLayerNative(sourceNodeModules, targetNodeModules);
+    }
+  }
+  const runtimeHpNext = resolve5(workspaceDir, "microservices", "hp-next-frontend", "app");
+  if (!existsSync5(resolve5(runtimeHpNext, "package.json"))) {
+    return;
+  }
+  const sourceHpNextNodeModules = resolve5(monorepoRoot, "microservices", "hp-next-frontend", "app", "node_modules");
+  const sourceMonorepoNodeModules = resolve5(monorepoRoot, "node_modules");
+  const targetHpNextNodeModules = resolve5(runtimeHpNext, "node_modules");
+  if (existsSync5(sourceHpNextNodeModules)) {
+    runtimeLinkDependencyLayerNative(sourceHpNextNodeModules, targetHpNextNodeModules);
+    return;
+  }
+  if (existsSync5(sourceMonorepoNodeModules)) {
+    runtimeLinkDependencyLayerNative(sourceMonorepoNodeModules, targetHpNextNodeModules);
+  }
+}
+function linkGenericNodeModulesLayers(monorepoRoot, workspaceDir) {
+  linkNodeModulesLayer(resolve5(monorepoRoot, "node_modules"), resolve5(workspaceDir, "node_modules"));
+  for (const relativePackageDir of [
+    "apps/native-app/apps/marketing",
+    "apps/native-app/apps/web",
+    "apps/native-app/apps/browser",
+    "apps/native-app/apps/desktop",
+    "apps/native-app/scripts",
+    "packages/cli",
+    "packages/client",
+    "packages/contracts",
+    "packages/core",
+    "packages/hook-kit",
+    "packages/plugin-testkit",
+    "packages/runtime",
+    "packages/scripts",
+    "packages/shared",
+    "packages/skill-loader",
+    "packages/standard-plugin",
+    "packages/validator-kit"
+  ]) {
+    const workspacePackageDir = resolve5(workspaceDir, relativePackageDir);
+    if (!existsSync5(resolve5(workspacePackageDir, "package.json"))) {
+      continue;
+    }
+    linkNodeModulesLayer(resolve5(monorepoRoot, relativePackageDir, "node_modules"), resolve5(workspacePackageDir, "node_modules"));
+  }
+}
+function linkNodeModulesLayer(sourceDir, targetDir) {
+  if (!existsSync5(sourceDir) || existsSync5(targetDir)) {
+    return;
+  }
+  try {
+    runtimeLinkDependencyLayerNative(sourceDir, targetDir);
+    return;
+  } catch (error) {
+    console.warn(`[rig-agent] Native dependency-layer linking failed for ${targetDir}; using symlink fallback: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  mkdirSync5(dirname4(targetDir), { recursive: true });
+  symlinkSync(sourceDir, targetDir, "dir");
+}
+function ensureRuntimeBinTrees(runtimeBinDir) {
+  const hooksDir = resolve5(runtimeBinDir, "hooks");
+  const pluginsDir = resolve5(runtimeBinDir, "plugins");
+  const validatorsDir = resolve5(runtimeBinDir, "validators");
+  mkdirSync5(hooksDir, { recursive: true });
+  mkdirSync5(pluginsDir, { recursive: true });
+  mkdirSync5(validatorsDir, { recursive: true });
+  return { hooksDir, pluginsDir, validatorsDir };
+}
+function runtimeWorktreeId(workspaceDir) {
+  return workspaceDir.split("/").at(-1) || "runtime";
+}
+var __testOnly = {
+  isGitIndexLockError,
+  parseGitIndexLockPath,
+  restoreTrackedArtifactPathWithRetry,
+  tryClearStaleGitIndexLock
+};
+export {
+  writeRuntimeManifest,
+  syncRuntimeWorkspaceSources,
+  runtimeWorktreeId,
+  resolveContributedToolchainSources,
+  resetEphemeralTaskArtifacts,
+  prepareTrackedRuntimePaths,
+  prepareRuntimeWorkspace,
+  materializeRuntimeHostToolWrappers,
+  initializeRuntimeStateFiles,
+  buildRuntimeToolchain,
+  buildBinary,
+  __testOnly
+};