@tea-agent/loop-agent 0.13.0-alpha.0 → 0.13.0-beta.0

package/dist/worker/observe/static/views/dashboard.js

@@ -1,445 +1,445 @@
-/** Observe UI view module (R5). */
-import {
-	UI_TEXT,
-	LIVENESS_LABELS,
-	ARTIFACT_LABELS,
-	ARTIFACT_KEYS,
-	STEP_LABELS,
-	STEP_ORDER,
-	DAG_INSPECTOR_DEFAULT_WIDTH,
-	DAG_INSPECTOR_MIN_WIDTH,
-	DAG_INSPECTOR_MAX_WIDTH,
-	DAG_INSPECTOR_RIGHT_OFFSET,
-	DAG_INSPECTOR_VIEWPORT_MARGIN,
-	DAG_INSPECTOR_KEYBOARD_STEP,
-	TERMINAL_RUN_STATUSES,
-	DAG_EFFECTIVE_STATUS_LABELS,
-	STATUS_LABELS,
-} from "../constants.js";
-import { clearNode, el, metaGrid, buildTable } from "../dom.js";
-import {
-	badge,
-	badgeClass,
-	statusLabel,
-	formatTs,
-	formatMs,
-	formatDuration,
-	formatAgo,
-	dagStatusBadge,
-	livenessBadge,
-	displayDurationMs,
-	derivedDurationMs,
-	summaryText,
-	truncateText,
-	repoBaseName,
-	parseMarkdownBlocks,
-	markdownLinkHref,
-} from "../format.js";
-import { parseRoute, navigate, buildHashPath } from "../router.js";
-import { fetchJson, artifactUrl, parseArtifactPreviewResponse } from "../api.js";
-import {
-	objectRouteLink,
-	findFeatureInSnapshot,
-	featureLookupState,
-	buildObjectRelations,
-	renderObjectRelationBar,
-} from "../relations.js";
-import { copyText, renderRecommendedCommand } from "../copy.js";
-import {
-	isPageVisible,
-	detailPollDelay,
-	dashboardPollDelay,
-	captureDagGraphViewportState,
-	updateDagGraphViewportState,
-	updateDagTimelineViewportState,
-	renderViewState,
-	mountViewState,
-} from "../state.js";
-import { uiState } from "../state.js";
-import { sortPoolTasks } from "../format-pool.js";
-import {
-	dagMetaVisibility,
-	isDagRunActive,
-	dashboardVisibleFeatures,
-	findDagForRun,
-} from "../dag-model.js";
-import { layoutDag } from "../dag-layout.js";
-import { showView, setBreadcrumb, updateHeaderRefresh } from "../shell-chrome.js";
-import { kpiCard, renderRepoBanner, renderProjectionFault, failuresInboxLink, artifactLink } from "../kpi.js";
-import { dagSortTime, renderActiveDagCard, dagProgress } from "../dag-helpers.js";
-
-export async function renderDashboard(scrollTo) {
-	showView("dashboard");
-	setBreadcrumb([{ label: UI_TEXT.dashboard }]);
-
-	const kpiEl = document.getElementById("dashboard-kpi");
-	const featureEl = document.getElementById("dashboard-features");
-	const activeEl = document.getElementById("dashboard-active-dags");
-	const riskEl = document.getElementById("dashboard-risk");
-	const dagsEl = document.getElementById("dashboard-dags");
-	const batchesEl = document.getElementById("dashboard-batches");
-	const repoEl = document.getElementById("dashboard-repo");
-	const host = kpiEl || featureEl || activeEl;
-	if (host) mountViewState(host, "loading", "加载看板…");
-
-	const snapshot = await fetchJson("/api/snapshot");
-	if (!snapshot) {
-		if (kpiEl) mountViewState(kpiEl, "error", "无法加载 snapshot。");
-		return;
-	}
-	uiState.lastSnapshot = snapshot;
-	updateHeaderRefresh(snapshot.generatedAt);
-
-	const dagRuns = snapshot.dagRuns ?? [];
-	const activeDags = dagRuns.filter(isDagRunActive);
-	const activeDagIds = new Set(activeDags.map((d) => d.dagRunId));
-	const recentDags = dagRuns
-		.filter((d) => !activeDagIds.has(d.dagRunId))
-		.sort((a, b) => dagSortTime(b).localeCompare(dagSortTime(a)))
-		.slice(0, 10);
-
-	const features = dashboardVisibleFeatures(snapshot.features);
-	featureEl.hidden = features.length === 0;
-	clearNode(featureEl);
-	if (features.length > 0) {
-		featureEl.appendChild(el("h3", "section-heading", "Feature 决策"));
-		featureEl.appendChild(
-			buildTable(
-				["Feature", "状态", "下一步（建议）", "原因", "required AC", "证据"],
-				features.map((feature) => {
-					const idCell = objectRouteLink(
-						"feature",
-						feature.featureId,
-						snapshot,
-					);
-					// Prefer planner-selected next task; never re-rank ready pool order here.
-					const selected = feature.planning?.selected?.[0];
-					const nextHint = selected
-						? `Next Task: ${selected.taskId} (${selected.priority})`
-						: feature.nextAction?.label ??
-							(feature.nextAction?.command
-								? truncateText(feature.nextAction.command, 48)
-								: "—");
-					return {
-						onClick: feature.featureId
-							? () =>
-									navigate(`/feature/${encodeURIComponent(feature.featureId)}`)
-							: undefined,
-						cells: [
-							idCell,
-							feature.statusLabel ?? feature.status,
-							nextHint,
-							feature.blockingItems?.[0]?.message ??
-								`${feature.summary?.tasksSucceeded ?? 0}/${feature.summary?.tasksTotal ?? 0} tasks completed`,
-							`${feature.summary?.requiredAcCovered ?? 0}/${feature.summary?.requiredAcTotal ?? 0}`,
-							artifactLink(
-								"查看",
-								feature.evidence?.delivery ??
-									feature.evidence?.closeout ??
-									feature.evidence?.morningReport ??
-									feature.evidence?.observeSnapshot,
-							),
-						],
-					};
-				}),
-			),
-		);
-	}
-	if (features.length > 0 && (snapshot.projectionWarnings ?? []).length > 0) {
-		featureEl.appendChild(
-			el("p", "empty", `投影警告：${snapshot.projectionWarnings.join("；")}`),
-		);
-	}
-
-	renderRepoBanner(repoEl, snapshot);
-
-	clearNode(kpiEl);
-	const dagHealth = snapshot.health?.dag;
-	const dagActiveRuns = dagHealth?.activeRuns ?? activeDags.length;
-	const dagRunningNodes =
-		dagHealth?.runningNodes ??
-		activeDags
-			.flatMap((dag) => dag.nodes ?? [])
-			.filter((node) =>
-				["running", "started"].includes((node.status ?? "").toLowerCase()),
-			).length;
-	const dagPendingNodes =
-		dagHealth?.pendingNodes ??
-		activeDags
-			.flatMap((dag) => dag.nodes ?? [])
-			.filter((node) =>
-				["pending", "queued"].includes((node.status ?? "").toLowerCase()),
-			).length;
-	const dagPausedRuns = dagHealth?.pausedRuns ?? 0;
-	const dagStaleRuns = dagHealth?.staleRuns ?? 0;
-	const dagInterruptedRuns = dagHealth?.interruptedRuns ?? 0;
-	const dagInconsistentRuns = dagHealth?.inconsistentRuns ?? 0;
-	const dagAttentionRuns =
-		dagHealth?.attentionRuns ??
-		dagRuns.filter(
-			(dag) =>
-				(dag.lifecycle ?? "").toLowerCase() !== "completed" &&
-				((dag.lifecycle ?? "").toLowerCase() === "paused" ||
-					["stale", "orphaned"].includes((dag.liveness ?? "").toLowerCase()) ||
-					["interrupted", "remote-unknown"].includes(dag.effectiveStatus) ||
-					dag.stateConsistent === false),
-		).length;
-
-	const quietCount = snapshot.health?.quietCount ?? 0;
-	const staleCount = snapshot.health?.staleCount ?? 0;
-	const timeoutRiskCount = snapshot.health?.timeoutRiskCount ?? 0;
-	const failuresCount = snapshot.health?.failuresCount ?? 0;
-
-	if (snapshot.projectionError) {
-		mountViewState(kpiEl, "degraded", "指标暂不可用：数据投影失败。", {
-			detail: snapshot.projectionError.message ?? null,
-		});
-		// keep legacy banner for non-color / structure parity
-		kpiEl.appendChild(renderProjectionFault(snapshot.projectionError));
-	} else {
-		const dagGroup = el("fieldset", "kpi-group");
-		dagGroup.appendChild(el("legend", "kpi-group-legend", "DAG 运行"));
-		const dagCards = el("div", "kpi-grid");
-		dagCards.appendChild(
-			kpiCard(
-				"活跃 DAG",
-				dagActiveRuns,
-				"kpi-highlight",
-				"当前处于运行、静默运行、远端状态未知或等待执行的 DAG 数量（来源：.harness/dag-runs 的有效状态）。",
-			),
-		);
-		dagCards.appendChild(
-			kpiCard(
-				"执行中节点",
-				dagRunningNodes,
-				"",
-				"活跃 DAG 中状态为 running 或 started、正在执行的节点数量；DAG 内执行单元统一称为节点。",
-			),
-		);
-		dagCards.appendChild(
-			kpiCard(
-				"等待节点",
-				dagPendingNodes,
-				"",
-				"活跃 DAG 中状态为 pending 或 queued、尚未开始执行的节点数量。",
-			),
-		);
-		dagCards.appendChild(
-			kpiCard(
-				"暂停 DAG",
-				dagPausedRuns,
-				dagPausedRuns > 0 ? "kpi-muted" : "",
-				"生命周期被暂停的 DAG 运行数量（来源：.harness/dag-runs 下的 lifecycle 目录）。",
-			),
-		);
-		dagCards.appendChild(
-			kpiCard(
-				"需处理 DAG",
-				dagAttentionRuns,
-				dagAttentionRuns > 0 ? "kpi-risk" : "",
-				"未完成且暂停、失联、中断、远端状态未知或状态不一致的 DAG 数量；同一个 DAG 只计一次。",
-			),
-		);
-		dagGroup.appendChild(dagCards);
-
-		const workerGroup = el("fieldset", "kpi-group");
-		workerGroup.appendChild(el("legend", "kpi-group-legend", "Worker 执行"));
-		const workerCards = el("div", "kpi-grid");
-		workerCards.appendChild(
-			kpiCard(
-				"活跃 Worker Task",
-				snapshot.health?.activeTasks ?? 0,
-				"",
-				"当前运行或等待执行的 Worker Task Pool 任务数量（来源：.harness/task-pool 的状态、运行记录与事件；不含 .harness/tasks 下的 task.json）。",
-			),
-		);
-		workerCards.appendChild(
-			kpiCard(
-				"无输出",
-				quietCount,
-				quietCount > 0 ? "kpi-muted" : "",
-				"心跳仍正常，但超过无输出判定时长仍没有新输出的 Worker Task 数量。",
-			),
-		);
-		workerCards.appendChild(
-			kpiCard(
-				"心跳失联",
-				staleCount,
-				staleCount > 0 ? "kpi-risk" : "",
-				"超过心跳失联判定时长仍没有新心跳的 Worker Task 数量。",
-			),
-		);
-		workerCards.appendChild(
-			kpiCard(
-				"即将超时",
-				timeoutRiskCount,
-				timeoutRiskCount > 0 ? "kpi-risk" : "",
-				"命令已执行时长超过 80% 超时的 Worker Task 数量。",
-			),
-		);
-		workerCards.appendChild(
-			kpiCard(
-				"失败",
-				failuresCount > 0 ? failuresInboxLink(failuresCount) : failuresCount,
-				failuresCount > 0 ? "kpi-danger" : "",
-				"状态为 failed 的 Worker Task 数量。",
-			),
-		);
-		workerGroup.appendChild(workerCards);
-		kpiEl.appendChild(workerGroup);
-		kpiEl.appendChild(dagGroup);
-	}
-
-	const nowMs = Date.now();
-
-	clearNode(activeEl);
-	activeEl.appendChild(el("h3", "section-heading", UI_TEXT.activeDags));
-	if (activeDags.length === 0) {
-		activeEl.appendChild(el("p", "empty", UI_TEXT.noActiveDags));
-	} else {
-		const list = el("div", "active-dag-list");
-		for (const dag of activeDags.sort((a, b) =>
-			dagSortTime(b).localeCompare(dagSortTime(a)),
-		)) {
-			list.appendChild(renderActiveDagCard(dag, nowMs));
-		}
-		activeEl.appendChild(list);
-	}
-
-	clearNode(riskEl);
-	const dagRiskCount = dagAttentionRuns;
-	const workerRiskCount = failuresCount + staleCount + timeoutRiskCount;
-	riskEl.classList.toggle(
-		"panel-risk-attention",
-		dagRiskCount > 0 || workerRiskCount > 0,
-	);
-	riskEl.appendChild(el("h3", "section-heading", "运行风险"));
-	if (dagRiskCount === 0 && workerRiskCount === 0) {
-		riskEl.appendChild(el("p", "risk-empty", "当前没有需要处理的异常。"));
-	} else {
-		const riskBlocks = el("div", "risk-blocks");
-		if (dagRiskCount > 0) {
-			const dagBlock = el("div", "risk-block risk-block-dag");
-			dagBlock.appendChild(el("div", "risk-block-label", "需处理 DAG"));
-			dagBlock.appendChild(el("div", "risk-total", String(dagRiskCount)));
-			dagBlock.appendChild(
-				el(
-					"p",
-					"risk-summary",
-					`去重运行数 ${dagAttentionRuns} · 中断 ${dagInterruptedRuns} · 失联 ${dagStaleRuns} · 状态不一致 ${dagInconsistentRuns} · 暂停 ${dagPausedRuns}`,
-				),
-			);
-			riskBlocks.appendChild(dagBlock);
-		}
-		if (workerRiskCount > 0) {
-			const workerBlock = el("div", "risk-block risk-block-worker");
-			workerBlock.appendChild(el("div", "risk-block-label", "Worker 风险"));
-			workerBlock.appendChild(el("div", "risk-total", String(workerRiskCount)));
-			workerBlock.appendChild(
-				el(
-					"p",
-					"risk-summary",
-					`失败 ${failuresCount} · 心跳失联 ${staleCount} · 即将超时 ${timeoutRiskCount}`,
-				),
-			);
-			const link = el("a", "risk-link", "查看异常 Task →");
-			link.href = "#/failures";
-			link.addEventListener("click", (event) => {
-				event.preventDefault();
-				navigate("/failures");
-			});
-			workerBlock.appendChild(link);
-			riskBlocks.appendChild(workerBlock);
-		}
-		riskEl.appendChild(riskBlocks);
-	}
-
-	clearNode(dagsEl);
-	dagsEl.id = "dashboard-dags";
-	dagsEl.appendChild(el("h3", "section-heading", UI_TEXT.recentDags));
-	if (recentDags.length === 0 && activeDags.length === 0) {
-		dagsEl.appendChild(el("p", "empty", UI_TEXT.noRecentDags));
-	} else if (recentDags.length === 0) {
-		dagsEl.appendChild(el("p", "empty", "暂无历史 DAG 记录"));
-	} else {
-		const timeline = el("div", "dag-run-timeline");
-		for (const dag of recentDags) {
-			const progress = dagProgress(dag);
-			const item = el("a", "dag-run-timeline-item");
-			item.href = `#/dag/${encodeURIComponent(dag.dagRunId)}`;
-			item.title = dag.title || dag.dagRunId;
-			item.addEventListener("click", (event) => {
-				event.preventDefault();
-				navigate(`/dag/${encodeURIComponent(dag.dagRunId)}`);
-			});
-
-			const rail = el("span", "dag-run-timeline-rail");
-			rail.appendChild(
-				el(
-					"span",
-					`dag-run-timeline-dot status-${badgeClass(dag.effectiveStatus ?? dag.status)}`,
-				),
-			);
-			item.appendChild(rail);
-
-			const content = el("span", "dag-run-timeline-content");
-			content.appendChild(
-				el("span", "dag-run-timeline-title", dag.title || dag.dagRunId),
-			);
-			content.appendChild(
-				el(
-					"span",
-					"dag-run-timeline-meta",
-					`${formatTs(dag.startedAt)} · ${progress.finished}/${progress.total} · ${formatDuration(dag.durationMs)}`,
-				),
-			);
-			item.appendChild(content);
-
-			const state = el("span", "dag-run-timeline-status");
-			state.appendChild(dagStatusBadge(dag.effectiveStatus ?? dag.status));
-			item.appendChild(state);
-			timeline.appendChild(item);
-		}
-		dagsEl.appendChild(timeline);
-	}
-
-	clearNode(batchesEl);
-	batchesEl.appendChild(el("h3", "section-heading", UI_TEXT.batches));
-	const batches = snapshot.batches ?? [];
-	if (batches.length === 0) {
-		batchesEl.appendChild(el("p", "empty", UI_TEXT.noBatches));
-	} else {
-		const rows = batches.map((batch) => ({
-			onClick: () => navigate(`/batch/${encodeURIComponent(batch.batchRunId)}`),
-			cells: [
-				batch.batchRunId,
-				batch.featureId ?? "—",
-				badge(batch.status),
-				formatTs(batch.startedAt),
-				summaryText(batch.summary),
-			],
-		}));
-		batchesEl.appendChild(
-			buildTable(["批次 ID", "功能", "状态", "开始时间", "摘要"], rows),
-		);
-	}
-
-	if (scrollTo === "dags") {
-		dagsEl.scrollIntoView({ behavior: "smooth" });
-	}
-}
-
-export function startDashboardPolling(scrollTo) {
-	if (uiState.dashboardTimer) clearTimeout(uiState.dashboardTimer);
-	const generation = ++uiState.pollingGeneration;
-	const poll = async (initialScrollTo) => {
-		await renderDashboard(initialScrollTo);
-		if (generation !== uiState.pollingGeneration) return;
-		uiState.dashboardTimer = setTimeout(() => {
-			uiState.dashboardTimer = null;
-			void poll();
-		}, dashboardPollDelay());
-	};
-	void poll(scrollTo);
-}
-
+/** Observe UI view module (R5). */
+import {
+	UI_TEXT,
+	LIVENESS_LABELS,
+	ARTIFACT_LABELS,
+	ARTIFACT_KEYS,
+	STEP_LABELS,
+	STEP_ORDER,
+	DAG_INSPECTOR_DEFAULT_WIDTH,
+	DAG_INSPECTOR_MIN_WIDTH,
+	DAG_INSPECTOR_MAX_WIDTH,
+	DAG_INSPECTOR_RIGHT_OFFSET,
+	DAG_INSPECTOR_VIEWPORT_MARGIN,
+	DAG_INSPECTOR_KEYBOARD_STEP,
+	TERMINAL_RUN_STATUSES,
+	DAG_EFFECTIVE_STATUS_LABELS,
+	STATUS_LABELS,
+} from "../constants.js";
+import { clearNode, el, metaGrid, buildTable } from "../dom.js";
+import {
+	badge,
+	badgeClass,
+	statusLabel,
+	formatTs,
+	formatMs,
+	formatDuration,
+	formatAgo,
+	dagStatusBadge,
+	livenessBadge,
+	displayDurationMs,
+	derivedDurationMs,
+	summaryText,
+	truncateText,
+	repoBaseName,
+	parseMarkdownBlocks,
+	markdownLinkHref,
+} from "../format.js";
+import { parseRoute, navigate, buildHashPath } from "../router.js";
+import { fetchJson, artifactUrl, parseArtifactPreviewResponse } from "../api.js";
+import {
+	objectRouteLink,
+	findFeatureInSnapshot,
+	featureLookupState,
+	buildObjectRelations,
+	renderObjectRelationBar,
+} from "../relations.js";
+import { copyText, renderRecommendedCommand } from "../copy.js";
+import {
+	isPageVisible,
+	detailPollDelay,
+	dashboardPollDelay,
+	captureDagGraphViewportState,
+	updateDagGraphViewportState,
+	updateDagTimelineViewportState,
+	renderViewState,
+	mountViewState,
+} from "../state.js";
+import { uiState } from "../state.js";
+import { sortPoolTasks } from "../format-pool.js";
+import {
+	dagMetaVisibility,
+	isDagRunActive,
+	dashboardVisibleFeatures,
+	findDagForRun,
+} from "../dag-model.js";
+import { layoutDag } from "../dag-layout.js";
+import { showView, setBreadcrumb, updateHeaderRefresh } from "../shell-chrome.js";
+import { kpiCard, renderRepoBanner, renderProjectionFault, failuresInboxLink, artifactLink } from "../kpi.js";
+import { dagSortTime, renderActiveDagCard, dagProgress } from "../dag-helpers.js";
+
+export async function renderDashboard(scrollTo) {
+	showView("dashboard");
+	setBreadcrumb([{ label: UI_TEXT.dashboard }]);
+
+	const kpiEl = document.getElementById("dashboard-kpi");
+	const featureEl = document.getElementById("dashboard-features");
+	const activeEl = document.getElementById("dashboard-active-dags");
+	const riskEl = document.getElementById("dashboard-risk");
+	const dagsEl = document.getElementById("dashboard-dags");
+	const batchesEl = document.getElementById("dashboard-batches");
+	const repoEl = document.getElementById("dashboard-repo");
+	const host = kpiEl || featureEl || activeEl;
+	if (host) mountViewState(host, "loading", "加载看板…");
+
+	const snapshot = await fetchJson("/api/snapshot");
+	if (!snapshot) {
+		if (kpiEl) mountViewState(kpiEl, "error", "无法加载 snapshot。");
+		return;
+	}
+	uiState.lastSnapshot = snapshot;
+	updateHeaderRefresh(snapshot.generatedAt);
+
+	const dagRuns = snapshot.dagRuns ?? [];
+	const activeDags = dagRuns.filter(isDagRunActive);
+	const activeDagIds = new Set(activeDags.map((d) => d.dagRunId));
+	const recentDags = dagRuns
+		.filter((d) => !activeDagIds.has(d.dagRunId))
+		.sort((a, b) => dagSortTime(b).localeCompare(dagSortTime(a)))
+		.slice(0, 10);
+
+	const features = dashboardVisibleFeatures(snapshot.features);
+	featureEl.hidden = features.length === 0;
+	clearNode(featureEl);
+	if (features.length > 0) {
+		featureEl.appendChild(el("h3", "section-heading", "Feature 决策"));
+		featureEl.appendChild(
+			buildTable(
+				["Feature", "状态", "下一步（建议）", "原因", "required AC", "证据"],
+				features.map((feature) => {
+					const idCell = objectRouteLink(
+						"feature",
+						feature.featureId,
+						snapshot,
+					);
+					// Prefer planner-selected next task; never re-rank ready pool order here.
+					const selected = feature.planning?.selected?.[0];
+					const nextHint = selected
+						? `Next Task: ${selected.taskId} (${selected.priority})`
+						: feature.nextAction?.label ??
+							(feature.nextAction?.command
+								? truncateText(feature.nextAction.command, 48)
+								: "—");
+					return {
+						onClick: feature.featureId
+							? () =>
+									navigate(`/feature/${encodeURIComponent(feature.featureId)}`)
+							: undefined,
+						cells: [
+							idCell,
+							feature.statusLabel ?? feature.status,
+							nextHint,
+							feature.blockingItems?.[0]?.message ??
+								`${feature.summary?.tasksSucceeded ?? 0}/${feature.summary?.tasksTotal ?? 0} tasks completed`,
+							`${feature.summary?.requiredAcCovered ?? 0}/${feature.summary?.requiredAcTotal ?? 0}`,
+							artifactLink(
+								"查看",
+								feature.evidence?.delivery ??
+									feature.evidence?.closeout ??
+									feature.evidence?.morningReport ??
+									feature.evidence?.observeSnapshot,
+							),
+						],
+					};
+				}),
+			),
+		);
+	}
+	if (features.length > 0 && (snapshot.projectionWarnings ?? []).length > 0) {
+		featureEl.appendChild(
+			el("p", "empty", `投影警告：${snapshot.projectionWarnings.join("；")}`),
+		);
+	}
+
+	renderRepoBanner(repoEl, snapshot);
+
+	clearNode(kpiEl);
+	const dagHealth = snapshot.health?.dag;
+	const dagActiveRuns = dagHealth?.activeRuns ?? activeDags.length;
+	const dagRunningNodes =
+		dagHealth?.runningNodes ??
+		activeDags
+			.flatMap((dag) => dag.nodes ?? [])
+			.filter((node) =>
+				["running", "started"].includes((node.status ?? "").toLowerCase()),
+			).length;
+	const dagPendingNodes =
+		dagHealth?.pendingNodes ??
+		activeDags
+			.flatMap((dag) => dag.nodes ?? [])
+			.filter((node) =>
+				["pending", "queued"].includes((node.status ?? "").toLowerCase()),
+			).length;
+	const dagPausedRuns = dagHealth?.pausedRuns ?? 0;
+	const dagStaleRuns = dagHealth?.staleRuns ?? 0;
+	const dagInterruptedRuns = dagHealth?.interruptedRuns ?? 0;
+	const dagInconsistentRuns = dagHealth?.inconsistentRuns ?? 0;
+	const dagAttentionRuns =
+		dagHealth?.attentionRuns ??
+		dagRuns.filter(
+			(dag) =>
+				(dag.lifecycle ?? "").toLowerCase() !== "completed" &&
+				((dag.lifecycle ?? "").toLowerCase() === "paused" ||
+					["stale", "orphaned"].includes((dag.liveness ?? "").toLowerCase()) ||
+					["interrupted", "remote-unknown"].includes(dag.effectiveStatus) ||
+					dag.stateConsistent === false),
+		).length;
+
+	const quietCount = snapshot.health?.quietCount ?? 0;
+	const staleCount = snapshot.health?.staleCount ?? 0;
+	const timeoutRiskCount = snapshot.health?.timeoutRiskCount ?? 0;
+	const failuresCount = snapshot.health?.failuresCount ?? 0;
+
+	if (snapshot.projectionError) {
+		mountViewState(kpiEl, "degraded", "指标暂不可用：数据投影失败。", {
+			detail: snapshot.projectionError.message ?? null,
+		});
+		// keep legacy banner for non-color / structure parity
+		kpiEl.appendChild(renderProjectionFault(snapshot.projectionError));
+	} else {
+		const dagGroup = el("fieldset", "kpi-group");
+		dagGroup.appendChild(el("legend", "kpi-group-legend", "DAG 运行"));
+		const dagCards = el("div", "kpi-grid");
+		dagCards.appendChild(
+			kpiCard(
+				"活跃 DAG",
+				dagActiveRuns,
+				"kpi-highlight",
+				"当前处于运行、静默运行、远端状态未知或等待执行的 DAG 数量（来源：.harness/dag-runs 的有效状态）。",
+			),
+		);
+		dagCards.appendChild(
+			kpiCard(
+				"执行中节点",
+				dagRunningNodes,
+				"",
+				"活跃 DAG 中状态为 running 或 started、正在执行的节点数量；DAG 内执行单元统一称为节点。",
+			),
+		);
+		dagCards.appendChild(
+			kpiCard(
+				"等待节点",
+				dagPendingNodes,
+				"",
+				"活跃 DAG 中状态为 pending 或 queued、尚未开始执行的节点数量。",
+			),
+		);
+		dagCards.appendChild(
+			kpiCard(
+				"暂停 DAG",
+				dagPausedRuns,
+				dagPausedRuns > 0 ? "kpi-muted" : "",
+				"生命周期被暂停的 DAG 运行数量（来源：.harness/dag-runs 下的 lifecycle 目录）。",
+			),
+		);
+		dagCards.appendChild(
+			kpiCard(
+				"需处理 DAG",
+				dagAttentionRuns,
+				dagAttentionRuns > 0 ? "kpi-risk" : "",
+				"未完成且暂停、失联、中断、远端状态未知或状态不一致的 DAG 数量；同一个 DAG 只计一次。",
+			),
+		);
+		dagGroup.appendChild(dagCards);
+
+		const workerGroup = el("fieldset", "kpi-group");
+		workerGroup.appendChild(el("legend", "kpi-group-legend", "Worker 执行"));
+		const workerCards = el("div", "kpi-grid");
+		workerCards.appendChild(
+			kpiCard(
+				"活跃 Worker Task",
+				snapshot.health?.activeTasks ?? 0,
+				"",
+				"当前运行或等待执行的 Worker Task Pool 任务数量（来源：.harness/task-pool 的状态、运行记录与事件；不含 .harness/tasks 下的 task.json）。",
+			),
+		);
+		workerCards.appendChild(
+			kpiCard(
+				"无输出",
+				quietCount,
+				quietCount > 0 ? "kpi-muted" : "",
+				"心跳仍正常，但超过无输出判定时长仍没有新输出的 Worker Task 数量。",
+			),
+		);
+		workerCards.appendChild(
+			kpiCard(
+				"心跳失联",
+				staleCount,
+				staleCount > 0 ? "kpi-risk" : "",
+				"超过心跳失联判定时长仍没有新心跳的 Worker Task 数量。",
+			),
+		);
+		workerCards.appendChild(
+			kpiCard(
+				"即将超时",
+				timeoutRiskCount,
+				timeoutRiskCount > 0 ? "kpi-risk" : "",
+				"命令已执行时长超过 80% 超时的 Worker Task 数量。",
+			),
+		);
+		workerCards.appendChild(
+			kpiCard(
+				"失败",
+				failuresCount > 0 ? failuresInboxLink(failuresCount) : failuresCount,
+				failuresCount > 0 ? "kpi-danger" : "",
+				"状态为 failed 的 Worker Task 数量。",
+			),
+		);
+		workerGroup.appendChild(workerCards);
+		kpiEl.appendChild(workerGroup);
+		kpiEl.appendChild(dagGroup);
+	}
+
+	const nowMs = Date.now();
+
+	clearNode(activeEl);
+	activeEl.appendChild(el("h3", "section-heading", UI_TEXT.activeDags));
+	if (activeDags.length === 0) {
+		activeEl.appendChild(el("p", "empty", UI_TEXT.noActiveDags));
+	} else {
+		const list = el("div", "active-dag-list");
+		for (const dag of activeDags.sort((a, b) =>
+			dagSortTime(b).localeCompare(dagSortTime(a)),
+		)) {
+			list.appendChild(renderActiveDagCard(dag, nowMs));
+		}
+		activeEl.appendChild(list);
+	}
+
+	clearNode(riskEl);
+	const dagRiskCount = dagAttentionRuns;
+	const workerRiskCount = failuresCount + staleCount + timeoutRiskCount;
+	riskEl.classList.toggle(
+		"panel-risk-attention",
+		dagRiskCount > 0 || workerRiskCount > 0,
+	);
+	riskEl.appendChild(el("h3", "section-heading", "运行风险"));
+	if (dagRiskCount === 0 && workerRiskCount === 0) {
+		riskEl.appendChild(el("p", "risk-empty", "当前没有需要处理的异常。"));
+	} else {
+		const riskBlocks = el("div", "risk-blocks");
+		if (dagRiskCount > 0) {
+			const dagBlock = el("div", "risk-block risk-block-dag");
+			dagBlock.appendChild(el("div", "risk-block-label", "需处理 DAG"));
+			dagBlock.appendChild(el("div", "risk-total", String(dagRiskCount)));
+			dagBlock.appendChild(
+				el(
+					"p",
+					"risk-summary",
+					`去重运行数 ${dagAttentionRuns} · 中断 ${dagInterruptedRuns} · 失联 ${dagStaleRuns} · 状态不一致 ${dagInconsistentRuns} · 暂停 ${dagPausedRuns}`,
+				),
+			);
+			riskBlocks.appendChild(dagBlock);
+		}
+		if (workerRiskCount > 0) {
+			const workerBlock = el("div", "risk-block risk-block-worker");
+			workerBlock.appendChild(el("div", "risk-block-label", "Worker 风险"));
+			workerBlock.appendChild(el("div", "risk-total", String(workerRiskCount)));
+			workerBlock.appendChild(
+				el(
+					"p",
+					"risk-summary",
+					`失败 ${failuresCount} · 心跳失联 ${staleCount} · 即将超时 ${timeoutRiskCount}`,
+				),
+			);
+			const link = el("a", "risk-link", "查看异常 Task →");
+			link.href = "#/failures";
+			link.addEventListener("click", (event) => {
+				event.preventDefault();
+				navigate("/failures");
+			});
+			workerBlock.appendChild(link);
+			riskBlocks.appendChild(workerBlock);
+		}
+		riskEl.appendChild(riskBlocks);
+	}
+
+	clearNode(dagsEl);
+	dagsEl.id = "dashboard-dags";
+	dagsEl.appendChild(el("h3", "section-heading", UI_TEXT.recentDags));
+	if (recentDags.length === 0 && activeDags.length === 0) {
+		dagsEl.appendChild(el("p", "empty", UI_TEXT.noRecentDags));
+	} else if (recentDags.length === 0) {
+		dagsEl.appendChild(el("p", "empty", "暂无历史 DAG 记录"));
+	} else {
+		const timeline = el("div", "dag-run-timeline");
+		for (const dag of recentDags) {
+			const progress = dagProgress(dag);
+			const item = el("a", "dag-run-timeline-item");
+			item.href = `#/dag/${encodeURIComponent(dag.dagRunId)}`;
+			item.title = dag.title || dag.dagRunId;
+			item.addEventListener("click", (event) => {
+				event.preventDefault();
+				navigate(`/dag/${encodeURIComponent(dag.dagRunId)}`);
+			});
+
+			const rail = el("span", "dag-run-timeline-rail");
+			rail.appendChild(
+				el(
+					"span",
+					`dag-run-timeline-dot status-${badgeClass(dag.effectiveStatus ?? dag.status)}`,
+				),
+			);
+			item.appendChild(rail);
+
+			const content = el("span", "dag-run-timeline-content");
+			content.appendChild(
+				el("span", "dag-run-timeline-title", dag.title || dag.dagRunId),
+			);
+			content.appendChild(
+				el(
+					"span",
+					"dag-run-timeline-meta",
+					`${formatTs(dag.startedAt)} · ${progress.finished}/${progress.total} · ${formatDuration(dag.durationMs)}`,
+				),
+			);
+			item.appendChild(content);
+
+			const state = el("span", "dag-run-timeline-status");
+			state.appendChild(dagStatusBadge(dag.effectiveStatus ?? dag.status));
+			item.appendChild(state);
+			timeline.appendChild(item);
+		}
+		dagsEl.appendChild(timeline);
+	}
+
+	clearNode(batchesEl);
+	batchesEl.appendChild(el("h3", "section-heading", UI_TEXT.batches));
+	const batches = snapshot.batches ?? [];
+	if (batches.length === 0) {
+		batchesEl.appendChild(el("p", "empty", UI_TEXT.noBatches));
+	} else {
+		const rows = batches.map((batch) => ({
+			onClick: () => navigate(`/batch/${encodeURIComponent(batch.batchRunId)}`),
+			cells: [
+				batch.batchRunId,
+				batch.featureId ?? "—",
+				badge(batch.status),
+				formatTs(batch.startedAt),
+				summaryText(batch.summary),
+			],
+		}));
+		batchesEl.appendChild(
+			buildTable(["批次 ID", "功能", "状态", "开始时间", "摘要"], rows),
+		);
+	}
+
+	if (scrollTo === "dags") {
+		dagsEl.scrollIntoView({ behavior: "smooth" });
+	}
+}
+
+export function startDashboardPolling(scrollTo) {
+	if (uiState.dashboardTimer) clearTimeout(uiState.dashboardTimer);
+	const generation = ++uiState.pollingGeneration;
+	const poll = async (initialScrollTo) => {
+		await renderDashboard(initialScrollTo);
+		if (generation !== uiState.pollingGeneration) return;
+		uiState.dashboardTimer = setTimeout(() => {
+			uiState.dashboardTimer = null;
+			void poll();
+		}, dashboardPollDelay());
+	};
+	void poll(scrollTo);
+}
+