@gavin-hu/my-pi-agent 0.7.0 → 0.8.1

package/extensions/bytefly/doctor/tui.ts

@@ -1,140 +0,0 @@
-/**
- * The `/doctor` TUI screen.
- *
- * One row per extension with a severity glyph, plus a detail pane for the
- * focused row. It stays in the dock's editor slot like `/jobs` and `/rewind`,
- * so the transcript stays visible; `Esc` closes it.
- *
- * The screen holds no themed strings: `render` reads the live report each time
- * and `invalidate` has nothing to rebuild. Report text comes from `format.ts`,
- * which sanitizes everything that originated in a probe.
- */
-
-import type { Theme } from "@earendil-works/pi-coding-agent";
-import {
-	Key,
-	matchesKey,
-	truncateToWidth,
-	type Component,
-	type TuiMouseEvent,
-	type TuiMouseEventResult,
-} from "@earendil-works/pi-tui";
-import { fitRows, formatRange, ListCursor, navigateList, scrollList } from "../../../lib/list-cursor.ts";
-import { screenHeader, screenHint } from "../../../lib/tui.ts";
-import type { ExtensionReport } from "../../../lib/requirements.ts";
-import { countFindings, detailLines, extensionRow } from "./format.ts";
-
-/** Body rows when the terminal height is unknown. */
-const SCREEN_DEFAULT_ROWS = 12;
-/** Rows reserved for the focused extension's detail pane. */
-const DETAIL_ROWS = 4;
-/** Fixed rows around the list: header, blank, detail label, hint. */
-const CHROME = 4;
-
-export interface DoctorScreenOptions {
-	/** Current reports; read on every render so a refresh is picked up. */
-	reports: () => ExtensionReport[];
-	/** Live terminal height, for the row budget. */
-	rows: () => number | undefined;
-	theme: Theme;
-	requestRender: () => void;
-	/** Re-probe with `refresh` and update `reports`. May be async; awaited before the busy state clears. */
-	refresh: () => void | Promise<void>;
-	/** Close the screen. */
-	done: () => void;
-}
-
-/** The docked `/doctor` list screen. */
-export class DoctorScreen implements Component {
-	private readonly cursor: ListCursor;
-	private showAll = false;
-	/** True while a re-probe is in flight, so `r` does not stack probes. */
-	private refreshing = false;
-
-	constructor(private readonly options: DoctorScreenOptions) {
-		this.cursor = new ListCursor(() => this.options.requestRender());
-	}
-
-	invalidate(): void {}
-
-	/** Re-probe once; a second request while one is in flight is ignored. */
-	async refresh(): Promise<void> {
-		if (this.refreshing) return;
-		this.refreshing = true;
-		this.showAll = false;
-		this.options.requestRender();
-		try {
-			await this.options.refresh();
-		} finally {
-			this.refreshing = false;
-			this.options.requestRender();
-		}
-	}
-
-	private count(): number {
-		return this.options.reports().length;
-	}
-
-	handleInput(data: string): void {
-		if (matchesKey(data, Key.escape)) {
-			this.options.done();
-			return;
-		}
-		if (matchesKey(data, "r")) {
-			void this.refresh();
-			return;
-		}
-		if (matchesKey(data, Key.enter)) {
-			this.showAll = !this.showAll;
-			this.options.requestRender();
-			return;
-		}
-
-		navigateList(data, this.cursor, this.count());
-	}
-
-	handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
-		return scrollList(event, this.cursor, this.count());
-	}
-
-	// Kept off `dockListFrame`: `/doctor` has no summary, prints the range after
-	// the detail, and has no trailing blank, so the shared frame would change its
-	// output. Its blank-line convention is deliberately local.
-	render(width: number): string[] {
-		const w = Math.max(1, width);
-		const reports = this.options.reports();
-		const count = reports.length;
-
-		this.cursor.visible = Math.max(1, fitRows(this.options.rows(), count, CHROME + DETAIL_ROWS, SCREEN_DEFAULT_ROWS));
-		this.cursor.sync(count);
-		const window = this.cursor.window(count);
-
-		const lines: string[] = [screenHeader(this.options.theme, w, "doctor")];
-		for (let index = window.start; index < window.end; index += 1) {
-			const report = reports[index];
-			if (report) lines.push(extensionRow(report, this.options.theme, w, index === this.cursor.selected));
-		}
-		lines.push("");
-
-		const focused = reports[this.cursor.selected];
-		const counts = countFindings(focused ? [focused] : []);
-		const label = focused
-			? `  ${focused.extension} — ${counts.missing} missing, ${counts.degraded} degraded`
-			: "  no extensions to report";
-		lines.push(truncateToWidth(this.options.theme.fg("dim", label), w));
-		lines.push(...detailLines(focused, this.options.theme, w, DETAIL_ROWS, this.showAll));
-
-		if (this.cursor.clipped(count)) {
-			lines.push(formatRange(this.options.theme, w, { start: window.start, end: window.end, total: count }));
-		}
-		lines.push(
-			screenHint(this.options.theme, w, [
-				"Esc close",
-				"↑/↓ select",
-				this.showAll ? "Enter problems" : "Enter all checks",
-				this.refreshing ? "refreshing…" : "r refresh",
-			]),
-		);
-		return lines;
-	}
-}

