@xynogen/pix-runtime 0.2.0 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-runtime",
-	"version": "0.2.0",
+	"version": "0.3.1",
 	"description": "Pix shared runtime — versioned pix.json config, atomic persistence, typed change events",
 	"type": "module",
 	"main": "src/index.ts",

package/src/pix-command.ts

@@ -7,12 +7,18 @@
  */
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-import { matchesKey } from "@earendil-works/pi-tui";
+import {
+	Key,
+	type KeybindingsManager,
+	matchesKey,
+	truncateToWidth,
+	visibleWidth,
+	wrapTextWithAnsi,
+} from "@earendil-works/pi-tui";
 import type { PixRuntime } from "./runtime.ts";
 import type { DeepPartial, SectionHandle } from "./schema.ts";
 import { collapseSection } from "./sections/collapse.ts";
 import { gateSection } from "./sections/gate.ts";
-import { optimizerSection } from "./sections/optimizer.ts";
 import { prettySection } from "./sections/pretty.ts";
 
 interface SettingRow<T> {
@@ -62,29 +68,13 @@ const SETTINGS: SettingRow<unknown>[] = [
 		read: (v) => String(v.delaySec),
 		patch: (value) => ({ delaySec: Number(value) }),
 	}),
-	row({
-		section: "Optimizer",
-		label: "caveman",
-		handle: optimizerSection,
-		values: ["off", "lite", "full", "ultra", "micro"],
-		read: (v) => v.caveman,
-		patch: (value) => ({ caveman: value as "off" | "lite" | "full" | "ultra" | "micro" }),
-	}),
-	row({
-		section: "Optimizer",
-		label: "rtk",
-		handle: optimizerSection,
-		values: ["on", "off"],
-		read: (v) => v.rtk,
-		patch: (value) => ({ rtk: value as "on" | "off" }),
-	}),
 	row({
 		section: "Gate",
-		label: "disable defaults",
+		label: "Guardrails",
 		handle: gateSection,
-		values: ["false", "true"],
-		read: (v) => String(v.disableDefaults),
-		patch: (value) => ({ disableDefaults: value === "true" }),
+		values: ["on", "off"],
+		read: (v) => v.guardrails,
+		patch: (guardrails) => ({ guardrails: guardrails as "on" | "off" }),
 	}),
 ];
 
@@ -121,15 +111,20 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 			const boxW = 52;
 			await ui.custom(
 				(
-					tui: { requestRender(): void },
+					tui: { requestRender(): void; terminal?: { rows?: number } },
 					theme: {
 						fg(c: string, t: string): string;
+						bg(c: string, t: string): string;
 						bold(t: string): string;
 					},
-					_kb: unknown,
+					kb: KeybindingsManager,
 					done: (v: null) => void,
 				) => {
 					let selected = 0;
+					let bodyOffset = 0;
+					let visibleBodyLines = 1;
+					let maxBodyOffset = 0;
+					let inspectingPage = false;
 
 					const cycle = (direction: -1 | 1) => {
 						const row = SETTINGS[selected];
@@ -142,18 +137,20 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 					};
 					const move = (direction: -1 | 1) => {
 						selected = (selected + direction + SETTINGS.length) % SETTINGS.length;
+						inspectingPage = false;
 					};
 
 					return {
 						render: () => {
 							const labelW = Math.max(...SETTINGS.map((r) => r.label.length));
-							const lines: string[] = [theme.fg("accent", theme.bold("  pix settings")), ""];
+							const body: string[] = [];
+							const settingBodyLines: number[] = [];
 							let lastSection = "";
 							for (let i = 0; i < SETTINGS.length; i++) {
 								const row = SETTINGS[i]!;
 								if (row.section !== lastSection) {
-									if (lastSection) lines.push("");
-									lines.push(theme.fg("dim", `  ${row.section}`));
+									if (lastSection) body.push("");
+									body.push(theme.fg("dim", `  ${row.section}`));
 									lastSection = row.section;
 								}
 								const sel = i === selected;
@@ -161,14 +158,40 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 								const label = theme.fg(sel ? "accent" : "text", row.label.padEnd(labelW));
 								const value = row.read(runtime.get(row.handle));
 								const isDefault = value === row.values[0];
-								lines.push(`${cursor} ${label}  ${theme.fg(isDefault ? "dim" : "success", value)}`);
+								settingBodyLines[i] = body.length;
+								body.push(`${cursor} ${label}  ${theme.fg(isDefault ? "dim" : "success", value)}`);
 							}
-							lines.push("");
-							lines.push(theme.fg("dim", "←→ change · ↑↓ move · esc close"));
-							return lines;
+							const result = frameModal({
+								width: boxW,
+								maxHeight: modalHeight(tui.terminal?.rows),
+								header: [theme.fg("accent", theme.bold("  pix settings")), ""],
+								body,
+								footer: [
+									"",
+									theme.fg("dim", "←→ change · ↑↓ move · PgUp/PgDn inspect · esc close"),
+								],
+								bodyOffset,
+								selectedBodyLine: inspectingPage ? undefined : settingBodyLines[selected],
+								color: (s: string) => theme.fg("accent", s),
+								bg: (s: string) => theme.bg("customMessageBg", s),
+							});
+							bodyOffset = result.bodyOffset;
+							visibleBodyLines = Math.max(1, result.visibleBodyLines);
+							maxBodyOffset = result.maxBodyOffset;
+							return result.lines;
 						},
 						invalidate: () => {},
 						handleInput: (data: string) => {
+							const pageUp = kb?.matches(data, "tui.select.pageUp") || matchesKey(data, Key.pageUp);
+							const pageDown =
+								kb?.matches(data, "tui.select.pageDown") || matchesKey(data, Key.pageDown);
+							if (pageUp || pageDown) {
+								const direction = pageUp ? -1 : 1;
+								bodyOffset = pageBodyOffset(bodyOffset, visibleBodyLines, maxBodyOffset, direction);
+								inspectingPage = true;
+								tui.requestRender();
+								return;
+							}
 							// matchesKey handles both legacy bytes and Kitty CSI-u encodings
 							// for letters and special keys alike — raw string compares like
 							// `data === "k"` silently fail under the Kitty keyboard protocol.
@@ -195,3 +218,109 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 		},
 	});
 }
