Changelog

Copy Markdown View Source

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.6.0] - 2026-06-13

Adds client support for the engine's full-text (Tantivy/BM25) and vector (HNSW) index creation and search, now wired into the query layer.

Added

  • Dllb.Query.define_fulltext_index/4 builds DEFINE FULLTEXT INDEX <name> ON TABLE <table> FIELDS <field> [ANALYZER <a>], with an optional :analyzer (default, simple, or a language).
  • Dllb.Query.define_vector_index/5 builds DEFINE VECTOR INDEX <name> ON TABLE <table> FIELDS <field> DIMENSION <n> [METRIC <m>], with an optional :metric (cosine, euclidean/l2, or dot).
  • Dllb.Query.search/4 builds SEARCH <table> <field> '<query>' [LIMIT n] (BM25 full-text). Results are rows ranked best-first, each with a score.
  • Dllb.Query.vector_search/4 builds VECTOR SEARCH <table> <field> [v, ...] [K n] (approximate KNN). Results are rows ordered nearest-first, each with a distance.
  • Dllb.Schema.ast_node_search_indexes/0 defines the full-text indexes on source_text/docstring and the vector indexes on source_embedding (768, cosine) / structure_embedding (384, cosine).

Changed

  • Dllb.Schema.all_statements/0 now also emits the full-text and vector search index definitions, so bootstrap/1 provisions them. These require a dllb server with search services enabled (the default server build).

[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.