@deeeed/metamask-harness 0.84.0 → 0.86.0

package/dist/adapters/mobile/verify.js

@@ -4,7 +4,7 @@ import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 import { runnerDir } from "../../paths.js";
-const USAGE = "Usage: mm-harness verify --adapter mobile -- [--target <metamask-mobile>] [--artifacts-dir <dir>] [--static-only] [--platform ios|android] [--preflight-mode fast|auto|default|rebuild-native|clean] [--no-auto-start]";
+const USAGE = "Usage: mm-harness verify --adapter mobile -- [--target <metamask-mobile>] [--artifacts-dir <dir>] [--static-only] [--platform ios|android] [--watcher-port <port>] [--preflight-mode fast|auto|default|rebuild-native|clean] [--no-auto-start]";
 const ENV_FILES = [".js.env", ".env", ".env.local"];
 const PREFLIGHT_MODES = ["fast", "auto", "default", "rebuild-native", "clean"];
 const AUTO_START_TRUE = ["1", "true", "TRUE", "True", "yes", "YES", "Yes", "on", "ON", "On"];
@@ -36,6 +36,7 @@ function parseMobileVerifyArgs(argv, env = process.env) {
   let platform = env.RECIPE_HARNESS_PLATFORM || env.PLATFORM || "ios";
   let preflightMode = env.RECIPE_HARNESS_MOBILE_PREFLIGHT_MODE || "fast";
   let autoStart = env.RECIPE_HARNESS_MOBILE_AUTO_START ?? "false";
+  let watcherPort;
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
     const needsValue = () => {
@@ -65,6 +66,12 @@ function parseMobileVerifyArgs(argv, env = process.env) {
         platform = value;
         break;
       }
+      case "--watcher-port": {
+        const value = needsValue();
+        if (value === void 0) return { kind: "error", message: "Missing value for --watcher-port", exitCode: 2 };
+        watcherPort = value;
+        break;
+      }
       case "--preflight-mode": {
         const value = needsValue();
         if (value === void 0) return { kind: "error", message: "Missing value for --preflight-mode", exitCode: 2 };
@@ -101,7 +108,8 @@ function parseMobileVerifyArgs(argv, env = process.env) {
       staticOnly,
       platform,
       preflightMode,
-      autoStart: AUTO_START_TRUE.includes(autoStart)
+      autoStart: AUTO_START_TRUE.includes(autoStart),
+      ...watcherPort === void 0 ? {} : { watcherPort }
     }
   };
 }
@@ -141,8 +149,8 @@ function buildMobileVerifySummary(input) {
     generatedAt: input.generatedAt
   };
 }
