6.2 KiB
6.2 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 publishes every unpublished workspace crate version to
crates.io, in dependency order; already published versions are skipped on
retries. Authentication uses the
CARGO_REGISTRY_TOKENActions secret.
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.