@tea-agent/loop-agent 0.39.0-next.30 → 0.39.0-next.31

package/skills/fe-test-ui-scout/references/ledger-schema.md

@@ -0,0 +1,62 @@
+# 台账（ui-anchors.md）表结构与分节规则
+
+## 文件位置与命名
+
+- 路径：`testcase/frontend/rag/ui-anchors.md`
+- 编码：UTF-8，LF；表格用 GitHub Flavored Markdown。
+- 台账是**增量账本**：修订不删除历史行；失效行改状态列并注明原因。
+
+## 顶层结构
+
+```markdown
+# UI 锚点台账（frontend-test）
+
+- baseUrl：<验证时的绝对 URL>
+- 更新时间：<YYYY-MM-DD HH:mm（本地时区）>
+- 维护：fe-test-ui-scout skill
+
+## <页面路由> · <状态>
+
+| 字面（find 原文） | 命中 | 唯一 | 控件/位置 | 状态 | 备注 | 验证时间 |
+| --- | --- | --- | --- | --- | --- | --- |
+| 后端研发（默认 DAG） | 1 | 是 | workflow-kind-select option | 有效 | 括号必须带全 | 2026-08-22 15:00 |
+```
+
+## 分节规则
+
+- 一节 = 一个「页面路由 × 状态」组合。路由用 hash 形式（`#/tasks`、
+  `#/chat`、`/inspect/#/dags`）；状态至少区分：
+  - `no-session`（无会话 landing）
+  - `has-session`（已存在会话，composer 可见）
+  - `empty-session`（新建空会话，无消息）
+  - 页面特有态（如 `#/night · 无计划`、`#/recovery · 无候选`、
+    setup-required）随需追加，节名写清楚。
+- 同一页面多个状态各自成节；不要把跨状态结果合并进一行。
+
+## 列语义
+
+| 列 | 说明 |
+| --- | --- |
+| 字面（find 原文） | `playwright-cli find "<字面>"` 的唯一入参原文，逐字节照抄（含括号、空格、中点） |
+| 命中 | 侦察时 `find` 实际返回的匹配数（0/1/N） |
+| 唯一 | 是/否/不适用；命中=1 且作用于目标控件才算「是」 |
+| 控件/位置 | 命中元素的角色与位置（如 `h2`、`oc-suggestion strong`、`aria-label`） |
+| 状态 | `有效` / `失效` / `待复核`；失效须在备注注明原因与替代字面 |
+| 备注 | 陷阱与前置：拆节点（kbd+span、text+code）、同名多控件、aria-label≠可见文本、状态前置、setup 门 |
+| 验证时间 | YYYY-MM-DD HH:mm |
+
+## 有效 / 失效判定
+
+- **有效**：命中=1、目标控件、字面在当前 build 下可复现。
+- **不可断言**：命中 0（字面不存在或被拆节点）、命中 >1 且状态/作用域
+  无法区分（如「发送」同时命中 tips 与按钮）。这类行保留在台账里，
+  状态列写 `不可断言`，备注写原因——它们正是 PRD 的「禁用清单」。
+- **失效**：页面改版后不再命中。不删行，改状态 + 备注（替代字面是什么）。
+
+## 与 PRD / 目录的关系
+
+- PRD 每条 `find "..."` 断言的字面必须出自台账某行且该行状态为
+  `有效`（或备注给出拆节点断言替代方案，如 `find "taskKind="` 与
+  `find "frontend-test"` 二选一）。
+- 目录 AC 的 live 校准注记引用台账行（日期 + 路由+状态），保持
+  「AC ↔ 台账」双向可追溯。

package/skills/fe-test-ui-scout/references/recon-protocol.md

