@tea-agent/loop-agent 0.30.0 → 0.31.0

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

@@ -0,0 +1,313 @@
+/**
+ * DAG 执行轨迹 storyboard（Observe UI R5 / P1）。
+ *
+ * 将 detail 响应内嵌的有界 executionTrajectory 渲染为自上而下的 lane：
+ * 「初始执行」「修复轮次 N-1」「最终收敛」（仅内容 lane）。raw pass=1（scope
+ * base 或 convergence-pass）均显示「初始执行」，raw pass>=2 显示「修复轮次
+ * N-1」；raw pass 编号仅保留在 occurrence 卡 hover/title 诊断（AC-001/AC-002）。
+ * lane 内按真实
+ * sequence 左→右；occurrence 卡含节点名/状态/耗时/语义 verdict；多 attempt
+ * 显示中文紧凑尝试条；lane 间短箭头加中文原因；不画跨 lane 回环（P2 路由
+ * 算法不在 P1 范围）。布局异常降级为纵向事件列表，不空白页。
+ */
+import { el } from "../dom.js";
+import { statusLabel, formatMs } from "../format.js";
+import {
+	attemptFailureLabel,
+	semanticVerdictLabel,
+	transitionReasonLabel,
+} from "../dag-history-labels.js";
+import { setDagGraphViewMode } from "../state.js";
+import { selectDagExecution } from "./dag-inspector.js";
+
+export const TRAJECTORY_EMPTY_TEXT = "本次运行没有可展开的执行轨迹";
+export const TRAJECTORY_UNAVAILABLE_TEXT = "执行历史暂不可用";
+export const TRAJECTORY_PARTIAL_TEXT = "历史证据不完整";
+
+const SUCCESS_STATUSES = new Set([
+	"finished",
+	"completed",
+	"succeeded",
+	"done",
+	"success",
+]);
+const FAILURE_STATUSES = new Set([
+	"error",
+	"failed",
+	"partial_failed",
+	"partial-failed",
+	"interrupted",
+	"failure",
+	"superseded",
+]);
+const RUNNING_STATUSES = new Set(["running", "started", "paused", "queued"]);
+
+function occurrenceStatusBadge(status) {
+	const normalized = String(status ?? "").toLowerCase();
+	if (SUCCESS_STATUSES.has(normalized)) {
+		return { cls: "succeeded", label: "成功" };
+	}
+	if (FAILURE_STATUSES.has(normalized)) {
+		return { cls: "failed", label: "失败" };
+	}
+	if (RUNNING_STATUSES.has(normalized)) {
+		return { cls: "pending", label: "运行中" };
+	}
+	return { cls: "pending", label: statusLabel(status) ?? status ?? "未知" };
+}
+
+/** Lane grouping key from an occurrence (pre-sorted by the projection). */
+function laneKeyOf(occurrence) {
+	if (occurrence.scope === "final") return "final";
+	if (occurrence.scope === "base") return "base";
+	return `pass-${occurrence.pass ?? 0}`;
+}
+
+function laneTitle(laneKey, occurrence) {
+	if (laneKey === "base") return "初始执行";
+	if (laneKey === "final") return "最终收敛";
+	// raw pass=1 的 convergence-pass lane 也显示「初始执行」；raw pass>=2
+	// 映射为人类修复轮次 N-1（AC-001/AC-002），主文案不出现 raw 轮次直译。
+	const pass = occurrence.pass ?? 0;
+	if (pass <= 1) return "初始执行";
+	return `修复轮次 ${pass - 1}`;
+}
+
+/** 中文紧凑尝试条：首次尝试 / 第 N 次尝试（AC-002，主 UI 不出现裸 A1/A2）。 */
+function attemptStripLabel(occurrence) {
+	const attempts = occurrence.attempts;
+	if (!Array.isArray(attempts) || attempts.length <= 1) return null;
+	return attempts
+		.map((attempt) => {
+			const name =
+				attempt.attempt === 1 ? "首次尝试" : `第 ${attempt.attempt} 次尝试`;
+			// 失败 attempt 显示表一中文原因（AC-001），未知/缺失分类
+			// fail-closed 为「其他失败原因」；成功 attempt 保持「成功」。
+			const outcome =
+				attempt.status === "success"
+					? "成功"
+					: attemptFailureLabel(attempt.failureCategory);
+			return `${name} ${outcome}`;
+		})
+		.join(" → ");
+}
+
+function buildOccurrenceCard(dagRunId, occurrence) {
+	const badge = occurrenceStatusBadge(occurrence.status);
+	const recovered =
+		occurrence.recovered === true ||
+		occurrence.supersededBy?.length > 0 ||
+		false;
+	const card = document.createElement("button");
+	card.type = "button";
+	const extraClasses = [
+		recovered ? "is-recovered" : "",
+		occurrence.availability === "partial" ? "is-partial" : "",
+	]
+		.filter(Boolean)
+		.join(" ");
+	card.className = extraClasses
+		? `dag-trajectory-occurrence ${extraClasses}`
+		: "dag-trajectory-occurrence";
+	// 原始 pass/attempt 编号仅出现在 hover/title 诊断中，不作主标题（AC-003）。
+	const diagnostic = [
+		occurrence.executionId,
+		occurrence.status,
+		...(occurrence.pass ? [`pass ${occurrence.pass}`] : []),
+		...(occurrence.failureCategory
+			? [`failureCategory ${occurrence.failureCategory}`]
+			: []),
+	].join("\n");
+	card.setAttribute("title", diagnostic);
+	// 语义 verdict 主文案与 aria-label 均显示表二中文（AC-002）。
+	const verdictLabel = semanticVerdictLabel(occurrence.semanticVerdict);
+	card.setAttribute(
+		"aria-label",
+		`${occurrence.nodeId}，${badge.label}${occurrence.semanticVerdict ? `，语义 ${verdictLabel}` : ""}${recovered ? "，历史失败 · 已恢复/已覆盖" : ""}`,
+	);
+
+	const nodeLine = el("span", "dag-trajectory-occurrence-node", occurrence.nodeId);
+	card.appendChild(nodeLine);
+	const statusBadge = el(
+		"span",
+		`badge badge-${badge.cls} dag-trajectory-occurrence-status`,
+		badge.label,
+	);
+	card.appendChild(statusBadge);
+	if (occurrence.durationMs !== undefined) {
+		card.appendChild(
+			el(
+				"span",
+				"dag-trajectory-occurrence-meta",
+				formatMs(occurrence.durationMs),
+			),
+		);
+	}
+	if (occurrence.semanticVerdict) {
+		card.appendChild(
+			el("span", "dag-trajectory-occurrence-verdict", verdictLabel),
+		);
+	}
+	const strip = attemptStripLabel(occurrence);
+	if (strip) {
+		card.appendChild(el("span", "dag-trajectory-attempt-strip", strip));
+	}
+	if (recovered) {
+		const label =
+			occurrence.supersededBy?.length > 0
+				? "历史失败 · 已覆盖"
+				: "历史失败 · 已恢复";
+		card.appendChild(el("span", "dag-trajectory-recovered", label));
+	}
+	if (occurrence.availability === "partial") {
+		card.appendChild(
+			el("span", "dag-trajectory-partial", TRAJECTORY_PARTIAL_TEXT),
+		);
+	}
+	card.addEventListener("click", () => {
+		// @pass-<n> 映射为 Inspector 既有 pass-<n> key；@base/@final 默认最新。
+		selectDagExecution(
+			dagRunId,
+			occurrence.nodeId,
+			occurrence.pass ? `pass-${occurrence.pass}` : null,
+		);
+	});
+	return card;
+}
+
+function buildEmptyState(dagRunId, rerender) {
+	const root = el("div", "dag-trajectory-empty");
+	root.appendChild(el("p", "dag-trajectory-empty-text", TRAJECTORY_EMPTY_TEXT));
+	const back = document.createElement("button");
+	back.type = "button";
+	back.className = "dag-trajectory-back";
+	back.textContent = "返回逻辑拓扑";
+	back.addEventListener("click", () => {
+		setDagGraphViewMode(dagRunId, "topology");
+		rerender();
+	});
+	root.appendChild(back);
+	return root;
+}
+
+/**
+ * 渲染执行轨迹视图到图区域 viewport。`rerender` 由 dag-graph 注入，用于
+ * 空态「返回逻辑拓扑」就地切回拓扑（避免模块环）。
+ */
+export function renderTrajectoryStoryboard(dag, dagRunId, viewport, rerender) {
+	const trajectory = dag.executionTrajectory;
+	const fallback = (occurrences) => {
+		const list = el("ul", "dag-trajectory-fallback");
+		const items = Array.isArray(occurrences)
+			? occurrences
+			: trajectory?.occurrences ?? [];
+		if (items.length === 0) {
+			list.appendChild(
+				el("li", "dag-trajectory-fallback-item", TRAJECTORY_UNAVAILABLE_TEXT),
+			);
+		} else {
+			let rendered = 0;
+			for (const occurrence of items) {
+				if (!occurrence || typeof occurrence !== "object") continue;
+				// 纵向降级列表同样经表三/表二映射拼接，不出现裸英文 token（AC-002）。
+				const reason =
+					transitionReasonLabel(occurrence.nextReason) ||
+					semanticVerdictLabel(occurrence.semanticVerdict) ||
+					"";
+				list.appendChild(
+					el(
+						"li",
+						"dag-trajectory-fallback-item",
+						`${occurrence.nodeId} · ${statusLabel(occurrence.status)}${reason ? ` · ${reason}` : ""}`,
+					),
+				);
+				rendered += 1;
+			}
+			if (rendered === 0) {
+				list.appendChild(
+					el(
+						"li",
+						"dag-trajectory-fallback-item",
+						TRAJECTORY_UNAVAILABLE_TEXT,
+					),
+				);
+			}
+		}
+		viewport.appendChild(list);
+	};
+	try {
+		if (!trajectory || !Array.isArray(trajectory.occurrences)) {
+			// 无 executionTrajectory 或空轨迹：空态 + 返回逻辑拓扑入口。
+			viewport.appendChild(buildEmptyState(dagRunId, rerender));
+			return;
+		}
+		const root = el("div", "dag-trajectory");
+		if (trajectory.projectionError === true) {
+			root.appendChild(
+				el("div", "dag-trajectory-banner is-error", TRAJECTORY_UNAVAILABLE_TEXT),
+			);
+		}
+		if (Array.isArray(trajectory.warnings) && trajectory.warnings.length > 0) {
+			root.appendChild(
+				el(
+					"div",
+					"dag-trajectory-banner",
+					`${TRAJECTORY_PARTIAL_TEXT}：${trajectory.warnings.join("；")}`,
+				),
+			);
+		}
+		if (trajectory.occurrences.length === 0) {
+			root.appendChild(buildEmptyState(dagRunId, rerender));
+			viewport.appendChild(root);
+			return;
+		}
+		// 按投影排序连续分组为 lane（仅内容 lane），lane 间插入带中文原因的短箭头。
+		const lanes = [];
+		let currentLaneKey = null;
+		for (const occurrence of trajectory.occurrences) {
+			const laneKey = laneKeyOf(occurrence);
+			if (laneKey !== currentLaneKey) {
+				currentLaneKey = laneKey;
+				lanes.push({
+					laneKey,
+					title: laneTitle(laneKey, occurrence),
+					occurrences: [],
+				});
+			}
+			lanes[lanes.length - 1].occurrences.push(occurrence);
+		}
+		for (const [index, lane] of lanes.entries()) {
+			const laneRoot = el("div", "dag-trajectory-lane");
+			const head = el("div", "dag-trajectory-lane-head");
+			head.appendChild(el("span", "dag-trajectory-lane-title", lane.title));
+			head.appendChild(
+				el("span", "dag-trajectory-lane-meta", `${lane.occurrences.length} 次执行`),
+			);
+			laneRoot.appendChild(head);
+			const laneCards = el("div", "dag-trajectory-lane-cards");
+			for (const occurrence of lane.occurrences) {
+				laneCards.appendChild(buildOccurrenceCard(dagRunId, occurrence));
+			}
+			laneRoot.appendChild(laneCards);
+			root.appendChild(laneRoot);
+			if (index < lanes.length - 1) {
+				const lastOccurrence = lane.occurrences[lane.occurrences.length - 1];
+				const reason = transitionReasonLabel(lastOccurrence?.nextReason);
+				if (reason) {
+					const transition = el("div", "dag-trajectory-transition");
+					transition.appendChild(
+						el("span", "dag-trajectory-transition-arrow", "↓"),
+					);
+					transition.appendChild(
+						el("span", "dag-trajectory-transition-reason", reason),
+					);
+					root.appendChild(transition);
+				}
+			}
+		}
+		viewport.appendChild(root);
+	} catch {
+		// 布局/渲染异常降级：纵向事件列表，不空白页（AC-006）。
+		fallback(null);
+	}
+}

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

