IR-0006 残留缺陷：butler 源账本不可用——butler-reconcile 影子双写 git add 被 .gitignore 拦截（butler-ledger 分支从未创建，evidence-query butler 源恒 0 条）

[randypanding]

问题

IR-0006 统一证据账本（期望变化 3 / AC-4 / 卡 #430「butler/drill 影子双写」）的 butler 源不可用：butler-ledger 分支从未成功创建，evidence-query.sh 第 3 源（butler）恒 0 条。独立复现：

• evidence-query.sh 七源实测（2026-08-30，token=owner PAT）：by_source: {butler: 0, drill: 1, elevation: 5, env: 3, feishu: 9, metering: 1, tickets: 4}，total 23——唯一缺 butler。
• butler-ledger 分支不存在（API branches/butler-ledger → Branch not found）；governance/butler/shadow-evidence.jsonl 从未落盘。
• 但书双写工作流 butler-reconcile 连续 4 次失败（含 fix: IR-0006 验收缺陷五连修——预算执法/metering 源/gate 逐测/retention/checkpoint（ADR-0103） #474 修复后重试仍红）：
  • 33263640232（08-29 16:41）ledger/governance/butler/shadow-evidence.jsonl: No such file or directory（目录缺位）
  • 33274629909（08-29 20:53）同上
  • 33290785868（08-30 03:40）同上
  • 33292355351（08-30 04:23，fix: IR-0006 验收缺陷五连修——预算执法/metering 源/gate 逐测/retention/checkpoint（ADR-0103） #474 修复后手动重试）→ 仍失败，但换为 git add 被忽略拦截：

根因（代码证据）

.github/.gitignore 第 14 行忽略本地影子文件（持久化真源在 *-ledger 分支，设计正确），但但书写入路径未按同仓先例加 -f：

# .gitignore
governance/butler/shadow-evidence.jsonl     # 第 14 行
governance/feishu/shadow-evidence.jsonl
governance/env/shadow-evidence.jsonl
governance/feedback/shadow-evidence.jsonl

# .github/workflows/butler-reconcile.yml:80 —— 缺 -f → git add 被 ignore 拦截，exit 1
git -C ledger add "$SHADOW"

对比同仓其他 *-ledger 写路径均正确使用 -f：

• feishu-drill.yml:82 git -C ledger add -f "$SHADOW"（fix: feishu-drill 账本 add 加 -f（W3-F1 实测缺陷之二） #449 正是为此加的 -f）
• env-drift.yml:133 git -C ledger add -f "$SHADOW"
• feedback-edge.yml:70 git -C ledger add -f "$SHADOW"
• （elevation/drill 影子文件不在 .gitignore，故无 -f 也可）

#474「五连修」只补了 mkdir -p "$(dirname "$BASE")"（修复目录缺位），未补 -f——修复不完整，butler 源仍然恒 0。

影响

• IR-0006 期望变化 3「三源事件可按同一 schema 查询」（metering/butler/drill）中 butler 源缺失；acceptance.md 声称「evidence-query.sh 七源一条命令」，实测 only 六源有数。
• 卡 feat: butler/drill 影子双写 + 三源统一查询（W1-B2 后半，IR-0006） #430（W1-B2 butler/drill 影子双写）只完成 drill 半边。
• 但书审计事件（butler-audit.sh 发射）丢失——AUDIT 行仅存在于 runner 临时 shadow，从未持久化。

建议修复

butler-reconcile.yml:80 改为 git -C ledger add -f "$SHADOW"（同 #449 feishu 先例，squash 后 1 行变更）；并建议补一条但书双写的离线断言（test-butler 类：gitignore 中文件被 add 时必须 -f），防同款回归。

关联

• 父意图：IR-0006: 治理战略总纲吸收——三面分离治理架构、证据账本统一与云内网入图（六波次总图） #402（IR-0006）
• 卡：feat: butler/drill 影子双写 + 三源统一查询（W1-B2 后半，IR-0006） #430（W1-B2 影子双写）
• 关联缺陷：IR-0006 独立实证：evidence-query metering 源 KeyError（AC-4 未满足）+ test-feedback-edge.sh 稳定红（W6-M2 自测被 CI 掩盖） #471（evidence-query metering 源，已修）、fix: feishu-drill 账本 add 加 -f（W3-F1 实测缺陷之二） #449（feishu 账本 add 加 -f，先例）
• 上一修复：fix: IR-0006 验收缺陷五连修——预算执法/metering 源/gate 逐测/retention/checkpoint（ADR-0103） #474（补 mkdir，未补 -f）