@tea-agent/loop-agent 0.11.0 → 0.12.0

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

@@ -0,0 +1,347 @@
+/** 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,
+	matchesPoolStatusFilter,
+	poolStatusCounts,
+} 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 { renderProjectionFault } from "../kpi.js";
+import { mountBoundedEventTimeline } from "./timeline.js";
+
+export async function renderPool() {
+	showView("pool");
+	setBreadcrumb([
+		{ label: UI_TEXT.dashboard, href: "#/" },
+		{ label: "资源池" },
+	]);
+
+	const faultEl = document.getElementById("pool-fault");
+	const kpiEl = document.getElementById("pool-kpi");
+	const emptyEl = document.getElementById("pool-empty");
+	const listEl = document.getElementById("pool-tasks");
+	const eventsEl = document.getElementById("pool-events");
+	if (!faultEl || !kpiEl || !emptyEl || !listEl) return;
+
+	mountViewState(faultEl, "loading", "加载资源池…");
+	clearNode(kpiEl);
+	clearNode(listEl);
+	clearNode(emptyEl);
+	emptyEl.hidden = true;
+
+	const snapshot = await fetchJson("/api/snapshot");
+	if (!snapshot) {
+		clearNode(kpiEl);
+		clearNode(listEl);
+		clearNode(emptyEl);
+		emptyEl.hidden = true;
+		if (eventsEl) clearNode(eventsEl);
+		mountViewState(faultEl, "error", "无法加载 snapshot。");
+		return;
+	}
+	uiState.lastSnapshot = snapshot;
+	updateHeaderRefresh(snapshot.generatedAt);
+
+	clearNode(faultEl);
+	if (snapshot.projectionError) {
+		mountViewState(faultEl, "degraded", "投影降级：状态分布可能不完整。", {
+			detail: snapshot.projectionError.message ?? null,
+		});
+		faultEl.appendChild(
+			renderProjectionFault(snapshot.projectionError),
+		);
+	}
+	if ((snapshot.projectionWarnings ?? []).length > 0) {
+		const warn = el("div", "projection-fault");
+		const body = el("div", "projection-fault-body");
+		body.appendChild(el("p", "projection-fault-title", "投影警告"));
+		body.appendChild(
+			el(
+				"p",
+				"projection-fault-message",
+				snapshot.projectionWarnings.join("；"),
+			),
+		);
+		warn.appendChild(body);
+		faultEl.appendChild(warn);
+	}
+	if (snapshot.generatedAt) {
+		faultEl.appendChild(
+			el(
+				"p",
+				"muted pool-updated-at",
+				`投影更新时间：${formatTs(snapshot.generatedAt)}（derived/advisory）`,
+			),
+		);
+	}
+
+	const allTasks = sortPoolTasks(snapshot.tasks ?? []);
+	const routeFilters = parseRoute().filters ?? {};
+	const statusFilter = (routeFilters.status ?? "").toLowerCase();
+	const qFilter = (routeFilters.q ?? "").trim().toLowerCase();
+	const tasks = allTasks.filter((task) => {
+		if (statusFilter && !matchesPoolStatusFilter(task.status, statusFilter)) {
+			return false;
+		}
+		if (qFilter) {
+			const hay =
+				`${task.taskId ?? ""} ${task.featureId ?? ""} ${task.workerRunId ?? ""} ${task.failureCategory ?? ""}`.toLowerCase();
+			if (!hay.includes(qFilter)) return false;
+		}
+		return true;
+	});
+	const poolPresent = snapshot.taskPool?.present === true;
+	const projectionFailed = Boolean(snapshot.projectionError);
+
+	// Shareable hash filters (REQ-R5-04)
+	if (listEl) {
+		let filtersEl = document.getElementById("pool-filters");
+		if (!filtersEl) {
+			filtersEl = el("div", "pool-filters");
+			filtersEl.id = "pool-filters";
+			listEl.parentElement?.insertBefore(filtersEl, listEl);
+		}
+		clearNode(filtersEl);
+		const statusLabelEl = el("label", null);
+		statusLabelEl.appendChild(document.createTextNode("状态"));
+		const statusSelect = document.createElement("select");
+		statusSelect.setAttribute("aria-label", "按状态筛选 Task");
+		for (const [value, label] of [
+			["", "全部"],
+			["running", "运行中"],
+			["pending", "等待/排队"],
+			["blocked", "阻塞/失联"],
+			["failed", "失败"],
+			["succeeded", "成功/复用"],
+		]) {
+			const opt = document.createElement("option");
+			opt.value = value;
+			opt.textContent = label;
+			if (value === statusFilter) opt.selected = true;
+			statusSelect.appendChild(opt);
+		}
+		statusLabelEl.appendChild(statusSelect);
+		const qLabel = el("label", null);
+		qLabel.appendChild(document.createTextNode("搜索"));
+		const qInput = document.createElement("input");
+		qInput.type = "search";
+		qInput.placeholder = "Task / Feature / run…";
+		qInput.setAttribute("aria-label", "搜索 Task");
+		qInput.value = routeFilters.q ?? "";
+		qLabel.appendChild(qInput);
+		statusSelect.addEventListener("change", () => {
+			const next = buildHashPath("/pool", {
+				status: statusSelect.value || undefined,
+				q: qInput.value.trim() || undefined,
+			});
+			navigate(next);
+		});
+		qInput.addEventListener("change", () => {
+			const next = buildHashPath("/pool", {
+				status: statusSelect.value || undefined,
+				q: qInput.value.trim() || undefined,
+			});
+			navigate(next);
+		});
+		filtersEl.appendChild(statusLabelEl);
+		filtersEl.appendChild(qLabel);
+		filtersEl.appendChild(
+			el("span", "muted layer-raw", `显示 ${tasks.length}/${allTasks.length}`),
+		);
+	}
+
+	clearNode(kpiEl);
+	clearNode(listEl);
+	emptyEl.hidden = true;
+	clearNode(emptyEl);
+
+	if (projectionFailed) {
+		// Fault-first: do not render healthy-looking zero KPIs when projection is broken.
+		kpiEl.appendChild(
+			el(
+				"p",
+				"empty",
+				"投影失败，状态分布与健康 KPI 不可用（避免将未知显示为健康 0）。",
+			),
+		);
+		if (eventsEl) {
+			await mountBoundedEventTimeline(
+				eventsEl,
+				"/api/events",
+				"最近事件",
+			);
+		}
+		return;
+	}
+
+	if (!poolPresent && tasks.length === 0) {
+		emptyEl.hidden = false;
+		mountViewState(
+			emptyEl,
+			"empty",
+			"当前仓库未使用 Task Pool（未发现 .harness/task-pool）。",
+		);
+		if (eventsEl) {
+			await mountBoundedEventTimeline(
+				eventsEl,
+				"/api/events",
+				"最近事件",
+			);
+		}
+		return;
+	}
+
+	if (poolPresent && tasks.length === 0) {
+		emptyEl.hidden = false;
+		mountViewState(emptyEl, "empty", "Task Pool 已存在，但当前没有 Task。");
+	}
+
+	const counts = poolStatusCounts(tasks);
+	const cards = el("div", "kpi-grid");
+	for (const [label, value] of [
+		["运行中", counts.running],
+		["等待/排队", counts.pending],
+		["阻塞/失联", counts.blocked],
+		["失败", counts.failed],
+		["成功/复用", counts.succeeded],
+		["其他", counts.other],
+		["合计", tasks.length],
+	]) {
+		const card = el("div", "kpi-card");
+		card.appendChild(el("div", "kpi-value", String(value)));
+		card.appendChild(el("div", "kpi-label", label));
+		cards.appendChild(card);
+	}
+	kpiEl.appendChild(el("h3", "section-heading", "状态分布"));
+	kpiEl.appendChild(cards);
+
+	if (tasks.length > 0) {
+		const rows = tasks.map((task) => {
+			const taskLink = document.createElement("a");
+			taskLink.href = `#/task/${encodeURIComponent(task.taskId)}`;
+			taskLink.textContent = task.taskId;
+			taskLink.addEventListener("click", (e) => {
+				e.preventDefault();
+				navigate(`#/task/${encodeURIComponent(task.taskId)}`);
+			});
+
+			let runCell = "—";
+			if (task.workerRunId) {
+				const a = document.createElement("a");
+				a.href = `#/run/${encodeURIComponent(task.workerRunId)}`;
+				a.textContent = task.workerRunId;
+				a.addEventListener("click", (e) => {
+					e.preventDefault();
+					navigate(`#/run/${encodeURIComponent(task.workerRunId)}`);
+				});
+				runCell = a;
+			}
+
+			return {
+				cells: [
+					taskLink,
+					task.featureId ?? "—",
+					badge(task.status),
+					runCell,
+					formatAgo(task.updatedAt || task.finishedAt || task.startedAt),
+					task.failureCategory ?? "—",
+				],
+			};
+		});
+		listEl.appendChild(
+			buildTable(
+				["Task", "Feature", "状态", "最新 worker run", "更新时间", "失败分类"],
+				rows,
+			),
+		);
+	}
+
+	if (eventsEl) {
+		await mountBoundedEventTimeline(
+			eventsEl,
+			"/api/events",
+			"最近事件",
+		);
+	}
+}
+
+export function startPoolPolling() {
+	if (uiState.poolTimer) clearTimeout(uiState.poolTimer);
+	const generation = ++uiState.pollingGeneration;
+	const poll = async () => {
+		await renderPool();
+		if (generation !== uiState.pollingGeneration) return;
+		uiState.poolTimer = setTimeout(() => {
+			uiState.poolTimer = null;
+			void poll();
+		}, dashboardPollDelay());
+	};
+	void poll();
+}