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

package/docs/templates/frontend-design-contract.md

@@ -1,33 +1,42 @@
-# 前端设计契约模板
-
-## 页面目标
-
-TODO
-
-## 信息结构
-
-TODO
-
-## 组件拆分
-
-TODO
-
-## 交互规则
-
-TODO
-
-## UI 状态
-
-TODO
-
-## 样式与设计系统映射
-
-TODO
-
-## 响应式范围
-
-TODO
-
-## 风险与非目标
-
-TODO
+# 前端设计契约模板
+
+## 页面目标
+
+TODO
+
+## 信息结构
+
+TODO
+
+## 组件拆分
+
+TODO
+
+## 交互规则
+
+TODO
+
+## UI 状态
+
+TODO
+
+## Mock / API 策略
+
+- 接口文档或 schema：TODO
+- 策略：`native | browser-intercept | request-adapter | not-needed | blocked`
+- endpoint / fixture / UI 状态映射：TODO
+- 显式启用方式与 production 默认关闭边界：TODO
+- DAG 已固化的验证入口：TODO
+- Real Integration Gap 与后端就绪后的复验：TODO
+
+## 样式与设计系统映射
+
+TODO
+
+## 响应式范围
+
+TODO
+
+## 风险与非目标
+
+TODO

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

@@ -1,25 +1,35 @@
-# 前端任务执行约束模板
-
-## 技术约束
-
-TODO
-
-## 代码风格约束
-
-TODO
-
-## 设计约束
-
-TODO
-
-## 验证约束
-
-TODO
-
-## 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,61 +1,70 @@
-# 前端任务需求模板
-
-## 用户目标
-
-TODO
-
-## 目标页面/组件/路由
-
-TODO
-
-## 用户流程
-
-TODO
-
-## 必须状态
-
-### loading
-
-TODO
-
-### empty
-
-TODO
-
-### error
-
-TODO
-
-### success
-
-TODO
-
-### disabled
-
-TODO
-
-## 目标运行环境
-
-### desktop
-
-TODO
-
-### mobile
-
-TODO
-
-### tablet
-
-TODO
-
-## 交互要求
-
-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

@@ -0,0 +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>`.

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

@@ -0,0 +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" }
+  ]
+}

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

@@ -0,0 +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.

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

@@ -0,0 +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.

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

@@ -0,0 +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.

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

@@ -0,0 +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.