Merge branch 'codex/2198-runner-demand' into codex/2198-proxy-parity

* codex/2198-runner-demand:
  feat(apple): release a speculative runner when the plan is proven observation-only
  refactor(daemon): move four pure leaves to their kits (#2347)
  fix(ios): stop charging every capture for a slow Simulator app discovery (#2331)
  refactor(commands): move commands-side rendering out of src/daemon and retire the doctor progress flag (#2349)

Author: thymikee

.fallowrc.json

@@ -97,6 +97,7 @@
       "exports": [
         "detachIosSimulatorRunnerSessionsForShutdown",
         "hasLiveIosRunnerSession",
+        "releaseSpeculativeIosRunnerSessionFor",
         "stopAllIosRunnerSessions"
       ]
     },

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Unreleased
 
+- Fixed: the iOS Simulator AX snapshot route bounds how long a capture waits for app discovery
+  and stops starting a discovery per capture. Discovery (`simctl launchctl list` through xcrun)
+  takes seconds on a loaded host; a capture now waits at most 1.5s for the one in-flight
+  discovery, takes the XCTest fallback, and the discovery keeps running under its own 15s
+  deadline for the captures that follow. Previously each capture ran its own probe with a 3s
+  timeout on its critical path, so a `wait` issued right after `open` could spend its budget on
+  probe timeouts and report `wait_capture_stalled` with the app already on screen.
 - Fixed: iOS snapshots no longer report `truncated: true` merely because a later backend produced
   them. The runner stamped every recovered capture as truncated — including a complete private-AX
   tree taken while the XCTest channel was penalized as slow — so a strict `is absent` / `wait absent`

CONTEXT.md

@@ -125,7 +125,7 @@ The daemon-side truth for route ownership and request-policy traits.
 Per-command classes steering Apple runner lifecycle and recovery, independent of the public surface.
 
 **Runner demand**:
-What a local-Simulator open prepares of the XCTest runner for the remaining batch steps.
+What a Simulator open prepares, or releases unused, of the XCTest runner for remaining steps.
 
 **Daemon RPC protocol version**:
 The integer that detects breaking compatibility across the remote daemon boundary.

packages/capture-kit/package.json

@@ -26,14 +26,14 @@
       "types": "./src/ios-snapshot-acquisition.ts",
       "default": "./src/ios-snapshot-acquisition.ts"
     },
-    "./ios-snapshot-planning": {
-      "types": "./src/ios-snapshot-planning.ts",
-      "default": "./src/ios-snapshot-planning.ts"
-    },
     "./ios-snapshot-engine": {
       "types": "./src/ios-snapshot-engine/index.ts",
       "default": "./src/ios-snapshot-engine/index.ts"
     },
+    "./ios-snapshot-planning": {
+      "types": "./src/ios-snapshot-planning.ts",
+      "default": "./src/ios-snapshot-planning.ts"
+    },
     "./mobile-snapshot-semantics": {
       "types": "./src/mobile-snapshot-semantics.ts",
       "default": "./src/mobile-snapshot-semantics.ts"
@@ -62,6 +62,14 @@
       "types": "./src/png-worker-client.ts",
       "default": "./src/png-worker-client.ts"
     },
+    "./post-gesture-stability": {
+      "types": "./src/post-gesture-stability.ts",
+      "default": "./src/post-gesture-stability.ts"
+    },
+    "./react-native-overlay": {
+      "types": "./src/react-native-overlay.ts",
+      "default": "./src/react-native-overlay.ts"
+    },
     "./screenshot-density": {
       "types": "./src/screenshot-density.ts",
       "default": "./src/screenshot-density.ts"
@@ -70,6 +78,10 @@
       "types": "./src/screenshot-diff-pixels.ts",
       "default": "./src/screenshot-diff-pixels.ts"
     },
+    "./screenshot-overlay": {
+      "types": "./src/screenshot-overlay.ts",
+      "default": "./src/screenshot-overlay.ts"
+    },
     "./snapshot-desktop-projection": {
       "types": "./src/snapshot-desktop-projection.ts",
       "default": "./src/snapshot-desktop-projection.ts"

src/daemon/post-gesture-stability.ts …apture-kit/src/post-gesture-stability.tssrc/daemon/post-gesture-stability.ts renamed to packages/capture-kit/src/post-gesture-stability.ts src/daemon/post-gesture-stability.ts renamed to packages/capture-kit/src/post-gesture-stability.ts

@@ -1,11 +1,11 @@
 import assert from 'node:assert/strict';
 import { test } from 'vitest';
 import type { SnapshotNode } from '@agent-device/kernel/snapshot';
-import { makeSnapshotState } from '../../__tests__/test-utils/snapshot-builders.ts';
+import { makeSnapshotState } from './snapshot-state.fixtures.ts';
 import {
   isAndroidUnlabeledClickableSource,
   resolveAndroidOverlaySourceRect,
-} from '../screenshot-overlay/android.ts';
+} from './screenshot-overlay-android.ts';
 
 const SCREEN = { x: 0, y: 0, width: 1080, height: 1920 };
 

src/core/react-native-overlay.ts …/capture-kit/src/react-native-overlay.tssrc/core/react-native-overlay.ts renamed to packages/capture-kit/src/react-native-overlay.ts src/core/react-native-overlay.ts renamed to packages/capture-kit/src/react-native-overlay.ts

@@ -1,6 +1,6 @@
 import type { Rect, SnapshotNode, SnapshotState } from '@agent-device/kernel/snapshot';
 import { isViewportRootNode, normalizeType } from '@agent-device/contracts/snapshot';
-import { hasPositiveRect, rectArea, rectContains, unionRects } from './rects.ts';
+import { hasPositiveRect, rectArea, rectContains, unionRects } from './screenshot-overlay-rects.ts';
 
 /**
  * Android overlay policy (#1983): which Android nodes earn an overlay ref, and what rectangle

…sts__/screenshot-overlay-android.test.ts …t/src/screenshot-overlay-android.test.tssrc/snapshot/__tests__/screenshot-overlay-android.test.ts renamed to packages/capture-kit/src/screenshot-overlay-android.test.ts src/snapshot/__tests__/screenshot-overlay-android.test.ts renamed to packages/capture-kit/src/screenshot-overlay-android.test.ts

@@ -1,6 +1,6 @@
 import type { Rect, ScreenshotOverlayRef } from '@agent-device/kernel/snapshot';
-import type { PNG } from '@agent-device/capture-kit/png';
-import { clamp } from '../snapshot/screenshot-overlay/rects.ts';
+import type { PNG } from './png.ts';
+import { clamp } from './screenshot-overlay-rects.ts';
 
 /**
  * Rasterizing one overlay ref onto a decoded PNG: border, badge, and the bitmap glyphs the badge