# Gitea Webhook Agent 文档与回归计划

## 目标

补齐 Gitea Workflow 的部署运维和测试设计文档，并新增不依赖业务实现的
Webhook 协议回归脚本与 fixtures，覆盖验签、事件过滤、队列恢复、回执重试
兜底、MCP 线程配置和安全边界；不修改 `server.js` 主逻辑，也不覆盖其他代理
正在进行的 Gitea 文档或实现改动。

## 步骤

1. 盘点并复核 `docs/gitea-workflow/PRD.md`、`ARCHITECTURE.md`，确认需求覆盖和
   与其他代理的修改边界
2. 补齐/校验 PRD 与架构交付基线，并设计部署运维文档固定安全与恢复契约
3. 设计测试文档并建立需求到回归场景覆盖矩阵
4. 新增独立 webhook 回归脚本与 JSON fixtures，固定直接验收入口
5. 运行定向回归、脚本语法检查和差异范围审查
6. 完成文档一致性复核并清理临时清单

## 约束

- 现有 `PRD.md`、`ARCHITECTURE.md` 属于其他代理的工作区：先做只读一致性复核；
  只有发现本需求明确缺口且确认不覆盖其改动时才做最小追加，否则在新增文档中
  记录已覆盖项和缺口。
- 本轮新增/修改目标为 `docs/gitea-workflow/DEPLOYMENT.md`、`TESTING.md`、
  `scripts/gitea-webhook-regression.js` 及 `fixtures/gitea-workflow/*.json`，
  并在新增文档中明确引用 PRD/架构路径。
- 独立验收入口固定为：`timeout 60s node scripts/gitea-webhook-regression.js`；
  脚本输出每个场景的 PASS/FAIL 与最终汇总，不依赖服务启动或网络。
- 不修改 `server.js` 主逻辑、`lib/`、`public/`、依赖和其他代理的目标文档。