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.