pi-firecode 0.8.1 → 1.0.0

package/review/ui.ts

@@ -1,116 +1,42 @@
 /**
- * /fire-review 的活动 UI：编辑器上方的固定活动条与 esc 取消接管。
+ * /fire-review 的界面接管：esc 取消的只读编辑器与终端标题。
  *
- * 只读 executor 传入的快照函数，自身不持状态；动画由组件内部计时器驱动，
- * dispose 时清理。审查看不见就等于坏了，这一层是可用性的主体。
+ * 审查进度不在这里画：它经占用频道（occupancy.ts）发布，由输入框外壳嵌进上边框，界面只此一处。
+ * Working 指示的可见性归输入框外壳（statusbar）统一管理，这里不碰。
  */
 import { basename } from "node:path";
 import {
 	CustomEditor,
-	DynamicBorder,
 	type ExtensionContext,
 	type KeybindingsManager,
-	type Theme,
 } from "@earendil-works/pi-coding-agent";
-import {
-	type Component,
-	type EditorTheme,
-	type TUI,
-	truncateToWidth,
-	visibleWidth,
-} from "@earendil-works/pi-tui";
-import { clip, formatDuration } from "../format.js";
+import type { EditorComponent, EditorTheme, TUI } from "@earendil-works/pi-tui";
 import type { Language } from "../config.js";
-import {
-	FLAME_FRAME_COUNT,
-	flameFrameLines,
-	flameFrameWidth,
-} from "../flame-frames.js";
-import type { ProgressTool, ReviewerProgress } from "./progress.js";
-import type { Phase } from "./state.js";
+import { clip } from "../format.js";
 
-const WIDGET_KEY = "fire-review";
-const FRAME_MS = 100;
-const SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-const REVIEW_COLOR: readonly [number, number, number] = [255, 153, 102];
-/** 火焰排版阈值：窄屏（48–59 列）收紧边距也要有火焰，<48 才退化为居中文本。 */
-const FLAME_MIN_WIDTH = 48;
-const FLAME_WIDE_WIDTH = 60;
-const FLAME_MARGIN_MIN = 6;
-const FLAME_MARGIN_NARROW = 2;
-const FLAME_GAP_MIN = 8;
-const FLAME_GAP_NARROW = 4;
-const FLAME_GAP_IDEAL = 16;
 let reviewTitleActive = false;
 
-/** 活动条渲染所需的一切；executor 每次状态变化后重新提供。 */
-export interface ActivityView {
-	phase: Phase;
-	round: number;
-	focus: string;
-	roundStartedAt: number;
-	progressStartedAt?: number;
-	reviewers: readonly ReviewerProgress[];
-	/** 当前 progress 属于谁：修复相据此判断能否把残留摘要当顾问裁决展示。 */
-	progressKind?: "reviewers" | "advisor";
-	advisorRunning: boolean;
-	consecutiveFailures?: number;
-	cwd?: string;
-	language: Language;
-}
-
-type ViewSource = () => ActivityView | undefined;
-
-export function showActivity(ctx: ExtensionContext, view: ViewSource): void {
-	if (ctx.hasUI === false) return;
-	if (typeof ctx.ui.setWorkingVisible === "function") ctx.ui.setWorkingVisible(false);
-	setReviewTitle(ctx, view());
-	if (typeof ctx.ui.setWidget !== "function") return;
-	ctx.ui.setWidget(
-		WIDGET_KEY,
-		(tui: TUI, theme: Theme) =>
-			new ActivityBar(view, theme, tui, () => tui.requestRender()),
-		{ placement: "aboveEditor" },
-	);
-}
-
-export function hideActivity(ctx: ExtensionContext): void {
-	if (ctx.hasUI === false) return;
-	if (typeof ctx.ui.setWorkingVisible === "function") ctx.ui.setWorkingVisible(true);
-	restoreReviewTitle(ctx);
-	if (typeof ctx.ui.setWidget === "function")
-		ctx.ui.setWidget(WIDGET_KEY, undefined);
-}
-
 /**
  * 审查等模型结论时（排队/审查中/顾问仲裁）接管编辑器：禁止输入，esc/Ctrl+C 随时取消。
+ * 返回解锁函数，还原成锁定前的编辑器工厂（可能是别的扩展设置的自定义编辑器）。
  *
  * 不能用全局输入钩子比对裸 \x1b：终端开启增强键盘协议后 esc 是带修饰的序列，
  * 字面量比较会漏。这里统一走 keybindings 匹配。
  * awaiting_fix 相不接管——那时是执行模型在改代码，用户应能正常输入与中断。
  */
