Injected gesture acceptance procedure

Run this only with the board operator holding the serial and graphical-session reservation. It is a board-local helper: it uses the existing tools/inject-tap.sh virtual touchscreen and captures native Wayland PNGs with grim.

The helper alternates 20 left and 20 right drags from the Apps card region, waiting at least 250 ms after every drag. It captures an explicitly shown keyboard, explicitly hides it before overview/Back, counts current windows through a read-only command, opens the overview with an upward drag, and taps its Back control. It writes acceptance.json, native PNGs, copied metrics if supplied, and optional /proc/<launcher-pid> memory snapshots.

The persistent bar controls wvkbd-mobintl with:

pkill -RTMIN -x wvkbd-mobintl

That signal is a toggle. The pinned wvkbd main.c signal handlers also define SIGUSR2 as show and SIGUSR1 as hide; use those explicit commands in automated runs. The helper deliberately has no default show/hide command.

Copy this helper and tools/inject-tap.sh into /run first. The interpreter and metadata helper are closure dependencies referenced by the installed wrappers; they need not have their own system-profile symlinks.

K230_TEST_PYTHON=$(sed -n 's/^exec \([^ ]*\/python3\) .*/\1/p' /run/current-system/sw/bin/k230-video-session)
K230_TEST_WINDOW_CATALOG=$(sed -n 's/^export K230_WINDOW_CATALOG=//p' /run/current-system/sw/bin/k230-touch-launcher)
"$K230_TEST_PYTHON" /run/gesture-acceptance.py --execute \
  --device /dev/input/eventN \
  --inject-script /path/to/inject-tap.sh \
  --keyboard-show-command 'pkill -USR2 -x wvkbd-mobintl' \
  --keyboard-hide-command 'pkill -USR1 -x wvkbd-mobintl' \
  --window-catalog-command "$K230_TEST_WINDOW_CATALOG" \
  --launcher-pid "$(pidof k230-touch-launcher)" \
  --metrics-file /run/shell/launcher-metrics.txt \
  --output-dir docs/evidence/launcher-gestures/UTC-run

The execution mode refuses a catalog with fewer than two rows, so an empty or single-card overview is not accepted as a multi-card result. It retains only that row count: do not save or publish raw window titles or the catalog command output.

Start the native launcher with K230_LAUNCHER_METRICS=/run/shell/launcher-metrics.txt before the run. The fields distinguish wall-clock render and release-to-submit intervals from CLOCK_PROCESS_CPUTIME_ID CPU time since release. They also record transient snapshot bytes, live Wayland buffer count, direction, page and overview mode. These do not measure display scanout or physical presentation. Check settled page/direction records against all 40 requested swipes before claiming no missed or duplicate transition; the helper records requested actions, not that acceptance verdict.

The default is plan-only: it writes a plan but makes no board, uinput, grim, or physical-touch claim. --self-test is a host-only mocked subprocess check of action order, the 42 injected drags, settle waits, and before/after resource snapshots.

This is injected-touch evidence only. A separate real-finger camera trial must show left/right paging, overview entry/exit, a card tap, and Back before the physical-glass task can close. Do not tick any hardware task from this procedure alone.