@soulcraft/cortex 2.4.0 → 2.5.0

package/dist/plugin.js

@@ -123,6 +123,11 @@ const cortexPlugin = {
         // Quantized distance: SQ8 cosine distance on uint8 arrays (no dequantization).
         // Consumed by brainy's HNSW SQ8 reranking (setSQ8DistanceImplementation).
         context.registerProvider('distance:sq8', native.cosineDistanceSq8);
+        // Quantized distance: SQ4 cosine distance on packed nibbles (2 values per byte).
+        // Consumed by brainy 7.28.0+ HNSW SQ4 reranking when config.hnsw.quantization.bits === 4
+        // via setSQ4DistanceImplementation. Byte-for-byte identical to brainy's
+        // distanceSQ4Js; cross-language parity verified in the brainy test suite.
+        context.registerProvider('distance:sq4', native.cosineDistanceSq4);
         // Graph connection compression: delta-varint encoded connection lists.
         // Reserved for the 2.4.0 vector/graph-storage initiative (HNSW connection
         // persistence). Registered now so that work wires brainy without a cortex change.
@@ -134,10 +139,13 @@ const cortexPlugin = {
         // up. The following native capabilities exist in Rust + napi but are intentionally
         // NOT registered (no brainy consumer yet) — they are re-registered the moment a
         // hook lands, with no Rust change required:
-        //   • SQ8 batch distance, SQ8/SQ4 quantize-codec, SQ4 distance, PQ codebook
-        //       → pending a brainy quantization-delegation hook (handoff BR-QUANT-SQ4-PQ)
-        //   • compaction:bfsOrder / compaction:hnswOrder
-        //       → pending a brainy compaction-order hook (handoff BR-COMPACTION-HOOK)
+        //   • SQ8 batch distance, SQ8/SQ4 quantize-codec, PQ codebook
+        //       → pending broader brainy quantization-delegation hooks beyond the
+        //         distance-fn swap (already wired for SQ8 + SQ4 above)
+        //   • compaction:bfsOrder / compaction:hnswOrder — superseded after the
+        //     2026-05-28 strategic reset: DiskANN's Vamana produces locality natively,
+        //     so the HNSW BFS-compaction hook is not pursued. Rust impls stay as
+        //     future-utility; no brainy hook will be added.
         // HNSW: Native Rust graph engine with SIMD distance and Arc-based COW
         const { NativeHNSWWrapper } = await import('./hnsw/NativeHNSWWrapper.js');
         context.registerProvider('hnsw', (config, distanceFn, options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/cortex",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Native Rust acceleration for Brainy — SIMD distance, vector quantization, zero-copy mmap, native embeddings. Free tier for storage, Pro license for compute acceleration.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -66,11 +66,11 @@
     "LICENSE"
   ],
   "peerDependencies": {
-    "@soulcraft/brainy": ">=7.26.0"
+    "@soulcraft/brainy": ">=7.28.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.0.0",
-    "@soulcraft/brainy": "^7.26.0",
+    "@soulcraft/brainy": "^7.28.0",
     "@types/node": "^22.0.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",