pi-cockpit 0.20.0 → 0.21.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.21.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.4.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.4.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/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

@@ -357,6 +357,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 +476,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 +616,7 @@ export default function (pi: ExtensionAPI): void {
 			if (refreshAmbientSurface) refreshAmbient(now);
 			if (agentPriorityChanged) publishUiOwnership();
 			try {
-				capturedTui?.requestRender();
+				requestCapturedRender();
 				activeAgentOverlayRender?.();
 				sidebarController?.requestRender();
 			} catch {
@@ -691,6 +706,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 +763,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 +1925,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/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;
 					}
 				}
 			}