ccstatusline-usage 2.3.0 → 2.3.2

package/README.md

@@ -31,15 +31,17 @@
 This fork adds API-based usage widgets beyond the upstream:
 
 - **Session/Weekly Usage** - Real utilization from Anthropic API with progress bars
+- **Weekly Pace** - Pendulum bar showing if you're ahead or behind expected usage pace
 - **Reset Timer** - Time until 5-hour session window resets
 - **Context Window Display** - Visual bar showing context usage
+- **Off Peak** - Shows peak/off-peak 2x status during Anthropic usage promotions
 - **Two-line Layout** - Session info on line 1, context on line 2
 
 ### Enhanced Status Line Preview
 
 ```
 Session: [████░░░░░░░░░░░] 27.0% | Weekly: [███████████████] 100.0% | Extra: €2.50/€50.00 | Model: Opus 4.6 | Session ID: 0109b99d...
-  Context: [███████░░░░░░░░] 103k/200k (51%)
+  Context: [███████░░░░░░░░] 103k/200k (51%) | Pace: [░░░░░░░|██░░░░░] D5/7 +12% | Off peak: Off-peak 2x
 ```
 
 ![Demo](https://raw.githubusercontent.com/sirmalloc/ccstatusline/main/screenshots/demo.gif)
@@ -64,6 +66,16 @@ Session: [████░░░░░░░░░░░] 27.0% | Weekly: [██
 
 ## 🆕 Recent Updates
 
+### [v2.3.2](https://github.com/pcvelz/ccstatusline-usage/releases/tag/v2.3.2) - Off Peak widget + WeeklyPace compact fix
+
+- [pcvelz/ccstatusline-usage](https://github.com/pcvelz/ccstatusline-usage): **Off Peak widget** — New widget showing `Off peak: Off-peak 2x` or `Off peak: Peak` during the Anthropic March 2026 Spring Break promotion (off-peak = weekdays outside 8 AM–2 PM ET, weekends all day). Widget automatically hides after March 28, 2026 23:59 PT.
+- [pcvelz/ccstatusline-usage](https://github.com/pcvelz/ccstatusline-usage): **WeeklyPace compact fix** — Pendulum bar now falls back to text mode (`D6/7: -18%`) on narrow terminals (< 80 chars)
+- [pcvelz/ccstatusline-usage](https://github.com/pcvelz/ccstatusline-usage): **Sonnet [1m] extra usage fix** — Extra usage spending now shown when a charged `[1m]` model (e.g. Sonnet) is active, regardless of weekly limit status
+
+### [v2.3.1](https://github.com/pcvelz/ccstatusline-usage/releases/tag/v2.3.1) - Weekly Pace widget
+
+- [pcvelz/ccstatusline-usage](https://github.com/pcvelz/ccstatusline-usage): **Weekly Pace widget** — New widget showing if weekly usage pace is on track, with pendulum bar or text display mode (PR #1 by @BenIsLegit)
+
 ### [v2.3.0](https://github.com/pcvelz/ccstatusline-usage/releases/tag/v2.3.0) - Upstream sync + Vim Mode widget
 
 - [pcvelz/ccstatusline-usage](https://github.com/pcvelz/ccstatusline-usage): **Upstream sync** — Merged 14 upstream commits: Vim Mode widget, hyperlink support for GitBranch/GitRootDir, ESLint 10 upgrade, timer day display fix (≥24h), macOS keychain token fallback, ink-gradient 4.0.0
@@ -538,12 +550,14 @@ bun run example
 - **Battery** *(ccstatusline-usage)* - Shows battery percentage on macOS and Linux (only visible when on battery power, hidden when charging)
 - **Session Usage** - Shows daily/session API usage percentage
 - **Weekly Usage** - Shows weekly API usage percentage
+- **Weekly Pace** - Pendulum bar or text label showing if usage pace is on track, overcooking, or underutilized (toggle with `p` key in TUI)
 - **Block Reset Timer** - Shows time remaining until current 5-hour block reset window
 - **Weekly Reset Timer** - Shows time remaining until weekly usage reset
 - **Context Bar** - Shows context usage as a progress bar with short/full display modes
 - **Skills** - Shows skill activity as last used, total count, or unique list (with optional list limit and hide-when-empty toggle)
 - **Thinking Effort** - Shows the current Claude Code thinking effort level
 - **Vim Mode** - Displays current vim editor mode
+- **Off Peak** *(ccstatusline-usage)* - Shows `Off peak: Off-peak 2x` or `Off peak: Peak` during Anthropic usage promotions (auto-hides when promotion ends)
 - **Separator** - Visual divider between widgets (available when Powerline mode is off and no default separator is configured)
 - **Flex Separator** - Expands to fill available space (available when Powerline mode is off)
 
@@ -631,6 +645,7 @@ Widget-specific shortcuts:
 - **Block Timer**: `p` cycle display mode (time/full bar/short bar)
 - **Block Reset Timer**: `p` cycle display mode (time/full bar/short bar)
 - **Weekly Reset Timer**: `p` cycle display mode (time/full bar/short bar)
+- **Weekly Pace**: `p` toggle pendulum bar / text label
 - **Current Working Dir**: `h` home abbreviation, `s` segment editor, `f` fish-style path
 - **Custom Command**: `e` command, `w` max width, `t` timeout, `p` preserve ANSI colors
 - **Link**: `u` URL, `e` link text

package/dist/ccstatusline.js

@@ -52428,7 +52428,9 @@ var init_Settings = __esm(() => {
         { id: "session-id", type: "claude-session-id", color: "cyan" }
       ],
       [
-        { id: "context-bar", type: "context-bar", color: "blue" }
+        { id: "context-bar", type: "context-bar", color: "blue" },
+        { id: "sep-off-peak", type: "separator" },
+        { id: "off-peak", type: "off-peak", color: "green" }
       ],
       []
     ]),
@@ -54069,7 +54071,7 @@ function getTerminalWidth() {
 function canDetectTerminalWidth() {
   return probeTerminalWidth() !== null;
 }
-var __dirname = "/Users/peter/Documents/Code/ccstatusline-usage/src/utils", PACKAGE_VERSION = "2.3.0";
+var __dirname = "/Users/peter/Documents/Code/ccstatusline-usage/src/utils", PACKAGE_VERSION = "2.3.2";
 var init_terminal = () => {};
 
 // src/utils/renderer.ts
@@ -60440,6 +60442,19 @@ function resolveUsageWindowWithFallback(usageData, blockMetrics, nowMs = Date.no
   }
   return getUsageWindowFromBlockMetrics(fallbackMetrics, nowMs);
 }
+function getWeeklyUsageWindowFromResetAt(weeklyResetAt, nowMs = Date.now()) {
+  if (!weeklyResetAt) {
+    return null;
+  }
+  const resetAtMs = Date.parse(weeklyResetAt);
+  if (Number.isNaN(resetAtMs)) {
+    return null;
+  }
+  return buildUsageWindow(resetAtMs, nowMs, SEVEN_DAY_WINDOW_MS);
+}
+function resolveWeeklyUsageWindow(usageData, nowMs = Date.now()) {
+  return getWeeklyUsageWindowFromResetAt(usageData.weeklyResetAt, nowMs);
+}
 function formatUsageDuration(durationMs, compact2 = false, useDays = true) {
   const clampedMs = Math.max(0, durationMs);
   const totalHours = Math.floor(clampedMs / (1000 * 60 * 60));
@@ -60451,6 +60466,28 @@ function formatUsageDuration(durationMs, compact2 = false, useDays = true) {
   const parts = [d > 0 && `${d}d`, h > 0 && `${h}${hLabel}`, m > 0 && `${m}m`].filter(Boolean);
   return parts.length > 0 ? parts.join(sep2) : "0m";
 }
+function getUsageErrorMessage(error48) {
+  switch (error48) {
+    case "no-credentials":
+      return "[No credentials]";
+    case "timeout":
+      return "[Timeout]";
+    case "rate-limited":
+      return "[Rate limited]";
+    case "api-error":
+      return "[API Error]";
+    case "parse-error":
+      return "[Parse Error]";
+  }
+}
+function makePendulumBar(delta, halfWidth = 7) {
+  const clamped = Math.max(-100, Math.min(100, delta));
+  const fill2 = Math.min(halfWidth, Math.round(Math.abs(clamped) / 100 * halfWidth));
+  if (clamped < 0) {
+    return "[" + "░".repeat(halfWidth - fill2) + "█".repeat(fill2) + "|" + "░".repeat(halfWidth) + "]";
+  }
+  return "[" + "░".repeat(halfWidth) + "|" + "█".repeat(fill2) + "░".repeat(halfWidth - fill2) + "]";
+}
 var init_usage_windows = __esm(() => {
   init_jsonl();
   init_usage_types();
@@ -61708,7 +61745,11 @@ class ResetTimerWidget {
     const data = fetchApiData();
     if (data.error)
       return getErrorMessage(data.error);
-    if (data.extraUsageEnabled && data.weeklyUsage !== undefined && data.weeklyUsage >= 100 && data.extraUsageUsed !== undefined && data.extraUsageLimit !== undefined) {
+    const modelId = context.data?.model?.id ?? "";
+    const is1mModel = modelId.includes("[1m]");
+    const isOpus = modelId.includes("opus");
+    const isChargedModel = is1mModel && !isOpus;
+    if (data.extraUsageEnabled && data.extraUsageUsed !== undefined && data.extraUsageLimit !== undefined && (data.weeklyUsage !== undefined && data.weeklyUsage >= 100 || isChargedModel)) {
       const used = formatCents(data.extraUsageUsed);
       const displayLimit = settings.extraUsageBalance ?? data.extraUsageLimit;
       const limit = formatCents(displayLimit);
@@ -62453,6 +62494,169 @@ var init_VimMode = __esm(() => {
   FORMATS = ["icon-dash-letter", "icon-letter", "icon", "letter", "word"];
 });
 
+// src/widgets/WeeklyPace.ts
+function getPaceDisplayMode(item) {
+  return item.metadata?.display === "pendulum" ? "pendulum" : "text";
+}
+function computePace(actualPercent, expectedPercent) {
+  const delta = actualPercent - expectedPercent;
+  const dayOfWeek = Math.max(1, Math.min(7, Math.ceil(expectedPercent * 7 / 100)));
+  let status;
+  if (delta > 15) {
+    status = `Overcooking +${Math.round(delta)}%`;
+  } else if (delta > 5) {
+    status = `Warm +${Math.round(delta)}%`;
+  } else if (delta < -15) {
+    status = `Underusing ${Math.round(delta)}%`;
+  } else if (delta < -5) {
+    status = `Cool ${Math.round(delta)}%`;
+  } else {
+    status = "On Pace";
+  }
+  return { delta, dayOfWeek, status };
+}
+
+class WeeklyPaceWidget {
+  getDefaultColor() {
+    return "brightYellow";
+  }
+  getDescription() {
+    return "Shows if weekly usage pace is on track, overcooking, or underutilized";
+  }
+  getDisplayName() {
+    return "Weekly Pace";
+  }
+  getCategory() {
+    return "Usage";
+  }
+  getEditorDisplay(item) {
+    const mode = getPaceDisplayMode(item);
+    const modifiers = [];
+    if (mode === "pendulum") {
+      modifiers.push("pendulum bar");
+    }
+    return {
+      displayText: this.getDisplayName(),
+      modifierText: makeModifierText(modifiers)
+    };
+  }
+  handleEditorAction(action, item) {
+    if (action !== "toggle-pendulum") {
+      return null;
+    }
+    const currentMode = getPaceDisplayMode(item);
+    const nextMode = currentMode === "text" ? "pendulum" : "text";
+    return {
+      ...item,
+      metadata: {
+        ...item.metadata ?? {},
+        display: nextMode
+      }
+    };
+  }
+  render(item, context, settings) {
+    const displayMode = getPaceDisplayMode(item);
+    if (context.isPreview) {
+      if (displayMode === "pendulum") {
+        const barDisplay = `${makePendulumBar(10)} D4/7 +10%`;
+        return formatRawOrLabeledValue(item, "Pace: ", barDisplay);
+      }
+      return formatRawOrLabeledValue(item, "", "D4/7: On Pace");
+    }
+    const data = context.usageData;
+    if (!data)
+      return null;
+    if (data.error)
+      return getUsageErrorMessage(data.error);
+    if (data.weeklyUsage === undefined)
+      return null;
+    const window2 = resolveWeeklyUsageWindow(data);
+    if (!window2)
+      return null;
+    const actualPercent = Math.max(0, Math.min(100, data.weeklyUsage));
+    const { delta, dayOfWeek, status } = computePace(actualPercent, window2.elapsedPercent);
+    const mobile = (context.terminalWidth ?? 0) > 0 && (context.terminalWidth ?? 0) < MOBILE_THRESHOLD3;
+    if (displayMode === "pendulum" && !mobile) {
+      const sign = delta >= 0 ? "+" : "";
+      const barDisplay = `${makePendulumBar(delta)} D${dayOfWeek}/7 ${sign}${Math.round(delta)}%`;
+      return formatRawOrLabeledValue(item, "Pace: ", barDisplay);
+    }
+    return formatRawOrLabeledValue(item, "", `D${dayOfWeek}/7: ${status}`);
+  }
+  getCustomKeybinds() {
+    return [
+      { key: "p", label: "(p)endulum toggle", action: "toggle-pendulum" }
+    ];
+  }
+  supportsRawValue() {
+    return true;
+  }
+  supportsColors(item) {
+    return true;
+  }
+}
+var MOBILE_THRESHOLD3 = 80;
+var init_WeeklyPace = __esm(() => {
+  init_usage();
+});
+
+// src/widgets/OffPeak.ts
+function isOffPeak(now2) {
+  const ms = now2.getTime();
+  if (ms < PROMO_START_MS || ms >= PROMO_END_MS) {
+    return null;
+  }
+  const dayOfWeek = now2.getUTCDay();
+  const isWeekend = dayOfWeek === 0 || dayOfWeek === 6;
+  if (isWeekend)
+    return true;
+  const utcHour = now2.getUTCHours();
+  const isPeak = utcHour >= PEAK_START_UTC_HOUR && utcHour < PEAK_END_UTC_HOUR;
+  return !isPeak;
+}
+
+class OffPeakWidget {
+  getDefaultColor() {
+    return "green";
+  }
+  getDescription() {
+    return "Shows peak / off-peak 2x status during the March 2026 Anthropic usage promotion";
+  }
+  getDisplayName() {
+    return "Off Peak";
+  }
+  getCategory() {
+    return "Usage";
+  }
+  getEditorDisplay(_item) {
+    return { displayText: this.getDisplayName() };
+  }
+  render(item, context, _settings) {
+    if (context.isPreview) {
+      return item.rawValue ? "Off-peak 2x" : "Off peak: Off-peak 2x";
+    }
+    const result2 = isOffPeak(new Date);
+    if (result2 === null)
+      return null;
+    const value = result2 ? "Off-peak 2x" : "Peak";
+    const mobile = (context.terminalWidth ?? 0) > 0 && (context.terminalWidth ?? 0) < 80;
+    if (item.rawValue || mobile)
+      return value;
+    return `Off peak: ${value}`;
+  }
+  supportsRawValue() {
+    return true;
+  }
+  supportsColors(_item) {
+    return true;
+  }
+}
+var PROMO_START_MS, PROMO_END_MS, PEAK_START_UTC_HOUR = 12, PEAK_END_UTC_HOUR = 18;
+var init_OffPeak = __esm(() => {
+  PROMO_START_MS = Date.UTC(2026, 2, 13, 7, 0, 0);
+  PROMO_END_MS = Date.UTC(2026, 2, 29, 6, 59, 0);
+});
+
 // src/widgets/index.ts
 var init_widgets = __esm(async () => {
   init_GitBranch();
@@ -62471,6 +62675,8 @@ var init_widgets = __esm(async () => {
   init_ThinkingEffort();
   init_Battery();
   init_VimMode();
+  init_WeeklyPace();
+  init_OffPeak();
   await __promiseAll([
     init_TokensInput(),
     init_TokensOutput(),
@@ -62530,7 +62736,9 @@ var init_widget_manifest = __esm(async () => {
     { type: "skills", create: () => new SkillsWidget },
     { type: "thinking-effort", create: () => new ThinkingEffortWidget },
     { type: "battery", create: () => new BatteryWidget },
-    { type: "vim-mode", create: () => new VimModeWidget }
+    { type: "vim-mode", create: () => new VimModeWidget },
+    { type: "weekly-pace", create: () => new WeeklyPaceWidget },
+    { type: "off-peak", create: () => new OffPeakWidget }
   ];
   LAYOUT_WIDGET_MANIFEST = [
     {
@@ -68934,7 +69142,8 @@ var USAGE_WIDGET_TYPES = new Set([
   "weekly-usage",
   "block-timer",
   "reset-timer",
-  "weekly-reset-timer"
+  "weekly-reset-timer",
+  "weekly-pace"
 ]);
 function hasUsageDependentWidgets(lines) {
   return lines.some((line) => line.some((item) => USAGE_WIDGET_TYPES.has(item.type)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccstatusline-usage",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "A customizable status line formatter for Claude Code CLI",
   "module": "src/ccstatusline.ts",
   "type": "module",