Bump DEVICE_SYNC_PROTOCOL_VERSION to 4 (ALPN unchanged) and carry the
podcast contract between trusted devices:
- podcast_subscription_set, podcast_share_set, podcast_progress_set and
podcast_listen_recorded operations with record materializers and
validation; unsubscribe is LWW state, share=false is a tombstone;
- bounded podcast sections in SyncSnapshot, the recovery path for peers
that upgrade after operations were hidden from them;
- PlaybackTrack.source with PlaybackSource::{Music, PodcastEpisode,
Private}, reserved PlaybackStateWire.playback_rate and an optional
self-reported protocol_version in DeviceProfileSet;
- gating helpers for peers below v4 (op_allowed_for_peer,
playback_allowed_for_peer, playback_command_allowed_from_peer,
SyncSnapshot::for_peer) and Jam privacy (redact_for_jam,
redact_jam_snapshot, jam_command_allowed, restore_jam_private_items).
Tests show that a v3-shaped enum rejects a whole batch containing a new
kind, which is why gating is mandatory, and that legacy JSON still
parses and music-only messages keep their v3 shape.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Port the tolerant RSS 2.0 / RSS 1.0 / Atom parser of the original
furumi-tui podcast work into music_dht::podcast::feed behind the
optional podcast-feed feature (quick-xml, encoding_rs, url). Episode
identity depends on what the parser extracts, so it must be shared by
all clients.
The port keeps its robustness (BOM and declared encodings, entities,
mismatched tags, depth and size limits, lenient dates, http(s)-only
media) and adds itunes:season, itunes:episode, itunes:episodeType,
guid isPermaLink and itunes:new-feed-url. Missing GUIDs stay absent
instead of falling back to the enclosure URL, and parsed items produce
identity hints and contract metadata.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Introduce music_dht::podcast, a pure module (no SQLite, HTTP or clock)
that every Furumi client uses for podcast identity and personal state:
- FeedUrl canonicalization that keeps the path and every query
parameter byte-for-byte, PodcastId/EpisodeId derivation with
domain-separated BLAKE3, feed aliases and the documented no-GUID
episode identity rule;
- bounded PodcastMeta, EpisodeMeta and the self-contained
PodcastEpisodeRef queue item;
- convergent merge rules for subscriptions (LWW, unsubscribe is state),
share decisions (false is a tombstone), progress registers ordered by
a Lamport generation, and listening sessions (G-set, one completion
per session).
Tests cover every delivery permutation of small operation sets, late
checkpoints of old sessions, concurrent offline sessions and RSS
metadata updates that must not touch progress.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>