@deeeed/metamask-harness 0.79.0 → 0.80.0

package/dist/harness.js

@@ -1,451 +0,0 @@
-import { spawnScriptStreaming } from "./commands/shared.js";
-import { execFileSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { shellLeafMissing, missingShellLeafMessage } from "./leaf-invoke.js";
-import { adapterRegistry } from "./adapters/registry.js";
-import { recipeHarnessPath, recipeRuntimeDir, runnerDir } from "./paths.js";
-import { colorHumanMessage } from "./cli-color.js";
-const HARNESS_ACTIONS = ["install", "verify", "cleanup"];
-const ADAPTERS = ["mobile", "extension", "core", "terminal"];
-function harnessUsage() {
-  console.error(`mm-harness \u2014 install and validate the MetaMask recipe runtime in a checkout.
-
-Run it from inside a MetaMask checkout; the platform (mobile | extension | core | terminal)
-is auto-detected from the repo. Pass --platform only to override.
-
-Commands (one copy-pasteable example each):
-  install   Install the recipe harness runtime overlay into the checkout.
-              mm-harness install
-  verify    Check the harness/runtime is present and healthy (no app launch).
-              mm-harness verify
-  cleanup   Remove the installed harness overlay and restore the checkout.
-              mm-harness cleanup
-
-Options:
-  --platform <mobile|extension|core|terminal>   Override auto-detection (alias: --adapter).
-  --target <repo>                      Checkout to operate on (default: current dir).
-  --json                               Machine-readable summary for agents/scripts.
-  -- <args>                            Forward the rest verbatim to the underlying
-                                       script, e.g. -- --platform ios --preflight-mode fast
-                                       (mobile) or -- --cdp-port 6665 (extension).
-
-Examples:
-  mm-harness install                          # inside a checkout, auto-detected
-  mm-harness verify --platform extension
-  mm-harness cleanup --target ../metamask-mobile
-
-core supports install, verify, and cleanup (headless; no live).`);
-}
-function failureHint(surface, action) {
-  const restart = surface.harness.restart;
-  if (!restart) {
-    if (action === "verify") {
-      return `Install the ${surface.id} harness first: mm-harness install --platform ${surface.id}`;
-    }
-    return "Read the error above for the specific cause, then re-run this command.";
-  }
-  return `Read the error above for the specific cause. To (re)start the runtime, run: ${restart}`;
-}
-function successNext(adapter, action, target) {
-  const base = `--adapter ${adapter} --target ${shellQuote(target)}`;
-  if (action === "install") return `mm-harness verify ${base}`;
-  if (action === "cleanup") return `mm-harness install ${base}`;
-  return `mm-harness status --target ${shellQuote(target)} --json`;
-}
-function hasArg(args, needle) {
-  return args.some((arg) => arg === needle || arg.startsWith(`${needle}=`));
-}
-function argValue(args, needle) {
-  for (let i = 0; i < args.length; i += 1) {
-    if (args[i] === needle) return args[i + 1];
-    if (args[i].startsWith(`${needle}=`)) return args[i].slice(needle.length + 1);
-  }
-  return void 0;
-}
-function shellQuote(value) {
-  return /^[A-Za-z0-9_./:=@+-]+$/u.test(value) ? value : `'${value.replace(/'/gu, `'\\''`)}'`;
-}
-function isAdapter(value) {
-  return value !== void 0 && adapterRegistry.has(value);
-}
-function parseHarnessArgs(args) {
-  const forward = [];
-  let adapter;
-  let json = false;
-  let quiet = false;
-  let separator = false;
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-    if (separator) {
-      forward.push(arg);
-      continue;
-    }
-    if (arg === "--") {
-      separator = true;
-      continue;
-    }
-    if (arg === "--json") {
-      json = true;
-      continue;
-    }
-    if (arg === "--quiet") {
-      quiet = true;
-      continue;
-    }
-    if (arg === "--adapter" || arg === "--platform") {
-      const value = args[i + 1];
-      if (arg === "--adapter") {
-        adapter = value;
-        i += 1;
-        continue;
-      }
-      if (adapter === void 0 && isAdapter(value)) {
-        adapter = value;
-        i += 1;
-        continue;
-      }
-      forward.push(arg);
-      continue;
-    }
-    if (arg.startsWith("--adapter=")) {
-      adapter = arg.slice("--adapter=".length);
-      continue;
-    }
-    if (arg.startsWith("--platform=")) {
-      const value = arg.slice("--platform=".length);
-      if (adapter === void 0 && isAdapter(value)) {
-        adapter = value;
-        continue;
-      }
-      forward.push(arg);
-      continue;
-    }
-    forward.push(arg);
-  }
-  return { adapter, json, quiet, forward };
-}
-const ADAPTER_DETECT_NEXT = "cd into a MetaMask checkout or pass --target <path>, or force it with --adapter <mobile|extension|core|terminal>";
-function detectAdapter(target) {
-  let remote = "";
-  try {
-    remote = execFileSync("git", ["-C", target, "config", "--get", "remote.origin.url"], {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
-    }).trim();
-  } catch {
-    remote = "";
-  }
-  if (remote.includes("metamask-extension")) return "extension";
-  if (remote.includes("metamask-mobile")) return "mobile";
-  const exists = (rel) => fs.existsSync(path.join(target, rel));
-  const isDir = (rel) => {
-    try {
-      return fs.statSync(path.join(target, rel)).isDirectory();
-    } catch {
-      return false;
-    }
-  };
-  if (exists("development/skills-sync.ts") || isDir("ui") && isDir("app/scripts")) return "extension";
-  if (exists("scripts/skills-sync.mts") || isDir("ios") && isDir("android") && isDir("app/core")) return "mobile";
-  if (isDir("packages/perps-controller") && exists("yarn.lock")) return "core";
-  if (remote.includes("va-mmcx-terminal") || isDir("src/features/perpetuals") && (exists("next.config.ts") || exists("next.config.mjs") || exists("next.config.js"))) return "terminal";
-  return void 0;
-}
-function resolveRuntimeContextPath(target) {
-  return process.env.RECIPE_RUNTIME_CONTEXT ?? path.join(target, recipeRuntimeDir(), "agentic-runtime.json");
-}
-function readRuntimeContextField(contextPath, field) {
-  let data;
-  try {
-    data = JSON.parse(fs.readFileSync(contextPath, "utf8"));
-  } catch {
-    return void 0;
-  }
-  let node = data;
-  for (const key of field.split(".")) {
-    if (node === void 0 || node === null || typeof node !== "object") return void 0;
-    node = node[key];
-  }
-  if (node === void 0 || node === null || node === "") return void 0;
-  return String(node);
-}
-function resolveEntry(base, candidates, mode) {
-  for (const candidate of candidates) {
-    const full = path.resolve(base, candidate);
-    try {
-      const stat = fs.statSync(full);
-      if (!stat.isFile()) continue;
-      if (mode === "file" || (stat.mode & 73) !== 0) return full;
-    } catch {
-    }
-  }
-  return path.resolve(base, candidates[0]);
-}
-function installedRunnerSource(target, adapter) {
-  const pointer = path.join(recipeHarnessPath(target, adapter), "runner", ".runner-source");
-  if (!fs.existsSync(pointer)) return void 0;
-  const value = fs.readFileSync(pointer, "utf8").trim();
-  if (!value || !fs.existsSync(value)) return void 0;
-  return value;
-}
-function resolveHarnessDispatch(surface, action, target) {
-  if (action === "verify") return surface.harness.verify(target);
-  const leaf = action === "install" ? surface.harness.install : surface.harness.cleanup;
-  const base = action === "cleanup" && surface.harness.cleanup.fromInstalledRunner ? installedRunnerSource(target, surface.id) ?? runnerDir : runnerDir;
-  const entry = resolveEntry(base, [leaf.entry, leaf.fallback], "file");
-  return leaf.node ? { command: process.execPath, prefixArgs: [entry] } : { command: entry, prefixArgs: [] };
-}
-async function handleHarness(argv) {
-  const action = argv[0];
-  if (!action || action === "-h" || action === "--help") {
-    harnessUsage();
-    return action ? 0 : 2;
-  }
-  if (!HARNESS_ACTIONS.includes(action)) {
-    harnessUsage();
-    console.error(`unsupported harness subcommand: ${action}`);
-    return 2;
-  }
-  const harnessAction = action;
-  const { getAdapterSurface } = await import("./adapters/surface.js");
-  const { adapter: parsedAdapter, json, quiet, forward } = parseHarnessArgs(argv.slice(1));
-  const rawTarget = argValue(forward, "--target");
-  const target = path.resolve(rawTarget ?? process.cwd());
-  const adapter = parsedAdapter ?? detectAdapter(target);
-  if (!adapter || !isAdapter(adapter)) {
-    if (quiet) {
-      return 2;
-    } else if (json) {
-      const detectError = adapter ? { code: "UNSUPPORTED_PLATFORM", message: `unsupported platform: ${adapter}`, userAction: "pass --adapter <mobile|extension|core|terminal> to specify a supported adapter" } : { code: "ADAPTER_DETECTION_FAILED", message: `could not detect the MetaMask repo type for ${target}`, userAction: ADAPTER_DETECT_NEXT };
-      console.log(harnessSummary(harnessAction, void 0, target, "fail", 2, false, detectError));
-    } else {
-      harnessUsage();
-      console.error(
-        adapter ? `
-\u2717 unsupported platform: ${adapter}` : `
-\u2717 could not detect the MetaMask repo type for ${target}
-  Next: ${ADAPTER_DETECT_NEXT}`
-      );
-    }
-    return 2;
-  }
-  const autoDetected = parsedAdapter === void 0;
-  let forwardArgs = hasArg(forward, "--target") ? [...forward] : ["--target", target, ...forward];
-  if (harnessAction === "install" && hasArg(forward, "--runway")) {
-    return handleRunwayInstall(adapter, target, forward, json);
-  }
-  const surface = getAdapterSurface(adapter);
-  if (harnessAction === "verify" && surface.harness.verifyArgs) {
-    forwardArgs = surface.harness.verifyArgs(target, forwardArgs);
-  }
-  const dispatch = resolveHarnessDispatch(surface, harnessAction, target);
-  if ("error" in dispatch) {
-    if (quiet) {
-      return 1;
-    } else if (json) {
-      console.log(
-        harnessSummary(harnessAction, adapter, target, "fail", 1, autoDetected, {
-          code: "DISPATCH_UNAVAILABLE",
-          message: dispatch.error,
-          // The dispatch error embeds "Next: <hint>" — extract it so --json consumers
-          // get a clean programmatic escape without parsing the human message.
-          userAction: dispatch.error.split("\nNext: ")[1] ?? "run mm-harness install to complete setup, then retry"
-        })
-      );
-    } else {
-      console.error(`\u2717 ${harnessAction} ${adapter} failed
-  ${dispatch.error.replace(/\n/gu, "\n  ")}`);
-    }
-    return 1;
-  }
-  if (!json && !quiet) {
-    const detected = autoDetected ? ", auto-detected" : "";
-    console.error(colorHumanMessage(`\u2192 ${harnessAction} (${adapter}${detected}) \u2014 target: ${target}`));
-  }
-  const start = Date.now();
-  if ("inProcess" in dispatch) {
-    const runVerify = await dispatch.inProcess();
-    let exitCode;
-    try {
-      exitCode = await runVerify(forwardArgs, {
-        out: quiet ? () => {
-        } : (line) => {
-          (json ? process.stderr : process.stdout).write(`${line}
-`);
-        },
-        err: quiet ? () => {
-        } : (line) => {
-          process.stderr.write(`${line}
-`);
-        }
-      });
-    } catch (error) {
-      if (!quiet) process.stderr.write(`${error instanceof Error ? error.message : String(error)}
-`);
-      exitCode = 1;
-    }
-    return reportHarnessOutcome(harnessAction, surface, target, exitCode, autoDetected, json, quiet, start);
-  }
-  if (shellLeafMissing(dispatch.command)) {
-    const message = missingShellLeafMessage(dispatch.command);
-    if (quiet) {
-      return 1;
-    } else if (json) {
-      console.log(
-        harnessSummary(harnessAction, adapter, target, "fail", 1, autoDetected, {
-          code: "HARNESS_SPAWN_FAILED",
-          message,
-          userAction: failureHint(surface, harnessAction)
-        })
-      );
-    } else {
-      console.error(`\u2717 ${message}`);
-    }
-    return 1;
-  }
-  const result = await spawnScriptStreaming(dispatch.command, [...dispatch.prefixArgs, ...forwardArgs], target, {
-    forward: quiet ? "none" : json ? "stderr" : "original",
-    stdin: quiet ? "ignore" : "inherit",
-    capture: false
-  });
-  if (result.error) {
-    if (quiet) {
-      return 1;
-    } else if (json) {
-      console.log(
-        harnessSummary(harnessAction, adapter, target, "fail", 1, autoDetected, {
-          code: "HARNESS_SPAWN_FAILED",
-          message: `${harnessAction} ${adapter} could not start: ${result.error.message}`,
-          userAction: failureHint(surface, harnessAction)
-        })
-      );
-    } else {
-      console.error(`\u2717 ${harnessAction} ${adapter} could not start: ${result.error.message}
-  ${failureHint(surface, harnessAction)}`);
-    }
-    return 1;
-  }
-  return reportHarnessOutcome(harnessAction, surface, target, result.status ?? 1, autoDetected, json, quiet, start);
-}
-function reportHarnessOutcome(action, surface, target, exitCode, autoDetected, json, quiet, start) {
-  const seconds = ((Date.now() - start) / 1e3).toFixed(1);
-  const adapter = surface.id;
-  if (quiet) {
-    return exitCode;
-  } else if (json) {
-    console.log(
-      harnessSummary(
-        action,
-        adapter,
-        target,
-        exitCode === 0 ? "pass" : "fail",
-        exitCode,
-        autoDetected,
-        exitCode === 0 ? void 0 : { code: "HARNESS_FAILED", message: `${action} ${adapter} failed (exit ${exitCode})`, userAction: failureHint(surface, action) }
-      )
-    );
-  } else if (exitCode === 0) {
-    console.error(colorHumanMessage(`\u2713 ${action} ${adapter} passed (${seconds}s)
-  Next: ${successNext(adapter, action, target)}`));
-  } else {
-    console.error(colorHumanMessage(`\u2717 ${action} ${adapter} failed (exit ${exitCode}, ${seconds}s)
-  ${failureHint(surface, action)}`));
-  }
-  return exitCode;
-}
-async function handleRunwayInstall(adapter, target, forward, json) {
-  const { getAdapterSurface } = await import("./adapters/surface.js");
-  const rerunCommand = runwayInstallRerunCommand(adapter, target, forward, json);
-  const surface = getAdapterSurface(adapter);
-  const runtimeDir = argValue(forward, "--runtime-dir");
-  const watcherPort = argValue(forward, "--watcher-port");
-  const result = await surface.runwayProvision.run(target, {
-    json,
-    platform: argValue(forward, "--platform") ?? "ios",
-    branch: argValue(forward, "--branch"),
-    defaultBranch: argValue(forward, "--default-branch"),
-    run: argValue(forward, "--run"),
-    cacheRoot: argValue(forward, "--cache-root"),
-    simulator: argValue(forward, "--simulator") ?? argValue(forward, "--device"),
-    runtime: argValue(forward, "--runtime"),
-    deviceType: argValue(forward, "--device-type"),
-    slot: argValue(forward, "--slot"),
-    watcherPort,
-    runtimeDir,
-    force: hasArg(forward, "--force"),
-    resolveOnly: hasArg(forward, "--resolve-only"),
-    rerunCommand
-  });
-  const provisionedSimulator = typeof result.simulator === "object" && result.simulator ? result.simulator : void 0;
-  const provisionedDevice = typeof provisionedSimulator?.udid === "string" ? provisionedSimulator.udid : typeof provisionedSimulator?.name === "string" ? provisionedSimulator.name : void 0;
-  const next = result.status === "pass" && surface.runwayProvision.launchNext && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? "ios")} --adapter ${adapter} --target ${shellQuote(target)}` + (provisionedDevice ? ` --device ${shellQuote(provisionedDevice)}` : "") : void 0;
-  const output = next ? { ...result, next } : result;
-  if (json) {
-    console.log(JSON.stringify(output, null, 2));
-  } else if (result.status === "pass") {
-    const cache = typeof result.cache === "object" && result.cache ? result.cache : void 0;
-    const simulator = provisionedSimulator;
-    const artifact = typeof result.artifact === "object" && result.artifact ? result.artifact : void 0;
-    if (result.resolveOnly) {
-      console.error(`\u2713 resolved Runway app for ${adapter} ${result.platform ?? ""} run=${artifact?.runId ?? "unknown"} revision=${artifact?.revision ?? "unknown"} artifact=${artifact?.artifactName ?? "unknown"}`);
-    } else {
-      const action = result.skipped ? "already provisioned" : "installed Runway app";
-      console.error(`\u2713 ${action} for ${adapter} ${result.platform ?? ""} simulator=${simulator?.name ?? "unknown"} udid=${simulator?.udid ?? "unknown"} cache=${cache?.status ?? "skip"}`);
-    }
-    if (next) console.error(`  Next: ${next}`);
-  } else {
-    console.error(`\u2717 mm-harness install --runway: ${result.error?.message ?? "runway install failed"}
-  Next: ${result.error?.userAction ?? rerunCommand}`);
-  }
-  return result.exitCode;
-}
-function runwayInstallRerunCommand(adapter, target, forward, json) {
-  const parts = ["mm-harness", "install", "--runway", "--adapter", adapter, "--target", shellQuote(target)];
-  const valueFlags = [
-    "--platform",
-    "--branch",
-    "--default-branch",
-    "--run",
-    "--cache-root",
-    "--simulator",
-    "--device",
-    "--slot",
-    "--watcher-port",
-    "--runtime-dir",
-    "--runtime",
-    "--device-type"
-  ];
-  for (const flag of valueFlags) {
-    const value = argValue(forward, flag);
-    if (value) parts.push(flag, shellQuote(value));
-  }
-  if (hasArg(forward, "--force")) parts.push("--force");
-  if (hasArg(forward, "--resolve-only")) parts.push("--resolve-only");
-  if (json) parts.push("--json");
-  return parts.join(" ");
-}
-function harnessSummary(action, adapter, target, status, exitCode, autoDetected, error) {
-  return JSON.stringify({
-    schemaVersion: 1,
-    command: "harness",
-    action,
-    adapter: adapter ?? null,
-    target,
-    autoDetected,
-    status,
-    exitCode,
-    // Error contract: every --json failure carries a stable machine code + human
-    // message. userAction is included when present so callers
-    // can surface the reachable escape without parsing the human message.
-    ...status === "fail" && error ? { error } : {},
-    ...status === "pass" && adapter ? { next: successNext(adapter, action, target) } : {}
-  });
-}
-export {
-  ADAPTER_DETECT_NEXT,
-  detectAdapter,
-  handleHarness,
-  readRuntimeContextField,
-  resolveRuntimeContextPath
-};

package/dist/heal-bounds.js

@@ -1,137 +0,0 @@
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { getAdapterSurface } from "./adapters/surface.js";
-import { handleHarness } from "./harness.js";
-import { recipeHarnessPath, recipeRuntimePath } from "./paths.js";
-import { EXIT } from "./commands/shared.js";
-function newHealState() {
-  return { recovered: [], mutations: [], attemptedRecoveries: [] };
-}
-function conciseFailureForHuman(output) {
-  const errors = output.split(/\r?\n/u).map((line) => /^(?:[A-Za-z]*Error):\s*(.+)$/u.exec(line.trim())?.[1]).filter((line) => Boolean(line));
-  return errors.at(-1) ?? output.trim();
-}
-function parseHeal(options, fallback) {
-  const value = options.heal;
-  if (value === void 0) return fallback;
-  if (value === "off" || value === "infra-only" || value === "auto") return value;
-  return { error: `--heal must be off, infra-only, or auto (got "${String(value)}").` };
-}
-function overlayDir(target, adapter) {
-  return recipeHarnessPath(target, adapter);
-}
-function overlayPresent(target, adapter) {
-  try {
-    return fs.statSync(overlayDir(target, adapter)).isDirectory();
-  } catch {
-    return false;
-  }
-}
-function overlayDelegateValid(target, adapter) {
-  if (getAdapterSurface(adapter).headless) return true;
-  const pointer = path.join(recipeHarnessPath(target, adapter), "runner", ".runner-source");
-  if (!fs.existsSync(pointer)) return true;
-  const runnerPath = fs.readFileSync(pointer, "utf8").trim();
-  if (!Boolean(runnerPath) || !fs.existsSync(runnerPath)) return false;
-  return fs.existsSync(path.join(runnerPath, "bin", "mm-harness"));
-}
-async function ensureOverlay(adapter, target, heal, state, json) {
-  if (getAdapterSurface(adapter).headless) return { ok: true };
-  if (overlayPresent(target, adapter) && overlayDelegateValid(target, adapter)) return { ok: true };
-  if (heal === "off") return { ok: true };
-  const installBin = process.env.MM_HARNESS_INSTALL_BIN;
-  let code;
-  if (installBin) {
-    const result = spawnSync(installBin, ["install", "--platform", adapter, "--target", target], {
-      cwd: target,
-      stdio: ["ignore", 2, "inherit"],
-      env: process.env
-    });
-    code = result.status ?? 1;
-  } else {
-    code = await handleHarness(["install", "--platform", adapter, "--target", target, "--quiet"]);
-  }
-  if (code !== 0 || !overlayPresent(target, adapter)) {
-    return { ok: false, error: `runtime overlay install failed (exit ${code})` };
-  }
-  const dir = overlayDir(target, adapter);
-  state.mutations.push({ type: "file", action: "created", path: dir });
-  if (!json) process.stderr.write(`installed mm-harness overlay \u2192 ${dir}
-`);
-  return { ok: true };
-}
-function classifyFailure(output) {
-  if (/SCREENSHOT_PROTECTED|screenshot is protected by FLAG_SECURE/iu.test(output)) return "screenshot-protected";
-  if (/CDP_TIMEOUT|Mobile CDP bridge command timed out|NO_TARGET|WS_CLOSED/iu.test(output)) return "infra";
-  if (/fixture|keyring|not seeded|\bsrp\b|password|onboard/iu.test(output)) return "wallet";
-  if (/metro|cdp|chrome|bridge|bundle|packager|port\b|econnrefused|not reachable|watcher|dev client|websocket/iu.test(output)) {
-    return "infra";
-  }
-  return "app";
-}
-function recipeRunning(target) {
-  if (process.env.MM_HARNESS_RECIPE_RUNNING === "1") return true;
-  return fs.existsSync(recipeRuntimePath(target, "recipe.lock"));
-}
-const RECOVERY_CODE = {
-  mobile: "metro.restarted",
-  extension: "chrome.reopened"
-};
-function checkHealBounds(target, output, state) {
-  const originalError = output.trim() || void 0;
-  if (recipeRunning(target)) {
-    return {
-      code: "RECIPE_RUNNING",
-      exitCode: EXIT.bounded,
-      message: "a recipe is currently running \u2014 refusing recovery to avoid corrupting mid-run state.",
-      originalError
-    };
-  }
-  const failureClass = classifyFailure(conciseFailureForHuman(output));
-  if (failureClass === "screenshot-protected") {
-    return {
-      code: "SCREENSHOT_PROTECTED",
-      exitCode: EXIT.runtime,
-      message: "the focused Android window intentionally blocks screenshots; a black capture cannot be used as evidence.",
-      userAction: "unlock or navigate to a non-protected screen, then rerun the screenshot action",
-      originalError
-    };
-  }
-  if (failureClass === "wallet") {
-    return {
-      code: "WALLET_STATE_REQUIRED",
-      exitCode: EXIT.bounded,
-      message: "wallet prerequisites need attention; healing never changes wallet state.",
-      userAction: /(?:^|\n)\s*Next:\s*([^\r\n]+)/u.exec(output)?.[1] ?? "run mm-harness doctor --json",
-      originalError
-    };
-  }
-  if (failureClass === "app") {
-    return {
-      code: "APP_LOGIC_FAILURE",
-      exitCode: EXIT.runtime,
-      message: "failure looks like app-logic \u2014 healing cannot help; surface verbatim.",
-      originalError
-    };
-  }
-  if (state.attemptedRecoveries.length > 0) {
-    return {
-      code: "SAME_RECOVERY_TWICE",
-      exitCode: EXIT.bounded,
-      message: state.recovered.length > 0 ? "one recovery already succeeded this invocation \u2014 bounded policy refuses a second recovery." : "one recovery was already attempted this invocation \u2014 refusing to loop.",
-      originalError
-    };
-  }
-  return null;
-}
-export {
-  RECOVERY_CODE,
-  checkHealBounds,
-  classifyFailure,
-  conciseFailureForHuman,
-  ensureOverlay,
-  newHealState,
-  parseHeal,
-  recipeRunning
-};

package/dist/json-stream.js

@@ -1,60 +0,0 @@
-import { recordCommandStage } from "./command-journal.js";
-class JsonStreamWriter {
-  enabled;
-  command;
-  completed = false;
-  writeLine;
-  constructor(command, enabled, output = process.stdout) {
-    this.command = command;
-    this.enabled = enabled;
-    const write = output.write.bind(output);
-    this.writeLine = (line) => {
-      write(`${line}
-`);
-    };
-  }
-  isolateStdout() {
-    if (!this.enabled) return () => void 0;
-    const original = process.stdout.write;
-    const redirect = ((chunk, encoding, callback) => process.stderr.write(chunk, encoding, callback));
-    process.stdout.write = redirect;
-    return () => {
-      if (process.stdout.write === redirect) process.stdout.write = original;
-    };
-  }
-  emit(event, fields = {}) {
-    if (!this.enabled || this.completed) return;
-    this.writeLine(JSON.stringify({
-      schemaVersion: 1,
-      command: this.command,
-      event,
-      ...fields,
-      ts: (/* @__PURE__ */ new Date()).toISOString()
-    }));
-  }
-  phase(phase, fields = {}) {
-    recordCommandStage(phase);
-    this.emit("phase", { phase, ...fields });
-  }
-  node(nodeId, action, status) {
-    if (status === "running") recordCommandStage(`${nodeId}: ${action}`);
-    this.emit("node", { nodeId, action, status });
-  }
-  mutation(mutation) {
-    this.emit("mutation", { mutation });
-  }
-  recovery(code) {
-    this.emit("recovery", { code });
-  }
-  error(error) {
-    this.emit("error", { error });
-  }
-  complete(status, exitCode, fields = {}) {
-    if (!this.enabled || this.completed) return;
-    this.emit("complete", { status, exitCode, ...fields });
-    this.completed = true;
-  }
-}
-export {
-  JsonStreamWriter
-};

package/dist/leaf-invoke.js

@@ -1,19 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-function resolveLeafInvoke(command, args) {
-  if (command.endsWith(".sh")) return { bin: "bash", args: [command, ...args] };
-  return { bin: command, args };
-}
-function missingShellLeafMessage(leafPath) {
-  const leaf = path.basename(leafPath);
-  return `leaf could not start: ${leaf} (ENOENT)
-  Next: reinstall mm-harness (npm i -g @deeeed/metamask-harness) \u2014 the shell leaf is missing or not executable`;
-}
-function shellLeafMissing(leafPath) {
-  return leafPath.endsWith(".sh") && !fs.existsSync(leafPath);
-}
-export {
-  missingShellLeafMessage,
-  resolveLeafInvoke,
-  shellLeafMissing
-};