Skip to content

Expose quiz delivery health and opt-in diagnostics - #11

Open
irinanazarova wants to merge 4 commits into
mainfrom
add-quiz-delivery-diagnostics
Open

irinanazarova wants to merge 4 commits into
mainfrom
add-quiz-delivery-diagnostics

Conversation

@irinanazarova

@irinanazarova irinanazarova commented Oct 17, 2026 •

Copy link
Copy Markdown
Collaborator

The Deccan Queen incident was difficult to diagnose after the event because connection and delivery evidence was not retained. Expose opt-in operational events and presenter delivery health so applications can retain that evidence and presenters can see delayed or failed broadcasts.

The public observer excludes answer contents, raw errors, URLs and participant session IDs. Observer failures cannot interrupt quiz delivery; the engine does not upload telemetry itself. Reveal.js and Slidev display delivery details, with full status in Slidev presenter view and a compact control for single-window presenting.

Health distinguishes pending current state, retries, stale refreshes and HTTP acceptance. An older request cannot clear newer pending state, and restored active questions initialize health after reload. Failures identify the question actually sent, even when the slide changes during a request. Acceptance explicitly leaves phone receipt unconfirmed.

Self-review fixes establish the in-flight request guard before notifying public store subscribers or diagnostics observers, so a synchronous observer refreshing question definitions cannot start a parallel sync. Late-registration snapshots pass the same strict validation as live events. Both failures have regressions that failed before the fixes.

Validation: 167 unit tests; TypeScript check and build; four real AnyCable integration tests. An application checkout using the built candidate passed all 22 browser tests, including presenter warning/recovery without navigation, keyboard navigation after opening details, QR opt-in propagation, voting, retained operational events without answer contents, offline browser journals, minute keepalive and lost-response deduplication.

Versions remain unchanged. The addon guards the new public APIs until a diagnostics-capable engine release is installed.

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