@narumitw/pi-statusline 0.10.0 → 0.12.0

package/README.md

@@ -9,7 +9,7 @@ Use it to monitor model selection, thinking level, git branch, working directory
 ## ✨ Features
 
 - 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.
+- Shows model, thinking level, git branch/status, project directory, active tool, context usage, tokens, cost, and clock.
 - Displays compact statuses published through Pi's generic extension status API.
 - 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.
@@ -64,14 +64,19 @@ Extension statuses use built-in icons by status key. Override or suppress them i
     "pisync": "☁️",
     "unknown-error-retry": "",
     "plan-mode": "📝",
-    "subagents": "🤖"
+    "subagents": "🤖",
+    "@vendor/pi-foo": "🧪"
   }
 }
 ```
 
+- Exact status key: always wins, e.g. `"goal"` or `"foo:server"`.
+- Installed extension id: for installed packages, use the package name/source such as `"@vendor/pi-foo"`, `"npm:@vendor/pi-foo@1.2.3"`, `"pi-foo"`, or the derived key `"foo"`.
+- Namespaced status keys: package `@vendor/pi-foo` can match `foo`, `foo:server`, and `foo/server`, but not fuzzy matches like `foobar`.
 - 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.
+- If multiple installed packages derive the same key, use the exact status key to disambiguate.
 - `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.
@@ -84,13 +89,15 @@ The default `tokyo-night` statusline uses a Starship-inspired `░▒▓` / `
 - 🤖 current model.
 - 🧠 thinking level.
 - 📁 current project directory.
-- 🌿 git branch.
+- 🌿 git branch, with compact git status tokens when dirty or ahead/behind.
 - ⚙ active or last tool.
 - 🪟 context usage percentage.
 - 🔢 token totals.
 - 💸 estimated cost.
 - 🕒 clock.
 
+Git status tokens are hidden for clean repositories. When present, they mean `⇡` ahead, `⇣` behind, `+` staged, `~` modified/deleted in the worktree, `?` untracked, and `!` conflicts. Example: `🌿 main ⇡1 +2 ~1 ?3`.
+
 Statuses from other extensions appear below the main statusline, use each preset's separator, and wrap onto additional footer lines when they exceed the terminal width.
 
 `pi-statusline` is extension-agnostic: it consumes Pi's generic extension status API and does not import or depend on status-producing extensions.
@@ -100,6 +107,7 @@ Examples:
 - `🎯 active` for `goal: active` using the built-in `goal` icon.
 - `🔎 PR #123 checks passing` for `github-pr: PR #123 checks passing` using the built-in `github-pr` icon.
 - `☕ display` when JSON config sets `"caffeinate": "☕"`.
