Part 8（最終章）　本物の Rigor へ

ここまで、前編で動く最小版を作り、後編でその裏にある理論（双方向、部分型と変性、ジェネリクス、再帰型、推論、FactStore、健全性）を回収しました。最後に、chibirigorの最小版と、本物のRigorの作り込みの間に橋を架けます。「ここから先、実用ツールは何を足すのか」を見渡して締めます。

8-1. 私たちが作ったもの、作らなかったもの

chibirigor（前編）は、Prism＋数百行で、こう積み上げました：

部品	前編での最小版	Rigorの本物
式の型付け	`type_of`（合成`⇒`）	`ExpressionTyper`（純粋、非破壊）
受理判定	`accepts`（三値）	`accepts`＋`AcceptsResult`（三値＋理由）
型環境	`Scope`（Hash）	`Scope`＋`FactStore`（6バケツ、stability）
メソッド解決	手書き表→ミニRBS	`MethodDispatcher`（多段ティア、RBS、継承）
型キャリア	7種	多数（`Refined`、`Intersection`、`App`、…）

最小版は「骨格を忠実に、肉は最小限」でした。骨格（双方向、gradual、フロー、RBS境界）は本物と同じです。ここから実用ツールになるには、何が要るかを見ていきます。

8-2. 実用ツールが足すもの

理論ではなく工学の層です。chibirigorは意図的にこれらを切り捨てました。ここからは「読むなら、どのADRから」を具体的な次の一歩として示します（ADRはRigorの設計判断記録で、リポジトリのdocs/adr/にあります）：

足すもの	何を解く工学か	入口のADR
プラグイン機構	Rails、RSpec、dry-rbのDSL、マクロ、open classを、コアを汚さず外から型付け	ADR-2（拡張API）→ ADR-37（インターフェース分離）→ ADR-9（プラグイン間連携）
マクロ／DSL展開	`attr_accessor`や`Data.define`等の生成メソッドを型付け	ADR-16（マクロ展開）／ADR-48（`Data`、`Struct`折りたたみ）
キャッシュ／インクリメンタル	大規模コードを毎回全解析しない	ADR-6（永続キャッシュ）→ ADR-45（unchanged高速パス）→ ADR-46（増分解析）
LSP（エディタ統合）	型エラーのリアルタイム表示、補完、ホバー	ADR-19（Language Server同梱）
CI連携	SARIF、GitHub、GitLab等、各CIが読める出力	ADR-51（CI出力形式）／ADR-27（配布）
baseline／オンボーディング	既存コードへの後付け導入（前編Part 9のbaselineの本式）	ADR-22（baseline＋オンボーディング）
性能	アロケーション削減、並行解析で実用的な速さ	ADR-44（アロケーション）／ADR-15（Ractor/fork）／ADR-50（性能ゲート）

これらは「型システムそのもの」ではなく「型システムを応用した機能」です。『しくみ』も冒頭（本書の背景と目的）で、エディタ支援は型システムの特性ではなく応用だと釘を刺しています。chibirigorがこれらを非対象にしたのは、最小版の主旨を守るためでした。

読み進める順は、§8-2の表から興味のある行のADRを1本開くのがいちばん早い道です。どれも「なぜそう設計したか」が物語として書かれています。

8-2-a発展ノート：極小プラグインフック（`Chibirigor.register_method`）

上の表の「プラグイン機構」だけをchibirigorに最小実装してみましょう。本物のRigor ADR-2が「拡張APIをコアから分離する」という設計判断をした理由が、腑に落ちるはずです。

何をするか　Dispatch::METHODSはRbs.loadで生成される読み取り専用のカタログです。ここに直接書き込むと、テスト間の干渉、ライブラリ固有の型情報の混入など、_コアを汚す_問題が起きます。代わりに、外から合成するレジストリを1つ用意します。

Chibirigor.register_method(
  :String, :shout,
  params:  [],
  returns: Chibirigor::Type::Nominal[:String]
)

Chibirigor.annotate('"hello".shout')
#=> 最後の式の型は String（登録した戻り型が効いている）

仕組み（lib/chibirigor/plugin.rb抜粋）

module Plugin
  @registry = {}

  module_function

  def register_method(klass, name, params:, returns:)
    @registry[[klass, name]] = { params: Array(params), returns: returns }
  end

  def registry = @registry
  def reset! = @registry.clear
end

Dispatch#dispatchはPlugin.registry[key] || METHODS[key]の順で参照します。これだけで「プラグインが優先、コアは不変」が成り立ちます。

FPゼロの保証　Plugin.registryにないメソッドは従来通りMETHODSに委ねます。METHODSにもなければDynamic（untyped）に倒れます。前編の「知らなければ静かにuntyped」という約束は、ここでも守られます。

