@tea-agent/loop-agent 0.26.0 → 0.26.2

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

@@ -1,42 +1,42 @@
-# 前端设计契约模板
-
-## 页面目标
-
-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
+# 前端设计契约模板
+
+## 页面目标
+
+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-eval/fixtures/failures/01-type-build-error.md

@@ -1,17 +1,17 @@
-# Failure fixture: type / build error
-
-- **fixtureId**: `fe-fail-type-build-error`
-- **triggerSignal**: `frontend-static-verify-shell` 非零（tsc 或 build 失败）
-- **expectedGateBehavior**: static 失败阻断 behavior/review 成功路径；不得 closeout pass
-- **repairable (M3 预标注)**: `repairable`（局部类型/导入修复）
-- **Browser**: 不得宣称 Browser 证据
-
-## 场景
-
-Writer 引入错误 prop 类型或缺失导出，导致 typecheck/build 失败。
-
-## 期望
-
-- 新鲜 stdout/stderr 归档
-- review 不得在 static 失败时 VERDICT: pass
-- M3：可进入 bounded repair；M0 仅记录
+# Failure fixture: type / build error
+
+- **fixtureId**: `fe-fail-type-build-error`
+- **triggerSignal**: `frontend-static-verify-shell` 非零（tsc 或 build 失败）
+- **expectedGateBehavior**: static 失败阻断 behavior/review 成功路径；不得 closeout pass
+- **repairable (M3 预标注)**: `repairable`（局部类型/导入修复）
+- **Browser**: 不得宣称 Browser 证据
+
+## 场景
+
+Writer 引入错误 prop 类型或缺失导出，导致 typecheck/build 失败。
+
+## 期望
+
+- 新鲜 stdout/stderr 归档
+- review 不得在 static 失败时 VERDICT: pass
+- M3：可进入 bounded repair；M0 仅记录

package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md

@@ -1,16 +1,16 @@
-# Failure fixture: unit/component test fail
-
-- **fixtureId**: `fe-fail-unit-component-test`
-- **triggerSignal**: `frontend-behavior-verify-shell` 非零（vitest 断言失败）
-- **expectedGateBehavior**: behavior 失败 → review 不得 pass；closeout 阻断
-- **repairable (M3 预标注)**: `repairable`
-- **Browser**: not-run；不得用「应在浏览器正常」抵消
-
-## 场景
-
-组件测试期望文案/状态与实现不一致。
-
-## 期望
-
-- 失败命令为生成期冻结入口
-- 禁止删测 / `.skip` 伪装通过（review 应标 Important）
+# Failure fixture: unit/component test fail
+
+- **fixtureId**: `fe-fail-unit-component-test`
+- **triggerSignal**: `frontend-behavior-verify-shell` 非零（vitest 断言失败）
+- **expectedGateBehavior**: behavior 失败 → review 不得 pass；closeout 阻断
+- **repairable (M3 预标注)**: `repairable`
+- **Browser**: not-run；不得用「应在浏览器正常」抵消
+
+## 场景
+
+组件测试期望文案/状态与实现不一致。
+
+## 期望
+
+- 失败命令为生成期冻结入口
+- 禁止删测 / `.skip` 伪装通过（review 应标 Important）

package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md

@@ -1,16 +1,16 @@
-# Failure fixture: fixture schema drift vs API contract
-
-- **fixtureId**: `fe-fail-fixture-schema-drift`
-- **triggerSignal**: Mock fixture 字段与接口文档冲突；design gate 或 review 发现；或 mock 专项测试失败
-- **expectedGateBehavior**: design request-revision 或 review request-revision；不得发明字段硬通过
-- **repairable (M3 预标注)**: `non-repairable` 若根因是 spec 冲突未裁决；局部拼写且 contract 已明确时可为 repairable
-- **Browser**: not-run
-
-## 场景
-
-Handler 返回 `userName` 而契约为 `name`。
-
-## 期望
-
-- Mock assess / design 要求 contract-aligned
-- closeout 不得宣称真实联调成功
+# Failure fixture: fixture schema drift vs API contract
+
+- **fixtureId**: `fe-fail-fixture-schema-drift`
+- **triggerSignal**: Mock fixture 字段与接口文档冲突；design gate 或 review 发现；或 mock 专项测试失败
+- **expectedGateBehavior**: design request-revision 或 review request-revision；不得发明字段硬通过
+- **repairable (M3 预标注)**: `non-repairable` 若根因是 spec 冲突未裁决；局部拼写且 contract 已明确时可为 repairable
+- **Browser**: not-run
+
+## 场景
+
+Handler 返回 `userName` 而契约为 `name`。
+
+## 期望
+
+- Mock assess / design 要求 contract-aligned
+- closeout 不得宣称真实联调成功

