@pi-vault/pi-status 0.2.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

@@ -5,58 +5,63 @@
 [![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
+```
 
-## Install
+## Screenshots
 
-Install `pi-status`:
+Default status line rendering:
+
+![Status line UI](docs/assets/statusline-ui.png)
+
+Interactive configuration editor (`/statusline`):
+
+![Status line configuration](docs/assets/statusline-configuration.png)
+
+## Install And Reload
+
+Install the extension:
 
 ```bash
 pi install npm:@pi-vault/pi-status
 ```
 
-Optional: install `pi-usage` if you want `/usage` plus the usage-backed footer segments:
+Optional: install `pi-usage` if you want the `five-hour-limit` and `weekly-limit` footer segments:
 
 ```bash
 pi install npm:@pi-vault/pi-usage
 ```
 
-Then reload Pi:
+Reload Pi after installing or upgrading:
 
 ```bash
 /reload
 ```
 
-## Screenshots
+## Use `/statusline`
 
-Default status line rendering:
+Once installed, the footer updates automatically. Run `/statusline` inside Pi to open the interactive editor.
 
-![Status line UI](docs/assets/statusline-ui.png)
-
-Interactive configuration editor (`/statusline`):
-
-![Status line configuration](docs/assets/statusline-configuration.png)
-
-## Use
-
-Once installed, the footer updates automatically.
-
-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.
 
-You can build your footer from these items:
+## Available Footer Items
+
+You can compose the footer from these segment IDs:
 
 - `model`
 - `model-with-reasoning`
@@ -75,9 +80,11 @@ You can build your footer from these items:
 - `weekly-limit`
 - `extension-statuses`
 
-`five-hour-limit` and `weekly-limit` require 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 items are hidden from `/statusline` and omitted from the footer.
+`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:
 
@@ -91,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.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.2.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>",
@@ -38,10 +38,11 @@
   "files": [
     "src",
     "docs/assets",
+    "CHANGELOG.md",
     "README.md"
   ],
   "dependencies": {
-    "@pi-vault/pi-usage": "^0.2.0"
+    "@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/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/index.ts

@@ -2,10 +2,8 @@ import type {
   ExtensionAPI,
   ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
-import {
-  loadConfig,
-  saveConfigToSettings,
-} from "./core/config.ts";
+import { loadConfig, saveConfigToSettings } from "./core/config.ts";
+import { buildSnapshot } from "./core/snapshot.ts";
 import { createUsageRuntime } from "./core/usage-runtime.ts";
 import type { PiStatusConfig } from "./shared/types.ts";
 import { createStatusLineEditor } from "./tui/editor.ts";
@@ -30,6 +28,24 @@ type FooterFactory = (
   footerData: FooterDataLike,
 ) => FooterComponent;
 
+type RuntimeState = {
+  config: PiStatusConfig;
+  ctx: ExtensionContext | undefined;
+  requestRender: (() => void) | undefined;
+  gitBranch: string | null;
+  extensionStatuses: Map<string, string>;
+};
+
+function createRuntimeState(): RuntimeState {
+  return {
+    config: loadConfig().config,
+    ctx: undefined,
+    requestRender: undefined,
+    gitBranch: null,
+    extensionStatuses: new Map(),
+  };
+}
+
 const EMPTY_FOOTER_FACTORY: FooterFactory = () => ({
   render(): string[] {
     return [];
@@ -41,91 +57,64 @@ const EMPTY_FOOTER_FACTORY: FooterFactory = () => ({
 function isLiveTheme(value: unknown): boolean {
   if (!value || typeof value !== "object") return false;
   const candidate = value as { fg?: unknown; bold?: unknown };
-  return typeof candidate.fg === "function" && typeof candidate.bold === "function";
-}
-
-function aggregateBranchTotals(ctx: ExtensionContext): {
-  input: number;
-  output: number;
-  totalTokens: number;
-} {
-  const totals = { input: 0, output: 0, totalTokens: 0 };
-  const branch = ctx.sessionManager.getBranch() as unknown[];
-
-  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;
+  return (
+    typeof candidate.fg === "function" && typeof candidate.bold === "function"
+  );
 }
 
 export default function createExtension(pi: ExtensionAPI): void {
-  let runtimeConfig: PiStatusConfig = loadConfig().config;
-  let currentCtx: ExtensionContext | undefined;
-  let requestRender: (() => void) | undefined;
-  let lastGitBranch: string | null = null;
-  let lastExtensionStatuses = new Map<string, string>();
+  const state = createRuntimeState();
 
   const usageRuntime = createUsageRuntime(pi);
 
   function refreshRuntimeConfig(cwd?: string): void {
-    runtimeConfig = loadConfig(cwd ? { cwd } : undefined).config;
+    state.config = loadConfig(cwd ? { cwd } : undefined).config;
   }
 
   function installFooter(ctx: ExtensionContext): void {
     if (!ctx.hasUI) return;
 
     const factory: FooterFactory = (tui, theme, footerData) => {
-      requestRender = () => tui.requestRender?.();
-      usageRuntime.setOnChange(requestRender);
-      const unsubscribe = footerData.onBranchChange?.(() => tui.requestRender?.());
+      state.requestRender = () => tui.requestRender?.();
+      usageRuntime.setOnChange(state.requestRender);
+      const unsubscribe = footerData.onBranchChange?.(() =>
+        tui.requestRender?.(),
+      );
 
       return {
         dispose() {
           unsubscribe?.();
-          if (requestRender === tui.requestRender) requestRender = undefined;
-          usageRuntime.setOnChange(requestRender);
+          if (state.requestRender === tui.requestRender)
+            state.requestRender = undefined;
+          usageRuntime.setOnChange(state.requestRender);
         },
         invalidate() {
-          requestRender?.();
+          state.requestRender?.();
         },
         render(width: number) {
-          const activeCtx = currentCtx ?? ctx;
-          lastGitBranch = footerData.getGitBranch();
-          lastExtensionStatuses = new Map(footerData.getExtensionStatuses().entries());
+          const activeCtx = state.ctx ?? ctx;
+          state.gitBranch = footerData.getGitBranch();
+          state.extensionStatuses = new Map(
+            footerData.getExtensionStatuses().entries(),
+          );
+          const snapshot = buildSnapshot({
+            model: activeCtx.model,
+            cwd: activeCtx.cwd,
+            thinkingLevel: String(pi.getThinkingLevel()),
+            gitBranch: state.gitBranch,
+            isIdle: activeCtx.isIdle(),
+            hasPendingMessages: activeCtx.hasPendingMessages(),
+            contextUsage: activeCtx.getContextUsage(),
+            branch: activeCtx.sessionManager.getBranch() as unknown[],
+            sessionId: activeCtx.sessionManager.getSessionId(),
+            usageState: usageRuntime.getState(),
+            extensionStatuses: state.extensionStatuses,
+          });
           const line = buildFooterLine(
             {
-              model: activeCtx.model,
-              cwd: activeCtx.cwd,
-              thinkingLevel: String(pi.getThinkingLevel()),
-              gitBranch: lastGitBranch,
-              runState: !activeCtx.isIdle()
-                ? "busy"
-                : activeCtx.hasPendingMessages()
-                  ? "queued"
-                  : "idle",
-              contextUsage: activeCtx.getContextUsage(),
-              branchTotals: aggregateBranchTotals(activeCtx),
-              sessionId: activeCtx.sessionManager.getSessionId(),
-              usageState: usageRuntime.getState(),
-              extensionStatuses: lastExtensionStatuses,
-              filter: runtimeConfig.filter,
-              segments: runtimeConfig.segments,
+              ...snapshot,
+              filter: state.config.filter,
+              segments: state.config.segments,
             },
             theme,
             width,
@@ -143,9 +132,9 @@ export default function createExtension(pi: ExtensionAPI): void {
   }
 
   function refresh(ctx: ExtensionContext): void {
-    currentCtx = ctx;
+    state.ctx = ctx;
     refreshRuntimeConfig(ctx.cwd);
-    requestRender?.();
+    state.requestRender?.();
   }
 
   pi.registerCommand("statusline", {
@@ -156,39 +145,43 @@ export default function createExtension(pi: ExtensionAPI): void {
         return;
       }
 
-      const discovered = [...lastExtensionStatuses.keys()].sort((a, b) => a.localeCompare(b));
+      const discovered = [...state.extensionStatuses.keys()].sort((a, b) =>
+        a.localeCompare(b),
+      );
 
       let result: PiStatusConfig | null = null;
       try {
         installEmptyFooter(ctx);
-        result = await ctx.ui.custom<PiStatusConfig | null>((tui, theme, _keys, done) => {
-          const activeCtx = currentCtx ?? ctx;
-          const menuTheme: StatusLineTheme = isLiveTheme(theme) ? fromPiTheme(theme) : noTheme;
-          return createStatusLineEditor({
-            config: runtimeConfig,
-            discoveredStatuses: discovered,
-            previewInput: {
+        result = await ctx.ui.custom<PiStatusConfig | null>(
+          (tui, theme, _keys, done) => {
+            const activeCtx = state.ctx ?? ctx;
+            const menuTheme: StatusLineTheme = isLiveTheme(theme)
+              ? fromPiTheme(theme)
+              : noTheme;
+            const snapshot = buildSnapshot({
               model: activeCtx.model,
               cwd: activeCtx.cwd,
               thinkingLevel: String(pi.getThinkingLevel()),
-              gitBranch: lastGitBranch,
-              runState: !activeCtx.isIdle()
-                ? "busy"
-                : activeCtx.hasPendingMessages()
-                  ? "queued"
-                  : "idle",
+              gitBranch: state.gitBranch,
+              isIdle: activeCtx.isIdle(),
+              hasPendingMessages: activeCtx.hasPendingMessages(),
               contextUsage: activeCtx.getContextUsage(),
-              branchTotals: aggregateBranchTotals(activeCtx),
+              branch: activeCtx.sessionManager.getBranch() as unknown[],
               sessionId: activeCtx.sessionManager.getSessionId(),
               usageState: usageRuntime.getState(),
-              extensionStatuses: lastExtensionStatuses,
-            },
-            theme: menuTheme,
-            done,
-            requestRender: () => tui.requestRender?.(),
-            usageAvailable: usageRuntime.getAvailable(),
-          });
-        });
+              extensionStatuses: state.extensionStatuses,
+            });
+            return createStatusLineEditor({
+              config: state.config,
+              discoveredStatuses: discovered,
+              previewInput: snapshot,
+              theme: menuTheme,
+              done,
+              requestRender: () => tui.requestRender?.(),
+              usageAvailable: usageRuntime.getAvailable(),
+            });
+          },
+        );
       } finally {
         installFooter(ctx);
       }
@@ -197,10 +190,13 @@ export default function createExtension(pi: ExtensionAPI): void {
 
       try {
         saveConfigToSettings(result, { cwd: ctx.cwd });
-        runtimeConfig = result;
-        requestRender?.();
+        state.config = result;
+        state.requestRender?.();
       } catch (error) {
-        const message = error instanceof Error ? error.message : "Failed to save statusline settings";
+        const message =
+          error instanceof Error
+            ? error.message
+            : "Failed to save statusline settings";
         ctx.ui.notify(message, "warning");
       }
     },
@@ -209,13 +205,13 @@ export default function createExtension(pi: ExtensionAPI): void {
   pi.on("session_start", (_event, ctx) => {
     usageRuntime.requestCurrent();
     refreshRuntimeConfig(ctx.cwd);
-    currentCtx = ctx;
+    state.ctx = ctx;
     installFooter(ctx);
   });
 
   pi.on("session_tree", (_event, ctx) => {
     refreshRuntimeConfig(ctx.cwd);
-    currentCtx = ctx;
+    state.ctx = ctx;
     installFooter(ctx);
   });
 
@@ -228,8 +224,8 @@ export default function createExtension(pi: ExtensionAPI): void {
   });
 
   pi.on("session_shutdown", (_event, ctx) => {
-    currentCtx = undefined;
-    requestRender = undefined;
+    state.ctx = undefined;
+    state.requestRender = undefined;
     usageRuntime.setOnChange(undefined);
     if (ctx.hasUI) ctx.ui.setFooter(undefined);
   });

package/src/tui/render.ts

@@ -187,7 +187,7 @@ function formatExtensionStatuses(
   return parts.join(theme.fg("dim", " | "));
 }
 
-function formatSegment(
+export function formatSegment(
   id: StatusLineSegmentId,
   input: FooterRenderInput,
   theme: ThemeLike,