@deeeed/metamask-harness 0.40.1 → 0.41.1

package/dist/commands/launch/index.js

@@ -53,6 +53,21 @@ const LAUNCH_BOOLEANS = /* @__PURE__ */ new Set([
   "jsonStream"
 ]);
 const DEFAULT_EXTENSION_DAPP_URL = "https://metamask.github.io/test-dapp/";
+function metroLaunchEvidence(adapter, target) {
+  if (adapter !== "mobile") return void 0;
+  const evidencePath = recipeRuntimePath(target, "metro-generation.json");
+  let descriptor;
+  try {
+    descriptor = fs.openSync(evidencePath, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
+    const stat = fs.fstatSync(descriptor);
+    if (!stat.isFile() || stat.size > 256 * 1024) return void 0;
+    return JSON.parse(fs.readFileSync(descriptor, "utf8"));
+  } catch {
+    return void 0;
+  } finally {
+    if (descriptor !== void 0) fs.closeSync(descriptor);
+  }
+}
 async function handleLaunch(argv) {
   const { options } = parseFlags(argv, LAUNCH_BOOLEANS);
   const json = flag(options, "json");
@@ -627,14 +642,15 @@ async function finishLaunch(jsonOutput, machine, stream, adapter, mobileTarget,
         platform: mobileTarget ?? (adapter === "extension" ? displayMode : null),
         tier,
         recovered: state.recovered,
-        mutations: state.mutations
+        mutations: state.mutations,
+        metro: metroLaunchEvidence(adapter, target)
       });
     }
     return exitCode;
   }
-  return launchPass(jsonOutput, stream, adapter, mobileTarget, tier, displayMode, state);
+  return launchPass(jsonOutput, stream, adapter, mobileTarget, tier, displayMode, target, state);
 }
