All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.2.1 - 2026-11-21
Changed
- Upgraded
ruvector-corefrom2.3.0to2.5.2(bringingFlatGraph-based HNSW,Weak-backed storage pool lifecycle, and upstream recall fixes) and refreshed compatible Cargo dependencies (redb 2.6.4,hnsw_rs 0.3.5,serde_json 1.0.154,uuid 1.29.3). - Upgraded the Rust
rustlerNIF crate from0.38.0to0.39.0(retaining Rust1.91MSRV and Mixrustler ~> 0.38.0). - Added
QuantizationConfig::Turbo4encoding ininfo/1and updated thedb_info :quantizationtypespec and docs.
0.2.0 - 2026-11-21
Breaking Changes
- Upgraded Rustler dependency to
~> 0.38.0(runtime: false), raised the minimum Elixir version to~> 1.18(CI-tested through Elixir1.20.5/ Erlang/OTP29.1.2), and set the Rust MSRV to1.91. - Moved low-level NIF stubs to the internal NIF bridge module (RuvectorElixir.Native) and removed legacy top-level aliases (
open_db/2,3,get_entry/2,db_len/1,is_empty/1,all_ids/1,calculate_distance/3). - Standardized public API return shapes:
search/3,4returns{:ok, ids}instead of detailed result maps (usesearch_detailed/3,4for scores, vectors, and metadata).empty?/1returns a bareboolean()(raisingRuvectorElixir.Erroron closed or errored handles).info/1returns{:ok, map}with atom keys (:dimensions,:node_count,:distance_metric,:storage_path,:hnsw,:quantization).search_detailed/3,4now takes a trailingoptskeyword list or map supporting:filterand:ef_search.
- Added
RuvectorElixir.Error: bang (!) variants raiseRuvectorElixir.Erroron operational or NIF failures andArgumentErroron invalid caller inputs or options. - Hardened boundary validation across Elixir and Rust: rejects unknown or duplicate options, invalid filters, structs/tuples/PIDs/non-UTF-8 binaries in metadata,
nil/boolean/empty IDs, improper lists, and non-finite orf32-overflowing vectors rather than silently falling back.
Added
- Isolated in-memory databases via
"memory://<name>"URIs (InMemoryDB) that do not touch the filesystem. - Explicit handle lifecycle functions:
close/1,close!/1,with_open/3,4, andwith_open!/3,4, with idempotent close and{:error, :closed}on subsequent calls. - Per-query
:ef_searchtuning option forsearch/4,search!/4,search_detailed/4, andsearch_detailed!/4. usage-rules.mdguidance for AI agents and Hex consumers, amix precommitverification alias, and a GitHub Actions CI matrix across Elixir1.18/OTP27,1.19/OTP28, and1.20.5/OTP29.1.2.
Changed
- Migrated
DbResourceto#[rustler::resource_impl], removed unusedruvector-graph, and routed all database I/O (DirtyIo) and search / large-vector distance (DirtyCpu) calls onto Erlang dirty schedulers. - Encoded BEAM maps directly via
Term::map_from_term_arrays/rustler::term_map!and canonicalizedVectorEntry.new/2metadata atom keys to UTF-8 strings soget_struct!/2round-trips cleanly. - Updated Dialyzer typespecs across
RuvectorElixir,RuvectorElixir.VectorEntry, and the internalNativeNIF module.
Fixed
- Bounded HNSW parameters (
m: 2..256,ef_construction/ef_search:1..1_000_000,max_elements:1..10_000_000), clamped searchkto live entry count, and enforced platformusizebounds to prevent OOM aborts or decode mismatches. - Guarded metric-specific
f32vector norms and L1 bounds on insert and search so large finite vectors cannot overflow distances toInf/NaNand poison subsequent queries. - Fixed persistent HNSW upsert stale-score ghost results by deleting pre-existing IDs before re-insert under a serialization lock; fixed
InMemoryDBatomic locking, batch deduplication, anddelete/insert_batchindex-before-entries ordering. - Improved filtered and HNSW search recall via iterative over-fetching, Elixir-consistent
1 == 1.0numeric matching, exacti64/u64equality, iterativejson_values_equalwith uniform127-container JSON depth caps, and proper-list decoding without RustlerListIteratorpanics. - Released the
RwLockwrite guard before dropping database state duringclose/1teardown so concurrent callers immediately receive{:error, :closed}.
0.1.0 - 2026-09-16
Added
- Initial Elixir NIF bindings for
ruvector-corewith flat and HNSW indexing, persistence (.rvf), metadata filtering, direct distance calculations, andRuvectorElixir.VectorEntry.