@deeeed/metamask-harness 0.79.0 → 0.81.0

package/dist/adapters/mobile/source-freshness.js

@@ -1,135 +1,31 @@
-import { execFileSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-import { recipeRuntimePath } from "../../paths.js";
-const SOURCE_PATHS = [
-  "app",
-  "locales",
-  "index.js",
-  "shim.js",
-  "shimPerf.js",
-  "ReactotronConfig.js",
-  "wdyr.js",
-  "app.config.js",
-  "babel.config.js",
-  "metro.config.js",
-  "metro.transform.js",
-  "package.json"
-];
-const ENV_INPUTS = [".js.env", ".env", ".env.local"];
+import { recordSourceBaseline, sourceCheck, sourceFingerprint } from "@farmslot/adapter-rn";
+import { recipeRuntimePath } from "@farmslot/recipe-cli/harness";
+const MOBILE_SOURCE_INPUTS = {
+  paths: [
+    "app",
+    "locales",
+    "index.js",
+    "shim.js",
+    "shimPerf.js",
+    "ReactotronConfig.js",
+    "wdyr.js",
+    "app.config.js",
+    "babel.config.js",
+    "metro.config.js",
+    "metro.transform.js",
+    "package.json"
+  ],
+  envFiles: [".js.env", ".env", ".env.local"]
+};
 const BASELINE_FILE = "mobile-source-baseline.json";
 function mobileSourceFingerprint(target) {
-  const hash = createHash("sha256");
-  const head = tryGit(target, ["rev-parse", "HEAD"]);
-  if (head === null) {
-    hash.update("non-git\0");
-    for (const relative of SOURCE_PATHS) {
-      hashPath(hash, target, relative);
-    }
-  } else {
-    hash.update(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");
+  return sourceFingerprint(target, MOBILE_SOURCE_INPUTS);
 }
 function mobileSourceCheck(target) {
-  const fingerprint = mobileSourceFingerprint(target);
-  const baseline = readBaseline(target);
-  return {
-    fingerprint,
-    status: baseline === null ? "missing" : baseline.fingerprint === fingerprint ? "current" : "changed"
-  };
+  return sourceCheck(target, MOBILE_SOURCE_INPUTS, recipeRuntimePath(target, BASELINE_FILE));
 }
 function recordMobileSourceBaseline(target, expectedFingerprint) {
-  if (mobileSourceFingerprint(target) !== expectedFingerprint) return false;
-  const marker = recipeRuntimePath(target, BASELINE_FILE);
-  const temporary = `${marker}.${process.pid}.${Date.now()}.tmp`;
-  const baseline = {
-    schemaVersion: 1,
-    fingerprint: expectedFingerprint,
-    recordedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  fs.mkdirSync(path.dirname(marker), { recursive: true });
-  try {
-    fs.writeFileSync(temporary, `${JSON.stringify(baseline, null, 2)}
-`, { mode: 384 });
-    if (mobileSourceFingerprint(target) !== expectedFingerprint) return false;
-    fs.renameSync(temporary, marker);
-    if (mobileSourceFingerprint(target) !== expectedFingerprint) {
-      if (readBaseline(target)?.fingerprint === expectedFingerprint) fs.rmSync(marker, { force: true });
-      return false;
-    }
-  } finally {
-    fs.rmSync(temporary, { force: true });
-  }
-  return true;
-}
-function git(target, args) {
-  return execFileSync("git", args, {
-    cwd: target,
-    encoding: "buffer",
-    maxBuffer: 128 * 1024 * 1024,
-    stdio: ["ignore", "pipe", "ignore"]
-  });
-}
-function tryGit(target, args) {
-  try {
-    return git(target, args);
-  } catch {
-    return null;
-  }
-}
-function hashPath(hash, root, relative) {
-  const absolute = path.join(root, relative);
-  if (!fs.existsSync(absolute)) {
-    hash.update(`absent\0${relative}\0`);
-    return;
-  }
-  const stat = fs.lstatSync(absolute);
-  if (stat.isDirectory()) {
-    hash.update(`directory\0${relative}\0`);
-    for (const child of fs.readdirSync(absolute).sort()) {
-      hashPath(hash, root, path.join(relative, child));
-    }
-    return;
-  }
-  if (stat.isSymbolicLink()) {
-    hash.update(`symlink\0${relative}\0${fs.readlinkSync(absolute)}\0`);
-    return;
-  }
-  hash.update(`file\0${relative}\0`);
-  hash.update(fs.readFileSync(absolute));
-  hash.update("\0");
-}
-function readBaseline(target) {
-  try {
-    const parsed = JSON.parse(
-      fs.readFileSync(recipeRuntimePath(target, BASELINE_FILE), "utf8")
-    );
-    return parsed.schemaVersion === 1 && typeof parsed.fingerprint === "string" ? parsed : null;
-  } catch {
-    return null;
-  }
+  return recordSourceBaseline(target, MOBILE_SOURCE_INPUTS, recipeRuntimePath(target, BASELINE_FILE), expectedFingerprint);
 }
 export {
   mobileSourceCheck,

package/dist/adapters/mobile/surface.js

@@ -1,19 +1,19 @@
+import { recipeRuntimePath, shellQuote, writeInteractiveProgress } from "@farmslot/recipe-cli/harness";
 import { spawnSync } from "node:child_process";
 import path from "node:path";
 import { defineAdapter } from "@farmslot/adapter-sdk";
-import { recipeRuntimePath, runnerDir } from "../../paths.js";
-import { shellQuote } from "../../commands/parse-args.js";
+import { runnerDir } from "../../paths.js";
 import { resolveMobileSlotPorts } from "../slot-ports.js";
 import { mobileRuntimeStatus } from "./prepare.js";
 import { hasRunwayProvisionBaseline, provisionRunwayMobile } from "./provision.js";
 import { adapterRegistry } from "../registry.js";
-import { writeInteractiveProgress } from "../../commands/shared.js";
 import { mobileActions } from "./actions.js";
 import { mobileHarness, mobilePrepare, mobileRuntimeContext } from "./overlay.js";
 import { mobileReadiness, mobileRuntimeDecision } from "./readiness.js";
 import { clearMobileReleaseArtifactState } from "./release-artifact-state.js";
 import { mobileDiagnostics, mobileObservation, mobileRecording, mobileRun } from "./run.js";
 import { mobileSourceFingerprint } from "./source-freshness.js";
+import { checkoutHas, checkoutHasDir } from "../checkout-files.js";
 function mobileRuntimeNextAction(reasonCode, target, platform) {
   const resolved = shellQuote(path.resolve(target));
   return reasonCode === "deps-missing" || reasonCode === "deps-partial" || reasonCode === "deps-stale" ? `cd ${resolved} && yarn setup` : `mm-harness launch ${platform} --adapter mobile --target ${resolved}`;
@@ -53,6 +53,9 @@ const mobileSurface = defineAdapter({
   devServer: {
     label: "metro",
     describe: () => "Metro dev server",
+    // Metro's leaves read the port as METRO_PORT; run and call take it as --metro-port.
+    portEnv: ["METRO_PORT"],
+    portFlags: ["metroPort"],
     stop(target) {
       const leaf = path.join(runnerDir, "adapters", "mobile", "stop-metro.sh");
       const args = ["--target", target];
@@ -70,6 +73,26 @@ const mobileSurface = defineAdapter({
   appLogSource(target) {
     return { label: "app", path: recipeRuntimePath(target, "app-console.log") };
   },
+  detect: {
+    remote: (url) => url.includes("metamask-mobile"),
+    files: (target) => checkoutHas(target, "scripts/skills-sync.mts") || checkoutHasDir(target, "ios") && checkoutHasDir(target, "android") && checkoutHasDir(target, "app/core")
+  },
+  // `launch ios|android`, and --platform ios|android, select Mobile.
+  targets: ["ios", "android"],
+  flags: {
+    launch: ["build", "watch", "verify", "runway", "clearMetro"],
+    commands: ["clearMetro", "resolveOnly"]
+  },
+  failurePatterns: {
+    captureProtected: {
+      pattern: /SCREENSHOT_PROTECTED|screenshot is protected by FLAG_SECURE/iu,
+      message: "the focused Android window intentionally blocks screenshots; a black capture cannot be used as evidence.",
+      userAction: "unlock or navigate to a non-protected screen, then rerun the screenshot action"
+    },
+    transportFirst: /CDP_TIMEOUT|Mobile CDP bridge command timed out|NO_TARGET|WS_CLOSED/iu,
+    walletState: /fixture|keyring|not seeded|\bsrp\b|password|onboard/iu,
+    transport: /metro|bridge|bundle|packager|dev client/iu
+  },
   hints: {
     launch: "mm-harness launch ios",
     relaunch: "mm-harness launch ios",

package/dist/adapters/mobile/ui.js

@@ -3,9 +3,13 @@ import { promisify } from "node:util";
 import { bridgeCommand, evalAsync, evalSync, MOBILE_BRIDGE_ERROR_CODES, selectBridgeStatusEntry, simulatorScreenshot } from "../../../library/actions/mobile/platform/bridge.mjs";
 import { observeNativeUi } from "../../../library/actions/mobile/platform/observe-ui.mjs";
 import { nativeAgentDeviceStateDir } from "../../../library/actions/mobile/platform/native-session-name.mjs";
-import { resolveMobileToolPath } from "../../../library/actions/mobile/platform/tool-paths.mjs";
+import { resolveMobileToolPath } from "@farmslot/adapter-rn";
 import { isRecord, traceText } from "../../action-values.js";
-import { runLiveAdapterScript } from "../../live-adapter-contract.js";
+import { runLiveAdapterScript } from "@farmslot/recipe-cli/harness";
+import { trustedMutationContextExtras } from "../../funding-execution-context.js";
+import { LIBRARY_ACTION_NAMESPACE } from "../../paths.js";
+import { liveTsxCandidates } from "../../live-tsx.js";
+import { mobileAppIdentityEnv } from "./app-identity.js";
 const execFileAsync = promisify(execFile);
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -213,7 +217,10 @@ async function sendMobileBridgeCommand(command, context) {
   if (!handler) {
     throw new Error(`React Native bridge command ${command.command} is not implemented by the MetaMask runner transport.`);
   }
-  return handler(command.payload, context);
+  return handler(command.payload, {
+    ...context,
+    env: { ...context.env, ...mobileAppIdentityEnv(context.env) }
+  });
 }
 function mobileUiInput(context, command, payload) {
   return uiInputFor(context, { action: `ui.${command}`, node: payload });
@@ -235,8 +242,11 @@ async function handleMobileNavigate(payload, context) {
   const live = await runLiveAdapterScript({
     platform: "mobile",
     action: "ui.navigate",
+    namespace: LIBRARY_ACTION_NAMESPACE,
     node: payload,
-    context
+    context,
+    contextExtras: trustedMutationContextExtras(context),
+    tsxCandidates: liveTsxCandidates()
   });
   if (!live) throw new Error("ui.navigate requires library/actions/mobile/ui/navigate.mjs.");
   return isRecord(live.result) ? { ...live.result, liveAdapter: live.script } : live.result;
@@ -586,7 +596,8 @@ async function executeNativeProviderAction(action, node, context, createTranspor
   if (platform === "android" && action === "ui.swipe" && isCoordinateTarget(node.target)) {
     return executeAndroidCoordinateSwipe(node, String(device));
   }
-  const app = platform === "android" ? context.env.ANDROID_PACKAGE_ID ?? process.env.ANDROID_PACKAGE_ID ?? "io.metamask" : context.env.IOS_BUNDLE_ID ?? process.env.IOS_BUNDLE_ID ?? "io.metamask.MetaMask";
+  const identity = mobileAppIdentityEnv(context.env);
+  const app = platform === "android" ? identity.ANDROID_PACKAGE_ID : identity.IOS_BUNDLE_ID;
   const session = (platform === "ios" ? `mm-harness-${process.pid}-${device}` : `mm-harness-${process.pid}-${context.nodeId}`).replace(/[^a-zA-Z0-9._-]/gu, "-");
   const stateDir = nativeAgentDeviceStateDir(context.env ?? {}, context.projectRoot, String(device));
   let transport;

package/dist/adapters/mobile/verify.js

@@ -1,10 +1,9 @@
+import { recipeHarnessPath, recipeHarnessRoot, recipeRuntimeDir, spawnScriptStreaming, readRuntimeContextField } from "@farmslot/recipe-cli/harness";
 import { execFileSync } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
-import { spawnScriptStreaming } from "../../commands/shared.js";
-import { readRuntimeContextField } from "../../harness.js";
-import { recipeHarnessPath, recipeHarnessRoot, recipeRuntimeDir, runnerDir } from "../../paths.js";
+import { runnerDir } from "../../paths.js";
 const USAGE = "Usage: mm-harness verify --adapter mobile -- [--target <metamask-mobile>] [--artifacts-dir <dir>] [--static-only] [--platform ios|android] [--preflight-mode fast|auto|default|rebuild-native|clean] [--no-auto-start]";
 const ENV_FILES = [".js.env", ".env", ".env.local"];
 const PREFLIGHT_MODES = ["fast", "auto", "default", "rebuild-native", "clean"];

package/dist/adapters/performance/cdp-trace.js

@@ -1,6 +1,6 @@
 import {
   summarizeFrames
-} from "../mobile/frame-metrics.js";
+} from "@farmslot/adapter-rn";
 import { withTimeout } from "../../async.js";
 import {
   summarizeJavaScriptTasks

package/dist/adapters/performance/device-platform.js

@@ -1,6 +1,6 @@
 function devicePlatformFromEnv(env) {
   const explicit = String(
-    env.MM_HARNESS_EXPLICIT_PLATFORM ?? env.RECIPE_HARNESS_PLATFORM ?? ""
+    env.RECIPE_RN_EXPLICIT_PLATFORM ?? env.RECIPE_HARNESS_PLATFORM ?? ""
   ).toLowerCase();
   if (explicit === "android" || explicit === "ios") return explicit;
   return env.ADB_SERIAL || env.ANDROID_SERIAL || env.ANDROID_DEVICE ? "android" : "ios";

package/dist/adapters/perps-order-inputs.js

@@ -0,0 +1,36 @@
+function perpsOrderInputFindings(nodeId, node, { ensureChecksOnly }) {
+  const action = node.action;
+  const state = typeof node.state === "string" ? node.state.toLowerCase() : void 0;
+  const createsOrder = action === "metamask.perps.place_order" || !ensureChecksOnly && (action === "metamask.perps.ensure_positions" || action === "metamask.perps.ensure_orders") && (state === "open" || state === "present");
+  if (!createsOrder) return [];
+  const findings = [];
+  const requireOneOf = (names, message) => {
+    const present = names.some((name) => {
+      const value = node[name];
+      return value !== void 0 && value !== null && value !== "";
+    });
+    if (present) return;
+    findings.push({
+      severity: "error",
+      code: "recipe.missing_param",
+      path: `workflow.nodes.${nodeId}.${names[0]}`,
+      message
+    });
+  };
+  requireOneOf(
+    ["market", "symbol"],
+    `${action} requires market=<symbol> (or symbol=<symbol>) before it may create an order`
+  );
+  requireOneOf(
+    ["side"],
+    `${action} requires side=long or side=short before it may create an order`
+  );
+  requireOneOf(
+    ["amount", "notional"],
+    `${action} requires amount=<usd> or notional=<usd> before it may create an order`
+  );
+  return findings;
+}
+export {
+  perpsOrderInputFindings
+};

package/dist/adapters/proof-failure.js

@@ -0,0 +1,11 @@
+function emitProofFailure(json, failure) {
+  if (json) {
+    console.log(JSON.stringify({ schemaVersion: 1, status: "fail", ...failure }, null, 2));
+    return;
+  }
+  console.error(`\u2717 ${failure.error.message}`);
+  console.error(`  Next: ${failure.error.userAction}`);
+}
+export {
+  emitProofFailure
+};

package/dist/adapters/slot-ports.js

@@ -1,8 +1,8 @@
+import { recipeRuntimeDir } from "@farmslot/recipe-cli/harness";
 import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { recipeRuntimeDir } from "../paths.js";
 import {
   formatExtensionIdentityPorts,
   resolveDefaultExtensionPorts,

package/dist/adapters/surface.js

@@ -1,3 +1,4 @@
+import "../host.js";
 import { adapterRegistry } from "./registry.js";
 import "./mobile/surface.js";
 import "./extension/surface.js";

package/dist/adapters/terminal/actions.js

@@ -1,4 +1,5 @@
 import { manifestPath } from "../../paths.js";
+import { perpsOrderInputFindings } from "../perps-order-inputs.js";
 const terminalActions = {
   manifestPath: () => manifestPath("terminal"),
   semantic: [
@@ -36,7 +37,9 @@ const terminalActions = {
       }
       return standard();
     }
-  })
+  }),
+  // ensure_positions and ensure_orders with an open or present state place an order.
+  inputFindings: (nodeId, node) => perpsOrderInputFindings(nodeId, node, { ensureChecksOnly: false })
 };
 export {
   terminalActions

package/dist/adapters/terminal/console-capture.js

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
+import { recipeRuntimePath } from "@farmslot/recipe-cli/harness";
 import { verifyCapture } from "../../../library/actions/shared/console-collector.mjs";
-import { recipeRuntimePath } from "../../paths.js";
 import { ensureConsoleCollector } from "../console-capture.js";
 const TERMINAL_CONSOLE_FILES = Object.freeze({
   app: "app-console.log",

package/dist/adapters/terminal/doctor-checks.js

@@ -2,7 +2,9 @@ import { terminalAppPort, terminalCdpPort } from "./surface.js";
 async function terminalDoctorChecks(target) {
   const { terminalReadiness } = await import("../../../adapters/terminal/lib/readiness.mjs");
   const { resolveBrowser } = await import("../../../adapters/terminal/launch.mjs");
+  const { policy } = await import("../../../adapters/terminal/policy.mjs");
   const report = await terminalReadiness({
+    policy,
     target,
     appPort: terminalAppPort(),
     cdpPort: terminalCdpPort(),

package/dist/adapters/terminal/launch.js

@@ -1,6 +1,6 @@
+import { flag, str } from "@farmslot/recipe-cli/harness";
 import { execFileSync } from "node:child_process";
 import path from "node:path";
-import { flag, str } from "../../commands/shared.js";
 import { runnerDir } from "../../paths.js";
 const TERMINAL_ONLY_LAUNCH_OPTIONS = Object.freeze({
   signer: "--signer",
@@ -46,6 +46,9 @@ async function launchTerminal({ options, target, jsonOutput, stream, usage }) {
     cdpPort,
     "--app-port",
     appPort,
+    // The Terminal's venue policy (Hyperliquid hosts, refusal, start page).
+    "--policy-module",
+    path.join(runnerDir, "adapters", "terminal", "policy.mjs"),
     "--signer",
     str(options, "signer") ?? process.env.TERMINAL_SIGNER ?? "extension",
     "--account",

package/dist/adapters/terminal/overlay.js

@@ -3,7 +3,14 @@ import { runnerDir } from "../../paths.js";
 const terminalHarness = {
   install: { entry: "adapters/terminal/inject.mjs", fallback: "adapters/terminal/inject.mjs", node: true },
   cleanup: { entry: "adapters/terminal/cleanup.mjs", fallback: "adapters/terminal/cleanup.mjs", node: true },
-  verify: () => ({ command: process.execPath, prefixArgs: [path.join(runnerDir, "adapters", "terminal", "verify.mjs")] }),
+  verify: () => ({
+    command: process.execPath,
+    prefixArgs: [
+      path.join(runnerDir, "adapters", "terminal", "verify.mjs"),
+      "--policy-module",
+      path.join(runnerDir, "adapters", "terminal", "policy.mjs")
+    ]
+  }),
   restart: "mm-harness launch"
 };
 const terminalRuntimeContext = {

package/dist/adapters/terminal/run.js

@@ -1,3 +1,5 @@
+import { isRecord } from "@farmslot/recipe-cli/harness";
+import { verifyOwnedCollectorControl } from "../console-capture.js";
 import { devicePlatformFromEnv } from "../performance/device-platform.js";
 import {
   ensureTerminalConsoleCapture,
@@ -11,17 +13,43 @@ const terminalDiagnostics = {
     start: (projectRoot) => ensureTerminalConsoleCapture(projectRoot),
     files: (projectRoot) => terminalCaptureFiles(projectRoot),
     cdpPort: () => terminalCdpPort(),
-    verifyControl: (capture) => verifyTerminalConsoleControl(capture)
+    verifyControl: (capture) => verifyOwnedCollectorControl(capture, () => verifyTerminalConsoleControl(capture))
   },
-  walletLog: (projectRoot) => terminalRuntimeFile(projectRoot, "wallet-requests.jsonl")
+  requestLog: {
+    path: (projectRoot) => terminalRuntimeFile(projectRoot, "wallet-requests.jsonl"),
+    findings: (lines) => walletRequestFindings(lines)
+  }
 };
+function walletRequestFindings(lines) {
+  const findings = [];
+  for (const line of lines) {
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (!isRecord(entry)) continue;
+    let text = null;
+    if (entry.kind === "blocked-mainnet" && entry.probe !== true) text = `blocked-mainnet: ${String(entry.transport ?? "request")} to ${String(entry.url ?? "?")}`;
+    else if (entry.kind === "refused-mainnet") text = `refused-mainnet: ${String(entry.method ?? "?")} (${String(entry.reason ?? "?")})`;
+    else if (entry.kind === "unattributed") text = `unattributed wallet ${entry.binding === "request" ? "request" : "log entry"}${typeof entry.method === "string" ? ` (${entry.method})` : ""}`;
+    if (text) findings.push({ level: "error", source: "wallet", text });
+  }
+  return findings;
+}
 const terminalObservation = {
   network: {
-    backend: async (_target, env, artifactsDir) => (await import("../../network-observation.js")).createExtensionNetworkBackend(env, artifactsDir)
+    backend: async (_target, env, artifactsDir) => (await import("../extension/network-observer.js")).createExtensionNetworkBackend(env, artifactsDir)
   },
   performance: {
-    backend: async (target, env, ports) => (await import("../../performance-observation.js")).createExtensionPerformanceObserver(target, env, ports),
-    platform: (env) => devicePlatformFromEnv(env)
+    start: async (context) => {
+      const observation = await import("../../performance-observation.js");
+      return observation.startRunPerformanceObservation({
+        backend: (target, env, ports) => observation.createExtensionPerformanceObserver(target, env, ports),
+        platform: (env) => devicePlatformFromEnv(env)
+      }, context);
+    }
   }
 };
 export {

package/dist/adapters/terminal/surface.js

@@ -1,6 +1,6 @@
+import { shellQuote } from "@farmslot/recipe-cli/harness";
 import path from "node:path";
 import { defineAdapter } from "@farmslot/adapter-sdk";
-import { shellQuote } from "../../commands/parse-args.js";
 import fs from "node:fs";
 import { TERMINAL_CONSOLE_FILES, terminalRuntimeFile } from "./console-capture.js";
 import { stopTerminalBrowserSync } from "./stop.js";
@@ -9,6 +9,7 @@ import { terminalActions } from "./actions.js";
 import { terminalHarness, terminalRuntimeContext } from "./overlay.js";
 import { terminalReadiness } from "./readiness.js";
 import { terminalDiagnostics, terminalObservation } from "./run.js";
+import { checkoutHas, checkoutHasDir } from "../checkout-files.js";
 function portFromEnv(...names) {
   for (const name of names) {
     const raw = process.env[name];
@@ -38,7 +39,9 @@ const terminalSurface = defineAdapter({
   },
   async runtimeStatus(target) {
     const { terminalReadiness: terminalReadiness2 } = await import("../../../adapters/terminal/lib/readiness.mjs");
+    const { policy } = await import("../../../adapters/terminal/policy.mjs");
     const report = await terminalReadiness2({
+      policy,
       target: path.resolve(target),
       appPort: terminalAppPort(),
       cdpPort: terminalCdpPort(),
@@ -98,6 +101,11 @@ const terminalSurface = defineAdapter({
   appLogSource(target) {
     return { label: "app-console", path: terminalRuntimeFile(target, TERMINAL_CONSOLE_FILES.app) };
   },
+  detect: {
+    remote: (url) => url.includes("va-mmcx-terminal"),
+    files: (target) => checkoutHasDir(target, "src/features/perpetuals") && ["next.config.ts", "next.config.mjs", "next.config.js"].some((file) => checkoutHas(target, file))
+  },
+  flags: { launch: ["freshProfile", "headless", "headful"] },
   hints: {
     launch: "mm-harness launch --adapter terminal --cdp-port <port> --watcher-port <app port>",
     relaunch: "mm-harness launch --adapter terminal --fresh-profile",

package/dist/adapters.js

@@ -1,13 +1,13 @@
 import http from "node:http";
 import { createHash } from "node:crypto";
 import { compatibilityMode, fixtureSummary, repoShape } from "./doctor.js";
-import {
-  runLiveAdapterScript
-} from "./live-adapter-contract.js";
+import { liveAdapterProcessTimeoutMs, runLiveAdapterScript, runNetworkCaptureAction } from "@farmslot/recipe-cli/harness";
+import { trustedMutationContextExtras } from "./funding-execution-context.js";
+import { LIBRARY_ACTION_NAMESPACE } from "./paths.js";
+import { liveTsxCandidates } from "./live-tsx.js";
 import { resolveWalletImportCredentials, validateWalletImportOptions } from "../library/actions/shared/wallet/import-source.mjs";
 import { isRecord, traceText } from "./action-values.js";
 import { getAdapterSurface } from "./adapters/surface.js";
-import { handleRunNetworkAction } from "./network-observation.js";
 import { handleRunPerformanceAction } from "./performance-observation.js";
 function simpleAdapter(action, executor) {
   return {
@@ -99,6 +99,12 @@ function liveRuntimeConfigured(platform, node) {
   if (!getAdapterSurface(platform).actions.liveNeedsCdpPort) return true;
   return Boolean(node.cdp_port ?? process.env.CDP_PORT ?? process.env.RECIPE_CDP_PORT);
 }
+const IMMEDIATE_CLOSE_ALLOWANCE_MS = 18e4;
+function withImmediateCloseBudget(action, node) {
+  if (action !== `${LIBRARY_ACTION_NAMESPACE}.perps.place_order`) return node;
+  if (node.close_immediately !== true && node.closeImmediately !== true) return node;
+  return { ...node, live_adapter_timeout_ms: liveAdapterProcessTimeoutMs(node) + IMMEDIATE_CLOSE_ALLOWANCE_MS };
+}
 async function runLiveFirst(platform, action, node, context, forceLive = false, preparedLiveAdapters) {
   if (node.allow_static_placeholder === true) {
     throw new Error(
@@ -109,9 +115,12 @@ async function runLiveFirst(platform, action, node, context, forceLive = false,
   const live = await runLiveAdapterScript({
     platform,
     action,
-    node,
+    namespace: LIBRARY_ACTION_NAMESPACE,
+    node: withImmediateCloseBudget(action, node),
     context,
-    prepared: preparedLiveAdapters?.get(action)
+    prepared: preparedLiveAdapters?.get(action),
+    contextExtras: trustedMutationContextExtras(context),
+    tsxCandidates: liveTsxCandidates()
   });
   if (!live) return null;
   const liveResult = isRecord(live.result) ? live.result : { result: live.result };
@@ -127,6 +136,15 @@ function liveAdapterPathHint(platform, action) {
   }
   return `library/actions/${platform}/${action.replaceAll(".", "/")}.mjs`;
 }
+async function handleRunNetworkAction(platform, action, node, context) {
+  if (!getAdapterSurface(platform).observation?.network?.actions) return null;
+  if (action === "app.network_assert") {
+    const assertion = await import("../library/actions/shared/app/network-assert.mjs");
+    return { output: await assertion.assertNetwork({ action, node, context }) };
+  }
+  if (action !== "app.network_capture") return null;
+  return runNetworkCaptureAction(platform, node, context);
+}
 async function semanticResult(platform, action, node, context, forceLive = false, preparedLiveAdapters) {
   const performanceAction = await handleRunPerformanceAction(
     platform,
@@ -364,7 +382,9 @@ function createMetaMaskAdapters(adapter, declaredCustomActions = [], preparedLiv
   return adapters;
 }
 export {
+  IMMEDIATE_CLOSE_ALLOWANCE_MS,
   createMetaMaskAdapters,
   createMetaMaskUiTransport,
-  normalizeUiWaitNode
+  normalizeUiWaitNode,
+  withImmediateCloseBudget
 };

package/dist/advisor-policy.js

@@ -1,5 +1,5 @@
+import { optionString, usageError } from "@farmslot/recipe-cli/harness";
 import { assessmentProvider } from "./assessment-providers.js";
-import { optionString, usageError } from "./commands/parse-args.js";
 import { configPath, parseAdvisorSettings, readConfig } from "./review/knowledge.js";
 function resolveAdvisorPolicy(options, env = process.env, config) {
   const saved = (config ?? readConfig(configPath(env))).advisor ?? {};

package/dist/checkout-view.js

@@ -1,8 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
-import { color } from "./cli-color.js";
+import { color, recipeRuntimeDir } from "@farmslot/recipe-cli/harness";
 import { renderRuntimeContext, runtimeContextSummary } from "./doctor.js";
-import { recipeRuntimeDir } from "./paths.js";
 import {
   configPath,
   declaredLibraryPathEnv,