@tea-agent/loop-agent 0.40.0-next.2 → 0.40.0-next.3

package/dist/worker/observe/static/views/dag-inspector.js

@@ -19,8 +19,11 @@ import {
 	postOperatorAction,
 	fetchOperatorOperation,
 } from "../api.js";
-import { badge, formatMs, prettyJsonBlock } from "../format.js";
+import { badge, formatLedgerSummary, formatMs, prettyJsonBlock } from "../format.js";
 import { renderMarkdown, renderInspectorDocument } from "../markdown-render.js";
+import { describeDagNodePurpose } from "../dag-node-purpose.js";
+import { buildPromptRestartCandidateOptions } from "../prompt-restart-candidates.js";
+import { copyText } from "../copy.js";
 import {
 	uiState,
 	makeSessionEventIdentity,
@@ -52,6 +55,254 @@ import { createCustomSelect } from "../custom-select.js";
 // reference, always resolving the currently selected node identity.
 const inspectorSelection = { dagRunId: null, node: null };
 
+function createPromptRestartCopyButton(readCandidate) {
+	const buildIcon = (kind) => {
+		const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+		svg.setAttribute(
+			"class",
+			`dags-copy-icon dags-copy-icon-${kind === "check" ? "check" : "rects"}`,
+		);
+		svg.setAttribute("viewBox", "0 0 16 16");
+		svg.setAttribute("width", "16");
+		svg.setAttribute("height", "16");
+		svg.setAttribute("aria-hidden", "true");
+		svg.setAttribute("focusable", "false");
+		if (kind === "check") {
+			const check = document.createElementNS(
+				"http://www.w3.org/2000/svg",
+				"path",
+			);
+			check.setAttribute("d", "M3.5 8.5 6.5 11.5 12.5 4.5");
+			check.setAttribute("fill", "none");
+			check.setAttribute("stroke", "currentColor");
+			check.setAttribute("stroke-width", "1.8");
+			check.setAttribute("stroke-linecap", "round");
+			check.setAttribute("stroke-linejoin", "round");
+			svg.appendChild(check);
+			return svg;
+		}
+		for (const [x, y] of [
+			[2, 2],
+			[5, 5],
+		]) {
+			const rect = document.createElementNS(
+				"http://www.w3.org/2000/svg",
+				"rect",
+			);
+			rect.setAttribute("x", String(x));
+			rect.setAttribute("y", String(y));
+			rect.setAttribute("width", "9");
+			rect.setAttribute("height", "9");
+			rect.setAttribute("rx", "1.5");
+			rect.setAttribute("fill", "none");
+			rect.setAttribute("stroke", "currentColor");
+			rect.setAttribute("stroke-width", "1.5");
+			svg.appendChild(rect);
+		}
+		return svg;
+	};
+	const button = el(
+		"button",
+		"dags-copy-btn dags-copy-btn-icon prompt-restart-copy-icon",
+	);
+	button.type = "button";
+	button.setAttribute("data-testid", "prompt-restart-copy");
+	button.setAttribute("aria-label", "复制当前提示词候选");
+	button.setAttribute("title", "复制当前提示词候选");
+	button.appendChild(buildIcon("copy"));
+	button.appendChild(buildIcon("check"));
+	button.addEventListener("click", (event) => {
+		event.preventDefault();
+		event.stopPropagation();
+		const candidate = readCandidate();
+		void copyText(candidate?.prompt ?? "").then((ok) => {
+			const feedback = ok
+				? candidate?.truncated
+					? "已复制截断预览"
+					: "已复制"
+				: "复制失败";
+			button.classList.toggle("is-copied", ok);
+			button.setAttribute("aria-label", feedback);
+			button.setAttribute("title", feedback);
+			setTimeout(() => {
+				button.classList.remove("is-copied");
+				button.setAttribute("aria-label", "复制当前提示词候选");
+				button.setAttribute("title", "复制当前提示词候选");
+			}, 1500);
+		});
+	});
+	return button;
+}
+
+function formatPromptRestartMeta(text) {
+	const value = String(text ?? "");
+	const chars = [...value].length;
+	const lines = value.length === 0 ? 0 : value.split("\n").length;
+	return `${lines} 行 · ${chars.toLocaleString("zh-CN")} 字`;
+}
+
+function createPromptRestartBanner({ tone, kicker, title, body }) {
+	const banner = el("div", `prompt-restart-banner is-${tone}`);
+	banner.setAttribute("role", "status");
+	banner.appendChild(el("span", "prompt-restart-banner-kicker", kicker));
+	banner.appendChild(el("p", "prompt-restart-banner-title", title));
+	banner.appendChild(el("p", "prompt-restart-banner-body", body));
+	return banner;
+}
+
+function createPromptRestartCandidatePicker({
+	options,
+	value,
+	onChange,
+	label,
+	hint,
+}) {
+	const field = el("div", "prompt-restart-field");
+	field.appendChild(el("span", "prompt-restart-label", label));
+	const select = createCustomSelect({
+		ariaLabel: label,
+		className: "prompt-restart-candidate-select",
+		value,
+		disabled: options.length < 2,
+		options: options.map((option) => ({
+			value: option.key,
+			label: option.label,
+		})),
+		onChange: (nextKey) => {
+			onChange(String(nextKey));
+		},
+	});
+	select.setAttribute("data-testid", "prompt-restart-candidate");
+	field.appendChild(select);
+	const hintEl = el("p", "prompt-restart-hint", hint ?? "");
+	if (!hint) hintEl.hidden = true;
+	field.appendChild(hintEl);
+	return { field, select, hintEl };
+}
+
+function createPromptRestartModeSwitch({ value = "append", onChange }) {
+	const field = el("div", "prompt-restart-field prompt-restart-mode-field");
+	field.appendChild(el("span", "prompt-restart-label", "编辑模式"));
+	const group = el("div", "prompt-restart-mode-switch");
+	group.setAttribute("role", "radiogroup");
+	group.setAttribute("aria-label", "编辑模式");
+	group.setAttribute("data-testid", "prompt-restart-mode");
+	let current = value === "replace" ? "replace" : "append";
+	const buttons = [];
+	const sync = () => {
+		for (const btn of buttons) {
+			const selected = btn.dataset.mode === current;
+			btn.setAttribute("aria-checked", selected ? "true" : "false");
+			btn.classList.toggle("is-selected", selected);
+		}
+	};
+	for (const mode of [
+		{ value: "append", label: "追加指令" },
+		{ value: "replace", label: "全文替换" },
+	]) {
+		const btn = document.createElement("button");
+		btn.type = "button";
+		btn.className = "prompt-restart-mode-option";
+		btn.dataset.mode = mode.value;
+		btn.setAttribute("role", "radio");
+		btn.setAttribute("aria-label", mode.label);
+		btn.textContent = mode.label;
+		btn.addEventListener("click", () => {
+			if (current === mode.value) return;
+			current = mode.value;
+			sync();
+			onChange?.(current);
+		});
+		buttons.push(btn);
+		group.appendChild(btn);
+	}
+	Object.defineProperty(group, "value", {
+		configurable: true,
+		enumerable: true,
+		get() {
+			return current;
+		},
+		set(next) {
+			current = next === "replace" ? "replace" : "append";
+			sync();
+		},
+	});
+	sync();
+	field.appendChild(group);
+	const hint = el(
+		"p",
+		"prompt-restart-hint",
+		"追加会保留原提示词；全文替换会改写整份底稿。",
+	);
+	field.appendChild(hint);
+	return { field, group, hint };
+}
+
+function createPromptRestartPromptCard({
+	title,
+	badge,
+	readCandidate,
+	preTestId,
+	collapsible = false,
+	startCollapsed = false,
+}) {
+	const card = el("div", "prompt-restart-prompt-card");
+	const head = el("div", "prompt-restart-prompt-head");
+	const titles = el("div", "prompt-restart-prompt-titles");
+	const titleEl = el("span", "prompt-restart-prompt-title", title);
+	titles.appendChild(titleEl);
+	if (badge) {
+		titles.appendChild(el("span", "prompt-restart-prompt-badge", badge));
+	}
+	const metaEl = el("span", "prompt-restart-prompt-meta", "");
+	titles.appendChild(metaEl);
+	head.appendChild(titles);
+	const headActions = el("div", "prompt-restart-prompt-actions");
+	let fold = null;
+	let collapsed = Boolean(collapsible && startCollapsed);
+	const syncFold = () => {
+		if (!fold) return;
+		card.classList.toggle("is-collapsed", collapsed);
+		fold.setAttribute("aria-expanded", collapsed ? "false" : "true");
+		fold.textContent = collapsed ? "展开" : "收起";
+	};
+	if (collapsible) {
+		card.classList.add("is-collapsible");
+		fold = document.createElement("button");
+		fold.type = "button";
+		fold.className = "prompt-restart-prompt-fold";
+		fold.setAttribute("aria-controls", preTestId);
+		fold.addEventListener("click", (event) => {
+			event.preventDefault();
+			event.stopPropagation();
+			collapsed = !collapsed;
+			syncFold();
+		});
+		headActions.appendChild(fold);
+	}
+	headActions.appendChild(createPromptRestartCopyButton(readCandidate));
+	head.appendChild(headActions);
+	card.appendChild(head);
+	const pre = document.createElement("pre");
+	pre.className = "prompt-restart-readonly";
+	pre.setAttribute("data-testid", preTestId);
+	if (preTestId) pre.id = preTestId;
+	card.appendChild(pre);
+	const sync = (candidate) => {
+		const next = candidate ?? readCandidate?.();
+		titleEl.textContent =
+			next?.key === "frozen"
+				? "冻结原始提示词"
+				: (next?.label ?? title);
+		pre.textContent = next?.prompt ?? "";
+		metaEl.textContent = formatPromptRestartMeta(next?.prompt ?? "");
+		if (next?.truncated) metaEl.textContent += " · 已截断";
+	};
+	sync(readCandidate?.());
+	syncFold();
+	return { card, pre, titleEl, metaEl, sync };
+}
+
 function renderDagInspectorForCurrent() {
 	if (!inspectorSelection.dagRunId || !inspectorSelection.node) return;
 	renderDagInspector(
@@ -983,6 +1234,121 @@ async function renderDagNodeInput(content, dagRunId, node) {
 
 	renderDagNodeInputDetail(content, data);
 	finishInputRender();
+	// Frontend prewrite 门禁 / source fidelity ledger 展示（AC-009）：只读安全摘要，
+	// 从 run 产物（frontend-prewrite-result.json）与 /api/tasks/:id/ledger 拉取；
+	// 接口失败进入安全降级，不泄漏敏感内容。
+	if (/prewrite/.test(nodeId)) {
+		void renderFrontendGateLedger(content, dagRunId);
+	}
+}
+
+/**
+ * Frontend prewrite 门禁 + ledger 摘要行（AC-BLOCK-005）：纯函数，测试直接断言。
+ * prewriteResult = {ok:true, body}|{ok:false, status}|null（网络失败）；ledgerBody 为
+ * /api/tasks/:id/ledger 响应或 null。绝不把 envelope/预览原文塞入 <pre>（删除
+ * 旧 lines.push(previewText) 路径），缺失/拒绝显示明确 fail-closed 文案。
+ */
+export function frontendGateLedgerLines(input) {
+	const { prewriteResult, ledgerBody, taskId } = input;
+	const lines = [];
+	if (prewriteResult?.ok && prewriteResult.body) {
+		const parsed = prewriteResult.body;
+		if (parsed?.classification) {
+			lines.push(`classification: ${String(parsed.classification)}`);
+			if (parsed.failureCode) {
+				lines.push(`failureCode: ${String(parsed.failureCode)}`);
+			}
+			if (parsed.failureReason) {
+				lines.push(`failureReason: ${String(parsed.failureReason)}`);
+			}
+		} else {
+			lines.push("frontend-prewrite-result.json 内容无法解析为结构化结果。");
+		}
+	} else if (prewriteResult && prewriteResult.status === 404) {
+		lines.push("frontend-prewrite-result.json 尚未生成（门禁未执行或缺失）。");
+	} else if (prewriteResult) {
+		lines.push(
+			"frontend-prewrite-result.json 读取失败（只读接口拒绝/服务异常，安全降级）。",
+		);
+	} else {
+		lines.push("frontend-prewrite-result.json 尚未生成（门禁未执行或缺失）。");
+	}
+	if (ledgerBody && ledgerBody.present === true) {
+		lines.push(formatLedgerSummary(ledgerBody));
+	} else if (ledgerBody) {
+		lines.push("ledger: 无（任务无引用或 ledger 缺失，不伪造计数）");
+	} else if (taskId) {
+		lines.push("ledger: 暂不可查（只读接口失败，安全降级）");
+	}
+	return lines;
+}
+
+/** DAG run 专属 prewrite-result 只读拉取（内联 fetch，不新增 api.js 依赖）。 */
+async function fetchPrewriteResultJson(dagRunId) {
+	try {
+		const res = await fetch(
+			`/api/dag-runs/${encodeURIComponent(dagRunId)}/prewrite-result`,
+			{ credentials: "same-origin" },
+		);
+		if (!res.ok) return { ok: false, status: res.status };
+		return { ok: true, body: await res.json() };
+	} catch {
+		return null; // 网络失败
+	}
+}
+
+/**
+ * Resolve the DAG-owned task identity, prewrite result, and safe ledger summary.
+ * Exported so the real browser request sequence can be regression-tested without
+ * relying on source-string assertions.
+ */
+export async function fetchFrontendGateLedgerData(dagRunId) {
+	const run = await fetchJson(
+		`/api/dag-runs/${encodeURIComponent(dagRunId)}`,
+	);
+	const taskId = typeof run?.taskId === "string" ? run.taskId : "";
+	const prewriteResult = await fetchPrewriteResultJson(dagRunId);
+	let ledgerBody = null;
+	if (taskId) {
+		ledgerBody = await fetchJson(
+			`/api/tasks/${encodeURIComponent(taskId)}/ledger`,
+		);
+	}
+	return { taskId, prewriteResult, ledgerBody };
+}
+
+/**
+ * Inspect 节点面板：frontend prewrite 门禁分类/稳定 failure code + ledger 安全摘要。
+ * 数据全部来自只读接口与确定性产物（AC-BLOCK-005）：task identity 从 DAG run
+ * GET /api/dag-runs/:dagRunId 读取，prewrite 门禁调 DAG run 专属
+ * GET /api/dag-runs/:dagRunId/prewrite-result；任何失败仅显示安全降级文案，
+ * 绝不 push envelope。
+ */
+async function renderFrontendGateLedger(content, dagRunId) {
+	const section = el("section", "node-input-section");
+	section.appendChild(
+		el("h4", null, "Frontend prewrite 门禁 / source fidelity ledger"),
+	);
+	const status = el("p", "muted", "加载中…");
+	status.setAttribute("role", "status");
+	section.appendChild(status);
+	content.appendChild(section);
+	try {
+		const { taskId, prewriteResult, ledgerBody } =
+			await fetchFrontendGateLedgerData(dagRunId);
+		const lines = frontendGateLedgerLines({
+			prewriteResult,
+			ledgerBody,
+			taskId,
+		});
+		const pre = el("pre", "cmd", lines.join("\n"));
+		pre.dataset.testid = "frontend-prewrite-ledger-summary";
+		status.replaceWith(pre);
+	} catch (error) {
+		status.textContent = `加载失败：${
+			error instanceof Error ? error.message : String(error)
+		}（安全降级，不展示敏感内容）`;
+	}
 }
 
 /**
@@ -1017,29 +1383,62 @@ async function renderPromptRestart(content, dagRunId, node) {
 		content.appendChild(error);
 		return;
 	}
-	const basePrompt =
+	const frozenBasePrompt =
 		typeof input.body.prompt?.text === "string" ? input.body.prompt.text : "";
-	if (!basePrompt) {
+	if (!frozenBasePrompt) {
 		const error = el("p", "node-input-error", "该节点没有冻结提示词。");
 		error.setAttribute("role", "alert");
 		content.appendChild(error);
 		return;
 	}
+	const promptCandidateOptions = buildPromptRestartCandidateOptions(
+		frozenBasePrompt,
+		input.body.promptCandidates,
+	);
+	let selectedCandidate = promptCandidateOptions[0];
+	const historicalCandidatesMissing = Array.isArray(input.body.warnings)
+		? input.body.warnings.some((warning) =>
+				String(warning).startsWith("Failed prompt candidate missing for attempt "),
+			)
+		: false;
 
 	if (node.status !== "ERROR") {
 		// Non-failed nodes still show their frozen prompt — read-only.
-		const hint = el(
-			"p",
-			"muted",
-			`当前节点状态为 ${node.status ?? "unknown"}；仅失败（ERROR）节点支持编辑提示词并重启，以下为该节点冻结提示词（只读）。`,
+		const panel = el("div", "prompt-restart-panel");
+		panel.appendChild(
+			createPromptRestartBanner({
+				tone: "readonly",
+				kicker: "只读",
+				title: `当前节点 ${node.status ?? "unknown"}`,
+				body: "仅失败（ERROR）节点支持编辑提示词并重启。以下可只读查看冻结提示词与历史失败候选。",
+			}),
 		);
-		hint.setAttribute("role", "status");
-		content.appendChild(hint);
-		const pre = document.createElement("pre");
-		pre.className = "prompt-restart-readonly";
-		pre.setAttribute("data-testid", "prompt-restart-readonly");
-		pre.textContent = basePrompt;
-		content.appendChild(pre);
+		const promptCard = createPromptRestartPromptCard({
+			title: "冻结原始提示词",
+			badge: "只读",
+			readCandidate: () => selectedCandidate,
+			preTestId: "prompt-restart-readonly",
+		});
+		const picker = createPromptRestartCandidatePicker({
+			options: promptCandidateOptions,
+			value: selectedCandidate.key,
+			label: "提示词版本（只读）",
+			hint:
+				promptCandidateOptions.length === 1
+					? historicalCandidatesMissing
+						? "该历史运行未保存失败 attempt 的实际提示词；新运行会在此列出。"
+						: "该节点没有已保存的失败 attempt。"
+					: "可切换查看冻结底稿与历史失败候选。",
+			onChange: (nextKey) => {
+				selectedCandidate =
+					promptCandidateOptions.find((option) => option.key === nextKey) ??
+					promptCandidateOptions[0];
+				promptCard.sync(selectedCandidate);
+			},
+		});
+		panel.appendChild(picker.field);
+		panel.appendChild(promptCard.card);
+		content.appendChild(panel);
 		return;
 	}
 
@@ -1054,103 +1453,129 @@ async function renderPromptRestart(content, dagRunId, node) {
 		return;
 	}
 
-	const box = el("div", "prompt-restart-box");
+	const box = el("div", "prompt-restart-box prompt-restart-panel is-edit");
 	box.appendChild(
-		el(
-			"p",
-			"muted",
-			"编辑该失败节点的提示词并从它重启：父 run spec 保持冻结，将创建带修改提示词的续跑 run（实验能力，仅 ERROR 节点）。",
-		),
+		createPromptRestartBanner({
+			tone: "edit",
+			kicker: "可编辑",
+			title: "从失败节点编辑提示词并重启",
+			body: "父 run spec 保持冻结，将创建带修改提示词的续跑 run。",
+		}),
 	);
+	const promptCard = createPromptRestartPromptCard({
+		title: `冻结提示词（只读底稿 · ${nodeId}）`,
+		badge: "底稿",
+		readCandidate: () => selectedCandidate,
+		preTestId: "prompt-restart-base",
+		collapsible: true,
+		startCollapsed: true,
+	});
+	const picker = createPromptRestartCandidatePicker({
+		options: promptCandidateOptions,
+		value: selectedCandidate.key,
+		label: "提示词版本",
+		hint:
+			promptCandidateOptions.length > 1
+				? "选择失败候选会载入全文替换；冻结原始提示词仍可使用追加模式。"
+				: historicalCandidatesMissing
+					? "该历史运行未保存失败 attempt 的实际提示词；新运行会在此列出。"
+					: "该节点没有已保存的失败 attempt；当前仅有冻结原始提示词。",
+		onChange: (nextKey) => {
+			selectedCandidate =
+				promptCandidateOptions.find((option) => option.key === nextKey) ??
+				promptCandidateOptions[0];
+			promptCard.sync(selectedCandidate);
+			replaceArea.value = selectedCandidate.prompt;
+			if (selectedCandidate.key !== "frozen") {
+				modeSelect.value = "replace";
+			}
+			picker.hintEl.hidden = false;
+			picker.hintEl.textContent = selectedCandidate.truncated
+				? "该候选已截断，仅供查看，不能直接提交重启。"
+				: selectedCandidate.key === "frozen"
+					? "冻结原始提示词可使用追加或全文替换。"
+					: "已载入该失败候选；可在全文替换编辑器中修订后重启。";
+			applyModeVisibility();
+		},
+	});
+	const modeSwitch = createPromptRestartModeSwitch({
+		value: "append",
+		onChange: () => applyModeVisibility(),
+	});
+	const modeSelect = modeSwitch.group;
+	const toolbar = el("div", "prompt-restart-toolbar");
+	toolbar.appendChild(picker.field);
+	toolbar.appendChild(modeSwitch.field);
+	box.appendChild(toolbar);
 
-	const modeRow = el("div", "prompt-restart-mode");
-	modeRow.appendChild(el("span", "muted", "编辑模式"));
-	const modeSelect = document.createElement("select");
-	modeSelect.className = "prompt-restart-mode-select";
-	modeSelect.setAttribute("data-testid", "prompt-restart-mode");
-	const appendOption = document.createElement("option");
-	appendOption.value = "append";
-	appendOption.textContent =
-		"追加指令（推荐）：保留原提示词，在末尾追加 operator_addendum 块";
-	const replaceOption = document.createElement("option");
-	replaceOption.value = "replace";
-	replaceOption.textContent = "全文替换（高级）：替换整个提示词";
-	modeSelect.appendChild(appendOption);
-	modeSelect.appendChild(replaceOption);
-	modeSelect.value = "append";
-	modeRow.appendChild(modeSelect);
-	box.appendChild(modeRow);
-
-	const baseLabel = el("label", "prompt-restart-field");
-	baseLabel.appendChild(
-		el("span", "muted", `冻结提示词（只读底稿 · ${nodeId}）`),
+	const addendumLabel = el("label", "prompt-restart-field prompt-restart-work");
+	addendumLabel.appendChild(
+		el("span", "prompt-restart-label", "追加指令"),
 	);
-	const baseBlock = document.createElement("pre");
-	baseBlock.className = "prompt-restart-readonly";
-	baseBlock.setAttribute("data-testid", "prompt-restart-base");
-	baseBlock.textContent = basePrompt;
-	baseLabel.appendChild(baseBlock);
-	box.appendChild(baseLabel);
-
-	const addendumLabel = el("label", "prompt-restart-field");
 	addendumLabel.appendChild(
 		el(
-			"span",
-			"muted",
-			"追加指令（将包裹为 <operator_addendum> 块附加到原提示词末尾）",
+			"p",
+			"prompt-restart-hint",
+			"将包裹为 <operator_addendum> 块附加到原提示词末尾",
 		),
 	);
 	const addendumArea = document.createElement("textarea");
-	addendumArea.className = "prompt-restart-textarea";
-	addendumArea.rows = 6;
+	addendumArea.className = "prompt-restart-textarea prompt-restart-textarea-work";
+	addendumArea.rows = 8;
 	addendumArea.placeholder = "例如：重点检查 X 边界；输出前先自检 Y 约束…";
 	addendumArea.setAttribute("data-testid", "prompt-restart-addendum");
 	addendumLabel.appendChild(addendumArea);
 	box.appendChild(addendumLabel);
 
-	const replaceLabel = el("label", "prompt-restart-field");
-	replaceLabel.appendChild(el("span", "muted", `完整提示词（${nodeId}）`));
+	const replaceLabel = el("label", "prompt-restart-field prompt-restart-work");
+	replaceLabel.appendChild(
+		el("span", "prompt-restart-label", `完整提示词（${nodeId}）`),
+	);
 	const replaceArea = document.createElement("textarea");
-	replaceArea.className = "prompt-restart-textarea";
-	replaceArea.rows = 16;
-	replaceArea.value = basePrompt;
+	replaceArea.className = "prompt-restart-textarea prompt-restart-textarea-work";
+	replaceArea.rows = 12;
+	replaceArea.value = selectedCandidate.prompt;
 	replaceArea.setAttribute("data-testid", "prompt-restart-textarea");
 	replaceLabel.appendChild(replaceArea);
 	box.appendChild(replaceLabel);
 
+	const baseLabel = promptCard.card;
+	box.appendChild(baseLabel);
+
 	const applyModeVisibility = () => {
 		const append = modeSelect.value === "append";
-		baseLabel.style.display = append ? "" : "none";
-		addendumLabel.style.display = append ? "" : "none";
-		replaceLabel.style.display = append ? "none" : "";
+		baseLabel.classList.toggle("is-hidden", !append);
+		addendumLabel.classList.toggle("is-hidden", !append);
+		replaceLabel.classList.toggle("is-hidden", append);
 	};
-	modeSelect.addEventListener("change", applyModeVisibility);
 	applyModeVisibility();
 
 	const reasonLabel = el("label", "prompt-restart-field");
-	reasonLabel.appendChild(el("span", "muted", "重启原因（结构化说明）"));
+	reasonLabel.appendChild(el("span", "prompt-restart-label", "重启原因"));
+	reasonLabel.appendChild(
+		el("p", "prompt-restart-hint", "结构化说明，会写入续跑 provenance"),
+	);
 	const reasonArea = document.createElement("textarea");
-	reasonArea.className = "prompt-restart-textarea";
+	reasonArea.className = "prompt-restart-textarea prompt-restart-textarea-compact";
 	reasonArea.rows = 3;
 	reasonArea.value = `operator-prompt-override / run=${dagRunId} / node=${nodeId} / 手工编辑失败节点提示词后重启`;
 	reasonArea.setAttribute("data-testid", "prompt-restart-reason");
 	reasonLabel.appendChild(reasonArea);
 	box.appendChild(reasonLabel);
 
-	const row = el("div", "prompt-restart-actions");
+	const row = el("div", "prompt-restart-actions prompt-restart-footer");
+	const status = el("p", "prompt-restart-status", "");
+	status.setAttribute("role", "status");
+	status.setAttribute("aria-live", "polite");
 	const submit = document.createElement("button");
 	submit.type = "button";
 	submit.className = "prompt-restart-submit";
 	submit.textContent = "资格预检并重启";
 	submit.setAttribute("data-testid", "prompt-restart-submit");
+	row.appendChild(status);
 	row.appendChild(submit);
 	box.appendChild(row);
 
-	const status = el("p", "prompt-restart-status", "");
-	status.setAttribute("role", "status");
-	status.setAttribute("aria-live", "polite");
-	box.appendChild(status);
-
 	content.appendChild(box);
 
 	const setStatus = (text, isError = false) => {
@@ -1160,6 +1585,10 @@ async function renderPromptRestart(content, dagRunId, node) {
 
 	submit.addEventListener("click", () => {
 		void (async () => {
+			if (selectedCandidate.truncated) {
+				setStatus("所选失败提示词已截断，不能作为完整提示词重启。", true);
+				return;
+			}
 			const mode = modeSelect.value === "replace" ? "replace" : "append";
 			const prompt =
 				mode === "append" ? addendumArea.value : replaceArea.value;
@@ -1171,7 +1600,11 @@ async function renderPromptRestart(content, dagRunId, node) {
 				);
 				return;
 			}
-			if (mode === "replace" && prompt === basePrompt) {
+			if (
+				mode === "replace" &&
+				selectedCandidate.key === "frozen" &&
+				prompt === frozenBasePrompt
+			) {
 				setStatus("提示词未修改；如需按原提示词重跑请使用恢复工作台。", true);
 				return;
 			}
@@ -1234,7 +1667,7 @@ async function renderPromptRestart(content, dagRunId, node) {
 						setStatus(`重启完成，新 run：${newRunId}`);
 						const open = document.createElement("button");
 						open.type = "button";
-						open.className = "prompt-restart-submit";
+						open.className = "prompt-restart-submit is-secondary";
 						open.textContent = "打开新 run";
 						open.addEventListener("click", () => {
 							window.location.hash = `#/dag/${encodeURIComponent(String(newRunId))}`;
@@ -2077,6 +2510,16 @@ function fillDagInspectorContent(content, dagRunId, node) {
 	}
 }
 
+function inspectorNodePurpose(node) {
+	return describeDagNodePurpose(node?.nodeId, node);
+}
+
+function appendInspectorPurpose(title, node) {
+	const purpose = inspectorNodePurpose(node);
+	if (!purpose) return;
+	title.appendChild(el("p", "dag-inspector-purpose", purpose));
+}
+
 function buildDagInspectorHeader(dagRunId, node) {
 	const header = el("div", "dag-inspector-header");
 	header.dataset.dagRunId = String(dagRunId ?? "");
@@ -2084,6 +2527,7 @@ function buildDagInspectorHeader(dagRunId, node) {
 	const title = el("div", "dag-inspector-title");
 	title.appendChild(el("h3", null, "节点检查器"));
 	title.appendChild(el("div", "dag-inspector-node", node.nodeId));
+	appendInspectorPurpose(title, node);
 	header.appendChild(title);
 	const controls = el("div", "dag-inspector-controls");
 	const status = badge(node.status ?? "unknown");
@@ -2106,11 +2550,10 @@ function buildDagInspectorHeader(dagRunId, node) {
 		["timeline", "执行过程", "ri-route-line"],
 		["spec-evidence", "规范证据", "ri-book-open-line"],
 	];
-	// Experimental prompt-override rerun: the server injects the SCOPED
-	// inspect mutation token into /inspect HTML only while
-	// HARNESS_DAG_RERUN_PROMPT_OVERRIDE is enabled (and it only authorizes
-	// dagRerunPlan/dagRerun). No token → no tab → the inspector stays
-	// strictly read-only.
+	// Prompt-override rerun: the server injects the SCOPED inspect mutation
+	// token into /inspect HTML by default (it only authorizes
+	// dagRerunPlan/dagRerun). The emergency kill switch suppresses the token;
+	// no token → no tab → the inspector stays strictly read-only.
 	if (globalThis.__INSPECT_MUTATION_TOKEN__) {
 		tabDefs.push(["prompt-restart", "提示词重启", "ri-restart-line"]);
 	}
@@ -2164,6 +2607,16 @@ function syncDagInspectorHeader(panel, dagRunId, node) {
 	header.dataset.dagNodeId = String(node.nodeId ?? "");
 	const nodeLabel = header.querySelector(".dag-inspector-node");
 	if (nodeLabel) nodeLabel.textContent = node.nodeId;
+	const title = header.querySelector(".dag-inspector-title");
+	const purposeLine = header.querySelector(".dag-inspector-purpose");
+	const purpose = inspectorNodePurpose(node);
+	if (purposeLine && purpose) {
+		purposeLine.textContent = purpose;
+	} else if (purposeLine && !purpose) {
+		purposeLine.remove();
+	} else if (!purposeLine && purpose && title) {
+		title.appendChild(el("p", "dag-inspector-purpose", purpose));
+	}
 	const status = header.querySelector(".dag-inspector-status");
 	if (status) {
 		const next = badge(node.status ?? "unknown");