Document podcast register ordering, versions and snapshot limits
CI / check (pull_request) Successful in 2m13s

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
sanapachandClaude Opus 5.5 committed 2026-11-19 16:10:33 +02:00
1 parent 085bff6191
commit 65d6ca2f14
5 files changed
+243 -94

No files matched your search

+12 -9
View File
@@ -199,15 +199,18 @@ the publisher: it is never imported, content-addressed or offered for P2P
transfer.
Device-sync protocol v4 carries podcast state between trusted devices only:
four `podcast_*` operations, bounded snapshot sections (the recovery path,
because sync vectors never re-request operations hidden from an older peer),
and an explicit `PlaybackTrack.source`. Operation and source enums are closed,
so senders gate on the version each peer reported itself; podcast state is
never sent to peers below v4, handoff to them is refused, and their playback
commands are ignored while the queue contains episodes. Jam snapshots replace
episodes with opaque placeholders. Progress ordering uses a Lamport
generation rather than wall-clock `hlc_ms`, so a device with a fast clock
cannot undo an observed seek or restart. Public podcast discovery is a future
five `podcast_*` operations, bounded snapshot sections (the recovery path,
because sync vectors never re-request operations hidden from an older peer;
past the bounds an upgraded peer recovers only the newest records), and an
explicit `PlaybackTrack.source`. The operation enum is closed and v3 clients
ignore `source`, so senders gate on the version each peer reported itself
(relayed profiles only raise it; pairing requests use the version in the
invite); podcast state is never sent to peers below v4, handoff to them is
refused, and their playback commands are ignored while the queue contains
episodes. Jam snapshots replace episodes with opaque placeholders. Progress,
subscription and share registers order by a Lamport generation before
wall-clock `hlc_ms`, so a device with a fast clock cannot undo an observed
seek, restart, unsubscribe or share decision. Public podcast discovery is a future
separate overlay; the music DHT schema and `federation-net` are unchanged.
Music discovery identifies an owner and content; it does not force all domain