package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md

@@ -1,16 +1,16 @@
-# Failure fixture: missing loading/empty/error state
-
-- **fixtureId**: `fe-fail-missing-ui-states`
-- **triggerSignal**: plan/design 或 review 发现 applicable 异步列表缺少 loading/empty/error
-- **expectedGateBehavior**: first/final design 应 request-revision；若漏到实现则 review request-revision
-- **repairable (M3 预标注)**: `repairable`（补状态 UI + 测试）
-- **Browser**: not-run
-
-## 场景
-
-仅实现 success 列表渲染。
-
-## 期望
-
-- design checklist 含 UI States
-- M1 合同将强制 applicable states 映射
+# Failure fixture: missing loading/empty/error state
+
+- **fixtureId**: `fe-fail-missing-ui-states`
+- **triggerSignal**: plan/design 或 review 发现 applicable 异步列表缺少 loading/empty/error
+- **expectedGateBehavior**: first/final design 应 request-revision；若漏到实现则 review request-revision
+- **repairable (M3 预标注)**: `repairable`（补状态 UI + 测试）
+- **Browser**: not-run
+
+## 场景
+
+仅实现 success 列表渲染。
+
+## 期望
+
+- design checklist 含 UI States
+- M1 合同将强制 applicable states 映射

package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md

@@ -1,16 +1,16 @@
-# Failure fixture: forbidden write / writeSet expansion attempt
-
-- **fixtureId**: `fe-fail-forbidden-write`
-- **triggerSignal**: writer 试图修改 writeSet 外路径或 forbiddenPaths（如 `src/**` 任务写入 `package.json`）
-- **expectedGateBehavior**: write-guard 拒绝；run 失败或 NeedsAction；不得当成功 closeout
-- **repairable (M3 预标注)**: `non-repairable`（路径/authority；不得靠 repair 扩大 writeSet）
-- **Browser**: not-run
-
-## 场景
-
-实现中「顺手」改根配置或越界文档。
-
-## 期望
-
-- exclusive writeSet 强制
-- M0 eval 计入 `forbidden_write_count`
+# Failure fixture: forbidden write / writeSet expansion attempt
+
+- **fixtureId**: `fe-fail-forbidden-write`
+- **triggerSignal**: writer 试图修改 writeSet 外路径或 forbiddenPaths（如 `src/**` 任务写入 `package.json`）
+- **expectedGateBehavior**: write-guard 拒绝；run 失败或 NeedsAction；不得当成功 closeout
+- **repairable (M3 预标注)**: `non-repairable`（路径/authority；不得靠 repair 扩大 writeSet）
+- **Browser**: not-run
+
+## 场景
+
+实现中「顺手」改根配置或越界文档。
+
+## 期望
+
+- exclusive writeSet 强制
+- M0 eval 计入 `forbidden_write_count`

package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md

@@ -1,16 +1,16 @@
-# Failure fixture: unapproved dependency add
-
-- **fixtureId**: `fe-fail-unapproved-dependency`
-- **triggerSignal**: diff 出现未授权 `package.json` / lockfile 依赖新增
-- **expectedGateBehavior**: design 应预先拒绝；若发生则 review Important + request-revision；任务 forbidden 含 package 时 write-guard 阻断
-- **repairable (M3 预标注)**: `non-repairable`（依赖策略/人工批准）
-- **Browser**: not-run
-
-## 场景
-
-为方便引入大型 UI 库未在计划 Dependency Policy 批准。
-
-## 期望
-
-- 计入 `unapproved_dependency_count`
-- 不得以 build 通过单独放行
+# Failure fixture: unapproved dependency add
+
+- **fixtureId**: `fe-fail-unapproved-dependency`
+- **triggerSignal**: diff 出现未授权 `package.json` / lockfile 依赖新增
+- **expectedGateBehavior**: design 应预先拒绝；若发生则 review Important + request-revision；任务 forbidden 含 package 时 write-guard 阻断
+- **repairable (M3 预标注)**: `non-repairable`（依赖策略/人工批准）
+- **Browser**: not-run
+
+## 场景
+
+为方便引入大型 UI 库未在计划 Dependency Policy 批准。
+
+## 期望
+
+- 计入 `unapproved_dependency_count`
+- 不得以 build 通过单独放行

