chore: adopt openadapt-capture 0.5.4 and run the adapter tests in CI

[abrichr]

What

openadapt-capture's live Recorder is the recorder for OpenAdapt's desktop path. This PR brings flow's integration up to date with capture 0.5.4 and makes the adapter test coverage real in CI.

1. Pin bump: capture extra → openadapt-capture>=0.5.4

0.5.3/0.5.4 fixed the screenshot-at-import side effect (headless import now clean) and persist pixel_ratio on the recording model. uv.lock already resolved 0.5.4; only the specifier line is synced (no resolution change).

2. Three stale "capture screenshots the display at import" comments replaced

• pyproject.toml (the capture extra comment) — now documents why 0.5.4 is the floor and that the extra runs in headless CI.
• tests/test_capture_adapter.py — docstring + import-guard comments updated; the blanket try/except → skip around the import is removed: the module now skips only when the optional extra is absent. With the extra installed (as in CI), an import failure is a real regression and fails loudly instead of silently skipping.
• openadapt_flow/adapters/capture.py — HiDPI caveat now accurate: sessions recorded with ≥0.5.4 always persist pixel_ratio; the under-scaling caveat applies only to legacy 0.5.x sessions that lack it.

3. Adapter tests now REAL in CI

The fast unit test job installs .[dev,capture] and runs a cheap guard step (python -c "import openadapt_capture") proving the headless-import invariant before the suite. Result: the 13 tests in tests/test_capture_adapter.py — which build a REAL capture session (SQLAlchemy recording.db + VideoWriter mp4) and feed the converted recording to the UNMODIFIED compiler — now execute on every PR instead of silently skipping. This makes docs/desktop/RECORDING.md's "convert_capture, CI-tested" claim true (claim kept, not weakened). claims.yaml evidence/caveat updated to state precisely what CI proves (real on-disk session → convert → compile → replay; the live recorder has its own integration suite in the capture repo).

Verification (local, capture 0.5.4 installed headless-importable)

• pytest tests/test_capture_adapter.py → 13 passed
• ruff check openadapt_flow clean, ruff format --check clean, mypy clean
• python scripts/check_consistency.py → "Consistency gate passed"

Notes

• Deliberately does NOT touch openadapt_flow/backends/windows*, win_agent, runtime/replayer.py, resolver, or macOS-pixel files, and does not touch README.md (owned by a separate PR).
• Open PR feat(effects): effect-verifier kit — declarative verifiers, coverage gates, reconciliation tasks #134 (effects) also touches pyproject.toml; the pin change here is a single line and conflict-tolerant regardless of merge order.
• Companion PR: chore: modernize Recorder framing, CI coverage, and dependency floors openadapt-capture#28 (Recorder reframing + windows/macos CI legs + dep floors).

🤖 Generated with Claude Code