@@ -0,0 +1,54 @@
+# 逐状态侦察操作协议与陷阱清单
+
+## 前置检查
+
+1. 确认 SUT 健康：`curl -s -o /dev/null -w '%{http_code}' <baseUrl>/api/health`
+   返回 200；非 200 先解决环境，不侦察。
+2. 确认 SUT 跑的是当前 build（改过 `src/**` 后必须 `npm run build` 并重启
+   SUT，否则台账记录的是旧页面）。
+3. 准备隔离 app-data（SUT 启动参数已带 `/tmp` 隔离目录时无需额外动作）；
+   侦察结束把 no-session 状态还原（关闭页面即可；若点了「新建空白对话」
+   产生空会话，记录在案即可，不必清理 app-data）。
+
+## 每个页面 × 状态的标准动作序列
+
+```text
+playwright-cli open --browser=chrome <baseUrl>/#/<route>
+playwright-cli snapshot
+playwright-cli find "<候选字面 1>"
+playwright-cli find "<候选字面 2>"
+...
+playwright-cli close
+```
+
+- `snapshot` 先行：从 snapshot 里核对候选字面的真实渲染形态（是否拆节点、
+  是否 aria-label、是否在折叠组内需先展开）。
+- 每个候选字面必须真实 `find` 一次；snapshot 里「看起来有」不算数。
+- 折叠组（如「工程边界（可选，人类确认）」）：先记录折叠态的组标题字面，
+  再展开后侦察组内字段；两种形态分两行记。
+- 需要状态夹具的节（has-session）：点一次「新建空白对话」CTA 进入；
+  这是协议允许的唯一写动作。
+
+## 陷阱清单（出现即写进备注列）
+
+| 陷阱 | 症状 | 台账记法 |
+| --- | --- | --- |
+| 拆节点 | `find "Enter 发送"` 0 命中；DOM 是 `<kbd>Enter</kbd><span>发送</span>` | 字面行记完整原文 + 命中 0 + 状态 `不可断言`；备注给出替代（`find "发送"` 或 `find "Enter"`）并说明拆法 |
+| text+code 拆分 | `taskKind=frontend-test` 渲染为 `taskKind=` + `<code>frontend-test</code>` | 同上 |
+| 同名多控件 | 「发送」同时命中 tips span 与发送按钮 aria-label | 命中 N>1，唯一=否；备注指明各自位置，PRD 需换更独特字面或限定状态 |
+| 同名多行按钮（列表态） | 「重命名会话」在 3 行会话各自命中 1，全局命中 3；单会话态侦察时命中 1 | 备注标「会话数依赖」；断言法降级为 hover 目标行 → snapshot 解析该行真实 ref（存在即通过），禁止声明 find 命中数=1；或确保夹具为单行态（清 app-data） |
+| aria-label ≠ 可见文本 | 控件可访问名是 aria-label，渲染文本不同 | 字面列记 aria-label 值，备注「aria-label；可见文本为 X」 |
+| 无名 flex 子项 | flex 匿名文本无 name-from-content，find 不到 | 记录控件缺 aria-label → 这是**产品可修问题**，报告给修复决策树（页面象限），台账暂记 `不可断言` |
+| 括号/全半角 | 「后端研发（默认 DAG）」少括号 0 命中 | 字面逐字节照抄；备注提醒 |
+| 状态前置 | 控件只在 has-session / setup-required 等状态下存在 | 分节记录；PRD 引用时必须声明状态夹具 |
+| 折叠组 | 字面在 `<details>` 内，未展开时 find 0 | 两种形态分行记录（折叠标题/展开后字段） |
+| 瞬态文案 | 「正在加载…」类短暂存在 | 备注标「瞬态」，PRD 不引用 |
+
+## 输出纪律
+
+- find 命中数以工具返回为准，不目测。
+- 每节侦察完立即写台账（不攒到最后凭记忆写）。
+- 侦察小结按 SKILL.md 第 5 步输出：新增/修订/失效行数、命中率、
+  PRD 可用锚点清单与禁用清单。
+- 发现疑似产品缺陷（白屏、文案缺失、aria 错误）：记入小结的「移交修复」
+  段，不在台账内修，不因缺陷跳过其余候选字面的侦察。

package/skills/playwright-cli/SKILL.md

@@ -25,6 +25,7 @@ close
 goto
 snapshot
 find
+find-unique
 click
 dblclick
 fill
@@ -71,6 +72,16 @@ playwright-cli close
 普通交互和控制台输出均不能单独取得 passed authority。通过的 case 还需要同一 child 的有序
 controller receipts：successful `open` → successful `find` → successful post-execution cleanup。
 
+### 唯一性断言优先用 find-unique
+
+当语义要求「全页恰好一个」时，用 `playwright-cli find-unique "字面"` 代替人工数命中数：它内部
+执行 find 并在解析命中数 ≠ 1 时以非零退出码失败（零命中/多命中/输出不可解析均 fail），错误
+信息直接给出 `expected exactly 1 match, got N`。它只接受一个文本字面量、不接受 `--regex` 等
+flag。台账中标注 `==1` 的锚点、以及「唯一命中」类 AC 应优先用它；`>=N` 存在性断言仍用
+`find`（find-unique 会拒绝多命中）。controller 会解析两类命令的命中数写入 receipt，finalize
+时用 case 文档声明的 `find "字面" >=N / ==N` 对照 receipt 复核，缺失或不满足会把 passed
+降级为 blocked（assertion-not-receipt-backed），因此声明的断言必须真的执行。
+
 ## 受限证据采集
 
 - UI 状态：先 `snapshot`，完成交互后以成功 `find` 证明用户可见结果。
