From 69d8f0a1a8356d395b1cf7ef25dcf98939ff4c2d Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 16 Jun 2026 10:15:14 -0700 Subject: [PATCH 1/7] chore: Release hotdata-cli version 0.5.0 --- CHANGELOG.md | 10 ++++++++++ Cargo.lock | 2 +- Cargo.toml | 2 +- README.md | 2 +- skills/hotdata-analytics/SKILL.md | 2 +- skills/hotdata-geospatial/SKILL.md | 2 +- skills/hotdata-search/SKILL.md | 2 +- skills/hotdata/SKILL.md | 2 +- 8 files changed, 17 insertions(+), 7 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d1ddebc..a393002 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,13 @@ +## [0.5.0] - 2026-06-16 + +### πŸ› Bug Fixes + +- Follow truncated inline query results to full set +- Preserve inline warning and timing when following truncation + +### πŸ’Ό Other + +- Bump hotdata SDK to 0.2.0 ## [0.4.2] - 2026-06-15 ### πŸ“š Documentation diff --git a/Cargo.lock b/Cargo.lock index fe0acf5..2391d81 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1188,7 +1188,7 @@ dependencies = [ [[package]] name = "hotdata-cli" -version = "0.4.2" +version = "0.5.0" dependencies = [ "anstyle", "arrow", diff --git a/Cargo.toml b/Cargo.toml index b0b173a..18a3f08 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "hotdata-cli" -version = "0.4.2" +version = "0.5.0" edition = "2024" repository = "https://github.com/hotdata-dev/hotdata-cli" description = "CLI tool for Hotdata.dev" diff --git a/README.md b/README.md index fb04483..6bfa99d 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@
Command line interface for Hotdata.

- version + version build coverage

