@deeeed/metamask-harness 0.40.0 → 0.41.0

package/library/recipes/mobile/perps/performance.recipe.json

@@ -1,41 +1,695 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
-  "title": "MetaMask Mobile Perps performance recipe",
-  "description": "Canonical measured MetaMask Mobile Perps recipe. The graph unlocks the wallet, records stable status, opens the market list, reads live state, and opens market detail. Timings live in trace.json. Run pinned so numbers are comparable: `mm-harness run perps.performance --device <serial> --heal off`. Testnet order placement is omitted to keep the recipe repeatable and non-destructive.",
+  "title": "MetaMask Perps loading lifecycle performance",
+  "description": "The single platform-neutral Perps loading recipe. Parameters select account, content, lifecycle, network, endpoint mode, and sample identity; Android and iOS use the same graph. It proves visible content and captures Perps bootstrap, market, account, and live-stream evidence while setup stays outside the evidence window.",
+  "paramsSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["account"],
+    "properties": {
+      "account": {
+        "type": "string",
+        "description": "Exact fixture account name, such as Trading or dev3."
+      },
+      "content_variant": {
+        "type": "string",
+        "enum": ["positions", "trending"],
+        "default": "positions",
+        "description": "Measure a position-owning account or an independently proven empty account showing generic markets."
+      },
+      "initial_account": {
+        "type": "string",
+        "default": "dev2",
+        "description": "Source account used only by the account-switch lifecycle."
+      },
+      "initial_content_variant": {
+        "type": "string",
+        "enum": ["positions", "trending"],
+        "default": "trending",
+        "description": "Proven source-account state for account switching."
+      },
+      "provider": {
+        "type": "string",
+        "default": "hyperliquid"
+      },
+      "initial_network": {
+        "type": "string",
+        "enum": ["mainnet", "testnet"],
+        "default": "mainnet"
+      },
+      "target_network": {
+        "type": "string",
+        "enum": ["mainnet", "testnet"],
+        "default": "testnet"
+      },
+      "market": {
+        "type": "string",
+        "default": "BTC",
+        "description": "Exact visible position market symbol."
+      },
+      "lifecycle": {
+        "type": "string",
+        "enum": [
+          "navigate_return",
+          "cold_disk_cache",
+          "cold_no_cache",
+          "background_short",
+          "background_reconnect",
+          "account_switch",
+          "network_switch"
+        ],
+        "default": "cold_no_cache",
+        "description": "One lifecycle invariant exercised by this sample."
+      },
+      "sample_id": {
+        "type": "string",
+        "default": "sample",
+        "description": "Artifact-local sample identifier."
+      },
+      "snapshot_endpoint_mode": {
+        "type": "string",
+        "enum": ["deployed", "local"],
+        "default": "deployed",
+        "description": "Whether the current build uses its configured deployed endpoint or an explicitly routed local snapshot endpoint."
+      },
+      "snapshot_port": {
+        "type": "number",
+        "default": 3000,
+        "description": "Host port used only by the explicitly routed local snapshot endpoint."
+      }
+    }
+  },
   "workflow": {
-    "entry": "ensure-unlocked",
+    "entry": "ensure-wallet",
     "nodes": {
-      "open-perps-list": {
+      "ensure-wallet": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "target_timeout_ms": 90000,
+        "unlock_timeout_ms": 90000,
+        "stable_unlocked_ms": 0,
+        "intent": "Restore the already-provisioned fixture wallet without rerunning onboarding outside timing",
+        "next": "select-sample-account"
+      },
+      "select-sample-account": {
+        "action": "metamask.wallet.select_account",
+        "name": "{{params.account}}",
+        "cdp_timeout_ms": 30000,
+        "timeout_ms": 30000,
+        "intent": "Select the exact fixture account outside timing rather than relying on prior device state",
+        "next": "select-content-context-reset"
+      },
+      "select-content-context-reset": {
+        "action": "switch",
+        "value": "{{params.content_variant}}",
+        "equals": "trending",
+        "cases": {
+          "match": "clear-empty-account-caches"
+        },
+        "default": "select-network-target-preflight",
+        "intent": "Reconstruct Perps context only for the independently empty account used by the market lane"
+      },
+      "clear-empty-account-caches": {
+        "action": "metamask.perps.clear_performance_caches",
+        "intent": "Remove prior-account Perps memory and disk data before proving the empty account",
+        "next": "restart-empty-account-context"
+      },
+      "restart-empty-account-context": {
+        "action": "app.lifecycle",
+        "command": "restart",
+        "settle_ms": 0,
+        "runtime_ready_timeout_ms": 90000,
+        "timeout_ms": 120000,
+        "intent": "Construct controllers against the selected empty account outside the measurement window",
+        "next": "unlock-empty-account-context"
+      },
+      "unlock-empty-account-context": {
+        "action": "metamask.wallet.ensure_unlocked",
+        "target_timeout_ms": 90000,
+        "unlock_timeout_ms": 90000,
+        "intent": "Restore and prove the selected empty account after the setup-only process restart outside measurement",
+        "next": "select-network-target-preflight"
+      },
+      "select-network-target-preflight": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "network_switch",
+        "cases": {
+          "match": "prepare-target-network-preflight"
+        },
+        "default": "prepare-initial-state-preflight",
+        "intent": "Inspect the target-network position before changing to the measured source network"
+      },
+      "prepare-initial-state-preflight": {
+        "action": "metamask.perps.start_state",
+        "account": "{{params.account}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.initial_network}}",
+        "page": "home",
+        "positions": false,
+        "orders": false,
+        "timeout_ms": 120000,
+        "intent": "Initialize the exact Perps account, provider, and network outside timing before asserting its real position",
+        "next": "select-content-precondition"
+      },
+      "prepare-target-network-preflight": {
+        "action": "metamask.perps.start_state",
+        "account": "{{params.account}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.target_network}}",
+        "page": "home",
+        "positions": false,
+        "orders": false,
+        "timeout_ms": 120000,
+        "intent": "Set the target network outside timing only so its existing position can be proven",
+        "next": "select-content-precondition"
+      },
+      "select-content-precondition": {
+        "action": "switch",
+        "value": "{{params.content_variant}}",
+        "equals": "trending",
+        "cases": {
+          "match": "assert-no-positions"
+        },
+        "default": "assert-position",
+        "intent": "Prove either the existing position or the empty account before timing"
+      },
+      "assert-no-positions": {
+        "action": "metamask.perps.assert_positions",
+        "state": "none",
+        "mode": "all",
+        "timeout_ms": 30000,
+        "intent": "Prove the market-only account has no open positions",
+        "next": "assert-no-orders"
+      },
+      "assert-no-orders": {
+        "action": "metamask.perps.assert_orders",
+        "state": "none",
+        "mode": "all",
+        "timeout_ms": 30000,
+        "intent": "Prove the market-only account has no open orders",
+        "next": "select-account-switch-preparation"
+      },
+      "assert-position": {
+        "action": "metamask.perps.assert_positions",
+        "market": "{{params.market}}",
+        "state": "open",
+        "timeout_ms": 30000,
+        "intent": "Prove the real position exists without creating or replacing exchange state",
+        "next": "select-account-switch-preparation"
+      },
+      "select-account-switch-preparation": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "account_switch",
+        "cases": {
+          "match": "select-initial-account"
+        },
+        "default": "select-network-switch-preparation",
+        "intent": "Move to the source account outside timing only for the account-switch lifecycle"
+      },
+      "select-initial-account": {
+        "action": "metamask.wallet.select_account",
+        "name": "{{params.initial_account}}",
+        "cdp_timeout_ms": 30000,
+        "timeout_ms": 30000,
+        "intent": "Prime the source account while preserving the target account's proven position",
+        "next": "select-initial-account-precondition"
+      },
+      "select-initial-account-precondition": {
+        "action": "switch",
+        "value": "{{params.initial_content_variant}}",
+        "equals": "positions",
+        "cases": {
+          "match": "assert-initial-account-position"
+        },
+        "default": "assert-initial-account-no-positions",
+        "intent": "Prove the account-switch source has its declared position state"
+      },
+      "assert-initial-account-position": {
+        "action": "metamask.perps.assert_positions",
+        "market": "{{params.market}}",
+        "state": "open",
+        "timeout_ms": 30000,
+        "intent": "Prove the account-switch source owns the expected position",
+        "next": "open-wallet-home"
+      },
+      "assert-initial-account-no-positions": {
+        "action": "metamask.perps.assert_positions",
+        "state": "none",
+        "mode": "all",
+        "timeout_ms": 30000,
+        "intent": "Prove the account-switch source has no positions before timing",
+        "next": "assert-initial-account-no-orders"
+      },
+      "assert-initial-account-no-orders": {
+        "action": "metamask.perps.assert_orders",
+        "state": "none",
+        "mode": "all",
+        "timeout_ms": 30000,
+        "intent": "Prove the account-switch source has no orders before timing",
+        "next": "open-wallet-home"
+      },
+      "select-network-switch-preparation": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "network_switch",
+        "cases": {
+          "match": "prepare-initial-network"
+        },
+        "default": "open-wallet-home",
+        "intent": "Move to the source network outside timing only for the network-switch lifecycle"
+      },
+      "prepare-initial-network": {
+        "action": "metamask.perps.start_state",
+        "account": "{{params.account}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.initial_network}}",
+        "page": "home",
+        "positions": false,
+        "orders": false,
+        "timeout_ms": 120000,
+        "intent": "Prime the source Perps network before the measured switch",
+        "next": "open-wallet-home"
+      },
+      "open-wallet-home": {
         "action": "ui.navigate",
-        "page": "perps",
-        "intent": "Open the Perps market list screen",
-        "next": "read-positions"
+        "page": "home",
+        "timeout_ms": 30000,
+        "intent": "Persist Wallet Home and leave its Perps section available for the lifecycle sample",
+        "next": "reset-homepage-scroll"
+      },
+      "reset-homepage-scroll": {
+        "action": "ui.scroll",
+        "test_id": "wallet-screen",
+        "offset": 0,
+        "animated": false,
+        "timeout_ms": 60000,
+        "intent": "Move the Perps section out of view before the setup visibility proof",
+        "next": "select-account-switch-prime"
+      },
+      "select-account-switch-prime": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "account_switch",
+        "cases": {
+          "match": "select-local-snapshot-preparation"
+        },
+        "default": "start-prime-performance-capture",
+        "intent": "Skip target-content priming while the account-switch source identity is selected"
+      },
+      "start-prime-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "start",
+        "intent": "Open a setup-only log window so resident Homepage content can be proven before lifecycle mutation",
+        "next": "prime-homepage-position"
+      },
+      "prime-homepage-position": {
+        "action": "ui.scroll",
+        "test_id": "wallet-screen",
+        "offset": 600,
+        "animated": true,
+        "timeout_ms": 60000,
+        "intent": "Prime the below-fold position section before the measured lifecycle",
+        "next": "finish-prime-performance-capture"
+      },
+      "finish-prime-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "artifact_prefix": "setup/homepage-{{params.content_variant}}-prime-{{params.sample_id}}",
+        "intent": "Close the setup-only log window; native visibility is proven by the measured UI assertion later in the graph",
+        "next": "select-local-snapshot-preparation"
+      },
+      "select-local-snapshot-preparation": {
+        "action": "switch",
+        "value": "{{params.snapshot_endpoint_mode}}",
+        "equals": "local",
+        "cases": {
+          "match": "prepare-local-snapshot-endpoint"
+        },
+        "default": "select-navigate-return-setup",
+        "intent": "Route a host port only when the configured full-bootstrap endpoint is local"
+      },
+      "prepare-local-snapshot-endpoint": {
+        "action": "metamask.perps.prepare_local_snapshot_endpoint",
+        "port": "{{params.snapshot_port}}",
+        "intent": "Make the configured local Terminal endpoint reachable without an external command node",
+        "next": "select-navigate-return-setup"
       },