実Rigorとの対比　chibirigorの「1点のレジストリ」は、Rigor ADR-2の拡張APIの骨格に対応します。本物はDSL、ライフサイクル、プラグイン間連携（ADR-9、37）が加わりますが、「コアのカタログとプラグイン由来の情報を分けて持つ」という設計軸は同じです。

8-3. 設計判断はADRに残る

実用ツールは、無数の設計判断の積み重ねです。RigorはそれをADR（Architecture Decision Record）として記録します。「なぜopen classを許すか」「なぜRactorでなくforkか」「なぜbaselineをこう設計したか」。

chibirigorを作り終えたいま、RigorのADRを読むと、その多くが前編、後編で出会った緊張の具体的な解決だと分かります：

まず全体像をつかむなら ADR-0（基盤、設計原則の出発点）→ ADR-4（型推論エンジンの仕組み）
- この2本が、あとの全ADRの地図です
「誤検知をどう避けるか」（前編Part 4、6、後編Part 7（わざとunsound））を追うなら、読むなら ADR-5（ロバストネス原則）／ADR-22（baseline）
「再帰、推論をどう止めるか」（後編Part 4（fuel）、Part 7（予算））を追うなら、読むなら ADR-20（軽量HKT）／ADR-41（推論予算の設計、未実装）
「RBSとどう付き合うか」（前編Part 8、後編Part 3（erasure））を追うなら、読むなら ADR-14（sig-gen）／ADR-25、32（プラグインRBS、inline RBS）
「フロー事実をどう持つか」（後編Part 6（FactStore））を追うなら、読むなら ADR-46（増分依存グラフ）と内部仕様inference-engine.md

理論で「なぜそう作るか」が腑に落ちた目で実装を読むと、ADRの一つ一つが物語として読めます。

8-4. ここまでの全体像

チュートリアルの二巻を、一枚に：

前編The Little chibirigor … 動く最小版。Prism＋数百行で、checkとannotateが動くまで
- 易しさ、複雑さ予算、FP規律を、最小実装で体感する
後編The Seasoned chibirigor … その裏の理論。双方向、部分型と変性、ジェネリクス、再帰型、推論、FactStore、健全性を、用語と形式で回収する

そして本物のRigorは、この骨格に、プラグイン、キャッシュ、LSP、性能、ADRという作り込みを重ねた、実用規模の漸進的型チェッカーです。

8-5. 締め　三つの入口

最後に、この旅の地図をたどります：

『しくみ』／『TAPL』の終着点が、chibirigorの出発点。静的で健全なチェッカーのその先としてgradual typingから私たちは始めました（必須ではないが、併読すると地続きに読めます）。
chibirigorの出発点が、Rigorへの入口。最小版で骨格を手で作ったいま、本物のRigorの実装は「拡大した同じ骨格」として読めます。
そしてRigorの入口は、Rubyの型付けという、まだ続く道の入口。漸進的型付けは研究も実装も現在進行形です。

ここまで作り切ったなら、あとは本物のRigorのコードを開いて、ExpressionTyperの最初のcaseを読んでみてください。前編で書いたtype_ofの、見慣れた形がそこにあるはずです。

8-6. まとめ（後編全8章）

Part	回収した理論
1	双方向型付け（`type_of`＝`⇒`／`accepts`＝`⇐`、診断は照合位置のみ）
2	部分型と変性（width/depth、戻り共変、引数反変、gradual consistency）
3	ジェネリクスと型代入（α 同値、変数捕獲、fresh、erasure）
4	再帰型（μ、余帰納 ↔ HKT/fuel。HKTの根拠は『TAPL』29章）
5	本物の型推論（capability/duck、制約ベース、自明な範囲だけ）
6	完全なFactStore（6バケツ、stability、クロージャ捕獲、join）
7	健全性、正規化、そして「わざとunsound」＋gradual guarantee
8	実用ツールへの橋（プラグイン、キャッシュ、LSP、性能、ADR）

演習

次のADRを1本選ぶ：§8-2の表から、自分がいちばん気になる行を1つ選び、その入口ADRを開いて「どの設計判断が、後編のどの章の緊張に対応するか」を1つ書き出せ。
骨格の対応づけ：§8-1の対応表（chibirigor ↔ Rigor）から1組選び、前編で自分が書いたコード（例：accepts）が、本物のRigorで何という部品に育っているかを述べよ。
地図を描き直す：この二巻で学んだことを「①前編で作った ②後編で読み解いた ③Rigorで作り込まれている」の3段で、自分の言葉で3行にまとめよ。

The Little chibirigorで動かし、The Seasoned chibirigorで腑に落ち、そしてRigorへ。ここで地図は閉じます。

Part 8（最終章） 本物の Rigor へ