@deeeed/metamask-harness 0.82.1 → 0.84.0

package/dist/adapters/web-dapp/doctor-checks.js

@@ -1,33 +0,0 @@
-import { POLICY_ENV, webDappPolicy } from "../../../adapters/web-dapp/lib/policy.mjs";
-import { webDappAppPort, webDappCdpPort } from "./surface.js";
-async function webDappDoctorChecks(target) {
-  if (!process.env[POLICY_ENV]) {
-    return [{
-      id: "web-dapp-venue-policy",
-      status: "fail",
-      required: true,
-      message: "web-dapp needs a venue policy: select an adapter that extends it (e.g. --adapter terminal with its recipe library on RECIPE_LIBRARY_PATH)."
-    }];
-  }
-  const policy = webDappPolicy();
-  const { webDappReadiness } = await import("../../../adapters/web-dapp/lib/readiness.mjs");
-  const { resolveBrowser } = await import("../../../adapters/web-dapp/launch.mjs");
-  const report = await webDappReadiness({
-    policy,
-    target,
-    appPort: webDappAppPort(),
-    cdpPort: webDappCdpPort(),
-    signer: process.env.TERMINAL_SIGNER || "extension",
-    account: process.env.TERMINAL_ACCOUNT || "dev1",
-    probeBrowser: resolveBrowser
-  });
-  return report.checks.map((check) => ({
-    id: `${policy.adapterId}-${check.id}`,
-    status: check.status === "pass" ? "pass" : "fail",
-    required: check.required,
-    message: check.detail
-  }));
-}
-export {
-  webDappDoctorChecks
-};

package/dist/adapters/web-dapp/launch.js

@@ -1,87 +0,0 @@
-import { flag, str } from "@farmslot/recipe-cli/harness";
-import { execFileSync } from "node:child_process";
-import path from "node:path";
-import { runnerDir } from "../../paths.js";
-import { webDappAdapterId } from "../../../adapters/web-dapp/lib/policy.mjs";
-const WEB_DAPP_ONLY_LAUNCH_OPTIONS = Object.freeze({
-  signer: "--signer",
-  account: "--account",
-  freshProfile: "--fresh-profile",
-  headless: "--headless",
-  headful: "--headful",
-  slowMo: "--slow-mo",
-  network: "--network",
-  mainnetConfirmation: "--mainnet-confirmation"
-});
-function webDappOnlyLaunchFlags(options) {
-  return Object.entries(WEB_DAPP_ONLY_LAUNCH_OPTIONS).filter(([key]) => options[key] !== void 0 && options[key] !== false).map(([, name]) => name);
-}
-function parseWebDappLauncherOutput(output) {
-  const text = output.trim();
-  if (!text) return { status: "fail", error: `the ${webDappAdapterId()} launcher printed no summary` };
-  try {
-    return JSON.parse(text);
-  } catch {
-    const last = text.split("\n").filter((line) => line.trim()).pop() ?? "";
-    try {
-      return JSON.parse(last);
-    } catch {
-      return { status: "fail", error: `the ${webDappAdapterId()} launcher printed no JSON summary: ${last.slice(0, 200)}` };
-    }
-  }
-}
-async function launchWebDapp({ options, target, jsonOutput, stream, usage }) {
-  const id = webDappAdapterId();
-  const cdpPort = str(options, "cdpPort") ?? process.env.RECIPE_CDP_PORT ?? process.env.CDP_PORT;
-  const appPort = str(options, "watcherPort") ?? process.env.TERMINAL_APP_PORT ?? process.env.RECIPE_WATCHER_PORT ?? process.env.WATCHER_PORT;
-  if (!cdpPort || !appPort) {
-    return usage(
-      `${id} launch needs the slot browser CDP port and the slot dev-server port.`,
-      `mm-harness launch --adapter ${id} --cdp-port <port> --watcher-port <app port>`
-    );
-  }
-  const args = [
-    path.join(runnerDir, "adapters", "web-dapp", "launch.mjs"),
-    "--target",
-    target,
-    "--cdp-port",
-    cdpPort,
-    "--app-port",
-    appPort,
-    "--signer",
-    str(options, "signer") ?? process.env.TERMINAL_SIGNER ?? "extension",
-    "--account",
-    str(options, "account") ?? process.env.TERMINAL_ACCOUNT ?? "dev1",
-    "--json"
-  ];
-  if (flag(options, "freshProfile")) args.push("--fresh-profile");
-  if (flag(options, "headless")) args.push("--headless");
-  if (flag(options, "headful")) args.push("--headful");
-  const slowMo = str(options, "slowMo");
-  if (slowMo) args.push("--slow-mo", slowMo);
-  const network = str(options, "network");
-  if (network) args.push("--network", network);
-  const mainnetConfirmation = str(options, "mainnetConfirmation");
-  if (mainnetConfirmation) args.push("--mainnet-confirmation", mainnetConfirmation);
-  stream.phase("launch", { adapter: id, cdpPort, appPort });
-  let output = "";
-  let status = 0;
-  try {
-    output = execFileSync(process.execPath, args, { encoding: "utf8", stdio: ["ignore", "pipe", "inherit"] });
-  } catch (error) {
-    status = 1;
-    output = String(error.stdout ?? "");
-  }
-  const result = parseWebDappLauncherOutput(output);
-  if (jsonOutput) console.log(JSON.stringify({ schemaVersion: 1, command: "launch", adapter: id, target, ...result }, null, 2));
-  else if (result.status === "pass") console.log(`\u2713 ${id} browser ${result.reused ? "reused" : "started"} on CDP ${result.cdpPort} (${result.signer}, ${result.account?.name})`);
-  else console.error(`\u2717 ${id} launch failed: ${result.error ?? "unknown error"}`);
-  stream.complete(result.status === "pass" ? "pass" : "fail", status);
-  return result.status === "pass" ? 0 : 1;
-}
-export {
-  WEB_DAPP_ONLY_LAUNCH_OPTIONS,
-  launchWebDapp,
-  parseWebDappLauncherOutput,
-  webDappOnlyLaunchFlags
-};

