@llblab/pi-codex-usage 0.3.5 → 0.4.1

package/AGENTS.md

@@ -8,6 +8,6 @@
   - Trigger: Updating quota polling or error handling.
   - Action: Do not collapse the bar while a request is in flight; only show `n/a` or `error` after repeated failures or no usable quota.
 
-- `Compact dual bar`: Encode the 5-hour and weekly quota windows in the five-character separated-sextant bar.
+- `Compact dual bar`: Encode the 5-hour and weekly quota windows in the ten-character separated-sextant bar.
   - Trigger: Changing statusline formatting.
-  - Action: Keep a fixed-width `[xxxxx]` bar where top sextants represent the 5-hour window and bottom sextants represent the weekly window.
+  - Action: Keep a fixed-width `xxxxxxxxxx` bar where top sextants represent the 5-hour window and bottom sextants represent the weekly window, with 20 steps per window.

package/CHANGELOG.md

@@ -1,9 +1,25 @@
 # Changelog
 
-- `0.3.5` Refined the compact statusline bar with quadrant glyphs, darker bar coloring, and blink-on-segment-change behavior. Impact: Codex quota changes are easier to notice while routine refreshes stay visually stable.
-- `0.3.4` Added package banner metadata and README hero image. Impact: Pi/package listings can show the Codex Usage banner while npm packages include the image asset.
-- `Fork baseline` Imported `extensions/pi-codex-usage` from `narumiruna/pi-extensions` as a standalone `@llblab/pi-codex-usage` package. Impact: the extension can be installed and maintained independently.
-- `Minimal statusline` Removed command-driven report output and narrowed the extension to a zero-configuration statusline widget. Impact: runtime behavior is automatic while `openai-codex` is active.
-- `Primary quota focus` Ignored additional returned buckets such as Spark-specific limits. Impact: the statusline only represents primary Codex 5-hour and weekly quota windows.
-- `Dual quota bar` Replaced textual percentages with a fixed-width separated-sextant bar. Impact: both 5-hour and weekly remaining quota are encoded in five statusline characters.
-- `Optimistic refresh` Kept the last good bar during refresh and transient failures, with a short successful-redraw blink. Impact: the footer no longer shifts or collapses during polling.
+## 0.4.1: Stable Startup Bar
+
+- Fixed the initial empty statusline bar to use ten non-trimmed blank glyph cells through the same formatting path as the populated quota bar. Impact: the footer background stays at ten cells during startup before the first quota values arrive.
+
+## 0.4.0
+
+- Expanded the dual statusline bar to ten glyphs with 20 steps per quota window, moved its status key near the start of the footer status order, and draws the bar on the themed selected background. Impact: 5-hour and weekly limits now move in 5% increments for 40 total discrete points while empty cells no longer blend into the terminal background.
+
+## 0.3.5
+
+- Refined the compact statusline bar with quadrant glyphs, darker bar coloring, and blink-on-segment-change behavior. Impact: Codex quota changes are easier to notice while routine refreshes stay visually stable.
+
+## 0.3.4
+
+- Added package banner metadata and README hero image. Impact: Pi/package listings can show the Codex Usage banner while npm packages include the image asset.
+
+## Fork baseline
+
+- Imported `extensions/pi-codex-usage` from `narumiruna/pi-extensions` as a standalone `@llblab/pi-codex-usage` package. Impact: the extension can be installed and maintained independently.
+- Removed command-driven report output and narrowed the extension to a zero-configuration statusline widget. Impact: runtime behavior is automatic while `openai-codex` is active.
+- Ignored additional returned buckets such as Spark-specific limits. Impact: the statusline only represents primary Codex 5-hour and weekly quota windows.
+- Replaced textual percentages with a fixed-width separated-sextant bar. Impact: both 5-hour and weekly remaining quota are encoded in five statusline characters.
+- Kept the last good bar during refresh and transient failures, with a short successful-redraw blink. Impact: the footer no longer shifts or collapses during polling.

package/README.md

