fix(spend): preserve recorded zero sources and scoped dates

Keep date inspection within plotted buckets, retain recorded zero-dollar source chips and inspector rows, and cover hourly inspection across DST. Reuse source records during stacking and sync the reviewed main baseline without rewriting contributor history.

Co-authored-by: Yuxin Qiao <104957188+Yuxin-Qiao@users.noreply.github.com>

Author: steipete

CHANGELOG.md

@@ -2,6 +2,22 @@
 
 ## 0.73.1 — Unreleased
 
+### Added
+
+- X API: track prepaid and free developer-console credits with a bundled plugin, Chrome/manual cookies, and negative balances in Balance layouts (#4127). Thanks @marklights54-byte!
+- Notion AI: import signed-in Microsoft Edge sessions after Chrome on macOS, retaining prompt-free background cookie access (#4323). Thanks @jiehua!
+
+### Fixed
+
+- Usage & Spend: keep date inspection inside recorded chart buckets, wrap scoped source legends, and retain recorded zero-dollar sources and amounts (#4329). Thanks @Yuxin-Qiao!
+
+- Menu bar: keep the empty Settings placeholder from creating a persistent Dock icon at launch on macOS 27, and share its guarded dismissal path. (#4101)
+- OpenCode Go: show the most constrained five-hour, weekly, or monthly quota in the automatic menu-bar percentage and switcher before it runs out. (#3349)
+- Claude: preserve Plan Usage history across external OAuth token rotations and reunite saved fragments with verified account/profile bindings, while keeping other accounts and unverified history separate (#4322). Thanks @urda!
+- Claude: keep Enterprise monthly Extra usage visible in Compact Overview when quota limits are unavailable, respecting the optional-usage preference (#4320). Thanks @wrick17!
+- Claude: distinguish insights-only CLI reports from subscription-only notices so failed direct fallbacks preserve the original PTY error, and log that error before fallback (#4083). Thanks @sczhui!
+- Docs: correct Codex Auto source order and explain credential renewal, local cost coverage, and the distinct Pi, OpenCodex, OpenCode, Amp, and dots paths (#3635, #3273, #3556, #4300).
+
 ## 0.73.0 — 2026-10-07
 
 ### Highlights

README.md

@@ -10,7 +10,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-6e5aff?style=flat-square)](LICENSE)
 [![Site](https://img.shields.io/badge/site-codexbar.app-16d3b4?style=flat-square)](https://codexbar.app)
 
-<a href="https://codexbar.app"><img src="docs/social.png?v=3182891f443d237c" alt="CodexBar — every AI coding limit in your menu bar. 91 providers." width="100%" /></a>
+<a href="https://codexbar.app"><img src="docs/social.png?v=82fb5aa4eda4b681" alt="CodexBar — every AI coding limit in your menu bar. 92 providers." width="100%" /></a>
 
 Tiny macOS 14+ menu bar app that keeps **AI coding-provider limits visible** and shows when each window resets. See the [supported providers](#providers) below. One status item per provider, or Merge Icons mode with a provider switcher. No Dock icon, minimal UI, dynamic bar icons.
 
@@ -184,6 +184,7 @@ See [CLI configuration](docs/cli-configuration.md) for the full flow.
 
 <!-- Generated provider additions: Scripts/regenerate-provider-docs.mjs -->
 - [Langdock](docs/langdock.md) — Selected Microsoft Edge profile → personal included session and weekly limits (`web`, macOS).
+- [X API](docs/xapi.md) — Chrome or manual console.x.com cookies for prepaid and free credits, including negative balances.
 - [LithosAI](docs/lithosai.md) — Chrome or manual console cookies for prepaid USD balance and optional UTC spend.
 - [WorkBuddy](docs/workbuddy.md) — Chrome or manual www.workbuddy.cn cookies for the monthly credits allowance, plan name, and cycle reset.
 <!-- End generated provider additions -->

Sources/CodexBar/CodexbarApp.swift

@@ -463,7 +463,9 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
         self.installDebugMemoryPressureObserverIfNeeded()
         #endif
         self.ensureStatusController()
-        self.closeSwiftUISettingsPlaceholderWindow()
+        DispatchQueue.main.async { [weak self] in
+            self?.placeholderSettingsWindowGuard.sweep()
+        }
         self.observeSettingsApplicationMenuLanguage()
         self.scheduleSettingsApplicationMenuValidation(
             missingItemRetriesRemaining: Self.settingsMenuReadinessRetryCount,
@@ -503,21 +505,6 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
         }
     }
 
-    /// The SwiftUI `Settings` scene exists only to own the app-menu Settings command; the real
-    /// settings window is AppKit-managed (`SettingsWindowController`). macOS can still present or
-    /// state-restore the scene's empty placeholder window at launch — close it and keep it out of
-    /// state restoration so it cannot come back on the next launch.
-    private func closeSwiftUISettingsPlaceholderWindow() {
-        DispatchQueue.main.async {
-            for window in NSApp.windows
-                where window.identifier?.rawValue.hasPrefix("com_apple_SwiftUI_Settings") == true
-            {
-                window.isRestorable = false
-                window.close()
-            }
-        }
-    }
-
     func applicationShouldTerminate(_ sender: NSApplication) -> NSApplication.TerminateReply {
         guard !self.isWaitingForConfigPersistence else { return .terminateLater }
         guard let save = self.settings?.persistPendingConfigForTermination() else { return .terminateNow }

Sources/CodexBar/DockIconController.swift

@@ -3,6 +3,7 @@ import CodexBarCore
 
 struct DockIconWindowDescriptor: Equatable, Sendable {
     let identifier: String?
+    let frameAutosaveName: String
     let title: String
     let classNames: [String]
     let width: Double
@@ -13,12 +14,14 @@ struct DockIconWindowDescriptor: Equatable, Sendable {
     let isKnownSettingsWindow: Bool
 
     var isSettingsWindow: Bool {
-        if self.isKnownSettingsWindow {
-            return true
-        }
-        guard let identifier else { return false }
-        return identifier == SettingsWindowIdentity.identifier
-            || identifier.contains("com_apple_SwiftUI_Settings")
+        self.isKnownSettingsWindow || self.identifier == SettingsWindowIdentity.identifier
+    }
+
+    var isPlaceholderSettingsWindow: Bool {
+        PlaceholderSettingsWindowDecision.shouldClose(
+            identifier: self.identifier,
+            frameAutosaveName: self.frameAutosaveName,
+            isKnownSettingsWindow: self.isKnownSettingsWindow)
     }
 
     var isSparkleWindow: Bool {
@@ -28,6 +31,7 @@ struct DockIconWindowDescriptor: Equatable, Sendable {
     }
 
     var isRealWindow: Bool {
+        guard !self.isPlaceholderSettingsWindow else { return false }
         guard self.isVisible, !self.isMiniaturized, self.canBecomeKey else { return false }
         guard !self.isTinyWindow, !self.isStatusBarWindow else { return false }
         return true
@@ -56,6 +60,7 @@ struct DockIconWindowDescriptor: Equatable, Sendable {
 
         return Self(
             identifier: window.identifier?.rawValue,
+            frameAutosaveName: window.frameAutosaveName,
             title: window.title,
             classNames: classNames,
             width: window.frame.width,
@@ -75,7 +80,7 @@ enum DockIconPolicyDecision {
     }
 
     static func shouldPromoteForPresentedWindow(_ window: DockIconWindowDescriptor) -> Bool {
-        window.isVisible && (window.isSettingsWindow || window.isSparkleWindow)
+        window.isVisible && !window.isPlaceholderSettingsWindow && (window.isSettingsWindow || window.isSparkleWindow)
     }
 
     /// Windows that became eligible for Dock promotion since the last evaluation.

Sources/CodexBar/MenuBarMetricWindowResolver.swift

@@ -76,10 +76,8 @@ enum MenuBarMetricWindowResolver {
         -> RateWindow?
     {
         if presentation.automaticSelectionPrioritizesExhaustedWindow,
-           let exhausted = exhaustedWindow(
-               primary: snapshot.primary,
-               secondary: snapshot.secondary,
-               tertiary: snapshot.tertiary)
+           let exhausted = [snapshot.primary, snapshot.secondary, snapshot.tertiary]
+               .compactMap(\.self).first(where: { $0.usedPercent >= 100 })
         {
             return exhausted
         }
@@ -171,17 +169,6 @@ enum MenuBarMetricWindowResolver {
         return family
     }
 
-    private static func exhaustedWindow(
-        primary: RateWindow?,
-        secondary: RateWindow?,
-        tertiary: RateWindow?)
-        -> RateWindow?
-    {
-        [primary, secondary, tertiary]
-            .compactMap(\.self)
-            .first { $0.usedPercent >= 100 }
-    }
-
     /// The Claude spend-limit window when the account only exposes an enterprise/extra-usage spend limit
     /// and has no real session/weekly quota lanes (`primary` nil, a `.spendLimit` window, or an explicitly
     /// marked placeholder). Lets the automatic and combined metrics surface the spend limit instead of an empty

Sources/CodexBar/PlaceholderSettingsWindowGuard.swift

@@ -81,6 +81,7 @@ final class PlaceholderSettingsWindowGuard {
             defer { self.closingWindows.remove(identity) }
             // Record before closing: close can synchronously trigger another window notification.
             self.closedWindows.add(window)
+            window.isRestorable = false
             self.closeWindow(window)
             closedCount += 1
         }

Sources/CodexBar/Providers/Shared/ProviderImplementationManifest.swift

@@ -75,6 +75,7 @@ enum ProviderImplementationManifest {
         PluginAPIKeyProviderImplementation(spec: AiAndProviderDescriptor.spec),
         ZoomMateProviderImplementation(),
         PluginAPIKeyProviderImplementation(spec: XAIProviderDescriptor.spec),
+        PluginCookieProviderImplementation(spec: XAPIProviderDescriptor.spec),
         NotionProviderImplementation(),
         IBMBobProviderImplementation(),
         NousProviderImplementation(),

Sources/CodexBar/Resources/ProviderIcon-xapi.svg

@@ -13,7 +13,11 @@ struct SpendDashboardTrendPanel: View {
     @State private var focusedInterval: DateInterval?
 
     var body: some View {
-        let legendProviders = self.legendProviders
+        let legendProviders = SpendTrendChartModel(
+            group: self.group,
+            section: self.activeSection,
+            day: self.day,
+            overviewInterval: self.focusedInterval).legendProviders(in: self.group)
         let sourceID = self.selectedSourceID.flatMap { id in legendProviders.contains { $0.id == id } ? id : nil }
         return SpendDashboardPanel {
             VStack(alignment: .leading, spacing: 14) {
@@ -102,14 +106,6 @@ struct SpendDashboardTrendPanel: View {
         SpendTrendChartModel.focusedDay(self.focusedDay, group: self.group)
     }
 
-    private var legendProviders: [SpendDashboardModel.ProviderRow] {
-        SpendTrendChartModel(
-            group: self.group,
-            section: self.activeSection,
-            day: self.day,
-            overviewInterval: self.focusedInterval).legendProviders(in: self.group)
-    }
-
     private func dayNavigation(_ day: Date) -> some View {
         let index = self.hourlyDays.firstIndex(of: day)
         return HStack(spacing: 8) {
@@ -433,7 +429,7 @@ struct SpendTrendChart: View {
     }
 
     private func inspectionRows(_ bucket: SpendTrendChartModel.Bucket?) -> some View {
-        ForEach(bucket?.segments.filter { $0.cost > 0 } ?? []) { segment in
+        ForEach(bucket?.segments ?? []) { segment in
             HStack(spacing: 5) {
                 Circle().fill(Color(nsColor: SpendChartPalette.color(
                     sourceID: segment.sourceID, provider: segment.provider, providers: self.group.providers)))

Sources/CodexBar/SpendDashboardTrendPanel.swift

@@ -48,7 +48,7 @@ struct SpendTrendChartModel {
     {
         self.section = section
         self.calendar = group.calendar
-        let points: [Segment]
+        let points: [(source: (id: String, provider: UsageProvider, name: String), date: Date, cost: Double)]
         if section == .hourly {
             let day = day ?? Self.focusedDay(nil, group: group) ?? group.chartDomain.lowerBound
             let interval = group.calendar.dateInterval(of: .day, for: day)
@@ -59,14 +59,7 @@ struct SpendTrendChartModel {
             points = group.hourlyPoints.filter {
                 $0.hour >= interval.start && $0.hour < interval.end
             }.map {
-                Segment(
-                    sourceID: $0.sourceID,
-                    provider: $0.provider,
-                    name: $0.providerName,
-                    date: $0.hour,
-                    cost: $0.cost,
-                    start: 0,
-                    end: 0)
+                (($0.sourceID, $0.provider, $0.providerName), $0.hour, $0.cost)
             }
         } else {
             self.scope = overviewInterval.map { $0.start...$0.end } ?? group.chartDomain
@@ -80,39 +73,30 @@ struct SpendTrendChartModel {
             points = group.dailyPoints.filter {
                 $0.day >= scope.lowerBound && $0.day < scope.upperBound
             }.map {
-                Segment(
-                    sourceID: $0.sourceID,
-                    provider: $0.provider,
-                    name: $0.providerName,
-                    date: $0.day,
-                    cost: $0.cost,
-                    start: 0,
-                    end: 0)
+                (($0.sourceID, $0.provider, $0.providerName), $0.day, $0.cost)
             }
         }
-        let filtered = points.filter { sourceID == nil || $0.sourceID == sourceID }
+        let filtered = points.filter { sourceID == nil || $0.source.id == sourceID }
         let unit = self.unit
         let grouped = Dictionary(grouping: filtered) {
             group.calendar.dateInterval(of: unit, for: $0.date)?.start ?? $0.date
         }
         self.buckets = grouped.keys.sorted().compactMap { date in
             var end = 0.0
-            let sources = Dictionary(grouping: grouped[date] ?? [], by: \.sourceID)
-            let segments = sources.keys.sorted().compactMap { sourceID -> Segment? in
-                guard let point = sources[sourceID]?.first else { return nil }
-                let cost = (sources[sourceID] ?? []).reduce(0) { $0 + $1.cost }
-                var segment = Segment(
-                    sourceID: point.sourceID,
-                    provider: point.provider,
-                    name: point.name,
+            let sources = Dictionary(grouping: grouped[date] ?? [], by: { $0.source.id })
+            let segments = sources.sorted { $0.key < $1.key }.map { _, points in
+                let point = points[0]
+                let cost = points.reduce(0) { $0 + $1.cost }
+                let start = end
+                end += cost
+                return Segment(
+                    sourceID: point.source.id,
+                    provider: point.source.provider,
+                    name: point.source.name,
                     date: date,
                     cost: cost,
-                    start: 0,
-                    end: 0)
-                segment.start = end
-                end += cost
-                segment.end = end
-                return segment
+                    start: start,
+                    end: end)
             }
             return end.isFinite ? Bucket(date: date, segments: segments) : nil
         }
@@ -250,7 +234,7 @@ struct SpendTrendChartModel {
     }
 
     func legendProviders(in group: SpendDashboardModel.CurrencyGroup) -> [SpendDashboardModel.ProviderRow] {
-        let sourceIDs = Set(self.segments.filter { $0.cost > 0 }.map(\.sourceID))
+        let sourceIDs = Set(self.segments.map(\.sourceID))
         return group.providers.filter { sourceIDs.contains($0.id) }
     }
 
@@ -269,10 +253,8 @@ struct SpendTrendChartModel {
 
     static func focusedDay(_ day: Date?, group: SpendDashboardModel.CurrencyGroup) -> Date? {
         let days = self.hourlyDays(group)
-        if let selectedDay = group.selectedDay.map({ group.calendar.startOfDay(for: $0) }),
-           days.contains(selectedDay) { return selectedDay }
-        if let day = day.map({ group.calendar.startOfDay(for: $0) }), days.contains(day) { return day }
-        return days.last
+        return [group.selectedDay, day].compactMap { $0.map { group.calendar.startOfDay(for: $0) } }
+            .first(where: days.contains) ?? days.last
     }
 }