diff --git a/skills/hotdata-analytics/SKILL.md b/skills/hotdata-analytics/SKILL.md index 55c05d1..6e18249 100644 --- a/skills/hotdata-analytics/SKILL.md +++ b/skills/hotdata-analytics/SKILL.md @@ -1,7 +1,7 @@ --- name: hotdata-analytics description: Use this skill when the user wants OLAP-style SQL analytics in Hotdata β€” aggregations, GROUP BY, JOINs, reporting, exploratory queries, query run history, stored results, or materialized follow-up tables (Chain via datasets or managed databases). Activate for "analyze", "aggregate", "rollup", "pivot", "report", "metrics", "GROUP BY", "query history", "past queries", "query runs", "stored results", "materialize", "chain", "intermediate table", or sorted indexes for filters/range scans. Do not load for BM25/vector search or geospatial SQL β€” use hotdata-search or hotdata-geospatial. Requires the core hotdata skill for connections, tables, datasets, and auth. -version: 0.4.2 +version: 0.5.0 --- # Hotdata Analytics Skill diff --git a/skills/hotdata-geospatial/SKILL.md b/skills/hotdata-geospatial/SKILL.md index cc32706..dafb07f 100644 --- a/skills/hotdata-geospatial/SKILL.md +++ b/skills/hotdata-geospatial/SKILL.md @@ -1,7 +1,7 @@ --- name: hotdata-geospatial description: Use this skill only when the user is working with geospatial data in Hotdata (PostGIS-style SQL like ST_* functions, geometry/WKB, bbox filtering, point-in-polygon, distance/area, lat/lon, spatial joins, β€œgeospatial”, β€œGIS”, β€œPostGIS”). Do not load this skill for non-geospatial SQL or general Hotdata usage. -version: 0.4.2 +version: 0.5.0 --- # Hotdata Geospatial Skill diff --git a/skills/hotdata-search/SKILL.md b/skills/hotdata-search/SKILL.md index 4f9e6a1..ef7a2ae 100644 --- a/skills/hotdata-search/SKILL.md +++ b/skills/hotdata-search/SKILL.md @@ -1,7 +1,7 @@ --- name: hotdata-search description: Use this skill when the user wants full-text search, BM25 keyword search, vector similarity search, semantic search, embeddings, or retrieval indexes in Hotdata. Activate for "hotdata search", "BM25", "full-text", "vector search", "semantic search", "similarity", "embedding", "embedding provider", "create an index" (bm25 or vector), "list indexes" for search, or SQL using bm25_search or vector_distance. Do not load for general SQL analytics (aggregations, GROUP BY) or geospatial work β€” use hotdata-analytics or hotdata-geospatial instead. Requires the core hotdata skill for auth and workspace basics. -version: 0.4.2 +version: 0.5.0 --- # Hotdata Search Skill diff --git a/skills/hotdata/SKILL.md b/skills/hotdata/SKILL.md index f588555..3e91620 100644 --- a/skills/hotdata/SKILL.md +++ b/skills/hotdata/SKILL.md @@ -1,7 +1,7 @@ --- name: hotdata description: Use this skill when the user wants to run core hotdata CLI commands β€” auth, workspaces, connections, managed databases, datasets, tables, basic SQL query, database context (context:DATAMODEL), jobs, and skill install. Activate for "run hotdata", "list workspaces", "list connections", "create a connection", "list databases", "managed database", "load parquet", "list tables", "list datasets", "create a dataset", "execute a query", "database context", "context:DATAMODEL", or general Hotdata CLI usage. For full-text/vector search and retrieval indexes use hotdata-search; for OLAP analytics, query history, stored results, and Chain materializations use hotdata-analytics; for geospatial/GIS use hotdata-geospatial. -version: 0.4.2 +version: 0.5.0 --- # Hotdata CLI Skill From 4e636a7699e7b6f640699c9f5ce509c28c69f525 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 16 Jun 2026 10:16:52 -0700 Subject: [PATCH 2/7] docs(changelog): classify truncation-follow as feature --- CHANGELOG.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a393002..2e26f52 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,8 +1,11 @@ ## [0.5.0] - 2026-06-16 -### πŸ› Bug Fixes +### πŸš€ Features - Follow truncated inline query results to full set + +### πŸ› Bug Fixes + - Preserve inline warning and timing when following truncation ### πŸ’Ό Other From 7d0821a643a9a3b753ee3f2d48c3f0cf37749a84 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 16 Jun 2026 12:40:14 -0700 Subject: [PATCH 3/7] docs(changelog): reflect SDK bump to 0.3.0 in 0.5.0 --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2e26f52..03c2584 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,7 +10,7 @@ ### πŸ’Ό Other -- Bump hotdata SDK to 0.2.0 +- Bump hotdata SDK to 0.3.0 ## [0.4.2] - 2026-06-15 ### πŸ“š Documentation From 6d31620a4ed0b0910ad56cc902364eb1a5b9cd90 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 16 Jun 2026 12:58:03 -0700 Subject: [PATCH 4/7] chore: bump hotdata SDK to 0.3.1 for query 429 retry --- CHANGELOG.md | 3 ++- Cargo.lock | 4 ++-- Cargo.toml | 2 +- 3 files changed, 5 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 03c2584..ad80ecd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,7 @@ ### πŸš€ Features - Follow truncated inline query results to full set +- Auto-retry queries shed under load (HTTP 429 `OVERLOADED`), honoring `Retry-After` ### πŸ› Bug Fixes @@ -10,7 +11,7 @@ ### πŸ’Ό Other -- Bump hotdata SDK to 0.3.0 +- Bump hotdata SDK to 0.3.1 ## [0.4.2] - 2026-06-15 ### πŸ“š Documentation diff --git a/Cargo.lock b/Cargo.lock index 2391d81..d97075e 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1165,9 +1165,9 @@ checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70" [[package]] name = "hotdata" -version = "0.3.0" +version = "0.3.1" source = "registry+https://github.com/rust-lang/crates.io-index" -checksum = "1e42225ce51283f0dc70c4162e5499aef1afdf13dac3ee3cd143bd31c5bcb524" +checksum = "c54b66bbff35134c3c592aa55694015d282a1cbcdb549eaca6742b3ba35c12f1" dependencies = [ "arrow-array", "arrow-ipc", diff --git a/Cargo.toml b/Cargo.toml index 18a3f08..2d4b786 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -16,7 +16,7 @@ path = "src/main.rs" # behind a shared multi-thread tokio runtime. The `arrow` feature backs result # decode; `upload_stream` carries `content_length` (sized body, not chunked, so # the server can fast-fail an oversized upload β€” see src/sdk.rs::Api::upload_stream). -hotdata = { version = "0.3.0", features = ["arrow"] } +hotdata = { version = "0.3.1", features = ["arrow"] } # Shared multi-thread runtime for the sync wrapper; block_on is called # concurrently from rayon worker threads (see src/indexes.rs). `sync` backs the # mpsc channel that bridges the blocking upload reader into an async byte stream. From 8e69f1f9d984f9adfb5c0c9a50434b6364c5a04f Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 16 Jun 2026 13:00:44 -0700 Subject: [PATCH 5/7] docs(skills): document query truncation auto-follow and 429 retry --- skills/hotdata/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/skills/hotdata/SKILL.md b/skills/hotdata/SKILL.md index 3e91620..ea2a2f4 100644 --- a/skills/hotdata/SKILL.md +++ b/skills/hotdata/SKILL.md @@ -323,6 +323,8 @@ hotdata query status [--output table|json|csv] - Use `hotdata tables list` for discovery β€” not `information_schema` via `query`. - **PostgreSQL dialect.** Quote non-lowercase columns with double quotes. - Async runs return `query_run_id` β†’ poll with `query status` (do not re-run the same heavy SQL). +- **Large results are complete, not a preview.** The server returns inline rows only up to a bounded cap and persists the full set out-of-band; `hotdata query` transparently fetches the full result, so the printed rows and row count are the complete set. (If the full result can't be retrieved, the CLI prints the preview and a `warning:` to stderr.) +- **Backpressure is handled.** Under heavy concurrent load the server may shed a query with HTTP 429 (`OVERLOADED`); the CLI auto-retries (honoring `Retry-After`) before surfacing an error β€” no manual retry needed. - **OLAP** (aggregations, history, Chain, sorted indexes): **`hotdata-analytics`** skill. - **Search** (BM25, vector): **`hotdata-search`** skill. From 3c16a28494b74c6ca1bd15c455c6c1bbb8ecb34f Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 16 Jun 2026 13:31:27 -0700 Subject: [PATCH 6/7] docs(changelog): note dropping deprecated row_count in 0.5.0 --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index ad80ecd..4dd31c9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,7 @@ ### πŸ› Bug Fixes - Preserve inline warning and timing when following truncation +- Stop using deprecated `QueryResponse.row_count` ### πŸ’Ό Other From a55e5c88cb88bca748f70ba59ae9c7668025e137 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 16 Jun 2026 13:43:06 -0700 Subject: [PATCH 7/7] docs(changelog): add blank line before previous release section --- CHANGELOG.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 4dd31c9..a6ff51d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,6 +13,7 @@ ### πŸ’Ό Other - Bump hotdata SDK to 0.3.1 + ## [0.4.2] - 2026-06-15 ### πŸ“š Documentation