统一 SuperAgent 查询接口鉴权契约

docs/project/go-live-notes.md

@@ -16,6 +16,7 @@
 - Reservation 任务详情接口：返回任务字段、队列可处理状态和 OPERA 模拟操作摘要。
 - Reservation 任务草稿保存和最终确认接口：按任务卡矩阵做第一版后端校验，确认后生成 `confirmed_payload_json`。
 - Reservation OPERA 模拟骨架：已确认任务固定生成两条模拟操作，支持执行、失败重试、attempt 记录和任务审计列表。
+- SuperAgent 查询上下文接口 1、2：支持 HMAC 鉴权的订单上下文查询和对象详情查询。
 
 当前不要把以下能力当作已上线：
 
@@ -24,7 +25,7 @@
 - 自动 ACK、`task.result` 或客户回复。
 - 业务前端页面展示邮件原文。
 - OHIP / OPERA 或其他业务系统真实写操作。
-- SuperAgent 查询上下文接口。
+- SuperAgent 查询上下文接口 3、4。
 - 普通任务切换订单接口。
 - 用户身份、权限和真实审计 actor。
 
@@ -82,6 +83,21 @@
 - `AGENTBUS_CAPTURE_ENABLED=false` 时，业务 frame 会被忽略，不会写入 SourceMessage Inbox。
 - 当前实现不发送 ACK、不发送 `task.result`、不自动回复客户。
 
+### 3.4 SuperAgent HMAC
+
+| 变量 | 是否 Secret | 上线注意事项 |
+| --- | --- | --- |
+| `SUPERAGENT_TASK_RESULT_HMAC_SECRET` | 是 | SuperAgent 查询接口 1、2 和任务结果通知接口共用的 HMAC secret。生产不能为空，只能通过 Secret 注入。 |
+| `SUPERAGENT_TASK_RESULT_CLOCK_SKEW_SECONDS` | 否 | 请求时间允许偏移，默认 `300` 秒。上线前确认双方机器时间已同步。 |
+| `SUPERAGENT_TASK_RESULT_NONCE_TTL_SECONDS` | 否 | nonce 防重放窗口，默认 `600` 秒。 |
+| `SUPERAGENT_TASK_RESULT_MAX_BODY_BYTES` | 否 | SuperAgent 入站请求体最大字节数，默认 `1048576`。 |
+
+注意：
+
+- 查询接口和任务结果通知接口使用同一套 Header、签名串、secret、timestamp 和 nonce 规则。
+- SuperAgent 侧也需要配置同一个 secret，并按原始请求体计算 SHA-256。
+- 当前第一版只支持一个 HMAC secret，secret 轮换需要协调部署窗口。
+
 ## 4. 数据库上线注意事项
 
 当前 SourceMessage 相关 migration：