sanapachandClaude Opus 5.5 e22c470ea7 Add SQLite podcast store with prototype import
New `furumi_library::podcasts::PodcastStore` in its own podcasts.sqlite3:

- user_version migrations in immediate transactions; version 1 is the
  prototype schema of the original podcast PR, version 2 renames its tables
  to legacy_* and imports feeds, episodes and fetch state with contract
  ids; unimportable rows go to legacy_quarantine; newer or foreign files
  are refused before anything is written;
- catalog (podcasts, feed aliases, seasons, episodes), subscription, share
  and progress registers, listening sessions and local-only fetch state;
- local actions that apply and return podcast sync operations, remote
  operation and snapshot application through the music-dht materializers
  and merge functions, bounded snapshot export;
- RSS refresh ingestion with stable episode ids and alias learning that
  never touches personal state, and queries for the UI.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 16:42:52 +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, including the shared podcast contract (PODCASTS.md).
  • 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
1.7 MiB
0 Stars 1 Watchers 0 Forks
Languages
Rust 100%