huskies: merge 631_story_crdt_delta_sync_via_vector_clocks_replace_full_bulk_dumps

server/src/crdt_wire.rs

@@ -27,6 +27,15 @@
 ///   Binary fields (`signed_digest`, `depends_on`, `id`, …) use
 ///   `serde_with::Bytes` so they appear as base64 strings in JSON.
 ///
+/// # Sync protocol versions
+///
+/// The wire codec encodes individual `SignedOp`s for real-time streaming.
+/// The higher-level sync protocol (see [`crate::crdt_sync`]) uses text-frame
+/// JSON messages for negotiation:
+///
+/// - **v2**: `{"type":"clock","clock":{...}}` — vector clock exchange for delta sync.
+/// - **v1**: `{"type":"bulk","ops":[...]}` — full bulk dump (legacy, still supported).
+///
 /// # Upgrading the format
 ///
 /// Bump `WIRE_VERSION` and add a new arm to the `match envelope.v` block in