-      "read-positions": {
-        "action": "metamask.perps.read_positions",
-        "intent": "Read the live Perps positions shown on the market list",
-        "next": "open-market-detail"
+      "select-navigate-return-setup": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "navigate_return",
+        "cases": {
+          "match": "navigate-away-before-capture"
+        },
+        "default": "start-performance-capture",
+        "intent": "Leave Homepage before arming the warm navigation-return evidence window"
       },
-      "open-market-detail": {
+      "navigate-away-before-capture": {
         "action": "ui.navigate",
-        "page": "perps-market",
-        "market": "BTC",
-        "intent": "Open the BTC Perps market detail screen",
-        "next": "end"
+        "page": "perps",
+        "timeout_ms": 30000,
+        "intent": "Unmount the Homepage section while preserving resident Perps data",
+        "next": "start-performance-capture"
       },
-      "end": {
-        "action": "end",
-        "status": "pass"
+      "start-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "start",
+        "intent": "Start passive app-log capture immediately before the measured lifecycle transition",
+        "next": "select-cold-no-cache"
+      },
+      "select-cold-no-cache": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "cold_no_cache",
+        "cases": {
+          "match": "clear-perps-caches"
+        },
+        "default": "select-cold-disk-cache",
+        "intent": "Choose the cold no-cache transition only for its named lifecycle"
+      },
+      "clear-perps-caches": {
+        "action": "metamask.perps.clear_performance_caches",
+        "intent": "Remove only persisted Perps market and user snapshots while preserving the wallet",
+        "next": "restart-app"
+      },
+      "select-cold-disk-cache": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "cold_disk_cache",
+        "cases": {
+          "match": "restart-app"
+        },
+        "default": "select-background-short",
+        "intent": "Choose the returning cold-process transition only for its named lifecycle"
       },
