@aemonge-dev/pi-stardeck 0.5.0 → 0.6.0

package/README.md

@@ -21,12 +21,13 @@ Header Deck ◀── bounded lifecycle, work, project, model, and resource cont
 zero-row Vim command surface ── Insert transition ──▶ Neovim prompt.md
                              ◀── :x + auto-submit ───┘
 
-responsive Footer ◀── model, quota, context, cost, Git, and capability telemetry
+deck telemetry row ◀── model, context, and cost from session usage; quota via an empty seam
 ```
 
 The package composes four bounded modules in dependency-safe order:
 
-- **Fancy Footer** — responsive model, quota, context, cost, Git, and resource telemetry;
+- **Footer telemetry** — session usage cost for the deck's telemetry row, with an
+  empty quota seam;
 - **Status provider** — lifecycle, OpenSpec, Session Work, and diagnostic state;
 - **Header Deck** — current activity, focus, project state, and compact telemetry.
   Companion extensions surface as leading telemetry icons:

package/docs/architecture.md

@@ -6,7 +6,7 @@ The baseline is one Pi package identity with four existing extension factories:
 
 ```text
 root package manifest
-├── Fancy Footer telemetry provider
+├── Footer telemetry provider (`packages/footer`)
 ├── status and focus producer
 ├── Header Deck and telemetry producer
 └── focused zero-row Vim command surface and external-editor consumer
@@ -18,7 +18,7 @@ through the event protocols that already isolate them.
 
 Startup order is intentional:
 
-1. Fancy Footer subscribes to widget snapshots.
+1. Footer telemetry publishes session-cost snapshots for the deck row.
 2. Status registers focus tools and publishes lifecycle/work snapshots.
 3. Context Header consumes status and supplies the Header Deck renderer.
 4. Pi Vim installs the focused editor component, renders that deck with its live mode,
@@ -29,10 +29,13 @@ when present; it is not a dependency of this package.
 
 ## Stable protocol seams
 
-The imported modules currently coordinate through:
+The composed modules currently coordinate through:
 
