[takemi-ohama]

概要

スプリント m8b（#472）の確定仕様化。設計と要求を確定仕様へ取り込み、issues/ の作業文書を消す。コードは変えない。

課題	確定仕様	主な追記
#458	docs/specifications/snapshot-series.md	世代の作り直しになる 3 つの場面、決定 1〜5 の結論と理由、入れ替えの途中で止まった世代の状態の表、常に成り立つ条件、rebuilding の互換、#466・#473 の現状、テスト観点
#295	docs/specifications/secret-backend.md	構成要素（container_bao_address・_host_gateway_kwargs・雛形）、決定の結論と理由、雛形 5 つの表、accessor での token の失効、常に成り立つ条件、試用の運用、テスト観点
#453	docs/specifications/cli-argument-resolution.md	決定 18（--context の欠けと余分の両方を比べ、余分は末端の道に限る）、テスト観点、関連リンク #471

削除: issues/issue-458-{design,requirements}.md・issues/issue-295-{design,requirements}.md

設計と実装の差で実装に合わせたところ

• 既存の世代の名前で snapshot create --full を打つと、full.tar.zst が変更分だけになり復元でファイルを失う #458: 控えのコマンドを checked_backup_command で包み tar の失敗も拾う（設計は pipefail 無し）。snapshot.yml の更新で volumes も書き直す。復元前バックアップの失敗で消すのはその呼び出しで作ったディレクトリだけ
• OpenBao backend を、利用者が個人・チームで自分のサーバを立てて使う前提の文書と雛形に揃える #295: 決定 4 — network_mode: host の dev サービスには置き換えも extra_hosts も当てない。判定は container_bao_address・_host_gateway_kwargs が行う。文書に実の値を書かないこと・組織名が無いことは pytest ではなくレビューと固有の語の検査で見る

検査

• env -u DEVBASE_ROOT uv run --locked pytest tests/ -q: 4303 passed, 28 skipped
• uvx ruff check --select=E9,F63,F7,F82 lib: All checks passed
• python3 .github/scripts/proper_term_check.py: 語の一覧が無いため飛ばした（検査していない）。例の名前は中立名（member01・personal など）だけ
• 一致テストが補完の --context の余分を比べず、--context を取らない道で補完が --context を勧めても落ちない #453 の観点は担当が一時コピーで bash・zsh の env set に --context を足し、2 件落ちることを確かめた

CHANGELOG: 開発者向けの文書だけのため書かない。

🤖 Generated with Claude Code

https://claude.ai/code/session_0111uDyVMhJts3mForKPjcUX