@vanillagreen/pi-qol 1.0.0 → 1.0.2

package/README.md

@@ -7,6 +7,23 @@
 
 Quality-of-life extension for Pi.
 
+## Install
+
+Via [npm](https://www.npmjs.com/package/@vanillagreen/pi-qol):
+
+```bash
+pi install npm:@vanillagreen/pi-qol
+```
+
+Via [vstack](https://github.com/vanillagreencom/vstack):
+
+```bash
+cargo install --git https://github.com/vanillagreencom/vstack.git vstack
+vstack add vanillagreencom/vstack --pi-extension pi-qol --harness pi -y
+```
+
+Restart Pi after installation.
+
 ## What it provides
 
 - Compact statusline and `π` prompt editor: shows repo/project, branch/dirty state, model, thinking level, context window size, and remaining context percent while replacing Pi's default footer/editor chrome.

package/extensions/qol.ts

@@ -9,6 +9,7 @@ import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 
 const INSTALL_SYMBOL = Symbol.for("vstack.pi-qol.installed");
+const CONFIG_ID = "@vanillagreen/pi-qol";
 const STATUS_KEY = "qol-attachments";
 const SESSION_SEARCH_STATUS_KEY = "qol-session-search";
 const SESSION_SEARCH_CONTEXT_TYPE = "qol-session-context";
@@ -44,6 +45,7 @@ const DEFAULT_SESSION_SEARCH_SHORTCUT = "f3";
 const DEFAULT_SESSION_SEARCH_SUMMARY_INPUT_CHARS = 180_000;
 const DEFAULT_SESSION_SEARCH_SUMMARY_MAX_TOKENS = 4096;
 const DEFAULT_SESSION_SEARCH_CACHE_TTL_SECONDS = 0;
+const SESSION_SEARCH_OVERLAY_HEIGHT_RATIO = 0.9;
 const DEFAULT_AUTO_RENAME_MODEL = "openai-codex/gpt-5.4-mini";
 const DEFAULT_AUTO_RENAME_FALLBACK_MODEL = "current";
 const DEFAULT_AUTO_RENAME_INPUT_CHARS = 2000;
@@ -131,7 +133,7 @@ function readVstackConfig(cwd?: string): VstackConfig {
 		if (!existsSync(path)) continue;
 		try {
 			const parsed = JSON.parse(readFileSync(path, "utf8"));
-			const config = parsed?.vstack?.extensionManager?.config?.["pi-qol"];
+			const config = parsed?.vstack?.extensionManager?.config?.[CONFIG_ID];
 			if (config && typeof config === "object" && !Array.isArray(config)) Object.assign(merged, config);
 		} catch {
 			// Ignore malformed optional manager config.
@@ -3071,7 +3073,7 @@ class QolSessionSearchComponent {
 
 	constructor(
 		private readonly done: (action: QolSessionPaletteAction) => void,
-		private readonly tui: { requestRender(): void },
+		private readonly tui: { requestRender(): void; terminal?: { rows?: number } },
 		private readonly theme: Theme,
 		private readonly sessions: QolSessionSearchSession[],
 		private readonly cwd: string,
@@ -3089,6 +3091,30 @@ class QolSessionSearchComponent {
 
 	invalidate(): void {}
 
+	private maxOverlayRows(): number {
+		const terminalRows = Number(this.tui.terminal?.rows ?? process.stdout.rows ?? 30);
+		const safeRows = Number.isFinite(terminalRows) && terminalRows > 0 ? terminalRows : 30;
+		return Math.max(8, Math.floor(safeRows * SESSION_SEARCH_OVERLAY_HEIGHT_RATIO));
+	}
+
+	private searchMaxVisibleRows(): number {
+		const configured = Math.max(1, Math.floor(settingNumber("sessionSearch.maxVisible", 8, this.cwd)));
+		// Search results render as 3 content rows plus a divider between rows.
+		// The remaining chrome is title, search box, help text, scroll status,
+		// footer, and frame. Keep the rendered line count within overlay maxHeight
+		// so Pi does not clip the bottom of the popup on short terminals.
+		const responsive = Math.max(1, Math.floor((this.maxOverlayRows() - 12) / 4));
+		return Math.max(1, Math.min(configured, responsive));
+	}
+
+	private messageMaxVisibleRows(): number {
+		const configured = Math.max(1, Math.floor(settingNumber("sessionSearch.messageMaxVisible", 12, this.cwd)));
+		// Message rows are one line each; reserve space for session metadata,
+		// optional scroll status, footer, and frame.
+		const responsive = Math.max(1, this.maxOverlayRows() - 14);
+		return Math.max(1, Math.min(configured, responsive));
+	}
+
 	render(width: number): string[] {
 		const configured = Math.max(70, Math.floor(settingNumber("sessionSearch.overlayWidth", 104, this.cwd)));
 		const renderWidth = Math.min(Math.max(48, width), configured);
@@ -3165,11 +3191,11 @@ class QolSessionSearchComponent {
 			return;
 		}
 		if (matchesKey(data, "-") || matchesKey(data, "pageup")) {
-			state.selected = Math.max(0, state.selected - 10);
+			state.selected = Math.max(0, state.selected - this.searchMaxVisibleRows());
 			return;
 		}
 		if (matchesKey(data, "=") || matchesKey(data, "pagedown")) {
-			state.selected = Math.min(state.results.length - 1, state.selected + 10);
+			state.selected = Math.min(state.results.length - 1, state.selected + this.searchMaxVisibleRows());
 			return;
 		}
 		if (matchesKey(data, "left")) {
@@ -3239,11 +3265,11 @@ class QolSessionSearchComponent {
 			return;
 		}
 		if (matchesKey(data, "-") || matchesKey(data, "pageup")) {
-			state.selected = Math.max(0, state.selected - 10);
+			state.selected = Math.max(0, state.selected - this.messageMaxVisibleRows());
 			return;
 		}
 		if (matchesKey(data, "=") || matchesKey(data, "pagedown")) {
-			state.selected = Math.min(state.messages.length - 1, state.selected + 10);
+			state.selected = Math.min(state.messages.length - 1, state.selected + this.messageMaxVisibleRows());
 			return;
 		}
 		if (matchesKey(data, "home") || matchesKey(data, "ctrl+a")) {
@@ -3365,7 +3391,7 @@ class QolSessionSearchComponent {
 		if (state.results.length === 0) {
 			lines.push(row(muted(state.query.trim() ? "No sessions match your search" : "No sessions found")), empty());
 		} else {
-			const maxVisible = Math.max(3, Math.floor(settingNumber("sessionSearch.maxVisible", 8, this.cwd)));
+			const maxVisible = this.searchMaxVisibleRows();
 			const start = Math.max(0, Math.min(state.selected - Math.floor(maxVisible / 2), state.results.length - maxVisible));
 			const end = Math.min(start + maxVisible, state.results.length);
 			const rowBudget = Math.max(10, inner);
@@ -3394,7 +3420,7 @@ class QolSessionSearchComponent {
 			if (state.results.length > maxVisible) lines.push(empty(), row(dim(`${state.selected + 1}/${state.results.length} ${state.query.trim() ? "matches" : "recent sessions"}`)));
 		}
 		lines.push(divider(), empty());
-		lines.push(row(`${ansiYellow("↑↓")} ${dim("sessions")}  ${ansiYellow("-/=")} ${dim("page")}  ${ansiYellow("enter")} ${dim("prompts")}  ${ansiYellow("ctrl+u")} ${dim("clear")}  ${ansiYellow("esc")} ${dim("close")}`));
+		lines.push(row(`${ansiYellow("-/=")} ${dim("page")}  ${ansiYellow("enter")} ${dim("prompts")}  ${ansiYellow("ctrl+u")} ${dim("clear")}  ${ansiYellow("esc")} ${dim("close")}`));
 		lines.push(bottom());
 		return lines;
 	}
@@ -3419,7 +3445,7 @@ class QolSessionSearchComponent {
 		lines.push(row(dim(`${state.messages.length} user prompt${state.messages.length === 1 ? "" : "s"} · enter opens prompt actions · r resumes latest session state`)));
 		lines.push(empty(), divider(), empty());
 
-		const maxVisible = Math.max(6, Math.floor(settingNumber("sessionSearch.messageMaxVisible", 12, this.cwd)));
+		const maxVisible = this.messageMaxVisibleRows();
 		const start = Math.max(0, Math.min(state.selected - Math.floor(maxVisible / 2), state.messages.length - maxVisible));
 		const end = Math.min(start + maxVisible, state.messages.length);
 		for (let i = start; i < end; i++) {
@@ -3434,7 +3460,7 @@ class QolSessionSearchComponent {
 		}
 		if (state.messages.length > maxVisible) lines.push(empty(), row(dim(`${state.selected + 1}/${state.messages.length} user prompts`)));
 		lines.push(divider(), empty());
-		lines.push(row(`${ansiYellow("↑↓")} ${dim("prompts")}  ${ansiYellow("-/=")} ${dim("page")}  ${ansiYellow("enter")} ${dim("prompt actions")}  ${ansiYellow("r")} ${dim("resume session")}  ${ansiYellow("esc")} ${dim("sessions")}`));
+		lines.push(row(`${ansiYellow("-/=")} ${dim("page")}  ${ansiYellow("enter")} ${dim("prompt actions")}  ${ansiYellow("r")} ${dim("resume session")}  ${ansiYellow("esc")} ${dim("sessions")}`));
 		lines.push(bottom());
 		return lines;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillagreen/pi-qol",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Pi quality-of-life extension: compact statusline/π prompt, reliable multiline input, styled pasted-image chips, session naming/search/context import, handoff, permission prompts, notifications, custom compaction, and a collapsed-thinking timer.",
   "license": "MIT",
   "keywords": [