rails-ai-context 5.30.2 → 5.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (222) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +868 -0
  3. data/CONTEXT.md +7 -3
  4. data/README.md +1 -1
  5. data/docs/ARCHITECTURE.md +3 -3
  6. data/docs/CLI.md +1 -1
  7. data/docs/COMPATIBILITY.md +50 -14
  8. data/docs/CONFIGURATION.md +4 -1
  9. data/docs/FAQ.md +1 -1
  10. data/docs/GUIDE.md +14 -8
  11. data/docs/INTROSPECTORS.md +50 -23
  12. data/docs/SECURITY.md +56 -1
  13. data/docs/TOOLS.md +58 -12
  14. data/lib/generators/rails_ai_context/install/install_generator.rb +1 -0
  15. data/lib/rails_ai_context/action_filters.rb +121 -48
  16. data/lib/rails_ai_context/app_commands.rb +2 -2
  17. data/lib/rails_ai_context/app_kind.rb +65 -8
  18. data/lib/rails_ai_context/ast_cache.rb +53 -18
  19. data/lib/rails_ai_context/base_mixins.rb +46 -16
  20. data/lib/rails_ai_context/boot_manager.rb +5 -1
  21. data/lib/rails_ai_context/cli/entry_boot.rb +17 -2
  22. data/lib/rails_ai_context/cli/tool_runner.rb +15 -1
  23. data/lib/rails_ai_context/concern_macros.rb +791 -111
  24. data/lib/rails_ai_context/concern_membership.rb +25 -5
  25. data/lib/rails_ai_context/concern_paths.rb +63 -17
  26. data/lib/rails_ai_context/config_yaml.rb +40 -0
  27. data/lib/rails_ai_context/configuration.rb +3 -3
  28. data/lib/rails_ai_context/data/docs/index.json +324 -0
  29. data/lib/rails_ai_context/database_yml.rb +136 -0
  30. data/lib/rails_ai_context/doctor.rb +30 -37
  31. data/lib/rails_ai_context/erb_source.rb +40 -0
  32. data/lib/rails_ai_context/fingerprinter.rb +48 -22
  33. data/lib/rails_ai_context/fixture_keys.rb +42 -1
  34. data/lib/rails_ai_context/gem_lock.rb +275 -47
  35. data/lib/rails_ai_context/git_ignore.rb +13 -11
  36. data/lib/rails_ai_context/hydrators/hydration_formatter.rb +8 -2
  37. data/lib/rails_ai_context/hydrators/schema_hint_builder.rb +10 -5
  38. data/lib/rails_ai_context/introspector.rb +10 -1
  39. data/lib/rails_ai_context/introspectors/action_mailbox_introspector.rb +27 -19
  40. data/lib/rails_ai_context/introspectors/action_presence.rb +11 -8
  41. data/lib/rails_ai_context/introspectors/action_resolver.rb +38 -26
  42. data/lib/rails_ai_context/introspectors/action_text_introspector.rb +2 -2
  43. data/lib/rails_ai_context/introspectors/active_record_settings.rb +56 -0
  44. data/lib/rails_ai_context/introspectors/active_storage_introspector.rb +1 -1
  45. data/lib/rails_ai_context/introspectors/active_support_introspector.rb +98 -22
  46. data/lib/rails_ai_context/introspectors/admin_resources.rb +101 -0
  47. data/lib/rails_ai_context/introspectors/anyway_configs.rb +64 -0
  48. data/lib/rails_ai_context/introspectors/apartment_config.rb +47 -0
  49. data/lib/rails_ai_context/introspectors/api_introspector.rb +125 -26
  50. data/lib/rails_ai_context/introspectors/asset_pipeline_introspector.rb +24 -19
  51. data/lib/rails_ai_context/introspectors/ast_walk.rb +18 -0
  52. data/lib/rails_ai_context/introspectors/auth_introspector.rb +71 -18
  53. data/lib/rails_ai_context/introspectors/autoload_introspector.rb +62 -15
  54. data/lib/rails_ai_context/introspectors/base.rb +38 -0
  55. data/lib/rails_ai_context/introspectors/call_site_expansion.rb +349 -39
  56. data/lib/rails_ai_context/introspectors/component_introspector.rb +26 -14
  57. data/lib/rails_ai_context/introspectors/config_introspector.rb +22 -9
  58. data/lib/rails_ai_context/introspectors/connection_pool_introspector.rb +1 -4
  59. data/lib/rails_ai_context/introspectors/controller_filters.rb +335 -31
  60. data/lib/rails_ai_context/introspectors/controller_introspector.rb +315 -129
  61. data/lib/rails_ai_context/introspectors/controller_settings.rb +182 -0
  62. data/lib/rails_ai_context/introspectors/convention_introspector.rb +18 -15
  63. data/lib/rails_ai_context/introspectors/database_stats_introspector.rb +1 -1
  64. data/lib/rails_ai_context/introspectors/declared_constant.rb +108 -23
  65. data/lib/rails_ai_context/introspectors/eager_load.rb +12 -7
  66. data/lib/rails_ai_context/introspectors/engine_introspector.rb +13 -5
  67. data/lib/rails_ai_context/introspectors/env_config_introspector.rb +62 -17
  68. data/lib/rails_ai_context/introspectors/env_introspector.rb +8 -6
  69. data/lib/rails_ai_context/introspectors/env_references.rb +21 -4
  70. data/lib/rails_ai_context/introspectors/frontend_framework_introspector.rb +37 -22
  71. data/lib/rails_ai_context/introspectors/gem_introspector.rb +3 -1
  72. data/lib/rails_ai_context/introspectors/gemfile_gems.rb +53 -5
  73. data/lib/rails_ai_context/introspectors/grape_endpoints.rb +109 -0
  74. data/lib/rails_ai_context/introspectors/helper_names.rb +12 -1
  75. data/lib/rails_ai_context/introspectors/i18n_introspector.rb +101 -46
  76. data/lib/rails_ai_context/introspectors/includers.rb +6 -1
  77. data/lib/rails_ai_context/introspectors/initializer_introspector.rb +2 -5
  78. data/lib/rails_ai_context/introspectors/job_introspector.rb +548 -103
  79. data/lib/rails_ai_context/introspectors/listener_registration.rb +11 -1
  80. data/lib/rails_ai_context/introspectors/listeners/associations_listener.rb +51 -4
  81. data/lib/rails_ai_context/introspectors/listeners/autoload_ignore_listener.rb +31 -0
  82. data/lib/rails_ai_context/introspectors/listeners/autoload_paths_listener.rb +4 -47
  83. data/lib/rails_ai_context/introspectors/listeners/base_listener.rb +80 -14
  84. data/lib/rails_ai_context/introspectors/listeners/branch_conditions.rb +156 -0
  85. data/lib/rails_ai_context/introspectors/listeners/callbacks_listener.rb +85 -23
  86. data/lib/rails_ai_context/introspectors/listeners/class_definition_listener.rb +35 -6
  87. data/lib/rails_ai_context/introspectors/listeners/component_structure_listener.rb +30 -2
  88. data/lib/rails_ai_context/introspectors/listeners/conditional_macro_listener.rb +19 -0
  89. data/lib/rails_ai_context/introspectors/listeners/config_assignment_listener.rb +255 -10
  90. data/lib/rails_ai_context/introspectors/listeners/constant_reference_listener.rb +34 -0
  91. data/lib/rails_ai_context/introspectors/listeners/constructor_macro_listener.rb +123 -0
  92. data/lib/rails_ai_context/introspectors/listeners/definition_file_paths_listener.rb +66 -0
  93. data/lib/rails_ai_context/introspectors/listeners/enums_listener.rb +2 -2
  94. data/lib/rails_ai_context/introspectors/listeners/env_access_listener.rb +31 -0
  95. data/lib/rails_ai_context/introspectors/listeners/filter_macro_listener.rb +54 -0
  96. data/lib/rails_ai_context/introspectors/listeners/fixture_paths_listener.rb +62 -0
  97. data/lib/rails_ai_context/introspectors/listeners/gemfile_dsl_listener.rb +42 -1
  98. data/lib/rails_ai_context/introspectors/listeners/generic_macro_listener.rb +28 -2
  99. data/lib/rails_ai_context/introspectors/listeners/grape_api_listener.rb +137 -0
  100. data/lib/rails_ai_context/introspectors/listeners/http_client_call_listener.rb +50 -0
  101. data/lib/rails_ai_context/introspectors/listeners/i18n_load_path_listener.rb +54 -0
  102. data/lib/rails_ai_context/introspectors/listeners/literal_paths.rb +123 -0
  103. data/lib/rails_ai_context/introspectors/listeners/macros_listener.rb +248 -4
  104. data/lib/rails_ai_context/introspectors/listeners/mailbox_routing_listener.rb +2 -1
  105. data/lib/rails_ai_context/introspectors/listeners/method_call_listener.rb +7 -1
  106. data/lib/rails_ai_context/introspectors/listeners/methods_listener.rb +352 -69
  107. data/lib/rails_ai_context/introspectors/listeners/migration_dsl_listener.rb +1 -1
  108. data/lib/rails_ai_context/introspectors/listeners/migration_replay_listener.rb +35 -26
  109. data/lib/rails_ai_context/introspectors/listeners/mixins_listener.rb +62 -29
  110. data/lib/rails_ai_context/introspectors/listeners/mount_listener.rb +8 -0
  111. data/lib/rails_ai_context/introspectors/listeners/namespaced_roots_listener.rb +35 -0
  112. data/lib/rails_ai_context/introspectors/listeners/nested_constants_listener.rb +32 -0
  113. data/lib/rails_ai_context/introspectors/listeners/owner_scope.rb +67 -0
  114. data/lib/rails_ai_context/introspectors/listeners/preview_paths_listener.rb +16 -7
  115. data/lib/rails_ai_context/introspectors/listeners/proc_literal_listener.rb +42 -0
  116. data/lib/rails_ai_context/introspectors/listeners/queue_assignment_listener.rb +54 -0
  117. data/lib/rails_ai_context/introspectors/listeners/rake_task_dsl_listener.rb +21 -8
  118. data/lib/rails_ai_context/introspectors/listeners/route_files_listener.rb +4 -11
  119. data/lib/rails_ai_context/introspectors/listeners/routes_dsl_listener.rb +461 -65
  120. data/lib/rails_ai_context/introspectors/listeners/schema_dsl_listener.rb +76 -14
  121. data/lib/rails_ai_context/introspectors/listeners/scopes_listener.rb +40 -1
  122. data/lib/rails_ai_context/introspectors/listeners/validations_listener.rb +10 -1
  123. data/lib/rails_ai_context/introspectors/listeners/view_paths_listener.rb +37 -0
  124. data/lib/rails_ai_context/introspectors/middleware_introspector.rb +47 -3
  125. data/lib/rails_ai_context/introspectors/migration_introspector.rb +3 -3
  126. data/lib/rails_ai_context/introspectors/migration_replay/helpers.rb +4 -3
  127. data/lib/rails_ai_context/introspectors/migration_replay/statements.rb +72 -12
  128. data/lib/rails_ai_context/introspectors/migration_replay.rb +110 -14
  129. data/lib/rails_ai_context/introspectors/model_introspector.rb +708 -214
  130. data/lib/rails_ai_context/introspectors/module_aliases.rb +11 -3
  131. data/lib/rails_ai_context/introspectors/multi_database_introspector.rb +9 -57
  132. data/lib/rails_ai_context/introspectors/observability_introspector.rb +5 -8
  133. data/lib/rails_ai_context/introspectors/performance_introspector.rb +28 -8
  134. data/lib/rails_ai_context/introspectors/rake_task_introspector.rb +118 -51
  135. data/lib/rails_ai_context/introspectors/recurring_schedules.rb +150 -0
  136. data/lib/rails_ai_context/introspectors/rendered_record.rb +87 -0
  137. data/lib/rails_ai_context/introspectors/retry_policy.rb +8 -5
  138. data/lib/rails_ai_context/introspectors/route_introspector.rb +153 -42
  139. data/lib/rails_ai_context/introspectors/schema_conventions.rb +127 -40
  140. data/lib/rails_ai_context/introspectors/schema_dump_path.rb +80 -0
  141. data/lib/rails_ai_context/introspectors/schema_introspector.rb +346 -112
  142. data/lib/rails_ai_context/introspectors/schema_reader.rb +69 -29
  143. data/lib/rails_ai_context/introspectors/service_classes.rb +21 -15
  144. data/lib/rails_ai_context/introspectors/source_calls.rb +1 -1
  145. data/lib/rails_ai_context/introspectors/source_introspector.rb +17 -2
  146. data/lib/rails_ai_context/introspectors/source_scan.rb +174 -26
  147. data/lib/rails_ai_context/introspectors/sqlite_virtual_tables.rb +28 -0
  148. data/lib/rails_ai_context/introspectors/stimulus_introspector.rb +16 -5
  149. data/lib/rails_ai_context/introspectors/structure_sql_reader.rb +372 -98
  150. data/lib/rails_ai_context/introspectors/superclass_chain.rb +14 -15
  151. data/lib/rails_ai_context/introspectors/table_name.rb +46 -45
  152. data/lib/rails_ai_context/introspectors/test_introspector.rb +289 -78
  153. data/lib/rails_ai_context/introspectors/turbo_introspector.rb +10 -5
  154. data/lib/rails_ai_context/introspectors/view_introspector.rb +5 -40
  155. data/lib/rails_ai_context/introspectors/view_template_introspector.rb +12 -10
  156. data/lib/rails_ai_context/method_name.rb +31 -0
  157. data/lib/rails_ai_context/migration_status.rb +5 -5
  158. data/lib/rails_ai_context/output_guard.rb +6 -4
  159. data/lib/rails_ai_context/package_json.rb +96 -5
  160. data/lib/rails_ai_context/path_resolver.rb +170 -15
  161. data/lib/rails_ai_context/payload.rb +48 -0
  162. data/lib/rails_ai_context/pending_migrations.rb +15 -18
  163. data/lib/rails_ai_context/portable_path.rb +76 -4
  164. data/lib/rails_ai_context/redaction.rb +8 -2
  165. data/lib/rails_ai_context/route_coverage.rb +5 -1
  166. data/lib/rails_ai_context/safe_file.rb +4 -1
  167. data/lib/rails_ai_context/safe_path.rb +61 -10
  168. data/lib/rails_ai_context/schema_hint.rb +8 -2
  169. data/lib/rails_ai_context/schema_version.rb +7 -9
  170. data/lib/rails_ai_context/serializers/claude_rules_serializer.rb +1 -1
  171. data/lib/rails_ai_context/serializers/markdown_serializer.rb +13 -4
  172. data/lib/rails_ai_context/serializers/section_facts.rb +5 -1
  173. data/lib/rails_ai_context/serializers/stack_overview_helper.rb +2 -2
  174. data/lib/rails_ai_context/serializers/tool_guide_helper.rb +7 -4
  175. data/lib/rails_ai_context/server.rb +26 -7
  176. data/lib/rails_ai_context/test_framework.rb +32 -5
  177. data/lib/rails_ai_context/tools/analyze_feature.rb +22 -10
  178. data/lib/rails_ai_context/tools/base_tool.rb +69 -30
  179. data/lib/rails_ai_context/tools/diagnose.rb +1 -1
  180. data/lib/rails_ai_context/tools/generate_test.rb +8 -9
  181. data/lib/rails_ai_context/tools/get_active_support.rb +19 -4
  182. data/lib/rails_ai_context/tools/get_api.rb +17 -11
  183. data/lib/rails_ai_context/tools/get_autoload.rb +10 -5
  184. data/lib/rails_ai_context/tools/get_callbacks.rb +65 -14
  185. data/lib/rails_ai_context/tools/get_component_catalog.rb +7 -4
  186. data/lib/rails_ai_context/tools/get_concern.rb +31 -18
  187. data/lib/rails_ai_context/tools/get_config.rb +52 -18
  188. data/lib/rails_ai_context/tools/get_controllers.rb +57 -13
  189. data/lib/rails_ai_context/tools/get_conventions.rb +44 -22
  190. data/lib/rails_ai_context/tools/get_engines.rb +2 -0
  191. data/lib/rails_ai_context/tools/get_env.rb +209 -52
  192. data/lib/rails_ai_context/tools/get_env_config.rb +38 -7
  193. data/lib/rails_ai_context/tools/get_frontend_stack.rb +56 -7
  194. data/lib/rails_ai_context/tools/get_helper_methods.rb +136 -26
  195. data/lib/rails_ai_context/tools/get_job_pattern.rb +143 -87
  196. data/lib/rails_ai_context/tools/get_mailers.rb +59 -2
  197. data/lib/rails_ai_context/tools/get_model_details.rb +178 -28
  198. data/lib/rails_ai_context/tools/get_partial_interface.rb +101 -62
  199. data/lib/rails_ai_context/tools/get_routes.rb +35 -9
  200. data/lib/rails_ai_context/tools/get_schema.rb +160 -61
  201. data/lib/rails_ai_context/tools/get_service_pattern.rb +121 -25
  202. data/lib/rails_ai_context/tools/get_stimulus.rb +1 -1
  203. data/lib/rails_ai_context/tools/get_test_info.rb +152 -82
  204. data/lib/rails_ai_context/tools/get_view.rb +37 -20
  205. data/lib/rails_ai_context/tools/migration_advisor.rb +64 -24
  206. data/lib/rails_ai_context/tools/onboard.rb +174 -88
  207. data/lib/rails_ai_context/tools/performance_check.rb +5 -13
  208. data/lib/rails_ai_context/tools/query.rb +122 -28
  209. data/lib/rails_ai_context/tools/read_logs.rb +45 -17
  210. data/lib/rails_ai_context/tools/runtime_info.rb +1 -1
  211. data/lib/rails_ai_context/tools/safe_call.rb +20 -15
  212. data/lib/rails_ai_context/tools/search_code.rb +114 -40
  213. data/lib/rails_ai_context/tools/search_docs.rb +22 -11
  214. data/lib/rails_ai_context/tools/security_scan.rb +51 -4
  215. data/lib/rails_ai_context/tools/validate.rb +21 -4
  216. data/lib/rails_ai_context/tools/validate_semantics.rb +18 -6
  217. data/lib/rails_ai_context/version.rb +1 -1
  218. data/lib/rails_ai_context/vfs.rb +2 -2
  219. data/lib/rails_ai_context/view_file.rb +53 -3
  220. data/lib/rails_ai_context.rb +10 -2
  221. data/server.json +1 -1
  222. metadata +34 -3
