@deeeed/metamask-harness 0.2.0 → 0.3.0

package/{orchestration → adapters}/manifest.json

@@ -1,26 +1,50 @@
 {
   "schemaVersion": 1,
-  "description": "Orchestration feature surface: one entry per feature script. orchestration/doctor.mjs verifies every entry point exists, answers --help with exit 0, and that no orchestration script is missing from this manifest.",
+  "description": "Adapter feature surface: one entry per feature script. scripts/adapter-surface-doctor.mjs verifies every entry point exists, answers --help with exit 0, and that no adapter script is missing from this manifest.",
   "features": [
     {
-      "id": "mobile/launch",
-      "entry": "orchestration/mobile/launch.sh",
+      "id": "mobile/yarn-setup",
+      "entry": "adapters/mobile/yarn-setup.sh",
       "kind": "bash",
-      "purpose": "Mobile instance identity intake (port/simulator/adb/runtime-dir tuple) + prepare/preflight launch.",
-      "inputs": "--target --platform --preflight-mode --port|--watcher-port|--cdp-port --simulator --adb-serial --runtime-dir --wallet-setup/--no-wallet-setup --wallet-fixture --artifacts-dir; env WATCHER_PORT>METRO_PORT>CDP_PORT, IOS_SIMULATOR>SIM_UDID, ADB_SERIAL>ANDROID_SERIAL, RECIPE_RUNTIME_DIR, RECIPE_HARNESS_MOBILE_PREFLIGHT_MODE",
-      "outputs": "<artifacts>/summary.json, runtime-status.json, logs/prepare.log; exit 0/1/2"
+      "purpose": "Install node_modules for a MetaMask Mobile checkout (yarn setup + pod install on iOS).",
+      "inputs": "--target <metamask-mobile dir>; env MOBILE_SKIP_POD_INSTALL",
+      "outputs": "node_modules + ios/Pods; exit 0/1/2"
     },
     {
-      "id": "mobile/live",
-      "entry": "orchestration/mobile/live.sh",
+      "id": "mobile/start-metro",
+      "entry": "adapters/mobile/start-metro.sh",
       "kind": "bash",
-      "purpose": "Launch-then-verify chaining for one mobile slot run (verify gets --no-auto-start).",
-      "inputs": "--target --platform --preflight-mode --artifacts-dir --wallet-setup/--no-wallet-setup --wallet-fixture",
-      "outputs": "<artifacts>/summary.json + launch/ + verify/; exit 0/1/2"
+      "purpose": "Ensure the Metro bundler is running for a MetaMask Mobile checkout (start, restart, or skip if valid).",
+      "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/prewarm-bundle",
+      "entry": "adapters/mobile/prewarm-bundle.sh",
+      "kind": "bash",
+      "purpose": "Curl the Metro bundle URL before the dev client opens to pre-compile and cache the bundle.",
+      "inputs": "--platform ios|android --target --port; env MOBILE_BUNDLE_PREWARM, MOBILE_BUNDLE_PREWARM_TIMEOUT",
+      "outputs": "progress on stderr; exit 0 bundle ready / 1 timeout / 2 bad args"
+    },
+    {
+      "id": "mobile/open-device",
+      "entry": "adapters/mobile/open-device.sh",
+      "kind": "bash",
+      "purpose": "Open the MetaMask Mobile dev client on a simulator or device via expo-development-client deep link.",
+      "inputs": "--platform ios|android --target --simulator --adb-serial --preflight-mode --port; env IOS_SIMULATOR, SIM_UDID, ADB_SERIAL, MOBILE_PREFLIGHT_MODE, WATCHER_PORT",
+      "outputs": "progress on stderr; exit 0 opened / 1 open failed / 2 bad args"
+    },
+    {
+      "id": "mobile/wait-for-bridge",
+      "entry": "adapters/mobile/wait-for-bridge.sh",
+      "kind": "bash",
+      "purpose": "Poll the CDP bridge (cdp-bridge.cjs status) until a route target registers; progressive diagnostics on failure.",
+      "inputs": "--target --port --max-polls; env WATCHER_PORT, MOBILE_BRIDGE_READY_POLLS",
+      "outputs": "progress on stderr; exit 0 bridge ready / 1 timeout"
     },
     {
       "id": "mobile/inject",
-      "entry": "orchestration/mobile/inject.sh",
+      "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",
@@ -28,15 +52,23 @@
     },
     {
       "id": "mobile/cleanup",
-      "entry": "orchestration/mobile/cleanup.sh",
+      "entry": "adapters/mobile/cleanup.sh",
       "kind": "bash",
       "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",
+      "entry": "adapters/mobile/verify.sh",
+      "kind": "bash",
+      "purpose": "Verify the mobile harness/runtime is present and healthy (no app launch).",
+      "inputs": "--target --artifacts-dir --static-only --platform ios|android --preflight-mode --no-auto-start",
+      "outputs": "verify report + evidence; exit 0/1/2"
+    },
     {
       "id": "extension/launch",
-      "entry": "orchestration/extension/launch.sh",
+      "entry": "adapters/extension/launch.sh",
       "kind": "bash",
       "purpose": "Run the caller-supplied prepare command for one slot, then confirm app-control readiness.",
       "inputs": "--target --cdp-port --prepare-cmd --artifacts-dir; env RECIPE_HARNESS_EXTENSION_LAUNCH_CMD",
@@ -44,15 +76,23 @@
     },
     {
       "id": "extension/live",
-      "entry": "orchestration/extension/live.sh",
+      "entry": "adapters/extension/live.sh",
       "kind": "bash",
       "purpose": "Sequencer: builds the prepare command from the named feature scripts, then launch + verify.",
       "inputs": "--target --cdp-port --launch-existing-dist|--start-watch|--prepare-cmd --dist-dir --chrome-user-data-dir --out --artifacts-dir; env RECIPE_HARNESS_CHROME_BIN, RECIPE_WALLET_FIXTURE, RECIPE_HARNESS_LIVE_KEEP",
       "outputs": "<artifacts>/summary.json + launch/ + verify/ + logs/fixture-source.json; exit 0/1/2"
     },
+    {
+      "id": "extension/verify",
+      "entry": "adapters/extension/verify.sh",
+      "kind": "bash",
+      "purpose": "Verify the extension harness/runtime is present and healthy (no app launch).",
+      "inputs": "--target --out --cdp-port --static-only",
+      "outputs": "verify report + evidence; exit 0/1/2"
+    },
     {
       "id": "extension/start-watch",
-      "entry": "orchestration/extension/start-watch.sh",
+      "entry": "adapters/extension/start-watch.sh",
       "kind": "bash",
       "purpose": "Harness-owned webpack watcher: cache clear, dual-writer refusal, compile-marker wait, baseline record.",
       "inputs": "--target --runtime-dir --runner-bin --summary",
@@ -60,7 +100,7 @@
     },
     {
       "id": "extension/console-tail",
-      "entry": "orchestration/extension/console-tail.mjs",
+      "entry": "adapters/extension/console-tail.mjs",
       "kind": "node",
       "purpose": "Live CDP stream of the running extension console (MV3 service worker + UI pages), re-attaching across service-worker churn; hosts the console tmux tab.",
       "inputs": "--cdp-port [--log <file>]",
@@ -68,7 +108,7 @@
     },
     {
       "id": "extension/snapshot-dist",
-      "entry": "orchestration/extension/snapshot-dist.sh",
+      "entry": "adapters/extension/snapshot-dist.sh",
       "kind": "bash",
       "purpose": "Runtime-dist snapshot (rsync, excludes _metadata) with from-git-id freshness guard.",
       "inputs": "--dist --runtime-dist --wait-iterations --summary",
@@ -76,7 +116,7 @@
     },
     {
       "id": "extension/seed-fixture",
-      "entry": "orchestration/extension/seed-fixture.sh",
+      "entry": "adapters/extension/seed-fixture.sh",
       "kind": "bash",
       "purpose": "Wallet fixture resolution chain + generate/prefill (pre-launch) and seed-cdp (post-launch) phases.",
       "inputs": "resolve|prefill|seed-cdp; --target --cdp-port --fixture --state --profile --extension-dir --extension-id-file --out --source-out --fixture-script --summary; env RECIPE_WALLET_FIXTURE",
@@ -84,7 +124,7 @@
     },
     {
       "id": "extension/launch-browser",
-      "entry": "orchestration/extension/launch-browser.cjs",
+      "entry": "adapters/extension/launch-browser.cjs",
       "kind": "node",
       "purpose": "Low-level spawn primitive: detached Chrome with isolated profile, CDP on 127.0.0.1, unpacked dist.",
       "inputs": "--cdp-port --chrome-bin --profile --extension-dir --chrome-log --chrome-pid",
@@ -92,7 +132,7 @@
     },
     {
       "id": "extension/refresh-build",
-      "entry": "orchestration/extension/refresh-build.sh",
+      "entry": "adapters/extension/refresh-build.sh",
       "kind": "bash",
       "purpose": "One-shot rebuild for a frozen slot: yarn start, wait for entry points, kill watcher (fresh AND frozen).",
       "inputs": "--repo --watcher-port --timeout --clean-timeout",
@@ -100,7 +140,7 @@
     },
     {
       "id": "extension/ensure-browser",
-      "entry": "orchestration/extension/ensure-browser.sh",
+      "entry": "adapters/extension/ensure-browser.sh",
       "kind": "bash",
       "purpose": "Ensure the slot's Chromium is running against the existing dist/profile/port (kills + relaunches).",
       "inputs": "--slot-id --repo --cdp-port --runtime-dir --watcher-port; env CHROME_USER_DATA_DIR, RECIPE_HARNESS_ROOT",
@@ -108,7 +148,7 @@
     },
     {
       "id": "extension/inject",
-      "entry": "orchestration/extension/inject.mjs",
+      "entry": "adapters/extension/inject.mjs",
       "kind": "node",
       "purpose": "Install the extension harness overlay (delegate, manifests, recipes, helper scripts).",
       "inputs": "--target --no-git-exclude; env RECIPE_HARNESS_ROOT, METAMASK_RUNNER_DIR, METAMASK_RUNNER_PROTOCOL_ROOT>FARMSLOT_ROOT",
@@ -116,7 +156,7 @@
     },
     {
       "id": "extension/cleanup",
-      "entry": "orchestration/extension/cleanup.mjs",
+      "entry": "adapters/extension/cleanup.mjs",
       "kind": "node",
       "purpose": "Remove the extension overlay and exactly the recorded git-exclude entries.",
       "inputs": "--target; env RECIPE_HARNESS_ROOT",
@@ -124,7 +164,7 @@
     },
     {
       "id": "extension/sidepanel-toggle",
-      "entry": "orchestration/extension/sidepanel-toggle.sh",
+      "entry": "adapters/extension/sidepanel-toggle.sh",
       "kind": "bash",
       "purpose": "Window-mode control for the extension instance: chrome.sidePanel status/open/close/toggle/cycle over the instance's CDP port.",
       "inputs": "<status|open|close|toggle|cycle> --cdp-port --ext-id --agent-dir --settle-ms; env REPO, CDP_PORT, EXT_ID, SETTLE_MS, AGENT_DIR",
@@ -132,7 +172,7 @@
     },
     {
       "id": "extension/pin-remote-flags",
-      "entry": "orchestration/extension/pin-remote-flags.cjs",
+      "entry": "adapters/extension/pin-remote-flags.cjs",
       "kind": "lib",
       "purpose": "Pin A/B remote feature-flag variants into an extension manifest _flags before runtime-dist launch.",
       "inputs": "<manifest.json> <KEY=VARIANT[,KEY=VARIANT...]>",
@@ -140,7 +180,7 @@
     },
     {
       "id": "extension/readiness",
-      "entry": "orchestration/extension/readiness.mjs",
+      "entry": "adapters/extension/readiness.mjs",
       "kind": "node",
       "purpose": "Health probe for one extension instance: dist entry files + live CDP target, repairs <runtime-dir>/extension.id.",
       "inputs": "--target --cdp-port --json; env RECIPE_RUNTIME_DIR",
@@ -148,7 +188,7 @@
     },
     {
       "id": "extension/wallet-fixture-state",
-      "entry": "orchestration/extension/wallet-fixture-state.cjs",
+      "entry": "adapters/extension/wallet-fixture-state.cjs",
       "kind": "node",
       "purpose": "Instance wallet state: generate deterministic state from a fixture, prefill the Chrome profile, seed/validate over CDP.",
       "inputs": "generate|prefill-profile|seed-cdp + flags per usage(); env RECIPE_RUNTIME_DIR",
@@ -156,7 +196,7 @@
     },
     {
       "id": "extension/extension-id",
-      "entry": "orchestration/extension/extension-id.ts",
+      "entry": "src/adapters/extension/extension-id.ts",
       "kind": "module",
       "purpose": "Deterministic CRX id resolution from the loaded dist manifest key (TS module used by the runner CLI).",
       "inputs": "resolveExtensionId(target)",
@@ -164,7 +204,7 @@
     },
     {
       "id": "extension/ensure-ready",
-      "entry": "orchestration/extension/ensure-ready.ts",
+      "entry": "src/adapters/extension/ensure-ready.ts",
       "kind": "module",
       "purpose": "Ensure the extension runtime is attachable (TS module used by the runner CLI).",
       "inputs": "ensureExtensionReady(...)",
@@ -172,7 +212,7 @@
     },
     {
       "id": "extension/runtime",
-      "entry": "orchestration/extension/runtime.ts",
+      "entry": "src/adapters/extension/runtime.ts",
       "kind": "module",
       "purpose": "Extension runtime prepare/health over CDP (TS module used by the runner CLI).",
       "inputs": "prepareExtensionRuntime/checkExtensionRuntimeHealth",
@@ -180,7 +220,7 @@
     },
     {
       "id": "extension/runtime-decision",
-      "entry": "orchestration/extension/runtime-decision.ts",
+      "entry": "src/adapters/extension/runtime-decision.ts",
       "kind": "module",
       "purpose": "Cache/deps baseline + readiness decision (TS module used by the runner CLI).",
       "inputs": "decideExtensionReadiness(...)",
@@ -188,7 +228,7 @@
     },
     {
       "id": "mobile/runtime-decision",
-      "entry": "orchestration/mobile/runtime-decision.ts",
+      "entry": "src/adapters/mobile/runtime-decision.ts",
       "kind": "module",
       "purpose": "Mobile deps + Metro bundle readiness decision (parity with extension runtime-decision).",
       "inputs": "decideMobileReadiness(...)",
@@ -196,7 +236,7 @@
     },
     {
       "id": "mobile/deps-markers",
-      "entry": "orchestration/mobile/deps-markers.ts",
+      "entry": "src/adapters/mobile/deps-markers.ts",
       "kind": "module",
       "purpose": "MetaMask Mobile product/native marker tables for harness deps-readiness.",
       "inputs": "mobileProductMarkers(platform?)",
@@ -204,7 +244,7 @@
     },
     {
       "id": "core/inject",
-      "entry": "orchestration/core/inject.sh",
+      "entry": "adapters/core/inject.sh",
       "kind": "bash",
       "purpose": "Headless core adapter install: overlay metadata + runner delegate only (no product writes).",
       "inputs": "--target; env RECIPE_HARNESS_ROOT, METAMASK_RUNNER_PROTOCOL_ROOT>FARMSLOT_ROOT",
@@ -212,7 +252,7 @@
     },
     {
       "id": "core/cleanup",
-      "entry": "orchestration/core/cleanup.sh",
+      "entry": "adapters/core/cleanup.sh",
       "kind": "bash",
       "purpose": "Remove the core overlay dir (idempotent; nothing to restore).",
       "inputs": "--target; env RECIPE_HARNESS_ROOT",
@@ -220,7 +260,7 @@
     },
     {
       "id": "lib/harness-path",
-      "entry": "orchestration/lib/harness-path.sh",
+      "entry": "adapters/shared/harness-path.sh",
       "kind": "lib",
       "purpose": "THE one sourceable lib: harness root/dir + runtime dir resolution with path validation.",
       "inputs": "env RECIPE_HARNESS_ROOT, RECIPE_RUNTIME_DIR (validated relative paths)",
@@ -228,7 +268,7 @@
     },
     {
       "id": "lib/hash-helpers",
-      "entry": "orchestration/lib/hash-helpers.sh",
+      "entry": "adapters/shared/hash-helpers.sh",
       "kind": "lib",
       "purpose": "Overlay file hash markers (digest_file/digest_stdin/hash_path) for safe re-install/cleanup.",
       "inputs": "TARGET env var (hash_path)",
@@ -236,23 +276,15 @@
     },
     {
       "id": "lib/json-field",
-      "entry": "orchestration/lib/json-field.sh",
+      "entry": "adapters/shared/json-field.sh",
       "kind": "lib",
       "purpose": "read_runtime_context_field: dotted-path JSON reader for harness scripts.",
       "inputs": "json path + dotted field",
       "outputs": "field value on stdout"
     },
-    {
-      "id": "lib/recipe-paths",
-      "entry": "orchestration/lib/recipe-paths.mjs",
-      "kind": "lib",
-      "purpose": "ESM mirror of harness-path defaults/validation for node scripts.",
-      "inputs": "env RECIPE_HARNESS_ROOT, RECIPE_RUNTIME_DIR",
-      "outputs": "recipeHarnessRoot()/recipeRuntimeDir() exports"
-    },
     {
       "id": "lib/activate-repo-node",
-      "entry": "orchestration/lib/activate-repo-node.sh",
+      "entry": "adapters/shared/activate-repo-node.sh",
       "kind": "lib",
       "purpose": "Manager-agnostic Node pin from .nvmrc / .tool-versions for non-interactive yarn/webpack spawns (tmux, nohup).",
       "inputs": "activate_repo_node [target-dir]; tries asdf, fnm, mise, nvm, then matching node on PATH",
@@ -260,7 +292,7 @@
     },
     {
       "id": "lib/ensure-runner-deps",
-      "entry": "orchestration/lib/ensure-runner-deps.sh",
+      "entry": "adapters/shared/ensure-runner-deps.sh",
       "kind": "lib",
       "purpose": "Idempotent install of runner npm deps (@farmslot/recipe-harness) for cloned checkouts with no node_modules; uses npm so parent product .yarnrc.yml does not block install.",
       "inputs": "ensure-runner-deps.sh [RUNNER_DIR]; env FARMSLOT_ROOT / METAMASK_RUNNER_PROTOCOL_ROOT optional local link target",
@@ -268,55 +300,39 @@
     },
     {
       "id": "lib/resolve-farmslot-ports",
-      "entry": "orchestration/lib/resolve-farmslot-ports.sh",
+      "entry": "adapters/shared/resolve-farmslot-ports.sh",
       "kind": "lib",
       "purpose": "Resolve CDP + watcher ports from farmslot pool JSON by repo path, else 6660+N / 9010+N.",
       "inputs": "resolve_extension_runtime_ports <repo>",
       "outputs": "CDP_PORT / WATCHER_PORT / SLOT_ID lines on stdout"
     },
+    {
+      "id": "lib/sync-wallet-fixture",
+      "entry": "adapters/shared/sync-wallet-fixture.sh",
+      "kind": "bash",
+      "purpose": "Copy wallet fixture to the canonical runtime slot after overlay install.",
+      "inputs": "--target <checkout> --slot-id <id> --cdp-port <port>",
+      "outputs": "wallet-fixture.json in runtime dir; exit 0 always (non-zero = informational, no source found)"
+    },
     {
       "id": "lib/path-defaults",
-      "entry": "orchestration/lib/path-defaults.json",
+      "entry": "adapters/shared/path-defaults.json",
       "kind": "data",
       "purpose": "Single source for the default harness root and runtime dir.",
       "inputs": "none",
       "outputs": "recipeHarnessRoot / recipeRuntimeDir defaults"
     },
-    {
-      "id": "lib/cli-color",
-      "entry": "orchestration/lib/cli-color.mjs",
-      "kind": "lib",
-      "purpose": "Shared ANSI styling for recipe CLI human output (NO_COLOR / TTY aware).",
-      "inputs": "import { color, colorLogEvent, ... }",
-      "outputs": "styled strings for home, logs, and progress views"
-    },
-    {
-      "id": "lib/cli-home",
-      "entry": "orchestration/lib/cli-home.mjs",
-      "kind": "lib",
-      "purpose": "Recipe CLI home screen and ports output for mm-recipe / mme-recipe wrappers.",
-      "inputs": "--adapter extension|mobile --target --cdp-port --watcher-port [--harness-stale] [--json]",
-      "outputs": "human home/ports screen or JSON payload on stdout"
-    },
     {
       "id": "lib/cli-ux",
-      "entry": "orchestration/lib/cli-ux.sh",
+      "entry": "adapters/shared/cli-ux.sh",
       "kind": "lib",
       "purpose": "Shared bash UX helpers: progress, log-tui watch, failure playbooks, harness stale warnings.",
-      "inputs": "sourced by bin/mm-recipe and bin/mme-recipe",
+      "inputs": "sourced by adapters that invoke recipe CLI commands",
       "outputs": "recipe_progress / recipe_watch_rebuild_log / recipe_failure_playbook functions"
     },
-    {
-      "id": "lib/cli-version",
-      "entry": "orchestration/lib/cli-version.mjs",
-      "kind": "node",
-      "purpose": "Detect stale installed harness scripts vs the active runner revision.",
-      "inputs": "check --runner-root --manifest [--installed-sha] [--json]",
-      "outputs": "stale boolean + details on stdout/stderr; exit 0"
-    },
     {
       "id": "lib/log-tui",
-      "entry": "orchestration/lib/log-tui.mjs",
+      "entry": "adapters/shared/log-tui.mjs",
       "kind": "node",
       "purpose": "Compact build-log UX: last N significant events plus pointer to full log.",
       "inputs": "watch|tail|events --log <path> [--events <n>] [--mode compact|full|quiet] [--json]",
@@ -324,31 +340,15 @@
     },
     {
       "id": "lib/open-debug",
-      "entry": "orchestration/lib/open-debug.mjs",
+      "entry": "adapters/shared/open-debug.mjs",
       "kind": "node",
       "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": "lib/progress",
-      "entry": "orchestration/lib/progress.mjs",
-      "kind": "node",
-      "purpose": "Structured progress events for long recipe CLI operations (emit/done).",
-      "inputs": "emit|done --verb --phase|--status --message [--elapsed-ms] [--json]",
-      "outputs": "human or JSONL progress line on stderr"
-    },
-    {
-      "id": "lib/cli-commands",
-      "entry": "orchestration/lib/cli-commands.mjs",
-      "kind": "lib",
-      "purpose": "Single source of truth for recipe CLI command/flag completion metadata.",
-      "inputs": "dump|describe|flags|args|global-flags --adapter extension|mobile|shim",
-      "outputs": "completion tokens on stdout for shell scripts"
-    },
     {
       "id": "compat-overlays/mobile",
-      "entry": "orchestration/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)",

package/{library/actions → adapters}/mobile/bridge-runtime/cdp-bridge.cjs

@@ -4,10 +4,10 @@
  * CDP Bridge — Connect to the running MetaMask app via Hermes Chrome DevTools Protocol.
  *
  * Usage:
- *   node library/actions/mobile/bridge-runtime/cdp-bridge.cjs navigate PerpsMarketListView
- *   node library/actions/mobile/bridge-runtime/cdp-bridge.cjs get-route
- *   node library/actions/mobile/bridge-runtime/cdp-bridge.cjs get-state "engine.backgroundState.NetworkController"
- *   node library/actions/mobile/bridge-runtime/cdp-bridge.cjs eval "1+1"
+ *   node adapters/mobile/bridge-runtime/cdp-bridge.cjs navigate PerpsMarketListView
+ *   node adapters/mobile/bridge-runtime/cdp-bridge.cjs get-route
+ *   node adapters/mobile/bridge-runtime/cdp-bridge.cjs get-state "engine.backgroundState.NetworkController"
+ *   node adapters/mobile/bridge-runtime/cdp-bridge.cjs eval "1+1"
  *
  * Environment:
  *   WATCHER_PORT  Metro port (default: 8081, read from .js.env if present)
@@ -597,7 +597,7 @@ async function main() {
     console.log(`CDP Bridge — interact with the running MetaMask app via Hermes CDP
 
 Usage:
-  node library/actions/mobile/bridge-runtime/cdp-bridge.cjs <command> [args...]
+  node adapters/mobile/bridge-runtime/cdp-bridge.cjs <command> [args...]
 
 Commands:
   navigate <RouteName> [params-json]   Navigate to a screen

package/{orchestration → adapters}/mobile/cleanup.sh

@@ -34,14 +34,14 @@ done
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 TARGET="$(cd "$TARGET" && pwd)"
 # shellcheck disable=SC1091
-. "$SCRIPT_DIR/../lib/hash-helpers.sh"
+. "$SCRIPT_DIR/../shared/hash-helpers.sh"
 # shellcheck disable=SC1091
-for _hp in "$SCRIPT_DIR/../lib/harness-path.sh"; do
+for _hp in "$SCRIPT_DIR/../shared/harness-path.sh"; do
   [ -f "$_hp" ] && { . "$_hp"; break; }
 done
 unset _hp
 if ! command -v harness_root >/dev/null 2>&1; then
-  echo "mm-harness: shared lib orchestration/lib/harness-path.sh not found; reinstall the runner." >&2
+  echo "mm-harness: shared lib adapters/shared/harness-path.sh not found; reinstall the runner." >&2
   exit 1
 fi
 HARNESS_DIR="$(harness_dir "$TARGET" mobile)"

package/{orchestration → adapters}/mobile/inject.sh

@@ -42,21 +42,21 @@ done
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 RUNNER_DIR="$(cd "${SCRIPT_DIR}/../.." && pwd -P)"
-ADAPTER_DIR="$RUNNER_DIR/library/actions/mobile"
-# compat-overlays: NOT applied here. orchestration/compat-overlays/ holds
+ADAPTER_DIR="$RUNNER_DIR/adapters/mobile"
+# compat-overlays: NOT applied here. adapters/mobile/overlay/compat/ holds
 # reversible patches applied only when injecting into HISTORICAL checkouts
 # (replay/eval against old product commits, e.g. pre-RN-0.81 mobile); the
 # operator/recipe-harness skill applies them manually before the rebuild.
-# See orchestration/compat-overlays/README.md.
+# See adapters/mobile/overlay/compat/README.md.
 # shellcheck disable=SC1091
-. "$SCRIPT_DIR/../lib/hash-helpers.sh"
+. "$SCRIPT_DIR/../shared/hash-helpers.sh"
 # shellcheck disable=SC1091
-for _hp in "$SCRIPT_DIR/../lib/harness-path.sh"; do
+for _hp in "$SCRIPT_DIR/../shared/harness-path.sh"; do
   [ -f "$_hp" ] && { . "$_hp"; break; }
 done
 unset _hp
 if ! command -v harness_root >/dev/null 2>&1; then
-  echo "mm-harness: shared lib orchestration/lib/harness-path.sh not found; reinstall the runner." >&2
+  echo "mm-harness: shared lib adapters/shared/harness-path.sh not found; reinstall the runner." >&2
   exit 1
 fi
 TARGET="$(cd "$TARGET" && pwd)"
@@ -134,7 +134,7 @@ install_v1_runner_assets() {
   # quote — cannot break the generated wrapper or inject at runtime.
   local runner_protocol_root_q runner_exec_q target_q
   runner_protocol_root_q="$(printf '%q' "$METAMASK_RUNNER_PROTOCOL_ROOT")"
-  runner_exec_q="$(printf '%q' "$METAMASK_RUNNER_DIR/orchestration/porcelain/metamask-recipe")"
+  runner_exec_q="$(printf '%q' "$METAMASK_RUNNER_DIR/bin/mm-harness")"
   target_q="$(printf '%q' "$TARGET")"
   {
     printf '%s\n' '#!/usr/bin/env bash'
@@ -175,8 +175,8 @@ install_v1_runner_assets() {
       printf 'export FARMSLOT_ROOT=${FARMSLOT_ROOT:-%s}\n' "$runner_protocol_root_q"
     fi
     printf 'exec %s "$@"\n' "$runner_exec_q"
-  } > "$HARNESS_DIR/runner/bin/metamask-recipe"
-  chmod +x "$HARNESS_DIR/runner/bin/metamask-recipe"
+  } > "$HARNESS_DIR/runner/bin/mm-harness"
+  chmod +x "$HARNESS_DIR/runner/bin/mm-harness"
   if [ -n "$METAMASK_RUNNER_PROTOCOL_ROOT" ]; then
     printf '%s\n' "$METAMASK_RUNNER_PROTOCOL_ROOT" > "$HARNESS_DIR/runner/.farmslot-root"
   fi
@@ -199,19 +199,19 @@ install_v1_runner_assets() {
   # 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.
-  if [ -d "$METAMASK_RUNNER_DIR/orchestration/mobile" ]; then
+  if [ -d "$METAMASK_RUNNER_DIR/adapters/mobile" ]; then
     mkdir -p "$HARNESS_DIR/scripts"
-    cp "$METAMASK_RUNNER_DIR/orchestration/mobile/launch.sh" "$HARNESS_DIR/scripts/launch.sh"
-    cp "$METAMASK_RUNNER_DIR/orchestration/mobile/live.sh" "$HARNESS_DIR/scripts/live.sh"
-    cp "$METAMASK_RUNNER_DIR/runner/mobile/verify.sh" "$HARNESS_DIR/scripts/verify.sh"
+    # launch and live orchestration is now in-process (src/harness.ts + src/adapters/mobile/prepare.ts).
+    # Remove any copies left by older installs so stale scripts cannot shadow the in-process path.
+    rm -f "$HARNESS_DIR/scripts/launch.sh" "$HARNESS_DIR/scripts/live.sh"
+    cp "$METAMASK_RUNNER_DIR/adapters/mobile/verify.sh" "$HARNESS_DIR/scripts/verify.sh"
     mkdir -p "$HARNESS_DIR/scripts/lib"
-    cp "$METAMASK_RUNNER_DIR/orchestration/lib/harness-path.sh" "$HARNESS_DIR/scripts/lib/harness-path.sh"
-    cp "$METAMASK_RUNNER_DIR/orchestration/lib/path-defaults.json" "$HARNESS_DIR/scripts/lib/path-defaults.json"
-    cp "$METAMASK_RUNNER_DIR/orchestration/lib/recipe-paths.mjs" "$HARNESS_DIR/scripts/lib/recipe-paths.mjs"
+    cp "$METAMASK_RUNNER_DIR/adapters/shared/harness-path.sh" "$HARNESS_DIR/scripts/lib/harness-path.sh"
+    cp "$METAMASK_RUNNER_DIR/adapters/shared/path-defaults.json" "$HARNESS_DIR/scripts/lib/path-defaults.json"
     chmod -R u+rwX,go+rX "$HARNESS_DIR/scripts"
     find "$HARNESS_DIR/scripts" -type f \( -name '*.sh' -o -name '*.cjs' -o -name '*.mjs' \) -exec chmod +x {} +
   fi
-  if [ ! -x "$HARNESS_DIR/runner/bin/metamask-recipe" ]; then
+  if [ ! -x "$HARNESS_DIR/runner/bin/mm-harness" ]; then
     echo "Refusing mobile recipe harness install: failed to make runner executable." >&2
     return 1
   fi
@@ -288,10 +288,8 @@ if [ "$FORCE_OVERLAY" = false ] && has_product_owned_mobile_harness; then
       target,
       protocolVersion: "v1",
       actionManifestPath: harnessRel + "/action-manifest.json",
-      runnerEntrypoint: harnessRel + "/runner/bin/metamask-recipe",
+      runnerEntrypoint: harnessRel + "/runner/bin/mm-harness",
       runtimeHelpers: {
-        launch: harnessRel + "/scripts/launch.sh",
-        live: harnessRel + "/scripts/live.sh",
         verify: harnessRel + "/scripts/verify.sh"
       },
       installedPaths: [],
@@ -527,7 +525,7 @@ install_v1_runner_assets
 
 mkdir -p "$TARGET/app/dev-tools/AgenticService"
 while IFS= read -r -d '' overlay_file; do
-  rel="${overlay_file#$ADAPTER_DIR/app-overlay/app/dev-tools/AgenticService/}"
+  rel="${overlay_file#$ADAPTER_DIR/overlay/app/dev-tools/AgenticService/}"
   dest_rel="${rel%.patch}"
   dest="$TARGET/app/dev-tools/AgenticService/$dest_rel"
   mkdir -p "$(dirname "$dest")"
@@ -537,7 +535,7 @@ while IFS= read -r -d '' overlay_file; do
   # Exclude overlay *.test.* files: they are source tests for the overlay
   # templates and must not ship into the product checkout, where the product's
   # jest could pick them up on local runs.
-done < <(find "$ADAPTER_DIR/app-overlay/app/dev-tools/AgenticService" -type f ! -name '*.test.*' -print0)
+done < <(find "$ADAPTER_DIR/overlay/app/dev-tools/AgenticService" -type f ! -name '*.test.*' -print0)
 
 node - "$TARGET" <<'NODE'
 const fs = require('fs');
@@ -654,7 +652,7 @@ node -e '
     target,
     protocolVersion: "v1",
     actionManifestPath: harnessRel + "/action-manifest.json",
-    runnerEntrypoint: harnessRel + "/runner/bin/metamask-recipe",
+    runnerEntrypoint: harnessRel + "/runner/bin/mm-harness",
     runtimeHelpers: {
       launch: harnessRel + "/scripts/launch.sh",
       live: harnessRel + "/scripts/live.sh",
@@ -673,7 +671,7 @@ node -e '
   fs.writeFileSync(manifestPath, JSON.stringify(m, null, 2) + "\n");
 ' "$RUNNER_DIR" "$SOURCE_REV" "$METAMASK_RUNNER_DIR" "$METAMASK_RUNNER_REVISION" "$METAMASK_RUNNER_SOURCE_KIND" "$ADAPTER_DIR" "$TARGET" "$BACKUP_DIR" "$SCRIPT_DIR" "$HARNESS_DIR/manifest.json" "${MOBILE_AGENTIC_SOURCE:-}" "$HARNESS_ROOT" "$HARNESS_REL" "$CLEANUP_COMMAND"
 
-ENSURE_DEPS="$SCRIPT_DIR/../lib/ensure-runner-deps.sh"
+ENSURE_DEPS="$SCRIPT_DIR/../shared/ensure-runner-deps.sh"
 if [ -f "$ENSURE_DEPS" ]; then
   bash "$ENSURE_DEPS" "$RUNNER_DIR"
 fi