refactor(capture-kit): re-point capture and recording consumers to the new subpaths

Rewires every consumer of the relocated snapshot/recording modules to the new @agent-device/capture-kit subpath exports, adds the 23 subpath entries to the capture-kit exports map, fixes the moved recording-scripts test's __dirname-relative paths for the deeper location, and records the completed migration in ADR 0019's end state.

Author: thymikee

docs/adr/0019-request-bound-platform-runtime.md

@@ -902,42 +902,25 @@ target, unverified**, not a derived number.
   The root files that remain are either declared host-port adapters (e.g. `adb-host`, bound only
   by its named root file per Decision §1) or mechanics whose wave has not landed yet — the two are
   not distinguished by filename and need per-file classification before a target is set.
-- `src/recording`, `src/snapshot`, `src/snapshot-quality`, `src/screenshot-diff`. Corrected
-  2026-09-03: `packages/capture-kit/src/` already has broad production ownership across
-  recording (`screen-recording-live-handle.ts`, `screen-recording-completion.ts`,
-  `screen-recording-options.ts`, consumed by `platform-android`/`platform-apple`/
-  `platform-harmonyos`/`platform-web`'s `recording/runtime.ts`), screenshot/diff
-  (`png.ts`, `png-worker-client.ts`, imported by `src/screenshot-diff/screenshot-diff.ts`),
-  snapshot quality (`snapshot-quality-verdict.ts`, `snapshot-quality-backend-capabilities.ts` —
-  `src/snapshot-quality/` now holds only a cross-package regression test, no production file),
-  occlusion (`snapshot-occlusion.ts`), audio/app-log (`audio-probe-runtime.ts`,
-  `app-log-live-handle.ts`, consumed by `platform-android`, `platform-apple`, and
-  `provider-limrun`), and iOS acquisition/engine (`ios-snapshot-acquisition.ts`,
-  `ios-snapshot-planning.ts`, `ios-snapshot-engine/`, consumed by
-  `src/snapshot/ios-snapshot-runtime.ts`). ADR §1's amendment already assigns this capture
-  domain to `capture-kit`; the domain mechanics are migrated. What remains under `src/` in
-  these four directories, verified file-by-file at HEAD, is daemon-facing composition with no
-  existing package equivalent, not unmigrated capture mechanics:
-  - `src/recording/{output-path,overlay,swift-cache,telemetry,video,video-webm}.ts` — video
-    playability polling, overlay burn-in, telemetry persistence, and output-path resolution,
-    imported only by `src/platform-runtime-screen-recording-*.ts` and
-    `src/daemon/handlers/record-runtime*.ts`. Equivalent: none.
-  - `src/snapshot/ios-snapshot-runtime.ts` and `snapshot-visibility.ts` — composition over the
-    capture-kit acquisition/planning/engine/semantics calls above. Equivalent: capture-kit
-    (mechanics already migrated; these are the composition callers).
-  - `src/snapshot/{android-replacement-surface-occlusion,rect-coverage,scroll-edge-state,
-    snapshot-desktop-surface,snapshot-diff,snapshot-evidence,snapshot-label-dedup,
-    snapshot-lines,snapshot-node-label,snapshot-timeout-policy}.ts` — none import capture-kit.
-    `android-replacement-surface-occlusion.ts` implements a distinct Android-specific
-    footprint algorithm, not the generic viewport pruning in capture-kit's
-    `snapshot-occlusion.ts`. Equivalent: none.
-  - `src/snapshot-quality/__tests__/warnings.test.ts` — the sole survivor in that directory;
-    exercises `renderSnapshotQualityWarnings` (root) against capture-kit's
-    `readSnapshotQualityVerdict`. Equivalent: capture-kit (production logic fully migrated).
-  - `src/screenshot-diff/*.ts` (region split/overlay/summarization/component composition) —
-    pixel-diff computation and PNG decode/encode already call capture-kit's `png`/
-    `png-worker-client`; the root files remain for daemon/CLI diff-report composition.
-    Equivalent: none (built atop already-migrated capture-kit mechanics).
+- `src/recording`, `src/snapshot`, `src/snapshot-quality` — **migrated to
+  `packages/capture-kit/src/` (2026-09-07)**: the whole trees moved as-is (`recording/`,
+  `snapshot/` including its `snapshot-presentation/` and `snapshot-freshness/` subtrees),
+  together with the cross-package `warnings.test.ts` regression test. The four snapshot
+  modules from `src/core/` (`snapshot-chrome.ts`, `snapshot-state.ts`,
+  `snapshot-tree-ingestion.ts`, `snapshot-node-lookup.ts`, with their tests) joined the
+  package root. External consumers (daemon, commands, platform hosts, integration tests)
+  use package subpath exports (e.g. `@agent-device/capture-kit/snapshot-lines`,
+  `/recording-video`, `/ios-snapshot-runtime`); `snapshot-tree-ingestion` carries no
+  subpath because only `snapshot-state.ts` (same package) consumes it. Three tests stayed
+  at the root — `src/core/__tests__/snapshot-state.test.ts` and
+  `snapshot-chrome-android-statusbar.test.ts` (pinned to root-owned
+  `interaction-targeting` and the android UI-hierarchy fixtures) and
+  `src/__tests__/snapshot-desktop-surface.test.ts` (pinned to the root
+  eager-import-closure fixtures).
+- `src/screenshot-diff/*.ts` (region split/overlay/summarization/component composition) —
+  pixel-diff computation and PNG decode/encode already call capture-kit's `png`/
+  `png-worker-client`; the root files remain for daemon/CLI diff-report composition.
+  Equivalent: none (built atop already-migrated capture-kit mechanics).
 - `src/provider-device-runtime.ts`, `src/provider-device-runtimes.ts`,
   `src/provider-limrun-runtime.ts`, `src/provider-webdriver.ts`. Mostly already thin: the bulk of
   WebDriver and Limrun provider logic lives in `packages/provider-webdriver/src/` and

packages/capture-kit/package.json

@@ -14,6 +14,10 @@
       "types": "./src/index.ts",
       "default": "./src/index.ts"
     },
