ruby-version

Field	Value
Probe ID	ruby-version
Category	runtime
Severity	error
Inferred from	Gemfile (ruby 'X.Y.Z'), .ruby-version, .tool-versions, mise.toml

What it means

The repo declares a Ruby version your local interpreter doesn’t satisfy. bundle install will either refuse or silently produce a Gemfile.lock with the wrong BUNDLED WITH metadata.

How it’s detected

1. Read every supported manifest. Gemfile is regex-scanned for ruby '...' declarations.
2. ruby --version is exec’d; output like ruby 3.2.2 (...) is parsed to the version token.
3. Any mismatch produces one finding.

Common causes

• System Ruby is 2.6 (macOS pre-Sonoma) and the repo wants 3.x.
• rbenv shell not run; the shim is on PATH but the active version disagrees.
• chruby setup that requires explicit sourcing per shell.

Recipes

The probe selects one fix based on the tools available on your machine. See the YAML source for the full Fix definitions.

Fix	Class	When	Fallback
mise-install-ruby	safe	has_tool=mise
rbenv-install-ruby	safe	has_tool=rbenv
asdf-install-ruby	safe	has_tool=asdf
brew-install-ruby	shared	has_tool=brew	yes