From 20d7bfbd0ece133c15c774c46b2c6e6f96f314a2 Mon Sep 17 00:00:00 2001
From: lszskye <57179283+lszskye@users.noreply.github.com>
Date: Fri, 27 Feb 2026 16:16:17 +0800
Subject: [PATCH] chore: add VERSION for lumina (#153)

---
 third_party/lumina/VERSION         |  2 ++
 third_party/lumina/releases/v0.1.0 | 36 ++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 third_party/lumina/VERSION
 create mode 100644 third_party/lumina/releases/v0.1.0

diff --git a/third_party/lumina/VERSION b/third_party/lumina/VERSION
new file mode 100644
index 00000000..ec4aec56
--- /dev/null
+++ b/third_party/lumina/VERSION
@@ -0,0 +1,2 @@
+tag: v0.1.0
+bd7ac880cf34af4d267fcaf16773627cad122463
\ No newline at end of file
diff --git a/third_party/lumina/releases/v0.1.0 b/third_party/lumina/releases/v0.1.0
new file mode 100644
index 00000000..78cba2d0
--- /dev/null
+++ b/third_party/lumina/releases/v0.1.0
@@ -0,0 +1,36 @@
+# v0.1.0
+
+## Overview
+
+v0.1.0 is the first tagged release of Lumina. It establishes the public C++ API surface, and a baseline set of backends, formats, and extensions.
+
+## Audience
+
+- Users integrating Lumina via the public C++ API.
+- Users building indexes and serving online search.
+
+## Status
+
+Stable (initial release).
+
+## Changes
+
+- Features:
+  - Public "narrow waist" APIs: `LuminaBuilder` and `LuminaSearcher` with unified `Options` and `IO` abstraction.
+  - Backends: `diskann`, `ivf`, `bruteforce`.
+  - Extensions:
+    - Search-time filtering via `SearchWithFilterExtension` (DiskANN/Bruteforce).
+    - Experimental build-time checkpoint extension (DiskANN/Bruteforce builders).
+  - Persisted artifacts: `.lmi` section-based container format with CRC32C (optional per-section verification).
+  - Memory management: per-instance memory resource config and session pool support for avoiding heap allocations.
+
+## Migration Notes
+
+- This is the initial tagged release. If upgrading from an earlier untagged snapshot, rebuild indexes and checkpoints.
+
+## Known Issues
+
+- IVF: only `L2` metric is supported currently.
+- DiskANN: dynamic updates (incremental insert/delete) are not supported.
+- Builder: `LuminaBuilder` instances are not thread-safe.
+- IO: `.lmi` and backend layouts may change; upgrades may require rebuilding indexes.