verify

Apps here render via the kitty graphics protocol, so they can be verified without a real terminal. Every verification is **recorded**: the harness in `tools/verify-recorder/` captures every frame the app emits, overlays your inputs (click ripples, caption bar), encodes a video, and generates a summary page. Do not hand-roll one-off pty scripts that only dump PNGs. ## Writing a verification Write a driver script (in /tmp is fine) using the checked-in package: ```python import sys sys.path.insert(0, "<repo>/tools/verify-recorder") from driver import Driver from recorder import Recorder rec = Recorder("wheel-pan", title="Wheel pan keeps cursor anchored") d = Driver(["<repo>/engine/target/debug/typing"], rec, cols=120, rows=32, xpixel=1200, ypixel=800) d.pump(3.0) # pump between actions so frames arrive rec.check("app painted", d.frame_size is not None, f"{d.frame_size}") w, h = d.frame_size # REAL framebuffer size — always use this d.text("hello", "type into editor") # every input takes a description d.click(w // 2, h // 3, "select the note") # mouse coords are pixels (1016 mode) d.wheel(w // 2, h // 2, down=True, n=3, description="scroll content") d.pump(1.0) rec.check("scroll redrew", len(rec.frames) > 40, f"{len(rec.frames)} frames") rec.still("after-scroll") # named snapshot for the summary page d.stop("ctrl+c") # or "ctrl+q" depending on the ...