v0.4.0

v0.4.0 — 2026-05-22

This release expands query-building and execution workflows, improves agent-friendly help output, and hardens URL handling, timeout behavior, and query validation across the CLI.

⚠️ Breaking Changes

• Renamed the query polling timeout flag to --result-timeout to avoid conflict with the global HTTP --timeout flag. Scripts using the old polling --timeout flag should migrate to --result-timeout. (2ac8379, b448855)

🚀 Features & Enhancements

• Added create-query ordering controls, including limit, order, and having flags with local validation. Fixes #15. (2e9b305)
• Added run-query, a one-step command that builds a query, executes it, polls for completion, and prints query result JSON. Fixes #16. (5ec2b4a)
• Added raw Honeycomb query JSON input from files or stdin for create-query and run-query, while preserving unknown query fields. Fixes #17. (c165092)
• Added automatic scalar type inference for query filter values, supporting JSON numbers and booleans while preserving strings where appropriate. Fixes #18. (6d0f50f)
• Improved command help output with required flag markers, examples across command help pages, and clearer global/local flag handling. (2ac8379)

🐛 Bug Fixes

• Escaped API resource URL path segments and encoded query parameters to correctly handle reserved characters in identifiers. (e876d53)
• Escaped trace UI URL components for datasets, environments, teams, and trace IDs with reserved characters. (723c809)
• Applied the documented default HTTP client timeout when callers pass zero timeout. (855fe49)
• Kept HTTP timeout handling global so command-local polling flags no longer shadow HONEYCOMB_TIMEOUT. (b448855)
• Validated raw query JSON before resolving auth, so local usage errors surface even without configured credentials. (f1cf4d2)
• Rejected negative plain-integer time ranges consistently with unit-suffixed durations. (8b05f63)
• Handled repeated whitespace in filter flags while preserving values containing spaces. (2db2660)
• Omitted empty calculate_op fields from column-based having clauses. (9b4e7c9)
• Returned JSON from delete commands to preserve the documented machine-readable output contract. (2ac8379)

📖 Documentation

• Documented top-N and slowest-query examples for query creation. (2e9b305)
• Documented run-query usage. (5ec2b4a)
• Documented raw query JSON input for files and stdin. (c165092)
• Documented query filter type inference behavior. (6d0f50f)

📦 Dependency updates

• No dependency updates in this release.

v0.3.0

Changelog

• 0c886a5 add Honeycomb auth profiles
• 95ffa7a add version flag to hccli
• 80097fd standardize make targets and agent docs
• d8f6ea6 target go 1.26.1

v0.2.0

Changelog

• 63323bb Add get-trace command to build Honeycomb UI trace URL
• be832a2 Show helpful warning on stderr when query returns empty results
• d0d74a9 Support multiple --breakdown flags in create-query
• a25e630 Support multiple filter conditions in queries (#2)
• e5887df Write large output to temp file with actionable guidance on stderr
• c55fd42 feat: support human-friendly time range formats
• b3535fc fix: update goreleaser config to use formats instead of deprecated format

v0.1.0

Changelog

• f888d5a Add --panels-json flag to update-board for panel add/remove workflows
• 9cc32d0 Add Columns API support (list, get, create, update, delete)
• 3179aea Add GET /2/auth endpoint (auth-v2 command)
• 8f99a12 Add README with Certified Shovelware badge
• c53231d Add boards API: list, create, and delete boards
• cad4cf3 Add calculated fields (derived columns) API support
• d272786 Add create-board-view command
• 4ea50e5 Add dataset CRUD operations and fix noctx lint issues
• 07bc0cc Add formatting and linting setup
• 7af81bd Add get-board command to fetch a single board by ID
• 258359a Add list, get, update, and delete operations for query annotations
• e8f6577 Add marker settings API: list, create, update, delete
• 2a3b391 Add markers API: list, create, update, delete
• 1d50dd5 Add missing board view API endpoints: list, get, update, delete
• 0c5d14c Add queries API: create-query and get-query commands with smoke tests
• 6979127 Add query results: execute queries and retrieve data
• 92b6a40 Add update-board, create-query-annotation commands and query panel support
• ce1b64a Document all features in help text
• 00cb0fe Format main.go alignment and add auth smoke test
• 2ce3aa6 Initial commit: hccli project with urfave/cli v3
• 864542b Move tests to dedicated directory
• f1beb9c Refactor CLI commands into separate files
• 6e85fce Refactor tests to invoke CLI binary as subprocess
• ad2a340 Update README with install options and authentication section
• 35925af add GoReleaser config and release workflow
• 484aa3e add SLO CRUD commands
• 44043e0 add burn alert CRUD commands
• e3b050a add default HTTP timeout and --api-url flag
• 1336d27 create-query: support multiple calculations
• 2ee5b0d feat: implement auth command with API client
• ee5aed9 fix: add missing os import in datasets_cli_test.go
• 824ba51 fix: restrict test target to tests/ directory
• 5533ffe harden query result polling loop
• 291e68a refactor(cmd/shared): add IDFlag and DatasetFlag helpers
• 15cee26 refactor: extract generic CRUD helpers to reduce API duplication
• 3ebb2ae require --alert-type on update-burn-alert
• 3eb01e5 stream-decode responses instead of buffering
• 6e62950 tests: skip dataset CRUD test by default