feat(databases): migrate to dedicated databases API

[eddietejeda]

Summary

Migrates the CLI from the deprecated /connections API to the new /databases API, adds a current-database context (mirroring the sandbox context pattern), and scopes all queries via X-Database-Id.

What changed

• databases command rewritten — list, create, get, delete, set, and tables subcommands all hit /databases instead of /connections
• Current database context — hotdata databases set <id> saves the active database to config; auto-set on databases create
• --database flag on all databases tables subcommands (optional; falls back to current database)
• X-Database-Id header — automatically sent on every API request when a database is set, so hotdata query "SELECT ..." works against the current database without extra flags
• Footer — current database: <id> use 'hotdata databases set' to change printed on stderr at exit (same pattern as sandbox)
• Workspace-scoped — current database is stored as HashMap<workspace_id, database_id>; switching workspaces with --workspace-id never inherits a database set in a different workspace
• Clear on delete — databases delete clears the saved current database when the deleted ID was the active one, so subsequent commands don't silently send a stale X-Database-Id
• Datasets rework — removed file/upload/URL create paths; renamed --label→--description, --table-name→--name; --name is required; exactly one of --sql/--query-id required

Workflow

# First time
$ hotdata databases create --description "analytics"
Database created
description: analytics
id:          dbid_abc123
current database: dbid_abc123  use 'hotdata databases set' to change

# Tables and queries use the current database automatically
$ hotdata databases tables list
TABLE                     SYNCED  LAST_SYNC
default.public.events     true    2026-05-22

$ hotdata query "SELECT count(*) FROM default.public.events"
╭───────╮
│ count │
├───────┤
│ 3399866 │
╰───────╯

# Switch by description or id
$ hotdata databases set analytics
Current database set to dbid_abc123

# Delete clears the context
$ hotdata databases delete dbid_abc123
Database deleted.
$ hotdata databases tables list
error: no current database set. Use 'hotdata databases set <id>' or pass a database id.

Test results (against production server)

Command	Result
databases list	✅ Lists databases
databases set <description>	✅ Resolves by description, saves current
databases tables list (no flag)	✅ Uses current database
databases tables list --database <id>	✅ Uses explicit database, footer shows current
query "SELECT ..."	✅ Sends X-Database-Id, queries the database's tables
databases create	✅ Creates and auto-sets as current
databases delete <current>	✅ Deletes and clears current database
databases tables list after delete	✅ Errors with "no current database set"
databases set to recover	✅ Works, tables list resumes

Codex review items addressed

• Workspace-scoped current database — current_database is now stored as current_databases: HashMap<workspace_id, database_id>. Using --workspace-id ws_b will never pick up a database set under ws_a. The footer and X-Database-Id header both use the workspace that was actually resolved for the command.
• Clear on delete — databases delete now clears the saved current database when the deleted ID was the active one, preventing subsequent commands from silently sending a stale X-Database-Id.
• Positional arg removal — intentional; this is a new API with no existing scripts.

🤖 Generated with Claude Code

[sentry]

Codecov Report

❌ Patch coverage is 52.21239% with 162 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/databases.rs	60.07%	107 Missing ⚠️
src/config.rs	11.90%	37 Missing ⚠️
src/main.rs	33.33%	16 Missing ⚠️
src/api.rs	60.00%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!