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

package/docs/templates/backend-test-result.schema.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://tea-agent.dev/schemas/backend-test-result-v1.json",
+  "title": "Backend Test Result v1",
+  "description": "Run-owned pytest result artifact. Task Pool may consume outcome, counts, failures[], executionStatus, collectionStatus, pytestExitCode, and junit refs. Auto follow-up is out of scope for M2.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "executionStatus",
+    "pytestExitCode",
+    "collectionStatus",
+    "tests",
+    "passed",
+    "failed",
+    "error",
+    "skipped",
+    "junit",
+    "commandSummary",
+    "failures",
+    "outcome"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "executionStatus": {
+      "type": "string",
+      "enum": ["completed", "collection-error", "command-error", "report-error"],
+      "description": "Process-level status. Task Pool: do not treat collection-error/command-error as ProductBug."
+    },
+    "pytestExitCode": {
+      "type": "integer",
+      "minimum": 0,
+      "maximum": 255,
+      "description": "Raw pytest process exit code (0/1 are node-success when JUnit exists)."
+    },
+    "collectionStatus": {
+      "type": "string",
+      "enum": ["ok", "error", "unknown", "skipped"]
+    },
+    "tests": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Task Pool: total tests = passed+failed+error+skipped"
+    },
+    "passed": { "type": "integer", "minimum": 0 },
+    "failed": { "type": "integer", "minimum": 0 },
+    "error": { "type": "integer", "minimum": 0 },
+    "skipped": { "type": "integer", "minimum": 0 },
+    "durationMs": { "type": "number", "minimum": 0 },
+    "junit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["relativePath", "sha256"],
+      "properties": {
+        "relativePath": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*(?:^|/)\\.(?:/|$))(?!.*\\\\)(?!.*//).+$",
+          "description": "Run-dir relative POSIX path without absolute form, backslashes, dot segments, or parent traversal (e.g. reports/backend-test-junit.xml)"
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "commandSummary": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Non-secret command summary only"
+    },
+    "failures": {
+      "type": "array",
+      "description": "Truncated failure/error summaries for triage (Task Pool consumable).",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["classname", "name", "message"],
+        "properties": {
+          "classname": { "type": "string", "minLength": 1 },
+          "name": { "type": "string", "minLength": 1 },
+          "message": { "type": "string", "minLength": 1 },
+          "kind": { "type": "string", "enum": ["failure", "error"], "default": "failure" }
+        }
+      }
+    },
+    "outcome": {
+      "type": "string",
+      "enum": [
+        "passed",
+        "completed-with-failures",
+        "collection-error",
+        "command-error",
+        "report-error"
+      ],
+      "description": "Authoritative shell-facing outcome for backend-test-outcome-gate-shell. Retrospective must not override."
+    }
+  }
+}

package/docs/templates/branch-merge-report.md