-- `pi-fancy-footer:widget` — complete protocol-1 widget snapshots;
-- `pi-fancy-footer:ready` — consumer readiness and producer republish;
+- `pi-stardeck:footer-telemetry/v1` — session-cost snapshots from
+  `packages/footer` (plus an optional quota seam);
+- `pi-fancy-footer:widget` — complete protocol-1 widget snapshots (live wire
+  between the deck and the Vim prompt rail; the name predates the footer
+  fork's removal and is slated for renaming);
 - `galactica-status:header` — bounded lifecycle, selection, suggestion, and active-run
   snapshots;
 - `galactica-status:prompt-row` — prompt-rail telemetry;

package/licenses/README.md

@@ -3,15 +3,17 @@
 `pi-stardeck` is private and currently marked `UNLICENSED` as a whole. Imported
 third-party-derived components retain their own licenses:
 
-- `pi-vim-LICENSE` covers the imported `pi-vim-top-border` descendant;
-- `pi-fancy-footer-LICENSE` covers the imported Fancy Footer fork.
+- `pi-vim-LICENSE` covers the imported `pi-vim-top-border` descendant.
 
 The same license text remains beside each imported source. Local modifications are
 recorded in:
 
-- `packages/pi-vim-top-border/LOCAL-CHANGES.md`;
-- `packages/pi-fancy-footer-full-palette/LOCAL-CHANGES.md`.
+- `packages/pi-vim-top-border/LOCAL-CHANGES.md`.
 
-Do not remove or replace these notices when consolidating or packing the source. A
-future public release requires an explicit project-level licensing decision in addition
-to retaining upstream attribution.
+The former Fancy Footer fork was replaced by the clean-room
+`packages/footer` telemetry provider (see
+`openspec/changes/replace-fancy-footer-with-stardeck-footer`); its license and
+local-change records were removed with it. Do not remove or replace the
+remaining notices when consolidating or packing the source. A future public
+release requires an explicit project-level licensing decision in addition to
+retaining upstream attribution.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aemonge-dev/pi-stardeck",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A Vim- and tmux-inspired command deck for Pi",
   "type": "module",
   "keywords": [
@@ -49,7 +49,7 @@
     "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:footer": "npm --prefix packages/footer 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"
   },

package/packages/footer/README.md

@@ -0,0 +1,15 @@
+# footer
+
+Footer telemetry producer for the [pi-stardeck](../../README.md) deck.
+
+The deck renders the telemetry row; this module only feeds it. It walks the
+session branch for assistant usage cost and publishes snapshots on
+`pi-stardeck:footer-telemetry/v1` after the events that can change them
+(session start, message end, model selection, compaction).
+
+It renders nothing, reads no files, sets no timers, and talks to no network.
+Quota gauges are a seam (`src/quota.ts`) with no implementations: register a
+provider there and the deck row gains its gauge back without renderer
+changes.
+
+Composed by the root package; do not install separately.

package/packages/footer/index.ts

@@ -0,0 +1,37 @@
+import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
+
+import { activeQuotaProviders } from './src/quota.ts';
+import { FOOTER_TELEMETRY_CHANNEL } from './src/protocol.ts';
+import { buildFooterTelemetryMessage, collectTotalCost } from './src/telemetry.ts';
+
+/**
+ * Footer telemetry producer for the pi-stardeck deck. Renders nothing,
+ * configures nothing, polls nothing: it walks the session branch for usage
+ * cost and publishes deck-consumable snapshots on the footer-telemetry
+ * channel after the events that can change them.
+ */
+export default function footerTelemetry(pi: ExtensionAPI): void {
+  let context: ExtensionContext | undefined;
+
+  const publish = () => {
+    if (!context) return;
+    const quota = activeQuotaProviders()
+      .map((provider) => provider.snapshot())
+      .find((snapshot) => snapshot !== undefined);
+    pi.events.emit(
+      FOOTER_TELEMETRY_CHANNEL,
+      buildFooterTelemetryMessage(collectTotalCost(context), quota),
+    );
+  };
+
+  pi.on('session_start', (_event, ctx) => {
+    context = ctx;
+    publish();
+  });
+  pi.on('message_end', publish);
+  pi.on('model_select', publish);
+  pi.on('session_compact', publish);
+  pi.on('session_shutdown', () => {
+    context = undefined;
+  });
+}

package/packages/footer/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "footer",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Footer telemetry producer for the pi-stardeck deck",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "telemetry"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "format": "prettier --write \"**/*.{js,jsx,ts,tsx,mjs,cjs,mts,cts}\" --ignore-path .prettierignore",
+    "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,mjs,cjs,mts,cts}\" --ignore-path .prettierignore",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test --experimental-strip-types test/*.test.ts",
+    "check": "npm run format:check && npm run typecheck && npm test"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  }
+}

package/packages/footer/src/protocol.ts

@@ -0,0 +1,10 @@
+export const FOOTER_TELEMETRY_PROTOCOL_VERSION = 1 as const;
+
+export const FOOTER_TELEMETRY_CHANNEL = 'pi-stardeck:footer-telemetry/v1';
+
+export interface FooterTelemetryMessage {
+  protocol: typeof FOOTER_TELEMETRY_PROTOCOL_VERSION;
+  type: 'snapshot';
+  totalCost: number;
+  quotaPercent?: number;
+}

package/packages/footer/src/quota.ts

@@ -0,0 +1,26 @@
+/**
+ * Quota seam. The provider ships with no implementations: every quota source
+ * this cockpit had (Codex OAuth, Claude OAuth, z.ai coding plan) is gone with
+ * the previous footer module. A future slice registers a provider here
+ * and the deck row gains its gauge back without any renderer change.
+ */
+export interface QuotaSnapshot {
+  /** Whole-session quota usage, 0–100. */
+  percent: number;
+}
+
+export interface QuotaProvider {
+  readonly id: string;
+  snapshot(): QuotaSnapshot | undefined;
+}
+
+const quotaProviders: QuotaProvider[] = [];
+
+export function registerQuotaProvider(provider: QuotaProvider): void {
+  if (quotaProviders.some(({ id }) => id === provider.id)) return;
+  quotaProviders.push(provider);
+}
+
+export function activeQuotaProviders(): readonly QuotaProvider[] {
+  return quotaProviders;
+}

package/packages/footer/src/telemetry.ts

@@ -0,0 +1,59 @@
+import type { ExtensionContext } from '@earendil-works/pi-coding-agent';
+
+import type { QuotaSnapshot } from './quota.ts';
+import {
+  FOOTER_TELEMETRY_PROTOCOL_VERSION,
+  type FooterTelemetryMessage,
+} from './protocol.ts';
+
+function toCost(value: unknown): number {
+  return typeof value === 'number' && Number.isFinite(value) ? Math.max(0, value) : 0;
+}
+
+/**
+ * Sums assistant usage cost over a session branch. Non-message entries,
+ * non-assistant messages, and malformed usage contribute nothing, matching
+ * the walk the deck row has consumed since 0.1.0.
+ */
+export function totalCostFromEntries(entries: readonly unknown[]): number {
+  let totalCost = 0;
+  for (const entry of entries) {
+    if (typeof entry !== 'object' || entry === null) continue;
+    const { type, message } = entry as { type?: unknown; message?: unknown };
+    if (type !== 'message') continue;
+    if (typeof message !== 'object' || message === null) continue;
+    const { role, usage } = message as { role?: unknown; usage?: unknown };
+    if (role !== 'assistant') continue;
+    if (typeof usage !== 'object' || usage === null) continue;
+    const cost = (usage as { cost?: unknown }).cost;
+    if (typeof cost !== 'object' || cost === null) continue;
+    totalCost += toCost((cost as { total?: unknown }).total);
+  }
+  return totalCost;
+}
+
+export function collectTotalCost(ctx: ExtensionContext): number {
+  return totalCostFromEntries(ctx.sessionManager.getBranch());
+}
+
+export function buildFooterTelemetryMessage(
+  totalCost: number,
+  quota?: QuotaSnapshot,
+): FooterTelemetryMessage {
+  const cost =
+    typeof totalCost === 'number' && Number.isFinite(totalCost)
+      ? Math.max(0, totalCost)
+      : 0;
+  const percent =
+    quota !== undefined &&
+    typeof quota.percent === 'number' &&
+    Number.isFinite(quota.percent)
+      ? Math.min(100, Math.max(0, quota.percent))
+      : undefined;
+  return {
+    protocol: FOOTER_TELEMETRY_PROTOCOL_VERSION,
+    type: 'snapshot',
+    totalCost: cost,
+    ...(percent !== undefined ? { quotaPercent: percent } : {}),
+  };
+}

package/packages/pi-stardeck/README.md

@@ -169,8 +169,8 @@ sustained CPU pressure above 80% or unusually high session memory; one resource
 does not recolor its neighbors. Pink and red are never used in these three telemetry
 groups. In the title, lifecycle and bounded activity are blue; the major boundary is
 purple; real focus and optional Task hierarchy are green; empty focus fallbacks and the
-footer runtime age/state are dim. Persistent cache-hit presentation is disabled, while
-Fancy Footer retains its internal cache accounting. Compaction count is hidden at zero.
+footer runtime age/state are dim. Persistent cache-hit presentation is disabled and no
+module keeps cache accounting since the footer fork's replacement. Compaction count is hidden at zero.
 The first deck row always begins with the compact runtime capsule
 `( children ›  subagents · 00:00'00)`. Each zero count and the settled timer remain
 dim in place; a live count or timer changes color without moving neighboring content.
@@ -182,12 +182,12 @@ Quota is reduced to the most constrained provider-reported percentage with no we
 analysis. Cost is Pi's native estimated session cost in USD, rendered without trailing
 fractional zeros; its preceding `⟩` retains the shared purple major-boundary color while
 the value remains blue. No local daily aggregation or currency conversion is performed.
-No center group or gauges are used. The local Fancy Footer fork expands its widget
-protocol to accept these native theme tokens. The narrative lifecycle header begins with
+No center group or gauges are used. The deck's widget protocol (historically the
+Fancy Footer protocol, `pi-fancy-footer:widget`) accepts these native theme tokens. The narrative lifecycle header begins with
 its active/passive terminal icon; the prompt border keeps only its right-aligned vi-mode
 glyph. Concurrent Git refreshes coalesce without polling.
 