+
+// ── Inline modal engine (runtime cannot depend on pix-pretty: pretty depends on runtime) ─
+
+interface RuntimeModalOptions {
+	width: number;
+	maxHeight: number;
+	header: string[];
+	body: string[];
+	footer: string[];
+	bodyOffset: number;
+	selectedBodyLine?: number;
+	color: (s: string) => string;
+	bg?: (s: string) => string;
+}
+
+interface RuntimeModalResult {
+	lines: string[];
+	bodyOffset: number;
+	visibleBodyLines: number;
+	maxBodyOffset: number;
+}
+
+function modalHeight(rows = 24): number {
+	const safe = Number.isFinite(rows) ? Math.max(1, Math.floor(rows)) : 24;
+	return Math.max(1, Math.min(safe, Math.floor(safe * 0.8)));
+}
+
+function pageBodyOffset(offset: number, size: number, max: number, direction: -1 | 1): number {
+	const s = Math.max(1, size);
+	const step = Math.max(1, Math.floor(s / 2));
+	return Math.min(max, Math.max(0, offset + direction * step));
+}
+
+function fitLines(lines: string[], width: number): string[] {
+	const rows: string[] = [];
+	for (const line of lines) {
+		if (line === "") rows.push("");
+		else rows.push(...wrapTextWithAnsi(line, Math.max(1, width)));
+	}
+	return rows;
+}
+
+function frameModal(opts: RuntimeModalOptions): RuntimeModalResult {
+	const inner = Math.max(1, opts.width - 4);
+	const header = fitLines(opts.header, inner);
+	const footer = fitLines(opts.footer, inner);
+	const body = fitLines(opts.body, inner);
+	const cap = Math.max(1, opts.maxHeight);
+	const bodyBudget = cap - 2 - header.length - footer.length;
+	const overflows = body.length > Math.max(0, bodyBudget);
+	const visibleBodyLines = overflows ? Math.max(0, bodyBudget - 1) : Math.max(0, bodyBudget);
+	if (visibleBodyLines === 0 && body.length > 0) {
+		return {
+			lines: frameRows(opts.width, ["Terminal too short — resize or press esc to cancel"], opts),
+			bodyOffset: 0,
+			visibleBodyLines: 0,
+			maxBodyOffset: 0,
+		};
+	}
+	const maxBodyOffset = Math.max(0, body.length - visibleBodyLines);
+	let offset = Math.min(maxBodyOffset, Math.max(0, opts.bodyOffset));
+	if (opts.selectedBodyLine !== undefined) {
+		const selected = Math.min(body.length - 1, Math.max(0, opts.selectedBodyLine));
+		if (selected < offset) offset = selected;
+		else if (selected >= offset + visibleBodyLines) offset = selected - visibleBodyLines + 1;
+	}
+	const end = Math.min(body.length, offset + visibleBodyLines);
+	const lines = [...header];
+	if (overflows) {
+		const step = Math.max(1, Math.floor(visibleBodyLines / 2));
+		const totalPages = Math.max(1, Math.ceil(maxBodyOffset / step) + 1);
+		const page = offset >= maxBodyOffset ? totalPages : Math.floor(offset / step) + 1;
+		lines.push(`PgUp/PgDn inspect • ${page}/${totalPages}`);
+	}
+	lines.push(...body.slice(offset, end), ...footer);
+	return {
+		lines: frameRows(opts.width, lines, opts),
+		bodyOffset: offset,
+		visibleBodyLines,
+		maxBodyOffset,
+	};
+}
+
+function frameRows(
+	width: number,
+	lines: string[],
+	opts: Pick<RuntimeModalOptions, "color" | "bg">,
+): string[] {
+	const bg = opts.bg ?? ((s: string) => s);
+	const inner = Math.max(1, width - 4);
+	const dashes = "─".repeat(width - 2);
+	const SENTINEL = "\x00";
+	const bgOpen = bg(SENTINEL).split(SENTINEL)[0] ?? "";
+	const reassert = (s: string): string =>
+		bgOpen
+			? s.replace(/\x1b\[([0-9;]*)m/g, (seq, p: string) =>
+					p === "0" || p.split(";").includes("49") ? `${seq}${bgOpen}` : seq,
+				)
+			: s;
+	const row = (content: string): string => {
+		const fitted = truncateToWidth(content, inner, "…");
+		const padded = fitted + " ".repeat(Math.max(0, inner - visibleWidth(fitted)));
+		return bg(`${opts.color("│")} ${reassert(padded)} ${opts.color("│")}`);
+	};
+	return [bg(opts.color(`╭${dashes}╮`)), ...lines.map(row), bg(opts.color(`╰${dashes}╯`))];
+}

package/src/sections/gate.ts

@@ -1,4 +1,4 @@
-import { boolOr, defineSection, isObj, strArr } from "../schema.ts";
+import { defineSection, enumOr, isObj, strArr } from "../schema.ts";
 
 export type GateSeverity = "risky" | "dangerous" | "critical";
 
@@ -10,7 +10,8 @@ export interface GateRuleConfig {
 }
 
 export interface GateConfig {
-	disableDefaults: boolean;
+	/** Whether Pix's built-in command protections are active. */
+	guardrails: "on" | "off";
 	autoApprove: string[];
 	extraRules: GateRuleConfig[];
 }
@@ -18,7 +19,7 @@ export interface GateConfig {
 const SEVERITIES: readonly GateSeverity[] = ["risky", "dangerous", "critical"];
 
 const DEFAULTS: Readonly<GateConfig> = {
-	disableDefaults: false,
+	guardrails: "on",
 	autoApprove: [],
 	extraRules: [],
 };
@@ -37,7 +38,7 @@ export const gateSection = defineSection<"gate", GateConfig>({
 	key: "gate",
 	defaults: DEFAULTS,
 	parse(raw, ctx) {
-		if (!isObj(raw)) return { disableDefaults: false, autoApprove: [], extraRules: [] };
+		if (!isObj(raw)) return { guardrails: "on", autoApprove: [], extraRules: [] };
 		const extraRules: GateRuleConfig[] = [];
 		if (Array.isArray(raw.extraRules)) {
 			raw.extraRules.forEach((r, i) => {
@@ -63,7 +64,7 @@ export const gateSection = defineSection<"gate", GateConfig>({
 			});
 		}
 		return {
-			disableDefaults: boolOr(raw.disableDefaults, DEFAULTS.disableDefaults),
+			guardrails: enumOr(raw.guardrails, ["on", "off"], DEFAULTS.guardrails),
 			autoApprove: strArr(raw.autoApprove),
 			extraRules,
 		};