@deeeed/metamask-harness 0.17.4 → 0.17.5

package/dist/commands/manifest.js

@@ -1,129 +1,57 @@
 import { loadActionManifest, validateManifest } from "../manifest.js";
 import { EXIT } from "./shared.js";
-import { isRecord, optionFlag, optionString, resolveAdapter } from "./parse-args.js";
-async function handleActions({ options, positional }) {
+import {
+  actionManifestPathOption,
+  isRecord,
+  optionFlag,
+  optionString,
+  resolveAdapter
+} from "./parse-args.js";
+async function handleManifest({ options }) {
+  const { adapter } = resolveAdapter(options);
+  const actionManifestPath = actionManifestPathOption(options, adapter);
+  const manifest = loadActionManifest(adapter, optionString(options, "actionManifest"));
+  await validateManifest(manifest);
+  if (optionFlag(options, "json")) console.log(JSON.stringify(manifest, null, 2));
+  else console.log(actionManifestPath);
+  return 0;
+}
+async function handleActions({ options }) {
   const { adapter } = resolveAdapter(options);
   const manifest = loadActionManifest(adapter, optionString(options, "actionManifest"));
   await validateManifest(manifest);
-  if (optionFlag(options, "raw")) {
-    console.log(JSON.stringify(manifest, null, 2));
-    return EXIT.ok;
-  }
   const json = optionFlag(options, "json");
   const action = optionString(options, "action");
-  const query = positional[0]?.trim();
-  const category = optionString(options, "category")?.toLowerCase();
-  const categoriesOnly = optionFlag(options, "categories");
   const all = describeManifestActions(manifest);
-  const categories = summarizeActionCategories(all);
-  if (categoriesOnly && (action || category)) {
-    const message = "--categories cannot be combined with --action or --category.";
-    const userAction = `mm-harness actions --adapter ${adapter} --categories`;
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, error: { code: "ACTION_FILTER_CONFLICT", message, userAction } }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  if (categoriesOnly) {
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, categories }, null, 2));
-    else for (const entry of categories) console.log(`${entry.name} (${entry.count})`);
-    return EXIT.ok;
-  }
-  const categoryActions = category ? all.filter((entry) => entry.category === category) : all;
-  if (category && categoryActions.length === 0) {
-    const message = `no action category matches "${category}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter} --categories`;
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, category, availableCategories: categories, error: { code: "ACTION_CATEGORY_UNKNOWN", message, userAction } }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  const actions = action ? fuzzyResolveActions(categoryActions, action) : query ? searchActions(categoryActions, query) : categoryActions;
+  const actions = action ? fuzzyResolveActions(all, action) : all;
   if (action && actions.length === 0) {
     const message = `no action matches "${action}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter}`;
-    if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, action, category, error: { code: "ACTION_UNKNOWN", message, userAction } }, null, 2));
-    } else {
-      console.error(`\u2717 mm-harness actions: ${message}
-  Next: ${userAction}`);
-    }
-    return EXIT.usage;
-  }
-  if (query && actions.length === 0) {
-    const message = `no action matches search "${query}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter} --categories`;
+    const userAction = `mm-harness actions --adapter ${adapter}   # list the vocabulary`;
     if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        command: "actions",
-        adapter,
-        query,
-        category,
-        error: { code: "ACTION_SEARCH_EMPTY", message, userAction }
-      }, null, 2));
+      console.log(JSON.stringify({ schemaVersion: 1, command: "actions", adapter, action, error: { code: "ACTION_UNKNOWN", message, userAction } }, null, 2));
     } else {
       console.error(`\u2717 mm-harness actions: ${message}
   Next: ${userAction}`);
     }
     return EXIT.usage;
   }
