All notable changes to this project are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.5.0] - 2026-06-13

Synchronizes the client with the dllb engine's persisted secondary-index catalog and related query features.

Added

  • Dllb.Query.define_index/4 builds the engine's catalog-backed secondary index DDL: DEFINE INDEX <name> ON TABLE <table> FIELDS <field>[, ...]. It supports composite (multi-field) indexes with leftmost-prefix planning and an optional unique: true constraint over the full indexed tuple.
  • Dllb.Query.remove_index/2 builds REMOVE INDEX <name> ON TABLE <table>.
  • Dllb.Query.upsert/4 accepts an explicit update_fields map, emitting CREATE ... ON CONFLICT UPDATE SET <update_fields>. The existing upsert/3 behavior is unchanged.

Changed

  • Dllb.Schema.ast_node_indexes/0 now emits the new secondary-index DDL and defines idx_kind, idx_language, idx_file_path, idx_module, idx_project_path, and the composite idx_file_kind on file_path, kind.
  • Equality and range predicates on indexed fields are now transparently accelerated by the engine; no client query changes are required to benefit.

Removed

  • BREAKING: the typed Dllb.Query.define_index/5 variants (:btree, :fulltext, :hnsw) are removed. They generated DDL (SEARCH ANALYZER ..., HNSW DIMENSION ... DIST ...) that the current engine parser rejects. Use define_index/4 for secondary indexes.
  • Dllb.Schema.ast_node_indexes/0 no longer emits the non-functional HNSW (idx_source_embedding, idx_structure_embedding) and full-text (idx_source_text, idx_docstring) index definitions, because vector and full-text index creation are not exposed by the engine's query protocol.