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
@@ -24,6 +24,11 @@ module RailsAiContext
24
24
  CONFIG_AVAILABLE_LOCALES = [ [ :i18n, :available_locales ] ].freeze
25
25
  I18N_AVAILABLE_LOCALES = [ [ :available_locales ], [ :config, :available_locales ] ].freeze
26
26
 
27
+ # Railties' `paths.add "config/locales", glob: "**/*.{rb,yml}"`, the same from 7.0 to 8.1.
28
+ RAILS_LOCALE_GLOB = "**/*.{rb,yml}"
29
+ # I18n loads these from an explicit load_path entry (load_rb, load_yml, load_yaml).
30
+ LOAD_PATH_EXTENSIONS = %w[.rb .yml .yaml].freeze
31
+
27
32
  REFUSED_LOCALE_FILE = {
28
33
  parse_error: true, locales: [], key_count: 0, key_paths: []
29
34
  }.freeze
@@ -77,7 +82,7 @@ module RailsAiContext
77
82
  dirs = PathResolver.locale_roots(root).map { |dir| File.join(dir, "config", "locales") }
78
83
  return {} if dirs.empty?
79
84
 
80
- files = dirs.sum { |dir| Dir.glob(File.join(dir, "**/*.{yml,yaml,rb}")).size }
85
+ files = dirs.sum { |dir| Dir.glob(File.join(dir, RAILS_LOCALE_GLOB)).size }
81
86
  { in_repo_locale_dirs: dirs.size, in_repo_locale_files: files }
82
87
  end
83
88
 
@@ -141,7 +146,7 @@ module RailsAiContext
141
146
  : all_environments.map { |path| [ path, true ] }
142
147
 
143
148
  ([ [ File.join(root, "config", "application.rb"), false ] ] + environments +
144
- Dir.glob(File.join(root, "config", "initializers", "*.rb")).sort.map { |path| [ path, false ] })
149
+ PathResolver.initializer_paths(root).map { |path| [ path, false ] })
145
150
  .select { |path, _ambiguous| File.exist?(path) }
146
151
  end
147
152
 
@@ -150,10 +155,6 @@ module RailsAiContext
150
155
  # last assignment within a spelling.
151
156
  def configured_available_locales
152
157
  entries = config_candidate_files.flat_map do |path, ambiguous|
153
- # Reading first also keeps an unreadable file away from the parser.
154
- source = RailsAiContext::SafeFile.read(path)
155
- next [] unless source&.include?("available_locales")
156
-
157
158
  # Every assignment, not only the readable ones: a literal a later
158
159
  # computed assignment overwrites is not the list Rails hands I18n,
159
160
  # so it falls through to the locale files and says so.
@@ -166,20 +167,48 @@ module RailsAiContext
166
167
  end
167
168
 
168
169
  def available_locales_assignments(path)
169
- walked = SourceIntrospector.walk(path, {
170
- config: -> { Listeners::ConfigAssignmentListener.new("config") },
171
- i18n: -> { Listeners::ConfigAssignmentListener.new("I18n") }
172
- })
170
+ walked = config_walk(path)
171
+ return [] unless walked
173
172
 
174
173
  entries = walked[:config].select { |entry| CONFIG_AVAILABLE_LOCALES.include?(entry[:path]) }
175
174
  .map { |entry| entry.merge(spelling: :config) } +
176
175
  walked[:i18n].select { |entry| I18N_AVAILABLE_LOCALES.include?(entry[:path]) }
177
176
  .map { |entry| entry.merge(spelling: :i18n) }
178
177
  entries.select { |entry| entry[:assignment] }.sort_by { |entry| entry[:location] }
178
+ end
179
+
180
+ # One walk per config file for every i18n setting read from it, and none for
181
+ # a file that never mentions one.
182
+ def config_walk(path)
183
+ @config_walks ||= {}
184
+ return @config_walks[path] if @config_walks.key?(path)
185
+
186
+ # Reading first also keeps an unreadable file away from the parser.
187
+ source = RailsAiContext::SafeFile.read(path)
188
+ @config_walks[path] = if source&.match?(/available_locales|load_path/)
189
+ SourceIntrospector.walk(path, {
190
+ config: -> { Listeners::ConfigAssignmentListener.new("config") },
191
+ i18n: -> { Listeners::ConfigAssignmentListener.new("I18n") },
192
+ load_path: Listeners::I18nLoadPathListener
193
+ })
194
+ end
179
195
  # One initializer this introspector cannot parse must not take the whole
180
196
  # I18n answer down through static_call's rescue.
181
197
  rescue StandardError => e
