Module: RailsAiContext::BootManager

Defined in:
lib/rails_ai_context/boot_manager.rb

Overview

Boots the host Rails app by requiring config/environment.rb, with three protections a bare require lacks:

1. stdout quarantine - boot output goes to stderr so the stdio MCP
 protocol channel stays clean.
2. a timeout - initializers that block on unreachable services (a
 database, Redis) fail loudly instead of hanging the server forever.
3. a broad rescue - real-world boot failures are ScriptError
 (SyntaxError, LoadError) at least as often as StandardError; both
 become a structured Result instead of a raw crash.

Dependency-free on purpose: standalone mode loads this file before the host app's Bundler.setup runs, so it must not pull in the rest of the gem.

Defined Under Namespace

Classes: BootError, BootTimeoutError, Result

Constant Summary collapse

DEFAULT_TIMEOUT = 
60

Class Method Summary collapse

Class Method Details

.boot!(app_root: Dir.pwd, timeout: DEFAULT_TIMEOUT) ⇒ Object

Attempts to boot the Rails app rooted at app_root. Returns a Result; never raises for boot problems. SystemExit passes through - an initializer calling exit() is an explicit process-level decision.



46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
 
# File 'lib/rails_ai_context/boot_manager.rb', line 46

def self.boot!(app_root: Dir.pwd, timeout: DEFAULT_TIMEOUT)
  environment_rb = File.join(app_root, "config", "environment.rb")
  unless File.exist?(environment_rb)
    return Result.new(
      status: :failed,
      error: BootError.new("No Rails app found in #{app_root} (missing config/environment.rb)")
    )
  end

  OutputGuard.quarantine_stdout do
    Timeout.timeout(timeout) { require environment_rb }
  end
  Result.new(status: :booted)
rescue Timeout::Error
  # Timeout::Error's own message ("execution expired") names neither the
  # app nor the configured limit - wrap it so a slow-booting app produces
  # actionable guidance instead of a cryptic stdlib message.
  Result.new(status: :failed, error: BootTimeoutError.new("Boot did not finish within #{timeout}s"))
rescue StandardError, ScriptError => e
  Result.new(status: :failed, error: e)
end