 Songhaoz666andClaude Opus 4.8
|
3411daf00b
|
复审整改(PR #30)：审计接口读取完整事件流，消除 >500 事件静默截断
Fasthei 复审阻塞点：build_audit_trace_for_run 只调用一次 list_events(limit=500)，
而 list_events 把 limit 钳到 500 并用 next_cursor 暴露下一页——501+ 事件的 run 只返回
前 500 条审计记录，无报错/无 truncated 标记，违背 #17「每步 trace 可回放」核心 DoD。
修复：build_audit_trace_for_run 改为循环跟随 next_cursor 读到为空，拼出完整事件流再
装配审计记录（main.py）。
测试：test-audit-trace.py 新增 test_pagination_no_truncation——存 612 条事件（>500 且非
500 整数倍），断言 audit count == 完整事件数（613，含创建事件）、replay 行数 == count 不截断、
audit_id 连续到末条（aud_000613）。本地全绿。
影响范围：仅 agent_swarm（orchestrator 只读审计装配 + 测试）；无契约/计费/审批/密钥改动。
Refs #17
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
2026-06-10 21:14:50 +08:00 |
|
|
Songhaoz666andClaude Opus 4.8
|
af4ace4340
|
审计/链路追踪落地（可回放审计记录 FROZEN v1）（Refs #17）
issue #17 要求「每步 trace 可回放（谁/何模型/何工具/何审批）+ schema 冻结 + 测试」。
本仓已持久化事件流 + 任务谱系 + 每任务 usage(model_id) + 审批；本 PR 把它们规整为
统一、有序、可回放的审计记录并冻结 schema。
代码：
- orchestrator/audit.py（新，纯模块，无 Redis/WS/FastAPI/模型）：build_audit_trace(
events, task_facts, approvals, lineage) 逐事件产审计记录（who/when/model_id/tool_count/
approval{id,decision}/result/lineage），audit_id 由序位确定（非随机，可字节级复现）；
replay(records) 产人读步骤行。无内容、无密钥、缺信号不伪造（model/tool 缺则 null）。
- orchestrator/main.py：build_audit_trace_for_run（装配器，从 list_events + 任务 usage +
run.approvals 取数）+ 读接口 GET …/{id}/audit（三别名路由，复用既有鉴权）。
文档：docs/integration/audit-trace-schema.md → FROZEN v1：§3.1 回放装配、§5 冻结记录形；
诚实标注**有意排除**（prompt/代码原文、model 请求响应体刻意不留痕——无内容原则；
无 SK/MCP 工具层故无工具名谱系），按规则 #9 不伪造、不在本次扩展。
测试：scripts/test-audit-trace.py（纯模块 + 集成）：逐步 who/model/tool/approval 重建、
result 归类、有序回放、**断言无 secret_ref/azkv/明文泄漏**；接入 CI。
影响范围：仅 agent_swarm（orchestrator 新增只读审计接口 + 纯模块 + 文档 + 测试 + CI）。
- Manager：新增只读 GET …/{id}/audit；不改回调/契约/计费/审批链。
- 密钥/审计：审计记录只含非内容元数据 + secret_ref 永不写入；归因按 user/channelId，不引入 tenant。
Refs #17
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
|
2026-06-10 18:06:50 +08:00 |
|