IR-0006 AC-4 残留：butler 源仍无法落盘——butler-reconcile.yml git add 缺 -f（.gitignore 忽略，修复后 run 34 仍红）

[randypanding]

背景（独立验收，2026-08-30 第三轮独立核对）

对 IR-0006（#402，state:done）做独立代码+运行时验收时发现：AC-4「七源一条命令」的 butler 源至今无数据，且根因是一个 #474 未覆盖的第二段 bug。此前 #471 已报 butler 源恒 0，#474 声称修复（Fixes #471），但修复后运行时仍然失败——本次用实际运行日志实证。

运行时证据

1. butler-reconcile run 34（2026-08-30T04:22:41Z，head=69da2c1=#474 修复提交）仍失败

失败步骤=「影子账本落盘（butler-ledger 分支）」，日志末尾：

Cloning into 'ledger'...
Switched to a new branch 'butler-ledger'
relink → merged.jsonl（base 0 + local 2 条）
OK merged.jsonl: 2 条，链完整
The following paths are ignored by one of your .gitignore files:
governance/butler/shadow-evidence.jsonl
hint: Use -f if you really want to add them.
##[error]Process completed with exit code 1.

即：mkdir 修复（#474）已解决「父目录缺位 : > $BASE 崩」；但紧接着的 git -C ledger add "$SHADOW" 被 .gitignore 拒绝，push 不执行。

2. 此前 run 31/32/33 亦连续失败（旧提交：406cf1c/15ac9c13/ee64016）

3. 分支与数据实况

• .github 仓 无 butler-ledger 分支（GitHub API：Branch not found）
• evidence-query.sh --json 实测 by_source: butler=0（metering=1, drill=1, elevation=5, tickets=4, feishu=9, env=3）——七源实为六源有数据

根因链

1. .github 仓 .gitignore 明确忽略 governance/butler/shadow-evidence.jsonl（影子真源在 *-ledger 分支，工作树副本不入库）；
2. butler-reconcile.yml 落盘步用 git -C ledger add "$SHADOW" 缺 -f → 被 gitignore 拒绝；
3. 同类 workflow 均有 -f 先例：env-drift.yml:133、feishu-drill.yml:82、feedback-edge.yml:70 都是 git -C ledger add -f "$SHADOW"——唯独 butler-reconcile.yml 漏了。
4. fix: IR-0006 验收缺陷五连修——预算执法/metering 源/gate 逐测/retention/checkpoint（ADR-0103） #474 修复只补了 mkdir -p "$(dirname "$BASE")"（解决目录崩溃），未处理 gitignore 这第二段——故修复后 run 34 仍红，butler-ledger 分支从未建出。

影响

• AC-4「三源（metering/drill/butler）统一查询」/「七源一条命令」对 butler 源不成立：butler 有影子记录（run34 日志显示 local 2 条）但永远查不到；
• acceptance.md 的 AC-4 勾选与 fix: IR-0006 验收缺陷五连修——预算执法/metering 源/gate 逐测/retention/checkpoint（ADR-0103） #474「Fixes IR-0006 独立实证：evidence-query metering 源 KeyError（AC-4 未满足）+ test-feedback-edge.sh 稳定红（W6-M2 自测被 CI 掩盖） #471」声明，在 butler 源这一面上与仓库实际状态不一致（IR-0006 收口断言与仓库实际状态不一致：state:done + acceptance.md「十条全绿」下并存 4 个未登记的 AC 级缺陷 #473 同款收口诚实性问题）；
• butler-reconcile 持续红，账本刷新/needs-human 判定链路缺 butler 证据面。

修复建议（最小变更，对齐同类先例）

# .github/workflows/butler-reconcile.yml 落盘步
- git -C ledger add "$SHADOW"
+ git -C ledger add -f "$SHADOW"

修后验证（对账基准）：

1. butler-reconcile 绿跑 → .github 仓出现 butler-ledger 分支；
2. governance/butler/shadow-evidence.jsonl 在分支上存在且链验证通过；
3. evidence-query.sh --json 的 by_source.butler ≥ 1。

关联

• 父 IR：IR-0006: 治理战略总纲吸收——三面分离治理架构、证据账本统一与云内网入图（六波次总图） #402（AC-4 / BEH-03 / W1-B2）
• 前序：IR-0006 独立实证：evidence-query metering 源 KeyError（AC-4 未满足）+ test-feedback-edge.sh 稳定红（W6-M2 自测被 CI 掩盖） #471（butler 源恒 0 首次登记）、fix: IR-0006 验收缺陷五连修——预算执法/metering 源/gate 逐测/retention/checkpoint（ADR-0103） #474（本面修复，遗漏 -f）
• Spec：specs/IR-0006/spec.md AC-4

附：本次独立验收已通过的其余面（供对照）

AC-1/AC-2/AC-3（verify_evidence 链完整 OK）/AC-5/AC-6/AC-7/AC-8/AC-9（#470/#472 修复后实测 fail-closed 生效：wallclock 超限 rc=4、human_minutes 转 unenforced_dims 可见）/AC-10 均以代码+运行实测通过；IR-0006 suite 14/14、test-wave-schema/test-cost-wave-channel/test-feedback-edge/test-evidence-shadow 全绿。本 issue 仅报 butler 源这一残留面。