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
@@ -13,29 +13,19 @@ module RailsAiContext
13
13
  class MixinsListener < BaseListener
14
14
  MIXIN_MACROS = %i[include prepend extend].to_set.freeze
15
15
  ANCESTOR_MACROS = %i[include prepend].to_set.freeze
16
+ # GitLab's `prepend_mod_with("Note")` mixes in EE::Note and JH::Note, each where that edition defines it;
17
+ # `prepend_mod` names the class itself.
18
+ EDITION_MACROS = {
19
+ include_mod_with: :include, prepend_mod_with: :prepend, extend_mod_with: :extend,
20
+ include_mod: :include, prepend_mod: :prepend, extend_mod: :extend
21
+ }.freeze
22
+ EDITIONS = %w[EE JH].freeze
23
+
24
+ include OwnerScope
16
25
 
17
26
  def initialize
18
27
  super
19
28
  @singleton_depth = 0
20
- @owner_stack = []
21
- end
22
-
23
- # The class or module the mixin is written in, the way MethodsListener
24
- # records a method's: a nested class's include is not its module's.
25
- def on_class_node_enter(node)
26
- @owner_stack.push(constant_path_string(node.constant_path))
27
- end
28
-
29
- def on_class_node_leave(_node)
30
- @owner_stack.pop
31
- end
32
-
33
- def on_module_node_enter(node)
34
- @owner_stack.push(constant_path_string(node.constant_path))
35
- end
36
-
37
- def on_module_node_leave(_node)
38
- @owner_stack.pop
39
29
  end
40
30
 
41
31
  # `include` inside `class << self` lands on the singleton class, so it
@@ -48,27 +38,41 @@ module RailsAiContext
48
38
  @singleton_depth -= 1
49
39
  end
50
40
 
41
+ # `singleton_class` called on what stands for the class: nothing or `self` in its body, `base` in a hook.
42
+ # `singleton_class.include M` gives the class M's methods, as `extend` does, without `extended`.
43
+ def self.singleton_class_of?(node, &stands_for_class)
44
+ node.is_a?(Prism::CallNode) && node.name == :singleton_class && node.arguments.nil? && stands_for_class.call(node.receiver)
45
+ end
46
+
47
+ # The record of `node` mixing in `name`.
48
+ def self.record(node, macro, name, ancestor:, owner: [])
49
+ { macro: macro, name: name, ancestor: ancestor, owner: owner, location: node.location.start_line,
50
+ confidence: confidence_for(node) }
51
+ end
52
+
51
53
  # `Type.include(StatusPatch)` mixes into Type, not the class the line sits in, so the
52
54
  # record names Type as `receiver` and it is never an ancestor of the enclosing class.
53
55
  def on_call_node_enter(node)
54
56
  receiver = node.receiver && constant_name(node.receiver)
55
- return unless node.receiver.nil? || receiver
57
+ singleton = self.class.singleton_class_of?(node.receiver) { |inner| inner.nil? || inner.is_a?(Prism::SelfNode) }
58
+ return unless node.receiver.nil? || receiver || singleton
59
+
60
+ return record_edition(node, receiver) if EDITION_MACROS.key?(node.name)
61
+ return record_concerning(node) if node.name == :concerning && node.receiver.nil?
56
62
 
57
63
  macro, arguments = mixin_call(node)
58
64
  return unless macro
65
+ return if singleton && macro == :extend
66
+
67
+ macro = :"singleton_#{macro}" if singleton
59
68
 
60
- arguments.each do |arg|
69
+ # Ruby adds `include A, B` last argument first: B's hook runs first and A ends up nearer.
70
+ arguments.reverse_each do |arg|
61
71
  name = constant_name(arg)
62
72
  next unless name
63
73
 
64
- record = {
65
- macro: macro,
66
- name: name,
67
- ancestor: receiver.nil? && @singleton_depth.zero? && ANCESTOR_MACROS.include?(macro),
68
- owner: @owner_stack.dup,
69
- location: node.location.start_line,
70
- confidence: confidence_for(node)
71
- }
74
+ ancestor = receiver.nil? && @singleton_depth.zero? && ANCESTOR_MACROS.include?(macro)
75
+ record = self.class.record(node, macro, name, ancestor: ancestor, owner: @owner_stack.dup)
72
76
  record[:receiver] = receiver if receiver
73
77
  @results << record
74
78
  end
@@ -76,6 +80,35 @@ module RailsAiContext
76
80
 
77
81
  private
78
82
 
