Merge pull request #164 from Lykhoyda/feat/rn-device-ios-first-mvp

feat(rn-device): iOS-first MVP — replace external agent-device iOS surface

Author: Lykhoyda

.gitignore

@@ -10,8 +10,10 @@ reports
 # Vendored native drivers (installed by agent-device)
 drivers/
 
-# Workspace symlinks (local dev only)
-scripts/fast-runner/build/
+# Xcode build artifacts for the imported iOS runner
+scripts/rn-fast-runner/build/
+scripts/rn-fast-runner/**/xcuserdata/
+scripts/rn-fast-runner/**/DerivedData/
 
 # Local worktrees for isolated feature work
 .worktrees/

scripts/cdp-bridge/dist/agent-device-wrapper.js

@@ -1,4 +1,5 @@
 let refMap = new Map();
+let metadataMap = new Map();
 let screenRect = null;
 let lastUpdated = 0;
 export function updateRefMap(nodes) {
@@ -35,9 +36,107 @@ export function getRefMapAge() {
 }
 export function clearRefMap() {
     refMap.clear();
+    metadataMap.clear();
     screenRect = null;
     lastUpdated = 0;
 }
 export function hasRefMap() {
     return refMap.size > 0;
 }
+export function flattenXCUITree(tree) {
+    const nodes = [];
+    const localRefMap = new Map();
+    let counter = 0;
+    const walk = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        if (node.frame) {
+            const id = `e${counter}`;
+            counter++;
+            const rect = {
+                x: node.frame.x,
+                y: node.frame.y,
+                width: node.frame.width,
+                height: node.frame.height,
+            };
+            const flat = {
+                ref: `@${id}`,
+                type: node.type ?? '',
+                rect,
+            };
+            if (node.label !== undefined)
+                flat.label = node.label;
+            if (node.identifier !== undefined)
+                flat.identifier = node.identifier;
+            if (node.enabled !== undefined)
+                flat.enabled = node.enabled;
+            if (node.hittable !== undefined)
+                flat.hittable = node.hittable;
+            nodes.push(flat);
+            localRefMap.set(id, rect);
+        }
+        if (Array.isArray(node.children)) {
+            for (const child of node.children)
+                walk(child);
+        }
+    };
+    walk(tree);
+    return { nodes, refMap: localRefMap };
+}
+export function updateRefMapFromFlat(nodes) {
+    refMap.clear();
+    metadataMap.clear();
+    screenRect = null;
+    for (const node of nodes) {
+        if (!node.ref || !node.rect)
+            continue;
+        const key = node.ref.startsWith('@') ? node.ref.slice(1) : node.ref;
+        refMap.set(key, node.rect);
+        const meta = { type: node.type };
+        if (node.label !== undefined)
+            meta.label = node.label;
+        if (node.identifier !== undefined)
+            meta.identifier = node.identifier;
+        metadataMap.set(key, meta);
+        if (!screenRect && node.rect.x === 0 && node.rect.y === 0 && node.rect.width > 300) {
+            screenRect = node.rect;
+        }
+    }
+    lastUpdated = Date.now();
+}
+export function getCachedMetadata(ref) {
+    const key = ref.startsWith('@') ? ref.slice(1) : ref;
+    return metadataMap.get(key) ?? null;
+}
+function metadataMatches(a, b) {
+    return a.type === b.type && a.label === b.label && a.identifier === b.identifier;
+}
+function flatNodeMetadata(node) {
+    const meta = { type: node.type };
+    if (node.label !== undefined)
+        meta.label = node.label;
+    if (node.identifier !== undefined)
+        meta.identifier = node.identifier;
+    return meta;
+}
+export function isRefStale(ref, newNodes) {
+    const cached = getCachedMetadata(ref);
+    if (!cached)
+        return true;
+    const target = ref.startsWith('@') ? ref : `@${ref}`;
+    const fresh = newNodes.find((n) => n.ref === target);
+    if (!fresh)
+        return true;
+    return !metadataMatches(cached, flatNodeMetadata(fresh));
+}
+export function findNewRefByMetadata(oldRef, newNodes) {
+    const cached = getCachedMetadata(oldRef);
+    if (!cached)
+        return null;
+    for (const node of newNodes) {
+        if (metadataMatches(cached, flatNodeMetadata(node))) {
+            return node.ref;
+        }
+    }
+    return null;
+}