@iowarp/clio-coder 0.4.8 → 0.4.9

package/src/interactive/dispatch-board.ts

@@ -29,6 +29,7 @@ import { formatWorkerContextMeter } from "./context-meter.js";
 import { COUNCIL_SYNTHESIS_LABEL } from "./council.js";
 import { type CouncilGroupView, type CouncilMemberView, councilGroupBody, councilIslandLines } from "./council-grid.js";
 import { formatFooterTokens } from "./footer-panel.js";
+import { presentWorkerContractAnswer, safeWorkerAnswerText } from "./renderers/worker-answer.js";
 import {
 	type ClioTheme,
 	type ClioToken,
@@ -43,6 +44,7 @@ import {
 	screenTitle,
 	spinnerFrame,
 } from "./theme/index.js";
+import { fitIdentityLabel } from "./theme/labels.js";
 
 export type DispatchBoardStatus = ObservabilityRunSummary["status"];
 
@@ -121,6 +123,7 @@ export interface DispatchBoardRow {
 	 * worker is doing rather than a richer spinner.
 	 */
 	progress?: WorkerProgressSnapshot;
+	resultContract?: ObservabilityRunSummary["resultContract"];
 	/**
 	 * Id of the receipt sealed for this run (`receipts/<runId>.json`, the id
 	 * `clio-coder trace` takes). Set only once a terminal dispatch event has
@@ -474,8 +477,8 @@ function progressActionLine(theme: ClioTheme, progress: WorkerProgressSnapshot,
 	const current = progress.currentAction;
 	const recent = progress.recentActions[0];
 	const units: string[] = [];
-	if (phase !== null) units.push(phase);
-	if (current !== null) units.push(theme.fg("muted", actionPhrase(current)));
+	if (phase !== null && current === null) units.push(phase);
+	if (current !== null) units.push(theme.fg("muted", `now ${actionPhrase(current)}`));
 	else if (recent !== undefined) units.push(theme.fg("dim", `last ${actionPhrase(recent)}`));
 	if (units.length === 0) return null;
 	return cardUnitsLine(theme, "doing", units, contentWidth);
@@ -493,24 +496,36 @@ function progressAnswerLines(
 	progress: WorkerProgressSnapshot,
 	runId: string,
 	contentWidth: number,
+	contract: ObservabilityRunSummary["resultContract"],
 ): string[] {
 	if (progress.tailText.length === 0) return [];
 	const gutter = CARD_KV_KEY_WIDTH + 1;
 	const railWidth = Math.max(1, contentWidth - gutter - 2);
+	const presented = presentWorkerContractAnswer(
+		progress.tailText,
+		contract,
+		progress.droppedLines === 0 && progress.droppedBytes === 0,
+		progress.settled,
+	);
+	const source = presented
+		? [...(presented.footer ? [presented.footer] : []), ...presented.lines]
+		: safeWorkerAnswerText(progress.tailText).split("\n");
 	const wrapped: string[] = [];
-	for (const line of progress.tailText.split("\n")) {
+	for (const line of source) {
 		for (const row of wrapTextWithAnsi(sanitizeCallTargetText(line), railWidth)) wrapped.push(row);
 	}
-	const shown = wrapped.slice(Math.max(0, wrapped.length - WORKER_PROGRESS_CARD_ROWS));
+	const shown = progress.settled
+		? wrapped.slice(0, WORKER_PROGRESS_CARD_ROWS)
+		: wrapped.slice(Math.max(0, wrapped.length - WORKER_PROGRESS_CARD_ROWS));
 	const hiddenRows = wrapped.length - shown.length;
 	const rail = theme.fg("dim", `${GLYPH.rail} `);
 	const body = shown.map((row) => `${rail}${theme.fg("muted", row)}`);
 	const hiddenLines = progress.droppedLines + hiddenRows;
 	if (hiddenLines > 0 || progress.droppedBytes > 0) {
 		const facts = [
+			`/view dispatch:${runId}`,
 			...(hiddenLines > 0 ? [`${hiddenLines} more line${hiddenLines === 1 ? "" : "s"}`] : []),
 			...(progress.droppedBytes > 0 ? [`${progress.droppedBytes} bytes outran the view`] : []),
-			`/view dispatch:${runId}`,
 		];
 		body.push(`${rail}${theme.fg("dim", truncateToWidth(facts.join(" · "), railWidth, "…", false))}`);
 	}
@@ -519,16 +534,29 @@ function progressAnswerLines(
 	return body.map((row, index) => `${index === 0 ? cardKvKey(theme, "answer") : " ".repeat(gutter)}${row}`);
 }
 
-/** Keep the canonical tier and every summary clause visible by wrapping the value under its card key. */
-function trustCardLines(theme: ClioTheme, row: DispatchBoardRow, contentWidth: number): string[] {
+/** Compact ordinary unvalidated completions; preserve all exceptional facts and expanded provenance. */
+function trustCardLines(theme: ClioTheme, row: DispatchBoardRow, contentWidth: number, expanded: boolean): string[] {
 	const gutter = CARD_KV_KEY_WIDTH + 1;
 	const valueWidth = Math.max(1, contentWidth - gutter);
+	const axes = row.trust?.axes;
+	// Only the ordinary sealed, mediated completion without validation/review
+	// folds. Unknown, failed, inferred or exceptional provenance stays explicit.
+	const compact =
+		!expanded &&
+		row.status === "completed" &&
+		row.trust?.verdict === "unverified" &&
+		axes?.artifactIntegrity === "verified" &&
+		axes.validationGrounding === "absent" &&
+		axes.independentReview === "absent" &&
+		axes.autonomyEnforcement === "enforced" &&
+		axes.contextProvenance === "recorded" &&
+		axes.completionEvidence === "absent";
 	const trust =
 		row.trust === undefined
 			? theme.fg("dim", isTerminalStatus(row.status) ? "receipt not read back" : "not sealed yet")
 			: theme.fg(
 					trustVerdictToken(row.trust.verdict),
-					`${trustVerdictGlyph(row.trust.verdict)} ${row.trust.verdict}; ${row.trust.text}`,
+					`${trustVerdictGlyph(row.trust.verdict)} ${row.trust.verdict}; ${compact ? trustStateWord("validationGrounding", "absent") : row.trust.text}`,
 				);
 	const host =
 		row.hostVerification === undefined ? "" : ` · ${theme.fg("muted", `host checks ${row.hostVerification}`)}`;
@@ -565,7 +593,6 @@ function renderDispatchCard(
 	const statusStr = theme.fg(presentation.token, `${presentation.glyph} ${presentation.label}`);
 
 	const ttft = row.ttftMs !== null ? `${row.ttftMs}ms` : row.status === "running" ? `waiting${GLYPH.ellipsis}` : "n/a";
-	const target = `${theme.fg("muted", `${row.runtimeKind}:${row.targetId}`)} ${theme.fg("dim", "▸")} ${theme.fg("muted", row.wireModelId)}`;
 
 	// The agent label is the frame title and can be arbitrarily long (agent ids
 	// are user data); clamp it so the title plus the elapsed meta never pushes
@@ -592,7 +619,8 @@ function renderDispatchCard(
 
 	// The model id is user data and can outrun the card; mark the cut with `…`
 	// rather than hard-clipping it mid-token into a string that reads whole.
-	const targetLine = truncateToWidth(`${cardKvKey(theme, "target")}${target}`, contentWidth, "…", false);
+	const targetKey = cardKvKey(theme, "target");
+	const targetLine = `${targetKey}${theme.fg("muted", fitIdentityLabel(sanitizeCallTargetText(`${row.runtimeKind}:${row.targetId} ▸ ${row.wireModelId}`), Math.max(1, contentWidth - visibleWidth(targetKey))))}`;
 	// Fleet facts: node placement (absent means local), gate role badge, and
 	// reroute lineage. Whole units so overflow drops a fact, never clips one.
 	const statusUnits = [
@@ -621,19 +649,28 @@ function renderDispatchCard(
 	// step it is; every other run leaves the cell empty rather than inventing a
 	// position, so the column reads as "not a fleet step" and not as wave zero.
 	const phaseCell = formatDispatchPhaseCell(row.phase, contentWidth);
+	const fullTask = row.taskSummary
+		? cardWrappedValueLines(theme, "task", theme.fg("muted", row.taskSummary), contentWidth)
+		: [];
+	const taskLines =
+		options.expanded === true || fullTask.length <= 3
+			? fullTask
+			: [...fullTask.slice(0, 2), theme.fg("dim", "… Enter detail for full task")];
 	const bodyLines = [
 		cardUnitsLine(theme, "run", [theme.fg("dim", row.runId)], contentWidth),
-		cardUnitsLine(
-			theme,
-			"phase",
-			[phaseCell === null ? theme.fg("dim", "—") : theme.fg("info", phaseCell)],
-			contentWidth,
-		),
-		targetLine,
-		...(row.taskSummary ? cardWrappedValueLines(theme, "task", theme.fg("muted", row.taskSummary), contentWidth) : []),
+		...(phaseCell === null ? [] : [cardUnitsLine(theme, "phase", [theme.fg("info", phaseCell)], contentWidth)]),
+		...(options.expanded === true
+			? cardWrappedValueLines(
+					theme,
+					"target",
+					theme.fg("muted", sanitizeCallTargetText(`${row.runtimeKind}:${row.targetId} ▸ ${row.wireModelId}`)),
+					contentWidth,
+				)
+			: [targetLine]),
+		...taskLines,
 		cardUnitsLine(theme, "status", statusUnits, contentWidth),
-		...trustCardLines(theme, row, contentWidth),
-		...(row.budget !== undefined
+		...trustCardLines(theme, row, contentWidth, options.expanded === true),
+		...(options.expanded === true && row.budget !== undefined
 			? [
 					...cardWrappedValueLines(
 						theme,
@@ -669,19 +706,19 @@ function renderDispatchCard(
 	// never arguments, across the stdout seam) and the recent-tool trail.
 	const currentTool = row.currentTool ?? null;
 	const recentTools = row.recentTools ?? [];
-	if (currentTool !== null || recentTools.length > 0) {
+	if (!row.progress && (currentTool !== null || recentTools.length > 0)) {
 		const toolUnits = [
 			currentTool !== null ? theme.fg("action", `${currentTool} running`) : theme.fg("dim", "idle"),
 			...(recentTools.length > 0 ? [theme.fg("muted", `recent ${recentTools.join(" ")}`)] : []),
 		];
 		bodyLines.push(cardUnitsLine(theme, "tools", toolUnits, contentWidth));
 	}
-	// Live worker progress is expanded detail, never a default row: five running
-	// scouts must stay five compact cards until the operator opens one.
-	if (options.expanded === true && row.progress) {
+	// One current-operation row is useful at a glance; prose and policy expand on demand.
+	if (row.progress) {
 		const doing = progressActionLine(theme, row.progress, contentWidth);
 		if (doing !== null) bodyLines.push(doing);
-		bodyLines.push(...progressAnswerLines(theme, row.progress, row.runId, contentWidth));
+		if (options.expanded === true)
+			bodyLines.push(...progressAnswerLines(theme, row.progress, row.runId, contentWidth, row.resultContract));
 	}
 	if (row.steerAcknowledgement) {
 		bodyLines.push(
@@ -922,11 +959,13 @@ function formatDispatchBoardLines(
 ): string[] {
 	if (rows.length === 0) {
 		const theme = clioTheme();
-		const lines = ["", "No fleet runs yet", "Delegated runs appear here with task, status, and telemetry.", ""];
-		return lines.map((line) => {
-			const padding = Math.max(0, Math.floor((width - visibleWidth(line)) / 2));
-			return theme.fg("dim", " ".repeat(padding) + line);
-		});
+		const lines = ["", "No fleet runs yet", "Use /run or /delegate to start a run.", ""];
+		return lines
+			.flatMap((line) => wrapTextWithAnsi(line, Math.max(1, width)))
+			.map((line) => {
+				const padding = Math.max(0, Math.floor((width - visibleWidth(line)) / 2));
+				return theme.fg("dim", " ".repeat(padding) + line);
+			});
 	}
 
 	const endpointActive: Record<string, number> = { ...foregroundStreamUsage() };
@@ -1124,6 +1163,7 @@ function toRow(entry: ObservabilityRunSummary, now: number): DispatchBoardRow {
 	const progress = entry.progress;
 	return {
 		...(progress !== undefined ? { progress } : {}),
+		...(entry.resultContract !== undefined ? { resultContract: entry.resultContract } : {}),
 		runId: entry.runId,
 		agentId: entry.agentId,
 		...(entry.agentAudience !== undefined ? { agentAudience: entry.agentAudience } : {}),

package/src/interactive/editor-submit.ts

@@ -126,7 +126,7 @@ export interface EditorSubmitController {
 	shutdownEditorBash(): Promise<void>;
 }
 
-type EditorSteerSubmission = "unhandled" | "accepted" | "rejected";
+type EditorSteerSubmission = "accepted" | "rejected";
 
 /** Owns editor submission and the one local bash process attached to it. */
 export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubmitController {
@@ -284,10 +284,17 @@ export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubm
 		let running: RunningDispatchRef[] = [];
 		try {
 			running = deps.dispatch.snapshot().running.map((run) => ({ runId: run.runId, agentId: run.agentId }));
-		} catch {
-			running = [];
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			deps.notify(
+				"error",
+				`cannot resolve steer to @${mention.target}: ${msg}; retry when Fleet Runs is available`,
+				`steer:${mention.target}`,
+			);
+			return "rejected";
 		}
-		if (running.length === 0) return "unhandled";
+		// The parser owns addressed syntax even after the last worker exits.
+		// File completion quotes bare filenames that would otherwise match it.
 		const resolution = resolveSteerTarget(mention.target, running);
 		if (resolution.kind === "match") {
 			try {
@@ -314,14 +321,16 @@ export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubm
 		}
 		deps.notify(
 			"warning",
-			`no running dispatch matches @${mention.target}; running: ${formatSteerCandidates(running)}`,
+			`no running dispatch matches @${mention.target}; running: ${formatSteerCandidates(running) || "none"}; choose an active target in Fleet Runs or remove the @target to send to the main agent`,
 			`steer:${mention.target}`,
 		);
 		return "rejected";
 	};
 
-	const handleEditorSteerMention = (mention: { target: string; text: string }): boolean =>
-		submitEditorSteerMention(mention) !== "unhandled";
+	const handleEditorSteerMention = (mention: { target: string; text: string }): boolean => {
+		submitEditorSteerMention(mention);
+		return true;
+	};
 
 	const submitEditorText = (text: string): void => {
 		const literalText = unguardPastedEditorOperator(text);
@@ -344,18 +353,16 @@ export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubm
 		const steerMention = parseEditorSteerMention(trimmed);
 		if (steerMention) {
 			const submission = submitEditorSteerMention(steerMention);
-			if (submission !== "unhandled") {
-				if (submission === "accepted") {
-					deps.editor.addToHistory(literalText);
-					deps.editor.setText("");
-				} else {
-					// Resolution and dispatch failures are correctable rejections. Pi
-					// has already cleared the editor, so explicitly restore the draft.
-					deps.editor.setText(literalText);
-				}
-				deps.ui.requestRender();
-				return;
+			if (submission === "accepted") {
+				deps.editor.addToHistory(literalText);
+				deps.editor.setText("");
+			} else {
+				// Resolution and dispatch failures are correctable rejections. Pi
+				// has already cleared the editor, so explicitly restore the draft.
+				deps.editor.setText(literalText);
 			}
+			deps.ui.requestRender();
+			return;
 		}
 		const command = parseSlashCommand(trimmed);
 		if (command.kind === "editor" || command.kind === "interrupt") {
@@ -419,14 +426,12 @@ export function createEditorSubmitController(deps: EditorSubmitDeps): EditorSubm
 		const steerMention = parseEditorSteerMention(trimmed);
 		if (steerMention) {
 			const submission = submitEditorSteerMention(steerMention);
-			if (submission !== "unhandled") {
-				if (submission === "rejected") {
-					throw new Error("queued boot steer was not admitted; preserving it for recovery");
-				}
-				deps.editor.addToHistory(literalText);
-				deps.ui.requestRender();
-				return;
+			if (submission === "rejected") {
+				throw new Error("queued boot steer was not admitted; preserving it for recovery");
 			}
+			deps.editor.addToHistory(literalText);
+			deps.ui.requestRender();
+			return;
 		}
 		const command = parseSlashCommand(trimmed);
 		if (isRejectedCommand(command)) {

package/src/interactive/footer/widgets.ts

@@ -38,6 +38,8 @@ import {
 	sectionTag,
 } from "../theme/index.js";
 
+import { fitIdentityLabel } from "../theme/labels.js";
+
 export interface ToolTallySnapshot {
 	tools: Readonly<Record<string, number>>;
 	errors: number;
@@ -263,20 +265,22 @@ export function compactPrimaryLine(
 	const safeWidth = Math.max(1, Math.floor(width));
 	let git = safeWidth >= COMPACT_GIT_MIN_WIDTH ? gitChip(theme, workspace.branch, workspace.dirty) : null;
 	let right = buildHarnessStatePill(theme, status, toolCounts, dispatchRows, tick, now, safeWidth, true);
-	let left = joinSections(theme, [theme.fg("muted", workspace.cwd), git]);
-
-	if (visibleWidth(left) + 1 + visibleWidth(right) > safeWidth) {
-		right = buildHarnessStatePill(theme, status, toolCounts, dispatchRows, tick, now, safeWidth, false);
-	}
+	// A long temporary parent must yield before the active worker count.
+	const cwd = fitIdentityLabel(workspace.cwd, Math.max(8, safeWidth - visibleWidth(right) - 1));
+	let left = joinSections(theme, [theme.fg("muted", cwd), git]);
 
 	if (git && visibleWidth(left) + 1 + visibleWidth(right) > safeWidth) {
 		git = null;
-		left = theme.fg("muted", workspace.cwd);
+		left = theme.fg("muted", cwd);
+	}
+
+	if (visibleWidth(left) + 1 + visibleWidth(right) > safeWidth) {
+		right = buildHarnessStatePill(theme, status, toolCounts, dispatchRows, tick, now, safeWidth, false);
 	}
 
 	if (visibleWidth(left) + 1 + visibleWidth(right) > safeWidth) {
 		const maxCwdWidth = Math.max(1, safeWidth - visibleWidth(right) - 1);
-		left = theme.fg("muted", truncateToWidth(workspace.cwd, maxCwdWidth, "…", true));
+		left = theme.fg("muted", fitIdentityLabel(workspace.cwd, maxCwdWidth));
 	}
 
 	return joinColumns(left, right, safeWidth);
@@ -1077,8 +1081,7 @@ function buildHarnessStatePill(
 	fleetSummaryIsAction = false,
 ): string {
 	const safeWidth = Math.max(1, Math.floor(width));
-	const badge =
-		showBadge && safeWidth >= 48 ? harnessBadge(theme, status, toolCounts, dispatchRows, fleetSummaryIsAction) : "";
+	const badge = showBadge ? harnessBadge(theme, status, toolCounts, dispatchRows, fleetSummaryIsAction) : "";
 	// Idleness is absence of work, not a phase worth narrating. If a tool or
 	// fleet remains live while the harness settles, keep that activity without
 	// prefixing it with an idle glyph.

package/src/interactive/interactive-presentation.ts

@@ -40,7 +40,6 @@ import { parseSlashCommand, type RunIo } from "./slash-commands.js";
 import { createStatusController, type StatusController, type TurnSummary } from "./status/index.js";
 import type { SmoothStreamingMode } from "./stream-pacer.js";
 import { processAutoPacingAllowed } from "./stream-pacing-policy.js";
-import { formatTargetLabel } from "./theme/index.js";
 import { createWelcomeDashboard, type WelcomeDashboardComponent } from "./welcome-dashboard.js";
 import { readWorkerReceiptFacts } from "./worker-receipts.js";
 import type { WorkspaceFacts } from "./workspace-facts.js";
@@ -443,8 +442,8 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 	const editorChrome: EditorChrome = {
 		getModelLabel: () => {
 			const current = deps.getSettings?.();
-			// The rail is the narrowest of the three, so it drops the spaces.
-			return formatTargetLabel(current?.chat?.target, current?.chat?.model, { separator: "·" });
+			// Keep raw fields separate through the terminal-lease proxy until render knows its width.
+			return { targetId: current?.chat?.target, modelId: current?.chat?.model };
 		},
 		getThinkingLabel: () => {
 			const current = deps.getSettings?.();

package/src/interactive/mux-bridge.ts

@@ -14,13 +14,9 @@
  *   operator turn passes through several phases inside one window, of which
  *   only the last is worth a wire call.
  *
- * What this bridge deliberately no longer does is open panes. The phase 3/4
- * integration projected every dispatch onto a viewer pane in a hidden Fleet
- * tab (an `agents` policy knob, a keep-failed close policy, resume adoption,
- * role-vocabulary sidebar labels). All of it duplicated the native fleet
- * surfaces into panes the operator had not asked for; the one pane that
- * renders runs is now the operator-pulled watch pane (`watch-pane.ts`), and
- * the policy line lives in `pane-policy.ts`.
+ * The bridge does not open panes. The operator opens the shared watch pane
+ * (`watch-pane.ts`) to inspect runs already shown by the native fleet
+ * surfaces. Pane ownership policy lives in `pane-policy.ts`.
  */
 
 import { type AgentStatusChangedPayload, BusChannels, type DispatchRunIdentity } from "../core/bus-events.js";

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

@@ -31,7 +31,7 @@ import {
 } from "./dispatch-board.js";
 import { compileFleetRunPreview, type FleetRunPreview, type FleetRunPreviewInput } from "./fleet-run-preview.js";
 import { openMemoryOverlay } from "./memory-overlay.js";
-import { buildHint, showClioOverlayFrame } from "./overlay-frame.js";
+import { buildResponsiveHint, type HintEntry, showClioOverlayFrame } from "./overlay-frame.js";
 import type { OverlayTransitions } from "./overlay-transitions.js";
 import {
 	type ContextResetMutationChoice,
@@ -348,13 +348,20 @@ export function createOverlayGeneralOpeners(deps: OverlayGeneralOpenersDeps): Ov
 		deps.requestRender();
 	};
 
-	const dispatchBoardHint = (): string => {
+	const dispatchBoardHint = (innerWidth: number): string => {
 		const row = deps.dispatchBoard.selectedRow();
-		const entries = [{ key: "↑↓", verb: "select" }];
-		if (row) entries.push({ key: "Enter", verb: deps.dispatchBoard.detailExpanded() ? "hide detail" : "detail" });
-		if (row && isDispatchBoardRowSteerable(row)) entries.push({ key: "s", verb: "steer" });
-		if (row && isDispatchBoardRowCancellable(row)) entries.push({ key: "x", verb: "cancel" });
-		return buildHint(entries);
+		const entries: HintEntry[] = [];
+		if (row) {
+			entries.push({ key: "↑↓", verb: "select" });
+			entries.push({
+				key: "Enter",
+				verb: deps.dispatchBoard.detailExpanded() ? "hide detail" : "detail",
+				critical: false,
+			});
+		}
+		if (row && isDispatchBoardRowSteerable(row)) entries.push({ key: "s", verb: "steer", critical: true });
+		if (row && isDispatchBoardRowCancellable(row)) entries.push({ key: "x", verb: "cancel", critical: true });
+		return buildResponsiveHint(entries)(innerWidth);
 	};
 
 	/**

package/src/interactive/overlays/cwd-fallback.ts

@@ -1,5 +1,5 @@
 /**
- * cwd-fallback overlay (Phase 12 slice 12d).
+ * cwd-fallback overlay.
  *
  * Two-choice overlay shown after `session.resume(...)` when the recorded
  * cwd no longer exists on disk (see src/domains/session/cwd-fallback.ts).