mobridge-mcp 0.0.1

package/dist/protocol/fixtures/01-login-views/expected.json

@@ -0,0 +1,32 @@
+[
+  {
+    "name": "email by resourceId",
+    "query": { "resourceId": "com.example.app:id/email" },
+    "expect": { "matchCount": 1, "nodeIds": ["n2"] }
+  },
+  {
+    "name": "login button by role+text normalized",
+    "query": { "role": "BUTTON", "text": { "value": "đăng nhập", "match": "NORMALIZED_EXACT" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n4"] }
+  },
+  {
+    "name": "role INPUT returns both fields",
+    "query": { "role": "INPUT" },
+    "expect": { "matchCount": 2, "nodeIds": ["n2", "n3"] }
+  },
+  {
+    "name": "exact case-sensitive misses normalized-only match",
+    "query": { "role": "BUTTON", "text": { "value": "đăng nhập", "match": "EXACT" } },
+    "expect": { "matchCount": 0 }
+  },
+  {
+    "name": "contains matches partial",
+    "query": { "role": "LINK", "text": { "value": "Quên", "match": "CONTAINS" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n5"] }
+  },
+  {
+    "name": "text Đăng nhập matches both title(TEXT) and button unless role given",
+    "query": { "text": { "value": "Đăng nhập", "match": "NORMALIZED_EXACT" } },
+    "expect": { "matchCount": 2, "nodeIds": ["n1", "n4"] }
+  }
+]

package/dist/protocol/fixtures/01-login-views/snapshot.json

@@ -0,0 +1,20 @@
+{
+  "schemaVersion": 1,
+  "deviceId": "pixel5",
+  "snapshotId": "s_0101",
+  "timestamp": 1784772000000,
+  "packageName": "com.example.app",
+  "windowId": 42,
+  "orientation": "portrait",
+  "screenStateId": "login:a91f",
+  "compact": true,
+  "nodes": [
+    { "nodeId": "n0", "parentId": null, "role": "SCREEN", "label": null, "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n1", "parentId": "n0", "role": "TEXT", "label": null, "text": "Đăng nhập", "value": null, "hint": null, "resourceId": "com.example.app:id/title", "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n2", "parentId": "n0", "role": "INPUT", "label": "Email", "text": null, "value": "", "hint": "Email", "resourceId": "com.example.app:id/email", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["FOCUS", "SET_TEXT", "CLEAR_TEXT"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n3", "parentId": "n0", "role": "INPUT", "label": "Mật khẩu", "text": null, "value": "", "hint": "Mật khẩu", "resourceId": "com.example.app:id/password", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": true }, "actions": ["FOCUS", "SET_TEXT", "CLEAR_TEXT"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n4", "parentId": "n0", "role": "BUTTON", "label": "Đăng nhập", "text": "Đăng nhập", "value": null, "hint": null, "resourceId": "com.example.app:id/login", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK", "FOCUS"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n5", "parentId": "n0", "role": "LINK", "label": "Quên mật khẩu", "text": "Quên mật khẩu", "value": null, "hint": null, "resourceId": "com.example.app:id/forgot", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 1.0 }
+  ],
+  "treeHash": "e4c0a1"
+}

package/dist/protocol/fixtures/02-alert-dialog/expected.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": "OK is ambiguous without scope",
+    "query": { "role": "BUTTON", "text": { "value": "OK", "match": "EXACT" } },
+    "expect": { "matchCount": 2, "nodeIds": ["n1", "n5"], "ambiguous": true }
+  },
+  {
+    "name": "OK scoped to dialog is unique",
+    "query": { "role": "BUTTON", "text": { "value": "OK", "match": "EXACT" }, "within": { "role": "DIALOG" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n5"] }
+  },
+  {
+    "name": "cancel in dialog",
+    "query": { "role": "BUTTON", "text": { "value": "Hủy", "match": "NORMALIZED_EXACT" }, "within": { "role": "DIALOG" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n4"] }
+  },
+  {
+    "name": "dialog node itself",
+    "query": { "role": "DIALOG" },
+    "expect": { "matchCount": 1, "nodeIds": ["n2"] }
+  }
+]

package/dist/protocol/fixtures/02-alert-dialog/snapshot.json

@@ -0,0 +1,20 @@
+{
+  "schemaVersion": 1,
+  "deviceId": "pixel5",
+  "snapshotId": "s_0201",
+  "timestamp": 1784772100000,
+  "packageName": "com.example.app",
+  "windowId": 43,
+  "orientation": "portrait",
+  "screenStateId": "home+dialog:77b2",
+  "compact": true,
+  "nodes": [
+    { "nodeId": "n0", "parentId": null, "role": "SCREEN", "label": null, "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n1", "parentId": "n0", "role": "BUTTON", "label": "OK", "text": "OK", "value": null, "hint": null, "resourceId": "com.example.app:id/bg_ok", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n2", "parentId": "n0", "role": "DIALOG", "label": "Xác nhận", "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["DISMISS"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n3", "parentId": "n2", "role": "TEXT", "label": null, "text": "Xóa mục này?", "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n4", "parentId": "n2", "role": "BUTTON", "label": "Hủy", "text": "Hủy", "value": null, "hint": null, "resourceId": "android:id/button2", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n5", "parentId": "n2", "role": "BUTTON", "label": "OK", "text": "OK", "value": null, "hint": null, "resourceId": "android:id/button1", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 1.0 }
+  ],
+  "treeHash": "77b2c9"
+}

package/dist/protocol/fixtures/03-recyclerview-list/expected.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": "visible item resolves by itemKey",
+    "query": { "role": "LIST_ITEM", "text": { "value": "Item 4", "match": "EXACT" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n3"] }
+  },
+  {
+    "name": "off-screen item not present (needs scroll)",
+    "query": { "role": "LIST_ITEM", "text": { "value": "Item 40", "match": "EXACT" } },
+    "expect": { "matchCount": 0, "error": "NODE_NOT_FOUND" }
+  },
+  {
+    "name": "nth visible list item",
+    "query": { "role": "LIST_ITEM", "nth": 0 },
+    "expect": { "matchCount": 1, "nodeIds": ["n2"] }
+  },
+  {
+    "name": "shared resourceId row is ambiguous alone",
+    "query": { "resourceId": "com.example.app:id/row" },
+    "expect": { "matchCount": 3, "nodeIds": ["n2", "n3", "n4"], "ambiguous": true }
+  }
+]

package/dist/protocol/fixtures/03-recyclerview-list/snapshot.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "deviceId": "pixel5",
+  "snapshotId": "s_0301",
+  "timestamp": 1784772200000,
+  "packageName": "com.example.app",
+  "windowId": 44,
+  "orientation": "portrait",
+  "screenStateId": "list:1c4d",
+  "compact": true,
+  "nodes": [
+    { "nodeId": "n0", "parentId": null, "role": "SCREEN", "label": null, "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n1", "parentId": "n0", "role": "LIST", "label": null, "text": null, "value": null, "hint": null, "resourceId": "com.example.app:id/recycler", "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["SCROLL_FORWARD", "SCROLL_BACKWARD"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n2", "parentId": "n1", "role": "LIST_ITEM", "label": "Item 3", "text": "Item 3", "value": null, "hint": null, "resourceId": "com.example.app:id/row", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "collection": { "index": 3, "itemKey": "Item 3", "rowCount": 200, "scrollContainerId": "n1", "ancestorFingerprint": "1c4d01" }, "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n3", "parentId": "n1", "role": "LIST_ITEM", "label": "Item 4", "text": "Item 4", "value": null, "hint": null, "resourceId": "com.example.app:id/row", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "collection": { "index": 4, "itemKey": "Item 4", "rowCount": 200, "scrollContainerId": "n1", "ancestorFingerprint": "1c4d01" }, "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n4", "parentId": "n1", "role": "LIST_ITEM", "label": "Item 5", "text": "Item 5", "value": null, "hint": null, "resourceId": "com.example.app:id/row", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "collection": { "index": 5, "itemKey": "Item 5", "rowCount": 200, "scrollContainerId": "n1", "ancestorFingerprint": "1c4d01" }, "source": "ACCESSIBILITY", "confidence": 1.0 }
+  ],
+  "treeHash": "1c4d5e"
+}

package/dist/protocol/fixtures/04-ambiguous-ctas/expected.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": "three identical CTAs are ambiguous",
+    "query": { "role": "BUTTON", "text": { "value": "Tiếp tục", "match": "NORMALIZED_EXACT" } },
+    "expect": { "matchCount": 3, "nodeIds": ["n2", "n4", "n6"], "ambiguous": true }
+  },
+  {
+    "name": "resolve by dialog ancestor",
+    "query": { "role": "BUTTON", "text": { "value": "Tiếp tục", "match": "NORMALIZED_EXACT" }, "within": { "role": "DIALOG" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n6"] }
+  },
+  {
+    "name": "resolve by card_a ancestor resourceId",
+    "query": { "role": "BUTTON", "text": { "value": "Tiếp tục", "match": "NORMALIZED_EXACT" }, "within": { "resourceId": "com.example.app:id/card_a" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n2"] }
+  }
+]

package/dist/protocol/fixtures/04-ambiguous-ctas/snapshot.json

@@ -0,0 +1,21 @@
+{
+  "schemaVersion": 1,
+  "deviceId": "pixel5",
+  "snapshotId": "s_0401",
+  "timestamp": 1784772300000,
+  "packageName": "com.example.app",
+  "windowId": 45,
+  "orientation": "portrait",
+  "screenStateId": "onboard:3fe1",
+  "compact": true,
+  "nodes": [
+    { "nodeId": "n0", "parentId": null, "role": "SCREEN", "label": null, "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n1", "parentId": "n0", "role": "LIST_ITEM", "label": "card A", "text": null, "value": null, "hint": null, "resourceId": "com.example.app:id/card_a", "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n2", "parentId": "n1", "role": "BUTTON", "label": "Tiếp tục", "text": "Tiếp tục", "value": null, "hint": null, "resourceId": "com.example.app:id/cta", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n3", "parentId": "n0", "role": "LIST_ITEM", "label": "card B", "text": null, "value": null, "hint": null, "resourceId": "com.example.app:id/card_b", "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n4", "parentId": "n3", "role": "BUTTON", "label": "Tiếp tục", "text": "Tiếp tục", "value": null, "hint": null, "resourceId": "com.example.app:id/cta", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n5", "parentId": "n0", "role": "DIALOG", "label": "Xác nhận", "text": null, "value": null, "hint": null, "resourceId": "com.example.app:id/confirm_sheet", "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["DISMISS"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n6", "parentId": "n5", "role": "BUTTON", "label": "Tiếp tục", "text": "Tiếp tục", "value": null, "hint": null, "resourceId": "com.example.app:id/cta", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 1.0 }
+  ],
+  "treeHash": "3fe1aa"
+}

package/dist/protocol/fixtures/05-compose-settings/expected.json

@@ -0,0 +1,17 @@
+[
+  {
+    "name": "switch by label (no resourceId in Compose)",
+    "query": { "role": "SWITCH", "label": { "value": "Notifications", "match": "EXACT" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n1"] }
+  },
+  {
+    "name": "unchecked switches only",
+    "query": { "role": "SWITCH", "state": { "checked": false } },
+    "expect": { "matchCount": 1, "nodeIds": ["n1"] }
+  },
+  {
+    "name": "input current value",
+    "query": { "role": "INPUT", "label": { "value": "Name", "match": "EXACT" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n3"] }
+  }
+]

package/dist/protocol/fixtures/05-compose-settings/snapshot.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "deviceId": "pixel5",
+  "snapshotId": "s_0501",
+  "timestamp": 1784772400000,
+  "packageName": "com.example.compose",
+  "windowId": 46,
+  "orientation": "portrait",
+  "screenStateId": "settings:9ab0",
+  "compact": true,
+  "nodes": [
+    { "nodeId": "n0", "parentId": null, "role": "SCREEN", "label": null, "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n1", "parentId": "n0", "role": "SWITCH", "label": "Notifications", "text": null, "value": null, "hint": null, "resourceId": null, "className": "androidx.compose.ui.platform.ComposeView", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": false, "password": false }, "actions": ["SELECT", "CLICK"], "source": "ACCESSIBILITY", "confidence": 0.95 },
+    { "nodeId": "n2", "parentId": "n0", "role": "SWITCH", "label": "Dark mode", "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": true, "password": false }, "actions": ["SELECT", "CLICK"], "source": "ACCESSIBILITY", "confidence": 0.95 },
+    { "nodeId": "n3", "parentId": "n0", "role": "INPUT", "label": "Name", "text": null, "value": "Anh", "hint": "Your name", "resourceId": null, "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["FOCUS", "SET_TEXT", "CLEAR_TEXT"], "source": "ACCESSIBILITY", "confidence": 0.9 },
+    { "nodeId": "n4", "parentId": "n0", "role": "BUTTON", "label": "Save", "text": "Save", "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "source": "ACCESSIBILITY", "confidence": 0.92 }
+  ],
+  "treeHash": "9ab0f3"
+}

package/dist/protocol/fixtures/06-canvas-game/expected.json

@@ -0,0 +1,12 @@
+[
+  {
+    "name": "no semantic Play button -> vision required",
+    "query": { "role": "BUTTON", "text": { "value": "Play", "match": "CONTAINS" } },
+    "expect": { "matchCount": 0, "error": "VISION_REQUIRED" }
+  },
+  {
+    "name": "screen is a bare canvas",
+    "query": { "role": "CANVAS" },
+    "expect": { "matchCount": 1, "nodeIds": ["n1"] }
+  }
+]

package/dist/protocol/fixtures/06-canvas-game/snapshot.json

@@ -0,0 +1,16 @@
+{
+  "schemaVersion": 1,
+  "deviceId": "pixel5",
+  "snapshotId": "s_0601",
+  "timestamp": 1784772500000,
+  "packageName": "com.example.unitygame",
+  "windowId": 47,
+  "orientation": "landscape",
+  "screenStateId": "game:canvas",
+  "compact": true,
+  "nodes": [
+    { "nodeId": "n0", "parentId": null, "role": "SCREEN", "label": null, "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n1", "parentId": "n0", "role": "CANVAS", "label": null, "text": null, "value": null, "hint": null, "resourceId": "com.example.unitygame:id/unitySurface", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "bounds": [0, 0, 2340, 1080], "source": "ACCESSIBILITY", "confidence": 1.0 }
+  ],
+  "treeHash": "ca0000"
+}

package/dist/protocol/fixtures/07-search-results/expected.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": "contains Pizza returns two",
+    "query": { "role": "LIST_ITEM", "text": { "value": "Pizza", "match": "CONTAINS" } },
+    "expect": { "matchCount": 2, "nodeIds": ["n2", "n3"] }
+  },
+  {
+    "name": "firstVisible pizza narrows to one",
+    "query": { "role": "LIST_ITEM", "text": { "value": "Pizza", "match": "CONTAINS" }, "firstVisible": true },
+    "expect": { "matchCount": 1, "nodeIds": ["n2"] }
+  },
+  {
+    "name": "nth=1 among all results",
+    "query": { "role": "LIST_ITEM", "resourceId": "com.example.app:id/result", "nth": 1 },
+    "expect": { "matchCount": 1, "nodeIds": ["n3"] }
+  },
+  {
+    "name": "regex anchored match",
+    "query": { "role": "LIST_ITEM", "text": { "value": "^Pho", "match": "REGEX" } },
+    "expect": { "matchCount": 1, "nodeIds": ["n4"] }
+  }
+]

package/dist/protocol/fixtures/07-search-results/snapshot.json

@@ -0,0 +1,19 @@
+{
+  "schemaVersion": 1,
+  "deviceId": "pixel5",
+  "snapshotId": "s_0701",
+  "timestamp": 1784772600000,
+  "packageName": "com.example.app",
+  "windowId": 48,
+  "orientation": "portrait",
+  "screenStateId": "search:6d2e",
+  "compact": true,
+  "nodes": [
+    { "nodeId": "n0", "parentId": null, "role": "SCREEN", "label": null, "text": null, "value": null, "hint": null, "resourceId": null, "state": { "enabled": true, "clickable": false, "focused": false, "selected": false, "checked": null, "password": false }, "actions": [], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n1", "parentId": "n0", "role": "INPUT", "label": "Search", "text": null, "value": "pi", "hint": "Search", "resourceId": "com.example.app:id/search", "state": { "enabled": true, "clickable": true, "focused": true, "selected": false, "checked": null, "password": false }, "actions": ["FOCUS", "SET_TEXT", "CLEAR_TEXT"], "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n2", "parentId": "n0", "role": "LIST_ITEM", "label": null, "text": "Pizza Hut", "value": null, "hint": null, "resourceId": "com.example.app:id/result", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "collection": { "index": 0, "itemKey": "Pizza Hut", "rowCount": 3, "scrollContainerId": "n0", "ancestorFingerprint": "6d2e01" }, "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n3", "parentId": "n0", "role": "LIST_ITEM", "label": null, "text": "Pizza 4P's", "value": null, "hint": null, "resourceId": "com.example.app:id/result", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "collection": { "index": 1, "itemKey": "Pizza 4P's", "rowCount": 3, "scrollContainerId": "n0", "ancestorFingerprint": "6d2e01" }, "source": "ACCESSIBILITY", "confidence": 1.0 },
+    { "nodeId": "n4", "parentId": "n0", "role": "LIST_ITEM", "label": null, "text": "Pho 24", "value": null, "hint": null, "resourceId": "com.example.app:id/result", "state": { "enabled": true, "clickable": true, "focused": false, "selected": false, "checked": null, "password": false }, "actions": ["CLICK"], "collection": { "index": 2, "itemKey": "Pho 24", "rowCount": 3, "scrollContainerId": "n0", "ancestorFingerprint": "6d2e01" }, "source": "ACCESSIBILITY", "confidence": 1.0 }
+  ],
+  "treeHash": "6d2e77"
+}

package/dist/protocol/fixtures/README.md

@@ -0,0 +1,34 @@
+# Fixtures
+
+Each fixture is a folder with:
+- `snapshot.json` — a `ScreenSnapshot` (validates against `msm:screen-snapshot.schema.json`).
+- `expected.json` — query cases: `{ query, expect }` where `expect` is `{ matchCount, nodeIds?, error? }`.
+
+These drive the P0 query/diff validator **with no device**. Concrete fixtures below are authored now; the remaining rows are captured from real devices in P1 (they need live Compose/WebView/RN/Flutter/Unity trees).
+
+## The 20 target screens
+
+| # | Screen | UI tech | Authored | Purpose |
+|---|--------|---------|----------|---------|
+| 01 | Login | Views | ✅ | resource-id + role/label; NORMALIZED_EXACT |
+| 02 | Alert dialog | Views | ✅ | `within` DIALOG scoping; DISMISS |
+| 03 | Long list | RecyclerView | ✅ | collection identity; off-screen NODE_NOT_FOUND |
+| 04 | Ambiguous CTAs | Views | ✅ | AMBIGUOUS_MATCH + ancestor disambiguation |
+| 05 | Settings form | Compose | ✅ | Compose semantics; SWITCH state |
+| 06 | Game menu | Canvas/Unity | ✅ | near-empty tree → VISION_REQUIRED |
+| 07 | Search + results | Views | ✅ | CONTAINS + firstVisible/nth |
+| 08 | Web article | WebView | ⬜ P1 | LINK role from WebView |
+| 09 | Permission dialog | System | ⬜ P1 | system package window |
+| 10 | Bottom sheet | Compose | ⬜ P1 | modal sheet as DIALOG |
+| 11 | Product list | React Native | ⬜ P1 | RN accessibility mapping |
+| 12 | Feed | Flutter | ⬜ P1 | Flutter semantics tree |
+| 13 | Multi-window | Views | ⬜ P1 | two windows, windowId scoping |
+| 14 | Notification shade | System | ⬜ P1 | shade open state |
+| 15 | Landscape login | Views | ⬜ P1 | orientation + DPI locator stability |
+| 16 | Large font scale | Views | ⬜ P1 | font scale, bounds shift |
+| 17 | Dark mode home | Compose | ⬜ P1 | theme independence |
+| 18 | Loading/skeleton | Views | ⬜ P1 | transient nodes, diff coalescing |
+| 19 | Network error | Views | ⬜ P1 | error state + retry |
+| 20 | Checkout (guarded) | Views | ⬜ P1 | financial-class action gating |
+
+Legend: ✅ concrete JSON here · ⬜ device-capture in P1.

package/dist/protocol/platform-capabilities.json

@@ -0,0 +1,95 @@
+{
+  "$comment": "Operation-level platform capability manifest. SINGLE SOURCE OF TRUTH for iOS tool registration, per-call operation validation, the device.connect envelope (supportedTools/unsupportedCapabilities), docs and tests. Android is intentionally NOT enumerated: on Android the platform filter is a no-op and the existing profile system is authoritative, so nothing here can make the Android surface drift. A tool with no iOS entry (in `common` or the active mode) is level NONE => NOT registered on iOS. Entries are version-qualified (minIosVersion/minXcodeVersion) because support varies by toolchain; connect resolves the effective set against the detected environment.",
+  "version": 1,
+  "platforms": ["ANDROID", "IOS"],
+  "iosModes": ["physical", "simulator"],
+
+  "unsupportedCapabilities": {
+    "physical": ["APP_CLEAR_DATA", "APP_PERMISSION_GRANT", "BATTERYSTATS"],
+    "simulator": ["BATTERYSTATS"]
+  },
+
+  "ios": {
+    "common": {
+      "mobile.device.connect": { "level": "FULL" },
+      "mobile.app.open": { "level": "FULL", "allowedOperations": ["APP_OPEN", "APP_DEEP_LINK", "APP_BRING_TO_FRONT", "APP_CLOSE_UI"] },
+      "mobile.screen.get": { "level": "FULL" },
+      "mobile.screen.find": { "level": "FULL" },
+      "mobile.screen.act": { "level": "FULL" },
+      "mobile.screen.wait": { "level": "FULL" },
+      "mobile.screen.diff": { "level": "FULL" },
+      "mobile.system.action": { "level": "PARTIAL", "allowedOperations": ["HOME"], "reasonCode": "NO_GLOBAL_BACK_OR_RECENTS", "note": "iOS has no global BACK/RECENTS/NOTIFICATION_SHADE; BACK is a semantic UI action (find nav button + act)." },
+      "mobile.capability.invoke": { "level": "PARTIAL", "allowedOperations": ["APP", "CLIPBOARD"], "reasonCode": "NO_NOTIFICATION_LISTENER", "note": "APP ok; CLIPBOARD limited; no general notification listener." },
+
+      "mobile.screen.delta": { "level": "FULL" },
+      "mobile.batch": { "level": "FULL" },
+      "mobile.gesture.perform": { "level": "FULL" },
+      "mobile.screen.scrollTo": { "level": "FULL" },
+      "mobile.screen.capture": { "level": "FULL" },
+      "mobile.input.text": { "level": "FULL" },
+      "mobile.notification.act": { "level": "PARTIAL", "reasonCode": "NO_STABLE_LISTENER", "note": "UI automation of the notification surface only, not a stable capability." },
+
+      "mobile.perf.sample": { "level": "FULL" },
+      "mobile.diag.crash": { "level": "PARTIAL", "reasonCode": "PROCESS_SCOPED" },
+      "mobile.diag.startup": { "level": "FULL" },
+
+      "runtime.setup.status": { "level": "FULL" },
+      "runtime.setup.open": { "level": "PARTIAL", "reasonCode": "NO_DEEP_LINK_FOR_EVERY_PAGE" },
+      "runtime.setup.verify": { "level": "PARTIAL", "reasonCode": "PHYSICAL_PERMISSION_PROBE_LIMITED" },
+
+      "mobile.app.control.authorize": { "level": "FULL" },
+      "mobile.app.control.deauthorize": { "level": "FULL" },
+      "mobile.app.control.status": { "level": "FULL" },
+
+      "mobile.workflow.run": { "level": "FULL" },
+
+      "ios.app.terminate": { "level": "FULL", "note": "Terminate the test-session app only; NOT an OS force-stop." },
+      "ios.diag.logs": { "level": "PARTIAL", "reasonCode": "PROCESS_SCOPED", "replacesAndroidTool": "mobile.diag.logcat" },
+      "ios.diag.energyProfile": { "level": "PARTIAL", "reasonCode": "OWN_CONTRACT", "replacesAndroidTool": "mobile.diag.batterystats" }
+    },
+
+    "physical": {
+      "mobile.device.state": { "level": "PARTIAL", "reasonCode": "ORIENTATION_AND_APPSTATE_ONLY" },
+      "mobile.app.list": { "level": "PARTIAL", "reasonCode": "DEVICECTL_OR_MDM" },
+      "mobile.app.info": { "level": "PARTIAL", "reasonCode": "OWN_APP_OR_BUNDLE_METADATA" },
+      "mobile.diag.battery": { "level": "PARTIAL", "reasonCode": "ENERGY_NOT_BATTERYSTATS" },
+      "mobile.diag.netstats": { "level": "PARTIAL", "reasonCode": "INSTRUMENTS_PER_APP" },
+      "mobile.diag.storage": { "level": "PARTIAL", "reasonCode": "OWN_APP_SANDBOX_ONLY" },
+
+      "mobile.diag.logcat": { "level": "NONE", "replacementTool": "ios.diag.logs", "reasonCode": "PROCESS_SCOPED_ONLY" },
+      "mobile.diag.batterystats": { "level": "NONE", "replacementTool": "ios.diag.energyProfile", "reasonCode": "NO_PUBLIC_API" },
+
+      "mobile.app.forceStop": { "level": "NONE", "replacementTool": "ios.app.terminate", "reasonCode": "NO_OS_FORCE_STOP" },
+      "mobile.app.clearData": { "level": "NONE", "reasonCode": "NO_PUBLIC_API" },
+      "mobile.app.uninstall": { "level": "PARTIAL", "reasonCode": "SIGNED_DEVICECTL_OR_MDM" },
+      "mobile.app.install": { "level": "PARTIAL", "reasonCode": "SIGNED_IPA_OR_MDM" },
+      "mobile.app.permission.grant": { "level": "NONE", "reasonCode": "NO_PUBLIC_API" },
+      "mobile.app.permission.revoke": { "level": "PARTIAL", "replacementTool": "ios.permission.reset", "reasonCode": "XCUI_RESET_ONLY" },
+
+      "ios.permission.reset": { "level": "PARTIAL", "reasonCode": "XCUI_RESET_AUTHORIZATION" }
+    },
+
+    "simulator": {
+      "mobile.device.state": { "level": "FULL" },
+      "mobile.app.list": { "level": "FULL" },
+      "mobile.app.info": { "level": "FULL" },
+      "mobile.diag.battery": { "level": "PARTIAL", "reasonCode": "ENERGY_NOT_BATTERYSTATS" },
+      "mobile.diag.netstats": { "level": "PARTIAL", "reasonCode": "INSTRUMENTS_PER_APP" },
+      "mobile.diag.storage": { "level": "FULL" },
+
+      "mobile.diag.logcat": { "level": "NONE", "replacementTool": "ios.diag.logs", "reasonCode": "PROCESS_SCOPED_ONLY" },
+      "mobile.diag.batterystats": { "level": "NONE", "replacementTool": "ios.diag.energyProfile", "reasonCode": "NO_PUBLIC_API" },
+
+      "mobile.app.forceStop": { "level": "NONE", "replacementTool": "ios.app.terminate", "reasonCode": "NO_OS_FORCE_STOP" },
+      "mobile.app.clearData": { "level": "NONE", "replacementTool": "ios.simulator.resetAppData", "reasonCode": "USE_REINSTALL_NOT_ERASE" },
+      "mobile.app.uninstall": { "level": "FULL" },
+      "mobile.app.install": { "level": "FULL" },
+      "mobile.app.permission.grant": { "level": "PARTIAL", "reasonCode": "SIMCTL_PRIVACY" },
+      "mobile.app.permission.revoke": { "level": "PARTIAL", "reasonCode": "SIMCTL_PRIVACY" },
+
+      "ios.permission.reset": { "level": "FULL", "reasonCode": "SIMCTL_PRIVACY" },
+      "ios.simulator.resetAppData": { "level": "FULL", "note": "uninstall + reinstall the pinned artifact; NOT a device erase." },
+      "ios.simulator.eraseDevice": { "level": "FULL", "destructive": true, "defaultOff": true, "reasonCode": "FULL_SIMULATOR_WIPE" }
+    }
+  }
+}