@tea-agent/loop-agent 0.39.0-beta.0 → 0.39.0-beta.10

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

@@ -11,14 +11,26 @@ import {
 } from "../constants.js";
 import { clearNode, el } from "../dom.js";
 import { attemptFailureLabel } from "../dag-history-labels.js";
-import { fetchJson, fetchSpecEvidenceFile, fetchDagNodeInput } from "../api.js";
-import { badge, formatMs } from "../format.js";
-import { renderMarkdown } from "../markdown-render.js";
 import {
+	fetchJson,
+	fetchSpecEvidenceFile,
+	fetchDagNodeInput,
+	fetchDagNodeProcess,
+	postOperatorAction,
+	fetchOperatorOperation,
+} from "../api.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 {
+	fetchWithWorkspaceScope,
 	uiState,
 	makeSessionEventIdentity,
 	makeDagNodeInputIdentity,
 	makeDagNodeExecutionOutputIdentity,
+	makeDagNodeProcessIdentity,
 	getDagNodeExecutionOutputCache,
 	setDagNodeExecutionOutputCache,
 	clearDagNodeExecutionOutputCache,
@@ -44,6 +56,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(
@@ -68,6 +328,10 @@ function resetInspectorNodeSelection(dagRunId, nodeId) {
 	uiState.dagNodeInputData = null;
 	uiState.dagNodeInputError = null;
 	uiState.dagNodeInputLoading = false;
+	uiState.dagNodeProcessData = null;
+	uiState.dagNodeProcessError = null;
+	uiState.dagNodeProcessLoading = false;
+	uiState.dagNodeProcessIdentity = null;
 	// Drop execution-output cache/identity so node A's bodies never leak into B.
 	clearDagNodeExecutionOutputCache();
 	// Bump the session-event identity token so any in-flight response for the
@@ -725,6 +989,11 @@ function renderDagNodeInputDetail(content, data) {
 		}
 		section.appendChild(dl);
 		appendCodeList(section, "skills", data.executorInput.skills);
+		appendCodeList(
+			section,
+			"piExtensions（声明）",
+			data.executorInput.piExtensions,
+		);
 		if (data.executorInput.shell) {
 			const shell = data.executorInput.shell;
 			const shellDl = el("dl", "node-input-summary");
@@ -743,6 +1012,12 @@ function renderDagNodeInputDetail(content, data) {
 				(shell.gates ?? []).join(", ") || "(none)",
 				null,
 			);
+			appendMetaRow(
+				shellDl,
+				"handlers",
+				(shell.handlers ?? []).join(", ") || "(none)",
+				null,
+			);
 			section.appendChild(shellDl);
 			if ((shell.commands ?? []).length > 0) {
 				const list = el("ol", "node-input-command-list");
@@ -799,6 +1074,52 @@ function renderDagNodeInputDetail(content, data) {
 		wrap.appendChild(section);
 	}
 
+	if (data.piExtensionRunFacts) {
+		const facts = data.piExtensionRunFacts;
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "Pi 扩展运行事实"));
+		if (!facts.exists) {
+			section.appendChild(
+				el(
+					"p",
+					"muted",
+					facts.parseError
+					? `产物 ${facts.artifact} 读取失败（${facts.parseError}）。`
+					: `产物 ${facts.artifact} 尚未生成（节点未执行或缺失）。`,
+				),
+			);
+		} else {
+			const dl = el("dl", "node-input-summary");
+			appendMetaRow(
+				dl,
+				"resolved",
+				facts.resolved
+					.map((entry) => `${entry.id} → ${entry.packageName}@${entry.version}`)
+					.join(", ") || "(none)",
+				null,
+			);
+			section.appendChild(dl);
+			appendCodeList(
+				section,
+				"requested",
+				facts.requested,
+			);
+			for (const missingEntry of facts.missing ?? []) {
+				section.appendChild(
+					el(
+						"p",
+						"node-input-warning",
+						`降级：${missingEntry.id} 未加载（${missingEntry.reason || "unknown"}）`,
+					),
+				);
+			}
+			if ((facts.missing ?? []).length === 0) {
+				section.appendChild(el("p", "muted", "全部声明扩展均已解析加载。"));
+			}
+		}
+		wrap.appendChild(section);
+	}
+
 	if (data.promptFingerprint?.exists) {
 		const section = el("section", "node-input-section");
 		section.appendChild(el("h4", null, "Assembled prompt 指纹"));
@@ -914,10 +1235,488 @@ 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 fetchWithWorkspaceScope(
+			`/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)
+		}（安全降级，不展示敏感内容）`;
+	}
+}
+
+/**
+ * Experimental prompt-override rerun tab. Only reachable when the server
+ * injected the mutation token (switch on). Every node shows its frozen
+ * subtask_prompt here; only FAILED (ERROR) nodes additionally get the editor +
+ * restart flow: preflight (dagRerunPlan) binds the edit into planHash, dagRerun
+ * executes it as a Console operation, and on success we jump to the new run.
+ */
+async function renderPromptRestart(content, dagRunId, node) {
+	const nodeId = node.nodeId;
+	clearNode(content);
+
+	const loading = el("p", "muted", "正在加载冻结提示词…");
+	loading.setAttribute("role", "status");
+	loading.setAttribute("aria-live", "polite");
+	content.appendChild(loading);
+	const input = await fetchDagNodeInput(dagRunId, nodeId);
+	if (
+		!content.isConnected ||
+		content.dataset.dagNodeId !== String(nodeId) ||
+		content.dataset.dagRunId !== String(dagRunId) ||
+		activeInspectorTab() !== "prompt-restart"
+	) {
+		return;
+	}
+	clearNode(content);
+
+	if (!input.ok || !input.body?.available) {
+		const error = el("p", "node-input-error", "无法读取该节点的冻结提示词。");
+		error.setAttribute("role", "alert");
+		content.appendChild(error);
+		return;
+	}
+	const frozenBasePrompt =
+		typeof input.body.prompt?.text === "string" ? input.body.prompt.text : "";
+	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 panel = el("div", "prompt-restart-panel is-readonly");
+		panel.appendChild(
+			createPromptRestartBanner({
+				tone: "readonly",
+				kicker: "只读",
+				title: `当前节点 ${node.status ?? "unknown"}`,
+				body: "仅失败（ERROR）节点支持编辑提示词并重启。以下可只读查看冻结提示词与历史失败候选。",
+			}),
+		);
+		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;
+	}
+
+	if (input.body.prompt?.truncated === true) {
+		const error = el(
+			"p",
+			"node-input-error",
+			"冻结提示词被截断，为避免误替换请改用 CLI（dag rerun --prompt-override）。",
+		);
+		error.setAttribute("role", "alert");
+		content.appendChild(error);
+		return;
+	}
+
+	const box = el("div", "prompt-restart-box prompt-restart-panel is-edit");
+	box.appendChild(
+		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 addendumLabel = el("label", "prompt-restart-field prompt-restart-work");
+	addendumLabel.appendChild(
+		el("span", "prompt-restart-label", "追加指令"),
+	);
+	addendumLabel.appendChild(
+		el(
+			"p",
+			"prompt-restart-hint",
+			"将包裹为 <operator_addendum> 块附加到原提示词末尾",
+		),
+	);
+	const addendumArea = document.createElement("textarea");
+	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 prompt-restart-work");
+	replaceLabel.appendChild(
+		el("span", "prompt-restart-label", `完整提示词（${nodeId}）`),
+	);
+	const replaceArea = document.createElement("textarea");
+	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.classList.toggle("is-hidden", !append);
+		addendumLabel.classList.toggle("is-hidden", !append);
+		replaceLabel.classList.toggle("is-hidden", append);
+	};
+	applyModeVisibility();
+
+	const reasonLabel = el("label", "prompt-restart-field");
+	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 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 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);
+
+	content.appendChild(box);
+
+	const setStatus = (text, isError = false) => {
+		status.textContent = text ?? "";
+		status.classList.toggle("prompt-restart-error", isError);
+	};
+
+	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;
+			const reason = reasonArea.value.trim();
+			if (!prompt.trim()) {
+				setStatus(
+					mode === "append" ? "追加指令不能为空。" : "提示词不能为空。",
+					true,
+				);
+				return;
+			}
+			if (
+				mode === "replace" &&
+				selectedCandidate.key === "frozen" &&
+				prompt === frozenBasePrompt
+			) {
+				setStatus("提示词未修改；如需按原提示词重跑请使用恢复工作台。", true);
+				return;
+			}
+			if (!reason) {
+				setStatus("需要填写重启原因。", true);
+				return;
+			}
+			submit.disabled = true;
+			try {
+				setStatus("正在做重跑资格预检（dagRerunPlan）…");
+				const overrides = [{ nodeId, prompt, mode }];
+				const planRes = await postOperatorAction("dagRerunPlan", {
+					runId: dagRunId,
+					fromNode: nodeId,
+					promptOverrides: overrides,
+				});
+				const plan = planRes.body?.result ?? null;
+				if (!planRes.ok || plan?.eligible !== true || !plan?.planHash) {
+					setStatus(
+						planRes.body?.error?.message ??
+							plan?.blockedReasons?.join(", ") ??
+							"资格预检未通过。",
+						true,
+					);
+					return;
+				}
+
+				const est = plan.estimatedExecution;
+				const estText = est
+					? `（将执行 ${est.nodeCount ?? "?"} 个节点 / ${est.piCallCount ?? "?"} 次 Pi 调用）`
+					: "";
+				setStatus(`预检通过${estText}，正在提交续跑（dagRerun）…`);
+				const clientRequestId = `inspect-prompt-restart-${Date.now()}-${Math.random()
+					.toString(36)
+					.slice(2, 10)}`;
+				const runRes = await postOperatorAction(
+					"dagRerun",
+					{
+						runId: dagRunId,
+						fromNode: nodeId,
+						planHash: plan.planHash,
+						reason,
+						promptOverrides: overrides,
+					},
+					clientRequestId,
+				);
+				const operationId = runRes.body?.operationId;
+				if (!runRes.ok || !operationId) {
+					setStatus(runRes.body?.error?.message ?? "提交续跑失败。", true);
+					return;
+				}
+
+				const op = await pollOperationToTerminal(operationId, (text) =>
+					setStatus(text),
+				);
+				if (op?.state === "succeeded") {
+					const newRunId =
+						op.dagRunId ?? op.result?.newRunId ?? op.runSummary?.runId ?? null;
+					if (newRunId) {
+						setStatus(`重启完成，新 run：${newRunId}`);
+						const open = document.createElement("button");
+						open.type = "button";
+						open.className = "prompt-restart-submit is-secondary";
+						open.textContent = "打开新 run";
+						open.addEventListener("click", () => {
+							window.location.hash = `#/dag/${encodeURIComponent(String(newRunId))}`;
+						});
+						row.appendChild(open);
+					} else {
+						setStatus("重启完成（未能解析新 run id，请在 DAG 历史中查看）。");
+					}
+				} else if (op) {
+					setStatus(
+						`续跑操作终态：${op.state}${op.errorMessage ? ` — ${op.errorMessage}` : ""}`,
+						true,
+					);
+				} else {
+					setStatus("等待超时：操作仍在运行，可在操作台查看进度。", true);
+				}
+			} catch (err) {
+				setStatus(err instanceof Error ? err.message : String(err), true);
+			} finally {
+				submit.disabled = false;
+			}
+		})();
+	});
+}
+
+/** Poll a Console operation until a terminal state; null on poll budget end. */
+async function pollOperationToTerminal(operationId, onProgress) {
+	const terminal = new Set([
+		"succeeded",
+		"failed",
+		"timed-out",
+		"needs-reconcile",
+	]);
+	for (let attempt = 0; attempt < 1200; attempt += 1) {
+		const res = await fetchOperatorOperation(operationId);
+		const op = res.body?.operation ?? res.body;
+		const state = op?.state ?? "";
+		if (res.ok && terminal.has(state)) {
+			return op;
+		}
+		onProgress(`续跑执行中…（${state || "queued"}）`);
+		await new Promise((resolve) => setTimeout(resolve, 3000));
+	}
+	return null;
 }
 
 function activeInspectorTab() {
-	return ["input", "timeline", "spec-evidence"].includes(
+	return ["input", "timeline", "spec-evidence", "prompt-restart"].includes(
 		uiState.dagInspectorTab,
 	)
 		? uiState.dagInspectorTab
@@ -1214,7 +2013,7 @@ function effectiveExecutionKey(dagRunId, node) {
 async function fetchExecutionOutput(dagRunId, nodeId, key) {
 	const url = `/api/dag-runs/${encodeURIComponent(dagRunId)}/nodes/${encodeURIComponent(nodeId)}/execution-output?key=${encodeURIComponent(key)}`;
 	try {
-		const res = await fetch(url);
+		const res = await fetchWithWorkspaceScope(url);
 		let body = null;
 		try {
 			body = await res.json();
@@ -1254,7 +2053,7 @@ function appendOutputBody(content, outputText, errorText, options = null) {
 		content.appendChild(el("p", "empty", UI_TEXT.noOutput));
 		return;
 	}
-	if (outputText) content.appendChild(renderMarkdown(outputText));
+	if (outputText) content.appendChild(renderInspectorDocument(outputText));
 	// Truncation note only for full/cached execution-output bodies (AC-003);
 	// preview path never invents truncated/maxBytes.
 	if (options?.truncated === true) {
@@ -1270,7 +2069,7 @@ function appendOutputBody(content, outputText, errorText, options = null) {
 	if (errorText) {
 		const error = el("section", "markdown-error");
 		error.appendChild(el("p", "markdown-error-title", "错误输出"));
-		error.appendChild(renderMarkdown(errorText));
+		error.appendChild(renderInspectorDocument(errorText));
 		content.appendChild(error);
 	}
 }
@@ -1404,6 +2203,228 @@ function repaintOutputTabBody(content, dagRunId, node) {
 	restoreInspectorContentScroll(content, dagRunId, node.nodeId, "output");
 }
 
+function processEmptyMessage(body) {
+	const reason = body?.emptyReason;
+	if (reason === "static-no-process") return UI_TEXT.staticNoProcess;
+	if (reason === "shell-receipt-missing") return UI_TEXT.noShellProcess;
+	if (reason === "shell-preset-pending") return UI_TEXT.noPresetProcess;
+	if (reason === "pi-session") return UI_TEXT.noSessionEvents;
+	return UI_TEXT.noSessionEvents;
+}
+
+function formatProcessBlock(text) {
+	if (!text) return "";
+	return prettyJsonBlock(text) ?? text;
+}
+
+function appendProcessPre(parent, text) {
+	if (!text) return;
+	const pre = el("pre", "process-timeline-code");
+	pre.textContent = formatProcessBlock(text);
+	parent.appendChild(pre);
+}
+
+function renderProcessCommandCard(command) {
+	const failed = command.ok === false;
+	const card = el(
+		"div",
+		`process-timeline-card process-timeline-tool-card${failed ? " is-error" : ""}`,
+	);
+	const details = document.createElement("details");
+	details.className = "process-timeline-details";
+	details.open = failed;
+	const summary = el("summary", "process-timeline-summary");
+	summary.appendChild(
+		el("span", "process-timeline-summary-title", command.command || "command"),
+	);
+	summary.appendChild(
+		el(
+			"span",
+			`process-timeline-summary-status status-${failed ? "failed" : "succeeded"}`,
+			failed ? "失败" : command.reused ? "复用" : "成功",
+		),
+	);
+	details.appendChild(summary);
+	const body = el("div", "process-timeline-card-body");
+	const meta = [
+		command.exitCode != null ? `exit ${command.exitCode}` : null,
+		command.durationMs != null ? `耗时 ${formatMs(command.durationMs)}` : null,
+		command.failureCategory ? command.failureCategory : null,
+	].filter(Boolean);
+	if (meta.length > 0) {
+		body.appendChild(el("div", "process-timeline-section-label", meta.join(" · ")));
+	}
+	if (command.stdout) {
+		body.appendChild(el("div", "process-timeline-section-label", "stdout"));
+		appendProcessPre(body, command.stdout);
+	}
+	if (command.stderr) {
+		body.appendChild(el("div", "process-timeline-section-label", "stderr"));
+		appendProcessPre(body, command.stderr);
+	}
+	if (command.truncated) {
+		body.appendChild(el("p", "muted", "内容过长，已截断。"));
+	}
+	details.appendChild(body);
+	card.appendChild(details);
+	return card;
+}
+
+function renderProcessStepCard(step) {
+	const failed = step.ok === false;
+	const card = el(
+		"div",
+		`process-timeline-card process-timeline-tool-card${failed ? " is-error" : ""}`,
+	);
+	const details = document.createElement("details");
+	details.className = "process-timeline-details";
+	details.open = true;
+	const summary = el("summary", "process-timeline-summary");
+	summary.appendChild(
+		el("span", "process-timeline-summary-title", step.label || step.id || "step"),
+	);
+	summary.appendChild(
+		el(
+			"span",
+			`process-timeline-summary-status status-${failed ? "failed" : "succeeded"}`,
+			failed ? "失败" : "成功",
+		),
+	);
+	details.appendChild(summary);
+	const body = el("div", "process-timeline-card-body");
+	if (step.durationMs != null) {
+		body.appendChild(
+			el("div", "process-timeline-section-label", `耗时 ${formatMs(step.durationMs)}`),
+		);
+	}
+	if (step.detail) appendProcessPre(body, step.detail);
+	if (step.truncated) {
+		body.appendChild(el("p", "muted", "内容过长，已截断。"));
+	}
+	details.appendChild(body);
+	card.appendChild(details);
+	return card;
+}
+
+function renderNonPiProcess(content, body) {
+	content.classList.add("process-timeline-scroll");
+	if (!body || body.emptyReason || ((body.commands ?? []).length === 0 && (body.steps ?? []).length === 0)) {
+		content.appendChild(el("p", "empty", processEmptyMessage(body)));
+		return;
+	}
+	const heading =
+		body.kind === "shell-preset"
+			? UI_TEXT.shellPresetHeading
+			: UI_TEXT.shellCommandsHeading;
+	if (body.handler) {
+		content.appendChild(
+			el("p", "process-timeline-note", `${heading} · ${body.handler}`),
+		);
+	}
+	const ul = el("ul", "process-timeline process-timeline-rich");
+	const items = (body.commands ?? []).length > 0 ? body.commands : body.steps ?? [];
+	for (let index = 0; index < items.length; index += 1) {
+		const item = items[index];
+		const failed = item.ok === false;
+		const li = el(
+			"li",
+			`process-timeline-item process-timeline-tool-end${failed ? " is-error" : ""}${index === 0 ? " is-first" : ""}${index === items.length - 1 ? " is-last" : ""}`,
+		);
+		const rail = el("span", "process-timeline-rail");
+		rail.appendChild(el("span", "process-timeline-dot"));
+		li.appendChild(rail);
+		const cardBody = el("div", "process-timeline-body");
+		cardBody.appendChild(
+			body.kind === "shell-preset"
+				? renderProcessStepCard(item)
+				: renderProcessCommandCard(item),
+		);
+		li.appendChild(cardBody);
+		ul.appendChild(li);
+	}
+	content.appendChild(ul);
+}
+
+export async function mergeNodeProcess(dagRunId, node) {
+	if (!dagRunId || !node?.nodeId) return;
+	const nodeId = node.nodeId;
+	const key = effectiveExecutionKey(dagRunId, node);
+	const identity = makeDagNodeProcessIdentity(dagRunId, nodeId, key);
+	uiState.dagNodeProcessIdentity = identity;
+	uiState.dagNodeProcessLoading = true;
+	const result = await fetchDagNodeProcess(dagRunId, nodeId, key);
+	if (uiState.dagNodeProcessIdentity !== identity) return;
+	if (!result.ok || !result.body) {
+		uiState.dagNodeProcessError =
+			result.body?.error || UI_TEXT.processError;
+		uiState.dagNodeProcessData = {
+			schemaVersion: 1,
+			dagRunId,
+			nodeId,
+			kind: "none",
+			executor: node.executor ?? null,
+			handler: null,
+			emptyReason: "not-executed",
+			key: key ?? null,
+			commands: [],
+			steps: [],
+		};
+		uiState.dagNodeProcessLoading = false;
+		return;
+	}
+	uiState.dagNodeProcessError = null;
+	uiState.dagNodeProcessData = result.body;
+	uiState.dagNodeProcessLoading = false;
+}
+
+function renderExecutorAwareTimeline(content, dagRunId, node) {
+	content.dataset.dagRunId = String(dagRunId ?? "");
+	content.dataset.nodeId = String(node.nodeId ?? "");
+	const key = effectiveExecutionKey(dagRunId, node);
+	const cached = uiState.dagNodeProcessData;
+	const sameNode =
+		cached &&
+		cached.dagRunId === dagRunId &&
+		cached.nodeId === node.nodeId &&
+		(cached.key ?? null) === (key ?? null);
+	if (sameNode && uiState.dagNodeProcessError) {
+		content.appendChild(el("p", "empty", uiState.dagNodeProcessError));
+		return;
+	}
+	if (sameNode && cached.kind === "pi-session") {
+		renderSessionTimeline(content, node.nodeId, {
+			executionKey: effectiveExecutionKey(dagRunId, node),
+		});
+		return;
+	}
+	if (sameNode && cached.kind !== "pi-session") {
+		renderNonPiProcess(content, cached);
+		return;
+	}
+	if ((node.executor ?? "pi") === "pi") {
+		renderSessionTimeline(content, node.nodeId, {
+			executionKey: effectiveExecutionKey(dagRunId, node),
+		});
+		return;
+	}
+	if (uiState.dagNodeProcessError && sameNode) {
+		content.appendChild(el("p", "empty", uiState.dagNodeProcessError));
+		return;
+	}
+	const loading = el("p", "muted", UI_TEXT.processLoading);
+	loading.setAttribute("role", "status");
+	content.appendChild(loading);
+	void mergeNodeProcess(dagRunId, node).then(() => {
+		if (
+			uiState.dagInspectorTab === "timeline" &&
+			uiState.selectedDagNodeId === node.nodeId &&
+			uiState.currentDagRunId === dagRunId
+		) {
+			renderDagInspectorForCurrent();
+		}
+	});
+}
+
 function fillDagInspectorContent(content, dagRunId, node) {
 	const previousRenderedNode = content.dataset.dagNodeId ?? "";
 	const previousRenderedRun = content.dataset.dagRunId ?? "";
@@ -1450,10 +2471,12 @@ function fillDagInspectorContent(content, dagRunId, node) {
 	);
 	if (activeTab === "spec-evidence") {
 		void renderSpecEvidence(content, dagRunId, node.nodeId);
+	} else if (activeTab === "prompt-restart") {
+		void renderPromptRestart(content, dagRunId, node);
 	} else if (activeTab === "timeline") {
 		const attemptBuilt = buildAttemptBar(dagRunId, node);
 		if (attemptBuilt?.bar) content.appendChild(attemptBuilt.bar);
-		renderSessionTimeline(content, node.nodeId);
+		renderExecutorAwareTimeline(content, dagRunId, node);
 	} else if (activeTab === "input") {
 		void renderDagNodeInput(content, dagRunId, node);
 	} else {
@@ -1488,6 +2511,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 ?? "");
@@ -1495,6 +2528,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");
@@ -1517,6 +2551,13 @@ function buildDagInspectorHeader(dagRunId, node) {
 		["timeline", "执行过程", "ri-route-line"],
 		["spec-evidence", "规范证据", "ri-book-open-line"],
 	];
+	// 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"]);
+	}
 	const tabs = el("div", "dag-inspector-tabs");
 	tabs.setAttribute("role", "tablist");
 	tabs.setAttribute("aria-label", "节点检查器面板");
@@ -1567,6 +2608,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");
@@ -1606,7 +2657,14 @@ function dagInspectorSignature(dagRunId, node) {
 					uiState.dagNodeExecutionOutputLoading ? "loading" : "idle",
 				]
 			: tab === "timeline"
-				? [uiState.sessionEventOffset]
+				? [
+						uiState.sessionEventOffset,
+						uiState.dagNodeProcessData?.kind ?? "",
+						uiState.dagNodeProcessData?.emptyReason ?? "",
+						(uiState.dagNodeProcessData?.commands ?? []).length,
+						(uiState.dagNodeProcessData?.steps ?? []).length,
+						uiState.dagNodeProcessLoading ? "loading" : "idle",
+					]
 				: [node.status ?? ""];
 	// Attempt dimension: selection identity + history shape. Poll refreshes keep
 	// the DOM while selection/history are unchanged; switching attempt or a