6.3 KiB
6.3 KiB
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_TOKENandGITEA_PACKAGES_TOKEN.
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 (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_sharesis fail-safe for revocation (per-podcastfailed) 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
maintenanceorrepublish) nor served to lookups until the firstsync_sharesof 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 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.
Podcast contract and storage
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.