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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +868 -0
- data/CONTEXT.md +7 -3
- data/README.md +1 -1
- data/docs/ARCHITECTURE.md +3 -3
- data/docs/CLI.md +1 -1
- data/docs/COMPATIBILITY.md +50 -14
- data/docs/CONFIGURATION.md +4 -1
- data/docs/FAQ.md +1 -1
- data/docs/GUIDE.md +14 -8
- data/docs/INTROSPECTORS.md +50 -23
- data/docs/SECURITY.md +56 -1
- data/docs/TOOLS.md +58 -12
- data/lib/generators/rails_ai_context/install/install_generator.rb +1 -0
- data/lib/rails_ai_context/action_filters.rb +121 -48
- data/lib/rails_ai_context/app_commands.rb +2 -2
- data/lib/rails_ai_context/app_kind.rb +65 -8
- data/lib/rails_ai_context/ast_cache.rb +53 -18
- data/lib/rails_ai_context/base_mixins.rb +46 -16
- data/lib/rails_ai_context/boot_manager.rb +5 -1
- data/lib/rails_ai_context/cli/entry_boot.rb +17 -2
- data/lib/rails_ai_context/cli/tool_runner.rb +15 -1
- data/lib/rails_ai_context/concern_macros.rb +791 -111
- data/lib/rails_ai_context/concern_membership.rb +25 -5
- data/lib/rails_ai_context/concern_paths.rb +63 -17
- data/lib/rails_ai_context/config_yaml.rb +40 -0
- data/lib/rails_ai_context/configuration.rb +3 -3
- data/lib/rails_ai_context/data/docs/index.json +324 -0
- data/lib/rails_ai_context/database_yml.rb +136 -0
- data/lib/rails_ai_context/doctor.rb +30 -37
- data/lib/rails_ai_context/erb_source.rb +40 -0
- data/lib/rails_ai_context/fingerprinter.rb +48 -22
- data/lib/rails_ai_context/fixture_keys.rb +42 -1
- data/lib/rails_ai_context/gem_lock.rb +275 -47
- data/lib/rails_ai_context/git_ignore.rb +13 -11
- data/lib/rails_ai_context/hydrators/hydration_formatter.rb +8 -2
- data/lib/rails_ai_context/hydrators/schema_hint_builder.rb +10 -5
- data/lib/rails_ai_context/introspector.rb +10 -1
- data/lib/rails_ai_context/introspectors/action_mailbox_introspector.rb +27 -19
- data/lib/rails_ai_context/introspectors/action_presence.rb +11 -8
- data/lib/rails_ai_context/introspectors/action_resolver.rb +38 -26
- data/lib/rails_ai_context/introspectors/action_text_introspector.rb +2 -2
- data/lib/rails_ai_context/introspectors/active_record_settings.rb +56 -0
- data/lib/rails_ai_context/introspectors/active_storage_introspector.rb +1 -1
- data/lib/rails_ai_context/introspectors/active_support_introspector.rb +98 -22
- data/lib/rails_ai_context/introspectors/admin_resources.rb +101 -0
- data/lib/rails_ai_context/introspectors/anyway_configs.rb +64 -0
- data/lib/rails_ai_context/introspectors/apartment_config.rb +47 -0
- data/lib/rails_ai_context/introspectors/api_introspector.rb +125 -26
- data/lib/rails_ai_context/introspectors/asset_pipeline_introspector.rb +24 -19
- data/lib/rails_ai_context/introspectors/ast_walk.rb +18 -0
- data/lib/rails_ai_context/introspectors/auth_introspector.rb +71 -18
- data/lib/rails_ai_context/introspectors/autoload_introspector.rb +62 -15
- data/lib/rails_ai_context/introspectors/base.rb +38 -0
- data/lib/rails_ai_context/introspectors/call_site_expansion.rb +349 -39
- data/lib/rails_ai_context/introspectors/component_introspector.rb +26 -14
- data/lib/rails_ai_context/introspectors/config_introspector.rb +22 -9
- data/lib/rails_ai_context/introspectors/connection_pool_introspector.rb +1 -4
- data/lib/rails_ai_context/introspectors/controller_filters.rb +335 -31
- data/lib/rails_ai_context/introspectors/controller_introspector.rb +315 -129
- data/lib/rails_ai_context/introspectors/controller_settings.rb +182 -0
- data/lib/rails_ai_context/introspectors/convention_introspector.rb +18 -15
- data/lib/rails_ai_context/introspectors/database_stats_introspector.rb +1 -1
- data/lib/rails_ai_context/introspectors/declared_constant.rb +108 -23
- data/lib/rails_ai_context/introspectors/eager_load.rb +12 -7
- data/lib/rails_ai_context/introspectors/engine_introspector.rb +13 -5
- data/lib/rails_ai_context/introspectors/env_config_introspector.rb +62 -17
- data/lib/rails_ai_context/introspectors/env_introspector.rb +8 -6
- data/lib/rails_ai_context/introspectors/env_references.rb +21 -4
- data/lib/rails_ai_context/introspectors/frontend_framework_introspector.rb +37 -22
- data/lib/rails_ai_context/introspectors/gem_introspector.rb +3 -1
- data/lib/rails_ai_context/introspectors/gemfile_gems.rb +53 -5
- data/lib/rails_ai_context/introspectors/grape_endpoints.rb +109 -0
- data/lib/rails_ai_context/introspectors/helper_names.rb +12 -1
- data/lib/rails_ai_context/introspectors/i18n_introspector.rb +101 -46
- data/lib/rails_ai_context/introspectors/includers.rb +6 -1
- data/lib/rails_ai_context/introspectors/initializer_introspector.rb +2 -5
- data/lib/rails_ai_context/introspectors/job_introspector.rb +548 -103
- data/lib/rails_ai_context/introspectors/listener_registration.rb +11 -1
- data/lib/rails_ai_context/introspectors/listeners/associations_listener.rb +51 -4
- data/lib/rails_ai_context/introspectors/listeners/autoload_ignore_listener.rb +31 -0
- data/lib/rails_ai_context/introspectors/listeners/autoload_paths_listener.rb +4 -47
- data/lib/rails_ai_context/introspectors/listeners/base_listener.rb +80 -14
- data/lib/rails_ai_context/introspectors/listeners/branch_conditions.rb +156 -0
- data/lib/rails_ai_context/introspectors/listeners/callbacks_listener.rb +85 -23
- data/lib/rails_ai_context/introspectors/listeners/class_definition_listener.rb +35 -6
- data/lib/rails_ai_context/introspectors/listeners/component_structure_listener.rb +30 -2
- data/lib/rails_ai_context/introspectors/listeners/conditional_macro_listener.rb +19 -0
- data/lib/rails_ai_context/introspectors/listeners/config_assignment_listener.rb +255 -10
- data/lib/rails_ai_context/introspectors/listeners/constant_reference_listener.rb +34 -0
- data/lib/rails_ai_context/introspectors/listeners/constructor_macro_listener.rb +123 -0
- data/lib/rails_ai_context/introspectors/listeners/definition_file_paths_listener.rb +66 -0
- data/lib/rails_ai_context/introspectors/listeners/enums_listener.rb +2 -2
- data/lib/rails_ai_context/introspectors/listeners/env_access_listener.rb +31 -0
- data/lib/rails_ai_context/introspectors/listeners/filter_macro_listener.rb +54 -0
- data/lib/rails_ai_context/introspectors/listeners/fixture_paths_listener.rb +62 -0
- data/lib/rails_ai_context/introspectors/listeners/gemfile_dsl_listener.rb +42 -1
- data/lib/rails_ai_context/introspectors/listeners/generic_macro_listener.rb +28 -2
- data/lib/rails_ai_context/introspectors/listeners/grape_api_listener.rb +137 -0
- data/lib/rails_ai_context/introspectors/listeners/http_client_call_listener.rb +50 -0
- data/lib/rails_ai_context/introspectors/listeners/i18n_load_path_listener.rb +54 -0
- data/lib/rails_ai_context/introspectors/listeners/literal_paths.rb +123 -0
- data/lib/rails_ai_context/introspectors/listeners/macros_listener.rb +248 -4
- data/lib/rails_ai_context/introspectors/listeners/mailbox_routing_listener.rb +2 -1
- data/lib/rails_ai_context/introspectors/listeners/method_call_listener.rb +7 -1
- data/lib/rails_ai_context/introspectors/listeners/methods_listener.rb +352 -69
- data/lib/rails_ai_context/introspectors/listeners/migration_dsl_listener.rb +1 -1
- data/lib/rails_ai_context/introspectors/listeners/migration_replay_listener.rb +35 -26
- data/lib/rails_ai_context/introspectors/listeners/mixins_listener.rb +62 -29
- data/lib/rails_ai_context/introspectors/listeners/mount_listener.rb +8 -0
- data/lib/rails_ai_context/introspectors/listeners/namespaced_roots_listener.rb +35 -0
- data/lib/rails_ai_context/introspectors/listeners/nested_constants_listener.rb +32 -0
- data/lib/rails_ai_context/introspectors/listeners/owner_scope.rb +67 -0
- data/lib/rails_ai_context/introspectors/listeners/preview_paths_listener.rb +16 -7
- data/lib/rails_ai_context/introspectors/listeners/proc_literal_listener.rb +42 -0
- data/lib/rails_ai_context/introspectors/listeners/queue_assignment_listener.rb +54 -0
- data/lib/rails_ai_context/introspectors/listeners/rake_task_dsl_listener.rb +21 -8
- data/lib/rails_ai_context/introspectors/listeners/route_files_listener.rb +4 -11
- data/lib/rails_ai_context/introspectors/listeners/routes_dsl_listener.rb +461 -65
- data/lib/rails_ai_context/introspectors/listeners/schema_dsl_listener.rb +76 -14
- data/lib/rails_ai_context/introspectors/listeners/scopes_listener.rb +40 -1
- data/lib/rails_ai_context/introspectors/listeners/validations_listener.rb +10 -1
- data/lib/rails_ai_context/introspectors/listeners/view_paths_listener.rb +37 -0
- data/lib/rails_ai_context/introspectors/middleware_introspector.rb +47 -3
- data/lib/rails_ai_context/introspectors/migration_introspector.rb +3 -3
- data/lib/rails_ai_context/introspectors/migration_replay/helpers.rb +4 -3
- data/lib/rails_ai_context/introspectors/migration_replay/statements.rb +72 -12
- data/lib/rails_ai_context/introspectors/migration_replay.rb +110 -14
- data/lib/rails_ai_context/introspectors/model_introspector.rb +708 -214
- data/lib/rails_ai_context/introspectors/module_aliases.rb +11 -3
- data/lib/rails_ai_context/introspectors/multi_database_introspector.rb +9 -57
- data/lib/rails_ai_context/introspectors/observability_introspector.rb +5 -8
- data/lib/rails_ai_context/introspectors/performance_introspector.rb +28 -8
- data/lib/rails_ai_context/introspectors/rake_task_introspector.rb +118 -51
- data/lib/rails_ai_context/introspectors/recurring_schedules.rb +150 -0
- data/lib/rails_ai_context/introspectors/rendered_record.rb +87 -0
- data/lib/rails_ai_context/introspectors/retry_policy.rb +8 -5
- data/lib/rails_ai_context/introspectors/route_introspector.rb +153 -42
- data/lib/rails_ai_context/introspectors/schema_conventions.rb +127 -40
- data/lib/rails_ai_context/introspectors/schema_dump_path.rb +80 -0
- data/lib/rails_ai_context/introspectors/schema_introspector.rb +346 -112
- data/lib/rails_ai_context/introspectors/schema_reader.rb +69 -29
- data/lib/rails_ai_context/introspectors/service_classes.rb +21 -15
- data/lib/rails_ai_context/introspectors/source_calls.rb +1 -1
- data/lib/rails_ai_context/introspectors/source_introspector.rb +17 -2
- data/lib/rails_ai_context/introspectors/source_scan.rb +174 -26
- data/lib/rails_ai_context/introspectors/sqlite_virtual_tables.rb +28 -0
- data/lib/rails_ai_context/introspectors/stimulus_introspector.rb +16 -5
- data/lib/rails_ai_context/introspectors/structure_sql_reader.rb +372 -98
- data/lib/rails_ai_context/introspectors/superclass_chain.rb +14 -15
- data/lib/rails_ai_context/introspectors/table_name.rb +46 -45
- data/lib/rails_ai_context/introspectors/test_introspector.rb +289 -78
- data/lib/rails_ai_context/introspectors/turbo_introspector.rb +10 -5
- data/lib/rails_ai_context/introspectors/view_introspector.rb +5 -40
- data/lib/rails_ai_context/introspectors/view_template_introspector.rb +12 -10
- data/lib/rails_ai_context/method_name.rb +31 -0
- data/lib/rails_ai_context/migration_status.rb +5 -5
- data/lib/rails_ai_context/output_guard.rb +6 -4
- data/lib/rails_ai_context/package_json.rb +96 -5
- data/lib/rails_ai_context/path_resolver.rb +170 -15
- data/lib/rails_ai_context/payload.rb +48 -0
- data/lib/rails_ai_context/pending_migrations.rb +15 -18
- data/lib/rails_ai_context/portable_path.rb +76 -4
- data/lib/rails_ai_context/redaction.rb +8 -2
- data/lib/rails_ai_context/route_coverage.rb +5 -1
- data/lib/rails_ai_context/safe_file.rb +4 -1
- data/lib/rails_ai_context/safe_path.rb +61 -10
- data/lib/rails_ai_context/schema_hint.rb +8 -2
- data/lib/rails_ai_context/schema_version.rb +7 -9
- data/lib/rails_ai_context/serializers/claude_rules_serializer.rb +1 -1
- data/lib/rails_ai_context/serializers/markdown_serializer.rb +13 -4
- data/lib/rails_ai_context/serializers/section_facts.rb +5 -1
- data/lib/rails_ai_context/serializers/stack_overview_helper.rb +2 -2
- data/lib/rails_ai_context/serializers/tool_guide_helper.rb +7 -4
- data/lib/rails_ai_context/server.rb +26 -7
- data/lib/rails_ai_context/test_framework.rb +32 -5
- data/lib/rails_ai_context/tools/analyze_feature.rb +22 -10
- data/lib/rails_ai_context/tools/base_tool.rb +69 -30
- data/lib/rails_ai_context/tools/diagnose.rb +1 -1
- data/lib/rails_ai_context/tools/generate_test.rb +8 -9
- data/lib/rails_ai_context/tools/get_active_support.rb +19 -4
- data/lib/rails_ai_context/tools/get_api.rb +17 -11
- data/lib/rails_ai_context/tools/get_autoload.rb +10 -5
- data/lib/rails_ai_context/tools/get_callbacks.rb +65 -14
- data/lib/rails_ai_context/tools/get_component_catalog.rb +7 -4
- data/lib/rails_ai_context/tools/get_concern.rb +31 -18
- data/lib/rails_ai_context/tools/get_config.rb +52 -18
- data/lib/rails_ai_context/tools/get_controllers.rb +57 -13
- data/lib/rails_ai_context/tools/get_conventions.rb +44 -22
- data/lib/rails_ai_context/tools/get_engines.rb +2 -0
- data/lib/rails_ai_context/tools/get_env.rb +209 -52
- data/lib/rails_ai_context/tools/get_env_config.rb +38 -7
- data/lib/rails_ai_context/tools/get_frontend_stack.rb +56 -7
- data/lib/rails_ai_context/tools/get_helper_methods.rb +136 -26
- data/lib/rails_ai_context/tools/get_job_pattern.rb +143 -87
- data/lib/rails_ai_context/tools/get_mailers.rb +59 -2
- data/lib/rails_ai_context/tools/get_model_details.rb +178 -28
- data/lib/rails_ai_context/tools/get_partial_interface.rb +101 -62
- data/lib/rails_ai_context/tools/get_routes.rb +35 -9
- data/lib/rails_ai_context/tools/get_schema.rb +160 -61
- data/lib/rails_ai_context/tools/get_service_pattern.rb +121 -25
- data/lib/rails_ai_context/tools/get_stimulus.rb +1 -1
- data/lib/rails_ai_context/tools/get_test_info.rb +152 -82
- data/lib/rails_ai_context/tools/get_view.rb +37 -20
- data/lib/rails_ai_context/tools/migration_advisor.rb +64 -24
- data/lib/rails_ai_context/tools/onboard.rb +174 -88
- data/lib/rails_ai_context/tools/performance_check.rb +5 -13
- data/lib/rails_ai_context/tools/query.rb +122 -28
- data/lib/rails_ai_context/tools/read_logs.rb +45 -17
- data/lib/rails_ai_context/tools/runtime_info.rb +1 -1
- data/lib/rails_ai_context/tools/safe_call.rb +20 -15
- data/lib/rails_ai_context/tools/search_code.rb +114 -40
- data/lib/rails_ai_context/tools/search_docs.rb +22 -11
- data/lib/rails_ai_context/tools/security_scan.rb +51 -4
- data/lib/rails_ai_context/tools/validate.rb +21 -4
- data/lib/rails_ai_context/tools/validate_semantics.rb +18 -6
- data/lib/rails_ai_context/version.rb +1 -1
- data/lib/rails_ai_context/vfs.rb +2 -2
- data/lib/rails_ai_context/view_file.rb +53 -3
- data/lib/rails_ai_context.rb +10 -2
- data/server.json +1 -1
- 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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
65
|
-
|
|
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
|
|
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
|
|
12
|
-
class PreviewPathsListener <
|
|
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
|
|
35
|
-
#
|
|
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 ==
|
|
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:
|
|
30
|
-
name:
|
|
31
|
-
location:
|
|
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 =
|
|
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) &&
|
|
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
|