@deeeed/metamask-harness 0.79.0 → 0.81.0

package/dist/commands/shared.js

@@ -1,323 +0,0 @@
-import { trackCheckoutChild } from "../checkout-lock.js";
-import { recordCommandOutput, recordCommandStage } from "../command-journal.js";
-import { spawn, spawnSync } from "node:child_process";
-import { StringDecoder } from "node:string_decoder";
-import { OperationOutputTail } from "@farmslot/recipe-runner/runtime/operation";
-import path from "node:path";
-import { detectAdapter } from "../harness.js";
-import { colorHumanMessage } from "../cli-color.js";
-import { resolveLeafInvoke, shellLeafMissing } from "../leaf-invoke.js";
-import { adapterRegistry } from "../adapters/registry.js";
-const EXIT = { ok: 0, runtime: 1, usage: 2, infra: 3, bounded: 4, validation: 5 };
-function writeInteractiveProgress(json, message, {
-  stdoutIsTTY = Boolean(process.stdout.isTTY),
-  stream = process.stderr
-} = {}) {
-  if (json || !stdoutIsTTY) return false;
-  stream.write(`${colorHumanMessage(message, { stream })}
-`);
-  return true;
-}
-function parseFlags(argv, booleans) {
-  const positional = [];
-  const options = {};
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (!arg.startsWith("--")) {
-      positional.push(arg);
-      continue;
-    }
-    const body = arg.slice(2);
-    const eq = body.indexOf("=");
-    const rawKey = eq === -1 ? body : body.slice(0, eq);
-    const inline = eq === -1 ? void 0 : body.slice(eq + 1);
-    const key = rawKey.replace(/-([a-z])/gu, (_, c) => c.toUpperCase());
-    if (booleans.has(key)) {
-      options[key] = inline === void 0 ? true : inline !== "false";
-      continue;
-    }
-    if (inline !== void 0) {
-      options[key] = inline;
-      continue;
-    }
-    const next = argv[i + 1];
-    if (next === void 0 || next.startsWith("--")) {
-      options[key] = true;
-      continue;
-    }
-    options[key] = next;
-    i += 1;
-  }
-  return { positional, options };
-}
-function str(options, key) {
-  const value = options[key];
-  return typeof value === "string" ? value : void 0;
-}
-function flag(options, key) {
-  return options[key] === true;
-}
-function targetOf(options) {
-  return path.resolve(str(options, "target") ?? process.cwd());
-}
-function resolveAdapter(options, target, hint) {
-  const platform = str(options, "platform");
-  const explicit = str(options, "adapter") ?? (platform === "ios" || platform === "android" ? "mobile" : platform);
-  if (explicit && adapterRegistry.has(explicit)) return explicit;
-  if (hint) return hint;
-  return detectAdapter(target);
-}
-function scriptOverride(scriptPath) {
-  const stem = path.basename(scriptPath).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase();
-  return process.env[`MM_HARNESS_SCRIPT_BIN_${stem}`];
-}
-function spawnScript(script, args, cwd, json, env) {
-  const isNodeScript = script === process.execPath && args.length > 0;
-  const stem = isNodeScript ? path.basename(args[0]).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase() : path.basename(script).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase();
-  const override = process.env[`MM_HARNESS_SCRIPT_BIN_${stem}`];
-  const bin = override ?? script;
-  const directArgs = override !== void 0 && isNodeScript ? args.slice(1) : args;
-  if (shellLeafMissing(bin)) {
-    const message = `leaf could not start: ${path.basename(bin)} (ENOENT)
-  Next: reinstall mm-harness (npm i -g @deeeed/metamask-harness) \u2014 the shell leaf is missing or not executable`;
-    process.stderr.write(`${message}
-`);
-    return { status: 1, output: message };
-  }
-  const { bin: invokeBin, args: spawnArgs } = resolveLeafInvoke(bin, directArgs);
-  recordCommandStage(path.basename(isNodeScript ? args[0] : script));
-  const result = spawnSync(invokeBin, spawnArgs, {
-    cwd,
-    encoding: "utf8",
-    env: env ? { ...process.env, ...env } : process.env,
-    maxBuffer: 64 * 1024 * 1024
-  });
-  if (result.error) {
-    const leaf = isNodeScript ? path.basename(args[0]) : path.basename(script);
-    const code = result.error.code ?? "ESPAWN";
-    const message = `leaf could not start: ${leaf} (${code})
-  Next: reinstall mm-harness (npm i -g @deeeed/metamask-harness) \u2014 the shell leaf is missing or not executable`;
-    process.stderr.write(`${message}
-`);
-    return { status: 1, output: message };
-  }
-  const output = `${result.stdout ?? ""}${result.stderr ?? ""}`;
-  recordCommandOutput(output);
-  if (!json && output) process.stderr.write(output);
-  return { status: result.status ?? 1, output };
-}
-function spawnInherit(script, args, cwd) {
-  const isNodeScript = script === process.execPath && args.length > 0;
-  const stem = (isNodeScript ? path.basename(args[0]) : path.basename(script)).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase();
-  const override = process.env[`MM_HARNESS_SCRIPT_BIN_${stem}`];
-  const bin = override ?? script;
-  const directArgs = override !== void 0 && isNodeScript ? args.slice(1) : args;
-  const { bin: invokeBin, args: spawnArgs } = resolveLeafInvoke(bin, directArgs);
-  const result = spawnSync(invokeBin, spawnArgs, { cwd, stdio: "inherit", env: process.env });
-  if (result.error) {
-    const leaf = isNodeScript ? path.basename(args[0]) : path.basename(script);
-    const code = result.error.code ?? "ESPAWN";
-    process.stderr.write(
-      `leaf could not start: ${leaf} (${code})
-  Next: reinstall mm-harness (npm i -g @deeeed/metamask-harness) \u2014 the leaf is missing or not executable
-`
-    );
-    return 1;
-  }
-  if (result.status !== null) return result.status;
-  return result.signal === "SIGINT" || result.signal === "SIGTERM" ? 0 : 1;
-}
-function spawnScriptStreaming(script, args, cwd, options) {
-  const spawnOptions = options && ("env" in options || "timeoutMs" in options || "forward" in options || "capture" in options || "stdin" in options || "stage" in options) ? options : { env: options };
-  const isNodeScript = script === process.execPath && args.length > 0;
-  const stem = isNodeScript ? path.basename(args[0]).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase() : path.basename(script).replace(/[^A-Za-z0-9]/gu, "_").toUpperCase();
-  const override = process.env[`MM_HARNESS_SCRIPT_BIN_${stem}`];
-  const bin = override ?? script;
-  const directArgs = override !== void 0 && isNodeScript ? args.slice(1) : args;
-  if (shellLeafMissing(bin)) {
-    const message = `leaf could not start: ${path.basename(bin)} (ENOENT)
-  Next: reinstall mm-harness (npm i -g @deeeed/metamask-harness) \u2014 the shell leaf is missing or not executable`;
-    if (spawnOptions.forward !== "none") process.stderr.write(`${message}
-`);
-    return Promise.resolve({ status: 1, output: message });
-  }
-  const { bin: invokeBin, args: spawnArgs } = resolveLeafInvoke(bin, directArgs);
-  recordCommandStage(spawnOptions.stage ?? path.basename(isNodeScript ? args[0] : script));
-  return new Promise((resolve, reject) => {
-    const ownsProcessGroup = process.platform !== "win32";
-    const child = spawn(invokeBin, spawnArgs, {
-      cwd,
-      env: spawnOptions.env ? { ...process.env, ...spawnOptions.env } : process.env,
-      stdio: [spawnOptions.stdin ?? "ignore", "pipe", "pipe"],
-      detached: ownsProcessGroup
-    });
-    let untrack;
-    try {
-      untrack = child.pid ? trackCheckoutChild(cwd, child.pid, ownsProcessGroup) : void 0;
-    } catch (error) {
-      child.once("error", reject);
-      child.once("close", () => reject(error));
-      try {
-        if (ownsProcessGroup && child.pid) process.kill(-child.pid, "SIGKILL");
-        else child.kill("SIGKILL");
-      } catch (killError) {
-        if (killError.code !== "ESRCH") reject(killError);
-      }
-      return;
-    }
-    const captured = new OperationOutputTail();
-    let settled = false;
-    let didTimeout = false;
-    let escalation;
-    let forwardedParentSignal;
-    let parentSignalFallback;
-    const parentSignals = ["SIGINT", "SIGTERM", "SIGHUP", "SIGQUIT"];
-    const removeParentSignalHandlers = () => {
-      for (const signal of parentSignals) process.removeListener(signal, parentSignalHandlers[signal]);
-    };
-    const finish = (result) => {
-      if (settled) return;
-      settled = true;
-      if (timer) clearTimeout(timer);
-      if (escalation) clearTimeout(escalation);
-      if (parentSignalFallback) clearTimeout(parentSignalFallback);
-      removeParentSignalHandlers();
-      resolve(result);
-    };
-    const signalChildTree = (signal) => {
-      try {
-        if (ownsProcessGroup && child.pid) process.kill(-child.pid, signal);
-        else child.kill(signal);
-      } catch {
-      }
-    };
-    const exitFromForwardedSignal = () => {
-      if (!forwardedParentSignal) return;
-      const signal = forwardedParentSignal;
-      forwardedParentSignal = void 0;
-      if (parentSignalFallback) clearTimeout(parentSignalFallback);
-      process.kill(process.pid, signal);
-    };
-    const parentSignalHandlers = Object.fromEntries(parentSignals.map((signal) => [signal, () => {
-      if (forwardedParentSignal) return;
-      forwardedParentSignal = signal;
-      signalChildTree(signal);
-      removeParentSignalHandlers();
-      if (Number(spawnOptions.timeoutMs) > 0) parentSignalFallback = setTimeout(() => {
-        signalChildTree("SIGKILL");
-        exitFromForwardedSignal();
-      }, 1e3);
-    }]));
-    if (ownsProcessGroup) {
-      for (const signal of parentSignals) process.once(signal, parentSignalHandlers[signal]);
-    }
-    const timeoutMs = spawnOptions.timeoutMs;
-    const timer = Number.isFinite(timeoutMs) && Number(timeoutMs) > 0 ? setTimeout(() => {
-      didTimeout = true;
-      const message = `leaf timed out after ${String(timeoutMs)}ms: ${path.basename(script)}`;
-      captured.append(`
-${message}
-`);
-      if (spawnOptions.forward !== "none") process.stderr.write(`${message}
-`);
-      signalChildTree("SIGTERM");
-      escalation = setTimeout(() => {
-        signalChildTree("SIGKILL");
-        finish({ status: 1, output: captured.toString(), timedOut: true, timeoutMs: Number(timeoutMs) });
-      }, 1e3);
-    }, Number(timeoutMs)) : void 0;
-    const decoders = [new StringDecoder("utf8"), new StringDecoder("utf8")];
-    const tee = (chunk, stdout = false) => {
-      if (spawnOptions.capture !== false) captured.append(decoders[stdout ? 0 : 1].write(chunk));
-      recordCommandOutput(chunk);
-      if (spawnOptions.forward !== "none") {
-        (stdout && spawnOptions.forward === "original" ? process.stdout : process.stderr).write(chunk);
-      }
-    };
-    child.stdout?.on("data", (chunk) => tee(chunk, true));
-    child.stderr?.on("data", tee);
-    child.on("error", (error) => {
-      const leaf = isNodeScript ? path.basename(args[0]) : path.basename(script);
-      const code = error.code ?? "ESPAWN";
-      const message = `leaf could not start: ${leaf} (${code})
-  Next: reinstall mm-harness (npm i -g @deeeed/metamask-harness) \u2014 the shell leaf is missing or not executable`;
-      if (spawnOptions.forward !== "none") process.stderr.write(`${message}
-`);
-      finish({ status: 1, output: message, error });
-    });
-    child.on("exit", () => {
-      if (forwardedParentSignal) {
-        exitFromForwardedSignal();
-        return;
-      }
-      if (!didTimeout) return;
-      signalChildTree("SIGKILL");
-      finish({ status: 1, output: captured.toString(), timedOut: true, timeoutMs: Number(timeoutMs) });
-    });
-    child.on("close", (status) => {
-      if (status !== null) untrack?.();
-      if (spawnOptions.capture !== false) captured.append(decoders.map((decoder) => decoder.end()).join(""));
-      if (didTimeout) signalChildTree("SIGKILL");
-      finish({
-        status: didTimeout ? 1 : status ?? 1,
-        output: captured.toString(),
-        ...didTimeout ? { timedOut: true, timeoutMs: Number(timeoutMs) } : {}
-      });
-    });
-  });
-}
-import { ADAPTER_DETECT_NEXT } from "../harness.js";
-function usageOut(json, command, message, userAction) {
-  if (json) {
-    console.log(
-      JSON.stringify(
-        { schemaVersion: 1, command, status: "fail", exitCode: EXIT.usage, error: { code: "USAGE", message, userAction } },
-        null,
-        2
-      )
-    );
-  } else {
-    console.error(`\u2717 mm-harness ${command}: ${message}
-  Next: ${userAction}`);
-  }
-  return EXIT.usage;
-}
-function checkoutBusyOut(json, command, message, lockPath) {
-  const userAction = `wait for the current owner, or inspect ${lockPath} if its process has exited`;
-  if (json) {
-    console.log(
-      JSON.stringify(
-        {
-          schemaVersion: 1,
-          command,
-          status: "fail",
-          exitCode: EXIT.bounded,
-          recoverable: false,
-          error: { code: "SANDBOX_BUSY", message, userAction }
-        },
-        null,
-        2
-      )
-    );
-  } else {
-    console.error(`\u2717 mm-harness ${command}: ${message}
-  Next: ${userAction}`);
-  }
-  return EXIT.bounded;
-}
-export {
-  ADAPTER_DETECT_NEXT,
-  EXIT,
-  checkoutBusyOut,
-  flag,
-  parseFlags,
-  resolveAdapter,
-  scriptOverride,
-  spawnInherit,
-  spawnScript,
-  spawnScriptStreaming,
-  str,
-  targetOf,
-  usageOut,
-  writeInteractiveProgress
-};

