[seanpk]

Adds a "see it without clicking" demo to the README, per the plan we discussed.

• scripts/demo.mjs (npm run demo) — drives the overlay through a scripted review against the static-site fixture and records docs/media/demo.webm plus three stills. Re-running overwrites in place, so the README never needs editing. It's a generator, not a test (excluded from the Playwright testDir), and lints under Node (locator APIs only; the on-screen cursor dot is injected as a script string).
• README — a three-beat visual story (select → comment → queue) with a ▶ Watch the demo link to the committed webm. Static images render inline on GitHub and npm; the webm plays via GitHub's file viewer when clicked.

Notes:

• Media is committed for rendering but not added to files, so the npm tarball stays small (39 files, no media). README uses absolute raw.githubusercontent.com/...@master URLs (matching the logo), so images resolve once this is on master.
• Why webm + a click-to-watch link instead of an inline GIF: a committed webm can't autoplay inline on GitHub (needs an attachment URL) and npm doesn't render <video> at all — so the static screenshots carry the inline story and the webm is the optional full-motion watch. A GIF can be added later if we want inline motion.

🤖 Generated with Claude Code