@iowarp/clio-coder 0.4.4 → 0.4.6

package/src/interactive/interactive-presentation.ts

@@ -16,7 +16,8 @@ import { type ProvidersContract, resolveModelRuntimeCapabilitiesForProviders } f
 import type { ResourcesContract } from "../domains/resources/index.js";
 import { ceilChars, contentChars } from "../domains/session/context-accounting.js";
 import type { SessionContract, TaskBoardSnapshot } from "../domains/session/index.js";
-import type { Component, TUI } from "../engine/tui.js";
+import type { UserTasksStore } from "../domains/user-tasks/store.js";
+import type { Component, ScrollView, TUI } from "../engine/tui.js";
 import type { ChatLoop, ChatLoopEvent } from "./chat-loop.js";
 import { type ChatPanel, createChatPanel } from "./chat-panel.js";
 import { type CoalescingChatRenderer, createCoalescingChatRenderer } from "./chat-renderer.js";
@@ -32,7 +33,7 @@ import { createNotificationCenter, type NotificationCenter } from "./footer/noti
 import { getActiveRenderTrace } from "./interactive-shell.js";
 import type { InteractiveNoticeLevel } from "./interactive-subscriptions.js";
 import { type ClioKeybindingManager, createKeybindingManager } from "./keybinding-manager.js";
-import { buildLayout } from "./layout.js";
+import { buildLayout, preserveTranscriptScroll } from "./layout.js";
 import type { SessionTranscript } from "./session-transcript.js";
 import { createSlashCommandAutocompleteProvider } from "./slash-autocomplete.js";
 import { parseSlashCommand, type RunIo } from "./slash-commands.js";
@@ -93,6 +94,7 @@ export interface InteractivePresentationDeps {
 	session?: Pick<SessionContract, "current">;
 	getSessionId?: () => string | null;
 	getTaskBoard?: () => TaskBoardSnapshot | null;
+	userTasks?: Pick<UserTasksStore, "snapshot">;
 	getTaskMemoryStatus?: () => TaskMemoryOperatorStatus;
 	getTaskMemorySeedOffer?: () => { source: string; count: number } | null;
 	getContextState?: (cwd?: string) => ContextState;
@@ -144,6 +146,8 @@ export interface InteractivePresentation {
 	chatRenderer: CoalescingChatRenderer;
 	io: RunIo;
 	root: Component;
+	changeOutputStyle(mutation: () => void): void;
+	setLocalBashRunning(running: boolean): void;
 	getObservabilitySnapshot(): ObservabilitySnapshot;
 	/** Fold one raw chat event into the ephemeral throughput shown only while this turn is active. */
 	recordChatEvent(event: ChatLoopEvent): void;
@@ -231,11 +235,8 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 	});
 	const renderTrace = getActiveRenderTrace();
 	const chatPanel = factories.createChatPanel({
-		getToolExpandKey: () => {
-			const first = keybindings.getKeys("clio-coder.tool.expand")[0];
-			return typeof first === "string" && first.length > 0 ? first : undefined;
-		},
-		getOutputVerbosity: () => deps.getSettings?.().interface.outputDetail ?? "default",
+		getOutputStyle: () => deps.getSettings?.().interface.outputDetail ?? "standard",
+		getTerminalRows: () => process.stdout.rows ?? 40,
 		...(renderTrace ? { onRenderMetrics: (metrics) => renderTrace.recordPanelRender(metrics) } : {}),
 	});
 	const followUpQueuePanel = factories.createFollowUpQueuePanel({
@@ -357,10 +358,21 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		);
 	};
 
+	let localBashStartedAt: number | null = null;
 	const footerDeps: FooterDashboardDeps = {
 		providers: deps.providers,
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
-		getAgentStatus: () => statusController.current(),
+		getAgentStatus: () => {
+			const status = statusController.current();
+			if (localBashStartedAt === null || (status.phase !== "idle" && status.phase !== "ended")) return status;
+			return {
+				...status,
+				phase: "tool_running",
+				since: localBashStartedAt,
+				toolStartedAt: localBashStartedAt,
+				tool: { toolName: "bash", toolPreview: "local shell" },
+			};
+		},
 		getTerminalColumns: () => deps.terminal.columns,
 		getSessionTokens: () => observabilitySnapshot.session.tokens,
 		getTokenThroughput: () =>
@@ -471,13 +483,19 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 					label: skill.name,
 					description: skill.description,
 				})),