package/dist/adapters/web-dapp/overlay.js

@@ -1,21 +0,0 @@
-import path from "node:path";
-import { runnerDir } from "../../paths.js";
-const webDappHarness = {
-  install: { entry: "adapters/web-dapp/inject.mjs", fallback: "adapters/web-dapp/inject.mjs", node: true },
-  cleanup: { entry: "adapters/web-dapp/cleanup.mjs", fallback: "adapters/web-dapp/cleanup.mjs", node: true },
-  verify: () => ({
-    command: process.execPath,
-    prefixArgs: [path.join(runnerDir, "adapters", "web-dapp", "verify.mjs")]
-  }),
-  restart: "mm-harness launch"
-};
-const webDappRuntimeContext = {
-  forbiddenFields: ["metroPort", "simulator", "simulatorUdid", "adbSerial", "extensionId"],
-  resources: ({ existing, defaults, envPort }) => ({
-    cdpPort: envPort("RECIPE_CDP_PORT", "CDP_PORT") ?? existing.cdpPort ?? defaults.cdpPort
-  })
-};
-export {
-  webDappHarness,
-  webDappRuntimeContext
-};

package/dist/adapters/web-dapp/readiness.js

@@ -1,10 +0,0 @@
-import { POLICY_ENV, webDappPolicy } from "../../../adapters/web-dapp/lib/policy.mjs";
-const webDappReadiness = {
-  compatibilityMode: (target) => process.env[POLICY_ENV] && webDappPolicy().checkout.matches(target) ? "slot browser over CDP (website; no product bridge)" : "unsupported/no bridge",
-  liveChecks: async (target) => (await import("./doctor-checks.js")).webDappDoctorChecks(target),
-  // Screenshots come from the slot browser over CDP.
-  captureProviders: ["cdp"]
-};
-export {
-  webDappReadiness
-};