package/extensions/bytefly/picker/commands.ts

@@ -1,73 +0,0 @@
-/**
- * The `/extensions` command.
- *
- * In a terminal session it opens the dock list, where Space toggles the focused
- * extension and Tab switches between Global and Project settings. Everywhere
- * else it prints the same list as text. After the screen closes with pending
- * changes it offers to reload so the new selection takes effect.
- */
-
-import { type ExtensionAPI, getAgentDir } from "@earendil-works/pi-coding-agent";
-import { withRailsSuppressed } from "../../../lib/rails.ts";
-import { discoverExtensions, type DiscoveryDeps } from "./discovery.ts";
-import { formatListing } from "./resources.ts";
-import { createExtensionsPickerRuntime } from "./runtime.ts";
-import { ExtensionsListComponent } from "./tui.ts";
-import type { Discovery } from "./types.ts";
-
-/** Host seams, injected by tests. */
-export interface CommandDeps {
-	discover?: (deps: DiscoveryDeps) => Promise<Awaited<ReturnType<typeof discoverExtensions>>>;
-}
-
-export function registerExtensionsCommand(pi: ExtensionAPI, deps: CommandDeps = {}): void {
-	const discover = deps.discover ?? discoverExtensions;
-
-	pi.registerCommand("extensions", {
-		description: "List and enable/disable extensions",
-		handler: async (_args, ctx) => {
-			const cwd = ctx.cwd ?? process.cwd();
-			const agentDir = getAgentDir();
-			let discovery: Discovery;
-			try {
-				discovery = await discover({ cwd, agentDir, trusted: ctx.isProjectTrusted() });
-			} catch (error) {
-				ctx.ui.notify(`Could not list extensions: ${error instanceof Error ? error.message : String(error)}`, "error");
-				return;
-			}
-			const runtime = createExtensionsPickerRuntime({
-				discovery,
-				cwd,
-				agentDir,
-				onError: (message) => ctx.ui.notify(message, "error"),
-			});
-
-			if (ctx.mode !== "tui") {
-				ctx.ui.notify(formatListing(runtime.items(), agentDir), "info");
-				return;
-			}
-
-			await withRailsSuppressed(pi, () =>
-				ctx.ui.custom<void>((tui, theme, _keybindings, done) => {
-					const unsubscribe = runtime.onChange(() => tui.requestRender());
-					return new ExtensionsListComponent(
-						runtime,
-						theme,
-						agentDir,
-						() => {
-							unsubscribe();
-							done();
-						},
-						() => tui.requestRender(),
-						() => tui.terminal?.rows,
-						(message) => ctx.ui.notify(message, "warning"),
-					);
-				}),
-			);
-
-			if (!runtime.isDirty()) return;
-			const reload = await ctx.ui.confirm("Reload to apply changes?", "Extension changes take effect after a reload.");
-			if (reload) await ctx.reload();
-		},
-	});
-}

package/extensions/bytefly/picker/tui.ts

