@deeeed/metamask-harness 0.17.0 → 0.17.2

package/dist/adapters/extension/runtime-decision.js

@@ -173,7 +173,7 @@ function runtimeDistCheck(target) {
   } catch (error) {
     if (error.code === "ENOENT") {
       try {
-        const modified2 = filesystemSnapshotDiff(dist, runtimeDist).slice(0, 10);
+        const modified2 = filesystemSnapshotDiff(dist, runtimeDist).filter((relative) => !slotTitleOnlyDifference(dist, runtimeDist, relative)).slice(0, 10);
         return modified2.length > 0 ? { status: "stale", comparison: "filesystem-quick", modified: modified2 } : { status: "fresh", comparison: "filesystem-quick" };
       } catch (fallbackError) {
         return {
@@ -188,9 +188,21 @@ function runtimeDistCheck(target) {
       error: `rsync snapshot comparison failed${typeof status === "number" ? ` with exit ${status}` : ""}`
     };
   }
-  const modified = output.split("\n").map((line) => line.trim()).filter(Boolean).slice(0, 10);
+  const modified = output.split("\n").map((line) => line.trim()).filter(Boolean).filter((relative) => !slotTitleOnlyDifference(dist, runtimeDist, relative)).slice(0, 10);
   return modified.length > 0 ? { status: "stale", comparison: "rsync-quick", modified } : { status: "fresh", comparison: "rsync-quick" };
 }
+function slotTitleOnlyDifference(dist, runtimeDist, relative) {
+  if (relative !== "home.html" && relative !== "sidepanel.html") return false;
+  try {
+    const normalize = (source) => source.replace(
+      /<title>([^<]*)<\/title>/iu,
+      (_match, title) => `<title>${String(title || "MetaMask").replace(/^.+?\s+[—–-]\s+/u, "") || "MetaMask"}</title>`
+    );
+    return normalize(fs.readFileSync(path.join(dist, relative), "utf8")) === normalize(fs.readFileSync(path.join(runtimeDist, relative), "utf8"));
+  } catch {
+    return false;
+  }
+}
 function filesystemSnapshotDiff(source, snapshot) {
   const sourceEntries = snapshotEntries(source);
   const snapshotEntriesByPath = snapshotEntries(snapshot);

package/dist/adapters/extension/surface.js

@@ -65,11 +65,12 @@ const extensionSurface = {
     return [
       { label: "webpack", path: recipeRuntimePath(target, "webpack.log") },
       { label: "watcher", path: recipeRuntimePath(target, "recipe-harness-webpack.log") },
-      { label: "rebuild", path: recipeRuntimePath(target, "rebuild.log") }
+      { label: "rebuild", path: recipeRuntimePath(target, "rebuild.log") },
+      { label: "dapp", path: recipeRuntimePath(target, "dapp-console.log") }
     ];
   },
   appLogSource(target) {
-    return { label: "app", path: recipeRuntimePath(target, "extension-console.log") };
+    return { label: "extension", path: recipeRuntimePath(target, "extension-console.log") };
   },
   hints: {
     launch: "mm-harness launch",

package/dist/adapters/mobile/prepare.js

@@ -56,14 +56,21 @@ async function prepareMobile(target, opts = {}) {
       json,
       preflightMode
     );
-    if (confirm.status === 0) return { status: 0, output: "" };
+    if (confirm.status === 0) return startMobileConsoleForwarder(target, json);
     if (!json) {
       process.stderr.write(
         `launch: runtime looked ready but no ${platform} bridge target answered; launching the app.
 `
       );
     }
-    return dispatchActionSequence(launchActions(path.resolve(target)), target, platform, json, preflightMode);
+    const launch = await dispatchActionSequence(
+      launchActions(path.resolve(target)),
+      target,
+      platform,
+      json,
+      preflightMode
+    );
+    return launch.status === 0 ? startMobileConsoleForwarder(target, json) : launch;
   }
   if (report.decision === "unknown") {
     const msg = "mobile prepare: runtime state unknown\n  Next: run mm-harness verify --adapter mobile --target <checkout>";
@@ -111,7 +118,15 @@ async function prepareMobile(target, opts = {}) {
       }
     }
   }
-  return { status: 0, output: "" };
+  return startMobileConsoleForwarder(target, json);
+}
+function startMobileConsoleForwarder(target, json) {
+  return dispatchAction(
+    { id: "start-console-forwarder", cwd: target, argv: json ? ["--quiet"] : [] },
+    target,
+    "ios",
+    json
+  );
 }
 async function dispatchActionSequence(requestedActions, target, platform, json, preflightMode) {
   const resolved = path.resolve(target);
@@ -147,6 +162,10 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
       const extra = action.argv ?? [];
       return spawnScriptStreaming(leaf, ["--target", cwd, ...extra], target);
     }
+    case "start-console-forwarder": {
+      const leaf = path.join(runnerDir, "adapters/mobile/start-console-forwarder.sh");
+      return spawnScriptStreaming(leaf, ["--target", cwd, ...action.argv ?? []], target);
+    }
     case "prewarm-bundle": {
       const leaf = path.join(runnerDir, "adapters/mobile/prewarm-bundle.sh");
       return spawnScriptStreaming(leaf, ["--platform", platform, "--target", cwd], target);
@@ -156,10 +175,6 @@ async function dispatchAction(action, target, platform, json, preflightMode = "f
       const extra = action.argv ?? [];
       return spawnScriptStreaming(leaf, ["--target", cwd, "--platform", platform, ...extra], target);
     }
-    case "clear-metro-cache": {
-      const leaf = path.join(runnerDir, "adapters/mobile/start-metro.sh");
-      return spawnScriptStreaming(leaf, ["--target", cwd, "--clear"], target);
-    }
     case "launch-mobile-runtime": {
       const leaf = path.join(runnerDir, "adapters/mobile/open-device.sh");
       return spawnScriptStreaming(

package/dist/adapters/mobile/surface.js

@@ -47,7 +47,7 @@ const mobileSurface = {
     return [{ label: "metro", path: recipeRuntimePath(target, "metro.log") }];
   },
   appLogSource(target) {
-    return { label: "app", path: recipeRuntimePath(target, "metro.log") };
+    return { label: "app", path: recipeRuntimePath(target, "app-console.log") };
   },
   hints: {
     launch: "mm-harness launch ios",

package/dist/adapters/resolve-slot-ports.js

@@ -7,7 +7,6 @@ import {
   resolveExtensionRuntimeContext,
   resolveExtensionRuntimePorts,
   resolveSlotPortsByRepo,
-  resolveFarmslotPortsByRepo,
   resolveMobileRuntimeContext,
   resolveMobileRuntimePorts,
   resolveMobileSlotDefaults
@@ -20,7 +19,6 @@ export {
   resolveDefaultExtensionPorts,
   resolveExtensionRuntimeContext,
   resolveExtensionRuntimePorts,
-  resolveFarmslotPortsByRepo,
   resolveMobileRuntimeContext,
   resolveMobileRuntimePorts,
   resolveMobileSlotDefaults,

package/dist/adapters/slot-ports.js

@@ -105,7 +105,13 @@ function isExtensionWatcherLive(target) {
 function stopExtensionWatcher(target) {
   const runtimeAbs = path.join(path.resolve(target), recipeRuntimeDir());
   const webpackPidFile = path.join(runtimeAbs, "recipe-harness-webpack.pid");
+  const syncPidFile = path.join(runtimeAbs, "recipe-harness-webpack-sync.pid");
   const ownedPids = extensionWatcherPids(target);
+  try {
+    const syncPid = fs.readFileSync(syncPidFile, "utf8").trim();
+    if (/^\d+$/u.test(syncPid) && processAlive(Number(syncPid))) ownedPids.push(Number(syncPid));
+  } catch {
+  }
   for (const pid of ownedPids) {
     try {
       process.kill(pid, "SIGTERM");
@@ -113,6 +119,7 @@ function stopExtensionWatcher(target) {
     }
   }
   fs.rmSync(webpackPidFile, { force: true });
+  fs.rmSync(syncPidFile, { force: true });
   if (ownedPids.length > 0) {
     Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 2e3);
     for (const pid of ownedPids) {
@@ -164,6 +171,7 @@ function stopExtensionRuntime(target) {
   let removedMarkers = 0;
   for (const name of [
     "recipe-harness-webpack.pid",
+    "recipe-harness-webpack-sync.pid",
     "webpack.pid",
     "browser.pid",
     "chromium.pid",

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { detectAdapter, handleHarness } from "./harness.js";
-import { handleActions, handleManifest } from "./commands/manifest.js";
+import { handleActions } from "./commands/manifest.js";
 import { handleDoctor } from "./commands/doctor.js";
 import { handleProvision } from "./commands/provision.js";
 import { handleRuntimeHealth } from "./commands/runtime-health.js";
@@ -25,7 +25,6 @@ import { handleLast } from "./commands/last.js";
 import { parseArgs, targetPath } from "./commands/parse-args.js";
 import { runOneNode } from "./commands/run-engine.js";
 const COMMANDS = {
-  manifest: handleManifest,
   actions: handleActions,
   doctor: handleDoctor,
   "runtime-health": handleRuntimeHealth,
@@ -36,7 +35,7 @@ const COMMANDS = {
   run: handleRun,
   "self-test": handleSelfTest
 };
-const OVERLAY_COMMANDS = ["install", "verify", "cleanup", "live"];
+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) is auto-detected.
@@ -63,9 +62,6 @@ PROVE \u2014 run recipes and inspect capabilities:
                mm-harness check diff --profile fast --artifacts-dir artifacts/validation
   actions    Describe the actions a manifest declares.
                mm-harness actions --adapter mobile
-  manifest   Print/validate the action manifest for an adapter.
-               mm-harness manifest --adapter extension --json
-
 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
@@ -73,12 +69,8 @@ RUNTIME OVERLAY \u2014 install/verify/clean the per-checkout runtime overlay:
                mm-harness install                      # inside a checkout, auto-detected
   verify     Check the overlay/runtime is present and healthy (no launch).
                mm-harness verify
-  live       Launch/reuse the app, then verify live control end-to-end.
-               mm-harness live
   cleanup    Remove the installed overlay and restore the checkout.
                mm-harness cleanup
-  # Open sub-question (Arthur): keep these top-level (mm-harness install) or group
-  # them under an \`overlay\` command (mm-harness overlay install)? Top-level for now.
 
 ADVANCED \u2014 internal runtime probes (rarely typed by hand):
   runtime-health     runtime-decision   runtime-launch
@@ -89,7 +81,7 @@ ONE bin: mm-harness is the only command. No per-platform binaries \u2014 platfor
 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 docs/MENTAL-MODEL.md (overview) and docs/CLI-SPEC.md (full contract).
+See README.md for the current workflow and docs/CHEATSHEET.md for examples.
 `);
 }
 async function main(argv) {

package/dist/commands/call.js

@@ -33,6 +33,7 @@ import {
   validateRecipeAdapterAware
 } from "./run-engine.js";
 import { acquireCheckoutLock } from "../checkout-lock.js";
+import { formatRunDiagnosticsForHuman, readRunDiagnosticsDocument } from "../run-diagnostics.js";
 async function handleCall(argv) {
   if (argv.includes("--list")) {
     const { options: options2 } = parseArgs(argv, "call");
@@ -206,15 +207,19 @@ async function handleCall(argv) {
       const rendered = callOutput !== void 0 ? `
 Result:
 ${formatCallOutput(callOutput)}` : "";
-      const sideFindingTotal = result.sideFindings?.counts.total ?? 0;
       const out = (style, text) => color(style, text, { stream: process.stdout });
-      const sideFindings = sideFindingTotal > 0 ? `${out("label", "Side findings:")} REVIEW ${sideFindingTotal} distinct application warning/error event(s); see ${out("path", result.diagnosticsPath ?? "diagnostics.json")} (non-blocking)
-` : "";
+      const diagnostics = formatRunDiagnosticsForHuman(
+        readRunDiagnosticsDocument(result.diagnosticsPath),
+        adapter
+      );
+      const renderedDiagnostics = `${out("label", "Diagnostics:")}
+${diagnostics.map((line) => `  ${line}`).join("\n")}
+`;
       console.log(
         `${out("label", "call")} ${out("cmd", resolvedAction)}: ${out(result.status === "pass" ? "ok" : "err", result.status)}${rendered ? `
 ${out("label", "Result:")}
 ${formatCallOutput(callOutput)}` : ""}
-` + sideFindings + `${out("label", "Artifacts:")} ${out("path", result.artifactManifestPath)}` + (result.status === "fail" ? `
+` + renderedDiagnostics + `${out("label", "Artifacts:")} ${out("path", result.artifactManifestPath)}` + (result.status === "fail" ? `
   Next: ${failureUserAction}` : "")
       );
     }

package/dist/commands/debug.js

@@ -1,7 +1,8 @@
 import path from "node:path";
 import { runnerDir } from "../paths.js";
+import { acquireCheckoutLock } from "../checkout-lock.js";
 import { getAdapterSurface } from "../adapters/surface.js";
-import { ADAPTER_DETECT_NEXT, EXIT, flag, parseFlags, resolveAdapter, spawnScript, targetOf, usageOut } from "./shared.js";
+import { ADAPTER_DETECT_NEXT, checkoutBusyOut, EXIT, flag, parseFlags, resolveAdapter, spawnScript, targetOf, usageOut } from "./shared.js";
 const DEBUG_BOOLEANS = /* @__PURE__ */ new Set(["worker", "devMenu", "json", "noOpen"]);
 async function handleDebug(argv) {
   const { options } = parseFlags(argv, DEBUG_BOOLEANS);
@@ -31,37 +32,43 @@ async function handleDebug(argv) {
       "mm-harness debug --worker"
     );
   }
-  const openDebug = path.join(runnerDir, "adapters/shared/open-debug.mjs");
-  const debugArgs = ["--adapter", adapter];
-  if (adapter === "extension") {
-    if (process.env.CDP_PORT) debugArgs.push("--cdp-port", process.env.CDP_PORT);
-    debugArgs.push("--target", worker ? "worker" : "page");
-  } else {
-    if (process.env.WATCHER_PORT) debugArgs.push("--port", process.env.WATCHER_PORT);
-    debugArgs.push("--action", devMenu ? "dev-menu" : "debug");
-  }
-  if (json) debugArgs.push("--json");
-  if (noOpen) debugArgs.push("--no-open");
-  const result = spawnScript(process.execPath, [openDebug, ...debugArgs], target, json);
-  if (json) {
-    const leaf = parseDebugLeaf(result.output);
-    console.log(
-      JSON.stringify(
-        {
-          ...leaf,
-          schemaVersion: 1,
-          command: "debug",
-          adapter,
-          mode: worker ? "worker" : devMenu ? "dev-menu" : "default",
-          opened: leaf.opened === true,
-          exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime
-        },
-        null,
-        2
-      )
-    );
+  const lock = acquireCheckoutLock(target, "debug");
+  if ("message" in lock) return checkoutBusyOut(json, "debug", lock.message, lock.path);
+  try {
+    const openDebug = path.join(runnerDir, "adapters/shared/open-debug.mjs");
+    const debugArgs = ["--adapter", adapter];
+    if (adapter === "extension") {
+      if (process.env.CDP_PORT) debugArgs.push("--cdp-port", process.env.CDP_PORT);
+      debugArgs.push("--target", worker ? "worker" : "page");
+    } else {
+      if (process.env.WATCHER_PORT) debugArgs.push("--port", process.env.WATCHER_PORT);
+      debugArgs.push("--action", devMenu ? "dev-menu" : "debug");
+    }
+    if (json) debugArgs.push("--json");
+    if (noOpen) debugArgs.push("--no-open");
+    const result = spawnScript(process.execPath, [openDebug, ...debugArgs], target, json);
+    if (json) {
+      const leaf = parseDebugLeaf(result.output);
+      console.log(
+        JSON.stringify(
+          {
+            ...leaf,
+            schemaVersion: 1,
+            command: "debug",
+            adapter,
+            mode: worker ? "worker" : devMenu ? "dev-menu" : "default",
+            opened: leaf.opened === true,
+            exitCode: result.status === 0 ? EXIT.ok : EXIT.runtime
+          },
+          null,
+          2
+        )
+      );
+    }
+    return result.status === 0 ? EXIT.ok : EXIT.runtime;
+  } finally {
+    lock.release();
   }
-  return result.status === 0 ? EXIT.ok : EXIT.runtime;
 }
 function parseDebugLeaf(output) {
   try {

package/dist/commands/fixtures.js

@@ -56,6 +56,14 @@ async function handleFixturesLocked(argv, deps) {
   if (sub !== "init" && sub !== "sync" && sub !== "set" && sub !== "generate" && sub !== "finalize") {
     return usageOut(json, "fixtures", "fixtures requires a subcommand: mm-harness fixtures <init|sync|set|generate|finalize>", "mm-harness fixtures init --from <path>   or   mm-harness fixtures init --dev");
   }
+  if (sub !== "init" && (flag(options, "dev") || flag(options, "force") || str(options, "from"))) {
+    return usageOut(
+      json,
+      "fixtures",
+      "--dev, --from, and --force belong to fixtures init; they do not apply a fixture.",
+      "mm-harness fixtures init --dev && mm-harness fixtures set"
+    );
+  }
   const target = targetOf(options);
   const adapter = resolveAdapter(options, target);
   if (!adapter) {
@@ -96,6 +104,14 @@ async function handleFixturesLocked(argv, deps) {
     return exitCode;
   }
   const fixturePath = path.resolve(str(options, "fixture") ?? process.env.RECIPE_WALLET_FIXTURE ?? canonicalFixture);
+  if (!fs.existsSync(fixturePath)) {
+    return usageOut(
+      json,
+      "fixtures",
+      `no wallet fixture at ${fixturePath}.`,
+      "mm-harness fixtures init --dev && mm-harness fixtures set"
+    );
+  }
   process.stderr.write(`\u2192 fixtures set ${adapter} \u2014 connecting bridge + applying wallet fixture (can take ~30s)\u2026
 `);
   let status;
@@ -129,14 +145,6 @@ async function handleFixturesLocked(argv, deps) {
       console.error(`  Next: ${retryHint}`);
     }
   } else {
-    if (!fs.existsSync(fixturePath)) {
-      return usageOut(
-        json,
-        "fixtures",
-        `no wallet fixture at ${fixturePath}.`,
-        "create it (or pass --fixture <path>), then re-run: mm-harness fixtures set"
-      );
-    }
     const previousFixtureEnv = process.env.RECIPE_WALLET_FIXTURE;
     process.env.RECIPE_WALLET_FIXTURE = fixturePath;
     try {
@@ -150,7 +158,7 @@ async function handleFixturesLocked(argv, deps) {
       console.error(`  Next: ${retryHint}`);
     }
   }
-  const teaching = `Wallet fixture applied.  Want different accounts? Edit: ${canonicalFixture}`;
+  const teaching = status === "pass" ? `Wallet fixture applied.  Want different accounts? Edit: ${canonicalFixture}` : "Wallet fixture was not applied.";
   if (json) {
     console.log(
       JSON.stringify(
@@ -174,7 +182,7 @@ async function handleFixturesLocked(argv, deps) {
         2
       )
     );
-  } else {
+  } else if (status === "pass") {
     console.error(teaching);
   }
   return status === "pass" ? EXIT.ok : EXIT.runtime;

package/dist/commands/launch/index.js

@@ -35,6 +35,7 @@ import { launchMobile } from "./mobile.js";
 import { applyDeviceTargeting } from "../device-target.js";
 import { acquireCheckoutLock } from "../../checkout-lock.js";
 import { JsonStreamWriter } from "../../json-stream.js";
+import { ensureExtensionConsoleCapture } from "../../adapters/extension/console-capture.js";
 const LAUNCH_BOOLEANS = /* @__PURE__ */ new Set([
   "build",
   "watch",
@@ -427,6 +428,15 @@ async function finishLaunch(jsonOutput, machine, stream, adapter, mobileTarget,
       });
     }
   }
+  if (adapter === "extension") {
+    try {
+      await ensureExtensionConsoleCapture(target);
+    } catch (error) {
+      if (!machine) {
+        console.error(`WARN: Extension console capture unavailable: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
+  }
   if (wantVerify) {
     stream.phase("verify");
     const verifyArgs = ["verify", "--adapter", adapter, "--target", target];

package/dist/commands/logs.js

@@ -19,9 +19,10 @@ async function handleLogs(argv) {
   const logSources = surface.logSources(target);
   const appLogSource = surface.appLogSource(target);
   const sourceLabels = logSources.map((entry) => entry.label);
-  const defaultSource = sourceLabels[0];
+  const appSourceLabel = appLogSource?.label ?? "app";
+  const defaultSource = appLogSource && appSourceLabel !== "app" ? appSourceLabel : sourceLabels[0];
   const source = str(options, "source") ?? defaultSource;
-  const validSources = [...sourceLabels, ...appLogSource ? ["app"] : []];
+  const validSources = [...sourceLabels, ...appLogSource ? [appSourceLabel] : [], ...appLogSource && appSourceLabel !== "app" ? ["app"] : []];
   if (!validSources.includes(source)) {
     return usageOut(json, "logs", `--source must be one of: ${validSources.join(", ")}.`, `mm-harness logs --source ${defaultSource}`);
   }
@@ -32,11 +33,12 @@ async function handleLogs(argv) {
     }
     process.env.RECIPE_LOG_EVENTS = events;
   }
-  const requested = source === "app" ? appLogSource : logSources.find((entry) => entry.label === source);
-  const ordered = source === "app" ? requested ? [requested] : [] : requested ? [requested, ...logSources.filter((entry) => entry !== requested)] : logSources;
+  const isAppSource = source === "app" || source === appSourceLabel;
+  const requested = isAppSource ? appLogSource : logSources.find((entry) => entry.label === source);
+  const ordered = isAppSource ? requested ? [requested] : [] : requested ? [requested] : logSources;
   const logFile = ordered.find((entry) => fs.existsSync(entry.path))?.path;
   if (!logFile) {
-    if (source === "app" && appLogSource) {
+    if (isAppSource && appLogSource) {
       const message = `application console unavailable for this checkout (${path.basename(appLogSource.path)} is absent).`;
       const userAction = surface.hints.launch;
       if (json) {
@@ -55,7 +57,7 @@ async function handleLogs(argv) {
       }
       return EXIT.runtime;
     }
-    const names = source === "app" && appLogSource ? path.basename(appLogSource.path) : logSources.map((entry) => path.basename(entry.path)).join(" / ");
+    const names = isAppSource && appLogSource ? path.basename(appLogSource.path) : logSources.map((entry) => path.basename(entry.path)).join(" / ");
     return usageOut(
       json,
       "logs",

package/dist/commands/manifest.js

@@ -1,25 +1,14 @@
 import { loadActionManifest, validateManifest } from "../manifest.js";
 import { EXIT } from "./shared.js";
-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;
-}
+import { isRecord, optionFlag, optionString, resolveAdapter } from "./parse-args.js";
 async function handleActions({ options, positional }) {
   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();
@@ -226,7 +215,6 @@ export {
   findRelatedActions,
   fuzzyResolveActions,
   handleActions,
-  handleManifest,
   searchActions,
   summarizeActionCategories
 };

package/dist/commands/run-engine.js

@@ -200,12 +200,7 @@ function libraryRecipeNames(adapter) {
   return [...new Set(names)].sort();
 }
 function recipeNameCandidates(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)];
+  return singleRecipeNameCandidates(recipeArg, adapter);
 }
 function singleRecipeNameCandidates(name, adapter) {
   if (name.endsWith(".recipe.json")) {
@@ -231,32 +226,6 @@ 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);

package/dist/commands/run-report.js

@@ -34,7 +34,7 @@ function renderRunReport(summary, entries) {
     lines.push(
       "",
       "## Side findings",
-      `- REVIEW ${sideFindingTotal} distinct application warning/error event(s); see diagnostics.json (non-blocking)`
+      `- REVIEW ${sideFindingTotal} distinct application warning/error event(s) (non-blocking; expanded below and stored in diagnostics.json)`
     );
   }
   lines.push("", "## Steps");

package/dist/commands/run.js

@@ -31,6 +31,7 @@ import { coreDependencyBlock } from "./core-readiness.js";
 import { writeRunReport } from "./run-report.js";
 import { acquireCheckoutLock } from "../checkout-lock.js";
 import { JsonStreamWriter } from "../json-stream.js";
+import { formatRunDiagnosticsForHuman, readRunDiagnosticsDocument } from "../run-diagnostics.js";
 async function handleRun(parsed) {
   const stream = new JsonStreamWriter("run", optionFlag(parsed.options, "jsonStream"));
   const restoreStdout = stream.isolateStdout();
@@ -211,15 +212,61 @@ async function handleRunInner({ positional, options }, stream) {
         console.log(out("label", "summary:"));
         for (const line of report.preview) console.log(`  ${formatPreviewLine(line, out)}`);
       }
-      console.log(`${out("label", "report:")} ${out("path", report.path)}`);
-      console.log(`${out("label", "artifacts:")} ${out("path", result.artifactManifestPath)}`);
-      if (result.status === "fail") console.error(`  Next: ${failureUserAction}`);
+      const artifacts = runArtifactInventory(result.artifactManifestPath);
+      console.log(out("label", `artifacts (${artifacts.length}):`));
+      for (const artifact of artifacts) {
+        console.log(`  ${out("dim", `${artifact.label}:`)} ${out("path", artifact.absolutePath)}`);
+      }
+      if (result.status === "fail") {
+        console.error(`  Next: ${failureUserAction}`);
+      }
+      console.log(out("label", "diagnostics:"));
+      const diagnostics = readRunDiagnosticsDocument(result.diagnosticsPath);
+      for (const line of formatRunDiagnosticsForHuman(diagnostics, adapter)) {
+        console.log(`  ${formatDiagnosticLine(line, out)}`);
+      }
     }
     return exitCode;
   } finally {
     lock.release();
   }
 }
+function formatDiagnosticLine(line, out) {
+  const match = /^(CLEAN|REVIEW|UNAVAILABLE|N\/A|WARNING|ERROR|EXCEPTION)(.*)$/u.exec(line);
+  if (!match) return line;
+  const status = match[1];
+  const style = status === "CLEAN" ? "ok" : status === "ERROR" || status === "EXCEPTION" ? "err" : "warn";
+  return `${out(style, status)}${match[2]}`;
+}
+function runArtifactInventory(manifestPathValue) {
+  const manifestPath = path.resolve(String(manifestPathValue));
+  const root = path.dirname(manifestPath);
+  let manifest;
+  try {
+    manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+  } catch {
+    return [{ absolutePath: manifestPath, basename: path.basename(manifestPath), label: "Artifact manifest" }];
+  }
+  const entries = isRecord(manifest) && Array.isArray(manifest.artifacts) ? manifest.artifacts : [];
+  const artifacts = [];
+  for (const entry of entries) {
+    if (!isRecord(entry) || typeof entry.path !== "string" || entry.path.length === 0) continue;
+    const absolutePath = path.resolve(root, entry.path);
+    const basename = path.basename(absolutePath);
+    const label = typeof entry.label === "string" && entry.label.length > 0 ? entry.label : basename;
+    artifacts.push({ absolutePath, basename, label });
+  }
+  artifacts.push({ absolutePath: manifestPath, basename: path.basename(manifestPath), label: "Artifact manifest" });
+  const priority = /* @__PURE__ */ new Map([
+    ["diagnostics.json", 0],
+    ["report.md", 1],
+    ["summary.json", 2],
+    ["trace.json", 3],
+    ["recipe.json", 4],
+    ["artifact-manifest.json", 100]
+  ]);
+  return artifacts.filter((artifact, index, all) => all.findIndex((candidate) => candidate.absolutePath === artifact.absolutePath) === index).sort((left, right) => (priority.get(left.basename) ?? 50) - (priority.get(right.basename) ?? 50));
+}
 function formatPreviewLine(line, out) {
   const match = /^(PASS|FAIL)\s+(.+)$/u.exec(line);
   if (!match) return line;

package/dist/commands/status-probe.js

@@ -34,7 +34,7 @@ function parseBridgeEntries(raw) {
     deviceName: typeof e.deviceName === "string" ? e.deviceName : "",
     platform: typeof e.platform === "string" ? e.platform : "",
     // agenticPresent is only set when the bridge explicitly sends it (false = absent).
-    // Omitted by older bridge versions → leave undefined so caller treats as present.
+    // An omitted value remains unknown.
     ...typeof e.agenticPresent === "boolean" ? { agenticPresent: e.agenticPresent } : {}
   }));
 }