@tea-agent/loop-agent 0.29.3 → 0.31.0

package/CHANGELOG.md

@@ -2,6 +2,66 @@
 
 ## [Unreleased]
 
+## [0.31.0] - 2026-08-08
+
+### 重点更新
+
+- Observe 看板新增 DAG 执行轨迹视图，支持按初始执行、修复轮次和最终收敛分车道展开真实的调度执行过程
+- DAG 节点新增轻量执行历史摘要，在逻辑图卡片、节点表和 Inspector 中直观展示多次尝试与恢复记录
+- 统一执行轨迹与 Inspector 的业务文案为自然中文映射，主界面不再显示难以理解的裸英文状态标识
+- 优化 DAG 拓扑依赖边的路由算法，实现结构化避障正交路由，并恢复平滑的视觉线条样式
+
+### 新增
+
+- Observe DAG 详情新增执行轨迹视图，默认展示逻辑拓扑，支持键盘切换，点击轨迹卡片可联动 Inspector
+- 为 DAG 节点投影并展示轻量执行历史摘要，包含执行次数叙事及 Inspector 分次选择器
+- 新增纯函数模块统一执行轨迹与 Inspector 的业务文案中文映射，规范展示失败原因与状态转换
+- Console 与 Observe 共享统一的品牌 favicon，并支持通过同步脚本保持资源一致
+
+### 改进
+
+- DAG 拓扑依赖边采用结构化避障正交路由，支持长边避障与控制回环独立展示，提升复杂拓扑的可读性
+- 恢复相邻层级普通依赖边的平滑视觉样式，控制回环标签视觉更轻量，避免掩盖主链路
+- DAG 详情响应内嵌有界的执行轨迹投影，在历史证据缺失时安全降级并保持逻辑拓扑始终可用
+- 主 UI 业务术语优化，图卡与工具栏摘要改用自然的中文轮次描述，原始内部编号仅保留在诊断提示中
+
+### 修复
+
+- 修复 Console 与 Observe 未共享 favicon 的问题，现统一使用同一品牌资源并兼容嵌入模式
+- 修复 Observe 逻辑拓扑中同一行 DAG 边未能保持水平的问题，确保同逻辑行混合高度边正确展示
+- 修复执行轨迹车道归类错误，修正收敛开启时节点错误归入最终收敛道的问题，确保各节点按真实位置归类
+- 恢复 DAG Pi writer 节点的 bash 工具权限，同时保持只读节点无 bash 且 edit/write 仍受安全策略约束
+
+## [0.30.0] - 2026-08-08
+
+### 重点更新
+
+- 后端测试生成引入 map-shard 拓扑，将大型单节点拆分为 plan + manifest-shell + map_agent，每个模块用例获得独立的 16K 输出预算，消除大文件多轮写入被截断或完整性误报的风险
+- 修复 map_agent 单个子节点超出 token 限制导致后续所有子节点被错误级联跳过的问题，确保各模块测试用例独立生成互不干扰
+- Completeness Gate 升级为返回结构化缺陷原因，帮助模型精准定位并修复格式问题，有效结束续写死循环
+- 后端测试用例生成全面转向需求驱动覆盖，以产品需求为基准，API 契约作为场景补充，提升测试覆盖的精准度
+
+### 新增
+
+- 新增 plan 节点专属完整性评估器，仅校验 README 覆盖范围和模块索引，不再错误要求下游 map 子节点产出的文件
+- 新增 `scripts/regen-backend-test-dag.mjs` 脚本，用于从 runtime builder 重建打包镜像，保持 runtime 与 packaged template 字节对齐
+- Completeness Gate 的 `moduleStructurallyComplete` 新增结构化原因输出，明确指出空文件、标题层级错误、ID 格式非法或缺失必选章节等具体缺陷
+- 新增 `looksLikeValidPythonModule` 校验逻辑，用于准确识别共享辅助代码和工厂函数，兼容包含合法不平衡分隔符的 fixture 字符串
+
+### 改进
+
+- N2/N3 提示词改为需求驱动覆盖：Coverage Scope 固定为 new-operation/full-contract，以产品需求为基准全覆盖，API 契约补充场景维度，并禁止使用导致用例降级的 `## 测试类` 分组
+- dagDynamicExpansionChildTaskSchema 扩展 `writerOutcomePolicy` 和 `retryPolicy`，使 map_agent 子节点能正确声明实现产出并受 Completeness Gate 保护
+- Completeness Gate 白名单泛化，通过识别子节点 ID 前缀准确匹配 map 分片子节点
+- DAG 执行器模型矩阵统一路由至当前环境实际可用的 wizard-local 模型，避免因 API Key 缺失导致节点大面积失败
+
+### 修复
+
+- 修复 map_agent 中单个子节点超出 `maxTokensPerCase` 被误当作全局预算耗尽，导致后续兄弟子节点全部被跳过（SKIPPED）的问题
+- 修复 plan 节点 Completeness Gate 错误要求下游 map 子节点产出文件齐全，导致计划节点始终判定为不完整并陷入重试死循环的问题
+- 修复 manifest shell 命令因正则反引号和转义符在多层 shell 解析中被破坏，导致确定性 manifest 节点执行报错的问题，现采用 base64 编码彻底规避 bash 转义干扰
+- 修复 pytest-plan 资源检查因严格括号配平启发式算法，误判包含合法不平衡分隔符的 fixture 字符串为不完整的问题
+
 ## [0.29.3] - 2026-08-07
 
 ### 重点更新

