@deeeed/metamask-harness 0.65.0 → 0.66.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## Unreleased
 
+## 0.66.0 - 2026-09-25
+
+### Added
+
+- Observe Top Movers pills and visible counts separately from ordinary market rows.
+- Expose market-filter selection matches from observed controls for composable proof assertions.
+
+### Fixed
+
+- Give Extension Perps smoke its own runtime assertions and refuse a visible tutorial gate.
+- Refuse absence claims on truncated Perps observations and exclude pills clipped by the viewport or scroll containers from Top Movers visible counts.
+- Capture the driven market-search page through the existing surface-capture action.
+
 ## 0.65.0 - 2026-09-25
 
 ### Added

package/library/actions/extension/perps/read_visible_state.mjs

@@ -12,6 +12,12 @@ function pointInside(point, left, top, right, bottom) {
   return point && point.x >= left && point.x <= right && point.y >= top && point.y <= bottom;
 }
 
+export function topMoverFitsVisibleBounds(rect, bounds) {
+  return rect.width > 0 && rect.height > 0 && bounds.every((clip) =>
+    rect.left >= clip.left - 1 && rect.right <= clip.right + 1 &&
+    rect.top >= clip.top - 1 && rect.bottom <= clip.bottom + 1);
+}
+
 export function classifyActionableControlLayout(controls) {
   const bounded = Array.isArray(controls) ? controls.slice(0, 200) : [];
   return {
@@ -42,6 +48,26 @@ export async function readVisiblePerpsState(page, node = {}) {
   const raw = await page.evaluate(`(() => {
     const includeOffscreen = ${JSON.stringify(options.includeOffscreen)};
     const maximum = ${JSON.stringify(options.maxItems)};
+    const topMoverFitsVisibleBounds = ${topMoverFitsVisibleBounds.toString()};
+    const topMoverVisible = (element, rect) => {
+      const bounds = [{ left: 0, top: 0, right: innerWidth, bottom: innerHeight }];
+      for (let ancestor = element.parentElement; ancestor; ancestor = ancestor.parentElement) {
+        const style = getComputedStyle(ancestor);
+        const clipsX = /^(hidden|clip|scroll|auto|overlay)$/.test(style.overflowX);
+        const clipsY = /^(hidden|clip|scroll|auto|overlay)$/.test(style.overflowY);
+        if (!clipsX && !clipsY) continue;
+        const box = ancestor.getBoundingClientRect();
+        const left = box.left + ancestor.clientLeft;
+        const top = box.top + ancestor.clientTop;
+        bounds.push({
+          left: clipsX ? left : -Infinity,
+          right: clipsX ? left + ancestor.clientWidth : Infinity,
+          top: clipsY ? top : -Infinity,
+          bottom: clipsY ? top + ancestor.clientHeight : Infinity,
+        });
+      }
+      return topMoverFitsVisibleBounds(rect, bounds);
+    };
     const relevant = /^(?:perps-|parent-selector-perps-(?:market-list|order-entry)|explore-markets-|market-list-view|market-row-|filter-select-button|sort-dropdown-button|search-input|position-card-|order-card-|transaction-card-|bottom-nav-|back-button|direction-|order-type-|amount-|balance-percent-|leverage-|auto-close|submit-order-button|limit-price-|tp-|sl-|custom-amount-|pay-with-|confirm-footer-button|wallet-initiated-header-back-button|transaction-fee-|bridge-(?:fee|time)-|receive-(?:row|value))/u;
     const items = [];
     const offscreenItems = [];
@@ -70,7 +96,8 @@ export async function readVisiblePerpsState(page, node = {}) {
       const rendered = style.display !== 'none' && style.visibility !== 'hidden' && rect.width > 0 && rect.height > 0;
       if (!rendered) continue;
       matched += 1;
-      const visible = rect.bottom > 0 && rect.right > 0 && rect.top < innerHeight && rect.left < innerWidth;
+      const visible = rect.bottom > 0 && rect.right > 0 && rect.top < innerHeight && rect.left < innerWidth &&
+        (!testId.startsWith('perps-top-movers-pill-') || topMoverVisible(element, rect));
       if (rect.bottom > 0 && rect.top < innerHeight && (rect.left < -1 || rect.right > innerWidth + 1)) {
         clippedTestIds.push(testId);
       }

package/library/actions/extension/perps/select_market_filter.mjs

@@ -60,7 +60,7 @@ async function selectDropdownFilter(page, filter, option, timeoutMs, pollInterva
     }
     await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
   }
-  return { selectedLabel: selectedState.label, controlKind: 'dropdown', alreadySelected: false };
+  return { selectedLabel: selectedState.label, selectionMatches: selectedState.visible && selectedState.label === optionState.label, controlKind: 'dropdown', alreadySelected: false };
 }
 
 async function categoryRailState(page) {
@@ -109,7 +109,7 @@ async function selectCategoryRail(page, option, timeoutMs, pollIntervalMs) {
     await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
     selected = await categoryRailState(page);
   }
-  return { selectedLabel: selected.active[0]?.label ?? null, controlKind: 'category-rail', alreadySelected };
+  return { selectedLabel: selected.active[0]?.label ?? null, selectionMatches: matches(selected), controlKind: 'category-rail', alreadySelected };
 }
 
 export async function selectMarketFilter(page, input, pollOptions = {}) {

package/library/actions/shared/perps/visible-state.mjs

@@ -239,6 +239,15 @@ export function normalizeVisiblePerpsState(raw, options, platform) {
   };
   const detailPair = detailField(/^(?:perps-market-detail-pair|perps-(?:pro-)?market-header-subtitle)$/u);
   const detailSymbol = detailPair?.match(/^(.+?)-(?:USDC|USD|PERP)(?:\s+perp)?$/iu)?.[1]?.toUpperCase() ?? null;
+  const moverList = items.find((item) => item.testId === 'perps-top-movers-list');
+  const moverPills = items.filter((item) => item.testId.startsWith('perps-top-movers-pill-'))
+    .map((item) => ({
+      market: marketFromTestId(item.testId.replace('perps-top-movers-pill-', 'explore-markets-')),
+      testId: item.testId,
+      label: item.label ?? null,
+      visible: item.visible,
+    }))
+    .filter((item) => item.market);
   const state = {
     source: 'visible-ui',
     platform,
@@ -259,6 +268,12 @@ export function normalizeVisiblePerpsState(raw, options, platform) {
     )[0] ?? null,
     markets: marketItems,
     marketCount: marketItems.length,
+    topMovers: moverList ? {
+      visible: moverList.visible,
+      pills: moverPills,
+      count: moverPills.length,
+      visibleCount: moverPills.filter((item) => item.visible).length,
+    } : null,
     positions: compactEntries(
       selected(unique, (item) => /^(?:position-card-(?!roe-)|perps-position-row-|perps-position-size-value$|perps-pro-market-position-row-|perps-home-position-card-)/u.test(item.testId), options.maxItems),
       options.maxItems,
@@ -321,11 +336,14 @@ export function normalizeVisiblePerpsState(raw, options, platform) {
         : [],
     } : null,
   };
-  assertVisibleState(state, options);
+  assertVisibleState(state, options, testIds);
   return state;
 }
 
-function assertVisibleState(state, options) {
+function assertVisibleState(state, options, observed) {
+  if (options.forbidTestIds.length > 0 && state.truncated) {
+    throw new Error('Cannot prove forbidden Perps controls are absent from a truncated observation.');
+  }
   if (options.requireNoHorizontalOverflow && (
     !state.layout || state.layout.horizontalOverflow || state.layout.clippedTestIds.length > 0
   )) {
@@ -361,7 +379,6 @@ function assertVisibleState(state, options) {
   if (state.activity.length < options.minimumActivityCount) {
     throw new Error(`Expected at least ${options.minimumActivityCount} visible Perps activity entries, but observed ${state.activity.length}.`);
   }
-  const observed = new Set(state.observedTestIds);
   const missing = options.requireTestIds.filter((testId) => !observed.has(testId));
   if (missing.length > 0) {
     throw new Error(`Missing required visible Perps test IDs: ${missing.join(', ')}.`);

package/library/manifests/extension.action-manifest.json

@@ -2809,7 +2809,7 @@
       ]
     },
     "metamask.perps.read_visible_state": {
-      "description": "Read and assert bounded visible Perps UI state without product background hooks. marketDetails exposes visible symbol, pair, name, price and priceChange as text, or null when absent/ambiguous. marketCount counts the bounded observed markets array, not an unbounded total. favorite is boolean only when the requested market pair and one favorite control are both visible; otherwise null, never an assumed false.",
+      "description": "Read and assert bounded visible Perps UI state without product background hooks. marketDetails exposes visible symbol, pair, name, price and priceChange as text, or null when absent/ambiguous. marketCount counts the bounded observed markets array, not an unbounded total. topMovers separately reports its bounded pills, count and visibleCount when that list is observed; otherwise null. favorite is boolean only when the requested market pair and one favorite control are both visible; otherwise null, never an assumed false.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2919,6 +2919,7 @@
             "default": false
           },
           "forbid_test_ids": {
+            "description": "Requires a complete observation; truncated results fail rather than assuming these controls are absent.",
             "type": "array",
             "items": {
               "type": "string"

package/library/manifests/mobile.action-manifest.json

@@ -2178,7 +2178,7 @@
       "execution_capabilities": ["app-mutation"]
     },
     "metamask.perps.read_visible_state": {
-      "description": "Read and assert bounded visible Perps UI state through native accessibility. favorite is boolean only when the requested market pair and one favorite control are both observed as visible; otherwise null, never an assumed false. marketDetails exposes visible symbol, pair, name, price and priceChange as text, or null when absent/ambiguous. marketCount counts the bounded observed markets array, not an unbounded total.",
+      "description": "Read and assert bounded visible Perps UI state through native accessibility. favorite is boolean only when the requested market pair and one favorite control are both observed as visible; otherwise null, never an assumed false. marketDetails exposes visible symbol, pair, name, price and priceChange as text, or null when absent/ambiguous. marketCount counts the bounded observed markets array, not an unbounded total. topMovers separately reports its bounded pills, count and visibleCount when that list is observed; otherwise null.",
       "schema": {
         "type": "object",
         "properties": {
@@ -2227,6 +2227,7 @@
             "default": 0
           },
           "forbid_test_ids": {
+            "description": "Requires a complete observation; truncated results fail rather than assuming these controls are absent.",
             "type": "array",
             "items": { "type": "string" },
             "maxItems": 100

package/library/recipes/extension/perps/smoke.recipe.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://farmslot.io/schemas/recipe-v1.schema.json",
   "title": "MetaMask Extension Perps smoke",
-  "description": "Non-mutating Perps domain smoke for MetaMask Extension: verifies CDP, unlocks if needed, opens the Perps page, and reads live Perps positions and orders.",
+  "description": "Read-only Extension Perps smoke: verifies CDP, unlocks if needed, opens Perps, proves visible home with market data, and reads positions/orders. Requires approved wallet setup and completed onboarding gates; a visible tutorial is setup, not passing smoke.",
   "workflow": {
     "entry": "status",
     "nodes": {
@@ -26,7 +26,7 @@
       "open-perps": {
         "action": "ui.navigate",
         "page": "perps",
-        "next": "read-positions",
+        "next": "read-home",
         "intent": "Show the Perps home surface"
       },
       "read-positions": {
@@ -42,7 +42,56 @@
       "done": {
         "action": "end",
         "status": "pass"
+      },
+      "read-home": {
+        "action": "metamask.perps.read_visible_state",
+        "surface": "home",
+        "minimum_market_count": 1,
+        "require_features": [
+          "balance",
+          "market-list"
+        ],
+        "intent": "Observe a populated Perps home after setup",
+        "next": "assert-home",
+        "forbid_test_ids": [
+          "perps-tutorial-skip-button"
+        ],
+        "max_items": 200
+      },
+      "assert-home": {
+        "action": "assert_output",
+        "source": "read-home",
+        "assert": {
+          "path": "$.surface",
+          "operator": "eq",
+          "value": "home"
+        },
+        "proves": [
+          "perps-home"
+        ],
+        "intent": "The observed surface is Perps home",
+        "next": "assert-markets"
+      },
+      "assert-markets": {
+        "action": "assert_output",
+        "source": "read-home",
+        "assert": {
+          "path": "$.marketCount",
+          "operator": "gte",
+          "value": 1
+        },
+        "proves": [
+          "perps-home"
+        ],
+        "intent": "Perps home contains market data rather than only a loading shell",
+        "next": "read-positions"
       }
     }
-  }
+  },
+  "proofTargets": [
+    {
+      "id": "perps-home",
+      "claim": "The unlocked Perps home has visible market data and no observed tutorial gate."
+    }
+  ]
 }

package/library/recipes/shared/perps/release-market-search.recipe.json

@@ -72,7 +72,7 @@
         "next": "verify-result"
       },
       "capture": {
-        "action": "ui.screenshot",
+        "action": "ui.capture_surface",
         "path": "screenshots/perps-market-search.png",
         "label": "Perps release market search",
         "intent": "Preserve reviewer-visible proof of the filtered market list",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.65.0",
+  "version": "0.66.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"