@tea-agent/loop-agent 0.13.0 → 0.15.0

package/docs/templates/frontend-eval/smoke-targets.md

@@ -1,53 +1,53 @@
-# Frontend-implementation Smoke Targets 策略（M0）
-
-## 原则
-
-1. **仅使用平台临时目录**（`os.tmpdir()` / CI runner temp），**不得**在 loop-agent 仓库根写入可运行 app、`node_modules` 或构建产物。  
-2. **不启动浏览器**；不安装 Playwright/Cypress；不声明 Browser verification。  
-3. M0 只冻结**目标描述与生成约定**；真正从 fixture 物化临时项目在 **M1+ dogfood** 时实施。  
-4. 临时项目生命周期：创建 → 最小依赖安装（仅 temp）→ 跑冻结 static/behavior 命令 → 删除；失败日志可复制到 run-owned harness 目录，不进 git。
-
-## 三类可控目标
-
-| targetId | 栈 | 最小信号 | 建议 static | 建议 behavior | Browser |
-|----------|----|----------|-------------|---------------|---------|
-| `react-vitest-min` | React + Vitest + TypeScript | `package.json` scripts: `typecheck`, `build`/`vite build`, `test`；`src/**/*.tsx` | `npm run typecheck`（+ build 若存在） | `npm test` / `npx vitest run` | not-run |
-| `nextjs-min` | Next.js（App Router 信号） | `app/` 或 `pages/` + `"next"` dependency；`"use client"` 边界样例 | `npm run typecheck` / `next build`（temp only） | 聚焦 unit/component test，**不** `next start` 作完成证据 | not-run |
-| `vue-vitest-min` | Vue 3 + Vitest | `*.vue` + vitest config | `npm run typecheck` 或 `vue-tsc` | `npm test` | not-run |
-
-## 临时项目生成约定（M1+ 实施）
-
-```text
-ROOT="$(mktemp -d "${TMPDIR:-/tmp}/fe-eval-XXXXXX")"
-# 从 docs/templates/frontend-eval/fixtures/... 渲染 package.json / 源文件骨架
-# npm install --prefix "$ROOT"   # 仅 temp
-# 在 $ROOT 执行冻结 verify 命令
-# rm -rf "$ROOT"
-```
-
-约束：
-
-- fixture **不得**内嵌密钥、真实 PII、恶意脚本。  
-- 依赖版本钉死在 fixture 清单，避免 eval 漂移。  
-- 不得 `npm link` 工作区 loop-agent 作为被测 app 依赖（controller 版本另按任务约束）。
-
-## 与 functional / failure fixtures 映射
-
-| fixture 类别 | 优先 target |
-|--------------|-------------|
-| simple component / style | react-vitest-min, vue-vitest-min |
-| form validation | react-vitest-min |
-| list/detail | react-vitest-min, nextjs-min |
-| API + Mock | react-vitest-min（+ MSW 骨架） |
-| permission UI | react-vitest-min, nextjs-min |
-| SSR / server-client boundary | nextjs-min |
-| shared component API | react-vitest-min |
-| pure local no-remote | 任一 |
-| failure: type/build | 任一 |
-| failure: mock production-on | react-vitest-min + mock 骨架 |
-
-## 明确不做
-
-- 不在本仓库 `website/**` 或 examples 中落永久 dogfood app 作为 M0 必需项。  
-- 不把 `scripts/check-repo.sh` 全量当作前端 app 验证。  
-- 不提交 temp 安装树或截图基线。
+# Frontend-implementation Smoke Targets 策略（M0）
+
+## 原则
+
+1. **仅使用平台临时目录**（`os.tmpdir()` / CI runner temp），**不得**在 loop-agent 仓库根写入可运行 app、`node_modules` 或构建产物。  
+2. **不启动浏览器**；不安装 Playwright/Cypress；不声明 Browser verification。  
+3. M0 只冻结**目标描述与生成约定**；真正从 fixture 物化临时项目在 **M1+ dogfood** 时实施。  
+4. 临时项目生命周期：创建 → 最小依赖安装（仅 temp）→ 跑冻结 static/behavior 命令 → 删除；失败日志可复制到 run-owned harness 目录，不进 git。
+
+## 三类可控目标
+
+| targetId | 栈 | 最小信号 | 建议 static | 建议 behavior | Browser |
+|----------|----|----------|-------------|---------------|---------|
+| `react-vitest-min` | React + Vitest + TypeScript | `package.json` scripts: `typecheck`, `build`/`vite build`, `test`；`src/**/*.tsx` | `npm run typecheck`（+ build 若存在） | `npm test` / `npx vitest run` | not-run |
+| `nextjs-min` | Next.js（App Router 信号） | `app/` 或 `pages/` + `"next"` dependency；`"use client"` 边界样例 | `npm run typecheck` / `next build`（temp only） | 聚焦 unit/component test，**不** `next start` 作完成证据 | not-run |
+| `vue-vitest-min` | Vue 3 + Vitest | `*.vue` + vitest config | `npm run typecheck` 或 `vue-tsc` | `npm test` | not-run |
+
+## 临时项目生成约定（M1+ 实施）
+
+```text
+ROOT="$(mktemp -d "${TMPDIR:-/tmp}/fe-eval-XXXXXX")"
+# 从 docs/templates/frontend-eval/fixtures/... 渲染 package.json / 源文件骨架
+# npm install --prefix "$ROOT"   # 仅 temp
+# 在 $ROOT 执行冻结 verify 命令
+# rm -rf "$ROOT"
+```
+
+约束：
+
+- fixture **不得**内嵌密钥、真实 PII、恶意脚本。  
+- 依赖版本钉死在 fixture 清单，避免 eval 漂移。  
+- 不得 `npm link` 工作区 loop-agent 作为被测 app 依赖（controller 版本另按任务约束）。
+
+## 与 functional / failure fixtures 映射
+
+| fixture 类别 | 优先 target |
+|--------------|-------------|
+| simple component / style | react-vitest-min, vue-vitest-min |
+| form validation | react-vitest-min |
+| list/detail | react-vitest-min, nextjs-min |
+| API + Mock | react-vitest-min（+ MSW 骨架） |
+| permission UI | react-vitest-min, nextjs-min |
+| SSR / server-client boundary | nextjs-min |
+| shared component API | react-vitest-min |
+| pure local no-remote | 任一 |
+| failure: type/build | 任一 |
+| failure: mock production-on | react-vitest-min + mock 骨架 |
+
+## 明确不做
+
+- 不在本仓库 `website/**` 或 examples 中落永久 dogfood app 作为 M0 必需项。  
+- 不把 `scripts/check-repo.sh` 全量当作前端 app 验证。  
+- 不提交 temp 安装树或截图基线。

