sanapachandClaude Opus 5.5 2d4782819d Add podcasts to device-sync protocol v4
Bump DEVICE_SYNC_PROTOCOL_VERSION to 4 (ALPN unchanged) and carry the
podcast contract between trusted devices:

- podcast_subscription_set, podcast_share_set, podcast_progress_set and
  podcast_listen_recorded operations with record materializers and
  validation; unsubscribe is LWW state, share=false is a tombstone;
- bounded podcast sections in SyncSnapshot, the recovery path for peers
  that upgrade after operations were hidden from them;
- PlaybackTrack.source with PlaybackSource::{Music, PodcastEpisode,
  Private}, reserved PlaybackStateWire.playback_rate and an optional
  self-reported protocol_version in DeviceProfileSet;
- gating helpers for peers below v4 (op_allowed_for_peer,
  playback_allowed_for_peer, playback_command_allowed_from_peer,
  SyncSnapshot::for_peer) and Jam privacy (redact_for_jam,
  redact_jam_snapshot, jam_command_allowed, restore_jam_private_items).

Tests show that a v3-shaped enum rejects a whole batch containing a new
kind, which is why gating is mandatory, and that legacy JSON still
parses and music-only messages keep their v3 shape.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 15:40:43 +02:00
2026-07-26 03:51:15 +03:00
2026-07-10 12:45:47 +03:00
2026-07-26 03:48:30 +03:00

frid

Frid is the shared infrastructure core behind Furumi. It provides reusable Rust libraries for local music persistence and equal-peer networking without an application server, central peer registry, or privileged node.

The workspace has three layers:

  • federation-net establishes authenticated, NAT-traversing P2P connections over iroh, isolates independent networks and message schemas, and optionally discovers peers through the BitTorrent Mainline DHT.
  • music-dht builds a Kademlia-style distributed music directory on top of that transport, including catalog discovery, content-id lookup, signed similarity-LSH routing, direct byte streams, and shared Furumi wire types.
  • furumi-library owns the shared local library.db contract, migrations, catalog operations, metadata import, artwork, playlists, likes, history, and similarity persistence used by Furumi clients.

Each participant is a client, router, and storage peer. Automatic rendezvous has no Frid-operated bootstrap service, while self-contained peer tickets remain available for explicit or isolated connections.

Design principles

  • Equal peers. No node receives a permanent coordinator or server role.
  • Application-owned protocols. The transport moves typed messages and byte streams without owning domain state.
  • Bounded inputs. Frames, tickets, routing tables, requests, and record batches have explicit limits.
  • Offline-tolerant discovery. Records are replicated, refreshed by their owners, expired by TTL, and removed through revisioned tombstones.
  • Protocol isolation. Network IDs, schema IDs, versions, and ALPNs prevent unrelated or incompatible applications from being merged accidentally.
  • Local persistence. Identity, routing knowledge, owned records, and replicas survive restarts in application-controlled storage.

See ARCHITECTURE.md for the protocol layers, trust model, failure handling, and compatibility rules.

Workspace

crates/
  federation-net/       generic iroh transport and rendezvous
  music-dht/            distributed music catalog and content discovery
  furumi-library/       client-independent local music database and import

Using the libraries

Until crates are published to a registry, depend on the repository directly:

[dependencies]
federation-net = { git = "https://gt.hexor.cy/ab/frid.git" }
music-dht = { git = "https://gt.hexor.cy/ab/frid.git" }
furumi-library = { git = "https://gt.hexor.cy/ab/frid.git" }

Start with the crate documentation:

Development

Frid uses Rust edition 2024 and requires Rust 1.97 or newer.

cargo fmt --all -- --check
cargo check --workspace --all-targets --all-features
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace

The integration tests open real local sockets and establish iroh connections. Some rendezvous tests also use public discovery infrastructure, so a restricted sandbox may need explicit network permission.

License

Frid is released under the Do What The Fuck You Want To Public License, Version 2.

S
Description
Frid is the shared infrastructure core behind Furumi
Readme WTFPL
804 KiB
0 Stars 2 Watchers 1 Forks
Languages
Rust 99.4%
Python 0.6%