182
- RailsAiContext.debug_fail(e, [], label: "i18n available_locales walk of #{path}")
198
+ @config_walks[path] = RailsAiContext.debug_fail(e, nil, label: "i18n config walk of #{path}")
199
+ end
200
+
201
+ # Files config.i18n.load_path adds, from literal paths and globs under the app root.
202
+ def load_path_files
203
+ patterns = config_candidate_files.flat_map { |path, _| config_walk(path)&.dig(:load_path) || [] }
204
+ patterns.reject { |pattern| SafePath.traversal?(pattern) }.flat_map do |pattern|
205
+ Dir.glob(File.join(root, pattern)).select do |file|
206
+ LOAD_PATH_EXTENSIONS.include?(File.extname(file)) &&
207
+ SafePath.locate(file.delete_prefix("#{root}/"), under: root, max_size: Float::INFINITY, listed: true).ok?
208
+ end
209
+ end
210
+ rescue SystemCallError
211
+ []
183
212
  end
184
213
 
185
214
  # Only a literal list of names answers the question. `+= [...]`, a method
@@ -192,39 +221,38 @@ module RailsAiContext
192
221
  end
193
222
 
194
223
  def extract_locale_files
195
- dir = File.join(root, "config/locales")
196
- return [] unless Dir.exist?(dir)
197
-
198
- Dir.glob(File.join(dir, "**/*.{yml,yaml,rb}")).filter_map do |path|
199
- relative = path.sub("#{dir}/", "")
200
- info = { file: relative }
201
-
202
- if path.end_with?(".yml", ".yaml")
203
- entry = locale_index[path]
204
- if entry && !entry[:parse_error]
205
- info[:key_count] = entry[:key_count]
206
- # Which locales this file actually serves. The filename is only a
207
- # convention, and a gem-provided file is named for the gem.
208
- info[:locales] = entry[:locales]
209
- else
210
- info[:parse_error] = true
211
- end
224
+ locale_file_paths.map do |path|
225
+ info = { file: display_path(path) }
226
+ entry = locale_index[path]
227
+ if entry && !entry[:parse_error]
228
+ info[:key_count] = entry[:key_count]
229
+ # Which locales this file actually serves. The filename is only a
230
+ # convention, and a gem-provided file is named for the gem.
231
+ info[:locales] = entry[:locales]
232
+ else
233
+ info[:parse_error] = true
212
234
  end
213
-
214
235
  info
215
236
  end.sort_by { |f| f[:file] }
216
237
  end
217
238
 
239
+ # config/locales files keep their names relative to it; a load_path file is named from the app root.
240
+ def display_path(path)
241
+ base = locales_dir
242
+ base && path.start_with?("#{base}/") ? path.delete_prefix("#{base}/") : path.delete_prefix("#{root}/")
243
+ end
244
+
218
245
  def count_locale_files
219
- dir = File.join(root, "config/locales")
220
- return 0 unless Dir.exist?(dir)
221
- Dir.glob(File.join(dir, "**/*.{yml,yaml,rb}")).size
246
+ locale_file_paths.size
222
247
  end
223
248
 
224
249
  def detect_fallback_config
225
- config = {}
226
- config[:fallbacks] = I18n.fallbacks.to_h.transform_values { |v| v.map(&:to_s) } if I18n.respond_to?(:fallbacks) && I18n.fallbacks
227
- config
250
+ return {} unless I18n.backend.class.include?(I18n::Backend::Fallbacks)
251
+
252
+ # Fallbacks fills its hash one locale at a time on first lookup, so ask for each.
253
+ fallbacks = I18n.fallbacks
254
+ locales = (I18n.available_locales.map(&:to_sym) + fallbacks.to_h.keys).uniq
255
+ { fallbacks: locales.to_h { |locale| [ locale.to_s, fallbacks[locale].map(&:to_s) ] } }
228
256
  rescue => e
229
257
  RailsAiContext.debug_fail(e, {}, label: "detect_fallback_config")
230
258
  end
@@ -304,13 +332,10 @@ module RailsAiContext
304
332
  # config/locales/en/users.yml
305
333
  # config/locales/admin/en.yml
306
334
  def find_locale_paths(locale)
307
- base = locales_dir
308
- return [] unless base
309
-
310
335
  loc = locale.to_s
311
336
  named = locale_file_paths.select do |p|
312
337
  name = File.basename(p, ".*")
313
- rel = p.sub("#{base}/", "")
338
+ rel = display_path(p)
314
339
  name == loc || name.end_with?(".#{loc}") || rel.start_with?("#{loc}/") || rel.include?("/#{loc}/")
315
340
  end
316
341
 
@@ -329,8 +354,12 @@ module RailsAiContext
329
354
  @locales_dir = Dir.exist?(dir) ? dir : nil
330
355
  end
331
356
 
357
+ # The files Rails loads: config/locales by its glob, then what config.i18n.load_path adds.
332
358
  def locale_file_paths
333
- @locale_file_paths ||= locales_dir ? Dir.glob(File.join(locales_dir, "**/*.{yml,yaml}")).sort : []
359
+ @locale_file_paths ||= begin
360
+ defaults = locales_dir ? Dir.glob(File.join(locales_dir, RAILS_LOCALE_GLOB)) : []
361
+ (defaults + load_path_files).uniq.sort
362
+ end
334
363
  end
335
364
 