@@ -35,7 +35,7 @@ module RailsAiContext
35
35
  unread_parent = nil
36
36
  name = class_name
37
37
  SuperclassChain::MAX_DEPTH.times do
38
- declaration = source && DeclaredConstant.declarations(source).find { |d| d.name == name }
38
+ declaration = source && DeclaredConstant.declarations(source, path_name: name).find { |d| d.name == name }
39
39
  # A file the walk cannot match to the class leaves the class unread.
40
40
  break unread << name unless declaration
41
41
 
@@ -44,7 +44,7 @@ module RailsAiContext
44
44
  parent = declaration.superclass
45
45
  break if parent.nil? || BASES.include?(parent)
46
46
 
47
- found = SuperclassChain.resolve_in_scope(name, parent) { |c| (src = lookup.call(c)) && [ c, src ] }
47
+ found = SuperclassChain.resolve_in_scope(name, parent, nesting: declaration.nesting) { |c| (src = lookup.call(c)) && [ c, src ] }
48
48
  unless found
49
49
  unread_parent = parent
50
50
  break unread << parent
@@ -63,12 +63,13 @@ module RailsAiContext
63
63
  lambda do |name|
64
64
  file = controllers.is_a?(Hash) && controllers[name].is_a?(Hash) ? controllers[name][:file] : nil