package/dist/adapters/web-dapp/stop.js

@@ -1,20 +0,0 @@
-import { spawnSync } from "node:child_process";
-import path from "node:path";
-import { runnerDir } from "../../paths.js";
-import { webDappAdapterId } from "../../../adapters/web-dapp/lib/policy.mjs";
-function stopWebDappBrowserSync(target) {
-  const args = [path.join(runnerDir, "adapters", "web-dapp", "stop.mjs"), "--target", path.resolve(target)];
-  const cdpPort = process.env.RECIPE_CDP_PORT ?? process.env.CDP_PORT;
-  if (cdpPort) args.push("--cdp-port", cdpPort);
-  const result = spawnSync(process.execPath, args, { encoding: "utf8" });
-  const output = `${result.stdout ?? ""}${result.stderr ?? ""}`;
-  const status = result.status ?? 1;
-  return {
-    status,
-    summary: status === 0 ? `${webDappAdapterId()} browser and wallet host stopped` : `${webDappAdapterId()} browser stop failed`,
-    output
-  };
-}
-export {
-  stopWebDappBrowserSync
-};

package/dist/async.js

@@ -1,19 +0,0 @@
-async function withTimeout(promise, options) {
-  let timer;
-  try {
-    return await Promise.race([
-      promise,
-      new Promise((_resolve, reject) => {
-        timer = setTimeout(() => {
-          options.onTimeout?.();
-          reject(new Error(options.message));
-        }, options.timeoutMs);
-      })
-    ]);
-  } finally {
-    if (timer) clearTimeout(timer);
-  }
-}
-export {
-  withTimeout
-};

package/dist/cli.js

