@deeeed/metamask-harness 0.90.0 → 0.91.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## Unreleased
 
+## 0.91.0 - 2026-10-12
+
+- Support Extension `ui.navigate page=settings` through the visible account menu and verify the Settings page before returning.
+
+- Declare bounded `watch_logs.timeout_ms` for Core, Mobile, Extension and web-dapp, including Terminal inheritance. Use the supporting protocol 0.40.0 and runner 0.31.0 through coordinated runtime pins.
+
+### Changed
+
+- Breaking correction inherited from runner 0.31.0: run-scoped log observations require paths resolved before producers execute; output-derived paths must use `scope=file`. Nested output assertions and static JSON paths now receive complete preflight validation.
+
+### Fixed
+
+- Run the declared Oxlint script for changed-source checks and explicit fixes instead of skipping lint when ESLint is absent.
+
+- Mobile Perps position selectors now enforce long/short selection when the controller returns signed size without a side label. Core and Extension reuse the same side normalization while preserving their existing selection rules.
+
 ## 0.90.0 - 2026-10-12
 
 - Use typed iOS simulator recording targets, retain original Android recording segments, and use the shared action-context snapshot API for Extension evidence.

package/dist/commands/check.js

@@ -62,34 +62,32 @@ async function handleCheck(argv) {
   });
   const policyFailed = suppressionCheck.status === "fail";
   const fixes = [];
