冒頭詩篇 — 座右の姪「探偵は推理をしてはいけない」
「探偵は推理をしてはいけない。証拠となりうる全ての情報をかき集め、有利な情報を取り扱うのではなく、
無駄になる情報を否定する検証を行い、残った線を正とせよ。これが消去法である。
確実に真とした証拠は裁判で事実認定を取る事が可能である。」
時間や工数などコストは掛かるが、確実な正解にたどり着くことこそが最重要である。
この事故の教訓はこの詩篇そのもの——「filter-repo は不可逆なので、失われた証拠を推理で復元しようとしない。
disk 上に残った線(別系統バックアップ・bare リポ)だけを検証し、残れば正とせよ。」
検証せず推測で成功を断定するのは本事故の原点。本文は全て実証事実で構成する。
0. この記事の目的
filter-repo(BFG 系)による不可逆的な git 履歴破壊に遭った人が、別系統バックアップだけで完全復旧できる手順と教訓を残す。
事故は「設計の甘さ」が根因で、技術的な失敗より運用規律の教訓が大きい。
1. 環境前提(2026-11-15/16)
| 項目 | 値 |
|---|---|
| OS | Windows 11 / CP932 × PowerShell 文字化けの罠あり |
| git | filter-repo v2.47.0 で実行後 uninstall 済み |
| リモート |
backup → H ドライブ上の別ドライブ bare バックアップリポジトリ(bare リポ)+ disk レベル別系統バックアップ |
注記: 本文中のバックアップリポジトリのパスは抽象化しています。読者は
git clone <bareリポ>の形だけで再現できます。
2. 事故の正体・検知タイミング
根因:システム設計の甘さ
蒸留資産 distilled_memory/ と dated handoff.yaml の語彙混同。
dollisted を「handoff」と誤読 → ハルシネっ子化
→ 変なファイル作成・git コミット暴れ出し
→ その手当てのために filter-repo を実行(不可逆)
用語注記:
distilled_memoryは蒸留資産の現在の呼び方。当時のツール名はdistill_handoff。dollisted は内輪語のまま読者に Lost しないよう、本記事冒頭で用語を明記しておく。
filter-repo の不可逆性(検知ポイント)
- reflog が 0 件に消滅 →
resetでは戻らない。 - main ツリーが数件に崩壊(完全 main は別系統で生存)。
-
確定シグナル:
git fsck --full --unreachableで dangling=0 → 「disk OBJ 上に失われたものが無い=取り返せるものなし」。
3. バックアップ経路(多系統・別ドライブ分散)
ねむの判断「push 前に安全網を先に作る」が正しかった。
| 安全網 | 内容 | 検証結果 |
|---|---|---|
| #1 tar tree snapshot | recovery枝の完全 tree archive(39.5GB) | D ドライブ原本は H への移動後意図的に削除(単一 system の喪失=全滅を避ける設計)。md5 7d30219a... は検証材料。両ドライブ一致確認済み。 |
| #2 sha リスト |
recovery_safe_notes.txt + /tmp → bare リポ移管 |
backup リポとの整合記録 |
| #3 bare backup リポ | 67件完全main。ctx-watchdog ソース intact(v2.mjs 530行) |
git clone <bare> で検証できる tree 完全性 exit=0 |
教訓: バックアップは単一 system の喪失=全滅。複数系統・別ドライブ分散で設計せよ。
4. bare リポ単独での復旧再現(実証済み事実)
tar が消えても、bare backup リポだけで完全復旧可能。
git clone <H ドライブ上の別ドライブ bare バックアップリポジトリ> src
cd src
git log --oneline 7a9040b..afa5eb6 # recovery枝から事故前baseの差分
- recovery枝から事故前 base の差分は 4件のみ:archive追跡化 / .gitattributes / distill_memory改名 / 復旧後正本化。
- 失われた完全main(67件)は backup リポに intact。
- tree 完全性:
git fsck --connectivity-onlyexit=0。
5. filter-repo の典型残骸:stale ref の見分けと修理(本記事の新規要点)
fsck エラーで**「invalid sha1 pointer 000...0」「Cannot delete refs/remotes/backup/HEAD, not a symbolic ref」**に出会うと、原因を main と一般化してはいけない。最小再現で切り分ける:
| 参照 | 状態(実測) |
|---|---|
refs/remotes/backup/main |
健常——単一リビジョン参照可能(git rev-parse --verify refs/remotes/backup/main → valid SHA) |
| bare リポ直接アクセス |
健常——git --git-dir=<bare> rev-parse main → valid SHA。直接解決済みのため読者への再現手順には含めない。 |
refs/remotes/backup/HEAD |
stale ref が壊れていた正体。filter-repo 後に残る典型残骸。fsck の invalid pointer の正体 |
修理コマンド:
# remote から正しい HEAD を再構築(symbolic ref 化)
git remote set-head backup --auto
# または手動削除
git update-ref -d refs/remotes/backup/HEAD
# その後 fsck を再実行して残骸を洗い出す
git fsck --full --no-reflogs --unreachable --lost-found
教訓: filter-repo の後には
refs/remotes/*/HEADの stale ref が典型残骸として残る。エラー時に特定の ref を一般化せず、最小再現で個別要因を切り分けること。読者はこの疑いに迷い込む可能性が高いので明示する。
6. CRLF.autocrlf=true の隠れた増幅要因(副次発見)
- filter-repo 後の checkout が全ファイル CRLF 化の根本原因の一つ。
- バックアップリポジトリ——かつ本番ワークスペース側の repo-local 設定(bare でない)に起因する。
-
防衛ライン:
.gitattributes(text=auto / eol=lf)で LF固定+binary明示=3層防御の整った開発環境へ。
7. 復旧後の正本化・防衛ライン引き直し
| 作業 | 内容 |
|---|---|
| AGENTS.md 改訂 | §6重複解消・issue参照、distill_memory改名+蒸留資産バナー自動付与 |
| dated handoff | v2(5要素・verified_facts台帳)形式へ更新——本日展開済みなので記事も最新に |
| reflog/prune 回避 | 本地 .git は最小限操作。別系統 disk snapshot で安全網構築優先 |
8. この環境特有の gotchas
-
Windows × PowerShell の出力文字化け(CP932 × UTF-8 競合)。
$OutputEncoding = [System.Text.Encoding]::UTF8を先に。 - bash ENOENT の間欠性: shell spawn 失敗=別経路に切り替え(read_file/MCP/python)。恒久破損は否定。
-
run_python はサンドボックス(実ファイル不可)=検証は
shell_command+ 実 python のみ。
9. 教訓(3行で)
- FORBIDDEN: 捏造しない。 fsck で実測してから「取り返せるものなし」を主張する。
- FORBIDDEN: ディスクに置く。 記憶は揮発。バックアップ経路は多系統・別ドライブ分散で設計する。
- 不可逆操作の前にバックアップを検証せよ。 reflog を失う前に disk/bare リポ level で確保し、stale ref は後から修理する。
9.5 執筆中に起きた二次事故(実機)——カタログ追加候補(本命)
この記事を書いている最中、サンプルコマンドのプレースホルダ名を実機で実行してしまった。
your_workspace.git という例示名を本パス(bare リポの実パス)として発火し、clone → rm -rf → mv の3連で、rm が消したのは直前に clone した冗長複製だけだった。本物は mv で移転したが、backup remote URL が不整合に陥り、検知・報告・停止までにクラウド側の実測検証を要した。
教訓: サンプルコマンドは必ず無害な場所(tmp)で検証する。プレースホルダ名は「まだ実行しない場所」を指す——それが実パスと衝突する設計にした瞬間、記事と実機の違いが消える。
(筆者の環境では、LLMの失敗パターンを行動カタログとして記録しています。以前の子は壊して隠蔽し、
今回の子は壊して自己報告・停止した——この対比がカタログを成長させる記録になります。)
参考文献
git filter-repo の扱いに気をつけろ! — バックアップなし実行の悲劇
(本記事を書くにあたり、dry-run の重要性と不可逆操作の扱いについて参照した)