package/dist/executors/dag-pi-executor.js

@@ -9,10 +9,10 @@ import { dagCommandPolicyAllows, resolveDagCommandPolicy, } from "../workflows/d
 import { redactPromptForLog, truncateOutput, } from "../shared/output-truncation.js";
 import { GitStatusUnavailableError, pathsChangedDuringRun, readGitStatusPorcelain, recoverRootNulArtifact, snapshotGitStatusPathFingerprints, snapshotGitStatusPorcelain, validateShellWriteGuard, } from "./shell-write-guard.js";
 import { isWriterEmptyDiffRetryCandidate, INCOMPLETE_WRITE_SET_RETRY_CATEGORY, WRITER_EMPTY_DIFF_RETRY_CATEGORY, } from "../workflows/dag/retry-policy.js";
-import { assessBackendTestMdWriterCompleteness, assessBackendTestPytestWriterCompleteness, classifyBackendTestWriterCompletenessFailure, isBackendTestCompletenessRetryCandidate, writeBackendTestWriterProgressArtifacts, } from "../workflows/dag/backend-test-writer-completeness.js";
+import { assessBackendTestMdPlanCompleteness, assessBackendTestMdWriterCompleteness, assessBackendTestPytestPlanCompleteness, assessBackendTestPytestWriterCompleteness, assessBackendTestShardChildCompleteness, backendTestWriterProgressRoleForTask, classifyBackendTestWriterCompletenessFailure, isBackendTestCompletenessRetryCandidate, isBackendTestMdPlanTask, isBackendTestPytestPlanTask, isBackendTestShardChildTask, writeBackendTestWriterProgressArtifacts, } from "../workflows/dag/backend-test-writer-completeness.js";
 import { redactSecrets, truncateUtf8Preview } from "../shared/preview.js";
 export const DAG_PI_READONLY_TOOLS = ["read", "grep", "find", "ls"];
-/** Bounded writer tools: no unrestricted bash; edit/write are policy-wrapped via SDK customTools. */
+/** Bounded writer tools include bash; edit/write remain policy-wrapped via SDK customTools. */
 export const DAG_PI_WRITE_TOOLS = [
     "read",
     "edit",
@@ -20,6 +20,7 @@ export const DAG_PI_WRITE_TOOLS = [
     "grep",
     "find",
     "ls",
+    "bash",
 ];
 export const DEFAULT_DAG_PI_PROVIDER = "wizard-local";
 const WRITER_OUTCOME_PROTOCOL_LINE = "IMPLEMENTATION_OUTCOME:";
@@ -132,7 +133,7 @@ export function resolveDagPiToolNames(task) {
         return [...DAG_PI_READONLY_TOOLS];
     const tools = [...DAG_PI_WRITE_TOOLS];
     // Pi SDK activates custom tools only when they are in this explicit list.
-    // Do not add a command capability to ordinary writers or read-only nodes.
+    // Command capabilities (playwright_cli) stay capability-gated; read-only nodes never get command tools.
     if (dagCommandPolicyAllows(task.commandPolicy, "playwright-cli")) {
         tools.push("playwright_cli");
     }
@@ -688,9 +689,20 @@ export async function executeDagPiNode(input, meta, piStepFn = executePiStep, wr
     if (writeGuardOk &&
         isBackendTestCompletenessRetryCandidate(input.task)) {
         try {
-            const progress = input.task.id === "generate-backend-pytest-pi"
-                ? await assessBackendTestPytestWriterCompleteness(input.cwd)
-                : await assessBackendTestMdWriterCompleteness(input.cwd);
+            const writerRole = backendTestWriterProgressRoleForTask(input.task.id);
+            const progress = isBackendTestShardChildTask(input.task)
+                ? await assessBackendTestShardChildCompleteness({
+                    workspaceRoot: input.cwd,
+                    role: writerRole === "pytest-generate" ? "pytest-generate" : "md-generate",
+                    writeSet: input.task.writeSet ?? [],
+                })
+                : isBackendTestMdPlanTask(input.task)
+                    ? await assessBackendTestMdPlanCompleteness(input.cwd)
+                    : isBackendTestPytestPlanTask(input.task)
+                        ? await assessBackendTestPytestPlanCompleteness(input.cwd)
+                        : writerRole === "pytest-generate"
+                            ? await assessBackendTestPytestWriterCompleteness(input.cwd)
+                            : await assessBackendTestMdWriterCompleteness(input.cwd);
             await writeBackendTestWriterProgressArtifacts({
                 runDir: meta.runDir,
                 progress,