# Changelog

All notable changes to Furumi are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added

- Optional offline music-similarity search for local tracks, backed by
  versioned SQLite embeddings and a replaceable exact in-memory cosine index.
- Automatic SHA-256-verified download and local inference for the first ONNX
  embedding model, with retained model/profile generations and background
  backfilling of existing library tracks.
- Similarity settings for enablement, model/profile information, numeric worker
  count, derived-data cleanup, processing progress, and federation privacy
  consent.
- Track-seeded similarity search from the track-information popup, including
  bounded federated queries to compatible known peers.
- The `furumi-fd/similarity/1` protocol in the visible protocol-version status.
- Decentralized `similarity_dht` routing with signed anonymous two-level LSH
  summaries, multi-probe lookup beyond the locally known peer set, and known-
  peer fallback during gradual network upgrades.

### Changed

- Similarity wire types, bounds, validation, and stream framing now come from
  the shared `music-dht 0.4.0` API so native, web, and future clients can
  interoperate without sharing an embedding implementation.
- Existing SQLite embeddings are backfilled once with compact 256-bit routing
  signatures; new embeddings store them immediately without changing exact
  local cosine search.
- A similarity result page keeps the source track first as query context while
  excluding it from the actual nearest-neighbor ranking, labels the mode as
  `Search similar to`, and suppresses near-identical embeddings across releases
  and federated peer responses.
- Preprocessing profiles now open a read-only details window describing their
  audio selection, resampling, spectrogram, patching, and aggregation contract.

### Fixed

- Current-track information (`Shift+I`) now uses the enriched queue entry, so
  it shows the same complete metadata and similarity action as `I` on that
  track in the queue.

## [0.2.5] - 2026-08-02

### Added

- Command history navigation with the Up and Down arrow keys.
- A copy-friendly plain terminal view for connection tickets, device and Jam
  invites, and track-sharing links.
- A configurable permanent music directory with write validation and an
  optional safe migration of existing Furumi-managed files.
- Queue reordering for one track or a `Shift+V` selection with `Alt+K` and
  `Alt+J`.
- Reproducible Nix/devenv tooling with Rust 1.97 and ALSA development files.

### Changed

- Sequential `a` actions now build one ordered play-next block instead of
  reversing independently inserted tracks.
- Federated artist images and release covers are stored beside permanent music
  in an `Artist/Release` directory tree.

### Fixed

- Running a development build next to another Furumi instance no longer lets
  an MPRIS name collision disable terminal raw mode and freeze keyboard input.
- `nix develop` now keeps devenv state outside the read-only Nix store and
  isolates Rust 1.97 build artifacts from other toolchains.
- Music-directory validation and migration now reject overlapping changes,
  resolve canonical paths, and produce Windows-portable managed filenames.

[Unreleased]: https://gt.hexor.cy/ab/furumi_tui/compare/v0.2.5...HEAD
[0.2.5]: https://gt.hexor.cy/ab/furumi_tui/compare/v0.2.4...v0.2.5