@deeeed/metamask-harness 0.17.3 → 0.17.5

package/adapters/extension/inject.mjs

@@ -24,6 +24,7 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import process from 'node:process';
 import { recipeHarnessRoot } from '../shared/recipe-harness-root.mjs';
+import { harnessSourceFingerprint } from '../shared/harness-source-fingerprint.mjs';
 
 function usage() {
   console.error('Usage: inject-extension-harness.mjs [--target <metamask-extension>] [--no-git-exclude]');
@@ -94,16 +95,16 @@ copyDir(path.join(runnerDir, 'library/recipes'), path.join(harnessDir, 'runner/r
 copyFile(path.join(runnerDir, 'library/library.json'), path.join(harnessDir, 'runner/library.json'));
 fs.mkdirSync(path.join(harnessDir, 'runner/flows'), { recursive: true });
 copyDir(path.join(runnerDir, 'library/flows'), path.join(harnessDir, 'runner/flows'));
-// The installed overlay has a flat scripts/ runtime API independent of the
-// package's source layout.
+// Installed-layout back-compat (INTENTIONAL): targets keep a flat
+// <harness>/scripts/ subtree assembled from the runner trees, so installed
+// consumers are unaffected by runner-repo layout changes.
 copyFile(path.join(runnerDir, 'adapters/extension/launch-browser.cjs'), path.join(harnessDir, 'scripts/launch-browser.cjs'));
+// installed back-compat alias: callers of the pre-rename installed name
+copyFile(path.join(runnerDir, 'adapters/extension/launch-browser.cjs'), path.join(harnessDir, 'scripts/launch-chrome-detached.cjs'));
 copyFile(path.join(runnerDir, 'adapters/extension/console-tail.mjs'), path.join(harnessDir, 'scripts/console-tail.mjs'));
 copyFile(path.join(runnerDir, 'adapters/extension/launch.sh'), path.join(harnessDir, 'scripts/launch.sh'));
 copyFile(path.join(runnerDir, 'adapters/extension/live.sh'), path.join(harnessDir, 'scripts/live.sh'));
 copyFile(path.join(runnerDir, 'adapters/extension/start-watch.sh'), path.join(harnessDir, 'scripts/start-watch.sh'));
-copyFile(path.join(runnerDir, 'adapters/extension/launch-webpack.cjs'), path.join(harnessDir, 'scripts/launch-webpack.cjs'));
-copyFile(path.join(runnerDir, 'adapters/extension/sync-webpack-dist.cjs'), path.join(harnessDir, 'scripts/sync-webpack-dist.cjs'));
-copyFile(path.join(runnerDir, 'adapters/extension/stamp-runtime-title.cjs'), path.join(harnessDir, 'scripts/stamp-runtime-title.cjs'));
 copyFile(path.join(runnerDir, 'adapters/extension/stop-viewers.sh'), path.join(harnessDir, 'scripts/stop-viewers.sh'));
 copyFile(path.join(runnerDir, 'adapters/extension/snapshot-dist.sh'), path.join(harnessDir, 'scripts/snapshot-dist.sh'));
 copyFile(path.join(runnerDir, 'adapters/extension/pin-remote-flags.cjs'), path.join(harnessDir, 'scripts/pin-remote-flags.cjs'));
@@ -120,6 +121,10 @@ copyFile(path.join(runnerDir, 'adapters/shared/activate-repo-node.sh'), path.joi
 copyFile(path.join(runnerDir, 'adapters/shared/resolve-slot-ports.sh'), path.join(harnessDir, 'scripts/lib/resolve-slot-ports.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/resolve-slot-ports.mjs'), path.join(harnessDir, 'scripts/lib/resolve-slot-ports.mjs'));
 copyFile(path.join(runnerDir, 'adapters/shared/resolve-slot-ports-core.mjs'), path.join(harnessDir, 'scripts/lib/resolve-slot-ports-core.mjs'));
+// Back-compat shims (one release) so an overlay consumer using the old leaf names still resolves.
+copyFile(path.join(runnerDir, 'adapters/shared/resolve-farmslot-ports.sh'), path.join(harnessDir, 'scripts/lib/resolve-farmslot-ports.sh'));
+copyFile(path.join(runnerDir, 'adapters/shared/resolve-farmslot-ports.mjs'), path.join(harnessDir, 'scripts/lib/resolve-farmslot-ports.mjs'));
+copyFile(path.join(runnerDir, 'adapters/shared/resolve-farmslot-ports-core.mjs'), path.join(harnessDir, 'scripts/lib/resolve-farmslot-ports-core.mjs'));
 copyFile(path.join(runnerDir, 'adapters/shared/path-defaults.json'), path.join(harnessDir, 'scripts/lib/path-defaults.json'));
 copyFile(path.join(runnerDir, 'adapters/shared/json-field.sh'), path.join(harnessDir, 'scripts/lib/json-field.sh'));
 copyFile(path.join(runnerDir, 'adapters/shared/tmux-session.sh'), path.join(harnessDir, 'scripts/lib/tmux-session.sh'));
@@ -127,6 +132,7 @@ copyFile(path.join(runnerDir, 'adapters/shared/tmux-viewer.sh'), path.join(harne
 copyFile(path.join(runnerDir, 'adapters/shared/log-tui.mjs'), path.join(harnessDir, 'scripts/lib/log-tui.mjs'));
 copyFile(path.join(runnerDir, 'adapters/extension/lib/extension-id.cjs'), path.join(harnessDir, 'scripts/lib/extension-id.cjs'));
 copyFile(path.join(runnerDir, 'adapters/extension/lib/slot-title.cjs'), path.join(harnessDir, 'scripts/lib/slot-title.cjs'));
+copyFile(path.join(runnerDir, 'adapters/extension/lib/chrome-args.cjs'), path.join(harnessDir, 'scripts/lib/chrome-args.cjs'));
 makeExecutableTree(path.join(harnessDir, 'scripts'));
 fs.writeFileSync(path.join(harnessDir, 'installed-scripts.sha256'), `${dirContentHash(path.join(harnessDir, 'scripts'))}\n`);
 
@@ -136,6 +142,10 @@ const manifest = {
   adapter: 'extension',
   installedAt: new Date().toISOString(),
   runnerPackageVersion,
+  // Fingerprint of the runner source that produced this overlay. The launch-time
+  // freshness guard re-injects when the runner's fingerprint no longer matches,
+  // so a slot never silently runs a stale injected launcher.
+  sourceFingerprint: harnessSourceFingerprint(runnerDir),
   source: {
     runnerDir,
     runnerRevision,

package/adapters/extension/launch-browser.cjs

@@ -24,6 +24,7 @@ const os = require('node:os');
 const path = require('node:path');
 const { execFileSync, spawn, spawnSync } = require('node:child_process');
 const { extensionIdFromExtensionDir } = require('./lib/extension-id.cjs');
+const { remoteDebuggingArgs } = require('./lib/chrome-args.cjs');
 
 if (process.argv.includes('--help') || process.argv.includes('-h')) {
   console.log(
@@ -92,8 +93,9 @@ if (args['stop-only'] !== undefined) {
 const initialUrl = args['start-url'] || extensionHomeUrl(args['extension-dir']) || 'chrome://extensions/';
 const chromeArgs = [
   `--user-data-dir=${args.profile}`,
-  '--remote-debugging-address=127.0.0.1',
-  `--remote-debugging-port=${cdpPort}`,
+  // Debug-port trio (address + port + scoped allow-origins) from the shared module,
+  // so the DevTools origin allow-list can never drift away from the port.
+  ...remoteDebuggingArgs(cdpPort),
   '--no-first-run',
   '--disable-first-run-ui',
   '--disable-default-apps',
@@ -113,7 +115,6 @@ let browserPid;
 try {
   const application = process.platform === 'darwin' ? macApplicationForExecutable(args['chrome-bin']) : null;
   if (application) {
-    // Launch Services does not attach Chrome's stdio, so chrome.log may stay empty; CDP ownership is the readiness signal.
     execFileSync('open', ['-g', '-n', '-a', application, '--args', ...chromeArgs], {
       env: sanitizedChildEnv(),
       stdio: ['ignore', logFd, logFd],

package/adapters/extension/launch.sh

@@ -114,21 +114,24 @@ else
   status="fail"
 fi
 
-# The public CLI owns console collection after every successful launch path.
-# This leaf only adds an optional viewer when an explicitly run-owned tmux
-# session exists; the viewer tails the file and never owns the collector.
+# Live extension-console viewer tab (default-on): tail the running extension's
+# service worker + UI-page console in a tmux window, mirroring the Metro/webpack
+# tabs. Skipped silently when there is no tmux session or CDP (headless/CI), so
+# it never affects the launch result.
 if [ "$status" = "pass" ] && [ -n "$CDP_PORT" ] && command -v tmux >/dev/null 2>&1; then
-  console_runtime="$TARGET/$( (cd "$TARGET" && recipe_runtime_dir) 2>/dev/null || echo temp/recipe/runtime)"
-  mkdir -p "$console_runtime"
-  console_log="$console_runtime/extension-console.log"
   for _tv_src in "$SCRIPT_DIR/lib/tmux-viewer.sh" "$SCRIPT_DIR/../shared/tmux-viewer.sh"; do
     # shellcheck disable=SC1091
     [ -f "$_tv_src" ] && { . "$_tv_src"; break; }
   done
   unset _tv_src
-  if command -v tmux_viewer_open >/dev/null 2>&1; then
+  console_tail="$SCRIPT_DIR/console-tail.mjs"
+  if command -v tmux_viewer_open >/dev/null 2>&1 && [ -f "$console_tail" ]; then
+    console_runtime="$TARGET/$( (cd "$TARGET" && recipe_runtime_dir) 2>/dev/null || echo temp/recipe/runtime)"
+    mkdir -p "$console_runtime"
+    console_log="$console_runtime/extension-console.log"
+    : > "$console_log"
     tmux_viewer_open "console" "$CDP_PORT" "$console_log" "$console_runtime" "$console_runtime/console.tmux" \
-      "exec tail -n +1 -F $(printf '%q' "$console_log")"
+      "exec node $(printf '%q' "$console_tail") --cdp-port ${CDP_PORT} --log $(printf '%q' "$console_log")"
   fi
 fi
 

package/adapters/extension/lib/chrome-args.cjs

@@ -0,0 +1,24 @@
+'use strict';
+// chrome-args.cjs — single source of truth for the remote-debugging launch flags
+// shared by BOTH extension launchers: the fresh spawn (launch-browser.cjs) and the
+// reopen path (ensure-browser.sh → reopen-browser.sh). Keeping the debug-port trio
+// here means `--remote-allow-origins` can never drift away from the port it scopes:
+// the two are declared once and always travel together. Without the allow-origins
+// entry Chrome 403s every browser DevTools WebSocket on the debug port and
+// `mm-harness debug` cannot attach a visible console.
+
+// The exact origin allowed is the locally-served bundled DevTools frontend, which
+// Chrome serves at http://127.0.0.1:<cdpPort>. Scoped to that origin — never `*`.
+function remoteDebuggingArgs(cdpPort) {
+  const port = Number(cdpPort);
+  if (!Number.isInteger(port) || port <= 0) {
+    throw new Error(`remoteDebuggingArgs: invalid cdp port: ${cdpPort}`);
+  }
+  return [
+    '--remote-debugging-address=127.0.0.1',
+    `--remote-debugging-port=${port}`,
+    `--remote-allow-origins=http://127.0.0.1:${port}`,
+  ];
+}
+
+module.exports = { remoteDebuggingArgs };

package/adapters/extension/live.sh

@@ -100,6 +100,7 @@ if [ -z "$VERIFY_SH" ]; then
   echo "mm-harness: extension verify.sh not found next to $SCRIPT_DIR; reinstall the runner." >&2
   exit 1
 fi
+TARGET="$(cd "$TARGET" && pwd)"
 RUNTIME_DIR="$(recipe_runtime_dir)"
 RUNTIME_DIST_DIR="${RECIPE_RUNTIME_DIST_DIR:-runtime-dist}"
 CHROME_PROFILE_NAME="${RECIPE_CHROME_PROFILE_NAME:-chrome-profile}"
@@ -162,7 +163,6 @@ NODE
   quoted_seed_fixture="$(printf '%q' "$SCRIPT_DIR/seed-fixture.sh")"
   quoted_start_watch="$(printf '%q' "$SCRIPT_DIR/start-watch.sh")"
   quoted_snapshot_dist="$(printf '%q' "$SCRIPT_DIR/snapshot-dist.sh")"
-  quoted_stamp_title="$(printf '%q' "$SCRIPT_DIR/stamp-runtime-title.cjs")"
   quoted_chrome_launcher="$(printf '%q' "$SCRIPT_DIR/launch-browser.cjs")"
   quoted_fixture_state="$(printf '%q' "$FIXTURE_STATE_ABS")"
   quoted_fixture_validation="$(printf '%q' "$FIXTURE_VALIDATION_ABS")"
@@ -257,7 +257,6 @@ NODE
   fi
   prepare_parts+=("node ${quoted_chrome_launcher} --stop-only 1 --reset-profile 1 --chrome-bin ${quoted_chrome} --profile ${quoted_profile} --cdp-port ${CDP_PORT} --extension-dir ${quoted_runtime_dist} --chrome-log ${quoted_chrome_log} --chrome-pid ${quoted_chrome_pid}")
   prepare_parts+=("bash ${quoted_snapshot_dist} --dist ${quoted_dist} --runtime-dist ${quoted_runtime_dist}")
-  prepare_parts+=("node ${quoted_stamp_title} --target ${quoted_target} --runtime-dist ${quoted_runtime_dist} --runtime-dir ${quoted_runtime_dir}")
   # Optional A/B feature-flag pinning: patch the ephemeral snapshot manifest so
   # manifest._flags wins over the fetched ClientConfigApi value. No-op unless
   # --remote-flag was passed; the snapshot is re-created each run, so no revert.

package/adapters/extension/reattach.sh

@@ -103,7 +103,6 @@ echo "[reattach] reusing loaded runtime-dist: $RUNTIME_DIST_ABS" >&2
 if [ -d "$DIST_ABS" ] && [ -d "$RUNTIME_DIST_ABS" ]; then
   echo "[reattach] refreshing loaded runtime-dist in place" >&2
   rsync -a --exclude _metadata "$DIST_ABS/" "$RUNTIME_DIST_ABS/" >&2
-  node "$SCRIPT_DIR/stamp-runtime-title.cjs" --target "$TARGET" --runtime-dist "$RUNTIME_DIST_ABS" --runtime-dir "$RUNTIME_DIR" >&2
 fi
 
 # Resolve the extension id: explicit flag, then the recorded id file, else CDP.

package/adapters/extension/seed-fixture.sh

@@ -4,13 +4,15 @@
 #
 # Purpose:
 #   Resolves which wallet fixture a slot run should use (env override then
-#   the checkout's canonical runtime fixture) and drives the recipe-tree
+#   runtime-dir/legacy/port-scoped candidates) and drives the recipe-tree
 #   wallet-fixture-state.cjs phases around the browser launch.
 #
 # Subcommands (flags):
 #   resolve   --target <repo> --cdp-port <port> [--source-out <file>]
 #             Prints the fixture path (empty if none). Chain:
-#             RECIPE_WALLET_FIXTURE env > <runtime-dir>/wallet-fixture.json.
+#             RECIPE_WALLET_FIXTURE env > <runtime-dir>/wallet-fixture.json >
+#             temp/runtime/ > temp/.recipe-validation-<port>/ >
+#             temp/.agent-validation/.
 #   prefill   --fixture <json> --target <repo> --state <file> --profile <dir>
 #             --extension-dir <dist> --extension-id-file <file>
 #             Runs fixture-state generate then prefill-profile (pre-launch).
@@ -129,8 +131,14 @@ if [ "$SUBCOMMAND" = resolve ]; then
     fi
     resolved="$RECIPE_WALLET_FIXTURE"
   else
-    candidate="${RUNTIME_DIR:+$TARGET/$RUNTIME_DIR/wallet-fixture.json}"
-    [ -n "$candidate" ] && [ -f "$candidate" ] && resolved="$candidate"
+    for candidate in \
+      ${RUNTIME_DIR:+"$TARGET/$RUNTIME_DIR/wallet-fixture.json"} \
+      "$TARGET/temp/runtime/wallet-fixture.json" \
+      ${CDP_PORT:+"$TARGET/temp/.recipe-validation-${CDP_PORT}/wallet-fixture.json"} \
+      "$TARGET/temp/.agent-validation/wallet-fixture.json"
+    do
+      [ -f "$candidate" ] && { resolved="$candidate"; break; }
+    done
   fi
   [ -n "$resolved" ] || resolve_status=missing
   if [ -n "$SOURCE_OUT" ]; then

package/adapters/extension/sidepanel-toggle.sh

@@ -289,10 +289,7 @@ const { chromium } = require('playwright');
     return { windowId: currentWindow.id };
   });
 
-  // This harness-owned button exists only to provide Chrome's trusted user
-  // gesture. Its visual layout is irrelevant and can be occluded by the app's
-  // full-screen loading surface, so do not wait on Playwright actionability.
-  await page.locator('#__recipe_open_sidepanel__').click({ timeout: 5000, force: true });
+  await page.locator('#__recipe_open_sidepanel__').click({ timeout: 5000 });
   const clickResult = await page
     .locator('#__recipe_open_sidepanel__')
     .evaluate((button) => button.dataset.result || '');

package/adapters/extension/start-watch.sh

@@ -182,15 +182,9 @@ rm -rf node_modules/.cache/webpack
 killed_harness_pid=""
 if [ -f "$RUNTIME_DIR/recipe-harness-webpack.pid" ]; then
   killed_harness_pid="$(cat "$RUNTIME_DIR/recipe-harness-webpack.pid" 2>/dev/null || true)"
-  [ -z "$killed_harness_pid" ] || kill -- "-$killed_harness_pid" >/dev/null 2>&1 || true
   [ -z "$killed_harness_pid" ] || kill "$killed_harness_pid" >/dev/null 2>&1 || true
   rm -f "$RUNTIME_DIR/recipe-harness-webpack.pid"
 fi
-if [ -f "$RUNTIME_DIR/recipe-harness-webpack-sync.pid" ]; then
-  sync_pid="$(cat "$RUNTIME_DIR/recipe-harness-webpack-sync.pid" 2>/dev/null || true)"
-  [ -z "$sync_pid" ] || kill "$sync_pid" >/dev/null 2>&1 || true
-  rm -f "$RUNTIME_DIR/recipe-harness-webpack-sync.pid"
-fi
 
 # Do not start a second writer for dist/chrome. Slot-owned watches use
 # webpack.pid; harness-owned watches use recipe-harness-webpack.pid.
@@ -225,8 +219,6 @@ fi
 # unrelated repo and leave this target validating stale dist/chrome output.
 watch_pid_file="$RUNTIME_DIR/recipe-harness-webpack.pid"
 watch_log="$RUNTIME_DIR/recipe-harness-webpack.log"
-sync_pid_file="$RUNTIME_DIR/recipe-harness-webpack-sync.pid"
-sync_log="$RUNTIME_DIR/recipe-harness-webpack-sync.log"
 rm -f "$watch_pid_file"
 : > "$watch_log"
 LIB_DIR=""
@@ -237,16 +229,11 @@ unset _lib
 echo "[recipe-harness] Starting yarn start (watcher-port=${WATCHER_PORT:-default})"
 echo "[recipe-harness] compact build view - full log: $watch_log (mm-harness logs --full)"
 started_pid=""
+# Launch the watcher detached writing to the log; the tmux window is a read-only tail viewer.
 path_prefix="${REPO_NODE_PATH_PREFIX:-}"
-launcher="$SCRIPT_DIR/launch-webpack.cjs"
-[ -f "$launcher" ] || { echo "launch-webpack.cjs missing from harness; run: mm-harness install" >&2; exit 1; }
-sync_script="$SCRIPT_DIR/sync-webpack-dist.cjs"
-[ -f "$sync_script" ] || { echo "sync-webpack-dist.cjs missing from harness; run: mm-harness install" >&2; exit 1; }
-launch_args=(--target "$PWD" --log "$watch_log" --pid-file "$watch_pid_file" --sync-script "$sync_script" --sync-pid-file "$sync_pid_file" --sync-log "$sync_log" --dist "$PWD/dist/chrome" --runtime-dist "$PWD/$RUNTIME_DIR/${RECIPE_RUNTIME_DIST_DIR:-runtime-dist}")
-[ -z "$WATCHER_PORT" ] || launch_args+=(--port "$WATCHER_PORT")
-[ -z "$path_prefix" ] || launch_args+=(--path-prefix "$path_prefix")
-env -u BUNDLED_DEBUGPY_PATH node "$launcher" "${launch_args[@]}" >/dev/null
-started_pid="$(cat "$watch_pid_file")"
+nohup env -u BUNDLED_DEBUGPY_PATH ${path_prefix:+PATH="${path_prefix}${PATH}"} ${WATCHER_PORT:+PORT="$WATCHER_PORT"} yarn start > "$watch_log" 2>&1 &
+started_pid=$!
+printf '%s\n' "$started_pid" > "$watch_pid_file"
 # The orchestrator names the session; the harness only populates windows. Resolve
 # via the run-owned ladder (RECIPE_TMUX_SESSION → agentic-runtime.json session) —
 # no current-session fallback or slot-number derivation.

package/adapters/extension/stop-viewers.sh

@@ -52,5 +52,5 @@ ps -axo pid=,command= 2>/dev/null | while read -r pid command; do
   esac
 done
 
-rm -f "$runtime_dir/console.tmux" "$runtime_dir/webpack.tmux" "$runtime_dir/console-tail.pid"
+rm -f "$runtime_dir/console.tmux" "$runtime_dir/webpack.tmux"
 exit 0

package/adapters/extension/verify.sh

@@ -58,7 +58,7 @@ if ! command -v harness_root >/dev/null 2>&1; then
   exit 1
 fi
 
-# Safe task-local --out resolution.
+# Safe task-local --out resolution (kept from the legacy extension path.sh).
 resolve_harness_out() {
   local target="$1"
   local out="$2"

package/adapters/manifest.json

@@ -18,22 +18,6 @@
       "inputs": "--target --port --clear; env WATCHER_PORT, METRO_PORT, MOBILE_METRO_REQUIRED_ENV, METRO_MAX_WORKERS",
       "outputs": "Metro PID file + log; exit 0 ready / 1 timeout / 2 bad args"
     },
-    {
-      "id": "mobile/start-console-forwarder",
-      "entry": "adapters/mobile/start-console-forwarder.sh",
-      "kind": "bash",
-      "purpose": "Ensure one runner-owned Mobile application console collector is alive after bridge readiness.",
-      "inputs": "--target --port --quiet; env WATCHER_PORT, METRO_PORT, METAMASK_RECIPE_CONSOLE_FORWARD",
-      "outputs": "app-console.log + collector PID file; exit 0 ready / 1 startup failed / 2 bad args"
-    },
-    {
-      "id": "mobile/launch-console-forwarder",
-      "entry": "adapters/mobile/launch-console-forwarder.cjs",
-      "kind": "node",
-      "purpose": "Detach the Mobile application console collector from command-runner process-group cleanup.",
-      "inputs": "--port --out --err",
-      "outputs": "collector PID on stdout; exit 0 launched / 1 spawn failed / 2 bad args"
-    },
     {
       "id": "mobile/launch-metro",
       "entry": "adapters/mobile/launch-metro.cjs",
@@ -78,17 +62,17 @@
       "id": "mobile/inject",
       "entry": "adapters/mobile/inject.sh",
       "kind": "bash",
-      "purpose": "Install Mobile runner metadata, delegates, and snapshots without modifying product source.",
-      "inputs": "--target --no-git-exclude; env RECIPE_HARNESS_ROOT, METAMASK_RUNNER_PROTOCOL_ROOT",
-      "outputs": "<harness>/manifest.json + runner/ + scripts/; exit 0/1/2"
+      "purpose": "Install the mobile harness overlay (delegate + snapshots; full mode adds the app bridge with backups).",
+      "inputs": "--target --allow-dirty-harness-paths --force-overlay --no-git-exclude; env RECIPE_HARNESS_ROOT, METAMASK_RUNNER_PROTOCOL_ROOT>FARMSLOT_ROOT",
+      "outputs": "<harness>/manifest.json + runner/ + scripts/ + backup store; exit 0/1/2"
     },
     {
       "id": "mobile/cleanup",
       "entry": "adapters/mobile/cleanup.sh",
       "kind": "bash",
-      "purpose": "Remove Mobile harness metadata and recorded git excludes without touching product source.",
-      "inputs": "--target; env RECIPE_HARNESS_ROOT",
-      "outputs": "removes <harness>/; exit 0/1/2"
+      "purpose": "Remove the mobile overlay; restore backed-up product files; remove recorded git excludes.",
+      "inputs": "--target --allow-managed-changes; env RECIPE_HARNESS_ROOT",
+      "outputs": "removes <harness>/ + backups; exit 0/1/2"
     },
     {
       "id": "mobile/verify",
@@ -130,30 +114,6 @@
       "inputs": "--target --runtime-dir --runner-bin --summary",
       "outputs": "<runtime-dir>/recipe-harness-webpack.{pid,log}; optional summary; exit 0/1/2"
     },
-    {
-      "id": "extension/launch-webpack",
-      "entry": "adapters/extension/launch-webpack.cjs",
-      "kind": "node",
-      "purpose": "Detach the normal yarn start watcher from the launching CLI process while preserving its target, environment, and log.",
-      "inputs": "--target --log --pid-file --sync-script --sync-pid-file --sync-log --dist --runtime-dist; optional --port --path-prefix",
-      "outputs": "watcher and runtime-sync pids; webpack and sync logs; exit 0/1"
-    },
-    {
-      "id": "extension/sync-webpack-dist",
-      "entry": "adapters/extension/sync-webpack-dist.cjs",
-      "kind": "node",
-      "purpose": "After each successful webpack compile, update the loaded isolated runtime in place so an ordinary browser refresh sees the edit.",
-      "inputs": "--watcher-pid --watch-log --target --dist --runtime-dist --pid-file",
-      "outputs": "runtime-dist updated in place after successful compile markers; exits with its watcher"
-    },
-    {
-      "id": "extension/stamp-runtime-title",
-      "entry": "adapters/extension/stamp-runtime-title.cjs",
-      "kind": "node",
-      "purpose": "Stamp the slot id into isolated Extension page titles so window identity survives browser refreshes.",
-      "inputs": "--target --runtime-dist; optional --runtime-dir",
-      "outputs": "home.html and sidepanel.html titles updated in the isolated runtime only; exit 0/1"
-    },
     {
       "id": "extension/stop-viewers",
       "entry": "adapters/extension/stop-viewers.sh",
@@ -418,6 +378,22 @@
       "inputs": "ESM import from resolve-slot-ports.mjs or resolve-slot-ports.ts",
       "outputs": "resolveSlotPortsByRepo and related functions"
     },
+    {
+      "id": "lib/resolve-farmslot-ports",
+      "entry": "adapters/shared/resolve-farmslot-ports.mjs",
+      "kind": "node",
+      "purpose": "Back-compat shim (one release): delegates to resolve-slot-ports.mjs.",
+      "inputs": "resolve-farmslot-ports.mjs <fn> <repo>",
+      "outputs": "same as resolve-slot-ports.mjs"
+    },
+    {
+      "id": "lib/resolve-farmslot-ports-core",
+      "entry": "adapters/shared/resolve-farmslot-ports-core.mjs",
+      "kind": "lib",
+      "purpose": "Back-compat shim (one release): re-exports resolve-slot-ports-core.mjs.",
+      "inputs": "ESM import of the old path",
+      "outputs": "re-exports resolveSlotPortsByRepo (and the resolveFarmslotPortsByRepo alias)"
+    },
     {
       "id": "lib/recipe-harness-root",
       "entry": "adapters/shared/recipe-harness-root.mjs",
@@ -430,10 +406,18 @@
       "id": "lib/resolve-slot-ports-sh",
       "entry": "adapters/shared/resolve-slot-ports.sh",
       "kind": "lib",
-      "purpose": "Sourced wrapper over resolve-slot-ports.mjs for shell runtime leaves.",
+      "purpose": "Bash-compat sourced wrapper over resolve-slot-ports.mjs for stop-metro and legacy callers.",
       "inputs": "source + resolve_* / apply_resolved_* function calls",
       "outputs": "KEY=VALUE lines on stdout; env vars via apply_resolved_*"
     },
+    {
+      "id": "lib/resolve-farmslot-ports-sh",
+      "entry": "adapters/shared/resolve-farmslot-ports.sh",
+      "kind": "lib",
+      "purpose": "Back-compat shim (one release): sources resolve-slot-ports.sh (keeps the resolve_farmslot_ports_by_repo alias).",
+      "inputs": "source",
+      "outputs": "same sourced functions as resolve-slot-ports.sh"
+    },
     {
       "id": "lib/reap-checkout-metros",
       "entry": "adapters/shared/reap-checkout-metros.sh",
@@ -488,12 +472,20 @@
       "outputs": "debug URL/report on stdout; exit 0/1"
     },
     {
-      "id": "lib/update-check-worker",
-      "entry": "adapters/shared/update-check-worker.mjs",
-      "kind": "node",
-      "purpose": "Detached, silent registry probe used by the daily passive update notice.",
-      "inputs": "<cache-file> <timeout-ms> [registry-endpoint]",
-      "outputs": "atomic update-cache refresh; always silent and best-effort"
+      "id": "lib/harness-source-fingerprint",
+      "entry": "adapters/shared/harness-source-fingerprint.mjs",
+      "kind": "lib",
+      "purpose": "Compute the deterministic source fingerprint stamped into injected extension harness manifests.",
+      "inputs": "imported by injection and launch freshness checks",
+      "outputs": "stable SHA-256 fingerprint"
+    },
+    {
+      "id": "compat-overlays/mobile",
+      "entry": "adapters/mobile/overlay/compat",
+      "kind": "compat-overlay",
+      "purpose": "Historical-commit replay support: reversible source overlays (e.g. rn81-message-event-source.patch) applied manually/via the recipe-harness skill so pre-RN-0.81 mobile checkouts boot and bridge under the current toolchain.",
+      "inputs": "manual `git apply` in the historical product checkout (no in-repo apply logic)",
+      "outputs": "patched historical checkout (reversible via git apply -R); overlay path recorded in eval evidence"
     }
   ]
 }

package/adapters/mobile/bridge-runtime/cdp-bridge.cjs

@@ -254,21 +254,6 @@ const COMMANDS = {
     return { ...result, testId, deviceName };
   },
 
-  async 'press-text'(client, args, { deviceName } = {}) {
-    const text = args[0];
-    if (!text) {
-      throw new Error('Usage: press-text <text>');
-    }
-    const expr = `(function() {
-      if (typeof globalThis.__AGENTIC__?.pressText !== 'function') {
-        return { ok: false, error: 'The app bridge does not expose pressText' };
-      }
-      return globalThis.__AGENTIC__.pressText(${JSON.stringify(text)});
-    })()`;
-    const result = await cdpEval(client, expr);
-    return { ...result, text, deviceName };
-  },
-
   async 'scroll-view'(client, args, { deviceName } = {}) {
     let testId;
     let offset = 300;
@@ -693,7 +678,6 @@ Commands:
   get-selected-account                 Get the currently selected account
   switch-account <address>             Switch to account by address
   press-test-id <testId>               Press a component by its testID prop
-  press-text <text>                     Press a component containing visible text
   scroll-view [--test-id <id>] [--offset <n>] [--animated]
                                        Scroll a ScrollView/FlatList
   set-input <testId> <value>           Set text input value by testID (calls onChangeText)

package/adapters/mobile/bridge-runtime/console-forwarder.cjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // console-forwarder — stream device console lines into metro.log.
 //
-// React Native (Bridgeless) gates its built-in console→Metro forwarding on
+// React Native (Bridgeless) gates its legacy console→Metro forwarding on
 // `console._isPolyfilled` (setUpDeveloperTools.js, T214991636); with the Hermes
 // native console that gate is false, so app logs (incl. DevLogger) never reach
 // Metro's log. The supported contract for log consumption in modern RN is CDP —

package/adapters/mobile/bridge-runtime/lib/match-bridge-target.cjs

@@ -50,9 +50,7 @@ function matchesBridgeTarget(target, env) {
 // (an in-app agentic bridge is live), not merely a registered debug target.
 function hasMatchingRoute(value, env) {
   const targets = Array.isArray(value) ? value : [value];
-  return targets.some(
-    (t) => matchesBridgeTarget(t, env) && t && t.agenticPresent === true && Boolean(t.route),
-  );
+  return targets.some((t) => matchesBridgeTarget(t, env) && t && t.route);
 }
 
 // Human summary of the targets that answered (platform / deviceName), for teaching on

package/adapters/mobile/bridge-runtime/lib/target-discovery.cjs

@@ -136,7 +136,7 @@ async function discoverTarget(port) {
   //   ANDROID_TARGET_DEVICE_NAME — Metro-compatible model prefix resolved by bridge.mjs
   //     from the adb serial via `adb -s <serial> shell getprop ro.product.model`.
   //     Example: "Pixel 6" matches Metro deviceName "Pixel 6 - 16 - API 36".
-  //   ANDROID_DEVICE — exact user-specified Metro deviceName.
+  //   ANDROID_DEVICE — exact Metro deviceName (backward compat / user-specified).
   const androidTargetName = loadAndroidTargetDeviceName();
   const androidDevice = loadAndroidDevice();
   const adbSerial = process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || '';
@@ -205,7 +205,8 @@ async function discoverTarget(port) {
       }
       candidates = androidFiltered;
     } else if (androidDevice) {
-      // Exact Metro deviceName match when the user set ANDROID_DEVICE directly.
+      // Exact Metro deviceName match (user set ANDROID_DEVICE to the Metro name, or
+      // legacy path where ANDROID_DEVICE was not resolved from serial).
       androidFiltered = candidates.filter((t) => t.deviceName === androidDevice);
       if (androidFiltered.length === 0) {
         // Pinned by exact Metro name but no candidate matched — fail fast.