Files
frid/CHANGELOG.md
T
Aleksandr Bogomiakov e47348b21d
CI / check (push) Successful in 2m22s
Publish crates / build (push) Successful in 3m24s
Publish crates / publish-crates-io (push) Successful in 21s
Publish crates / publish-gitea (push) Successful in 28s
Use a non-reserved Cargo secret name for Gitea publishing
2026-11-20 14:03:02 +00:00

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_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 PodcastCards and PodcastTombstones (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<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.