Sign up
View stargazers0Sign up
Commits

TODO.md

TODO

Parity baseline: docs/research/2026-09-01-macos-parity-0.56.2.md, pinned to upstream v0.56.2 and probed with the checksum-verified official Linux CLI 0.56.2 release asset. The audit compared the verified v0.55.0 and v0.56.2 binaries in isolated accounts. The provider catalog and the config providers, usage, and sessions contracts remain compatible. The cost command now supports Antigravity token-only local history. The audit did not install or replace a host CLI.

  • Provider-specific editable settings: the Providers page renders generic fields/actions from docs/cli-provider-settings-descriptor.md without provider-specific QML branches. Declared coverage includes source mode, API key, cookie source/manual cookie, enterprise/base URL, workspace/project ID, region, AWS profile/auth mode, and boolean extras. That descriptor is still a proposal: on CLI 0.56.2 config providers --descriptors returns Unknown option --descriptors and the plain payload carries no descriptor key, so the whole path is dormant and the page degrades to enable/disable, set-api-key and docs/dashboard/login links. Keep that fallback working. Missing controls once the CLI ships the contract include token-account add/edit/remove, provider-specific auth mode nuances, organization/team editors, provider metric pickers, and quota thresholds. Do not duplicate macOS Swift provider settings logic in QML; extend codexbar config first. IBM Bob can use the existing single-key command, but its token-account editing still needs generic CLI field/actions. Fireworks 0.54.0 and later auto-discovers its account slug from the API key. Plasma enables the generic single-key setup path only when the selected CLI reports 0.54.0 or later; multi-account slug editing still needs generic CLI field/actions.
  • Provider onboarding parity: descriptor-backed dashboard actions are supported, and legacy login/account/dashboard/docs links remain as fallbacks. Add safer setup actions for providers that need browser-cookie import, local app files, OAuth/device-flow handoff, CLI-auth setup, or token-account workflows when the CLI can describe and execute those actions in JSON.
  • Dashboard extras: the widget now surfaces the generic CodexBar 0.48.1 usage.details rows and bounded bar/line charts, with legacy KPI/summary payloads retained as a compatibility fallback. Add richer sections only when the CLI extends that stable presentation contract. Missing examples include billing summaries, usage breakdowns, credits history, and richer provider-specific model/request/token sections.
  • Credits allowance: the generic usage.credits balance uses remaining, updatedAt, and events and still has no generic allowance or plan total, so it stays a line without a meter. The optional Codex-only credits.codexCreditLimit record carries a real used amount, limit, remaining amount, percentage, and reset metadata; v0.54.1 made it reliable for Business and Enterprise accounts. Plasma now validates that nested record and shows its monthly meter, amounts, and reset time. Its denominator never applies to a plain credit balance.
  • Cost history plots either cost or tokens through costHistoryMetric; the selector drives the range chart, the heatmap, and the per-provider bars from one cost payload, so it must never add a CLI call. historyCoverageIsEstablished drives the "still collecting" note; a missing flag means established.
  • Cost truthfulness: CLI 0.56.2 retains the coverage counters and provenance normalized behind a bounded trust boundary. Provider and global cost amounts are qualified as estimated, partial, or approximate, and share one semantic notice decision; older payloads remain quiet. Project breakdown inputs remain future work: a Projects view must discard the emitted local path and retain only bounded display fields. Antigravity now emits token-only history through the same generic cost envelope. It normally omits dollar amounts, but CLI 0.56.2 uses zero as the established-empty sentinel even though its renderer says costs are unavailable. normalizeCostDaily and normalizeCostModels preserve absent costs; normalizeProviderCostTotals masks that provider sentinel until the CLI exposes explicit cost availability. Token charts render while cost totals and cost-mode charts remain unavailable.
  • Quota warning thresholds are configurable through quotaWarningPercent and quotaCriticalPercent, bounded by contents/ui/QuotaThresholds.js, and drive both the notification level and the usage-bar markers. Per-provider thresholds stay blocked on the CLI descriptor. Do not reintroduce literal percentages at a call site; limitResetArmThreshold is a separate reset-detection knob and is deliberately not tied to the warning step. Changing a threshold resets the threshold-derived notification memo but keeps the provider status baseline: a settings change is not a status transition. That decision lives in contents/ui/NotificationMemo.js and is covered by tests/tst_notification_memo.qml; keep it there rather than reinlining it in main.qml.
  • Local Agent Sessions are consumed through codexbar sessions --json-v2 in a bounded, refreshable global tab. Only safe display fields are normalized; cwd, transcriptPath, IDs, and PIDs are neither retained nor rendered. Remote/SSH host focus stays macOS-only.
  • Existing detail and cost charts now support hover, click selection, and keyboard inspection. The global Usage & Spend tab adds 7/30/90-day cost ranges and a bounded activity heatmap. CodexBar 0.55.0 Kiro overage data, z.ai BigModel CN balance, and Cursor Grok Bot usage already fit the generic detail, provider-cost, and extra-window paths, so they need only a CLI upgrade. Antigravity local token history now comes from Linux cost; it is not priced spend, so Plasma keeps its token charts separate from unavailable dollar amounts. Cursor local or dashboard cost remains blocked because the Linux command still rejects Cursor. Grok period-only responses no longer become a false 0%, but an explicit unknown-usage row with reset data needs a generic CLI window representation. Credits history, plan-utilization history, and session-equivalent forecasts still need stable CLI history payloads; do not infer history from one snapshot.
  • Panel element composition now has a persisted, sanitized order for identity, status, usage text, and provider meters. Visibility remains controlled by the existing Plasma-native display settings. The runOut display mode shows the predicted duration only while the CLI pace forecast reports exhaustion before the reset; keep it tied to paceWarningActive instead of the percent used. The macOS weekly reserve token remains open. CLI 0.54.0 also adds conditional menu-bar rules and direct primary/secondary/tertiary lane tokens; these are implementable from existing normalized data only through a Plasma-native rule model and configuration UI, not by copying the Swift persistence model.
  • Translations: gettext template extraction is in place. Add real .po catalogs, compiled catalog packaging, and translator contribution docs when localization work starts.
  • Predictive pace warnings are opt-in and consume the CLI pace forecast; they silently prime the current state and notify only on a new projected exhaustion. Consider reset-imminent notifications only if they remain quiet, configurable, and tied to clear state transitions.
  • Provider drift checks: the Plasma fallback catalog covers all 69 provider IDs released in CodexBar v0.49.1 and re-verified with the official 0.56.2 Linux CLI (same 69, none added), while retaining fork-only compatibility assets. OpenRouter changed its canonical dashboard action from credit settings to https://openrouter.ai/activity; the fallback and its drift assertion now use that URL. No other provider identity metadata changed. When upstream releases providers, sync provider keys, CLI aliases, titles, colors, docs/dashboard/login URLs, icon assets, and scripts/test_provider_icons.sh.
  • Plasma release channel: the GitHub Release updater is in place. If the widget is published through KDE Store, prefer KDE Store/KNewStuff/Discover for that channel instead of inventing a parallel updater.
  • Platform-specific non-goals: do not port macOS-only surfaces directly (WidgetKit, Sparkle, Keychain/Full Disk Access UI). Add only Plasma/Linux equivalents that provide real value and keep provider/auth logic in the CLI.