@deeeed/metamask-harness 0.17.0 → 0.17.2

package/adapters/extension/launch.sh

@@ -114,24 +114,21 @@ else
   status="fail"
 fi
 
-# 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.
+# 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.
 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
-  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"
+  if command -v tmux_viewer_open >/dev/null 2>&1; then
     tmux_viewer_open "console" "$CDP_PORT" "$console_log" "$console_runtime" "$console_runtime/console.tmux" \
-      "exec node $(printf '%q' "$console_tail") --cdp-port ${CDP_PORT} --log $(printf '%q' "$console_log")"
+      "exec tail -n +1 -F $(printf '%q' "$console_log")"
   fi
 fi
 

package/adapters/extension/live.sh

@@ -162,6 +162,7 @@ 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")"
@@ -256,6 +257,7 @@ 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,6 +103,7 @@ 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,15 +4,13 @@
 #
 # Purpose:
 #   Resolves which wallet fixture a slot run should use (env override then
-#   runtime-dir/legacy/port-scoped candidates) and drives the recipe-tree
+#   the checkout's canonical runtime fixture) 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 >
-#             temp/runtime/ > temp/.recipe-validation-<port>/ >
-#             temp/.agent-validation/.
+#             RECIPE_WALLET_FIXTURE env > <runtime-dir>/wallet-fixture.json.
 #   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).
@@ -131,14 +129,8 @@ if [ "$SUBCOMMAND" = resolve ]; then
     fi
     resolved="$RECIPE_WALLET_FIXTURE"
   else
-    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
+    candidate="${RUNTIME_DIR:+$TARGET/$RUNTIME_DIR/wallet-fixture.json}"
+    [ -n "$candidate" ] && [ -f "$candidate" ] && resolved="$candidate"
   fi
   [ -n "$resolved" ] || resolve_status=missing
   if [ -n "$SOURCE_OUT" ]; then

package/adapters/extension/sidepanel-toggle.sh

@@ -289,7 +289,10 @@ const { chromium } = require('playwright');
     return { windowId: currentWindow.id };
   });
 
-  await page.locator('#__recipe_open_sidepanel__').click({ timeout: 5000 });
+  // 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 });
   const clickResult = await page
     .locator('#__recipe_open_sidepanel__')
     .evaluate((button) => button.dataset.result || '');

package/adapters/extension/stamp-runtime-title.cjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const { readSlotId } = require('./lib/slot-title.cjs');
+
+function stampRuntimeTitles({ target, runtimeDist, runtimeDir = process.env.RECIPE_RUNTIME_DIR || 'temp/recipe/runtime' }) {
+  const slotId = readSlotId(target, runtimeDir);
+  if (!slotId) return { slotId: '', stamped: [] };
+  const stamped = [];
+  for (const name of ['home.html', 'sidepanel.html']) {
+    const file = path.join(runtimeDist, name);
+    if (!fs.existsSync(file)) continue;
+    const source = fs.readFileSync(file, 'utf8');
+    const next = source.replace(/<title>([^<]*)<\/title>/iu, (_match, title) => {
+      const base = String(title || 'MetaMask').replace(/^.+?\s+[—–-]\s+/u, '') || 'MetaMask';
+      return `<title>${slotId} — ${base}</title>`;
+    });
+    if (next === source) continue;
+    fs.writeFileSync(file, next);
+    stamped.push(name);
+  }
+  return { slotId, stamped };
+}
+
+if (require.main === module) {
+  const args = {};
+  for (let index = 2; index < process.argv.length; index += 1) {
+    const key = process.argv[index];
+    if (key === '--help' || key === '-h') {
+      process.stdout.write('Usage: stamp-runtime-title.cjs --target <path> --runtime-dist <path> [--runtime-dir <path>]\n');
+      process.exit(0);
+    }
+    if (!key.startsWith('--') || index + 1 >= process.argv.length) throw new Error(`invalid argument: ${key}`);
+    args[key.slice(2)] = process.argv[++index];
+  }
+  if (!args.target) throw new Error('--target is required');
+  if (!args['runtime-dist']) throw new Error('--runtime-dist is required');
+  const result = stampRuntimeTitles({
+    target: path.resolve(args.target),
+    runtimeDist: path.resolve(args['runtime-dist']),
+    runtimeDir: args['runtime-dir'],
+  });
+  if (result.stamped.length > 0) process.stdout.write(`slot title ${result.slotId}: ${result.stamped.join(', ')}\n`);
+}
+
+module.exports = { stampRuntimeTitles };