-			tasks: async () =>
-				(deps.getTaskBoard?.()?.tasks ?? []).map((task) => ({
-					id: task.id,
-					value: task.id,
-					label: task.title,
-					description: task.status,
-				})),
+			tasks: async ({ subcommand }) =>
+				(deps.userTasks?.snapshot() ?? [])
+					.filter((task) =>
+						subcommand === "hand"
+							? task.status === "open"
+							: task.status === "open" || task.status === "handed" || task.status === "picked",
+					)
+					.map((task) => ({
+						id: task.id,
+						value: task.id,
+						label: task.title,
+						description: task.status,
+					})),
 			// Other slots remain empty when this presentation has no read-only catalog for them.
 		},
 	});
@@ -525,6 +543,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 				},
 			}
 		: followUpQueuePanel;
+	let transcriptView: ScrollView | undefined;
 	const root = factories.buildLayout(
 		{
 			banner,
@@ -536,6 +555,9 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		{
 			mode: settings.interface?.mode ?? "regular",
 			fullscreenScrollbar: settings.interface?.fullscreenScrollbar ?? "auto",
+			onTranscript: (view) => {
+				transcriptView = view;
+			},
 		},
 	);
 	deps.mount?.(root, editor);
@@ -545,7 +567,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		deps.clearScheduledInterval ??
 		((handle: PresentationTickerHandle): void => clearInterval(handle as ReturnType<typeof setInterval>));
 	const footerTicker = scheduleInterval(() => {
-		const statusActive = statusController.current().phase !== "idle";
+		const statusActive = statusController.current().phase !== "idle" || localBashStartedAt !== null;
 		if (!deps.chat.isStreaming() && !statusActive && !footer.isExpanded()) return;
 		footer.refresh();
 		requestRender();
@@ -610,6 +632,13 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		chatRenderer,
 		io,
 		root,
+		setLocalBashRunning(running) {
+			localBashStartedAt = running ? Date.now() : null;
+			footer.refresh();
+			requestRender();
+		},
+		changeOutputStyle: (mutation) =>
+			chatRenderer.mutate(() => preserveTranscriptScroll(transcriptView, deps.terminal.columns, mutation), "output-style"),
 		getObservabilitySnapshot: () => observabilitySnapshot,
 		recordChatEvent,
 		recordToolStart: (toolCallId, toolName) => {

package/src/interactive/interactive-slash-runtime.ts

@@ -64,7 +64,7 @@ export interface InteractiveSlashSubmitExpansion {
 }
 
 type SlashChat = Pick<ChatLoop, "clearSkillSurface" | "getSessionId" | "isStreaming" | "submit">;
-type SlashChatPanel = Pick<ChatPanel, "appendReplayBlock" | "appendUser" | "clearFoldOverrides">;
+type SlashChatPanel = Pick<ChatPanel, "appendReplayBlock" | "appendUser">;
 type UserTurnStatus = import("./chat-panel.js").UserTurnStatus;
 type SlashResources = Pick<ResourcesContract, "prompts" | "expandPromptTemplate" | "reload">;
 type SlashExtensions = Pick<ExtensionsContract, "list">;
@@ -75,6 +75,7 @@ export interface InteractiveSlashRuntimeDeps {
 	io: RunIo;
 	bus: SafeEventBus;
 	dispatch: DispatchContract;
+	getDecisionBoard?: SlashCommandContext["getDecisionBoard"];
 	providers: ProvidersContract;
 	chat: SlashChat;
 	chatPanel: SlashChatPanel;
@@ -177,7 +178,6 @@ export interface InteractiveSlashRuntime {
 }
 
 /** Owns slash-command context construction and its asynchronous command state. */
-const OUTPUT_VERBOSITIES: ReadonlyArray<ClioSettings["interface"]["outputDetail"]> = ["minimal", "default", "verbose"];
 
 /** Thinking capability of the active orchestrator target and model, or null when unresolved. */
 export function resolveThinkingCapability(
@@ -380,6 +380,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 			});
 		},
 		dispatch: deps.dispatch,
+		...(deps.getDecisionBoard ? { getDecisionBoard: deps.getDecisionBoard } : {}),
 		bus: deps.bus,
 		...(deps.agents
 			? { getAgentRoleFacts: agentRoleFactsResolver((agentId: string) => deps.agents?.getSpec(agentId) ?? null) }
@@ -464,7 +465,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 			if (!match) {
 				return { status: "unsupported", level, supported: supported.map(labelFor) };
 			}
-			// Session scope, like /output: onSetThinkingLevel writes the level
+			// Session scope, like Alt+O: onSetThinkingLevel writes the level
 			// through to settings.yaml as the new default, which a slash command
 			// has no mandate to do.
 			if (deps.commitSetting) {
@@ -506,42 +507,6 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 					if (selected) dispatchSlashCommand({ kind: "thinking-set", level: selected.value }, context);
 				});
 		},
-		setOutputVerbosity: (verbosity) => {
-			if (!deps.getSettings || !(deps.commitSetting || deps.writeSettings)) return { status: "unavailable" };
-			const requested = verbosity.trim().toLowerCase();
-			const match = OUTPUT_VERBOSITIES.find((candidate) => candidate === requested);
-			if (!match) return { status: "unsupported", verbosity, supported: OUTPUT_VERBOSITIES };
-			const next = structuredClone(deps.getSettings()) as ClioSettings;
-			next.interface.outputDetail = match;
-			// Session scope: /output changes this session and leaves settings.yaml
-			// alone. Saving it as the default is what Settings → Terminal is for.
-			if (deps.commitSetting) deps.commitSetting("interface.outputDetail", next, "session");
-			else deps.writeSettings?.(next);
-			// `/output` is also the explicit reset action for transcript folds. Do
-			// this even when the requested level already matches the current one;
-			// the render-time change detector cannot observe a same-value command.
-			deps.chatPanel.clearFoldOverrides();
-			deps.refreshFooter();
-			return { status: "applied", verbosity: match };
-		},
-		openOutputPicker: () => {
-			void deps
-				.openAskUser([
-					{
-						question: "Choose transcript detail for this session.",
-						header: "Output",
-						options: OUTPUT_VERBOSITIES.map((value) => ({
-							label: `${value[0]?.toUpperCase()}${value.slice(1)}`,
-						})),
-					},
-				])
-				.then((result) => {
-					if (result.cancelled) return;
-					const answer = result.answers[0]?.answer.toLowerCase();
-					const selected = OUTPUT_VERBOSITIES.find((value) => value === answer);
-					if (selected) dispatchSlashCommand({ kind: "output-set", verbosity: selected }, context);
-				});
-		},
 		openModel: deps.openModel,
 		providers: deps.providers,
 		applyModelRef: (ref) => {
@@ -593,7 +558,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 				// operator overrides, and rendered at a stable width. HTML converts
 				// the resulting ANSI presentation to inline styles; Markdown keeps the
 				// prior plain-text fenced transcript.
-				const exportPanel = createChatPanel({ unboundedToolBodies: true, getOutputVerbosity: () => "verbose" });
+				const exportPanel = createChatPanel({ unboundedToolBodies: true, getOutputStyle: () => "detailed" });
 				// Scoped to the leaf the session is on, the same way /resume replays
 				// (issue #107): with a /tree pin persisted and not yet extended, the
 				// file still holds the abandoned branch after the pin, and an unscoped

package/src/interactive/layout.ts

@@ -13,6 +13,7 @@ export interface LayoutParts {
 export interface LayoutOptions {
 	mode?: TuiMode;
 	fullscreenScrollbar?: ScrollViewScrollbar;
+	onTranscript?: (view: ScrollView) => void;
 }
 
 export interface FullscreenLayout {
@@ -20,10 +21,7 @@ export interface FullscreenLayout {
 	transcript: ScrollView;
 }
 
-function buildFullscreenLayout(
-	parts: LayoutParts,
-	options: Pick<LayoutOptions, "fullscreenScrollbar"> = {},
-): FullscreenLayout {
+function buildFullscreenLayout(parts: LayoutParts, options: LayoutOptions = {}): FullscreenLayout {
 	const document = new Container();
 	document.addChild(parts.banner);
 	document.addChild(parts.chat);
@@ -33,8 +31,10 @@ function buildFullscreenLayout(
 		primary: true,
 		overscroll: "chain",
 		scrollbar: options.fullscreenScrollbar ?? "auto",
-		scrollbarStyle: () => theme.fg("frameStrong", GLYPH.barFull),
+		scrollbarTrackStyle: (text) => theme.fg("frame", text),
+		scrollbarThumbStyle: () => theme.fg("frameStrong", GLYPH.barFull),
 	});
+	options.onTranscript?.(transcript);
 	const dock = new VStack();
 	if (parts.pending) dock.addChild(parts.pending, { shrink: 1, minSize: 0 });
 	dock.addChild(parts.editor, { shrink: 1, minSize: 3 });
@@ -55,3 +55,29 @@ export function buildLayout(parts: LayoutParts, options: LayoutOptions = {}): Co
 	root.addChild(parts.footer);
 	return root;
 }
+
+/** Keep the nearest surviving text at the viewport when a preset changes row counts. */
+export function preserveTranscriptScroll(view: ScrollView | undefined, width: number, mutation: () => void): void {
+	if (!view || view.isFollowingEnd) {
+		mutation();
+		return;
+	}
+	const top = view.scrollTop;
+	const before = view.render(width);
+	mutation();
+	const after = view.render(width);
+	for (let row = top; row < Math.min(before.length, top + view.viewportHeight); row++) {
+		const anchor = before[row];
+		if (!anchor?.trim()) continue;
+		let match = -1;
+		for (let index = 0; index < after.length; index++) {
+			if (after[index] === anchor && (match < 0 || Math.abs(index - row) < Math.abs(match - row))) match = index;
+		}
+		if (match >= 0) {
+			view.updateLayout(after.length, view.viewportHeight, () => {});
+			view.scrollTo(Math.max(0, match - (row - top)), { disableFollow: true });
+			return;
+		}
+	}
+	view.scrollTo(top, { disableFollow: true });
+}

package/src/interactive/model-session-replay.ts

@@ -16,6 +16,6 @@ export function buildModelReplayAgentMessagesFromTurns(
 	options: RehydrateChatPanelOptions = {},
 ): AgentMessage[] {
 	const activeLeafTurnId = options.activeLeafTurnId ?? options.uptoTurnId;
-	const projected = projectWorkingSet(entries, foldWorkingSet(entries, activeLeafTurnId));
-	return buildReplayAgentMessagesFromTurns(projected, options);
+	const projected = projectWorkingSet(entries, foldWorkingSet(entries, activeLeafTurnId), activeLeafTurnId);
+	return buildReplayAgentMessagesFromTurns(projected, { ...options, skillContextEntries: entries });
 }

package/src/interactive/overlay-frame.ts

@@ -527,6 +527,7 @@ export function showClioOverlayFrame(
 		unfocus: (unfocusOptions?: OverlayUnfocusOptions): void =>
 			unfocusOptions ? handle.unfocus(unfocusOptions) : handle.unfocus(),
 		isFocused: (): boolean => handle.isFocused(),
+		getBounds: () => handle.getBounds(),
 	};
 }
 

package/src/interactive/overlay-general-openers.ts

@@ -19,6 +19,7 @@ import type { SessionMeta } from "../domains/session/index.js";
 import { foldSessionArtifacts } from "../domains/session/session-artifacts.js";
 import { foldSessionTaskHistory } from "../domains/session/task-board.js";
 import { filterEntriesToActivePath } from "../domains/session/tree/active-path.js";
+import { formatUserTaskHandoff } from "../domains/user-tasks/handoff.js";
 import type { UserTasksStore } from "../domains/user-tasks/store.js";
 import type { TUI } from "../engine/tui.js";
 import { type OpenContextOverlayOptions, openContextOverlay } from "./context-overlay.js";
@@ -40,12 +41,13 @@ import {
 import { formatDecisionCorrectionTurn, openDecisionsOverlay } from "./overlays/decisions.js";
 import { openFleetRunApprovalOverlay } from "./overlays/fleet-run-approval.js";
 import { openSideQuestionOverlay } from "./overlays/side-question.js";
-import { type ContextClearCommandOptions, formatUserTaskHandoff } from "./slash-commands.js";
+import type { ContextClearCommandOptions } from "./slash-commands.js";
 import { openTasksOverlay } from "./tasks-overlay.js";
 import { type ArtifactProviderDeps, createDefaultArtifactProviders } from "./view/artifacts.js";
 import { openViewOverlay } from "./view/view-overlay.js";
 
 export interface OverlayGeneralOpenersDeps {
+	readTranscript?: ArtifactProviderDeps["readTranscript"];
 	tui: TUI;
 	transitions: OverlayTransitions;
 	observability: ObservabilityContract;
@@ -318,6 +320,7 @@ export function createOverlayGeneralOpeners(deps: OverlayGeneralOpenersDeps): Ov
 				dispatch: deps.dispatch,
 				sessionMeta: deps.getSessionMeta(),
 				readSessionEntries: deps.readSessionEntries,
+				readTranscript: deps.readTranscript,
 			}),
 			...(initialFilter ? { initialFilter } : {}),
 			notice: deps.notify,
@@ -487,6 +490,7 @@ export function createOverlayGeneralOpeners(deps: OverlayGeneralOpenersDeps): Ov
 			fleetRootId,
 			dispatch: deps.dispatch,
 			agents: { getSpec: (agentId) => agents.getSpec(agentId) },
+			...(deps.getDecisionBoard ? { getDecisionBoard: deps.getDecisionBoard } : {}),
 			attributionEnabled: deps.getSettings?.().integrations.git.commitAttribution ?? true,
 			vars: preview.vars,
 			onStepDispatched: (event) => {

package/src/interactive/overlay-lifecycle.ts

@@ -399,6 +399,7 @@ export function createOverlayLifecycle(deps: OverlayLifecycleRuntimeDeps): Overl
 
 	const scheduling = deps.app.scheduling;
 	const overlayGeneralOpeners = createOverlayGeneralOpeners({
+		readTranscript: () => chatPanel.inspectionArtifacts(),
 		tui,
 		transitions: overlayTransitions,
 		observability: deps.app.observability,

package/src/interactive/overlay-session-lifecycle.ts

@@ -1,3 +1,4 @@
+import { editTextExternally, resolveExternalEditor } from "../core/external-editor.js";
 import { resolveSessionCwd } from "../domains/session/cwd-fallback.js";
 import type { DecisionLedgerEntry } from "../domains/session/entries.js";
 import {
@@ -18,7 +19,6 @@ import type { ChatLoop } from "./chat-loop.js";
 import type { ChatPanel } from "./chat-panel.js";
 import { rehydrateChatPanelFromTurns } from "./chat-renderer.js";
 import { emitCommandNotice } from "./command-fallbacks.js";
-import { editTextExternally, resolveExternalEditor } from "./external-editor.js";
 import type { InteractiveNoticeLevel } from "./interactive-subscriptions.js";
 import { buildModelReplayAgentMessagesFromTurns } from "./model-session-replay.js";
 import type { OverlayTransitions } from "./overlay-transitions.js";
@@ -304,6 +304,12 @@ export function createOverlaySessionLifecycle(deps: OverlaySessionLifecycleDeps)
 					}
 					deps.resetTranscript();
 					replayFork(forkedSessionId, parentTurnId, session);
+					emitCommandNotice(
+						deps.getSlashNotice(),
+						"info",
+						"fork",
+						"Conversation forked. Workspace files were not rewound; existing edits remain.",
+					);
 				} catch (error) {
 					deps.stderr(`[/fork] fork failed: ${error instanceof Error ? error.message : String(error)}\n`);
 				}

package/src/interactive/overlays/ask-user.ts

@@ -1270,6 +1270,7 @@ export function openAskUserOverlay(tui: TUI, deps: OpenAskUserOverlayDeps): AskU
 		focus: () => handle?.focus(),
 		unfocus: (options) => (options ? handle?.unfocus(options) : handle?.unfocus()),
 		isFocused: () => handle?.isFocused() ?? false,
+		getBounds: () => handle?.getBounds(),
 		ask: (questions, presentation) => view.begin(questions, presentation),
 		cancel: () => view.cancel(),
 		close,

package/src/interactive/overlays/message-picker.ts

@@ -150,7 +150,7 @@ export function openMessagePickerOverlay(tui: TUI, deps: OpenMessagePickerOverla
 		anchor: "center",
 		width: MESSAGE_PICKER_OVERLAY_WIDTH,
 		markerId: "message-picker",
-		title: "Fork",
+		title: "Fork conversation; workspace files stay unchanged",
 		footerHint: rows.length > 0 ? buildHint([{ key: "Enter", verb: "select" }]) : buildHint([]),
 	});
 }

package/src/interactive/overlays/settings.ts

@@ -229,7 +229,7 @@ export const SETTINGS_LABELS_BY_ID = {
 	"retry.maxDelayMs": "Max delay (ms)",
 	"retry.streamStallMs": "Stream stall timeout (ms)",
 	"terminal.showTerminalProgress": "Terminal progress badges",
-	"terminal.outputVerbosity": "Output detail",
+	"terminal.outputVerbosity": "Output style",
 	"terminal.tuiMode": "TUI mode",
 	"terminal.fullscreenScrollbar": "Fullscreen scrollbar",
 	"terminal.smoothStreaming": "Smooth streaming",
@@ -514,7 +514,8 @@ const SETTINGS_HELP_BY_ID: Partial<Record<EditableSettingId, string>> = {
 		"Written by the confirm flow, not by hand, because confirming a remote here would be the record confirming itself. Sync refuses with library_remote_unconfirmed until this equals library.remote. Default: blank.",
 	"library.sync":
 		"Off means `clio-coder library sync` and `push` refuse before touching the network, whatever the remote says. Legal values: true, false · default: false.",
-	"budget.concurrency": "auto sizes to your machine. A fixed number caps how many workers run at once.",
+	"budget.concurrency":
+		"auto allows four local workers. A fixed number caps how many workers run at once; the default is one.",
 	"skills.trustProjectCompatRoots":
 		"Project roots like .claude/skills and .codex/skills are untrusted by default; enabling exposes them to the model.",
 	"attribution.gitCommits":
@@ -550,7 +551,7 @@ const SETTINGS_HELP_BY_ID: Partial<Record<EditableSettingId, string>> = {
 	"watchdog.cadenceToolCalls":
 		"Mid-turn firing is how scope drift becomes visible before the turn ends. Leave blank and the watchdog fires at turn end only.",
 	keybindings:
-		"Renderer controls: Alt+O newest tool or worker details, Ctrl+Alt+O or Alt+Shift+O all of them, Alt+P live tool output, Alt+R latest reasoning, Ctrl+Alt+R or Alt+Shift+R all reasoning. Override these in settings.yaml or use /help.",
+		"Alt+O cycles Output style: Compact, Standard, Detailed. Use /view for full reasoning and action details. Shift+Tab changes model thinking effort.",
 };
 
 /** Per-value meaning, surfaced for the current value of an enum knob. */
@@ -623,9 +624,9 @@ const SETTINGS_VALUE_HELP_BY_ID: Partial<Record<EditableSettingId, Record<string
 		false: "no terminal progress badges",
 	},
 	"terminal.outputVerbosity": {
-		minimal: "quiet transcript; tools stay to one-line outcomes and reasoning stays folded",
-		default: "balanced transcript; unfold the latest tool, worker, or reasoning block on demand",
-		verbose: "transparent transcript; reasoning, arguments, and live tool output stay visible",
+		compact: "quiet action summaries, answers, and visible failures",
+		standard: "short reasoning and change previews, clear action outcomes",
+		detailed: "larger bounded previews; full content is available in /view",
 	},
 	"terminal.tuiMode": {
 		regular: "preserve terminal scrollback and render the composer below the transcript",
@@ -1923,7 +1924,7 @@ function buildSettingItems(settings: Readonly<ClioSettings>, options?: BuildSett
 			values: ["false", "true"],
 		}),
 		settingItem("terminal.outputVerbosity", terminal.outputDetail, {
-			values: ["minimal", "default", "verbose"],
+			values: ["compact", "standard", "detailed"],
 		}),
 		settingItem("terminal.tuiMode", terminal.mode, {
 			values: ["regular", "fullscreen"],
@@ -2555,7 +2556,7 @@ function applySettingChange(settings: ClioSettings, id: string, value: string):
 			if (value === "true" || value === "false") settings.interface.terminalProgress = value === "true";
 			return;
 		case "terminal.outputVerbosity":
-			if (value === "minimal" || value === "default" || value === "verbose") settings.interface.outputDetail = value;
+			if (value === "compact" || value === "standard" || value === "detailed") settings.interface.outputDetail = value;
 			return;
 		case "terminal.tuiMode":
 			if (value === "regular" || value === "fullscreen") settings.interface.mode = value;

package/src/interactive/renderers/preview.ts

@@ -0,0 +1,16 @@
+import { truncateToWidth } from "../../engine/tui.js";
+import { clioTheme } from "../theme/index.js";
+
+/** Count terminal rows after wrapping, including the inspection hint. */
+export function previewRows(rows: readonly string[], limit: number, width: number, tail = false): string[] {
+	if (rows.length <= limit) return [...rows];
+	if (limit <= 0) return [];
+	const count = Math.max(0, limit - 1);
+	const hint = clioTheme().fg("dim", truncateToWidth(`… ${rows.length - count} rows · /view`, Math.max(1, width)));
+	return tail ? [hint, ...rows.slice(rows.length - count)] : [...rows.slice(0, count), hint];
+}
+
+/** Leave room for the composer and action identity in a short terminal. */
+export function previewBudget(limit: number, terminalRows = 40): number {
+	return Math.min(limit, Math.max(2, Math.floor((terminalRows - 8) / 2)));
+}