[takemi-ohama]

同じ秒に復元前バックアップが重なった場合に、通し番号を付けた名前で新しい世代を作るようにしました。既にある世代を作り直すことはありません（#473）。仕様の文書も、この名前の規則に合わせて直しています。

利用者向けの変化

• 同じ秒に復元前バックアップが重なった場合は、通し番号を付けた名前で別の世代として作られ、既にある世代はそのまま残ります。

移行の手順

• 無し

変更の要点

• lib/devbase/snapshot/manager.py: 同じ秒の復元前バックアップは通し番号の名前で作り、既にある世代を作り直さないようにした。
• docs/specifications/snapshot-series.md: 復元前バックアップが重なる件を作り直しの場面から外した。通し番号の名前の規則を書き加えた。
• CHANGELOG.md: 今回の変更を追記した。
• 課題: 復元前バックアップが同じ秒の既存の世代と重なると、その世代を作り直す（復元元が pre-restore-* なら展開の前に置き換わる） #473（スプリント m8c のブランチへ集める）

テスト

• tests/snapshot/test_pre_restore_backup.py にテストを足し、tests/snapshot/test_rebuild_generation.py のテストを広げた。
• 範囲テスト（test-limited）: 1 本が通った（exit 0、134.4 秒、戦略 local-full）。
• 設計との照合（design-tests）: exit 3 で止まった。復元前バックアップが同じ秒の既存の世代と重なると、その世代を作り直す（復元元が pre-restore-* なら展開の前に置き換わる） #473 には設計文書が無いので、3 つの確認はどれも該当しなかった。

設計と違う点

• 該当なし（設計文書が無い）

設計の決定と違えたところ

• 既存の世代の名前で snapshot create --full を打つと、full.tar.zst が変更分だけになり復元でファイルを失う #458 の設計 F3（同じ秒に重なった復元前バックアップを、既にある世代の作り直しとして作る）を、課題 復元前バックアップが同じ秒の既存の世代と重なると、その世代を作り直す（復元元が pre-restore-* なら展開の前に置き換わる） #473 の「案」に置き換えました（2026-10-13 利用者が承認）。重なったら pre-restore-<時刻>-2、それも重なれば -3 … の名前で新しく作り、既にある世代には触りません。
• 「重なる」は、backups/ にその名前のディレクトリかシンボリックリンクがあるとき、または snapshot.yml にその名前のエントリがあるときです。ディレクトリの無いエントリだけが残っている名前も避けます（そのまま使うと _update_global_metadata が既存のエントリを書き換えるため）。ディレクトリは mkdir で排他的に作り、同じ秒に並んだ復元が同じ名前を取り合わないようにしました（新しい関数 _claim_pre_restore_dir）。
• 名前が決まるまでの間に失敗したとき（snapshot.yml を読めないなど）も、ほかの失敗と同じく警告 1 行で控え無しの復元を続けます。消すのは、その呼び出しで作ったディレクトリだけです。

確かめたこと

• F3 を縛っていた test_pre_restore_backup_rebuilds_an_existing_generation を 4 件のテストへ書き換えました（既にある世代とエントリが 1 バイトも変わらないこと・-2 も重なれば次の番号へ進むこと・同じ秒の pre-restore-* を復元すると打つ前の中身を展開すること・同じ秒の 2 回の復元で控えが 2 つ残ること）。manager.py を変更の前の形に戻すと、この 4 件が落ちることを確かめました。
• tests/snapshot/test_pre_restore_backup.py に 2 件を足しました（重なったときに控えが失敗しても、作った方だけを消すこと・通し番号の名前が名前の検証を通り、同じ系列で保持されること）。
• pytest tests の全件が通りました（4348 passed, 31 skipped）。実のボリュームを使う確認（devbase up・実機での restore）は行っていません。

残した事項

• 無し

モード: standard / 通した工程: 実装 → 完了判定 → Pull Request

🤖 Generated with Claude Code