package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md

@@ -1,21 +1,21 @@
-# Failure fixture: Mock production-on / real-request commented out
-
-- **fixtureId**: `fe-fail-mock-production-on`
-- **triggerSignal**: 生产入口默认启用 Mock、注释真实请求、或 production import test mocks
-- **expectedGateBehavior**: design/review 至少 Important → request-revision；static production/default-real-path 检查应失败或 review 阻断
-- **repairable (M3 预标注)**: `repairable` 若仅激活边界错误；`non-repairable` 若故意绕过合同
-- **Browser**: not-run；Mock UI 观感不得当真实联调
-
-## 场景
-
-```ts
-// fetch('/api/users')
-return mockUsers;
-```
-
-或 `mock.enable()` 无 dev/test 守卫。
-
-## 期望
-
-- 计入潜在 `mock_real_integration_false_claim` 若 closeout 美化
-- 与 mock workflow 生产默认真实路径规则一致
+# Failure fixture: Mock production-on / real-request commented out
+
+- **fixtureId**: `fe-fail-mock-production-on`
+- **triggerSignal**: 生产入口默认启用 Mock、注释真实请求、或 production import test mocks
+- **expectedGateBehavior**: design/review 至少 Important → request-revision；static production/default-real-path 检查应失败或 review 阻断
+- **repairable (M3 预标注)**: `repairable` 若仅激活边界错误；`non-repairable` 若故意绕过合同
+- **Browser**: not-run；Mock UI 观感不得当真实联调
+
+## 场景
+
+```ts
+// fetch('/api/users')
+return mockUsers;
+```
+
+或 `mock.enable()` 无 dev/test 守卫。
+
+## 期望
+
+- 计入潜在 `mock_real_integration_false_claim` 若 closeout 美化
+- 与 mock workflow 生产默认真实路径规则一致

package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md

@@ -1,29 +1,29 @@
-# Functional fixture: simple component / style
-
-- **fixtureId**: `fe-func-simple-component-style`
-- **taskTitle**: 调整 Button 次要样式以匹配设计 token
-- **expectedRoute**: `frontend-implementation`
-- **expectedRiskLevel**: `small`（M4 前仅标注）
-- **expectedGateIntensity**: standard dual design + mock assess；无 API 时倾向 `not-needed`
-- **expectedMockStrategy**: `not-needed`（无远程数据）
-- **Browser**: **out-of-scope / not-run**
-
-## 需求要点
-
-- 修改既有展示型组件 className / CSS module / token 引用。
-- 不改变公共 props API。
-- 覆盖 hover/disabled 若设计要求；无 loading/empty 则 N/A 并说明。
-
-## allowedPaths 建议
-
-```text
-src/components/Button/**
-src/styles/**
-test/components/Button/**
-```
-
-## expected verification 形态
-
-- Static: `typecheck` + `build`（fallback 可接受）
-- Behavior: 组件单测或 style snapshot 类 vitest（无浏览器）
-- 无 `frontend-mock-verify-shell`
+# Functional fixture: simple component / style
+
+- **fixtureId**: `fe-func-simple-component-style`
+- **taskTitle**: 调整 Button 次要样式以匹配设计 token
+- **expectedRoute**: `frontend-implementation`
+- **expectedRiskLevel**: `small`（M4 前仅标注）
+- **expectedGateIntensity**: standard dual design + mock assess；无 API 时倾向 `not-needed`
+- **expectedMockStrategy**: `not-needed`（无远程数据）
+- **Browser**: **out-of-scope / not-run**
+
+## 需求要点
+
+- 修改既有展示型组件 className / CSS module / token 引用。
+- 不改变公共 props API。
+- 覆盖 hover/disabled 若设计要求；无 loading/empty 则 N/A 并说明。
+
+## allowedPaths 建议
+
+```text
+src/components/Button/**
+src/styles/**
+test/components/Button/**
+```
+
+## expected verification 形态
+
+- Static: `typecheck` + `build`（fallback 可接受）
+- Behavior: 组件单测或 style snapshot 类 vitest（无浏览器）
+- 无 `frontend-mock-verify-shell`

