Skip to content

chore: spec §11 polling permanent; remove @hono/node-ws - #52

Merged
curtyo18 merged 1 commit into
mainfrom
chore/spec11-polling-permanent
May 17, 2026
Merged

chore: spec §11 polling permanent; remove @hono/node-ws#52
curtyo18 merged 1 commit into
mainfrom
chore/spec11-polling-permanent

Conversation

@curtyo18

Copy link
Copy Markdown
Owner

Summary

Closes the F1 (#35) Item 2 follow-up. The 2026-05-17 quality-review WS-delivery primer recommended SSE; on reflection the cost (~300-500 lines + reconnect/heartbeat complexity for a 1.5-3s UX lag improvement on one screen of a local 127.0.0.1 app) didn't justify the work.

  • Spec §11 now explicitly says polling is the permanent delivery mechanism (with decision rationale inline)
  • Architecture-overview line updated from "HTTP+WebSocket API" → "HTTP API"
  • Plan dep list updated to match
  • @hono/node-ws removed from engine runtime deps (preserved through M9 + N1 awaiting this decision; never imported)
  • EventBus stays — engine-internal coordination only

Test plan

  • Lint clean
  • Typecheck clean
  • Engine tests pass (311)
  • @hono/node-ws gone from lockfile

🤖 Generated with Claude Code

The 2026-05-17 quality review considered closing spec §11's WebSocket
promise by adding SSE browser delivery. Cost/benefit didn't justify
~300-500 lines of new code + reconnect/heartbeat complexity to shave
1.5-3s lag off one screen on a local 127.0.0.1 server.

Decision recorded in spec §11: polling stays as the permanent UX
delivery mechanism. The architecture summary's "HTTP+WebSocket API"
line is updated to "HTTP API". Plan dep list is updated to match.

Removes @hono/node-ws from engine runtime deps (was preserved through
M9 and N1 PRs awaiting this decision; never imported by any code).

EventBus stays — it's engine-internal coordination (scheduler ↔
throttle), not browser delivery.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@curtyo18
curtyo18 merged commit 20f7be7 into main May 17, 2026
2 checks passed
@curtyo18
curtyo18 deleted the chore/spec11-polling-permanent branch May 17, 2026 22:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant