pi-cockpit 0.20.0 → 0.22.0

package/package.json

@@ -1,85 +1,85 @@
-{
-  "name": "pi-cockpit",
-  "version": "0.20.0",
-  "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
-  "type": "module",
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "tui",
-    "teammate",
-    "todo"
-  ],
-  "license": "MIT",
-  "files": [
-    "src/",
-    "themes/",
-    "README.md"
-  ],
-  "scripts": {
-    "test": "node --test --experimental-transform-types tests/config.test.ts tests/public-events.test.ts tests/maestro-store.test.ts tests/split-pane.test.ts tests/editor-bottom.test.ts tests/sidebar-render.test.ts tests/sidebar-controller.test.ts tests/viewport-stability.test.ts tests/quiet-tools.test.ts tests/edit-guard.test.ts tests/agents-store.test.ts tests/endpoint-store.test.ts tests/session-ui-state.test.ts tests/session-tabs.test.ts tests/agent-bar.test.ts tests/supervision-store.test.ts tests/bash-bg-store.test.ts tests/bash-bg-widget.test.ts tests/bash-bg-overlay.test.ts tests/todo-overlay.test.ts tests/agent-overlay.test.ts tests/todo-store.test.ts tests/render.test.ts tests/agent-scroll.test.ts tests/session-bar.test.ts tests/session-detail.test.ts tests/footer.test.ts tests/extension-status.test.ts tests/teammate-message.test.ts tests/input-routing.test.ts tests/input-history-store.test.ts tests/unified-editor.test.ts tests/integration-contract.test.ts tests/stack-widget.test.ts tests/zen-render.test.ts tests/zen-browse.test.ts tests/zen-sheet.test.ts tests/settings-view.test.ts tests/thinking-fold.test.ts tests/thinking-timer.test.ts tests/tick-policy.test.ts tests/ambient.test.ts tests/viewport.test.ts tests/theme-picker.test.ts tests/model-picker.test.ts tests/title-gen.test.ts tests/title-llm.test.ts tests/settings-registry.test.ts tests/settings-coordinator.test.ts tests/settings-locale.test.ts tests/tui-i18n.test.ts tests/settings-shell.test.ts tests/settings-cockpit-provider.test.ts tests/settings-cross-package.test.ts tests/ui-primitives.test.ts tests/settings-shell-secret.test.ts tests/settings-shell-listcrud.test.ts tests/capturing-overlay.test.ts tests/claude-editor.test.ts tests/fullscreen-controller.test.ts tests/transcript-selection.test.ts tests/terminal-cleanup.test.ts tests/terminal-capability.test.ts tests/usage-core.test.ts tests/usage-extension.test.ts tests/usage-history.test.ts tests/usage-sparkline.test.ts",
-    "typecheck": "tsc --noEmit",
-    "prepack": "node ../../scripts/bundle-settings-core.mjs",
-    "postpack": "node ../../scripts/bundle-settings-core.mjs --clean"
-  },
-  "pi": {
-    "extensions": [
-      "./src/extension/index.ts"
-    ],
-    "themes": [
-      "./themes"
-    ]
-  },
-  "dependencies": {
-    "pi-maestro-settings-core": "0.2.1",
-    "proper-lockfile": "4.1.2"
-  },
-  "bundledDependencies": [
-    "pi-maestro-settings-core"
-  ],
-  "peerDependencies": {
-    "@earendil-works/pi-agent-core": "*",
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*",
-    "pi-maestro-teammate": "^2.1.0",
-    "typebox": "*"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-agent-core": {
-      "optional": true
-    },
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-coding-agent": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    },
-    "pi-maestro-teammate": {
-      "optional": true
-    },
-    "typebox": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@earendil-works/pi-agent-core": "0.84.4",
-    "@earendil-works/pi-ai": "0.84.4",
-    "@earendil-works/pi-coding-agent": "0.84.4",
-    "@earendil-works/pi-tui": "0.84.4",
-    "@types/node": "^22.0.0",
-    "pi-maestro-teammate": "2.3.0",
-    "typebox": "1.3.7",
-    "typescript": "^5.5.0"
-  },
-  "main": "./src/index.ts",
-  "exports": {
-    ".": "./src/index.ts",
-    "./v1/events": "./src/public/v1/events.ts",
-    "./src/*": "./src/*"
-  }
-}
+{
+  "name": "pi-cockpit",
+  "version": "0.22.0",
+  "description": "Responsive Maestro operations sidebar, fallback status widgets, and footer for Pi.",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "tui",
+    "teammate",
+    "todo"
+  ],
+  "license": "MIT",
+  "files": [
+    "src/",
+    "themes/",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test --experimental-transform-types tests/config.test.ts tests/public-events.test.ts tests/maestro-store.test.ts tests/split-pane.test.ts tests/editor-bottom.test.ts tests/sidebar-render.test.ts tests/sidebar-controller.test.ts tests/viewport-stability.test.ts tests/quiet-tools.test.ts tests/edit-guard.test.ts tests/agents-store.test.ts tests/endpoint-store.test.ts tests/session-ui-state.test.ts tests/session-tabs.test.ts tests/agent-bar.test.ts tests/supervision-store.test.ts tests/bash-bg-store.test.ts tests/bash-bg-widget.test.ts tests/bash-bg-overlay.test.ts tests/todo-overlay.test.ts tests/agent-overlay.test.ts tests/todo-store.test.ts tests/render.test.ts tests/agent-scroll.test.ts tests/session-bar.test.ts tests/session-detail.test.ts tests/footer.test.ts tests/extension-status.test.ts tests/teammate-message.test.ts tests/input-routing.test.ts tests/input-history-store.test.ts tests/unified-editor.test.ts tests/integration-contract.test.ts tests/stack-widget.test.ts tests/zen-render.test.ts tests/zen-browse.test.ts tests/zen-sheet.test.ts tests/settings-view.test.ts tests/thinking-fold.test.ts tests/thinking-timer.test.ts tests/tick-policy.test.ts tests/ambient.test.ts tests/viewport.test.ts tests/theme-picker.test.ts tests/model-picker.test.ts tests/title-gen.test.ts tests/title-llm.test.ts tests/settings-registry.test.ts tests/settings-coordinator.test.ts tests/settings-locale.test.ts tests/tui-i18n.test.ts tests/settings-shell.test.ts tests/settings-cockpit-provider.test.ts tests/settings-cross-package.test.ts tests/ui-primitives.test.ts tests/settings-shell-secret.test.ts tests/settings-shell-listcrud.test.ts tests/capturing-overlay.test.ts tests/claude-editor.test.ts tests/fullscreen-controller.test.ts tests/transcript-selection.test.ts tests/terminal-cleanup.test.ts tests/terminal-capability.test.ts tests/usage-core.test.ts tests/usage-extension.test.ts tests/usage-history.test.ts tests/usage-sparkline.test.ts",
+    "typecheck": "tsc --noEmit",
+    "prepack": "node ../../scripts/bundle-settings-core.mjs",
+    "postpack": "node ../../scripts/bundle-settings-core.mjs --clean"
+  },
+  "pi": {
+    "extensions": [
+      "./src/extension/index.ts"
+    ],
+    "themes": [
+      "./themes"
+    ]
+  },
+  "dependencies": {
+    "pi-maestro-settings-core": "0.2.1",
+    "proper-lockfile": "4.1.2"
+  },
+  "bundledDependencies": [
+    "pi-maestro-settings-core"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "pi-maestro-teammate": "^2.5.0",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-agent-core": {
+      "optional": true
+    },
+    "@earendil-works/pi-ai": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    },
+    "pi-maestro-teammate": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-agent-core": "0.84.4",
+    "@earendil-works/pi-ai": "0.84.4",
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
+    "@types/node": "^22.0.0",
+    "pi-maestro-teammate": "2.5.0",
+    "typebox": "1.3.7",
+    "typescript": "^5.5.0"
+  },
+  "main": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./v1/events": "./src/public/v1/events.ts",
+    "./src/*": "./src/*"
+  }
+}