package/dist/commands/stop.js

@@ -1,60 +0,0 @@
-import { color } from "../cli-color.js";
-import { getAdapterSurface } from "../adapters/surface.js";
-import { usageOut } from "./shared.js";
-import { stopProjectCollector } from "../../library/actions/shared/analytics/collector.mjs";
-import {
-  parseArgs,
-  optionFlag,
-  optionString,
-  resolveAdapter,
-  shellQuote
-} from "./parse-args.js";
-async function handleStop(argv) {
-  const { options } = parseArgs(argv, "stop");
-  const json = optionFlag(options, "json");
-  const { adapter, target } = resolveAdapter(options);
-  const surface = getAdapterSurface(adapter);
-  surface.resolveSlotPorts(target);
-  const explicitPort = optionString(options, "port") ?? optionString(options, "watcherPort");
-  if (explicitPort) {
-    process.env.WATCHER_PORT = explicitPort;
-    process.env.METRO_PORT = explicitPort;
-  }
-  const stop = surface.devServer.stop(target);
-  if (stop.kind === "headless") {
-    return usageOut(json, "stop", stop.message, stop.userAction);
-  }
-  const collector = await stopProjectCollector(target);
-  const signalled = (stop.signalled ?? 0) + (collector.stopped ? 1 : 0);
-  const summary = collector.stopped ? `${stop.summary}; stopped analytics collector ${collector.pid}` : stop.summary;
-  const next = surface.devServer.afterStop?.(target);
-  const userAction = `mm-harness status --target ${shellQuote(target)} --json`;
-  if (json) {
-    console.log(
-      JSON.stringify(
-        {
-          schemaVersion: 1,
-          command: "stop",
-          adapter,
-          target,
-          status: stop.status === 0 ? "pass" : "fail",
-          ...stop.signalled !== void 0 || collector.stopped ? { signalled } : {},
-          exitCode: stop.status,
-          ...stop.output ? { output: stop.output } : {},
-          ...stop.status === 0 ? next ? { next } : {} : { error: { code: "DEV_SERVER_STOP_FAILED", message: summary, userAction } }
-        },
-        null,
-        2
-      )
-    );
-  } else {
-    if (stop.output) process.stderr.write(`${stop.output}
-`);
-    console.error(`${color(stop.status === 0 ? "ok" : "err", stop.status === 0 ? "\u2713" : "\u2717")} ${summary}`);
-    if (stop.status !== 0 || next) console.error(`  Next: ${stop.status === 0 ? next : userAction}`);
-  }
-  return stop.status;
-}
-export {
-  handleStop
-};

