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

package/dist/worker/observe/static/views/dag.d.ts

@@ -0,0 +1,13 @@
+export interface DagNodeRemark {
+	failed: boolean;
+	text: string;
+	isErrorSummary: boolean;
+}
+
+export function resolveNodeRemark(node: {
+	status?: string | null;
+	errorPreview?: string | null;
+	label?: string | null;
+	nodeId: string;
+	rank?: string | number | null;
+} | null | undefined): DagNodeRemark;

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

@@ -70,6 +70,7 @@ import {
 	dashboardVisibleFeatures,
 	findDagForRun,
 } from "../dag-model.js";
+import { describeDagNodePurpose } from "../dag-node-purpose.js";
 import { layoutDag } from "../dag-layout.js";
 import {
 	showView,
@@ -90,6 +91,7 @@ import {
 	closeDagInspector,
 	selectDagNode,
 	renderDagInspector,
+	mergeNodeProcess,
 } from "./dag-inspector.js";
 import { mergeSessionEvents } from "./session-timeline.js";
 
@@ -135,7 +137,7 @@ export function extractFirstErrorSummary(errorPreview) {
 	return effective ?? "";
 }
 
-/** Resolve 备注 cell content for a DAG node (failed → summary; else label). */
+/** Resolve 备注 cell content for a DAG node (failed → summary; else purpose). */
 export function resolveNodeRemark(node) {
 	const failed = isNodeFailed(node?.status);
 	if (failed) {
@@ -146,10 +148,10 @@ export function resolveNodeRemark(node) {
 			isErrorSummary: Boolean(summary),
 		};
 	}
-	const label = typeof node?.label === "string" ? node.label.trim() : "";
+	const purpose = describeDagNodePurpose(node?.nodeId, node);
 	return {
 		failed: false,
-		text: label || "—",
+		text: purpose || "—",
 		isErrorSummary: false,
 	};
 }
@@ -362,7 +364,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 			"page-action-btn",
 			"在操作台中止此运行 →",
 		);
-		interruptLink.href = `/#/recovery?dagRunId=${encodeURIComponent(dag.dagRunId)}&intent=interrupt`;
+		interruptLink.href = `/#/operate/recovery?dagRunId=${encodeURIComponent(dag.dagRunId)}&intent=interrupt`;
 		interruptLink.setAttribute("data-testid", "inspect-dag-interrupt-link");
 		interruptLink.title = "只跳转到操作台 Recovery，不会在观测页执行中止";
 		primaryEntries.push(["协作中止", interruptLink]);