package/src/agents-store.ts

@@ -11,19 +11,227 @@ import type {
 } from "pi-maestro-teammate/v1/types";
 import type {
 	RuntimeAgentReadEntityV2,
+	RuntimeReadModelChangeV2,
 	RuntimeReadModelDeltaV2,
 	RuntimeReadModelOwnershipV2,
 	RuntimeReadModelSnapshotV2,
-} from "pi-maestro-teammate/v2/runtime";
-import {
-	RuntimeReadModelProjectionV2,
-	parseRuntimeReadModelDeltaV2,
-	parseRuntimeReadModelOwnershipV2,
-	parseRuntimeReadModelSnapshotV2,
+	RuntimeReadModelSourceV2,
 } from "pi-maestro-teammate/v2/runtime";
 import { sanitizeExtensionStatusText } from "./extension-status.ts";
 import { EXPERT_LEADER_NAME, type AgentRow, type AgentStatus } from "./types.ts";
 
+export const RUNTIME_READ_MODEL_DELTA_EVENT = "teammate:runtime-read-model-delta-v2";
+export const RUNTIME_READ_MODEL_QUERY_EVENT = "teammate:runtime-read-model-query-v2";
+export const RUNTIME_READ_MODEL_SNAPSHOT_EVENT = "teammate:runtime-read-model-snapshot-v2";
+export const RUNTIME_READ_MODEL_UNAVAILABLE_EVENT = "teammate:runtime-read-model-unavailable-v2";
+
+/** Keep Cockpit loadable when its optional Teammate peer is absent. */
+export function runtimeV2ReadEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
+	return env.PI_RUNTIME_BROKER?.trim().toLowerCase() === "sqlite"
+		&& (env.PI_RUNTIME_V2_READ === undefined || env.PI_RUNTIME_V2_READ === "1");
+}
+
+function plainObject(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function safeInteger(value: unknown, minimum = 0): value is number {
+	return Number.isSafeInteger(value) && (value as number) >= minimum;
+}
+
+function identifier(value: unknown): value is string {
+	return typeof value === "string" && value.length > 0 && value.length <= 1024 && !value.includes("\0");
+}
+
+function parseRuntimeReadModelOwnershipV2(value: unknown): RuntimeReadModelOwnershipV2 | undefined {
+	if (!plainObject(value)
+		|| !identifier(value.workspaceId)
+		|| !identifier(value.sessionId)
+		|| !identifier(value.sourceId)
+		|| !safeInteger(value.generation, 1)) return undefined;
+	return {
+		workspaceId: value.workspaceId,
+		sessionId: value.sessionId,
+		sourceId: value.sourceId,
+		generation: value.generation,
+	};
+}
+
+function parseSource(value: unknown): RuntimeReadModelSourceV2 | undefined {
+	if (!plainObject(value)
+		|| !identifier(value.streamId)
+		|| !safeInteger(value.revision, 1)
+		|| !safeInteger(value.generation, 1)) return undefined;
+	const projection = value.projection === undefined
+		? undefined
+		: parseRuntimeReadModelOwnershipV2(value.projection);
+	if (value.projection !== undefined && !projection) return undefined;
+	return {
+		streamId: value.streamId,
+		revision: value.revision,
+		generation: value.generation,
+		...(projection ? { projection } : {}),
+	};
+}
+
+const AGENT_STATUSES = new Set<RuntimeAgentReadEntityV2["status"]>([
+	"pending", "running", "retrying", "sleeping", "completed", "failed", "terminated",
+]);
+
+function parseRuntimeEntity(value: unknown): RuntimeAgentReadEntityV2 | undefined {
+	if (!plainObject(value)
+		|| !identifier(value.correlationId)
+		|| !safeInteger(value.generation, 1)
+		|| !identifier(value.agent)
+		|| !AGENT_STATUSES.has(value.status as RuntimeAgentReadEntityV2["status"])
+		|| !safeInteger(value.startedAt)
+		|| !safeInteger(value.lastActivityAt)) return undefined;
+	for (const key of ["name", "task", "spawnedBy", "parentCorrelationId", "phase", "requestedModel", "resolvedModel", "lastMessage", "error"] as const) {
+		if (value[key] !== undefined && typeof value[key] !== "string") return undefined;
+	}
+	if (value.dependencies !== undefined
+		&& (!Array.isArray(value.dependencies) || value.dependencies.some((item) => !safeInteger(item)))) return undefined;
+	if (value.attemptedModels !== undefined
+		&& (!Array.isArray(value.attemptedModels) || value.attemptedModels.some((item) => typeof item !== "string"))) return undefined;
+	if (value.projection !== undefined && !parseRuntimeReadModelOwnershipV2(value.projection)) return undefined;
+	return structuredClone(value) as unknown as RuntimeAgentReadEntityV2;
+}
+
+function parseRuntimeReadModelDeltaV2(value: unknown): RuntimeReadModelDeltaV2 | undefined {
+	if (!plainObject(value)
+		|| value.version !== 2
+		|| value.revision !== 1
+		|| value.kind !== "agent-runs-delta"
+		|| !safeInteger(value.baseCursor)
+		|| !safeInteger(value.nextCursor, 1)
+		|| value.nextCursor <= value.baseCursor
+		|| !Array.isArray(value.changes)) return undefined;
+	const source = parseSource(value.source);
+	if (!source) return undefined;
+	const changes: RuntimeReadModelChangeV2[] = [];
+	for (const change of value.changes) {
+		if (!plainObject(change)) return undefined;
+		if (change.kind === "upsert") {
+			const entity = parseRuntimeEntity(change.entity);
+			if (!entity) return undefined;
+			changes.push({ kind: "upsert", entity });
+			continue;
+		}
+		if (change.kind === "tombstone"
+			&& identifier(change.correlationId)
+			&& safeInteger(change.generation, 1)) {
+			changes.push({ kind: "tombstone", correlationId: change.correlationId, generation: change.generation });
+			continue;
+		}
+		return undefined;
+	}
+	return {
+		version: 2,
+		revision: 1,
+		kind: "agent-runs-delta",
+		baseCursor: value.baseCursor,
+		nextCursor: value.nextCursor,
+		source,
+		changes,
+	};
+}
+
+function parseRuntimeReadModelSnapshotV2(value: unknown): RuntimeReadModelSnapshotV2 | undefined {
+	if (!plainObject(value)
+		|| value.version !== 2
+		|| value.revision !== 1
+		|| value.kind !== "agent-runs-snapshot"
+		|| !safeInteger(value.cursor)
+		|| !Array.isArray(value.agents)) return undefined;
+	const source = parseSource(value.source);
+	if (!source) return undefined;
+	const agents = value.agents.map(parseRuntimeEntity);
+	if (agents.some((agent) => agent === undefined)) return undefined;
+	return {
+		version: 2,
+		revision: 1,
+		kind: "agent-runs-snapshot",
+		cursor: value.cursor,
+		source,
+		agents: agents as RuntimeAgentReadEntityV2[],
+	};
+}
+
+function cloneRuntimeEntity(entity: RuntimeAgentReadEntityV2): RuntimeAgentReadEntityV2 {
+	return structuredClone(entity);
+}
+
+class RuntimeReadModelProjectionV2 {
+	readonly #agents = new Map<string, RuntimeAgentReadEntityV2>();
+	#cursor = 0;
+	#source: RuntimeReadModelSourceV2 = { streamId: "uninitialized", revision: 1, generation: 1 };
+	#initialized = false;
+
+	get cursor(): number { return this.#cursor; }
+
+	applySnapshot(input: unknown): boolean {
+		const snapshot = parseRuntimeReadModelSnapshotV2(input);
+		if (!snapshot) return false;
+		if (this.#initialized && snapshot.source.streamId === this.#source.streamId) {
+			if (snapshot.source.generation < this.#source.generation) return false;
+			if (snapshot.source.generation === this.#source.generation && snapshot.cursor < this.#cursor) return false;
+		}
+		const next = new Map<string, RuntimeAgentReadEntityV2>();
+		for (const agent of snapshot.agents) {
+			const existing = next.get(agent.correlationId);
+			if (existing && existing.generation > agent.generation) continue;
+			next.set(agent.correlationId, cloneRuntimeEntity(agent));
+		}
+		this.#agents.clear();
+		for (const [id, agent] of next) this.#agents.set(id, agent);
+		this.#cursor = snapshot.cursor;
+		this.#source = { ...snapshot.source };
+		this.#initialized = true;
+		return true;
+	}
+
+	applyDelta(input: unknown): boolean {
+		const delta = parseRuntimeReadModelDeltaV2(input);
+		if (!delta
+			|| delta.baseCursor !== this.#cursor
+			|| delta.nextCursor <= this.#cursor
+			|| delta.source.streamId !== this.#source.streamId
+			|| delta.source.generation !== this.#source.generation
+			|| JSON.stringify(delta.source.projection) !== JSON.stringify(this.#source.projection)
+			|| delta.source.revision !== delta.nextCursor) return false;
+		const next = new Map([...this.#agents].map(([id, agent]) => [id, cloneRuntimeEntity(agent)]));
+		for (const change of delta.changes) {
+			if (change.kind === "upsert") {
+				const current = next.get(change.entity.correlationId);
+				if (current && change.entity.generation < current.generation) return false;
+				next.set(change.entity.correlationId, cloneRuntimeEntity(change.entity));
+				continue;
+			}
+			const current = next.get(change.correlationId);
+			if (current && change.generation < current.generation) return false;
+			if (!current || change.generation === current.generation) next.delete(change.correlationId);
+		}
+		this.#agents.clear();
+		for (const [id, agent] of next) this.#agents.set(id, agent);
+		this.#cursor = delta.nextCursor;
+		this.#source = { ...delta.source };
+		return true;
+	}
+
+	snapshot(): RuntimeReadModelSnapshotV2 {
+		return {
+			version: 2,
+			revision: 1,
+			kind: "agent-runs-snapshot",
+			cursor: this.#cursor,
+			source: { ...this.#source },
+			agents: [...this.#agents.values()]
+				.sort((left, right) => left.correlationId.localeCompare(right.correlationId))
+				.map(cloneRuntimeEntity),
+		};
+	}
+}
+
 const STATUS_TEXT_MAX = 48;
 /** Selected-session output kept for the expandable fixed detail region. */
 export const SESSION_CONTENT_MAX = 2_048;

package/src/config.ts

@@ -76,6 +76,7 @@ const isCurrencyMode = (v: unknown): v is CurrencyMode => v === "usd" || v === "
 		agentsMode: isMode(o.agentsMode) ? o.agentsMode : base.agentsMode,
 		todoMode: isMode(o.todoMode) ? o.todoMode : base.todoMode,
 		todoExpanded: typeof o.todoExpanded === "boolean" ? o.todoExpanded : base.todoExpanded,
+		todoDurationChart: typeof o.todoDurationChart === "boolean" ? o.todoDurationChart : base.todoDurationChart,
 		stackStyle: isStackStyle(o.stackStyle) ? o.stackStyle : base.stackStyle,
 		hideNativeAgents: typeof o.hideNativeAgents === "boolean" ? o.hideNativeAgents : base.hideNativeAgents,
 		pinEditorBottom: typeof o.pinEditorBottom === "boolean" ? o.pinEditorBottom : base.pinEditorBottom,
@@ -168,6 +169,7 @@ export function mergeConfigDocument(raw: unknown, config: CockpitConfig): Record
 		agentsMode: config.agentsMode,
 		todoMode: config.todoMode,
 		todoExpanded: config.todoExpanded,
+		todoDurationChart: config.todoDurationChart,
 		stackStyle: config.stackStyle,
 		hideNativeAgents: config.hideNativeAgents,
 		pinEditorBottom: config.pinEditorBottom,

package/src/index.ts

@@ -4,7 +4,18 @@ import { getAgentDir, type ExtensionAPI, type ExtensionCommandContext, type Exte
 import type { TUI } from "@earendil-works/pi-tui";
 import { ambientKeysShouldYield, capturingOverlayVisible } from "./capturing-overlay.ts";
 import { Key, decodeKittyPrintable, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { AgentReadStoreRouter, effectiveAgentStatus, type CompletePayload, type MessagePayload, type StartedPayload } from "./agents-store.ts";
+import {
+	AgentReadStoreRouter,
+	RUNTIME_READ_MODEL_DELTA_EVENT,
+	RUNTIME_READ_MODEL_QUERY_EVENT,
+	RUNTIME_READ_MODEL_SNAPSHOT_EVENT,
+	RUNTIME_READ_MODEL_UNAVAILABLE_EVENT,
+	effectiveAgentStatus,
+	runtimeV2ReadEnabled,
+	type CompletePayload,
+	type MessagePayload,
+	type StartedPayload,
+} from "./agents-store.ts";
 import { AmbientSurfaceCache, nextUiPromptDepth, shouldHideWorkingDuration, statusText, titleFor, workingMessage, type AmbientState } from "./ambient.ts";
 import { generateTitleWithModel } from "./title-llm.ts";
 import { suggestTitle } from "./title-gen.ts";
@@ -120,13 +131,6 @@ import {
 	type CockpitConfig,
 } from "./types.ts";
 import type { MailboxHostRegistry } from "pi-maestro-teammate/v1/mailbox";
-import {
-	RUNTIME_READ_MODEL_DELTA_EVENT,
-	RUNTIME_READ_MODEL_QUERY_EVENT,
-	RUNTIME_READ_MODEL_SNAPSHOT_EVENT,
-	RUNTIME_READ_MODEL_UNAVAILABLE_EVENT,
-	runtimeV2ReadEnabled,
-} from "pi-maestro-teammate/v2/runtime";
 
 export {
 	EndpointStore,
@@ -357,6 +361,27 @@ export default function (pi: ExtensionAPI): void {
 	// thinking label / teammate tree still stream above the visible viewport.
 	let stabilityTui: TUI | undefined;
 	let viewportStabilityPatch: ViewportStabilityPatch | undefined;
+	const ensureViewportStability = (tui: TUI): void => {
+		// Native fullscreen owns a fixed application viewport and has no main-screen
+		// applyLineResets hook. Do not cache that expected miss: the same dynamic TUI
+		// reference can later dispatch to the regular renderer.
+		if (tui.mode === "fullscreen") return;
+		if (stabilityTui === tui && viewportStabilityPatch?.active) return;
+		viewportStabilityPatch?.detach();
+		const patch = attachViewportStability(tui);
+		viewportStabilityPatch = patch;
+		stabilityTui = patch.active ? tui : undefined;
+	};
+	const requestCapturedRender = (): void => {
+		try {
+			const tui = capturedTui;
+			if (!tui) return;
+			ensureViewportStability(tui);
+			tui.requestRender();
+		} catch {
+			// tui may be gone between sessions
+		}
+	};
 	// True while Cockpit owns a capturing overlay (bash jobs, theme picker,
 	// settings panel). Split-pane resize must yield to the overlay's focus and
 	// refuse to start while one is open; otherwise the resize listener — a
@@ -455,13 +480,7 @@ export default function (pi: ExtensionAPI): void {
 	// while the model thinks, then the settled duration. Pi owns the fold.
 	const thinkingTimer = new ThinkingFoldTimer({
 		getTui: () => capturedTui,
-		requestRender: () => {
-			try {
-				capturedTui?.requestRender();
-			} catch {
-				// tui may be gone between sessions
-			}
-		},
+		requestRender: requestCapturedRender,
 		getBaseLabel: () => (config.quietMode ? quietThinkingLabel() : undefined),
 		getGlyphs: () => resolveGlyphs(config.icons.mode),
 		isThinkingHidden: () => (lastCtx ? readHideThinkingBlock(lastCtx.cwd) : false),
@@ -601,7 +620,7 @@ export default function (pi: ExtensionAPI): void {
 			if (refreshAmbientSurface) refreshAmbient(now);
 			if (agentPriorityChanged) publishUiOwnership();
 			try {
-				capturedTui?.requestRender();
+				requestCapturedRender();
 				activeAgentOverlayRender?.();
 				sidebarController?.requestRender();
 			} catch {
@@ -691,6 +710,7 @@ export default function (pi: ExtensionAPI): void {
 			sidebar: ownsDock,
 			goal: ownsDock,
 			todoExpanded: effectiveTodoExpanded(),
+			todoDurationChart: config.todoDurationChart,
 			quiet: config.enabled && config.quietMode,
 			quietSymbols: config.quietSymbols,
 			static: config.staticMode,
@@ -747,13 +767,6 @@ export default function (pi: ExtensionAPI): void {
 	};
 
 
-	const ensureViewportStability = (tui: TUI): void => {
-		if (stabilityTui === tui) return;
-		viewportStabilityPatch?.detach();
-		viewportStabilityPatch = attachViewportStability(tui);
-		stabilityTui = tui;
-	};
-
 	const sessionListOverlayActive = (): boolean =>
 		capturingOverlayActive || ambientKeysShouldYield(capturedTui);
 
@@ -1916,6 +1929,7 @@ export default function (pi: ExtensionAPI): void {
 			sidebar: false,
 			goal: false,
 			todoExpanded: config.todoExpanded,
+			todoDurationChart: config.todoDurationChart,
 			quiet: false,
 			quietSymbols: config.quietSymbols,
 			static: config.staticMode,

package/src/public/v1/events.ts

@@ -195,6 +195,8 @@ export interface CockpitUiOwnershipV1 {
 	/** True only while the dock renders Maestro Goal state. */
 	goal: boolean;
 	todoExpanded: boolean;
+	/** Whether Flow should render the duration chart after a terminal todo advance. */
+	todoDurationChart?: boolean;
 	quiet: boolean;
 	quietSymbols: "check" | "dot";
 	/** Static mode: per-second churn (elapsed ticks, spinners) is suppressed. */

package/src/settings/cockpit-provider.ts

@@ -68,6 +68,7 @@ const CONFIG_KEYS = [
 	"agentsMode",
 	"todoMode",
 	"todoExpanded",
+	"todoDurationChart",
 	"stackStyle",
 	"hideNativeAgents",
 	"toolPalette",
@@ -164,6 +165,8 @@ const CATALOGS = {
 		"cockpit.agentsMode": "Agent display",
 		"cockpit.todoMode": "Todo display",
 		"cockpit.todoExpanded": "Todo expanded",
+		"cockpit.todoDurationChart": "Advance duration chart",
+		"cockpit.todoDurationChart.description": "Show a task-duration chart after advance completes the entire Todo list.",
 		"cockpit.stackStyle": "Stack projection",
 		"cockpit.hideNativeAgents": "Hide native agent widget",
 		"cockpit.icons.mode": "Icon mode",
@@ -249,6 +252,8 @@ const CATALOGS = {
 		"cockpit.agentsMode": "Agent 显示",
 		"cockpit.todoMode": "Todo 显示",
 		"cockpit.todoExpanded": "展开 Todo",
+		"cockpit.todoDurationChart": "Advance 耗时图",
+		"cockpit.todoDurationChart.description": "当 advance 完成整个 Todo 列表后显示任务耗时统计图。",
 		"cockpit.stackStyle": "栈投影",
 		"cockpit.hideNativeAgents": "隐藏原生 Agent 面板",
 		"cockpit.icons.mode": "图标模式",
@@ -367,8 +372,9 @@ const DEFINITIONS: readonly SettingDefinition[] = [
 	enumDefinition("agentsMode", "cockpit.group.panels", 0, "cockpit.agentsMode", ["list", "compact"], "live"),
 	enumDefinition("todoMode", "cockpit.group.panels", 1, "cockpit.todoMode", ["list", "compact"], "live"),
 	booleanDefinition("todoExpanded", "cockpit.group.panels", 2, "cockpit.todoExpanded", "live"),
+	booleanDefinition("todoDurationChart", "cockpit.group.panels", 3, "cockpit.todoDurationChart", "live", "cockpit.todoDurationChart.description"),
 	enumDefinition("stackStyle", "cockpit.group.layout", 4, "cockpit.stackStyle", ["classic", "zen"], "live"),
-	booleanDefinition("hideNativeAgents", "cockpit.group.panels", 3, "cockpit.hideNativeAgents", "live"),
+	booleanDefinition("hideNativeAgents", "cockpit.group.panels", 4, "cockpit.hideNativeAgents", "live"),
 	enumDefinition("sidebar.mode", "cockpit.group.sidebar", 0, "cockpit.sidebar.mode", ["auto", "on", "off"], "live"),
 	{
 		key: "sidebar.width",
@@ -789,7 +795,7 @@ function setUsageValue(usage: CockpitConfig["usage"], field: string, value: Json
 }
 
 function validValue(key: CockpitSettingKey, value: JsonValue): boolean {
-	if (["enabled", "staticMode", "pinEditorBottom", "doubleEscapeClearInput", "fullscreenInput", "copyOnSelect", "historyEnabled", "quietMode", "todoExpanded", "hideNativeAgents"].includes(key)) return typeof value === "boolean";
+	if (["enabled", "staticMode", "pinEditorBottom", "doubleEscapeClearInput", "fullscreenInput", "copyOnSelect", "historyEnabled", "quietMode", "todoExpanded", "todoDurationChart", "hideNativeAgents"].includes(key)) return typeof value === "boolean";
 	if (key === "sidebar.width") return typeof value === "number" && Number.isSafeInteger(value) && value >= 32 && value <= 56;
 	if (key === "title.maxLength") return typeof value === "number" && Number.isSafeInteger(value) && value >= 20 && value <= 200;
 	if (key === "title.generationModel") return typeof value === "string";

package/src/settings/settings-shell.ts

@@ -1283,7 +1283,15 @@ export class MaestroSettingsShell implements Component, Focusable {
 		const change = this.params.coordinator.changes(providerId).find((entry) => entry.key === definition.key && entry.scope === scope);
 		if (change?.operation === "unset") return this.t("settings.inherited");
 		if (change?.operation === "set") return this.formatValue(definition, change.value);
-		return this.displayConfigured(definition, this.configuredValue(this.params.coordinator.baseline(providerId), definition.key, scope));
+		const baseline = this.params.coordinator.baseline(providerId);
+		const configured = this.configuredValue(baseline, definition.key, scope);
+		if (!configured || configured.state === "absent") {
+			const effective = baseline?.effective.values.find((value) => value.key === definition.key);
+			if (effective) {
+				return `${this.t("settings.state.absent")} · ${this.t("settings.effective")} ${this.formatValue(definition, effective.value)}`;
+			}
+		}
+		return this.displayConfigured(definition, configured);
 	}
 
 	private configuredValue(snapshot: SettingsSnapshot | undefined, key: string, scope: SettingsScope) {

package/src/types.ts

@@ -260,6 +260,8 @@ export interface CockpitConfig {
 	agentsMode: ViewMode;
 	todoMode: ViewMode;
 	todoExpanded: boolean;
+	/** Show the duration chart after a terminal todo advance. */
+	todoDurationChart: boolean;
 	/** Above-editor stack projection: classic Todo/Agents widgets or the unified Zen stack. */
 	stackStyle: StackStyle;
 	hideNativeAgents: boolean;
@@ -318,6 +320,7 @@ export const DEFAULT_CONFIG: CockpitConfig = {
 	agentsMode: "list",
 	todoMode: "list",
 	todoExpanded: false,
+	todoDurationChart: true,
 	stackStyle: "classic",
 	hideNativeAgents: true,
 	pinEditorBottom: false,

package/src/viewport-stability.ts

@@ -10,7 +10,8 @@ interface ViewportTuiInternals {
 	previousLines?: string[];
 	previousViewportTop?: number;
 	previousHeight?: number;
-	terminal?: { rows: number };
+	previousWidth?: number;
+	terminal?: { columns: number; rows: number };
 }
 
 interface ViewportStabilityMarker {
@@ -44,18 +45,6 @@ function markerOf(fn: ApplyLineResets): ViewportStabilityMarker | undefined {
 	return (fn as ApplyLineResets & Record<symbol, ViewportStabilityMarker | undefined>)[VIEWPORT_STABILITY_MARKER];
 }
 
-const ANSI_ESCAPE = /\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07]*(?:\x07|\x1b\\))/g;
-const TRAILING_DURATION = /(\s(?:·\s*)?)(?:\d+(?:\.\d+)?s|\d+m\d{1,2}s)$/;
-
-function differsOnlyByTrailingDuration(previous: string, next: string): boolean {
-	const previousPlain = previous.replace(ANSI_ESCAPE, "");
-	const nextPlain = next.replace(ANSI_ESCAPE, "");
-	if (previousPlain === nextPlain) return false;
-	if (!TRAILING_DURATION.test(previousPlain) || !TRAILING_DURATION.test(nextPlain)) return false;
-	return previousPlain.replace(TRAILING_DURATION, "$1<duration>")
-		=== nextPlain.replace(TRAILING_DURATION, "$1<duration>");
-}
-
 function isKittyImageLine(line: string | undefined): boolean {
 	return typeof line === "string" && line.includes("\x1b_G");
 }
@@ -110,13 +99,17 @@ function resolveApplyLineResetsSlot(internals: ViewportTuiInternals): ApplyLineR
 }
 
 /**
- * Prevents timer-only churn above the visible viewport from forcing a full
- * redraw. The next frame keeps the terminal's actual hidden text, so the diff
- * baseline remains truthful; status, content, layout and image changes retain
- * pi-tui's native redraw path.
+ * Treats the hidden viewport prefix as immutable scrollback while frame size is
+ * stable. The next frame keeps the terminal's actual hidden text, so visible
+ * changes can use pi-tui's differential path instead of clearing and replaying
+ * the screen. Structural, resize and image changes retain the native path.
  */
 export function attachViewportStability(tui: TUI): ViewportStabilityPatch {
 	try {
+		// Native fullscreen has an application-owned fixed viewport. Its inherited
+		// applyLineResets method is not part of that renderer's diff path, so patching
+		// it would report a false-positive attachment on the shared TUI base class.
+		if (tui.mode === "fullscreen") return { active: false, detach() {} };
 		const internals = tui as unknown as ViewportTuiInternals;
 		const slot = resolveApplyLineResetsSlot(internals);
 		if (!slot) return { active: false, detach() {} };
@@ -137,6 +130,7 @@ export function attachViewportStability(tui: TUI): ViewportStabilityPatch {
 					&& Number.isFinite(viewportTop)
 					&& viewportTop > 0
 					&& this.previousHeight === this.terminal?.rows
+					&& this.previousWidth === this.terminal?.columns
 			) {
 				const hiddenEnd = Math.min(previousLines.length, Math.trunc(viewportTop));
 				const hiddenHasKittyImage = previousLines.slice(0, hiddenEnd).some(isKittyImageLine)
@@ -144,10 +138,7 @@ export function attachViewportStability(tui: TUI): ViewportStabilityPatch {
 				if (!hiddenHasKittyImage) {
 					for (let index = 0; index < hiddenEnd; index += 1) {
 						const previous = previousLines[index];
-						const next = nextLines[index];
-						if (previous !== undefined && next !== undefined && differsOnlyByTrailingDuration(previous, next)) {
-							nextLines[index] = previous;
-						}
+						if (previous !== undefined) nextLines[index] = previous;
 					}
 				}
 			}