Summary

Replace the generic red ERR indicator on provider limit gauges and provider cards with category-specific labels, colors, and icons so users can diagnose token/auth issues at a glance without leaving the dashboard.

Changes

• Add src/utils/error-category.ts with ProviderErrorCategory type, classifyProviderError() string classifier, and getErrorCategoryDisplay() shared display helper
• Update LimitGauge.tsx to render category-specific error states: AUTH (yellow, ⚷ icon), RATE (yellow, ⧗), TIME (yellow, ⧗), CRED (yellow), NET (red), ERR (red, fallback)
• Update ProviderCard.tsx (Providers page) with the same category-aware treatment — status icon, status color, and error body all reflect the error category
• Update ProviderLimitsPanel.tsx to pass errorCategory through to LimitGauge in all 3 layout modes (compact, normal, wide)
• Update RealTimeDashboard.tsx to compute errorCategory via the classifier and pass it to the limits panel
• Add 13 test cases (46 assertions) in src/utils/__tests__/error-category.test.ts covering real error strings from all 11 provider plugins

Type

• feat — New feature
• fix — Bug fix
• refactor — Code change that neither fixes a bug nor adds a feature
• docs — Documentation only
• chore — Build, deps, CI, or tooling
• test — Adding or updating tests

Related issues

Closes #29

Testing

• bun test passes (109 tests, 0 failures)
• bun run typecheck passes (0 errors)
• Manual verification (describe below)

Error classification is tested against real error strings from all 11 provider plugins (Anthropic, OpenAI, Gemini, GitHub Copilot, Perplexity, Codex, Antigravity, Z.ai, MiniMax, Chutes, OpenCode Zen). Visual verification requires running with an expired/invalid token to trigger the new indicators.

Screenshots / captures

No captures yet — visual changes are best verified by running ttop with an expired OAuth token or invalid API key. The before/after:

Before (all errors identical):

✗ Anthropic   ────────── ERR    (red)
✗ OpenAI      ────────── ERR    (red)
✗ Perplexity  ────────── ERR    (red)

After (category-specific):

⚷ Anthropic   ────────── AUTH   (yellow — re-auth needed)
✗ OpenAI      ────────── ERR    (red — generic error)
⧗ Perplexity  ────────── RATE   (yellow — transient, will resolve)