#374 を実装する（スプリント m8d）

[takemi-ohama]

devbase の起動でコンテナを待つ処理が時間切れになったとき、文言に待ちの巡の回数と実際に経過した秒数を出すようにしました（#374）。新しい文言は確定仕様（docs/specifications/post-start.md）と CHANGELOG にも書いています。この変更はスプリント m8d のブランチへ集めます。

利用者向けの変化

• 起動の待ちが時間切れになると、それまでに待った巡の回数と実際に経過した秒数が文言に出ます。

移行の手順

• 無し

変更の要点

• lib/devbase/utils/docker.py: 時間切れの文言に巡の回数と実際の経過の秒数を含めるようにしました。
• tests/utils/test_wait_for_containers.py: 新しい文言を確かめるテストを足しました。
• docs/specifications/post-start.md: 確定仕様に時間切れの新しい文言を書きました。
• CHANGELOG.md: 新しい文言を書きました。

テスト

• test-limited: exit 0。範囲テストは 1 本で、戦略は local-full、所要は 122.2 秒です。
• design-tests: exit 3（stopped）。起動の待ちの制限時間（60 秒）が実際の時間ではなく巡の回数で数えられている #374 には設計文書が無いため、3 つの確認は該当なしで止まりました。

設計と違う点

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

概要

devbase up / devbase scale の起動の待ちで時間切れになった番号の行を、timeout (60s) ... から
timeout after 60 rounds (73s elapsed) waiting for the entrypoint to complete の形へ変えた（#374）。
2026-10-13 の利用者の決定に従い、数え方（1 秒休む巡の回数・上限 60）と打ち切りの条件は変えていない。

変えたこと

• StartupFailure に elapsed: int = 0 を足した（既定値つき）。待ちを始めてから時間切れが決まるまでの秒数を
  time.monotonic で測り、端数を切り捨てた整数で入れる
• 終了した・見つからないの文言、見出しの行、例外の型と ready・failures、引数と戻り値は変えていない
• 確定仕様 docs/specifications/post-start.md の文言の表・例・数え方の説明・クラス図を合わせた
• CHANGELOG.md の [Unreleased] の Fixed に書いた

設計との違い

設計なし（要求の受け入れ条件どおり）。課題の「直す場所」にある「経過時間で打ち切る」は、利用者の決定により行っていない。

確かめたこと

• 時計と time.sleep を差し替えたテストを 2 件足した（docker の呼び出し 1 回 0.65 秒で 60 巡 → 138s elapsed、
  端数の切り捨て）。test_rounds_do_not_exceed_the_limit は変えずに通る
• env -u DEVBASE_ROOT python3 -m pytest -q tests: 4389 passed, 32 skipped
• 実機での devbase up は打っていない（作業の制約）

残した事項

• 経過時間で打ち切る形への変更（と制限の値の見直し）は行っていない

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

🤖 Generated with Claude Code