Agent-System/.doc/test-reports/2026-09-25-t20-b5-chat-observability-test-report.md

T20 B5（chat 回合补偿可观测与孤儿扫描）测试报告

一、 测试背景 (Background)

T20 设计 B5：补偿已存在但错误被 _ = 静默吞掉；崩溃/超时后 processing 孤儿无批量清理，幂等键被永久占位。本批补可观测 + 周期扫描。

二、 测试目标 (Test Objectives)

• 补偿失败不再静默（结构化日志字段完整）。
• 过期 processing 被批量标 failed；未过期/终态不受影响；重复扫描幂等。

三、 测试方案与环境 (Test Plan & Environment)

• OS：Linux 7.0.0-31-generic；Go 单测（内存模式覆盖扫描语义；PG 路径与内存同构 SQL，属工程工具层）。
• worktree .worktrees/t20-b5-chat-observability-2026-09-25 @ dev 088ff307。

四、 预期结果 (Expected Results)

• TestSweepExpiredProcessingTurns_Memory：n=1，过期→failed，fresh/completed 不变，二次 0。

五、 实际测试结果与判定 (Actual Results & Evaluation)

$ go test ./internal/ctxmgr/ -run 'TestSweep' -v
--- PASS: TestSweepExpiredProcessingTurns_Memory (0.00s)
PASS
ok  	chat-agent-system/internal/ctxmgr  0.003s

判定：PASS。

$ go build ./...                      → exit 0
$ go test ./internal/ctxmgr/...       → ok（全量含既有 AcquireChatTurn 家族）

判定：PASS。

六、 自动化测试套件汇总 (Test Suite Execution)

套件	结果	通过率
go test ./internal/ctxmgr/ -run 'TestSweep' -v	PASS	1/1
go test ./internal/ctxmgr/...	PASS	全量
go build ./...	PASS	—

七、 测试结论与后续优化建议 (Conclusion & Next Steps)

• B5 三件套（可观测、扫描、调度）落地；PG 路径待部署后在共享环境用真实失败注入复核（见部署授权窗口）。
• 可选后续：绑定校验（user_message_id 为空的终态 turn）告警——需产品数据支持，暂不实施。