Merge branch 'main' into pca-c-api

Author: aamijar

.coderabbit.yaml

@@ -0,0 +1,77 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+reviews:
+  profile: chill
+  high_level_summary: true
+  high_level_summary_in_walkthrough: true
+  poem: false
+  auto_review:
+    enabled: true
+    drafts: false
+    base_branches:
+      - "^main$"
+      - "^release/.*"
+      - "^hotfix/.*"
+    ignore_usernames: ["rapids-bot", "GPUtester", "nv-automation-bot", "copy-pr-bot"]
+  tools:
+    markdownlint:
+      enabled: true
+    shellcheck:
+      enabled: true
+    gitleaks:
+      enabled: true
+  sequence_diagrams: false
+  collapse_walkthrough: true
+
+  # Reduce noise from status messages
+  request_changes_workflow: false
+  review_status: false
+
+  # Path-specific review instructions
+  # Note: Detailed C++/CUDA and Python review guidelines are in cpp/REVIEW_GUIDELINES.md and python/REVIEW_GUIDELINES.md
+  path_instructions:
+    - path: "docs/**/*"
+      instructions: |
+        For documentation changes, focus on:
+        - Accuracy: Verify code examples compile and run correctly
+        - Completeness: Check if API changes (parameters, return values, errors) are documented
+        - Clarity: Flag confusing explanations, missing prerequisites, or unclear examples
+        - Consistency: Version numbers, parameter types, and terminology match code
+        - Missing docs: If PR changes public APIs without updating docs, flag as HIGH priority
+
+    - path: "c/include/cuvs/**/*"
+      instructions: |
+        For public C API headers, additionally check:
+        - Doxygen documentation for all public functions/classes
+        - API changes flagged for docs/ updates
+        - Breaking changes require deprecation warnings and migration guide updates
+
+    - path: "cpp/include/cuvs/**/*"
+      instructions: |
+        For public C++ API headers, additionally check:
+        - Doxygen documentation for all public functions/classes
+        - API changes flagged for docs/ updates
+        - Breaking changes require deprecation warnings and migration guide updates
+
+    - path: "notebooks/**/*"
+      instructions: |
+        For example notebooks:
+        - Verify code examples match current API (parameter names, return types)
+        - Flag outdated imports or deprecated API usage
+
+    - path: "ci/**/*"
+      instructions: |
+        For CI/build scripts:
+        - Check for proper conda environment handling
+        - Verify GPU availability checks before tests
+        - Check for proper error handling and meaningful error messages
+
+knowledge_base:
+  opt_out: false
+  code_guidelines:
+    filePatterns:
+      - "cpp/REVIEW_GUIDELINES.md"
+      - "python/REVIEW_GUIDELINES.md"
+      - "docs/source/contributing.md"
+      - "docs/source/developer_guide.md"

.github/CODEOWNERS

@@ -31,6 +31,7 @@ cpp/scripts/run-cmake-format.sh @rapidsai/cuvs-cmake-codeowners
 /.github/                @rapidsai/ci-codeowners
 /ci/                     @rapidsai/ci-codeowners
 /.shellcheckrc           @rapidsai/ci-codeowners
+/.coderabbit.yaml        @rapidsai/ci-codeowners
 
 #packaging code owners
 /.pre-commit-config.yaml @rapidsai/packaging-codeowners

.github/workflows/pr.yaml

@@ -68,6 +68,8 @@ jobs:
       files_yaml: |
         build_docs:
           - '**'
+          - '!**/*/REVIEW_GUIDELINES.md'
+          - '!.coderabbit.yaml'
           - '!.devcontainer/**'
           - '!.github/CODEOWNERS'
           - '!.github/ISSUE_TEMPLATE/**'
@@ -90,6 +92,8 @@ jobs:
           - '!thirdparty/LICENSES/**'
         test_cpp:
           - '**'
+          - '!**/*/REVIEW_GUIDELINES.md'
+          - '!.coderabbit.yaml'
           - '!.devcontainer/**'
           - '!.github/CODEOWNERS'
           - '!.github/ISSUE_TEMPLATE/**'
@@ -124,6 +128,8 @@ jobs:
           - '!thirdparty/LICENSES/**'
         test_java:
           - '**'
+          - '!**/*/REVIEW_GUIDELINES.md'
+          - '!.coderabbit.yaml'
           - '!.devcontainer/**'
           - '!.github/CODEOWNERS'
           - '!.github/ISSUE_TEMPLATE/**'
@@ -157,6 +163,8 @@ jobs:
           - '!thirdparty/LICENSES/**'
         test_python_conda:
           - '**'
