@huseynsnmz/pi-board 0.15.3 → 0.17.0

package/src/ui/dashboard.ts

@@ -9,7 +9,9 @@
 import { readFileSync } from "node:fs";
 import { CustomEditor } from "@earendil-works/pi-coding-agent";
 import type { Component, EditorTheme, KeybindingsManager, TUI } from "@earendil-works/pi-tui";
-import { Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { CombinedAutocompleteProvider, Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { createDoublePress, QUIT_PRESS_MS } from "../core/double-press.mjs";
+import { runsInPi } from "../core/slash-commands.mjs";
 import { readConfig, writeConfig } from "../core/config.mjs";
 import { editExternally } from "./external-editor.ts";
 import { requestDashboardRender } from "../core/dashboard-render.mjs";
@@ -57,7 +59,11 @@ interface ThemeLike {
 	strikethrough(text: string): string;
 }
 
-export type DashboardResult = { action: "exit" } | { action: "attach"; viewId: string; stopFirst: boolean };
+export type DashboardResult =
+	| { action: "exit" }
+	| { action: "attach"; viewId: string; stopFirst: boolean }
+	| { action: "quit" }
+	| { action: "command"; text: string };
 
 type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 type LaunchModel = {
@@ -125,6 +131,7 @@ export interface DashboardDeps {
 	currentThinkingLevel: ThinkingLevel;
 	initialSelectedId?: string | null;
 	initialNotice?: string;
+	commands?: { name: string; description?: string; source: string }[];
 }
 
 export class DashboardComponent implements Component {
@@ -137,10 +144,11 @@ export class DashboardComponent implements Component {
 	private filterQuery = "";
 	private pending: PendingConfirm | null = null;
 	private deleteArm: { id: string; at: number } | null = null;
-	private exitArmedAt: number | null = null;
+	private readonly quitPresses = createDoublePress(Date.now, QUIT_PRESS_MS);
 	private groupBy: "state" | "directory" = readConfig().groupBy === "directory" ? "directory" : "state";
 	private readonly groupOf = new Map<string, string>();
 	private readonly neighborsOf = new Map<string, string>();
+	private readonly folderOf = new Map<string, string>();
 	private helpReturnMode: ReturnableMode = "list";
 	private ptyHelpReturnMode: ReturnableMode = "list";
 	private peekId: string | null = null;
@@ -181,6 +189,7 @@ export class DashboardComponent implements Component {
 			}
 		};
 		this.editor.onSubmit = (text) => this.submitEditor(text);
+		this.editor.setAutocompleteProvider(this.commandMenu());
 		this.selectedId = deps.initialSelectedId ?? null;
 		// Issue #147: the post-delete reopen carries the Deleted notice here —
 		// the component is new each open, so an inline notice cannot travel.
@@ -202,15 +211,17 @@ export class DashboardComponent implements Component {
 		this.rows = this.filterQuery ? filterRows(all, this.filterQuery) : all;
 		this.groupOf.clear();
 		this.neighborsOf.clear();
-		const place = (group: string, leaf: string, ids: string[]) => {
+		this.folderOf.clear();
+		const place = (group: string, folder: string, ids: string[]) => {
 			for (const id of ids) {
 				this.groupOf.set(id, group);
-				this.neighborsOf.set(id, `${group}\0${leaf}`);
+				this.folderOf.set(id, folder);
+				this.neighborsOf.set(id, `${group}\0${folder}`);
 			}
 			return ids;
 		};
 		this.orderedIds = this.groupBy === "directory"
-			? groupRowsByDirectory(this.rows, Date.now()).flatMap((f) => place(f.key, "", f.rows.map((r) => r.id)))
+			? groupRowsByDirectory(this.rows, Date.now()).flatMap((f) => place(f.key, f.key, f.rows.map((r) => r.id)))
 			: groupRowsByFolder(this.rows, Date.now()).flatMap((g) => g.folders.flatMap((f) => place(g.state, f.key, f.rows.map((r) => r.id))));
 		const visibleIds = new Set(this.orderedIds);
 		this.selectedIds = new Set([...this.selectedIds].filter((id) => visibleIds.has(id)));
@@ -332,6 +343,8 @@ export class DashboardComponent implements Component {
 	// ---- input --------------------------------------------------------------
 
 	handleInput(data: string): void {
+		if (!matchesKey(data, Key.ctrl("c"))) this.quitPresses.reset();
+		else if (this.quitPresses.press()) return this.done({ action: "quit" });
 		switch (this.mode) {
 			case "list":
 				this.handleListKey(data);
@@ -378,11 +391,10 @@ export class DashboardComponent implements Component {
 
 	private handleListKey(data: string): void {
 		if (!matchesKey(data, Key.ctrl("x"))) this.deleteArm = null;
-		if (!matchesKey(data, Key.ctrl("c"))) this.exitArmedAt = null;
 		if (this.handleRowKey(data)) return;
 		if (matchesKey(data, Key.right) || matchesKey(data, Key.left) || matchesKey(data, Key.enter)) return this.attachSelected();
 		if (matchesKey(data, Key.space)) return this.openPeek();
-		if (data === "/" || matchesKey(data, Key.ctrl("f"))) return this.startFilter();
+		if (matchesKey(data, Key.ctrl("f"))) return this.startFilter();
 		if (data === "?") return this.openHelp("list");
 		if (data === "!") return this.openPtyHelp("list");
 		if (matchesKey(data, Key.ctrl("r"))) return this.startRename();
@@ -399,16 +411,10 @@ export class DashboardComponent implements Component {
 		if (matchesKey(data, Key.ctrl("b"))) return this.toggleHold();
 		if (matchesKey(data, Key.ctrl("k"))) return this.confirmDeleteState();
 		for (let n = 1; n <= 9; n++) {
-			if (matchesKey(data, Key.alt(String(n) as never))) return this.attachRow(n - 1);
+			if (matchesKey(data, Key.alt(String(n) as never))) return this.attachInFolder(n - 1);
 		}
 		if (matchesKey(data, Key.escape)) return this.done({ action: "exit" });
-		if (matchesKey(data, Key.ctrl("c"))) {
-			const now = Date.now();
-			if (this.exitArmedAt !== null && now - this.exitArmedAt <= DELETE_DOUBLE_PRESS_MS) return this.done({ action: "exit" });
-			this.exitArmedAt = now;
-			this.notifyInputState("Press ctrl+c again to exit", "accent");
-			return;
-		}
+		if (matchesKey(data, Key.ctrl("c"))) return this.notifyInputState("Press ctrl+c again to quit Pi", "accent");
 		if (isPrintable(data) || isBracketedPaste(data)) {
 			this.mode = "dispatch";
 			this.handleEditorInput(data);
@@ -496,13 +502,22 @@ export class DashboardComponent implements Component {
 		this.selectIndex(index);
 	}
 
-	private attachRow(index: number): void {
-		if (!this.orderedIds[index]) return;
-		this.selectIndex(index);
+	/** Counts the rows in the selected session's folder. */
+	private attachInFolder(index: number): void {
+		const folder = this.folderOf.get(this.selectedId ?? "");
+		const id = this.orderedIds.filter((other) => this.folderOf.get(other) === folder)[index];
+		if (!id) return;
+		this.selectIndex(this.orderedIds.indexOf(id));
 		this.attachSelected();
 	}
 
 	private handleDispatchKey(data: string): void {
+		// The menu has its own use for Enter, Tab, Esc and the arrows.
+		if (this.editor.isShowingAutocomplete() && !matchesKey(data, Key.ctrl("c"))) {
+			this.handleEditorInput(data);
+			if (!this.input && this.mode === "dispatch") this.mode = "list";
+			return;
+		}
 		if (matchesKey(data, Key.ctrl("n"))) return this.openLaunchDialog();
 		if (matchesKey(data, Key.ctrl("g"))) return void this.openExternalEditor();
 		if (matchesKey(data, Key.ctrl("enter"))) return this.startNow(true);
@@ -795,6 +810,11 @@ export class DashboardComponent implements Component {
 
 	/** In this folder, with this session's model. Ctrl+N is there for anything else. */
 	private startNow(attach = false): void {
+		const text = this.input.trim();
+		if (runsInPi(text, this.deps.commands ?? [])) {
+			this.setInput("");
+			return this.done({ action: "command", text });
+		}
 		const cwd = this.deps.defaultCwd;
 		const { model, thinking } = this.buildLaunchState(cwd, this.deps.currentModel, this.deps.currentThinkingLevel);
 		this.submitDispatch({ cwd, model: model ? canonicalModelRef(model) : null, thinkingLevel: thinking, attach });
@@ -930,6 +950,17 @@ export class DashboardComponent implements Component {
 		this.handleEditorInput(data);
 	}
 
+	/** Only for a task that starts with `/`: the same editor takes filters, names and replies. */
+	private commandMenu(): CombinedAutocompleteProvider {
+		const menu = new CombinedAutocompleteProvider(this.deps.commands ?? [], this.deps.defaultCwd);
+		const suggest = menu.getSuggestions.bind(menu);
+		menu.getSuggestions = async (lines, line, col, options) => {
+			if (this.mode !== "dispatch" || line !== 0 || !lines[0]?.startsWith("/")) return null;
+			return suggest(lines, line, col, options);
+		};
+		return menu;
+	}
+
 	private handleEditorInput(data: string): void {
 		this.editor.handleInput(data);
 		this.input = this.editor.getExpandedText();
@@ -1435,7 +1466,7 @@ export class DashboardComponent implements Component {
 		if (this.mode === "select") {
 			return [`${this.selectionCount()} selected`, ...dots, "space toggle", "a all", "u clear", "d done", "ctrl+x delete", "esc cancel"];
 		}
-		return [selected ? (live ? "enter attach live" : "enter resume") : "type to start", "space peek", "/ filter", "ctrl+x stop", "? keys", ...dots];
+		return [selected ? (live ? "enter attach live" : "enter resume") : "type to start", "space peek", "ctrl+f filter", "ctrl+x stop", "? keys", ...dots];
 	}
 
 	private hintLine(label: string, color: InputNoticeColor, hints: string[]): string {
@@ -1479,8 +1510,10 @@ export class DashboardComponent implements Component {
 			const contentWidth = Math.max(1, width - visibleWidth(opts.prompt));
 			return [clip(`${opts.prompt}${clip(this.theme.fg("muted", opts.placeholder ?? ""), contentWidth)}`, width)];
 		}
-		// Its first and last lines are its own rules, and the frame already draws those.
-		const rendered = this.editor.render(width).slice(1, -1);
+		// Its first line and the one above any command menu are its own rules, and the frame already draws those.
+		const all = this.editor.render(width);
+		const menu = (this.editor as unknown as { renderedAutocompleteHeight: number }).renderedAutocompleteHeight;
+		const rendered = [...all.slice(1, all.length - menu - 1), ...all.slice(all.length - menu)];
 		return opts.editing ? rendered : rendered.map((line) => stripInactiveEditorCursor(line));
 	}
 
@@ -1798,9 +1831,10 @@ export class DashboardComponent implements Component {
 			["pgup / pgdn", "Move by a screenful"],
 			["home / end", "First or last row"],
 			["alt+↑ / alt+↓", "Previous or next group"],
-			["alt+1..9", "Attach to that row"],
+			["alt+1..9", "Attach to that row in this folder"],
 			["space", "Open or close the peek panel"],
-			["/ or ctrl+f", "Filter the list"],
+			["/", "Pi's commands. They run here; a template or skill starts a session"],
+			["ctrl+f", "Filter the list"],
 			["ctrl+s", "Group by state or by directory"],
 			["shift+↑ / ↓", "Move the row up or down its group"],
 			["ctrl+g", "Write the task in $VISUAL or $EDITOR"],
@@ -1814,7 +1848,7 @@ export class DashboardComponent implements Component {
 			["ctrl+e", "Evidence and diagnostics"],
 			["ctrl+k", "Delete every inactive session in this state"],
 			["esc", "Close, clear the input, or leave the board"],
-			["ctrl+c", "Clear the input; press twice to leave"],
+			["ctrl+c", "Clear the input; press twice to quit Pi, here or in a session"],
 			["!", "node-pty diagnostics"],
 			["?", "This help"],
 			["In select", "↑↓ move · space toggle · a all · u clear · d done · ctrl+x delete · esc cancel"],

package/src/ui/pty-attach.ts

@@ -6,6 +6,7 @@ import { createConnection, type Socket } from "node:net";
 import type { Component, KeybindingsManager, RgbColor, TUI, TerminalColorScheme, TuiMouseEvent, TuiMouseEventResult } from "@earendil-works/pi-tui";
 import { CURSOR_MARKER, Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { resolveAttachDeleteKey } from "../core/attach-delete.mjs";
+import { createDoublePress, QUIT_PRESS_MS } from "../core/double-press.mjs";
 import { findHttpUrlAtCells, findWordRangeAtCells } from "../core/pty-links.mjs";
 import { canPublishAttachView, createAttachOutputRenderScheduler, decideAttachPresentation, detectCursorDesync, isPtyCursorHidden, nextAttachRender, projectPtyCursor, shouldScheduleAttachRenderForMessage } from "../core/pty-attach-render.mjs";
 import { evaluateAttachReconnect, shouldEscapeAttach } from "../core/pty-attach-reconnect.mjs";
@@ -18,7 +19,7 @@ import { backgroundRgbFromTerminalColors, buildSettleSchemePatch, colorSchemeFor
 import { REPLY_GUARD_WINDOW_MS, createReplyGuard, isReplyGuardEnabled } from "../core/terminal-reply-guard.mjs";
 import { clampInt, encodeWheelReport, fullscreenMouseEnableSequence, historyFloorAfterHydrate, isFullscreenSelectionEnd, resolveAttachMouseAction, resolveAttachWheelRoute, resolvePasteSelectionSource, resolveWheelLines, sameMousePoint, scrollableHistoryLines, scrollViewportTop, selectionDragScrollLines, selectionReleaseIsDrag, shouldOwnOuterMouseMode, splitAttachInput, wheelScrollLinesUp } from "../core/pty-scroll.mjs";
 
-export type PtyAttachResult = { action: "detached" } | { action: "closed"; exitCode?: number | null } | { action: "delete" };
+export type PtyAttachResult = { action: "detached" } | { action: "closed"; exitCode?: number | null } | { action: "delete" } | { action: "quit" };
 
 type ThemeLike = {
 	fg(color: string, text: string): string;
@@ -400,6 +401,7 @@ export class PtyAttachComponent implements Component {
 	private selectionAutoScrollLines = 0;
 	private selectionAutoScrollMouse: { row: number; col: number } | null = null;
 	private pendingClickTimer: ReturnType<typeof setTimeout> | null = null;
+	private readonly quitPresses = createDoublePress(Date.now, QUIT_PRESS_MS);
 	private lastClickPoint: MousePoint | null = null;
 	private lastClickAt = 0;
 	/** Authoritative editor emptiness pushed by the child Pi extension via the
@@ -577,6 +579,9 @@ export class PtyAttachComponent implements Component {
 			this.send({ type: "input", data });
 			return;
 		}
+		// The first goes to the session as usual. The second never does, so the session lives on.
+		if (!matchesKey(data, Key.ctrl("c"))) this.quitPresses.reset();
+		else if (this.quitPresses.press()) return this.detach({ action: "quit" });
 		if (matchesKey(data, "ctrl+\\")) {
 			// Unconditional, terminal-independent escape (issue #126): 0x1c is a
 			// single raw ASCII byte every terminal forwards unchanged in raw
@@ -761,7 +766,7 @@ export class PtyAttachComponent implements Component {
 		this.scheduleRender();
 	}
 
-	private detach(): void {
+	private detach(result: PtyAttachResult = { action: "detached" }): void {
 		// Restore a held PTY before ending the control socket. The runner closes
 		// the socket immediately after receiving detach, so sending detach first
 		// can drop the G3 restore resize (issue #42).
@@ -772,7 +777,7 @@ export class PtyAttachComponent implements Component {
 			this.send({ type: "detach" });
 		}
 		this.close(true);
-		this.done({ action: "detached" });
+		this.done(result);
 	}
 
 		/** Install the component's public ?2026 observers; false return keeps xterm defaults. */