-Agent-environment, context, CPU, RAM, and compaction widgets use the same Fancy Footer
+Agent-environment, context, CPU, RAM, and compaction widgets use the same widget
 protocol, including producer-requested bold text for the PWD. Every three seconds on
 Linux, the extension discovers only Pi descendants through bounded
 `/proc/<pid>/task/<pid>/children` reads, then reads their `stat` and `status` records
@@ -196,7 +196,8 @@ private anonymous resident pages (`RssAnon`) instead of counting shared file-bac
 pages once per process. Individual status-read failures fall back to that process's RSS;
 unavailable `/proc` falls back honestly to current-process CPU and RSS. Sampling,
 smoothing, publication, timers, and resource widgets are session-scoped and cleaned up
-on shutdown. The local Fancy Footer fork owns cache, quota, and session-cost collection.
+on shutdown. Session-cost collection lives in `packages/footer`; cache and quota
+collection were removed with the fork, leaving quota as an empty seam.
 When the footer reports quota windows, the compact telemetry row paints icon-native
 tiles in cost, long-window, coding-window order — `󰜦 $5.21 ⟩ 󰃰 12% ⟩ 󰈸 62% › 󰅐 1:45`.
 The flame is the coding window's permanent icon and always carries the clock

package/packages/status/package.json