+          - '!**/*/REVIEW_GUIDELINES.md'
+          - '!.coderabbit.yaml'
           - '!.devcontainer/**'
           - '!.github/CODEOWNERS'
           - '!.github/ISSUE_TEMPLATE/**'
@@ -194,6 +202,8 @@ jobs:
           - '!thirdparty/LICENSES/**'
         test_python_wheels:
           - '**'
+          - '!**/*/REVIEW_GUIDELINES.md'
+          - '!.coderabbit.yaml'
           - '!.devcontainer/**'
           - '!.github/CODEOWNERS'
           - '!.github/ISSUE_TEMPLATE/**'
@@ -236,6 +246,8 @@ jobs:
           - '!thirdparty/LICENSES/**'
         test_rust:
           - '**'
+          - '!**/*/REVIEW_GUIDELINES.md'
+          - '!.coderabbit.yaml'
           - '!.devcontainer/**'
           - '!.github/CODEOWNERS'
           - '!.github/ISSUE_TEMPLATE/**'
@@ -273,6 +285,8 @@ jobs:
           - '!thirdparty/LICENSES/**'
         test_go:
           - '**'
+          - '!**/*/REVIEW_GUIDELINES.md'
+          - '!.coderabbit.yaml'
           - '!.devcontainer/**'
           - '!.github/CODEOWNERS'
           - '!.github/ISSUE_TEMPLATE/**'

.pre-commit-config.yaml

@@ -43,7 +43,7 @@ repos:
                 additional_dependencies: [toml]
                 args: ["--config=pyproject.toml"]
       - repo: https://github.com/pre-commit/mirrors-clang-format
-        rev: v20.1.4
+        rev: v20.1.8
         hooks:
               - id: clang-format
                 types_or: [c, c++, cuda]
@@ -96,10 +96,14 @@ repos:
                 name: clang-format-with-cmake-placeholders
                 entry: python3 ci/checks/clang_format_with_cmake_placeholders.py
                 language: python
-                additional_dependencies: [clang_format==20.1.4]
+                additional_dependencies: [clang_format==20.1.8]
                 files: |
                   (?x)
                     [.](cpp|cu|hpp|cuh)[.]in$
+                # clang-format struggles with one of the placeholders in register_fatbin.cpp.in, so exclude it
+                exclude: |
+                  (?x)
+                    ^cpp/cmake/modules/register_fatbin[.]cpp[.]in$
       - repo: https://github.com/codespell-project/codespell
         rev: v2.4.1
         hooks:

CHANGELOG.md

