@pi-vault/pi-status 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to `@pi-vault/pi-status` are documented in this file.
+
+## 0.2.1 - 2026-06-14
+
+### Changed
+
+- Updated the Pi host baseline to the `0.79.x` package line and refreshed the packaged dependency set.
+- Reworked the README around install, reload, `/statusline`, footer segments, and `pi-usage` integration so the published docs match current behavior.
+- Added this changelog to the published package contents.
+
+### Internal
+
+- Refactored internal snapshot and runtime-state code without changing the public behavior of the extension.
+- Exported `formatSegment` with full test coverage to harden segment rendering behavior.
+
+## 0.2.0 - 2026-06-07
+
+### Added
+
+- Screenshots for the live footer and interactive `/statusline` editor.
+- A usage runtime that integrates with `@pi-vault/pi-usage` for live limit-backed footer segments.
+
+### Changed
+
+- Upgraded usage-backed segments to the `@pi-vault/pi-usage@0.2.x` line.
+- Consolidated the TUI implementation and theme plumbing used by the footer preview and `/statusline`.
+- Refreshed the README to cover the shipped UI and configuration flow.
+
+## 0.1.0 - 2026-06-02
+
+### Added
+
+- Initial release of the Pi status line extension.
+- A footer that can replace Pi's default footer with configurable status segments.
+- The `/statusline` interactive editor for enabling, disabling, reordering, and previewing segments.
+- Settings persistence through Pi's `settings.json` with project and global loading behavior.
+- Segment support for model, reasoning level, project name, working directory, Git branch, run state, context metrics, token counts, session ID, usage limits, and extension statuses.
+- Filtering controls for visible extension statuses.
+
+### Changed
+
+- Iterated on the `/statusline` UI to use sectioned rows, search, inline rendering, live preview, theme adaptation, and footer suppression while editing.

package/README.md

