ccstatusline-usage 2.3.0 → 2.3.1

package/README.md

@@ -31,6 +31,7 @@
 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
 - **Two-line Layout** - Session info on line 1, context on line 2
@@ -39,7 +40,7 @@ This fork adds API-based usage widgets beyond the upstream:
 
 ```
 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%
 ```
 
 ![Demo](https://raw.githubusercontent.com/sirmalloc/ccstatusline/main/screenshots/demo.gif)
@@ -64,6 +65,10 @@ Session: [████░░░░░░░░░░░] 27.0% | Weekly: [██
 
 ## 🆕 Recent Updates
 
+### [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,6 +543,7 @@ 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
@@ -631,6 +637,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

@@ -54069,7 +54069,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.1";
 var init_terminal = () => {};
 
 // src/utils/renderer.ts
@@ -60440,6 +60440,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 +60464,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();
@@ -62453,6 +62488,110 @@ 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);
+    if (displayMode === "pendulum") {
+      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 init_WeeklyPace = __esm(() => {
+  init_usage();
+});
+
 // src/widgets/index.ts
 var init_widgets = __esm(async () => {
   init_GitBranch();
@@ -62471,6 +62610,7 @@ var init_widgets = __esm(async () => {
   init_ThinkingEffort();
   init_Battery();
   init_VimMode();
+  init_WeeklyPace();
   await __promiseAll([
     init_TokensInput(),
     init_TokensOutput(),
@@ -62530,7 +62670,8 @@ 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 }
   ];
   LAYOUT_WIDGET_MANIFEST = [
     {
@@ -68934,7 +69075,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.1",
   "description": "A customizable status line formatter for Claude Code CLI",
   "module": "src/ccstatusline.ts",
   "type": "module",