Files
KoalaSync/docs
KoalaDev 69f8f4cfd7 fix(extension): trust HOST_BLOCKED as authoritative (join race, EC-5)
hcmHandleBlocked no longer re-checks local control mode before acting. Background
only sends HOST_BLOCKED to a gated guest, so the message itself is authoritative —
adopt host-only/guest role from it. Fixes the join race where a HOST_BLOCKED
arriving before the CONTROL_MODE broadcast was silently ignored.

Also corrects the EC-4 note: "let catch-up re-sync" is invalid (sync is
event-driven, no continuous catch-up); the right fix is a buffer-aware deferred
snap-back.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-26 10:01:04 +02:00
..

Technical Documentation

This directory contains deep-dives into the KoalaSync protocol and architecture.

  • HOW_IT_WORKS.md: Step-by-step walkthrough of every user flow, from room creation to synchronized playback. Ideal for store reviewers and manual testers.
  • ARCHITECTURE.md: Communication flows, Dual Heartbeat, and Sync logic.
  • SYNC_GUIDE.md: Protocol constants and sync requirements.
  • TRANSLATION.md: Translation and localization guide for the extension and website.