@linxiraos/pi-tui 1.1.27 → 1.2.0

package/src/apps/debug/raw-sse.ts

@@ -9,7 +9,7 @@ import { actionBar, actionButton } from "../../native/overlay";
 import { routeSgrMouseInput, type SgrMouseEvent } from "../../mouse";
 import { truncateToWidth } from "../../utils";
 import { sanitizeDisplayText } from "../../overlays/extensions/display-text";
-import { theme } from "../../theme/theme";
+import { getThemeEpoch, theme } from "../../theme/theme";
 import { DebugViewerFrame } from "./viewer-frame";
 import {
 	formatRawSseIsoTime,
@@ -106,6 +106,14 @@ export class RawSseViewerComponent implements Component {
 	// Sequences are monotonic; we prune entries below the oldest live record
 	// after each render so the cache tracks the buffer's eviction window.
 	readonly #prettyLinesCache = new Map<number, string[]>();
+	/** Buffer snapshot for {@link #snapshotRevision}; the buffer's revision bumps on every change. */
+	#snapshot: RawSseDebugSnapshot | undefined;
+	#snapshotRevision = -1;
+	/** Rendered body for (buffer revision, width, theme epoch). */
+	#bodyLines: string[] = [];
+	#bodyRevision = -1;
+	#bodyWidth = -1;
+	#bodyThemeEpoch = -1;
 
 	constructor(options: RawSseViewerOptions) {
 		this.#deps = options.deps;
@@ -227,6 +235,7 @@ export class RawSseViewerComponent implements Component {
 		this.#native.clear();
 		this.#nativeHead.clear();
 		this.#nativeBody.clear();
+		this.#bodyRevision = -1;
 	}
 
 	render(width: number): readonly string[] {
@@ -249,7 +258,7 @@ export class RawSseViewerComponent implements Component {
 	 * so they never scroll away.
 	 */
 	describeScreen(): NativeScreen {
-		const snapshot = this.#buffer.snapshot();
+		const snapshot = this.#currentSnapshot();
 		const stream = this.#feedNative(snapshot);
 		const head = this.#nativeHead.get(
 			[snapshot.totalEvents, snapshot.records.length, snapshot.droppedRecords, snapshot.lastUpdatedAt],
@@ -372,15 +381,40 @@ export class RawSseViewerComponent implements Component {
 		this.#onExit();
 	}
 
+	/** The buffer's snapshot, re-taken only when its revision moved. */
+	#currentSnapshot(): RawSseDebugSnapshot {
+		const revision = this.#buffer.revision;
+		if (!this.#snapshot || this.#snapshotRevision !== revision) {
+			this.#snapshot = this.#buffer.snapshot();
+			this.#snapshotRevision = revision;
+		}
+		return this.#snapshot;
+	}
+
 	#renderRawLines(innerWidth: number): string[] {
-		const snapshot = this.#buffer.snapshot();
+		const snapshot = this.#currentSnapshot();
+		const themeEpoch = getThemeEpoch();
+		if (
+			this.#bodyRevision === this.#snapshotRevision &&
+			this.#bodyWidth === innerWidth &&
+			this.#bodyThemeEpoch === themeEpoch
+		) {
+			return this.#bodyLines;
+		}
+		this.#bodyRevision = this.#snapshotRevision;
+		this.#bodyWidth = innerWidth;
+		this.#bodyThemeEpoch = themeEpoch;
+		this.#bodyLines = this.#formatRawLines(snapshot, innerWidth);
+		return this.#bodyLines;
+	}
+
+	#formatRawLines(snapshot: RawSseDebugSnapshot, innerWidth: number): string[] {
 		if (snapshot.records.length === 0) {
 			return [
 				theme.fg("muted", "No raw SSE frames captured yet."),
 				theme.fg("muted", "HTTP SSE providers populate this view while a model response is streaming."),
 			];
 		}
-
 		const lines: string[] = [];
 		if (snapshot.droppedRecords > 0) {
 			lines.push(
@@ -421,7 +455,7 @@ export class RawSseViewerComponent implements Component {
 		}
 	}
 	#summaryText(): string {
-		const snapshot = this.#buffer.snapshot();
+		const snapshot = this.#currentSnapshot();
 		const last = snapshot.lastUpdatedAt
 			? `${theme.fg("muted", "last")} ${theme.fg("accent", formatRawSseIsoTime(snapshot.lastUpdatedAt))}`
 			: theme.fg("muted", "waiting for first frame");

package/src/apps/git/diff-pane.ts

@@ -19,7 +19,7 @@ import { centerLine, sliceWithWidth, truncateToWidth, visibleWidth } from "../..
 import { formatBytes } from "@linxiraos/pi-utils";
 import { sanitizeDisplayText } from "../../overlays/extensions/display-text";
 import { getLanguageFromPath } from "../../lang-from-path";
-import { createHighlightStream, theme } from "../../theme/theme";
+import { createHighlightStream, getThemeEpoch, theme } from "../../theme/theme";
 import { bgAnsiHex, canvasHex, fgAnsiHex, mixHex, pill, selectionBgAnsi, textHex, withBg } from "./colors";
 import { DIFF_CONTEXT_LINES, type FileAssetSide, type FileStreamUpdate } from "./state";
 import { tuiText } from "../../i18n";
@@ -502,9 +502,12 @@ interface DiffPalette {
 	gutterDel: string;
 }
 
-let paletteCache: { key: string; palette: DiffPalette } | undefined;
+let paletteCache: { epoch: number; theme: object; palette: DiffPalette } | undefined;
 
+/** Diff colors for the active theme, rebuilt only when the theme instance or epoch changes. */
 function palette(): DiffPalette {
+	const epoch = getThemeEpoch();
+	if (paletteCache?.epoch === epoch && paletteCache.theme === theme) return paletteCache.palette;
 	const added = theme.getColorHex("toolDiffAdded");
 	const removed = theme.getColorHex("toolDiffRemoved");
 	const accent = theme.getColorHex("accent");
@@ -512,8 +515,6 @@ function palette(): DiffPalette {
 	const dark = luminance === undefined || luminance <= 0.5;
 	const canvas = canvasHex();
 	const text = textHex();
-	const key = `${added}\u0000${removed}\u0000${accent}\u0000${dark}\u0000${canvas}\u0000${text}`;
-	if (paletteCache?.key === key) return paletteCache.palette;
 	const built: DiffPalette = {
 		addSoft: bgAnsiHex(mixHex(canvas, added, dark ? 0.18 : 0.24)),
 		addStrong: bgAnsiHex(mixHex(canvas, added, dark ? 0.42 : 0.48)),
@@ -529,7 +530,7 @@ function palette(): DiffPalette {
 		gutterAdd: added,
 		gutterDel: removed,
 	};
-	paletteCache = { key, palette: built };
+	paletteCache = { epoch, theme, palette: built };
 	return built;
 }
 
@@ -599,6 +600,10 @@ export class DiffPane {
 	#lastHeight = 1;
 	#lastWidth = 0;
 	#layoutCache: { key: string; visuals: Visual[] } | undefined;
+	/** Minimap column for (layout, height, scroll offset, palette). */
+	#minimapCache:
+		| { visuals: Visual[]; height: number; scrollTop: number; colors: DiffPalette; lines: string[] }
+		| undefined;
 	/** Per visible row: clickable hunk-button ranges recorded during render. */
 	#hits: ({ hunk: number; primary?: [number, number]; discard?: [number, number] } | undefined)[] = [];
 	/**
@@ -1500,6 +1505,22 @@ export class DiffPane {
 	}
 
 	#renderMinimap(visuals: Visual[], height: number, colors: DiffPalette): string[] {
+		const cached = this.#minimapCache;
+		if (
+			cached &&
+			cached.visuals === visuals &&
+			cached.height === height &&
+			cached.scrollTop === this.scrollTop &&
+			cached.colors === colors
+		) {
+			return cached.lines;
+		}
+		const lines = this.#buildMinimap(visuals, height, colors);
+		this.#minimapCache = { visuals, height, scrollTop: this.scrollTop, colors, lines };
+		return lines;
+	}
+
+	#buildMinimap(visuals: Visual[], height: number, colors: DiffPalette): string[] {
 		const total = visuals.length;
 		const lines: string[] = [];
 		const bandKind = (band: number): RowKind | "hunk" | null => {

package/src/apps/git/git-tui.ts

@@ -1,5 +1,5 @@
 /**
- * `omp git` — fullscreen repository TUI.
+ * `zetacode git` — fullscreen repository TUI.
  *
  * Layout: header (file path, encoding, stage-file button, close), toolbar
  * (scope chip, file/diff toggle, hunk navigation, hunk/inline/split view
@@ -1235,7 +1235,7 @@ export async function showGitOverlay(ui: TUI, host: GitTuiHost): Promise<void> {
 	}
 }
 
-/** Run the fullscreen git TUI standalone (`omp git`) until the user quits. */
+/** Run the fullscreen git TUI standalone (`zetacode git`) until the user quits. */
 export async function runGitTui(host: GitTuiHost): Promise<void> {
 	const ui = new TUI(new ProcessTerminal());
 	ui.start();

package/src/apps/git/help.ts

@@ -11,7 +11,8 @@ import { formatKeyHint } from "../../app-keybindings";
 import type { KeyName } from "../../key-hint-format";
 import { matchesKey } from "../../keys";
 import { col, node, span } from "../../native/describe";
-import type { NativeNode } from "../../native/node";
+import type { NativeNode, NativeUiEvent } from "../../native/node";
+import { actionBar, actionButton } from "../../native/overlay";
 import { theme } from "../../theme/theme";
 import type { Component } from "../../tui";
 import { truncateToWidth, visibleWidth } from "../../utils";
@@ -79,28 +80,36 @@ export class GitHelpSheet implements Component {
 		if (data === "?" || data === "q" || matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) this.#close();
 	}
 
+	/** Close runs what Esc runs. */
+	handleNativeEvent(event: NativeUiEvent): void {
+		if (event.type === "action" && event.act === "close") this.#close();
+	}
+
 	describe(): NativeNode {
 		this.#native ??= col(
-			GROUPS.map(group =>
-				node(
-					"section",
-					{ head: group.title, role: "zeta.hotkeys.group" },
-					[
-						node("table", {
-							role: "zeta.hotkeys.table",
-							cols: [
-								{ id: "keys", head: "Keys" },
-								{ id: "does", head: "Action", grow: 1 },
-							],
-							rows: group.rows.map((row, index) => ({
-								id: String(index),
-								cells: { keys: row.keys.map(key => span(formatKeyHint(key), "key")), does: row.label },
-							})),
-						}),
-					],
-					group.title,
+			[
+				...GROUPS.map(group =>
+					node(
+						"section",
+						{ head: group.title, role: "zeta.hotkeys.group" },
+						[
+							node("table", {
+								role: "zeta.hotkeys.table",
+								cols: [
+									{ id: "keys", head: "Keys" },
+									{ id: "does", head: "Action", grow: 1 },
+								],
+								rows: group.rows.map((row, index) => ({
+									id: String(index),
+									cells: { keys: row.keys.map(key => span(formatKeyHint(key), "key")), does: row.label },
+								})),
+							}),
+						],
+						group.title,
+					),
 				),
-			),
+				actionBar([null, actionButton("Close", "close", { keys: "escape" })]),
+			],
 			{ gap: "lg", role: "zeta.app.git.help" },
 		);
 		return this.#native;

package/src/apps/if-bench-board.ts

@@ -1,5 +1,5 @@
 /**
- * Live board and scoreboard for `omp if-bench`.
+ * Live board and scoreboard for `zetacode if-bench`.
  *
  * Interactive terminals get one repainted row per model — a turn ladder that
  * fills as turns pass, the in-flight turn as a spinner cell, and the live
@@ -71,7 +71,7 @@ const FAILURE_TEXT: Record<IfBenchFailure, string> = {
 	provider: "provider error",
 };
 
-/** Rendering surface for one `omp if-bench` run. */
+/** Rendering surface for one `zetacode if-bench` run. */
 export interface IfBenchBoard extends IfBenchObserver {
 	readonly interactive: boolean;
 	/** Print a permanent line above the live rows (plain write when non-TTY). */

package/src/apps/ps-top.ts

@@ -1,5 +1,5 @@
 /**
- * Interactive alt-screen monitor for `omp ps` (btop idiom): a live process
+ * Interactive alt-screen monitor for `zetacode ps` (btop idiom): a live process
  * table over every selected broker scope with in-place actions.
  *
  * Keys — table: `↑/↓`/`j/k` select, `enter`/`i` info, `l` logs, `s` stop,
@@ -631,7 +631,7 @@ export class PsTopComponent implements Component {
 
 	#header(width: number, title: string): string {
 		const age = this.#lastRefresh ? `updated ${formatDuration(Date.now() - this.#lastRefresh)} ago` : "updating…";
-		const left = ` ${chalk.bold("omp ps")} ${chalk.dim("·")} ${title}`;
+		const left = ` ${chalk.bold("zetacode ps")} ${chalk.dim("·")} ${title}`;
 		const right = chalk.dim(age);
 		const pad = Math.max(1, width - Bun.stringWidth(left) - Bun.stringWidth(right) - 1);
 		return truncateToWidth(`${left}${" ".repeat(pad)}${right}`, width);

package/src/apps/setup-model-picker.ts

@@ -1,5 +1,5 @@
 /**
- * Standalone TUI model picker used by `omp setup speech`.
+ * Standalone TUI model picker used by `zetacode setup speech`.
  *
  * One-shot {@link selectStandaloneItem} prompt: resolve on select/cancel and
  * let the adapter tear the UI down. The standalone TUI auto-renders on input,

package/src/autocomplete.d.ts

@@ -77,8 +77,11 @@ export interface AutocompleteProvider {
     };
     /** Get inline hint text to show as dim ghost text after the cursor */
     getInlineHint?(lines: string[], cursorLine: number, cursorCol: number): string | null;
-    /** Synchronously try to complete a slash command at the start of a line (no async I/O). */
-    /** Returns matched items and the full prefix, or null if not applicable. */
+    /**
+     * Synchronously list slash command-name completions for a leading slash token (no async I/O).
+     * Mirrors the command-name branch of {@link getSuggestions}, including the bare `/` listing and
+     * the collapsed `/skill:` namespace row. Returns null outside a command-name token or with no match.
+     */
     trySyncSlashCompletion?(textBeforeCursor: string): {
         items: AutocompleteItem[];
         prefix: string;

package/src/autocomplete.ts

@@ -263,8 +263,11 @@ export interface AutocompleteProvider {
 
 	/** Get inline hint text to show as dim ghost text after the cursor */
 	getInlineHint?(lines: string[], cursorLine: number, cursorCol: number): string | null;
-	/** Synchronously try to complete a slash command at the start of a line (no async I/O). */
-	/** Returns matched items and the full prefix, or null if not applicable. */
+	/**
+	 * Synchronously list slash command-name completions for a leading slash token (no async I/O).
+	 * Mirrors the command-name branch of {@link getSuggestions}, including the bare `/` listing and
+	 * the collapsed `/skill:` namespace row. Returns null outside a command-name token or with no match.
+	 */
 	trySyncSlashCompletion?(textBeforeCursor: string): { items: AutocompleteItem[]; prefix: string } | null;
 	/**
 	 * Synchronously try to expand text immediately before the cursor (no async I/O).
@@ -589,6 +592,22 @@ function buildMidPromptSkillCompletions(commands: CommandEntry[], lowerPrefix: s
 	);
 }
 
+const DIR_CACHE_MAX = 100;
+const DIR_CACHE_EVICT = 50;
+
+/**
+ * Drops the `count` oldest entries once `map` exceeds `max`. Callers delete a
+ * key before re-setting it, so Map insertion order is refresh order.
+ */
+function evictOldest(map: Map<string, unknown>, max: number, count: number): void {
+	if (map.size <= max) return;
+	let remaining = count;
+	for (const key of map.keys()) {
+		if (remaining-- === 0) break;
+		map.delete(key);
+	}
+}
+
 // Combined provider that handles both slash commands and file paths.
 export class CombinedAutocompleteProvider implements AutocompleteProvider {
 	#commands: CommandEntry[];
@@ -598,6 +617,9 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 	// per-directory readdir fast-path for prefix completions. Global fuzzy
 	// discovery continues to use native fuzzyFind + shared scan cache.
 	#dirCache: Map<string, { entries: fs.Dirent[]; timestamp: number }> = new Map();
+	// Whether a scoped fuzzy query's base (`src/` in `@src/foo`) is a directory;
+	// stat'ing it on every keystroke is redundant while the base is unchanged.
+	#scopedBaseCache: Map<string, { isDirectory: boolean; timestamp: number }> = new Map();
 	readonly #DIR_CACHE_TTL = 2000; // 2 seconds
 
 	constructor(
@@ -806,7 +828,7 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 			};
 		}
 
-		// Slash command suggestions can be accepted before the debounced refresh
+		// Slash command suggestions can be accepted before an async refresh
 		// catches up to newly typed characters. Replace the live command token,
 		// not only the prefix captured when the suggestion list was rendered.
 		// Absolute-path completions share the leading-slash prefix shape but
@@ -976,11 +998,21 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 			baseDir = path.join(this.#basePath, displayBase);
 		}
 
-		try {
-			if (!(await fs.promises.stat(baseDir)).isDirectory()) {
-				return null;
+		const now = Date.now();
+		let cachedBase = this.#scopedBaseCache.get(baseDir);
+		if (!cachedBase || now - cachedBase.timestamp >= this.#DIR_CACHE_TTL) {
+			let isDirectory = false;
+			try {
+				isDirectory = (await fs.promises.stat(baseDir)).isDirectory();
+			} catch {
+				// Missing or inaccessible base: not a scope.
 			}
-		} catch {
+			cachedBase = { isDirectory, timestamp: now };
+			this.#scopedBaseCache.delete(baseDir);
+			this.#scopedBaseCache.set(baseDir, cachedBase);
+			evictOldest(this.#scopedBaseCache, DIR_CACHE_MAX, DIR_CACHE_EVICT);
+		}
+		if (!cachedBase.isDirectory) {
 			return null;
 		}
 
@@ -1003,17 +1035,9 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		}
 
 		const entries = await fs.promises.readdir(searchDir, { withFileTypes: true });
+		this.#dirCache.delete(searchDir);
 		this.#dirCache.set(searchDir, { entries, timestamp: now });
-
-		if (this.#dirCache.size > 100) {
-			const sortedKeys = [...this.#dirCache.entries()]
-				.sort((a, b) => a[1].timestamp - b[1].timestamp)
-				.slice(0, 50)
-				.map(([key]) => key);
-			for (const key of sortedKeys) {
-				this.#dirCache.delete(key);
-			}
-		}
+		evictOldest(this.#dirCache, DIR_CACHE_MAX, DIR_CACHE_EVICT);
 
 		return entries;
 	}
@@ -1021,8 +1045,10 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 	invalidateDirCache(dir?: string): void {
 		if (dir) {
 			this.#dirCache.delete(dir);
+			this.#scopedBaseCache.delete(dir);
 		} else {
 			this.#dirCache.clear();
+			this.#scopedBaseCache.clear();
 		}
 	}
 
@@ -1087,26 +1113,29 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 			const entries = await this.#getCachedDirEntries(searchDir);
 			const suggestions: AutocompleteItem[] = [];
 
-			for (const entry of entries) {
-				if (!entry.name.toLowerCase().startsWith(searchPrefix.toLowerCase())) {
-					continue;
-				}
-				// Skip .git directory
-				if (entry.name === ".git") {
-					continue;
-				}
+			const lowerSearchPrefix = searchPrefix.toLowerCase();
+			// Skip .git directory
+			const matched = entries.filter(
+				entry => entry.name !== ".git" && entry.name.toLowerCase().startsWith(lowerSearchPrefix),
+			);
+			// Directory flag per match; symlinks are stat'ed concurrently to learn whether
+			// they point at a directory. `null` drops a broken symlink, a file deleted
+			// between readdir and stat, or a permission error.
+			const directoryFlags = await Promise.all(
+				matched.map(entry =>
+					!entry.isDirectory() && entry.isSymbolicLink()
+						? fs.promises.stat(path.join(searchDir, entry.name)).then(
+								stats => stats.isDirectory(),
+								() => null,
+							)
+						: entry.isDirectory(),
+				),
+			);
 
-				// Check if entry is a directory (or a symlink pointing to a directory)
-				let isDirectory = entry.isDirectory();
-				if (!isDirectory && entry.isSymbolicLink()) {
-					try {
-						const fullPath = path.join(searchDir, entry.name);
-						isDirectory = (await fs.promises.stat(fullPath)).isDirectory();
-					} catch {
-						// Broken symlink, file deleted between readdir and stat, or permission error
-						continue;
-					}
-				}
+			for (let index = 0; index < matched.length; index++) {
+				const isDirectory = directoryFlags[index];
+				if (typeof isDirectory !== "boolean") continue;
+				const entry = matched[index]!;
 
 				let relativePath: string;
 				const name = entry.name;
@@ -1300,19 +1329,14 @@ export class CombinedAutocompleteProvider implements AutocompleteProvider {
 		const slashStart = findLeadingSlashCommandStart(textBeforeCursor);
 		if (slashStart === null) return null;
 		const commandText = textBeforeCursor.slice(slashStart);
-		if (commandText.length <= 1) return null; // Bare "/" alone, don't auto-complete
 		if (commandText.includes(" ")) return null; // Only complete command name, not args
 
-		const prefix = commandText.slice(1);
-		const lowerPrefix = prefix.toLowerCase();
-
-		// The `/skill:` namespace row is excluded here: the sync path submits
-		// immediately after applying, and the bare namespace is not a command.
+		const lowerPrefix = commandText.slice(1).toLowerCase();
 		const matches = buildSlashCommandCompletions(
 			collapseSkillNamespace(this.#commands, lowerPrefix),
 			lowerPrefix,
 			this.#commandUsage,
-		).filter(item => item.value !== SKILL_NAMESPACE);
+		);
 
 		if (matches.length === 0) return null;
 		// Mirror `getSuggestions`: preserve leading whitespace so the editor's