@@ -1,202 +0,0 @@
-import "./host.js";
-import "./adapters/surface.js";
-import fs from "node:fs";
-import {
-  detectAdapter,
-  handleActions,
-  handleCall,
-  handleHarness,
-  handleLast,
-  handleLaunch,
-  handleReload,
-  handleRun,
-  handleStop,
-  parseArgs,
-  targetPath
-} from "@farmslot/recipe-cli/harness";
-import { stopProjectCollector } from "../library/actions/shared/analytics/collector.mjs";
-import { loadSelectedAdapter } from "./adapters/plugin-surface.js";
-import { adapterRegistry } from "./adapters/registry.js";
-import { applyDeviceTargeting } from "./commands/device-target.js";
-import { metaMaskEngine } from "./engine.js";
-import { walletFixturePath } from "./paths.js";
-import { handleDoctor } from "./commands/doctor.js";
-import { handleProvision } from "./commands/provision.js";
-import { handleRuntimeHealth } from "./commands/runtime-health.js";
-import { handleRuntimeLaunch } from "./commands/runtime-launch.js";
-import { handleRuntimeDecision } from "./commands/runtime-decision.js";
-import { handleResolveExtension } from "./commands/resolve-extension.js";
-import { handleEnsureReady } from "./commands/ensure-ready.js";
-import { handleSelfTest } from "./commands/self-test.js";
-import { handleCompletionCandidates, invalidateCompletionCache } from "./commands/completion-candidates.js";
-import { handleLogs } from "./commands/logs.js";
-import { handleDebug } from "./commands/debug.js";
-import { handleFixtures } from "./commands/fixtures.js";
-import { handleRecipeQuality } from "./commands/recipe-quality.js";
-import { handleStatus } from "./commands/status.js";
-import { handleCheck } from "./commands/check.js";
-import { handleChecklist } from "./commands/checklist.js";
-import { handleExecutionTemplate } from "./commands/execution-template.js";
-import { handlePrepare } from "./commands/prepare.js";
-import { handleTaskInit } from "./commands/task-init.js";
-import { handleReview } from "./commands/review.js";
-import { handleDomain } from "./commands/domain.js";
-import { handleConfig } from "./commands/config.js";
-import { handlePrBody } from "./commands/pr-body.js";
-import { overlayCommandOptions } from "./commands/overlay.js";
-const stopOptions = {
-  companions: async (target) => {
-    const collector = await stopProjectCollector(target);
-    return collector.stopped && collector.pid !== null ? [{ label: "analytics collector", pid: collector.pid }] : [];
-  }
-};
-const targetDevice = (command, adapter, options) => applyDeviceTargeting(command, adapter, options, { gate: true, rerun: "" });
-const runOptions = {
-  engine: metaMaskEngine,
-  targetDevice,
-  plan: {
-    // The wallet fixture `fixtures set` seeds.
-    steps: (target) => [{
-      step: "fixture.file",
-      confidence: "static",
-      status: "ok",
-      detail: fs.existsSync(walletFixturePath(target)) ? `present: ${walletFixturePath(target)}` : `absent: ${walletFixturePath(target)} (fixtures set to seed)`
-    }],
-    launchDetail: "would launch/attach the app + heal transport (Metro/Chrome/CDP) before executing"
-  }
-};
-const callOptions = {
-  engine: metaMaskEngine,
-  targetDevice,
-  // A wallet action makes the most useful first example.
-  exampleAction: (names) => names.find((name) => /wallet|unlock/u.test(name))
-};
-const COMMANDS = {
-  actions: (parsed) => handleActions(parsed, { catalog: metaMaskEngine }),
-  doctor: handleDoctor,
-  "runtime-health": handleRuntimeHealth,
-  "runtime-decision": handleRuntimeDecision,
-  "runtime-launch": handleRuntimeLaunch,
-  "resolve-extension": handleResolveExtension,
-  "ensure-ready": handleEnsureReady,
-  "self-test": handleSelfTest
-};
-const OVERLAY_COMMANDS = ["install", "verify", "cleanup"];
-function usage() {
-  console.error(`mm-harness \u2014 the MetaMask recipe harness: launch the app, prove behavior, manage the runtime overlay.
-Run it from inside a MetaMask checkout; the platform (mobile | extension | core | terminal) is auto-detected.
-Grammar: mm-harness <command> [target] [flags]   (target is a positional: ios | android | extension; flags add agent depth)
-
-DAILY LOOP \u2014 what a teammate runs many times a day:
-  launch     Launch the app incl. Metro/build, surface auto-detected. Mobile: ios|android required.
-               mm-harness launch ios                    # quick relaunch (add --build | --verify)
-  logs       Tail Metro/webpack + app logs.
-               mm-harness logs
-  debug      Open the debug console (extension DevTools / mobile RN).
-               mm-harness debug
-  reload     Reload the connected Mobile or Extension runtime.
-               mm-harness reload
-  fixtures   Sync files, set/reset the wallet, generate fixture-state, or finalize labels over CDP.
-               mm-harness fixtures sync                 # or: set | reset | generate --fixture <f> --out <o> | finalize \u2026
-
-PROVE \u2014 run recipes and inspect capabilities:
-  run        Run a recipe and write evidence (summary/trace/artifacts).
-               mm-harness run recipe.json
-  doctor     Readiness check for a checkout (no app launch).
-               mm-harness doctor
-  check      Run bounded repo-local checks for an active diff.
-               mm-harness check diff --profile fast --artifacts-dir artifacts/validation
-  actions    Describe the actions a manifest declares.
-               mm-harness actions --adapter mobile
-RUNTIME OVERLAY \u2014 install/verify/clean the per-checkout runtime overlay:
-  provision  Install the cached Runway mobile dev client (artifact cache + sim install).
-               mm-harness provision runway ios --adapter mobile
-  install    Install the runtime overlay into the checkout.
-               mm-harness install                      # inside a checkout, auto-detected
-  verify     Check the overlay/runtime is present and healthy (no launch).
-               mm-harness verify
-  cleanup    Remove the installed overlay and restore the checkout.
-               mm-harness cleanup
-
-ADVANCED \u2014 internal runtime probes (rarely typed by hand):
-  runtime-health     runtime-decision   runtime-launch
-  resolve-extension  ensure-ready       self-test
-  (e.g. mm-harness runtime-decision --adapter extension --target <repo> --json)
-
-ONE bin: mm-harness is the only command. No per-platform binaries \u2014 platform is
-auto-detected, the positional target forces it (mm-harness launch ios), and
-platform-specific needs are FLAGS on the same command (e.g. --sidebar, --full-build).
-Human happy path = the bare command; agents add depth via flags (--json, --target, ports).
-See README.md for the workflow and docs/RECIPES.md for proof authoring.
-`);
-}
-async function main(argv) {
-  const command = argv[0];
-  if (!command || command === "-h" || command === "--help") {
-    usage();
-    return command ? 0 : 2;
-  }
-  const refused = await loadSelectedAdapter(command, argv.slice(1));
-  if (refused !== void 0) return refused;
-  if (command === "status" || command === "health" || command === "home") {
-    return handleStatus(parseArgs(argv.slice(1)));
-  }
-  if (command === "run") return handleRun(argv.slice(1), runOptions);
-  if (command === "call") return handleCall(argv.slice(1), callOptions);
-  if (command === "completion-candidates") return handleCompletionCandidates(argv.slice(1));
-  if (command === "provision") return handleProvision(parseArgs(argv.slice(1)));
-  if (OVERLAY_COMMANDS.includes(command)) {
-    if (command === "verify" && process.env.MM_HARNESS_SKIP_OVERLAY_ENSURE !== "1") {
-      try {
-        const { options } = parseArgs(argv.slice(1));
-        const target = targetPath(options);
-        const adapterRaw = (typeof options["adapter"] === "string" ? options["adapter"] : void 0) ?? (typeof options["platform"] === "string" ? options["platform"] : void 0) ?? detectAdapter(target);
-        if (adapterRaw && adapterRegistry.has(adapterRaw)) {
-          await handleHarness(["install", "--platform", adapterRaw, "--target", target, "--quiet"]);
-        }
-      } catch {
-      }
-    }
-    const code = await handleHarness(argv, overlayCommandOptions);
-    if (code === 0 && command === "install") {
-      try {
-        invalidateCompletionCache(targetPath(parseArgs(argv.slice(1)).options));
-      } catch {
-      }
-    }
-    return code;
-  }
-  if (command === "launch") return handleLaunch(argv.slice(1));
-  if (command === "stop") return handleStop(argv.slice(1), stopOptions);
-  if (command === "logs") return handleLogs(argv.slice(1));
-  if (command === "debug") return handleDebug(argv.slice(1));
-  if (command === "reload") return handleReload(argv.slice(1));
-  if (command === "fixtures") return handleFixtures(argv.slice(1));
-  if (command === "recipe-quality") return handleRecipeQuality(argv.slice(1));
-  if (command === "check") return handleCheck(argv.slice(1));
-  if (command === "checklist") return handleChecklist(argv.slice(1));
-  if (command === "execution-template") return handleExecutionTemplate(argv.slice(1));
-  if (command === "task") return handleTaskInit(argv.slice(1));
-  if (command === "prepare") return handlePrepare(argv.slice(1));
-  if (command === "last") return handleLast(parseArgs(argv.slice(1)));
-  if (command === "review") return handleReview(argv.slice(1));
-  if (command === "domain") return handleDomain(argv.slice(1));
-  if (command === "config") return handleConfig(argv.slice(1));
-  if (command === "pr-body") return handlePrBody(argv.slice(1));
-  const handler = COMMANDS[command];
-  if (!handler) throw new Error(`Unknown command: ${command}`);
-  return handler(parseArgs(argv.slice(1), command === "runtime-decision" ? { recordIsFlag: true } : {}));
-}
-if (!globalThis.__MM_HARNESS_WRAPPER__) {
-  try {
-    process.exit(await main(process.argv.slice(2)));
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(
-      error !== null && typeof error === "object" && "exitCode" in error && typeof error.exitCode === "number" ? error.exitCode : 1
-    );
-  }
-}
-export {
-  main
-};