[YanZhiwei]

摘要

记录 PR #18 的合并结果，把 delivery 证据锚定到 main 历史内的 squash 合并提交，并在删除
已合并分支后保持证据可验证。

变更类型

• 文档或治理

当前设计（变更前）

• harness/evidence/delivery-v022-upgrade.md 的 head_revision 指向未合并分支提交
  079ccc2，不是 main 的祖先；base_revision 指向未合并的 v0.2.1 分支提交。
• harness/evidence/delivery-v021-upgrade.md 的 head_revision 同样指向未合并分支提交。
• .specify/delivery/008-langchain-first-llm-runtime/evidence.md 仍写“未执行 merge”，且
  base_revision 指向只在已删除分支上可达的 S2 提交。
• pull-request.md 是合并前的 PR 正文，没有历史标注。

分支删除后，这些提交在全新克隆中不可达，governance 会报
head_revision is not a commit in this repository。

变更内容

位置	变更	原因
harness/evidence/delivery-v022-upgrade.md	head_revision → PR #17 squash 提交 353af49；base_revision → main 基线 9cdb10a	锚点落在 main 历史内，保留材料提交 079ccc2 的说明
harness/evidence/delivery-v021-upgrade.md	head_revision → 353af49，并说明 v0.2.1 内容随 v0.2.2 一起合并	该分支未单独合并，原锚点已不可达
.specify/delivery/008-*/evidence.md	head_revision → 468ee7f；base_revision → 353af49；新增 “Post-merge closure” 与 re-anchor 说明	让记录与合并事实一致，并保持 SHA 可验证
.specify/delivery/008-*/pull-request.md	顶部加入“历史记录”提示	保留合并前正文的真实性

影响

维度	影响	证据
公共 API、命令、配置	无；只改 Markdown 记录	git diff --name-only
持久化或迁移	无	—
兼容性与升级路径	无	—
安全与权限	无；未引入密钥或私有地址	diff
性能与资源	无	—
依赖与供应链	无依赖变化	diff

设计

N/A：只修正证据锚点和历史标注，没有结构变化。

架构决策

• 没有架构决策变化。
• 说明：ADR-0006/0007 已 Accepted，本次不修改其内容。

行为与验收

需求	结果	证据
证据锚点位于 main 历史	通过：353af49、9cdb10a、468ee7f 均可达	全新克隆 governance 运行
008 记录与合并事实一致	通过：合并提交、CI、分支删除均已记录	Post-merge closure 小节
squash 未丢失内容	通过：分支头 e451315 与合并提交 tree 相同	tree 均为 89801db…
历史正文可辨识	通过：pull-request.md 顶部标注为合并前正文	diff
删除分支后证据仍可验证	通过：全新克隆 0 error	下方验证表

验证

检查	结果	证据
构建	不适用	无源码变更
测试	不适用	无行为变更
文档检查	pass	scripts/quality.ps1 -Check docs：79 files / 206 targets
治理检查（本地）	pass（0 error，1 warning）	warning 为锚点之后出现材料路径变化的真实信号
全新克隆治理检查	pass（0 error，1 warning）	git clone --no-local 后运行 check-governance.ps1
空白与 diff	pass	git diff --check 退出 0

文档

• 源文档已更新。
• 生成文档已同步。
• 不需要文档变更。

回滚

revert 提交 c8400fe 和 187ca87；只涉及 Markdown 记录，无持久化数据需要清理。

AI 辅助

• 未使用 AI 辅助。
• 使用了 AI 辅助，且每一行变更都已审阅和验证。

评审说明

• Lane：Lightweight（文档/记录修正，无行为变化）。
• 首次 CI 的 governance 失败由分支删除后提交不可达引起，已通过重新锚定修复，并在全新克隆
  中复现验证。
• 文档检查需临时移出本地忽略的 specs/007-llm-protocol-abstraction（其 plan.md 链接
  未合并 PR feat: add protocol-native LLM contracts and LangChain adapters #16 的 ADR-0005），检查后已恢复。
• 保留 1 个 warning：v0.2.2 证据锚定后出现了 008 的材料路径变化；这是真实的新鲜度信号。
• 未执行 merge；本 PR 只记录事实。

检查清单

• 验收条件已覆盖。
• 阻断性评审问题已解决。
• ADR 与 HEAD 的实现一致。
• 已附相关验证证据。
• 外发 diff 与已审阅范围一致。