@@ -451,13 +453,19 @@ export async function renderDagDetail(dagRunId, initial = true) {
 	nodesEl.scrollLeft = nodesScrollLeft;
 
 	if (uiState.dagInspectorOpen && uiState.selectedDagNodeId) {
+		const selectedNode = nodes.find(
+			(node) => node.nodeId === uiState.selectedDagNodeId,
+		);
 		if (!uiState.sessionEventIdentity) {
 			uiState.sessionEventIdentity = makeSessionEventIdentity(
 				dagRunId,
 				uiState.selectedDagNodeId,
 			);
 		}
-		await mergeSessionEvents(dagRunId, uiState.selectedDagNodeId);
+		await Promise.all([
+			mergeSessionEvents(dagRunId, uiState.selectedDagNodeId),
+			selectedNode ? mergeNodeProcess(dagRunId, selectedNode) : Promise.resolve(),
+		]);
 	}
 	renderDagInspector(
 		dagRunId,
@@ -474,6 +482,7 @@ export function startDagPolling(dagRunId, initial = true) {
 		const active = await renderDagDetail(dagRunId, isInitial);
 		if (generation !== uiState.pollingGeneration || !active) return;
 		const delay = detailPollDelay("running", isPageVisible());
+		if (delay == null) return;
 		uiState.dagPollTimer = setTimeout(() => {
 			uiState.dagPollTimer = null;
 			void poll(false);

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

@@ -84,7 +84,7 @@ let dashboardLoadingNode = null;
 
 /**
  * 「昨夜班次」条带：夜间结果在观测侧的唯一一级呈现（替代旧「夜间任务」tab）。
- * 管理动作（晨审处置）始终落在操作侧 /#/night，保持 Inspect 只读不变式。
+ * 管理动作（晨审处置）始终落在操作侧 /#/operate/night，保持 Inspect 只读不变式。
  */
 async function renderNightStrip() {
 	const strip = document.getElementById("dashboard-night");
@@ -118,14 +118,14 @@ async function renderNightStrip() {
 
 	const actions = el("div", "night-strip-actions");
 	const detail = el("a", "page-action-btn", "夜间详情");
-	detail.href = "#/night";
+	detail.href = "/#/inspect/night";
 	detail.addEventListener("click", (e) => {
 		e.preventDefault();
 		navigate("/night");
 	});
 	actions.appendChild(detail);
 	const manage = el("a", "page-action-btn night-strip-manage", "晨审处置 →");
-	manage.href = "/#/night";
+	manage.href = "/#/operate/night";
 	manage.title = "夜间计划的管理与晨审处置在操作台完成（Inspect 保持只读）";
 	actions.appendChild(manage);
 	strip.appendChild(actions);
@@ -738,10 +738,12 @@ export function startDashboardPolling(scrollTo) {
 	const poll = async (initialScrollTo) => {
 		await renderDashboard(initialScrollTo);
 		if (generation !== uiState.pollingGeneration) return;
+		const delay = dashboardPollDelay();
+		if (delay == null) return;
 		uiState.dashboardTimer = setTimeout(() => {
 			uiState.dashboardTimer = null;
 			void poll();
-		}, dashboardPollDelay());
+		}, delay);
 	};
 	void poll(scrollTo);
 }

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

@@ -101,11 +101,14 @@ export async function renderFailures() {
 
 	if (tasks.length === 0) {
 		clearNode(listEl);
+		// 2026-08-22 (B-FIND-02): 空态文案与静态 #failures-empty / 页面标题
+		// 「异常 Task」保持一致；旧文案「当前没有失败或阻塞的 Task。」与静态
+		// HTML 及回归目录 AC-FE-INS-004 漂移，导致 frontend-test 字面 find 0 命中。
 		if (emptyEl) {
 			emptyEl.hidden = false;
-			mountViewState(emptyEl, "empty", "当前没有失败或阻塞的 Task。");
+			mountViewState(emptyEl, "empty", "当前没有异常 Task");
 		} else {
-			mountViewState(listEl, "empty", "当前没有失败或阻塞的 Task。");
+			mountViewState(listEl, "empty", "当前没有异常 Task");
 		}
 		return;
 	}

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

@@ -46,8 +46,8 @@ export async function renderNightJobs(scheduleId) {
 	showView("night");
 	bindNightToolbar();
 	const crumbs = [
-		{ label: UI_TEXT.dashboard, href: "#/" },
-		{ label: UI_TEXT.nightJobs, href: "#/night" },
+		{ label: UI_TEXT.dashboard, href: "/#/inspect" },
+		{ label: UI_TEXT.nightJobs, href: "/#/inspect/night" },
 	];
 	if (scheduleId) crumbs.push({ label: scheduleId });
 	setBreadcrumb(crumbs);

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

@@ -93,6 +93,7 @@ function startPoolAutoPolling() {
 		if (generation !== uiState.pollingGeneration) return;
 		if (!poolAutoRefreshEnabled()) return;
 		const delay = isPageVisible() ? POOL_POLL_MS : dashboardPollDelay();
+		if (delay == null) return;
 		uiState.poolTimer = setTimeout(() => {
 			uiState.poolTimer = null;
 			void poll();

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

@@ -50,6 +50,7 @@ import {
 } from "../relations.js";
 import { copyText, renderRecommendedCommand } from "../copy.js";
 import {
+	fetchWithWorkspaceScope,
 	isPageVisible,
 	detailPollDelay,
 	dashboardPollDelay,
@@ -126,7 +127,7 @@ export function renderInlineArtifactList(container, artifacts) {
 		list.appendChild(li);
 		void (async () => {
 			try {
-				const res = await fetch(artifactUrl(artifactPath));
+				const res = await fetchWithWorkspaceScope(artifactUrl(artifactPath));
 				const text = await res.text();
 				if (!res.ok) {
 					let message = text;
@@ -444,6 +445,7 @@ export function startRunPolling(workerRunId, initial = true) {
 		const active = await renderRun(workerRunId, isInitial);
 		if (generation !== uiState.pollingGeneration || !active) return;
 		const delay = detailPollDelay("running", isPageVisible());
+		if (delay == null) return;
 		uiState.runPollTimer = setTimeout(() => {
 			uiState.runPollTimer = null;
 			void poll(false);

package/dist/worker/observe/static/views/session-timeline.js

@@ -250,6 +250,54 @@ export function buildSessionTimelineItems(events) {
 	return items;
 }
 
+/**
+ * Split a node's shared session-events log into per-attempt segments. Every
+ * attempt appends one agent run beginning with agent_start; events recorded
+ * before the first agent_start (defensive) stay in an implicit first segment.
+ */
+export function splitSessionEventsByAttempt(events) {
+	const segments = [];
+	let current = null;
+	for (const event of events) {
+		if (typeof event?.type === "string" && event.type === "agent_start") {
+			current = [];
+			segments.push(current);
+		}
+		if (current === null) {
+			current = [];
+			segments.push(current);
+		}
+		current.push(event);
+	}
+	return segments;
+}
+
+/**
+ * Resolve the events visible in the「执行过程」tab for the selected execution
+ * key. attempt-N shows only that attempt's segment when the shared log carries
+ * multiple attempts; other keys (pass-N, null) keep the full stream.
+ */
+export function resolveTimelineVisibleEvents(events, executionKey) {
+	const match =
+		typeof executionKey === "string"
+			? /^attempt-(\d+)$/.exec(executionKey)
+			: null;
+	if (!match) return { events, note: null };
+	const segments = splitSessionEventsByAttempt(events);
+	if (segments.length <= 1) return { events, note: null };
+	const requested = Number(match[1]);
+	if (requested >= 1 && requested <= segments.length) {
+		return {
+			events: segments[requested - 1],
+			note: `已按第 ${requested} 次执行过滤 · 共 ${segments.length} 次执行`,
+		};
+	}
+	return {
+		events,
+		note: `未检测到第 ${requested} 次执行的边界（共 ${segments.length} 次执行），暂显示全部事件`,
+	};
+}
+
 /**
  * Build rich timeline items: merge tool start/end by toolCallId, collapse
  * protocol noise, surface turn thinking/text without dumping agent_end.messages.
@@ -439,12 +487,25 @@ function ensureOpenDetailsSet() {
 	return uiState.sessionTimelineOpenDetails;
 }
 
-function bindDetailsToggle(details, detailKey) {
+function closedDetailKey(detailKey) {
+	return `${detailKey}::user-closed`;
+}
+
+function bindDetailsToggle(details, detailKey, defaultOpen = false) {
 	const openSet = ensureOpenDetailsSet();
-	if (openSet.has(detailKey)) details.open = true;
+	if (defaultOpen) {
+		if (!openSet.has(closedDetailKey(detailKey))) details.open = true;
+	} else if (openSet.has(detailKey)) {
+		details.open = true;
+	}
 	details.addEventListener("toggle", () => {
-		if (details.open) openSet.add(detailKey);
-		else openSet.delete(detailKey);
+		if (details.open) {
+			openSet.add(detailKey);
+			openSet.delete(closedDetailKey(detailKey));
+		} else {
+			openSet.delete(detailKey);
+			openSet.add(closedDetailKey(detailKey));
+		}
 	});
 }
 
@@ -599,7 +660,7 @@ function renderProtocolCard(item) {
 	const details = document.createElement("details");
 	details.className = "process-timeline-details";
 	details.dataset.detailKey = item.detailKey;
-	bindDetailsToggle(details, item.detailKey);
+	bindDetailsToggle(details, item.detailKey, true);
 	const summary = document.createElement("summary");
 	summary.className = "process-timeline-summary";
 	summary.textContent = `消息收发 · ${item.protocolCount} 条协议事件`;
@@ -644,7 +705,7 @@ export async function mergeSessionEvents(dagRunId, nodeId) {
 	}
 }
 
-export function renderSessionTimeline(content, nodeId) {
+export function renderSessionTimeline(content, nodeId, options = {}) {
 	content.dataset.dagRunId = uiState.currentDagRunId ?? "";
 	content.dataset.nodeId = nodeId ?? "";
 	content.classList.add("process-timeline-scroll");
@@ -653,6 +714,14 @@ export function renderSessionTimeline(content, nodeId) {
 		return;
 	}
 
+	const visible = resolveTimelineVisibleEvents(
+		uiState.sessionEvents,
+		options.executionKey,
+	);
+	if (visible.note) {
+		content.appendChild(el("p", "process-timeline-note", visible.note));
+	}
+
 	const showProtocol = Boolean(uiState.sessionTimelineShowProtocol);
 	const toolbar = el("div", "process-timeline-toolbar");
 	const protocolToggle = document.createElement("button");
@@ -668,17 +737,17 @@ export function renderSessionTimeline(content, nodeId) {
 		const scrollTop = parent.scrollTop;
 		const scrollLeft = parent.scrollLeft;
 		while (parent.firstChild) parent.removeChild(parent.firstChild);
-		renderSessionTimeline(parent, nodeId);
+		renderSessionTimeline(parent, nodeId, options);
 		parent.scrollTop = scrollTop;
 		parent.scrollLeft = scrollLeft;
 	});
 	toolbar.appendChild(protocolToggle);
 	content.appendChild(toolbar);
 
-	const timelineItems = buildRichTimelineItems(uiState.sessionEvents, {
+	const timelineItems = buildRichTimelineItems(visible.events, {
 		showProtocol,
 	});
-	const hasEventTimes = uiState.sessionEvents.some((event) =>
+	const hasEventTimes = visible.events.some((event) =>
 		Boolean(sessionEventTimestamp(event)),
 	);
 	if (!hasEventTimes) {

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

@@ -34,6 +34,7 @@ import {
 	repoBaseName,
 	parseMarkdownBlocks,
 	markdownLinkHref,
+	formatLedgerSummary,
 } from "../format.js";
 import { parseRoute, navigate, buildHashPath } from "../router.js";
 import {
@@ -85,7 +86,7 @@ export async function renderTaskDetail(featureId, taskId) {
 	showView("task");
 	setBreadcrumb([
 		{ label: UI_TEXT.dashboard, href: "#/" },
-		{ label: "资源池", href: "#/pool" },
+		{ label: "资源池", href: "/#/inspect/pool" },
 		{ label: displayLabel },
 	]);
 
@@ -94,6 +95,7 @@ export async function renderTaskDetail(featureId, taskId) {
 	const linksEl = document.getElementById("task-links");
 	const evidenceEl = document.getElementById("task-evidence");
 	const runsEl = document.getElementById("task-runs");
+	const ledgerEl = document.getElementById("task-ledger");
 	if (!metaEl || !linksEl || !evidenceEl || !runsEl) return false;
 	if (titleEl) titleEl.textContent = displayLabel;
 	mountViewState(metaEl, "loading", "加载 Task…");
@@ -252,9 +254,62 @@ export async function renderTaskDetail(featureId, taskId) {
 	const active = ["running", "pending", "blocked", "stale"].includes(
 		(task.status ?? "").toLowerCase(),
 	);
+	if (ledgerEl) {
+		void renderTaskLedger(ledgerEl, taskId);
+	}
 	return active;
 }
 
+/**
+ * Task 详情页 ledger 安全摘要（AC-009）：从只读 GET /api/tasks/:id/ledger 拉取，
+ * 计数/状态/failure code + 有界排除理由；无 ledger 显示空态，失败安全降级。
+ */
+async function renderTaskLedger(ledgerEl, taskId) {
+	clearNode(ledgerEl);
+	ledgerEl.appendChild(el("h3", "section-heading", "Source fidelity ledger"));
+	mountViewState(ledgerEl, "loading", "加载 ledger…");
+	let body = null;
+	try {
+		body = await fetchJson(`/api/tasks/${encodeURIComponent(taskId)}/ledger`);
+	} catch {
+		body = null;
+	}
+	if (!body) {
+		mountViewState(ledgerEl, "error", "ledger 只读接口失败（安全降级）。");
+		return;
+	}
+	if (body.present !== true) {
+		mountViewState(
+			ledgerEl,
+			body.error ? "error" : "empty",
+			body.error
+				? `ledger 不可用（${body.error}）。`
+				: "无 source fidelity ledger（任务无引用或 ledger 缺失，不伪造计数）。",
+		);
+		return;
+	}
+	const pre = el(
+		"pre",
+		"cmd",
+		formatLedgerSummary({
+			present: true,
+			fragmentCount: body.fragmentCount,
+			canonicalRequirementCount: body.canonicalRequirementCount,
+			contextOnlyCount: body.contextOnlyCount,
+			duplicateCount: body.duplicateCount,
+			unresolvedCount: body.unresolvedCount,
+			conflictCount: body.conflictCount,
+			gateStatus: body.gateStatus,
+			failureCode: body.failureCode,
+			exclusions: body.exclusions ?? [],
+		}),
+	);
+	pre.dataset.testid = "task-ledger-summary";
+	clearNode(ledgerEl);
+	ledgerEl.appendChild(el("h3", "section-heading", "Source fidelity ledger"));
+	ledgerEl.appendChild(pre);
+}
+
 export async function loadOlderTaskRuns(featureId, taskId, before, runsEl) {
 	if (runsEl === undefined) {
 		runsEl = before;

package/dist/workflows/dag/backend-test-case-coverage-analysis.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import { z } from "zod";
 import YAML from "yaml";
 import { resolveBackendTestLayout, } from "./backend-test-layout.js";
+import { resolveBackendTestManifestModules, backendManifestStatusFinding } from "./backend-test-markdown-workflow.js";
 import { applyOpenApiPartitionDomainPolicy, assessScenarioPartitionCoverage, parseScenarioPartitions, } from "./backend-test-scenario-partitions.js";
 import { backendTestCaseManifestSchema, computeCaseManifestCoverageSummary, } from "./backend-test-case-manifest.js";
 const CASE_HEADING = /^##\s+(BE-[A-Z0-9_-]+-\d{3})\b.*$/gm;
@@ -659,10 +660,18 @@ async function markdownModuleFiles(workspaceRoot, layout) {
     const resolved = layout ?? resolveBackendTestLayout(undefined);
     const dir = path.join(workspaceRoot, ...resolved.markdownDir.split("/"));
     const entries = await readdir(dir, { withFileTypes: true });
-    return entries
+    const all = entries
         .filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".md") && entry.name.toLowerCase() !== "readme.md")
         .map((entry) => path.join(dir, entry.name))
         .sort();
+    // Current-round Markdown scope is the README Module Index manifest: unmanifested
+    // legacy .md files must not enter Case/coverage/partition statistics. Workspaces
+    // without a Module Index fall back to the whole directory (prior behaviour).
+    const manifest = await resolveBackendTestManifestModules(workspaceRoot, resolved);
+    if (manifest.manifestStatus !== "valid")
+        return [];
+    const declaredAbs = new Set(manifest.declaredMdFiles.map((rel) => path.join(workspaceRoot, ...rel.split("/")).toLowerCase()));
+    return all.filter((file) => declaredAbs.has(file.toLowerCase())).sort();
 }
 async function parseMarkdownCases(workspaceRoot, layout) {
     const result = [];
@@ -874,6 +883,16 @@ export async function analyzeBackendTestCaseCoverage(input) {
     findings.push(...coverageScope.findings);
     const matrix = parseCoverageMatrix(readme);
     findings.push(...matrix.findings);
+    const manifest = await resolveBackendTestManifestModules(input.workspaceRoot, layout);
+    // Fail closed on README Module Index entries declared but never materialized.
+    if (manifest.declaredMissing.length > 0) {
+        findings.push(`declared Markdown module is missing (Module Index): ${manifest.declaredMissing.join(", ")}`);
+    }
+    // Fail closed on every non-valid Module Index state: without a valid unique
+    // Module Index the current round must not re-scan historical `.md` files.
+    if (manifest.manifestStatus !== "valid") {
+        findings.push(backendManifestStatusFinding(manifest.manifestStatus, manifest.moduleIndexHeadingCount));
+    }
     const cases = await parseMarkdownCases(input.workspaceRoot, layout);
     for (const file of await markdownModuleFiles(input.workspaceRoot, layout)) {
         const markdown = await readFile(file, "utf8");
@@ -1109,6 +1128,15 @@ export async function analyzeBackendTestCaseCoverage(input) {
         "",
         facts.status,
         "",
+        `- Manifest scope: ${manifest.manifestStatus === "valid" ? "declared-modules" : `fails-closed:${manifest.manifestStatus}`} (declared-missing=${manifest.declaredMissing.length}, unmanifested-advisory=${manifest.unmanifested.length}, module-index-heading-count=${manifest.moduleIndexHeadingCount})`,
+        "",
+        "## Unmanifested Markdown Modules",
+        "",
+        "- Advisory: existing .md files not declared by the README Module Index are excluded from Case/coverage/partition statistics for this round.",
+        ...(manifest.unmanifested.length > 0
+            ? manifest.unmanifested.map((item) => `- ${item}`)
+            : ["- None"]),
+        "",
         "## Coverage Scope",
         "",
         `- Change Classification: ${facts.coverageScope.changeClassification}`,
@@ -1500,8 +1528,26 @@ print(json.dumps(out,ensure_ascii=True))
     // Windows Python may expose stdin as GBK; decoding generated Chinese/emoji
     // source through that locale can create surrogateescape code points and make
     // ast.parse fail with "surrogates not allowed".
-    const result = spawnSync("python", ["-c", program], { input: Buffer.from(source, "utf8"), encoding: "utf8", maxBuffer: 4 * 1024 * 1024, windowsHide: true });
-    if (result.status !== 0 || !result.stdout.trim())
+    // POSIX images usually expose only `python3` (modern macOS has no `python`);
+    // Windows often has a real `python` plus a Microsoft Store `python3` stub.
+    // A missing interpreter must not silently degrade to empty payload shapes.
+    const interpreterCandidates = process.platform === "win32" ? ["python", "python3"] : ["python3", "python"];
+    let result;
+    for (const interpreter of interpreterCandidates) {
+        const attempt = spawnSync(interpreter, ["-c", program], {
+            input: Buffer.from(source, "utf8"),
+            encoding: "utf8",
+            maxBuffer: 4 * 1024 * 1024,
+            windowsHide: true,
+        });
+        // Interpreter missing/unspawnable → try the next candidate. A spawned
+        // interpreter that exits nonzero analyzed real input; do not retry then.
+        if (attempt.error)
+            continue;
+        result = attempt;
+        break;
+    }
+    if (!result || result.status !== 0 || !result.stdout.trim())
         return new Map();
     try {
         const parsed = JSON.parse(result.stdout);