fix: Cargo.lock差し戻しでyank済み版を再採用しない

[owayo]

概要

Rust依存の経過期間による差し戻しで、install前のCargo.lockにあったyank済み版を再採用していました。例えば、0.8.4がage未満、0.8.3がyank済み、0.8.2が利用可能な場合に、0.8.3へ戻っていました。

利用可能な同じsemver系列の版だけを下限や戻し先に使い、この例では0.8.2へ戻します。有効な候補がない場合は未解消として報告します。

原因

crates.ioアダプターはyank済み版を候補一覧から除外していますが、差し戻しの下限はinstall前のlockだけから決めていました。候補が下限より古い場合の復元処理で、除外された版を再び選んでいました。まとめ解きの最小版にも同じ下限が残っていました。

Cargoのupdate --preciseはyank済み版も選べるため、Cargoコマンドの成功だけでは防げません。Cargo公式ドキュメント

変更内容

• 下限を利用可能な版情報と照合し、個別の差し戻しとまとめ解きで共有します。
• 下限がなくても別のsemver系列へ下げないようにします。
• 利用可能なinstall前の版へ戻して今回の変更だけを取り消す既存仕様は維持します。
• 実物のCargoを使うオフライン回帰テスト3件と、互換系列・新規依存・残った利用可能な下限のテスト3件を追加します。
• 利用文書の英語版・日本語版と開発指針を更新します。

Claudeとの設計相談で、アダプターが持つ候補除外を使う案と互換系列のガードを採用しました。VersionInfoへのフラグ追加は不要です。旧版が複数ある場合は利用可能性を検査してから最大を選び、残った有効な下限を維持します。現在版の情報がキャッシュにない場合の再取得と未検証報告は既存処理で対応しています。

最終レビューで指摘された新規依存の互換系列テストと文書の説明を追加しました。公開日不明の版もアダプターの一覧から外れるため、yank済みと区別できない版を再採用せず、利用可能性を検証できる候補へ限定します。キャッシュは1回の実行内のメモリだけで、永続キャッシュによる古いyank情報はありません。

検証

• 修正前: 差し戻し・有効候補なし・まとめ解きの回帰テスト3件がすべて失敗し、不具合を再現しました。
• 修正後: 同じ3件がすべて成功しました。Cargo.lockの実際の版と、元のマニフェストでlockを受理できることも確認しています。
• make ci: フォーマット、Clippy、全2,485テストが成功しました。
• astro-sight reviewとimpact: 呼び出し元の修正漏れなし。

Closes #10

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

• Configuration used: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: c50ad503-185a-4d72-8524-6ef06bcb916e

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}