Bump version to v0.2.4-alpha

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: vlasky

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this community fork will be documented in this file.
 
+## [0.2.4-alpha] - 2026-01-03
+
+### Added
+
+- **Lua binding with IEEE 754 compliant float serialization** ([#237](https://github.com/asg017/sqlite-vec/pull/237))
+  - `bindings/lua/sqlite_vec.lua` provides `load()`, `serialize_f32()`, and `serialize_json()` functions
+  - Lua 5.1+ compatible with lsqlite3
+  - IEEE 754 single-precision float encoding with round-half-to-even (banker's rounding)
+  - Proper handling of special values: NaN, Inf, -Inf, -0.0, subnormals
+  - Example script and runner in `/examples/simple-lua/`
+
 ## [0.2.3-alpha] - 2025-12-29
 
 ### Added

CLAUDE.md

@@ -7,12 +7,12 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 > [!NOTE]
 > This is a community fork of [`asg017/sqlite-vec`](https://github.com/asg017/sqlite-vec) created to merge pending upstream PRs and provide continued support while the original author is unavailable.
 
-`sqlite-vec` is a lightweight, fast vector search SQLite extension written in pure C with no dependencies. It's a pre-v1 project (current: v0.2.2-alpha) that provides vector similarity search capabilities for SQLite databases across all platforms where SQLite runs.
+`sqlite-vec` is a lightweight, fast vector search SQLite extension written in pure C with no dependencies. It's a pre-v1 project (current: v0.2.4-alpha) that provides vector similarity search capabilities for SQLite databases across all platforms where SQLite runs.
 
 Key features:
 - Supports float, int8, and binary vector types via `vec0` virtual tables
 - Pure C implementation with optional SIMD optimizations (AVX on x86_64, NEON on ARM)
-- Multi-language bindings (Python, Node.js, Ruby, Go, Rust)
+- Multi-language bindings (Python, Node.js, Ruby, Go, Rust, Lua)
 - Runs anywhere: Linux/MacOS/Windows, WASM, embedded devices
 - Distance constraints for KNN queries (enables pagination and range queries)
 - Optimize command for space reclamation after deletes
@@ -134,6 +134,13 @@ All bindings wrap the core C extension:
   - Crate configuration in `Cargo.toml`
   - Exports `sqlite3_vec_init()` in `src/lib.rs`
 
+- **Lua** (`bindings/lua/`): Lua 5.1+ compatible binding
+  - Requires `lsqlite3` module
+  - `load()` function to load the extension
+  - `serialize_f32()` for IEEE 754 binary format
+  - `serialize_json()` for JSON format
+  - Example in `examples/simple-lua/`
+
 ### Documentation Site
 
 Built with VitePress (Vue-based static site generator):
@@ -203,6 +210,8 @@ Code uses preprocessor directives to select implementations. Distance calculatio
 - Vector format: JSON arrays `'[1,2,3]'` or raw bytes via helper functions
 
 **Fork-specific notes:**
+- Version v0.2.4-alpha includes: Lua binding with IEEE 754 compliant float serialization (#237)
+- Version v0.2.3-alpha includes: Android 16KB page support (#254), LDFLAGS support, documentation fixes (#208, #209)
 - Version v0.2.2-alpha includes: GLOB operator for text metadata (#191), IS/IS NOT/IS NULL/IS NOT NULL operators (#190), all compilation warnings fixed (including critical logic bug)
 - Version v0.2.1-alpha includes: LIKE operator for text metadata (#197), locale-independent JSON parsing (#241), musl libc compilation fix
 - Version v0.2.0-alpha merged upstream PRs: #166 (distance constraints), #210 (optimize), #203 (ALTER TABLE RENAME), #212 (cosine distance for binary), #243 (delete memory leak fix), #228 (CI/CD updates)

README.md

@@ -71,11 +71,12 @@ Install directly from GitHub to get the latest features from this community fork
 
 | Language | Install Latest (main branch) | Install Specific Version |
 |----------|------------------------------|--------------------------|
-| **Go** | `go get github.com/vlasky/sqlite-vec/bindings/go/cgo@main` | `go get github.com/vlasky/sqlite-vec/bindings/go/cgo@v0.2.0-alpha` |
-| **Python** | `pip install git+https://github.com/vlasky/sqlite-vec.git` | `pip install git+https://github.com/vlasky/sqlite-vec.git@v0.2.0-alpha` |
-| **Rust** | `cargo add sqlite-vec --git https://github.com/vlasky/sqlite-vec` | `cargo add sqlite-vec --git https://github.com/vlasky/sqlite-vec --tag v0.2.0-alpha` |
-| **Node.js** | `npm install vlasky/sqlite-vec` | `npm install vlasky/sqlite-vec#v0.2.0-alpha` |
-| **Ruby** | `gem 'sqlite-vec', git: 'https://github.com/vlasky/sqlite-vec'` | `gem 'sqlite-vec', git: 'https://github.com/vlasky/sqlite-vec', tag: 'v0.2.0-alpha'` |
+| **Go** | `go get github.com/vlasky/sqlite-vec/bindings/go/cgo@main` | `go get github.com/vlasky/sqlite-vec/bindings/go/cgo@v0.2.4-alpha` |
+| **Lua** | `luarocks install lsqlite3` then copy [`sqlite_vec.lua`](bindings/lua/) to your project. See [Lua example](/examples/simple-lua/) | Download [`sqlite_vec.lua` at v0.2.4-alpha](https://github.com/vlasky/sqlite-vec/blob/v0.2.4-alpha/bindings/lua/sqlite_vec.lua) |
+| **Python** | `pip install git+https://github.com/vlasky/sqlite-vec.git` | `pip install git+https://github.com/vlasky/sqlite-vec.git@v0.2.4-alpha` |
+| **Rust** | `cargo add sqlite-vec --git https://github.com/vlasky/sqlite-vec` | `cargo add sqlite-vec --git https://github.com/vlasky/sqlite-vec --tag v0.2.4-alpha` |
+| **Node.js** | `npm install vlasky/sqlite-vec` | `npm install vlasky/sqlite-vec#v0.2.4-alpha` |
+| **Ruby** | `gem 'sqlite-vec', git: 'https://github.com/vlasky/sqlite-vec'` | `gem 'sqlite-vec', git: 'https://github.com/vlasky/sqlite-vec', tag: 'v0.2.4-alpha'` |
 
 **Python Note:** Requires Python built with loadable extension support (`--enable-loadable-sqlite-extensions`). If you encounter an error about extension support not being available:
 - Use `uv` to create virtual environments (automatically uses system Python which typically has extension support)

VERSION

@@ -1 +1 @@
-0.2.3-alpha
+0.2.4-alpha

sqlite-vec.h

@@ -17,15 +17,15 @@
   #endif
 #endif
 
-#define SQLITE_VEC_VERSION "v0.2.3-alpha"
+#define SQLITE_VEC_VERSION "v0.2.4-alpha"
 // TODO rm
-#define SQLITE_VEC_DATE "2025-12-29T11:22:41Z+1100"
-#define SQLITE_VEC_SOURCE "d12d763eb2170ccdfd7418b9af3febd46fb33a85"
+#define SQLITE_VEC_DATE "2026-01-04T19:18:13Z+1100"
+#define SQLITE_VEC_SOURCE "c4ec0fc3a6254789d84cfa288313723fb6f2015d"
 
 
 #define SQLITE_VEC_VERSION_MAJOR 0
 #define SQLITE_VEC_VERSION_MINOR 2
-#define SQLITE_VEC_VERSION_PATCH 3
+#define SQLITE_VEC_VERSION_PATCH 4
 
 #ifdef __cplusplus
 extern "C" {