package/dist/devices.js

@@ -1,100 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { resolveMobileToolPath } from "../library/actions/mobile/platform/tool-paths.mjs";
-const IOS_DEVICE_DISCOVERY_TIMEOUT_MS = 3e4;
-function reportProbeFailure(errors, platform, error) {
-  const code = error?.code;
-  if (code === "ENOENT") return;
-  const timeoutSeconds = platform === "ios" ? IOS_DEVICE_DISCOVERY_TIMEOUT_MS / 1e3 : 5;
-  const reason = code === "ETIMEDOUT" ? `timed out after ${timeoutSeconds} seconds` : "failed";
-  const probeCode = code ?? error?.status;
-  errors.push({
-    platform,
-    message: `${platform} device discovery ${reason}; device availability is unknown.`,
-    userAction: platform === "ios" ? "xcrun simctl list devices booted -j" : "adb devices -l",
-    ...probeCode !== void 0 ? { probeCode } : {}
-  });
-}
-function listConnectedDevices(platform, errors = []) {
-  const devices = [];
-  if (!platform || platform === "android") devices.push(...listAndroidDevices(errors));
-  if (!platform || platform === "ios") devices.push(...listIosSimulators("booted", errors));
-  return devices;
-}
-function findAvailableIosSimulatorById(id, errors = []) {
-  for (const simulator of listIosSimulators("available", errors)) {
-    if (simulator.id === id) return simulator;
-  }
-  return void 0;
-}
-function listAndroidDevices(errors) {
-  const adbPath = resolveMobileToolPath("adb");
-  if (!adbPath) return [];
-  let output;
-  try {
-    output = execFileSync(adbPath, ["devices", "-l"], {
-      encoding: "utf8",
-      timeout: 5e3,
-      stdio: ["ignore", "pipe", "ignore"]
-    });
-  } catch (error) {
-    reportProbeFailure(errors, "android", error);
-    return [];
-  }
-  if (!output.trimStart().startsWith("List of devices attached")) {
-    errors.push({ platform: "android", message: "Android device discovery returned an invalid response; device availability is unknown.", userAction: "adb devices -l" });
-    return [];
-  }
-  const devices = [];
-  for (const line of output.split("\n").slice(1)) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    const fields = trimmed.split(/\s+/u);
-    const id = fields[0];
-    const state = fields[1] ?? "unknown";
-    if (!id) continue;
-    const modelField = fields.find((f) => f.startsWith("model:"));
-    const name = modelField ? modelField.slice("model:".length) : void 0;
-    devices.push({ platform: "android", id, state, ...name ? { name } : {} });
-  }
-  return devices;
-}
-function listIosSimulators(scope, errors) {
-  let output;
-  try {
-    output = execFileSync("xcrun", ["simctl", "list", "devices", scope, "-j"], {
-      encoding: "utf8",
-      timeout: IOS_DEVICE_DISCOVERY_TIMEOUT_MS,
-      stdio: ["ignore", "pipe", "ignore"]
-    });
-  } catch (error) {
-    reportProbeFailure(errors, "ios", error);
-    return [];
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(output);
-    if (!parsed?.devices || typeof parsed.devices !== "object" || Array.isArray(parsed.devices) || Object.values(parsed.devices).some((devices2) => !Array.isArray(devices2) || devices2.some((device) => !device || typeof device.udid !== "string"))) {
-      throw new Error("Invalid simctl device inventory");
-    }
-  } catch {
-    errors.push({ platform: "ios", message: "iOS device discovery returned an invalid response; device availability is unknown.", userAction: `xcrun simctl list devices ${scope} -j` });
-    return [];
-  }
-  const devices = [];
-  for (const runtimeDevices of Object.values(parsed.devices ?? {})) {
-    for (const device of runtimeDevices) {
-      if (!device.udid) continue;
-      devices.push({
-        platform: "ios",
-        id: device.udid,
-        state: device.state ?? "unknown",
-        ...device.name ? { name: device.name } : {}
-      });
-    }
-  }
-  return devices;
-}
-export {
-  findAvailableIosSimulatorById,
-  listConnectedDevices
-};

package/dist/discovery.js

@@ -1,15 +0,0 @@
-import { assessRecipe } from "@farmslot/recipe-cli";
-import {
-  loadRecipeLibraries
-} from "@farmslot/recipe-runner";
-import { resolveActionManifest } from "./manifest.js";
-async function runnableLibraryRecipes(adapter, sources) {
-  const resolution = await loadRecipeLibraries(sources, { adapter });
-  const { manifest } = await resolveActionManifest(adapter, void 0, sources);
-  return [...resolution.recipes.values()].filter(
-    (recipe) => assessRecipe({ resolution, manifest }, recipe).length === 0
-  );
-}
-export {
-  runnableLibraryRecipes
-};