package/adapters/extension/start-watch.sh

@@ -185,6 +185,11 @@ if [ -f "$RUNTIME_DIR/recipe-harness-webpack.pid" ]; then
   [ -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.
@@ -219,6 +224,8 @@ 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=""
@@ -229,11 +236,16 @@ 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:-}"
-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"
+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")"
 # 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"
+rm -f "$runtime_dir/console.tmux" "$runtime_dir/webpack.tmux" "$runtime_dir/console-tail.pid"
 exit 0

package/adapters/extension/sync-webpack-dist.cjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+const { stampRuntimeTitles } = require('./stamp-runtime-title.cjs');
+
+const args = {};
+for (let index = 2; index < process.argv.length; index += 1) {
+  const key = process.argv[index];
+  if (key === '--help' || key === '-h') {
+    process.stdout.write('Usage: sync-webpack-dist.cjs --watcher-pid <pid> --watch-log <path> --target <path> --dist <path> --runtime-dist <path> --pid-file <path>\n');
+    process.exit(0);
+  }
+  if (!key.startsWith('--') || index + 1 >= process.argv.length) throw new Error(`invalid argument: ${key}`);
+  args[key.slice(2)] = process.argv[++index];
+}
+for (const required of ['watcher-pid', 'watch-log', 'target', 'dist', 'runtime-dist', 'pid-file']) {
+  if (!args[required]) throw new Error(`--${required} is required`);
+}
+
+const watcherPid = Number(args['watcher-pid']);
+if (!Number.isInteger(watcherPid) || watcherPid <= 0) throw new Error('--watcher-pid must be a positive integer');
+
+const watchLog = path.resolve(args['watch-log']);
+const dist = path.resolve(args.dist);
+const runtimeDist = path.resolve(args['runtime-dist']);
+const pidFile = path.resolve(args['pid-file']);
+const compilePattern = /compiled successfully|compiled with \d+ warning|MetaMask .* compiled|Bundle end: service worker|Bundle end:.*app-init/u;
+let offset = 0;
+let carry = '';
+let timer;
+
+function processAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function removeOwnPidFile() {
+  try {
+    if (fs.readFileSync(pidFile, 'utf8').trim() === String(process.pid)) fs.rmSync(pidFile, { force: true });
+  } catch {
+    // The launcher may have already removed or replaced it.
+  }
+}
+
+function syncRuntimeDist() {
+  if (!fs.existsSync(path.join(dist, 'manifest.json')) || !fs.existsSync(runtimeDist)) return;
+  const result = spawnSync('rsync', ['-a', '--exclude', '_metadata', `${dist}${path.sep}`, `${runtimeDist}${path.sep}`], {
+    encoding: 'utf8',
+  });
+  if (result.status !== 0) {
+    process.stderr.write(`runtime-dist sync failed: ${(result.stderr || result.stdout || `rsync exited ${result.status}`).trim()}\n`);
+    return;
+  }
+  stampRuntimeTitles({ target: path.resolve(args.target), runtimeDist });
+  process.stdout.write(`runtime-dist updated after webpack compile (${new Date().toISOString()})\n`);
+}
+
+function poll() {
+  if (!processAlive(watcherPid)) {
+    removeOwnPidFile();
+    process.exit(0);
+  }
+  try {
+    const size = fs.statSync(watchLog).size;
+    if (size < offset) {
+      offset = 0;
+      carry = '';
+    }
+    if (size > offset) {
+      const length = size - offset;
+      const fd = fs.openSync(watchLog, 'r');
+      const chunk = Buffer.alloc(length);
+      fs.readSync(fd, chunk, 0, length, offset);
+      fs.closeSync(fd);
+      offset = size;
+      const text = carry + chunk.toString('utf8');
+      const lines = text.split(/\r?\n/u);
+      carry = lines.pop() || '';
+      if (lines.some((line) => compilePattern.test(line))) syncRuntimeDist();
+    }
+  } catch (error) {
+    if (error?.code !== 'ENOENT') process.stderr.write(`runtime-dist sync monitor: ${error.message}\n`);
+  }
+  timer = setTimeout(poll, 250);
+}
+
+fs.mkdirSync(path.dirname(pidFile), { recursive: true });
+process.on('SIGTERM', () => {
+  clearTimeout(timer);
+  removeOwnPidFile();
+  process.exit(0);
+});
+process.on('SIGINT', () => {
+  clearTimeout(timer);
+  removeOwnPidFile();
+  process.exit(0);
+});
+poll();

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 (kept from the legacy extension path.sh).
+# Safe task-local --out resolution.
 resolve_harness_out() {
   local target="$1"
   local out="$2"

package/adapters/manifest.json

@@ -18,6 +18,22 @@
       "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",
@@ -62,17 +78,17 @@
       "id": "mobile/inject",
       "entry": "adapters/mobile/inject.sh",
       "kind": "bash",
-      "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"
+      "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"
     },
     {
       "id": "mobile/cleanup",
       "entry": "adapters/mobile/cleanup.sh",
       "kind": "bash",
-      "purpose": "Remove the mobile overlay; restore backed-up product files; remove recorded git excludes.",
+      "purpose": "Remove Mobile harness metadata and recorded git excludes without touching product source.",
       "inputs": "--target --allow-managed-changes; env RECIPE_HARNESS_ROOT",
-      "outputs": "removes <harness>/ + backups; exit 0/1/2"
+      "outputs": "removes <harness>/; exit 0/1/2"
     },
     {
       "id": "mobile/verify",
@@ -114,6 +130,30 @@
       "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",
@@ -378,22 +418,6 @@
       "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",
@@ -406,18 +430,10 @@
       "id": "lib/resolve-slot-ports-sh",
       "entry": "adapters/shared/resolve-slot-ports.sh",
       "kind": "lib",
-      "purpose": "Bash-compat sourced wrapper over resolve-slot-ports.mjs for stop-metro and legacy callers.",
+      "purpose": "Sourced wrapper over resolve-slot-ports.mjs for shell runtime leaves.",
       "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",
@@ -470,14 +486,6 @@
       "purpose": "Open human-facing debugger UIs for extension CDP or mobile Metro runtimes.",
       "inputs": "--adapter extension|mobile [--cdp-port|--port] [--target page|worker] [--json] [--no-open]",
       "outputs": "debug URL/report on stdout; exit 0/1"
-    },
-    {
-      "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/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 legacy console→Metro forwarding on
+// React Native (Bridgeless) gates its built-in 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/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 Metro deviceName (backward compat / user-specified).
+  //   ANDROID_DEVICE — exact user-specified Metro deviceName.
   const androidTargetName = loadAndroidTargetDeviceName();
   const androidDevice = loadAndroidDevice();
   const adbSerial = process.env.ADB_SERIAL || process.env.ANDROID_SERIAL || '';
@@ -205,8 +205,7 @@ async function discoverTarget(port) {
       }
       candidates = androidFiltered;
     } else if (androidDevice) {
-      // Exact Metro deviceName match (user set ANDROID_DEVICE to the Metro name, or
-      // legacy path where ANDROID_DEVICE was not resolved from serial).
+      // Exact Metro deviceName match when the user set ANDROID_DEVICE directly.
       androidFiltered = candidates.filter((t) => t.deviceName === androidDevice);
       if (androidFiltered.length === 0) {
         // Pinned by exact Metro name but no candidate matched — fail fast.