Skip to content

Commit 2e01cd3

Browse files
committed
docs: correct release date and note the vector-planner caveat
The 0.10.0 heading carried the date the entry was drafted, not the release date. The entry also implied a vector index accelerates queries; verification against api.hotdata.dev found it does not currently do so on a managed database, so the entry now says what was observed.
1 parent 3bcef4c commit 2e01cd3

2 files changed

Lines changed: 10 additions & 2 deletions

File tree

CHANGELOG.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
88
## [Unreleased]
99

1010

11-
## [0.10.0] - 2026-08-06
11+
## [0.10.0] - 2026-08-07
1212

1313
### Added
1414

@@ -50,6 +50,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
5050
`metric`/`dimensions`/`embedding_provider_id`/`output_column`/`description` on a
5151
non-vector index.
5252

53+
Verified against `api.hotdata.dev` when this version was released: BM25 and vector
54+
indexes both build and report `ready`, and a BM25 index is used by full-text
55+
search. A *vector* index on a managed database was **not** picked up by the query
56+
planner at that time — a matching `cosine_distance(...) ORDER BY ... LIMIT k` still
57+
planned as a full scan. That reproduces with an index created by `hotdata indexes
58+
create`, so it is an engine-side issue rather than a client one, but it means a
59+
vector index built through this method may not yet accelerate queries.
60+
5361
- `CreateIndexResult`, the frozen dataclass `create_index` returns, is exported from
5462
`hotdata_framework` and added to the public contract surface. Its `source_column`
5563
names the text column to query for a provider-backed vector index, and is `None`

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Runtime boundary and guarantees are defined in `CONTRACT.md`.
1616
- **Result utilities** — convert query results to records, pandas DataFrames, or metadata dictionaries for adapter display layers.
1717
- **History helpers** — list recent results and query run history with normalized dataclasses.
1818
- **Managed databases** — create Hotdata-owned catalogs, declare tables, upload parquet, and load managed tables (mirrors `hotdata databases` in the CLI).
19-
- **Indexes** — build BM25, vector, or sorted indexes on managed tables (parity with `hotdata indexes create`), waiting on the background build and surfacing its failure instead of reporting a phantom success.
19+
- **Indexes** — build BM25, vector, or sorted indexes on managed tables, mirroring `hotdata indexes create` (managed databases only). Waits on the background build job and surfaces its failure, instead of reporting the phantom success the submit call returns.
2020
- **Health helpers** — build compact API/workspace health summaries for UI integrations.
2121

2222
Install:

0 commit comments

Comments
 (0)