83
+ def record_edition(node, receiver)
84
+ macro = EDITION_MACROS[node.name]
85
+ arguments = node.arguments&.arguments || []
86
+ name = if node.name.end_with?("_with")
87
+ arguments.first.unescaped if arguments.size == 1 && arguments.first.is_a?(Prism::StringNode)
88
+ elsif arguments.empty?
89
+ receiver || @owner_stack.join("::").presence
90
+ end
91
+ return unless name
92
+
93
+ ancestor = receiver.nil? && @singleton_depth.zero? && ANCESTOR_MACROS.include?(macro)
94
+ EDITIONS.each do |edition|
95
+ record = self.class.record(node, macro, "#{edition}::#{name}", ancestor: ancestor, owner: @owner_stack.dup)
96
+ record[:receiver] = receiver if receiver
97
+ @results << record.merge(edition: true)
98
+ end
99
+ end
100
+
101
+ # `concerning :Topic do` defines Owner::Topic and mixes it in; `inline`
102
+ # says its body is the block, already read as the class's own.
103
+ def record_concerning(node)
104
+ topic = node.arguments&.arguments&.first
105
+ return unless topic.is_a?(Prism::SymbolNode) && node.block && !@owner_stack.empty?
106
+
107
+ macro = extract_keyword_nodes(node)[:prepend].is_a?(Prism::TrueNode) ? :prepend : :include
108
+ name = "#{@owner_stack.join("::")}::#{topic.unescaped}"
109
+ @results << self.class.record(node, macro, name, ancestor: @singleton_depth.zero?, owner: @owner_stack.dup).merge(inline: true)
110
+ end
111
+
79
112
  # `include X`, and `send :include, X`, the same include written to reach a private method.
80
113
  def mixin_call(node)
81
114
  arguments = node.arguments&.arguments || []
@@ -14,6 +14,8 @@ module RailsAiContext
14
14
  # unanchored mount at /metrics also answers /metrics-admin - and that
15
15
  # form was invisible here, which left the endpoint out of every tool.
16
16
  class MountListener < BaseListener
17
+ include BranchConditions
18
+
17
19
  VERB_MACROS = %i[match get post put patch delete].freeze
18
20
 
19
21
  # The blocks that prefix every path drawn inside them.
@@ -42,6 +44,12 @@ module RailsAiContext
42
44
  return unless engine
43
45
 
44
46
  record = { engine: engine, path: prefixed_path(path), location: node.location.start_line }
47
+ condition = current_condition
48
+ if condition
49
+ record[:condition] = condition
50
+ arm = chain_arm
51
+ record[:arm] = arm if arm
52
+ end
45
53
  # The mount's route name, which names an engine's route proxy.
46
54
  if node.name == :mount
