CI で rake sig と steep check を回す

[znz]

解決したい問題

#231 で sig/ が lib/ の全宣言をカバーし、steep check が
エラー 0・警告 0 になりましたが、CI では型検査を回していないため、
今後の変更で sig の追従漏れや型エラーが入っても検出できません。

変更内容

typecheck ジョブの追加

test.yml に typecheck ジョブを追加します(既存ジョブは変更なし):

1. bundle exec rake rbs:install — rbs_collection.lock.yaml で
   固定された gem_rbs_collection を取得
2. bundle exec rake sig — rbs prototype rb → rbs subtract の
   残余ゼロ = sig が lib の全宣言をカバーしていることの検査
   (新しいクラス/メソッド/ivar を追加して sig を書き忘れると失敗します)
   • rbs validate
3. bundle exec steep check — 型エラーで失敗

ドキュメントだけの変更で CI を回さない

doctree の ci.yml と同様に、on: へ paths-ignore を追加し、
doc/・README.md・ChangeLog だけの変更では既存の test / rurema ジョブ含め
ワークフロー全体をスキップ**します(doc/ 配下は設計文書・MARKUP_SPEC 等のみで、
テストフィクスチャやランタイムが参照するファイルはありません)。

備考

• Ruby はテストのバージョンマトリクスとは独立に、最新安定版の
  3.4 固定です(型検査は1バージョンで十分。バージョン網羅は
  build ジョブが担います)
• rbs / steep のバージョンは Gemfile.lock(rbs 3.10.3 / steep 1.9.4、
  Gemfile で steep ~> 1.9.0)で固定されており、bundler-cache: true で
  そのまま再現されます。rbs のメジャーアップ時に prototype の出力形が
  変わっても、lock を更新するまで CI は影響を受けません
• sig 書き忘れ時の rake sig の失敗は Errno::ENOTEMPTY(sig-prototype の
  rmdir 失敗)として現れます。残余ファイルが sig-prototype/ に残るので、
  ローカルで bundle exec rake sig を実行すると不足分が確認できます

検証

• ローカル(rbs 3.10.3 / steep 1.9.4)で 2→3 の手順を実行し、
  rake sig 通過・steep check は "No type error detected" を確認
• ワークフロー YAML のパースを確認
• (rake rbs:install はこの作業環境のネットワーク制限で最終確認できて
  いないため、CI の初回実行で要確認)

🤖 Generated with Claude Code

[znz]

CI の typecheck 失敗(steep check の RBS::DuplicatedDeclaration 48件)を調査し、修正コミットを追加しました。

原因

rbs collection install がコミット済みの rbs_collection.lock.yaml を使わず
Gemfile.lock から再解決しており、path gem である bitclust-core が sig/ を
持つため「gem 同梱 RBS」としてコレクションに追加されていました
(ログの Using bitclust-core:1.4.0 (.../bitclust/sig)。ローカルの lock には
bitclust-core は入っていないため手元では再現しません)。

その結果 steep が Steepfile の signature "sig" とコレクション経由で
同じ sig/ を二重ロードし、class 宣言はマージされるのに対して
interface・type エイリアス・定数はマージ不可のため、全 sig ファイルで
重複宣言エラーになりました。なお直前の rake sig 内の rbs validate は
コレクションしか読まない(sig/ を1回しかロードしない)ため通過していて、
steep だけが落ちる形になっていました。

修正

• rbs_collection.yaml: bitclust-core / bitclust-dev / refe2 に
  ignore: true を追加。再解決しても自分自身の sig/ を取り込まなくなります
• CI: rbs collection install --frozen に変更し、lock のとおりに取得。
  再解決による gem_rbs_collection(revision: main)の変動も防ぎます
• あわせて typecheck の Ruby バージョンのコメントを修正しました。
  3.4 は「最新安定版」ではなく、rbs 3.10 / steep 1.9 のロックを検証した
  環境という意味です(型検査は1バージョンで十分で、バージョン網羅は
  build ジョブが担います。4.0 への引き上げは steep/rbs のロック更新と
  合わせて別途検証するのが安全と判断しました)

ローカルで rbs collection install --frozen(bitclust-core が入らない
25 gems になること)→ rake sig → steep check エラー0を確認済みです。