@tea-agent/loop-agent 0.40.0-beta.1 → 0.40.0-beta.2

package/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 ### 重点更新
 
+- Worker 只读分析 workflow：TaskSpec 新增 `execution.workflow: backend-test-analysis`，映射到专用 `backend-test-analysis-dag`，只执行 Backend Test Analysis v2 生成、严格 JSON 物化、独立只读复核与静态收尾。该路径不进入 writer、动态扩展或测试执行，并显式声明 `revisionPolicy: replace-file` artifact 及其 consumer，可作为安全 artifact continuation 的真实 Worker parent。
+
 - 发布渠道：恢复 npm `beta` 作为 operator 显式手动预览渠道（`x.y.z-beta.N`，dist-tag 固定 `beta`，仅手动发布、不接入 CI、不可晋升 latest）；`checkPublishPolicy` / `checkPromotePolicy` 与发布管理文档同步。
 
 - Worker-managed 产物派生继续（M7）：Console 现在为 Worker-owned parent 生成 plan-hash-bound continuation authority，以 parent worker run + revision 确定性创建新的 child Worker/DAG、先占 Task Pool Running slot再调用 pinned sibling `loop-agent`，并在 spawn 前绑定 child run 供 interrupt 使用。成功 child 写入独立 `artifact-continuation` 审计 run/event、释放 lease，并保留原 parent Outcome/Delivery checkpoint；失败 fail closed。Console crash 发生在 terminal run record 写入前时，可由 immutable owner + child DAG lineage reconcile，已有 child 不会被第二请求覆盖或双启动。Writer/dynamic/budget/worktree 扩展仍保持 M8 阻断。

package/dist/build-stamp.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.40.0-beta.1",
-  "gitSha": "a548be28ee02b5f147edd65d2766516e07ca308f",
-  "builtAt": "2026-08-30T02:34:20.899Z"
+  "version": "0.40.0-beta.2",
+  "gitSha": "e0f4d38e3e1a8261a0d9b224757c10173def0cdb",
+  "builtAt": "2026-08-30T04:00:34.348Z"
 }

package/dist/task/config-types.js

@@ -14,6 +14,7 @@ export const taskKindSchema = z.enum([
     "frontend-implementation",
     "frontend-test",
     "backend-test",
+    "backend-test-analysis",
     "knowledge-sync",
     "knowledge-graph-bootstrap",
 ]);
@@ -163,7 +164,7 @@ const taskConfigObjectSchema = z.object({
     taskId: z.string(),
     title: z.string(),
     sourceFiles: z.array(z.string()),
-    /** standard: 本仓库需求实现；feature-study: 参考外部代码特性并在目标仓库落地；frontend-implementation: 前端实现 DAG；backend-test: 后端测试 DAG；knowledge-sync: 最终验证后回写测试知识库 DAG；knowledge-graph-bootstrap: AI 辅助业务知识图谱初始化 */
+    /** standard: 本仓库需求实现；feature-study: 参考外部代码特性并在目标仓库落地；frontend-implementation: 前端实现 DAG；frontend-test: 前端浏览器测试 DAG；backend-test-analysis: 只读后端测试分析 DAG；backend-test: 后端测试 DAG；knowledge-sync: 最终验证后回写测试知识库 DAG；knowledge-graph-bootstrap: AI 辅助业务知识图谱初始化 */
     taskKind: taskKindSchema.optional().default("standard"),
     /** true = taskKind 由人类显式选择（含显式 standard）；DAG 路由必须尊重，不做语义改写。 */
     taskKindExplicit: z.boolean().optional(),

package/dist/task/task-demand-routing.js

@@ -76,6 +76,7 @@ const SPECIAL_TEMPLATE_BY_TASK_KIND = {
     "frontend-implementation": "frontend-implementation",
     "frontend-test": "frontend-test-dag",
     "backend-test": "backend-test-dag",
+    "backend-test-analysis": "backend-test-analysis-dag",
     "knowledge-sync": "knowledge-sync-dag",
     "knowledge-graph-bootstrap": "knowledge-graph-bootstrap-dag",
 };
@@ -83,6 +84,7 @@ const TASK_KIND_ROUTING_REASON = {
     "frontend-implementation": 'taskKind "frontend-implementation" selects the dedicated frontend DAG template',
     "frontend-test": 'taskKind "frontend-test" selects the dedicated frontend test DAG template',
     "backend-test": 'taskKind "backend-test" selects the dedicated backend test DAG template',
+    "backend-test-analysis": 'taskKind "backend-test-analysis" selects the read-only backend test analysis DAG template',
     "knowledge-sync": 'taskKind "knowledge-sync" selects the dedicated knowledge-sync DAG template',
     "knowledge-graph-bootstrap": 'taskKind "knowledge-graph-bootstrap" selects the dedicated knowledge-graph bootstrap DAG template',
 };
@@ -90,6 +92,7 @@ const SPECIAL_REQUESTED_TEMPLATES = new Set([
     "frontend-implementation",
     "frontend-test-dag",
     "backend-test-dag",
+    "backend-test-analysis-dag",
     "knowledge-sync-dag",
     "knowledge-graph-bootstrap-dag",
 ]);

package/dist/worker/outcomes/adapters.js

@@ -98,6 +98,24 @@ class FrontendImplementationAdapter {
         };
     }
 }
