feat: telemetry intelligence, UI overhaul, and provider fixes

Fixes: local-day bucketing for Claude analytics, single-number model
pricing (fable), stale-cache fallback on transient API failures, health
aliases, Gemini key via header, DeepSeek stringification, exclusive
MOONSHOT_API_BASE override.

UI: redesigned popout hero with progress ring and stat band, status
filter chips, animated cards with usage rings, indeterminate loading
bar, redesigned settings with health chips and section headers, daily
bar hover details, expand/collapse all, copy buttons on diagnostics.

Features: threshold desktop notifications, Claude 5h burn forecast and
monthly cost projection, persistent usage history with sparklines and
trend arrows, provider pinning, per-provider retry, console deep links,
top pill mode, weekly top Claude projects by session cwd.

Author: bernardopg

.gitignore

@@ -7,4 +7,4 @@
 
 .codex
 .claude
-
+CLAUDE.md

AiOverviewControlSettings.qml

@@ -2,7 +2,7 @@
 
 ## [Unreleased]
 
-## 1.3.0 - 2026-06-10
+## 1.3.0 - 2026-06-11
 
 ### Architecture
 - Removed the external aggregation executable and its settings, detection, dispatcher arguments, documentation, and diagnostics.
@@ -20,11 +20,45 @@
 - Added provider filtering when more than eight cards are visible.
 - Rebuilt settings around provider health, telemetry coverage, informational coverage, and plugin-managed diagnostics.
 - Removed obsolete source mode and external-binary path controls.
+- Redesigned the popout hero: animated circular progress gauge, status eyebrow with live pulse, badge row, and a stat band (active/attention/engine/last sync) replacing the metric tiles.
+- Added status filter chips (All/Live/Issues) with counts above the provider list; the name filter now appears from six providers.
+- Provider cards gained an animated expand/collapse, a usage ring around the provider icon, and a rotating chevron.
+- Added an indeterminate loading bar at the top of the popout while fetching.
+- Redesigned settings: gradient hero with icon tile, version pill, health summary chips, and a re-check health action; section headers with icons and dividers; provider chips animate on hover; selected providers show colored health status pills; diagnostics commands render in monospace.
+- Provider cards sort by usage (highest first) with failed providers at the end.
+- Claude daily bars show per-day tokens and cost on hover, with animated bar heights.
+- Added expand-all/collapse-all toggle next to the provider list header.
+- Bar pill entries gained a usage-colored status dot and percent, replacing flat text.
+- Diagnostics commands gained a one-click copy button (wl-copy) with confirmation feedback.
+
+### Features
+- Desktop notifications when a provider crosses a configurable usage threshold (75/85/95%), de-duplicated per reset window.
+- Claude 5h burn-rate forecast: warns "At this pace: 100% in Xm" when the window will be exhausted before reset.
+- Claude projected month cost tile based on average daily spend; turns red when projecting 1.5× current spend.
+- Usage history: the dispatcher records snapshots to `~/.cache/AiOverviewControl/usage-history.jsonl`; expanded cards render a sparkline via the new `get-usage-history` helper.
+- Trend arrows on cards (up/down vs the previous snapshot).
+- Pin providers (star) to keep them at the top of the list, persisted in settings.
+- "Open console" button on expanded cards deep-links to each provider's usage page.
+- Per-provider retry badge on failed cards re-fetches only that provider.
+- New "top" pill mode shows only the most critical provider in the bar.
+- Top Claude projects of the week (by real session `cwd`) with token bars, toggleable via the restored `showClaudeProjects` setting.
 
 ### Quality
 - Updated CI for the new dispatcher contract, health schema, and a regression check preventing the removed dependency from returning.
 - Rebuilt English, Brazilian Portuguese, and Simplified Chinese locale bundles with key parity.
 
