Agent-System/.doc/ops/short-term/2026-09-17-w3-pi-change-report-narrative.md

title, status, created, updated, owner, branch, worktree, mutex

title	status	created	updated	owner	branch	worktree	mutex
W3 PU7 PI change-report 叙事 live	done	2026-09-17	2026-09-17	Cursor	feature/w3-pi-change-report-narrative-live	-	docgov

W3 PU7 PI change-report 叙事 live

目标

flag on 时质量修复路径向产品 PI Agent Runner 请求 change_report_narrative_v1；digest 绑定；畸形/超时全量 fallback；UI 区分叙事与 rule_risk/lineage。

范围

• CreateAgentCandidate 在 flag on 且 ReportJSON 为空时调用 NarrativeFetcher
• 组合根仅 PI_CHANGE_REPORT_NARRATIVE on + pi-agent 注入 PiChangeReportNarrator
• 仓库默认 flag 仍 off；dev 运行态可覆盖
• 负例：timeout envelope / fetcher error → fallback 且不返回 ErrReportInvalid

非目标

• 不把 fallback 写成完整 PI
• 不覆盖服务端风险与文档影响
• 不默认开启仓库 flag

步骤

1. no-tool PI narrator + 组合根接线
2. digest 与 ResolveChangeReport 同源（candidate 真实 diff 之后再 fetch）
3. 单测 + 真实 MiniMax + UI 分区单测
4. 合 dev + 冒烟 + 矩阵升 done

验收标准

• 真实 PI 产出 change_report_narrative_v1 且 digest 原样回写
• fallback 负例 PASS
• UI change-report-factual / change-report-narrative 分区
• test-report 归档

相关链接

• Contract: ../long-term/2026-09-16-pu7-pi-narrative-contract.md
• Test report: ../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md