+- `🧪 running` for third-party status `foo:server` when an installed package is named `@vendor/pi-foo` and JSON config sets `"@vendor/pi-foo": "🧪"`.
 - `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.

package/package.json

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

package/src/statusline.ts

@@ -22,6 +22,7 @@ import type {
 } from "../presets/types.js";
 
 type ThinkingLevel = ReturnType<ExtensionAPI["getThinkingLevel"]>;
+export type ExtensionStatusIconAliasMap = ReadonlyMap<string, readonly string[]>;
 
 interface RuntimeState {
 	turnCount: number;
@@ -31,9 +32,20 @@ interface RuntimeState {
 	isStreaming: boolean;
 	thinkingLevel: ThinkingLevel;
 	duplicateExtensions: string[];
+	extensionStatusIconAliases: ExtensionStatusIconAliasMap;
+	gitStatus?: GitStatusSummary;
 	requestRender?: () => void;
 }
 
+export interface GitStatusSummary {
+	ahead: number;
+	behind: number;
+	staged: number;
+	modified: number;
+	untracked: number;
+	conflicts: number;
+}
+
 interface TokenTotals {
 	input: number;
 	output: number;
@@ -44,6 +56,11 @@ const STATUSLINE_KEY = "statusline";
 const GITHUB_PR_KEY = "github-pr";
 const SETTINGS_FILE = "pi-statusline-settings.json";
 const DEFAULT_PRESET: StatuslinePresetName = "tokyo-night";
+const GIT_STATUS_REFRESH_INTERVAL_MS = 30_000;
+const GIT_STATUS_EVENT_DEBOUNCE_MS = 250;
+const GIT_STATUS_TIMEOUT_MS = 3_000;
+
+const EMPTY_EXTENSION_STATUS_ICON_ALIASES: ExtensionStatusIconAliasMap = new Map();
 
 const DEFAULT_EXTENSION_STATUS_ICONS: Record<string, string> = {
 	"chrome-devtools": "🌐",
@@ -93,23 +110,125 @@ export default function statusline(pi: ExtensionAPI) {
 		isStreaming: false,
 		thinkingLevel: "off",
 		duplicateExtensions: [],
+		extensionStatusIconAliases: EMPTY_EXTENSION_STATUS_ICON_ALIASES,
 	};
 
+	let sessionGeneration = 0;
+	let gitStatusRequestId = 0;
+	let activeGitStatusTarget: { cwd: string; generation: number } | undefined;
+	let gitStatusRefreshInFlight = false;
+	let gitStatusDebounceTimer: ReturnType<typeof setTimeout> | undefined;
+	let pendingGitStatusRefresh:
+		| { cwd: string; generation: number; requestId: number }
+		| undefined;
+
 	const refresh = () => runtime.requestRender?.();
 
+	const setGitStatus = (summary: GitStatusSummary | undefined) => {
+		if (gitStatusSummaryEqual(runtime.gitStatus, summary)) return;
+		runtime.gitStatus = summary;
+		refresh();
+	};
+
+	const clearGitStatusDebounce = () => {
+		if (!gitStatusDebounceTimer) return;
+		clearTimeout(gitStatusDebounceTimer);
+		gitStatusDebounceTimer = undefined;
+	};
+
+	const isActiveGitStatusTarget = (cwd: string, generation: number) =>
+		activeGitStatusTarget?.cwd === cwd &&
+		activeGitStatusTarget.generation === generation &&
+		generation === sessionGeneration;
+
+	const isCurrentGitStatusRequest = (cwd: string, generation: number, requestId: number) =>
+		isActiveGitStatusTarget(cwd, generation) && requestId === gitStatusRequestId;
+
+	const runGitStatusRefresh = (cwd: string, generation: number, requestId: number) => {
+		if (!isCurrentGitStatusRequest(cwd, generation, requestId)) return;
+		if (gitStatusRefreshInFlight) {
+			pendingGitStatusRefresh = { cwd, generation, requestId };
+			return;
+		}
+
+		gitStatusRefreshInFlight = true;
+		void (async () => {
+			try {
+				const summary = await readGitStatus(pi, cwd);
+				if (isCurrentGitStatusRequest(cwd, generation, requestId)) setGitStatus(summary);
+			} catch {
+				if (isCurrentGitStatusRequest(cwd, generation, requestId)) setGitStatus(undefined);
+			} finally {
+				gitStatusRefreshInFlight = false;
+				const pending = pendingGitStatusRefresh;
+				pendingGitStatusRefresh = undefined;
+				if (pending) runGitStatusRefresh(pending.cwd, pending.generation, pending.requestId);
+			}
+		})();
+	};
+
+	const refreshGitStatus = (cwd: string, generation = sessionGeneration) => {
+		if (!isActiveGitStatusTarget(cwd, generation)) return;
+		runGitStatusRefresh(cwd, generation, ++gitStatusRequestId);
+	};
+
+	const scheduleGitStatusRefresh = (cwd: string, generation = sessionGeneration) => {
+		if (!isActiveGitStatusTarget(cwd, generation)) return;
+		const requestId = ++gitStatusRequestId;
+		clearGitStatusDebounce();
+		gitStatusDebounceTimer = setTimeout(() => {
+			gitStatusDebounceTimer = undefined;
+			runGitStatusRefresh(cwd, generation, requestId);
+		}, GIT_STATUS_EVENT_DEBOUNCE_MS);
+	};
+
+	const scheduleGitStatusRefreshForContext = (ctx: ExtensionContext) => {
+		if (!activeGitStatusTarget || activeGitStatusTarget.cwd !== ctx.cwd) return;
+		scheduleGitStatusRefresh(activeGitStatusTarget.cwd, activeGitStatusTarget.generation);
+	};
+
 	const installFooter = (ctx: ExtensionContext) => {
+		const generation = ++sessionGeneration;
+		const cwd = ctx.cwd;
+		clearGitStatusDebounce();
+		activeGitStatusTarget = ctx.mode === "tui" ? { cwd, generation } : undefined;
+		runtime.gitStatus = undefined;
+		runtime.duplicateExtensions = [];
+		runtime.extensionStatusIconAliases = EMPTY_EXTENSION_STATUS_ICON_ALIASES;
 		ctx.ui.setStatus(STATUSLINE_KEY, undefined);
-		runtime.duplicateExtensions = findDuplicateExtensions(ctx.cwd);
+		if (!activeGitStatusTarget) return;
+		const installedPackages = readInstalledExtensionPackages(cwd);
+		runtime.duplicateExtensions = findDuplicateExtensions(installedPackages);
+		runtime.extensionStatusIconAliases = buildExtensionStatusIconAliases(installedPackages);
 		ctx.ui.setFooter((tui, theme, footerData) => {
 			runtime.requestRender = () => tui.requestRender();
 
-			const branchUnsubscribe = footerData.onBranchChange(() => tui.requestRender());
-			const clock = setInterval(() => tui.requestRender(), 30_000);
+			const refreshFooterGitStatus = () => refreshGitStatus(cwd, generation);
+			const branchUnsubscribe = footerData.onBranchChange(() => {
+				runtime.gitStatus = undefined;
+				clearGitStatusDebounce();
+				refreshFooterGitStatus();
+				tui.requestRender();
+			});
+			const clock = setInterval(() => {
+				clearGitStatusDebounce();
+				refreshFooterGitStatus();
+				tui.requestRender();
+			}, GIT_STATUS_REFRESH_INTERVAL_MS);
 
 			return {
 				dispose() {
 					branchUnsubscribe();
 					clearInterval(clock);
+					if (isActiveGitStatusTarget(cwd, generation)) {
+						activeGitStatusTarget = undefined;
+						clearGitStatusDebounce();
+						pendingGitStatusRefresh = undefined;
+						runtime.gitStatus = undefined;
+						runtime.duplicateExtensions = [];
+						runtime.extensionStatusIconAliases = EMPTY_EXTENSION_STATUS_ICON_ALIASES;
+						runtime.requestRender = undefined;
+					}
 				},
 				invalidate() {},
 				render(width: number): string[] {
@@ -119,6 +238,7 @@ export default function statusline(pi: ExtensionAPI) {
 				},
 			};
 		});
+		refreshGitStatus(cwd, generation);
 	};
 
 	pi.on("session_start", (_event, ctx) => {
@@ -132,6 +252,13 @@ export default function statusline(pi: ExtensionAPI) {
 	});
 
 	pi.on("session_shutdown", (_event, ctx) => {
+		sessionGeneration += 1;
+		activeGitStatusTarget = undefined;
+		clearGitStatusDebounce();
+		pendingGitStatusRefresh = undefined;
+		runtime.gitStatus = undefined;
+		runtime.duplicateExtensions = [];
+		runtime.extensionStatusIconAliases = EMPTY_EXTENSION_STATUS_ICON_ALIASES;
 		ctx.ui.setFooter(undefined);
 		ctx.ui.setStatus(STATUSLINE_KEY, undefined);
 		runtime.requestRender = undefined;
@@ -149,8 +276,9 @@ export default function statusline(pi: ExtensionAPI) {
 		refresh();
 	});
 
-	pi.on("agent_end", () => {
+	pi.on("agent_end", (_event, ctx) => {
 		runtime.isStreaming = false;
+		scheduleGitStatusRefreshForContext(ctx);
 		refresh();
 	});
 
@@ -160,7 +288,10 @@ export default function statusline(pi: ExtensionAPI) {
 		refresh();
 	});
 
-	pi.on("turn_end", () => refresh());
+	pi.on("turn_end", (_event, ctx) => {
+		scheduleGitStatusRefreshForContext(ctx);
+		refresh();
+	});
 
 	pi.on("tool_execution_start", (event) => {
 		const currentCount = runtime.activeTools.get(event.toolName) ?? 0;
@@ -169,12 +300,13 @@ export default function statusline(pi: ExtensionAPI) {
 		refresh();
 	});
 
-	pi.on("tool_execution_end", (event) => {
+	pi.on("tool_execution_end", (event, ctx) => {
 		const currentCount = runtime.activeTools.get(event.toolName) ?? 0;
 		if (currentCount <= 1) runtime.activeTools.delete(event.toolName);
 		else runtime.activeTools.set(event.toolName, currentCount - 1);
 
 		runtime.lastCompletedTool = event.toolName;
+		scheduleGitStatusRefreshForContext(ctx);
 		refresh();
 	});
 }
@@ -280,7 +412,7 @@ function buildSegment(
 		case "branch": {
 			const branch = footerData.getGitBranch();
 			const pr = branch ? prLinkFromStatuses(footerData.getExtensionStatuses()) : undefined;
-			return segment(name, pr ? `🌿 ${branch} (${pr})` : `🌿 ${branch ?? "no-git"}`, color, "git");
+			return segment(name, formatGitBranchText(branch, runtime.gitStatus, pr), color, "git");
 		}
 		case "cwd":
 			return segment(name, `📁 ${basename(ctx.cwd) || ctx.cwd}`, color, "directory");
@@ -390,6 +522,113 @@ export function prLinkFromStatuses(statuses: ReadonlyMap<string, string>): strin
 	return close === -1 ? undefined : value.slice(open, close + closeMarker.length);
 }
 
+async function readGitStatus(
+	pi: ExtensionAPI,
+	cwd: string,
+): Promise<GitStatusSummary | undefined> {
+	const result = await pi.exec(
+		"git",
+		["--no-optional-locks", "status", "--porcelain=v1", "--branch", "--untracked-files=normal"],
+		{
+			cwd,
+			timeout: GIT_STATUS_TIMEOUT_MS,
+		},
+	);
+	if (result.code !== 0 || result.killed) return undefined;
+	return parseGitStatusPorcelain(result.stdout);
+}
+
+export function parseGitStatusPorcelain(output: string): GitStatusSummary {
+	const summary: GitStatusSummary = {
+		ahead: 0,
+		behind: 0,
+		staged: 0,
+		modified: 0,
+		untracked: 0,
+		conflicts: 0,
+	};
+
+	for (const line of output.split(/\r?\n/)) {
+		if (!line) continue;
+		if (line.startsWith("## ")) {
+			const ahead = line.match(/\bahead (\d+)/u);
+			const behind = line.match(/\bbehind (\d+)/u);
+			summary.ahead = ahead ? Number(ahead[1]) : 0;
+			summary.behind = behind ? Number(behind[1]) : 0;
+			continue;
+		}
+
+		const indexStatus = line[0] ?? " ";
+		const worktreeStatus = line[1] ?? " ";
+		if (indexStatus === "?" && worktreeStatus === "?") {
+			summary.untracked += 1;
+			continue;
+		}
+		if (isConflictStatus(indexStatus, worktreeStatus)) {
+			summary.conflicts += 1;
+			continue;
+		}
+		if (isChangedStatus(indexStatus)) summary.staged += 1;
+		if (isChangedStatus(worktreeStatus)) summary.modified += 1;
+	}
+
+	return summary;
+}
+
+function isConflictStatus(indexStatus: string, worktreeStatus: string): boolean {
+	return (
+		(indexStatus === "D" && worktreeStatus === "D") ||
+		(indexStatus === "A" && worktreeStatus === "A") ||
+		indexStatus === "U" ||
+		worktreeStatus === "U"
+	);
+}
+
+function isChangedStatus(status: string): boolean {
+	return status !== " " && status !== "?" && status !== "!";
+}
+
+export function formatGitStatusSummary(summary: GitStatusSummary | undefined): string {
+	if (!summary) return "";
+	const tokens = [
+		["⇡", summary.ahead],
+		["⇣", summary.behind],
+		["+", summary.staged],
+		["~", summary.modified],
+		["?", summary.untracked],
+		["!", summary.conflicts],
+	] as const;
+	return tokens
+		.filter(([, count]) => count > 0)
+		.map(([prefix, count]) => `${prefix}${formatCount(count)}`)
+		.join(" ");
+}
+
+export function formatGitBranchText(
+	branch: string | null,
+	status: GitStatusSummary | undefined,
+	pr?: string,
+): string {
+	if (!branch) return "🌿 no-git";
+	const suffixes = [formatGitStatusSummary(status), pr ? `(${pr})` : ""].filter(Boolean);
+	return suffixes.length > 0 ? `🌿 ${branch} ${suffixes.join(" ")}` : `🌿 ${branch}`;
+}
+
+function gitStatusSummaryEqual(
+	left: GitStatusSummary | undefined,
+	right: GitStatusSummary | undefined,
+): boolean {
+	if (!left || !right) return left === right;
+	return (
+		left.ahead === right.ahead &&
+		left.behind === right.behind &&
+		left.staged === right.staged &&
+		left.modified === right.modified &&
+		left.untracked === right.untracked &&
+		left.conflicts === right.conflicts
+	);
+}
+
 function formatExtensionStatuses(
 	statuses: ReadonlyMap<string, string>,
 	theme: Theme,
@@ -405,7 +644,9 @@ function formatExtensionStatuses(
 				([key, value]) =>
 					key !== STATUSLINE_KEY && key !== GITHUB_PR_KEY && value.trim().length > 0,
 			)
-			.map(([key, value]) => formatExtensionStatus(key, value, theme, config)),
+			.map(([key, value]) =>
+				formatExtensionStatus(key, value, theme, config, runtime.extensionStatusIconAliases),
+			),
 	].slice(0, 5);
 
 	return visibleStatuses.join(separator);
@@ -416,12 +657,13 @@ export function formatExtensionStatus(
 	value: string,
 	theme: Theme,
 	config: Pick<StatuslineConfig, "extensionStatusIcons">,
+	extensionStatusIconAliases: ExtensionStatusIconAliasMap = EMPTY_EXTENSION_STATUS_ICON_ALIASES,
 ): string {
 	const status = splitExtensionStatusIcon(stripExtensionStatusPrefix(key, value));
 	const text = simplifyExtensionStatusText(status.text);
 	const color = extensionColor(key, value);
 	const textColor = color === "warning" ? "warning" : "muted";
-	const icon = extensionStatusIcon(key, status.icon, config.extensionStatusIcons);
+	const icon = extensionStatusIcon(key, status.icon, config.extensionStatusIcons, extensionStatusIconAliases);
 	const renderedText = theme.fg(textColor, text);
 	return icon ? `${theme.fg(color, icon)} ${renderedText}` : renderedText;
 }
@@ -430,11 +672,29 @@ function extensionStatusIcon(
 	key: string,
 	leadingIcon: string | undefined,
 	configuredIcons: Record<string, string>,
+	extensionStatusIconAliases: ExtensionStatusIconAliasMap,
 ) {
 	if (Object.hasOwn(configuredIcons, key)) return configuredIcons[key];
+	for (const alias of extensionStatusAliasesForKey(key, extensionStatusIconAliases)) {
+		if (Object.hasOwn(configuredIcons, alias)) return configuredIcons[alias];
+	}
 	return leadingIcon ?? DEFAULT_EXTENSION_STATUS_ICONS[key] ?? "🔌";
 }
 
+function extensionStatusAliasesForKey(
+	key: string,
+	extensionStatusIconAliases: ExtensionStatusIconAliasMap,
+): readonly string[] {
+	for (const [statusBase, aliases] of extensionStatusIconAliases) {
+		if (statusKeyMatchesStatusBase(key, statusBase)) return aliases;
+	}
+	return [];
+}
+
+function statusKeyMatchesStatusBase(key: string, statusBase: string): boolean {
+	return key === statusBase || key.startsWith(`${statusBase}:`) || key.startsWith(`${statusBase}/`);
+}
+
 export function wrapExtensionStatusline(status: string, width: number): string[] {
 	if (!status || width <= 0) return [];
 	return wrapTextWithAnsi(status, width);
@@ -489,21 +749,44 @@ function escapeRegExp(value: string): string {
 	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
-function findDuplicateExtensions(cwd: string): string[] {
-	const settingsFiles = [
+interface InstalledExtensionPackage {
+	packageName: string;
+	source: string;
+	identity: string;
+}
+
+function readInstalledExtensionPackages(cwd: string): InstalledExtensionPackage[] {
+	const packages: InstalledExtensionPackage[] = [];
+	const settingsFiles = extensionSettingsFiles(cwd);
+
+	for (const settingsFile of settingsFiles) {
+		const baseDirectory = dirname(settingsFile);
+		for (const rawSource of readPackageSources(settingsFile)) {
+			const source = rawSource.trim();
+			if (!source) continue;
+			const packageName = packageNameForSource(source, baseDirectory);
+			if (!packageName) continue;
+			packages.push({ packageName, source, identity: sourceIdentity(source, baseDirectory) });
+		}
+	}
+
+	return packages;
+}
+
+function extensionSettingsFiles(cwd: string): string[] {
+	return [
 		join(process.env.HOME ?? "", ".pi", "agent", "settings.json"),
 		join(cwd, ".pi", "settings.json"),
 	].filter((file) => existsSync(file));
+}
+
+function findDuplicateExtensions(installedPackages: readonly InstalledExtensionPackage[]): string[] {
 	const sourcesByPackage = new Map<string, Set<string>>();
 
-	for (const settingsFile of settingsFiles) {
-		for (const source of readPackageSources(settingsFile)) {
-			const packageName = packageNameForSource(source, dirname(settingsFile));
-			if (!packageName) continue;
-			const sources = sourcesByPackage.get(packageName) ?? new Set<string>();
-			sources.add(sourceIdentity(source, dirname(settingsFile)));
-			sourcesByPackage.set(packageName, sources);
-		}
+	for (const extensionPackage of installedPackages) {
+		const sources = sourcesByPackage.get(extensionPackage.packageName) ?? new Set<string>();
+		sources.add(extensionPackage.identity);
+		sourcesByPackage.set(extensionPackage.packageName, sources);
 	}
 
 	return [...sourcesByPackage.entries()]
@@ -511,6 +794,57 @@ function findDuplicateExtensions(cwd: string): string[] {
 		.map(([packageName]) => packageName.replace(/^@[^/]+\//, "").replace(/^pi-/, ""));
 }
 
+export function buildExtensionStatusIconAliases(
+	installedPackages: readonly { packageName: string; source?: string }[],
+): Map<string, string[]> {
+	const packageAliasesByStatusBase = new Map<string, Map<string, string[]>>();
+
+	for (const extensionPackage of installedPackages) {
+		const candidate = extensionStatusIconAliasCandidate(extensionPackage.packageName, extensionPackage.source);
+		if (!candidate) continue;
+		const aliasesByPackage = packageAliasesByStatusBase.get(candidate.statusBase) ?? new Map<string, string[]>();
+		const existingAliases = aliasesByPackage.get(extensionPackage.packageName) ?? [];
+		aliasesByPackage.set(extensionPackage.packageName, uniqueStrings([...existingAliases, ...candidate.aliases]));
+		packageAliasesByStatusBase.set(candidate.statusBase, aliasesByPackage);
+	}
+
+	const aliases = new Map<string, string[]>();
+	for (const [statusBase, aliasesByPackage] of packageAliasesByStatusBase) {
+		if (aliasesByPackage.size === 1) aliases.set(statusBase, [...aliasesByPackage.values()][0] ?? []);
+	}
+	return aliases;
+}
+
+function extensionStatusIconAliasCandidate(
+	packageName: string,
+	source?: string,
+): { statusBase: string; aliases: string[] } | undefined {
+	const packageBase = packageBaseName(packageName);
+	const statusBase = statusBaseFromPackageBase(packageBase);
+	if (!statusBase) return undefined;
+
+	const sourceAliases = source?.startsWith("npm:") ? [source, `npm:${npmPackageName(source)}`] : [];
+	return {
+		statusBase,
+		aliases: uniqueStrings([...sourceAliases, packageName, packageBase, statusBase]),
+	};
+}
+
+function packageBaseName(packageName: string): string {
+	const slashIndex = packageName.lastIndexOf("/");
+	return slashIndex === -1 ? packageName : packageName.slice(slashIndex + 1);
+}
+
+function statusBaseFromPackageBase(packageBase: string): string {
+	return packageBase.startsWith("pi-") && packageBase.length > "pi-".length
+		? packageBase.slice("pi-".length)
+		: packageBase;
+}
+
+function uniqueStrings(values: readonly string[]): string[] {
+	return [...new Set(values.filter((value) => value.length > 0))];
+}
+
 function readPackageSources(settingsFile: string): string[] {
 	try {
 		const settings = JSON.parse(readFileSync(settingsFile, "utf8")) as { packages?: unknown[] };