Skip to content

Commit 744cd15

Browse files
authored
chore: Release hotdata-cli version 0.26.0 (#265)
* chore: Release hotdata-cli version 0.26.0 * docs(changelog): explain the 0.26.0 breaking changes
1 parent ea632b2 commit 744cd15

7 files changed

Lines changed: 62 additions & 6 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,59 @@
1+
## [0.26.0] - 2026-08-19
2+
3+
### 🚀 Features
4+
5+
- *(auth)* [**breaking**] Stop minting jwts from api tokens
6+
- *(sdk)* [**breaking**] Adopt hotdata 0.13.0 and restore the per-request bearer hook
7+
- *(databases)* [**breaking**] Remove the run command
8+
9+
### 🐛 Bug Fixes
10+
11+
- *(databases)* Stop tables load misrouting into wrong database
12+
- *(sdk)* Re-resolve bearer per call for CLI-owned request paths
13+
- *(sdk)* Diagnose expired-session upload failures, fix blocking probe
14+
- *(sdk)* Scope expired-session upload hint to real sessions
15+
- *(databases)* Treat a 403 existence check as unverifiable in set
16+
17+
### 🚜 Refactor
18+
19+
- *(auth)* Share the /workspaces fetch helper
20+
- *(databases)* [**breaking**] Drop guessed database-token detection
21+
22+
### 📚 Documentation
23+
24+
- *(ingest)* Create starts no run — correct the causality (#260)
25+
- *(jwt)* Correct stale JWT-exchange doc comments
26+
- *(credentials)* Correct stale empty-ids semantics
27+
28+
### 🧪 Testing
29+
30+
- *(sdk)* Prove the bearer re-resolves per request, not once
31+
- *(sdk)* Pin which mint answers which upload refresh
32+
33+
### ⚠️ Breaking: `databases run` is gone, and API tokens are no longer exchanged for JWTs
34+
35+
`databases run` is removed with no replacement. It was the only command that
36+
minted a database session token, so the client side of that credential goes
37+
with it — the `HOTDATA_DATABASE_TOKEN` auth path no longer exists.
38+
`HOTDATA_DATABASE` and the `hd_…` database API token are untouched.
39+
40+
An `hd_…` API token is now sent verbatim as the bearer instead of being
41+
exchanged for a JWT, and the credential is resolved once per request rather
42+
than once per client. That fixes uploads large enough to outlive the credential
43+
they started with, which used to 401 at finalize (#120).
44+
45+
Three consequences of losing the JWT claims the CLI used to read:
46+
47+
- `auth status` no longer shows an "API Key Source" row.
48+
- `tables load` no longer routes a database-scoped API token to the
49+
database-scoped endpoints — the claim it keyed off is gone and there is no
50+
replacement signal, so those tokens now surface the server's `ACCESS_DENIED`
51+
403. `databases set` still works with them: its existence check is advisory,
52+
so a 403 there means "can't verify, proceed".
53+
- Workspace scope for an API key comes from a live `GET /workspaces` instead of
54+
a claim. An unrestricted key with no saved default used to have no
55+
discoverable scope and forced `--workspace-id`; it now resolves to whichever
56+
workspace the API lists first.
157
## [0.25.0] - 2026-08-14
258

359
### 🚀 Features

‎Cargo.lock‎

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎Cargo.toml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[package]
22
name = "hotdata-cli"
3-
version = "0.25.0"
3+
version = "0.26.0"
44
edition = "2024"
55
repository = "https://github.com/hotdata-dev/hotdata-cli"
66
description = "CLI tool for Hotdata.dev"

‎skills/hotdata/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: hotdata
33
description: Use this skill when the user wants to run core hotdata CLI commands — auth, workspaces, managed 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", "managed 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.
4-
version: 0.25.0
4+
version: 0.26.0
55
---
66

77
# Hotdata CLI Skill

‎skills/hotdata/subskills/analytics/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: hotdata-analytics
33
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 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 tables and auth.
4-
version: 0.25.0
4+
version: 0.26.0
55
---
66

77
# Hotdata Analytics Skill

‎skills/hotdata/subskills/geospatial/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: hotdata-geospatial
33
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.
4-
version: 0.25.0
4+
version: 0.26.0
55
---
66

77
# Hotdata Geospatial Skill

‎skills/hotdata/subskills/search/SKILL.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: hotdata-search
33
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.
4-
version: 0.25.0
4+
version: 0.26.0
55
---
66

77
# Hotdata Search Skill

0 commit comments

Comments
 (0)