@@ -62,7 +62,7 @@ import {
 	mountViewState,
 	makeSessionEventIdentity,
 } from "../state.js";
-import { uiState, dagGraphViewportStates } from "../state.js";
+import { uiState, dagGraphViewportStates, dagGraphViewModes } from "../state.js";
 import { sortPoolTasks } from "../format-pool.js";
 import {
 	dagMetaVisibility,
@@ -108,9 +108,12 @@ export async function renderDagDetail(dagRunId, initial = true) {
 		uiState.sessionEventIdentity = null;
 		uiState.dagInspectorOpen = false;
 		uiState.dagInspectorTab = "output";
+		uiState.dagInspectorAttempt = null;
 		uiState.dagGraphViewportState = null;
 		uiState.dagTimelineViewportState = null;
 	}
+	// AC-001：同会话内重新进入同一 dagRunId 保持当前图视图模式（不切回逻辑拓扑）。
+	uiState.dagGraphViewMode = dagGraphViewModes.get(dagRunId) ?? "topology";
 
 	const metaEl = document.getElementById("dag-meta");
 	const ranksEl = document.getElementById("dag-ranks");
@@ -167,6 +170,7 @@ export async function renderDagDetail(dagRunId, initial = true) {
 	) {
 		uiState.selectedDagNodeId = null;
 		uiState.dagInspectorOpen = false;
+		uiState.dagInspectorAttempt = null;
 		if (initial) {
 			uiState.sessionEventOffset = 0;
 			uiState.sessionEvents = [];
@@ -325,17 +329,30 @@ export async function renderDagDetail(dagRunId, initial = true) {
 					node.model ?? "—",
 					node.status ? badge(node.status) : "—",
 					formatMs(node.durationMs),
+					(typeof node.executionSummary?.historyLabel === "string" &&
+						node.executionSummary.historyLabel.trim()) ||
+						"—",
 					node.errorPreview ?? node.label ?? "—",
 				],
 			};
 		});
 		const nodeTable = buildTable(
-			["序号", "节点 ID", "依赖层", "执行方式", "模型", "状态", "耗时", "备注"],
+			[
+				"序号",
+				"节点 ID",
+				"依赖层",
+				"执行方式",
+				"模型",
+				"状态",
+				"耗时",
+				"执行历史",
+				"备注",
+			],
 			rows,
 		);
 		nodeTable.classList.add("dag-node-table");
 		for (const row of nodeTable.tBodies[0]?.rows ?? []) {
-			for (const columnIndex of [1, 4, 7]) {
+			for (const columnIndex of [1, 4, 8]) {
 				const cell = row.cells[columnIndex];
 				if (cell?.textContent) cell.title = cell.textContent;
 			}

package/dist/workflows/dag/init-hybrid.js

@@ -561,7 +561,7 @@ export function hasApiDependency(sources) {
 /**
  * Resolve frontend Mock mode from capability seed, task config, and interface dependency analysis.
  *
- * Decision matrix (from docs/design/active/frontend-mock-data-workflow.md):
+ * Decision matrix (historical design: docs/design/archive/frontend-mock-data-workflow.md):
  *
  * | 接口/异步数据依赖 | 既有 Mock 服务 | policy | 结果 |
  * |---|---|---|---|
@@ -4553,7 +4553,7 @@ function buildFrontendTestHybridDag(sources) {
         "Use only the declared isolated test environment. Production URLs, real credentials, and unauthorized data are blocked.",
         `Browser startup for generated cases must be playwright-cli open --browser=chrome ${controllerFrontend.baseUrl}; this origin is frozen by the controller from ${controllerFrontend.baseUrlSource}, and model-authored files cannot establish or override it; generated operations stay in the default browser session and must not use unverified named-session flags.`,
         "Browser-tool preflight runs before any frontend-test Pi node; cli-only rollback, missing/incompatible Pi SDK custom-tool capability, missing verified playwright-cli launcher, or incompatible --help fails with zero Pi calls.",
-        "Browser case children use commandPolicy capability-allowlist playwright-cli and structured playwright_cli tool; ordinary writers remain without Bash.",
+        "Browser case children use commandPolicy capability-allowlist playwright-cli and structured playwright_cli tool; playwright-cli stays capability-gated while ordinary writers have bash.",
         "Passed cases require same-child ordered controller receipts: successful open → successful find → successful post-execution cleanup. Pre-start cleanup, snapshot/goto/screenshot/request/console and ordinary interactions are insufficient; missing or unordered receipts convert to blocked (browser-command-evidence-missing).",
         "playwright-cli-only: generators and executors may call only skill-declared playwright-cli commands; bare playwright / npx playwright / @playwright/test / Playwright source are forbidden with no native Playwright fallback.",
         "Environment preflight must curl-probe the frozen non-production baseUrl before generate; unreachable or curl-unavailable ends preflight as blocked (frontend-base-url-unreachable|curl-unavailable) so generate/map do not run.",

package/docs/architecture/README.md

@@ -15,6 +15,10 @@
 5. `worker-and-feature.md` — agent-worker 子进程边界、controller identity、Task Pool、Feature、Observe 与 Console。
 6. `facts-and-state.md` — `.harness/` 各根目录、canonical facts、derived read models 与不可变规则。
 7. `evolution.md` — 当前已实现能力 vs 第 3–6 月未来方向（明确标注规划/未实现）。
+8. `state-and-failure-taxonomy.md` — Task Pool、DAG、Loop 与报告共用的 canonical 状态/失败分类。
+9. `taskspec-to-loop-agent-mapping.md` / `.yaml` — TaskSpec 到 worker/runtime 的兼容合同与机器可读镜像。
+10. `knowledge-graph-and-query-spec.md` — 业务知识图谱、knowledge-links 与查询协议。
+11. `testing-knowledge-base-impl-spec.md` — 测试知识库 schema、ID、读写矩阵和校验规则。
 
 ## 事实与规划的区分
 

package/docs/architecture/dag-execution.md

@@ -44,7 +44,7 @@ src/commands/dag-validate.ts  runDagValidate
 ### 专用 taskKind 与模板选择（架构摘要）
 
 - `initHybridDagFromTask` 按 `task.json.taskKind`（及前端需求自动分类）选择专用拓扑：`frontend-implementation`、`frontend-test`、`backend-test`、`knowledge-sync`、`knowledge-graph-bootstrap` 等；默认 `standard` 走 governance profile 通用实现链。
-- **backend-test（0.17.x）**：Markdown-first 固定短链（环境硬门 → Markdown 用例/Review → 单次 pytest + HTML → 报告与 L-5）；不在本页展开节点清单，见 `docs/design/active/backend-test-workflow.md` 与 completed markdown-first plan。
+- **backend-test（0.17.x）**：Markdown-first 固定短链（环境硬门 → Markdown 用例/Review → 单次 pytest + HTML → 报告与 L-5）；不在本页展开节点清单，见 `docs/runtime/backend-test-workflow.md` 与 completed markdown-first plan。
 - 专用模板不是新的 governance profile：风险等级仍由 profile 规则判断；写边界仍受 `allowedPaths` / `forbiddenPaths` / `writeSet` 约束。
 
 ## rank 调度

package/docs/architecture/worker-and-feature.md

@@ -62,7 +62,7 @@ controller identity 与 DAG skill snapshot 是两个不同冻结层（前者跨
 - schema/validate：`src/worker/task-spec/{schema,validate}.ts`。
 - 校验验收条件、依赖、验证命令；`agent-worker task validate-feature` 等用之。
 - **0.16.0+**：可选 `execution.workflow` 映射到 loop-agent `taskKind`（如 agent-dag / frontend-implementation / backend-test / frontend-test）；typed Task Outcome 与 artifact-aware Ready 门禁见 completed `2026-07-19-taskspec-workflow-routing.md`。
-- 文档映射镜像：`docs/design/active/taskspec-to-loop-agent-mapping.md`（runtime 真源仍在 `src/worker/` 与 materialize 路径）。
+- 文档映射镜像：`docs/architecture/taskspec-to-loop-agent-mapping.md`（runtime 真源仍在 `src/worker/` 与 materialize 路径）。
 
 ### Task Pool
 

package/docs/governance/README.md

@@ -11,5 +11,8 @@
 - [`harness-methodology-verification.md`](harness-methodology-verification.md)：如何用新鲜命令结果支持完成声明。
 - [`harness-methodology-debugging.md`](harness-methodology-debugging.md)：系统化定位故障，不用猜测代替证据。
 - [`document-review-policy.md`](document-review-policy.md)：文档 freshness、`reviewTier` 与 `lastReviewed` 更新边界。
+- [`lightweight-github-collaboration.md`](lightweight-github-collaboration.md)：短分支、简短 PR、CI 与 Squash Merge 的轻量协作规则。
+- [`研发模式.md`](研发模式.md)：Feature 团队推进、交付和知识回写方法论。
+- [`腾讯实践对当前项目的指引.md`](腾讯实践对当前项目的指引.md)：外部工程实践与本仓库治理/能力边界的映射。
 
 架构事实见 [`../architecture/README.md`](../architecture/README.md)，运行手册见 [`../runtime/README.md`](../runtime/README.md)，日常维护操作见 [`../operations/README.md`](../operations/README.md)。

package/docs/operations/README.md

@@ -8,5 +8,6 @@
 - [`branch-merge-guideline.md`](branch-merge-guideline.md)：按风险选择合并模式并留下 source-SHA 证据。
 - [`github-collaboration.md`](github-collaboration.md)：仓库内 GitHub 协作约定及自动/人工发布通道。
 - [`production-readiness.md`](production-readiness.md)：交付前的生产就绪判断。
+- [`backend-test-jacoco-coverage.md`](backend-test-jacoco-coverage.md)：Java 被测服务挂载 JaCoCo tcpserver agent 的 Maven、`java -jar` 与 Docker 操作手册。
 
 验证命令仍以 [`../governance/verification-matrix.md`](../governance/verification-matrix.md) 为准。

package/docs/templates/frontend-test-dag.json

@@ -18,7 +18,7 @@
     "Default frontendTest.reviewMode=off uses mechanical checklist-shell before materialize; set reviewMode=blocking for legacy dual LLM review gate.",
     "playwright-cli-only: generators and executors may call only skill-declared playwright-cli commands; bare playwright / npx playwright / @playwright/test / Playwright source are forbidden with no native Playwright fallback.",
     "Browser-tool preflight (preflight-frontend-browser-tool-shell) must reject CODE_AGENT_PI_BACKEND=cli-only, verify the Pi SDK structured custom-tool surface, freeze baseUrl from hash-bound task source config.md (or controller default localhost), and confirm the verified playwright-cli launcher + --help contract before any frontend-test Pi node; missing capability/CLI fails with zero Pi calls.",
-    "Case executors use structured playwright_cli custom tool under commandPolicy capability-allowlist; ordinary writers stay without Bash.",
+    "Case executors use structured playwright_cli custom tool under commandPolicy capability-allowlist; playwright-cli stays capability-gated while ordinary writers have bash.",
     "File outputs use canonical --filename: playwright-cli screenshot --filename final.png (a real target/ref may precede it), playwright-cli pdf --filename final.pdf, and playwright-cli snapshot --filename snapshot.txt only when a snapshot file is needed; a snapshot without filename is response-only. Never use --path, --output, --file, or an output path as a positional target.",
     "Passed cases require same-child ordered controller receipts: successful open → successful find → successful post-execution cleanup. Pre-start cleanup, snapshot/goto/screenshot/request/console, and ordinary interactions cannot establish passed authority; model prose cannot fake green.",
     "Environment preflight must curl-probe the frozen non-production baseUrl before generate; unreachable or curl-unavailable ends preflight as blocked (frontend-base-url-unreachable|curl-unavailable) so generate/map do not run.",

package/harness.json

@@ -80,9 +80,9 @@
   "executors": {
     "pi": {
       "description": "Pi planning, review, diagnosis, and bounded writing when DAG toolProfile=write",
-      "LOW": "gpt-5.3-codex-spark",
-      "MED": "glm-5.2",
-      "HIGH": "grok-4.5"
+      "LOW": "minimax-m3",
+      "MED": "grok-4.5",
+      "HIGH": "gpt-5.6-sol"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",
@@ -44,7 +44,8 @@
     "cursor": "node --import tsx/esm src/cli.ts cursor-prompt",
     "pi-prompt": "node --import tsx/esm src/cli.ts pi-prompt",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\" && npm run console:build",
+    "brand:sync": "node scripts/sync-brand-assets.mjs",
+    "build": "npm run brand:sync && npm run clean && tsc -p tsconfig.build.json && node -e \"const fs=require('node:fs');const p='dist/worker/observe/static';fs.mkdirSync(p,{recursive:true});fs.cpSync('src/worker/observe/static',p,{recursive:true});\" && npm run console:build",
     "console:build": "vite build --config src/worker/console/vite.config.ts",
     "prepack": "npm run build",
     "prepublishOnly": "node scripts/check-npm-publish-policy.mjs && npm run typecheck && npm test && npm run build",

package/scripts/kb-bootstrap-init-skeleton.sh

@@ -168,7 +168,7 @@ loop-agent task advance <id> --task-kind knowledge-graph-bootstrap --allowed-pat
 # bash scripts/kb-query.sh --mode by_feature --feature F-2026-004 --json
 ```
 
-See `docs/design/active/knowledge-graph-and-query-spec.md` and `docs/design/active/knowledge-graph-ai-bootstrap.md`.
+See `docs/architecture/knowledge-graph-and-query-spec.md` and `docs/design/active/knowledge-graph-ai-bootstrap.md`.
 EOF
 )