Set version to v0.52.0

[Mark Hildebrand (hildebrandmw)]

DiskANN v0.52.0 Release Notes

Breaking Changes

An AI generated, human reviewed list of changes is summarized below.

get_degree_stats signature changed (#998)

DiskANNIndex::get_degree_stats now takes an explicit iterator of IDs instead of requiring the data provider to implement IntoIterator.

// Before — provider had to impl IntoIterator
index.get_degree_stats(&mut accessor)?;

// After — caller supplies the ID iterator
index.get_degree_stats(&mut accessor, id_iter)?;

PQ dimension contract tightened; entries now &[f32] only (#1044)

With AlignedBoxWithSlice removed from the PQ path, the dimension handling has been refactored into a three-layer contract:

Layer	Where	Contract
Boundary (inmem)	QueryComputer::new, MultiQueryComputer::new, DistanceComputer::evaluate_similarity	len == dim (returns Err on mismatch)
Boundary (disk)	PQScratch::set	len >= dim, slices to [..dim]
Internal	TableL2/IP/Cosine::{new, populate}	Trusted — no re-validation

Other changes:

• PQ table populate/distance methods now accept &[f32] instead of <U: Into<f32>>. Callers must pre-decode quantized vectors via VectorRepr::as_f32.
• Generic trampoline impls (&Vec<u8>, &&[u8]) on QueryComputer / DistanceComputer have been removed.

calculate_chunk_offsets relocated to ChunkOffsets constructors (#976)

The free functions calculate_chunk_offsets and calculate_chunk_offsets_auto have been moved into constructors on ChunkOffsets / ChunkOffsetsView in diskann-quantization::views.

// Before
let offsets = calculate_chunk_offsets(dim, num_chunks);

// After (allocating)
let offsets = ChunkOffsets::partition(dim, num_chunks)?;

// After (zero-alloc, borrows caller-owned scratch)
let view = ChunkOffsetsView::partition_into(dim, &mut scratch)?;

Additionally, get_chunk_from_training_data has been moved from public API.

CachingProvider removed (#1052)

The entire diskann_providers::model::graph::provider::async_::caching module has been deleted.

Why: The CachingProvider was an experiment in transparent caching over DataProvider. In practice it required double monomorphization of the indexing code, didn't save integration work for bulk methods like on_elements_unordered/distances_unordered, and was complex to maintain. An internal user who …migrated off it removed ~1,000 lines of code, improved compile times by ~20%, and substantially reduced complexity.

Upgrade: Manage caching directly in your DataProvider implementation.

New Features

AVX-512 4-bit distance kernels (#1045)

Native V4 (AVX-512) specializations for 4-bit packed vector distance computations:

• SquaredL2 — 16 × u32 lanes per iteration via _mm512_madd_epi16.
• InnerProduct — AVX-512 VNNI (_mm512_dpbusd_epi32) over u8x64 / i8x64 operands.

Previously, V4 hardware fell back to two AVX2 (V3) kernel invocations per 512-bit chunk. The native kernels double per-instruction throughput. No API changes — existing code benefits automatically on AVX-512 capable hardware.

Merged PRs

• Deprecate 32-bit targets by Suhas Jayaram Subramanya (@suhasjs) in Deprecate 32-bit targets #1022
• Add a fast path to Map::prepare. by Mark Hildebrand (@hildebrandmw) in Add a fast path to Map::prepare. #1023
• Add boundary checks in gen_associated_data_from_range() by Copilot in Add boundary checks in gen_associated_data_from_range() #847
• [deps] Don't pull rayon as a dependency of diskann. by Mark Hildebrand (@hildebrandmw) in [deps] Don't pull rayon as a dependency of diskann. #1024
• Bump openssl from 0.10.78 to 0.10.79 by Dependabot (@dependabot)[bot] in Bump openssl from 0.10.78 to 0.10.79 #1026
• Cleaning up test work and changing the get_degree_stats signature. by Jordan Maples (@JordanMaples) in Cleaning up test work and changing the get_degree_stats signature. #998
• Reduce scalar-quantization benchmark monomorphization by Suryansh Gupta (@suri-kumkaran) in Reduce scalar-quantization benchmark monomorphization #1041
• [diskann-vector] Support truly unaligned distances. by Mark Hildebrand (@hildebrandmw) in [diskann-vector] Support truly unaligned distances. #981
• rename spherical.json to graph index with spherical quantization by Harsha Simhadri (@harsha-simhadri) in rename spherical.json to graph index with spherical quantization #1042
• [PQ Cleanup] Part 2: Consolidate calculate_chunk_offsets* by Aditya Krishnan (@arkrishn94) in [PQ Cleanup] Part 2: Consolidate calculate_chunk_offsets*  #976
• PQ: tighten dim contract; right-size scratch buffer by Wei Wu (@wuw92) in PQ: tighten dim contract; right-size scratch buffer #1044
• Add v4 distance kernels (4-bit SquaredL2 / InnerProduct) by Mehmet YILMAZ (@m3hm3t) in Add v4 distance kernels (4-bit SquaredL2 / InnerProduct) #1045
• Remove the Caching Provider by Mark Hildebrand (@hildebrandmw) in Remove the Caching Provider #1052

New Contributors

• Suhas Jayaram Subramanya (@suhasjs) made their first contribution in Deprecate 32-bit targets #1022
• Mehmet YILMAZ (@m3hm3t) made their first contribution in Add v4 distance kernels (4-bit SquaredL2 / InnerProduct) #1045

Full Changelog: v0.51.0...v0.52.0

[Copilot]

Pull request overview

Updates the Rust workspace and in-repo crate versions for the DiskANN v0.52.0 release.

Changes:

• Bump [workspace.package] version to 0.52.0.
• Update workspace path dependency versions for the DiskANN crates to 0.52.0.
• Regenerate Cargo.lock to reflect the new workspace crate versions.

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated no comments.

File	Description
Cargo.toml	Bumps workspace/package version and updates workspace dependency versions to 0.52.0.
Cargo.lock	Updates lockfile entries for in-repo DiskANN crates to 0.52.0.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Codecov Comments Bot (codecov-commenter)]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.51%. Comparing base (c33ae16) to head (5b2a2f3).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1056   +/-   ##
=======================================
  Coverage   89.51%   89.51%           
=======================================
  Files         461      461           
  Lines       85920    85920           
=======================================
  Hits        76909    76909           
  Misses       9011     9011           

Flag	Coverage Δ
miri	89.51% <ø> (ø)
unittests	89.14% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.
see 4 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.