@deeeed/metamask-harness 0.2.0 → 0.3.1

package/{runner → adapters}/extension/verify.sh

@@ -49,12 +49,12 @@ fi
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 # shellcheck disable=SC1091
-for _hp in "$SCRIPT_DIR/lib/harness-path.sh" "$SCRIPT_DIR/../../orchestration/lib/harness-path.sh" "$SCRIPT_DIR/../lib/harness-path.sh"; do
+for _hp in "$SCRIPT_DIR/lib/harness-path.sh" "$SCRIPT_DIR/../../adapters/shared/harness-path.sh" "$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 "extension verify: shared lib orchestration/lib/harness-path.sh not found; reinstall the harness." >&2
+  echo "extension verify: shared lib adapters/shared/harness-path.sh not found; reinstall the harness." >&2
   exit 1
 fi
 
@@ -84,7 +84,7 @@ RUNTIME_DIR="$(recipe_runtime_dir)"
 HARNESS_ROOT="$(harness_root)"
 HARNESS_REL="$HARNESS_ROOT/extension"
 HARNESS_DIR="$(harness_dir "$TARGET" extension)"
-RUNNER_BIN="$HARNESS_DIR/runner/bin/metamask-recipe"
+RUNNER_BIN="$HARNESS_DIR/runner/bin/mm-harness"
 # --out (optional): a task-local recipes dir. Resolve it safely within the target
 # (resolve_harness_out rejects absolute/.. escapes) and prefer its smoke recipe so
 # `live --out <dir>` does not silently fall back to the installed default.
@@ -108,22 +108,22 @@ ARTIFACTS="${ARTIFACTS:-$HARNESS_DIR/verify/$(date -u +%Y%m%dT%H%M%SZ)}"
 mkdir -p "$ARTIFACTS/logs"
 EXTENSION_ID_FILE="$TARGET/$RUNTIME_DIR/extension.id"
 # Shared JSON reader: $SCRIPT_DIR/lib when running from the installed copy,
-# else the runner canonical at orchestration/lib.
+# else the runner canonical at adapters/shared.
 # shellcheck disable=SC1091
-for _lib in "$SCRIPT_DIR/lib/json-field.sh" "$SCRIPT_DIR/../../orchestration/lib/json-field.sh"; do
+for _lib in "$SCRIPT_DIR/lib/json-field.sh" "$SCRIPT_DIR/../../adapters/shared/json-field.sh"; do
   [ -f "$_lib" ] && { . "$_lib"; break; }
 done
 unset _lib
 # Fail fast with an actionable message if neither path loaded (e.g. an install that
 # predates the lib co-location), instead of a cryptic later `set -e` abort.
 if ! command -v read_runtime_context_field >/dev/null 2>&1; then
-  echo "extension verify: json-field helper missing (orchestration/lib/json-field.sh). Run metamask-recipe extension prepare --target $TARGET" >&2
+  echo "extension verify: json-field helper missing (adapters/shared/json-field.sh). Run mm-harness extension prepare --target $TARGET" >&2
   exit 1
 fi
 # readiness probe is app control: co-located in installed copies, under
-# orchestration/extension in a repo checkout.
+# adapters/extension in a repo checkout.
 READINESS_MJS=""
-for _r in "$SCRIPT_DIR/readiness.mjs" "$SCRIPT_DIR/../../orchestration/extension/readiness.mjs"; do
+for _r in "$SCRIPT_DIR/readiness.mjs" "$SCRIPT_DIR/../../adapters/extension/readiness.mjs"; do
   [ -f "$_r" ] && { READINESS_MJS="$_r"; break; }
 done
 unset _r
@@ -290,7 +290,7 @@ check_file() {
 
 check_file "$HARNESS_REL/manifest.json"
 check_file "$HARNESS_REL/action-manifest.json"
-check_file "$HARNESS_REL/runner/bin/metamask-recipe"
+check_file "$HARNESS_REL/runner/bin/mm-harness"
 check_file "$HARNESS_REL/runner/manifests/extension.action-manifest.json"
 
 # dist-freshness + build-health now come from the runner's single source of
@@ -327,7 +327,7 @@ const blMsg = bl.status === "ok" ? "webpack compiled."
   : bl.status === "no-watch" ? "no webpack watch log; build-health n/a (e.g. one-shot build)."
   : bl.status === "building" ? "webpack has not reported a successful compile yet."
   : bl.status === "errors" ? (bl.reason === "stale-cache"
-      ? "webpack build failing on a stale cache (ENOENT on a deduped module). Run `metamask-recipe runtime-launch --adapter extension --target <repo> --cdp-port <port>` to auto-clear the cache and rebuild."
+      ? "webpack build failing on a stale cache (ENOENT on a deduped module). Run `mm-harness runtime-launch --adapter extension --target <repo> --cdp-port <port>` to auto-clear the cache and rebuild."
       : "webpack build has errors; fix the source/build before validating.")
   : "build-health unknown.";
 fs.writeFileSync(dir + "/build-health.json", JSON.stringify({ status: bl.status, reason: bl.reason, excerpt: bl.excerpt, message: blMsg }));
@@ -399,7 +399,7 @@ if [ "$STATIC_ONLY" = false ]; then
 
     if (
       cd "$TARGET"
-      "$RUNNER_BIN" manifest --adapter extension --json
+      "$RUNNER_BIN" actions --raw --adapter extension
     ) > "$ARTIFACTS/logs/runner-manifest.json" 2> "$ARTIFACTS/logs/runner-manifest.err"; then
       checks+=("{\"name\":\"runner manifest\",\"status\":\"pass\"}")
     else

package/{orchestration → adapters}/extension/wallet-fixture-state.cjs

@@ -41,8 +41,8 @@ function usage() {
 function pathDefault(key) {
   for (const candidate of [
     path.join(__dirname, 'lib/path-defaults.json'),
-    path.join(__dirname, '../lib/path-defaults.json'),
-    path.join(__dirname, '../../orchestration/lib/path-defaults.json'),
+    path.join(__dirname, '../shared/path-defaults.json'),
+    path.join(__dirname, '../../adapters/shared/path-defaults.json'),
   ]) {
     if (!fs.existsSync(candidate)) continue;
     const value = JSON.parse(fs.readFileSync(candidate, 'utf8'))[key];

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)"