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

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

@@ -1,163 +1,163 @@
-/** 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";
-
-export async function mountBoundedEventTimeline(container, apiBase, title) {
-	clearNode(container);
-	container.appendChild(el("h3", "section-heading", title));
-	const note = el(
-		"p",
-		"process-timeline-note",
-		"有界历史（默认 50 / 最大 200）；分页使用 cursor，与 SSE 行号 offset 分离。",
-	);
-	container.appendChild(note);
-	const scroll = el("div", "process-timeline-scroll event-history-scroll");
-	const listHost = el("div", "event-history-list");
-	scroll.appendChild(listHost);
-	container.appendChild(scroll);
-	const footer = el("div", "event-history-footer");
-	container.appendChild(footer);
-
-	let nextCursor = null;
-	let loading = false;
-	const accumulated = [];
-
-	const renderList = () => {
-		clearNode(listHost);
-		if (accumulated.length === 0) {
-			mountViewState(listHost, "empty", "暂无事件");
-			return;
-		}
-		const ul = el("ul", "process-timeline");
-		for (let index = 0; index < accumulated.length; index += 1) {
-			const event = accumulated[index];
-			const li = el(
-				"li",
-				`process-timeline-item process-timeline-event has-time${index === 0 ? " is-first" : ""}${index === accumulated.length - 1 ? " is-last" : ""}`,
-			);
-			const rail = el("span", "process-timeline-rail");
-			rail.appendChild(el("span", "process-timeline-dot"));
-			li.appendChild(rail);
-			li.appendChild(
-				el("span", "process-timeline-time", formatTs(event.at) || "—"),
-			);
-			const label = `${event.type ?? "event"}${event.taskId ? ` · ${event.taskId}` : ""}${event.workerRunId ? ` · ${event.workerRunId}` : ""}`;
-			li.appendChild(el("span", "process-timeline-label", label));
-			ul.appendChild(li);
-		}
-		listHost.appendChild(ul);
-	};
-
-	const loadPage = async (cursor) => {
-		if (loading) return;
-		loading = true;
-		if (accumulated.length === 0) {
-			mountViewState(listHost, "loading", "加载事件…");
-		}
-		const qs = new URLSearchParams();
-		qs.set("limit", "50");
-		if (cursor) qs.set("cursor", cursor);
-		const page = await fetchJson(`${apiBase}?${qs.toString()}`);
-		loading = false;
-		if (!page) {
-			mountViewState(listHost, "error", "无法加载事件历史。");
-			return;
-		}
-		const events = page.events ?? [];
-		for (const event of events) accumulated.push(event);
-		nextCursor = page.nextCursor ?? null;
-		renderList();
-		clearNode(footer);
-		if (page.corruptLineCount > 0) {
-			footer.appendChild(
-				renderViewState(
-					"degraded",
-					`跳过损坏行 ${page.corruptLineCount} 条（failure-safe）。`,
-				),
-			);
-		}
-		if (nextCursor) {
-			const btn = el(
-				"button",
-				"btn-secondary event-history-more",
-				"加载更早事件",
-			);
-			btn.type = "button";
-			btn.addEventListener("click", () => {
-				void loadPage(nextCursor);
-			});
-			footer.appendChild(btn);
-		} else if (accumulated.length > 0) {
-			footer.appendChild(el("p", "muted", "已到历史边界"));
-		}
-	};
-
-	await loadPage(null);
-}
+/** 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";
+
+export async function mountBoundedEventTimeline(container, apiBase, title) {
+	clearNode(container);
+	container.appendChild(el("h3", "section-heading", title));
+	const note = el(
+		"p",
+		"process-timeline-note",
+		"有界历史（默认 50 / 最大 200）；分页使用 cursor，与 SSE 行号 offset 分离。",
+	);
+	container.appendChild(note);
+	const scroll = el("div", "process-timeline-scroll event-history-scroll");
+	const listHost = el("div", "event-history-list");
+	scroll.appendChild(listHost);
+	container.appendChild(scroll);
+	const footer = el("div", "event-history-footer");
+	container.appendChild(footer);
+
+	let nextCursor = null;
+	let loading = false;
+	const accumulated = [];
+
+	const renderList = () => {
+		clearNode(listHost);
+		if (accumulated.length === 0) {
+			mountViewState(listHost, "empty", "暂无事件");
+			return;
+		}
+		const ul = el("ul", "process-timeline");
+		for (let index = 0; index < accumulated.length; index += 1) {
+			const event = accumulated[index];
+			const li = el(
+				"li",
+				`process-timeline-item process-timeline-event has-time${index === 0 ? " is-first" : ""}${index === accumulated.length - 1 ? " is-last" : ""}`,
+			);
+			const rail = el("span", "process-timeline-rail");
+			rail.appendChild(el("span", "process-timeline-dot"));
+			li.appendChild(rail);
+			li.appendChild(
+				el("span", "process-timeline-time", formatTs(event.at) || "—"),
+			);
+			const label = `${event.type ?? "event"}${event.taskId ? ` · ${event.taskId}` : ""}${event.workerRunId ? ` · ${event.workerRunId}` : ""}`;
+			li.appendChild(el("span", "process-timeline-label", label));
+			ul.appendChild(li);
+		}
+		listHost.appendChild(ul);
+	};
+
+	const loadPage = async (cursor) => {
+		if (loading) return;
+		loading = true;
+		if (accumulated.length === 0) {
+			mountViewState(listHost, "loading", "加载事件…");
+		}
+		const qs = new URLSearchParams();
+		qs.set("limit", "50");
+		if (cursor) qs.set("cursor", cursor);
+		const page = await fetchJson(`${apiBase}?${qs.toString()}`);
+		loading = false;
+		if (!page) {
+			mountViewState(listHost, "error", "无法加载事件历史。");
+			return;
+		}
+		const events = page.events ?? [];
+		for (const event of events) accumulated.push(event);
+		nextCursor = page.nextCursor ?? null;
+		renderList();
+		clearNode(footer);
+		if (page.corruptLineCount > 0) {
+			footer.appendChild(
+				renderViewState(
+					"degraded",
+					`跳过损坏行 ${page.corruptLineCount} 条（failure-safe）。`,
+				),
+			);
+		}
+		if (nextCursor) {
+			const btn = el(
+				"button",
+				"btn-secondary event-history-more",
+				"加载更早事件",
+			);
+			btn.type = "button";
+			btn.addEventListener("click", () => {
+				void loadPage(nextCursor);
+			});
+			footer.appendChild(btn);
+		} else if (accumulated.length > 0) {
+			footer.appendChild(el("p", "muted", "已到历史边界"));
+		}
+	};
+
+	await loadPage(null);
+}

package/dist/workflows/dag/backend-test-analysis-contract.js

@@ -0,0 +1,120 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { writeDagRunJsonArtifact } from "../../infrastructure/harness/artifact-store.js";
+export const BACKEND_TEST_ANALYSIS_SCHEMA_ID = "backend-test-analysis-v1";
+const sourceRefSchema = z.string().min(1);
+const fieldSchema = z.object({
+    name: z.string().min(1),
+    type: z.string().min(1).optional(),
+    required: z.boolean().optional(),
+    description: z.string().optional(),
+}).strict();
+const errorCaseSchema = z.object({
+    status: z.number().int().min(400).max(599).optional(),
+    code: z.string().min(1).optional(),
+    messageField: z.string().min(1).optional(),
+    description: z.string().min(1),
+}).strict();
+export const backendTestAnalysisContractSchema = z.object({
+    schemaVersion: z.literal(1),
+    sourceBinding: z.object({
+        taskId: z.string().min(1),
+        requirementPath: z.string().min(1),
+        requirementSha256: z.string().regex(/^[a-f0-9]{64}$/),
+        referencePaths: z.array(z.string().min(1)),
+        requirementIds: z.array(z.string().regex(/^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$/)),
+    }).strict(),
+    acceptanceCriteria: z.array(z.object({
+        id: z.string().regex(/^AC-[A-Z0-9]+(?:-[A-Z0-9]+)*$/),
+        text: z.string().min(1),
+        sourceRef: sourceRefSchema,
+    }).strict()),
+    endpoints: z.array(z.object({
+        id: z.string().min(1),
+        method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]),
+        path: z.string().startsWith("/"),
+        requestFields: z.array(fieldSchema),
+        responseFields: z.array(fieldSchema),
+        successStatuses: z.array(z.number().int().min(100).max(399)),
+        errorCases: z.array(errorCaseSchema),
+    }).strict()),
+    dataModels: z.array(z.object({ id: z.string().min(1), description: z.string().min(1), sourceRef: sourceRefSchema }).strict()),
+    businessRules: z.array(z.object({ id: z.string().min(1), text: z.string().min(1), sourceRef: sourceRefSchema }).strict()),
+    stateTransitions: z.array(z.object({ from: z.string().min(1), to: z.string().min(1), trigger: z.string().min(1), sourceRef: sourceRefSchema }).strict()),
+    boundaryConstraints: z.array(z.object({ field: z.string().min(1), constraint: z.string().min(1), sourceRef: sourceRefSchema }).strict()),
+    externalDependencies: z.array(z.object({ name: z.string().min(1), description: z.string().min(1), sourceRef: sourceRefSchema.optional() }).strict()),
+    risks: z.array(z.object({ description: z.string().min(1), sourceRef: sourceRefSchema.optional() }).strict()),
+    evidenceGaps: z.array(z.object({ description: z.string().min(1), requirementId: z.string().optional(), sourceRef: sourceRefSchema.optional() }).strict()),
+}).strict();
+const SECRET_KEY = /(?:password|passwd|secret|token|api[_-]?key|private[_-]?key|credential|authorization)/i;
+const SECRET_VALUE = /(?:-----BEGIN [A-Z ]*PRIVATE KEY-----|\b(?:sk|ghp|github_pat|xox[baprs]|AKIA)[-_A-Za-z0-9]{12,}\b)/;
+function secretIssues(value, at = "$", issues = []) {
+    if (typeof value === "string" && SECRET_VALUE.test(value))
+        issues.push(`${at}: secret-like value is forbidden`);
+    if (Array.isArray(value))
+        value.forEach((item, index) => secretIssues(item, `${at}[${index}]`, issues));
+    else if (value && typeof value === "object") {
+        for (const [key, child] of Object.entries(value)) {
+            if (SECRET_KEY.test(key))
+                issues.push(`${at}.${key}: secret-shaped field name is forbidden`);
+            secretIssues(child, `${at}.${key}`, issues);
+        }
+    }
+    return issues;
+}
+export function extractStrictJsonObject(text) {
+    const trimmed = text.trim();
+    if (trimmed.startsWith("{") && trimmed.endsWith("}"))
+        return JSON.parse(trimmed);
+    const blocks = [...trimmed.matchAll(/```json\s*\n([\s\S]*?)\n```/gi)];
+    if (blocks.length !== 1 || trimmed.replace(blocks[0][0], "").trim()) {
+        throw new Error("analysis output must be one pure JSON object or one fenced json block with no trailing text");
+    }
+    return JSON.parse(blocks[0][1]);
+}
+function assertSourceBinding(contract, binding) {
+    const requirement = binding.sources.find((source) => source.kind === "requirement");
+    const references = binding.sources.filter((source) => source.kind === "reference").map((source) => source.path).sort();
+    const actualReferences = [...contract.sourceBinding.referencePaths].sort();
+    if (!requirement || contract.sourceBinding.taskId !== binding.taskId || contract.sourceBinding.requirementPath !== requirement.path || contract.sourceBinding.requirementSha256 !== requirement.sha256) {
+        throw new Error("analysis source binding does not match DAG requirement source");
+    }
+    if (JSON.stringify(actualReferences) !== JSON.stringify(references))
+        throw new Error("analysis referencePaths do not match DAG source binding");
+    if (JSON.stringify(contract.sourceBinding.requirementIds) !== JSON.stringify(binding.requirementIds))
+        throw new Error("analysis requirementIds do not match DAG source binding");
+    const explicitAc = binding.requirementIds.filter((id) => id.startsWith("AC-"));
+    const contractAc = contract.acceptanceCriteria.map((item) => item.id);
+    for (const id of explicitAc)
+        if (!contractAc.includes(id) && !contract.evidenceGaps.some((gap) => gap.requirementId === id))
+            throw new Error(`analysis contract does not cover explicit acceptance criterion ${id}`);
+}
+export async function materializeBackendTestAnalysisContract(input) {
+    if (!input.sourceBinding)
+        throw new Error("backend-test analysis gate requires DAG sourceBinding");
+    if (!/^[a-z0-9][a-z0-9._-]*\.json$/.test(input.artifactName) || !/^[a-z0-9][a-z0-9._-]*$/.test(input.outputDir))
+        throw new Error("unsafe structured artifact path");
+    const nodePath = path.join(input.runDir, `${input.fromNodeId}.json`);
+    const record = JSON.parse(await readFile(nodePath, "utf8"));
+    const raw = record.assistantText?.trim() || record.stdout?.trim() || "";
+    let parsed;
+    try {
+        parsed = extractStrictJsonObject(raw);
+    }
+    catch (error) {
+        throw new Error(`invalid-output: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const secrets = secretIssues(parsed);
+    if (secrets.length)
+        throw new Error(`invalid-output: ${secrets.join("; ")}`);
+    const result = backendTestAnalysisContractSchema.safeParse(parsed);
+    if (!result.success)
+        throw new Error(`invalid-output: ${result.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")}`);
+    assertSourceBinding(result.data, input.sourceBinding);
+    const relativePath = path.posix.join(input.outputDir, input.artifactName);
+    const artifactPath = await writeDagRunJsonArtifact(input.runDir, relativePath, result.data);
+    const normalized = `${JSON.stringify(result.data, null, 2)}\n`;
+    return { path: artifactPath, sha256: createHash("sha256").update(normalized).digest("hex"), schemaId: BACKEND_TEST_ANALYSIS_SCHEMA_ID };
+}