336
365
  # locale => the files declaring it, built in ONE pass. Asking every file
@@ -350,16 +379,15 @@ module RailsAiContext
350
379
  @locale_index ||= locale_file_paths.to_h { |path| [ path, index_locale_file(path) ] }
351
380
  end
352
381
 
382
+ BACKEND_SETTINGS = [ %w[i18n plural], %w[i18n transliterate] ].freeze
383
+
353
384
  def index_locale_file(path)
354
385
  content = RailsAiContext::SafeFile.read(path)
355
386
  return REFUSED_LOCALE_FILE unless content
356
387
 
357
- # aliases: true - sharing formats through a YAML anchor is ordinary,
358
- # and without the flag Psych raises and every locale in that file
359
- # disappears while the Locale Files section still lists it.
360
- data = YAML.safe_load(content, permitted_classes: [ Symbol ], aliases: true)
361
- data = {} unless data.is_a?(Hash)
362
- key_paths = nested_key_paths(data)
388
+ data = path.end_with?(".rb") ? ruby_locale_data(content) : yaml_locale_data(content)
389
+ # I18n reads <locale>.i18n.plural and .transliterate as backend settings, not translations.
390
+ key_paths = nested_key_paths(data).reject { |key_path| key_path.include?(".i18n.") && BACKEND_SETTINGS.include?(key_path.split(".", 4)[1, 2]) }
363
391
 
364
392
  # Only the locale-rooted paths are kept. The per-locale lists are the
365
393
  # same strings without their root, so holding both doubled what an
@@ -375,6 +403,33 @@ module RailsAiContext
375
403
  RailsAiContext.debug_fail(e, REFUSED_LOCALE_FILE, label: "i18n parse of #{path}")
376
404
  end
377
405
 
406
+ def yaml_locale_data(content)
407
+ # aliases: true - sharing formats through a YAML anchor is ordinary,
408
+ # and without the flag Psych raises and every locale in that file
409
+ # disappears while the Locale Files section still lists it.
410
+ data = YAML.safe_load(content, permitted_classes: [ Symbol ], aliases: true)
411
+ data.is_a?(Hash) ? data : {}
412
+ end
413
+
414
+ # I18n evals a .rb locale file for the Hash it returns. Its literal keys are read
415
+ # from the AST instead, so neither tier runs app code; a non-literal value is a leaf.
416
+ def ruby_locale_data(content)
417
+ result = AstCache.parse_string(content)
418
+ raise ArgumentError, "unparseable Ruby locale file" if result.failure?
419
+
420
+ hash = result.value.statements.body.last
421
+ hash.is_a?(Prism::HashNode) ? literal_hash(hash) : {}
422
+ end
423
+
424
+ def literal_hash(node)
425
+ node.elements.each_with_object({}) do |element, hash|
426
+ next unless element.is_a?(Prism::AssocNode) && element.key.respond_to?(:unescaped)
427
+
428
+ value = element.value
429
+ hash[element.key.unescaped] = value.is_a?(Prism::HashNode) ? literal_hash(value) : true
430
+ end
431
+ end
432
+
378
433
  def nested_key_paths(hash, prefix = nil, paths = [])
379
434
  return paths unless hash.is_a?(Hash)
380
435
  hash.each do |key, value|
@@ -21,6 +21,12 @@ module RailsAiContext
21
21
 
22
22
  segments = names.map { |name| name.split("::").last }.uniq
23
23
  found = Hash.new { |hash, key| hash[key] = [] }
24
+ # One run, so the directories every resolution walks are listed once for the whole scan.
25
+ RunCache.around { collect(root, sources, segments, known, macros, found) }
26
+ found.transform_values(&:uniq)
27
+ end
28
+
29
+ def collect(root, sources, segments, known, macros, found)
24
30
  sources.each do |_path, source|
25
31
  next unless source && segments.any? { |segment| source.include?(segment) }
26
32
 
@@ -35,7 +41,6 @@ module RailsAiContext
35
41
  found[name] << includer if name
36
42
  end
37
43
  end
38
- found.transform_values(&:uniq)
39
44
  end
40
45
 
41
46
  # The name asked about the written one means, or nil when the nearest
@@ -48,14 +48,11 @@ module RailsAiContext
48
48
  end
49
49
  end
50
50
 
51
- # Initializers defined in config/application.rb or config/initializers/*.rb
51
+ # Initializers defined in config/application.rb or config/initializers
52
52
  # are the ones the user wrote. Return file + count of initializer blocks
53
53
  # declared inside each file so AI can jump straight to user-owned code.
54
54
  def extract_application_initializers
55
- dir = File.join(root, "config/initializers")
56
- return [] unless Dir.exist?(dir)
57
-
58
- Dir.glob(File.join(dir, "*.rb")).sort.filter_map do |path|
55
+ PathResolver.initializer_paths(root).filter_map do |path|
59
56
  next unless RailsAiContext::SafeFile.read(path)
60
57
 
61
58
  ast = SourceIntrospector.walk(path, {