sanapachandClaude Opus 5.5 38e49c4926 Add shared podcast contract to music-dht
Introduce music_dht::podcast, a pure module (no SQLite, HTTP or clock)
that every Furumi client uses for podcast identity and personal state:

- FeedUrl canonicalization that keeps the path and every query
  parameter byte-for-byte, PodcastId/EpisodeId derivation with
  domain-separated BLAKE3, feed aliases and the documented no-GUID
  episode identity rule;
- bounded PodcastMeta, EpisodeMeta and the self-contained
  PodcastEpisodeRef queue item;
- convergent merge rules for subscriptions (LWW, unsubscribe is state),
  share decisions (false is a tombstone), progress registers ordered by
  a Lamport generation, and listening sessions (G-set, one completion
  per session).

Tests cover every delivery permutation of small operation sets, late
checkpoints of old sessions, concurrent offline sessions and RSS
metadata updates that must not touch progress.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 15:39:50 +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%