Skip to content

feat: add versioned structured client output - #103

Merged
catay merged 1 commit into
mainfrom
feat/versioned-structured-output
Apr 5, 2026
Merged

feat: add versioned structured client output#103
catay merged 1 commit into
mainfrom
feat/versioned-structured-output

Conversation

@catay

@catay catay commented Apr 5, 2026

Copy link
Copy Markdown
Owner

Summary

  • add --format-version to client structured output
  • preserve legacy behavior in format version 1 for single-target and batch runs
  • add format version 2 for json/yaml with a stable envelope using status, summary, results, and tls_status
  • extend format version 2 to csv/csv-full with inline batch failures and status/tls_status/error columns
  • add config support and documentation for format-version

Testing

  • make test
  • make

Introduce --format-version for client structured output.

Version 1 preserves the legacy output shapes and behavior for
single-target and batch runs.

Version 2 adds a stable schema for structured output:
- json/yaml use a top-level envelope with status, summary, and results
- csv/csv-full include batch failures inline with status, tls_status, and error columns
- status represents query execution status
- tls_status represents TLS health for successful results

This keeps backward compatibility for existing consumers while
providing a clearer, versioned format for automation.
@catay
catay merged commit 9b59244 into main Apr 5, 2026
7 checks passed
@catay
catay deleted the feat/versioned-structured-output branch April 5, 2026 22:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant