@aemonge-dev/pi-stardeck 0.0.0-stage → 0.5.0

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "@aemonge-dev/pi-stardeck",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.0",
+  "description": "A Vim- and tmux-inspired command deck for Pi",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "vim",
+    "tmux",
+    "cockpit"
+  ],
+  "license": "MIT",
+  "files": [
+    "README.md",
+    "docs/architecture.md",
+    "docs/development.md",
+    "docs/assets/pi-stardeck.gif",
+    "demo/pi-stardeck.tape",
+    "licenses",
+    "src/*.ts",
+    "!src/local-load-probe.ts",
+    "packages/*/*.ts",
+    "packages/*/src/**/*.ts",
+    "!packages/*/src/**/*.test.ts",
+    "packages/*/package.json",
+    "packages/*/README.md",
+    "packages/*/LICENSE",
+    "packages/*/LOCAL-CHANGES.md"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "format": "prettier --write . --ignore-path .prettierignore",
+    "format:check": "prettier --check . --ignore-path .prettierignore",
+    "lint": "biome check --config-path=biome.json packages/pi-vim-top-border && eslint packages scripts src test",
+    "typecheck": "tsc --noEmit && npm run typecheck --workspaces --if-present",
+    "test": "npm run test:tooling && npm run test:components",
+    "check": "npm run check:baseline && npm run check:package:load && npm run format:check && npm run lint && npm run typecheck && npm test && npm run check:composition && npm run check:openspec",
+    "check:baseline": "node scripts/check-baseline.mjs",
+    "check:package": "node scripts/check-package.mjs",
+    "check:package:load": "node scripts/check-package.mjs --load",
+    "check:composition": "node --import tsx/esm src/local-load-probe.ts",
+    "check:openspec": "node scripts/check-openspec.mjs",
+    "test:tooling": "node --import tsx/esm --test test/*.test.ts",
+    "test:status": "npm --prefix packages/status test",
+    "test:stardeck": "npm --prefix packages/pi-stardeck test",
+    "test:footer": "npm --prefix packages/pi-fancy-footer-full-palette test",
+    "test:vim": "npm --prefix packages/pi-vim-top-border test",
+    "test:components": "npm run test:status && npm run test:stardeck && npm run test:footer && npm run test:vim"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.8",
+    "@earendil-works/pi-ai": "0.84.4",
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
+    "@eslint/js": "9.39.5",
+    "@types/node": "24.13.3",
+    "eslint": "9.39.5",
+    "lefthook": "2.1.12",
+    "prettier": "3.9.6",
+    "tsx": "4.23.13",
+    "typebox": "1.3.25",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.69.0"
+  },
+  "pi": {
+    "image": "docs/assets/pi-stardeck.gif",
+    "extensions": [
+      "./src/index.ts"
+    ]
+  }
+}

package/packages/pi-fancy-footer-full-palette/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthias Vallentin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/packages/pi-fancy-footer-full-palette/LOCAL-CHANGES.md

@@ -0,0 +1,41 @@
+# Local changes
+
+This is a Galactica-managed local fork of `pi-fancy-footer` 3.0.1.
+
+## Full Pi theme palette
+
+The extension-widget and configuration color schema accepts Pi's complete foreground
+theme-token palette instead of limiting footer widgets to seven generic colors. This
+lets Galactica use the configured cyan, purple, orange, green, red, and teal palette
+without embedding ANSI escapes or falling back to gray text.
+
+## Extension-widget emphasis
+
+Protocol-1 extension widgets accept `style.bold: true`. The renderer applies
+theme-native bold after effective text-color resolution, allowing Galactica's PWD widget
+to stand out without embedding unsafe ANSI escapes or bolding its icon.
+
+## Compact metric presentation
+
+The `percent` provider-status display mode joins the most constrained known quota to the
+LLM group as `›  4%`, with no window analysis. Its five-state battery depletes from ``
+through `` and changes semantic color as remaining quota falls. Cache accounting
+remains available even when its persistent widget is disabled. Session cost uses a
+leading major `⟩`, no treasure-chest glyph, and compact trailing-zero-free formatting of
+Pi's native USD estimate (`$0`, `$0.1`, `$1`, or `$1.23`). Cache and cost remain neutral
+local telemetry instead of inheriting unrelated context-pressure warnings; context, CPU,
+and RAM own their warning colors independently. Galactica now keeps exactly one footer
+row: project PWD and Git state on the left, with model, reasoning, and quota on the
+right. On wide terminals, the footer ends with the four-cell tail `⟨ 󰠭` after model
+quota: a purple left-pointing boundary and the static violet ladybug as Ramona's compact
+avatar, with no trailing cell after her. The bounded tail keeps the avatar distinct
+without producing a large empty region. Work progress, cost, MCP availability, runtime,
+resources, and context are still published as bounded widget snapshots but are hidden
+from the footer and consumed by the prompt rails. The renderer omits trailing rows that
+contain no visible widgets, allowing the configured footer to occupy one terminal row
+without changing the upstream two-row default. Non-growing widgets continue to honor
+`minWidth` where configured.
+
+The package is loaded from `./packages/pi-fancy-footer-full-palette` in `settings.json`.
+Do not replace it with the npm package without first preserving the expanded
+`FOOTER_WIDGET_COLORS` contract. Run the package tests and `/reload` after updates.

package/packages/pi-fancy-footer-full-palette/README.md

