5.4 KiB
5.4 KiB
Changelog
Unreleased — podcast discovery (podcast_dht)
music-dht 0.6.0: newmusic_dht::podcast_dhtoverlay for public podcast discovery on its own ALPNfurumi-fd/podcast-dht/1(version 1) and its own SQLite cache (schema 2): signedPodcastCards andPodcastTombstones (furumi-podcast-card:v1/furumi-podcast-card-tombstone:v1canonical signing input), monotonic revisions with a total tie-break, text and id keys,PodcastDht::{publish, unpublish, sync_shares, republish, search, lookup_podcast}gated byeffective_share, typed search hits (PodcastSearchHit,ClaimedFeedUrl,FederatedSearchHit,SearchHitKind,merge_search_results) and the advisoryfeed_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 and within per-key, per-publisher and total budgets, and never evict existing records for newcomers. Search offers only the URL the podcast id hashes from; moved-feed URLs are reported as unverified claims. sync_sharesis fail-safe for revocation (per-podcastfailed) and holds back cards with privacy warnings until confirmed (held_back,PodcastShareState::privacy_confirmed).music-dht 0.6.0: capability manifests can advertisepodcast_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: newMusicDhtError::PodcastPublicationvariant (the enum is#[non_exhaustive]).- The music DHT (
music-dht-v5),federation-netand device-sync protocol v4 are unchanged. See "Public discovery (podcast_dht)" inPODCASTS.md.
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.