package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md

@@ -1,28 +1,28 @@
-# Functional fixture: form validation
-
-- **fixtureId**: `fe-func-form-validation`
-- **taskTitle**: 实现登录表单客户端校验与错误提示
-- **expectedRoute**: `frontend-implementation`
-- **expectedRiskLevel**: `standard`
-- **expectedGateIntensity**: dual design；UI states 含 error/empty 输入
-- **expectedMockStrategy**: `not-needed` 若仅客户端校验；若提交到 API 则为 native/request-adapter
-- **Browser**: **out-of-scope / not-run**
-
-## 需求要点
-
-- 必填、格式、确认字段一致性。
-- 提交中 loading、校验失败 error message、成功 success 反馈。
-- 不得默认 Mock 掉真实提交路径。
-
-## allowedPaths 建议
-
-```text
-src/components/LoginForm/**
-src/pages/login/**
-test/components/LoginForm/**
-```
-
-## expected verification 形态
-
-- Static: typecheck/build
-- Behavior: 组件/单元测试覆盖 invalid/valid 路径
+# Functional fixture: form validation
+
+- **fixtureId**: `fe-func-form-validation`
+- **taskTitle**: 实现登录表单客户端校验与错误提示
+- **expectedRoute**: `frontend-implementation`
+- **expectedRiskLevel**: `standard`
+- **expectedGateIntensity**: dual design；UI states 含 error/empty 输入
+- **expectedMockStrategy**: `not-needed` 若仅客户端校验；若提交到 API 则为 native/request-adapter
+- **Browser**: **out-of-scope / not-run**
+
+## 需求要点
+
+- 必填、格式、确认字段一致性。
+- 提交中 loading、校验失败 error message、成功 success 反馈。
+- 不得默认 Mock 掉真实提交路径。
+
+## allowedPaths 建议
+
+```text
+src/components/LoginForm/**
+src/pages/login/**
+test/components/LoginForm/**
+```
+
+## expected verification 形态
+
+- Static: typecheck/build
+- Behavior: 组件/单元测试覆盖 invalid/valid 路径

package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md

@@ -1,28 +1,28 @@
-# Functional fixture: list/detail page
-
-- **fixtureId**: `fe-func-list-detail-page`
-- **taskTitle**: 实现订单列表与详情路由页面
-- **expectedRoute**: `frontend-implementation`
-- **expectedRiskLevel**: `standard`
-- **expectedGateIntensity**: dual design + 状态覆盖（loading/empty/error/success）
-- **expectedMockStrategy**: 有 API 时 `native` 或 `request-adapter`；policy=auto
-- **Browser**: **out-of-scope / not-run**
-
-## 需求要点
-
-- 列表分页或筛选；详情根据 id 加载。
-- loading / empty / error / success 四态可测。
-- Real Integration Gap 在 closeout 保留（若仅 Mock）。
-
-## allowedPaths 建议
-
-```text
-src/pages/orders/**
-src/components/orders/**
-src/api/orders/**
-test/pages/orders/**
-```
-
-## expected verification 形态
-
-- Static + behavior（路由/组件测试，非 e2e 浏览器）
+# Functional fixture: list/detail page
+
+- **fixtureId**: `fe-func-list-detail-page`
+- **taskTitle**: 实现订单列表与详情路由页面
+- **expectedRoute**: `frontend-implementation`
+- **expectedRiskLevel**: `standard`
+- **expectedGateIntensity**: dual design + 状态覆盖（loading/empty/error/success）
+- **expectedMockStrategy**: 有 API 时 `native` 或 `request-adapter`；policy=auto
+- **Browser**: **out-of-scope / not-run**
+
+## 需求要点
+
+- 列表分页或筛选；详情根据 id 加载。
+- loading / empty / error / success 四态可测。
+- Real Integration Gap 在 closeout 保留（若仅 Mock）。
+
+## allowedPaths 建议
+
+```text
+src/pages/orders/**
+src/components/orders/**
+src/api/orders/**
+test/pages/orders/**
+```
+
+## expected verification 形态
+
+- Static + behavior（路由/组件测试，非 e2e 浏览器）

package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md

