feat(automation): 为每日情报简报项绑定稳定证据引用与快照版本 - #154
Theater-ahyeon wants to merge 1 commit into
Conversation
helsome
left a comment
There was a problem hiding this comment.
当前增量方向可以保留,但这里有一个会冻结错误 evidence identity 的 correctness blocker,需要先修:BriefItem.evidenceRefs 被声明为“stable evidence / source references”,实际写入的却是 ResearchDiff.change.evidence 的自由文本 provenance(测试里就是 capability:... run:... fetchedAt:...),以及合成的 automation-run:${run.id}:material。这些值目前不是可解析的 canonical sourceId/evidenceId,后续 Inspector 无法据此稳定定位证据;这与 #103 本切片声称的“stable evidence/source identities”不一致,也会与正在收敛的 #100 unified evidence contract 产生第二套身份。
最小修改即可:要么让这里消费真实 canonical sourceId / evidenceId(推荐在 #100/#104 契约可用后接入),并加一个“引用可 resolve 到对应 evidence/source”的 focused assertion;要么把字段明确收窄/改名为 provenance/correlation anchors,并同步 PR 描述,不把它声称为稳定证据 identity。contextVersion 本身不需要因为这个问题扩大设计,也不要求完整 #103 E2E。作者现有 Bun/OS、9/0 focused、54/0 automation 和全 workspace typecheck 报告可继续沿用到未受影响部分;当前 head Actions 是 action_required,我没有把它当成质量失败。
改了什么
Refs #103(增量切片:简报证据溯源与快照绑定)
按 Issue #103 的验收标准,组合情报简报(Daily Intelligence Digest)中的每一项结论不应仅是自由文本,而必须能够定位到稳定的证据引用与所依据的上下文快照:
packages/shared/src/automation/brief.ts:BriefItem新增evidenceRefs?: string[]与contextVersion?: string;watchlistItems(研报差异项):自动将diff.changes里的底层证据标注提取为evidenceRefs,并以diff-${diff.id}标记上下文快照版本;thesisItems(论点异动项):同样提取底层证据引用与 diff 标识;automationItems:对实质变化运行标记对应的运行证据锚点与 run 上下文版本。packages/shared/src/automation/brief.test.ts:evidenceRefs与contextVersion的断言用例,确保简报项能够稳定追溯到来源数据。为什么要改
Issue #103 明确要求:
此前
DailyBrief的各个BriefItem仅包含展示性文案和基本标题,无法直接挂钩到底层数据能力(如company.valuation、market.quote等运行证据)与上下文版本。本 PR 补齐该数据连接,让简报消费方或后续 Inspector 能够直接根据evidenceRefs展示证据详情。兼容性与 UI 影响
验证
环境:Bun 1.4.2 / Windows 11 (10.0.26200)