@@ -91,3 +102,14 @@ controller receipts：successful `open` → successful `find` → successful pos
 当环境、数据、权限、时序、异常路径或响应内容无法用 RAG、已验证 context URL 和 runtime allowlist 证明时，
 写入 `blocked` evidence，并提供具体 `blockedReason`。不要引入替代执行路径，也不要把隐藏状态或
 未观察到的网络结果当作通过证据。
+
+### 唯一控件早停（unique-control-unavailable）
+
+- 适用：AC 点名的具体控件在到达目标状态后的**首个 post-navigation snapshot** 中缺失，且页面没有
+  setup-required 门（如「需先完成 Pi setup」）。
+- 判定：用 case 给出的字面做**单次** `find`；返回 0 命中即为充分证据，直接写
+  `status=blocked`、`blockedReason=unique-control-unavailable`，在 execution.md 中引用该次 find 结果。
+- 禁止：换字面重试、反复 snapshot、绕路导航、多轮探索或请求 rerun。这些都产生无放大的 token
+  成本且不改变结论（Wave 3 教训：反复探测不存在控件耗掉约 717k input tokens）。
+- 若 snapshot 显示存在 setup-required 门或状态前置未满足，按其对应 blockedReason 记录
+  （环境/状态类），不属于本早停。

package/skills/playwright-cli-case-generator/SKILL.md

@@ -14,11 +14,21 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
 ## 输入与边界
 
 - 只读取 `testcase/frontend/rag/context.md`、`coverage-map.md` 与已有 `testcase/frontend/cases/`。
+- 若存在 `testcase/frontend/rag/ui-anchors.md` 锚点台账，必须一并读取并作为 UI 断言的唯一事实源；台账缺失时按 RAG 知识包生成，但不得引用台账外的具体控件字面（缺失信息标 `blocked`）。
 - 只写 `testcase/frontend/cases/**`；不得回读 PRD、读取 `.harness/`，或写
   `testcase/frontend/evidence/**`。
 - 所有 API、字段限制、状态流转、数据来源、SLA、URL 与账号要求必须能在 RAG 知识包中追溯。
   缺失信息标记 `blocked` 或“需人工确认”，不得猜测。
 
+### 锚点台账规则（存在 ui-anchors.md 时）
+
+- case 中每条拟通过的 `find "<字面>"` 断言必须能在台账对应「页面 × 状态」节找到
+  状态为 `有效` 的行；台账 `不可断言` / `失效` 行的字面**禁止**作为通过断言。
+- AC 点名的控件在台账对应状态节缺失（0 命中或无行）时，该 AC 的 case 生成
+  `blocked` 语义说明（或从本批剔除该 AC），`blockedReason` 用
+  `unique-control-unavailable`，不得生成探测性步骤反复 find。
+- 台账行备注中的替代断言方案（如拆节点后的短字面二选一）按备注执行。
+
 ## 输出
 
 - 写 `index.md`、`manifest.draft.json`（生成阶段；materialize 会写成 `manifest.json`）与独立 case 文件
@@ -51,7 +61,16 @@ description: 根据 FE-test RAG 知识包生成可由受限 playwright_cli runti
    占位符仅表示从紧邻其前、最新一次 `snapshot` 输出解析出的真实 `eNN` ref。生成的 case 必须在每次
    引用元素前写明 fresh snapshot；`eX`/`eY` 不是可传给 structured tool 的 literal ref，新的 snapshot
    会使旧 ref 失效，不得复用 stale ref。