+/**
+ * `backend-test-analysis` — read-only requirements/API analysis. It produces
+ * the strict Backend Test Analysis v2 contract without claiming that tests or
+ * a real integration ran.
+ */
+class BackendTestAnalysisAdapter {
+    workflow = "backend-test-analysis";
+    project(input) {
+        return {
+            artifacts: [
+                ...canonicalArtifacts(input),
+                ...structuredArtifactsFromReport(input.dagReportRun),
+            ],
+            acceptanceCoverage: [...input.acceptanceRefs],
+            integrationStatus: { mock: false, real: false },
+        };
+    }
+}
 /**
  * `backend-test` — generates + executes backend tests. Integration status is
  * `real: true` only when the report completed (a real test execution); mock is
@@ -139,6 +157,7 @@ class FrontendTestAdapter {
 const ADAPTERS = new Map([
     ["agent-dag", new AgentDagAdapter()],
     ["frontend-implementation", new FrontendImplementationAdapter()],
+    ["backend-test-analysis", new BackendTestAnalysisAdapter()],
     ["backend-test", new BackendTestAdapter()],
     ["frontend-test", new FrontendTestAdapter()],
 ]);

package/dist/worker/outcomes/types.js

@@ -24,6 +24,7 @@ export const outcomeFailureCategorySchema = z.enum([
 export const OUTCOME_WORKFLOWS = [
     "agent-dag",
     "frontend-implementation",
+    "backend-test-analysis",
     "backend-test",
     "frontend-test",
 ];

package/dist/worker/task-spec/workflow-routing.js

@@ -11,6 +11,7 @@ export const workflowSchema = z.enum([
     "agent-dag",
     "frontend-implementation",
     "backend-test",
+    "backend-test-analysis",
     "frontend-test",
 ]);
 /**
@@ -23,6 +24,7 @@ export const WORKFLOW_TASK_KIND = {
     "agent-dag": "standard",
     "frontend-implementation": "frontend-implementation",
     "backend-test": "backend-test",
+    "backend-test-analysis": "backend-test-analysis",
     "frontend-test": "frontend-test",
 };
 /**
@@ -48,7 +50,7 @@ export function legacyDefaultWorkflow(type) {
 }
 /** Migration guidance surfaced whenever a legacy QA type lacks an explicit workflow. */
 export const LEGACY_QA_MIGRATION_GUIDANCE = "Legacy qa-casegen/qa-testcode/qa-execute tasks no longer auto-select a backend or frontend workflow. " +
