@narumitw/pi-statusline 0.5.0 → 0.6.0

package/README.md

@@ -11,7 +11,7 @@ Use it to monitor model selection, thinking level, git branch, working directory
 - Replaces the default Pi footer with a compact preset-based statusline.
 - Shows model, thinking level, git branch, project directory, active tool, context usage, tokens, cost, and clock.
 - Displays compact statuses published through Pi's generic extension status API.
-- Preserves extension-provided status icons when the status text starts with one.
+- Owns extension status icons through optional JSON config, including per-extension icon suppression with `""`.
 - Warns when the same extension package is installed from multiple sources.
 - Uses emoji-labeled segments for readability in both classic and Tokyo Night presets.
 - Adapts to terminal width and truncates safely.
@@ -49,7 +49,31 @@ Supported presets:
 - `tokyo-night` — the default, inspired by the [Starship Tokyo Night preset](https://starship.rs/presets/tokyo-night), using `░▒▓` / `` powerline blocks and the Tokyo Night color ramp.
 - `classic` — a compact Pi-themed statusline with left-aligned `•` separators.
 
-Unset or invalid values fall back to `tokyo-night`. Both presets keep the same emoji-labeled information and preserve extension-provided status icons.
+Unset or invalid values fall back to `tokyo-night`. Both presets keep the same emoji-labeled information.
+
+## ⚙️ Extension status icons
+
+Extension statuses use built-in icons by status key. Override or suppress them in `${PI_CODING_AGENT_DIR:-~/.pi/agent}/pi-statusline-settings.json`:
+
+```json
+{
+  "extensionStatusIcons": {
+    "caffeinate": "☕",
+    "goal": "🎯",
+    "pisync": "☁️",
+    "unknown-error-retry": "",
+    "plan-mode": "📝",
+    "subagents": "🤖"
+  }
+}
+```
+
+- Missing key: use the built-in icon, or `🔌` for an unknown status key.
+- String value: use that string as the icon.
+- Empty string: show the status text without an icon.
+- `PI_STATUSLINE_PRESET` remains the only preset setting; this JSON file only controls extension status icons.
+
+During the `PI_CAFFEINATE_ICON` deprecation window, a leading emoji from `pi-caffeinate` is still used when JSON does not configure `caffeinate`. JSON wins when both are set.
 
 ## 👀 What it shows
 
@@ -68,14 +92,14 @@ The default `tokyo-night` statusline uses a Starship-inspired `░▒▓` / `
 
 Statuses from other extensions appear on their own compact line below the main statusline and use each preset's separator.
 
-`pi-statusline` is extension-agnostic: it consumes Pi's generic extension status API and does not import or depend on status-producing extensions. If an extension wants a custom icon, it should include that icon at the start of its status text, for example `ctx.ui.setStatus("goal", "🎯 active")`. Statuses without a leading icon use the generic `🔌` icon.
+`pi-statusline` is extension-agnostic: it consumes Pi's generic extension status API and does not import or depend on status-producing extensions.
 
 Examples:
 
-- `🔌 active` for a plain status such as `goal: active`.
-- `🎯 active` when the producing extension sets `🎯 active`.
-- `🐍 ty ✓ ruff ✓` when the producing extension sets a Python status with a leading icon.
-- `🧪 running` when any extension publishes an activity status with its own icon.
+- `🎯 active` for `goal: active` using the built-in `goal` icon.
+- `☕ display` when JSON config sets `"caffeinate": "☕"`.
+- `receiving` when JSON config sets `"unknown-error-retry": ""`.
+- `🔌 running` for an unknown extension status key with no configured icon.
 - `⚠️ dup biome-lsp` when local and npm installs register the same extension.
 
 ## 🧠 Use cases

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narumitw/pi-statusline",
-	"version": "0.5.0",
+	"version": "0.6.0",
 	"description": "Pi extension that replaces the footer with an information-rich statusline.",
 	"type": "module",
 	"license": "MIT",

package/presets/types.ts

@@ -26,6 +26,7 @@ export interface StatuslineConfig {
 	separator: SeparatorName;
 	showLabels: boolean;
 	segments: SegmentName[];
+	extensionStatusIcons: Record<string, string>;
 }
 
 export interface RenderSegment {

package/src/statusline.ts

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import process from "node:process";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
 import type {
 	ExtensionAPI,
 	ExtensionContext,
@@ -40,8 +41,26 @@ interface TokenTotals {
 }
 
 const STATUSLINE_KEY = "statusline";
+const SETTINGS_FILE = "pi-statusline-settings.json";
 const DEFAULT_PRESET: StatuslinePresetName = "tokyo-night";
 
+const DEFAULT_EXTENSION_STATUS_ICONS: Record<string, string> = {
+	"chrome-devtools": "🌐",
+	"codex-usage": "📊",
+	caffeinate: "💊",
+	firecrawl: "🔥",
+	goal: "🎯",
+	lsp: "🧰",
+	"plan-mode": "📝",
+	pisync: "🔄",
+	subagents: "🧑‍🤝‍🧑",
+	"unknown-error-retry": "🔁",
+};
+
+interface StatuslineSettings {
+	extensionStatusIcons: Record<string, string>;
+}
+
 const DEFAULT_SEGMENTS: SegmentName[] = [
 	"brand",
 	"model",
@@ -173,6 +192,28 @@ function createDefaultConfig(): StatuslineConfig {
 		separator: "dot",
 		showLabels: false,
 		segments: [...DEFAULT_SEGMENTS],
+		extensionStatusIcons: readStatuslineSettings().extensionStatusIcons,
+	};
+}
+
+export function readStatuslineSettings(settingsPath = join(getAgentDir(), SETTINGS_FILE)): StatuslineSettings {
+	try {
+		return normalizeStatuslineSettings(JSON.parse(readFileSync(settingsPath, "utf8")));
+	} catch {
+		return { extensionStatusIcons: {} };
+	}
+}
+
+export function normalizeStatuslineSettings(value: unknown): StatuslineSettings {
+	if (!value || typeof value !== "object") return { extensionStatusIcons: {} };
+	const icons = (value as { extensionStatusIcons?: unknown }).extensionStatusIcons;
+	if (!icons || typeof icons !== "object" || Array.isArray(icons)) {
+		return { extensionStatusIcons: {} };
+	}
+	return {
+		extensionStatusIcons: Object.fromEntries(
+			Object.entries(icons).filter((entry): entry is [string, string] => typeof entry[1] === "string"),
+		),
 	};
 }
 
@@ -351,18 +392,34 @@ function formatExtensionStatuses(
 		...formatDuplicateExtensionStatus(runtime, theme),
 		...[...statuses.entries()]
 			.filter(([key, value]) => key !== STATUSLINE_KEY && value.trim().length > 0)
-			.map(([key, value]) => formatExtensionStatus(key, value, theme)),
+			.map(([key, value]) => formatExtensionStatus(key, value, theme, config)),
 	].slice(0, 5);
 
 	return visibleStatuses.join(separator);
 }
 
-function formatExtensionStatus(key: string, value: string, theme: Theme): string {
+export function formatExtensionStatus(
+	key: string,
+	value: string,
+	theme: Theme,
+	config: Pick<StatuslineConfig, "extensionStatusIcons">,
+): string {
 	const status = splitExtensionStatusIcon(stripExtensionStatusPrefix(key, value));
 	const text = truncateToWidth(simplifyExtensionStatusText(status.text), 22, "…");
 	const color = extensionColor(key, value);
 	const textColor = color === "warning" ? "warning" : "muted";
-	return `${theme.fg(color, status.icon)} ${theme.fg(textColor, text)}`;
+	const icon = extensionStatusIcon(key, status.icon, config.extensionStatusIcons);
+	const renderedText = theme.fg(textColor, text);
+	return icon ? `${theme.fg(color, icon)} ${renderedText}` : renderedText;
+}
+
+function extensionStatusIcon(
+	key: string,
+	leadingIcon: string | undefined,
+	configuredIcons: Record<string, string>,
+) {
+	if (Object.hasOwn(configuredIcons, key)) return configuredIcons[key];
+	return leadingIcon ?? DEFAULT_EXTENSION_STATUS_ICONS[key] ?? "🔌";
 }
 
 function formatDuplicateExtensionStatus(runtime: RuntimeState, theme: Theme): string[] {
@@ -373,13 +430,13 @@ function formatDuplicateExtensionStatus(runtime: RuntimeState, theme: Theme): st
 	return [`${theme.fg("warning", "⚠️")} ${theme.fg("warning", `dup ${names}${suffix}`)}`];
 }
 
-export function splitExtensionStatusIcon(value: string): { icon: string; text: string } {
+export function splitExtensionStatusIcon(value: string): { icon?: string; text: string } {
 	const trimmed = value.trim();
 	const [firstToken, ...restTokens] = trimmed.split(/\s+/);
 	if (firstToken && isEmojiOnlyToken(firstToken)) {
 		return { icon: firstToken, text: restTokens.join(" ") };
 	}
-	return { icon: "🔌", text: trimmed };
+	return { text: trimmed };
 }
 
 function isEmojiOnlyToken(value: string): boolean {