362 lines (254 loc) · 13.8 KB

Changelog

All notable changes to @bonnard/cli will be documented in this file.

[0.3.13] - 2026-03-03

Added

bon init --agent <name> — generate templates for a specific coding agent (claude, cursor, codex, windsurf, copilot, cline)
Interactive agent picker when running bon init without --agent
Non-interactive mode detection: --agent required when stdin is not a TTY
Self-hosted env var hints: bon datasource add prints CUBEJS_DB_* values for .env in self-hosted mode

Fixed

bon datasource test no longer tries to push datasources in self-hosted mode
Self-hosted bon datasource add no longer shows misleading "tested during deploy" message

[0.3.12] - 2026-03-03

Changed

bon init --self-hosted no longer scaffolds DEPLOY.md — deployment docs now in the public repo README

[0.3.11] - 2026-03-01

Added

bon datasource test [name] — test datasource connections via Cube drivers (syncs first, then tests)
--no-check flag for bon deploy — skip connection tests during deploy
Connection testing during bon deploy — tests all referenced datasources after sync, before uploading files

Changed

Connection testing now routes through Cube's bundled drivers instead of native DB drivers — supports all 7 warehouse types (postgres, redshift, snowflake, bigquery, databricks, duckdb, clickhouse)
bon datasource add now shows "Connection will be tested during bon deploy" messaging

[0.3.10] - 2026-03-01

Added

--ssl flag for bon datasource add — sets SSL mode for Postgres/Redshift (defaults to require)
SSL Configuration section in cubes.data-source docs

Fixed

SSL not passed to Cube Postgres driver at query time — cloud databases (Neon, Supabase, RDS) now connect correctly

[0.3.9] - 2026-02-27

Changed

Get-started skill now pauses between phases — checkpoints after data exploration, persona questions before view design, confirmation before deploy
Skill templates updated for both Claude and Cursor

[0.3.8] - 2026-02-27

Added

CLI sends User-Agent header (bon-cli/<version> node-<version> <os> (<arch>)) on all API calls for usage tracking

Changed

Security docs: added Fly.io to infrastructure vendor table

Fixed

@bonnard/react exports map updated for tsdown 0.20.3 (.js → .mjs), fixing Vercel production builds

[0.3.7] - 2026-02-24

Added

--no-check flag for bon deploy — skips datasource validation when editing remote models without local credentials

Changed

bon validate warns when views combine cubes with no join path between them

[0.3.6] - 2026-02-24

Added

bon query docs topic (bon docs cli.query) with full query reference
bon schema now separates time dimensions from regular dimensions
Dashboard viewer source tab with line numbers and copy button

Changed

Query API normalizes timeDimension → timeDimensions and dimension → member aliases
BigQuery credentials passed as parsed object instead of base64 string
Dashboard build skill requires preview confirmation before deploy

[0.3.5] - 2026-02-23

Added

BigQuery and Databricks driver support in Cube layer

Changed

Safer error handling across CLI commands (annotate, query, deploy, keys, docs)
bon login timeout increased to 10 minutes for first-time sign-up flows
Redshift case added to dbt connection mapping

[0.3.4] - 2026-02-23

Added

bon schema — list deployed views/cubes with measures, dimensions, and segments
BigQuery connection tester (JWT + REST API, no new deps)
<Column> children for DataTable — per-column formatting without comma ambiguity

Changed

bon query now bypasses governance (full access) — only SDK tokens carry group restrictions
Skill templates updated to use bon schema instead of bon docs schema
"Local preview — not deployed" banner added to dashboard viewer

[0.3.3] - 2026-02-22

Changed

Slug validation on bon dashboard deploy — rejects invalid characters before upload
Request timeouts on all API calls — prevents hanging on network issues
Theme validation on bon theme set — catches invalid YAML and unknown keys before upload
Updated dashboard skill templates (Claude + Cursor) with BigValue comparison and combo chart examples
Dashboard docs updated: BigValue comparison props, secondary y-axis, PieChart fmt, theming sidebar

[0.3.2] - 2026-02-21

Added

bon theme get / bon theme set / bon theme reset — manage org-wide dashboard themes
Dashboard theming docs (bon docs dashboards.theming) — palettes, color tokens, cascade

