Promote test → main: songstats backfill backoff (#673) + measurement-jobs card gate (#671)

[sweetmantech]

Promotes test to main. Contents:

• fix(songstats-backfill): backoff on 429 + defer instead of churn (chat#1797 — pacing/backoff + logging) #673 — Songstats backfill: bounded exponential backoff on 429 + defer-to-pending past the bound (claimed-batch release), per-step/per-batch logging (chat#1797 bullets 1 & 3).
• feat(measurement-jobs): free-tier card gate (setup mode) + instant backfill drain (chat#1796) #671 — measurement-jobs free-tier card gate (Stripe setup mode) + instant backfill drain.

main has no commits test lacks — clean promotion.

---

Summary by cubic

Promotes test → main with a smarter Songstats backfill that backs off and defers under rate limits, plus a free‑tier card gate with instant backfill start for measurement jobs. This reduces API churn and speeds up time to first data.

• New Features
  • Songstats backfill: bounded exponential backoff on 408/429/502/503/504. When retries are exhausted, set the row to pending without spending quota, stop the batch, and release remaining claimed rows.
  • Clear status handling: 200 writes history and records one hit; 404/other terminal 4xx mark done and record a hit.
  • Measurement jobs: free‑tier card gate using Stripe Checkout mode: "setup" (collect card, no subscription) and auto‑start of the backfill drain after enqueue.

^{Written for commit 5fa5e3a. Summary will update on new commits.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api	Building	Preview	Jun 16, 2026 9:42pm

[coderabbitai]

Warning

Review limit reached

@sweetmantech, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 39 minutes and 7 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 5577e435-5c1a-49c5-87e1-9e120cfed0fd

📥 Commits

Reviewing files that changed from the base of the PR and between e10217e and 5fa5e3a.

⛔ Files ignored due to path filters (5)

• app/workflows/__tests__/backfillTrackStep.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by app/**
• app/workflows/__tests__/songstatsBackfillWorkflow.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by app/**
• lib/songstats/__tests__/fetchSongstatsWithBackoff.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/songstats/__tests__/isRetryableStatus.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**
• lib/supabase/songstats_backfill_queue/__tests__/updateSongstatsBackfillQueue.test.ts is excluded by !**/*.test.*, !**/__tests__/** and included by lib/**

📒 Files selected for processing (6)

• app/workflows/backfillTrackStep.ts
• app/workflows/releaseClaimedRowsStep.ts
• app/workflows/songstatsBackfillWorkflow.ts
• lib/songstats/fetchSongstatsWithBackoff.ts
• lib/songstats/isRetryableStatus.ts
• lib/supabase/songstats_backfill_queue/updateSongstatsBackfillQueue.ts

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch test

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}