@@ -0,0 +1,468 @@
+# ✨ pi-fancy-footer
+
+A [Pi](https://pi.dev) extension that replaces the default footer with a compact,
+configurable fancy status footer. Its defaults use two rows; trailing rows with no
+visible widgets are omitted, so a row-zero-only layout occupies exactly one row.
+
+<!-- markdownlint-disable MD033 -->
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="screenshots/editor-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="screenshots/editor-light.png">
+  <img alt="Pi editor with the fancy footer" src="screenshots/editor-light.png">
+</picture>
+
+<!-- markdownlint-enable MD033 -->
+
+## 🚀 Installation
+
+```sh
+pi install npm:pi-fancy-footer
+```
+
+## 📊 What it shows
+
+- Active model + thinking level, plus the model's provider (hidden by default)
+- Provider quota status for OpenAI Codex, Claude, and z.ai GLM models
+- A mini gauge of used context, which can optionally grow into a full-width bar, plus an
+  optional context-capacity widget (hidden by default)
+- Total session cost with compact trailing-zero-free USD formatting
+- Prompt-cache statistics: cumulative cache-read/write tokens and the latest turn's
+  cache hit rate
+- Current path, branch, and optional commit SHA (hidden by default)
+- Git diff stats and ahead/behind status
+
+Pull request widgets come from [pi-prs](https://github.com/mavam/pi-prs), which owns
+GitHub polling and publishes them into this footer.
+
+## 📸 Configuration editor
+
+<!-- markdownlint-disable MD033 -->
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="screenshots/config-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="screenshots/config-light.png">
+  <img alt="Fancy Footer configuration editor" src="screenshots/config-light.png">
+</picture>
+
+<!-- markdownlint-enable MD033 -->
+
+## 🎮 Commands
+
+- `/fancy-footer` - open interactive footer config editor (small TUI)
+    - widgets appear as a micro-view of the footer: same rows, alignment groups, and
+      ordering as the real footer, which updates live below
+    - use `←→↑↓` to select a widget (shown inverted), then:
+        - `l`/`r` - move it left/right; at a group edge it flows into the adjacent
+          alignment group (left ↔ middle ↔ right)
+        - `u`/`d` - move it up/down a row; `d` on the bottom row hides it into the
+          `hidden` strip, `u` from there brings it back
+        - `a` - cycle alignment (left → middle → right)
+        - `f` - toggle fill (`none` ↔ `grow`)
+        - `x` or Space - toggle visibility
+        - Enter - open widget-specific settings (visibility, icon, icon color, text
+          color, min width, and the provider-status reset threshold)
+    - arrow down past the widgets to reach the General settings (refresh, icon family,
+      gauge style/width/colors, default colors); Enter/Space cycles values
+
+## ⚙️ Configuration
+
+Create `~/.pi/agent/fancy-footer.json`:
+
+```json
+{
+    "refreshMs": 3000,
+    "iconFamily": "unicode",
+    "gaugeStyle": "blocks",
+    "gaugeWidth": 5,
+    "gaugeColors": {
+        "ok": "accent",
+        "warning": "warning",
+        "error": "error"
+    },
+    "defaultTextColor": "dim",
+    "defaultIconColor": "text",
+    "providerStatus": {
+        "refreshMs": 60000,
+        "cacheTtlMs": 60000,
+        "providers": ["openai-codex", "anthropic", "zai"],
+        "display": "gauge",
+        "showCredits": false,
+        "showReset": "all",
+        "resetMinUsedPercent": 75
+    },
+    "widgets": {
+        "context-bar": {
+            "align": "left",
+            "row": 0,
+            "position": 0,
+            "fill": "grow"
+        },
+        "total-cost": {
+            "enabled": false
+        },
+        "commit": {
+            "enabled": true
+        },
+        "branch": {
+            "icon": "hide",
+            "textColor": "muted"
+        }
+    },
+    "extensionWidgets": {
+        "acme.build-status": {
+            "row": 1,
+            "position": 8,
+            "align": "right"
+        }
+    }
+}
+```
+
+Top-level settings:
+
+> [!NOTE] `fancy-footer.json` is validated strictly. Use only the documented keys and
+> values. Invalid configuration falls back to defaults and logs a warning.
+
+> [!WARNING] `providerStatus.showReset` no longer accepts booleans. Before upgrading,
+> replace `true` with `"primary"` and `false` with `"off"`. An invalid value causes the
+> entire file to fall back to defaults.
+
+- `refreshMs` (number) - interval for background Git refreshes. Model, thinking-level,
+  provider-response, and extension-widget changes update from events without waiting for
+  this interval
+- `iconFamily` (`nerd` | `emoji` | `unicode` | `ascii`)
+- `gaugeStyle` (`blocks` | `lines` | `circles` | `parallelograms` | `diamonds` | `bars`
+  | `stars` | `specks`)
+- `gaugeWidth` - cells spanned by the provider status gauges and the compact context
+  gauge (3-40, default 5); a context bar with `fill` set to `grow` spans the row instead
+- `gaugeColors` - fill colors per gauge severity; each of `ok`, `warning`, and `error`
+  accepts a widget color. Defaults to `accent` / `warning` / `error`, so healthy gauges
+  blend into the theme and only stand out when running low
+- `defaultTextColor` (`text` | `accent` | `muted` | `dim` | `success` | `error` |
+  `warning`)
+- `defaultIconColor` (`text` | `accent` | `muted` | `dim` | `success` | `error` |
+  `warning`)
+- `providerStatus`:
+    - `refreshMs` - provider status refresh interval in milliseconds
+    - `cacheTtlMs` - cache freshness window in milliseconds
+    - `providers` - supported provider adapters (`openai-codex`, `anthropic`, `zai`)
+    - `display` - render quota windows as a mini `gauge` (default) or plain `text`
+    - `showCredits` - include a provider-specific credit balance when available
+    - `showReset` - control which relative reset countdowns are eligible:
+        - `"off"` - hide all countdowns
+        - `"primary"` - show the primary window countdown
+        - `"all"` - show every reported window countdown (default)
+    - `resetMinUsedPercent` - show an eligible countdown once its window reaches this
+      used quota percentage (0-100, default 75). The comparison is inclusive and uses
+      the displayed percentage. A window without a reported usage value counts as 0%.
+      Set this to `0` to always show eligible countdowns.
+
+Supported per-widget overrides for both `widgets` and `extensionWidgets`:
+
+- `enabled` (boolean)
+- `row` (number)
+- `position` (number, ordering within an aligned row group)
+- `align` (`left` | `middle` | `right`)
+- `fill` (`none` | `grow`)
+- `minWidth` (number)
+- `icon` (`default` | `hide`)
+- `iconColor` (`text` | `accent` | `muted` | `dim` | `success` | `error` | `warning`)
+- `textColor` (`text` | `accent` | `muted` | `dim` | `success` | `error` | `warning`)
+
+Built-in widget IDs:
+
+- `provider`
+- `model`
+- `thinking`
+- `context-capacity`
+- `context-bar`
+- `total-cost`
+- `cache-read`
+- `cache-write`
+- `cache-hit-rate`
+- `location`
+- `branch`
+- `commit`
+- `provider-status`
+- `diff-added`
+- `diff-removed`
+- `git-status`
+
+3rd-party widget IDs are extension-defined and live under `extensionWidgets`.
+
+Non-empty left, middle, and right alignment groups reserve four display cells between
+groups. `fill: "none"` widgets pad to `minWidth`, keeping following columns stable as
+content changes. When a row can fit at declared minimum widths, `fill: "grow"` widgets
+yield down to `minWidth` with an ANSI-safe `...` before fixed telemetry is truncated.
+This keeps the right group complete while retaining a visible left/right split.
+
+### Provider quota sources
+
+- `openai-codex` and `anthropic` read OAuth credentials from Pi's auth file (or
+  `~/.codex/auth.json` for Codex) and refresh them automatically.
+- `zai` reads a static API key from Pi's auth file (`zai.key`). The value may be a
+  literal key or a `${ENV_VAR}` reference resolved from the environment at runtime.
+  Quota comes from the z.ai monitor endpoint: the token or credit limit with the
+  nearest reset paints as the `5h` window and the next one as `7d`; the monthly
+  `TIME_LIMIT` allowance is not rendered. Without a key, offline, or on error the
+  provider fails soft and the quota widget stays hidden.
+
+  The telemetry channel also publishes the model-relevant quota windows (`5h` and
+  `7d` with used percent and reset deadline) alongside the collapsed single percent,
+  so deck surfaces can paint both windows as separate tiles.
+
+## 🧩 Extension widgets
+
+Other pi extensions can contribute fancy-footer widgets.
+
+### For users
+
+- Contributed widgets appear alongside built-in widgets in the `/fancy-footer`
+  micro-view.
+- Their overrides are stored in `extensionWidgets` inside
+  `~/.pi/agent/fancy-footer.json`.
+- They use the same layout controls as built-in widgets, so you can mix and match them
+  on any footer row.
+
+### For extension developers
+
+Publish complete widget snapshots over pi's in-process event bus. Producers do not need
+to depend on `pi-fancy-footer`:
+
+```ts
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+
+const protocol = 1;
+const widgetChannel = 'pi-fancy-footer:widget';
+const readyChannel = 'pi-fancy-footer:ready';
+
+export default function (pi: ExtensionAPI) {
+    let status = 'passing';
+
+    const publish = () => {
+        pi.events.emit(widgetChannel, {
+            protocol,
+            type: 'upsert',
+            widget: {
+                id: 'acme.build-status',
+                label: 'Build status',
+                description: 'Current build result',
+                content: {
+                    type: 'text',
+                    text: status,
+                    href: 'https://ci.example.com/builds/latest',
+                },
+                icon: {
+                    glyphs: {
+                        nerd: '󰙨',
+                        emoji: '🧪',
+                        unicode: '◈',
+                        ascii: 'B',
+                    },
+                    color: 'success',
+                },
+                style: { textColor: 'success', bold: true },
+                layout: { row: 1, position: 8, align: 'right' },
+            },
+        });
+    };
+
+    const stopReady = pi.events.on(readyChannel, (message) => {
+        if (
+            typeof message === 'object' &&
+            message !== null &&
+            'protocol' in message &&
+            message.protocol === protocol
+        ) {
+            publish();
+        }
+    });
+
+    // Publish once for a footer that is already listening. Publish again when
+    // state changes; the footer does not poll producers.
+    publish();
+
+    pi.on('session_shutdown', () => {
+        stopReady();
+        pi.events.emit(widgetChannel, {
+            protocol,
+            type: 'remove',
+            id: 'acme.build-status',
+        });
+    });
+}
+```
+
+The protocol uses these channels:
+
+- `pi-fancy-footer:widget` accepts protocol-1 `upsert` and `remove` messages.
+- `pi-fancy-footer:ready` announces that the footer is listening. Producers should
+  republish their current snapshot when they receive it.
+
+`style.bold: true` applies theme-native bold emphasis to widget text after its effective
+text color is resolved; icons remain independently styled.
+
+Each `upsert` replaces the complete snapshot for its `id`; the latest command wins if
+multiple producers use the same ID. IDs must be at most 128 ASCII characters and contain
+two or more dot-separated segments. Each segment starts with a letter or digit and may
+also contain letters, digits, underscores, and hyphens, for example `acme.build-status`.
+An empty `content.text` creates an icon-only widget when the selected icon family has a
+glyph. Widgets with `layout.enabled: false` stay hidden while their text is empty, even
+when a user enables them. This keeps opt-in activity widgets out of the footer while
+they have nothing to report. Without a glyph, an empty widget also stays hidden. Set
+`content.href` to an HTTP or HTTPS URL to make the complete widget, including its icon,
+clickable. Invalid links are omitted without dropping the widget update. A `remove`
+message drops the live widget definition. Widget text is limited to 512 Unicode code
+points and terminal control characters are stripped.
+
+The structured snapshot can provide `label`, `description`, an icon glyph or per-family
+glyph map, icon and text colors, and layout defaults (`enabled`, `row`, `position`,
+`align`, `fill`, and `minWidth`). Saved user settings override event-provided defaults.
+Use `layout.enabled: false` for an opt-in widget.
+
+Extensions that already depend on this package may use `createFancyFooterClient` from
+`pi-fancy-footer/api` for typed `upsert`, `remove`, and `onReady` helpers. It speaks the
+same event protocol.
+
+## 🔣 Icon families
+
+The following table shows the symbol used by each widget for each icon family. For
+`git-status`, the table shows the rendered status symbols rather than a leading widget
+icon.
+
+> [!NOTE] Some glyphs, especially in the `nerd` family, may not render in your browser.
+> If a cell looks blank or shows a replacement box, check the table in a terminal with
+> the relevant font installed.
+
+<!-- markdownlint-disable MD013 MD060 -->
+
+| Widget             | nerd    | emoji      | unicode | ascii    |
+| ------------------ | ------- | ---------- | ------- | -------- |
+| `context-bar`      | `󰾆`     | `🔋`       | `◧`     | `\|`     |
+| `context-capacity` | ``     | `💾`       | `□`     | `[]`     |
+| `provider-status`  | `󰓅`     | `📊`       | `%`     | `%`      |
+| `cache-read`       | `󰇚`     | `📥`       | `↧`     | `R`      |
+| `cache-write`      | `󰕒`     | `📤`       | `↥`     | `W`      |
+| `cache-hit-rate`   | `󰀚`     | `🎯`       | `◎`     | `H`      |
+| `total-cost`       | `󰇁`     | `💲`       | `$`     | `$`      |
+| `location`         | ``     | `📁`       | `⌂`     | `/`      |
+| `branch`           | ``     | `🌿`       | `⎇`     | `*`      |
+| `commit`           | ``     | `🔖`       | `#`     | `#`      |
+| `diff-added`       | `↗`     | `➕`       | `+`     | `+`      |
+| `diff-removed`     | `↘`     | `➖`       | `−`     | `-`      |
+| `git-status`       | `//` | `🔼/🔽/🔀` | `↑/↓/↕` | `^/_/<>` |
+| `provider`         | `󰅟`     | `☁️`       | `☁`     | `&`      |
+| `model`            | `󰚩`     | `🤖`       | `◉`     | `%`      |
+| `thinking`         | `󰧑`     | `🧠`       | `✦`     | `?`      |
+
+<!-- markdownlint-enable MD013 MD060 -->
+
+Notes:
+
+- Most widgets use a leading icon.
+- `context-bar` renders a mini gauge of used context, e.g. `■■□□□ 40%`, spanning
+  `gaugeWidth` cells with the glyphs from `gaugeStyle` (not `iconFamily`). Filled cells
+  and the percentage show the consumed share and fill up from the left, colored via
+  `gaugeColors` by how close the context is to exhaustion; empty cells stay dim. It sits
+  on the left of the top row by default, with provider quota gauges beside it. Set the
+  widget's `fill` to `grow` (via `/fancy-footer` or the configuration file) to expand it
+  into a full-width bar with the used tokens in front, e.g. `246k ██████████░░░`.
+  Immediately after compaction, the gauge resets to empty (`0%`) while Pi waits for the
+  next model response to report post-compaction usage.
+- `context-capacity` shows the total context window in compact SI form (`200k`, `1M`).
+  It is hidden by default since the context bar already conveys usage; enable it via
+  `/fancy-footer` (it starts in the `hidden` strip) or with
+  `"context-capacity": { "enabled": true }`. It then sits between the context bar and
+  the provider quota gauges.
+- `commit` shows the short Git commit SHA. It is hidden by default; enable it via
+  `/fancy-footer` or with `"commit": { "enabled": true }`.
+- `provider` shows the display name of the active model's provider (`Anthropic`,
+  `OpenAI Codex`, …), which the model name alone does not reveal. Providers defined only
+  in `models.json` fall back to their id. The widget is hidden by default; enable it via
+  `/fancy-footer` or with `"provider": { "enabled": true }`. It then sits left of the
+  model on the bottom row.
+- `cache-read` and `cache-write` show cumulative prompt-cache tokens for the session in
+  compact form (e.g. `246k`, `1.2M`). `cache-hit-rate` shows the latest turn's cache hit
+  rate, computed as `cacheRead / (input + cacheRead + cacheWrite)`, matching the `R` /
+  `W` / `CH` stats in pi's built-in footer. All three sit on the right of the top row by
+  default, before `total-cost` (which stays rightmost), and hide when the session has no
+  cache activity or the terminal is narrower than 60 columns.
+- `total-cost` uses Pi's native estimated session cost and keeps useful nonzero
+  precision while removing trailing fractional zeros: `$0`, `$0.1`, `$1`, or `$1.23`.
+  Its text includes the major scope separator (`⟩ $1.23`); hide the built-in icon for
+  that exact presentation. Zero-cost sessions retain the widget's existing hidden
+  behavior.
+- `git-status` uses symbols for ahead / behind / diverged status.
+- `provider-status` shows provider quota windows for OpenAI Codex and Claude models as
+  mini gauges per window, for example `5h ▰▰▰▰▱ 80% ~1h12m 7d ▰▰▱▱▱ 38%`. Filled cells
+  show the used quota, growing from the left like the context bar, and each window is
+  colored by how close it is to exhaustion. In gauge mode, a dim reset countdown belongs
+  to the window immediately before it. The default `resetMinUsedPercent: 75` shows a
+  countdown only when that window is at least 75% used. The default `showReset: "all"`
+  makes every reported window eligible; use `"primary"` to allow only the primary window
+  or `"off"` to hide countdowns. You can change the threshold in the `provider-status`
+  widget's interactive settings. Set it to `0` to restore the previous always-show
+  behavior. The gauge spans `gaugeWidth` cells and reuses the configured `gaugeStyle`
+  glyphs. Set `providerStatus.display` to `text` for the compact
+  `qta 5h:80% ~1h12m 7d:38%` form. Text mode keeps the existing provider severity color
+  for the whole widget. The local `percent` mode shows only the most constrained known
+  usage as `›  80%`, omitting window analysis and reset countdowns. Its five-state
+  battery depletes from `` through `` as used quota rises, and changes from success to
+  warning to error as remaining quota falls. Countdown placement, thresholds, and modes
+  apply to Claude and Codex in gauge and text styles. The widget renders only the
+  windows that the provider reports. If Codex omits its 5-hour window and promotes the
+  weekly window to primary, the footer removes the stale 5-hour value and shows only
+  `7d`. Because that weekly window is primary, it receives a countdown under the default
+  mode. In an output such as `󰾆▱▱▱▱▱ 0% 󰓅7d ▰▰▰▰▱ 84% ~1d7h`, `0%` is the share of pi's
+  context window in use and `84%` is the used weekly Codex quota. Codex uses existing pi
+  OpenAI Codex credentials from `~/.pi/agent/auth.json`, falling back to Codex CLI
+  credentials in `~/.codex/auth.json`. Claude uses pi Anthropic OAuth credentials from
+  `~/.pi/agent/auth.json` and reads Claude.ai usage for the 5-hour and weekly windows.
+  When Claude reports a limit that applies only to the active model, such as the weekly
+  Fable cap, that window replaces the account-wide window with the same label instead of
+  adding a gauge, so `7d` shows the quota that actually limits the current model. The
+  stricter of the two always wins, because whichever runs out first ends the session,
+  and the value follows `/model` switches without another usage request. Status is
+  cached under `~/.cache/pi-fancy-footer/provider-status/`; when a refresh fails, cached
+  quota windows keep showing until their reset times pass instead of hiding the widget.
+  Once a window passes its reset time it stays visible with unknown usage (`—`) until a
+  refresh reports the new period, so a quota rollover neither hides the gauge nor claims
+  unconfirmed headroom. The widget is hidden when the active model selection is not
+  backed by the status provider.
+- `provider-status` also refreshes from `x-codex-*` provider response headers when pi
+  exposes them, avoiding a separate Codex status request after provider calls. Claude
+  status refreshes from the Claude.ai usage endpoint, not provider response headers.
+- `iconFamily` lets you choose between `nerd`, `emoji`, `unicode`, and `ascii` palettes.
+- `nerd` keeps the original Nerd Font look. `emoji`, `unicode`, and `ascii` work better
+  in terminals that don't use a Nerd Font.
+- Per-widget icon overrides only let you hide the icon. The selected `iconFamily`
+  controls which icon each widget uses.
+- Pull request widgets live in [pi-prs](https://github.com/mavam/pi-prs), which owns all
+  GitHub polling and publishes them through the data-widget protocol.
+
+## 🧱 Gauge styles
+
+The `gaugeStyle` setting controls the characters used by the `context-bar` and
+`provider-status` gauges. All gauges fill from the left with what is already consumed,
+so a nearly full gauge means a nearly exhausted resource. Each style defines symbols for
+filled and empty cells:
+
+<!-- markdownlint-disable MD013 MD060 -->
+
+| Style              | Filled | Empty |
+| ------------------ | ------ | ----- |
+| `blocks` (default) | `■`    | `□`   |
+| `lines`            | `━`    | `─`   |
+| `circles`          | `●`    | `○`   |
+| `parallelograms`   | `▰`    | `▱`   |
+| `diamonds`         | `◆`    | `◇`   |
+| `bars`             | `█`    | `░`   |
+| `stars`            | `★`    | `☆`   |
+| `specks`           | `•`    | `◦`   |
+
+<!-- markdownlint-enable MD013 MD060 -->
+
+## 📄 License
+
+[MIT](LICENSE)

package/packages/pi-fancy-footer-full-palette/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "pi-fancy-footer-full-palette",
+  "version": "3.0.1-local.8",
+  "description": "A fancy footer extension for pi",
+  "type": "module",
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "footer",
+    "statusline"
+  ],
+  "author": "Matthias Vallentin",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mavam/pi-fancy-footer.git"
+  },
+  "exports": {
+    ".": "./src/index.ts",
+    "./api": "./src/api.ts"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "format": "prettier --write src tsconfig.json",
+    "format:check": "prettier --check src tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --experimental-strip-types src/*.test.ts",
+    "check": "npm run format:check && npm run typecheck && npm test"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  }
+}