+    "./android-replacement-surface-occlusion": {
+      "types": "./src/snapshot/android-replacement-surface-occlusion.ts",
+      "default": "./src/snapshot/android-replacement-surface-occlusion.ts"
+    },
     "./durable-capture": {
       "types": "./src/durable-capture/index.ts",
       "default": "./src/durable-capture/index.ts"
@@ -34,6 +38,10 @@
       "types": "./src/ios-snapshot-planning.ts",
       "default": "./src/ios-snapshot-planning.ts"
     },
+    "./ios-snapshot-runtime": {
+      "types": "./src/snapshot/ios-snapshot-runtime.ts",
+      "default": "./src/snapshot/ios-snapshot-runtime.ts"
+    },
     "./mobile-snapshot-semantics": {
       "types": "./src/mobile-snapshot-semantics.ts",
       "default": "./src/mobile-snapshot-semantics.ts"
@@ -66,10 +74,34 @@
       "types": "./src/post-gesture-stability.ts",
       "default": "./src/post-gesture-stability.ts"
     },
+    "./quality-warnings": {
+      "types": "./src/snapshot/snapshot-presentation/quality-warnings.ts",
+      "default": "./src/snapshot/snapshot-presentation/quality-warnings.ts"
+    },
     "./react-native-overlay": {
       "types": "./src/react-native-overlay.ts",
       "default": "./src/react-native-overlay.ts"
     },
+    "./recording-output-path": {
+      "types": "./src/recording/output-path.ts",
+      "default": "./src/recording/output-path.ts"
+    },
+    "./recording-overlay": {
+      "types": "./src/recording/overlay.ts",
+      "default": "./src/recording/overlay.ts"
+    },
+    "./recording-telemetry": {
+      "types": "./src/recording/telemetry.ts",
+      "default": "./src/recording/telemetry.ts"
+    },
+    "./recording-video": {
+      "types": "./src/recording/video.ts",
+      "default": "./src/recording/video.ts"
+    },
+    "./repeated-nav-subtree": {
+      "types": "./src/snapshot/snapshot-presentation/repeated-nav-subtree.ts",
+      "default": "./src/snapshot/snapshot-presentation/repeated-nav-subtree.ts"
+    },
     "./screenshot-density": {
       "types": "./src/screenshot-density.ts",
       "default": "./src/screenshot-density.ts"
@@ -82,14 +114,58 @@
       "types": "./src/screenshot-overlay.ts",
       "default": "./src/screenshot-overlay.ts"
     },
+    "./scroll-edge-state": {
+      "types": "./src/snapshot/scroll-edge-state.ts",
+      "default": "./src/snapshot/scroll-edge-state.ts"
+    },
+    "./snapshot-chrome": {
+      "types": "./src/snapshot-chrome.ts",
+      "default": "./src/snapshot-chrome.ts"
+    },
     "./snapshot-desktop-projection": {
       "types": "./src/snapshot-desktop-projection.ts",
       "default": "./src/snapshot-desktop-projection.ts"
     },
