@iowarp/clio-coder 0.4.9 → 0.5.0

package/src/interactive/interactive-application.ts

@@ -1,6 +1,7 @@
 import { BusChannels, type PermissionRequestedPayload } from "../core/bus-events.js";
 import type { ClioSettings } from "../core/config.js";
 import { nextOutputStyle } from "../core/defaults.js";
+import { installDiagnosticSink } from "../core/diagnostics.js";
 import type { SafeEventBus } from "../core/event-bus.js";
 import { expandInlineFileReferencesAsync } from "../core/file-references.js";
 import type { PendingSkillRequest } from "../core/skill-activation.js";
@@ -9,7 +10,7 @@ import { clioStateDir } from "../core/xdg.js";
 import type { AgentsContract } from "../domains/agents/contract.js";
 import type { ClioKeybinding } from "../domains/config/keybindings.js";
 import type { ContextState } from "../domains/context/index.js";
-import type { DispatchContract } from "../domains/dispatch/contract.js";
+import type { DispatchContract, RouteBreakerView } from "../domains/dispatch/contract.js";
 import type { ExtensionsContract } from "../domains/extensions/index.js";
 import { OperatorExtensionRuntime } from "../domains/extensions/operator-runtime.js";
 import type { InteropContract } from "../domains/interop/index.js";
@@ -18,6 +19,7 @@ import { openDetachedBatchViews } from "../domains/middleware/index.js";
 import type { MuxContract } from "../domains/mux/index.js";
 import type { PanesOperations, PanesWatchController } from "../domains/mux/operations.js";
 import type { ObservabilityContract } from "../domains/observability/index.js";
+import { appendOutOfTurnUsageRow } from "../domains/observability/out-of-turn-usage.js";
 import type { ProvidersContract, ThinkingLevel } from "../domains/providers/index.js";
 import type { ResourcesContract } from "../domains/resources/index.js";
 import type { FleetNodeSnapshot } from "../domains/scheduling/cluster.js";
@@ -57,7 +59,6 @@ import type {
 	ContextClearCommandOptions,
 	InitCommandOptions,
 	RunIo,
-	SettingsAreaId,
 	SlashCommandContext,
 	TaskMemorySeedCommandResult,
 } from "./slash-commands.js";