[0.3.1] - 2026-02-21

Fixed

Buffer polyfill for dashboard viewer in browser environments

[0.3.0] - 2026-02-21

Added

Markdown dashboards — bon dashboard dev for local preview with live reload, bon dashboard deploy for production
Built-in chart components: BigValue, LineChart, BarChart, AreaChart, PieChart, DataTable
Interactive inputs: DateRange picker, Dropdown filter with query binding
Format presets (eur, usd, gbp, chf, pct, num, dates) and raw Excel format codes
Auto BigValue grouping and Grid layout
Shareable URLs with filter state in query params

[0.2.16] - 2026-02-21

Changed

Unified dashboards — bon page commands renamed to bon dashboard (deploy, list, remove, open)
Public URL path changed from /p/{org}/{slug} to /d/{org}/{slug}
Dashboards now require login (no longer publicly accessible)
Removed markdown dashboard documentation from bundled docs

Removed

bon page commands (replaced by bon dashboard)

[0.2.15] - 2026-02-21

Changed

MCP server no longer includes dashboard tools (list, get, deploy, remove, get_dashboard_docs) — use bon dashboard CLI commands instead
SDK docs now bundled with CLI (bon docs sdk.browser, bon docs sdk.authentication, etc.)

[0.2.14] - 2026-02-20

Added

bon pull — download deployed models from remote to local project
bon page deploy / bon page list / bon page remove / bon page open — deploy HTML dashboards via CLI
/bonnard-build-dashboard agent skill for Claude and Cursor — guides building HTML dashboards with the SDK
Browser SDK docs added to bon docs topics

[0.2.13] - 2026-02-19

Added

Security context and governance documentation (bon docs security-context)

Fixed

Chart y-axis formatting when yFmt is specified

[0.2.12] - 2026-02-19

Added

bon keys list / bon keys create / bon keys revoke — manage API keys from the CLI
DuckDB and MotherDuck as supported warehouse types (bon datasource add --type duckdb)

Changed

Fully-qualified field names required everywhere (removed cube shorthand)
Fixed components doc examples to use fully-qualified field names

[0.2.11] - 2026-02-18

Added

Update check notification — bon now checks for newer versions in the background and shows a notice after command output

[0.2.10] - 2026-02-18

Changed

CI publish workflow fixes (sync + provenance)

[0.2.9] - 2026-02-17

Changed

CI publish workflow with npm provenance for verified builds

[0.2.8] - 2026-02-17

Added

MCP dashboard tools: list, get, deploy, remove dashboards, get dashboard docs
Dashboard versioning — version snapshots created on dashboard create/update
Open-source CLI repository at github.com/bonnard-data/bonnard-cli

Changed

Getting-started docs now lead with npx as primary install method
Added repository and license fields to package.json
README updated with open-source callout and GitHub link

[0.2.7] - 2026-02-16

Added

bon metabase explore now accepts names (not just IDs) for table, card, dashboard, database, and collection lookups
Disambiguation output when a name matches multiple resources (shows IDs with context)
Table IDs included in bon metabase analyze report (Table Inventory and Most Referenced Tables sections)

Changed

Design guide: removed "5-10 views" target — governance policies control per-user view access, so build as many views as audiences need

[0.2.6] - 2026-02-16

Added

README for npm package page

Fixed

TypeScript error in metabase explore command (null check on database metadata)

[0.2.5] - 2026-02-15

Added

/bonnard-design-guide skill — 7 design principles for building semantic layers that work well for AI agents (question-first design, audience-centric views, filtered measures, descriptions as discovery API, natural language testing, iteration)
Design principles summary inlined in project rules (always loaded in agent context)

Changed

/bonnard-get-started skill — added filtered measure example, audience-centric view naming, navigational descriptions, natural language testing step
/bonnard-metabase-migrate skill — added filtered measure guidance from card WHERE clauses, audience-centric view examples, natural language verification step
Demo data reference updated — added dim_channel, return_quantity, return_amount to Contoso table descriptions

[0.2.4] - 2026-02-14

Added

Redshift as first-class warehouse type (bon datasource add --type redshift)
Redshift auto-detection from dbt profiles and environment variables