+    "./snapshot-desktop-surface": {
+      "types": "./src/snapshot/snapshot-desktop-surface.ts",
+      "default": "./src/snapshot/snapshot-desktop-surface.ts"
+    },
+    "./snapshot-diff": {
+      "types": "./src/snapshot/snapshot-diff.ts",
+      "default": "./src/snapshot/snapshot-diff.ts"
+    },
+    "./snapshot-evidence": {
+      "types": "./src/snapshot/snapshot-evidence.ts",
+      "default": "./src/snapshot/snapshot-evidence.ts"
+    },
+    "./snapshot-freshness": {
+      "types": "./src/snapshot/snapshot-freshness/index.ts",
+      "default": "./src/snapshot/snapshot-freshness/index.ts"
+    },
+    "./snapshot-label-dedup": {
+      "types": "./src/snapshot/snapshot-label-dedup.ts",
+      "default": "./src/snapshot/snapshot-label-dedup.ts"
+    },
+    "./snapshot-lines": {
+      "types": "./src/snapshot/snapshot-lines.ts",
+      "default": "./src/snapshot/snapshot-lines.ts"
+    },
+    "./snapshot-node-lookup": {
+      "types": "./src/snapshot-node-lookup.ts",
+      "default": "./src/snapshot-node-lookup.ts"
+    },
     "./snapshot-occlusion": {
       "types": "./src/snapshot-occlusion.ts",
       "default": "./src/snapshot-occlusion.ts"
     },
+    "./snapshot-presentation-android-helper": {
+      "types": "./src/snapshot/snapshot-presentation/android/helper.ts",
+      "default": "./src/snapshot/snapshot-presentation/android/helper.ts"
+    },
+    "./snapshot-presentation-ios-transitions-fixtures": {
+      "types": "./src/snapshot/snapshot-presentation/ios/transitions.fixtures.ts",
+      "default": "./src/snapshot/snapshot-presentation/ios/transitions.fixtures.ts"
+    },
     "./snapshot-quality-backend-capabilities": {
       "types": "./src/snapshot-quality-backend-capabilities.ts",
       "default": "./src/snapshot-quality-backend-capabilities.ts"
@@ -101,6 +177,22 @@
     "./snapshot-rect-projection": {
       "types": "./src/snapshot-rect-projection.ts",
       "default": "./src/snapshot-rect-projection.ts"
+    },
+    "./snapshot-state": {
+      "types": "./src/snapshot-state.ts",
+      "default": "./src/snapshot-state.ts"
+    },
+    "./snapshot-timeout-policy": {
+      "types": "./src/snapshot/snapshot-timeout-policy.ts",
+      "default": "./src/snapshot/snapshot-timeout-policy.ts"
+    },
+    "./snapshot-visibility": {
+      "types": "./src/snapshot/snapshot-visibility.ts",
+      "default": "./src/snapshot/snapshot-visibility.ts"
+    },
+    "./text-surface": {
+      "types": "./src/snapshot/snapshot-presentation/text-surface.ts",
+      "default": "./src/snapshot/snapshot-presentation/text-surface.ts"
     }
   },
   "devDependencies": {

packages/capture-kit/src/__tests__/test-utils/video-fixtures.ts

@@ -0,0 +1,8 @@
+export function likelyPlayableWebmContainer(): Buffer {
+  // One 16x16 VP8 keyframe generated by ffmpeg. Unlike a marker-only synthetic fixture,
+  // ffprobe identifies this as a WebM video stream with a 40ms duration.
+  return Buffer.from(
+    'GkXfo59ChoEBQveBAULygQRC84EIQoKEd2VibUKHgQJChYECGFOAZwEAAAAAAAHpEU2bdLpNu4tTq4QVSalmU6yBoU27i1OrhBZUrmtTrIHYTbuMU6uEElTDZ1OsggElTbuMU6uEHFO7a1OsggHT7AEAAAAAAABZAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAVSalmsirXsYMPQkBNgI1MYXZmNjIuMTIuMTAxV0GNTGF2ZjYyLjEyLjEwMUSJiEBEAAAAAAAAFlSua8iuAQAAAAAAAD/XgQFzxYgNIomR4viG6pyBACK1nIN1bmSIgQCGhVZfVlA4g4EBI+ODhAJiWgDgkLCBELqBEJqBAlWwhFW5gQESVMNn/HNzoGPAgGfImkWjh0VOQ09ERVJEh41MYXZmNjIuMTIuMTAxc3PWY8CLY8WIDSKJkeL4hupnyKFFo4dFTkNPREVSRIeUTGF2YzYyLjI4LjEwMSBsaWJ2cHhnyKFFo4hEVVJBVElPTkSHkzAwOjAwOjAwLjA0MDAwMDAwMAAfQ7Z1qOeBAKOjgQAAgBACAJ0BKhAAEAAARwiFhYiFhIgCAgAMDWAA/v+rUIAcU7trkbuPs4EAt4r3gQHxggGm8IED',
+    'base64',
+  );
+}

packages/capture-kit/src/recording/__tests__/overlay.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, beforeEach, expect, test, vi } from 'vitest';
 import fs from 'node:fs';
 import path from 'node:path';
