Files
frid/CHANGELOG.md
T
sanapachandClaude Opus 5.5 d2530dca6c
CI / check (pull_request) Successful in 2m18s
Convert received playback items without copying wire ids
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>
2026-11-19 18:32:38 +02:00

3.6 KiB

Changelog

Unreleased — podcast contract

  • music-dht 0.6.0 (breaking): new music_dht::podcast module with the shared podcast contract: canonical FeedUrl, PodcastId/EpisodeId derivation (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: optional podcast-feed feature with the shared tolerant RSS/Atom parser (quick-xml, encoding_rs, url).
  • music-dht 0.6.0: device-sync protocol version 4 (ALPN unchanged): five podcast_* operation kinds (subscription, share, feed aliases, progress, listening sessions), bounded podcast snapshot sections, PlaybackTrack.source, reserved PlaybackStateWire.playback_rate, DeviceProfileSet.protocol_version, optional InviteWire protocol 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: follows music-dht 0.6.0, whose types it re-exposes.
  • furumi-library 0.3.0: new furumi_library::podcasts::PodcastStore, the SQLite reference store of the podcast contract in its own podcasts.sqlite3: user_version migrations that import the prototype podcast database (tables kept as legacy_*, unimportable rows in legacy_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 the podcast_* 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 the music-dht podcast-feed feature.
  • furumi-library 0.3.0 (breaking): TrackItem.podcast: Option<PodcastEpisodeRef> and TrackItem::podcast_episode/is_podcast. Exhaustive TrackItem literals in clients need the new field; music-only code must skip podcast items. Podcast items use the fixed sentinel TrackItem::NOT_A_LIBRARY_ROW (-1) as id, release_id and artist id, so existing id < 0 / release_id < 0 checks already treat them as non-library items; the sentinel carries no identity. New TrackItem::key / TrackItemKey (lib:<id>, fed:<owner>:<item_id>, ep:<episode id>), the source identity: episodes must be keyed by it (or TrackItem.podcast), never by id; content-first music matching stays as it is. New TrackItem::from_playback_track / PlaybackItem convert 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.md for 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.