@deeeed/metamask-harness 0.83.0 → 0.84.0

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/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
-};