-function resolveWatcherPort(target, env = process.env) {
-  const explicit = env.WATCHER_PORT || "";
+function resolveWatcherPort(target, env = process.env, flag) {
+  const explicit = flag || env.RECIPE_WATCHER_PORT || env.WATCHER_PORT || "";
   if (explicit) return explicit;
   for (const file of ENV_FILES) {
     const full = path.join(target, file);
@@ -299,7 +307,7 @@ async function runMobileVerify(argv, io = defaultIo) {
     io.err(parsed.message);
     return parsed.exitCode;
   }
-  const { staticOnly, platform, preflightMode, autoStart } = parsed.options;
+  const { staticOnly, platform, preflightMode, autoStart, watcherPort } = parsed.options;
   const target = path.resolve(parsed.options.target);
   if (!fs.existsSync(target)) {
     io.err(`Refusing mobile verify: target checkout does not exist: ${target}`);
@@ -344,9 +352,9 @@ async function runMobileVerify(argv, io = defaultIo) {
   let fixtureStatus = null;
   let portHolder = null;
   if (!staticOnly) {
-    const port = resolveWatcherPort(target);
+    const port = resolveWatcherPort(target, process.env, watcherPort);
     if (!isNumericWatcherPort(port)) {
-      io.err(`Refusing mobile verify: resolved watcher port is not numeric: '${port}' (check WATCHER_PORT)`);
+      io.err(`Refusing mobile verify: resolved watcher port is not numeric: '${port}' (check --watcher-port, RECIPE_WATCHER_PORT or WATCHER_PORT)`);
       return 2;
     }
     let deviceTarget = mobileDeviceTarget(target, platform, process.env);

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

@@ -9,7 +9,7 @@ const webDappActions = {
     "app.performance_assert"
   ],
   cdpTarget: { transport: "chrome-cdp", probePath: "json/version" },
-  ui: (harness, { hudPolicy }) => ({
+  ui: (harness) => ({
     base: harness.createCdpWebUiTransport({
       async withPage(input, callback) {
         const { withAppPage } = await import("../../../library/actions/web-dapp/platform/page.mjs");
@@ -30,14 +30,16 @@ const webDappActions = {
     async execute(action, node, context, standard) {
       if (action === "app.hud") {
         const { showAppHud } = await import("../../../library/actions/web-dapp/platform/hud.mjs");
-        return showAppHud(
-          { action, node, context: { nodeId: context.nodeId, projectRoot: context.projectRoot } },
-          { hudPolicy }
-        );
+        return showAppHud({ action, node, context: { nodeId: context.nodeId, projectRoot: context.projectRoot } });
       }
       return standard();
     }
   }),
+  // Deletes hud.json (the wallet host redraws from it) and the HUD on the app tabs.
+  async clearHud(projectRoot) {
+    const { showAppHud } = await import("../../../library/actions/web-dapp/platform/hud.mjs");
+    await showAppHud({ node: { clear: true }, context: { nodeId: "hud-clear", projectRoot } });
+  },
   // ensure_positions and ensure_orders with an open or present state place an order.
   inputFindings: (nodeId, node) => perpsOrderInputFindings(nodeId, node, { ensureChecksOnly: false })
 };

package/dist/adapters.js

@@ -90,7 +90,9 @@ const LIVE_ONLY_APP_ACTIONS = /* @__PURE__ */ new Set([
   "app.network_capture",
   "app.network_assert",
   "app.performance_capture",
-  "app.performance_assert"
+  "app.performance_assert",
+  // Proves a capture of the running app; a static result would pass on no evidence.
+  "metamask.app.assert_no_console_errors"
 ]);
 function requiresLiveAdapter(platform, action) {
   return LIVE_ONLY_ACTIONS.has(action) || Boolean(getAdapterSurface(platform).actions.liveOnly?.includes(action)) || LIVE_ONLY_WALLET_ACTIONS.has(action) || LIVE_ONLY_FEATURE_FLAG_ACTIONS.has(action) || LIVE_ONLY_APP_ACTIONS.has(action);
@@ -290,7 +292,7 @@ function createMetaMaskSemanticAdapters(platform, declaredCustomActions = [], pr
     )
   );
 }
-function createMetaMaskUiTransport(platform, harness, preparedLiveAdapters, { hudPolicy = "auto" } = {}) {
+function createMetaMaskUiTransport(platform, harness, preparedLiveAdapters) {
   const ui = getAdapterSurface(platform).actions.ui;
   if (!ui) {
     return {
@@ -301,7 +303,7 @@ function createMetaMaskUiTransport(platform, harness, preparedLiveAdapters, { hu
       }
     };
   }
-  const { base, execute } = ui(harness, { hudPolicy });
+  const { base, execute } = ui(harness, { hudPolicy: "show" });
   async function standard(action, node, context) {
     if (action === "ui.navigate") {
       const live = await runLiveFirst(

package/dist/command-contract.js

@@ -19,6 +19,12 @@ const adapterIds = (tokens) => adapterChoices(optionValues(tokens, "--library"),
   env: operatorLibraryEnv()
 });
 const ADAPTER = { "--adapter": value(adapterIds) };
+function selectableAdapters(libraries = []) {
+  return adapterIds(libraries.flatMap((entry) => ["--library", entry]));
+}
+function withAdapterList(text, libraries = []) {
+  return text.replaceAll("{adapters}", selectableAdapters(libraries).join("|"));
+}
 const MOBILE_PLATFORM = { "--platform": value(["ios", "android"]) };
 const ADAPTER_OR_MOBILE_PLATFORM = { "--platform": value((tokens) => [...adapterIds(tokens), "ios", "android"]) };
 const DEVICE = { "--device": value() };
@@ -88,7 +94,7 @@ const PUBLIC_COMMANDS = [
 
   Loads the complete recipe guide shipped with this harness.
 
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Load the same guide as structured agent context
 
@@ -289,6 +295,7 @@ Example:
   Home dashboard for the current checkout \u2014 the detected adapter, the next command
   to run, and (mobile only) the connected devices with live app state. Aliases: health, home.
 
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable envelope { adapter, target, view, devices[], next }
   --fast                             Skip all live-state probes (instant output, safe for scripts)
@@ -334,7 +341,7 @@ Example:
   mm-harness status --fast
   mm-harness status --watch`,
     contract: {
-      options: options(HELP, JSON, TARGET, DEVICE, {
+      options: options(HELP, JSON, TARGET, ADAPTER, ADAPTER_OR_MOBILE_PLATFORM, DEVICE, {
         "--fast": bool(),
         "--all-devices": bool(),
         "--watch": bool(),
@@ -429,7 +436,7 @@ Example:
   refuses with the numbered choice when that is ambiguous.
 
   --target <path>                    Checkout path (default: cwd)
-  --platform <mobile|extension|core|terminal> Force the platform (auto-detected inside a checkout)
+  --platform <{adapters}> Force the platform (auto-detected inside a checkout)
   --mobile-platform <ios|android>    Mobile target when status cannot decide it
   --clear-metro                      Mobile only: clear Metro's transform cache in the launch step
   --artifacts-dir <dir>              Where sandbox.json and the per-step reports land
@@ -633,7 +640,7 @@ Materialize:
   --matrix                           Compare action availability across Mobile, Extension, Core, and Terminal
   --categories                       List compact action categories and counts
   --category <name>                  List only one category (for example ui, wallet, or perps)
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --raw                              Dump raw action registry JSON
   --json                             Machine-readable output
@@ -674,7 +681,7 @@ Example:
     core       headless \u2014 no dev server to stop (teaching error)
 
   --port <port>                      Metro/webpack port override; Extension CDP remains checkout-context scoped
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable output
 
@@ -707,19 +714,21 @@ Example:
   --sort <domain|name|library>       With --list: grouping/order (default: domain; JSON: name)
   --device <udid|serial|name>        Mobile only: target this device (sets IOS_SIMULATOR / ADB_SERIAL and updates agentic-runtime.json). Without it, >1 connected mobile device fails fast and lists them. Do not shut down other devices to force selection.
   --cdp-port <port>                  Extension only: bind the action to this live browser runtime.
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --artifacts-dir <dir>              Where to write evidence (default: <task>/artifacts/calls/<action>-<id>
                                      inside a task, else temp/recipe/calls/<action>-<id>)
   --action-manifest <path>           Override the action manifest
   --library <name=path>              Add/override a recipe-library source (repeatable)
   --heal <off|infra-only|auto>       Healing policy (default: infra-only); auto-ensures the overlay
+  --hud <show|hide>                  Recipe HUD: the call's intent= drawn over the app, headless included (default: show)
   --json                             Machine-readable output
 
 Example (real actions; run mm-harness actions for this checkout's full set):
   mm-harness call ensure_unlocked --adapter extension   # a wallet action (extension/mobile)
   mm-harness call navigate page=perps --adapter mobile
   mm-harness call command cmd="echo hi" --adapter core   # the universal action (all adapters)
+  mm-harness call ui.screenshot intent="Show the order filled"   # intent= is the HUD text
 
 Remote feature flags (mobile applies at runtime; extension pins at launch):
   mm-harness call metamask.feature_flags.read --adapter mobile
@@ -731,7 +740,8 @@ Remote feature flags (mobile applies at runtime; extension pins at launch):
         "--list": bool(),
         "--domain": value(),
         "--source": value(),
-        "--sort": value(["domain", "name", "library"])
+        "--sort": value(["domain", "name", "library"]),
+        "--hud": value(["show", "hide"])
       }),
       positionals: [{ label: "action" }],
       minimumPositionals: 0,
@@ -765,7 +775,7 @@ Discovery:
 
 Common overrides:
   --device <udid|serial|name>        Mobile only: target this device (sets IOS_SIMULATOR / ADB_SERIAL and updates agentic-runtime.json). Without it, >1 connected mobile device fails fast and lists them. Do not shut down other devices to force selection.
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --platform <ios|android>           Mobile platform preference; use --adapter for the product adapter
   --target <path>                    Checkout path (default: cwd)
   --artifacts-dir <dir>              Override evidence output (default: active task/artifacts, otherwise a checkout-local temp/recipe/runs/<run>)
@@ -778,7 +788,7 @@ Common overrides:
   --json                             Machine-readable output
   --json-stream                      Line-flushed JSONL progress + terminal event
   --record-video=full-run            Record a video of the run
-  --hud <auto|show|hide>             Recipe HUD policy (auto shows normal Mobile recipes and a headful terminal browser; hide is explicit)
+  --hud <show|hide>                  Recipe HUD: each node's intent drawn over the app on every adapter, headless included (default: show)
 
 Advanced integrations:
   runtime: --cdp-port, --watcher-port, --runtime-dir, --slot,
@@ -801,7 +811,7 @@ Example:
         "--plan": bool(),
         "--proof": bool(),
         "--describe": bool(),
-        "--hud": value(["auto", "show", "hide"])
+        "--hud": value(["show", "hide"])
       }),
       positionals: [{ label: "recipe" }],
       minimumPositionals: 1,
@@ -850,7 +860,7 @@ Example:
   --cdp-port <port>                  Extension CDP port for the liveness probe (env: CDP_PORT / RECIPE_CDP_PORT)
   --device <udid|serial|name>        Mobile only: target this device (env: IOS_SIMULATOR / ADB_SERIAL). doctor reports the connected devices; it never gates on ambiguity.
   --all-devices                      Mobile only: show every connected device instead of the slot-scoped target
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --runtime-dir <dir>                Runtime dir containing agentic-runtime.json (relative to target)
   --json                             Machine-readable output (incompatible with --print-ready)
@@ -882,7 +892,7 @@ Example:
   when available. Does not launch an app or run a recipe.
 
   --target <path>                    Checkout path (default: cwd)
-  --adapter <mobile|extension|core|terminal>  Adapter label (auto-detected when possible)
+  --adapter <{adapters}>  Adapter label (auto-detected when possible)
   --base <ref>                       Diff base (default: PR base, then remote HEAD, then repo fallback)
   --profile <fast|full>              Validation depth (default: fast)
   --fix                              Fix changed files, then validate them
@@ -929,11 +939,11 @@ Example:
 Optional advice:
   advisor-status --json
     Resolve saved settings and overrides without reading tasks or calling a model.
-  plan --task <task.json> --adapter <mobile|extension|core|terminal> --advisor typesafe
+  plan --task <task.json> --adapter <{adapters}> --advisor typesafe
     Assess each acceptance criterion before a recipe exists. Task JSON contains
     acceptanceCriteria: ["criterion", "..."] (1\u201320 entries), with optional title/description.
     Returns known candidate refs for reuse/composition, or an explicit discovery gap.
-  advise --recipe <recipe.json> --task <TASK.md> --adapter <mobile|extension|core|terminal>
+  advise --recipe <recipe.json> --task <TASK.md> --adapter <{adapters}>
     --advisor <provider|off> Override saved policy for this task (currently: typesafe)
     --advisor-model <model> Override the provider default model or alias
     --advisor-stages <csv>   Select plan,draft,evidence (saved/default: plan)
@@ -983,7 +993,7 @@ Example:
   provisioning path only: artifact cache + simulator create + simctl install.
   JavaScript dependencies and Metro remain dispatch-time launch concerns.
 
-  --adapter <mobile|extension|core|terminal>  Target adapter (mobile supported; extension/core/terminal teach)
+  --adapter <{adapters}>  Target adapter (mobile supported; the others teach)
   --target <path>                    Slot checkout path (default: cwd)
   --platform <ios>                   Platform (default ios)
   --simulator <name|udid>            Override agentic-runtime.json simulator (alias: --device)
@@ -1027,7 +1037,7 @@ Example:
   artifact cache + simulator create + simctl install. JavaScript dependencies
   and Metro remain dispatch-time launch concerns.
 
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --runway                           Thin mobile Runway artifact install instead of overlay install
   --platform <ios>                   Runway platform (default ios)
@@ -1062,7 +1072,7 @@ Example:
   Extension live checks infer the checkout CDP port from runtime context,
   pool, or slot suffix when --cdp-port is omitted.
 
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable output
 
@@ -1082,7 +1092,7 @@ Example:
 
   Remove the installed overlay and restore the checkout.
 
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
 
 Example:
@@ -1235,7 +1245,7 @@ Example:
   --source <label>                   Log source per adapter \u2014 mobile: metro|app;
                                      extension: extension|dapp|webpack|watcher|rebuild.
                                      Core is headless (teaching error).
-  --adapter <mobile|extension|core|terminal>  Target adapter (auto-detected inside a checkout)
+  --adapter <{adapters}>  Target adapter (auto-detected inside a checkout)
   --target <path>                    Checkout path (default: cwd)
   --json                             Machine-readable output
 
@@ -1458,5 +1468,7 @@ export {
   HIDDEN_COMMANDS,
   PUBLIC_COMMANDS,
   REPLACED_OPTIONS,
-  explainMissingAdapterLibrary
+  explainMissingAdapterLibrary,
+  selectableAdapters,
+  withAdapterList
 };

package/dist/commands/check.js

@@ -1,8 +1,7 @@
-import { detectAdapter, EXIT, usageOut, optionFlag, optionString, parseArgs, shellQuote } from "@farmslot/recipe-cli/harness";
+import { EXIT, contextAdapter, usageOut, optionFlag, optionString, parseArgs, shellQuote } from "@farmslot/recipe-cli/harness";
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
-import "../adapters/surface.js";
 const USAGE = "mm-harness check diff [--fix] [--target <repo>] [--adapter <adapter>] [--base <ref>] [--profile fast|full] [--artifacts-dir <dir>] [--json]";
 const JS_TS_EXT_RE = /\.(?:c|m)?jsx?$|\.tsx?$/u;
 const FORMAT_EXT_RE = /\.(?:c|m)?jsx?$|\.tsx?$|\.json$|\.md$|\.css$|\.scss$|\.ya?ml$/u;
@@ -20,12 +19,11 @@ async function handleCheck(argv) {
     return usageOut(json, "check", message, USAGE);
   }
   const target = path.resolve(optionString(options, "target") ?? process.cwd());
-  const explicitAdapter = optionString(options, "adapter") ?? optionString(options, "platform");
-  const detected = explicitAdapter ?? detectAdapter(target);
-  if (detected === "ios" || detected === "android") {
-    return usageOut(json, "check", `unsupported adapter '${detected}'`, USAGE);
+  const platform = optionString(options, "adapter") ? void 0 : optionString(options, "platform");
+  if (platform === "ios" || platform === "android") {
+    return usageOut(json, "check", `unsupported adapter '${platform}'`, USAGE);
   }
-  const adapter = detected;
+  const adapter = contextAdapter(target);
   const profileInput = optionString(options, "profile");
   if (profileInput && profileInput !== "fast" && profileInput !== "full") {
     return usageOut(json, "check", "--profile must be fast or full", USAGE);

package/dist/commands/debug.js

@@ -1,4 +1,4 @@
-import { adapterDetectNext, EXIT, flag, parseFlags, resolveFlagsAdapter, spawnScript, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
+import { adapterDetectNext, EXIT, flag, parseFlags, contextAdapter, spawnScript, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
 import path from "node:path";
 import { runnerDir } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
@@ -7,7 +7,7 @@ async function handleDebug(argv) {
   const { options } = parseFlags(argv, DEBUG_BOOLEANS);
   const json = flag(options, "json");
   const target = targetOf(options);
-  const adapter = resolveFlagsAdapter(options, target);
+  const adapter = contextAdapter(target);
   if (!adapter) return usageOut(json, "debug", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   const surface = getAdapterSurface(adapter);
   if (surface.headless) return usageOut(json, "debug", `${adapter} is headless; there is no debug console.`, surface.hints.relaunch);

package/dist/commands/doctor.js

@@ -2,7 +2,7 @@ import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { featureFlagReport } from "../feature-flags.js";
-import { adapterPluginChecks, color, acquireCheckoutLock, detectAdapter, resolveRuntimeContextPath, ensureOverlay, newHealState, recipeRunning, adapterDetectNext, checkoutBusyOut, EXIT, usageOut, actionManifestPathOption, applyRuntimeDirOption, optionFlag, optionString, shellQuote, targetPath } from "@farmslot/recipe-cli/harness";
+import { adapterPluginChecks, color, acquireCheckoutLock, contextAdapter, resolveRuntimeContextPath, ensureOverlay, newHealState, recipeRunning, adapterDetectNext, checkoutBusyOut, EXIT, usageOut, actionManifestPathOption, applyRuntimeDirOption, optionFlag, optionString, shellQuote, targetPath } from "@farmslot/recipe-cli/harness";
 import { collectCheckoutView, renderCheckoutView } from "../checkout-view.js";
 import { createDoctorReport, fixtureSummary, requiredDoctorCheckSummary } from "../doctor.js";
 import { assertAdapter, runnerDir } from "../paths.js";
@@ -33,8 +33,7 @@ async function handleDoctor({ options }) {
   const expectLive = optionFlag(options, "expectLive") || printReady;
   const allDevices = optionFlag(options, "allDevices");
   const platformOption = optionString(options, "platform");
-  const explicitAdapter = optionString(options, "adapter") ?? (platformOption === "ios" || platformOption === "android" ? "mobile" : platformOption);
-  const adapter = explicitAdapter ?? detectAdapter(target);
+  const adapter = contextAdapter(target);
   if (!adapter) {
     return usageOut(json, "doctor", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }

package/dist/commands/domain.js

@@ -4,7 +4,8 @@ import {
   classifyDomain,
   configPath,
   discoverLibraries,
-  readConfig
+  readConfig,
+  REVIEW_ADAPTERS
 } from "../review/knowledge.js";
 import { adapterFromOptions } from "./review.js";
 async function handleDomain(argv) {
@@ -12,14 +13,14 @@ async function handleDomain(argv) {
   const target = targetPath(parsed.options);
   const json = optionFlag(parsed.options, "json");
   const declared = optionString(parsed.options, "domain") ?? process.env.MM_HARNESS_DOMAIN;
-  const detected = adapterFromOptions(parsed.options, target);
+  const detected = adapterFromOptions();
   const adapter = detected === "unscoped" ? void 0 : detected;
   if (declared) {
     emit(json, { domain: declared, source: "declared", adapter: adapter ?? null, target });
     return 0;
   }
   if (!adapter) {
-    throw usageError("No MetaMask checkout detected: pass --adapter <mobile|extension|core|terminal> or --domain <name>.");
+    throw usageError(`No MetaMask checkout detected: pass --adapter <${REVIEW_ADAPTERS.join("|")}> or --domain <name>.`);
   }
   const config = readConfig(configPath());
   const libraries = discoverLibraries({ target, config });

package/dist/commands/fixtures.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { runnerDir, walletFixturePath } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 import { fixtureFileSummary, fixtureSummary } from "../doctor.js";
-import { acquireCheckoutLock, adapterDetectNext, checkoutBusyOut, EXIT, flag, parseFlags, resolveFlagsAdapter, scriptOverride, spawnScript, spawnScriptStreaming, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
+import { acquireCheckoutLock, adapterDetectNext, checkoutBusyOut, EXIT, flag, parseFlags, contextAdapter, scriptOverride, spawnScript, spawnScriptStreaming, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
 import { applyDeviceTargeting } from "./device-target.js";
 import { FeatureFlagSpecError, fixtureFeatureFlags, parseRemoteFlagSpec } from "../feature-flags.js";
 const FIXTURES_BOOLEANS = /* @__PURE__ */ new Set(["dev", "force", "json"]);
@@ -38,7 +38,7 @@ function fixturesStatus(options) {
     );
   }
   const target = targetOf(options);
-  const adapter = resolveFlagsAdapter(options, target);
+  const adapter = contextAdapter(target);
   if (!adapter) {
     return usageOut(json, "fixtures", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }
@@ -114,7 +114,7 @@ async function handleFixturesLocked(argv) {
     );
   }
   const target = targetOf(options);
-  const adapter = resolveFlagsAdapter(options, target);
+  const adapter = contextAdapter(target);
   if (!adapter) {
     return usageOut(json, "fixtures", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }

package/dist/commands/help.js

@@ -1,9 +1,10 @@
 import fs from "node:fs";
 import path from "node:path";
-import { color, detectAdapter, optionString, parseArgs, targetPath } from "@farmslot/recipe-cli/harness";
+import { color, contextAdapter, parseArgs, targetPath } from "@farmslot/recipe-cli/harness";
+import { selectableAdapters } from "../command-contract.js";
 import { handleHelpReview } from "./review.js";
 import "../adapters/surface.js";
-const UNSCOPED_NEXT = "cd into a MetaMask checkout or pass --adapter <mobile|extension|core|terminal>";
+const unscopedNext = () => `cd into a MetaMask checkout or pass --adapter <${selectableAdapters().join("|")}>`;
 function validHelpLine(value) {
   return typeof value === "string" || Boolean(value && typeof value.text === "string" && Array.isArray(value.adapters) && value.adapters.length > 0 && value.adapters.every((adapter) => ["mobile", "extension", "core", "web-dapp"].includes(adapter)));
 }
@@ -35,7 +36,7 @@ function recipeHelpPayload(topic, harnessVersion, adapter, target) {
     harnessVersion,
     recipeProtocolVersion: topic.recipeProtocolVersion,
     adapter,
-    ...adapter === "unscoped" ? { next: UNSCOPED_NEXT } : {},
+    ...adapter === "unscoped" ? { next: unscopedNext() } : {},
     target,
     topic: topic.topic,
     title: topic.title,
@@ -58,7 +59,7 @@ function renderRecipeHelp(topic, harnessVersion, adapter) {
     paint("warn", topic.scopeNotice),
     `Visual tutorial: ${paint("cmd", "mm-harness tutorial")}`
   ];
-  if (adapter === "unscoped") lines.push(paint("warn", `No MetaMask checkout detected. Next: ${UNSCOPED_NEXT}.`));
+  if (adapter === "unscoped") lines.push(paint("warn", `No MetaMask checkout detected. Next: ${unscopedNext()}.`));
   for (const [index, section] of scopedSections(topic, adapter).entries()) {
     lines.push("", paint("label", `${index + 1}. ${section.title}`), `   ${section.instruction}`);
     for (const detail of section.details) lines.push(`   - ${detail}`);
@@ -72,7 +73,7 @@ function handleHelp(argv, context) {
   const parsed = parseArgs(argv);
   if (parsed.positional[0] === "review") return handleHelpReview(argv, context.harnessVersion);
   const target = targetPath(parsed.options);
-  const adapter = optionString(parsed.options, "adapter") ?? detectAdapter(target) ?? "unscoped";
+  const adapter = contextAdapter(target) ?? "unscoped";
   const topic = loadRecipeHelp(context.packageRoot);
   const payload = recipeHelpPayload(topic, context.harnessVersion, adapter, target);
   if (parsed.options.json === true) {

package/dist/commands/launch/extension.js

@@ -24,6 +24,7 @@ import {
 import { checkExtensionRuntimeHealth } from "../../adapters/extension/runtime.js";
 import { ensureHarnessFresh } from "../../adapters/harness-freshness.js";
 import { isExtensionWatcherLive, stopExtensionWatcher } from "../../adapters/slot-ports.js";
+import { recordExtensionConsoleLaunch } from "../../adapters/extension/console-capture.js";
 import { readExtensionPinnedFlags } from "../../adapters/extension/feature-flags.js";
 import { sameFeatureFlags } from "../../feature-flags.js";
 const { CdpSession } = await importRecipeHarnessRuntimeCdp();
@@ -108,6 +109,14 @@ Next: ${block.userAction}`
   }
   await ensureHarnessFresh(target, "extension");
   restoreRequestedPorts();
+  if (!reusable && artifactLaunchable && remoteFlags) {
+    return {
+      status: EXIT.infra,
+      output: `REMOTE_FLAG_NOT_PINNABLE: the remote feature-flag pin '${remoteFlags.spec}' (from --remote-flag and the wallet fixture's remoteFeatureFlags) cannot be applied to a verified release artifact; the artifact's manifest is signed evidence and is never rewritten.
+Next: drop --remote-flag and remove remoteFeatureFlags from the wallet fixture to validate the artifact as shipped, or validate the variant on a source checkout launched without the artifact.`
+    };
+  }
+  recordExtensionConsoleLaunch(target);
   if (wantWatch) {
     const startWatchSh = path.join(runnerDir, "adapters/extension/start-watch.sh");
     const watchArgs = ["--target", target, "--runner-bin", path.join(runnerDir, "bin/mm-harness")];
@@ -128,13 +137,6 @@ Next: ${block.userAction}`
     return extensionReattach(target, displayMode);
   }
   if (artifactLaunchable) {
-    if (remoteFlags) {
-      return {
-        status: EXIT.infra,
-        output: `REMOTE_FLAG_NOT_PINNABLE: the remote feature-flag pin '${remoteFlags.spec}' (from --remote-flag and the wallet fixture's remoteFeatureFlags) cannot be applied to a verified release artifact; the artifact's manifest is signed evidence and is never rewritten.
-Next: drop --remote-flag and remove remoteFeatureFlags from the wallet fixture to validate the artifact as shipped, or validate the variant on a source checkout launched without the artifact.`
-      };
-    }
     return extensionLaunchReleaseArtifact(target, artifact);
   }
   return extensionLaunchDevelopment(target, remoteFlags);

package/dist/commands/logs.js

@@ -1,4 +1,4 @@
-import { adapterDetectNext, EXIT, flag, parseFlags, resolveFlagsAdapter, spawnInherit, spawnScript, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
+import { adapterDetectNext, EXIT, flag, parseFlags, contextAdapter, spawnInherit, spawnScript, str, targetOf, usageOut } from "@farmslot/recipe-cli/harness";
 import fs from "node:fs";
 import path from "node:path";
 import { runnerDir } from "../paths.js";
@@ -8,7 +8,7 @@ async function handleLogs(argv) {
   const { options } = parseFlags(argv, LOGS_BOOLEANS);
   const json = flag(options, "json");
   const target = targetOf(options);
-  const adapter = resolveFlagsAdapter(options, target);
+  const adapter = contextAdapter(target);
   if (!adapter) {
     return usageOut(json, "logs", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }

package/dist/commands/prepare.js

@@ -1,4 +1,4 @@
-import { acquireCheckoutLock, trackCheckoutChild, recordCommandStage, color, stripAnsi, harnessExecutable, recipeRuntimeDir, detectAdapter, optionFlag, optionString, parseArgs, targetPath, usageError, EXIT } from "@farmslot/recipe-cli/harness";
+import { acquireCheckoutLock, trackCheckoutChild, recordCommandStage, color, stripAnsi, harnessExecutable, recipeRuntimeDir, contextAdapter, optionFlag, optionString, parseArgs, targetPath, usageError, EXIT } from "@farmslot/recipe-cli/harness";
 import { spawn } from "node:child_process";
 import { OperationOutputTail } from "@farmslot/recipe-runner/runtime/operation";
 import fs from "node:fs";
@@ -265,8 +265,8 @@ function mobilePlatformOption(value) {
   Next: ${USAGE}`
   );
 }
-function resolvePlatform(requested, target) {
-  const platform = requested ?? detectAdapter(target);
+function resolvePlatform(target) {
+  const platform = contextAdapter(target);
   const surface = platform && adapterRegistry.has(platform) ? getAdapterSurface(platform) : void 0;
   if (surface?.prepare) {
     return surface;
@@ -296,7 +296,7 @@ async function handlePrepareLocked(argv) {
   const { options } = parseArgs(argv);
   const json = optionFlag(options, "json");
   const target = targetPath(options);
-  const surface = resolvePlatform(optionString(options, "platform"), target);
+  const surface = resolvePlatform(target);
   const platform = surface.id;
   const artifactsDir = path.resolve(
     optionString(options, "artifactsDir") ?? path.join(target, recipeRuntimeDir())

package/dist/commands/provision.js

@@ -1,11 +1,11 @@
-import { detectAdapter, adapterDetectNext, usageOut, applyWatcherPortOption, optionFlag, optionString, shellQuote, shellQuoteArg, targetPath } from "@farmslot/recipe-cli/harness";
+import { contextAdapter, adapterDetectNext, usageOut, applyWatcherPortOption, optionFlag, optionString, shellQuote, shellQuoteArg, targetPath } from "@farmslot/recipe-cli/harness";
 import { assertAdapter } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
 async function handleProvision({ positional, options, rawArgv }) {
   applyWatcherPortOption(options);
   const json = optionFlag(options, "json");
   const target = targetPath(options);
-  const adapter = optionString(options, "adapter") ?? detectAdapter(target);
+  const adapter = contextAdapter(target);
   if (!adapter) {
     return usageOut(json, "provision", `could not detect the MetaMask repo type for ${target}`, adapterDetectNext());
   }

package/dist/commands/review.js

@@ -1,4 +1,4 @@
-import { detectAdapter, optionFlag, optionString, parseArgs, targetPath, usageError } from "@farmslot/recipe-cli/harness";
+import { harnessContext, optionFlag, optionString, parseArgs, targetPath, usageError } from "@farmslot/recipe-cli/harness";
 import fs from "node:fs";
 import path from "node:path";
 import { runnerDir } from "../paths.js";
@@ -15,7 +15,6 @@ import {
   resolveReference,
   defaultBaseRef
 } from "../review/knowledge.js";
-import "../adapters/surface.js";
 const EXIT_OK = 0;
 let cachedHarnessVersion;
 function harnessVersion() {
@@ -25,18 +24,17 @@ function harnessVersion() {
   }
   return cachedHarnessVersion;
 }
-function adapterFromOptions(options, target) {
-  const raw = optionString(options, "adapter") ?? optionString(options, "platform");
-  if (raw !== void 0) {
-    if (raw !== "mobile" && raw !== "extension" && raw !== "core" && raw !== "terminal") throw usageError(`--adapter must be mobile, extension, core, or terminal (got ${raw}).`);
-    return raw;
+function adapterFromOptions() {
+  const adapter = harnessContext()?.adapter;
+  const scope = REVIEW_ADAPTERS.find((id) => id === adapter?.value);
+  if (adapter?.source === "flag" && !scope) {
+    throw usageError(`--adapter must be one of ${REVIEW_ADAPTERS.join(", ")} (got ${adapter.value}).`);
   }
-  const detected = detectAdapter(target);
-  return REVIEW_ADAPTERS.find((adapter) => adapter === detected) ?? "unscoped";
+  return scope ?? "unscoped";
 }
 function resolveReviewContext(options, { fetch = true } = {}) {
   const target = targetPath(options);
-  const adapter = adapterFromOptions(options, target);
+  const adapter = adapterFromOptions();
   const domain = optionString(options, "domain") ?? process.env.MM_HARNESS_DOMAIN;
   const config = readConfig(configPath());
   const context = { target, adapter, ...domain ? { domain } : {} };