Skip to content

feat(cli): add SQL preview and job status commands - #127

Draft
rtiman-spotify wants to merge 3 commits into
spotify:mainfrom
rtiman-spotify:cli-sql-jobs
Draft

rtiman-spotify wants to merge 3 commits into
spotify:mainfrom
rtiman-spotify:cli-sql-jobs

Conversation

@rtiman-spotify

Copy link
Copy Markdown

Summary

Adds data sql preview/status with direct regional Metrics HTTP APIs, JSON query input, immediate job references and optional bounded --wait polling. Handles pending/running/retry-pending/throttled jobs and terminal failure/cancellation; preserves job references when waiting fails. Inspecting a failed job is a successful status read.

Dependency

Depends on #122. The fork branch shares the exact foundation commits; its main-targeted diff includes them until the foundation lands. Kept draft; do not merge out of order. The separate schema PR builds on this one.

Safety

Explicit preview starts a query and may incur warehouse costs. Never replays a preview or automatically cancels its remote job. Transport/5xx/malformed-success creation responses report an unknown outcome. Dry-run validates locally before authentication and performs no HTTP calls, writes or telemetry. This is not physical discovery or an onboarding run.

Verification

Node 24, pnpm build and full pnpm qa passed after current-main auth integration. MSW command tests cover job lifecycle, bounded polling/timeouts, malformed/lost responses, local validation and auth-free dry-run. Existing E2E regression runs in CI; no live warehouse/API compatibility claim.

Checklist

  • Local build/typecheck/lint/unit tests passed
  • CLI documentation and examples updated
  • New behavior/regression tests added
  • TUI screenshots (not applicable)

Related: https://spotify.atlassian.net/browse/SLMD-1921.

rtiman-spotify and others added 3 commits October 19, 2026 15:30
Co-Authored-By: Xirp Agent (gpt-6.1-sol) <xirp-agent@users.noreply.ghe.spotify.net>
Co-Authored-By: Xirp Agent (gpt-6.1-sol) <xirp-agent@users.noreply.ghe.spotify.net>
Co-Authored-By: Xirp Agent (gpt-6.1-sol) <xirp-agent@users.noreply.ghe.spotify.net>
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