-function launchPass(json, stream, adapter, mobileTarget, tier, displayMode, state) {
+function launchPass(json, stream, adapter, mobileTarget, tier, displayMode, target, state) {
   if (stream.enabled) {
     for (const mutation of state.mutations) stream.mutation(mutation);
     for (const recovery of state.recovered) stream.recovery(recovery);
@@ -643,7 +659,8 @@ function launchPass(json, stream, adapter, mobileTarget, tier, displayMode, stat
       platform: mobileTarget ?? (adapter === "extension" ? displayMode : null),
       tier,
       recovered: state.recovered,
-      mutations: state.mutations
+      mutations: state.mutations,
+      metro: metroLaunchEvidence(adapter, target)
     });
   } else if (json) {
     console.log(
@@ -658,6 +675,7 @@ function launchPass(json, stream, adapter, mobileTarget, tier, displayMode, stat
           phase: "launch",
           recovered: state.recovered,
           mutations: state.mutations,
+          metro: metroLaunchEvidence(adapter, target),
           exitCode: EXIT.ok
         },
         null,
@@ -706,7 +724,8 @@ function launchFail(json, stream, adapter, mobileTarget, tier, state, target, fa
       recovered: state.recovered,
       mutations: state.mutations,
       recoverable: failure.recoverable,
-      attemptedRecoveries: state.attemptedRecoveries
+      attemptedRecoveries: state.attemptedRecoveries,
+      metro: metroLaunchEvidence(adapter, target)
     });
   } else if (json) {
     console.log(
@@ -723,6 +742,7 @@ function launchFail(json, stream, adapter, mobileTarget, tier, state, target, fa
           mutations: state.mutations,
           recoverable: failure.recoverable,
           attemptedRecoveries: state.attemptedRecoveries,
+          metro: metroLaunchEvidence(adapter, target),
           exitCode: failure.exitCode,
           error: {
             code: failure.code,

package/dist/commands/run-engine.js

@@ -155,12 +155,11 @@ async function resolveRecipeExecution(adapter, recipe, artifactsDir, projectRoot
     projectRoot,
     rootRecipe: recipeDocument
   });
-  const suppressHudForLifecycleTiming = adapter === "mobile" && mobileRecipeRequiresUninterruptedLifecycleTiming(recipeDocument);
   const suppressHudForOpaqueMobile = adapter === "mobile" && process.env.METAMASK_RECIPE_MOBILE_OPAQUE_RUNTIME === "1";
   const runnerOptions = {
     quietStdout: runtimeOptions.stdoutIsMachineContract === true,
     suppressLibraryResolutionLogs: runtimeOptions.suppressLibraryResolutionLogs,
-    autoHud: suppressHudForLifecycleTiming || suppressHudForOpaqueMobile ? false : trust.source && trust.source.trust !== "trusted" ? false : runtimeOptions.autoHud,
+    autoHud: suppressHudForOpaqueMobile ? false : trust.source && trust.source.trust !== "trusted" ? false : runtimeOptions.autoHud,
     onActionEvent: runtimeOptions.onActionEvent,
     actionSources,
     // A direct engineer invocation is the explicit trust boundary for a
@@ -213,16 +212,6 @@ function runtimeRecipeDocument(recipe, absoluteRecipePath) {
     return void 0;
   }
 }
-function mobileRecipeRequiresUninterruptedLifecycleTiming(recipe) {
-  if (!isRecord(recipe)) return false;
-  const workflow = isRecord(recipe.workflow) ? recipe.workflow : void 0;
-  const nodes = workflow && isRecord(workflow.nodes) ? workflow.nodes : void 0;
-  if (!nodes) return false;
-  const actions = new Set(
-    Object.values(nodes).filter(isRecord).map((node) => node.action).filter((action) => typeof action === "string")
-  );
-  return actions.has("app.lifecycle") && actions.has("metamask.perps.capture_performance");
-}
 function recipeProcessEnvironment() {
   const env = { ...process.env };
   delete env.MM_HARNESS_CHECKOUT_LOCK_TOKEN;
@@ -314,7 +303,8 @@ function recipeRunEnv(adapter, runtimeOptions = {}) {
     RECIPE_CDP_PORT: runtimeOptions.cdpPort ?? process.env.RECIPE_CDP_PORT,
     FARMSLOT_SLOT_ID: runtimeOptions.slot ?? process.env.FARMSLOT_SLOT_ID,
     SLOT_ID: runtimeOptions.slot ?? process.env.SLOT_ID,
-    PLATFORM: process.env.PLATFORM
+    PLATFORM: process.env.PLATFORM,
+    MM_HARNESS_EXPLICIT_PLATFORM: process.env.MM_HARNESS_EXPLICIT_PLATFORM
   };
   if (adapter !== "mobile") return base;
   return {
@@ -322,6 +312,7 @@ function recipeRunEnv(adapter, runtimeOptions = {}) {
     WATCHER_PORT: process.env.WATCHER_PORT ?? base.CDP_PORT ?? base.RECIPE_CDP_PORT,
     METRO_PORT: process.env.METRO_PORT ?? process.env.WATCHER_PORT ?? base.CDP_PORT ?? base.RECIPE_CDP_PORT,
     IOS_SIMULATOR: process.env.IOS_SIMULATOR,
+    SIM_UDID: process.env.SIM_UDID,
     ANDROID_DEVICE: process.env.ANDROID_DEVICE,
     ANDROID_TARGET_DEVICE_NAME: process.env.ANDROID_TARGET_DEVICE_NAME,
     ADB_SERIAL: process.env.ADB_SERIAL,
@@ -1378,7 +1369,6 @@ export {
   ensureMobileProofRuntime,
   executeWithHealBounds,
   listRunnableRecipes,
-  mobileRecipeRequiresUninterruptedLifecycleTiming,
   preflightRecipe,
   prepareHeal,
   prepareRuntimeIfNeeded,

package/dist/heal-bounds.js

@@ -62,6 +62,7 @@ async function ensureOverlay(adapter, target, heal, state, json) {
 }
 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 (/wallet|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";

package/dist/live-adapter-contract.js

@@ -359,7 +359,8 @@ function liveAdapterProcessTimeoutMs(node) {
   const actionTimeouts = [
     node.target_timeout_ms,
     node.unlock_timeout_ms,
-    node.timeout_ms
+    node.timeout_ms,
+    node.wait_timeout_ms
   ].map(Number).filter((value) => Number.isFinite(value) && value > 0);
   if (actionTimeouts.length > 0) {
     return Math.max(

package/dist/mm-harness-cli.js

@@ -243,7 +243,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 (default: auto)
+  --hud <auto|show|hide>             Recipe HUD policy (auto shows normal Mobile recipes; hide is explicit)
 
 Advanced integrations:
   runtime: --cdp-port, --watcher-port/--metro-port, --runtime-dir, --slot,

package/docs/QA.md

@@ -124,6 +124,8 @@ mm-harness debug
 - [ ] Status matches verified product routes: `Login`/`LockScreen` are locked;
   `WalletView` is unlocked.
 - [ ] App and Metro logs are separate.
+- [ ] A restarted Metro rotates the previous `metro.log`, records its generation and retention actions in launch JSON, and classifies bundle failures only from the current log.
+- [ ] `mm-harness logs --full` preserves errors, completion, and meaningful timestamped bundle progress without repeated same-percentage module counts.
 - [ ] A JS edit rebuilds through Metro and appears after reload without a native
   rebuild; revert restores a clean tree.
 

package/docs/RECIPES.md

@@ -176,30 +176,36 @@ For visual PR proof, prefer a short simulator recording or GIF over still
 screenshots when the claim is a UI flow (timing / transitions). Use screenshots
 as supporting stills.
 
-### Perps Homepage visible performance
+### Perps loading lifecycle validation
 
-The bundled `perps.performance.homepage.*` family preserves the device-proven
-Homepage TTC/DFD journeys. Run every recipe with an explicit device pin,
-healing disabled, and full-run video:
+One platform-neutral recipe owns the reusable Perps lifecycle proof. The
+harness adapter supplies Android or iOS behavior; the graph and lifecycle
+parameters remain identical. Run it with an explicit device pin:
 
 ```bash
-mm-harness run perps.performance.homepage.android-background-short --device <serial> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.android-background-reconnect --device <serial> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.android-cold-no-cache --device <serial> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.android-cold-disk-cache --device <serial> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.android-network-recovery --device <serial> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.ios-background-short --device <udid> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.ios-background-reconnect --device <udid> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.ios-cold-no-cache --device <udid> --heal off --record-video=full-run
-mm-harness run perps.performance.homepage.ios-cold-disk-cache --device <udid> --heal off --record-video=full-run
+mm-harness run perps.performance \
+  --device <android-serial-or-ios-udid> \
+  account=<fixture-account-name> \
+  content_variant=trending \
+  market=BTC \
+  lifecycle=cold_no_cache \
+  --heal off --record-video=full-run
 ```
 
-The Android variants use a deterministic Hyperliquid testnet order and cancel
-it after capture. The iOS variants use the existing fixture wallet and validate
-trending content without fabricating position/order state. `app.network` is
-Android-only because host-wide iOS network mutation cannot isolate one
-simulator safely. These recipes validate viewport-demand-to-visible TTC/DFD;
-they do not relabel process-start duration as TTC.
+The Mobile recipe HUD is shown by default, including during performance
+validation. Use `--hud hide` only when a specific opaque/release proof requires
+an unobstructed product surface; do not hide it merely to collect timings.
+
+Supported lifecycle values are `navigate_return`, `cold_disk_cache`,
+`cold_no_cache`, `background_short`, `background_reconnect`, `account_switch`,
+and `network_switch`. The shared graph uses an existing fixture position and
+never fabricates exchange state inside the measurement. It proves native
+visible content with `ui.wait_for`, captures production `[PerpsLoadProof]` and
+WebSocket milestones, and leaves detailed TTC/DFD to the app's Sentry traces.
+It never relabels Metro, fixture, or process-start duration as TTC.
+The recipe does not label a checkout as main or candidate; pin and record the
+exact checkout commit externally, then use captured source milestones to verify
+which data path actually ran.
 
 Rules:
 

package/library/actions/mobile/perps/capture_performance.mjs

@@ -1,4 +1,4 @@
 import { runAdapter } from '../platform/bridge.mjs';
-import { captureHomepagePerformance } from './performance-capture.mjs';
+import { capturePerpsPerformance } from './performance-capture.mjs';
 
-runAdapter(captureHomepagePerformance);
+runAdapter(capturePerpsPerformance);