pi-minimal-footer 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-10-06
+
+### Fixed
+
+- Keep quota requests and timers stopped after another extension removes or replaces the footer, even when the model changes; explicit reinstallation restores polling
+- Use all spare columns for responsive quota bars when the left group is absent
+- Fall back to default settings when the JSON root is null, a scalar, or an array
+
+### Changed
+
+- Clarify renderer ownership and layout budgeting with rationale comments; isolate reset-label formatting and name shared bar-size limits
+
+## [0.3.0] - 2026-10-06
+
+### Added
+
+- `minFooter.powerlineSeparator` (default `true`); set to `false` for a single-space fallback when the terminal font lacks Powerline glyphs
+
+### Changed
+
+- Keep README focused on installation and daily use; move design constraints, developer guidance, and provider details into `VISION.md`
+- Separate directory and git branch with ``; render each extension status as its own `` tab, without footer-added parentheses or pipes
+- Group model, context, and quota with spaced ` · ` separators
+- Join the quota bar and reset label without an intervening space
+- Show reset labels as local `↻HH:mm` through 24 hours, remaining whole days/hours above 24 hours (e.g., `↻1d8h`), and whole days above 10 days (e.g., `↻12d`)
+- Grow the quota bar from five to ten cells using spare footer columns, improving steps from 2.5% to 1.25% without shortening other fields; retain the smaller fallback on very narrow terminals
+
 ## [0.2.0] - 2026-10-05
 
 ### Added
@@ -114,7 +141,9 @@ First npm-ready release.
 
 - Project scaffold — `extensions/index.ts` with basic footer structure, `package.json` with pi extension manifest, `README.md`, `LICENSE` (MIT)
 
