# 发现记录

## 现状

- `docs/gitea-workflow/PRD.md` 与 `ARCHITECTURE.md` 已存在，已约定 MVP 为单
  Gitea 实例、`ccweb-bot`、同仓库串行、全局并发 2、线程级 `gitea-mcp`。
- 当前仓库没有 Gitea 业务实现入口；本轮脚本必须测试协议/状态机纯函数，不应
  假设或改写 `server.js`。
- `package.json` 只有 `npm run regression`；新增脚本应提供独立 `node` 入口，
  便于实现接入阶段先运行夹具回归。

## 交付设计

- `DEPLOYMENT.md`：配置分层、Webhook 反向代理、凭据、目录权限、启动顺序、
  健康检查、暂停/恢复、备份恢复、故障处置、日志脱敏和容量基线。
- `TESTING.md`：测试金字塔、fixtures 协议、场景矩阵、故障注入、恢复/重试
  断言、MCP `thread/start.config.mcp_servers.gitea` 契约与安全测试。
- `scripts/gitea-webhook-regression.js`：零依赖 Node 脚本，加载 fixtures，
  对原始 body 做 HMAC-SHA256 常量时间校验，验证事件过滤、delivery 去重、
  队列恢复/并发互斥、回执补发/REST 兜底、线程级 MCP 配置、路径边界以及敏感
  信息不泄漏。