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>
58 lines
3.6 KiB
Markdown
58 lines
3.6 KiB
Markdown
# 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.
|