[takemi-ohama]

Pull Request

Summary

スプリント m8a（#462 でマージ済み）の確定仕様化。#455・#368 の要求・設計のうち確定仕様に未反映だったものを確定仕様へ移し、issues/ の元 4 ファイルを消す。コードは変えない。

関連 Issue

• zsh の補完の実際の候補を確かめるテストが無く、分岐の文字列はそろっていても候補が出ない退行を拾えない #455 スナップショットが作り直せるキャッシュ・一時ファイル・ログまで控える（除外の仕組みが無い） #368（いずれも スプリント m8a #462 で閉じ済み）

変更点

• cli-argument-resolution.md（zsh の補完の実際の候補を確かめるテストが無く、分岐の文字列はそろっていても候補が出ない退行を拾えない #455）: 実装 PR #455 を実装する（スプリント m8a） #460 で補完の実行テストの小節・テスト観点・決定 14〜17 まで反映済みだった。未反映は関連リンクだけで、課題 zsh の補完の実際の候補を確かめるテストが無く、分岐の文字列はそろっていても候補が出ない退行を拾えない #455 へのリンクを実装 PR #455 を実装する（スプリント m8a） #460 へのリンクに差し替えた（#455 を実装する（スプリント m8a） #460 の本文の「設計と違う点」で、PR 番号が決まってから差し替えると残していたもの）
• snapshot-exclude.md（スナップショットが作り直せるキャッシュ・一時ファイル・ログまで控える（除外の仕組みが無い） #368、新規）: 実装 PR #368 を実装する（スプリント m8a） #461 で確定仕様に入っていたのは snapshot-series.md の積み先の順 4a だけだった。除外の一覧の確定仕様を新しく書いた
  • 構成要素とクラス図（構造改善の後の形: _exclude_resolution・_excludes_differ・_incremental_block_reason・_latest_recorded_excludes・canonical・_load_user_excludes・_read_exclude_values を図に足した）
  • 常に成り立つ条件 I1〜I9、既定の除外 10 個と控えるもの、normalize の順、tar へ渡す形と --anchored --no-wildcards-match-slash を置く理由、世代の記録と差分の止め方、読めない設定の間の扱い
  • meta.yml の exclude・backups/exclude.yml の形、ログと SnapshotError の文言、運用（移行・切り戻し・除外を変えたときのローテーション・受け入れ条件 9 の確認で分かった CLI の振る舞い・既存の世代の名前で snapshot create --full を打つと、full.tar.zst が変更分だけになり復元でファイルを失う #458）、テスト観点
  • 設計の決定 1〜7 は結論と理由だけを該当の節に溶かした
• snapshot-series.md: 順 4a の説明と関連リンクから snapshot-exclude.md へつないだ
• 用語集: 除外の一覧・既定の除外・利用者の除外・除外のパターンの出所を snapshot-exclude.md へ移し、docs/glossary.md を作り直した（spec-finalize が行った）
• issues/issue-455-requirements.md・issue-455-design.md・issue-368-requirements.md・issue-368-design.md を削除

設計と違う点

• zsh の補完の実際の候補を確かめるテストが無く、分岐の文字列はそろっていても候補が出ない退行を拾えない #455: 決定 1〜4 との違いは無し。設計の処理の流れの「プロセスのグループごと終える」は、実装が子孫を辿って終える形で、確定仕様は実装どおり「起動した zsh とその子孫を終える」と書いてある（#455 を実装する（スプリント m8a） #460 の本文）
• スナップショットが作り直せるキャッシュ・一時ファイル・ログまで控える（除外の仕組みが無い） #368: 決定 1〜7 との違いは無し（#368 を実装する（スプリント m8a） #461 の本文の担当の覚え書き）。設計のクラス図は構造改善（ef7a59a ほか）の後の形に合わせた

利用者向けの変化

• 無し

移行の手順

• 無し

Test plan

• env -u DEVBASE_ROOT uv run --locked pytest tests/ -q → exit=0（4230 passed, 24 skipped）
• uvx ruff check --select=E9,F63,F7,F82 lib → exit=0
• python3 .github/scripts/proper_term_check.py → exit=0。ただし「語の一覧が無いため飛ばした」と出ており、検査はしていない。実機の記録の固有の名前（グループ名など）は確定仕様に書いていない

モード: standard / 通した工程: 確定仕様化