-5. 明确的 UI/API 预期与数据清理结果；无法满足的环境或数据依赖必须写为 `blocked`。
+5. **期望命中数不得内联进命令行（硬约束）**：如需声明 find 期望命中数，写在「预期结果」区或
+   列表项的说明文字中（如 “预期唯一命中”）；命令行只写纯命令 `playwright-cli find "<字面>"`。
+   禁止 `find "<字面>">=N`、`≥N`、`（≥N）` 等计数后缀内联进命令 token。
+6. **唯一性断言优先 find-unique**：台账或 AC 标注 `==1`/「唯一命中」的锚点，生成
+   `playwright-cli find-unique "<字面>"`（仅一个文本字面量，无 flag；多命中/零命中即命令失败）；
+   `>=N` 存在性断言仍用 `find`。finalize 会用 case 文档中 `find "字面" >=N / ==N` 声明对照
+   controller receipt 的解析命中数复核，声明的断言未真正执行或命中数不满足会把 passed 降级为
+   blocked（assertion-not-receipt-backed）——因此「测试点」里声明的每个 find 断言都必须在步骤中
+   真实执行且字面完全一致。
+7. 明确的 UI/API 预期与数据清理结果；无法满足的环境或数据依赖必须写为 `blocked`。
 
 所有文件型输出均由 controller 绑定到执行节点提供的
 `testcase/frontend/evidence/<case-id>/` 工作目录。截图一律使用 canonical 语法

package/dist/worker/console/static/assets/channel-DMvu1nmi.js

@@ -1 +0,0 @@
-import{ag as o,ah as n}from"./mermaid.core-C1cSavOy.js";const t=(a,r)=>o.lang.round(n.parse(a)[r]);export{t as c};

package/dist/worker/console/static/assets/classDiagram-JCYQIIEL-DVzM-02m.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-DklNc7dm.js";import{_ as i}from"./mermaid.core-C1cSavOy.js";import"./chunk-5VM5RSS4-BF57lhXj.js";import"./chunk-XXDRQBXY-B0JK51NT.js";import"./chunk-KBJHAD2P-BBgLqV4h.js";import"./chunk-2GRJ4B5K-DbYr-Cxy.js";import"./index-C2jmYBfu.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist/worker/console/static/assets/classDiagram-v2-OCEON4UE-DVzM-02m.js

@@ -1 +0,0 @@
-import{s as a,c as s,a as e,C as t}from"./chunk-GF5L2VYU-DklNc7dm.js";import{_ as i}from"./mermaid.core-C1cSavOy.js";import"./chunk-5VM5RSS4-BF57lhXj.js";import"./chunk-XXDRQBXY-B0JK51NT.js";import"./chunk-KBJHAD2P-BBgLqV4h.js";import"./chunk-2GRJ4B5K-DbYr-Cxy.js";import"./index-C2jmYBfu.js";var n={parser:e,get db(){return new t},renderer:s,styles:a,init:i(r=>{r.class||(r.class={}),r.class.arrowMarkerAbsolute=r.arrowMarkerAbsolute},"init")};export{n as diagram};

package/dist/worker/console/static/assets/stateDiagram-v2-UEYNNEHI-BwecGAkM.js

@@ -1 +0,0 @@
-import{s as r,b as e,a,S as s}from"./chunk-5RXB4S5H-BtcKAj9i.js";import{_ as i}from"./mermaid.core-C1cSavOy.js";import"./chunk-XXDRQBXY-B0JK51NT.js";import"./chunk-KBJHAD2P-BBgLqV4h.js";import"./chunk-2GRJ4B5K-DbYr-Cxy.js";import"./index-C2jmYBfu.js";var u={parser:a,get db(){return new s(2)},renderer:e,styles:r,init:i(t=>{t.state||(t.state={}),t.state.arrowMarkerAbsolute=t.arrowMarkerAbsolute},"init")};export{u as diagram};

package/dist/worker/console/static/assets/swimlanesDiagram-ULZ7WXOC-D5WW_LbN.js

@@ -1,8 +0,0 @@
-import{c as r,s as e}from"./flowDiagram-UKHOOZJN-BXrfDo8y.js";import{_ as a}from"./mermaid.core-C1cSavOy.js";import"./chunk-5VM5RSS4-BF57lhXj.js";import"./chunk-XXDRQBXY-B0JK51NT.js";import"./chunk-KBJHAD2P-BBgLqV4h.js";import"./chunk-2GRJ4B5K-DbYr-Cxy.js";import"./channel-DMvu1nmi.js";import"./index-C2jmYBfu.js";var o=a(t=>`${e(t)}
-  .swimlane.cluster rect {
-    stroke: ${t.clusterBorder} !important;
-  }
-  [data-look="neo"].cluster rect {
-    filter: none;
-  }
-`,"getStyles"),s=o,n=r({defaultLayout:"swimlane",styles:s});export{n as diagram};