-    "Add `execution.workflow` with one of: agent-dag, frontend-implementation, backend-test, frontend-test. " +
+    "Add `execution.workflow` with one of: agent-dag, frontend-implementation, backend-test-analysis, backend-test, frontend-test. " +
     "Use backend-test for backend-only test generation/execution, frontend-test for browser/UI tests, " +
     "or agent-dag when the QA task is a generic agent study.";
 export class WorkflowRoutingError extends Error {
@@ -120,10 +122,13 @@ export function validateWorkflowCompatibility(taskSpec) {
     }
     const issues = [];
     const type = taskSpec.type;
-    if (type === "backend-feature" && explicit !== "agent-dag" && explicit !== "backend-test") {
+    if (type === "backend-feature" &&
+        explicit !== "agent-dag" &&
+        explicit !== "backend-test-analysis" &&
+        explicit !== "backend-test") {
         issues.push({
             code: "workflow-type-incompatible",
-            message: `backend-feature is incompatible with workflow "${explicit}" (expected agent-dag or backend-test)`,
+            message: `backend-feature is incompatible with workflow "${explicit}" (expected agent-dag, backend-test-analysis, or backend-test)`,
             path: "execution.workflow",
         });
     }

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

@@ -4077,6 +4077,84 @@ const BACKEND_TEST_SKILLS_BY_ROLE = {
     verifier: ["verification-before-completion", "systematic-debugging"],
     closeout: ["loop-agent", "verification-before-completion"],
 };
+/**
+ * Read-only Worker workflow for producing a revision-eligible Backend Test
+ * Analysis v2 contract without crossing into test generation or execution.
+ * The explicit consumer keeps artifact lineage meaningful for safe
+ * continuation: replacing the contract reruns review + deterministic closeout
+ * only.
+ */
+function buildBackendTestAnalysisHybridDag(sources) {
+    const analysis = buildAnalyzeInputsNode(sources);
+    const contract = buildBackendTestAnalysisContractGateNode(sources);
+    const review = {
+        id: "review-backend-test-analysis-pi",
+        depends_on: [contract.id],
+        role: "reviewer",
+        executor: "pi",
+        complexity: "LOW",
+        writePolicy: "read-only",
+        allowedPaths: commonReadOnlyPaths(sources),
+        forbiddenPaths: commonForbiddenPaths(sources),
+        outputContract: "Concise Markdown review of the validated Backend Test Analysis v2 contract, covering source binding, explicit requirement coverage, evidence gaps, risks, and downstream readiness. No file writes.",
+        subtask_prompt: [
+            "Review the validated run-owned `contracts/backend-test-analysis.json` artifact.",
+            "Treat that structured artifact as the authoritative analysis contract; do not substitute the producer's assistant prose.",
+            "Check that every explicit AC/REQ/BR is represented by acceptanceCriteria or an evidenceGap, source references are precise, and unknown behavior remains an evidence gap rather than an invented requirement.",
+            "Summarize source-binding integrity, coverage, risks, evidence gaps, and whether the contract is ready for a later backend-test generation workflow.",
+            "Read-only: do not modify code, docs, artifacts, or repository files.",
+        ].join("\n\n"),
+    };
+    const closeout = {
+        id: "backend-test-analysis-closeout-static",
+        depends_on: [review.id],
+        role: "closeout",
+        executor: "static",
+        complexity: "LOW",
+        writePolicy: "none",
+        allowedPaths: [],
+        forbiddenPaths: commonForbiddenPaths(sources),
+        outputContract: "Deterministic handoff pointing to the validated analysis contract and its independent read-only review.",
+        subtask_prompt: "Close the read-only analysis workflow after the structured contract and review both succeed.",
+        static: {
+            resultMarkdown: [
+                "# Backend-test analysis closeout",
+                "",
+                "Validated contract: `contracts/backend-test-analysis.json`.",
+                "Independent review: `review-backend-test-analysis-pi`.",
+            ].join("\n"),
+        },
+    };
+    const spec = {
+        version: 3,
+        title: `Backend test analysis DAG: ${sources.taskConfig.title}`,
+        runtimeContract: GENERATED_DAG_RUNTIME_CONTRACT,
+        outputLanguage: sources.outputLanguage ?? DEFAULT_DAG_OUTPUT_LANGUAGE,
+        objective: extractObjective(sources.requirementMarkdown, sources.taskConfig.title),
+        successCriteria: [
+            "A strict Backend Test Analysis v2 contract is materialized with immutable source binding",
+            "Every explicit requirement is covered or preserved as an evidence gap",
+            "An independent read-only review consumes the validated structured artifact",
+        ],
+        globalConstraints: [
+            ...sources.taskConfig.hardConstraints,
+            "This workflow is analysis-only: no repository writer, dynamic expansion, test generation, or test execution is allowed.",
+        ],
+        defaults: {
+            ...BACKEND_TEST_DEFAULTS,
+            contextProfile: sources.taskConfig.contextProfile,
+        },
+        skillsByRole: BACKEND_TEST_SKILLS_BY_ROLE,
+        executorModels: sources.executorModelMatrix ?? DEFAULT_DAG_EXECUTOR_MODELS,
+        verifyStrategy: resolveDagVerifyStrategy(sources.taskConfig),
+        tasks: [analysis, contract, review, closeout],
+    };
+    applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
+    parseDagSpec(spec);
+    assertValidDagSpec(spec);
+    return spec;
+}
 /**
  * Plan D: gap-fill incremental DAG (mode=gap-fill).
  *
@@ -6784,6 +6862,8 @@ async function buildHybridDagForTemplate(sources, template, options = {}) {
     }
     else if (template === "frontend-test-dag")
         spec = buildFrontendTestHybridDag(sources);
+    else if (template === "backend-test-analysis-dag")
+        spec = buildBackendTestAnalysisHybridDag(sources);
     else if (template === "backend-test-dag")
         spec = await buildBackendTestHybridDag(sources);
     else if (template === "knowledge-sync-dag")
@@ -6828,6 +6908,7 @@ async function buildHybridDagForTemplate(sources, template, options = {}) {
 const GOVERNANCE_DISALLOWED_TEMPLATES = new Set([
     "frontend-implementation",
     "frontend-test-dag",
+    "backend-test-analysis-dag",
     "backend-test-dag",
     "knowledge-sync-dag",
     "knowledge-graph-bootstrap-dag",

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

@@ -61,7 +61,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`。
+- **0.16.0+**：可选 `execution.workflow` 映射到 loop-agent `taskKind`（agent-dag / frontend-implementation / backend-test-analysis / backend-test / frontend-test）；`backend-test-analysis` 只读生成严格 analysis artifact，不执行测试；typed Task Outcome 与 artifact-aware Ready 门禁见 completed `2026-07-19-taskspec-workflow-routing.md`。
 - 文档映射镜像：`docs/architecture/taskspec-to-loop-agent-mapping.md`（runtime 真源仍在 `src/worker/` 与 materialize 路径）。
 
 ### Task Pool

package/docs/templates/product-line/task.yaml

@@ -31,7 +31,7 @@ constraints:
   hard_constraints:
     - Do not access production secrets
 # Explicit runtime workflow → taskKind. For fullstack-v1 packets this should be set
-# on every TaskSpec. Allowed: agent-dag | frontend-implementation | backend-test | frontend-test
+# on every TaskSpec. Allowed: agent-dag | frontend-implementation | backend-test-analysis | backend-test | frontend-test
 execution:
   workflow: agent-dag
 verify:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.40.0-beta.1",
+  "version": "0.40.0-beta.2",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",