@iowarp/clio-coder 0.4.3 → 0.4.5

package/src/interactive/editor-submit.ts

@@ -25,6 +25,8 @@ import {
 } from "./transcript-detail.js";
 
 const EDITOR_BASH_TIMEOUT_MS = 300_000;
+/** Existing bash TERM-to-KILL grace (5s), plus settlement and session append. */
+export const EDITOR_BASH_SHUTDOWN_MS = 6000;
 
 /**
  * Command shapes whose text is put back in the editor after the parser rejects
@@ -125,18 +127,22 @@ export interface EditorSubmitController {
 	restoreQueuedFollowUpsToEditor(): void;
 	hasActiveEditorBash(): boolean;
 	cancelActiveEditorBash(): boolean;
+	/** Stop shell admission, cancel the owned command, and await its persisted result. */
+	shutdownEditorBash(): Promise<void>;
 }
 
 type EditorSteerSubmission = "unhandled" | "accepted" | "rejected";
 
 /** Owns editor submission and the one local bash process attached to it. */
 export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubmitController {
+	let shuttingDown = false;
 	let activeEditorBash: AbortController | null = null;
 	let activeEditorBashSettlement: Promise<void> | null = null;
 
 	const runEditorBash = (text: string): boolean => {
 		const parsed = parseEditorBashCommand(text);
 		if (!parsed) return false;
+		if (shuttingDown) return true;
 		if (deps.chat.isStreaming()) {
 			deps.io.stderr("[bash] response in progress. Press Esc to cancel the active run before running a local command.\n");
 			return true;
@@ -394,12 +400,14 @@ export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubm
 		const literalText = unguardPastedEditorOperator(text);
 		const trimmed = literalText.trim();
 		if (trimmed.length === 0) return;
+		if (shuttingDown) throw new Error("editor is shutting down");
 		signal?.throwIfAborted();
 		deps.collapseLaunchpadBeforeSubmit?.();
 		if (parseEditorBashCommand(text)) {
 			while (deps.chat.isStreaming()) await awaitWithAbort(deps.chat.whenSettled(), signal);
 			while (activeEditorBashSettlement) await awaitWithAbort(activeEditorBashSettlement, signal);
 			signal?.throwIfAborted();
+			if (shuttingDown) throw new Error("editor is shutting down");
 			deps.editor.addToHistory(literalText);
 			runEditorBash(text);
 			deps.ui.requestRender();
@@ -529,6 +537,11 @@ export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubm
 		interruptFromEditor,
 		restoreQueuedFollowUpsToEditor,
 		hasActiveEditorBash: () => activeEditorBash !== null,
+		shutdownEditorBash: async () => {
+			shuttingDown = true;
+			activeEditorBash?.abort();
+			await activeEditorBashSettlement;
+		},
 		cancelActiveEditorBash: () => {
 			if (!activeEditorBash) return false;
 			activeEditorBash.abort();

package/src/interactive/fleet-run-preview.ts

@@ -38,6 +38,7 @@ import {
 } from "../domains/dispatch/execution-role.js";
 import { compileFleetExecutionPlan } from "../domains/dispatch/fleet-plan.js";
 import { preflightWriteBoundaries } from "../domains/dispatch/write-boundary-enforcer.js";
+import { formatUsd } from "./footer/widgets.js";
 
 /** Where a step would run, as the dispatch domain resolves it today. */
 export interface FleetRunPreviewRoute {
@@ -263,7 +264,7 @@ export function compileFleetRunPreview(input: FleetRunPreviewInput): FleetRunPre
 	};
 	if (input.budget) {
 		if (input.budget.verdict === "over" || input.budget.verdict === "at") {
-			diagnostics.push(`budget ceiling crossed: $${budget.currentUsd.toFixed(4)} / $${budget.ceilingUsd.toFixed(4)}`);
+			diagnostics.push(`budget ceiling crossed: ${formatUsd(budget.currentUsd)} / ${formatUsd(budget.ceilingUsd)}`);
 		} else if (contract.budgetUsd !== null) {
 			const remaining = budget.ceilingUsd - budget.currentUsd;
 			if (contract.budgetUsd > remaining) {

package/src/interactive/interactive-application.ts

@@ -3,6 +3,7 @@ import type { ClioSettings } from "../core/config.js";
 import type { SafeEventBus } from "../core/event-bus.js";
 import { expandInlineFileReferencesAsync } from "../core/file-references.js";
 import type { PendingSkillRequest } from "../core/skill-activation.js";
+import { getTerminationCoordinator } from "../core/termination.js";
 import { clioStateDir } from "../core/xdg.js";
 import type { AgentsContract } from "../domains/agents/contract.js";
 import type { ClioKeybinding } from "../domains/config/keybindings.js";
@@ -33,7 +34,7 @@ import { emitCommandNotice } from "./command-fallbacks.js";
 import { appendNotice } from "./command-output.js";
 import { dispatchCouncilThroughRegistry } from "./council-dispatch.js";
 import { createDispatchSteering } from "./dispatch-steering.js";
-import { createEditorSubmitController } from "./editor-submit.js";
+import { createEditorSubmitController, EDITOR_BASH_SHUTDOWN_MS } from "./editor-submit.js";
 import { createInteractiveDesktopNotifications } from "./footer/notifications.js";
 import { createInteractiveEventProjection } from "./interactive-event-projection.js";
 import { createInteractiveInputRuntime } from "./interactive-input-runtime.js";
@@ -228,8 +229,8 @@ export interface InteractiveDeps {
 	onNewSession?: () => void;
 	/**
 	 * Fork from a parent assistant turn picked in /fork. Default wiring
-	 * delegates to session.fork(parentTurnId); the override exists so
-	 * future slices can layer telemetry or settings merging on top.
+	 * delegates to session.fork(parentTurnId); the override exists so a
+	 * host can layer telemetry or settings merging on top.
 	 */
 	onForkSession?: (parentTurnId: string) => void;
 	/**
@@ -583,9 +584,11 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 			: {}),
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
 		...(deps.resources ? { resources: deps.resources } : {}),
+		...(deps.agents ? { agents: deps.agents } : {}),
 		...(deps.session ? { session: deps.session } : {}),
 		...(deps.getSessionId ? { getSessionId: deps.getSessionId } : {}),
 		...(deps.getTaskBoard ? { getTaskBoard: deps.getTaskBoard } : {}),
+		...(deps.userTasks ? { userTasks: deps.userTasks } : {}),
 		...(deps.getTaskMemoryStatus ? { getTaskMemoryStatus: deps.getTaskMemoryStatus } : {}),
 		...(deps.getTaskMemorySeedOffer ? { getTaskMemorySeedOffer: deps.getTaskMemorySeedOffer } : {}),
 		...(deps.getContextState ? { getContextState: deps.getContextState } : {}),
@@ -700,6 +703,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		io,
 		bus: deps.bus,
 		dispatch: deps.dispatch,
+		...(deps.getDecisionBoard ? { getDecisionBoard: deps.getDecisionBoard } : {}),
 		...(deps.session ? { session: deps.session } : {}),
 		providers: deps.providers,
 		chat: deps.chat,
@@ -803,6 +807,9 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		expandSubmit: (text) => expandInteractiveSubmitAsync(text, deps.resources),
 		notify,
 	});
+	// The lease drains the terminal; operator shell ownership outlives that
+	// surface and must settle before the session domain stops, on every exit.
+	getTerminationCoordinator().onDrain(() => editorSubmit.shutdownEditorBash(), { timeoutMs: EDITOR_BASH_SHUTDOWN_MS });
 	editor.onSubmit = editorSubmit.submitEditorText;
 
 	const interactiveTickers = createInteractiveTickers({
@@ -1110,7 +1117,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		steerSelectedDispatch,
 		cancelSelectedDispatch,
 		cancelActiveEditorBash: () => editorSubmit.cancelActiveEditorBash(),
-		isStreaming: () => deps.chat.isStreaming(),
+		isStreaming: () => deps.chat.isStreaming() || deps.chat.turnPreparation().phase === "compacting",
 		cancelActiveRun,
 		editor,
 		editorSubmit,

package/src/interactive/interactive-event-projection.ts

@@ -251,9 +251,10 @@ export function createInteractiveEventProjection(deps: InteractiveEventProjectio
 				typeof event.tokensBefore === "number" &&
 				typeof event.tokensAfter === "number"
 			) {
+				const outcome = event.tokensAfter < event.tokensBefore ? "Reclaimed context" : "Context updated";
 				deps.notify(
 					"info",
-					`[Compaction] Reclaimed context: ${event.tokensBefore} -> ${event.tokensAfter} tokens (${event.stage})`,
+					`[Compaction] ${outcome}: ${event.tokensBefore} -> ${event.tokensAfter} tokens (${event.stage})`,
 					"compaction-notice",
 				);
 			}
@@ -388,6 +389,11 @@ export function createInteractiveEventProjection(deps: InteractiveEventProjectio
 
 	const seenMiddlewareBudgetWarnings = new Set<string>();
 	remainingUnsubscribers.push(
+		deps.bus.on(BusChannels.ExtensionsLoadIssue, (payload) => {
+			if (typeof payload?.message !== "string" || payload.message.trim().length === 0) return;
+			deps.appendTranscriptNotice("warn", payload.message);
+			deps.requestRender();
+		}),
 		deps.bus.on(BusChannels.MiddlewareHookFailed, (payload) => {
 			const notice = middlewareHookFailedSessionNotice(payload, seenMiddlewareBudgetWarnings);
 			if (notice === null) return;

package/src/interactive/interactive-presentation.ts

@@ -2,6 +2,8 @@ import { performance } from "node:perf_hooks";
 import type { ClioSettings } from "../core/config.js";
 import { DEFAULT_SETTINGS } from "../core/defaults.js";
 import type { SafeEventBus } from "../core/event-bus.js";
+import type { AgentsContract } from "../domains/agents/contract.js";
+import { isUserVisibleAgent } from "../domains/agents/spec.js";
 import type { ContextState } from "../domains/context/index.js";
 import type { DispatchContract } from "../domains/dispatch/contract.js";
 import type { TaskMemoryOperatorStatus } from "../domains/memory/index.js";
@@ -12,9 +14,9 @@ import type {
 } from "../domains/observability/index.js";
 import { type ProvidersContract, resolveModelRuntimeCapabilitiesForProviders } from "../domains/providers/index.js";
 import type { ResourcesContract } from "../domains/resources/index.js";
-import { getMarketplaceSkills } from "../domains/resources/skills/marketplace.js";
 import { ceilChars, contentChars } from "../domains/session/context-accounting.js";
 import type { SessionContract, TaskBoardSnapshot } from "../domains/session/index.js";
+import type { UserTasksStore } from "../domains/user-tasks/store.js";
 import type { Component, TUI } from "../engine/tui.js";
 import type { ChatLoop, ChatLoopEvent } from "./chat-loop.js";
 import { type ChatPanel, createChatPanel } from "./chat-panel.js";
@@ -88,9 +90,11 @@ export interface InteractivePresentationDeps {
 	bootPending?: Component;
 	getSettings?: () => Readonly<ClioSettings>;
 	resources?: Pick<ResourcesContract, "skills">;
+	agents?: Pick<AgentsContract, "listSpecs">;
 	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;
@@ -248,13 +252,11 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		bus: deps.bus,
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
 	});
-	// The board settles a finished run on the same sealed receipt the transcript
-	// block reads, so the two surfaces agree on a worker's terminal answer.
-	const dispatchBoardStore = factories.createDispatchBoardStore(
-		deps.bus,
-		() => deps.dispatch.snapshot(),
-		(runId) => readWorkerReceiptFacts(runId),
-	);
+	const unbindRunReaders = deps.observability.bindRunReaders({
+		dispatchSnapshot: () => deps.dispatch.snapshot(),
+		readReceipt: (runId) => readWorkerReceiptFacts(runId),
+	});
+	const dispatchBoardStore = factories.createDispatchBoardStore(deps.observability);
 	const contextActivityStore = factories.createContextActivityStore(deps.bus);
 
 	const footerToolCounts = new Map<string, number>();
@@ -434,10 +436,58 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 	const editor = deps.editor ?? factories.createEditor(deps.tui, editorChrome);
 	editor.focused = true;
 	const autocomplete: AutocompleteProvider = factories.createAutocomplete({
-		listSkills: () => ({
-			installed: deps.resources?.skills(getCwd()).items ?? [],
-			marketplace: getMarketplaceSkills(),
-		}),
+		completionSources: {
+			agents: async () =>
+				(deps.agents?.listSpecs() ?? []).filter(isUserVisibleAgent).map((agent) => ({
+					id: agent.id,
+					value: agent.id,
+					label: agent.id,
+					description: agent.description,
+				})),
+			targets: async () =>
+				deps.providers.list().map(({ target, reason }) => ({
+					id: target.id,
+					value: target.id,
+					label: target.id,
+					description: reason,
+				})),
+			models: async () =>
+				deps.providers.list().flatMap(({ target, discoveredModels, discoveredModelLabels }) =>
+					[
+						...new Set([
+							...(target.defaultModel ? [target.defaultModel] : []),
+							...(target.wireModels ?? []),
+							...discoveredModels,
+						]),
+					].map((model) => ({
+						id: `${target.id}/${model}`,
+						value: model,
+						label: discoveredModelLabels?.[model] ?? model,
+						description: target.id,
+					})),
+				),
+			skills: async () =>
+				(deps.resources?.skills(getCwd()).items ?? []).map((skill) => ({
+					id: skill.name,
+					value: skill.name,
+					label: skill.name,
+					description: skill.description,
+				})),
+			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.
+		},
 	});
 	editor.setAutocompleteProvider(autocomplete);
 
@@ -539,6 +589,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		unsubscribeObservability();
 		contextActivityStore.unsubscribe();
 		dispatchBoardStore.unsubscribe();
+		unbindRunReaders();
 	};
 	const disposeStatus = (): void => {
 		if (statusDisposed) return;

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

@@ -24,6 +24,7 @@ import type { SessionContract, SessionEntry } from "../domains/session/index.js"
 import { foldTaskBoard } from "../domains/session/task-board.js";
 import { filterEntriesToActivePath } from "../domains/session/tree/active-path.js";
 import type { ShareContract } from "../domains/share/index.js";
+import type { UserTaskAcceptance } from "../domains/user-tasks/acceptance.js";
 import type { UserTasksStore } from "../domains/user-tasks/store.js";
 import { stripTerminalSequences } from "../engine/tui.js";
 import type { ImageContent } from "../engine/types.js";
@@ -74,6 +75,7 @@ export interface InteractiveSlashRuntimeDeps {
 	io: RunIo;
 	bus: SafeEventBus;
 	dispatch: DispatchContract;
+	getDecisionBoard?: SlashCommandContext["getDecisionBoard"];
 	providers: ProvidersContract;
 	chat: SlashChat;
 	chatPanel: SlashChatPanel;
@@ -379,6 +381,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) }
@@ -432,7 +435,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 		...(userTasks
 			? {
 					userTasks: {
-						add: (title: string) => userTasks.add(title),
+						add: (title: string, acceptance?: UserTaskAcceptance) => userTasks.add(title, undefined, acceptance),
 						hand: (id: string) => userTasks.hand(id, deps.chat.getSessionId() ?? undefined),
 						done: (id: string) => userTasks.done(id),
 						drop: (id: string) => userTasks.drop(id),

package/src/interactive/layout.ts

@@ -33,7 +33,8 @@ 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),
 	});
 	const dock = new VStack();
 	if (parts.pending) dock.addChild(parts.pending, { shrink: 1, minSize: 0 });

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/oracle.ts

@@ -13,6 +13,7 @@
  */
 
 import type { OracleResult } from "../domains/agents/index.js";
+import { decisionRationale } from "../domains/session/decision-board.js";
 import type { DecisionLedgerEntry } from "../domains/session/entries.js";
 import type { TaskBoardTask } from "../domains/session/task-board.js";
 
@@ -89,12 +90,14 @@ function clamp(text: string, maxBytes: number): { text: string; truncated: boole
 
 /** One decision line. Superseded decisions carry their correction so a reversal is visible. */
 function decisionLine(decision: DecisionLedgerEntry["decisions"][number]): string {
+	const argument = decisionRationale(decision);
+	const details = argument ? `\n  ${argument}` : "";
 	const label = decision.label ? ` (${decision.label})` : "";
 	if (decision.status === "superseded") {
 		const correction = decision.correction ? `; corrected to ${decision.correction}` : "";
-		return `- ${decision.key}${label}: ${decision.value} [superseded${correction}]`;
+		return `- ${decision.key}${label}: ${decision.value} [superseded${correction}]${details}`;
 	}
-	return `- ${decision.key}${label}: ${decision.value}`;
+	return `- ${decision.key}${label}: ${decision.value}${details}`;
 }
 
 function taskLine(task: TaskBoardTask): string {

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,7 +41,7 @@ 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";
@@ -487,6 +488,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-session-lifecycle.ts

@@ -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/fleet-run-approval.ts

@@ -21,6 +21,7 @@ import {
 	wrapTextWithAnsi,
 } from "../../engine/tui.js";
 import type { FleetRunPreview, FleetRunPreviewStep } from "../fleet-run-preview.js";
+import { formatUsd } from "../footer/widgets.js";
 import { buildResponsiveHint, FocusBox, showClioOverlayFrame } from "../overlay-frame.js";
 import { clioTheme, rule } from "../theme/index.js";
 
@@ -83,12 +84,12 @@ function formatFleetRunPreviewStep(step: FleetRunPreviewStep): string {
 	return `agent ${step.stepId}${loop} · ${step.agentId ?? "?"} · ${route}${node}${declaredRoute}${gate}${dynamicPlan} · ${step.scope} · ${formatWriteBoundary(step.writes)}`;
 }
 
-function formatBudgetLine(preview: FleetRunPreview): string {
+export function formatBudgetLine(preview: FleetRunPreview): string {
 	const contract =
 		preview.budget.contractUsd === null
 			? "contract declares no ceiling"
 			: `contract ceiling $${preview.budget.contractUsd.toFixed(2)}`;
-	return `budget: admitted under $${preview.budget.ceilingUsd.toFixed(2)} session ceiling, $${preview.budget.currentUsd.toFixed(4)} spent, ${contract}`;
+	return `budget: admitted under $${preview.budget.ceilingUsd.toFixed(2)} session ceiling, ${formatUsd(preview.budget.currentUsd)} spent, ${contract}`;
 }
 
 /**

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

@@ -25,8 +25,8 @@ const PREVIEW_WIDTH = 60;
  * calls onFork(parentTurnId); the caller wires that through
  * SessionContract.fork(parentTurnId).
  *
- * Phase 12 slice 12b-3 scope: current-session turns only. Multi-session picker
- * lives in a later slice once TreeSnapshot grows a payload preview field.
+ * Scope: current-session turns only. A multi-session picker is not
+ * implemented; it would need TreeSnapshot to carry a payload preview field.
  */
 export interface OpenMessagePickerOverlayDeps {
 	session: SessionContract;
@@ -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

@@ -600,10 +600,10 @@ const SETTINGS_VALUE_HELP_BY_ID: Partial<Record<EditableSettingId, Record<string
 		false: "context is only compacted when you run /context compact",
 	},
 	// `embedded` is a declared rung with no implementation behind it yet; it
-	// runs as `auto` until Clio can own a pane host, and the hint says so.
+	// refuses until Clio can own a pane host, and the hint says so.
 	"panes.enabled": {
 		auto: "detect a herdr session and join it as a guest; no pane host, no panes",
-		embedded: "not implemented yet; behaves as auto (guest mode inside herdr) until Clio can own a pane host",
+		embedded: "not implemented yet; use auto or guest",
 		off: "never detect or open a pane",
 	},
 	"retry.enabled": {

package/src/interactive/overlays/tree-selector.ts

@@ -16,14 +16,14 @@ export const TREE_OVERLAY_WIDTH = 88;
 const VISIBLE_ROWS = 16;
 
 /**
- * /tree navigator overlay. Phase 12 slice 12b-2 behaviors only:
+ * /tree navigator overlay. Behaviors:
  *   - One row per node, indented two spaces per branch level (not per message)
  *   - Shift+T toggles operator-local timestamps on/off
  *   - `e` enters label edit submode (Enter commits, Esc cancels)
  *   - Enter on a row switches the active append point to that turn id
  *   - Esc closes the overlay
  *
- * Cwd-toggle (`p`) and sort-order (`s`) land in Phase 18.
+ * Cwd-toggle (`p`) and sort-order (`s`) are not implemented.
  *
  * The overlay queries `session.tree()` on open and after any mutation so
  * label edits are reflected without a close/reopen cycle.

package/src/interactive/renderers/branch-summary.ts

@@ -1,5 +1,5 @@
 /**
- * Renderer for BranchSummary session entries (Phase 12 / slice 12b).
+ * Renderer for BranchSummary session entries.
  *
  * A branchSummary entry is produced when a fork inherits a compacted parent
  * context: the new session opens with a single summary block standing in for

package/src/interactive/renderers/tool-execution.ts

@@ -12,6 +12,7 @@
  * two surfaces stay byte-identical.
  */
 
+import { trustStateWord } from "../../domains/evidence/trust-projection.js";
 import { sanitizeCallTargetText } from "../../domains/safety/call-target.js";
 import { redactSecretString, redactToolArgs } from "../../domains/safety/redaction.js";
 import { formatSize } from "../../engine/truncate.js";
@@ -320,7 +321,22 @@ function outcomeSummary(finished: ToolExecutionFinished): string | null {
 	if (finished.toolName === "dispatch") {
 		const receipts = numberField(details, "receiptCount");
 		const failed = numberField(details, "failedCount") ?? 0;
-		if (receipts !== null) return `${receipts} task${receipts === 1 ? "" : "s"} -> ${receipts - failed} ok`;
+		if (receipts !== null) {
+			const runs = Array.isArray(details?.runs) ? details.runs.slice(0, receipts) : [];
+			const qualityCounts = new Map<string, number>();
+			for (const run of runs) {
+				const trust = isPlainObject(run) && isPlainObject(run.trust) ? run.trust : null;
+				const axes = isPlainObject(trust?.axes) ? trust.axes : null;
+				const word = trustStateWord("validationGrounding", stringField(axes, "validationGrounding") ?? "unknown");
+				qualityCounts.set(word, (qualityCounts.get(word) ?? 0) + 1);
+			}
+			if (runs.length < receipts) {
+				const unknown = trustStateWord("validationGrounding", "unknown");
+				qualityCounts.set(unknown, (qualityCounts.get(unknown) ?? 0) + receipts - runs.length);
+			}
+			const quality = [...qualityCounts].map(([word, count]) => `${count} ${word}`).join(", ");
+			return `${receipts} task${receipts === 1 ? "" : "s"} -> ${receipts - failed} execution ok${failed > 0 ? `, ${failed} execution failed` : ""}${quality ? `; quality: ${quality}` : ""}`;
+		}
 		return null;
 	}
 	if (finished.toolName === "tasks") {

package/src/interactive/renderers/worker-entry.ts

@@ -11,17 +11,20 @@
  *   ◇ coder · node-a/example-coder-model · run 2mkas6s
  *   │ Hello! I'm the coder worker.
  *   │ ⚙ read · artifact
- *   └ ✓ ok · 4.8k tok · 9.6s · contract pass
+ *   └ ✓ execution ok · 4.8k tok · 9.6s · contract pass
+ *   │ quality: grounded
  *
- * Folded (the default for a run the model asked for) is one row shaped like a tool subline,
- * so a fan-out of five scouts costs five rows until the operator opens one:
+ * Folded (the default for a run the model asked for) keeps identity and
+ * execution on a tool-style subline, followed by the settled quality fact:
  *
- *   ◆ scout · node-b/example-scout-model · run 3nc18jo ✓ · 41s (Ctrl+O)
+ *   ◆ scout · node-b/example-scout-model · run 3nc18jo ✓ execution ok · 41s (Ctrl+O)
+ *   │ quality: validation failed
  *
  * Pure: no I/O, no module-level mutable state beyond the shared theme handle.
  */
 
 import { parseJsonObjectPayload } from "../../core/json-payload.js";
+import { trustStateWord } from "../../domains/evidence/trust-projection.js";
 import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "../../engine/tui.js";
 import { formatFooterTokens } from "../footer-panel.js";
 import { type ClioToken, clioTheme, fitUnits, formatCompactMs, GLYPH } from "../theme/index.js";
@@ -80,14 +83,14 @@ function headerLine(entry: WorkerEntryState, width: number): string {
 }
 
 /**
- * Outcome glyph, with the word on the footer. The folded row uses the glyph
- * alone, as a tool subline does, so a list of cards reads like a list of calls.
+ * Execution outcome, explicitly named on successful folded and expanded rows
+ * so the separate quality line cannot be mistaken for process status.
  * Abandoned names itself rather than falling through to its `stalled`
  * outcome code, so it reads as a ledger-side finding instead of the ordinary
  * heartbeat-timeout `stalled` a sealed receipt reports.
  */
 function outcomeUnit(receipt: WorkerReceiptSummary, word: boolean): string {
-	if (receipt.outcome === "succeeded") return theme.fg("success", word ? `${GLYPH.ok} ok` : GLYPH.ok);
+	if (receipt.outcome === "succeeded") return theme.fg("success", `${GLYPH.ok} execution ok`);
 	if (receipt.outcome === "canceled") return theme.fg("dim", `${GLYPH.cancelled} canceled`);
 	if (receipt.abandonedDetail !== undefined) return theme.fg("error", word ? `${GLYPH.error} abandoned` : GLYPH.error);
 	return theme.fg("error", `${GLYPH.error} ${receipt.outcomeCode ?? receipt.outcome}`);
@@ -397,8 +400,12 @@ function foldedLine(entry: WorkerEntryState, width: number, expandKey: string |
 		entry.receipt?.durationMs === undefined ? "" : dim(`${SEPARATOR}${formatCompactMs(entry.receipt.durationMs)}`);
 	const hint = expandKey === undefined || expandKey.length === 0 ? "" : dim(` (${expandKey})`);
 	const full = ` ${status}${elapsed}${hint}`;
-	const tail = visibleWidth(identity) + visibleWidth(full) <= width ? full : ` ${status}${hint}`;
-	return `${truncateToWidth(identity, Math.max(1, width - visibleWidth(tail)), GLYPH.ellipsis, false)}${tail}`;
+	let tail = visibleWidth(identity) + visibleWidth(full) <= width ? full : ` ${status}${hint}`;
+	// Reserve one identity cell. The optional hint yields before execution
+	// status when the suffix alone would exhaust the header's width.
+	if (visibleWidth(tail) >= width) tail = ` ${status}`;
+	const header = `${truncateToWidth(identity, Math.max(1, width - visibleWidth(tail)), GLYPH.ellipsis, false)}${tail}`;
+	return truncateToWidth(header, width, GLYPH.ellipsis, false);
 }
 
 export function renderWorkerEntryLines(
@@ -407,7 +414,14 @@ export function renderWorkerEntryLines(
 	options: WorkerEntryRenderOptions,
 ): string[] {
 	const safeWidth = Math.max(1, Math.floor(width));
-	if (options.folded) return [foldedLine(entry, safeWidth, options.expandKey)];
+	const quality = isPending(entry)
+		? []
+		: railLines(
+				`quality: ${trustStateWord("validationGrounding", entry.receipt?.trust?.validationGrounding.state ?? "unknown")}`,
+				"muted",
+				safeWidth,
+			);
+	if (options.folded) return [foldedLine(entry, safeWidth, options.expandKey), ...quality];
 	const tools = toolLine(entry, safeWidth);
 	return [
 		headerLine(entry, safeWidth),
@@ -416,5 +430,6 @@ export function renderWorkerEntryLines(
 		...(tools === null ? [] : [tools]),
 		...failureLines(entry, safeWidth),
 		footerLine(entry, safeWidth),
+		...quality,
 	];
 }