CI / check (pull_request) Successful in 2m18s
Add TrackItem::from_playback_track and PlaybackItem: a received podcast episode becomes TrackItem::podcast_episode (sentinel ids) and a Jam private placeholder gets no TrackItem, so the wire ids (0 for both) are never copied. Narrow the TrackItem::key guidance: it is the source identity, episodes must never be keyed by id, and content-first music matching stays as it is. Document how TrackItem::podcast_episode differs from the wire form. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.6 KiB
3.6 KiB
Changelog
Unreleased — podcast contract
music-dht 0.6.0(breaking): newmusic_dht::podcastmodule with the shared podcast contract: canonicalFeedUrl,PodcastId/EpisodeIdderivation (furumi-podcast:*:v1), feed aliases, the no-GUID episode identity rule,PodcastMeta/EpisodeMeta/PodcastEpisodeRef, and convergent merge rules for subscriptions, shares, progress registers and listening sessions.music-dht 0.6.0: optionalpodcast-feedfeature with the shared tolerant RSS/Atom parser (quick-xml,encoding_rs,url).music-dht 0.6.0: device-sync protocol version 4 (ALPN unchanged): fivepodcast_*operation kinds (subscription, share, feed aliases, progress, listening sessions), bounded podcast snapshot sections,PlaybackTrack.source, reservedPlaybackStateWire.playback_rate,DeviceProfileSet.protocol_version, optionalInviteWireprotocol version (p), self-reported vs relayed version helpers, version-gating helpers and Jam redaction. New struct fields and enum variants break exhaustive construction and matching in clients.furumi-library 0.3.0: followsmusic-dht 0.6.0, whose types it re-exposes.furumi-library 0.3.0: newfurumi_library::podcasts::PodcastStore, the SQLite reference store of the podcast contract in its ownpodcasts.sqlite3:user_versionmigrations that import the prototype podcast database (tables kept aslegacy_*, unimportable rows inlegacy_quarantine) and refuse newer or foreign files unchanged; podcasts, feed aliases, seasons, episodes, subscription/share/progress registers, listening sessions and local-only fetch state; local actions that return thepodcast_*operations for the client's sync log;apply_remote_op, bounded snapshot export and merge; RSS refresh ingestion with stable episode ids; UI queries. Enables themusic-dhtpodcast-feedfeature.furumi-library 0.3.0(breaking):TrackItem.podcast: Option<PodcastEpisodeRef>andTrackItem::podcast_episode/is_podcast. ExhaustiveTrackItemliterals in clients need the new field; music-only code must skip podcast items. Podcast items use the fixed sentinelTrackItem::NOT_A_LIBRARY_ROW(-1) asid,release_idand artist id, so existingid < 0/release_id < 0checks already treat them as non-library items; the sentinel carries no identity. NewTrackItem::key/TrackItemKey(lib:<id>,fed:<owner>:<item_id>,ep:<episode id>), the source identity: episodes must be keyed by it (orTrackItem.podcast), never byid; content-first music matching stays as it is. NewTrackItem::from_playback_track/PlaybackItemconvert received playback items without copying wire ids (0 for episodes and Jam private placeholders). The library database is unchanged.furumi-library 0.3.0: prototype import collapses rows of one GUID-less item under several enclosure URLs, and the first refresh re-keys imported GUID-less episodes without personal state to the ids the current feed gives, so they match devices that never had the prototype; when another episode (for example one created by a remote operation) already holds that id, the imported copy is deleted instead of kept as a duplicate. Fetch-state writes are atomic across threads and processes.- See
PODCASTS.mdfor the normative contract.
v0.4.1 — 2026-09-02
federation-net 0.3.1: recover timed-out or failed Mainline-DHT rendezvous clients and expose network health to applications.music-dht 0.4.1: retain temporarily unreachable contacts and serialize duplicate dial attempts with bounded backoff.