@@ -2,45 +2,66 @@
 
 [![npm version](https://img.shields.io/npm/v/%40pi-vault%2Fpi-status)](https://www.npmjs.com/package/@pi-vault/pi-status)
 [![Quality](https://github.com/pi-vault/pi-status/actions/workflows/quality.yml/badge.svg?branch=master)](https://github.com/pi-vault/pi-status/actions/workflows/quality.yml)
-[![Node >= 22.12](https://img.shields.io/badge/node-%3E%3D22.12-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![Node >= 22.19](https://img.shields.io/badge/node-%3E%3D22.19-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 
-Replace Pi's default footer with a cleaner Codex-style status line that stays out of the way but keeps the useful bits visible.
+Replace Pi's default footer with a compact status line that shows the session details you actually care about. The extension installs a live footer and adds `/statusline`, an interactive editor for choosing, ordering, and previewing footer segments.
 
-Default status line:
+Default footer:
 
-`model-with-reasoning · current-dir`
+```text
+model-with-reasoning · current-dir
+```
+
+## Screenshots
+
+Default status line rendering:
+
+![Status line UI](docs/assets/statusline-ui.png)
 
-> **Status:** Early-adopter release (`v0.1.0`). It is ready to use, but the available segments and configuration details may still change before `v1.0`.
+Interactive configuration editor (`/statusline`):
 
-## Install
+![Status line configuration](docs/assets/statusline-configuration.png)
+
+## Install And Reload
+
+Install the extension:
 
 ```bash
 pi install npm:@pi-vault/pi-status
 ```
 
-Then reload Pi:
+Optional: install `pi-usage` if you want the `five-hour-limit` and `weekly-limit` footer segments:
+
+```bash
+pi install npm:@pi-vault/pi-usage
+```
+
+Reload Pi after installing or upgrading:
 
 ```bash
 /reload
 ```
 
-## Use
+## Use `/statusline`
 
-Once installed, the footer updates automatically.
+Once installed, the footer updates automatically. Run `/statusline` inside Pi to open the interactive editor.
 
-Use `/statusline` inside Pi to:
+The editor lets you:
 
 - turn footer items on or off
-- reorder the items you want to see
+- reorder enabled items with `Left` and `Right`
+- search the segment list
 - preview the result before saving
 - control which extension status messages are shown
 
 Changes are saved and reused the next time Pi starts.
 
-## Available Status Items
+During editing, the live footer is temporarily hidden so the inline UI can use the full width cleanly.
+
+## Available Footer Items
 
-You can build your footer from these items:
+You can compose the footer from these segment IDs:
 
 - `model`
 - `model-with-reasoning`
@@ -59,9 +80,11 @@ You can build your footer from these items:
 - `weekly-limit`
 - `extension-statuses`
 
-`five-hour-limit` and `weekly-limit` come from [`@pi-vault/pi-usage`](https://www.npmjs.com/package/@pi-vault/pi-usage) and only appear when that usage data is available.
+`five-hour-limit` and `weekly-limit` depend on standalone [`@pi-vault/pi-usage`](https://www.npmjs.com/package/@pi-vault/pi-usage). When `pi-usage` is not installed or has not responded yet, those segments are hidden from `/statusline` and omitted from the footer.
+
+`extension-statuses` renders the visible extension status values reported by Pi extensions. `/statusline` also lets you hide individual status keys or switch to an allowlist.
 
-## Common Setups
+## Common Examples
 
 Keep it minimal:
 
@@ -75,19 +98,30 @@ Show more session detail:
 model · run-state · git-branch · context-used · context-remaining · session-id
 ```
 
+Usage-aware footer:
+
+```text
+model-with-reasoning · current-dir · five-hour-limit · weekly-limit
+```
+
+Show extension activity too:
+
+```text
+model · current-dir · extension-statuses
+```
+
 ## Compatibility
 
-- Node.js `>=22.12`
+- Node.js `>=22.19`
 - Pi host environment with `@earendil-works/pi-coding-agent` and `@earendil-works/pi-tui`
-- Tested in this repo against `@earendil-works/pi-coding-agent@0.78.x` and `@earendil-works/pi-tui@0.78.x`
+- Tested in this repo against `@earendil-works/pi-coding-agent@0.79.3` and `@earendil-works/pi-tui@0.79.3`
 
-## Development Setup
+## Development
 
 ```bash
 pnpm install
 pnpm check
-pnpm pack --dry-run
-pi -e .
+pnpm run pack:dry-run
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-vault/pi-status",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Pi extension that replaces the default status with a Codex-like status",
   "author": "Lanh Hoang <lanhhoang@users.noreply.github.com>",
@@ -29,19 +29,20 @@
   },
   "pi": {
     "extensions": [
-      "./src/index.ts",
-      "node_modules/@pi-vault/pi-usage/src/index.ts"
+      "./src/index.ts"
     ]
   },
   "engines": {
-    "node": ">=22.12"
+    "node": ">=22.19"
   },
   "files": [
     "src",
+    "docs/assets",
+    "CHANGELOG.md",
     "README.md"
   ],
   "dependencies": {
-    "@pi-vault/pi-usage": "^0.1.1"
+    "@pi-vault/pi-usage": "^0.4.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",
@@ -49,8 +50,8 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.16",
-    "@earendil-works/pi-coding-agent": "^0.78.0",
-    "@earendil-works/pi-tui": "^0.78.0",
+    "@earendil-works/pi-coding-agent": "^0.79.3",
+    "@earendil-works/pi-tui": "^0.79.3",
     "@types/node": "^25.9.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.7"

package/src/{config.ts → core/config.ts}

@@ -11,14 +11,11 @@ import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import {
   DEFAULT_SEGMENTS,
+  isKnownSegment,
+  type PiStatusConfig,
   type StatusFilter,
   type StatusLineSegmentId,
-} from "./render.ts";
-
-export type PiStatusConfig = {
-  segments: StatusLineSegmentId[];
-  filter: StatusFilter;
-};
+} from "../shared/types.ts";
 
 export type ConfigLoadResult = {
   config: PiStatusConfig;
@@ -30,25 +27,6 @@ export const DEFAULT_CONFIG: PiStatusConfig = {
   filter: { mode: "all", hidden: [] },
 };
 
-const KNOWN_SEGMENTS = new Set<StatusLineSegmentId>([
-  "model",
-  "model-with-reasoning",
-  "project-name",
-  "current-dir",
-  "git-branch",
-  "run-state",
-  "context-remaining",
-  "context-used",
-  "context-window-size",
-  "used-tokens",
-  "total-input-tokens",
-  "total-output-tokens",
-  "session-id",
-  "five-hour-limit",
-  "weekly-limit",
-  "extension-statuses",
-]);
-
 function cloneDefaultConfig(): PiStatusConfig {
   return {
     segments: [...DEFAULT_CONFIG.segments],
@@ -76,11 +54,10 @@ export function normalizeSegments(input: unknown): StatusLineSegmentId[] {
 
   for (const value of input) {
     if (typeof value !== "string") continue;
-    if (!KNOWN_SEGMENTS.has(value as StatusLineSegmentId)) continue;
-    const id = value as StatusLineSegmentId;
-    if (seen.has(id)) continue;
-    seen.add(id);
-    out.push(id);
+    if (!isKnownSegment(value)) continue;
+    if (seen.has(value)) continue;
+    seen.add(value);
+    out.push(value);
   }
 
   return out;
@@ -103,8 +80,9 @@ function normalizeFilterValues(input: unknown): string[] {
 }
 
 export function normalizeStatusFilter(input: unknown): StatusFilter {
-  if (!input || typeof input !== "object" || Array.isArray(input))
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
     return { mode: "all", hidden: [] };
+  }
   const mode = (input as { mode?: unknown }).mode;
 
   if (mode === "all") {
@@ -127,8 +105,9 @@ export function normalizeStatusFilter(input: unknown): StatusFilter {
 function readJsonObject(path: string): Record<string, unknown> | null {
   try {
     const parsed: unknown = JSON.parse(readFileSync(path, "utf8"));
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
       return null;
+    }
     return parsed as Record<string, unknown>;
   } catch {
     return null;
@@ -141,24 +120,17 @@ type SettingsFileState =
   | { exists: true; malformed: true };
 
 function readSettingsFileState(path: string): SettingsFileState {
-  if (!existsSync(path)) {
-    return { exists: false, value: {} };
-  }
-
+  if (!existsSync(path)) return { exists: false, value: {} };
   const parsed = readJsonObject(path);
-  if (parsed) {
-    return { exists: true, value: parsed };
-  }
-
+  if (parsed) return { exists: true, value: parsed };
   return { exists: true, malformed: true };
 }
 
 function normalizePiStatus(input: unknown): PiStatusConfig {
-  if (!input || typeof input !== "object" || Array.isArray(input))
+  if (!input || typeof input !== "object" || Array.isArray(input)) {
     return cloneDefaultConfig();
-  const segments = normalizeSegments(
-    (input as { segments?: unknown }).segments,
-  );
+  }
+  const segments = normalizeSegments((input as { segments?: unknown }).segments);
   const filter = normalizeStatusFilter((input as { filter?: unknown }).filter);
   return {
     segments: segments.length > 0 ? segments : [...DEFAULT_SEGMENTS],
@@ -167,18 +139,12 @@ function normalizePiStatus(input: unknown): PiStatusConfig {
 }
 
 function mergePiStatus(globalValue: unknown, projectValue: unknown): unknown {
-  if (
-    !globalValue ||
-    typeof globalValue !== "object" ||
-    Array.isArray(globalValue)
-  )
+  if (!globalValue || typeof globalValue !== "object" || Array.isArray(globalValue)) {
     return projectValue ?? globalValue;
-  if (
-    !projectValue ||
-    typeof projectValue !== "object" ||
-    Array.isArray(projectValue)
-  )
+  }
+  if (!projectValue || typeof projectValue !== "object" || Array.isArray(projectValue)) {
     return globalValue;
+  }
   const g = globalValue as Record<string, unknown>;
   const p = projectValue as Record<string, unknown>;
   const merged: Record<string, unknown> = { ...g, ...p };
@@ -186,12 +152,8 @@ function mergePiStatus(globalValue: unknown, projectValue: unknown): unknown {
   const gFilter = g.filter;
   const pFilter = p.filter;
   if (
-    gFilter &&
-    typeof gFilter === "object" &&
-    !Array.isArray(gFilter) &&
-    pFilter &&
-    typeof pFilter === "object" &&
-    !Array.isArray(pFilter)
+    gFilter && typeof gFilter === "object" && !Array.isArray(gFilter) &&
+    pFilter && typeof pFilter === "object" && !Array.isArray(pFilter)
   ) {
     merged.filter = {
       ...(gFilter as Record<string, unknown>),
@@ -240,9 +202,7 @@ export function saveConfigToSettings(
 
   const targetState = readSettingsFileState(path);
   if ("malformed" in targetState) {
-    throw new Error(
-      `Refusing to write malformed or non-object settings file: ${path}`,
-    );
+    throw new Error(`Refusing to write malformed or non-object settings file: ${path}`);
   }
 
   const base = targetState.value;

package/src/core/snapshot.ts

@@ -0,0 +1,75 @@
+import type { FooterRenderInput, ModelLike, RunState } from "../tui/render.ts";
+
+export type SnapshotInput = {
+  model?: ModelLike;
+  cwd: string;
+  thinkingLevel: string;
+  gitBranch: string | null;
+  isIdle: boolean;
+  hasPendingMessages: boolean;
+  contextUsage?: {
+    tokens?: number | null;
+    contextWindow?: number;
+    percent?: number | null;
+  };
+  branch: unknown[];
+  sessionId: string;
+  usageState?: FooterRenderInput["usageState"];
+  extensionStatuses: ReadonlyMap<string, string>;
+};
+
+function aggregateBranchTotals(branch: unknown[]): {
+  input: number;
+  output: number;
+  totalTokens: number;
+} {
+  const totals = { input: 0, output: 0, totalTokens: 0 };
+
+  for (const entry of branch ?? []) {
+    if (!entry || typeof entry !== "object") continue;
+    if ((entry as { type?: unknown }).type !== "message") continue;
+    const message = (
+      entry as {
+        message?: {
+          role?: unknown;
+          usage?: { input?: number; output?: number; totalTokens?: number };
+        };
+      }
+    ).message;
+    if (message?.role !== "assistant") continue;
+    const usage = message.usage;
+    if (!usage) continue;
+    if (typeof usage.input === "number") totals.input += usage.input;
+    if (typeof usage.output === "number") totals.output += usage.output;
+    if (typeof usage.totalTokens === "number")
+      totals.totalTokens += usage.totalTokens;
+  }
+
+  return totals;
+}
+
+function deriveRunState(
+  isIdle: boolean,
+  hasPendingMessages: boolean,
+): RunState {
+  if (!isIdle) return "busy";
+  if (hasPendingMessages) return "queued";
+  return "idle";
+}
+
+export function buildSnapshot(
+  input: SnapshotInput,
+): Omit<FooterRenderInput, "segments" | "filter"> {
+  return {
+    model: input.model,
+    cwd: input.cwd,
+    thinkingLevel: input.thinkingLevel,
+    gitBranch: input.gitBranch,
+    runState: deriveRunState(input.isIdle, input.hasPendingMessages),
+    contextUsage: input.contextUsage,
+    branchTotals: aggregateBranchTotals(input.branch),
+    sessionId: input.sessionId,
+    usageState: input.usageState,
+    extensionStatuses: input.extensionStatuses,
+  };
+}

package/src/core/usage-runtime.ts

@@ -0,0 +1,62 @@
+import {
+  USAGE_CORE_READY_EVENT,
+  USAGE_CORE_REQUEST_EVENT,
+  USAGE_CORE_UPDATE_CURRENT_EVENT,
+} from "@pi-vault/pi-usage/events";
+import type { UsageCoreState } from "@pi-vault/pi-usage/types";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+function isUsageCoreState(value: unknown): value is UsageCoreState {
+  return Boolean(value && typeof value === "object");
+}
+
+export function createUsageRuntime(pi: ExtensionAPI) {
+  let available = false;
+  let state: UsageCoreState | undefined;
+  let onChange: (() => void) | undefined;
+
+  const acceptPayload = (payload: unknown): void => {
+    if (!payload || typeof payload !== "object") return;
+    const maybe = payload as { state?: unknown };
+    const next = maybe.state ?? payload;
+    if (!isUsageCoreState(next)) return;
+    state = next;
+    available = true;
+    onChange?.();
+  };
+
+  const requestCurrent = (): void => {
+    pi.events.emit(USAGE_CORE_REQUEST_EVENT, {
+      type: "current",
+      reply(payload: unknown) {
+        acceptPayload(payload);
+      },
+    });
+  };
+
+  const unsubscribeReady = pi.events.on(USAGE_CORE_READY_EVENT, acceptPayload);
+  const unsubscribeUpdate = pi.events.on(
+    USAGE_CORE_UPDATE_CURRENT_EVENT,
+    acceptPayload,
+  );
+
+  requestCurrent();
+
+  return {
+    getAvailable(): boolean {
+      return available;
+    },
+    getState(): UsageCoreState | undefined {
+      return state;
+    },
+    setOnChange(listener: (() => void) | undefined): void {
+      onChange = listener;
+    },
+    requestCurrent,
+    dispose(): void {
+      onChange = undefined;
+      unsubscribeReady();
+      unsubscribeUpdate();
+    },
+  };
+}