@deeeed/metamask-harness 0.17.4 → 0.17.5

package/dist/adapters/mobile/perps-env.js

@@ -1,4 +1,3 @@
-import { randomUUID } from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
 const DEFAULTS = {
@@ -25,53 +24,14 @@ function ensureMobilePerpsEnvironment(target) {
     (key) => settingForKey(current, key).status === "missing"
   );
   if (missing.length === 0) return [];
-  const file = path.join(fs.realpathSync(target), current.file);
-  const snapshot = readEnvironmentSnapshot(file);
-  const before = snapshot?.text ?? "";
+  const file = path.join(target, current.file);
+  const before = current.fileExists ? fs.readFileSync(file, "utf8") : "";
   const separator = before.length > 0 && !before.endsWith("\n") ? "\n" : "";
   const additions = missing.map((key) => `export ${key}="${DEFAULTS[key]}"`).join("\n");
-  const temporary = `${file}.${process.pid}.${randomUUID()}.tmp`;
-  let descriptor = null;
-  try {
-    descriptor = fs.openSync(
-      temporary,
-      fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL,
-      snapshot?.mode ?? 384
-    );
-    fs.writeFileSync(descriptor, `${before}${separator}${additions}
+  fs.writeFileSync(file, `${before}${separator}${additions}
 `);
-    if (snapshot) fs.fchmodSync(descriptor, snapshot.mode);
-    fs.closeSync(descriptor);
-    descriptor = null;
-    fs.renameSync(temporary, file);
-  } finally {
-    if (descriptor !== null) fs.closeSync(descriptor);
-    fs.rmSync(temporary, { force: true });
-  }
   return missing;
 }
-function readEnvironmentSnapshot(file) {
-  let descriptor;
-  try {
-    descriptor = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
-  } catch (error) {
-    const code = error.code;
-    if (code === "ENOENT") return null;
-    if (code === "ELOOP") {
-      throw new Error(`.js.env must not be a symbolic link. Next: replace ${file} with a regular file.`);
-    }
-    throw error;
-  }
-  try {
-    const stat = fs.fstatSync(descriptor);
-    if (!stat.isFile()) {
-      throw new Error(`.js.env must be a regular file. Next: replace ${file} with a regular file.`);
-    }
-    return { text: fs.readFileSync(descriptor, "utf8"), mode: stat.mode & 511 };
-  } finally {
-    fs.closeSync(descriptor);
-  }
-}
 function readSetting(source, key) {
   const assignment = new RegExp(`^\\s*(?:export\\s+)?${key}\\s*=(.*)$`, "u");
   let value = null;

package/dist/adapters/mobile/prepare.js

@@ -56,21 +56,14 @@ async function prepareMobile(target, opts = {}) {
       json,
       preflightMode
     );
-    if (confirm.status === 0) return startMobileConsoleForwarder(target, platform, json);
+    if (confirm.status === 0) return { status: 0, output: "" };
     if (!json) {
       process.stderr.write(
         `launch: runtime looked ready but no ${platform} bridge target answered; launching the app.
 `
       );
     }
-    const launch = await dispatchActionSequence(
-      launchActions(path.resolve(target)),
-      target,
-      platform,
-      json,
-      preflightMode
-    );
-    return launch.status === 0 ? startMobileConsoleForwarder(target, platform, json) : launch;
+    return dispatchActionSequence(launchActions(path.resolve(target)), target, platform, json, preflightMode);
   }
   if (report.decision === "unknown") {
     const msg = "mobile prepare: runtime state unknown\n  Next: run mm-harness verify --adapter mobile --target <checkout>";
@@ -118,15 +111,7 @@ async function prepareMobile(target, opts = {}) {
       }
     }
   }
-  return startMobileConsoleForwarder(target, platform, json);
-}
-function startMobileConsoleForwarder(target, platform, json) {
-  return dispatchAction(
-    { id: "start-console-forwarder", cwd: target, argv: json ? ["--quiet"] : [] },
-    target,
-    platform,
-    json
-  );
+  return { status: 0, output: "" };
 }
 async function dispatchActionSequence(requestedActions, target, platform, json, preflightMode) {
   const resolved = path.resolve(target);
@@ -162,10 +147,6 @@ 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);
@@ -175,6 +156,10 @@ 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/source-freshness.js

@@ -20,47 +20,32 @@ const SOURCE_PATHS = [
 const ENV_INPUTS = [".js.env", ".env", ".env.local"];
 const BASELINE_FILE = "mobile-source-baseline.json";
 function mobileSourceFingerprint(target) {
-  try {
-    const hash = createHash("sha256");
-    hash.update(git(target, ["rev-parse", "HEAD"]));
-    hash.update(git(target, ["diff", "--no-ext-diff", "--binary", "HEAD", "--", ...SOURCE_PATHS]));
-    const untracked = git(target, [
-      "ls-files",
-      "--others",
-      "--exclude-standard",
-      "-z",
-      "--",
-      ...SOURCE_PATHS
-    ]).toString("utf8").split("\0").filter(Boolean).sort();
-    for (const relative of untracked) {
-      hash.update(`untracked\0${relative}\0`);
-      hash.update(fs.readFileSync(path.join(target, relative)));
-      hash.update("\0");
-    }
-    for (const relative of ENV_INPUTS) {
-      const absolute = path.join(target, relative);
-      hash.update(`env\0${relative}\0`);
-      hash.update(fs.existsSync(absolute) ? fs.readFileSync(absolute) : "<absent>");
-      hash.update("\0");
-    }
-    return { status: "ok", fingerprint: hash.digest("hex") };
-  } catch {
-    const resolved = path.resolve(target);
-    return {
-      fingerprint: null,
-      status: "unavailable",
-      error: {
-        code: "MOBILE_SOURCE_UNAVAILABLE",
-        message: `Mobile source fingerprint requires a readable Git checkout and source inputs: ${resolved}`,
-        userAction: "mm-harness doctor --adapter mobile --target <metamask-mobile-checkout>"
-      }
-    };
+  const hash = createHash("sha256");
+  hash.update(git(target, ["rev-parse", "HEAD"]));
+  hash.update(git(target, ["diff", "--no-ext-diff", "--binary", "HEAD", "--", ...SOURCE_PATHS]));
+  const untracked = git(target, [
+    "ls-files",
+    "--others",
+    "--exclude-standard",
+    "-z",
+    "--",
+    ...SOURCE_PATHS
+  ]).toString("utf8").split("\0").filter(Boolean).sort();
+  for (const relative of untracked) {
+    hash.update(`untracked\0${relative}\0`);
+    hash.update(fs.readFileSync(path.join(target, relative)));
+    hash.update("\0");
+  }
+  for (const relative of ENV_INPUTS) {
+    const absolute = path.join(target, relative);
+    hash.update(`env\0${relative}\0`);
+    hash.update(fs.existsSync(absolute) ? fs.readFileSync(absolute) : "<absent>");
+    hash.update("\0");
   }
+  return hash.digest("hex");
 }
 function mobileSourceCheck(target) {
-  const result = mobileSourceFingerprint(target);
-  if (result.status === "unavailable") return result;
-  const { fingerprint } = result;
+  const fingerprint = mobileSourceFingerprint(target);
   const baseline = readBaseline(target);
   return {
     fingerprint,
@@ -68,7 +53,7 @@ function mobileSourceCheck(target) {
   };
 }
 function recordMobileSourceBaseline(target, expectedFingerprint) {
-  if (mobileSourceFingerprint(target).fingerprint !== expectedFingerprint) return false;
+  if (mobileSourceFingerprint(target) !== expectedFingerprint) return false;
   const marker = recipeRuntimePath(target, BASELINE_FILE);
   const temporary = `${marker}.${process.pid}.${Date.now()}.tmp`;
   const baseline = {
@@ -80,9 +65,9 @@ function recordMobileSourceBaseline(target, expectedFingerprint) {
   try {
     fs.writeFileSync(temporary, `${JSON.stringify(baseline, null, 2)}
 `, { mode: 384 });
-    if (mobileSourceFingerprint(target).fingerprint !== expectedFingerprint) return false;
+    if (mobileSourceFingerprint(target) !== expectedFingerprint) return false;
     fs.renameSync(temporary, marker);
-    if (mobileSourceFingerprint(target).fingerprint !== expectedFingerprint) {
+    if (mobileSourceFingerprint(target) !== expectedFingerprint) {
       if (readBaseline(target)?.fingerprint === expectedFingerprint) fs.rmSync(marker, { force: true });
       return false;
     }

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, "app-console.log") };
+    return { label: "app", path: recipeRuntimePath(target, "metro.log") };
   },
   hints: {
     launch: "mm-harness launch ios",

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

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

package/dist/adapters/slot-ports.js

@@ -105,32 +105,17 @@ 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");
-    } catch {
-    }
     try {
       process.kill(pid, "SIGTERM");
     } catch {
     }
   }
   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) {
-      try {
-        process.kill(-pid, "SIGKILL");
-      } catch {
-      }
       try {
         process.kill(pid, "SIGKILL");
       } catch {
@@ -179,7 +164,6 @@ 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/adapters.js

@@ -287,15 +287,8 @@ async function handleMobileNavigate(payload, context) {
   return isRecord(live.result) ? { ...live.result, liveAdapter: live.script } : live.result;
 }
 async function handleMobilePress(payload, context) {
-  const identifiers = ["test_id", "testID", "selector"].map((field) => optionalScalarText(payload[field], `ui.press.${field}`)).filter((value) => value !== void 0);
-  const text = optionalScalarText(payload.text, "ui.press.text");
-  if (identifiers.length + Number(text !== void 0) !== 1) {
-    throw new Error("ui.press requires exactly one of: test_id, testID, selector, text.");
-  }
-  const target = text ?? identifiers[0];
-  if (target.trim() === "") throw new Error("ui.press target must be non-empty.");
-  const input = mobileUiInput(context, "press", payload);
-  return text !== void 0 ? bridgeCommand(input, ["press-text", target]) : bridgeCommand(input, ["press-test-id", target]);
+  const target = firstScalarText(payload, ["test_id", "testID", "selector", "text"], "ui.press");
+  return bridgeCommand(mobileUiInput(context, "press", payload), ["press-test-id", target]);
 }
 async function handleMobileSetInput(payload, context) {
   const input = mobileUiInput(context, "set_input", payload);
@@ -472,12 +465,12 @@ function createMetaMaskUiTransport(platform, harness) {
         if (live) return live.output;
         throw new Error(`ui.navigate requires library/actions/${platform}/ui/navigate.mjs.`);
       }
-      return base.execute(action, action === "ui.wait_for" ? normalizeUiWaitNode(node, platform) : node, context);
+      return base.execute(action, action === "ui.wait_for" ? normalizeUiWaitNode(node) : node, context);
     }
   };
 }
-function normalizeUiWaitNode(node, adapter) {
-  if (adapter !== "extension" || node.expected !== void 0 || typeof node.visible !== "boolean") return node;
+function normalizeUiWaitNode(node) {
+  if (node.expected !== void 0 || typeof node.visible !== "boolean") return node;
   return { ...node, expected: node.visible ? "visible" : "absent" };
 }
 function createMetaMaskAdapters(adapter) {

package/dist/cli-commands.js

@@ -15,7 +15,7 @@ const SPEC = {
     { name: "logs", aliases: ["tail"], desc: "Compact build events or full log", flags: ["--full", "-f", "--window", "--events", "--source", "--json"] },
     { name: "debug", aliases: ["devtools", "inspect"], desc: "Open DevTools UI", flags: ["--json", "--no-open"] },
     { name: "fixtures", desc: "Manage the canonical wallet fixture (sync/set/generate)", args: ["sync", "set", "generate"], flags: ["--fixture", "--out", "--adapter", "--target", "--device", "--json"] },
-    { name: "actions", desc: "List runnable recipe actions", flags: ["--json", "--categories", "--category", "--action"] },
+    { name: "actions", desc: "List runnable recipe actions", flags: ["--json"] },
     { name: "doctor", desc: "Check harness/orchestration health", flags: ["--json", "--target", "--adapter", "--runtime-dir", "--expect-live", "--print-ready", "--cdp-port", "--device"] },
     { name: "run", desc: "Execute a proof recipe (path or library name, e.g. run perps.smoke)", args: ["recipe.json|name"], flags: ["--list", "--device"] },
     { name: "recipe-quality", desc: "Build the recipe-quality artifact from compact JSON", args: ["build"], flags: ["--input", "--output", "--json"] },

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { detectAdapter, handleHarness } from "./harness.js";
-import { handleActions } from "./commands/manifest.js";
+import { handleActions, handleManifest } from "./commands/manifest.js";
 import { handleDoctor } from "./commands/doctor.js";
 import { handleProvision } from "./commands/provision.js";
 import { handleRuntimeHealth } from "./commands/runtime-health.js";
@@ -21,10 +21,10 @@ import { handleRecipeQuality } from "./commands/recipe-quality.js";
 import { handleStatus } from "./commands/status.js";
 import { handleCheck } from "./commands/check.js";
 import { handleChecklist } from "./commands/checklist.js";
-import { 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,
@@ -35,7 +35,7 @@ const COMMANDS = {
   run: handleRun,
   "self-test": handleSelfTest
 };
-const OVERLAY_COMMANDS = ["install", "verify", "cleanup"];
+const OVERLAY_COMMANDS = ["install", "verify", "cleanup", "live"];
 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.
@@ -62,6 +62,9 @@ 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
@@ -69,8 +72,12 @@ 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
@@ -81,7 +88,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 README.md for the current workflow and docs/CHEATSHEET.md for examples.
+See docs/MENTAL-MODEL.md (overview) and docs/CLI-SPEC.md (full contract).
 `);
 }
 async function main(argv) {
@@ -104,7 +111,7 @@ async function main(argv) {
         const target = targetPath(options);
         const adapterRaw = (typeof options["adapter"] === "string" ? options["adapter"] : void 0) ?? (typeof options["platform"] === "string" ? options["platform"] : void 0) ?? detectAdapter(target);
         if (adapterRaw === "mobile" || adapterRaw === "extension" || adapterRaw === "core") {
-          await handleHarness(["install", "--platform", adapterRaw, "--target", target, "--quiet"]);
+          await handleHarness(["install", "--platform", adapterRaw, "--target", target]);
         }
       } catch {
       }
@@ -126,7 +133,6 @@ async function main(argv) {
   if (command === "recipe-quality") return handleRecipeQuality(argv.slice(1));
   if (command === "check") return handleCheck(argv.slice(1));
   if (command === "checklist") return handleChecklist(argv.slice(1));
-  if (command === "last") return handleLast(parseArgs(argv.slice(1), command));
   const handler = COMMANDS[command];
   if (!handler) throw new Error(`Unknown command: ${command}`);
   return handler(parseArgs(argv.slice(1), command));

package/dist/commands/call.js

@@ -6,7 +6,7 @@ import { loadActionManifest } from "../manifest.js";
 import { importRecipeProtocol } from "../paths.js";
 import { recipeRunning } from "../heal-bounds.js";
 import { color } from "../cli-color.js";
-import { checkoutBusyOut, EXIT, usageOut } from "./shared.js";
+import { EXIT } from "./shared.js";
 import { describeManifestActions, fuzzyResolveActions } from "./manifest.js";
 import {
   parseArgs,
@@ -15,7 +15,6 @@ import {
   optionString,
   resolveAdapter,
   runtimeOptionsFromCli,
-  shellQuote,
   usageError
 } from "./parse-args.js";
 import { getAdapterSurface } from "../adapters/surface.js";
@@ -33,7 +32,6 @@ 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");
@@ -61,42 +59,25 @@ async function handleCall(argv) {
     }
     const message = `call requires <action>. Example: ${example}`;
     const userAction = `${example}   # see the vocabulary: ${discovery}`;
-    if (json) console.log(JSON.stringify({
-      schemaVersion: 1,
-      command: "call",
-      status: "fail",
-      error: { code: "CLI_MISSING_POSITIONAL", message, userAction },
-      exitCode: EXIT.usage
-    }, null, 2));
+    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", error: { code: "USAGE", message, userAction } }, null, 2));
     else console.error(`${message}
   See the vocabulary: ${discovery}`);
     return EXIT.usage;
   }
   const { adapter, target } = resolveAdapter(options);
-  if (!fs.existsSync(target)) {
-    return usageOut(
-      json,
-      "call",
-      `target does not exist: ${target}`,
-      "pass --target <metamask-checkout> pointing to an existing checkout"
-    );
-  }
   getAdapterSurface(adapter).resolveSlotPorts(target);
   const dtResult = applyDeviceTargeting("call", adapter, options, { gate: true, rerun: "" });
   if ("code" in dtResult) {
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, error: { code: dtResult.code, message: dtResult.message, userAction: dtResult.userAction } }, null, 2));
-    else console.error(`\u2717 call: ${dtResult.message}
-  Next: ${dtResult.userAction}`);
+    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, error: { code: dtResult.code, message: dtResult.message } }, null, 2));
+    else console.error(`\u2717 call: ${dtResult.message}`);
     return EXIT.usage;
   }
   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 ${shellQuote(target)} --json; retry after the active recipe finishes`;
     if (json) {
-      console.log(JSON.stringify({ schemaVersion: 1, command: "call", status: "fail", recoverable: false, error: { code: "RECIPE_RUNNING", message: msg, userAction } }, null, 2));
+      console.log(JSON.stringify({ schemaVersion: 1, command: "call", status: "fail", recoverable: false, error: { code: "RECIPE_RUNNING", message: msg } }, null, 2));
     } else {
-      console.error(`\u2717 mm-harness call: ${msg}
-  Next: ${userAction}`);
+      console.error(`\u2717 mm-harness call: ${msg}`);
     }
     return EXIT.bounded;
   }
@@ -106,19 +87,16 @@ async function handleCall(argv) {
   const names = getRecipeActionManifestActionNames(manifest);
   const resolution = resolveActionName(shortName, names);
   if (resolution.status === "unknown") {
-    const message = `unknown action "${shortName}" for the ${adapter} adapter.`;
-    const userAction = `mm-harness actions --adapter ${adapter} --json`;
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, error: { code: "ACTION_UNKNOWN", message, userAction } }, null, 2));
-    else console.error(`\u2717 call: ${message}
-  Next: ${userAction}`);
+    const message = `\u2717 call: unknown action "${shortName}" for the ${adapter} adapter.
+  See the vocabulary: mm-harness actions --adapter ${adapter} --json`;
+    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, error: { code: "ACTION_UNKNOWN", message } }, null, 2));
+    else console.error(message);
     return EXIT.usage;
   }
   if (resolution.status === "ambiguous") {
-    const message = `"${shortName}" is ambiguous: ${resolution.candidates.join(", ")} \u2014 use the full name.`;
-    const userAction = `mm-harness actions --action ${resolution.candidates[0]} --adapter ${adapter} --json`;
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, error: { code: "ACTION_AMBIGUOUS", message, candidates: resolution.candidates, userAction } }, null, 2));
-    else console.error(`\u2717 call: ${message}
-  Next: ${userAction}`);
+    const message = `\u2717 call: "${shortName}" is ambiguous: ${resolution.candidates.join(", ")} \u2014 use the full name.`;
+    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, error: { code: "ACTION_AMBIGUOUS", message, candidates: resolution.candidates } }, null, 2));
+    else console.error(message);
     return EXIT.usage;
   }
   const resolvedAction = resolution.resolved;
@@ -135,19 +113,19 @@ async function handleCall(argv) {
   const recipe = synthesizeOneNodeRecipe(resolvedAction, args);
   const validation = await validateRecipeAdapterAware(recipe, manifest);
   if (validation.status === "invalid") {
-    const message = `call ${resolvedAction}: recipe validation failed`;
-    const userAction = `mm-harness actions --action ${resolvedAction} --adapter ${adapter} --json`;
-    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, resolvedAction, args, findings: validation.findings, error: { code: "RECIPE_VALIDATION_FAILED", message, userAction } }, null, 2));
+    const message = `\u2717 call ${resolvedAction}: recipe validation failed`;
+    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", adapter, action: shortName, resolvedAction, args, findings: validation.findings, error: { code: "RECIPE_VALIDATION_FAILED", message } }, null, 2));
     else {
-      console.error(`\u2717 ${message}`);
+      console.error(message);
       for (const finding of validation.findings) console.error(`  ${finding.code} ${finding.path} \u2014 ${finding.message}`);
-      console.error(`  Next: ${userAction}`);
     }
     return EXIT.validation;
   }
   const lock = acquireCheckoutLock(target, "call");
   if ("message" in lock) {
-    return checkoutBusyOut(json, "call", lock.message, lock.path);
+    if (json) console.log(JSON.stringify({ schemaVersion: 1, command: "call", status: "fail", recoverable: false, error: { code: "SANDBOX_BUSY", message: lock.message } }, null, 2));
+    else console.error(`\u2717 mm-harness call: ${lock.message}`);
+    return EXIT.bounded;
   }
   try {
     const prepared = await prepareHeal(adapter, target, options, json, {
@@ -176,7 +154,6 @@ async function handleCall(argv) {
     );
     if (violation !== null) return emitHealViolation(json, "call", result, violation, state, adapter);
     const callOutput = readCallOutput(result.tracePath);
-    const failureUserAction = `mm-harness last --target ${shellQuote(target)} --json`;
     if (json) {
       console.log(
         JSON.stringify(
@@ -191,13 +168,10 @@ async function handleCall(argv) {
             summaryPath: result.summaryPath,
             tracePath: result.tracePath,
             artifactManifestPath: result.artifactManifestPath,
-            ...result.diagnosticsPath ? { diagnosticsPath: result.diagnosticsPath } : {},
-            ...result.sideFindings ? { sideFindings: result.sideFindings } : {},
             ...callOutput !== void 0 ? { output: callOutput } : {},
             recovered: state.recovered,
             mutations: state.mutations,
-            exitCode: result.status === "pass" ? EXIT.ok : EXIT.runtime,
-            ...result.status === "fail" ? { error: { code: "ACTION_EXECUTION_FAILED", message: `${resolvedAction} failed; inspect the persisted result and evidence paths`, userAction: failureUserAction } } : {}
+            exitCode: result.status === "pass" ? EXIT.ok : EXIT.runtime
           },
           null,
           2
@@ -208,19 +182,11 @@ async function handleCall(argv) {
 Result:
 ${formatCallOutput(callOutput)}` : "";
       const out = (style, text) => color(style, text, { stream: process.stdout });
