SHIP-READY — FAIRLINE: Odds API quota guardrails + last-known-good cache

Date: 2026-02-24

Problem

When The Odds API returns OUT_OF_USAGE_CREDITS, /events looked broken (0 games, 0 edges) even though the key was present.

Outcome

Shipped guardrails so FAIRLINE becomes self-diagnosing and does not look dead during provider downtime:

• Detects quota exhaustion (OUT_OF_USAGE_CREDITS / “Usage quota has been reached”).
• Shows a clear QUOTA banner with the fix path.
• Disables “Run Scan” when quota is reached (prevents repeated failing calls).
• Loads and displays the last known-good scan (cached client-side) so the terminal remains usable.

Implementation

UI

• /events now classifies provider errors and shows a dedicated alert.
• Run Scan becomes ⛔ QUOTA and is disabled when quota is reached.
• Cached report stored as fairline:lastGoodReport (slimmed: rows capped) and hydrated on page load.

Files changed

• src/app/events/page.tsx
• src/app/events/fairline-cinematic.css

Git / Deploy

• Commit: 7bc6d08ded8ca4d73a1346ab455311956f97e8e3
• Deployed to Vercel production.
• Verified via diag:
  • https://fairline-app.vercel.app/api/diag/build

Operator note

This does not solve the underlying quota issue; it makes the system transparent + resilient until credits are restored.