Live-card motion in headless QEMU

Date: 2026-09-24 UTC. Source: clean impl/live-card-integrated aa9015191bc049a06d161392191c6e5745498cb6, with motion commits and host limits listed in the host checkpoint. The Nix build used nix build .#card-shell --max-jobs 1 --cores 4 --no-link --print-out-paths and passed from this source. Final package: /nix/store/py8nv6xlf2wc66jxmy6byvf0hskdc7ja-k230-card-shell; derivation: /nix/store/dkd44v0f6nnqv1nvrlldjzqqshzz1i15-k230-card-shell.drv. Its wrapper selects the actual RISC-V Sway executable at /nix/store/dcv9yzsa2mbbxmbiz1cp0dr5dkhlbxr8-sway-unwrapped-riscv64-unknown-linux-gnu-1.12/bin/sway (SHA-256 ff67a91c2544cabceefe2fc8d0177a8161e46053b2e8b3ab71aa1e1ac4ed3fbd). The live nested-surface fixture was /nix/store/6nskh3ldk3ya7mwxbb258qszrxhw2i61-card-composition-probe-client-0.1/bin/card-composition-probe-client.

The exact cross-built Sway ran under /usr/bin/qemu-riscv64-static with a 568×1232 headless wlroots output, Pixman renderer, two live fixture views, and SWAY_K230_CARD_TOUCH_FIRST=1. Commands and results:

CARD_SHELL_SWAY=<Sway path above> CARD_SHELL_CLIENT=<fixture path above> \
  python3 tests/test_card_shell_touch_first_runtime.py
  PASS: one actual Sway/Wayland runtime case, including a mapped drawer layer,
  no legacy Back hit target, fixed drawer/shade routes, live entry, expansion,
  and restored focus.
python3 tests/card_shell_runtime.py --sway <Sway path above> \
  --client <fixture path above> --touch-first \
  --output /tmp/k230-live-card-motion-evidence
  PASS: retained the synthetic fixture screenshots copied beside this note.
CARD_SHELL_SWAY=<Sway path above> CARD_SHELL_CLIENT=<fixture path above> \
  python3 tests/test_card_shell_composition.py
  PASS: 17 headless runtime checks, including private/unavailable placeholders,
  live-to-private transition, nested surfaces, and clean teardown.
CARD_SHELL_SWAY=<Sway path above> CARD_SHELL_CLIENT=<fixture path above> \
  python3 tests/test_card_shell_gestures.py
  PASS: the same 17 headless runtime checks.
CARD_SHELL_SWAY=<Sway path above> CARD_SHELL_CLIENT=<fixture path above> \
  python3 tests/test_card_shell_recovery.py
  PASS when run alone: recovery and disabled-adapter runtime routes.

An initial recovery invocation ran concurrently with the gestures QEMU suite and failed an existing one-second frame-callback increase assertion for one fixture ([5,4] remained [5,4] while the other advanced [26,25] to [35,34]). The identical recovery command passed when rerun alone. The concurrent failure is retained as a harness timing limit; no source fix or performance claim is inferred from the rerun.

The screenshots show actual compositor output of synthetic pixels. The purple live content bounds move from roughly (40,48)–(543,1087) at entry start to (77,100)–(487,947) in the middle and (120,152)–(435,807) at the end, using the same color threshold in each image. before-expand.png and during-expand.png show the selected live card growing toward the source view geometry. These captures prove visible intermediate geometry in headless QEMU, not physical panel presentation or a measured smooth frame cadence.

Remaining gates: inspect real-finger tracking and focus/cancel/privacy on the reserved board and camera, establish an actual presented-frame transition and CPU/frame budget profile with the integrated image, and record optical acceptance. The policy’s full-geometry timer dwell is not a Wayland frame or output-presented acknowledgment. No hardware or performance task is checked by this evidence.