feat: add tusk drift query CLI commands for span querying

[sohankshirsagar]

Summary

Adds 6 new CLI commands under tusk drift query that expose the same span querying capabilities as the https://github.com/Use-Tusk/drift-mcp, allowing users to search, analyze, and debug recorded API traffic directly from
the CLI. This enables a skill-driven workflow where users can install the skill (will be available on https://github.com/Use-Tusk/tusk-skills shortly after this pr is merged) instead of configuring an MCP server.

Changes

• internal/driftquery/types.go — Go structs for filter types (StringFilter, NumberFilter, BooleanFilter, SpanWhereClause, JsonbFilter) and 6 tool input types, matching the MCP's types.ts
  with camelCase JSON tags
• internal/api/drift_query.go — 6 new TuskClient methods (QueryDriftSpans, GetDriftSchema, ListDriftDistinctValues, AggregateDriftSpans, GetDriftTrace, GetDriftSpansByIds)
  using makeJSONRequestWithBody, returning json.RawMessage to avoid maintaining response structs
• cmd/drift_query.go — Parent tusk drift query command + shared helpers: setupDriftQueryCloud, resolveQueryServiceID (flag > TUSK_DRIFT_SERVICE_ID env > config),
  buildWhereFromFlags, JSON parsing helpers, splitComma
• cmd/drift_query_spans.go — Search spans with convenience flags (--name, --package-name, --trace-id, --min-duration, etc.) and advanced JSON flags (--where, --jsonb-filters)
• cmd/drift_query_distinct.go — List unique field values (--field required)
• cmd/drift_query_aggregate.go — Aggregate metrics (--metrics required, --group-by, --time-bucket)
• cmd/drift_query_trace.go — Get full trace tree by trace ID (positional arg)
• cmd/drift_query_schema.go — Get schema info and example payloads
• cmd/drift_query_spans_by_ids.go — Fetch spans by ID (--ids required)

Design decisions

• json.RawMessage for responses — Commands print backend JSON directly via printJSON rather than parsing into typed Go structs. This avoids duplicated maintenance when backend response
  shapes change.
• Service ID resolution adds TUSK_DRIFT_SERVICE_ID env var support (new to CLI, matches MCP behavior) alongside --service-id flag and .tusk/config.yaml.
• Convenience flags + raw JSON — Simple filters use --name, --package-name etc. Complex nested filters (AND/OR, JSONB paths) use --where and --jsonb-filters as JSON strings, which is fine since the primary consumer is an AI agent via the skill.

[cubic-dev-ai]

1 issue found across 9 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="cmd/drift_query_aggregate.go">

<violation number="1" location="cmd/drift_query_aggregate.go:40">
P2: `--limit` is documented as 1-100 but is never validated before sending the API request.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.}