-  const relatedActions = action && actions.length === 1 ? findRelatedActions(all, actions[0]) : void 0;
   if (json) {
-    console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "actions",
-      adapter,
-      ...query ? { query } : {},
-      category,
-      actions,
-      ...relatedActions ? { relatedActions } : {}
-    }, null, 2));
+    console.log(JSON.stringify({ adapter, actions }, null, 2));
   } else {
     for (const entry of actions) {
       const fields = entry.fields.length ? ` fields=${entry.fields.join(",")}` : "";
       console.log(`${entry.name} (${entry.kind})${fields}${entry.description ? ` \u2014 ${entry.description}` : ""}`);
     }
-    if (relatedActions) console.log(`Related: ${relatedActions.join(", ")}`);
   }
   return 0;
 }
 function fuzzyResolveActions(entries, query) {
   const exactFull = entries.filter((e) => e.name === query);
   if (exactFull.length > 0) return exactFull;
-  const finalSegment2 = (name) => name.split(".").pop() ?? name;
-  const exactSegment = entries.filter((e) => finalSegment2(e.name) === query);
+  const finalSegment = (name) => name.split(".").pop() ?? name;
+  const exactSegment = entries.filter((e) => finalSegment(e.name) === query);
   if (exactSegment.length > 0) return exactSegment;
-  return entries.filter((e) => finalSegment2(e.name).includes(query));
-}
-function searchActions(entries, query) {
-  const terms = searchTerms(query);
-  if (terms.length === 0) return [];
-  return entries.map((entry) => {
-    const scores = terms.map((term) => actionSearchScore(entry, term));
-    return { entry, scores, score: scores.reduce((total, value) => total + value, 0) };
-  }).filter(({ score, scores }) => score > 0 && scores.every((value) => value > 0)).sort((left, right) => right.score - left.score || left.entry.name.localeCompare(right.entry.name)).map(({ entry }) => entry);
-}
-function findRelatedActions(entries, selected, limit = 5) {
-  const selectedNameTerms = searchTerms(finalSegment(selected.name).replaceAll("_", " "));
-  return entries.filter((entry) => entry.name !== selected.name).map((entry) => {
-    const nameTerms = new Set(searchTerms(finalSegment(entry.name).replaceAll("_", " ")));
-    const sharedScore = selectedNameTerms.filter((term) => nameTerms.has(term)).reduce((score2, term) => score2 + (GENERIC_OPERATION_TERMS.has(term) ? 5 : 30), 0);
-    const score = (entry.category === selected.category ? 100 : 0) + sharedScore;
-    return { name: entry.name, score };
-  }).filter(({ score }) => score > 0).sort((left, right) => right.score - left.score || left.name.localeCompare(right.name)).slice(0, limit).map(({ name }) => name);
-}
-const GENERIC_OPERATION_TERMS = /* @__PURE__ */ new Set(["assert", "call", "close", "ensure", "place", "read", "start", "teardown"]);
-function summarizeActionCategories(actions) {
-  const counts = /* @__PURE__ */ new Map();
-  for (const action of actions) counts.set(action.category, (counts.get(action.category) ?? 0) + 1);
-  return [...counts.entries()].map(([name, count]) => ({ name, count })).sort((left, right) => left.name.localeCompare(right.name));
+  return entries.filter((e) => finalSegment(e.name).includes(query));
 }
 function describeManifestActions(manifest) {
   const manifestRecord = isRecord(manifest) ? manifest : {};
@@ -152,69 +80,15 @@ function describeManifestAction(name, kind, metadata) {
   return {
     name,
     kind,
-    category: actionCategory(name, record.category),
     description: typeof record.description === "string" ? record.description : "",
     fields: properties,
     schema,
     examples: record.examples
   };
 }
-function actionCategory(name, configured) {
-  if (typeof configured === "string" && configured.trim()) return configured.trim().toLowerCase();
-  const segments = name.split(".");
-  if (segments[0] === "metamask" && segments.length > 2) return segments[1] ?? "metamask";
-  if (segments[0] === "app" || segments[0] === "cdp") return "runtime";
-  if (segments[0] === "ui") return "ui";
-  if (name.startsWith("assert_")) return "assertion";
-  if (name === "watch_logs" || name === "index_artifacts") return "evidence";
-  if (name === "command" || name === "wait" || name === "call" || name === "end") return "control";
-  return segments.length > 1 ? segments[0] || "utility" : "utility";
-}
-function actionSearchScore(entry, term) {
-  const name = entry.name.toLowerCase();
-  const segment = finalSegment(name);
-  const nameTerms = searchTerms(name.replaceAll(".", " ").replaceAll("_", " "));
-  const fields = entry.fields.map((field) => field.toLowerCase());
-  const description = entry.description.toLowerCase();
-  if (name === term) return 120;
-  if (segment === term) return 110;
-  if (entry.category === term) return 100;
-  if (fields.includes(term)) return 90;
-  if (nameTerms.includes(term)) return 80;
-  if (name.includes(term)) return 70;
-  if (fields.some((field) => field.includes(term))) return 60;
-  if (description.includes(term)) return 50;
-  if ([...nameTerms, ...fields].some((candidate) => fuzzyTermMatch(term, candidate))) return 40;
-  return 0;
-}
-function fuzzyTermMatch(term, candidate) {
-  if (term.length < 4 || candidate.length < 4) return false;
-  const threshold = Math.max(1, Math.floor(Math.max(term.length, candidate.length) / 4));
-  return levenshtein(term, candidate) <= threshold;
-}
-function searchTerms(value) {
-  return value.toLowerCase().match(/[a-z0-9]+/gu) ?? [];
-}
-function finalSegment(name) {
-  return name.split(".").pop() ?? name;
-}
-function levenshtein(left, right) {
-  const prior = Array.from({ length: right.length + 1 }, (_, index) => index);
-  for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
-    const current = [leftIndex];
-    for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) {
-      const substitution = (prior[rightIndex - 1] ?? 0) + (left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1);
-      current[rightIndex] = Math.min((current[rightIndex - 1] ?? 0) + 1, (prior[rightIndex] ?? 0) + 1, substitution);
-    }
-    for (let index = 0; index < current.length; index += 1) prior[index] = current[index] ?? 0;
-  }
-  return prior[right.length] ?? right.length;
-}
 export {
   describeManifestActions,
-  findRelatedActions,
   fuzzyResolveActions,
   handleActions,
-  searchActions,
-  summarizeActionCategories
+  handleManifest
 };

package/dist/commands/parse-args.js

@@ -19,14 +19,12 @@ function parseArgs(argv, command) {
   const options = {};
   const booleanOptions = /* @__PURE__ */ new Set([
     "json",
-    "jsonStream",
     "launchExistingDist",
     "startWatch",
     "record",
     "plan",
     "list",
     "raw",
-    "categories",
     "fix",
     "force",
     "resolveOnly",

package/dist/commands/provision.js

@@ -1,7 +1,7 @@
 import { detectAdapter } from "../harness.js";
 import { assertAdapter } from "../paths.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { ADAPTER_DETECT_NEXT, usageOut, writeInteractiveProgress } from "./shared.js";
+import { ADAPTER_DETECT_NEXT, usageOut } from "./shared.js";
 import {
   applyWatcherPortOption,
   optionFlag,
@@ -25,13 +25,9 @@ async function handleProvision({ positional, options, rawArgv }) {
   }
   const surface = getAdapterSurface(adapter);
   const rerunCommand = provisionRerunCommand(rawArgv, options, adapter, target);
-  const platform = optionString(options, "platform") ?? optionString(options, "devicePlatform") ?? (positional[0] === "runway" ? positional[1] : positional[0]) ?? "ios";
-  if (adapter === "mobile") {
-    writeInteractiveProgress(json, `\u2192 provision mobile ${platform} \u2014 resolving simulator and Runway artifact`);
-  }
   const result = await surface.runwayProvision.run(target, {
     json,
-    platform,
+    platform: optionString(options, "platform") ?? optionString(options, "devicePlatform") ?? (positional[0] === "runway" ? positional[1] : positional[0]) ?? "ios",
     branch: optionString(options, "branch"),
     defaultBranch: optionString(options, "defaultBranch"),
     run: optionString(options, "run"),
@@ -46,10 +42,8 @@ async function handleProvision({ positional, options, rawArgv }) {
     resolveOnly: optionFlag(options, "resolveOnly"),
     rerunCommand
   });
-  const next = result.status === "pass" && adapter === "mobile" && result.resolveOnly !== true ? `mm-harness launch ${String(result.platform ?? platform)} --adapter mobile --target ${shellQuote(target)}` : void 0;
-  const output = next ? { ...result, next } : result;
   if (json) {
-    console.log(JSON.stringify(output, null, 2));
+    console.log(JSON.stringify(result, null, 2));
   } else if (result.status === "pass") {
     const cache = typeof result.cache === "object" && result.cache ? result.cache : void 0;
     const simulator = typeof result.simulator === "object" && result.simulator ? result.simulator : void 0;
@@ -60,7 +54,6 @@ async function handleProvision({ positional, options, rawArgv }) {
       const action = result.skipped ? "already provisioned" : "provisioned";
       console.error(`\u2713 ${action} ${adapter} ${result.platform ?? ""} simulator=${simulator?.name ?? "unknown"} cache=${cache?.status ?? "unknown"}`);
     }
-    if (next) console.error(`  Next: ${next}`);
   } else {
     console.error(`\u2717 mm-harness provision: ${result.error?.message ?? "provision failed"}
   Next: ${result.error?.userAction ?? rerunCommand}`);

package/dist/commands/run-engine.js

@@ -20,17 +20,12 @@ import {
 import { captureHelperSupportsRecordSessionSnapshots } from "../recording-target.js";
 import { listRecipeFiles } from "../recipe-files.js";
 import { startRecipeRecording, stopRecipeRecording } from "../run-recording.js";
-import {
-  beginRunDiagnostics,
-  finishRunDiagnostics
-} from "../run-diagnostics.js";
-import { EXIT } from "./shared.js";
+import { EXIT, spawnScriptStreaming } from "./shared.js";
 import {
   actionManifestPathOption,
   optionString,
   isRecord,
   shellQuoteArg,
-  targetPath,
   usageError
 } from "./parse-args.js";
 async function runRecipe(adapter, recipe, artifactsDir, projectRoot, actionManifestPath, runtimeOptions = {}) {
@@ -54,7 +49,6 @@ async function runRecipe(adapter, recipe, artifactsDir, projectRoot, actionManif
   try {
     await prepareRuntimeIfNeeded(adapter, projectRoot, runtimeOptions);
     const absoluteArtifactsDir = path.resolve(artifactsDir);
-    const diagnosticBaseline = await beginRunDiagnostics(adapter, projectRoot);
     const recordVideo = runtimeOptions.recordVideo ?? false;
     const useFramedExtensionRecording = adapter === "extension" && recordVideo === "full-run" && captureHelperSupportsRecordSessionSnapshots(projectRoot);
     const recording = useFramedExtensionRecording ? await startRecipeRecording(adapter, projectRoot, absoluteArtifactsDir, {
@@ -66,8 +60,7 @@ async function runRecipe(adapter, recipe, artifactsDir, projectRoot, actionManif
       await validateManifest(manifest);
       const { createMetaMaskRunner } = await import("../runner.js");
       const runner = await createMetaMaskRunner(adapter, manifest, {
-        quietStdout: runtimeOptions.stdoutIsMachineContract === true,
-        onActionEvent: runtimeOptions.onActionEvent
+        quietStdout: runtimeOptions.stdoutIsMachineContract === true
       });
       const runRequest = {
         recipePath: path.resolve(recipe),
@@ -87,7 +80,7 @@ async function runRecipe(adapter, recipe, artifactsDir, projectRoot, actionManif
         }
       }
       await stopRecipeRecording(recording, result);
-      return finishRunDiagnostics(diagnosticBaseline, result);
+      return result;
     } finally {
       await stopRecipeRecording(recording);
     }
@@ -198,7 +191,12 @@ function libraryRecipeNames(adapter) {
   return [...new Set(names)].sort();
 }
 function recipeNameCandidates(recipeArg, adapter) {
-  return singleRecipeNameCandidates(recipeArg, adapter);
+  const names = [recipeArg, ...LEGACY_RECIPE_ALIASES[recipeArg] ?? []];
+  const candidates = [];
+  for (const name of names) {
+    candidates.push(...singleRecipeNameCandidates(name, adapter));
+  }
+  return [...new Set(candidates)];
 }
 function singleRecipeNameCandidates(name, adapter) {
   if (name.endsWith(".recipe.json")) {
@@ -224,6 +222,32 @@ function domainPathForRecipeName(name) {
 function uniqueStrings(values) {
   return [...new Set(values)];
 }
+const LEGACY_RECIPE_ALIASES = {
+  "action-validation": ["runner.action-validation"],
+  "action-validation.extension.recipe.json": ["runner.action-validation.extension.recipe.json"],
+  "action-validation.mobile.recipe.json": ["runner.action-validation.mobile.recipe.json"],
+  "app-lifecycle-android-smoke": ["app.lifecycle.android-smoke"],
+  "app-lifecycle-android-smoke.mobile.recipe.json": ["app.lifecycle.android-smoke.mobile.recipe.json"],
+  "order-lifecycle": ["perps.order-lifecycle"],
+  "order-lifecycle.core.recipe.json": ["perps.order-lifecycle.core.recipe.json"],
+  "perps-lifecycle": ["perps.lifecycle"],
+  "perps-lifecycle.recipe.json": ["perps.lifecycle.recipe.json"],
+  "perps-performance": ["perps.performance"],
+  "perps-performance-background-resume": ["perps.performance.background-resume"],
+  "perps-performance-background-resume.mobile.recipe.json": ["perps.performance.background-resume.mobile.recipe.json"],
+  "perps-performance-cold-start": ["perps.performance.cold-start"],
+  "perps-performance-cold-start.mobile.recipe.json": ["perps.performance.cold-start.mobile.recipe.json"],
+  "perps-performance-warm-start": ["perps.performance.warm-start"],
+  "perps-performance-warm-start.mobile.recipe.json": ["perps.performance.warm-start.mobile.recipe.json"],
+  "perps-performance.mobile.recipe.json": ["perps.performance.mobile.recipe.json"],
+  "read-markets": ["perps.read-markets"],
+  "read-markets.core.recipe.json": ["perps.read-markets.core.recipe.json"],
+  "smoke": ["runner.smoke"],
+  "smoke.extension.recipe.json": ["runner.smoke.extension.recipe.json"],
+  "smoke.mobile.recipe.json": ["runner.smoke.mobile.recipe.json"],
+  "trading-lifecycle": ["perps.trading-lifecycle"],
+  "trading-lifecycle.core.recipe.json": ["perps.trading-lifecycle.core.recipe.json"]
+};
 async function validateRunRecipeStatic(recipeArg, adapter, options) {
   const librarySources = await resolveMetaMaskLibrarySources(optionString(options, "library"));
   const resolved = resolveRunRecipeArg(recipeArg, adapter, librarySources);
@@ -317,7 +341,6 @@ async function actionInsteadOfRecipeHint(recipeArg, adapter, options) {
     const device = optionString(options, "device");
     const actionManifest = optionString(options, "actionManifest");
     const parts = ["mm-harness", "call", matches[0]];
-    parts.push("--adapter", adapter, "--target", shellQuoteArg(targetPath(options)));
     if (device) parts.push("--device", shellQuoteArg(device));
     if (actionManifest) parts.push("--action-manifest", shellQuoteArg(actionManifest));
     return ` This is an action, not a recipe. Use: ${parts.join(" ")}.`;
@@ -375,12 +398,10 @@ async function runOneNode(adapter, action, args, target, actionManifest) {
 async function prepareHeal(adapter, target, options, json, prepareOptions = {}) {
   if (recipeRunning(target)) {
     const msg = "a recipe is currently running \u2014 refusing to start while another recipe executes.";
-    const userAction = `inspect the checkout state with: mm-harness status --target ${shellQuoteArg(target)} --json; retry after the active recipe finishes`;
     if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, status: "fail", recoverable: false, error: { code: "RECIPE_RUNNING", message: msg, userAction } }, null, 2));
+      console.log(JSON.stringify({ schemaVersion: 1, status: "fail", recoverable: false, error: { code: "RECIPE_RUNNING", message: msg } }, null, 2));
     } else {
-      console.error(`\u2717 mm-harness: ${msg}
-  Next: ${userAction}`);
+      console.error(`\u2717 mm-harness: ${msg}`);
     }
     return EXIT.bounded;
   }
@@ -393,25 +414,21 @@ async function prepareHeal(adapter, target, options, json, prepareOptions = {})
     return EXIT.usage;
   }
   const state = newHealState();
-  prepareOptions.onPhase?.("install");
   const ensured = await ensureOverlay(adapter, target, heal, state, json);
   if (!ensured.ok) {
-    const userAction = `mm-harness install --adapter ${adapter} --target ${shellQuoteArg(target)}`;
     if (json) {
       console.log(
         JSON.stringify(
-          { schemaVersion: 1, status: "fail", recoverable: false, mutations: state.mutations, error: { code: "OVERLAY_INSTALL_FAILED", message: ensured.error, userAction } },
+          { schemaVersion: 1, status: "fail", recoverable: false, mutations: state.mutations, error: { code: "OVERLAY_INSTALL_FAILED", message: ensured.error } },
           null,
           2
         )
       );
     } else {
-      console.error(`\u2717 overlay auto-ensure failed: ${ensured.error}
-  Next: ${userAction}`);
+      console.error(`\u2717 overlay auto-ensure failed: ${ensured.error}`);
     }
     return EXIT.infra;
   }
-  prepareOptions.onPhase?.("healthcheck");
   if (adapter === "extension") {
     const previousCdpPort = process.env.CDP_PORT;
     const previousRecipeCdpPort = process.env.RECIPE_CDP_PORT;
@@ -424,9 +441,7 @@ async function prepareHeal(adapter, target, options, json, prepareOptions = {})
     }
     if (explicitWatcherPort) process.env.WATCHER_PORT = explicitWatcherPort;
     try {
-      const current = await ensureExtensionProofRuntime(target, heal, state, json, {
-        onRecovery: (code) => prepareOptions.onPhase?.("recover", { code })
-      });
+      const current = await ensureExtensionProofRuntime(target, heal, state, json);
       if (current !== null) return current;
     } finally {
       restoreEnv("CDP_PORT", previousCdpPort);
@@ -435,9 +450,7 @@ async function prepareHeal(adapter, target, options, json, prepareOptions = {})
     }
   }
   if (adapter === "mobile" && prepareOptions.skipMobileSourceFreshness !== true) {
-    const current = await ensureMobileProofRuntime(target, heal, state, json, {
-      onRecovery: (code) => prepareOptions.onPhase?.("recover", { code })
-    });
+    const current = await ensureMobileProofRuntime(target, heal, state, json);
     if (current !== null) return current;
   }
   return { state, heal };
@@ -447,20 +460,6 @@ async function ensureMobileProofRuntime(target, heal, state, json, deps = {}) {
   const check = deps.check ?? (() => source.mobileSourceCheck(target));
   const record = deps.record ?? ((fingerprint) => source.recordMobileSourceBaseline(target, fingerprint));
   const initial = check();
-  if (initial.status === "unavailable") {
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        status: "fail",
-        recoverable: false,
-        error: initial.error
-      }, null, 2));
-    } else {
-      console.error(`\u2717 ${initial.error.message}`);
-      console.error(`  Next: ${initial.error.userAction}`);
-    }
-    return EXIT.usage;
-  }
   if (initial.status === "current") return null;
   const targetArg = JSON.stringify(path.resolve(target));
   const userAction = `mm-harness call app.lifecycle --arg command=restart --adapter mobile --target ${targetArg}`;
@@ -482,7 +481,6 @@ async function ensureMobileProofRuntime(target, heal, state, json, deps = {}) {
   }
   const recoveryCode = "mobile.source_reloaded";
   state.attemptedRecoveries.push(recoveryCode);
-  deps.onRecovery?.(recoveryCode);
   if (!json) console.error(`\u2192 Mobile proof preflight: source ${initial.status}; restarting the app before execution`);
   const restart = deps.restart ?? (async () => {
     const result2 = await runOneNode(
@@ -495,21 +493,27 @@ async function ensureMobileProofRuntime(target, heal, state, json, deps = {}) {
     return { status: result2.status === "pass" ? 0 : EXIT.runtime, output: result2.status };
   });
   const result = await restart();
-  const recorded = result.status === 0 && record(initial.fingerprint);
+  const platform = resolveRunMobilePlatform();
+  const bridge = result.status === 0 ? await (deps.waitForBridge ? deps.waitForBridge() : spawnScriptStreaming(
+    path.join(runnerDir, "adapters/mobile/wait-for-bridge.sh"),
+    ["--target", target, "--platform", platform],
+    target
+  )) : { status: result.status, output: result.output };
+  const recorded = result.status === 0 && bridge.status === 0 && record(initial.fingerprint);
   const verified = recorded ? check() : initial;
-  if (result.status !== 0 || !recorded || verified.status !== "current") {
-    const message = "Mobile source restart did not produce a current loaded-source baseline.";
+  if (result.status !== 0 || bridge.status !== 0 || !recorded || verified.status !== "current") {
+    const message = bridge.status !== 0 ? "Mobile source restart completed but the platform-matched bridge did not become ready." : "Mobile source restart did not produce a current loaded-source baseline.";
     if (json) {
       console.log(JSON.stringify({
         schemaVersion: 1,
         status: "fail",
         recoverable: false,
         attemptedRecoveries: state.attemptedRecoveries,
-        error: { code: "MOBILE_SOURCE_RELOAD_FAILED", message, userAction, originalError: result.output }
+        error: { code: bridge.status !== 0 ? "MOBILE_BRIDGE_NOT_READY" : "MOBILE_SOURCE_RELOAD_FAILED", message, userAction, originalError: bridge.output || result.output }
       }, null, 2));
     } else {
       console.error(`\u2717 ${message}`);
-      console.error(`  Next: ${userAction}`);
+      console.error(`  Next: ${bridge.status !== 0 ? "inspect the bridge-status log and rerun mm-harness launch <platform>" : userAction}`);
     }
     return EXIT.infra;
   }
@@ -528,22 +532,6 @@ async function ensureExtensionProofRuntime(target, heal, state, json, deps = {})
   });
   const initial = await decide();
   if (initial.decision === "ready") return null;
-  if (initial.reasonCode === "runtime-dist-check-failed") {
-    const message = `Extension proof runtime freshness could not be checked: ${initial.reasons[0] ?? initial.decision}`;
-    const userAction2 = `mm-harness doctor --adapter extension --target ${JSON.stringify(path.resolve(target))}`;
-    if (json) {
-      console.log(JSON.stringify({
-        schemaVersion: 1,
-        status: "fail",
-        recoverable: false,
-        error: { code: "EXTENSION_RUNTIME_CHECK_FAILED", message, userAction: userAction2 }
-      }, null, 2));
-    } else {
-      console.error(`\u2717 ${message}`);
-      console.error(`  Next: ${userAction2}`);
-    }
-    return EXIT.infra;
-  }
   if (!["dist-stale", "dist-missing", "runtime-dist-stale", "runtime-dist-missing"].includes(initial.reasonCode)) {
     return null;
   }
@@ -569,14 +557,19 @@ async function ensureExtensionProofRuntime(target, heal, state, json, deps = {})
   }
   const recoveryCode = tier === "build" ? "extension.runtime_rebuilt" : "extension.runtime_reloaded";
   state.attemptedRecoveries.push(recoveryCode);
-  deps.onRecovery?.(recoveryCode);
   if (!json) console.error(`\u2192 Extension proof preflight: ${initial.reasonCode}; ${tier === "build" ? "rebuilding" : "reloading"} before execution`);
   const launch = deps.launch ?? (async (requestedTier) => {
     const { launchExtension } = await import("./launch/extension.js");
     return launchExtension(target, requestedTier, false);
   });
   const result = await launch(tier);
-  const verified = result.status === 0 ? await decide() : initial;
+  let verified = result.status === 0 ? await decide() : initial;
+  if (result.status === 0 && verified.decision !== "ready") {
+    for (let attempt = 0; attempt < 8 && verified.decision !== "ready"; attempt += 1) {
+      await new Promise((resolve) => setTimeout(resolve, 250));
+      verified = await decide();
+    }
+  }
   if (result.status !== 0 || verified.decision !== "ready") {
     const message = `Extension runtime recovery did not produce a current healthy runtime (${verified.reasonCode}).`;
     if (json) {
@@ -610,11 +603,17 @@ async function recoverRunInfra(adapter, target, json) {
   }
   if (adapter === "mobile") {
     const { launchMobile } = await import("./launch/mobile.js");
-    const platform = process.env.PLATFORM === "android" ? "android" : "ios";
+    const platform = resolveRunMobilePlatform();
     return launchMobile(target, platform, "quick", json);
   }
   return { status: 0, output: "headless run retry" };
 }
+function resolveRunMobilePlatform() {
+  if (process.env.PLATFORM === "android" || process.env.PLATFORM === "ios") {
+    return process.env.PLATFORM;
+  }
+  return process.env.ADB_SERIAL || process.env.ANDROID_SERIAL ? "android" : "ios";
+}
 function readRunFailureText(result) {
   try {
     const trace = JSON.parse(fs.readFileSync(result.tracePath, "utf8"));
@@ -624,7 +623,7 @@ function readRunFailureText(result) {
     return "";
   }
 }
-async function executeWithHealBounds(exec, adapter, target, heal, state, recover = () => recoverRunInfra(adapter, target, false), onRecovery = () => void 0) {
+async function executeWithHealBounds(exec, adapter, target, heal, state, recover = () => recoverRunInfra(adapter, target, false)) {
   let result = await exec();
   for (; ; ) {
     if (result.status === "pass") return { result, violation: null };
@@ -633,7 +632,6 @@ async function executeWithHealBounds(exec, adapter, target, heal, state, recover
     if (heal === "off") return { result, violation: null };
     const recoveryCode = RUN_RECOVERY_CODE[adapter];
     state.attemptedRecoveries.push(recoveryCode);
-    onRecovery(recoveryCode);
     await recover();
     result = await exec();
     if (result.status === "pass") {
@@ -643,7 +641,7 @@ async function executeWithHealBounds(exec, adapter, target, heal, state, recover
   }
 }
 function emitHealViolation(json, command, result, violation, state, adapter) {
-  const userAction = adapter === "core" && violation.code === "WALLET_STATE_REQUIRED" ? 'create temp/recipe/runtime/wallet-fixture.json, or add "account": "<0x\u2026>" to the node block in the recipe' : violation.userAction ?? `inspect ${shellQuoteArg(result.summaryPath)} and ${shellQuoteArg(result.tracePath)}; fix the application or recipe failure before retrying`;
+  const userAction = adapter === "core" && violation.code === "WALLET_STATE_REQUIRED" ? 'set MM_TEST_ACCOUNT_ADDRESS=<0x\u2026> in env, or add "account": "<0x\u2026>" to the node block in the recipe' : violation.userAction;
   if (json) {
     console.log(
       JSON.stringify(
@@ -663,7 +661,7 @@ function emitHealViolation(json, command, result, violation, state, adapter) {
             code: violation.code,
             message: violation.message,
             retryable: false,
-            userAction,
+            userAction: userAction ?? null,
             originalError: violation.originalError ?? null
           }
         },

package/dist/commands/run-report.js

@@ -25,19 +25,10 @@ function renderRunReport(summary, entries) {
     "",
     `Status: ${String(summary.status ?? "unknown")}`,
     `Duration: ${formatDuration(Number(summary.durationMs ?? 0))}`,
-    `Nodes: ${Number(summary.passed ?? 0)}/${Number(summary.total ?? entries.length)} passed`
+    `Nodes: ${Number(summary.passed ?? 0)}/${Number(summary.total ?? entries.length)} passed`,
+    "",
+    "## Steps"
   ];
-  const sideFindings = isRecord(summary.sideFindings) ? summary.sideFindings : void 0;
-  const sideFindingCounts = sideFindings && isRecord(sideFindings.counts) ? sideFindings.counts : void 0;
-  const sideFindingTotal = Number(sideFindingCounts?.total ?? 0);
-  if (sideFindingTotal > 0) {
-    lines.push(
-      "",
-      "## Side findings",
-      `- REVIEW ${sideFindingTotal} distinct application warning/error event(s) (non-blocking; expanded below and stored in diagnostics.json)`
-    );
-  }
-  lines.push("", "## Steps");
   for (const entry of entries) {
     if (!isRecord(entry)) continue;
     const mark = entry.ok === false ? "FAIL" : "PASS";