47
55
  as = extract_keyword_nodes(node)[:as]
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ module Listeners
6
+ # Roots an app hands Zeitwerk under a namespace, literal paths only:
7
+ #
8
+ # Rails.autoloaders.main.push_dir(Rails.root.join("app/components"), namespace: Components)
9
+ # → ["app/components", "Components"]
10
+ #
11
+ # phlex:install writes this, so app/components/base.rb is Components::Base.
12
+ class NamespacedRootsListener < BaseListener
13
+ include LiteralPaths
14
+
15
+ def on_call_node_enter(node)
16
+ return unless node.name == :push_dir
17
+
18
+ arguments = Array(node.arguments&.arguments)
19
+ @namespace = namespace_of(extract_keyword_nodes(node)[:namespace])
20
+ collect_paths(arguments.first) if @namespace
21
+ end
22
+
23
+ private
24
+
25
+ def namespace_of(value)
26
+ value.slice.delete_prefix("::") if value.is_a?(Prism::ConstantReadNode) || value.is_a?(Prism::ConstantPathNode)
27
+ end
28
+
29
+ def record_path(path)
30
+ @results << [ path, @namespace ]
31
+ end
32
+ end
33
+ end
34
+ end
35
+ end
@@ -0,0 +1,32 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ module Listeners
6
+ # The offset ranges of the modules and classes a class body nests: what they declare runs only where they are mixed in.
7
+ class NestedConstantsListener < BaseListener
8
+ def initialize
9
+ super
10
+ @depth = 0
11
+ end
12
+
13
+ def on_class_node_enter(node)
14
+ record(node)
15
+ @depth += 1
16
+ end
17
+
18
+ def on_class_node_leave(_node)
19
+ @depth -= 1
20
+ end
21
+
22
+ def on_module_node_enter(node) = record(node)
23
+
24
+ private
25
+
26
+ def record(node)
27
+ @results << (node.location.start_offset...node.location.end_offset) if @depth.positive?
28
+ end
29
+ end
30
+ end
31
+ end
32
+ end
@@ -0,0 +1,67 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ module Listeners
6
+ # The class or module a record is written in, so a nested class's
7
+ # declarations stay its own. `Sib = Class.new(Base) do` opens Sib.
8
+ module OwnerScope
9
+ def initialize(...)
10
+ super
11
+ @owner_stack = []
12
+ @class_new_writes = []
13
+ end
14
+
15
+ def on_class_node_enter(node)
16
+ @owner_stack.push(constant_path_string(node.constant_path))
17
+ end
18
+
19
+ def on_class_node_leave(_node)
20
+ @owner_stack.pop
21
+ end
22
+
23
+ def on_module_node_enter(node)
24
+ @owner_stack.push(constant_path_string(node.constant_path))
25
+ end
26
+
27
+ def on_module_node_leave(_node)
28
+ @owner_stack.pop
29
+ end
30
+
31
+ def on_constant_write_node_enter(node)
32
+ enter_class_new(node, node.name.to_s)
33
+ end
34
+
35
+ def on_constant_write_node_leave(node)
36
+ leave_class_new(node)
37
+ end
38
+
39
+ def on_constant_path_write_node_enter(node)
40
+ enter_class_new(node, node.target.slice)
41
+ end
42
+
43
+ def on_constant_path_write_node_leave(node)
44
+ leave_class_new(node)
45
+ end
46
+
47
+ private
48
+
49
+ def enter_class_new(node, name)
50
+ value = node.value
51
+ return unless value.is_a?(Prism::CallNode) && value.name == :new && value.block &&
52
+ value.receiver.is_a?(Prism::ConstantReadNode) && value.receiver.name == :Class
53
+
54
+ @owner_stack.push(name)
55
+ @class_new_writes.push(node)
56
+ end
57
+
58
+ def leave_class_new(node)
59
+ return unless @class_new_writes.last.equal?(node)
60
+
61
+ @class_new_writes.pop
62
+ @owner_stack.pop
63
+ end
64
+ end
65
+ end
66
+ end
67
+ end
@@ -3,15 +3,24 @@
3
3
  module RailsAiContext
4
4
  module Introspectors
5
5
  module Listeners
6
- # ViewComponent preview directories an app sets, literal paths only:
6
+ # ViewComponent (or, given `framework: :action_mailer`, mailer) preview
7
+ # directories an app sets, literal paths only:
7
8
  #
8
9
  # config.view_component.previews.paths += [Rails.root.join("lookbook/previews").to_s]
9
10
  # config.view_component.preview_paths << "#{Rails.root}/spec/previews"
11
+ # config.action_mailer.preview_paths << "#{root}/lib/mailer_previews"
10
12
  #
11
- # The path forms are the autoload listener's, so both read one way.
12
- class PreviewPathsListener < AutoloadPathsListener
13
+ # The path forms are LiteralPaths'.
14
+ class PreviewPathsListener < BaseListener
15
+ include LiteralPaths
16
+
13
17
  ASSIGNING = %i[preview_paths= preview_path= paths=].to_set.freeze
14
18
 
19
+ def initialize(framework: :view_component)
20
+ super()
21
+ @framework = framework
22
+ end
23
+
15
24
  def on_call_node_enter(node)
16
25
  if ASSIGNING.include?(node.name)
17
26
  return unless preview_target?(node.name.to_s.delete_suffix("=").to_sym, node.receiver)
@@ -31,14 +40,14 @@ module RailsAiContext
31
40
 
32
41
  private
33
42
 
34
- # `preview_paths` / `preview_path` on view_component, or `paths` on
35
- # its `previews`.
43
+ # `preview_paths` / `preview_path` on the framework, or `paths` on
44
+ # view_component's `previews`.
36
45
  def preview_target?(name, receiver)
37
46
  return false unless receiver.is_a?(Prism::CallNode)
38
47
 
39
48
  case name
40
- when :preview_paths, :preview_path then receiver.name == :view_component
41
- when :paths then receiver.name == :previews
49
+ when :preview_paths, :preview_path then receiver.name == @framework
50
+ when :paths then @framework == :view_component && receiver.name == :previews
42
51
  else false
43
52
  end
44
53
  end
