docs: condense implementation comments

2026-07-23 13:37:05 +02:00
parent 575e2907d0
commit 4f71b784fe
22 changed files with 102 additions and 507 deletions
--- a/docs/protocol.md
+++ b/docs/protocol.md
@@ -314,6 +314,13 @@ message TextMessage {
  it before closing the socket. `code = 0` is reserved for client-initiated graceful
  disconnect; server-sent fatal `Disconnect` uses `code ≥ 1` (1 = protocol error,
  2 = kicked).
+- **Client reconnection is local policy.** The core reports transport loss but does not reconnect.
+  The iOS client snapshots the server, channel, voice subscription, mute, and deafen state, then
+  reconnects with exponential backoff capped at 30 seconds. `NWPathMonitor` proactively replaces
+  a live session when the active interface changes or becomes unavailable, avoiding the TCP
+  keepalive delay; same-interface refreshes are ignored. A user-initiated disconnect cancels the
+  retry task and path monitor. After authentication, the client rejoins the prior channel before
+  restoring voice and local mute/deafen state.

 ## 8. Client-local features (no protocol changes)