[charleslpan]

Stacked on #3266 (luke/neon-realtime-service-wake). Released desktops keep holding GET /api/mac-commands until the version gate cuts them off, so this PR makes that held read wait on Realtime too. Desktops on #3285 don't use this route.

Change

• macCommandsFor now waits through lookedUntil from feat(service): the service's held reads and waits on a row are woken by Neon Realtime #3266, in place of Effect.repeat(Schedule.spaced(POLL)) + timeoutOption(HOLD). Between looks it waits for Neon Realtime to report that the account's unclaimed commands changed. The heartbeat on arrival, the 20 s hold, and the claim at the end are unchanged.
• New macCommandsWaitingLiveStatement(userId) in mac-command-store.ts: SELECT id FROM mac_command WHERE user_id = $1 AND claimed_at IS NULL. It selects ids only, never the command text, and has no clock window. The read's own look still checks CLAIM_WINDOW. It mirrors feat(service): the Mac's commands are sealed for following over Neon Realtime, claimed by id #3274's macCommandsLiveStatement, which the Mac subscribes to and which also carries what to run. It's kept separate so that the conflict with feat(service): the Mac's commands are sealed for following over Neon Realtime, claimed by id #3274 stays to adjacent additions.

Tests

• mac-command-store.test.ts (PGlite): the wake statement returns the account's unclaimed commands by id only, drops one once it's claimed, and reads nothing of another account's.
• mac-commands-app.test.ts: with a scripted LiveWake, a held read answers a command queued while it's held as soon as the watch says the rows changed, with no TestClock advance. It also watches only the account's own statement. Without the change the test times out, because the read waits out its poll.

pnpm check:affected passes except apps/desktop/src/main/app-menu.test.ts, which is known to fail in the sandbox.

Made with Luke

---

Summary by cubic

Makes the Mac's held GET /api/mac-commands read wake on Neon Realtime instead of its 500 ms poll, so queued commands are answered as soon as they're queued.

• macCommandsFor now waits on Realtime between looks through the new macCommandsWaitingLiveStatement, which selects the account's unclaimed command ids only. It falls back to the poll only where the deployment has no Realtime. The heartbeat, 20 s hold, and final claim are unchanged.

^{Written for commit 21eed83. Summary will update on new commits.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
luke-web	Ready	Preview	Oct 20, 2026 2:37am UTC

[luke-agent]

Closing for now: the developer moved every area onto the central live layer with Neon Realtime off (LUKE_REALTIME, #4267; held polls, #4272), and this change only does something with Realtime on. The branch is kept, so the PR can be reopened and rebased when LUKE_REALTIME goes back on.