@@ -0,0 +1,42 @@
1
+ # frozen_string_literal: true
2
+
3
+ module RailsAiContext
4
+ module Introspectors
5
+ module Listeners
6
+ # Every Proc literal (`-> {}`, `lambda {}`, `proc {}`, `Proc.new {}`) with
7
+ # the line it starts on and the constant it is assigned to, if any.
8
+ class ProcLiteralListener < BaseListener
9
+ def initialize
10
+ super
11
+ @assigned = {}
12
+ end
13
+
14
+ def on_constant_write_node_enter(node)
15
+ @assigned[node.value.location.start_offset] = node.name.to_s
16
+ end
17
+
18
+ def on_lambda_node_enter(node)
19
+ record(node)
20
+ end
21
+
22
+ def on_call_node_enter(node)
23
+ record(node) if proc_call?(node)
24
+ end
25
+
26
+ private
27
+
28
+ def proc_call?(node)
29
+ return false unless node.block.is_a?(Prism::BlockNode)
30
+ return %i[lambda proc].include?(node.name) if node.receiver.nil?
31
+
32
+ node.name == :new && node.receiver.is_a?(Prism::ConstantReadNode) && node.receiver.name == :Proc
33
+ end
34
+
35
+ def record(node)
36
+ @results << { line: node.location.start_line, constant: @assigned[node.location.start_offset],
37
+ source: one_line_source(node) }
38
+ end
39
+ end
40
+ end
41
+ end
42
+ end
@@ -0,0 +1,54 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "prism"
4
+
5
+ module RailsAiContext
6
+ module Introspectors
7
+ module Listeners
8
+ # A queue a class body assigns outside any method: Resque's `@queue = :name`
9
+ # and Que's `self.queue = "name"`, or a `def self.queue` returning one, which
10
+ # Resque asks for when @queue is unset. A literal is kept as its value, anything else as source.
11
+ class QueueAssignmentListener < BaseListener
12
+ def initialize
13
+ super
14
+ @def_depth = 0
15
+ end
16
+
17
+ def on_def_node_enter(node)
18
+ if @def_depth.zero? && node.name == :queue && node.receiver.is_a?(Prism::SelfNode) && node.parameters.nil?
19
+ body = node.body
20
+ body = body.body.first if body.is_a?(Prism::StatementsNode) && body.body.one?
21
+ record(node, body, :method) if body && !body.is_a?(Prism::StatementsNode)
22
+ end
23
+ @def_depth += 1
24
+ end
25
+
26
+ def on_def_node_leave(_node)
27
+ @def_depth -= 1
28
+ end
29
+
30
+ def on_instance_variable_write_node_enter(node)
31
+ record(node, node.value, :ivar) if @def_depth.zero? && node.name == :@queue
32
+ end
33
+
34
+ def on_call_node_enter(node)
35
+ return unless @def_depth.zero? && node.name == :queue= && node.receiver.is_a?(Prism::SelfNode)
36
+
37
+ value = node.arguments&.arguments&.first
38
+ record(node, value, :self) if value
39
+ end
40
+
41
+ private
42
+
43
+ # A half-written `@queue =` parses with a MissingNode value.
44
+ def record(node, value, form)
45
+ return if value.is_a?(Prism::MissingNode)
46
+
47
+ literal = value.is_a?(Prism::SymbolNode) || value.is_a?(Prism::StringNode)
48
+ @results << { form: form, queue: literal ? value.unescaped : nil, source: value.slice,
49
+ location: node.location.start_line, confidence: literal ? Confidence::VERIFIED : Confidence::INFERRED }
50
+ end
51
+ end
52
+ end
53
+ end
54
+ end
@@ -4,7 +4,8 @@ module RailsAiContext
4
4
  module Introspectors
5
5
  module Listeners
6
6
  # Detects rake task DSL patterns via Prism AST:
7
- # namespace :name, desc "...", task :name => [:dep1]
7
+ # namespace :name, desc "...", task :name => [:dep1], multitask.
8
+ # Each entry carries its byte offset, and a namespace its end, so a reader can scope tasks.
8
9
  class RakeTaskDslListener < BaseListener
9
10
  def on_call_node_enter(node)
10
11
  return unless node.receiver.nil?
@@ -14,7 +15,7 @@ module RailsAiContext
14
15
  extract_namespace(node)
15
16
  when :desc
16
17
  extract_desc(node)
17
- when :task
18
+ when :task, :multitask
18
19
  extract_task(node)
19
20
  end
20
21
  end
@@ -26,9 +27,11 @@ module RailsAiContext
26
27
  return if name == RailsAiContext::Confidence::INFERRED
27
28
 
28
29
  @results << {
29
- type: :namespace,
30
- name: name.to_s,
31
- location: node.location.start_line
30
+ type: :namespace,
31
+ name: name.to_s,
32
+ location: node.location.start_line,
33
+ offset: node.location.start_offset,
34
+ end_offset: node.location.end_offset
32
35
  }
