0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

git filter-repoによる全損からの復旧

0
Last updated at Posted at 2026-11-16

冒頭詩篇 — 座右の姪「探偵は推理をしてはいけない」

「探偵は推理をしてはいけない。証拠となりうる全ての情報をかき集め、有利な情報を取り扱うのではなく、
無駄になる情報を否定する検証を行い、残った線を正とせよ。これが消去法である。
確実に真とした証拠は裁判で事実認定を取る事が可能である。」

時間や工数などコストは掛かるが、確実な正解にたどり着くことこそが最重要である。

この事故の教訓はこの詩篇そのもの——「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-only exit=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行で)

  1. FORBIDDEN: 捏造しない。 fsck で実測してから「取り返せるものなし」を主張する。
  2. FORBIDDEN: ディスクに置く。 記憶は揮発。バックアップ経路は多系統・別ドライブ分散で設計する。
  3. 不可逆操作の前にバックアップを検証せよ。 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 の重要性と不可逆操作の扱いについて参照した)

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?