gentle-pi 2.7.0 → 3.0.0

package/lib/session-change-capture.ts

@@ -20,7 +20,8 @@ export function installSessionChangeCapture(pi: ExtensionAPI, env: NodeJS.Proces
 	const publish = (evidence: SessionChangeEvidence) => {
 		if (!current || !store || current.sessionManager.getSessionId() !== store.sessionId) return;
 		if (store.record(evidence)) pi.appendEntry(SESSION_CHANGE_ENTRY, { sessionId: store.sessionId, evidence });
-		pi.events.emit(SESSION_CHANGE_EVENT, { sessionId: store.sessionId, notice: store.notice });
+		const notice = store.takeNotice();
+		pi.events.emit(SESSION_CHANGE_EVENT, { sessionId: store.sessionId, ...(notice ? { notice } : {}) });
 	};
 	pi.on("session_start", (_event, ctx) => {
 		pending.clear(); current = ctx;

package/lib/session-changes.ts

@@ -70,6 +70,7 @@ export class SessionChanges {
 	private readonly seen = new Set<string>();
 	private readonly files = new Map<string, Map<string, FileState>>();
 	private bytes = 0;
+	private announced = false;
 	notice: string | undefined;
 	readonly sessionId: string;
 	private cached: WorktreeChanges[] | undefined;
@@ -130,7 +131,13 @@ export class SessionChanges {
 	}
 	get model() {
 		const trees = this.worktrees;
-		return changesModel(trees.flatMap(tree => tree.model.files.map(file => ({ ...file, path: trees.length === 1 ? file.path : tree.root + "/" + file.path }))));
+		return { ...changesModel(trees.flatMap(tree => tree.model.files.map(file => ({ ...file, path: trees.length === 1 ? file.path : tree.root + "/" + file.path })))), ...(this.notice ? { notice: this.notice } : {}) };
+	}
+	/** Return the capture-limit notice once, for a single user notification. The `notice` field stays set. */
+	takeNotice(): string | undefined {
+		if (!this.notice || this.announced) return undefined;
+		this.announced = true;
+		return this.notice;
 	}
 	async refresh() { return this.model; }
 	loadDiff(root: string, file: ChangedFile): string {

package/lib/shell-bar.ts

@@ -12,6 +12,7 @@ export { gaugeTone, renderGauge, type GaugeTone };
 
 export interface ShellBarModel {
 	profile?: string;
+	changes?: { files: number; added: number; deleted: number; notice?: string };
 	cwd: string;
 	branch: string | null;
 	dirty: number | undefined;
@@ -123,7 +124,7 @@ function joinSegments(segments: string[], theme: ShellBarTheme): string {
 export function renderShellSidebarBar(model: ShellBarModel, theme: ShellBarTheme, width: number): string[] {
 	const value = (text: string) => theme.fg(ROLE.VALUE, theme.bold(text));
 	const label = (text: string) => theme.fg(ROLE.LABEL, text);
-	const dirty = model.dirty ? theme.fg(ROLE.DIRTY, `±${model.dirty}`) : "";
+	const changes = model.changes;
 	const branch = model.branch ? `${label("Branch")} ${value(model.branch)}` : "";
 	const percent = model.contextPercent === null ? "?%" : `${Math.round(model.contextPercent)}%`;
 	const capacity = label(`${formatTokens(model.contextWindow)} tokens`);
@@ -133,27 +134,35 @@ export function renderShellSidebarBar(model: ShellBarModel, theme: ShellBarTheme
 			title: "Project",
 			lines: [
 				value(model.cwd),
-				...((branch || dirty) ? [[branch, dirty].filter(Boolean).join(" ")] : []),
+				...(branch ? [branch] : []),
 				...(model.sessionName ? [`${label("Session")} ${value(model.sessionName)}`] : []),
-			],
-		},
-		{
-			title: "Model",
-			lines: [
-				value(model.modelId),
+				`${label("Model")} ${value(model.modelId)}`,
 				...(model.effort ? [`${label("Effort")} ${theme.fg(ROLE.EFFORT, model.effort)}`] : []),
 				...(model.profile ? [`${label("Profile")} ${value(sanitizeStatus(model.profile))}`] : []),
 			],
 		},
 		{
-			title: "Context",
-			lines: [`${paintGauge(model.contextPercent, theme)} ${value(percent)}  ${capacity}`],
+			title: "Changes",
+			lines: [
+				changes?.files
+					? `${changes.files} ${changes.files === 1 ? "file" : "files"} · ${theme.fg("success", `+${changes.added}`)} ${theme.fg("error", `−${changes.deleted}`)}`
+					: label("No captured changes"),
+				...(changes?.notice ? [theme.fg("warning", sanitizeStatus(changes.notice))] : []),
+				label("/gentle:changes"),
+			],
 		},
 		{
 			title: "Usage",
-			lines: [`${label("Cost")} ${value(formatCost(model.costTotal, model.subscription))}`, ...(usage ? [usage] : [])],
+			lines: [
+				`${label("Context")} ${paintGauge(model.contextPercent, theme)} ${value(percent)}`,
+				capacity,
+				`${label("Cost")} ${value(formatCost(model.costTotal, model.subscription))}`,
+				...(usage ? [usage] : []),
+			],
 		},
-		...(model.statuses.length ? [{ title: "Integrations", lines: model.statuses.map((status) => theme.fg(ROLE.STATUS, sanitizeStatus(status))) }] : []),
+		{ title: "Integrations", lines: model.statuses.length
+			? model.statuses.map((status) => theme.fg(ROLE.STATUS, sanitizeStatus(status)))
+			: [label("No status reported")] },
 	];
 	// Pre-wrap values before indenting so Unicode/ANSI continuation lines keep
 	// the same inset without consuming the card's right border.

package/lib/shell-card.ts

@@ -60,12 +60,8 @@ function bodyLines(card: Card, innerWidth: number): string[] {
 	return card.body.flatMap((paragraph) => (paragraph === "" ? [""] : wrapTextWithAnsi(paragraph, innerWidth)));
 }
 
-// The left rail, corners included, carries the tone at full strength; the
-// rest of the frame stays in the theme's border color, so the state reads from the rail.
-const FRAME_ROLE = "border";
-
-function soft(theme: CardTheme, _tone: CardTone, text: string): string {
-	return theme.fg(FRAME_ROLE, text);
+function frame(theme: CardTheme, tone: CardTone, text: string): string {
+	return theme.fg(TONE_ROLE[tone], text);
 }
 
 export function cardTop(card: Card, theme: CardTheme, width: number, hint?: string): string {
@@ -74,7 +70,7 @@ export function cardTop(card: Card, theme: CardTheme, width: number, hint?: stri
 	if (targetWidth < 5) {
 		const left = theme.fg(TONE_ROLE[card.tone], "╭");
 		if (targetWidth === 1) return left;
-		return left + soft(theme, card.tone, `${rule(targetWidth - 2)}╮`);
+		return left + frame(theme, card.tone, `${rule(targetWidth - 2)}╮`);
 	}
 
 	const title = titleText(card, theme);
@@ -86,7 +82,7 @@ export function cardTop(card: Card, theme: CardTheme, width: number, hint?: stri
 	const styledTitleWidth = title.width <= titleWidth ? title.width : visibleWidth(styledTitle);
 	const fill = rule(targetWidth - styledTitleWidth - 5 - hintWidth);
 	const tail = shownHint ? ` ${theme.fg(HINT_ROLE, shownHint)} ` : "";
-	return theme.fg(TONE_ROLE[card.tone], "╭") + soft(theme, card.tone, "─ ") + styledTitle + soft(theme, card.tone, ` ${fill}`) + tail + soft(theme, card.tone, "╮");
+	return theme.fg(TONE_ROLE[card.tone], "╭") + frame(theme, card.tone, "─ ") + styledTitle + frame(theme, card.tone, ` ${fill}`) + tail + frame(theme, card.tone, "╮");
 }
 
 export function cardLine(text: string, tone: CardTone, theme: CardTheme, width: number): string {
@@ -94,13 +90,13 @@ export function cardLine(text: string, tone: CardTone, theme: CardTheme, width:
 	if (targetWidth === 0) return "";
 	const left = theme.fg(TONE_ROLE[tone], "│");
 	if (targetWidth === 1) return left;
-	if (targetWidth === 2) return left + soft(theme, tone, "│");
-	if (targetWidth === 3) return `${left} ${soft(theme, tone, "│")}`;
+	if (targetWidth === 2) return left + frame(theme, tone, "│");
+	if (targetWidth === 3) return `${left} ${frame(theme, tone, "│")}`;
 
 	const innerWidth = targetWidth - FRAME_COLUMNS;
 	const clipped = innerWidth === 0 ? "" : truncateToWidth(text, innerWidth, "…");
 	const padding = " ".repeat(Math.max(0, innerWidth - visibleWidth(clipped)));
-	return `${left} ${clipped}${padding} ${soft(theme, tone, "│")}`;
+	return `${left} ${clipped}${padding} ${frame(theme, tone, "│")}`;
 }
 
 export function cardBottom(tone: CardTone, theme: CardTheme, width: number): string {
@@ -108,7 +104,7 @@ export function cardBottom(tone: CardTone, theme: CardTheme, width: number): str
 	if (targetWidth === 0) return "";
 	const left = theme.fg(TONE_ROLE[tone], "╰");
 	if (targetWidth === 1) return left;
-	return left + soft(theme, tone, `${rule(targetWidth - 2)}╯`);
+	return left + frame(theme, tone, `${rule(targetWidth - 2)}╯`);
 }
 
 export function cardInnerWidth(width: number): number {

package/lib/shell-changes.ts

@@ -27,6 +27,7 @@ export interface ChangesModel {
 	files: ChangedFile[];
 	added: number;
 	deleted: number;
+	notice?: string;
 }
 
 export interface ChangesSnapshot {
@@ -117,7 +118,7 @@ export function changesModel(changed: ChangedFile[]): ChangesModel {
 
 export function changesSummary(model: ChangesModel): string {
 	const noun = model.files.length === 1 ? "file" : "files";
-	return `${model.files.length} ${noun} · +${model.added} −${model.deleted}${model.files.some(file => file.countsUnavailable) ? " · partial counts" : ""}`;
+	return `${model.files.length} ${noun} · +${model.added} −${model.deleted}${model.files.some(file => file.countsUnavailable) ? " · partial counts" : ""}${model.notice ? " · capture limit reached" : ""}`;
 }
 
 // One line: summary, the files joined by dots, and the command pushed to
@@ -126,7 +127,7 @@ export function renderChangesWidget(model: ChangesModel, theme: ChangesTheme, wi
 	if (model.files.length === 0) return [];
 	const noun = model.files.length === 1 ? "file" : "files";
 	const dot = theme.fg("muted", "·");
-	const head = `${theme.fg("accent", WIDGET_GLYPH)} ${theme.fg("text", `${model.files.length} ${noun}`)} ${dot} ${theme.fg("success", `+${model.added}`)} ${theme.fg("error", `−${model.deleted}`)}${model.files.some(file => file.countsUnavailable) ? " · partial counts" : ""}`;
+	const head = `${theme.fg("accent", WIDGET_GLYPH)} ${theme.fg("text", `${model.files.length} ${noun}`)} ${dot} ${theme.fg("success", `+${model.added}`)} ${theme.fg("error", `−${model.deleted}`)}${model.files.some(file => file.countsUnavailable) ? " · partial counts" : ""}${model.notice ? ` ${dot} ${theme.fg("warning", "capture limit reached")}` : ""}`;
 	const hint = theme.fg("dim", CHANGES_COMMAND);
 	const list = model.files.map((file) => theme.fg("muted", file.path)).join(` ${dot} `);
 	const left = `${head} ${dot} ${list}`;

package/lib/shell-prompt.ts

@@ -23,9 +23,24 @@ const PETAL_TONE = {
 
 export type PetalTone = (typeof PETAL_TONE)[keyof typeof PETAL_TONE];
 
-// The Gentle themes map these to the rose ramp: active pink, rose, soft
-// rose, deep pink. The spin walks the ramp one shade per frame.
-const PETAL_TONE_FRAMES = [PETAL_TONE.BRIGHT, PETAL_TONE.ROSE, PETAL_TONE.SOFT, PETAL_TONE.DEEP] as const;
+// Keep Pi's original loader cadence while carrying the banner's reflected-light
+// language into the compact working labels. The highlight enters before the
+// word, crosses it as a soft symmetric wave, then exits before wrapping.
+export const SHELL_PULSE_MS = 80;
+export const SHELL_SCANNER_STEPS = 15;
+const SCANNER_ENTRY_OFFSET = 3;
+
+/** Banner-style reflected-light wave across text; foreground only. */
+export function scanWorkingText(text: string, tick: number, fg: (role: string, text: string) => string): string {
+	const phase = ((Math.floor(tick) % SHELL_SCANNER_STEPS) + SHELL_SCANNER_STEPS) % SHELL_SCANNER_STEPS;
+	const head = phase - SCANNER_ENTRY_OFFSET;
+	return Array.from(text, (char, index) => {
+		const distance = Math.abs(head - index);
+		const role = distance === 0 ? "borderAccent" : distance === 1 ? "accent" : distance === 2 ? "thinkingHigh" : "muted";
+		return fg(role, char);
+	}).join("");
+}
+const PETAL_TONE_FRAMES = [PETAL_TONE.DEEP, PETAL_TONE.SOFT, PETAL_TONE.ROSE, PETAL_TONE.BRIGHT, PETAL_TONE.ROSE, PETAL_TONE.SOFT, PETAL_TONE.DEEP, PETAL_TONE.DEEP] as const;
 
 export interface PromptFrameOptions {
 	state: PromptState;
@@ -46,7 +61,7 @@ const FAKE_CURSOR = "\x1b[7m \x1b[0m";
 const SCROLL_INDICATOR = /[↑↓] \d+ more/;
 const STATE_LABEL: Record<PromptState, string | undefined> = {
 	[PROMPT_STATE.IDLE]: undefined,
-	[PROMPT_STATE.WORKING]: "working",
+	[PROMPT_STATE.WORKING]: "working…",
 	[PROMPT_STATE.QUEUED]: "queued",
 };
 
@@ -71,13 +86,15 @@ function rule(length: number): string {
 
 function topRule(width: number, options: PromptFrameOptions, indicator: string | undefined): string {
 	const label = indicator ?? STATE_LABEL[options.state];
+	const scanning = options.state === PROMPT_STATE.WORKING;
 	const glyph = petalGlyph(options.state, options.tick);
 	const petal = options.fg(petalTone(options.state, options.tick), options.bold ? options.bold(glyph) : glyph);
-	const labelText = label ? ` ${options.fg(LABEL_ROLE, label)}` : "";
-	const labelWidth = label ? label.length + 1 : 0;
-	const fill = width - 3 - visibleWidth(glyph) - labelWidth - 1 - 1;
+	const paintedLabel = label && scanning && !indicator ? scanWorkingText(label, options.tick, options.fg) : label ? options.fg(LABEL_ROLE, label) : "";
+	const title = [petal, paintedLabel].filter(Boolean).join(" ");
+	const titleWidth = visibleWidth(glyph) + (label ? visibleWidth(label) + (glyph ? 1 : 0) : 0);
+	const fill = width - titleWidth - 5;
 	if (fill < 0) return options.borderColor(`╭${rule(width - 2)}╮`);
-	return options.borderColor("╭─ ") + petal + labelText + options.borderColor(` ${rule(fill)}╮`);
+	return options.borderColor("╭─ ") + title + options.borderColor(` ${rule(fill)}╮`);
 }
 
 function bottomRule(width: number, options: PromptFrameOptions, indicator: string | undefined): string {

package/lib/shell-sidebar-banner.ts

@@ -2,10 +2,10 @@ import { visibleWidth } from "@earendil-works/pi-tui";
 import type { ShellBarTheme } from "./shell-bar.ts";
 
 export function renderSidebarBanner(theme: ShellBarTheme, width: number): string[] {
-	const label = "✿ Gentle-Pi ✿";
+	const label = "✿ Gentle Shell ✿";
 	const space = width - visibleWidth(label);
 	if (space < 0) return [];
 	// Gentleman's accent is pink; card titles use a separate champagne role.
-	const title = theme.fg("accent", "✿") + " " + theme.fg("text", "Gentle-Pi") + " " + theme.fg("accent", "✿");
+	const title = theme.fg("accent", "✿") + " " + theme.fg("text", "Gentle Shell") + " " + theme.fg("accent", "✿");
 	return [" ".repeat(Math.floor(space / 2)) + title + " ".repeat(Math.ceil(space / 2))];
 }

package/lib/shell-sidebar-layout.ts

@@ -134,7 +134,7 @@ export function installSidebar(tui: TUI, theme: ShellBarTheme): () => void {
 		}
 		try {
 			const contentWidth = scroll.getContentWidth(RAIL_WIDTH);
-			const sections = ["footer", "changes", "agents", "todo"].map((key) => {
+			const sections = ["footer", "agents", "todo"].map((key) => {
 				const component = state.parts.get(key);
 				const lines = [...(component?.render(contentWidth - RAIL_PADDING * 2) ?? [])];
 				while (lines.length && lines[lines.length - 1]?.trim() === "") lines.pop();
@@ -171,7 +171,10 @@ export function installSidebar(tui: TUI, theme: ShellBarTheme): () => void {
 			if (roots.has(root)) return;
 			const original = root[NODE]!;
 			const descriptor = Object.getOwnPropertyDescriptor(root, NODE);
-			const left = { render: (width: number) => root.render(width), invalidate() {}, [NODE]: () => original.call(root) };
+			// Fullscreen gives this stretched stack an explicit viewport height.
+			// Its intrinsic-height probe is unused; real painting traverses NODE.
+			// Delegating that probe to root.render would render the transcript twice.
+			const left = { render: () => [], invalidate() {}, [NODE]: () => original.call(root) };
 			const replacement = () => {
 				if (!prepare(tui.terminal.columns, root)) return original.call(root);
 				const current = prepared!;