feat(screenshot): --native-density keeps the display's own pixels

Draft
TU
5d ago
+357-31

Summary

Add --native-density for iOS simulator screenshots to retain captured pixels and report the scale and logical dimensions for tap mapping. Native density is admitted only by capture owners that report the scale; explicit runner and provider captures are refused. The option is carried consistently as a boolean.

agent-device screenshot --native-density --json

Validation

  • Head: 38ec6490; base: 093341a60.
  • pnpm check:affected --run --base origin/main --head HEAD passed all runnable local checks at the exact commit: format, lint, typecheck, layering, fallow, build, related tests and unit checks. Unit tests: 17,667 passed, 70 skipped; the unit check also ran its smoke and temporary-file checks.
  • Fixed two pre-existing test problems encountered during validation: inefficient fake-time advancement in Apple runner lease testing, and a daemon startup race fixture that spawned an untracked second contender. The latter failed at the same assertion on the unchanged base.
  • Focused screenshot and capture capability tests passed. In an isolated checkout, removing the native-density early return failed the pixel-size test (42 versus 126); removing daemon forwarding failed the metadata test.
  • Live verification at this head remains outstanding: the iPhone 17 Pro simulator failed to boot twice in the device host without details. The earlier live results in this PR predate the rebases and do not validate this head. GitHub-authoritative checks remain outstanding.