@@ -15,12 +15,12 @@ This repository is a minimal fork of [`narumiruna/pi-extensions/extensions/pi-co
 ## Features
 
 - Shows an empty statusline bar immediately, then refreshes every 30 seconds while the active Pi model uses `openai-codex`
-- Statusline output stays compact, with the `codex` label accented and the values muted
+- Statusline output stays compact, with the `codex` label accented and the quota bar drawn on a themed background
 - Additional returned buckets, including Spark-specific limits, are ignored
 - Pi OpenAI Codex provider auth is used first
 - Codex CLI app-server remains available as a fallback
 - Missing auth, subscription, plan, or quota windows are shown as `n/a`, not as an error
-- Successful updates briefly redraw the bar only when a ten-step segment changes
+- Successful updates briefly redraw the bar only when a 5% segment changes
 - Network/provider failures keep the last good bar briefly, then show `error`
 - No commands or configuration are required
 
@@ -43,10 +43,10 @@ pi install git:github.com/llblab/pi-codex-usage
 Normal usage:
 
 ```text
-codex ███▀▀
+codex ██████▀▀▀▀
 ```
 
-The five-character bar encodes two ten-step limits at once: the top quadrants are the 5-hour limit, and the bottom quadrants are the weekly limit.
+The ten-character bar encodes two twenty-step limits at once: 40 total bits of quota state in 10 terminal cells. Each step is 5%: the top quadrants are the 5-hour limit, and the bottom quadrants are the weekly limit.
 
 Unavailable because Codex auth or subscription quota is not available:
 

package/index.ts

@@ -11,11 +11,12 @@ const CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
 const DEFAULT_TIMEOUT_MS = 15_000;
 const REFRESH_INTERVAL_MS = 30 * 1000;
 const REDRAW_BLINK_MS = 150;
-const STATUS_KEY = "codex-usage";
+const STATUS_KEY = "aa-codex-usage";
 const MAX_ERROR_BODY_CHARS = 600;
 const STATUS_LABEL_TEXT = "codex";
+const DUAL_BAR_WIDTH = 10;
 const DUAL_BAR_CHARS = [
-  " ",
+  "⠀",
   "▘",
   "▝",
   "▀",
@@ -688,7 +689,8 @@ export function formatCodexUsageStatusline(
   ctx: ExtensionContext,
   _model?: CodexUsageModel,
 ): string {
-  return formatStatuslineText(ctx, formatReportBar(report) ?? "n/a");
+  const bar = formatReportBar(report);
+  return bar ? formatStatuslineBarText(ctx, bar) : formatStatuslineText(ctx, "n/a");
 }
 
 function formatReportBar(report: CodexUsageReport): string | undefined {
@@ -702,8 +704,17 @@ function formatStatuslineText(ctx: ExtensionContext, value: string): string {
   return `${label} ${ctx.ui.theme.fg("dim", value)}`;
 }
 
+function formatStatuslineBarText(ctx: ExtensionContext, bar: string): string {
+  const label = ctx.ui.theme.fg("accent", STATUS_LABEL_TEXT);
+  const value = ctx.ui.theme.bg(
+    "selectedBg",
+    ctx.ui.theme.fg("dim", bar),
+  );
+  return `${label} ${value}`;
+}
+
 function formatEmptyStatuslineBar(ctx: ExtensionContext): string {
-  return formatStatuslineText(ctx, "\u00a0\u00a0\u00a0\u00a0\u00a0");
+  return formatStatuslineBarText(ctx, DUAL_BAR_CHARS[0].repeat(DUAL_BAR_WIDTH));
 }
 
 function formatStatuslineProblem(
@@ -755,10 +766,10 @@ function formatDualLimitBar(
   primary: NormalizedRateLimitWindow | undefined,
   secondary: NormalizedRateLimitWindow | undefined,
 ): string {
-  const primaryParts = filledTenths(primary);
-  const secondaryParts = filledTenths(secondary);
+  const primaryParts = filledTwentieths(primary);
+  const secondaryParts = filledTwentieths(secondary);
   let value = "";
-  for (let index = 0; index < 5; index++) {
+  for (let index = 0; index < DUAL_BAR_WIDTH; index++) {
     const leftPart = index * 2 + 1;
     const rightPart = leftPart + 1;
     let mask = 0;
@@ -771,9 +782,9 @@ function formatDualLimitBar(
   return value;
 }
 
-function filledTenths(window: NormalizedRateLimitWindow | undefined): number {
+function filledTwentieths(window: NormalizedRateLimitWindow | undefined): number {
   if (!window) return 0;
-  return Math.round(remainingPercent(window) / 10);
+  return Math.round(remainingPercent(window) / 5);
 }
 
 function remainingPercent(window: NormalizedRateLimitWindow): number {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-codex-usage",
-  "version": "0.3.5",
+  "version": "0.4.1",
   "private": false,
   "description": "Minimal Pi extension that shows primary Codex ChatGPT subscription usage limits.",
   "keywords": [