33
36
  end
34
37
 
@@ -40,7 +43,8 @@ module RailsAiContext
40
43
  @results << {
41
44
  type: :desc,
42
45
  description: text.unescaped,
43
- location: node.location.start_line
46
+ location: node.location.start_line,
47
+ offset: node.location.start_offset
44
48
  }
45
49
  end
46
50
 
@@ -52,13 +56,14 @@ module RailsAiContext
52
56
  task_args = []
53
57
 
54
58
  case first
55
- when Prism::SymbolNode
59
+ when Prism::SymbolNode, Prism::StringNode
56
60
  name = first.unescaped
57
61
  deps = extract_task_deps(args)
58
62
  # Check for task arguments: task :name, [:arg1, :arg2] => :environment
59
63
  # Prism parses this as SymbolNode + KeywordHashNode where key is ArrayNode
60
64
  task_args, extra_deps = extract_args_from_keyword_hash(args)
61
65
  deps = extra_deps if extra_deps.any?
66
+ task_args = positional_args(args.drop(1)) if task_args.empty?
62
67
  when Prism::KeywordHashNode, Prism::HashNode
63
68
  # task name: :dep or task name: [:dep1, :dep2]
64
69
  name, deps = extract_hash_task(first)
@@ -73,7 +78,8 @@ module RailsAiContext
73
78
  name: name,
74
79
  deps: deps || [],
75
80
  args: task_args,
76
- location: node.location.start_line
81
+ location: node.location.start_line,
82
+ offset: node.location.start_offset
77
83
  }
78
84
  end
79
85
 
@@ -96,6 +102,13 @@ module RailsAiContext
96
102
  [ [], [] ]
97
103
  end
98
104
 
105
+ # Rake's resolve_args without dependencies: `task :go, [:a, :b]`, or the older `task :go, :a, :b`.
106
+ def positional_args(rest)
107
+ rest = rest.reject { |arg| arg.is_a?(Prism::KeywordHashNode) || arg.is_a?(Prism::HashNode) }
108
+ rest = rest.first.elements if rest.one? && rest.first.is_a?(Prism::ArrayNode)
109
+ rest.filter_map { |arg| literal_string(arg) }
110
+ end
111
+
99
112
  def extract_task_deps(args)
100
113
  args.each do |arg|
101
114
  next unless arg.is_a?(Prism::KeywordHashNode) || arg.is_a?(Prism::HashNode)
@@ -12,6 +12,8 @@ module RailsAiContext
12
12
  # Literal paths and literal globs only; a list the app computes is
13
13
  # recorded as computed so the answer can say routes are missing.
14
14
  class RouteFilesListener < BaseListener
15
+ include LiteralPaths
16
+
15
17
  ROUTES_KEY = "config/routes.rb"
16
18
  APPENDING = { :<< => :append, push: :append, append: :append, concat: :append,
17
19
  unshift: :prepend, prepend: :prepend }.freeze
@@ -63,27 +65,18 @@ module RailsAiContext
63
65
  when :map then node.receiver.is_a?(Prism::ArrayNode) && collect(node.receiver, paths, globs)
64
66
  when :to_s then collect(node.receiver, paths, globs)
65
67
  when :join
66
- segments = rails_root_join(node)
68
+ segments = app_root_join(node)
67
69
  segments ? (paths << File.join(*segments)) : false
68
70
  when :[], :glob
69
71
  return false unless dir_constant?(node.receiver)
70
72
 
71
73
  pattern = Array(node.arguments&.arguments).first
72
- literal = pattern.is_a?(Prism::StringNode) ? [ pattern.unescaped ] : (pattern.is_a?(Prism::CallNode) && rails_root_join(pattern))
74
+ literal = pattern.is_a?(Prism::StringNode) ? [ pattern.unescaped ] : (pattern.is_a?(Prism::CallNode) && app_root_join(pattern))
73
75
  literal ? (globs << File.join(*literal)) : false
74
76
  else false
75
77
  end
76
78
  end
77
79
 
78
- def rails_root_join(node)
79
- return nil unless node.is_a?(Prism::CallNode) && node.name == :join && node.receiver&.slice == "Rails.root"
80
-
81
- segments = Array(node.arguments&.arguments)
82
- return nil unless segments.all? { |segment| segment.is_a?(Prism::StringNode) }
83
-
84
- segments.map(&:unescaped)
85
- end
86
-
87
80
  def dir_constant?(node)
88
81
  node.is_a?(Prism::ConstantReadNode) && node.name == :Dir
89
82
  end