@@ -1,260 +0,0 @@
-/**
- * The `/extensions` dock screen: a scrollable, keyboard-driven list of every
- * resolved extension with its group header.
- *
- * The component is derived: it reads `runtime.items()` on each render and
- * requests a repaint after a toggle or a scope switch through the injected
- * callbacks. It reuses the shared screen chrome (`lib/tui.ts`) and scroll math
- * (`lib/list-cursor.ts`) rather than re-deriving either.
- */
-
-import type { Theme } from "@earendil-works/pi-coding-agent";
-import {
-	Key,
-	matchesKey,
-	truncateToWidth,
-	type Component,
-	type TuiMouseEvent,
-	type TuiMouseEventResult,
-} from "@earendil-works/pi-tui";
-import { sanitizeLine } from "../../../lib/format.ts";
-import {
-	fitRows,
-	formatRange,
-	isCloseKey,
-	ListCursor,
-	navIntent,
-	selectionMarker,
-	wheelDelta,
-} from "../../../lib/list-cursor.ts";
-import { dockListFrame, screenHint, type ViewportRowsSource } from "../../../lib/tui.ts";
-import { buildEntries, firstSelectable, nextSelectable } from "./resources.ts";
-import type { ExtensionsPickerRuntime as Runtime } from "./runtime.ts";
-import type { Entry } from "./types.ts";
-
-/** Rows the screen shows when the terminal height is unknown. */
-const SCREEN_DEFAULT_ROWS = 16;
-
-/**
- * Fixed rows around the list: header, summary, blank, blank, hint, blank. The
- * focused-detail and pending-changes rows are added on top when present.
- */
-const CHROME = 6;
-
-export class ExtensionsListComponent implements Component {
-	private readonly cursor: ListCursor;
-	/** Serialises toggles so a rapid double press toggles twice, not once. */
-	private chain: Promise<void> = Promise.resolve();
-
-	constructor(
-		private readonly runtime: Runtime,
-		private readonly theme: Theme,
-		private readonly agentDir: string,
-		private readonly onClose: () => void,
-		private readonly requestRender: () => void,
-		private readonly viewportRowsSource?: ViewportRowsSource,
-		private readonly onNotice?: (message: string) => void,
-	) {
-		this.cursor = new ListCursor(() => this.requestRender());
-	}
-
-	private entries(): Entry[] {
-		return buildEntries(this.runtime.items(), this.agentDir);
-	}
-
-	private currentItem() {
-		const entry = this.entries()[this.cursor.selected];
-		return entry?.kind === "item" ? entry.item : undefined;
-	}
-
-	private select(index: number | undefined): void {
-		if (index === undefined) return;
-		this.cursor.set(index, this.entries().length);
-	}
-
-	/** Keep the cursor on an item row when the list shape changes. */
-	private ensureSelectable(): void {
-		const entries = this.entries();
-		if (entries[this.cursor.selected]?.kind === "item") return;
-		this.select(firstSelectable(entries));
-	}
-
-	/** Move the cursor onto an item row when the list shape changed. No repaint. */
-	private clampSelection(entries: Entry[]): void {
-		if (entries[this.cursor.selected]?.kind === "item") return;
-		const first = firstSelectable(entries);
-		if (first !== undefined) this.cursor.selected = first;
-	}
-
-	/** Move `delta` item rows, skipping group headers. */
-	private move(delta: number): void {
-		if (delta === 0) return;
-		this.ensureSelectable();
-		const entries = this.entries();
-		const direction = delta < 0 ? -1 : 1;
-		let index = this.cursor.selected;
-		let remaining = Math.abs(delta);
-		while (remaining > 0) {
-			const next = nextSelectable(entries, index, direction);
-			if (next === undefined) break;
-			index = next;
-			remaining -= 1;
-		}
-		this.cursor.set(index, entries.length);
-	}
-
-	private switchScope(): void {
-		const next = this.runtime.scope() === "global" ? "project" : "global";
-		if (next === "project" && !this.runtime.projectAvailable()) {
-			this.onNotice?.("Project is not trusted; manage extensions in Global scope only.");
-			return;
-		}
-		this.runtime.setScope(next);
-		this.clampSelection(this.entries());
-		this.requestRender();
-	}
-
-	private toggle(): void {
-		const item = this.currentItem();
-		if (!item) return;
-		this.chain = this.chain
-			.then(() => this.runtime.toggle(item))
-			.catch(() => undefined)
-			.then(() => this.requestRender());
-	}
-
-	handleInput(data: string): void {
-		if (isCloseKey(data)) {
-			this.onClose();
-			return;
-		}
-		this.ensureSelectable();
-		if (matchesKey(data, Key.space) || matchesKey(data, Key.enter)) {
-			this.toggle();
-			return;
-		}
-		if (matchesKey(data, Key.tab)) {
-			this.switchScope();
-			return;
-		}
-		if (data === "g") {
-			this.select(firstSelectable(this.entries()));
-			return;
-		}
-		if (data === "G") {
-			this.select(nextSelectable(this.entries(), this.entries().length, -1));
-			return;
-		}
-		switch (navIntent(data)) {
-			case "up":
-				this.move(-1);
-				return;
-			case "down":
-				this.move(1);
-				return;
-			case "pageUp":
-				this.move(-Math.max(1, this.cursor.visible));
-				return;
-			case "pageDown":
-				this.move(Math.max(1, this.cursor.visible));
-				return;
-			case "home":
-				this.select(firstSelectable(this.entries()));
-				return;
-			case "end":
-				this.select(nextSelectable(this.entries(), this.entries().length, -1));
-				return;
-		}
-	}
-
-	handleMouse(event: TuiMouseEvent): TuiMouseEventResult | undefined {
-		const delta = wheelDelta(event);
-		if (delta === undefined) return undefined;
-		this.move(delta);
-		return { handled: true };
-	}
-
-	invalidate(): void {
-		// Everything is rebuilt from live state on each render.
-	}
-
-	private summary(width: number): string {
-		const items = this.runtime.items();
-		const scope = this.runtime.scope() === "global" ? "Global" : "Project";
-		const untrusted = this.runtime.scope() === "global" && !this.runtime.projectAvailable();
-		const counts = `${items.length} extension${items.length === 1 ? "" : "s"} · ${this.runtime.disabledCount()} disabled`;
-		return truncateToWidth(
-			`  ${this.theme.fg("accent", scope)}${untrusted ? this.theme.fg("warning", " (project untrusted)") : ""}${this.theme.fg("muted", ` · ${counts}`)}`,
-			width,
-			"…",
-		);
-	}
-
-	private itemRow(entry: Extract<Entry, { kind: "item" }>, selected: boolean, width: number): string {
-		const checkbox = entry.item.enabled ? this.theme.fg("success", "[x]") : this.theme.fg("dim", "[ ]");
-		const label = sanitizeLine(entry.label);
-		const styled = selected ? this.theme.fg("accent", label) : entry.item.enabled ? label : this.theme.fg("dim", label);
-		return truncateToWidth(`${selectionMarker(this.theme, selected)}${checkbox} ${styled}`, width, "…");
-	}
-
-	render(width: number): string[] {
-		const w = Math.max(1, width);
-		const entries = this.entries();
-		const summary = this.summary(w);
-
-		if (entries.length === 0) {
-			return dockListFrame({
-				theme: this.theme,
-				width: w,
-				title: "Extensions",
-				summary,
-				body: [truncateToWidth(`  ${this.theme.fg("dim", "No extensions found.")}`, w)],
-				hint: screenHint(this.theme, w, ["Esc close"]),
-			});
-		}
-
-		this.clampSelection(entries);
-
-		const focused = entries[this.cursor.selected];
-		const detail = focused?.kind === "item" ? sanitizeLine(focused.item.path) : "";
-		const chrome = CHROME + (detail ? 1 : 0) + (this.runtime.isDirty() ? 1 : 0);
-		this.cursor.visible = fitRows(this.viewportRowsSource, entries.length, chrome, SCREEN_DEFAULT_ROWS);
-		this.cursor.sync(entries.length);
-
-		const { start, end } = this.cursor.window(entries.length);
-		const body: string[] = [];
-		for (let index = start; index < end; index++) {
-			const entry = entries[index];
-			if (entry.kind === "group") {
-				body.push(
-					truncateToWidth(
-						`  ${this.theme.fg("muted", sanitizeLine(entry.label))} ${this.theme.fg("dim", `(${entry.count})`)}`,
-						w,
-						"…",
-					),
-				);
-			} else {
-				body.push(this.itemRow(entry, index === this.cursor.selected, w));
-			}
-		}
-
-		const footnotes: string[] = [];
-		if (detail) footnotes.push(truncateToWidth(`  ${this.theme.fg("muted", detail)}`, w, "…"));
-		if (this.runtime.isDirty()) {
-			footnotes.push(truncateToWidth(`  ${this.theme.fg("warning", "Saved · reload to apply")}`, w, "…"));
-		}
-
-		return dockListFrame({
-			theme: this.theme,
-			width: w,
-			title: "Extensions",
-			summary,
-			body,
-			range: this.cursor.clipped(entries.length)
-				? formatRange(this.theme, w, { start, end, total: entries.length })
-				: undefined,
-			detail: footnotes.length > 0 ? footnotes : undefined,
-			hint: screenHint(this.theme, w, ["Esc close", "Space/Enter toggle", "Tab scope", "↑/↓ select", "g/G"]),
-		});
-	}
-}