@@ -0,0 +1,93 @@
+# Branch Merge Report — `<source-ref>` into `<target-branch>` at `<source-short-sha>`
+
+Date: `<YYYY-MM-DD>`
+Target branch: `<target-branch>`
+Target before merge: `<full SHA>`
+Source: `<source-ref>@<full SHA>`
+Merge base: `<full SHA>`
+Merge commit: `<full SHA or follow-up commit reference>`
+
+## Naming Convention
+
+Use `YYYY-MM-DD-origin-<source>-into-<target>-<source-short-sha>.md` under `docs/reports/`. Replace `/` and other path separators in branch names with `-`. The source short SHA distinguishes repeated merges on the same day.
+
+## Pre-merge Inspection
+
+- Divergence: `<target-only count>` target-only commits / `<source-only count>` source-only commits.
+- Dry run: `git merge-tree --write-tree --messages <target> <source>`.
+- Predicted conflicts: `<count and files>`.
+- Baseline verification: `<commands and results>`.
+
+## Incoming Capabilities
+
+| Capability | Key files / contracts | Expected user or runtime result | Verification |
+| --- | --- | --- | --- |
+| `<incoming capability>` | `<paths>` | `<behavior>` | `<test/smoke>` |
+
+## Target-branch Capabilities to Preserve
+
+| Capability | Key files / contracts | Preservation risk | Verification |
+| --- | --- | --- | --- |
+| `<target capability>` | `<paths>` | `<possible overwrite>` | `<test/smoke>` |
+
+## Conflict Resolution
+
+| File | Conflict type | Incoming concern | Target concern | Resolution | Evidence |
+| --- | --- | --- | --- | --- | --- |
+| `<path>` | `content/rename-delete/add-add` | `<incoming behavior>` | `<target behavior>` | `<combined decision>` | `<test/diff>` |
+
+If there were no textual conflicts, write `No textual conflicts` and continue with the automatic-merge review below.
+
+## Automatic-merge Semantic Review
+
+Record overlapping or high-risk files that Git merged without conflict. These are common places for silent feature loss.
+
+| File / area | Why high risk | Incoming behavior retained | Target behavior retained | Evidence |
+| --- | --- | --- | --- | --- |
+| `<path>` | `<shared imports/topology/config>` | `<incoming proof>` | `<target proof>` | `<tests/search>` |
+
+## Functional Impact Matrix
+
+| Feature | Before merge | After merge | Deleted or weakened? | Notes |
+| --- | --- | --- | --- | --- |
+| `<feature>` | `<baseline>` | `<result>` | `No/Yes` | `<details>` |
+
+## Init and Update Impact
+
+- Changed init/package surface: `<paths or none>`.
+- Fresh full init result: `<result>`.
+- `init check-update` result: `<result>`.
+- `init update --apply-safe` recovery result: `<result>`.
+- Manifest or init implementation updates made: `<details or none>`.
+
+## Package Surface Impact
+
+- `npm pack --dry-run --ignore-scripts --json`: `<file count>` files.
+- Added package paths: `<paths>`.
+- Removed package paths: `<paths or none>`.
+- Unexpected files or missing required files: `<details or none>`.
+
+## Verification
+
+| Command | Result | Capability covered |
+| --- | --- | --- |
+| `npm run typecheck` | `<pass/fail>` | TypeScript integration |
+| `npm test` | `<pass/fail>` | Full regression |
+| `npm run build` | `<pass/fail>` | Build/package inputs |
+| `bash scripts/check-repo.sh` | `<pass/fail>` | Governance and init surface |
+| `npm run docs:build` | `<pass/fail>` | User documentation |
+| `npm pack --dry-run --ignore-scripts --json` | `<pass/fail>` | Published files |
+
+Add focused tests and real init/update/browser/CLI smokes required by the merged capabilities.
+
+## Residual Risk
+
+- `<unverified external environment, performance, migration, or compatibility risk>`
+
+## Rollback and Investigation Pointers
+
+- Merge commit: `<SHA>`.
+- Conflict files: `<paths>`.
+- First tests to run if a feature appears missing: `<commands>`.
+- Safe rollback strategy: prefer `git revert -m 1 <merge-commit>` after review; do not use destructive reset on shared work.
+

package/docs/templates/exec-plan.md