@@ -2,7 +2,7 @@
   "name": "status",
   "version": "1.0.0",
   "private": true,
-  "description": "Project status producer for pi-fancy-footer",
+  "description": "Project status producer for the pi-stardeck deck",
   "type": "module",
   "keywords": [
     "pi-package",

package/src/health.ts

@@ -59,7 +59,6 @@ const PACKAGE_VERSION = (
 ).version;
 
 const PACKAGE_COMMANDS = [
-  'fancy-footer',
   'galactica-status',
   'galactica-status-debug',
   'galactica-status-refresh',

package/src/index.ts

@@ -2,24 +2,23 @@ import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
 
 import galacticaContextHeader from '../packages/pi-stardeck/index.js';
 import galacticaStatus from '../packages/status/index.js';
-import fancyFooter from '../packages/pi-fancy-footer-full-palette/src/index.js';
+import footerTelemetry from '../packages/footer/index.js';
 import { registerStardeckHealth } from './health.js';
 import { registerPiStatus } from './pi-status.js';
 
 export const COCKPIT_SURFACES = {
-  footer: 'telemetry',
   contextHeader: 'deck',
 } as const;
 
 export const COCKPIT_COMPOSITION = [
-  `fancy-footer:${COCKPIT_SURFACES.footer}`,
+  'footer:telemetry',
   'galactica-status:provider',
   `galactica-context-header:${COCKPIT_SURFACES.contextHeader}`,
 ] as const;
 
 export default function piStardeck(pi: ExtensionAPI): void {
   registerPiStatus(pi);
-  fancyFooter(pi, { surface: COCKPIT_SURFACES.footer });
+  footerTelemetry(pi);
   galacticaStatus(pi);
   galacticaContextHeader(pi, {
     surface: COCKPIT_SURFACES.contextHeader,

package/licenses/pi-fancy-footer-LICENSE

@@ -1,21 +0,0 @@
-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/LICENSE

@@ -1,21 +0,0 @@
-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

@@ -1,41 +0,0 @@
-# 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.