Files
frid/CHANGELOG.md
T
sanapachandClaude Opus 5.5 06ac3691d8 Key podcast queue items by source, not by a negative id range
The per-episode negative ids (TrackItem::podcast_track_id below
PODCAST_TRACK_ID_MAX) were a magic id range in shared code, which the
podcast requirements forbid. Podcast items now use the fixed sentinel
TrackItem::NOT_A_LIBRARY_ROW (-1) as id, release_id and artist id; it
carries no identity. Their identity is TrackItem.podcast alone.

Add TrackItem::key returning a typed TrackItemKey (library row, federated
owner and item id, podcast episode id, or transient), with the stable
string forms lib:<id>, fed:<owner>:<item_id>, ep:<episode id> and
tmp:<id>, so clients key queue items by source instead of by numeric id.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 18:04:37 +02:00

3.2 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>): clients must key queue items by it, not by id. 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. 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.