pi-bar 0.3.40 → 0.3.43

package/README.md

@@ -6,7 +6,7 @@
 **Never accidentally run Opus on a typo again.** pi-bar keeps your model, thinking level, context pressure, a live progress update, and any extension statuses visible in pi's footer.
 
 ```text
-claude-opus-4.7  ❯  think:med  ❯  2.6% / 1.0M  ❯  Reviewing package structure  ❯  plan:active ❯ queue:2
+claude-opus-4.7  ❯  think:med  ❯  2.6% / 1.0M  ❯  Reviewing package structure  ❯  Plan active  ❯  Queue: 2
 ```
 
 ![pi-bar with low context usage](https://cdn.jsdelivr.net/npm/pi-bar@0.3.38/assets/screenshot-green.png)
@@ -35,6 +35,19 @@ If pi is already running after install, reload resources:
 /reload
 ```
 
+## Automatic layout
+
+The footer adapts to terminal width without extra configuration:
+
+- **Model, thinking level, and context percentage take priority.**
+- Separators have two spaces on each side by default, for a roomier display.
+- Progress text shrinks first. If space is still tight, separator padding reduces to one space per side before compacting content. CWD then compacts from its preferred path to `parent/project`, then `project`; context window size is omitted when needed.
+- Extension badges stay in their published order. Badges that cannot fit are hidden whole, with `+N` showing how many are behind the overflow. Open `/bar status` to inspect their text and visibility by key.
+- On very narrow terminals, progress and CWD yield to core information. If even the core cannot fit, the model name is truncated first. At extreme widths, not every value or overflow count can remain visible.
+- Widening the terminal restores the full display. Thinking and context retain their semantic colors throughout.
+
+Existing segment visibility settings still apply; CWD remains opt-in.
+
 ## Customization
 
 pi-bar works out of the box. Run `/bar` inside pi to choose which footer segments and extension statuses are shown:
@@ -43,7 +56,7 @@ pi-bar works out of the box. Run `/bar` inside pi to choose which footer segment
 /bar
 ```
 
-Toggle `Model`, `Thinking level`, `Context usage`, `Progress update`, and `Extension statuses` between `shown` and `hidden`. If other extensions have published status badges, `/bar` also shows fine-grained `Status: <key>` rows plus a `New extension statuses` default. You can also use commands:
+Toggle `Model`, `Thinking level`, `Context usage`, `Current directory`, `Progress update`, and `Extension statuses` between `shown` and `hidden`. If other extensions have published status badges, `/bar` also shows fine-grained `Status: <key>` rows plus a `New extension statuses` default. You can also use commands:
 
 ```text
 /bar segments list
@@ -52,7 +65,7 @@ Toggle `Model`, `Thinking level`, `Context usage`, `Progress update`, and `Exten
 /bar segments show thinking
 ```
 
-Allowed segments are `model`, `thinking`, `context`, `progress`, and `extensions`. The `progress` segment stays hidden until pi-bar has a current update. The `extensions` segment stays hidden when no extension has set a status.
+Allowed segments are `model`, `thinking`, `context`, `cwd`, `progress`, and `extensions`. The `cwd` segment is off by default. The `progress` segment stays hidden until pi-bar has a current update. The `extensions` segment stays hidden when no extension has set a status.
 
 You can also set startup defaults with environment variables before launching pi:
 
@@ -61,6 +74,30 @@ PI_BAR_SHOW=model,thinking,context,progress,extensions pi
 PI_BAR_SHOW=model,context pi
 ```
 
+### Show the session directory
+
+Enable the optional `cwd` segment to distinguish projects and sessions:
+
+```text
+/bar segments show cwd
+```
+
+Or set startup segments with `PI_BAR_SHOW=model,thinking,context,cwd,progress,extensions`.
+
+```text
+claude-opus-4.7  ❯  think:med  ❯  2.6% / 1.0M  ❯  ~/projects/pi-bar
+```
+
+Your home directory becomes `~`. Long paths omit middle directories, retaining trailing directory names where possible. The segment is capped at 36 terminal columns, including wide Unicode characters. Override the cap before starting pi:
+
+```bash
+PI_BAR_CWD_MAX_WIDTH=48 pi
+```
+
+The cap must be an integer of at least 8; invalid values use 36. Very long directory names are truncated. Paths are stripped of terminal controls before display.
+
+This is Pi's session working directory (`ctx.cwd`), not a live shell directory: `cd` inside a tool command does not change it. Visibility persists through the existing `/bar` configuration.
+
 ### Configure live progress updates
 
 pi-bar shows a short, plain-English description of what pi is working on right now. It refreshes as pi works and resets when you switch branches in the session tree, so stale updates never follow you across tasks. Hide `Progress update` in `/bar`, run `/bar segments hide progress`, or set `PI_BAR_SHOW` without `progress` to disable it.
@@ -75,7 +112,9 @@ Or in pi settings: `bar.progressModel`. Otherwise pi-bar picks a fast model you
 
 ### Configure extension statuses
 
-Other pi extensions can publish small status badges. Pi-bar collects them into the `extensions` segment, strips embedded terminal colors, and separates each badge with the same `❯` divider used by other footer segments. Run `/bar` or `/bar status` inside pi to pick which ones to show:
+Other pi extensions can publish small status badges. Pi-bar displays their text as written, without prepending internal keys: `setStatus("mcp", "MCP: 2/2 servers")` appears as `MCP: 2/2 servers`, not `mcp:MCP: 2/2 servers`. Extensions should publish self-describing text; pi-bar does not guess labels for bare values.
+
+Pi-bar strips embedded terminal colors and control sequences, and separates each badge with the same `❯` divider used by other footer segments. Keys remain available for filtering and identification in `/bar`; selecting a status row shows its current sanitized text. Run `/bar` or `/bar status` inside pi to inspect statuses or pick which ones to show:
 
 ```text
 /bar status
@@ -98,6 +137,16 @@ The first number is the warning/yellow threshold. The second number is the dange
 - **[pi-chrome](https://www.npmjs.com/package/pi-chrome)** — give your Pi agent your real, signed-in Chrome. Use pi-bar's red-context threshold as the signal to wrap up long browser scrapes before context overflows.
 - **[pi-qq](https://www.npmjs.com/package/pi-qq)** — ask side questions about what the agent just did without polluting the transcript.
 
+## Development
+
+```bash
+npm ci --ignore-scripts
+npm test
+npm run check
+```
+
+Tests cover path formatting, display-ready statuses, responsive layout, terminal safety, ANSI/Unicode width limits, resize behavior, and segment/status visibility persistence. Test configuration mirrors Pi's `pi-ai/compat` loader alias; runtime dependencies remain optional peers supplied by Pi.
+
 ## Security note
 
 Pi extensions run with your local user permissions. Review any pi package source before installing it.

package/extensions/status-footer.ts

@@ -2,7 +2,7 @@
  * pi-bar — footer / statusline extension.
  *
  * Replaces pi's built-in footer with left-aligned segments:
- *   <model> ❯ think:<level> ❯ <context% / window> ❯ <progress> ❯ <extensions>
+ *   <model> ❯ think:<level> ❯ <context% / window> ❯ [cwd] ❯ <progress> ❯ <extensions>
  *
  * Example:
  *   claude-opus-4.7  ❯  think:med  ❯  2.6% / 1.0M  ❯  Reviewing package structure
@@ -15,11 +15,12 @@
  *   PI_BAR_THRESHOLDS     warning,danger context-usage percentages
  *   PI_BAR_PROGRESS_MODEL provider/id for the progress update model
  *   PI_BAR_CONFIG         override the persisted pi-bar config path
+ *   PI_BAR_CWD_MAX_WIDTH  maximum cwd segment width in terminal columns (default 36)
  */
 
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
+import { dirname, join, posix, win32 } from "node:path";
 import { complete, type UserMessage } from "@earendil-works/pi-ai";
 import {
 	getSettingsListTheme,
@@ -33,9 +34,10 @@ import {
 	type SettingItem,
 	SettingsList,
 	truncateToWidth,
+	visibleWidth,
 } from "@earendil-works/pi-tui";
 
-type SegmentName = "model" | "thinking" | "context" | "progress" | "extensions";
+type SegmentName = "model" | "thinking" | "context" | "cwd" | "progress" | "extensions";
 type StatusFilter =
 	| { mode: "all"; hidden: Set<string> }
 	| { mode: "only"; shown: Set<string> };
@@ -75,7 +77,7 @@ type ProgressModelPreference = { provider: string; id: string };
 type FastModelAuth = {
 	model: Parameters<typeof complete>[0];
 	apiKey: string;
-	headers?: Record<string, string>;
+	headers?: NonNullable<Parameters<typeof complete>[2]>["headers"];
 };
 
 const STATUS_FILTER_ENTRY_TYPE = "pi-bar-status-filter";
@@ -118,6 +120,7 @@ const ALL_SEGMENTS: readonly SegmentName[] = [
 	"model",
 	"thinking",
 	"context",
+	"cwd",
 	"progress",
 	"extensions",
 ];
@@ -125,6 +128,7 @@ const SEGMENT_LABELS: Record<SegmentName, string> = {
 	model: "Model",
 	thinking: "Thinking level",
 	context: "Context usage",
+	cwd: "Current directory",
 	progress: "Progress update",
 	extensions: "Extension statuses",
 };
@@ -132,7 +136,6 @@ const DEFAULT_WARNING_THRESHOLD = 70;
 const DEFAULT_ERROR_THRESHOLD = 90;
 
 const SEGMENT_SEPARATOR = "❯";
-const EXTENSION_STATUS_SEPARATOR = SEGMENT_SEPARATOR;
 
 function formatTokens(n: number): string {
 	if (n >= 1_000_000) {
@@ -152,6 +155,150 @@ function formatModelName(id: string | undefined): string {
 	return base.replace(/-\d{8}$/, "").replace(/-\d{4}-\d{2}-\d{2}$/, "");
 }
 
+const DEFAULT_CWD_MAX_WIDTH = 36;
+
+export function parseCwdMaxWidth(raw: string | undefined): number {
+	const value = raw?.trim() ?? "";
+	const width = /^\d+$/.test(value) ? Number(value) : NaN;
+	return Number.isSafeInteger(width) && width >= 8 ? width : DEFAULT_CWD_MAX_WIDTH;
+}
+
+/** Format the session directory, preserving the leaf when middle components fit poorly. */
+export function formatCwd(
+	cwd: string,
+	home = homedir(),
+	maxWidth = DEFAULT_CWD_MAX_WIDTH,
+	paths = process.platform === "win32" ? win32 : posix,
+): string {
+	if (maxWidth <= 0) return "";
+	if (!cwd) return truncateToWidth("—", maxWidth);
+
+	const relative = home ? paths.relative(home, cwd) : undefined;
+	const insideHome = relative !== undefined &&
+		!paths.isAbsolute(relative) && relative !== ".." && !relative.startsWith(`..${paths.sep}`);
+	const prefix = insideHome ? `~${paths.sep}` : paths.parse(cwd).root;
+	const tail = insideHome ? relative! : cwd.slice(prefix.length);
+	const display = stripTerminalControls(insideHome ? (tail ? `${prefix}${tail}` : "~") : cwd);
+	if (visibleWidth(display) <= maxWidth) return display;
+
+	const parts = tail.split(paths.sep).filter(Boolean);
+	if (parts.length < 2) return truncateToWidth(display, maxWidth);
+
+	// Keep as many trailing directories as the column budget allows.
+	let compact = stripTerminalControls(`${prefix}…${paths.sep}${parts.at(-1)}`);
+	for (let index = parts.length - 2; index > 0; index--) {
+		const candidate = stripTerminalControls(`${prefix}…${paths.sep}${parts.slice(index).join(paths.sep)}`);
+		if (visibleWidth(candidate) > maxWidth) break;
+		compact = candidate;
+	}
+	return truncateToWidth(compact, maxWidth);
+}
+
+/** Preferred directory display, then parent/project, then project only. */
+export function cwdVariants(
+	cwd: string,
+	home = homedir(),
+	maxWidth = DEFAULT_CWD_MAX_WIDTH,
+	paths = process.platform === "win32" ? win32 : posix,
+): string[] {
+	const safeCwd = stripTerminalControls(cwd);
+	const leaf = paths.basename(safeCwd);
+	const parent = paths.basename(paths.dirname(safeCwd));
+	return [
+		formatCwd(cwd, home, maxWidth, paths),
+		...[parent && leaf ? `${parent}${paths.sep}${leaf}` : leaf, leaf]
+			.filter(Boolean)
+			.map((text) => truncateToWidth(stripTerminalControls(text), maxWidth, "…")),
+	].map(stripTerminalControls);
+}
+
+export type FooterSegment = {
+	name: SegmentName;
+	text: string;
+	/** Shorter, already styled representations, in preference order. */
+	alternatives?: readonly string[];
+};
+
+/** Pure, column-aware layout. The divider may be styled but has no padding. Never split a status badge. */
+export function layoutFooter(
+	segments: readonly FooterSegment[],
+	badges: readonly string[],
+	width: number,
+	divider = SEGMENT_SEPARATOR,
+): string {
+	if (!Number.isFinite(width) || width <= 0) return "";
+	width = Math.floor(width);
+	let separator = `  ${divider}  `;
+	const items = segments.map((segment) => ({ ...segment }));
+	const extensions = items.find((item) => item.name === "extensions");
+	let shownBadges = badges.length;
+	const updateBadges = () => {
+		if (!extensions) return;
+		const hidden = badges.length - shownBadges;
+		extensions.text = [...badges.slice(0, shownBadges), ...(hidden ? [`+${hidden}`] : [])].join(separator);
+	};
+	updateBadges();
+	const line = () => items.map((item) => item.text).filter(Boolean).join(separator);
+	const overflow = () => visibleWidth(line()) - width;
+	const progress = items.find((item) => item.name === "progress");
+	if (progress && overflow() > 0) {
+		const currentWidth = visibleWidth(progress.text);
+		// Keep a short activity fragment while trying the other compact forms.
+		const minimumWidth = Math.min(12, width);
+		const progressWidth = Math.min(currentWidth, Math.max(minimumWidth, currentWidth - overflow()));
+		progress.text = truncateToWidth(progress.text, progressWidth, "…");
+	}
+	// Keep the roomy default while progress alone can absorb width pressure.
+	// Tighten gaps before compacting paths/context or overflowing whole badges.
+	if (overflow() > 0) {
+		separator = ` ${divider} `;
+		updateBadges();
+	}
+	for (const name of ["cwd", "context", "thinking"] as const) {
+		const item = items.find((item) => item.name === name);
+		if (!item) continue;
+		for (const alternative of item.alternatives ?? []) {
+			if (overflow() <= 0) break;
+			if (visibleWidth(alternative) < visibleWidth(item.text)) item.text = alternative;
+		}
+	}
+	while (extensions && shownBadges > 0 && overflow() > 0) {
+		shownBadges--;
+		updateBadges();
+	}
+	// On very narrow terminals, remove optional content before clipping identity.
+	for (const name of ["progress", "cwd", "extensions"] as const) {
+		if (overflow() <= 0) break;
+		const item = items.find((item) => item.name === name);
+		if (item) {
+			item.text = name === "cwd"
+				? truncateToWidth(item.text, Math.max(0, visibleWidth(item.text) - overflow()), "…")
+				: "";
+		}
+	}
+	const model = items.find((item) => item.name === "model");
+	if (model && overflow() > 0) {
+		model.text = truncateToWidth(model.text, Math.max(0, visibleWidth(model.text) - overflow()), "…");
+	}
+	// Whole-badge overflow can free more space than needed. Use that space rather
+	// than leaving unnecessarily compact context, paths, or progress on screen.
+	for (const name of ["context", "thinking", "cwd", "progress"] as const) {
+		const item = items.find((item) => item.name === name);
+		const original = segments.find((segment) => segment.name === name);
+		if (!item?.text || !original) continue;
+		const budget = visibleWidth(item.text) - overflow();
+		if (name === "progress") {
+			item.text = truncateToWidth(original.text, Math.max(0, budget), "…");
+		} else {
+			const preferred = [original.text, ...(original.alternatives ?? [])]
+				.find((text) => visibleWidth(text) <= budget);
+			if (preferred !== undefined) item.text = preferred;
+		}
+	}
+	// A terminal narrower than thinking + context cannot show every core value.
+	return truncateToWidth(line(), width, "…");
+}
+
 function thinkingColor(level: string): ThemeColor {
 	switch (level) {
 		case "off":
@@ -1523,7 +1670,7 @@ function shouldShowStatus(key: string, filter: StatusFilter): boolean {
 	return !filter.hidden.has(key);
 }
 
-function formatExtensionStatuses(
+export function formatExtensionStatuses(
 	statuses: ReadonlyMap<string, string>,
 	filter: StatusFilter,
 	seenStatusKeys: Set<string>,
@@ -1534,9 +1681,7 @@ function formatExtensionStatuses(
 			seenStatusKeys.add(key);
 			return shouldShowStatus(key, filter);
 		})
-		.map(([key, text]) =>
-			`${stripTerminalControls(key)}:${stripTerminalControls(text)}`,
-		);
+		.map(([, text]) => stripTerminalControls(text));
 
 	return parts.length > 0 ? parts : null;
 }
@@ -1656,6 +1801,9 @@ export default function (pi: ExtensionAPI) {
 	let statusFilter: StatusFilter = { mode: "all", hidden: new Set() };
 	let visibleSegments: SegmentName[] = readGlobalSegments() ?? DEFAULT_SEGMENTS;
 	const seenStatusKeys = new Set<string>();
+	let currentStatuses: ReadonlyMap<string, string> = new Map();
+	const statusDescription = (key: string) =>
+		stripTerminalControls(currentStatuses.get(key) ?? "") || "No current status text";
 	const refresh = () => requestRender?.();
 	const progress = new FooterProgressEngine(refresh);
 	const restoreStatusFilter = (ctx: ExtensionContext) => {
@@ -1740,8 +1888,8 @@ export default function (pi: ExtensionAPI) {
 					},
 					...knownStatusKeys.map((key): SettingItem => ({
 						id: `status:${key}`,
-						label: `Status: ${key}`,
-						description: "Extension status visibility",
+						label: `Status: ${stripTerminalControls(key)}`,
+						description: statusDescription(key),
 						currentValue: statusVisibility.get(key) ? "shown" : "hidden",
 						values: ["shown", "hidden"],
 					})),
@@ -1856,8 +2004,8 @@ export default function (pi: ExtensionAPI) {
 				},
 				...knownStatusKeys.map((key): SettingItem => ({
 					id: key,
-					label: key,
-					description: "Extension status visibility",
+					label: stripTerminalControls(key),
+					description: statusDescription(key),
 					currentValue: statusVisibility.get(key) ? "shown" : "hidden",
 					values: ["shown", "hidden"],
 				})),
@@ -2078,6 +2226,7 @@ export default function (pi: ExtensionAPI) {
 		if (!ctx.hasUI) return;
 
 		const { warningThreshold, errorThreshold } = parseThresholds();
+		const cwdWidth = parseCwdMaxWidth(process.env.PI_BAR_CWD_MAX_WIDTH);
 
 		ctx.ui.setFooter((tui, theme, footerData) => {
 			requestRender = () => tui.requestRender();
@@ -2090,8 +2239,9 @@ export default function (pi: ExtensionAPI) {
 				render(width: number): string[] {
 					const modelName = formatModelName(ctx.model?.id);
 					const thinkingLevel = String(pi.getThinkingLevel());
+					currentStatuses = footerData?.getExtensionStatuses?.() ?? new Map();
 					const extensionStatusParts = formatExtensionStatuses(
-						footerData?.getExtensionStatuses?.() ?? new Map(),
+						currentStatuses,
 						statusFilter,
 						seenStatusKeys,
 					);
@@ -2107,26 +2257,33 @@ export default function (pi: ExtensionAPI) {
 						: "—";
 					const progressText = progress.text();
 
-					const extensionStatuses = extensionStatusParts
-						? extensionStatusParts
-							.map((part) => theme.fg("text", part))
-							.join(` ${theme.fg("dim", EXTENSION_STATUS_SEPARATOR)} `)
-						: null;
-					const segmentRenderers: Record<SegmentName, string | null> = {
-						model: theme.fg("accent", modelName),
-						thinking: theme.fg(thinkingColor(thinkingLevel), `think:${thinkingLevel}`),
-						context: theme.fg(contextSegmentColor, contextText),
-						progress: progressText ? theme.fg("text", progressText) : null,
-						extensions: extensionStatuses,
+					const directories = visibleSegments.includes("cwd")
+						? cwdVariants(ctx.cwd, homedir(), cwdWidth).map((text) => theme.fg("accent", text))
+						: [];
+					const contextCompact = usage
+						? usage.percent !== null ? `${usage.percent.toFixed(1)}%` : "—%"
+						: "—";
+					const shortThinking = thinkingLevel === "medium" ? "med" : thinkingLevel === "minimal" ? "min" : thinkingLevel;
+					const renderers: Record<SegmentName, Omit<FooterSegment, "name">> = {
+						model: { text: theme.fg("accent", stripTerminalControls(modelName)) },
+						thinking: {
+							text: theme.fg(thinkingColor(thinkingLevel), `think:${thinkingLevel}`),
+							alternatives: [theme.fg(thinkingColor(thinkingLevel), `think:${shortThinking}`)],
+						},
+						context: {
+							text: theme.fg(contextSegmentColor, contextText),
+							alternatives: [theme.fg(contextSegmentColor, contextCompact)],
+						},
+						cwd: { text: directories[0] ?? "", alternatives: directories.slice(1) },
+						progress: { text: progressText ? theme.fg("text", progressText) : "" },
+						extensions: { text: "" },
 					};
-
-					const separator = `  ${theme.fg("dim", SEGMENT_SEPARATOR)}  `;
-					const line = visibleSegments
-						.map((segment) => segmentRenderers[segment])
-						.filter((segment): segment is string => segment !== null)
-						.join(separator);
-
-					return [truncateToWidth(line, width)];
+					return [layoutFooter(
+						visibleSegments.map((name) => ({ name, ...renderers[name] })),
+						(extensionStatusParts ?? []).map((part) => theme.fg("text", part)),
+						width,
+						theme.fg("dim", SEGMENT_SEPARATOR),
+					)];
 				},
 			};
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-bar",
-  "version": "0.3.40",
+  "version": "0.3.43",
   "description": "Pi footer/statusline showing active model, thinking level, context pressure, live progress updates, and extension statuses.",
   "type": "module",
   "keywords": [
@@ -52,5 +52,17 @@
       "./extensions/status-footer.ts"
     ],
     "image": "https://cdn.jsdelivr.net/npm/pi-bar@0.3.38/assets/screenshot-yellow.png"
+  },
+  "scripts": {
+    "test": "tsx --tsconfig tests/tsconfig.json --test tests/*.test.ts",
+    "check": "tsc -p tests/tsconfig.json"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "^0.85.1",
+    "@earendil-works/pi-coding-agent": "^0.85.1",
+    "@earendil-works/pi-tui": "^0.85.1",
+    "@types/node": "^22.20.2",
+    "tsx": "^4.23.13",
+    "typescript": "^5.9.3"
   }
 }