gentle-pi 2.7.0 → 3.0.0

package/extensions/gentle-shell.ts

@@ -10,8 +10,11 @@ import { CHANGE_STATUS, renderChangesWidget, type ChangedFile, type ChangesModel
 import { WorktreeChangesView } from "../lib/shell-changes-view.ts";
 import { SessionWorktreeRegistry, resolveSessionWorktree, worktreeGitEnvironment, type WorktreeResolver } from "../lib/session-worktree-registry.ts";
 import { CARD_TONE, renderCard, type Card, type CardTheme } from "../lib/shell-card.ts";
+import { CommandPalette, commandsKey, type CommandPaletteResult } from "../lib/command-palette.ts";
+import { buildCommandPaletteGroups } from "../lib/command-palette-catalog.ts";
+import { agentsViewKey } from "../lib/agents-keys.ts";
 import { GentleAiDevBinaryOverrideError, resolveGentleAiDevBinaryOverride } from "../lib/gentle-ai-binary.ts";
-import { framePromptLines, PROMPT_HINT, PROMPT_STATE, withPromptHint, type PromptState } from "../lib/shell-prompt.ts";
+import { framePromptLines, PROMPT_HINT, PROMPT_STATE, SHELL_PULSE_MS, withPromptHint, type PromptState } from "../lib/shell-prompt.ts";
 import { accountIdFromToken, CODEX_PROVIDER, CODEX_USAGE_URL, parseCodexUsage, parseUsageHeaders, UsageStore, type ProviderUsage } from "../lib/shell-usage.ts";
 import { UsageView } from "../lib/shell-usage-view.ts";
 import { sidebarPart } from "../lib/shell-sidebar.ts";
@@ -182,8 +185,6 @@ interface PromptEditorDeps {
 
 const PROMPT_FRAME_ROLE = "border";
 
-const PETAL_PULSE_MS = 160;
-
 export class GentlePromptEditor extends CustomEditor {
 	private promptState: PromptState = PROMPT_STATE.IDLE;
 	private tick = 0;
@@ -202,7 +203,7 @@ export class GentlePromptEditor extends CustomEditor {
 			this.pulse = setInterval(() => {
 				this.tick += 1;
 				this.deps.requestRender();
-			}, PETAL_PULSE_MS);
+			}, SHELL_PULSE_MS);
 			this.pulse.unref();
 		}
 		this.deps.requestRender();
@@ -234,9 +235,14 @@ export class GentlePromptEditor extends CustomEditor {
 	}
 }
 