Changed

bon deploy now always syncs all local datasources to remote (upsert), replacing the interactive push flow
Datasource API endpoint changed from insert to upsert (stale remote configs are updated automatically)
Removed --push-datasources flag from bon deploy (no longer needed)

[0.2.3] - 2026-02-14

Removed

bon datasource test and bon datasource push CLI commands — bon deploy handles both automatically

Changed

Agent skill templates now show non-interactive bon datasource add flags (avoids interactive prompt timeouts)
Removed stale "test connection" hints from bon datasource add output

[0.2.2] - 2026-02-13

Added

bon metabase connect — configure Metabase API connection
bon metabase explore — browse databases, collections, cards, dashboards, tables
bon metabase analyze — generate analysis report for semantic layer planning
Metabase migration agent skill (/bonnard-metabase-migrate) for Claude, Cursor, and Codex
Analysis report now includes "How to Use This Report" guidance section

Changed

Shared agent template (bonnard.md) now lists metabase commands and links to migration skill

[0.2.1] - 2026-02-13

Changed

Replaced @cubejs-backend/schema-compiler (79 MB) with lightweight Zod v4 validator (~60 KB)
bon validate now provides field-level error messages with file context
Identifier validation (cube/measure/dimension names must match [_a-zA-Z][_a-zA-Z0-9]*)
Refresh key interval validation (every must match pattern like 1 hour, 30 minutes)

Added

Unit and integration tests for YAML schema validation

[0.2.0] - 2026-02-13

Added

bon deployments — list deployment history (--all for full history)
bon diff <id> — view changes in a deployment (--breaking for breaking only)
bon annotate <id> — add notes and context to deployment changes
bon deploy now requires -m "message" and detects changes vs previous deployment
Deploy output shows added, modified, removed, and breaking changes

Changed

Agent templates updated with deployment versioning, change tracking, and best practices
bon validate improved with better error detail and field-level validation

Fixed

CLI login now works for first-time users without existing org
bon docs topic resolution improvements

[0.1.13] - 2026-02-09

Fixed

bon docs --search demo now finds getting-started guide (was only searching modeling topics)
bon docs getting-started now works as a topic

[0.1.12] - 2026-02-09

Changed

Agent skills and getting-started guide now use Contoso demo data examples throughout (sales cube, not generic orders)
Phase 2 (Explore) now instructs agents to discover schema before creating cubes
Fixed bon query syntax in getting-started docs (was using non-existent --measures flag)

[0.1.11] - 2026-02-08

Added

bon datasource add --demo — adds a read-only Contoso retail dataset for testing without a warehouse
Demo data references in getting-started guide, agent skills (Claude/Cursor), and shared bonnard.md template

[0.1.10] - 2026-02-07

Changed

Replaced multiple agent skills with single bonnard-get-started walkthrough for Claude, Cursor, and Codex
Security hardening: input validation, auth fixes

Fixed

Removed workspace:* dependency that broke npm installs

[0.1.9] - 2026-02-05

Added

Embedded documentation via bon docs — browse cubes, views, measures, dimensions, joins
bon docs --search for keyword search across topics
bon docs schema for JSON schema output
bon init detects dbt projects and configures agent context accordingly

[0.1.8] - 2026-02-03

Added

bon mcp and bon mcp test commands for MCP server setup and connectivity testing
MCP token persistence in .bon/

[0.1.7] - 2026-02-02

Added

bon whoami with --verify flag
Codex agent support in bon init

[0.1.6] - 2026-02-01

Added

bon datasource push — sync local datasources to Bonnard server
bon query — query deployed semantic layer (JSON and SQL formats)

[0.1.5] - 2026-01-31

Added

bon datasource test — test warehouse connectivity
bon datasource list and bon datasource remove

[0.1.4] - 2026-01-30

Added

bon datasource add — interactive and non-interactive modes
bon datasource add --from-dbt — import from dbt profiles.yml
bon validate and bon deploy commands

[0.1.0] - 2026-01-27

Added

Initial release: bon init, bon login, bon logout
Project scaffolding with cubes/, views/, .bon/ structure
Agent template generation (Claude, Cursor)