+### Fixes
+- Claude analytics now bucket session timestamps by local day instead of UTC, fixing shifted daily bars and undercounted today cost/tokens in non-UTC timezones.
+- Claude pricing now matches single-number model versions (e.g. `claude-fable-5`), which previously priced whole families at $0; pricing cache is invalidated via a schema marker.
+- Claude quota falls back to the last good snapshot on transient API failures (429, 5xx, network) instead of erroring the card; auth failures still surface.
+- Claude card shows 5h/7d reset countdowns and an "Extra usage on" badge.
+- Provider health checks now recognize dispatcher aliases (`moonshot`, `zhipu`, `nim`, `vertex`, `ark`, `modelark`, `dashscope`, `alibaba`).
+- Gemini API key moved from the URL query string to the `x-goog-api-key` header so it no longer leaks via process listings.
+- DeepSeek balance fields are stringified defensively so numeric API responses cannot break JSON output.
+- `MOONSHOT_API_BASE` override is now exclusive: no silent fallback to the China host when an explicit base is set.
+- Messages without a timestamp are excluded from Claude weekly aggregation instead of being miscounted.
+- Removed the unused USD→EUR exchange-rate fetch and dead `costCurrency`/`showClaudeProjects` settings references.
+
 ## 1.2.4 - 2026-05-26
 
 ### Dashboard — UX

AiOverviewControlWidget.qml

@@ -24,7 +24,7 @@ Runtime: QML/Quickshell plus Bash helpers. Core dependencies: `bash`, `jq`, and
 
 ## Settings
 
-`refreshInterval`, `providerSelection`, `showErrorProviders`, `pillMode`, `pillProviders`, `densityMode`, `costCurrency`, `showClaudeProjects`, `languageOverride`.
+`refreshInterval`, `providerSelection`, `showErrorProviders`, `pillMode`, `pillProviders`, `densityMode`, `languageOverride`, `quotaNotifications`, `notifyThreshold`, `showClaudeProjects`, `pinnedProviders`.
 
 ## Validation
 

CHANGELOG.md

@@ -7,21 +7,31 @@
   "card.backend": "Backend",
   "card.claude_details": "Claude Code details",
   "card.claude_since": "Since {date} · {sessions} sessions · {messages} messages",
+  "card.collapse_all": "Collapse all",
   "card.credits": "Credits",
   "card.engine": "Engine",
+  "card.expand_all": "Expand all",
+  "card.extra_usage_on": "Extra usage on",
   "card.filter_providers": "Filter providers by name or source",
+  "card.history": "History",
   "card.login": "Login",
   "card.models_week": "Models this week",
   "card.month": "Month",
+  "card.open_console": "Open console",
+  "card.projected_month": "Projected month",
   "card.provider": "Provider",
   "card.provider_control": "Provider control",
   "card.provider_description": "Choose a provider managed by this plugin.",
   "card.providers": "Providers",
   "card.refresh": "Refresh",
+  "card.retry": "Retry",
   "card.today_cost": "Today cost",
   "card.today_tokens": "Today tokens",
+  "card.top_projects": "Top projects this week",
   "card.updated_at": "Updated {time}",
   "card.week": "Week",
+  "claude.burn_pace_exceed": "At this pace: 100% in {time}",
+  "claude.burn_pace_ok": "Usage on pace for this window",
   "error.claude_timeout": "Claude Code usage fetch timed out.",
   "error.claude_unavailable": "Claude Code usage details are unavailable. Check claude, jq, and curl.",
   "error.fetch_failed": "Failed to fetch usage from providers.",
@@ -30,30 +40,46 @@
   "error.helper_timeout": "Provider helper timed out while fetching usage data.",
   "error.parse_failed": "Failed to parse provider helper output.",
   "error.providers_need_attention": "{count} provider(s) need attention.",
+  "filter.all": "All",
+  "filter.issues": "Issues",
+  "filter.live": "Live",
+  "notify.body": "{window} window · resets in {time}",
+  "notify.title": "{provider} at {percent}%",
   "popout.details_stale": "Stale since {time} · local adapters",
   "popout.details_updated": "Updated {time} · local adapters",