package/docs/templates/frontend-implementation-contract.schema.json

@@ -1,27 +1,27 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "frontend-implementation-contract-v1",
-  "title": "Frontend Implementation Contract v1",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["schemaVersion", "sourceBinding", "riskLevel", "targets", "requirements", "uiStates", "interactions", "mockApi", "designEvidence", "verificationTargets", "evidenceGaps"],
-  "properties": {
-    "schemaVersion": { "const": 1 },
-    "sourceBinding": { "$ref": "#/$defs/sourceBinding" },
-    "riskLevel": { "enum": ["small", "standard", "high-risk"] },
-    "targets": { "type": "object", "additionalProperties": false, "required": ["files"], "properties": { "files": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/path" } }, "routes": { "type": "array", "items": { "type": "string", "pattern": "^/" } }, "publicApiChanges": { "type": "array", "items": { "type": "string", "minLength": 1 } } } },
-    "requirements": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "implementationTargets", "verificationTargetIds"], "properties": { "id": { "$ref": "#/$defs/requirementId" }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "evidenceGap": { "$ref": "#/$defs/gap" } } } },
-    "uiStates": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["name", "applicable"], "properties": { "name": { "type": "string", "minLength": 1 }, "applicable": { "type": "boolean" }, "expectedBehavior": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "notApplicableReason": { "type": "string", "minLength": 1 } } } },
-    "interactions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["name", "implementationTargets", "verificationTargetIds"], "properties": { "name": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string" } } } } },
-    "mockApi": { "type": "object", "additionalProperties": false, "required": ["strategy", "productionDefaultOff", "activation", "endpoints"], "properties": { "strategy": { "enum": ["native", "browser-intercept", "request-adapter", "not-needed"] }, "productionDefaultOff": { "const": true }, "activation": { "type": "string", "minLength": 1 }, "endpoints": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["method", "path"], "properties": { "method": { "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"] }, "path": { "type": "string", "pattern": "^/" }, "fixture": { "$ref": "#/$defs/path" }, "consumer": { "$ref": "#/$defs/path" } } } } } },
-    "designEvidence": { "type": "object", "additionalProperties": false, "required": ["source", "paths", "conflicts"], "properties": { "source": { "type": "string", "minLength": 1 }, "paths": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "conflicts": { "type": "array", "items": { "type": "string", "minLength": 1 } } } },
-    "verificationTargets": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "type", "commandLabel", "file", "requirementIds", "uiStates"], "properties": { "id": { "type": "string", "minLength": 1 }, "type": { "enum": ["static", "unit", "component", "integration", "mock"] }, "commandLabel": { "type": "string", "minLength": 1 }, "file": { "$ref": "#/$defs/path" }, "symbol": { "type": "string", "minLength": 1 }, "requirementIds": { "type": "array", "items": { "$ref": "#/$defs/requirementId" } }, "uiStates": { "type": "array", "items": { "type": "string", "minLength": 1 } } } } },
-    "evidenceGaps": { "type": "array", "items": { "$ref": "#/$defs/gap" } }
-  },
-  "$defs": {
-    "path": { "type": "string", "minLength": 1, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\).+$" },
-    "requirementId": { "type": "string", "pattern": "^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$" },
-    "gap": { "type": "object", "additionalProperties": false, "required": ["description", "blocking"], "properties": { "requirementId": { "$ref": "#/$defs/requirementId" }, "description": { "type": "string", "minLength": 1 }, "blocking": { "type": "boolean" } } },
-    "sourceBinding": { "type": "object", "additionalProperties": false, "required": ["taskId", "requirementPath", "requirementSha256", "referencePaths", "requirementIds"], "properties": { "taskId": { "type": "string", "minLength": 1 }, "requirementPath": { "$ref": "#/$defs/path" }, "requirementSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "referencePaths": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "requirementIds": { "type": "array", "items": { "$ref": "#/$defs/requirementId" } } } }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "frontend-implementation-contract-v1",
+  "title": "Frontend Implementation Contract v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "sourceBinding", "riskLevel", "targets", "requirements", "uiStates", "interactions", "mockApi", "designEvidence", "verificationTargets", "evidenceGaps"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "sourceBinding": { "$ref": "#/$defs/sourceBinding" },
+    "riskLevel": { "enum": ["small", "standard", "high-risk"] },
+    "targets": { "type": "object", "additionalProperties": false, "required": ["files"], "properties": { "files": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/path" } }, "routes": { "type": "array", "items": { "type": "string", "pattern": "^/" } }, "publicApiChanges": { "type": "array", "items": { "type": "string", "minLength": 1 } } } },
+    "requirements": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "implementationTargets", "verificationTargetIds"], "properties": { "id": { "$ref": "#/$defs/requirementId" }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "evidenceGap": { "$ref": "#/$defs/gap" } } } },
+    "uiStates": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["name", "applicable"], "properties": { "name": { "type": "string", "minLength": 1 }, "applicable": { "type": "boolean" }, "expectedBehavior": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "notApplicableReason": { "type": "string", "minLength": 1 } } } },
+    "interactions": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["name", "implementationTargets", "verificationTargetIds"], "properties": { "name": { "type": "string", "minLength": 1 }, "implementationTargets": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "verificationTargetIds": { "type": "array", "items": { "type": "string" } } } } },
+    "mockApi": { "type": "object", "additionalProperties": false, "required": ["strategy", "productionDefaultOff", "activation", "endpoints"], "properties": { "strategy": { "enum": ["native", "browser-intercept", "request-adapter", "not-needed"] }, "productionDefaultOff": { "const": true }, "activation": { "type": "string", "minLength": 1 }, "endpoints": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["method", "path"], "properties": { "method": { "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"] }, "path": { "type": "string", "pattern": "^/" }, "fixture": { "$ref": "#/$defs/path" }, "consumer": { "$ref": "#/$defs/path" } } } } } },
+    "designEvidence": { "type": "object", "additionalProperties": false, "required": ["source", "paths", "conflicts"], "properties": { "source": { "type": "string", "minLength": 1 }, "paths": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "conflicts": { "type": "array", "items": { "type": "string", "minLength": 1 } } } },
+    "verificationTargets": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "type", "commandLabel", "file", "requirementIds", "uiStates"], "properties": { "id": { "type": "string", "minLength": 1 }, "type": { "enum": ["static", "unit", "component", "integration", "mock"] }, "commandLabel": { "type": "string", "minLength": 1 }, "file": { "$ref": "#/$defs/path" }, "symbol": { "type": "string", "minLength": 1 }, "requirementIds": { "type": "array", "items": { "$ref": "#/$defs/requirementId" } }, "uiStates": { "type": "array", "items": { "type": "string", "minLength": 1 } } } } },
+    "evidenceGaps": { "type": "array", "items": { "$ref": "#/$defs/gap" } }
+  },
+  "$defs": {
+    "path": { "type": "string", "minLength": 1, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*\\\\).+$" },
+    "requirementId": { "type": "string", "pattern": "^(?:REQ|BR|AC)-[A-Z0-9]+(?:-[A-Z0-9]+)*$" },
+    "gap": { "type": "object", "additionalProperties": false, "required": ["description", "blocking"], "properties": { "requirementId": { "$ref": "#/$defs/requirementId" }, "description": { "type": "string", "minLength": 1 }, "blocking": { "type": "boolean" } } },
+    "sourceBinding": { "type": "object", "additionalProperties": false, "required": ["taskId", "requirementPath", "requirementSha256", "referencePaths", "requirementIds"], "properties": { "taskId": { "type": "string", "minLength": 1 }, "requirementPath": { "$ref": "#/$defs/path" }, "requirementSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "referencePaths": { "type": "array", "items": { "$ref": "#/$defs/path" } }, "requirementIds": { "type": "array", "items": { "$ref": "#/$defs/requirementId" } } } }
+  }
+}

package/docs/templates/frontend-task-constraints.md

@@ -1,35 +1,35 @@
-# 前端任务执行约束模板
-
-## 技术约束
-
-TODO
-
-## 代码风格约束
-
-TODO
-
-## 设计约束
-
-TODO
-
-## 验证约束
-
-TODO
-
-## Mock 约束（数据型任务）
-
-- Mock/API/schema 规范路径：TODO
-- 既有 Mock service root、handler/fixture/bootstrap：TODO
-- 既有 browser/e2e interception 或 request adapter/DI seam：TODO
-- 启动、健康检查和专项验证命令：TODO
-- production 禁用边界：TODO
-- 真实请求默认路径与 Mock 显式启用方式：TODO
-- `task.json.frontendMock.policy`：`auto | required | disabled`
-
-## allowedPaths
-
-TODO
-
-## forbiddenPaths
-
-TODO
+# 前端任务执行约束模板
+
+## 技术约束
+
+TODO
+
+## 代码风格约束
+
+TODO
+
+## 设计约束
+
+TODO
+
+## 验证约束
+
+TODO
+
+## Mock 约束（数据型任务）
+
+- Mock/API/schema 规范路径：TODO
+- 既有 Mock service root、handler/fixture/bootstrap：TODO
+- 既有 browser/e2e interception 或 request adapter/DI seam：TODO
+- 启动、健康检查和专项验证命令：TODO
+- production 禁用边界：TODO
+- 真实请求默认路径与 Mock 显式启用方式：TODO
+- `task.json.frontendMock.policy`：`auto | required | disabled`
+
+## allowedPaths
+
+TODO
+
+## forbiddenPaths
+
+TODO

package/docs/templates/frontend-task-requirement.md

@@ -1,70 +1,70 @@
-# 前端任务需求模板
-
-## 用户目标
-
-TODO
-
-## 目标页面/组件/路由
-
-TODO
-
-## 用户流程
-
-TODO
-
-## 必须状态
-
-### loading
-
-TODO
-
-### empty
-
-TODO
-
-### error
-
-TODO
-
-### success
-
-TODO
-
-### disabled
-
-TODO
-
-## 目标运行环境
-
-### desktop
-
-TODO
-
-### mobile
-
-TODO
-
-### tablet
-
-TODO
-
-## 交互要求
-
-TODO
-
-## 接口与 Mock 输入
-
-- 接口文档/schema：TODO
-- endpoint、method、关键请求/响应字段：TODO
-- 是否允许依赖真实后端：TODO
-- 是否要求离线或独立行为验证：TODO
-- success/empty/error/permission 状态：TODO
-- 后端当前就绪状态与 Real Integration Gap：TODO
-
-## 验收标准
-
-TODO
-
-## 非目标
-
-TODO
+# 前端任务需求模板
+
+## 用户目标
+
+TODO
+
+## 目标页面/组件/路由
+
+TODO
+
+## 用户流程
+
+TODO
+
+## 必须状态
+
+### loading
+
+TODO
+
+### empty
+
+TODO
+
+### error
+
+TODO
+
+### success
+
+TODO
+
+### disabled
+
+TODO
+
+## 目标运行环境
+
+### desktop
+
+TODO
+
+### mobile
+
+TODO
+
+### tablet
+
+TODO
+
+## 交互要求
+
+TODO
+
+## 接口与 Mock 输入
+
+- 接口文档/schema：TODO
+- endpoint、method、关键请求/响应字段：TODO
+- 是否允许依赖真实后端：TODO
+- 是否要求离线或独立行为验证：TODO
+- success/empty/error/permission 状态：TODO
+- 后端当前就绪状态与 Real Integration Gap：TODO
+
+## 验收标准
+
+TODO
+
+## 非目标
+
+TODO

package/docs/templates/frontend-test-dag.generate-cases.prompt.md

@@ -1,5 +1,5 @@
-# Generate frontend functional cases
-
-Use `playwright-cli-case-generator`. Read only `testcase/frontend/rag/context.md`, `coverage-map.md`, and existing `testcase/frontend/cases/`; write only that cases directory. Produce Markdown cases, `index.md`, and schema-version-1 `manifest.json`. Do not generate pytest or Playwright source code.
-
-Each case is independently executable and includes AC mapping, preconditions, session, cleanup, UI assertions, and isolated evidence paths. Use dimensions `core`, `boundary`, `flow`, or `backend`. Never guess API fields, constraints, SLA, credentials, or unrecorded data. The open command is exactly `playwright-cli open --browser=chrome --headed <base-url>`.
+# Generate frontend functional cases
+
+Use `playwright-cli-case-generator`. Read only `testcase/frontend/rag/context.md`, `coverage-map.md`, and existing `testcase/frontend/cases/`; write only that cases directory. Produce Markdown cases, `index.md`, and schema-version-1 `manifest.json`. Do not generate pytest or Playwright source code.
+
+Each case is independently executable and includes AC mapping, preconditions, session, cleanup, UI assertions, and isolated evidence paths. Use dimensions `core`, `boundary`, `flow`, or `backend`. Never guess API fields, constraints, SLA, credentials, or unrecorded data. The open command is exactly `playwright-cli open --browser=chrome --headed <base-url>`.

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

@@ -1,23 +1,23 @@
-{
-  "$schema": "./agent-dag.schema.json",
-  "version": 3,
-  "title": "Frontend test RAG DAG template",
-  "runtimeContract": { "schemaVersion": 1, "agentRuntime": "pi-only", "repairWriterProtocol": "explicit-node-v1" },
-  "objective": "Build a frontend test RAG package, generate Markdown cases, execute each case serially through playwright-cli, and retain browser evidence.",
-  "globalConstraints": [
-    "Do not generate pytest or Playwright source code.",
-    "Only use declared isolated test environments; production URLs and real credentials are blocked.",
-    "Every generated browser start command is playwright-cli open --browser=chrome --headed <base-url>.",
-    "Case children execute serially. Persist each case result, logs and browser evidence before the next child starts.",
-    "A token threshold is a post-case stop check, not a model hard token cap; unstarted cases must be recorded as blocked: token-budget-exhausted."
-  ],
-  "tasks": [
-    { "id": "retrieve-frontend-test-context-pi", "depends_on": [], "executor": "pi", "role": "planner", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/rag/**"], "allowedPaths": ["REPLACE/WITH/SOURCE/PATH/**", "testcase/frontend/rag/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "RAG context.md and coverage-map.md.", "subtask_prompt_markdown": "./frontend-test-dag.retrieve-context.prompt.md" },
-    { "id": "generate-frontend-functional-cases-pi", "depends_on": ["retrieve-frontend-test-context-pi"], "executor": "pi", "role": "implementer", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/cases/**"], "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Markdown cases, index.md and manifest.json schemaVersion 1; no test source code.", "subtask_prompt_markdown": "./frontend-test-dag.generate-cases.prompt.md" },
-    { "id": "review-frontend-cases-pi", "depends_on": ["generate-frontend-functional-cases-pi"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "First line VERDICT: pass or VERDICT: request-revision; no writes.", "subtask_prompt_markdown": "./frontend-test-dag.review-cases.prompt.md" },
-    { "id": "materialize-frontend-case-manifest-shell", "depends_on": ["review-frontend-cases-pi"], "executor": "shell", "role": "verifier", "complexity": "LOW", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "stdout exactly JSON { cases: [...] } after manifest validation.", "subtask_prompt": "Validate the generated frontend case manifest." },
-    { "id": "execute-frontend-cases-map", "depends_on": ["materialize-frontend-case-manifest-shell"], "executor": "static", "role": "verifier", "complexity": "LOW", "writePolicy": "none", "allowedPaths": [], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Serial aggregate of browser case results.", "subtask_prompt": "Expand the validated manifest into serial browser case children.", "static": { "resultMarkdown": "Frontend case map expansion barrier." }, "dynamicExpansion": { "type": "map_agent", "workflowNodeId": "execute-frontend-cases-map", "itemsFrom": "$.nodes['materialize-frontend-case-manifest-shell'].output.cases", "itemName": "case", "maxItems": 20, "maxExpandedNodes": 20, "childIdPrefix": "execute-frontend-case", "tokenBudget": { "maxTokensPerCase": 20000, "maxTotalTokens": 200000 }, "childTask": { "executor": "pi", "role": "verifier", "skills": ["playwright-cli", "webapp-testing"], "toolProfile": "write", "complexity": "MED", "subtaskPromptTemplate": "Execute {{case.caseId}} from {{case.casePath}} in a fresh Pi session. Use playwright-cli open --browser=chrome --headed <base-url>. Persist result, logs and screenshots/trace/video under {{case.evidenceDir}}; return compact JSON only.", "outputContract": "Compact JSON <=1200 chars.", "writePolicy": "exclusive", "allowedPaths": ["testcase/frontend/cases/{{case.caseId}}.md", "testcase/frontend/rag/context.md", "testcase/frontend/rag/coverage-map.md", "testcase/frontend/evidence/{{case.caseId}}/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "writeSet": ["testcase/frontend/evidence/{{case.caseId}}/**"] } } },
-    { "id": "review-frontend-execution-pi", "depends_on": ["execute-frontend-cases-map"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "AC-to-case-to-browser-evidence review.", "subtask_prompt_markdown": "./frontend-test-dag.review-execution.prompt.md" },
-    { "id": "frontend-test-retrospect-pi", "depends_on": ["review-frontend-execution-pi"], "executor": "pi", "role": "closeout", "toolProfile": "write", "complexity": "MED", "writePolicy": "exclusive", "writeSet": ["docs/test-reports/**"], "allowedPaths": ["testcase/frontend/**", "docs/test-reports/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Frontend test retrospective with A/B/C/D rating.", "subtask_prompt_markdown": "./frontend-test-dag.retrospect.prompt.md" }
-  ]
-}
+{
+  "$schema": "./agent-dag.schema.json",
+  "version": 3,
+  "title": "Frontend test RAG DAG template",
+  "runtimeContract": { "schemaVersion": 1, "agentRuntime": "pi-only", "repairWriterProtocol": "explicit-node-v1" },
+  "objective": "Build a frontend test RAG package, generate Markdown cases, execute each case serially through playwright-cli, and retain browser evidence.",
+  "globalConstraints": [
+    "Do not generate pytest or Playwright source code.",
+    "Only use declared isolated test environments; production URLs and real credentials are blocked.",
+    "Every generated browser start command is playwright-cli open --browser=chrome --headed <base-url>.",
+    "Case children execute serially. Persist each case result, logs and browser evidence before the next child starts.",
+    "A token threshold is a post-case stop check, not a model hard token cap; unstarted cases must be recorded as blocked: token-budget-exhausted."
+  ],
+  "tasks": [
+    { "id": "retrieve-frontend-test-context-pi", "depends_on": [], "executor": "pi", "role": "planner", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/rag/**"], "allowedPaths": ["REPLACE/WITH/SOURCE/PATH/**", "testcase/frontend/rag/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "RAG context.md and coverage-map.md.", "subtask_prompt_markdown": "./frontend-test-dag.retrieve-context.prompt.md" },
+    { "id": "generate-frontend-functional-cases-pi", "depends_on": ["retrieve-frontend-test-context-pi"], "executor": "pi", "role": "implementer", "toolProfile": "write", "complexity": "HIGH", "writePolicy": "exclusive", "writeSet": ["testcase/frontend/cases/**"], "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Markdown cases, index.md and manifest.json schemaVersion 1; no test source code.", "subtask_prompt_markdown": "./frontend-test-dag.generate-cases.prompt.md" },
+    { "id": "review-frontend-cases-pi", "depends_on": ["generate-frontend-functional-cases-pi"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/rag/**", "testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "First line VERDICT: pass or VERDICT: request-revision; no writes.", "subtask_prompt_markdown": "./frontend-test-dag.review-cases.prompt.md" },
+    { "id": "materialize-frontend-case-manifest-shell", "depends_on": ["review-frontend-cases-pi"], "executor": "shell", "role": "verifier", "complexity": "LOW", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/cases/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "stdout exactly JSON { cases: [...] } after manifest validation.", "subtask_prompt": "Validate the generated frontend case manifest." },
+    { "id": "execute-frontend-cases-map", "depends_on": ["materialize-frontend-case-manifest-shell"], "executor": "static", "role": "verifier", "complexity": "LOW", "writePolicy": "none", "allowedPaths": [], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Serial aggregate of browser case results.", "subtask_prompt": "Expand the validated manifest into serial browser case children.", "static": { "resultMarkdown": "Frontend case map expansion barrier." }, "dynamicExpansion": { "type": "map_agent", "workflowNodeId": "execute-frontend-cases-map", "itemsFrom": "$.nodes['materialize-frontend-case-manifest-shell'].output.cases", "itemName": "case", "maxItems": 20, "maxExpandedNodes": 20, "childIdPrefix": "execute-frontend-case", "tokenBudget": { "maxTokensPerCase": 20000, "maxTotalTokens": 200000 }, "childTask": { "executor": "pi", "role": "verifier", "skills": ["playwright-cli", "webapp-testing"], "toolProfile": "write", "complexity": "MED", "subtaskPromptTemplate": "Execute {{case.caseId}} from {{case.casePath}} in a fresh Pi session. Use playwright-cli open --browser=chrome --headed <base-url>. Persist result, logs and screenshots/trace/video under {{case.evidenceDir}}; return compact JSON only.", "outputContract": "Compact JSON <=1200 chars.", "writePolicy": "exclusive", "allowedPaths": ["testcase/frontend/cases/{{case.caseId}}.md", "testcase/frontend/rag/context.md", "testcase/frontend/rag/coverage-map.md", "testcase/frontend/evidence/{{case.caseId}}/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "writeSet": ["testcase/frontend/evidence/{{case.caseId}}/**"] } } },
+    { "id": "review-frontend-execution-pi", "depends_on": ["execute-frontend-cases-map"], "executor": "pi", "role": "reviewer", "complexity": "HIGH", "writePolicy": "read-only", "allowedPaths": ["testcase/frontend/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "AC-to-case-to-browser-evidence review.", "subtask_prompt_markdown": "./frontend-test-dag.review-execution.prompt.md" },
+    { "id": "frontend-test-retrospect-pi", "depends_on": ["review-frontend-execution-pi"], "executor": "pi", "role": "closeout", "toolProfile": "write", "complexity": "MED", "writePolicy": "exclusive", "writeSet": ["docs/test-reports/**"], "allowedPaths": ["testcase/frontend/**", "docs/test-reports/**"], "forbiddenPaths": [".harness/**", "artifacts/**"], "outputContract": "Frontend test retrospective with A/B/C/D rating.", "subtask_prompt_markdown": "./frontend-test-dag.retrospect.prompt.md" }
+  ]
+}

package/docs/templates/frontend-test-dag.retrieve-context.prompt.md

@@ -1,3 +1,3 @@
-# Retrieve frontend test context
-
-Write only `testcase/frontend/rag/context.md` and `coverage-map.md`. Record traceable facts from the task source, routes, components, API/Mock contracts, existing tests and execution contract. Do not invent fields, credentials, limits or test data.
+# Retrieve frontend test context
+
+Write only `testcase/frontend/rag/context.md` and `coverage-map.md`. Record traceable facts from the task source, routes, components, API/Mock contracts, existing tests and execution contract. Do not invent fields, credentials, limits or test data.

package/docs/templates/frontend-test-dag.retrospect.prompt.md

@@ -1,3 +1,3 @@
-# Frontend test retrospective
-
-Write a dated report under `docs/test-reports/` covering case coverage, passed/failed/blocked results, review findings, browser anomalies, residual risks, and an A/B/C/D maturity rating. Blocked cases never count as passed.
+# Frontend test retrospective
+
+Write a dated report under `docs/test-reports/` covering case coverage, passed/failed/blocked results, review findings, browser anomalies, residual risks, and an A/B/C/D maturity rating. Blocked cases never count as passed.

package/docs/templates/frontend-test-dag.review-cases.prompt.md

@@ -1,3 +1,3 @@
-# Review frontend cases
-
-Read the RAG files and Markdown cases only. First line must be `VERDICT: pass` or `VERDICT: request-revision`. Report AC coverage, case independence, evidence completeness, unsafe environment/data dependencies, and manifest issues. The verdict is advisory and does not block browser execution.
+# Review frontend cases
+
+Read the RAG files and Markdown cases only. First line must be `VERDICT: pass` or `VERDICT: request-revision`. Report AC coverage, case independence, evidence completeness, unsafe environment/data dependencies, and manifest issues. The verdict is advisory and does not block browser execution.

package/docs/templates/frontend-test-dag.review-execution.prompt.md

@@ -1,3 +1,3 @@
-# Review frontend execution evidence
-
-Review AC → case → browser-evidence traceability. A passed case needs assertions and screenshot or equivalent browser evidence. Failed and blocked cases need an explicit cause. Treat `token-budget-exhausted` as blocked; do not substitute model conclusions or static checks for browser evidence.
+# Review frontend execution evidence
+
+Review AC → case → browser-evidence traceability. A passed case needs assertions and screenshot or equivalent browser evidence. Failed and blocked cases need an explicit cause. Treat `token-budget-exhausted` as blocked; do not substitute model conclusions or static checks for browser evidence.