@tea-agent/loop-agent 0.10.0 → 0.12.0

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

@@ -0,0 +1,442 @@
+/** 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,
+					);
+					const nextHint =
+						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);
+}
+

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

@@ -0,0 +1,143 @@
+/** 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 { artifactLink } from "../kpi.js";
+
+export async function renderFailures() {
+	showView("failures");
+	setBreadcrumb([
+		{ label: UI_TEXT.dashboard, href: "#/" },
+		{ label: UI_TEXT.failures },
+	]);
+
+	const listEl = document.getElementById("failures-list");
+	const emptyEl = document.getElementById("failures-empty");
+	clearNode(listEl);
+	if (emptyEl) {
+		emptyEl.hidden = true;
+		clearNode(emptyEl);
+	}
+	if (listEl) mountViewState(listEl, "loading", "加载失败收件箱…");
+
+	const snapshot = await fetchJson("/api/snapshot");
+	if (!snapshot) {
+		if (listEl) mountViewState(listEl, "error", "无法加载 snapshot。");
+		return;
+	}
+	uiState.lastSnapshot = snapshot;
+	updateHeaderRefresh(snapshot.generatedAt);
+
+	const tasks = (snapshot.tasks ?? []).filter(
+		(task) =>
+			task.status === "failed" ||
+			task.status === "blocked" ||
+			task.status === "stale" ||
+			task.liveness === "stale",
+	);
+
+	if (tasks.length === 0) {
+		clearNode(listEl);
+		if (emptyEl) {
+			emptyEl.hidden = false;
+			mountViewState(emptyEl, "empty", "当前没有失败或阻塞的 Task。");
+		} else {
+			mountViewState(listEl, "empty", "当前没有失败或阻塞的 Task。");
+		}
+		return;
+	}
+	if (emptyEl) emptyEl.hidden = true;
+	clearNode(listEl);
+
+	const refs = (task) => task.artifactRefs ?? {};
+	const rows = tasks.map((task) => ({
+		className: `row-${task.status}`,
+		onClick: task.workerRunId
+			? () => navigate(`/run/${encodeURIComponent(task.workerRunId)}`)
+			: undefined,
+		cells: [
+			task.taskId ?? "—",
+			task.featureId ?? "—",
+			badge(task.status),
+			task.failureCategory ?? "—",
+			task.recommendedFollowUp ?? "—",
+			(() => {
+				const links = el("div", "artifact-links");
+				const r = refs(task);
+				links.appendChild(artifactLink("报告", r.reportMarkdown));
+				links.appendChild(document.createTextNode(" "));
+				links.appendChild(artifactLink("诊断", r.doctorMarkdown));
+				links.appendChild(document.createTextNode(" "));
+				links.appendChild(artifactLink("收尾方案", r.closeoutDraft));
+				return links;
+			})(),
+		],
+	}));
+	listEl.appendChild(
+		buildTable(["Task ID", "功能", "状态", "分类", "建议跟进", "产物"], rows),
+	);
+}
+