@@ -1,3 +1,109 @@
+# cuvs 26.04.00 (8 Apr 2026)
+
+### 🚨 Breaking Changes
+* Use HNSW GPU Hierarchy by Default by @julianmi in https://github.com/rapidsai/cuvs/pull/1617
+* Backport "Default to static linking of libcudart" by @KyleFromNVIDIA in https://github.com/rapidsai/cuvs/pull/1918
+* enforce a floor on libnvjitlink, build wheels with CUDA 13.0.x, test wheels against mix of CTK versions by @jameslamb in https://github.com/rapidsai/cuvs/pull/1862
+### 🐛 Bug Fixes
+* Add float16 support for CAGRA extend by @lowener in https://github.com/rapidsai/cuvs/pull/1620
+* Fix C examples CUDAToolkit dependency by @tfeher in https://github.com/rapidsai/cuvs/pull/1626
+* clang-tidy: remove AnalyzeTemporaryDtors key by @achirkin in https://github.com/rapidsai/cuvs/pull/1778
+* Fix build.sh: build cuvs_c for examples and fix --gpu-arch parsing by @achirkin in https://github.com/rapidsai/cuvs/pull/1779
+* Better handling of batching of search in MG replicated mode by @viclafargue in https://github.com/rapidsai/cuvs/pull/1718
+* Add nvjitlink to cuda-toolkit pip extras for cusparse compatibility by @bdice in https://github.com/rapidsai/cuvs/pull/1794
+* [REVIEW] Fix: for balanced kmeans use grid.x for adjust_centers to avoid grid.y overflow for >262K centroids by @Nischal1729 in https://github.com/rapidsai/cuvs/pull/1805
+* Fix thrust header by @aamijar in https://github.com/rapidsai/cuvs/pull/1817
+* Fix persistent CAGRA regressions by @achirkin in https://github.com/rapidsai/cuvs/pull/1800
+* Fix thrust header by @aamijar in https://github.com/rapidsai/cuvs/pull/1825
+* Set `cudaFuncAttributeMaxDynamicSharedMemorySize` with thread-safety by @mythrocks in https://github.com/rapidsai/cuvs/pull/1771
+* [REVIEW] Move from `thrust::make_counting_iterator` to `cuda::make_counting_iterator` by @mythrocks in https://github.com/rapidsai/cuvs/pull/1826
+* Fixed cuvs benchmark debug build issue (linker step fail) by @irina-resh-nvda in https://github.com/rapidsai/cuvs/pull/1599
+* Graph degree equals intermediate graph degree bug fix by @irina-resh-nvda in https://github.com/rapidsai/cuvs/pull/1834
+* FAISS patch for `thrust_counting_iterator.h` by @aamijar in https://github.com/rapidsai/cuvs/pull/1844
+* Use 1D grid calculations in `epsilon_neighborhood` by @divyegala in https://github.com/rapidsai/cuvs/pull/1847
+* Fix setting CAGRA graph build algo to iterative search by default by @achirkin in https://github.com/rapidsai/cuvs/pull/1864
+* Faiss suppress warning 611 by @aamijar in https://github.com/rapidsai/cuvs/pull/1879
+* Pin faiss to 1.14.0 by @aamijar in https://github.com/rapidsai/cuvs/pull/1885
+* Make some minor fixes to JIT+LTO functionality by @KyleFromNVIDIA in https://github.com/rapidsai/cuvs/pull/1896
+* Revert "Default to static linking of libcudart" by @KyleFromNVIDIA in https://github.com/rapidsai/cuvs/pull/1925
+* Fix hanging pytests by @aamijar in https://github.com/rapidsai/cuvs/pull/1924
+* Disallow programmatic stream serialization in JIT kernel launches by @divyegala in https://github.com/rapidsai/cuvs/pull/1932
+* IVF-Flat: fix irrelevant assert in the fused kernel mode by @achirkin in https://github.com/rapidsai/cuvs/pull/1941
+* [REVIEW] cuVS bench: Fix cudaFuncSetAttribute not being called when CAGRA search switches kernel variants by @irina-resh-nvda in https://github.com/rapidsai/cuvs/pull/1851
+* Pin openblas for aarch64 by @tarang-jain in https://github.com/rapidsai/cuvs/pull/1965
+* Null JIT kernel launch config by @divyegala in https://github.com/rapidsai/cuvs/pull/1974
+* [BUG] Fix Vamana Serialization by @tarang-jain in https://github.com/rapidsai/cuvs/pull/1966
+### 📖 Documentation
+* remove docs references to cuvs-bench-datasets, install a C compiler in pre-commit env by @jameslamb in https://github.com/rapidsai/cuvs/pull/1736
+* Adding simple tarball install to build and install docs by @cjnolet in https://github.com/rapidsai/cuvs/pull/1868
+* Fixing nccl link in tarball install instructions by @cjnolet in https://github.com/rapidsai/cuvs/pull/1887
+* Add developer and user guides for JIT by @divyegala in https://github.com/rapidsai/cuvs/pull/1876
+* PCA docs by @aamijar in https://github.com/rapidsai/cuvs/pull/1949
+* Fix a few typos and ``.rst`` link syntax by @jrbourbeau in https://github.com/rapidsai/cuvs/pull/1973
+* Update docs footer year by @aamijar in https://github.com/rapidsai/cuvs/pull/1958
+* Doc improvements by @aamijar in https://github.com/rapidsai/cuvs/pull/1978
+### 🚀 New Features
+* JIT compile `interleaved_scan_kernel` for CUDA 13 by @divyegala in https://github.com/rapidsai/cuvs/pull/1405
+* [REVIEW] L1 distance support for iterative search CAGRA build by @yan-zaretskiy in https://github.com/rapidsai/cuvs/pull/1831
+* [FEA] Inertia Computation for Balanced KMeans and Add Option for Weighted Inertia by @tarang-jain in https://github.com/rapidsai/cuvs/pull/1880
+* PCA preprocessor by @aamijar in https://github.com/rapidsai/cuvs/pull/1808
+* [FEA] Add Batching to KMeans by @tarang-jain in https://github.com/rapidsai/cuvs/pull/1886
+### 🛠️ Improvements
+* Automatic Partition Count Derivation for ACE  by @julianmi in https://github.com/rapidsai/cuvs/pull/1603
+* Add filter for cagra::merge by @benfred in https://github.com/rapidsai/cuvs/pull/1496
+* Ivf_flat extends golang APIs by @cpegeric in https://github.com/rapidsai/cuvs/pull/1600
+* Drop Python 3.10 support by @gforsyth in https://github.com/rapidsai/cuvs/pull/1748
+* tighten wheel size limits, expand CI-skipping logic, other small build changes by @jameslamb in https://github.com/rapidsai/cuvs/pull/1751
+* Migrate hash strategy to use the new cuco::static_map by @PointKernel in https://github.com/rapidsai/cuvs/pull/1462
+* Update raft headers by @aamijar in https://github.com/rapidsai/cuvs/pull/1763
+* remove pip.conf migration code in CI scripts, update CI-skipping rules by @jameslamb in https://github.com/rapidsai/cuvs/pull/1760
+* Convert non-type template parameters to runtime parameters in CAGRA search to cut binary size by @seunghwak in https://github.com/rapidsai/cuvs/pull/1498
+* Rename lanczos by @aamijar in https://github.com/rapidsai/cuvs/pull/1759
+* CI: build with CUDA 13.1.1 by @jameslamb in https://github.com/rapidsai/cuvs/pull/1766
+* Fixes for stricter compilers by @maxwbuckley in https://github.com/rapidsai/cuvs/pull/1703
+* fix cpu_search call by including `k` argument by @benfred in https://github.com/rapidsai/cuvs/pull/1785
+* Use GHA id-token for `sccache-dist` auth token by @trxcllnt in https://github.com/rapidsai/cuvs/pull/1790
+* Remove `cagra_optimize.hpp` by @aamijar in https://github.com/rapidsai/cuvs/pull/1791
+* Remove unused use_norms constant from kernel_sm60.cuh by @maxwbuckley in https://github.com/rapidsai/cuvs/pull/1705
+* Remove unused variable read_idx from query loop by @maxwbuckley in https://github.com/rapidsai/cuvs/pull/1706
+* remove gitutils by @jameslamb in https://github.com/rapidsai/cuvs/pull/1797
+* refactor: build wheels and conda packages using Python limited API by @gforsyth in https://github.com/rapidsai/cuvs/pull/1788
+* Add pluggable backend architecture to cuvs-bench by @jnke2016 in https://github.com/rapidsai/cuvs/pull/1536
+* Use Specific CCCL Includes by @divyegala in https://github.com/rapidsai/cuvs/pull/1806
+* Replace `thrust::tuple` with `cuda::std::tuple` by @miscco in https://github.com/rapidsai/cuvs/pull/1811
+* check-nightly-ci: update to new version by @jameslamb in https://github.com/rapidsai/cuvs/pull/1813
+* check-nightly-ci: remove testing config by @jameslamb in https://github.com/rapidsai/cuvs/pull/1824
+* Refactor JIT LTO kernel generation by @KyleFromNVIDIA in https://github.com/rapidsai/cuvs/pull/1812
+* Move `test_compute_matrix_product.py` to `cpp/tests` by @KyleFromNVIDIA in https://github.com/rapidsai/cuvs/pull/1836
+* Drop uses of `thrust/functional.h` by @miscco in https://github.com/rapidsai/cuvs/pull/1835
+* Better `ncv` param spectral embedding edge case by @aamijar in https://github.com/rapidsai/cuvs/pull/1828
+* Modernize the uses of raft in cuVS by @achirkin in https://github.com/rapidsai/cuvs/pull/1837
+* refactor(limited api): add explicit `wheel.py-api` to `pyproject.toml`
+ by @gforsyth in https://github.com/rapidsai/cuvs/pull/1852
+* Update Cython lower bound pin to 3.2.2 by @vyasr in https://github.com/rapidsai/cuvs/pull/1858
+* Add support for Python 3.14 by @gforsyth in https://github.com/rapidsai/cuvs/pull/1845
+* fix(rust): change Index::search to take &self instead of self by @zbennett10 in https://github.com/rapidsai/cuvs/pull/1839
+* Remove pytest upper bound pin by @vyasr in https://github.com/rapidsai/cuvs/pull/1867
+* Readme: vecflow paper in references by @aamijar in https://github.com/rapidsai/cuvs/pull/1874
+* Refactor knn graph build params to remove `graph_build_types.hpp` by @jinsolp in https://github.com/rapidsai/cuvs/pull/1235
+* Remove IndexWrapper by @aamijar in https://github.com/rapidsai/cuvs/pull/1792
+* Use C linkage for JIT LTO kernels by @divyegala in https://github.com/rapidsai/cuvs/pull/1909
+* Prevent nested parallelism in HNSW bench by @julianmi in https://github.com/rapidsai/cuvs/pull/1895
+* Add a script to check for breaking C ABI changes by @benfred in https://github.com/rapidsai/cuvs/pull/1749
+* Improve the IVF-PQ Coarse Batch Size Workspace Estimation by @julianmi in https://github.com/rapidsai/cuvs/pull/1937
+* ScaNN: Fix AVQ prefetch by @rmaschal in https://github.com/rapidsai/cuvs/pull/1899
+
+## New Contributors
+* @cpegeric made their first contribution in https://github.com/rapidsai/cuvs/pull/1600
+* @PointKernel made their first contribution in https://github.com/rapidsai/cuvs/pull/1462
+* @seunghwak made their first contribution in https://github.com/rapidsai/cuvs/pull/1498
+* @Nischal1729 made their first contribution in https://github.com/rapidsai/cuvs/pull/1805
+* @jnke2016 made their first contribution in https://github.com/rapidsai/cuvs/pull/1536
+* @zbennett10 made their first contribution in https://github.com/rapidsai/cuvs/pull/1839
+* @jrbourbeau made their first contribution in https://github.com/rapidsai/cuvs/pull/1973
+
+**Full Changelog**: https://github.com/rapidsai/cuvs/compare/v26.04.00a...release/26.04
+
 # cuvs 26.02.00 (4 Feb 2026)
 
 ### 🚨 Breaking Changes

