Add PODCASTS.md as the normative podcast contract: identity and URL canonicalization, the no-GUID rule, synced versus local versus public data, operation kinds and merge rules with examples, snapshot recovery, version gating for peers below v4, Jam privacy and the reserved playback_rate. Update PLAYBACK_PROTOCOL.md, ARCHITECTURE.md, the crate READMEs and CHANGELOG.md. Bump music-dht to 0.6.0 and furumi-library to 0.3.0: new public enum variants and struct fields are breaking changes for 0.x, and furumi-library re-exposes music-dht types. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
# furumi-library
|
|
|
|
Client-independent persistence foundation for Furumi music players.
|
|
|
|
The crate owns the shared `library.db` contract: SQLite schema and migrations,
|
|
catalog models and queries, local import and metadata extraction, artwork
|
|
resolution, playlists, likes, listening history, and similarity index storage.
|
|
It contains no UI, playback engine, or application runtime.
|
|
|
|
During local development clients use a path dependency:
|
|
|
|
```toml
|
|
furumi-library = { path = "../frid/crates/furumi-library" }
|
|
```
|
|
|
|
Adjust the relative path to match the position of the client repository. After
|
|
publication, clients can depend on the released crate version instead.
|
|
|
|
`Library::open(default_db_path()?)` opens the same platform-native Furumi
|
|
library used by every client. Connections use WAL, foreign keys, and a busy
|
|
timeout so independently running clients can safely share the database.
|
|
|
|
Version 0.3 follows `music-dht` 0.6, whose device-sync and podcast contract
|
|
types it re-exposes. Podcast persistence is not part of this release; it will
|
|
implement the rules of the workspace `PODCASTS.md`.
|