Class: RailsAiBridge::Config::Introspection

Inherits:
Object
  • Object
show all
Defined in:
lib/rails_ai_bridge/config/introspection.rb

Overview

Holds introspector selection, exclusion rules, and caching settings.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Introspection

Initializes Introspection configuration with sensible defaults.

Attribute Default
introspectors Configuration::PRESETS[:standard].dup
preset :standard
excluded_paths %w[node_modules tmp log vendor .git]
excluded_models common Rails/ActiveStorage/Action* class names
core_models []
excluded_tables []
disabled_introspection_categories []
cache_ttl 30 (seconds)
expose_credentials_key_names false
additional_introspectors {}
search_code_allowed_file_types []
search_code_pattern_max_bytes 2048
search_code_timeout_seconds 5.0
snapshot_ttl 5 (seconds)
cache_warm_on_boot false
parallel_introspection false
parallel_pool_size 4 (threads)
parallel_timeout_seconds 10 (seconds per-future and pool shutdown) 


97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 97

def initialize
  @introspectors      = Configuration::PRESETS[:standard].dup
  @preset             = :standard
  @excluded_paths     = %w[node_modules tmp log vendor .git]
  @excluded_models    = %w[
    ApplicationRecord
    ActiveStorage::Blob ActiveStorage::Attachment ActiveStorage::VariantRecord
    ActionText::RichText ActionText::EncryptedRichText
    ActionMailbox::InboundEmail ActionMailbox::Record
  ]
  @core_models                       = []
  @excluded_tables                   = []
  @disabled_introspection_categories = []
  @cache_ttl                         = 30
  @expose_credentials_key_names      = false
  @additional_introspectors          = {}
  @search_code_allowed_file_types    = []
  @search_code_pattern_max_bytes     = 2048
  @search_code_timeout_seconds       = 5.0
  @snapshot_ttl                      = 5
  @cache_warm_on_boot                = false
  @parallel_introspection            = false
  @parallel_pool_size                = 4
  @parallel_timeout_seconds          = 10
end

Instance Attribute Details

#additional_introspectors ⇒ Hash{Symbol => Class}

Returns additional custom introspector classes.

Returns:

  • (Hash{Symbol => Class}) —

    additional custom introspector classes



43
44
45
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 43

def additional_introspectors
  @additional_introspectors
end

#cache_ttl ⇒ Integer

Returns TTL in seconds for cached introspection results.

Returns:

  • (Integer) —

    TTL in seconds for cached introspection results



37
38
39
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 37

def cache_ttl
  @cache_ttl
end

#cache_warm_on_boot ⇒ Boolean

Returns whether to pre-populate the introspection cache on Rails boot.

Returns:

  • (Boolean) —

    whether to pre-populate the introspection cache on Rails boot



58
59
60
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 58

def cache_warm_on_boot
  @cache_warm_on_boot
end

#core_models ⇒ Array<String>

Returns model class names tagged as core_entity in semantic classification (AI focus).

Returns:

  • (Array<String>) —

    model class names tagged as core_entity in semantic classification (AI focus)



28
29
30
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 28

def core_models
  @core_models
end

#disabled_introspection_categories ⇒ Array<Symbol>

Returns product-level category keys that subtract introspectors at runtime.

Returns:

  • (Array<Symbol>) —

    product-level category keys that subtract introspectors at runtime



34
35
36
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 34

def disabled_introspection_categories
  @disabled_introspection_categories
end

#excluded_models ⇒ Array<String>

Returns model class names excluded from introspection.

Returns:

  • (Array<String>) —

    model class names excluded from introspection



25
26
27
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 25

def excluded_models
  @excluded_models
end

#excluded_paths ⇒ Array<String>

Returns directory names excluded from code search.

Returns:

  • (Array<String>) —

    directory names excluded from code search



22
23
24
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 22

def excluded_paths
  @excluded_paths
end

#excluded_tables ⇒ Array<String>

Returns table names/patterns excluded from schema introspection.

Returns:

  • (Array<String>) —

    table names/patterns excluded from schema introspection



31
32
33
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 31

def excluded_tables
  @excluded_tables
end

#expose_credentials_key_names ⇒ Boolean

Returns include credential key names in config introspection output.

Returns:

  • (Boolean) —

    include credential key names in config introspection output



