Rotorsoft / act-root / 23007721768

100%

push

github

feat(act-sse): add incremental state broadcast package

New @rotorsoft/act-sse library for efficient real-time state sync over SSE.
Computes RFC 6902 JSON Patches between consecutive aggregate snapshots and
sends only the diff, falling back to full state when patches are too large
or the client needs to resync.

Server: BroadcastChannel (per-stream subscribers + LRU cache + patch
computation), PresenceTracker (ref-counted online presence).
Client: applyBroadcastMessage() with version validation and resync detection.

Uses snap.event.version from the act event store as the single source of
truth for ordering — no separate version counters.

100% test coverage (33 tests). Scaffold skill updated with act-sse patterns
for events.routes.ts, broadcast.ts, useStateStream.ts, and production docs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

470 of 470 branches covered (100.0%)

Branch coverage included in aggregate %.

79 of 79 new or added lines in 4 files covered. (100.0%)

769 of 769 relevant lines covered (100.0%)

168.73 hits per line