@@ -107,6 +108,7 @@ export function isLiveWorkerEscalationRequest(payload: PermissionRequestedPayloa
 }
 
 export interface InteractiveDeps {
+	getConnections?: () => { mcp: string[]; plugins: string[] };
 	bus: SafeEventBus;
 	providers: ProvidersContract;
 	dispatch: DispatchContract;
@@ -197,6 +199,8 @@ export interface InteractiveDeps {
 	getSettings?: () => Readonly<ClioSettings>;
 	/** Live fleet node snapshots for the /fleet nodes view and node-pin editor. */
 	getFleetNodes?: () => ReadonlyArray<FleetNodeSnapshot>;
+	/** Live dispatch breaker state per route for the Settings → Targets rows. */
+	getRouteBreakers?: () => ReadonlyArray<RouteBreakerView>;
 	/** Optional resolver for the active session id used as the cost overlay title suffix. */
 	getSessionId?: () => string | null;
 	/** Install the TUI-backed ask_user handler for this interactive process. */
@@ -251,9 +255,9 @@ export interface InteractiveDeps {
 	/** Run /context init for the current working directory. */
 	onInit?: (options: InitCommandOptions, io?: RunIo) => Promise<void>;
 	/** Run /context reset for the current working directory. */
-	onContextClear?: (options: ContextClearCommandOptions) => Promise<void>;
+	onContextClear?: (options: ContextClearCommandOptions, io?: RunIo) => Promise<void>;
 	/** Run /context refresh: re-index codewiki and refresh .clio-coder state without touching CLIO-CODER.md. */
-	onContextRefresh?: () => Promise<void>;
+	onContextRefresh?: (io?: RunIo) => Promise<void>;
 	/**
 	 * Advance the orchestrator target one step forward through `provider.scope`.
 	 * False means nothing moved, which the UI answers with a notice: the keys are
@@ -474,6 +478,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 	const initialSmoothStreaming = deps.getSettings?.().interface.smoothStreaming ?? "off";
 	const initialAutoPacingAllowed = processAutoPacingAllowed(false);
 	const lease = deps.terminalLease;
+	let removeDiagnosticSink = () => {};
 	const shell =
 		lease?.shell ??
 		createProcessInteractiveShell({
@@ -590,9 +595,12 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 						}
 					: {}),
 				onDiagnostic: (message) => notify("warning", message, "operator-extensions:observation"),
-				onReload: (result) => {
-					if (result.status !== "deferred")
-						notify(result.status === "rejected" ? "error" : "info", result.message, "operator-extensions:reload");
+				onReload: (result, reason) => {
+					if (result.status === "deferred") return;
+					const failed = result.status === "rejected" || result.degraded === undefined;
+					const degraded = (result.degraded ?? 0) > 0;
+					if (reason !== "reload" && !failed && !degraded) return;
+					notify(failed ? "error" : degraded ? "warning" : "info", result.message, "operator-extensions:reload");
 				},
 			})
 		: undefined;
@@ -635,11 +643,13 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 				}
 			: {}),
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
+		...(deps.getConnections ? { getConnections: deps.getConnections } : {}),
 		...(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.scheduling?.localCapacity ? { getLocalCapacity: () => deps.scheduling?.localCapacity?.() ?? null } : {}),
 		...(deps.userTasks ? { userTasks: deps.userTasks } : {}),
 		...(deps.getTaskMemoryStatus ? { getTaskMemoryStatus: deps.getTaskMemoryStatus } : {}),
 		...(deps.getTaskMemorySeedOffer ? { getTaskMemorySeedOffer: deps.getTaskMemorySeedOffer } : {}),
@@ -847,19 +857,8 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		openModelScope: (ref) => openModelScopeState(ref),
 		openSettings: (area, group) => {
 			if (!area) return openSettingsOverlayState();
-			// Compatibility adapter until the seven-area Settings shell replaces
-			// the legacy section ids. Slash grammar never exposes these old names.
-			if (area === "chat" && group === "model-picker") return openSettingsOverlayState("models", "scope");
-			const section = {
-				chat: "orchestrator",
-				fleet: "fleet",
-				targets: "targets",
-				context: "compaction",
-				safety: "safety",
-				interface: "terminal",
-				integrations: "advanced",
-			} satisfies Record<SettingsAreaId, Parameters<typeof openSettingsOverlayState>[0]>;
-			openSettingsOverlayState(section[area]);
+			if (area === "chat" && group === "model-picker") return openSettingsOverlayState("chat", "scope");
+			openSettingsOverlayState(area);
 		},
 		openResume: () => openResumeOverlayState(),
 		startNewSession: () => startNewSession(),
@@ -1300,6 +1299,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 			};
 		})(),
 		stopUi: () => {
+			removeDiagnosticSink();
 			if (lease) void lease.close();
 			else shell.stop();
 		},
@@ -1378,5 +1378,93 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		if (!adopted) void applicationController.shutdown();
 	}
 
-	return applicationController.run;
+	const startupAbort = new AbortController();
+	const startupWorkspace = process.cwd();
+	const startupSession = deps.session?.current() ?? null;
+	let startupTimer: ReturnType<typeof setTimeout> | undefined;
+	const prepareStartup = () => {
+		const startupConfiguration = JSON.stringify(deps.getSettings?.());
+		const isBusy = () =>
+			startupAbort.signal.aborted ||
+			process.cwd() !== startupWorkspace ||
+			JSON.stringify(deps.getSettings?.()) !== startupConfiguration ||
+			overlayLifecycle.getState() !== "closed" ||
+			editorSubmit.hasActiveEditorBash() ||
+			(deps.session?.current()?.id ?? null) !== (startupSession?.id ?? null) ||
+			editor.getText().length > 0 ||
+			deps.chat.isStreaming() ||
+			deps.chat.turnPreparation().phase !== "idle" ||
+			deps.dispatch.snapshot().running.length > 0;
+		if (isBusy()) return;
+		void deps.interop?.detect({ cwd: startupWorkspace }).catch(() => {});
+		const settings = deps.getSettings?.();
+		if (settings)
+			void import("./startup-background.js")
+				.then(({ prepareWorkerTargets }) =>
+					prepareWorkerTargets({
+						settings,
+						providers: deps.providers,
+						signal: startupAbort.signal,
+						isBusy,
+						recordWarm: (target, model, result) => {
+							const usage = result.usage;
+							if (usage)
+								deps.observability.recordTokens(
+									target,
+									model,
+									usage.totalTokens,
+									usage.cost.total,
+									{
+										input: usage.input,
+										output: usage.output,
+										cacheRead: usage.cacheRead,
+										cacheWrite: usage.cacheWrite,
+										apiCalls: 1,
+									},
+									"unknown",
+									undefined,
+									"prewarm",
+								);
+							appendOutOfTurnUsageRow(deps.stateDir, {
+								label: "prewarm",
+								sessionId: startupSession?.id ?? null,
+								repoIdentity: startupSession?.cwdHash ?? null,
+								timestamp: new Date().toISOString(),
+								target,
+								attributedModelId: model,
+								callOutcome: result.aborted ? "aborted" : result.errorMessage ? "error" : "success",
+								timing: { durationMs: result.timing.apiMs },
+								usage: {
+									input: usage?.input ?? null,
+									output: usage?.output ?? null,
+									cacheRead: usage?.cacheRead ?? null,
+									cacheWrite: usage?.cacheWrite ?? null,
+									reasoning: null,
+									totalTokens: usage?.totalTokens ?? null,
+									costUsd: usage?.cost.total ?? null,
+									costProvenance: "unknown",
+								},
+							});
+						},
+					}),
+				)
+				.catch(() => {});
+	};
+	void shell.nextCommittedFrame().then((frame) => {
+		if (frame === null || startupAbort.signal.aborted) return;
+		startupTimer = setTimeout(prepareStartup, 1000);
+		startupTimer.unref();
+	});
+
+	removeDiagnosticSink = installDiagnosticSink((text, level) => {
+		const message = text.trim();
+		if (message) notify(level, message, `diagnostic:${message}`);
+	});
+	try {
+		return await applicationController.run;
+	} finally {
+		clearTimeout(startupTimer);
+		startupAbort.abort();
+		removeDiagnosticSink();
+	}
 }

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

@@ -349,13 +349,17 @@ export function createInteractiveEventProjection(deps: InteractiveEventProjectio
 	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.notify("warning", payload.message, `extension:${payload.message}`);
 			deps.requestRender();
 		}),
 		deps.bus.on(BusChannels.MiddlewareHookFailed, (payload) => {
 			const notice = middlewareHookFailedSessionNotice(payload, seenMiddlewareBudgetWarnings);
 			if (notice === null) return;
-			deps.appendTranscriptNotice(notice.level, notice.text);
+			deps.notify(
+				notice.level === "warn" ? "warning" : "error",
+				notice.text,
+				`middleware:${payload.registrationId}:${payload.hook}:${payload.kind}`,
+			);
 			deps.requestRender();
 		}),
 	);

package/src/interactive/interactive-presentation.ts

@@ -14,10 +14,12 @@ 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 type { LocalCapacity } from "../domains/scheduling/local-capacity.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, ScrollView, TUI } from "../engine/tui.js";
+import { createAssistantGenerationTiming, hasAssistantGenerationDelta } from "./assistant-generation-timing.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 +34,7 @@ import { buildFooterDashboard, type FooterDashboardDeps, type FooterDashboardPan
 import { createNotificationCenter, type NotificationCenter } from "./footer/notifications.js";
 import { getActiveRenderTrace } from "./interactive-shell.js";
 import type { InteractiveNoticeLevel } from "./interactive-subscriptions.js";
-import { type ClioKeybindingManager, createKeybindingManager } from "./keybinding-manager.js";
+import { type ClioKeybindingManager, createKeybindingManager, formatKeyLabel } from "./keybinding-manager.js";
 import { buildLayout, preserveTranscriptScroll } from "./layout.js";
 import type { SessionTranscript } from "./session-transcript.js";
 import { createSlashCommandAutocompleteProvider } from "./slash-autocomplete.js";
@@ -71,6 +73,7 @@ export interface InteractivePresentationFactories {
 }
 
 export interface InteractivePresentationDeps {
+	getConnections?: () => { mcp: string[]; plugins: string[] };
 	extensionCommands?: import("./slash-autocomplete.js").SlashAutocompleteOptions["extensionCommands"];
 	getExtensionStatus?: () => ReadonlyArray<string>;
 	bus: SafeEventBus;
@@ -81,7 +84,7 @@ export interface InteractivePresentationDeps {
 	workspaceFacts: WorkspaceFacts;
 	sessionTranscript: Pick<SessionTranscript, "liveSessionTurns">;
 	tui: TUI;
-	terminal: { readonly columns: number };
+	terminal: { readonly columns: number; readonly rows?: number };
 	mount?: (root: Component, editor: Component) => void;
 	/** Stage 0's exact editor; when present no replacement editor is constructed. */
 	editor?: ClioEditor;
@@ -95,6 +98,7 @@ export interface InteractivePresentationDeps {
 	session?: Pick<SessionContract, "current">;
 	getSessionId?: () => string | null;
 	getTaskBoard?: () => TaskBoardSnapshot | null;
+	getLocalCapacity?: () => LocalCapacity | null;
 	userTasks?: Pick<UserTasksStore, "snapshot">;
 	getTaskMemoryStatus?: () => TaskMemoryOperatorStatus;
 	getTaskMemorySeedOffer?: () => { source: string; count: number } | null;
@@ -187,15 +191,6 @@ const DEFAULT_FACTORIES: InteractivePresentationFactories = {
 	buildLayout,
 };
 
-/** Title-case a KeyId for compact chrome hints, preserving each caller's fallback. */
-function formatKeyLabel(keyId: string | undefined, fallback = "unbound"): string {
-	if (!keyId || keyId.length === 0) return fallback;
-	return keyId
-		.split("+")
-		.map((segment) => (segment.length === 0 ? segment : segment.charAt(0).toUpperCase() + segment.slice(1)))
-		.join("+");
-}
-
 function willEnterSteerActiveWork(deps: InteractivePresentationDeps, text: string): boolean {
 	const trimmed = text.trim();
 	if (trimmed.length === 0 || parseEditorBashCommand(text)) return false;
@@ -241,12 +236,17 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 
 	const banner = factories.createBanner({
 		providers: deps.providers,
+		...(deps.agents ? { getAgentCount: () => deps.agents?.listSpecs().filter(isUserVisibleAgent).length ?? 0 } : {}),
 		getWorkspaceSnapshot,
 		// The authoritative project-context reader. It is synchronous on a cache
 		// miss, so the banner refreshes it off the frame rather than calling it
 		// during render; the frame that shows the result is asked for below.
 		...(deps.getContextState ? { getContextState: deps.getContextState } : {}),
 		getSubmitKeyLabel: () => effectiveSubmitKeyLabel(),
+		getKeyLabel: (action) => {
+			const key = keybindings.isDisabled(action) ? undefined : keybindings.getKeys(action)[0];
+			return key ? formatKeyLabel(key, "") : null;
+		},
 		onFactsRefreshed: requestRender,
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
 	});
@@ -284,17 +284,15 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 	let footerToolTruncatedResults = 0;
 	let lastTurnSummary: TurnSummary | null = null;
 	let observabilitySnapshot = deps.observability.snapshot();
+	const generationTiming = createAssistantGenerationTiming();
 	let liveThroughput: {
-		startedAt: number;
-		firstDeltaAt: number | null;
 		settledOutputTokens: number;
 		partialOutputTokens: number;
 	} | null = null;
 	const recordChatEvent = (event: ChatLoopEvent): void => {
+		generationTiming.record(event, now());
 		if (event.type === "agent_start") {
 			liveThroughput = {
-				startedAt: now(),
-				firstDeltaAt: null,
 				settledOutputTokens: 0,
 				partialOutputTokens: 0,
 			};
@@ -311,15 +309,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		}
 		if (event.type === "message_update") {
 			const update = event.assistantMessageEvent as { type?: unknown; partial?: { content?: unknown; payload?: unknown } };
-			if (
-				update.type !== "text_delta" &&
-				update.type !== "thinking_delta" &&
-				update.type !== "toolcall_start" &&
-				update.type !== "toolcall_delta"
-			) {
-				return;
-			}
-			liveThroughput.firstDeltaAt ??= now();
+			if (!hasAssistantGenerationDelta(update)) return;
 			liveThroughput.partialOutputTokens = ceilChars(contentChars(update.partial?.payload ?? update.partial?.content));
 			return;
 		}
@@ -331,17 +321,18 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		}
 	};
 	const currentLiveThroughput = (): TokenThroughputSnapshot | null => {
-		if (!liveThroughput || liveThroughput.firstDeltaAt === null) return null;
+		if (!liveThroughput) return null;
+		const timing = generationTiming.snapshot(now());
+		if (!timing) return null;
 		const outputTokens = liveThroughput.settledOutputTokens + liveThroughput.partialOutputTokens;
 		if (outputTokens <= 0) return null;
-		const at = now();
-		const durationMs = Math.max(1, at - liveThroughput.firstDeltaAt);
+		const { durationMs, ttftMs } = timing;
 		const settings = deps.getSettings?.();
 		return {
 			tokensPerSecond: outputTokens / (durationMs / 1000),
 			outputTokens,
 			durationMs,
-			ttftMs: Math.max(0, liveThroughput.firstDeltaAt - liveThroughput.startedAt),
+			ttftMs,
 			providerId: settings?.chat?.target ?? "",
 			modelId: settings?.chat?.model ?? "",
 			recordedAt: Date.now(),
@@ -382,6 +373,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 	const footerDeps: FooterDashboardDeps = {
 		providers: deps.providers,
 		...(deps.getSettings ? { getSettings: deps.getSettings } : {}),
+		...(deps.getConnections ? { getConnections: deps.getConnections } : {}),
 		getAgentStatus: () => {
 			const status = statusController.current();
 			if (localBashStartedAt === null || (status.phase !== "idle" && status.phase !== "ended")) return status;
@@ -394,6 +386,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 			};
 		},
 		getTerminalColumns: () => deps.terminal.columns,
+		getTerminalRows: () => deps.terminal.rows ?? process.stdout.rows ?? 40,
 		getSessionTokens: () => observabilitySnapshot.session.tokens,
 		getTokenThroughput: () =>
 			liveThroughput === null ? observabilitySnapshot.session.latestThroughput : currentLiveThroughput(),
@@ -402,6 +395,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 		getContextLedger: () => deps.chat.contextLedger(),
 		getDispatchRows: () => dispatchBoardStore.rows(),
 		...(deps.getTaskBoard ? { getTaskBoard: deps.getTaskBoard } : {}),
+		...(deps.getLocalCapacity ? { getLocalCapacity: deps.getLocalCapacity } : {}),
 		...(deps.getTaskMemoryStatus ? { getTaskMemoryStatus: deps.getTaskMemoryStatus } : {}),
 		getContextActivity: () => contextActivityStore.current(),
 		...(deps.getLeaderArmed ? { getLeaderArmed: deps.getLeaderArmed } : {}),
@@ -459,6 +453,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 			);
 		},
 		isStreaming: () => deps.chat.isStreaming(),
+		getAutonomy: () => deps.getSettings?.().safety.autonomy ?? "auto-edit",
 		...(deps.isAwaitingApproval ? { isAwaitingApproval: deps.isAwaitingApproval } : {}),
 		...(deps.getPermissionInspection ? { getPermissionInspection: deps.getPermissionInspection } : {}),
 		getTurnPreparation: () => deps.chat.turnPreparation().phase,
@@ -592,7 +587,8 @@ 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" || localBashStartedAt !== null;
+		const statusActive =
+			statusController.current().phase !== "idle" || localBashStartedAt !== null || deps.isAwaitingApproval?.() === true;
 		if (!deps.chat.isStreaming() && !statusActive && !footer.isExpanded()) return;
 		footer.refresh();
 		requestRender();

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

@@ -4,7 +4,6 @@ import { BusChannels } from "../core/bus-events.js";
 import type { ClioSettings } from "../core/config.js";
 import type { SafeEventBus } from "../core/event-bus.js";
 import type { PendingSkillRequest } from "../core/skill-activation.js";
-import { clioConfigDir } from "../core/xdg.js";
 import type { AgentsContract } from "../domains/agents/contract.js";
 import type { DispatchContract } from "../domains/dispatch/contract.js";
 import { agentRoleFactsResolver } from "../domains/dispatch/execution-role.js";
@@ -39,6 +38,7 @@ import { renderSessionHtml } from "./export-html/index.js";
 import { dateLocal } from "./format-time.js";
 import type { OracleDigestSources } from "./oracle.js";
 import type { PendingModelScope } from "./overlays/model-scope.js";
+import { renderDoctorReport } from "./renderers/doctor-report.js";
 import {
 	type ContextClearCommandOptions,
 	type CouncilDispatchOutcome,
@@ -105,8 +105,8 @@ export interface InteractiveSlashRuntimeDeps {
 	onSetThinkingLevel?: (level: ThinkingLevel, scope?: "session" | "global") => void;
 	onCompact?: (instructions: string | undefined) => Promise<void>;
 	onInit?: (options: InitCommandOptions, io?: RunIo) => Promise<void>;
-	onContextClear?: (options: ContextClearCommandOptions) => Promise<void>;
-	onContextRefresh?: () => Promise<void>;
+	onContextClear?: (options: ContextClearCommandOptions, io?: RunIo) => Promise<void>;
+	onContextRefresh?: (io?: RunIo) => Promise<void>;
 	stateDir: string;
 	shutdown: () => void | Promise<void>;
 	requestRender: () => void;
@@ -169,7 +169,6 @@ export interface InteractiveSlashRuntimeDeps {
 	/** Worker blocks this session folded, oldest first; `/share` picks a finished one. */
 	listWorkerRuns?: () => ReadonlyArray<WorkerEntryState>;
 	getCwd?: () => string;
-	getConfigDir?: () => string;
 	installSkill?: typeof installSkill;
 	now?: () => Date;
 }
@@ -344,36 +343,36 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 						{
 							question: `Skill "${uninstalled.name}" is not installed. Would you like to install it?`,
 							options: [
-								{ label: "Install and run", description: `Install from ${uninstalled.marketplaceRef}` },
+								{ label: "Install and run", description: "Install in the active user profile and run." },
+								{ label: "Install for this project and run", description: "Install in this workspace only and run." },
 								{ label: "Cancel", description: "Do not install." },
 							],
 						},
 					])
 					.then((res) => {
-						if (res.cancelled || res.answers[0]?.answer !== "Install and run") {
+						const answer = res.answers[0]?.answer;
+						if (res.cancelled || (answer !== "Install and run" && answer !== "Install for this project and run")) {
 							deps.io.stderr("Installation cancelled.\n");
 							return;
 						}
 						void (async () => {
 							try {
 								deps.io.stdout(`Installing skill "${uninstalled.name}"...\n`);
-								let configDir: string | undefined;
-								try {
-									configDir = (deps.getConfigDir ?? clioConfigDir)();
-								} catch (configErr) {
-									deps.io.stderr(
-										`Skill install: config dir unavailable (${configErr instanceof Error ? configErr.message : String(configErr)}); continuing without it.\n`,
-									);
-								}
 								(deps.installSkill ?? installSkill)({
 									source: uninstalled.name,
 									cwd: cwd(),
-									...(configDir ? { configDir } : {}),
+									scope: answer === "Install for this project and run" ? "project" : "user",
 								});
 								deps.io.stdout(`Successfully installed "${uninstalled.name}"!\n`);
 								await deps.resources?.reload();
 								const postInstallSubmitted = await deps.expandSubmit(text);
-								submitExpanded(postInstallSubmitted);
+								if (postInstallSubmitted.pendingSkillRequests.some((request) => !request.installed)) {
+									throw new Error(
+										"Installed package is not available after reload; inspect it with clio-coder library inspect skill:" +
+											uninstalled.name,
+									);
+								}
+								await submitExpanded(postInstallSubmitted);
 							} catch (err) {
 								deps.io.stderr(
 									`Failed to install skill "${uninstalled.name}": ${err instanceof Error ? err.message : String(err)}\n`,
@@ -415,6 +414,21 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 		shutdown: () => {
 			void deps.shutdown();
 		},
+		showDoctor: (findings) => {
+			deps.chatPanel.appendReplayBlock((width) => renderDoctorReport(findings, width));
+			deps.requestRender();
+		},
+		runDoctor: async ({ deep }) => {
+			// Loaded on first use: doctor pulls in every sweep it runs, and a
+			// session that never asks for it should not pay for them at boot.
+			const { collectDoctorFindings, doctorNotice } = await import("../cli/doctor.js");
+			const autonomy = deps.getSettings?.().safety.autonomy;
+			const findings = await collectDoctorFindings({
+				workspaceRoot: cwd(),
+				deep: deep ? { providers: deps.providers, ...(autonomy ? { autonomy } : {}) } : false,
+			});
+			return doctorNotice(findings);
+		},
 		listPrompts: () => deps.resources?.prompts(cwd()) ?? { items: [], diagnostics: [] },
 		...(resources ? { expandPromptTemplate: (text: string) => resources.expandPromptTemplate(text, cwd()) } : {}),
 		openSkillsHub: deps.openSkillsHub,
@@ -636,7 +650,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 			void Promise.resolve()
 				.then(() => onInit(options, deps.io))
 				.then(() => {
-					deps.dismissContextBootstrapNotices();
+					if (!options.preview) deps.dismissContextBootstrapNotices();
 					deps.refreshFooter();
 				})
 				.catch((err) => {
@@ -693,7 +707,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 				return;
 			}
 			void deps
-				.onContextRefresh()
+				.onContextRefresh(deps.io)
 				.catch((err) => {
 					const msg = err instanceof Error ? err.message : String(err);
 					deps.io.stderr(`[/context refresh] ${msg}\n`);

package/src/interactive/interactive-subscriptions.ts

@@ -1,5 +1,6 @@
-import { BusChannels } from "../core/bus-events.js";
+import { BusChannels, type DispatchRunIdentity } from "../core/bus-events.js";
 import type { SafeEventBus } from "../core/event-bus.js";
+import { sanitizeCallTargetText } from "../domains/safety/call-target.js";
 import { readWorkerReceiptFacts } from "./worker-receipts.js";
 import { type WorkerRunEntryFields, workerRunEntryFields } from "./worker-replay.js";
 import {
@@ -60,6 +61,23 @@ export interface InteractiveSubscriptions {
  */
 export function createInteractiveSubscriptions(deps: InteractiveSubscriptionsDeps): InteractiveSubscriptions {
 	const workers = createWorkerStream({ readReceipt: deps.readWorkerReceipt ?? readWorkerReceiptFacts });
+	const helperNotice = (payload: DispatchRunIdentity, status: "working" | "completed" | "failed"): void => {
+		if (
+			payload.agentAudience !== "shadow" &&
+			payload.agentAudience !== "internal" &&
+			payload.requestOrigin !== "internal"
+		)
+			return;
+		deps.notify(
+			status === "failed" ? "warning" : status === "completed" ? "success" : "info",
+			`Clio-Coder → ${sanitizeCallTargetText(payload.agentId)
+				.slice(0, 80)
+				.replace(/^./, (letter) =>
+					letter.toUpperCase(),
+				)} · ${status} · run ${sanitizeCallTargetText(payload.runId).slice(0, 80)}`,
+			`helper:${payload.runId}:${status}`,
+		);
+	};
 	const repaint = (): void => {
 		deps.refreshFooter();
 		deps.renderTaskIsland();
@@ -80,10 +98,10 @@ export function createInteractiveSubscriptions(deps: InteractiveSubscriptionsDep
 		deps.bus.on(BusChannels.DispatchEnqueued, repaint),
 		// Every attempt writes its own session entry: a failover is history, and
 		// the attempt trail a resumed block shows is that history read back.
-		deps.bus.on(
-			BusChannels.DispatchStarted,
-			folded(workers.started, (change) => deps.recordWorkerRun?.(workerRunEntryFields(change.entry))),
-		),
+		deps.bus.on(BusChannels.DispatchStarted, (payload) => {
+			helperNotice(payload, "working");
+			folded(workers.started, (change) => deps.recordWorkerRun?.(workerRunEntryFields(change.entry)))(payload);
+		}),
 		deps.bus.on(
 			BusChannels.DispatchProgress,
 			folded((payload) => {
@@ -96,10 +114,12 @@ export function createInteractiveSubscriptions(deps: InteractiveSubscriptionsDep
 		),
 		deps.bus.on(BusChannels.RunAborted, folded(workers.aborted)),
 		deps.bus.on(BusChannels.DispatchCompleted, (payload) => {
+			helperNotice(payload, "completed");
 			folded(workers.completed)(payload);
 			deps.onDispatchSettled?.();
 		}),
 		deps.bus.on(BusChannels.DispatchFailed, (payload) => {
+			helperNotice(payload, "failed");
 			folded(workers.failed)(payload);
 			deps.onDispatchSettled?.();
 		}),