From 26835179403493082d2011710b10efe391fd5c98 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 8 Sep 2026 14:35:33 -0700 Subject: [PATCH 1/4] chore: Release hotdata-cli version 0.33.0 --- CHANGELOG.md | 6 ++++++ Cargo.lock | 2 +- Cargo.toml | 2 +- skills/hotdata/SKILL.md | 2 +- skills/hotdata/subskills/analytics/SKILL.md | 2 +- skills/hotdata/subskills/geospatial/SKILL.md | 2 +- skills/hotdata/subskills/search/SKILL.md | 2 +- 7 files changed, 12 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index a97aedd..df56044 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,9 @@ +## [0.33.0] - 2026-09-08 + +### πŸš€ Features + +- *(databases)* Load csv/json, keyed load modes, and table declaration (#293) +- *(databases)* Load a json file in whatever shape it holds (#294) ## [0.32.0] - 2026-09-06 ### πŸš€ Features diff --git a/Cargo.lock b/Cargo.lock index 54ecda1..76ee459 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1263,7 +1263,7 @@ dependencies = [ [[package]] name = "hotdata-cli" -version = "0.32.0" +version = "0.33.0" dependencies = [ "anstyle", "arrow", diff --git a/Cargo.toml b/Cargo.toml index ba6ca87..eafa2c2 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "hotdata-cli" -version = "0.32.0" +version = "0.33.0" edition = "2024" repository = "https://github.com/hotdata-dev/hotdata-cli" description = "CLI tool for Hotdata.dev" diff --git a/skills/hotdata/SKILL.md b/skills/hotdata/SKILL.md index ed17605..0a3b45e 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, instant databases, tables, basic SQL query, database context (context:DATAMODEL), jobs, datasources/ingests/runs (pull external data), and skill install. Activate for "run hotdata", "list workspaces", "list databases", "instant database", "load parquet", "list tables", "show table columns", "execute a query", "database context", "context:DATAMODEL", "ingest", "datasource", "ingest run", "show a run", "schedule an ingest", "import data from", "connect a data source", "connector", "pull data from postgres/mysql/an API/S3 buckets/Iceberg", or general Hotdata CLI usage. This skill bundles three specialized guides under subskills/, loaded on demand: read subskills/search/SKILL.md for full-text/vector search and retrieval indexes, subskills/analytics/SKILL.md for OLAP analytics, query history, stored results, and Chain materializations, and subskills/geospatial/SKILL.md for geospatial/GIS. -version: 0.32.0 +version: 0.33.0 --- # Hotdata CLI Skill diff --git a/skills/hotdata/subskills/analytics/SKILL.md b/skills/hotdata/subskills/analytics/SKILL.md index fcbc327..1210c2e 100644 --- a/skills/hotdata/subskills/analytics/SKILL.md +++ b/skills/hotdata/subskills/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 into instant 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 tables and auth. -version: 0.32.0 +version: 0.33.0 --- # Hotdata Analytics Skill diff --git a/skills/hotdata/subskills/geospatial/SKILL.md b/skills/hotdata/subskills/geospatial/SKILL.md index 02062c8..bbfb224 100644 --- a/skills/hotdata/subskills/geospatial/SKILL.md +++ b/skills/hotdata/subskills/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.32.0 +version: 0.33.0 --- # Hotdata Geospatial Skill diff --git a/skills/hotdata/subskills/search/SKILL.md b/skills/hotdata/subskills/search/SKILL.md index 6f68a24..a9a050b 100644 --- a/skills/hotdata/subskills/search/SKILL.md +++ b/skills/hotdata/subskills/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.32.0 +version: 0.33.0 --- # Hotdata Search Skill From f62ba3d63937179adb300e708965cedb0106e259 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 8 Sep 2026 14:36:33 -0700 Subject: [PATCH 2/4] docs(changelog): write the 0.33.0 entry in plain language --- CHANGELOG.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index df56044..c26dbff 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,8 +2,14 @@ ### πŸš€ Features -- *(databases)* Load csv/json, keyed load modes, and table declaration (#293) -- *(databases)* Load a json file in whatever shape it holds (#294) +- *(databases)* Load csv and json files, not just parquet β€” json in any shape: an array, a pretty-printed document, or one object per line (#293, #294) +- *(databases)* Keyed load modes β€” `--mode delete|update|upsert` match existing rows by key (#293) +- *(databases)* `databases tables add --key` declares a table's key and layout before its first load (#293) + +### πŸ”„ Changed + +- *(search)* Vector search no longer returns the index's embedding column; `--select '*'` asks for it back (#293) +- *(query)* `--output csv` no longer abbreviates long list values (#293) ## [0.32.0] - 2026-09-06 ### πŸš€ Features From cf65e2086ed14801cd1b6eae42eed1844cbbba50 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 8 Sep 2026 14:54:10 -0700 Subject: [PATCH 3/4] docs(changelog): note the skills update in 0.33.0 --- CHANGELOG.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index c26dbff..893c5c6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,6 +10,10 @@ - *(search)* Vector search no longer returns the index's embedding column; `--select '*'` asks for it back (#293) - *(query)* `--output csv` no longer abbreviates long list values (#293) + +### πŸ“š Documentation + +- *(skills)* Warn agents that a `;`-separated csv loads silently into one column, and that json-in-any-shape is the CLI's doing, not the API's (#296) ## [0.32.0] - 2026-09-06 ### πŸš€ Features From a43fa063b617592b2d3dc7b1f6aa5f46a1cbcf41 Mon Sep 17 00:00:00 2001 From: Zac Farrell Date: Tue, 8 Sep 2026 15:05:09 -0700 Subject: [PATCH 4/4] docs(changelog): shorten the skills line --- CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 893c5c6..3f42dc3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,7 +13,7 @@ ### πŸ“š Documentation -- *(skills)* Warn agents that a `;`-separated csv loads silently into one column, and that json-in-any-shape is the CLI's doing, not the API's (#296) +- *(skills)* Improve the agent guidance around data loading (#296) ## [0.32.0] - 2026-09-06 ### πŸš€ Features