feat(huey): Migrate Huey integration to spans-first tracing

[ericapisani]

Builds on a bug fix (PY-2426/ #6392 )

Migrates the Huey integration to support the new spans-first tracing lifecycle (trace_lifecycle: "stream"), while keeping full backwards compatibility with the existing transaction-based path.

Fixes PY-2331 and #6029

[linear-code]

PY-2331

[github-actions]

Codecov Results 📊

✅ 282 passed | Total: 282 | Pass Rate: 100% | Execution Time: 43.88s

📊 Comparison with Base Branch

Metric	Change
Total Tests	—
Passed Tests	—
Failed Tests	—
Skipped Tests	—

✨ No test changes detected

All tests are passing successfully.

❌ Patch coverage is 20.00%. Project has 15088 uncovered lines.
❌ Project coverage is 33.15%. Comparing base (base) to head (head).

Files with missing lines (2)

File	Patch %	Lines
utils.py	51.64%	⚠️ 456 Missing and 82 partials
huey.py	14.41%	⚠️ 95 Missing

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
- Coverage    34.93%    33.15%    -1.78%
==========================================
  Files          190       190         —
  Lines        22671     22569      -102
  Branches      7730      7692       -38
==========================================
+ Hits          7918      7481      -437
- Misses       14753     15088      +335
- Partials       832       745       -87

---

Generated by Codecov Action

[ericapisani]

bugbot run
@sentry review

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 97fb86c. Configure here.}

[cursor]

Subclass control-flow misclassified

Medium Severity

This commit adds Huey control-flow handling in should_be_treated_as_error via isinstance, but _capture_exception still gates on exc_info[0] in HUEY_CONTROL_FLOW_EXCEPTIONS. Subclasses of RetryTask, CancelExecution, or TaskLockedException skip that branch, so span streaming can mark segments error and emit Sentry error events for normal Huey retries or cancellations.

 

^{Reviewed by Cursor Bugbot for commit 97fb86c. Configure here.}