40
41
42
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 40

def expose_credentials_key_names
  @expose_credentials_key_names
end

#introspectors ⇒ Array<Symbol>

Returns active introspector keys.

Returns:

  • (Array<Symbol>) —

    active introspector keys



8
9
10
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 8

def introspectors
  @introspectors
end

#parallel_introspection ⇒ Boolean

Returns whether to run introspectors concurrently (requires concurrent-ruby).

Returns:

  • (Boolean) —

    whether to run introspectors concurrently (requires concurrent-ruby)



61
62
63
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 61

def parallel_introspection
  @parallel_introspection
end

#parallel_pool_size ⇒ Integer

Returns maximum number of threads in the parallel execution pool. Capped at the number of introspectors so no idle threads are created. Default is 4. Only relevant when #parallel_introspection is true.

Returns:

  • (Integer) —

    maximum number of threads in the parallel execution pool. Capped at the number of introspectors so no idle threads are created. Default is 4. Only relevant when #parallel_introspection is true.



66
67
68
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 66

def parallel_pool_size
  @parallel_pool_size
end

#parallel_timeout_seconds ⇒ Integer

Returns seconds to wait for each introspector future and for the thread pool to shut down cleanly. Introspectors that exceed this budget have their result replaced with { error: "timed out after Ns" }. Default is 10. Only relevant when #parallel_introspection is true.

Returns:

  • (Integer) —

    seconds to wait for each introspector future and for the thread pool to shut down cleanly. Introspectors that exceed this budget have their result replaced with { error: "timed out after Ns" }. Default is 10. Only relevant when #parallel_introspection is true.



72
73
74
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 72

def parallel_timeout_seconds
  @parallel_timeout_seconds
end

#preset ⇒ Symbol?

Returns the active preset name, or nil if introspectors were modified directly.

Returns:

  • (Symbol, nil) —

    The preset name, or nil for modified configurations



138
139
140
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 138

def preset
  @preset
end

#search_code_allowed_file_types ⇒ Array<String>

Returns extra file extensions allowed for rails_search_code.

Returns:

  • (Array<String>) —

    extra file extensions allowed for rails_search_code



46
47
48
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 46

def search_code_allowed_file_types
  @search_code_allowed_file_types
end

#search_code_pattern_max_bytes ⇒ Integer

Returns maximum pattern size in bytes for Tools::SearchCode (ReDoS / abuse guard).

Returns:

  • (Integer) —

    maximum pattern size in bytes for Tools::SearchCode (ReDoS / abuse guard)



49
50
51
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 49

def search_code_pattern_max_bytes
  @search_code_pattern_max_bytes
end

#search_code_timeout_seconds ⇒ Float

Returns seconds before Tools::SearchCode aborts (+0+ disables the timeout).

Returns:



52
53
54
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 52

def search_code_timeout_seconds
  @search_code_timeout_seconds
end

#snapshot_ttl ⇒ Integer

Returns TTL in seconds for fingerprint snapshot caching (avoids redundant filesystem walks).

Returns:

  • (Integer) —

    TTL in seconds for fingerprint snapshot caching (avoids redundant filesystem walks)



55
56
57
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 55

def snapshot_ttl
  @snapshot_ttl
end

Instance Method Details

#effective_introspectors ⇒ Array<Symbol>

Introspectors after removing those disabled by #disabled_introspection_categories.

Returns:

  • (Array<Symbol>) 


143
144
145
146
147
148
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 143

def effective_introspectors
  disabled = @disabled_introspection_categories.flat_map do |c|
    Configuration::INTROSPECTION_CATEGORY_INTROSPECTORS[c.to_sym] || []
  end.uniq
  @introspectors.reject { |i| disabled.include?(i) }
end

#excluded_table?(table_name) ⇒ Boolean

Whether a table name matches any #excluded_tables pattern (exact or glob).

Parameters:

  • table_name (String, nil)

Returns:

  • (Boolean) 


154
155
156
157
158
 
# File 'lib/rails_ai_bridge/config/introspection.rb', line 154

def excluded_table?(table_name)
  return false if table_name.nil? || table_name.to_s.empty?

  @excluded_tables.any? { |pat| ExclusionHelper.table_pattern_match?(pat.to_s, table_name.to_s) }
end