-      "start-state": {
-        "action": "app.status",
-        "intent": "Record the stable run start status after wallet setup",
-        "next": "open-perps-list"
+      "restart-app": {
+        "action": "app.lifecycle",
+        "command": "restart",
+        "settle_ms": 0,
+        "runtime_ready_timeout_ms": 90000,
+        "timeout_ms": 120000,
+        "intent": "Restart the installed process without rebuilding or replacing wallet state; app-side clocks own the performance boundary",
+        "next": "unlock-after-restart"
       },
-      "ensure-unlocked": {
+      "unlock-after-restart": {
         "action": "metamask.wallet.ensure_unlocked",
-        "intent": "Unlock the wallet before timing the Perps journey",
-        "next": "start-state"
+        "target_timeout_ms": 90000,
+        "unlock_timeout_ms": 90000,
+        "stable_unlocked_ms": 0,
+        "intent": "Restore and prove the existing wallet after process restart without delaying the captured bootstrap window",
+        "next": "scroll-visible-position"
+      },
+      "select-background-short": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "background_short",
+        "cases": {
+          "match": "background-short"
+        },
+        "default": "select-background-reconnect",
+        "intent": "Choose the below-grace-period background transition only for its named lifecycle"
+      },
+      "background-short": {
+        "action": "app.lifecycle",
+        "command": "background",
+        "settle_ms": 3000,
+        "intent": "Keep the process inactive for less than the Perps connection grace period",
+        "next": "foreground-app"
+      },
+      "select-background-reconnect": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "background_reconnect",
+        "cases": {
+          "match": "background-reconnect"
+        },
+        "default": "select-account-switch",
+        "intent": "Choose the beyond-grace-period background transition only for its named lifecycle"
+      },
+      "background-reconnect": {
+        "action": "app.lifecycle",
+        "command": "background",
+        "settle_ms": 25000,
+        "intent": "Keep the process inactive beyond the Perps connection grace period",
+        "next": "foreground-app"
+      },
+      "foreground-app": {
+        "action": "app.lifecycle",
+        "command": "foreground",
+        "settle_ms": 0,
+        "runtime_ready_timeout_ms": 90000,
+        "timeout_ms": 120000,
+        "intent": "Restore the same process without adding an artificial post-foreground timing delay",
+        "next": "scroll-visible-position"
+      },
+      "select-account-switch": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "account_switch",
+        "cases": {
+          "match": "switch-to-target-account"
+        },
+        "default": "select-network-switch",
+        "intent": "Choose the account identity transition only for its named lifecycle"
+      },
+      "switch-to-target-account": {
+        "action": "metamask.wallet.select_account",
+        "name": "{{params.account}}",
+        "cdp_timeout_ms": 30000,
+        "timeout_ms": 30000,
+        "intent": "Switch through the same wallet account-selection action used by a client journey",
+        "next": "scroll-visible-position"
+      },
+      "select-network-switch": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "network_switch",
+        "cases": {
+          "match": "switch-to-target-network"
+        },
+        "default": "select-navigate-return",
+        "intent": "Choose the Perps network/DEX identity transition only for its named lifecycle"
+      },
+      "switch-to-target-network": {
+        "action": "metamask.perps.start_state",
+        "account": "{{params.account}}",
+        "provider": "{{params.provider}}",
+        "network": "{{params.target_network}}",
+        "page": false,
+        "positions": false,
+        "orders": false,
+        "timeout_ms": 120000,
+        "intent": "Switch the real in-app Perps controller context to the target network without mutating exchange state",
+        "next": "scroll-visible-position"
+      },
+      "select-navigate-return": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "navigate_return",
+        "cases": {
+          "match": "navigate-home-for-return"
+        },
+        "default": "invalid-lifecycle",
+        "intent": "Accept the remaining schema-valid warm navigation-return lifecycle"
+      },
+      "navigate-home-for-return": {
+        "action": "ui.navigate",
+        "page": "home",
+        "timeout_ms": 30000,
+        "intent": "Return to Wallet Home inside the evidence window while resident Perps data remains available",
+        "next": "reset-returned-homepage-scroll"
+      },
+      "reset-returned-homepage-scroll": {
+        "action": "ui.scroll",
+        "test_id": "wallet-screen",
+        "offset": 0,
+        "animated": false,
+        "timeout_ms": 60000,
+        "intent": "Force the retained Homepage section out of view before measuring a new warm viewport demand",
+        "next": "settle-returned-homepage-scroll"
+      },
+      "settle-returned-homepage-scroll": {
+        "action": "wait",
+        "duration_ms": 250,
+        "intent": "Allow the passive visibility observer to record the section leaving the viewport",
+        "next": "scroll-visible-position"
+      },
+      "scroll-visible-position": {
+        "action": "ui.scroll",
+        "test_id": "wallet-screen",
+        "offset": 600,
+        "animated": true,
+        "timeout_ms": 60000,
+        "intent": "Demand the below-fold Perps content inside the evidence window",
+        "next": "select-visible-content"
+      },
+      "select-visible-content": {
+        "action": "switch",
+        "value": "{{params.content_variant}}",
+        "equals": "trending",
+        "cases": {
+          "match": "wait-visible-trending"
+        },
+        "default": "wait-visible-position",
+        "intent": "Prove the requested content variant with the same native UI assertion on Android and iOS"
+      },
+      "wait-visible-trending": {
+        "action": "ui.wait_for",
+        "test_id": "homepage-trending-perps-carousel",
+        "expected": "visible",
+        "timeout_ms": 90000,
+        "intent": "Require the generic Perps market carousel to be visibly inside the viewport",
+        "next": "select-resident-finish"
+      },
+      "wait-visible-position": {
+        "action": "ui.wait_for",
+        "test_id": "homepage-perps-positions",
+        "expected": "visible",
+        "timeout_ms": 90000,
+        "intent": "Require the selected account's Perps position content to be visibly inside the viewport",
+        "next": "select-resident-finish"
+      },
+      "select-resident-finish": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "navigate_return",
+        "cases": {
+          "match": "finish-resident-performance-capture"
+        },
+        "default": "select-cold-no-cache-finish",
+        "intent": "Use lifecycle-specific evidence: resident warm data, preloaded cold data, or a post-transition socket delivery"
+      },
+      "select-cold-no-cache-finish": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "cold_no_cache",
+        "cases": {
+          "match": "finish-cold-no-cache-performance-capture"
+        },
+        "default": "select-cold-disk-cache-finish",
+        "intent": "Accept fresh data preloaded after process start but before the Homepage viewport demand only for cold no-cache"
+      },
+      "select-cold-disk-cache-finish": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "cold_disk_cache",
+        "cases": {
+          "match": "finish-cold-disk-cache-performance-capture"
+        },
+        "default": "select-background-short-finish",
+        "intent": "Require disk hydration and immediate first fresh delivery only for the returning cold-process lifecycle"
+      },
+      "select-background-short-finish": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "background_short",
+        "cases": {
+          "match": "finish-background-short-performance-capture"
+        },
+        "default": "select-account-switch-finish",
+        "intent": "Treat a below-grace resume as resident continuity; a new socket tick is optional because the connection remains alive"
+      },
+      "select-account-switch-finish": {
+        "action": "switch",
+        "value": "{{params.lifecycle}}",
+        "equals": "account_switch",
+        "cases": {
+          "match": "select-account-switch-content-finish"
+        },
+        "default": "finish-performance-capture",
+        "intent": "Use target-cache visibility plus fresh takeover without requiring a new process bootstrap"
+      },
+      "select-account-switch-content-finish": {
+        "action": "switch",
+        "value": "{{params.content_variant}}",
+        "equals": "trending",
+        "cases": {
+          "match": "finish-account-switch-empty-performance-capture"
+        },
+        "default": "finish-account-switch-performance-capture",
+        "intent": "Require the target account's declared empty or positioned visible state"
+      },
+      "finish-resident-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "artifact_prefix": "logs/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}",
+        "intent": "Preserve the warm resident capture after native visible-content proof",
+        "next": "capture-position"
+      },
+      "finish-cold-no-cache-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "required_live_streams": ["positions", "orders", "account"],
+        "artifact_prefix": "logs/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}",
+        "wait_timeout_ms": 90000,
+        "intent": "Require complete live account streams after native cold visible-content proof; live prices remain an independent optional milestone",
+        "next": "capture-position"
+      },
+      "finish-cold-disk-cache-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "required_live_streams": ["positions", "orders", "account"],
+        "artifact_prefix": "logs/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}",
+        "wait_timeout_ms": 90000,
+        "intent": "Require complete live account takeover after native cached-content proof",
+        "next": "capture-position"
+      },
+      "finish-background-short-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "artifact_prefix": "logs/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}",
+        "intent": "Preserve the short-resume capture after native resident-content proof; a new socket frame is not required while continuity is retained",
+        "next": "capture-position"
+      },
+      "finish-account-switch-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "required_live_streams": ["positions", "orders", "account"],
+        "artifact_prefix": "logs/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}",
+        "wait_timeout_ms": 90000,
+        "intent": "Require complete live data for the selected target account after native position-content proof",
+        "next": "capture-position"
+      },
+      "finish-account-switch-empty-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "required_live_streams": ["positions", "orders", "account"],
+        "artifact_prefix": "logs/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}",
+        "wait_timeout_ms": 90000,
+        "intent": "Require complete live empty-account data after native trending-content proof",
+        "next": "capture-position"
+      },
+      "finish-performance-capture": {
+        "action": "metamask.perps.capture_performance",
+        "phase": "end",
+        "require_records": false,
+        "required_live_streams": ["positions", "orders", "account"],
+        "artifact_prefix": "logs/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}",
+        "wait_timeout_ms": 90000,
+        "intent": "Require complete post-transition account streams after native visible-content proof",
+        "next": "capture-position"
+      },
+      "capture-position": {
+        "action": "ui.screenshot",
+        "path": "screenshots/perps-{{params.content_variant}}-{{params.lifecycle}}-{{params.sample_id}}.png",
+        "intent": "Preserve the settled native-visible Perps content for this exact lifecycle and sample",
+        "next": "done"
+      },
+      "invalid-lifecycle": {
+        "action": "end",
+        "status": "fail"
+      },
+      "done": {
+        "action": "end",
+        "status": "pass"
       }
     }
   }