-export function lockEditor(
-	ctx: ExtensionContext,
-	_view: ViewSource,
-	cancel: () => void,
-): void {
-	if (ctx.hasUI === false || typeof ctx.ui.setEditorComponent !== "function") return;
+export function lockEditor(ctx: ExtensionContext, cancel: () => void): () => void {
+	if (ctx.hasUI === false || typeof ctx.ui.setEditorComponent !== "function") return () => {};
+	const previous = ctx.ui.getEditorComponent();
 	ctx.ui.setEditorComponent((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => {
-		const editor = new ReviewEditor(tui, theme, keybindings, cancel);
-		return editor;
+		const frame = previous?.(tui, theme, keybindings) ?? new CustomEditor(tui, theme, keybindings);
+		return new ReviewEditor(tui, theme, keybindings, cancel, frame);
 	});
-}
-
-export function unlockEditor(ctx: ExtensionContext): void {
-	if (ctx.hasUI === false) return;
-	if (typeof ctx.ui.setEditorComponent === "function")
-		ctx.ui.setEditorComponent(undefined);
+	return () => ctx.ui.setEditorComponent(previous);
 }
 
 /**
- * 审查期间的只读编辑器。
- *
- * 动效由上方活动条负责，这里静态提示即可。
+ * 审查期间的只读编辑器：输入区收起成一行暗色提示，上下边框取自 frame（锁定前的编辑器），
+ * 外壳状态（审查进度、会话标题、模型）因此保持可见。
  */
 class ReviewEditor extends CustomEditor {
 	constructor(
@@ -118,408 +44,43 @@ class ReviewEditor extends CustomEditor {
 		theme: EditorTheme,
 		private readonly keys: KeybindingsManager,
 		private readonly cancel: () => void,
+		private readonly frame: EditorComponent,
 	) {
 		super(tui, theme, keys);
 	}
 
 	override handleInput(data: string): void {
-		if (
-			this.keys.matches(data, "app.interrupt") ||
-			this.keys.matches(data, "app.clear")
-		) {
-			this.cancel();
-			return;
-		}
+		if (this.keys.matches(data, "app.interrupt") || this.keys.matches(data, "app.clear")) this.cancel();
 		// 审查期间不接受任何其他输入：插话会污染本轮审查的会话证据。
 	}
 
-	override render(_width: number): string[] {
-		// pi-flow 交互：审查期间输入区完全隐藏，不额外插入一行提示。
-		return [];
-	}
-}
-
-// ---- 组件 ----
-
-abstract class Animated implements Component {
-	protected frame = 0;
-	private readonly timer: ReturnType<typeof setInterval>;
-
-	constructor(requestRender: () => void) {
-		this.timer = setInterval(() => {
-			this.frame += 1;
-			requestRender();
-		}, FRAME_MS);
-		this.timer.unref?.();
-	}
-
-	abstract render(width: number): string[];
-
-	invalidate(): void {}
-
-	dispose(): void {
-		clearInterval(this.timer);
-	}
-
-	protected spinner() {
-		return SPINNER[this.frame % SPINNER.length];
-	}
-}
-
-class ActivityBar extends Animated {
-	/** 官方边框组件；颜色仍用品牌橙，边框字符与宽度处理交给宿主。 */
-	private readonly border = new DynamicBorder(reviewColor);
-
-	constructor(
-		private readonly view: ViewSource,
-		private readonly theme: Theme,
-		private readonly tui: TUI,
-		requestRender: () => void,
-	) {
-		super(requestRender);
-	}
-
-	render(width: number): string[] {
-		const view = this.view();
-		if (!view) return [];
-		const safeWidth = Math.max(1, width);
-		const terminalRows = (this.tui as TUI & { terminal?: { rows?: number } }).terminal?.rows;
-		const maxTotalLines = terminalRows ? Math.floor(terminalRows * 0.7) : 16;
-		if (maxTotalLines <= 0) return [];
-		if (maxTotalLines === 1) {
-			return [centerLine(boldText(this.theme.fg("muted", activityTitle(view))), safeWidth)];
-		}
-		if (maxTotalLines === 2) {
-			const line1 = boldText(this.theme.fg("muted", activityTitle(view)));
-			let line2 = view.reviewers.map((r) => `${statusIcon(r.status)} ${shortModelName(r.label)}`).join(" ");
-			if (visibleWidth(line2) > safeWidth) {
-				line2 = view.reviewers.map((r) => shortModelName(r.label)).join(" ");
-			}
-			return [
-				centerLine(line1, safeWidth),
-				centerLine(this.theme.fg("muted", truncateToWidth(line2, safeWidth, "…")), safeWidth),
-			];
-		}
-
-		const n = view.reviewers.length;
-		// 极矮预算模式（总行数放不下边框+标题+全员）：去掉边框，将总预算行数全部分配给审查者
-		if (maxTotalLines <= n + 1) {
-			// 每人一行也装不下时按行分组压缩：丢行动作可以，静默丢审查者不行。
-			if (maxTotalLines <= n) {
-				const perLine = Math.ceil(n / maxTotalLines);
-				const lines: string[] = [];
-				for (let i = 0; i < n; i += perLine) {
-					const group = view.reviewers
-						.slice(i, i + perLine)
-						.map((r) => `${statusIcon(r.status)} ${shortModelName(r.label)}`)
-						.join("  ");
-					lines.push(centerLine(group, safeWidth));
-				}
-				return lines;
-			}
-			return view.reviewers.map((r) => {
-				const raw = r.details?.[0] || r.summary || (r.status === "running" ? r.action : "通过");
-				const act = raw.replace(/^[↳\s]+/u, "");
-				return centerLine(`${statusIcon(r.status)} ${shortModelName(r.label)}: ${act}${elapsedSuffix(r)}`, safeWidth);
-			});
-		}
-
-		const border = this.border.render(safeWidth)[0] ?? "";
-		const maxBodyLines = Math.max(1, maxTotalLines - 2);
-		const content = this.contentRows(view, maxBodyLines, safeWidth);
-		const body = safeWidth >= FLAME_MIN_WIDTH
-			? this.renderFlameBody(content, safeWidth, maxBodyLines)
-			: content.map((line) => centerLine(line, safeWidth));
-		const finalLines = [border, ...body.slice(0, maxBodyLines), border];
-		return finalLines.slice(0, maxTotalLines);
-	}
-
-	private contentRows(view: ActivityView, maxBodyLines: number, width: number): string[] {
-		const title = boldText(this.theme.fg("muted", activityTitle(view)));
-		const hintText = activityHint(view);
-		const hint = hintText ? this.theme.fg("dim", hintText) : "";
-		const reviewers = view.reviewers;
-		const n = reviewers.length;
-
-		// 紧凑纵向模式（放不下多行展开但每人一行能装下）：单行纵向用满整宽输出
-		if (maxBodyLines < n + 1) {
-			return reviewers.map((r) => {
-				const raw = r.details?.[0] || r.summary || (r.status === "running" ? r.action : "通过");
-				const act = raw.replace(/^[↳\s]+/u, "");
-				return `${statusIcon(r.status)} ${shortModelName(r.label)}: ${act}${elapsedSuffix(r)}`;
-			});
-		}
-
-		// 中等/多行展开模式：只要行数足够容纳审查者多行展开
-		if (maxBodyLines >= n * 2 + 1) {
-			// 预留标题/提示/呼吸空行的开销后再分每人行预算。
-			const budgetPer = Math.max(2, Math.floor((maxBodyLines - (hint ? 6 : 4)) / n));
-			const details = activityRows(view, this.spinner(), maxBodyLines, budgetPer);
-			return breathe(title, details, hint, maxBodyLines);
-		}
-
-		// 紧凑单行模式：标题 + 单行审查者；有余量时同样补呼吸空行。
-		const details = activityRows(view, this.spinner(), maxBodyLines - 1, 1);
-		return breathe(title, details, hint, maxBodyLines);
-	}
-
-	private renderFlameBody(contentRows: string[], width: number, maxBodyLines: number) {
-		const wide = width >= FLAME_WIDE_WIDTH;
-		const margin = wide ? FLAME_MARGIN_MIN : FLAME_MARGIN_NARROW;
-		const gapMin = wide ? FLAME_GAP_MIN : FLAME_GAP_NARROW;
-		const flameHeight = Math.min(maxBodyLines, Math.max(1, contentRows.length));
-		const rawFlame = flameFrameLines(flameHeight, this.frame % FLAME_FRAME_COUNT);
-		const flameWidth = flameFrameWidth(flameHeight);
-		const contentWidth = Math.min(
-			Math.max(1, ...contentRows.map((row) => visibleWidth(row))),
-			Math.max(1, width - margin * 2 - gapMin - flameWidth),
-		);
-		const gap = Math.max(
-			gapMin,
-			Math.min(
-				FLAME_GAP_IDEAL,
-				width - margin * 2 - contentWidth - flameWidth,
-			),
-		);
-		const group = contentWidth + gap + flameWidth;
-		const indent = " ".repeat(
-			Math.max(margin, Math.floor((width - group) / 2)),
-		);
-		const paddedRows = [...contentRows];
-		while (paddedRows.length < flameHeight) paddedRows.push("");
-		return rawFlame.map((line, index) => {
-			const row = truncateToWidth(paddedRows[index] ?? "", contentWidth, "…");
-			const padding = " ".repeat(
-				Math.max(0, contentWidth - visibleWidth(row) + gap),
-			);
-			const flame = `${truncateToWidth(line, flameWidth, "")}\x1b[0m`;
-			return `${indent}${row}${padding}${flame}`;
-		});
-	}
-}
-
-// ---- 文案与样式 ----
-
-/**
- * 呼吸空行：预算内按优先级补回排版留白（标题后 > 提示前 > 顶部 > 底部），
- * 预算不够时逐个放弃、退回紧凑排列；超出部分由调用方的 slice 兑底。
- */
-function breathe(title: string, details: string[], hint: string, maxBodyLines: number): string[] {
-	const mandatory = 1 + details.length + (hint ? 1 : 0);
-	let spare = maxBodyLines - mandatory;
-	const afterTitle = spare > 0 && (spare -= 1) >= 0;
-	const beforeHint = hint !== "" && spare > 0 && (spare -= 1) >= 0;
-	const top = spare > 0 && (spare -= 1) >= 0;
-	const bottom = spare > 0 && (spare -= 1) >= 0;
-	return [
-		...(top ? [""] : []),
-		title,
-		...(afterTitle ? [""] : []),
-		...details,
-		...(hint ? [...(beforeHint ? [""] : []), hint] : []),
-		...(bottom ? [""] : []),
-	].slice(0, maxBodyLines);
-}
-
-function activityTitle(view: ActivityView) {
-	const { language } = view;
-	if (view.phase === "queued")
-		return language === "en" ? "🔥 Running" : "🔥 执行中";
-	if (view.phase === "needs_fix") {
-		// 连败轮数并进标题：正文首行留给顾问模型行，与审查相的布局对齐。
-		const failures = view.consecutiveFailures ?? 0;
-		const base = language === "en" ? "🔥 Advisor consulting" : "🔥 顾问介入中";
-		if (failures <= 0) return base;
-		return language === "en"
-			? `${base} · ${failures} straight fails`
-			: `${base} · 连续 ${failures} 轮未过`;
+	override render(width: number): string[] {
+		const lines = this.frame.render(width);
+		if (lines.length < 2) return lines;
+		const keys = this.keys.getKeys("app.interrupt").join("/").replaceAll("escape", "esc") || "esc";
+		const hint = clip(`  审查进行中 · ${keys} 取消`, width, "end", "");
+		return [lines[0], `\x1b[2m${hint}\x1b[22m`, lines[lines.length - 1]];
 	}
-	const phase = view.phase === "awaiting_fix"
-		? language === "en" ? "Repair in progress" : "修复中"
-		: language === "en" ? "Review in progress" : "审查中";
-	return `🔥 ${roundTitle(view.round, phase, language)}`;
-}
-
-function activityRows(view: ActivityView, spinner: string, budget = 16, budgetPer = 2): string[] {
-	if (view.phase === "queued")
-		return [view.language === "en" ? "Runs a review automatically when done" : "完成后自动审查"];
-	if (view.phase === "awaiting_fix") {
-		// 顾问落定与进入修复相在同一微任务链内，needs_fix 相没有渲染机会：
-		// 裁决摘要在迁入相展示，才有可见时机。
-		const advisorLine = view.progressKind === "advisor"
-			? view.reviewers.find((reviewer) => reviewer.summary)?.summary
-			: undefined;
-		return [
-			view.language === "en"
-				? `Repairing Round ${view.round} review feedback`
-				: `正在修复第 ${view.round} 轮审查反馈`,
-			...(advisorLine ? [`💡 ${clip(advisorLine, 64)}`] : []),
-		];
-	}
-	// 连败轮数已并入标题；正文首行即顾问模型行，与审查者行同格式。
-	if (view.phase === "needs_fix")
-		return view.reviewers.flatMap((reviewer) =>
-			reviewerActivityRows(reviewer, spinner, view.language, 1, true, budget, budgetPer),
-		);
-	const blocks = view.reviewers.map((reviewer) =>
-		reviewerActivityRows(reviewer, spinner, view.language, view.reviewers.length, false, budget, budgetPer),
-	);
-	// 模型之间空一行：只在预算容得下内容+分隔+标题提示时才加，紧屏不挤掉正文。
-	const total = blocks.reduce((sum, block) => sum + block.length, 0);
-	const spaced = blocks.length > 1 && budget >= total + blocks.length - 1 + 2;
-	return blocks.flatMap((block, index) => (spaced && index > 0 ? ["", ...block] : block));
-}
-
-function reviewerActivityRows(
-	reviewer: ReviewerProgress,
-	spinner: string,
-	language: Language,
-	totalReviewers: number,
-	isAdvisor = false,
-	budget = 16,
-	budgetPer = 2,
-): string[] {
-	const settled = reviewer.status !== "running";
-	const multiline = totalReviewers <= 3 && budgetPer >= 2;
-	const label = isAdvisor
-		? `${language === "en" ? "Advisor" : "顾问"} ${reviewer.label}`
-		: reviewer.label;
-
-	const elapsed = elapsedSuffix(reviewer);
-	if (settled) {
-		const icon = statusIcon(reviewer.status);
-		const details = reviewer.details && reviewer.details.length > 0
-			? reviewer.details
-			: [reviewer.summary || (reviewer.status === "passed" ? "审查通过" : "发现问题")];
-
-		if (!multiline) {
-			const text = details[0]?.replace(/^[↳\s]+/u, "") || "";
-			return [`${icon} ${label} · ${clip(text, 48)}${elapsed}`];
-		}
-
-		const statusText = reviewer.status === "passed"
-			? (language === "en" ? "Passed" : "通过")
-			: reviewer.status === "failed"
-				? (language === "en" ? "Failed" : "未通过")
-				: (language === "en" ? "Error" : "异常");
-		const firstDetail = details[0] ? ` · ${details[0]}` : ` · ${statusText}`;
-		const lines = [`${icon} ${label}${firstDetail}${elapsed}`];
-		for (const d of details.slice(1, budgetPer)) {
-			const clean = d.replace(/^[↳\s]+/u, "").trim();
-			if (clean) lines.push(`  ↳ ${clip(clean, 54)}`);
-		}
-		return lines;
-	}
-
-	if (reviewer.toolCalls === 0) {
-		return [`${spinner} ${label} · ${language === "en" ? "Thinking" : "思考中"}${elapsed}`];
-	}
-
-	if (!multiline) {
-		return [`${spinner} ${label} · ${reviewer.action} · ${callsText(reviewer.toolCalls, language)}${elapsed}`];
-	}
-
-	// 动作按时间顺序滚动（旧在上新在下），不标「当前/历史」。
-	const lines = [`${spinner} ${label} · ${callsText(reviewer.toolCalls, language)}${elapsed}`];
-	const prev = reviewer.recentTools?.at(-1);
-	if (prev) lines.push(`  ↳ ${clip(formatTool(prev, language), 50)}`);
-	lines.push(`  ↳ ${clip(reviewer.action, 50)}`);
-	return lines;
-}
-
-function formatTool(tool: ProgressTool, language: Language): string {
-	const verb = language === "en" ? tool.tool : tool.tool === "read" ? "读" : tool.tool === "bash" ? "跑" : tool.tool === "edit" ? "改" : tool.tool === "write" ? "写" : tool.tool;
-	const target = tool.args.split("/").pop() || tool.args;
-	return `${verb} ${target}`;
-}
-
-/** 每模型耗时后缀的唯一出口：运行中走表、落定冻结；所有携带每模型内容的行都拼它。 */
-function elapsedSuffix(reviewer: ReviewerProgress): string {
-	if (!reviewer.startedAt) return "";
-	const elapsedMs = Math.max(0, (reviewer.settledAt ?? Date.now()) - reviewer.startedAt);
-	return elapsedMs > 0 ? ` · ${formatDuration(elapsedMs)}` : "";
-}
-
-/** 审查者状态图标的唯一映射；运行中的动态 spinner 由调用方另行处理。 */
-function statusIcon(status: ReviewerProgress["status"]): string {
-	if (status === "passed") return "✅";
-	if (status === "failed") return "❌";
-	if (status === "error") return "⚠️";
-	return "⠋";
-}
-
-function shortModelName(label: string): string {
-	let s = label.replace(/^gpt-5\.6-/u, "").replace(/-\d+k$/u, "");
-	s = s.replace(/^(?:claude-3-[57]-|claude-)/u, "c37-").replace(/^(?:gemini-2\.[05]-|gemini-)/u, "g25-");
-	if (s.startsWith("c37-sonnet") || s === "c37-3-7-sonnet") return "c37";
-	if (s.startsWith("g25-pro") || s === "g25-2.5-pro") return "g25";
-	return s.length > 7 ? `${s.slice(0, 6)}…` : s;
-}
-
-function activityHint(view: ActivityView) {
-	if (view.phase === "awaiting_fix") return undefined;
-	if (view.phase === "queued")
-		return view.language === "en"
-			? "Esc/Ctrl+C cancel automatic review"
-			: "Esc/Ctrl+C 取消自动审查";
-	if (view.phase === "needs_fix")
-		return view.language === "en"
-			? "Esc/Ctrl+C skip consult"
-			: "Esc/Ctrl+C 跳过咨询";
-	return view.language === "en"
-		? "Esc/Ctrl+C cancel"
-		: "Esc/Ctrl+C 取消";
-}
-
-function roundTitle(round: number, title: string, language: Language) {
-	if (round <= 1) return title;
-	return language === "en" ? `Round ${round} ${title}` : `第 ${round} 轮${title}`;
-}
-
-function callsText(calls: number, language: Language) {
-	return language === "en" ? `${calls} calls` : `${calls} 次调用`;
-}
-
-function centerLine(line: string, width: number) {
-	if (width <= 0) return "";
-	const text = truncateToWidth(line, width, "…");
-	const padding = Math.max(0, width - visibleWidth(text));
-	const left = Math.floor(padding / 2);
-	return `${" ".repeat(left)}${text}${" ".repeat(padding - left)}`;
-}
-
-function boldText(text: string) {
-	return `\x1b[1m${text}\x1b[22m`;
-}
-
-function reviewColor(text: string) {
-	const [red, green, blue] = REVIEW_COLOR;
-	return `\x1b[38;2;${red};${green};${blue}m${text}\x1b[39m`;
 }
 
-function setReviewTitle(ctx: ExtensionContext, view: ActivityView | undefined) {
-	if (!view || !ctx.hasUI || typeof ctx.ui.setTitle !== "function") return;
-	const manager = ctx.sessionManager as {
-		getSessionName?: () => unknown;
-		getCwd?: () => unknown;
-	};
+/** 审查期间终端标题写明“审查中 R轮次 · 会话名”，结束后还原。 */
+export function showReviewTitle(ctx: ExtensionContext, round: number, language: Language) {
+	if (!ctx.hasUI || typeof ctx.ui.setTitle !== "function") return;
+	const manager = ctx.sessionManager as { getSessionName?: () => unknown; getCwd?: () => unknown };
 	const rawName = manager.getSessionName?.();
 	const rawCwd = manager.getCwd?.();
 	const who = typeof rawName === "string" && rawName
 		? rawName
 		: typeof rawCwd === "string" ? basename(rawCwd) : "";
-	const label = view.language === "en" ? "Reviewing" : "审查中";
+	const label = language === "en" ? "Reviewing" : "审查中";
 	reviewTitleActive = true;
-	ctx.ui.setTitle(`${label}${view.round > 0 ? ` R${view.round}` : ""}${who ? ` · ${who}` : ""}`);
+	ctx.ui.setTitle(`${label}${round > 0 ? ` R${round}` : ""}${who ? ` · ${who}` : ""}`);
 }
 
-function restoreReviewTitle(ctx: ExtensionContext) {
+export function hideReviewTitle(ctx: ExtensionContext) {
 	if (!reviewTitleActive || !ctx.hasUI || typeof ctx.ui.setTitle !== "function") return;
 	reviewTitleActive = false;
-	const manager = ctx.sessionManager as {
-		getSessionName?: () => unknown;
-		getCwd?: () => unknown;
-	};
+	const manager = ctx.sessionManager as { getSessionName?: () => unknown; getCwd?: () => unknown };
 	const rawName = manager.getSessionName?.();
 	const rawCwd = manager.getCwd?.();
 	const name = typeof rawName === "string" && rawName ? rawName : undefined;

package/round-recorder.ts

@@ -0,0 +1,18 @@
+/**
+ * 轮记录器：会话歇下时把这一段的整段时长、终态与均速写成轮记录（CustomEntry），写入后在进程内总线上通知。
+ * 每个会话都注册——主会话与每个子代理会话跑的是同一段代码、同一个歇下判定（busy.ts），与界面无关：
+ * 主会话的摘要行、输入框外壳、子代理全过程视图都只读记录；Master 结果事件的“本次运行”耗时也读子代理会话里的
+ * 这份记录，不再在指挥官这边另外计时——同一段时长只有一个事实源，视图与事件不会对不上。
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { watchBusy } from "./busy.js";
+import { ROUND_ENTRY, ROUND_RECORDED_CHANNEL } from "./tools/round.js";
+
+export function registerRoundRecorder(pi: ExtensionAPI): void {
+	watchBusy(pi, {
+		onSettled: (_ctx, round) => {
+			pi.appendEntry(ROUND_ENTRY, round);
+			pi.events.emit(ROUND_RECORDED_CHANNEL, undefined);
+		},
+	});
+}

package/session/herdr-display.ts

@@ -16,7 +16,7 @@ const nextSeq = () => (seq += 1);
 
 type Identity = { title: string; agent: string };
 
-export function projectIdentity(
+function projectIdentity(
 	sessionName: string | undefined,
 	modelId: string | undefined,
 	thinking: string | undefined,