main リポの未コミット作業は reset で消さず、PR として救出する:auto-pull が守る順番
この記事について
運用機にある main リポジトリは、origin/main のミラーとして扱っている。自動 pull(scripts/main_repo_autopull.sh)が追従させるが、分岐や未コミットの差分が出ることがある。2026-07-31 には、main リポでコミットした結果、分岐して auto-pull が止まる実害が2件あった。差分を reset で消すと本物の作業まで失うので、消さずに PR として救出する経路を作った。その順番と、止める条件を記録する。
前提:書き込み先ではない
main リポは書き込み先ではない。反映は「PR をマージし、各機が auto-pull で受け取る」形で届く。それでも、他のセッションの作業ファイルが落ちていたり、直接コミットされたりして、fast-forward で進めなくなることがある。
分岐していて、origin に無い本物の作業を含む場合、auto-pull は触らず、「reset 禁止・PR 化して救出」と明記して通知する。
救出の順番
安全性の本体は順番にある。
- 静止ガード: 直近の一定時間に触られたファイルが1つでもあれば、編集中とみなして何もしない。編集の途中を横から退避しない。既定は20分で、
MAIN_REPO_AUTOPULL_QUIET_MINUTESで変える - 先に stash: 捨てる前に必ず
git stash push --include-untrackedで退避する。判定を誤っても、中身は stash と reflog から戻せる - 救出ブランチへ: 一時 worktree で
rescue/ブランチに載せて push し、PR を立てる - 後始末: stash を drop するのは push が成功したときだけ。失敗したら stash を残して通知する
# 退避時に付く stash の名前
autopull-dirty-rescue <日時> on <ホスト名>
見落としやすい点:未追跡は stash の第3親にある
未追跡ファイルは stash 本体ではなく、第3親(stash^3)に入る。ここを見落とすと、origin/main と同一内容の blob を「救出」と誤認し、毎朝空コミットと空の rescue ブランチを作ることになる。救出するかどうかの判定は、origin/main の blob と照合して行う。
通知の閉じ方
救出に失敗した場合は Issue を立てる。取り下げる条件は「fast-forward できた」ではなく、「救出待ちの stash が残っていない」ことにした。fast-forward を条件にすると、人が stash を見る前に、次の回(20分後)で閉じてしまう。人がやるべきことは stash の中身の救出で、済んだかどうかは stash の有無で機械的に分かる。stash の一覧が読めなかった回は、読めないことが「残っていない」の証明にならないので、取り下げない。
止め方
MAIN_REPO_AUTOPULL_DIRTY_RESCUE=off # 旧来の警告だけに戻す
回帰テスト
scripts/test_main_repo_autopull_stray.py が、未追跡の取り残しなどの経路を見る。救出の分岐と手順は、プロジェクトのスキル main-repo-autopull に書いてある。
現時点のステータス
- 実装済み: 救出経路(stash → rescue ブランチ → PR)、救出失敗の Issue 起票と閉じ方
- 調整可能: 静止時間(
MAIN_REPO_AUTOPULL_QUIET_MINUTES)、救出の on/off