65
65
  path = file && File.expand_path(file, root)
66
- (path && SafePath.contained?(path, root) && SafeFile.read(path)) || by_path.call(name)
66
+ (path && PathResolver.project_file?(path, root) && SafeFile.read(path)) || by_path.call(name)
67
67
  end
68
68
  end
69
69
 
70
70
  def template?(root, chain, action)
71
- chain.prefixes.any? { |prefix| Dir.glob(File.join(root.to_s, "app", "views", prefix, "#{action}.*")).any? }
71
+ roots = [ root.to_s, *PathResolver.enclosing_engine_roots(root.to_s) ]
72
+ chain.prefixes.any? { |prefix| roots.any? { |dir| Dir.glob(File.join(dir, "app", "views", prefix, "#{action}.*")).any? } }
72
73
  end
73
74
 
74
75
  def read_class(source, name, defs, names)
@@ -83,8 +84,8 @@ module RailsAiContext
83
84
  # the actions its class macros build with define_method, and an unread
84
85
  # one only hides class methods.
85
86
  def read_modules(source, owner, root, names, unread, depth)
86
- mixins = ConcernMembership.own_mixins(
87
- SourceIntrospector.walk_source(source, { mixins: Listeners::MixinsListener })[:mixins], owner
87
+ mixins = ConcernMembership.owned_by(
88
+ SourceIntrospector.walk_source(source, { mixins: Listeners::MixinsListener })[:mixins], owner, root: root
88
89
  )
89
90
  mixins.select { |m| m[:ancestor] || (m[:macro] == :extend && !m[:receiver]) }.uniq { |m| m[:name] }.each do |mixin|
90
91
  mod = mixin[:name]
@@ -104,8 +105,10 @@ module RailsAiContext
104
105
  end
105
106
 
106
107
  def module_source(root, mod, owner)
107
- path = ConcernPaths.find_file(root.to_s, mod, within: owner) ||
108
- SuperclassChain.resolve_in_scope(owner, mod) { |c| PathResolver.file_for_constant(root.to_s, c) }
108
+ source = ConcernPaths.module_source(root.to_s, mod, within: owner)
109
+ return source if source
110
+
111
+ path = SuperclassChain.resolve_in_scope(owner, mod) { |c| PathResolver.file_for_constant(root.to_s, c) }
109
112
  path && SafeFile.read(path)
110
113
  end
111
114
 
@@ -37,6 +37,8 @@ module RailsAiContext
37
37
  # shift-assign, which does assign.
38
38
  ASSIGNMENT = /(?<![=!<>~])=(?![=~])|(?<![<>])(?:<<|>>)=/
39
39
 
40
+ WALKED_METHODS = ObjectSpace::WeakMap.new
41
+
40
42
  module_function
41
43
 
42
44
  def framework?(klass, kind:)
@@ -115,30 +117,42 @@ module RailsAiContext
115
117
  # its class methods, each as written (`full_name(sep = ' ')`). The owner
116
118
  # defaults to the constant the file declares.
117
119
  def public_methods_from_source(source, owner: nil, skip_underscored: true)
118
- methods = own_methods_in(source, owner).select { |m| m[:scope] == :instance && m[:visibility] == :public }
119
- methods = methods.reject { |m| m[:name].start_with?("_") } if skip_underscored
120
- methods.map { |m| signature(m) }.uniq
120
+ public_methods_in(source, owner: owner, skip_underscored: skip_underscored).map { |m| signature(m) }.uniq
121
121
  end
122
122
 
123
123
  def private_methods_from_source(source, owner: nil)
124
- own_methods_in(source, owner)
125
- .select { |m| m[:scope] == :instance && m[:visibility] != :public }
126
- .map { |m| signature(m) }.uniq
124
+ private_methods_in(source, owner: owner).map { |m| signature(m) }.uniq
125
+ end
126
+
127
+ # The walked methods behind those signatures, for a caller that prints each one's own body.
128
+ # `module_function:` also counts a module_function's instance copy, private to Ruby but callable from a view.
129
+ def public_methods_in(source, owner: nil, skip_underscored: true, module_function: false)
130
+ methods = own_methods_in(source, owner).select do |m|
131
+ m[:scope] == :instance && (m[:visibility] == :public || (module_function && m[:module_function]))
132
+ end
133
+ skip_underscored ? methods.reject { |m| m[:name].start_with?("_") } : methods
134
+ end
135
+
136
+ def private_methods_in(source, owner: nil)
137
+ own_methods_in(source, owner).select { |m| m[:scope] == :instance && m[:visibility] != :public }
127
138
  end
128
139
 
129
140
  # A bare `private` never reaches `def self.x`; it does reach a def
130
141
  # inside `class_methods do` or `class << self`.
131
142
  def class_methods_from_source(source, owner: nil)
132
143
  own_methods_in(source, owner)
133
- .select { |m| m[:scope] == :class && (m[:visibility] == :public || m[:signature].to_s.start_with?("self.")) }
144
+ .select { |m| m[:scope] == :class && m[:visibility] == :public }
134
145
  .map { |m| signature(m) }.uniq
135
146
  end
136
147
 
137
- # `perform`, or `execute` where a base class owns perform and calls it.
138
- # ponytail: those two names only; another base's entry point reads as no signature.
139
- def entry_point(methods)
148
+ ENTRY_POINTS = %w[perform execute].freeze
149
+ QUE_ENTRY_POINTS = %w[run].freeze
150
+
151
+ # `perform`, or `execute` where a base class owns perform and calls it; a Que job passes `run`.
152
+ # ponytail: those names only; another base's entry point reads as no signature.
153
+ def entry_point(methods, names: ENTRY_POINTS)
140
154
  instance = methods.select { |m| m[:scope] == :instance }
141
- instance.find { |m| m[:name] == "perform" } || instance.find { |m| m[:name] == "execute" }
155
+ names.lazy.filter_map { |name| instance.find { |m| m[:name] == name } }.first
142
156
  end
143
157
 
144
158
  # The method as written, minus a `self.` receiver: `build(attrs)`.
@@ -197,7 +211,8 @@ module RailsAiContext
197
211
  end
198
212
 
199
213
  def scanned_body(lines, method_name)
200
- start_idx = lines.index { |l| l.match?(/^\s*def\s+#{Regexp.escape(method_name.to_s)}\b/i) }
214
+ name_end = RailsAiContext::MethodName.definition_end(method_name)
215
+ start_idx = lines.index { |l| l.match?(/^\s*def\s+#{Regexp.escape(method_name.to_s)}#{name_end}/i) }
201
216
  return nil unless start_idx
202
217
 
203
218
  indent = lines[start_idx][/\A\s*/].length
@@ -241,8 +256,13 @@ module RailsAiContext
241
256
  action_source.to_s.scan(/render\s+(?:json|xml):\s*@(\w+)/).flatten.uniq
242
257
  end
243
258
 
259
+ # Keyed by the cached tree, so a tool asking one file for each of its
260
+ # callbacks walks it once.
244
261
  def methods_in(source)
245
- SourceIntrospector.walk_source(source, { methods: Listeners::MethodsListener })[:methods] || []
262
+ result = AstCache.parse_string(source.to_s)
263
+ (WALKED_METHODS[result.value] ||= Array(
264
+ SourceIntrospector.walk_dispatch(result, { methods: Listeners::MethodsListener })[:methods]
265
+ ).each(&:freeze).freeze).dup
246
266
  end
247
267
 
248
268
  def own_methods_in(source, owner)
@@ -323,24 +343,16 @@ module RailsAiContext
323
343
  found.uniq.sort
324
344
  end
325
345
 
326
- # Ruby resolves a bare superclass from the enclosing namespace outward,
327
- # so `module Settings; class ProfileController < BaseController` keys the
328
- # listing under Settings::BaseController even when a top-level
329
- # BaseController exists too. A qualified name the listing holds is taken as written, one
330
- # it lacks resolves outward too, and a rooted or unresolved name comes back as written.
346
+ # A bare superclass resolves through Module.nesting: `module Settings; class ProfileController < BaseController`
347
+ # means Settings::BaseController where the listing holds it.
331
348
  def resolve_entry_name(entries, name, within)
332
349
  rooted = name.to_s.start_with?("::")
333
350
  name = name&.to_s&.delete_prefix("::")
334
351
  return name if name.nil? || within.nil? || rooted || (name.include?("::") && entries.key?(name))
335
352
 
336
- scope = within.to_s.split("::")[0..-2]
337
- while scope.any?
338
- qualified = (scope + [ name ]).join("::")
339
- return qualified if entries.key?(qualified)
340
-
341
- scope.pop
342
- end
343
- name
353
+ info = entries[within]
354
+ nesting = info[:parent_nesting] if info.is_a?(Hash)
355
+ SuperclassChain.resolve_in_scope(within, name, nesting: nesting) { |qualified| qualified if entries.key?(qualified) } || name
344
356
  end
345
357
 
346
358
  # `action_methods` subtracts inherited methods only as far as the
@@ -36,9 +36,9 @@ module RailsAiContext
36
36
 
37
37
  def extract_rich_text_fields
38
38
  fields = []
39
- SourceScan.classes(root, kind: "app/models").each do |model_name, record|
39
+ model_classes.each do |model_name, record|
40
40
  ast_data = SourceIntrospector.walk_source(record.source, { macros: Listeners::MacrosListener })
41
- ast_data[:macros].each do |m|
41
+ ConcernMembership.owned_by(ast_data[:macros], model_name).each do |m|
42
42
  next unless m[:macro] == :has_rich_text
43
43
  fields << { model: model_name, field: m[:attribute] }
44
44
  end
@@ -0,0 +1,56 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ # The table affixes, pluralize_table_names and schema_format the app's config and initializers
6
+ # set on Active Record. Read once per run, so a long-lived server sees the app's edits.
7
+ module ActiveRecordSettings
8
+ module_function
9
+
10
+ SETTINGS = { table_name_prefix: String, table_name_suffix: String, pluralize_table_names: [ true, false ], schema_format: %i[ruby sql] }.freeze
11
+ # Rails copies these from config.active_record onto the ActiveRecord module in an after_initialize hook, so the config wins.
12
+ MODULE_SETTINGS = %i[schema_format].freeze
13
+ # ActiveRecord::Base's class attributes, ActiveRecord's module ones, and self or the param in the base's load hook.
14
+ BASE_ROOTS = %w[ActiveRecord::Base ActiveRecord on_load(:active_record)].freeze
15
+
16
+ # {table_name_prefix: "op_", schema_format: :sql}
17
+ def for(root)
18
+ return {} unless root
19
+
20
+ root = File.expand_path(root.to_s)
21
+ RunCache.fetch([ :active_record_settings, root ]) { read(root) }
22
+ end
23
+
24
+ # Files in Rails' load order, the last assignment of each kind winning. A Base
25
+ # attribute set directly beats config, which the base's load hook copies first.
26
+ def read(root)
27
+ files = [ File.join(root, "config", "application.rb"), File.join(root, "config", "environments", "#{RailsAiContext.environment_name}.rb") ]
28
+ files = files.select { |path| File.file?(path) } + PathResolver.initializer_paths(root)
29
+ listeners = { config: -> { Listeners::ConfigAssignmentListener.new }, base: -> { Listeners::ConfigAssignmentListener.new(BASE_ROOTS) } }
30
+ configured = {}
31
+ direct = {}
32
+ files.each do |file|
33
+ walked = SourceIntrospector.walk(file, listeners)
34
+ collect(Array(walked[:config]).filter_map { |entry| [ entry, entry[:path].last ] if entry[:path].size == 2 && entry[:path].first == :active_record }, configured)
35
+ collect(Array(walked[:base]).filter_map { |entry| [ entry, entry[:path].first ] if entry[:path].size == 1 }, direct)
36
+ end
37
+ MODULE_SETTINGS.each { |name| direct.delete(name) if configured.key?(name) }
38
+ configured.merge(direct)
39
+ rescue StandardError, ScriptError => e
40
+ RailsAiContext.debug_fail(e, {}, label: "active_record_settings")
41
+ end
42
+
43
+ def collect(settings, found)
44
+ settings.sort_by { |entry, _| entry[:location] }.each do |entry, name|
45
+ allowed = SETTINGS[name]
46
+ next unless entry[:assignment] && allowed
47
+
48
+ value = entry[:value]
49
+ found[name] = value if allowed.is_a?(Array) ? allowed.include?(value) : value.is_a?(allowed)
50
+ end
51
+ end
52
+
53
+ private_class_method :read, :collect
54
+ end
55
+ end
56
+ end
@@ -28,7 +28,7 @@ module RailsAiContext
28
28
  validations = []
29
29
  variants = []
30
30
 
31
- SourceScan.classes(root, kind: "app/models").each do |model_name, record|
31
+ model_classes.each do |model_name, record|
32
32
  ast = SourceIntrospector.walk_source(record.source, {
33
33
  macros: Listeners::MacrosListener,
34
34
  validations: Listeners::ValidationsListener,
@@ -15,6 +15,7 @@ module RailsAiContext
15
15
  concerns: extract_concerns,
16
16
  deprecators: extract_deprecators,
17
17
  message_verifier_usage: extract_message_verifier_usage,
18
+ notification_subscriptions: scan_sources[:notification_subscriptions],
18
19
  tagged_logging: detect_tagged_logging,
19
20
  on_load_hooks: common_on_load_hooks,
20
21
  cache_usage: detect_cache_usage
@@ -31,7 +32,8 @@ module RailsAiContext
31
32
  concerns: extract_concerns,
32
33
  deprecators: unavailable,
33
34
  message_verifier_usage: extract_message_verifier_usage,
34
- tagged_logging: detect_tagged_logging,
35
+ notification_subscriptions: scan_sources[:notification_subscriptions],
36
+ tagged_logging: detect_tagged_logging(static: true),
35
37
  on_load_hooks: unavailable,
36
38
  cache_usage: unavailable
37
39
  }
@@ -65,7 +67,7 @@ module RailsAiContext
65
67
  # An app/models/concerns directory holds classes too - every
66
68
  # validator in some apps - and a class is not a concern, let
67
69
  # alone a "plain module".
68
- declarations = DeclaredConstant.declarations(content)
70
+ declarations = DeclaredConstant.declarations(content, path_name: mod_name)
69
71
  declared = declarations.find { |d| d.name.split("::").last.casecmp?(mod_name.split("::").last) }
70
72
  if declared
71
73
  entry[:kind] = "class"
@@ -104,40 +106,114 @@ module RailsAiContext
104
106
  RailsAiContext.debug_fail(e, [], label: "extract_deprecators")
105
107
  end
106
108
 
107
- # Scan `lib/` + `app/` for calls into ActiveSupport::MessageEncryptor and
108
- # ActiveSupport::MessageVerifier. Used for tokens, signed IDs, etc.
109
109
  def extract_message_verifier_usage
110
- hits = []
111
- %w[lib app].each do |rel|
112
- dir = File.join(root, rel)
113
- next unless Dir.exist?(dir)
110
+ scan_sources[:message_verifier_usage]
111
+ end
114
112
 
115
- # Sort before slicing - Dir.glob ordering is filesystem-dependent
116
- # and would produce non-deterministic output on large monorepos.
117
- Dir.glob(File.join(dir, "**/*.rb")).sort.first(2000).each do |path|
113
+ SUBSCRIBE_CALLS = %w[subscribe monotonic_subscribe].freeze
114
+ # Prefilter: only the receivers subscriptions_from keeps, so a newsletter `subscribe` is not parsed.
115
+ SUBSCRIPTION_HINT = /Notifications\s*&?\.\s*(?:monotonic_)?subscribe\b|\battach_to\b/
116
+ VERIFIER_HINTS = %w[MessageEncryptor MessageVerifier message_verifier ActiveStorage.verifier].freeze
117
+ VERIFIER_CALLS = %w[message_verifier message_verifiers verifier].freeze
118
+
119
+ # One read of lib/, app/ and the initializers serves both lists; a file that
120
+ # mentions either is walked once, for both.
121
+ def scan_sources
122
+ @scan_sources ||= begin
123
+ verifier = []
124
+ subscriptions = []
125
+ source_paths.each do |path|
118
126
  content = RailsAiContext::SafeFile.read(path) or next
119
- # Mention of the class anywhere counts, so a text scan over 2000
120
- # files beats parsing each one. Regex stays.
121
- next unless content.match?(/MessageEncryptor|MessageVerifier/)
122
127
  relative = path.sub("#{root}/", "")
123
- hits << { file: relative, encryptor: content.include?("MessageEncryptor"), verifier: content.include?("MessageVerifier") }
128
+ verifies = VERIFIER_HINTS.any? { |hint| content.include?(hint) } && !relative.start_with?("config/")
129
+ subscribes = (content.include?("subscribe") || content.include?("attach_to")) && content.match?(SUBSCRIPTION_HINT)
130
+ next unless verifies || subscribes
131
+
132
+ walked = walk_usage(content, verifies: verifies, subscribes: subscribes)
133
+ usage = verifier_usage(walked)
134
+ verifier << { file: relative, **usage } if usage.values.any?
135
+ subscriptions.concat(subscriptions_from(walked, relative))
124
136
  end
137
+ { message_verifier_usage: verifier, notification_subscriptions: subscriptions.sort_by { |s| [ s[:file], s[:line], s[:event] ] } }
125
138
  end
126
- hits
127
- rescue => e
128
- RailsAiContext.debug_fail(e, [], label: "extract_message_verifier_usage")
129
139
  end
130
140
 
131
- def detect_tagged_logging
141
+ # Sorted, since Dir.glob order is filesystem-dependent. No cap: the hint prefilter
142
+ # keeps a file nobody subscribes from to one read.
143
+ def source_paths
144
+ paths = %w[lib app].flat_map do |rel|
145
+ dir = File.join(root, rel)
146
+ Dir.exist?(dir) ? Dir.glob(File.join(dir, "**/*.rb")).sort : []
147
+ end
148
+ paths + PathResolver.initializer_paths(root)
149
+ end
150
+
151
+ def walk_usage(content, verifies:, subscribes:)
152
+ listeners = {}
153
+ if verifies
154
+ listeners[:constants] = -> { Listeners::ConstantReferenceListener.new(names: %w[MessageVerifier MessageEncryptor]) }
155
+ listeners[:verifier_calls] = -> { Listeners::MethodCallListener.new(names: VERIFIER_CALLS) }
156
+ end
157
+ if subscribes
158
+ listeners[:calls] = -> { Listeners::MethodCallListener.new(names: SUBSCRIBE_CALLS + %w[attach_to]) }
159
+ listeners[:methods] = Listeners::MethodsListener
160
+ end
161
+ SourceIntrospector.walk_source(content, listeners)
162
+ end
163
+
164
+ # The class itself, Rails.application.message_verifier(s) or ActiveStorage.verifier.
165
+ def verifier_usage(walked)
166
+ constants = Array(walked[:constants]).map { |ref| ref[:name] }
167
+ calls = Array(walked[:verifier_calls]).select do |call|
168
+ call[:name] != "verifier" || call[:receiver].to_s.match?(/(\A|::)ActiveStorage\z/)
169
+ end
170
+ { encryptor: constants.include?("MessageEncryptor"), verifier: constants.include?("MessageVerifier") || calls.any? }
171
+ end
172
+
173
+ # A Subscriber's attach_to listens for "<public method>.<namespace>", one event per method.
174
+ def subscriptions_from(walked, relative)
175
+ Array(walked[:calls]).flat_map do |call|
176
+ if call[:name] == "attach_to"
177
+ attach_to_events(call, walked[:methods], relative)
178
+ elsif call[:receiver].to_s.match?(/(\A|::)Notifications\z/)
179
+ pattern = call[:arguments].first
180
+ event = pattern.nil? ? "every event" : pattern.to_s
181
+ [ { event: event, via: call[:name], file: relative, line: call[:line] } ]
182
+ else
183
+ []
184
+ end
185
+ end
186
+ end
187
+
188
+ def attach_to_events(call, methods, relative)
189
+ namespace = call[:arguments].first
190
+ return [] unless namespace.is_a?(Symbol) || namespace.is_a?(String)
191
+
192
+ receiver = call[:receiver]&.to_s
193
+ bare = receiver.nil? || receiver == "self"
194
+ owner = bare ? call[:owner].join("::").presence : receiver
195
+ short = owner.to_s.split("::").last
196
+ names = Array(methods).select do |m|
197
+ m[:scope] == :instance && m[:visibility] == :public &&
198
+ (bare ? m[:owner] == call[:owner] : m[:owner]&.last.to_s.split("::").last == short)
199
+ end.map { |m| m[:name] }
200
+ via = [ owner, "attach_to" ].compact.join(".")
201
+ events = names.empty? ? [ "every public method of #{owner || "the subscriber"}, as <method>.#{namespace}" ] : names.map { |name| "#{name}.#{namespace}" }
202
+ events.map { |event| { event: event, via: via, file: relative, line: call[:line] } }
203
+ end
204
+
205
+ # config.log_tags is evaluated at boot, so a static run reads only the initializer.
206
+ def detect_tagged_logging(static: false)
132
207
  result = { configured: false }
133
- config_logger = app.config.log_tags
134
- if config_logger.is_a?(Array) && config_logger.any?
208
+ if static
209
+ result[:tags] = { unavailable: StaticTier.unavailable_reason }
210
+ elsif (config_logger = app.config.log_tags).is_a?(Array) && config_logger.any?
135
211
  result[:configured] = true
136
212
  result[:tags] = config_logger.map(&:to_s)
137
213
  end
138
214
 
139
215
  # Initializer pattern: Rails.logger = ActiveSupport::TaggedLogging.new(…)
140
- Dir.glob(File.join(root, "config/initializers/*.rb")).each do |path|
216
+ PathResolver.initializer_paths(root).each do |path|
141
217
  content = RailsAiContext::SafeFile.read(path) or next
142
218
  if content.include?("ActiveSupport::TaggedLogging")
143
219
  result[:configured] = true
@@ -0,0 +1,101 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ # The models an admin gem exposes, read from the folder each gem's
6
+ # generator writes to: ActiveAdmin and Trestle in app/admin, Administrate
7
+ # in app/dashboards, Avo in app/avo/resources, Madmin in
8
+ # app/madmin/resources. Read from source, so both tiers answer the same.
9
+ module AdminResources
10
+ DIRS = %w[app/admin app/dashboards app/avo/resources app/madmin/resources].freeze
11
+ CALLS = %i[register resource permit_params model_class=].freeze
12
+
13
+ module_function
14
+
15
+ # @return [Array<Hash>] framework, model, file (app-relative) and, for ActiveAdmin, params
16
+ def call(root)
17
+ root = root.to_s
18
+ DIRS.flat_map do |dir|
19
+ FileWalk.each_file(File.join(root, dir)).select { |path| path.end_with?(".rb") }.sort.flat_map do |path|
20
+ relative = path.delete_prefix("#{root}/")
21
+ source, = SafePath.read(relative, under: root)
22
+ source ? resources(dir, relative, source) : []
23
+ end
24
+ end
25
+ end
26
+
27
+ def line(resource)
28
+ permits = " - permits #{resource[:params].join(', ')}" if resource[:params].any?
29
+ "#{resource[:framework]} `#{resource[:model]}` (`#{resource[:file]}`)#{permits}"
30
+ end
31
+
32
+ def resources(dir, file, source)
33
+ walked = SourceIntrospector.walk_source(
34
+ source, { calls: -> { Listeners::MethodCallListener.new(names: CALLS) },
35
+ classes: Listeners::ClassDefinitionListener }
36
+ )
37
+ calls = Array(walked[:calls])
38
+ classes = Array(walked[:classes])
39
+
40
+ found = case dir
41
+ when "app/admin" then registered(calls) + trestle(calls)
42
+ when "app/dashboards" then named(classes, "Dashboard").map { |model| [ "Administrate", model, [] ] }
43
+ when "app/madmin/resources" then named(classes, "Resource").map { |model| [ "Madmin", model, [] ] }
44
+ else avo(classes, calls)
45
+ end
46
+ found.map { |framework, model, params| { framework: framework, model: model, file: file, params: params } }
47
+ end
48
+
49
+ # `ActiveAdmin.register User do`, each with the permit_params that
50
+ # follow it before the next register.
51
+ def registered(calls)
52
+ registers = calls.select { |c| c[:name] == "register" && c[:receiver] == "ActiveAdmin" && c[:arguments].first.is_a?(String) }
53
+ registers.each_with_index.map do |register, index|
54
+ stop = registers[index + 1]&.dig(:offset) || Float::INFINITY
55
+ params = calls.select { |c| c[:name] == "permit_params" && c[:offset] > register[:offset] && c[:offset] < stop }
56
+ .flat_map { |c| c[:arguments].select { |arg| arg.is_a?(Symbol) }.map(&:to_s) + permitted_keywords(c[:options]) }
57
+ [ "ActiveAdmin", register[:arguments].first, params ]
58
+ end
59
+ end
60
+
61
+ # permit_params forwards to params.permit: `tags: []` is an array, `meta: [:a, :b]` nested keys.
62
+ def permitted_keywords(options)
63
+ Array(options).filter_map do |key, value|
64
+ next unless key.is_a?(Symbol)
65
+
66
+ inner = case value
67
+ when Array then value.empty? ? "array" : value.map { |v| v.is_a?(Hash) ? v.keys.join(", ") : v.to_s }.join(", ")
68
+ when Hash then value.empty? ? "hash" : value.keys.join(", ")
69
+ end
70
+ inner ? "#{key} (#{inner})" : key.to_s
71
+ end
72
+ end
73
+
74
+ # `Trestle.resource(:people, model: Person)`; without model:, the name.
75
+ def trestle(calls)
76
+ calls.select { |c| c[:name] == "resource" && c[:receiver] == "Trestle" && c[:arguments].first.is_a?(Symbol) }.map do |call|
77
+ model = call[:options][:model]
78
+ [ "Trestle", model.is_a?(String) ? model.delete_prefix("::") : call[:arguments].first.to_s.classify, [] ]
79
+ end
80
+ end
81
+
82
+ def named(classes, suffix)
83
+ classes.map { |c| c[:name] }.select { |name| name.end_with?(suffix) && name != suffix }.map { |name| name.delete_suffix(suffix) }
84
+ end
85
+
86
+ # `self.model_class = ::Account` names the model; otherwise the resource's
87
+ # own name, less the Resource suffix Avo 2 (top-level UserResource) drops.
88
+ def avo(classes, calls)
89
+ resource = classes.first or return []
90
+ override = calls.find { |c| c[:name] == "model_class=" }&.dig(:arguments)&.first
91
+ name = resource[:name]
92
+ model = if override.is_a?(String) then override.delete_prefix("::")
93
+ elsif name.start_with?("Avo::Resources::") then name.demodulize
94
+ else name.demodulize.delete_suffix("Resource")
95
+ end
96
+ model.empty? ? [] : [ [ "Avo", model, [] ] ]
97
+ end
98
+ private_class_method :resources, :registered, :permitted_keywords, :trestle, :named, :avo
99
+ end
100
+ end
101
+ end
@@ -0,0 +1,64 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ # Each Anyway::Config class under config/configs and app/configs, with its
6
+ # attributes and the env names anyway_config reads them from.
7
+ module AnywayConfigs
8
+ DIRS = %w[config/configs app/configs].freeze
9
+ BASES = %w[Anyway::Config ApplicationConfig].freeze
10
+ MACROS = %i[attr_config required config_name env_prefix].freeze
11
+
12
+ module_function
13
+
14
+ # @return [Array<Hash>] { name:, file:, attributes: [{ name:, env:, required: }] }
15
+ def scan(root)
16
+ root = root.to_s
17
+ DIRS.flat_map { |dir| Dir.glob(File.join(root, dir, "**", "*.rb")).sort }.flat_map do |path|
18
+ file = path.delete_prefix("#{root}/")
19
+ source = SafePath.read(file, under: root).first
20
+ source ? classes(source, file) : []
21
+ end
22
+ end
23
+
24
+ def classes(source, file)
25
+ all = DeclaredConstant.declarations(source, path_name: File.basename(file, ".rb").camelize)
26
+ declared = all.select { |d| BASES.include?(d.superclass.to_s.delete_prefix("::")) }
27
+ return [] if declared.empty?
28
+
29
+ parsed = AstCache.parse_string(source)
30
+ calls = SourceIntrospector.walk_dispatch(parsed, { calls: -> { Listeners::GenericMacroListener.new(*MACROS) } })[:calls]
31
+ bodies = all.flat_map do |d|
32
+ DeclaredConstant.class_bodies(parsed.value, d.name).map { |body| [ d.name, body.location.start_offset...body.location.end_offset ] }
33
+ end
34
+ owned = calls.group_by { |call| innermost(bodies, call[:offset]) }
35
+
36
+ declared.filter_map { |d| config(d.name, file, Array(owned[d.name])) }
37
+ end
38
+
39
+ # A call belongs to the innermost class body around it, so a nested class keeps its own macros.
40
+ def innermost(bodies, offset)
41
+ bodies.select { |_, range| range.cover?(offset) }.min_by { |_, range| range.size }&.first
42
+ end
43
+
44
+ def config(name, file, calls)
45
+ by_macro = calls.group_by { |c| c[:macro] }
46
+ names = Array(by_macro[:attr_config]).flat_map { |c| c[:args].map(&:to_s) + c[:options].keys.map(&:to_s) }.uniq
47
+ return nil if names.empty?
48
+
49
+ required = Array(by_macro[:required]).flat_map { |c| c[:args].map(&:to_s) }
50
+ prefix = env_prefix(name, by_macro)
51
+ { name: name, file: file, attributes: names.map { |n| { name: n, env: ("#{prefix}_#{n.upcase}" if prefix), required: required.include?(n) } } }
52
+ end
53
+
54
+ # anyway_config reads "#{env_prefix}_#{ATTR}"; the prefix defaults to the class name before `Config` (PAYMENT_*).
55
+ def env_prefix(class_name, by_macro)
56
+ explicit = Array(by_macro[:env_prefix]).last&.dig(:args, 0) || Array(by_macro[:config_name]).last&.dig(:args, 0)
57
+ return explicit.to_s.upcase if explicit
58
+
59
+ class_name[/\A(\w+)(?:::)?Config\z/, 1]&.upcase
60
+ end
61
+ private_class_method :classes, :innermost, :config, :env_prefix
62
+ end
63
+ end
64
+ end
@@ -0,0 +1,47 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ # The models an Apartment initializer keeps in the shared schema. Every
6
+ # other ActiveRecord model gets one table per tenant schema.
7
+ module ApartmentConfig
8
+ module_function
9
+
10
+ # @return [Hash, nil] { excluded_models: [names], file: } or, for a list the
11
+ # file computes, { excluded_models_source: text, file: }; nil without Apartment.configure
12
+ def read(root)
13
+ PathResolver.initializer_paths(root).each do |path|
14
+ source = SafeFile.read(path, max_size: RailsAiContext.configuration.max_file_size)
15
+ next unless source&.include?("Apartment.configure")
16
+ tree = AstCache.parse_string(source)
17
+ # A partial tree would read a cut-off list as no list.
18
+ next if tree.errors.any?
19
+
20
+ file = path.delete_prefix("#{root}/")
21
+ listener = -> { Listeners::ConfigAssignmentListener.new("Apartment.configure") }
22
+ # `+=`, `<<` or `concat` builds on a list the source does not show whole.
23
+ hit = SourceIntrospector.walk_dispatch(tree, { config: listener })[:config].reverse.find { |h| list_write?(h) }
24
+ return { excluded_models: [], file: file } unless hit
25
+ return { excluded_models_source: hit[:source], file: file } unless hit[:assignment] && literal_names?(hit[:value])
26
+
27
+ return { excluded_models: hit[:value].map { |name| name.delete_prefix("::") }, file: file }
28
+ end
29
+ nil
30
+ rescue StandardError => e
31
+ RailsAiContext.debug_fail(e, nil, label: "ApartmentConfig")
32
+ end
33
+
34
+ # A block on a read (`.each { }`) leaves the list as it was.
35
+ def list_write?(hit)
36
+ return hit[:path].size == 2 && hit[:path].first == :excluded_models if hit[:write] == :call
37
+ return false if hit[:write] == :block
38
+
39
+ hit[:path] == [ :excluded_models ] && (hit[:assignment] || hit[:write] == :operator)
40
+ end
41
+
42
+ def literal_names?(value)
43
+ value.is_a?(Array) && value.all?(String) && !value.include?(Confidence::INFERRED)
44
+ end
45
+ end
46
+ end
47
+ end