-import { mkdtempForTestSync } from '../../__tests__/test-utils/tmp-dir.ts';
+import { mkdtempForTestSync } from '../../tmp-dir.fixtures.ts';
 
 vi.mock('@agent-device/host-kit/command', async (importOriginal) => {
   const fs = await import('node:fs');

packages/capture-kit/src/recording/__tests__/recording-scripts.test.ts

@@ -8,9 +8,9 @@ import { getRecordingOverlaySupportWarning } from '../overlay.ts';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const recordingScriptsDir = path.resolve(
   __dirname,
-  '../../../apple/runner/AgentDeviceRunner/RecordingScripts',
+  '../../../../../apple/runner/AgentDeviceRunner/RecordingScripts',
 );
-const recordingTestSupportDir = path.resolve(__dirname, '../../../test/integration/support');
+const recordingTestSupportDir = path.resolve(__dirname, '../../../../../test/integration/support');
 const SWIFT_TYPECHECK_TIMEOUT_MS = 60_000;
 let swiftCompilerPath = 'swiftc';
 let swiftSdkPath = '';

packages/capture-kit/src/recording/swift-cache.test.ts

@@ -1,7 +1,7 @@
 import { afterEach, beforeEach, expect, test, vi } from 'vitest';
 import fs from 'node:fs';
 import path from 'node:path';
-import { mkdtempForTestSync } from '../__tests__/test-utils/tmp-dir.ts';
+import { mkdtempForTestSync } from '../tmp-dir.fixtures.ts';
 
 vi.mock(import('@agent-device/host-kit/command'), async (importOriginal) => ({
   ...(await importOriginal()),

packages/capture-kit/src/recording/video-webm.test.ts

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { expect, test } from 'vitest';
 import { likelyPlayableWebmContainer } from '../__tests__/test-utils/video-fixtures.ts';
-import { mkdtempForTestSync } from '../__tests__/test-utils/tmp-dir.ts';
+import { mkdtempForTestSync } from '../tmp-dir.fixtures.ts';
 import { hasPlayableWebmStructure } from './video-webm.ts';
 
 const directory = mkdtempForTestSync('agent-device-video-webm-structure-');

packages/capture-kit/src/recording/video.test.ts

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { expect, test } from 'vitest';
 import { likelyPlayableWebmContainer } from '../__tests__/test-utils/video-fixtures.ts';
-import { mkdtempForTestSync } from '../__tests__/test-utils/tmp-dir.ts';
+import { mkdtempForTestSync } from '../tmp-dir.fixtures.ts';
 import { isPlayableVideo } from './video.ts';
 
 const directory = mkdtempForTestSync('agent-device-video-webm-');

packages/capture-kit/src/snapshot-chrome.test.ts

@@ -1,7 +1,7 @@
 import { test } from 'vitest';
 import assert from 'node:assert/strict';
 import { attachRefs, type RawSnapshotNode, type SnapshotNode } from '@agent-device/kernel/snapshot';
-import { collectSettleChromeRefs } from '../snapshot-chrome.ts';
+import { collectSettleChromeRefs } from './snapshot-chrome.ts';
 
 function refFor(nodes: SnapshotNode[], label: string): string {
   const node = nodes.find((candidate) => candidate.label === label);

packages/capture-kit/src/snapshot-node-lookup.test.ts

@@ -1,7 +1,7 @@
 import assert from 'node:assert/strict';
 import { test } from 'vitest';
 import { attachRefs } from '@agent-device/kernel/snapshot';
-import { findNodeByLabel, resolveRefLabel } from '../snapshot-node-lookup.ts';
+import { findNodeByLabel, resolveRefLabel } from './snapshot-node-lookup.ts';
 
 test('findNodeByLabel matches label, value, and identifier case-insensitively', () => {
   const nodes = attachRefs([