ci/validate_wheel.sh

@@ -21,11 +21,11 @@ PYDISTCHECK_ARGS=(
 if [[ "${package_dir}" == "python/libcuvs" ]]; then
     if [[ "${RAPIDS_CUDA_MAJOR}" == "12" ]]; then
         PYDISTCHECK_ARGS+=(
-            --max-allowed-size-compressed '800Mi'
+            --max-allowed-size-compressed '400Mi'
         )
     else
         PYDISTCHECK_ARGS+=(
-            --max-allowed-size-compressed '450Mi'
+            --max-allowed-size-compressed '250Mi'
         )
     fi
 elif [[ "${package_dir}" != "python/cuvs" ]]; then

conda/environments/all_cuda-129_arch-aarch64.yaml

@@ -8,8 +8,8 @@ dependencies:
 - _go_select *=cgo
 - breathe>=4.35.0
 - c-compiler
-- clang-tools==20.1.4
-- clang==20.1.4
+- clang-tools==20.1.8
+- clang==20.1.8
 - cmake>=3.30.4
 - cuda-nvcc
 - cuda-nvtx-dev
@@ -25,7 +25,7 @@ dependencies:
 - go
 - graphviz
 - ipython
-- libclang==20.1.4
+- libclang==20.1.8
 - libcublas-dev
 - libcurand-dev
 - libcusolver-dev

conda/environments/all_cuda-129_arch-x86_64.yaml

@@ -8,8 +8,8 @@ dependencies:
 - _go_select *=cgo
 - breathe>=4.35.0
 - c-compiler
-- clang-tools==20.1.4
-- clang==20.1.4
+- clang-tools==20.1.8
+- clang==20.1.8
 - cmake>=3.30.4
 - cuda-nvcc
 - cuda-nvtx-dev
@@ -25,7 +25,7 @@ dependencies:
 - go
 - graphviz
 - ipython
-- libclang==20.1.4
+- libclang==20.1.8
 - libcublas-dev
 - libcurand-dev
 - libcusolver-dev

conda/environments/all_cuda-131_arch-aarch64.yaml

@@ -8,8 +8,8 @@ dependencies:
 - _go_select *=cgo
 - breathe>=4.35.0
 - c-compiler
-- clang-tools==20.1.4
-- clang==20.1.4
+- clang-tools==20.1.8
+- clang==20.1.8
 - cmake>=3.30.4
 - cuda-nvcc
 - cuda-nvtx-dev
@@ -25,7 +25,7 @@ dependencies:
 - go
 - graphviz
 - ipython
-- libclang==20.1.4
+- libclang==20.1.8
 - libcublas-dev
 - libcurand-dev
 - libcusolver-dev

conda/environments/all_cuda-131_arch-x86_64.yaml

@@ -8,8 +8,8 @@ dependencies:
 - _go_select *=cgo
 - breathe>=4.35.0
 - c-compiler
-- clang-tools==20.1.4
-- clang==20.1.4
+- clang-tools==20.1.8
+- clang==20.1.8
 - cmake>=3.30.4
 - cuda-nvcc
 - cuda-nvtx-dev
@@ -25,7 +25,7 @@ dependencies:
 - go
 - graphviz
 - ipython
-- libclang==20.1.4
+- libclang==20.1.8
 - libcublas-dev
 - libcurand-dev
 - libcusolver-dev