[tmm]

Adds apps/zbugs-video, a script that records five zbugs apps on one screen against one backend: zbugs-swift on macOS, zbugs-gpui, zbugs-rune, zbugs on the web in a Chrome window, and zbugs-swift on an iPhone: the simulator (in Simulator, or Xcode 27's Device Hub), or a real iPhone through iPhone Mirroring with ZBUGS_VIDEO_DEVICE. All five log in with the backend's crew token.

• record.ts does the whole run:
  • Builds the apps, including the web app (vite build against the backend's zero-cache).
  • Seeds 20,000 synthetic issues into the zero project (zbugs' generate-synthetic).
  • Launches the apps and tiles them in two rows: Swift and GPUI on top; Rune, the web, and the iPhone below.
  • Records the screen at 60 fps with ffmpeg, adds a caption band for each step, and checks Postgres for each change.
• storyboard.ts holds the nine steps. One cursor rotates them across the apps, so each change shows up live in the other four:
  1. Rune creates an issue.
  2. The iPhone comments.
  3. The browser closes it.
  4. Swift on the Mac comments.
  5. Rune labels it and lists closed issues.
  6. The iPhone reopens it.
  7. GPUI renames it.
  8. The browser comments.
  9. Each app scrolls fast.
• ax.swift finds controls through the accessibility API:
  • Rune exposes its element keys.
  • Swift exposes its labels, on macOS and through the simulator alike.
  • Chrome exposes the web app's roles and text.
  • GPUI exposes none, so its targets come from its layout constants, checked by reading its screen text.
  • iPhone Mirroring exposes none either. The real iPhone's steps find what they tap in its screen text (ax text, macOS Vision), and each change is checked in another app before the take goes on.
• Clicks and typing that can be dropped right after switching apps retry until their change shows; a step whose change never shows stops the take.
• Captions are drawn by ax and overlaid, as Homebrew's ffmpeg can lack drawtext.
• The layout fits whatever the main screen is.
  • A screen whose halves are smaller than 900×520 (zbugs-rune's minimum window), such as a MacBook's default 1512×982, switches to its largest HiDPI mode for the take, then switches back.
  • The web app zooms out until its cell is wider than 900 CSS pixels, so it keeps its sidebar.
• apps/zbugs-swift/server/server.ts gains ZBUGS_WEB=1, which serves the web app's build on the API port. zero-cache only accepts the web client's mutate and query URLs from there.

It runs on demand on a Mac; CI is left for later. The README lists the macOS permissions it needs (Accessibility and Screen Recording).

Testing on a Mac satellite:

• Four apps, at 2560×1600 and at 1920×1200: all steps ran and the Postgres check passed at both sizes.
• Five apps, at 1920×1200: all nine steps ran and the Postgres check passed. The take is 1 min 55 s.
• Five apps with Xcode 27.3's Device Hub at 2560×1600: passed through accessibility, and twice more with the phone driven only by its screen text, as for iPhone Mirroring.
• On a MacBook with a 2560×1440 external screen: a full take from an earlier commit passed. The real-iPhone path hasn't run against a real iPhone yet.