@@ -1,29 +1,29 @@
-# Functional fixture: API + Mock
-
-- **fixtureId**: `fe-func-api-mock`
-- **taskTitle**: 接入用户列表 API 并在本地用既有 MSW Mock 验证
-- **expectedRoute**: `frontend-implementation`
-- **expectedRiskLevel**: `standard`
-- **expectedGateIntensity**: mock assess + mock contract gate；required 时可能含 mock-verify
-- **expectedMockStrategy**: `native`（既有 MSW）优先
-- **Browser**: **out-of-scope / not-run**
-
-## 需求要点
-
-- Fixture 字段对齐接口文档；禁止发明字段。
-- 生产默认真实请求；Mock 仅 test/dev 显式激活。
-- closeout：`Frontend status: mock-validated`，`Real integration: pending`。
-
-## allowedPaths 建议
-
-```text
-src/features/users/**
-src/mocks/**
-test/features/users/**
-```
-
-## expected verification 形态
-
-- Static（含 production/default-real-path 构建）
-- Behavior（Mock 激活下状态）
-- 可选 `npm run test:mock` → `frontend-mock-verify-shell`
+# Functional fixture: API + Mock
+
+- **fixtureId**: `fe-func-api-mock`
+- **taskTitle**: 接入用户列表 API 并在本地用既有 MSW Mock 验证
+- **expectedRoute**: `frontend-implementation`
+- **expectedRiskLevel**: `standard`
+- **expectedGateIntensity**: mock assess + mock contract gate；required 时可能含 mock-verify
+- **expectedMockStrategy**: `native`（既有 MSW）优先
+- **Browser**: **out-of-scope / not-run**
+
+## 需求要点
+
+- Fixture 字段对齐接口文档；禁止发明字段。
+- 生产默认真实请求；Mock 仅 test/dev 显式激活。
+- closeout：`Frontend status: mock-validated`，`Real integration: pending`。
+
+## allowedPaths 建议
+
+```text
+src/features/users/**
+src/mocks/**
+test/features/users/**
+```
+
+## expected verification 形态
+
+- Static（含 production/default-real-path 构建）
+- Behavior（Mock 激活下状态）
+- 可选 `npm run test:mock` → `frontend-mock-verify-shell`

package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md

@@ -1,27 +1,27 @@
-# Functional fixture: permission / auth-gated UI
-
-- **fixtureId**: `fe-func-permission-auth-ui`
-- **taskTitle**: 管理后台菜单按角色隐藏未授权入口
-- **expectedRoute**: `frontend-implementation`
-- **expectedRiskLevel**: `high-risk`（M4 前仅标注）
-- **expectedGateIntensity**: dual design 保留；权限矩阵进 plan
-- **expectedMockStrategy**: 若角色来自 API 则 Mock/adapter；纯 prop 驱动可为 not-needed
-- **Browser**: **out-of-scope / not-run**
-
-## 需求要点
-
-- 未授权不渲染危险操作；无权限 empty/forbidden 态。
-- 不得在客户端硬编码绕过鉴权当作完成。
-- 安全相关不得扩大 writeSet 到服务端密钥配置。
-
-## allowedPaths 建议
-
-```text
-src/features/admin/nav/**
-src/hooks/usePermission/**
-test/features/admin/**
-```
-
-## expected verification 形态
-
-- Static + 权限矩阵单测/组件测
+# Functional fixture: permission / auth-gated UI
+
+- **fixtureId**: `fe-func-permission-auth-ui`
+- **taskTitle**: 管理后台菜单按角色隐藏未授权入口
+- **expectedRoute**: `frontend-implementation`
+- **expectedRiskLevel**: `high-risk`（M4 前仅标注）
+- **expectedGateIntensity**: dual design 保留；权限矩阵进 plan
+- **expectedMockStrategy**: 若角色来自 API 则 Mock/adapter；纯 prop 驱动可为 not-needed
+- **Browser**: **out-of-scope / not-run**
+
+## 需求要点
+
+- 未授权不渲染危险操作；无权限 empty/forbidden 态。
+- 不得在客户端硬编码绕过鉴权当作完成。
+- 安全相关不得扩大 writeSet 到服务端密钥配置。
+
+## allowedPaths 建议
+
+```text
+src/features/admin/nav/**
+src/hooks/usePermission/**
+test/features/admin/**
+```
+
+## expected verification 形态
+
+- Static + 权限矩阵单测/组件测