@tea-agent/loop-agent 0.37.0 → 0.37.1-beta.0

package/dist/worker/loop-agent/loop-agent-client.js

@@ -2,15 +2,11 @@ import { spawn } from "node:child_process";
 import { appendFileSync, realpathSync, statSync, writeFileSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { computeBinarySha256, computePackageFingerprint, findPackageRoot, isJavaScriptScript, normalizeCliVersionLabel, readPackageName, readPackageVersion, resolveBinPaths, resolveCmdShim, } from "../../shared/package-metadata.js";
+import { computeBinarySha256, computePackageFingerprint, findPackageRoot, isJavaScriptScript, readPackageName, readPackageVersion, resolveBinPaths, resolveCmdShim, } from "../../shared/package-metadata.js";
 import { parseCommandJson } from "./parse-json.js";
 export const DEFAULT_WORKER_COMMAND_TIMEOUT_MS = 120_000;
 export const DEFAULT_HEARTBEAT_INTERVAL_MS = 15_000;
 export const LOOP_AGENT_PACKAGE_NAME = "@tea-agent/loop-agent";
-/** Grace window between the SIGTERM and SIGKILL stages of a hard timeout, so a
- * runner can persist terminal state (see executeDagCheckpoint) before being
- * force-killed. */
-export const HARD_TIMEOUT_KILL_GRACE_MS = 10_000;
 const MAX_BUFFERED_OUTPUT_BYTES = 64 * 1024;
 /**
  * Bind evidence supplied by an orchestration layer to the identity exposed by
@@ -182,11 +178,10 @@ export class LoopAgentClient {
         if (!this._identity) {
             throw new Error("controller identity: cannot record a reported version without a pinned identity");
         }
-        const normalized = normalizeCliVersionLabel(reportedVersion);
-        if (normalized !== this._identity.packageVersion) {
+        if (reportedVersion !== this._identity.packageVersion) {
             throw new Error(`controller identity: reported version ${reportedVersion} does not match package version ${this._identity.packageVersion}`);
         }
-        this._identity = { ...this._identity, reportedVersion: normalized };
+        this._identity = { ...this._identity, reportedVersion };
         return this._identity;
     }
     async run(args, options) {
@@ -386,17 +381,10 @@ function spawnCommand(input) {
             });
         };
         let hardTimeout;
-        let killGraceTimeout;
         if (input.hardTimeoutMs !== undefined && input.hardTimeoutMs > 0) {
             hardTimeout = setTimeout(() => {
                 timedOut = true;
-                // Two-stage termination: SIGTERM first so the runner can persist a
-                // terminal state (see executeDagCheckpoint signal handler), then
-                // SIGKILL only after the grace window expires.
                 child.kill("SIGTERM");
-                killGraceTimeout = setTimeout(() => {
-                    child.kill("SIGKILL");
-                }, HARD_TIMEOUT_KILL_GRACE_MS);
             }, input.hardTimeoutMs);
         }
         let heartbeatTimer;
@@ -406,8 +394,6 @@ function spawnCommand(input) {
         const clearTimers = () => {
             if (hardTimeout !== undefined)
                 clearTimeout(hardTimeout);
-            if (killGraceTimeout !== undefined)
-                clearTimeout(killGraceTimeout);
             if (heartbeatTimer !== undefined) {
                 clearInterval(heartbeatTimer);
                 heartbeatTimer = undefined;

package/dist/worker/observability/read-model.js

@@ -1491,7 +1491,6 @@ function mergeDagRun(existing, incoming) {
         failureCategory: incoming.failureCategory ?? existing.failureCategory,
         stateConsistent: incoming.stateConsistent ?? existing.stateConsistent,
         recoveryEligibility: incoming.recoveryEligibility ?? existing.recoveryEligibility,
-        frontendRecovery: incoming.frontendRecovery ?? existing.frontendRecovery,
         title: incoming.title ?? existing.title,
         startedAt,
         finishedAt,
@@ -1791,23 +1790,6 @@ async function loadFrontendLintProjection(runDir) {
         blockingReasons: parsed.data.blockingReasons,
     };
 }
-function projectFrontendRecovery(state) {
-    const s = state.frontendRecoveryState;
-    const r = state.frontendRecoveryResult;
-    if (!s && !r)
-        return undefined;
-    return {
-        ...(s?.recoveryRootRunId ? { recoveryRootRunId: s.recoveryRootRunId } : {}),
-        ...(s?.parentRunId ? { parentRunId: s.parentRunId } : {}),
-        ...(s?.childRunId ? { childRunId: s.childRunId } : {}),
-        ...(s?.attemptIndex !== undefined ? { attemptIndex: s.attemptIndex } : {}),
-        ...(s?.continuationCount !== undefined
-            ? { continuationCount: s.continuationCount }
-            : {}),
-        ...(s?.phase ? { phase: s.phase } : {}),
-        ...(r?.outcome ? { outcome: r.outcome } : {}),
-    };
-}
 async function parseDagStateFile(statePath, now) {
     try {
         if (!existsSync(statePath))
@@ -1878,7 +1860,6 @@ async function parseDagStateFile(statePath, now) {
             loadBackendTestProjection(runDir, nodes),
             loadFrontendLintProjection(runDir),
         ]);
-        const frontendRecovery = projectFrontendRecovery(state);
         const continuationRecord = state.continuation &&
             typeof state.continuation.parentRunId === "string" &&
             typeof state.continuation.effectiveFromNodeId === "string" &&
@@ -1937,7 +1918,6 @@ async function parseDagStateFile(statePath, now) {
             ...(continuation ? { continuation } : {}),
             ...(backendTest ? { backendTest } : {}),
             ...(frontendLint ? { frontendLint } : {}),
-            ...(frontendRecovery ? { frontendRecovery } : {}),
         };
     }
     catch {

package/dist/worker/observe/spec-evidence.js

@@ -359,11 +359,16 @@ export async function extractSpecEvidence(repoRoot, dagRunId, nodeId) {
     if (status === "no-evidence") {
         summaryLines.push("未观察到任何规范证据：无 skill 注入、无文件读取、无检索操作。");
     }
-    // Openspec directory reads/searches remain in the payload for API consumers
-    // (tests and downstream projections); the inspector no longer displays them
-    // separately from the generic spec reads/searches.
+    // Separate openspec spec directory reads and searches for Dashboard display.
+    // Knowledge base and openspec are parallel sources.
     const openspecReads = specReads.filter((r) => isOpenspecPath(r.path));
     const openspecSearches = searches.filter((s) => isOpenspecSearch(s.query, s.path));
+    if (openspecReads.length > 0) {
+        summaryLines.push(`openspec 已读取 ${openspecReads.length} 个文件：${openspecReads.map((r) => r.path).join("、")}`);
+    }
+    if (openspecSearches.length > 0) {
+        summaryLines.push(`openspec 检索 ${openspecSearches.length} 次。`);
+    }
     return {
         dagRunId,
         nodeId,

package/dist/worker/observe/static/operator-chrome.d.ts

@@ -49,7 +49,6 @@ export function parseInspectObjectView(
 export function activeInspectTabHref(hashValue: string): string | null;
 export function parseInspectContext(hashValue: string): InspectContext | null;
 export function resolveOperateHrefFromInspectHash(hashValue: string): string;
-export function buildOperateInterruptHref(dagRunId: string): string;
 export function buildInspectDagHref(
 	dagRunId: string,
 	options?: { from?: string },

package/dist/worker/observe/static/operator-chrome.js

@@ -1,7 +1,7 @@
 /**
  * Operator Chrome — 统一壳（Operate React 与 Inspect vanilla 共用唯一实现）。
  *
- * 设计真源：docs/design/archive/2026-08-09-unified-operator-chrome.md
+ * 设计真源：docs/design/active/2026-08-09-unified-operator-chrome.md
  * - 一条 chrome 两条带：Band1 全局（品牌/仓库身份/模式分段控件/对象上下文/状态格），
  *   Band2 工作区（下划线 tab，随模式切换内容）。
  * - 模式语义：操作=做，观测=看同一对象；模式切换在持有 DAG 选中时不丢对象。
@@ -115,13 +115,7 @@ export function resolveOperateHrefFromInspectHash(hashValue) {
 	if (objectView?.view === "dag") {
 		return `/#/recovery?dagRunId=${encodeURIComponent(objectView.id)}`;
 	}
-	// 2026-08-16: 无持有对象时默认落到对话页（与 Console 默认 landing 一致）。
-	return "/#/chat";
-}
-
-/** Inspect DAG 详情 → Operate Recovery 协作中止深链（只改导航，不发 mutation）。 */
-export function buildOperateInterruptHref(dagRunId) {
-	return `/#/recovery?dagRunId=${encodeURIComponent(dagRunId)}&intent=interrupt`;
+	return "/#/";
 }
 
 /** 操作侧 → Inspect 的 canonical 深链（可携带 from 以激活上下文 chip）。 */
@@ -191,8 +185,7 @@ export function buildOperatorChromeModel(config) {
 			{
 				id: "operate",
 				label: "操作",
-				// 2026-08-16: 默认落到对话页，与 Console 默认 landing（chat）一致。
-				href: config.operateHref ?? "/#/chat",
+				href: config.operateHref ?? "/#/",
 				active: mode === "operate",
 			},
 			{

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

@@ -360,9 +360,15 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 		evidence.sourceBinding?.requirementIds,
 		(id) => el("li", null, id),
 	);
+	const openspecReadPaths = new Set(
+		(evidence.openspecReads ?? []).map((entry) => entry.path),
+	);
+	const otherSpecReads = (evidence.specReads ?? []).filter(
+		(entry) => !openspecReadPaths.has(entry.path),
+	);
 	appendListSection(
-		`规范已读取（${evidence.specReads?.length ?? 0}）`,
-		evidence.specReads,
+		`其他已读取规范文件（${otherSpecReads.length}）`,
+		otherSpecReads,
 		(read) => {
 			const item = el("li", null);
 			const button = document.createElement("button");
@@ -374,7 +380,7 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 				button.setAttribute("data-read-at", read.timestamp);
 			}
 			button.id = `spec-evidence-btn-read-${read.path}`;
-			const icon = el("i", "ri-book-open-line");
+			const icon = el("i", "ri-file-text-line");
 			icon.setAttribute("aria-hidden", "true");
 			button.append(icon, el("code", null, read.path));
 			if (read.timestamp) {
@@ -399,10 +405,9 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 			item.appendChild(button);
 			return item;
 		},
-		"unavailable：未观察到规范读取。",
 	);
 	appendListSection(
-		`规范检索（${evidence.specSearches?.length ?? 0}）`,
+		`检索操作（${evidence.specSearches?.length ?? 0}）`,
 		evidence.specSearches,
 		(search) => {
 			const item = el("li", null);
@@ -414,7 +419,6 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 			);
 			return item;
 		},
-		"unavailable：未观察到规范检索。",
 	);
 	appendListSection(
 		`知识库查询（${evidence.knowledgeBaseQueries?.length ?? 0}）`,
@@ -429,6 +433,67 @@ async function renderSpecEvidence(content, dagRunId, nodeId, cachedEvidence) {
 		"unavailable：未观察到知识库查询；connector 可能未配置或未调用。",
 	);
 
+	// openspec reads are displayed independently from skill/docs reads.
+	appendListSection(
+		`openspec 已读取（${evidence.openspecReads?.length ?? 0}）`,
+		evidence.openspecReads,
+		(read) => {
+			const item = el("li", null);
+			const button = document.createElement("button");
+			button.type = "button";
+			button.className = "spec-evidence-file-btn";
+			button.setAttribute("data-source", "read");
+			button.setAttribute("data-path", read.path);
+			if (read.timestamp) {
+				button.setAttribute("data-read-at", read.timestamp);
+			}
+			button.id = `spec-evidence-btn-read-${read.path}`;
+			const icon = el("i", "ri-book-open-line");
+			icon.setAttribute("aria-hidden", "true");
+			button.append(icon, el("code", null, read.path));
+			if (read.timestamp) {
+				button.appendChild(
+					el(
+						"span",
+						"spec-evidence-time",
+						formatSessionEventTime({ timestamp: read.timestamp }),
+					),
+				);
+			}
+			button.addEventListener("click", () =>
+				onSpecEvidenceFileClick(
+					content,
+					dagRunId,
+					nodeId,
+					"read",
+					read.path,
+					button,
+				),
+			);
+			item.appendChild(button);
+			return item;
+		},
+		evidence.openspecSearches?.length
+			? "已检索但未观察到 openspec 成功读取；若生成期存在候选，预写门禁会阻断 writer。"
+			: "unavailable：未观察到 openspec 成功读取。",
+	);
+
+	appendListSection(
+		`openspec 检索（${evidence.openspecSearches?.length ?? 0}）`,
+		evidence.openspecSearches,
+		(search) => {
+			const item = el("li", null);
+			const icon = el("i", "ri-search-line");
+			icon.setAttribute("aria-hidden", "true");
+			item.append(
+				icon,
+				document.createTextNode(` ${search.tool}: ${search.query}`),
+			);
+			return item;
+		},
+		"unavailable：未观察到 openspec 检索。",
+	);
+
 	if (
 		evidence.status === "source-bound" ||
 		evidence.status === "spec-injected" ||

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

@@ -355,18 +355,6 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		primaryEntries.push(["状态一致性", "不一致，需要处理"]);
 	if (visibility.showResume) primaryEntries.push(["允许恢复", "是"]);
 	if (visibility.showReconcile) primaryEntries.push(["允许收口", "是"]);
-	const liveStatus = String(dag.effectiveStatus ?? dag.status ?? "").toLowerCase();
-	if (liveStatus === "running" || liveStatus === "active") {
-		const interruptLink = el(
-			"a",
-			"page-action-btn",
-			"在操作台中止此运行 →",
-		);
-		interruptLink.href = `/#/recovery?dagRunId=${encodeURIComponent(dag.dagRunId)}&intent=interrupt`;
-		interruptLink.setAttribute("data-testid", "inspect-dag-interrupt-link");
-		interruptLink.title = "只跳转到操作台 Recovery，不会在观测页执行中止";
-		primaryEntries.push(["协作中止", interruptLink]);
-	}
 	primaryEntries.push(
 		["开始时间", formatTs(dag.startedAt)],
 		["结束时间", formatTs(dag.finishedAt)],

package/dist/worker/preflight.js

@@ -1,6 +1,5 @@
 import { access } from "node:fs/promises";
 import path from "node:path";
-import { normalizeCliVersionLabel } from "../shared/package-metadata.js";
 import { controllerIdentityExpectationFailure, resolveControllerIdentity, } from "./loop-agent/loop-agent-client.js";
 export const DEFAULT_CHECK_REPO_TIMEOUT_MS = 300_000;
 export async function preflightTargetRepo(input) {
@@ -48,7 +47,7 @@ export async function preflightTargetRepo(input) {
             controllerIdentity: identity,
         };
     }
-    const reportedVersion = normalizeCliVersionLabel(version.stdout);
+    const reportedVersion = version.stdout.trim();
     let controllerIdentity = identity
         ? { ...identity, reportedVersion }
         : undefined;