docs: record bounded capture validation

2026-07-18 13:16:29 +02:00
parent fdd4b75bcb
commit 15c16f244e
2 changed files with 22 additions and 1 deletions
@@ -0,0 +1,17 @@
+# R2.7.12 任务报告
+
+## 结论
+
+第二轮 `$post-task` 复核发现首版 `capture validate` 内部依次执行 `status` 和两次 `list`，会对捕获目录做三次扫描。该问题已在 SuperAPI 提交 `bec2457 perf: avoid repeated capture validation scans` 中修复，并快进到 `/root/superapi` master。
+
+## 调整
+
+- 保留 `status` 完成的一次目录 scan，用其内存文件索引定位最新请求和响应 JSONL。
+- 每类只读取最新一行，同时完成 JSON 解析、摘要字段、Secret 脱敏和权限校验。
+- 删除验证路径中的两次 `list` 调用，不改变普通 `capture list` 行为。
+- `capture validate` 的字段、默认不输出 body 的合同和退出码保持不变。
+- 使用 MDTODO CLI 修正 `R2.7.11` 中重复的报告尾句。
+
+## 验证
+
+在实验分支和快进后的 `/root/superapi` master 运行 `bun scripts/superapi-cli.ts capture validate` 均为 PASS；配额、双向 JSONL、UTC 路径、权限、API Key 脱敏、双向摘要均为 true，`BODY_PRINTED=false`。运行服务未重启。
@@ -224,7 +224,11 @@

 #### R2.7.11 [completed]

-复盘 SuperAPI 全量捕获交付并修复已暴露的流程缺口：让 L0 实际加载代理模块以提前发现语法错误；新增 `capture validate` 聚合校验配额、JSONL、UTC 分区、权限、敏感值脱敏和请求/响应摘要；将最短验收流程沉淀到 Sub2API skill，不修改运行网关行为，完成任务后将详细报告写入任务报告，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R2.7.11_Task_Report.md)。
+复盘 SuperAPI 全量捕获交付并修复已暴露的流程缺口：让 L0 实际加载代理模块以提前发现语法错误；新增 `capture validate` 聚合校验配额、JSONL、UTC 分区、权限、敏感值脱敏和请求/响应摘要；将最短验收流程沉淀到 Sub2API skill，不修改运行网关行为，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R2.7.11_Task_Report.md)。
+
+#### R2.7.12 [completed]
+
+复核 `capture validate` 聚合验收自身的调用成本，将三次捕获目录扫描收敛为一次扫描和每类最新一行读取，并验证输出合同不变，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R2.7.12_Task_Report.md)。
 ### R2.8 [completed]

 整理本 MDTODO FILE 的职责层级和编号，并把同一 SUBITEM 下的直接 SUBSUBITEM 一般不超过 20 固化到 mdtodo-edit skill，完成任务后将详细报告写入[任务报告](./details/sub2api-upstream-reliability/R2.8_Task_Report.md)。