# Changelog ## v0.6.0 — 2026-11-20 Releases `music-dht 0.6.0` and `furumi-library 0.3.0`. `federation-net` remains at `0.3.1`. - Tag-driven CI verifies release packages once, then publishes to crates.io and the Furumi Gitea Cargo mirror in parallel jobs without recompiling. Already published versions are skipped independently in each registry. Authentication uses `CARGO_REGISTRY_TOKEN` and `CARGO_REGISTRIES_GITEA_TOKEN`. ### Podcast discovery (`podcast_dht`) - `music-dht 0.6.0`: new `music_dht::podcast_dht` overlay for public podcast discovery on its own ALPN `furumi-fd/podcast-dht/1` (version 1) and its own SQLite cache (schema 2): signed `PodcastCard`s and `PodcastTombstone`s (`furumi-podcast-card:v1` / `furumi-podcast-card-tombstone:v1` canonical signing input), monotonic revisions with a total tie-break, text and id keys, `PodcastDht::{publish, unpublish, sync_shares, republish, search, lookup_podcast}` gated by `effective_share`, typed search hits (`PodcastSearchHit`, `ClaimedFeedUrl`, `FederatedSearchHit`, `SearchHitKind`, `merge_search_results`) and the advisory `feed_url_privacy_warning`. - Replicas accept records only from their publisher, store one payload per `(podcast_id, publisher)`, admit placements only for keys they are close to (counting verified contacts only) and within per-key, per-publisher and total budgets. A key never holds more than one response carries; full keys and caches admit newcomers by evicting random records from their younger half. Lookups give each response a bounded share of owners. Search offers only the URL the podcast id hashes from; moved-feed URLs are reported as unverified claims. - `sync_shares` is fail-safe for revocation (per-podcast `failed`) and holds back cards with privacy warnings until confirmed (`held_back`, `PodcastShareState::privacy_confirmed`). - Own cards persisted by an earlier run are neither republished (by `maintenance` or `republish`) nor served to lookups until the first `sync_shares` of the process, so a share revoked on another trusted device while this one was offline is not re-sent on startup. That first call also re-sends unchanged cards; tombstones are always re-sent. - `music-dht 0.6.0`: capability manifests can advertise `podcast_dht = 1` (`capabilities::PODCAST_DHT_ID`, `CapabilityManifest::with_podcast_dht`, `CapabilityManifest::protocol_version`, `CapabilityManifest::supports_podcast_dht`). It is opt-in: `CapabilityManifest::frid()` does not include it. - `music-dht 0.6.0`: new `MusicDhtError::PodcastPublication` variant (the enum is `#[non_exhaustive]`). - The music DHT (`music-dht-v5`), `federation-net` and device-sync protocol v4 are unchanged. See "Public discovery (podcast_dht)" in `PODCASTS.md`. ### Podcast contract and storage - `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` 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:`, `fed::`, `ep:`), 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.