@@ -1,64 +1,64 @@
-# 执行计划模板
-
-## 标题
-
-## 状态
-
-- draft / active / blocked / completed
-
-## 背景
-
-- 当前问题或机会是什么：
-- 为什么值得现在做：
-
-## 目标（Objective）
-
-- 本计划希望达成什么结果：
-
-## 范围（Scope）
-
-- 包含：
-- 不包含：
-
-## 约束（Constraints）
-
-- 架构/契约约束：
-- 时间/风险约束：
-- 验证约束：
-
-## 里程碑（Milestones）
-
-| ID | Milestone | Status | Exit Criteria |
-|----|-----------|--------|---------------|
-| M1 |           | todo   |               |
-
-## 工作分解（Work Breakdown）
-
-| ID | Work Item | Status | Notes |
-|----|-----------|--------|-------|
-| W1 |           | todo   |       |
-
-## 验证关口（Verification Gates）
-
-- [ ] 文档/契约已同步
-- [ ] 最低必要测试已通过
-- [ ] 关键路径已验证
-- [ ] 风险与未覆盖项已记录
-
-## 风险 / 阻塞项
-
-- 风险：
-- 阻塞：
-
-## 回退 / 恢复（Rollback / Recovery）
-
-- 如何回退：
-- 回退后如何恢复基线：
-
-## Open Questions
-
-- 
-
-## 推荐下一步
-
-- 
+# 执行计划模板
+
+## 标题
+
+## 状态
+
+- draft / active / blocked / completed
+
+## 背景
+
+- 当前问题或机会是什么：
+- 为什么值得现在做：
+
+## 目标（Objective）
+
+- 本计划希望达成什么结果：
+
+## 范围（Scope）
+
+- 包含：
+- 不包含：
+
+## 约束（Constraints）
+
+- 架构/契约约束：
+- 时间/风险约束：
+- 验证约束：
+
+## 里程碑（Milestones）
+
+| ID | Milestone | Status | Exit Criteria |
+|----|-----------|--------|---------------|
+| M1 |           | todo   |               |
+
+## 工作分解（Work Breakdown）
+
+| ID | Work Item | Status | Notes |
+|----|-----------|--------|-------|
+| W1 |           | todo   |       |
+
+## 验证关口（Verification Gates）
+
+- [ ] 文档/契约已同步
+- [ ] 最低必要测试已通过
+- [ ] 关键路径已验证
+- [ ] 风险与未覆盖项已记录
+
+## 风险 / 阻塞项
+
+- 风险：
+- 阻塞：
+
+## 回退 / 恢复（Rollback / Recovery）
+
+- 如何回退：
+- 回退后如何恢复基线：
+
+## Open Questions
+
+- 
+
+## 推荐下一步
+
+- 

package/docs/templates/feature-spec.md

@@ -1,53 +1,53 @@
-# Feature Spec 模板
-
-## 标题
-
-## 状态
-
-- draft / active / completed
-
-## 背景（Background）
-
-- 问题背景：
-- 用户/协作者痛点：
-- 与现有系统的关系：
-
-## 目标（Goal）
-
-- 本 feature 要实现什么：
-
-## 非目标（Non-goals）
-
-- 明确本轮不做什么：
-
-## 关键场景 / 用户路径
-
-1. 
-2. 
-3. 
-
-## Feature List
-
-| ID | Feature | Priority | Status | Acceptance | Notes |
-|----|---------|----------|--------|------------|-------|
-| F1 |         | High     | todo   |            |       |
-
-## 依赖（Dependencies）
-
-- 上游依赖：
-- 下游影响：
-- 文档/契约依赖：
-
-## 风险（Risks）
-
-- 
-
-## 验证说明（Verification Notes）
-
-- 最低建议验证：
-- 加强验证：
-- 关键手工路径：
-
-## Open Questions
-
-- 
+# Feature Spec 模板
+
+## 标题
+
+## 状态
+
+- draft / active / completed
+
+## 背景（Background）
+
+- 问题背景：
+- 用户/协作者痛点：
+- 与现有系统的关系：
+
+## 目标（Goal）
+
+- 本 feature 要实现什么：
+
+## 非目标（Non-goals）
+
+- 明确本轮不做什么：
+
+## 关键场景 / 用户路径
+
+1. 
+2. 
+3. 
+
+## Feature List
+
+| ID | Feature | Priority | Status | Acceptance | Notes |
+|----|---------|----------|--------|------------|-------|
+| F1 |         | High     | todo   |            |       |
+
+## 依赖（Dependencies）
+
+- 上游依赖：
+- 下游影响：
+- 文档/契约依赖：
+
+## 风险（Risks）
+
+- 
+
+## 验证说明（Verification Notes）
+
+- 最低建议验证：
+- 加强验证：
+- 关键手工路径：
+
+## Open Questions
+
+- 

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

@@ -0,0 +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 仅记录

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

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

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

@@ -0,0 +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 不得宣称真实联调成功

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

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

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

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

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

@@ -0,0 +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 通过单独放行

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

@@ -0,0 +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 生产默认真实路径规则一致

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

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