+  "popout.last_sync": "Last sync",
   "popout.provider_dashboard": "Provider dashboard",
   "settings.active_count": "{count} active",
   "settings.configured_count": "{count} configured",
+  "settings.copy_command": "Copy command",
   "settings.current_selection": "Current selection",
   "settings.density.description": "Comfortable keeps full previews. Compact reduces card height and visual detail.",
   "settings.density.label": "Dashboard density",
   "settings.diagnostics": "Diagnostics and tests",
   "settings.diagnostics_desc": "Commands for validating the plugin-managed pipeline.",
+  "settings.health.missing_count": "{count} missing",
   "settings.health.pending": "Not checked",
   "settings.health.ready": "Ready",
+  "settings.health.ready_count": "{count} ready",
+  "settings.health.recheck": "Re-check health",
   "settings.hero.self_managed": "Provider collection, health checks, refresh policy and rendering are managed by this plugin. No external aggregation tool is required.",
   "settings.informational_providers": "Informational providers",
   "settings.informational_providers_desc": "These providers expose no public read-only quota API. Their cards point to the official usage surface.",
   "settings.language.description": "UI language for this plugin. Auto follows system locale.",
   "settings.language.label": "Language",
+  "settings.notify.description": "Send a desktop notification when a provider crosses the threshold.",
+  "settings.notify.label": "Quota notifications",
+  "settings.notify.threshold": "Notification threshold",
+  "settings.notify.threshold_desc": "Usage percent that triggers a notification.",
   "settings.pill_mode.description": "Auto shows providers with measurable usage. Custom uses the configured list.",
   "settings.pill_mode.label": "Pill mode",
   "settings.refresh_description": "How often the plugin queries selected local adapters and provider APIs.",
   "settings.refresh_interval": "Refresh interval",
   "settings.section.interface": "Interface",
   "settings.show_errors": "Show providers with errors",
   "settings.show_errors_desc": "Keep authentication and configuration failures visible in the dashboard.",
+  "settings.show_projects": "Show Claude projects",
+  "settings.show_projects_desc": "List the week's top projects inside the Claude card.",
   "settings.telemetry_providers": "Telemetry providers",
   "settings.telemetry_providers_desc": "Adapters backed by official CLIs, documented APIs, or local usage stores.",
   "settings.test_backend": "Test selected providers",

CLAUDE.md

@@ -7,21 +7,31 @@
   "card.backend": "Backend",
   "card.claude_details": "Detalhes do Claude Code",
   "card.claude_since": "Desde {date} · {sessions} sessões · {messages} mensagens",
+  "card.collapse_all": "Recolher tudo",
   "card.credits": "Créditos",
   "card.engine": "Motor",
+  "card.expand_all": "Expandir tudo",
+  "card.extra_usage_on": "Uso extra ativo",
   "card.filter_providers": "Filtrar provedores por nome ou fonte",
+  "card.history": "Histórico",
   "card.login": "Login",
   "card.models_week": "Modelos nesta semana",
   "card.month": "Mês",
+  "card.open_console": "Abrir console",
+  "card.projected_month": "Projeção do mês",
   "card.provider": "Provedor",
   "card.provider_control": "Gerenciar provedores",
   "card.provider_description": "Escolha um provedor administrado por este plugin.",
   "card.providers": "Provedores",
   "card.refresh": "Atualizar",
+  "card.retry": "Tentar de novo",
   "card.today_cost": "Custo hoje",
   "card.today_tokens": "Tokens hoje",
+  "card.top_projects": "Top projetos da semana",
   "card.updated_at": "Atualizado às {time}",
   "card.week": "Semana",
+  "claude.burn_pace_exceed": "Neste ritmo: 100% em {time}",
+  "claude.burn_pace_ok": "Uso dentro do ritmo da janela",
   "error.claude_timeout": "A coleta de uso do Claude Code excedeu o tempo limite.",
   "error.claude_unavailable": "Os detalhes de uso do Claude Code estão indisponíveis. Verifique claude, jq e curl.",
   "error.fetch_failed": "Falha ao coletar uso dos provedores.",