-      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)}` : ""}
-` + renderedDiagnostics + `${out("label", "Artifacts:")} ${out("path", result.artifactManifestPath)}` + (result.status === "fail" ? `
-  Next: ${failureUserAction}` : "")
+${out("label", "Artifacts:")} ${out("path", result.artifactManifestPath)}`
       );
     }
     return result.status === "pass" ? EXIT.ok : EXIT.runtime;
@@ -354,7 +320,7 @@ function parseCallValue(value) {
     const number = Number(value);
     if (Number.isFinite(number)) return number;
   }
-  if (value.startsWith("[") && value.endsWith("]") || value.startsWith("{") && value.endsWith("}") || value.startsWith('"') && value.endsWith('"')) {
+  if (value.startsWith("[") && value.endsWith("]") || value.startsWith("{") && value.endsWith("}")) {
     try {
       return JSON.parse(value);
     } catch {

package/dist/commands/check.js

@@ -3,7 +3,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { detectAdapter } from "../harness.js";
 import { EXIT, usageOut } from "./shared.js";
-import { optionFlag, optionString, parseArgs, shellQuote } from "./parse-args.js";
+import { optionFlag, optionString, parseArgs } from "./parse-args.js";
 const USAGE = "mm-harness check diff [--fix] [--target <repo>] [--adapter mobile|extension|core] [--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;
@@ -111,7 +111,6 @@ async function handleCheck(argv) {
   const status = [...fixes, ...checks].some((check) => check.status === "fail") ? "fail" : "pass";
   const exitCode = status === "pass" ? EXIT.ok : EXIT.validation;
   const guidance = policyFailed ? ["Remove the newly added eslint-disable directive(s). Fix the underlying violation with existing named styles, project tokens, or another established source pattern; then rerun mm-harness check diff [--fix]. Other checks were skipped until this policy failure is removed."] : checks.some((check) => check.id === "eslint" && check.status === "fail") ? ["Fix the reported violations in changed source using existing project patterns and tokens; do not suppress rules, hide violations behind indirection, weaken configuration, or bypass check diff. Then rerun mm-harness check diff [--fix]."] : [];
-  const failureUserAction = guidance[0] ?? `inspect ${path.join(artifactsDir, "validation-summary.json")}, fix the failing check, then retry: mm-harness check diff --target ${shellQuote(target)} --base ${shellQuote(baseRef)} --profile ${profile} --json`;
   const summary = {
     schemaVersion: 1,
     command: "check",
@@ -130,7 +129,6 @@ async function handleCheck(argv) {
     fixes,
     checks,
     guidance,
-    ...status === "fail" ? { error: { code: "CHECK_DIFF_FAILED", message: "one or more bounded checks failed", userAction: failureUserAction } } : {},
     artifacts: {
       dir: artifactsDir,
       summaryJson: path.join(artifactsDir, "validation-summary.json"),
@@ -520,14 +518,10 @@ function renderHuman(summary) {
     if (check.status === "fail" && check.logPath) console.log(`    log: ${check.logPath}`);
   }
   for (const item of summary.guidance) console.log(`  Next: ${item}`);
-  if (summary.guidance.length === 0 && summary.status === "fail" && summary.error?.userAction) {
-    console.log(`  Next: ${summary.error.userAction}`);
-  }
   console.log(`Artifacts: ${summary.artifacts.summaryJson}`);
 }
 function failEnvelope(input) {
   const exitCode = EXIT.usage;
-  const userAction = USAGE;
   const body = {
     schemaVersion: 1,
     command: "check",
@@ -540,11 +534,11 @@ function failEnvelope(input) {
     baseRef: input.baseRef,
     baseSource: "unknown",
     artifacts: { dir: input.artifactsDir },
-    error: { code: input.code, message: input.message, userAction }
+    error: { code: input.code, message: input.message }
   };
   if (input.json) console.log(JSON.stringify(body, null, 2));
   else console.error(`\u2717 check diff: ${input.message}
-  Next: ${userAction}`);
+  Next: ${USAGE}`);
   return exitCode;
 }
 export {