@narumitw/pi-statusline 0.49.2 → 0.49.4

package/README.md

@@ -35,11 +35,11 @@ A representative uncolored layout:
 pi install npm:@narumitw/pi-statusline
 ```
 
-Try it without installing, or load it from this repository:
+Try the published package without installing, or load it directly from this repository:
 
 ```bash
 pi -e npm:@narumitw/pi-statusline
-pi -e ./extensions/pi-statusline
+just try statusline
 ```
 
 For the best result, use a terminal font that includes Powerline glyphs and emoji.
@@ -336,8 +336,9 @@ Put transient activity in the value and always clear the same complete key.
 ```text
 extensions/pi-statusline/
 ├── src/
-│   ├── index.ts
-│   ├── statusline.ts
+│   ├── index.ts          # thin entrypoint forwarding to the source runtime
+│   ├── statusline.ts     # authoritative lifecycle implementation
+│   ├── command-contract.ts
 │   ├── render.ts
 │   ├── directory.ts
 │   ├── usage.ts
@@ -357,7 +358,8 @@ extensions/pi-statusline/
 └── package.json
 ```
 
-`src/index.ts` is the thin Pi entrypoint; all other modules are package-internal.
+`src/` is the authoritative published implementation, and `src/index.ts` remains the sole declared
+Pi entrypoint.
 
 ## 🔎 Keywords
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narumitw/pi-statusline",
-	"version": "0.49.2",
+	"version": "0.49.4",
 	"description": "Pi extension that replaces the footer with an information-rich statusline.",
 	"type": "module",
 	"license": "MIT",
@@ -32,7 +32,7 @@
 		"@earendil-works/pi-tui": "*"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.5.6",
+		"@biomejs/biome": "2.5.7",
 		"@earendil-works/pi-coding-agent": "0.83.0",
 		"@earendil-works/pi-tui": "0.83.0",
 		"@types/node": "26.1.2",

package/src/command-contract.ts

@@ -0,0 +1,13 @@
+import type { AutocompleteItem } from "@earendil-works/pi-tui";
+
+export const STATUSLINE_SUBCOMMANDS: readonly AutocompleteItem[] = [
+	{ value: "settings", label: "settings", description: "Edit pi-statusline.json" },
+	{ value: "status", label: "status", description: "Show effective statusline settings" },
+	{ value: "help", label: "help", description: "Show configuration help" },
+];
+
+export function completeStatuslineArguments(prefix: string): AutocompleteItem[] | null {
+	const normalized = prefix.trim().toLowerCase();
+	const matches = STATUSLINE_SUBCOMMANDS.filter((item) => item.value.startsWith(normalized));
+	return matches.length > 0 ? [...matches] : null;
+}

package/src/commands.ts

@@ -4,7 +4,6 @@ import {
 	type ExtensionCommandContext,
 } from "@earendil-works/pi-coding-agent";
 import {
-	type AutocompleteItem,
 	Container,
 	Key,
 	matchesKey,
@@ -14,6 +13,7 @@ import {
 	truncateToWidth,
 	wrapTextWithAnsi,
 } from "@earendil-works/pi-tui";
+import { completeStatuslineArguments } from "./command-contract.js";
 import {
 	INFORMATION_PROFILE_NAMES,
 	INFORMATION_PROFILES,
@@ -56,12 +56,6 @@ const SEGMENT_DESCRIPTIONS: Record<SegmentName, string> = {
 	time: "Current local time",
 	turn: "Current session turn count",
 };
-const SUBCOMMANDS: AutocompleteItem[] = [
-	{ value: "settings", label: "settings", description: "Edit pi-statusline.json" },
-	{ value: "status", label: "status", description: "Show effective statusline settings" },
-	{ value: "help", label: "help", description: "Show configuration help" },
-];
-
 export interface StatuslineCommandOptions {
 	settingsPath: string;
 	getLoaded(): LoadedStatuslineSettings;
@@ -74,44 +68,46 @@ export interface StatuslineCommandOptions {
 export function registerStatuslineCommand(pi: ExtensionAPI, options: StatuslineCommandOptions) {
 	pi.registerCommand("statusline", {
 		description: "Open or inspect the statusline settings",
-		getArgumentCompletions(prefix: string): AutocompleteItem[] | null {
-			const normalized = prefix.trim().toLowerCase();
-			const matches = SUBCOMMANDS.filter((item) => item.value.startsWith(normalized));
-			return matches.length > 0 ? matches : null;
-		},
-		handler: async (args, ctx) => {
-			const normalized = args.trim();
-			if (!normalized) {
-				await showMainMenu(ctx, options);
-				return;
-			}
+		getArgumentCompletions: completeStatuslineArguments,
+		handler: (args, ctx) => handleStatuslineCommand(args, ctx, options),
+	});
+}
 
-			const tokens = normalized.split(/\s+/u);
-			const subcommand = tokens[0]?.toLowerCase() ?? "";
-			if (tokens.length > 1) {
-				if (canNotify(ctx)) {
-					ctx.ui.notify(`/statusline ${subcommand} does not accept trailing arguments.`, "warning");
-				}
-				return;
-			}
+export async function handleStatuslineCommand(
+	args: string,
+	ctx: ExtensionCommandContext,
+	options: StatuslineCommandOptions,
+) {
+	const normalized = args.trim();
+	if (!normalized) {
+		await showMainMenu(ctx, options);
+		return;
+	}
 
-			switch (subcommand) {
-				case "settings":
-					await editSettings(ctx, options);
-					return;
-				case "status":
-					showStatus(ctx, options);
-					return;
-				case "help":
-					showHelp(ctx, options.settingsPath);
-					return;
-				default:
-					if (canNotify(ctx)) {
-						ctx.ui.notify(`Unknown /statusline subcommand: ${subcommand}`, "warning");
-					}
+	const tokens = normalized.split(/\s+/u);
+	const subcommand = tokens[0]?.toLowerCase() ?? "";
+	if (tokens.length > 1) {
+		if (canNotify(ctx)) {
+			ctx.ui.notify(`/statusline ${subcommand} does not accept trailing arguments.`, "warning");
+		}
+		return;
+	}
+
+	switch (subcommand) {
+		case "settings":
+			await editSettings(ctx, options);
+			return;
+		case "status":
+			showStatus(ctx, options);
+			return;
+		case "help":
+			showHelp(ctx, options.settingsPath);
+			return;
+		default:
+			if (canNotify(ctx)) {
+				ctx.ui.notify(`Unknown /statusline subcommand: ${subcommand}`, "warning");
 			}
-		},
-	});
+	}
 }
 
 async function showMainMenu(ctx: ExtensionCommandContext, options: StatuslineCommandOptions) {

package/src/statusline.ts

@@ -4,7 +4,8 @@ import {
 	type ExtensionContext,
 	getAgentDir,
 } from "@earendil-works/pi-coding-agent";
-import { registerStatuslineCommand } from "./commands.js";
+import { completeStatuslineArguments } from "./command-contract.js";
+import type { StatuslineCommandOptions } from "./commands.js";
 import {
 	buildExtensionStatusIconAliases,
 	type ExtensionStatusIconAliasMap,
@@ -27,6 +28,19 @@ const GIT_STATUS_REFRESH_INTERVAL_MS = 30_000;
 const GIT_STATUS_EVENT_DEBOUNCE_MS = 250;
 const EMPTY_EXTENSION_STATUS_ICON_ALIASES: ExtensionStatusIconAliasMap = new Map();
 
+type StatuslineCommands = typeof import("./commands.js");
+let statuslineCommandsPromise: Promise<StatuslineCommands> | undefined;
+
+function loadStatuslineCommands(): Promise<StatuslineCommands> {
+	if (!statuslineCommandsPromise) {
+		statuslineCommandsPromise = import("./commands.js").catch((error) => {
+			statuslineCommandsPromise = undefined;
+			throw error;
+		});
+	}
+	return statuslineCommandsPromise;
+}
+
 export default function statusline(pi: ExtensionAPI) {
 	let loaded: LoadedStatuslineSettings | undefined;
 	let previewPalettePreset: PalettePreset | undefined;
@@ -193,7 +207,7 @@ export default function statusline(pi: ExtensionAPI) {
 
 	const agentDir = getAgentDir();
 	const configPath = settingsFilePath(agentDir);
-	registerStatuslineCommand(pi, {
+	const commandOptions: StatuslineCommandOptions = {
 		settingsPath: configPath,
 		getLoaded: () => loaded ?? loadStatuslineSettings(configPath),
 		getMenuOwner: () => {
@@ -214,6 +228,15 @@ export default function statusline(pi: ExtensionAPI) {
 			previewPalettePreset = palettePreset;
 			refresh();
 		},
+	};
+	pi.registerCommand("statusline", {
+		description: "Open or inspect the statusline settings",
+		getArgumentCompletions: completeStatuslineArguments,
+		handler: async (args, ctx) => {
+			const commands = await loadStatuslineCommands();
+			if (ctx.sessionManager !== activeSessionManager) return;
+			await commands.handleStatuslineCommand(args, ctx, commandOptions);
+		},
 	});
 
 	pi.on("session_start", (_event, ctx) => {