設定

Rigorはプロジェクトルートから単一のYAML設定ファイルを読み込みます。rigor initでスターターファイルを生成できます。

探索と優先順位

--configフラグなしの場合、Rigorは以下の順に探索します:

.rigor.yml
.rigor.dist.yml

最初に見つかったファイルが優先されます——両者はマージされません。慣例として.rigor.dist.ymlを共有プロジェクト設定としてコミットし、個々の開発者が（追跡されない）.rigor.ymlをローカルで上書きするために配置します。

設定を置き換えではなく継承するには、設定ファイルでincludes:（再帰的）を使ってベースを指定できます。--config=PATHは探索を完全にバイパスします。

設定ファイル内のすべての相対パスは、そのファイル自身のディレクトリを基準に解決されます。

最小限の設定

target_ruby: "4.0"
paths:
  - lib
plugins: []
cache:
  path: .rigor/cache

キーリファレンス

ソースとターゲット

キー	型	デフォルト	意味
`target_ruby`	String	`"4.0"`	自分のプロジェクトが実行するRubyバージョン——`"X.Y"`、`"X.Y.Z"`、または`"latest"`。Rigor自体が動作するRubyとは独立。
`paths`	Array	`["lib"]`	解析するディレクトリまたはファイル。
`exclude`	Array	`[]`	スキップするGlobパターン。`vendor/bundle`、`.bundle`、`node_modules`は常に除外される。
`includes`	Array	`[]`	このファイルの下に継承する他の設定ファイル。
`fold_platform_specific_paths`	Boolean	`false`	ソース探索時にRubyバージョン条件付きロードパスを解決する。

型ソース

キー	型	デフォルト	意味
`libraries`	Array	`[]`	バンドルされたRBSを読み込む標準ライブラリ/gem名。
`signature_paths`	Array	`nil`	`.rbs`ファイルの追加ディレクトリ。
`pre_eval`	Array	`[]`	ファイルごとの解析前に走査するファイル（またはglob）。プロジェクトのモンキーパッチを登録するために使用。
`plugins`	Array	`[]`	有効化するプラグイン——プラグインの使い方を参照。

診断

キー	型	デフォルト	意味
`disable`	Array	`[]`	プロジェクト全体で抑制するルールIDまたはファミリー。
`severity_profile`	String	`"balanced"`	`lenient`、`balanced`、または`strict`——診断を参照。
`severity_overrides`	Hash	`{}`	ルール/ファミリーごとの重要度。例: `{ call: warning, flow.always-truthy-condition: off }`。
`baseline`	String / `false`	`nil`	`.rigor-baseline.yml`へのパス、または`false`で継承されたベースライン（baseline）を無効化。ベースラインを参照。

依存関係RBS探索

キー	型	デフォルト	意味
`bundler.auto_detect`	Boolean	`true`	Bundlerのインストールパスとlockfileを自動検出する。
`bundler.bundle_path`	String	`nil`	明示的なBundlerインストールルート。
`bundler.lockfile`	String	`nil`	明示的な`Gemfile.lock`パス。
`rbs_collection.auto_detect`	Boolean	`true`	`rbs_collection.lock.yaml`を自動探索する。
`rbs_collection.lockfile`	String	`nil`	明示的な`rbs_collection.lock.yaml`パス。
`dependencies.source_inference`	Array	`[]`	gem単位のソース推論モード（ADR-10）。
`dependencies.budget_per_gem`	Integer	`5000`	gem単位のソースウォーク上限。時間ではなくメソッド定義の個数で数えます。ウォーカーはgemのカタログを収集する際、この個数の`def`に達するとそれ以上の収集を停止し、`dynamic.dependency-source.budget-exceeded`を発行して残りを`Dynamic[top]`に縮退させます。範囲は1250〜20000です。

実行

キー	型	デフォルト	意味
`cache.path`	String	`.rigor/cache`	永続キャッシュディレクトリ。キャッシュを参照。
`parallel.workers`	Integer	`0`	ファイルごとの解析用の並列ワーカープロセス（現在はfork方式のプール、ADR-15）。`0`は逐次処理。CLI `--workers`と`RIGOR_RACTOR_WORKERS`が優先される。
`plugins_io.network`	String	`"disabled"`	プラグインネットワークポリシー——`disabled`または`allowlist`。
`plugins_io.allowed_paths`	Array	`[]`	プラグインが読み取り可能なファイルシステムパス。
`plugins_io.allowed_url_hosts`	Array	`[]`	`network: allowlist`のときプラグインがフェッチ可能なURLホスト。

設定例

target_ruby: "3.4"
paths:
  - lib
  - app
exclude:
  - "**/*_pb.rb"
plugins:
  - rigor-activerecord
  - rigor-rspec
severity_profile: balanced
severity_overrides:
  flow.dead-assignment: warning
baseline: .rigor-baseline.yml