-  const eslintConfigArgs = resolveEslintConfigArgs(packageJson);
+  const usesOxlint = typeof packageJson?.scripts?.["lint:oxlint"] === "string";
+  const lintCommandArgs = usesOxlint ? ["lint:oxlint"] : resolveEslintConfigArgs(packageJson);
+  const lintCacheArgs = usesOxlint ? [] : ["--cache", "--cache-location", path.join(artifactsDir, "eslintcache")];
+  const lintCheck = {
+    id: usesOxlint ? "oxlint" : "eslint",
+    label: usesOxlint ? "Changed-file Oxlint" : "Changed-file ESLint",
+    target,
+    artifactsDir,
+    files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
+    command: usesOxlint ? "yarn" : executable(target, "eslint"),
+    args: [...lintCommandArgs, ...lintCacheArgs]
+  };
   if (fix && !policyFailed) {
     fixes.push(
       runToolCheck({
-        id: "eslint-fix",
-        label: "Changed-file ESLint fix",
-        target,
-        artifactsDir,
-        files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
-        command: executable(target, "eslint"),
-        args: [...eslintConfigArgs, "--fix", "--cache", "--cache-location", path.join(artifactsDir, "eslintcache")]
+        ...lintCheck,
+        id: `${lintCheck.id}-fix`,
+        label: `${lintCheck.label} fix`,
+        args: [...lintCommandArgs, "--fix", ...lintCacheArgs]
       })
     );
     fixes.push(runFormatterFix({ target, artifactsDir, files: existingChangedFiles.filter((file) => FORMAT_EXT_RE.test(file)) }));
   }
   const checks = [suppressionCheck];
   if (!policyFailed) {
-    checks.push(
-      runToolCheck({
-        id: "eslint",
-        label: "Changed-file ESLint",
-        target,
-        artifactsDir,
-        files: existingChangedFiles.filter((file) => JS_TS_EXT_RE.test(file)),
-        command: executable(target, "eslint"),
-        args: [...eslintConfigArgs, "--cache", "--cache-location", path.join(artifactsDir, "eslintcache")]
-      })
-    );
+    checks.push(runToolCheck(lintCheck));
     checks.push(runFormatterCheck({ target, artifactsDir, files: existingChangedFiles.filter((file) => FORMAT_EXT_RE.test(file)) }));
     checks.push(
       ...runJestChecks({
@@ -115,7 +113,7 @@ async function handleCheck(argv) {
   }
   const status = [...fixes, ...checks].some((check) => check.status === "fail") ? "fail" : "pass";
   const exitCode = status === "pass" ? EXIT.ok : EXIT.validation;
-  const guidance = policyFailed ? ["Remove the newly added eslint-disable directive(s). Fix the underlying violation with existing named styles, project tokens, or another established source pattern; then rerun mm-harness check diff [--fix]. Other checks were skipped until this policy failure is removed."] : checks.some((check) => check.id === "eslint" && check.status === "fail") ? ["Fix the reported violations in changed source using existing project patterns and tokens; do not suppress rules, hide violations behind indirection, weaken configuration, or bypass check diff. Then rerun mm-harness check diff [--fix]."] : [];
+  const guidance = policyFailed ? ["Remove the newly added eslint-disable directive(s). Fix the underlying violation with existing named styles, project tokens, or another established source pattern; then rerun mm-harness check diff [--fix]. Other checks were skipped until this policy failure is removed."] : checks.some((check) => check.id === lintCheck.id && check.status === "fail") ? ["Fix the reported violations in changed source using existing project patterns and tokens; do not suppress rules, hide violations behind indirection, weaken configuration, or bypass check diff. Then rerun mm-harness check diff [--fix]."] : [];
   const failureUserAction = guidance[0] ?? `inspect ${path.join(artifactsDir, "validation-summary.json")}, fix the failing check, then retry: mm-harness check diff --target ${shellQuote(target)} --base ${shellQuote(baseRef)} --profile ${profile} --json`;
   const summary = {
     schemaVersion: 1,

package/library/actions/core/perps/_controller.mjs

@@ -6,6 +6,7 @@ import path from 'node:path';
 import { pathToFileURL } from 'node:url';
 
 import { walletFixturePath } from '../../harness-exports.mjs';
+import { normalizeSide, sideForItem } from '../../shared/perps/item-side.mjs';
 import { readFixtureAccounts } from '../../shared/wallet/fixture-accounts.mjs';
 import { createRewardsClient, rewardsApiUrl } from './_rewards.mjs';
 
@@ -597,25 +598,6 @@ export function symbolForItem(item) {
   return normalizeMarketSymbol(item?.symbol ?? item?.coin ?? '');
 }
 
-// Orders carry buy/sell sides; Position.size is signed and authoritative.
-function normalizeSide(rawSide) {
-  const side = String(rawSide ?? '').toLowerCase();
-  if (side === 'buy' || side === 'b') return 'long';
-  if (side === 'sell' || side === 'a' || side === 's') return 'short';
-  return side;
-}
-
-function sideForItem(item, itemType) {
-  if (itemType === 'position') {
-    const rawSize = item?.size ?? item?.szi;
-    if (typeof rawSize !== 'string' && typeof rawSize !== 'number') return '';
-    const size = Number(rawSize);
-    if (!Number.isFinite(size) || size === 0) return '';
-    return size > 0 ? 'long' : 'short';
-  }
-  return normalizeSide(item?.side ?? item?.direction ?? '');
-}
-
 function uniqueSymbols(symbols) {
   return Array.from(new Set(symbols.filter(Boolean)));
 }

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

@@ -1,6 +1,7 @@
 // Implement Extension Perps state reads, UI setup and funded trade operations.
 // Funded paths check runtime identity and retain mutation receipts for cleanup.
 
+import { sideForItem } from '../../shared/perps/item-side.mjs';
 import { pathToFileURL } from 'node:url';
 import { createHash } from 'node:crypto';
 import { readFile, writeFile } from 'node:fs/promises';
@@ -66,17 +67,6 @@ function symbolForItem(item) {
   return normalizeMarketSymbol(item?.coin ?? item?.symbol ?? '');
 }
 
-function sideForItem(item) {
-  const side = String(item?.side ?? item?.direction ?? '').toLowerCase();
-  if (side === 'buy' || side === 'b') return 'long';
-  if (side === 'sell' || side === 'a' || side === 's') return 'short';
-  if (side) return side;
-  // Positions carry no side, only a signed size (long > 0, short < 0).
-  const size = Number(item?.size ?? item?.szi);
-  if (Number.isFinite(size) && size !== 0) return size > 0 ? 'long' : 'short';
-  return side;
-}
-
 function uniqueSymbols(symbols) {
   return Array.from(new Set(symbols.filter(Boolean)));
 }

package/library/actions/extension/ui/navigate.mjs

@@ -46,7 +46,7 @@ function text(value) {
 function pageIntent(node) {
   const page = text(node?.page);
   if (!page) return undefined;
-  if (page === 'back' || page === 'home' || page === 'perps' || page === 'swap') return { page };
+  if (page === 'back' || page === 'home' || page === 'perps' || page === 'swap' || page === 'settings') return { page };
   if (page === 'perps-market-list' || page === 'perps-activity') return { page };
   if (page === 'network') {
     const network = text(node.network);
@@ -61,7 +61,7 @@ function pageIntent(node) {
     if (!market) throw new Error('extension ui.navigate page=perps-market requires market or symbol.');
     return { page, market };
   }
-  throw new Error('extension ui.navigate supported page intents: back, home, network, perps, perps-market-list, perps-market, perps-activity, swap.');
+  throw new Error('extension ui.navigate supported page intents: back, home, settings, network, perps, perps-market-list, perps-market, perps-activity, swap.');
 }
 
 async function goBack(page, timeoutMs) {
@@ -503,6 +503,27 @@ export async function openNetwork(page, network, chainId, addIfMissing, timeoutM
   throw new Error(`Network ${network} (${chainId}) did not become the selected wallet filter.`);
 }
 
+export async function openSettings(page, timeoutMs) {
+  const destination = dataTestId('parent-selector-settings-page');
+  if (await hasVisibleSelector(page, destination)) {
+    return { method: 'visible-ui', href: await currentHref(page), steps: [] };
+  }
+  const deadline = Date.now() + timeoutMs;
+  const menu = dataTestId('account-options-menu-button');
+  const settings = dataTestId('global-menu-settings');
+  const steps = [];
+  if (!(await hasVisibleSelector(page, settings))) {
+    await page.waitFor({ selector: menu, expected: 'visible', timeoutMs: Math.max(1, deadline - Date.now()) });
+    await activateSemanticControl(page, menu);
+    steps.push(menu);
+  }
+  await page.waitFor({ selector: settings, expected: 'visible', timeoutMs: Math.max(1, deadline - Date.now()) });
+  const navigation = await activateSemanticControl(page, settings);
+  steps.push(settings);
+  await page.waitFor({ selector: destination, expected: 'visible', timeoutMs: Math.max(1, deadline - Date.now()) });
+  return { navigation, method: 'visible-ui', href: await currentHref(page), selector: settings, steps };
+}
+
 export async function openSwap(page, timeoutMs) {
   const sourceAmount = dataTestId('from-amount');
   const sourceToken = dataTestId('bridge-source-button');
@@ -588,6 +609,10 @@ export async function navigateExtensionUi(input) {
       );
       return { action: input.action, ...intent, ...result, proofPath: 'ui-navigation' };
     }
+    if (intent.page === 'settings') {
+      const result = await openSettings(page, timeoutMs);
+      return { action: input.action, ...intent, ...result, proofPath: 'ui-navigation' };
+    }
     if (intent.page === 'swap') {
       const result = await openSwap(page, timeoutMs);
       return { action: input.action, ...intent, ...result, proofPath: 'ui-navigation' };

package/library/actions/mobile/perps/perps.mjs

@@ -1,5 +1,6 @@
 // Implement Mobile Perps navigation, trading mutations, assertions, and setup or cleanup through the bridge.
 // Strategy getters used during cleanup can settle tracked collateral.
+import { sideForItem } from '../../shared/perps/item-side.mjs';
 import { pathToFileURL } from 'node:url';
 import {
   MOBILE_BRIDGE_RESULT_ERROR_CODES,
@@ -300,13 +301,6 @@ function symbolForItem(item) {
   return normalizeMarketSymbol(item?.symbol ?? item?.coin ?? '');
 }
 
-function sideForItem(item) {
-  const side = String(item?.side ?? item?.direction ?? '').toLowerCase();
-  if (side === 'buy' || side === 'b') return 'long';
-  if (side === 'sell' || side === 'a' || side === 's') return 'short';
-  return side;
-}
-
 function configuredSymbols(input, items) {
   const selector = input.node?.selector && typeof input.node.selector === 'object' ? input.node.selector : {};
   const mode = String(input.node?.mode ?? selector.mode ?? 'matching').toLowerCase();

package/library/actions/shared/perps/item-side.mjs

@@ -0,0 +1,18 @@
+// Normalize explicit order sides and the signed sizes returned for Perps positions.
+export function normalizeSide(rawSide) {
+  const side = String(rawSide ?? '').toLowerCase();
+  if (side === 'buy' || side === 'b') return 'long';
+  if (side === 'sell' || side === 'a' || side === 's') return 'short';
+  return side;
+}
+
+export function sideForItem(item, itemType) {
+  if (itemType !== 'position') {
+    const side = normalizeSide(item?.side ?? item?.direction);
+    if (side || itemType !== undefined) return side;
+  }
+  const rawSize = item?.size ?? item?.szi;
+  if (typeof rawSize !== 'string' && typeof rawSize !== 'number') return '';
+  const size = Number(rawSize);
+  return Number.isFinite(size) && size !== 0 ? (size > 0 ? 'long' : 'short') : '';
+}

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

@@ -362,7 +362,7 @@
       }
     },
     "watch_logs": {
-      "description": "Base log assertion/capture action.",
+      "description": "Observe log text immediately or within a declared timeout_ms window.",
       "examples": [
         {
           "action": "watch_logs",
@@ -386,6 +386,11 @@
               "run",
               "file"
             ]
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Observation window from 0 through 60000 ms; a positive window requires nonempty contains."
           }
         },
         "required": [

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

@@ -342,7 +342,7 @@
       }
     },
     "watch_logs": {
-      "description": "Base log assertion/capture action.",
+      "description": "Observe log text immediately or within a declared timeout_ms window.",
       "examples": [
         {
           "action": "watch_logs",
@@ -366,6 +366,11 @@
               "run",
               "file"
             ]
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Observation window from 0 through 60000 ms; a positive window requires nonempty contains."
           }
         },
         "required": [
@@ -509,7 +514,8 @@
               "perps-market-list",
               "perps-market",
               "perps-activity",
-              "swap"
+              "swap",
+              "settings"
             ]
           },
           "market": {

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

@@ -345,7 +345,7 @@
       }
     },
     "watch_logs": {
-      "description": "Base log assertion/capture action.",
+      "description": "Observe log text immediately or within a declared timeout_ms window.",
       "examples": [
         {
           "action": "watch_logs",
@@ -365,10 +365,20 @@
           },
           "scope": {
             "type": "string",
-            "enum": ["run", "file"]
+            "enum": [
+              "run",
+              "file"
+            ]
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Observation window from 0 through 60000 ms; a positive window requires nonempty contains."
           }
         },
-        "required": ["path"],
+        "required": [
+          "path"
+        ],
         "additionalProperties": false
       }
     },

package/library/manifests/web-dapp.action-manifest.json

@@ -1097,6 +1097,44 @@
         },
         "additionalProperties": false
       }
+    },
+    "watch_logs": {
+      "description": "Observe log text immediately or within a declared timeout_ms window.",
+      "examples": [
+        {
+          "action": "watch_logs",
+          "path": "logs/app.log",
+          "intent": "Observe the runtime behavior needed for this proof.",
+          "next": "done"
+        }
+      ],
+      "schema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "contains": {
+            "type": "string"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "run",
+              "file"
+            ]
+          },
+          "timeout_ms": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Observation window from 0 through 60000 ms; a positive window requires nonempty contains."
+          }
+        },
+        "required": [
+          "path"
+        ],
+        "additionalProperties": false
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deeeed/metamask-harness",
-  "version": "0.90.0",
+  "version": "0.91.0",
   "type": "module",
   "bin": {
     "mm-harness": "bin/mm-harness"
@@ -21,15 +21,15 @@
     "check:syntax": "find . -name '*.mjs' -print0 | xargs -0 -n1 node --check"
   },
   "dependencies": {
-    "@farmslot/adapter-node": "0.1.13",
-    "@farmslot/adapter-rn": "0.20.0",
-    "@farmslot/adapter-sdk": "0.9.0",
-    "@farmslot/adapter-web": "0.7.0",
-    "@farmslot/agent-runtime": "0.18.0",
+    "@farmslot/adapter-node": "0.1.14",
+    "@farmslot/adapter-rn": "0.20.1",
+    "@farmslot/adapter-sdk": "0.9.1",
+    "@farmslot/adapter-web": "0.7.1",
+    "@farmslot/agent-runtime": "0.18.1",
     "@farmslot/handoff": "^0.3.1",
-    "@farmslot/protocol": "0.39.0",
-    "@farmslot/recipe-cli": "0.14.1",
-    "@farmslot/recipe-runner": "0.30.0",
+    "@farmslot/protocol": "0.40.0",
+    "@farmslot/recipe-cli": "0.14.2",
+    "@farmslot/recipe-runner": "0.31.0",
     "agent-device": "0.19.3",
     "commander": "^12.0.0",
     "esbuild": "0.28.1",