内容は同じなのに PR が CONFLICTING になる — CRLF 混入の見かけ上の衝突を安全に解消する

この指示書が解決すること

GitHub で PR が mergeable: CONFLICTING と表示されるのに、衝突ファイルの中身を見比べると同じに見える。 原因の大半は、別のコミットがファイル全体の改行コードを CRLF↔LF に書き換えており、 git からは「全行が変更された」ように見えていること。これを 元の修正を壊さずに 解消し、再発を止める手順。

AI（Claude Code / Codex など）にこのファイルを読ませれば、以下をそのまま実行できる。

判定（まずこれで原因を確定する）

# 衝突している側のコミット（例: BASE..TARGET）で、空白・改行の違いを無視すると差分が消えるか
git diff --ignore-all-space BASE TARGET -- path/to/file | grep -c '^[-+][^-+]'
# → 0 なら「改行コードだけの差分」。1 以上なら本物の変更が混じっている（下の手順は使わない）

# CR バイトの有無（PowerShell / MSYS でも壊れない書き方）
git show TARGET:path/to/file | tr -cd '\r' | wc -c

$'\r' を grep に渡す書き方は、sh 経由だと unexpected EOF で止まることがある。tr -cd '\r' | wc -c を使う。

解消（修正の中身を触らずに rebase する）

git fetch origin && git fetch <fork-remote>
git checkout -B <branch> <fork-remote>/<branch>
git rebase -X renormalize origin/main

-X renormalize は、両側を .gitattributes の text 設定で正規化してから 3-way merge する。 改行コードだけの差分は衝突にならず、本物の修正だけが乗る。

検証（必ずやる）:

git diff --ignore-all-space --stat origin/main <branch>   # 元の修正ファイルだけが出ればよい
grep -rl '^<<<<<<<\|^>>>>>>>' src test                     # 0 件
git show <branch>:path/to/file | tr -cd '\r' | wc -c       # 0 なら LF に揃っている
npm test                                                   # 既存テスト全件 pass
git push --force-with-lease <fork-remote> <branch>

GitHub 側の mergeable は push 直後 UNKNOWN を返す。15〜20 秒待って再取得する（最大 3〜4 回）。

gh pr view <N> --json mergeable,mergeStateStatus

再発防止

.gitattributes を 1 行追加して、どの OS からコミットしても LF で保存されるようにする。

* text=auto eol=lf

注意: 既存ファイル全体の正規化（git add --renormalize .）は、開いている PR が全部マージされた後に別 PR で行う。 先にやると全行差分になり、開いている PR と再び全行衝突する。

複数の PR を同時に rebase するときの罠

• git worktree で枝ごとに作業場所を分ける。元のディレクトリでチェックアウト中の枝は worktree 側で checkout -B できない（already used by worktree）。 失敗に気づかず続けると、直後のコミットが別の枝に乗る。各ステップの後に git log --oneline -1 で枝を確認する。
• 2 本目の PR の中身が既に main に入っていた（別経路で push 済み）場合、rebase 後の差分が「改行コードの正規化だけ」になる。 その時は PR のタイトルと本文を実態（.gitattributes 追加のみ等）に書き換える。見た目の差分と説明が食い違う PR を残さない。

相手への報告文（例）

PR #N / #M の rebase が完了し、両方 MERGEABLE になりました。
原因は <コミット> が <file> の改行コードを CRLF に変えていた見かけ上の衝突で、
git rebase -X renormalize で中身を触らずに通りました（テスト <件数> pass）。
.gitattributes（* text=auto eol=lf）を #M に追加しました。
既存ファイル全体の正規化は両 PR のマージ後に別 PR で出します。