@@ -30,30 +40,46 @@
   "error.helper_timeout": "O helper excedeu o tempo limite durante a coleta.",
   "error.parse_failed": "Falha ao interpretar a saída do helper.",
   "error.providers_need_attention": "{count} provedor(es) precisam de atenção.",
+  "filter.all": "Todos",
+  "filter.issues": "Problemas",
+  "filter.live": "Ativos",
+  "notify.body": "Janela {window} · reseta em {time}",
+  "notify.title": "{provider} em {percent}%",
   "popout.details_stale": "Desatualizado desde {time} · adaptadores locais",
   "popout.details_updated": "Atualizado às {time} · adaptadores locais",
+  "popout.last_sync": "Última sincronização",
   "popout.provider_dashboard": "Painel de provedores",
   "settings.active_count": "{count} ativos",
   "settings.configured_count": "{count} configurados",
+  "settings.copy_command": "Copiar comando",
   "settings.current_selection": "Seleção atual",
   "settings.density.description": "Confortável mantém prévias completas. Compacta reduz altura e detalhes visuais.",
   "settings.density.label": "Densidade do painel",
   "settings.diagnostics": "Diagnósticos e testes",
   "settings.diagnostics_desc": "Comandos para validar o pipeline administrado pelo plugin.",
+  "settings.health.missing_count": "{count} pendentes",
   "settings.health.pending": "Não verificado",
   "settings.health.ready": "Pronto",
+  "settings.health.ready_count": "{count} prontos",
+  "settings.health.recheck": "Reverificar saúde",
   "settings.hero.self_managed": "A coleta, a saúde, a atualização e a renderização dos provedores são administradas por este plugin. Nenhum agregador externo é necessário.",
   "settings.informational_providers": "Provedores informativos",
   "settings.informational_providers_desc": "Estes provedores não expõem API pública somente leitura para cotas. Os cartões apontam para a tela oficial de uso.",
   "settings.language.description": "Idioma da interface deste plugin. Automático segue o idioma do sistema.",
   "settings.language.label": "Idioma",
+  "settings.notify.description": "Envia notificação na área de trabalho quando um provider cruza o limiar.",
+  "settings.notify.label": "Notificações de quota",
+  "settings.notify.threshold": "Limiar de notificação",
+  "settings.notify.threshold_desc": "Percentual de uso que dispara a notificação.",
   "settings.pill_mode.description": "Automático mostra provedores com uso mensurável. Personalizado usa a lista configurada.",
   "settings.pill_mode.label": "Modo do indicador",
   "settings.refresh_description": "Frequência de consulta aos adaptadores locais e APIs selecionadas.",
   "settings.refresh_interval": "Intervalo de atualização",
   "settings.section.interface": "Interface",
   "settings.show_errors": "Mostrar provedores com erro",
   "settings.show_errors_desc": "Mantém falhas de autenticação e configuração visíveis no painel.",
+  "settings.show_projects": "Mostrar projetos do Claude",
+  "settings.show_projects_desc": "Lista os principais projetos da semana no card do Claude.",
   "settings.telemetry_providers": "Provedores com telemetria",
   "settings.telemetry_providers_desc": "Adaptadores baseados em CLIs oficiais, APIs documentadas ou armazenamento local de uso.",
   "settings.test_backend": "Testar provedores selecionados",

i18n/en.json

@@ -7,21 +7,31 @@
   "card.backend": "后端",
   "card.claude_details": "Claude Code 详情",
   "card.claude_since": "自 {date} · {sessions} 个会话 · {messages} 条消息",
+  "card.collapse_all": "全部收起",
   "card.credits": "额度",
   "card.engine": "引擎",
+  "card.expand_all": "全部展开",
+  "card.extra_usage_on": "已启用额外用量",
   "card.filter_providers": "按名称或来源筛选提供商",