-[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.3.1...HEAD
+[0.3.1]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.3.0...v0.3.1
+[0.3.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.1.3...v0.2.0
 [0.1.3]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.1.2...v0.1.3
 [0.1.2]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.1.1...v0.1.2

package/README.md

@@ -1,142 +1,43 @@
 # pi-minimal-footer
 
 <p>
-  <a href="https://www.npmjs.com/package/pi-minimal-footer">
-    <img src="https://img.shields.io/npm/v/pi-minimal-footer" alt="npm version">
-  </a>
-  <a href="https://www.npmjs.com/package/pi-minimal-footer">
-    <img src="https://img.shields.io/npm/dt/pi-minimal-footer" alt="npm downloads">
-  </a>
-  <a href="LICENSE">
-    <img src="https://img.shields.io/npm/l/pi-minimal-footer" alt="license">
-  </a>
-  <a href="https://pi.dev/packages/pi-minimal-footer">
-    <img src="https://img.shields.io/badge/pi-package-1a1a2e" alt="pi package">
-  </a>
+  <a href="https://www.npmjs.com/package/pi-minimal-footer"><img src="https://img.shields.io/npm/v/pi-minimal-footer" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/pi-minimal-footer"><img src="https://img.shields.io/npm/dt/pi-minimal-footer" alt="npm downloads"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/npm/l/pi-minimal-footer" alt="license"></a>
+  <a href="https://pi.dev/packages/pi-minimal-footer"><img src="https://img.shields.io/badge/pi-package-1a1a2e" alt="pi package"></a>
 </p>
 
-An opinionated, clean, compact footer for [Pi](https://github.com/earendil-works/pi).
+An opinionated, compact one-line footer for [Pi](https://github.com/earendil-works/pi).
 
-```
-~/git/pi-minimal-footer   main       (icarus | goal running)  gpt-5.6-sol  12/128k    ⣿⣶⠀⠀⠀ ↻16:40
+```text
+~/git/project   main        🧠 Karpathy  🪽 Icarus  model · 42/200k · ⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀↻1d8h
 ```
 
-![pi-minimal-footer screenshot](media/github-preview.png)
+Path and branch on the left; extension statuses, model, context, and provider quota on the right. Shrinks to fit narrow terminals. Interactive terminal UI only.
+
+![Footer preview: ~/git/project   main        🧠 Karpathy  🪽 Icarus  model · 42/200k · ⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀↻1d8h](media/github-preview.png)
 
 ## Install
 
-Available on the [Pi package gallery](https://pi.dev/packages/pi-minimal-footer).
+Requires Node.js >=22.19.0.
 
 ```bash
-# From npm (recommended)
 pi install npm:pi-minimal-footer
-
-# From git
+# Or install from source:
 pi install git:github.com/Ryu-CZ/pi-minimal-footer
-
-# Manual — copy into your extensions directory
-cp -r extensions/* ~/.pi/agent/extensions/
-
-# Development — symlink for live edits
-ln -s "$PWD/extensions" ~/.pi/agent/extensions/minimal-footer
-```
-
-## Development
-
-Requires Node.js >=22.19.0. Run `npm ci`, `npm run check`, and `npm test`. Pi loads TypeScript directly; no build is needed. For an isolated local preview, run `pi --no-extensions -e ./extensions/index.ts`. After source edits, use `/reload` in Pi. Tests use Pi 1.0.3 and make no provider requests.
-
-## Features
-
-- **Working directory** — home abbreviated as `~`; paths outside home remain absolute
-- **Extension statuses** — text reported by extensions through Pi's status API (`showSkills` retains its existing setting name; it does not discover installed skills)
-- **Git branch** — current branch name
-- **Model** — active model ID
-- **Context usage** — tokens used / context window (e.g., `12/128k`). After compaction, Pi reports usage as unknown (`?`) until a subsequent model response.
-- **Provider quota** — the right end shows the selected provider's shortest available quota as a Braille bar and local reset time in 24-hour `HH:mm` format, when reported.
-
-The directory and git branch stay together on the left. Extension statuses, model, context usage, and quota stay on the right, with extra spacing before the quota. Statuses and location are muted; the model is bold.
-
-On narrow terminals, the directory and statuses shorten or disappear, then the branch disappears. The quota bar shrinks before model/context is shortened, preserving the reset time. The footer always uses one line.
-
-The footer appears only in Pi's interactive terminal UI, not in print, JSON, or RPC modes.
-
-### Provider usage limits
-
-The footer displays only the selected provider's shortest available quota window, typically five hours. If only a weekly or monthly quota is available, it displays that quota. This measures account quota used, separately from the model's context usage (`12/128k`).
-
-| Provider | Quota selection |
-|---|---|
-| OpenAI Codex (`openai-codex`) | Shortest primary/secondary window |
-| Claude (`anthropic`, OAuth) | Five-hour window, or weekly if that is all that is reported |
-| GitHub Copilot (`github-copilot`) | Limited premium/chat quota; unlimited buckets are hidden |
-| Gemini CLI (`google-gemini-cli`) | Selected model's quota, with Pro/Flash family fallback |
-| MiniMax (`minimax`, `minimax-cn`) | General text bucket's shortest interval/weekly window |
-| Kimi Coding (`kimi-coding`) | Shortest reported window, or weekly fallback |
-| OpenCode Go (`opencode-go`) | Shortest rolling/weekly/monthly window |
-
-The adapters reuse the selected provider's authentication from Pi. Claude subscription quota requires OAuth; ordinary Claude API keys do not expose it. Copilot's quota endpoint uses the GitHub login token from Pi's configured agent directory or `COPILOT_GITHUB_TOKEN`. Gemini CLI needs a configured provider/model; Pi 1.0.3 does not include that provider in its built-in catalog.
-
-The usage segment contains only a five-cell Braille bar and its reset time:
-
-```text
-⣿⣶⠀⠀⠀ ↻16:40
-```
-
-This example shows 35% used. `↻16:40` means the quota resets at 16:40 in your local timezone: an absolute 24-hour time, not a countdown. No provider name, window label, percentage, or date is displayed.
-
-If the provider does not report a reset time, only the bar is shown:
-
-```text
-⣿⣶⠀⠀⠀
 ```
 
-Each cell uses comic-style dot shading, starting from the bottom:
-
-| Cell | Fill |
-|---|---|
-| `⠀` | Empty |
-| `⡀` | One-eighth |
-| `⣀` | Quarter |
-| `⣄` | Three-eighths |
-| `⣤` | Half |
-| `⣦` | Five-eighths |
-| `⣶` | Three-quarter |
-| `⣷` | Seven-eighths |
-| `⣿` | Full |
-
-Each step adds one dot from the bottom upward. Five cells provide 2.5% steps, rounded to the nearest step; only the last partially filled cell uses an intermediate state. Filled cells are green below 85%, amber from 85%, and red from 92%. On narrow terminals the bar shrinks to preserve the reset time, so its steps become coarser.
-
-Usage refreshes from Codex response headers/stream events and Claude quota response headers when available. Otherwise, the footer checks the selected provider's usage endpoint on startup or provider switch, then every four minutes without a fresh response update. It also checks when a reported reset time arrives. These checks make no model requests.
-
-Partial response updates are merged with cached windows. A weekly-only update keeps the cached five-hour quota visible and does not postpone its refresh. Authentication, fetching, and response parsing share a five-second timeout; a stalled lookup or body read releases the request and allows the next scheduled attempt. Late results cannot restore a previous provider's quota.
-
-Codex endpoint responses can supply either an absolute reset timestamp or a relative reset delay. Kimi quotas accept either used or remaining counts, including week/month durations. Invalid optional reset metadata leaves the bar visible without a time.
-
-Switching providers immediately clears the previous quota, cancels its requests and timers, and ignores late results. Switching back fetches fresh data. Gemini model switches also refresh the model-specific quota. A previous provider's bar never remains visible while the new provider loads.
-
-Local models, unsupported providers, and sessions without a selected model show no usage segment and make no usage requests. Missing credentials or a successful usage response without an applicable quota hide the segment, including any previously cached bar. Zero usage still displays an empty bar, with its reset time when available.
-
-If a refresh fails temporarily or returns malformed quota data, the current provider's last known bar is dimmed until fresh data arrives; without cached data, the segment stays hidden. Explicit empty or unlimited quota responses clear the cached bar. Requests and timers also stop when the footer is disabled, disposed, or the session shuts down. Custom proxy endpoints are not polled. Live quota availability depends on each provider's endpoint; unavailable endpoints stay silent.
-
-The adapters have automated parsing and lifecycle coverage, but authenticated provider endpoints have not been tested live. In particular, OpenCode Go's bearer-token response format and Copilot's public quota endpoint and enterprise compatibility remain unverified. The comparison with [mtrojnar/pi-usage](https://github.com/mtrojnar/pi-usage) informed the timeout, validation, and partial-update handling; its OpenCode implementation uses an authenticated dashboard instead.
-
-### Credits
-
-Honorable mention and thanks to **Can Celik (@ogulcancelik)**: the provider usage-fetching and quota-parsing logic was **copied and adapted from [@ogulcancelik/pi-minimal-footer](https://pi.dev/packages/@ogulcancelik/pi-minimal-footer)**. This footer keeps its minimal layout, five-cell bottom-up Braille display, and four-minute refresh behavior. The upstream MIT copyright and license are retained in [extensions/lib/LICENSE](extensions/lib/LICENSE).
-
 ## Commands
 
-| Command | Description |
+| Command | Action |
 |---|---|
-| `/minfooter` | Toggle the extension on/off |
+| `/minfooter` | Toggle footer |
 | `/minfooter on` | Enable |
 | `/minfooter off` | Disable |
 
-> The `/minfooter` command only toggles the `enabled` flag. To show or hide individual segments, edit the agent settings file directly.
-
-## Configuration
+## Settings
 
-Settings live in Pi's configured agent directory, in `settings.json` under the `minFooter` key (normally `~/.pi/agent/settings.json`). The footer reads settings on session start and when `/minfooter` is run; external edits do not take effect until one of those actions (there is no file watcher). Unrelated settings are preserved when toggling.
+Edit `minFooter` in Pi's agent `settings.json` (normally `~/.pi/agent/settings.json`). All defaults are shown below. Apply edits with `/reload` or `/minfooter on`.
 
 ```json
 {
@@ -146,7 +47,30 @@ Settings live in Pi's configured agent directory, in `settings.json` under the `
     "showSkills": true,
     "showPath": true,
     "showModel": true,
-    "showContext": true
+    "showContext": true,
+    "powerlineSeparator": true
   }
 }
 ```
+
+- `showSkills` shows **extension status text**, not installed skills. The footer does not add the example statuses itself.
+- Set `powerlineSeparator` to `false` for plain spaces instead of `` / `` if your font lacks those glyphs. The git icon `` also needs a compatible font; hide it with `showGitBranch: false` if needed.
+- Context `42/200k` means tokens used / context window. `?` means Pi has not reported usage yet, including immediately after compaction.
+
+## Reading quota
+
+`⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀↻1d8h` shows **account quota used**, not context usage.
+
+- Bar: 5–10 cells, expanding into spare space; green below 85%, amber from 85%, red from 92%. Dim means cached after a refresh failure. Very narrow terminals may show fewer cells or only the reset label.
+- Reset: local `↻HH:mm` through 24 hours; whole days/hours above 24 hours (`↻1d8h`); whole days above 10 days (`↻12d`). Remaining durations round down. No reset reported means bar only.
+- Shows the shortest available quota window for the selected provider. Missing credentials, unsupported/local models, or absent limits hide quota. Custom proxy endpoints are not polled.
+
+Supported adapters: **OpenAI Codex, Claude OAuth, GitHub Copilot, Gemini CLI, MiniMax, Kimi Coding, and OpenCode Go**. Uses Pi's existing credentials; ordinary Claude API keys do not expose subscription quota. Provider availability varies; authenticated endpoints remain unverified live.
+
+## Development & design
+
+See [VISION.md](VISION.md) for design constraints, local development, provider details, and verification limits. Release history: [CHANGELOG.md](CHANGELOG.md).
+
+## Credits
+
+Provider usage-fetching and parsing logic **copied and adapted from [Can Celik (@ogulcancelik)'s pi-minimal-footer](https://pi.dev/packages/@ogulcancelik/pi-minimal-footer)**. Upstream MIT attribution is retained in [extensions/lib/LICENSE](extensions/lib/LICENSE).

package/VISION.md

@@ -0,0 +1,106 @@
+# Vision & developer guide
+
+## Purpose
+
+An opinionated footer that answers three questions at a glance: where am I, what is running, and how close am I to a limit? Keep one line, avoid redundant labels, and never exceed the terminal width.
+
+The [README](README.md) is the user manual. This document records current design and contributor guidance—not a speculative roadmap.
+
+## Layout contract
+
+- Directory and git branch form the left group, separated by ``.
+- Each extension status is its own `` tab. Preserve the supplied text; do not invent status labels, parentheses, or pipes.
+- Model, context, and quota form the rightmost group, separated by ` · `. Model identifies the running engine; context describes its usage; quota stays anchored at the right edge.
+- Powerline separators are dim. `powerlineSeparator: false` replaces them with a single space. Font availability cannot be detected reliably.
+- Measure terminal columns with `visibleWidth`, not string length. Preserve ANSI styling and wide-character accounting when truncating.
+
+### Space allocation
+
+Reserve quota and model/context before allocating location and statuses. Statuses and location may shorten or disappear; on sufficiently narrow terminals, model/context can also shorten or disappear.
+
+Lay out other fields with a five-cell quota bar first. Grow the bar only into leftover columns, up to ten cells—never truncate another field solely to enlarge it. At extreme widths, shrink below five cells, show only the reset label, or hide quota if the label cannot fit.
+
+Five cells give 2.5% steps; ten give 1.25%. Fill rounds to the nearest eighth-cell step. Only the final partially filled cell uses an intermediate shade:
+
+| Cell | Fill |
+|---|---|
+| `⠀` | Empty |
+| `⡀` | One-eighth |
+| `⣀` | Quarter |
+| `⣄` | Three-eighths |
+| `⣤` | Half |
+| `⣦` | Five-eighths |
+| `⣶` | Three-quarter |
+| `⣷` | Seven-eighths |
+| `⣿` | Full |
+
+The bar and reset label have no intervening space. Reset formatting uses local clock time through 24 hours, remaining whole days/hours above 24 hours, and whole days above 10 days. Exactly 24 hours stays clock time; exactly 10 days is `↻10d0h`. Missing reset metadata leaves the bar visible without a label.
+
+## Quota contract
+
+Display only the selected provider's shortest applicable window. Account quota and model context usage are separate measurements.
+
+| Provider | Selection / caveat |
+|---|---|
+| OpenAI Codex (`openai-codex`) | Shortest primary/secondary window; supports absolute reset timestamps and relative reset delays |
+| Claude (`anthropic`, OAuth) | Five-hour window, or weekly fallback; ordinary API keys do not expose subscription quota |
+| GitHub Copilot (`github-copilot`) | Most-used limited quota bucket; unlimited buckets hidden |
+| Gemini CLI (`google-gemini-cli`) | Selected model, with Pro/Flash family fallback; needs a configured provider/model |
+| MiniMax (`minimax`, `minimax-cn`) | Prefer general bucket, then active bucket, then first bucket; shortest interval/weekly window |
+| Kimi Coding (`kimi-coding`) | Shortest available window; accepts used or remaining counts and week/month durations |
+| OpenCode Go (`opencode-go`) | Shortest rolling/weekly/monthly window |
+
+Reuse Pi's selected-provider credentials. Copilot uses the GitHub login token from Pi's configured agent directory or `COPILOT_GITHUB_TOKEN`. Pi 1.0.3 does not include Gemini CLI in its built-in model catalog. Do not poll custom proxy endpoints or make model requests to obtain usage.
+
+### Refresh and failure behavior
+
+- Consume passive Codex response headers/stream events and Claude quota headers when available.
+- Otherwise fetch on startup/provider switch, then every four minutes without a fresh response update; also refresh at the reported reset time.
+- Merge partial windows. A weekly-only signal must not replace a cached shorter window or postpone its refresh.
+- Bound authentication, fetch, and response-body parsing by a shared five-second timeout. Release stalled work so polling can recover.
+- Provider switches clear quota immediately, cancel pending work, and invalidate late results. Gemini model switches also refresh model-specific quota.
+- Missing credentials and explicit empty/unlimited responses clear quota. Temporary authentication, network, or parsing failures retain only the current provider's cached quota, dimmed; without cache, hide it.
+- Invalid optional reset metadata must not discard otherwise valid usage. Zero usage is an empty bar, not an absent quota.
+- Stop requests and timers on disable, disposal, and session shutdown.
+
+### Verification limits
+
+Parsing and lifecycle behavior have automated coverage. Authenticated provider endpoints have **not** been tested live. OpenCode Go's bearer-token response format and Copilot's public endpoint/enterprise compatibility remain unverified.
+
+The comparison with [mtrojnar/pi-usage](https://github.com/mtrojnar/pi-usage) informed timeout, validation, and partial-update handling; its OpenCode implementation uses an authenticated dashboard rather than this adapter's bearer-token endpoint.
+
+## Local development
+
+Requires Node.js >=22.19.0. Tests currently use Pi 1.0.3 and mock provider requests.
+
+```bash
+npm ci
+npm run check
+npm test
+
+# Isolated interactive preview; Pi loads TypeScript directly, no build needed:
+pi --no-extensions -e ./extensions/index.ts
+```
+
+Use `/reload` after edits. For a persistent development install:
+
+```bash
+ln -s "$PWD/extensions" ~/.pi/agent/extensions/minimal-footer
+```
+
+For a manual install, copy `extensions/*` into `~/.pi/agent/extensions/`.
+
+### Code map
+
+- `extensions/index.ts`: settings, state refresh, layout, footer lifecycle, and `/minfooter`.
+- `extensions/lib/usage-limits.ts`: quota refresh, cache, cancellation, and bar/reset rendering.
+- `extensions/lib/quota-providers.ts`: authentication, endpoint selection, and response normalization.
+- `tests/`: loader-based lifecycle/layout regression tests and quota parsing tests.
+
+Settings live under `minFooter` in Pi's configured agent directory. Read them at session start or explicit toggle; ordinary refreshes use cached settings. Preserve unrelated settings on writes. Only install the footer in interactive terminal mode.
+
+### Checking changes
+
+For behavior changes, run `npm run check` and `npm test`. Layout tests should cover narrow widths, ANSI text, wide Unicode, field priority, and both separator modes. Quota changes should cover provider switches, timeouts, stale cache, partial updates, and malformed/missing metadata as applicable. Preview in a real terminal for font-dependent appearance; automated width checks cannot prove glyph availability.
+
+Keep release notes in [CHANGELOG.md](CHANGELOG.md), and keep the README focused on installation and daily use. Preserve [upstream MIT attribution](extensions/lib/LICENSE) when changing adapted provider code.

package/extensions/index.ts

@@ -1,7 +1,7 @@
 /**
  * Minimal footer — replaces pi's default footer with a clean status line:
  *
- *   ~/path/to/dir   main       (status1 | status2)  sonnet  12/128k    ⣿⣶⠀⠀⠀ ↻16:40
+ *   ~/path/to/dir   main        status1  status2  sonnet · 12/128k · ⣿⣶⠀⠀⠀↻16:40
  *
  * Settings are persisted in the agent directory (usually ~/.pi/agent)
  * settings.json under "minFooter".
@@ -17,7 +17,7 @@ import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { join, dirname, sep } from "node:path";
 import { homedir } from "node:os";
-import { UsageLimits } from "./lib/usage-limits.js";
+import { BASE_BAR_CELLS, MAX_BAR_CELLS, UsageLimits } from "./lib/usage-limits.js";
 
 // ── Settings ──────────────────────────────────────────────────────────
 
@@ -29,6 +29,7 @@ interface Settings {
     showPath?: boolean;
     showModel?: boolean;
     showContext?: boolean;
+    powerlineSeparator?: boolean;
   };
 }
 
@@ -41,6 +42,7 @@ const DEFAULT_SETTINGS: FooterSettings = {
   showPath: true,
   showModel: true,
   showContext: true,
+  powerlineSeparator: true,
 };
 
 function settingsPath(): string {
@@ -50,7 +52,10 @@ function settingsPath(): string {
 function readSettings(): Settings {
   try {
     if (!existsSync(settingsPath())) return {};
-    return JSON.parse(readFileSync(settingsPath(), "utf-8")) as Settings;
+    const settings: unknown = JSON.parse(readFileSync(settingsPath(), "utf-8"));
+    // Valid JSON can still be null or a scalar; a broken preference file must not prevent loading.
+    if (settings === null || typeof settings !== "object" || Array.isArray(settings)) return {};
+    return settings as Settings;
   } catch {
     return {};
   }
@@ -63,7 +68,7 @@ function writeSettings(patch: Partial<Settings>): void {
     const current = readSettings();
     writeFileSync(path, JSON.stringify({ ...current, ...patch }, null, 2) + "\n");
   } catch {
-    // best-effort
+    // A read-only settings file must not crash the extension.
   }
 }
 
@@ -127,56 +132,60 @@ function updateState(ctx: ExtensionContext, state: FooterState): void {
 // Keep quota and reset time together; shorten location/statuses before model/context.
 // All segment measurements use visible widths, including ANSI and wide characters.
 
-const SEGMENT_GAP = "  ";
-const QUOTA_GAP = "    ";
+const MODEL_GAP = " · ";
+const QUOTA_GAP = " · ";
 const LOCATION_GAP_WIDTH = 3;
-const FULL_QUOTA_WIDTH = 12;
-const COMPACT_QUOTA_WIDTH = 11;
 const MIN_TEXT_WIDTH = 4;
 const MIN_STATUS_WIDTH = 12;
 
-function buildLine(width: number, path: string, statuses: string, branch: string, model: string, context: string,
-  usage: (available: number) => string | null): string {
+function buildLine(
+  width: number, path: string, statuses: string, branch: string, model: string, context: string,
+  usage: (available: number, maxCells?: number) => string | null,
+  statusSeparator: string, locationSeparator: string,
+): string {
   if (width <= 0) return "";
-  let core = [model, context].filter(Boolean).join(SEGMENT_GAP);
-  let quota = usage(Math.min(FULL_QUOTA_WIDTH, width)) ?? "";
-  const availableQuotaWidth = width - visibleWidth(core) - QUOTA_GAP.length;
-  if (quota && visibleWidth(quota) > availableQuotaWidth) {
-    const compactWidth = Math.min(width, Math.max(COMPACT_QUOTA_WIDTH, availableQuotaWidth));
-    quota = usage(compactWidth) ?? "";
-  }
+  let core = [model, context].filter(Boolean).join(MODEL_GAP);
+  // Budget the compact bar first; its expanded size must not drive truncation decisions.
+  const quota = usage(width) ?? "";
   const quotaGapWidth = quota && core ? QUOTA_GAP.length : 0;
   const coreBudget = Math.max(0, width - visibleWidth(quota) - quotaGapWidth);
   if (quota && coreBudget < MIN_TEXT_WIDTH) {
     core = "";
-    quota = usage(Math.min(FULL_QUOTA_WIDTH, width)) ?? "";
   } else if (visibleWidth(core) > coreBudget) {
-    const modelGapWidth = model && context ? SEGMENT_GAP.length : 0;
+    const modelGapWidth = model && context ? MODEL_GAP.length : 0;
     const modelBudget = coreBudget - visibleWidth(context) - modelGapWidth;
     if (modelBudget > 0) {
-      core = [truncateToWidth(model, modelBudget, "..."), context].filter(Boolean).join(SEGMENT_GAP);
+      core = [truncateToWidth(model, modelBudget, "..."), context].filter(Boolean).join(MODEL_GAP);
     } else {
       core = truncateToWidth(context || model, coreBudget, "...");
     }
   }
   const protectedRight = [core, quota].filter(Boolean).join(QUOTA_GAP);
   const branchReservation = branch ? visibleWidth(branch) + LOCATION_GAP_WIDTH : 0;
-  const statusBudget = width - visibleWidth(protectedRight) - branchReservation - SEGMENT_GAP.length;
+  const statusBudget = width - visibleWidth(protectedRight) - branchReservation - visibleWidth(statusSeparator);
   let fittedStatuses = "";
   if (statusBudget >= MIN_STATUS_WIDTH) {
     fittedStatuses = statuses;
     if (visibleWidth(statuses) > statusBudget) {
-      fittedStatuses = truncateToWidth(statuses, statusBudget - 1, "...") + ")";
+      fittedStatuses = truncateToWidth(statuses, statusBudget, "...");
     }
   }
-  const right = [fittedStatuses, protectedRight].filter(Boolean).join(SEGMENT_GAP);
-  const locationGapWidth = right ? LOCATION_GAP_WIDTH : 0;
-  const leftBudget = Math.max(0, width - visibleWidth(right) - locationGapWidth);
+  let right = [fittedStatuses, protectedRight].filter(Boolean).join(statusSeparator);
+  const reservedLocationGapWidth = right ? LOCATION_GAP_WIDTH : 0;
+  const leftBudget = Math.max(0, width - visibleWidth(right) - reservedLocationGapWidth);
   const fittedBranch = visibleWidth(branch) <= leftBudget ? branch : "";
-  const pathGapWidth = fittedBranch && path ? SEGMENT_GAP.length : 0;
+  const pathGapWidth = fittedBranch && path ? visibleWidth(locationSeparator) : 0;
   const pathBudget = leftBudget - visibleWidth(fittedBranch) - pathGapWidth;
   const fittedPath = pathBudget >= MIN_TEXT_WIDTH ? truncateToWidth(path, pathBudget, "...") : "";
-  const left = [fittedPath, fittedBranch].filter(Boolean).join(SEGMENT_GAP);
+  const left = [fittedPath, fittedBranch].filter(Boolean).join(locationSeparator);
+  if (quota) {
+    // A dropped left group needs no divider; those columns belong to the quota bar instead.
+    const interGroupGapWidth = left && right ? LOCATION_GAP_WIDTH : 0;
+    const spareWidth = Math.max(0, width - visibleWidth(left) - visibleWidth(right) - interGroupGapWidth);
+    const expandedQuota = usage(visibleWidth(quota) + spareWidth, MAX_BAR_CELLS) ?? quota;
+    const expandedCore = [core, expandedQuota].filter(Boolean).join(QUOTA_GAP);
+    right = [fittedStatuses, expandedCore].filter(Boolean).join(statusSeparator);
+  }
   return left + " ".repeat(Math.max(0, width - visibleWidth(left) - visibleWidth(right))) + right;
 }
 
@@ -190,6 +199,12 @@ export default function (pi: ExtensionAPI) {
   let disposeFooter: (() => void) | null = null;
   const usageLimits = new UsageLimits(() => requestRender?.());
 
+  function selectUsage(ctx: ExtensionContext): void {
+    // The preference may remain enabled after another extension replaces our footer.
+    // Poll only while we own a live renderer, or model changes can resurrect hidden requests.
+    usageLimits.select(ctx, enabled && disposeFooter !== null);
+  }
+
   function install(ctx: ExtensionContext): void {
     config = readConfig();
     enabled = config.enabled !== false;
@@ -210,6 +225,7 @@ export default function (pi: ExtensionAPI) {
         if (disposed) return;
         disposed = true;
         unsub();
+        // A superseded renderer must not stop its replacement's quota polling.
         if (requestRender === request) {
           requestRender = null;
           usageLimits.stop();
@@ -220,18 +236,21 @@ export default function (pi: ExtensionAPI) {
 
       return {
         render(width: number): string[] {
-          const skills = config.showSkills
+          const statuses = config.showSkills
             ? [...footerData.getExtensionStatuses().values()].filter((s) => s.trim())
             : [];
           const branch = config.showGitBranch ? footerData.getGitBranch() : null;
+          const statusSeparator = config.powerlineSeparator ? theme.fg("dim", "  ") : " ";
           const line = buildLine(
             width,
             config.showPath ? theme.fg("dim", abbreviateHome(state.cwd, homedir())) : "",
-            skills.length ? theme.fg("dim", `(${skills.join(" | ")})`) : "",
+            statuses.length ? statusSeparator + statuses.map((status) => theme.fg("dim", status)).join(statusSeparator) : "",
             branch ? theme.fg("dim", ` ${branch}`) : "",
             config.showModel ? theme.bold(state.model) : "",
             config.showContext ? theme.fg("dim", theme.bold(state.context)) : "",
-            (available) => usageLimits.line(available, theme),
+            (available, maxCells = BASE_BAR_CELLS) => usageLimits.line(available, theme, maxCells),
+            statusSeparator,
+            config.powerlineSeparator ? theme.fg("dim", "  ") : " ",
           );
           return [line];
         },
@@ -239,7 +258,7 @@ export default function (pi: ExtensionAPI) {
         dispose,
       };
     });
-    usageLimits.select(ctx, enabled);
+    selectUsage(ctx);
   }
 
   /** Cheap refresh: update plain state and request one render. */
@@ -257,7 +276,7 @@ export default function (pi: ExtensionAPI) {
   });
 
   pi.on("model_select", async (_event, ctx) => {
-    usageLimits.select(ctx, enabled);
+    selectUsage(ctx);
     refresh(ctx);
   });
 

package/extensions/lib/usage-limits.ts

@@ -6,6 +6,29 @@ import { parseUsageWindows, record, shortest, supportedOrigin, usageRequest, win
 import type { QuotaWindow } from "./quota-providers.js";
 
 const REFRESH_MS = 4 * 60_000;
+const REQUEST_TIMEOUT_MS = 5000;
+const HOUR_MS = 60 * 60_000;
+const DAY_MS = 24 * HOUR_MS;
+const CELL_STEPS = 8;
+const PARTIAL_CELL_FILLS = ["", "⡀", "⣀", "⣄", "⣤", "⣦", "⣶", "⣷"];
+
+// Start compact so extra precision never steals space from the other footer fields.
+export const BASE_BAR_CELLS = 5;
+export const MAX_BAR_CELLS = 10;
+
+function formatResetLabel(resetAt: number | null, now: number): string {
+  if (resetAt === null) return "";
+  const remaining = resetAt - now;
+  // Clock time loses the day for distant resets; minutes add noise at that scale.
+  if (remaining > 10 * DAY_MS) return `↻${Math.floor(remaining / DAY_MS)}d`;
+  if (remaining > DAY_MS) {
+    const days = Math.floor(remaining / DAY_MS);
+    const hours = Math.floor(remaining % DAY_MS / HOUR_MS);
+    return `↻${days}d${hours}h`;
+  }
+  const date = new Date(resetAt);
+  return `↻${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
 
 function abortable<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {
   return new Promise((resolve, reject) => {
@@ -15,7 +38,7 @@ function abortable<T>(promise: Promise<T>, signal: AbortSignal): Promise<T> {
     };
     signal.addEventListener("abort", abort, { once: true });
     if (signal.aborted) abort();
-    // Observe late failures even after abort has settled the caller's await.
+    // Credential and body promises may ignore abort; observe late failures to avoid unhandled rejections.
     promise.then((value) => {
       signal.removeEventListener("abort", abort);
       resolve(value);
@@ -179,9 +202,10 @@ export class UsageLimits {
     const provider = this.provider!;
     const modelId = model.id;
     const controller = new AbortController();
+    // Identity checks below keep late responses from restoring a replaced provider's quota.
     this.request = controller;
     this.attemptedAt = Date.now();
-    const timeout = setTimeout(() => controller.abort(), 5000);
+    const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
     timeout.unref();
     try {
       const request = await abortable(usageRequest(ctx, model), controller.signal);
@@ -208,18 +232,19 @@ export class UsageLimits {
     }
   }
 
-  line(width: number, theme: Theme): string | null {
+  line(width: number, theme: Theme, maxCells = MAX_BAR_CELLS): string | null {
     const window = this.selectedWindow()?.[1];
-    if (!this.ctx || !window || width < (window.resetAt === null ? 1 : 6)) return null;
-    const date = window.resetAt === null ? null : new Date(window.resetAt);
-    const time = date ? `↻${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}` : "";
-    const cells = Math.min(5, Math.max(0, width - (time ? 7 : 0)));
-    const steps = Math.round(window.used / 100 * cells * 8);
-    const filled = "⣿".repeat(Math.floor(steps / 8)) + ["", "⡀", "⣀", "⣄", "⣤", "⣦", "⣶", "⣷"][steps % 8];
-    const empty = "⠀".repeat(cells - Math.ceil(steps / 8));
-    const stale = this.stale || (window.resetAt !== null && Date.now() >= window.resetAt);
+    if (!this.ctx || !window) return null;
+    const now = Date.now();
+    const resetLabel = formatResetLabel(window.resetAt, now);
+    if (width < (resetLabel.length || 1)) return null;
+    const cells = Math.min(maxCells, Math.max(0, width - resetLabel.length));
+    const steps = Math.round(window.used / 100 * cells * CELL_STEPS);
+    const filled = "⣿".repeat(Math.floor(steps / CELL_STEPS)) + PARTIAL_CELL_FILLS[steps % CELL_STEPS];
+    const empty = "⠀".repeat(cells - Math.ceil(steps / CELL_STEPS));
+    const stale = this.stale || (window.resetAt !== null && now >= window.resetAt);
     const color = stale ? "dim" : window.used >= 92 ? "error" : window.used >= 85 ? "warning" : "success";
-    const bar = cells ? theme.fg(color, filled) + theme.fg("dim", empty) + (time ? " " : "") : "";
-    return bar + theme.fg("dim", time);
+    const bar = cells ? theme.fg(color, filled) + theme.fg("dim", empty) : "";
+    return bar + theme.fg("dim", resetLabel);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-minimal-footer",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "An opinionated minimal footer extension for Pi — clean status line with path, extension statuses, model, and context usage.",
   "keywords": [
     "pi-package",
@@ -20,6 +20,7 @@
     "extensions/",
     "LICENSE",
     "README.md",
+    "VISION.md",
     "package.json",
     "media/"
   ],