-function installPrompt(ctx: ExtensionContext, onCreated: (prompt: GentlePromptEditor) => void): void {
-	if (ctx.ui.getEditorComponent()) return;
-	ctx.ui.setEditorComponent((tui, theme, keybindings) => {
+// Stable across extension module reloads; never infer ownership from a name.
+const PROMPT_OWNER = Symbol.for("gentle-pi.prompt-owner");
+type PromptFactory = NonNullable<ReturnType<ExtensionContext["ui"]["getEditorComponent"]>> & { [PROMPT_OWNER]?: boolean };
+
+function installPrompt(ctx: ExtensionContext, onCreated: (prompt: GentlePromptEditor) => void): boolean {
+	const previous = ctx.ui.getEditorComponent() as PromptFactory | undefined;
+	if (previous && !previous[PROMPT_OWNER]) return false;
+	const factory: PromptFactory = (tui, theme, keybindings) => {
 		const prompt = new GentlePromptEditor(tui, theme, keybindings, {
 			fg: (color, text) => ctx.ui.theme.fg(color as Parameters<typeof ctx.ui.theme.fg>[0], text),
 			bold: (text) => ctx.ui.theme.bold(text),
@@ -245,7 +251,10 @@ function installPrompt(ctx: ExtensionContext, onCreated: (prompt: GentlePromptEd
 		});
 		onCreated(prompt);
 		return prompt;
-	});
+	};
+	factory[PROMPT_OWNER] = true;
+	ctx.ui.setEditorComponent(factory);
+	return true;
 }
 
 const CHANGES_WIDGET_KEY = "gentle-shell-changes";
@@ -253,6 +262,7 @@ const CHANGES_COMMAND_NAME = "gentle:changes";
 const CHANGES_SHORTCUT_DEFAULT = "alt+g";
 const CHANGES_POLL_DEFAULT_MS = 2000;
 const GIT_TIMEOUT_MS = 5000;
+const COMMANDS_COMMAND_NAME = "gentle:commands";
 const OVERLAY_HEIGHT_RATIO = 0.8;
 const OVERLAY_MIN_ROWS = 8;
 
@@ -318,7 +328,7 @@ function changesPollMs(env: NodeJS.ProcessEnv): number {
 }
 
 function changesFingerprint(model: ChangesModel): string {
-	return model.files.map((file) => `${file.path}:${file.status}:${file.added}:${file.deleted}:${file.diffRevision ?? ""}:${file.countsUnavailable ?? ""}`).join("|");
+	return [model.notice ?? "", ...model.files.map((file) => `${file.path}:${file.status}:${file.added}:${file.deleted}:${file.diffRevision ?? ""}:${file.countsUnavailable ?? ""}`)].join("|");
 }
 
 interface OverlayDeps {
@@ -366,6 +376,29 @@ async function showChangesOverlay(ctx: ExtensionContext, deps: OverlayDeps): Pro
 	}
 }
 
+// The command palette is a curated, grouped menu (Configuration, Session,
+// Diagnostics, SDD, Skills), not a raw listing of every registered
+// extension command: buildCommandPaletteGroups keeps only the catalog
+// entries that are actually registered, so a missing extension never shows
+// a dead row. Selecting an entry runs it exactly as if the user had typed
+// the underlying slash command.
+async function showCommandPalette(pi: ExtensionAPI, ctx: ExtensionContext, env: NodeJS.ProcessEnv): Promise<void> {
+	if (!ctx.hasUI) return;
+	const groups = buildCommandPaletteGroups(pi.getCommands(), {
+		"gentle:changes": changesShortcut(env),
+		"gentle:agents": agentsViewKey(env),
+	});
+	if (groups.length === 0) {
+		ctx.ui.notify("No Gentle commands are registered.", "info");
+		return;
+	}
+	const result = await ctx.ui.custom<CommandPaletteResult>(
+		(tui, theme, _keybindings, done) => new CommandPalette(groups, done, theme, () => Math.max(0, tui.terminal.rows)),
+		{ overlay: true, overlayOptions: { anchor: "center", width: "70%", minWidth: 60, maxHeight: "85%" } },
+	);
+	if (result?.type === "run") pi.sendUserMessage(`/${result.name}`, { expandPromptTemplates: true });
+}
+
 function showChanges(ctx: ExtensionContext, model: ChangesModel): void {
 	if (model.files.length === 0) {
 		ctx.ui.setWidget(CHANGES_WIDGET_KEY, undefined);
@@ -378,20 +411,6 @@ function showChanges(ctx: ExtensionContext, model: ChangesModel): void {
 				return renderChangesWidget(model, theme, width);
 			},
 			invalidate() {},
-		}, {
-			render(width: number) {
-				const noun = model.files.length === 1 ? "file" : "files";
-				return renderCard({
-					title: "Changes",
-					tone: CARD_TONE.INFO,
-					body: [
-						`${model.files.length} ${noun} · ${theme.fg("success", `+${model.added}`)} ${theme.fg("error", `−${model.deleted}`)}`,
-						"",
-						theme.fg("muted", `/${CHANGES_COMMAND_NAME}`),
-					],
-				}, theme, width, { expanded: true });
-			},
-			invalidate() {},
 		}),
 		{ placement: "belowEditor" },
 	);
@@ -533,7 +552,8 @@ export default function gentleShell(pi: ExtensionAPI, env: NodeJS.ProcessEnv = p
 	};
 	const unsubscribeWorktrees = pi.events.on(SESSION_CHANGE_EVENT, (data) => {
 		if (!currentContext || !registry || (data as { sessionId?: string } | undefined)?.sessionId !== registry.sessionId) return;
-		if ((data as { notice?: string }).notice) currentContext.ui.notify((data as { notice: string }).notice, "warning");
+		const notice = (data as { notice?: string } | undefined)?.notice;
+		if (notice) { if (changes) changes.notice = notice; currentContext.ui.notify(notice, "warning"); }
 		void refreshChanges(currentContext);
 	});
 	pi.registerTool({
@@ -565,7 +585,10 @@ export default function gentleShell(pi: ExtensionAPI, env: NodeJS.ProcessEnv = p
 			// part for: model, effort, context, cost, session name and extension
 			// statuses. The digest is what keeps the fullscreen memo honest, and it
 			// rebuilds the model exactly as the narrow bottom bar does every frame.
-			const footerModel = () => buildShellBarModel(pi, ctx, footerData, { dirty: tracker.model.files.length, usage: usage.get(ctx.model?.provider ?? ""), profile: deps.activeProfile() });
+			const footerModel = (): ShellBarModel => ({
+				...buildShellBarModel(pi, ctx, footerData, { dirty: tracker.model.files.length, usage: usage.get(ctx.model?.provider ?? ""), profile: deps.activeProfile() }),
+				changes: { files: tracker.model.files.length, added: tracker.model.added, deleted: tracker.model.deleted, notice: tracker.model.notice },
+			});
 			const part = sidebarPart(tui, "footer", bottom, {
 				digest: () => JSON.stringify(footerModel()),
 				render: (width) => renderShellSidebarBar(footerModel(), theme, width),
@@ -575,11 +598,13 @@ export default function gentleShell(pi: ExtensionAPI, env: NodeJS.ProcessEnv = p
 			return { ...part, dispose() { uninstall(); part.dispose(); } };
 		});
 		void refreshUsage(ctx, true);
-		installPrompt(ctx, (created) => {
+		const ownsPrompt = installPrompt(ctx, (created) => {
+			prompt?.dispose();
 			prompt = created;
 		});
-		// The petal already says the agent is working; pi's own "Working" row would say it twice.
-		ctx.ui.setWorkingVisible(false);
+		// Hide native feedback only when our petal replaces it. Native transcript
+		// thinking blocks remain Pi-owned; this changes only the supported loader UI.
+		if (ownsPrompt) ctx.ui.setWorkingVisible(false);
 		const notice = deps.devBinary();
 		ctx.ui.setWidget(
 			DEV_BINARY_WIDGET_KEY,
@@ -591,7 +616,13 @@ export default function gentleShell(pi: ExtensionAPI, env: NodeJS.ProcessEnv = p
 		shown = "";
 		applyChanges(ctx, tracker.model);
 	});
-	pi.on("session_shutdown", () => {
+	pi.on("session_shutdown", (_event, ctx) => {
+		prompt?.dispose();
+		prompt = undefined;
+		if ((ctx.ui.getEditorComponent() as PromptFactory | undefined)?.[PROMPT_OWNER]) {
+			ctx.ui.setEditorComponent(undefined);
+			ctx.ui.setWorkingVisible(true);
+		}
 		registry?.close();
 		registry = undefined;
 		changes = undefined;
@@ -619,13 +650,26 @@ export default function gentleShell(pi: ExtensionAPI, env: NodeJS.ProcessEnv = p
 			handler: async (ctx) => openChanges(ctx),
 		});
 	}
+	pi.registerCommand(COMMANDS_COMMAND_NAME, {
+		description: "Open the command palette: a curated, grouped menu of Gentle commands.",
+		handler: async (_args, ctx) => showCommandPalette(pi, ctx, env),
+	});
+	const commandsShortcut = commandsKey(env);
+	if (commandsShortcut) {
+		pi.registerShortcut(commandsShortcut as Parameters<ExtensionAPI["registerShortcut"]>[0], {
+			description: "Open the command palette",
+			handler: async (ctx) => showCommandPalette(pi, ctx, env),
+		});
+	}
 	pi.on("agent_start", (_event, ctx) => {
 		prompt?.setWorking(true);
 		// The dev-binary card is a startup notice: it leaves with the first prompt.
 		if (ctx.hasUI) ctx.ui.setWidget(DEV_BINARY_WIDGET_KEY, undefined);
 	});
-	pi.on("agent_end", async (_event, ctx) => {
+	pi.on("agent_settled", () => {
 		prompt?.setWorking(false);
+	});
+	pi.on("agent_end", async (_event, ctx) => {
 		await refreshChanges(ctx);
 		void refreshUsage(ctx, false);
 	});

package/extensions/pi-pretty.ts

@@ -1,29 +1,78 @@
-import { realpathSync } from "node:fs";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { shellEnabled } from "../lib/shell-bar.ts";
 import {
 	mergeDisabledTools,
 	PI_PRETTY_SUPPRESSED_TOOL_NAMES,
 	quietToolsEnabled,
 } from "../lib/quiet-tools-config.ts";
 
-const packageJsonPath = realpathSync(
-	fileURLToPath(new URL("../package.json", import.meta.url)),
-);
-const requireFromRealPackage = createRequire(packageJsonPath);
-const piPrettyModule = requireFromRealPackage("@heyhuynhgiabuu/pi-pretty");
+type PiPrettyExtension = (pi: unknown, deps?: unknown) => unknown;
 
-const piPrettyExtension =
-	typeof piPrettyModule === "function"
-		? piPrettyModule
-		: piPrettyModule.default;
+let piPrettyExtensionPromise: Promise<PiPrettyExtension> | undefined;
 
-export default async function gentlePiPrettyExtension(pi: unknown, deps?: unknown): Promise<unknown> {
+async function loadPiPrettyExtension(): Promise<PiPrettyExtension> {
+	return piPrettyExtensionPromise ??= import("@heyhuynhgiabuu/pi-pretty").then(
+		(piPrettyModule) => {
+			const moduleCandidate: unknown = piPrettyModule;
+			const extension =
+				typeof moduleCandidate === "function"
+					? moduleCandidate
+					: piPrettyModule.default;
+			if (typeof extension !== "function") {
+				throw new TypeError("pi-pretty must export an extension function");
+			}
+			return extension as PiPrettyExtension;
+		},
+	);
+}
+
+export default async function gentlePiPrettyExtension(
+	pi: unknown,
+	deps?: unknown,
+	bundled?: PiPrettyExtension,
+	env: NodeJS.ProcessEnv = process.env,
+): Promise<unknown> {
 	if (quietToolsEnabled()) {
 		process.env.PRETTY_DISABLE_TOOLS = mergeDisabledTools(
 			process.env.PRETTY_DISABLE_TOOLS,
 			PI_PRETTY_SUPPRESSED_TOOL_NAMES,
 		);
 	}
-	return piPrettyExtension(pi, deps);
+	const extension = bundled ?? await loadPiPrettyExtension();
+	if (!shellEnabled(env)) return extension(pi, deps);
+	const api = pi as ExtensionAPI;
+	// Scope interception to this bundled dependency, never to the shared host UI.
+	// Its tools/autocomplete/status APIs pass through; prompt ownership stays with
+	// Gentle Shell (or a genuine third-party editor). This also blocks stale restores.
+	const owned = new Set(["setEditorComponent", "setWorkingIndicator", "setWorkingMessage", "setWorkingVisible"]);
+	const delegated = new Proxy(api, {
+		get(target, key) {
+			if (key !== "on") return Reflect.get(target, key);
+			return (event: Parameters<ExtensionAPI["on"]>[0], handler: (event: unknown, ctx: ExtensionContext) => unknown) => {
+				api.on(event, ((event: unknown, ctx: ExtensionContext) => {
+					if (ctx.mode !== "tui") return handler(event, ctx);
+					const ui = new Proxy(ctx.ui, {
+						get(target, key) {
+							return owned.has(String(key)) ? () => {} : Reflect.get(target, key);
+						},
+					});
+					return handler(event, new Proxy(ctx, { get: (target, key) => key === "ui" ? ui : Reflect.get(target, key) }));
+				}) as never);
+			};
+		},
+	});
+	const result = await extension(delegated, deps);
+	// GentlePromptEditor already carries the live working state in its frame.
+	// Hide Pi's separate loader row to avoid repeating Thinking above the input;
+	// transcript thinking blocks remain untouched as historical reasoning markers.
+	api.on("session_start", (_event, ctx) => {
+		if (ctx.mode === "tui") ctx.ui.setWorkingVisible(false);
+	});
+	api.on("session_shutdown", (_event, ctx) => {
+		if (ctx.mode !== "tui") return;
+		ctx.ui.setWorkingVisible(true);
+		ctx.ui.setWorkingIndicator();
+		ctx.ui.setWorkingMessage();
+	});
+	return result;
 }

package/extensions/quiet-tools.ts

@@ -238,7 +238,7 @@ function shellTokens(command: string): ShellTokenization {
 function isAssignment(token: string): boolean {
 	return /^[A-Za-z_][A-Za-z0-9_]*=/.test(token);
 }
-const SDD_ATTEMPT_VERBS = new Set(["acquire", "settle", "grant"]);
+const SDD_ATTEMPT_VERBS = new Set(["grant"]);
 
 const REVIEW_DIRECT_OPERATIONS = new Set([
 	"capabilities",
@@ -354,7 +354,6 @@ function gentleAiOperationPathFrom(tokens: string[]): string {
 	if (tokens[0] === "sdd-attempt") {
 		const verb = tokens[1] ?? "";
 		if (!SDD_ATTEMPT_VERBS.has(verb)) return "sdd attempt";
-		if (verb !== "grant") return `sdd attempt ${verb}`;
 		const rootCount = authorizationRootCount(tokens);
 		return rootCount > 0
 			? `sdd attempt grant · ${rootCount} root${rootCount === 1 ? "" : "s"}`

package/extensions/startup-banner.ts

@@ -29,14 +29,14 @@ const BANNER_PALETTES: Record<BannerColor, { rose: [number, number, number]; lab
 };
 
 const TEXT_LOGO = [
-  "                  ▄▄▄▀▀▀▀▀██                                ▄▄▀▄▄           ▄▄█▀▀▀██   ▀▀█▄    ▄▄▄",
-  "              ▄▄█▀▀▒▒▒▒▒▄▄█▀▒                   ▄██     ▄▄█▀█▄█▀▒▒      ▄█▀▀ ▒▒▒▄█▀▀▒   ▄██▒ ▄█▀▒▒▒",
-  "          ▄▄██▀▒▒▒▒▒▄▄▄▀▀▒▒▒▒        ▄▄▄  ▀▀▀▀██▀▀▀▀▀███▀█▄▀▀▒▒▒▒      ██▒▒▒▒▄▄█▀▒▒▒▒▄▄█▀▀▄██▀▒▒▒",
-  "        ▄██▀▒▒▒▒     ▒▒▄▄█ ▄▄▄▀██ ▄▄▄▀▀▀▄  ▄██▀▒▒▒▒▄██▀▀▀▒▄▄███         ▒▒ ▄███▄▄▄█▀▀▀▒▒▄██▀▒▒▒",
-  "       ██▀▒▒▒     ▄▄▄███▀▄██▀▀▀▄▄██▀▀▄█▀▄▄██▀▒▒▒▄▄██▀▒▒▄██▀▀▀▄▄▀▀▀▀▀▀▀▀▀ ▄█▀▀▒▒▒▒▒▒▒▒▒▄██▒▒▒▒",
-  "       ▀█▄▄▄▄▄▀▀▀█▄▄███▄▒▀▀▀▀▀▀▒▀▀▒▒▀▀▀▀▒██▄▄▀▀▀ ▀█▄▀▀▀ ▀▀▀▀▀▒▒▒▒▒▒▒▒▒▒▄██▀▒▒▒       ███▒▒",
-  "        ▒▄▄▄█▀▀▀█▄█▀▀▒▒▒▒ ▒▒▒▒▒▒ ▒▒  ▒▒▒▒ ▒▒▒▒▒▒▒ ▒▒▒▒▒▒ ▒▒▒▒▒        ▀▀▀▒▒▒          ▒▒▒",
-  "     ▄▄▀▀ ▒▒▒▒▄██▀▒▒▒▒                                                 ▒▒▒",
+  "                  ▄▄▄▀▀▀▀▀██                                ▄▄▀▄▄          ▄▄█▀▀▀██   ▄▄▀██               ▄▄▀▄▄   ▄▄▀▄▄",
+  "              ▄▄█▀▀▒▒▒▒▒▄▄█▀▒                   ▄██     ▄▄█▀█▄█▀▒▒       ▄█▀▀▒▒▒▄█▀▒ ▄██▄█▀▒           ▄▄█▀█▄█▀▄▄█▀█▄█▀▒",
+  "          ▄▄██▀▒▒▒▒▒▄▄▄▀▀▒▒▒▒        ▄▄▄  ▀▀▀▀██▀▀▀▀▀███▀█▄▀▀▒▒▒▒      ██▄▄▒▒▒▒▒▒▒ ▄██▀▀▒▒▒          ▄██▀█▄▀▀▄██▀█▄▀▀▒▒▒",
+  "        ▄██▀▒▒▒▒     ▒▒▄▄█ ▄▄▄▀██ ▄▄▄▀▀▀▄  ▄██▀▒▒▒▒▄██▀▀▀▒▄▄███         ▀▀▀██▄▄  ▄██▀▒▄▄▀██   ▄▄▀▀██ ██▀▀▀▒▒▒██▀▀▀▒▒▒",
+  "       ██▀▒▒▒     ▄▄▄███▀▄██▀▀▀▄▄██▀▀▄█▀▄▄██▀▒▒▒▄▄██▀▒▒▄██▀▀▀▄▄      ▄▄     ▀██▄▄██▀▄██▀██▒  ▄██▄▄▀▒ █▀▒▒▒   █▀▒▒▒",
+  "       ▀█▄▄▄▄▄▀▀▀█▄▄███▄▒▀▀▀▀▀▀▒▀▀▒▒▀▀▀▀▒██▄▄▀▀▀ ▀█▄▀▀▀ ▀▀▀▀▀▒▒      ▀█▄▄▄▄█▀▀▒▒▀▀▒▒▀▀▒ ██▄▄▀▀█▄▄▄▄▀▀█▄▄▀▀▀▄▄▀█▄▄▀▀▀",
+  "        ▒▄▄▄█▀▀▀█▄█▀▀▒▒▒▒ ▒▒▒▒▒▒ ▒▒  ▒▒▒▒ ▒▒▒▒▒▒▒ ▒▒▒▒▒▒ ▒▒▒▒▒        ▒▀▀▀▀▒▒▒▒  ▒▒▒▒▒▒ ▒▒▒▒▒ ▒▒▒▒▒▒  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒",
+  "     ▄▄▀▀ ▒▒▒▒▄██▀▒▒▒▒",
   "   ▄█ ▒▒▒▄▄██▀▀▒▒▒▒",
   "    ▀▀▀▀▀▀▒▒▒▒▒▒",
   "     ▒▒▒▒▒▒",
@@ -183,7 +183,8 @@ function buildLetterSpans(bounds: Span, weights: number[]): Span[] {
 }
 
 const LOGO_BOUNDS = computeLogoBounds(TEXT_LOGO);
-const LETTER_WEIGHTS = [14, 10, 11, 10, 9, 11, 6, 13, 12]; // G E N T L E - P I
+// Variable-width script regions, including the gap before Shell and shadows.
+const LETTER_WEIGHTS = [22, 9, 8, 9, 8, 9, 10, 13, 8, 8, 13]; // G E N T L E S H E L L
 const LETTER_SPANS = buildLetterSpans(LOGO_BOUNDS, LETTER_WEIGHTS);
 
 function letterIndexAtX(x: number): number {

package/lib/agent-home.ts

@@ -6,3 +6,11 @@ import { join } from "node:path";
 export function resolveGentlePiAgentHome(env: NodeJS.ProcessEnv = process.env): string {
 	return env.GENTLE_PI_AGENT_HOME || env.PI_CODING_AGENT_DIR || join(homedir(), ".pi", "agent");
 }
+
+// The Gentle AI config directory outside `~/.pi/agent`: everything the extension
+// commands own lives here. It is defined once because the launch-time profile pin
+// resolver reads the same profiles store the `/gentle:profiles` panel writes, and
+// two spellings of the override would silently read two different stores.
+export function gentlePiConfigHome(env: NodeJS.ProcessEnv = process.env): string {
+	return env.GENTLE_PI_CONFIG_HOME || join(homedir(), ".pi", "gentle-ai");
+}