feat(lumina): update lumina version to v0.2.3 (#418)

Author: lszskye

third_party/lumina/VERSION

@@ -1,2 +1,2 @@
-tag: v0.2.2
-89ea85ed8ef350455a15e1a2519271007ae15807
+tag: v0.2.3
+35a4baf2ffee257f1ca8663c183a42d0ed60c300

third_party/lumina/lib/liblumina.so

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e3d705af0cbeeed52f61875a450649dbe651ded22c534636e1e15deb8d5cc97c
-size 70689096
+oid sha256:0cb6ea8eb476fda606f0263609d94d976f1bf1d7ee896b4718b16aff277ce6bb
+size 70692672

third_party/lumina/reference/DiskANNParameters.md

@@ -147,4 +147,4 @@ options from a string map, prefer normalized entry points such as [NormalizeSear
 
 ## Status
 
-v0.2.2 Release Tag (2026-05-14).
+v0.2.3 Release Tag (2026-07-13).

third_party/lumina/reference/QuantizationParameters.md

@@ -112,4 +112,4 @@ Current behavior:
 
 ## Status
 
-v0.2.2 Release Tag (2026-05-14).
+v0.2.3 Release Tag (2026-07-13).

third_party/lumina/releases/v0.2.3.md

@@ -0,0 +1,46 @@
+# v0.2.3
+
+## Overview
+
+This is a patch release focusing on **bug fixes** for the PQ quantizer. No new features are introduced.
+
+## Audience
+
+- Users integrating Lumina via the public C++ API or Python interface.
+- Users building indexes offline and serving online search.
+
+## Status
+
+Stable (2026-07-13).
+
+## Compatibility
+
+- **Public API**: stable within `include/lumina/api/**` following Lumina versioning policy.
+- **Source compatibility**: guaranteed within the compatible range (recompile required). ABI compatibility is not
+  promised.
+- **On-disk formats**:
+  - The `.lmi` container format is versioned (current version: `0`) and uses CRC32C for corruption detection.
+  - Backend-specific layouts are excluded from long-term compatibility promises unless explicitly declared stable.
+  - IVF snapshot layout is experimental.
+- **Extensions**:
+  - `SearchWithFilterExtension` is stable and supported by `diskann` and `bruteforce` searchers (not supported by `ivf`).
+  - Checkpoint extension is experimental, backend-specific, and excluded from long-term compatibility promises.
+  - `GetVectorExtension` is experimental and supported only by the `bruteforce` searcher with `rawf32` encoding.
+- **Python**: experimental interface; the API may change across versions and is not covered by stability promises.
+
+## Changes
+
+- Bug Fixes:
+  - Quantizer: fix missing metric type validation for PQ quantizer when creating builder. PQ only supports `L2` and `IP` metrics; unsupported metrics now fail fast with a clear error (#84219024).
+
+## Migration Notes
+
+- No breaking changes. Drop-in replacement for v0.2.2.
+
+## Known Issues
+
+- IVF: only `L2` metric is currently supported.
+- DiskANN: dynamic updates (incremental insert/delete) are still not supported.
+- Builder: `LuminaBuilder` instances remain not thread-safe.
+- IO: `.lmi` and backend layouts are still evolving, so upgrades may require rebuilding indexes.
+- See [Limitations](../reference/Limitations.md) for the complete list.