+  "card.history": "历史",
   "card.login": "登录",
   "card.models_week": "本周模型",
   "card.month": "本月",
+  "card.open_console": "打开控制台",
+  "card.projected_month": "本月预测",
   "card.provider": "提供商",
   "card.provider_control": "管理提供商",
   "card.provider_description": "选择由此插件管理的提供商。",
   "card.providers": "提供商",
   "card.refresh": "刷新",
+  "card.retry": "重试",
   "card.today_cost": "今日费用",
   "card.today_tokens": "今日令牌",
+  "card.top_projects": "本周项目排行",
   "card.updated_at": "更新于 {time}",
   "card.week": "本周",
+  "claude.burn_pace_exceed": "按此速度：{time} 后达到 100%",
+  "claude.burn_pace_ok": "本窗口用量正常",
   "error.claude_timeout": "Claude Code 用量获取超时。",
   "error.claude_unavailable": "Claude Code 用量详情不可用。请检查 claude、jq 和 curl。",
   "error.fetch_failed": "获取提供商用量失败。",
@@ -30,30 +40,46 @@
   "error.helper_timeout": "获取用量时提供商助手超时。",
   "error.parse_failed": "无法解析提供商助手输出。",
   "error.providers_need_attention": "{count} 个提供商需要注意。",
+  "filter.all": "全部",
+  "filter.issues": "异常",
+  "filter.live": "正常",
+  "notify.body": "{window} 窗口 · {time} 后重置",
+  "notify.title": "{provider} 已达 {percent}%",
   "popout.details_stale": "自 {time} 起已过期 · 本地适配器",
   "popout.details_updated": "更新于 {time} · 本地适配器",
+  "popout.last_sync": "上次同步",
   "popout.provider_dashboard": "提供商仪表板",
   "settings.active_count": "{count} 个已启用",
   "settings.configured_count": "{count} 个已配置",
+  "settings.copy_command": "复制命令",
   "settings.current_selection": "当前选择",
   "settings.density.description": "舒适模式保留完整预览；紧凑模式减少卡片高度和视觉细节。",
   "settings.density.label": "仪表板密度",
   "settings.diagnostics": "诊断和测试",
   "settings.diagnostics_desc": "验证插件管理管线的命令。",
+  "settings.health.missing_count": "{count} 个缺失",
   "settings.health.pending": "未检查",
   "settings.health.ready": "就绪",
+  "settings.health.ready_count": "{count} 个就绪",
+  "settings.health.recheck": "重新检查健康",
   "settings.hero.self_managed": "提供商采集、健康检查、刷新策略和渲染均由此插件管理，无需外部聚合工具。",
   "settings.informational_providers": "信息型提供商",
   "settings.informational_providers_desc": "这些提供商没有公开的只读配额 API，卡片会指向官方用量页面。",
   "settings.language.description": "此插件的界面语言。自动模式跟随系统区域设置。",
   "settings.language.label": "语言",
+  "settings.notify.description": "当服务商超过阈值时发送桌面通知。",
+  "settings.notify.label": "配额通知",
+  "settings.notify.threshold": "通知阈值",
+  "settings.notify.threshold_desc": "触发通知的使用百分比。",
   "settings.pill_mode.description": "自动显示有可测用量的提供商；自定义使用配置列表。",
   "settings.pill_mode.label": "栏指示器模式",
   "settings.refresh_description": "插件查询所选本地适配器和提供商 API 的频率。",
   "settings.refresh_interval": "刷新间隔",
   "settings.section.interface": "界面",
   "settings.show_errors": "显示错误提供商",
   "settings.show_errors_desc": "在仪表板中保留身份验证和配置失败。",
+  "settings.show_projects": "显示 Claude 项目",
+  "settings.show_projects_desc": "在 Claude 卡片中列出本周项目排行。",
   "settings.telemetry_providers": "遥测提供商",
   "settings.telemetry_providers_desc": "由官方 CLI、文档化 API 或本地用量存储支持的适配器。",
   "settings.test_backend": "测试所选提供商",