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
|
@@ -35,7 +35,7 @@ module RailsAiContext
|
|
|
35
35
|
unread_parent = nil
|
|
36
36
|
name = class_name
|
|
37
37
|
SuperclassChain::MAX_DEPTH.times do
|
|
38
|
-
declaration = source && DeclaredConstant.declarations(source).find { |d| d.name == name }
|
|
38
|
+
declaration = source && DeclaredConstant.declarations(source, path_name: name).find { |d| d.name == name }
|
|
39
39
|
# A file the walk cannot match to the class leaves the class unread.
|
|
40
40
|
break unread << name unless declaration
|
|
41
41
|
|
|
@@ -44,7 +44,7 @@ module RailsAiContext
|
|
|
44
44
|
parent = declaration.superclass
|
|
45
45
|
break if parent.nil? || BASES.include?(parent)
|
|
46
46
|
|
|
47
|
-
found = SuperclassChain.resolve_in_scope(name, parent) { |c| (src = lookup.call(c)) && [ c, src ] }
|
|
47
|
+
found = SuperclassChain.resolve_in_scope(name, parent, nesting: declaration.nesting) { |c| (src = lookup.call(c)) && [ c, src ] }
|
|
48
48
|
unless found
|
|
49
49
|
unread_parent = parent
|
|
50
50
|
break unread << parent
|
|
@@ -63,12 +63,13 @@ module RailsAiContext
|
|
|
63
63
|
lambda do |name|
|
|
64
64
|
file = controllers.is_a?(Hash) && controllers[name].is_a?(Hash) ? controllers[name][:file] : nil
|
|
65
65
|
path = file && File.expand_path(file, root)
|
|
66
|
-
(path &&
|
|
66
|
+
(path && PathResolver.project_file?(path, root) && SafeFile.read(path)) || by_path.call(name)
|
|
67
67
|
end
|
|
68
68
|
end
|
|
69
69
|
|
|
70
70
|
def template?(root, chain, action)
|
|
71
|
-
|
|
71
|
+
roots = [ root.to_s, *PathResolver.enclosing_engine_roots(root.to_s) ]
|
|
72
|
+
chain.prefixes.any? { |prefix| roots.any? { |dir| Dir.glob(File.join(dir, "app", "views", prefix, "#{action}.*")).any? } }
|
|
72
73
|
end
|
|
73
74
|
|
|
74
75
|
def read_class(source, name, defs, names)
|
|
@@ -83,8 +84,8 @@ module RailsAiContext
|
|
|
83
84
|
# the actions its class macros build with define_method, and an unread
|
|
84
85
|
# one only hides class methods.
|
|
85
86
|
def read_modules(source, owner, root, names, unread, depth)
|
|
86
|
-
mixins = ConcernMembership.
|
|
87
|
-
SourceIntrospector.walk_source(source, { mixins: Listeners::MixinsListener })[:mixins], owner
|
|
87
|
+
mixins = ConcernMembership.owned_by(
|
|
88
|
+
SourceIntrospector.walk_source(source, { mixins: Listeners::MixinsListener })[:mixins], owner, root: root
|
|
88
89
|
)
|
|
89
90
|
mixins.select { |m| m[:ancestor] || (m[:macro] == :extend && !m[:receiver]) }.uniq { |m| m[:name] }.each do |mixin|
|
|
90
91
|
mod = mixin[:name]
|
|
@@ -104,8 +105,10 @@ module RailsAiContext
|
|
|
104
105
|
end
|
|
105
106
|
|
|
106
107
|
def module_source(root, mod, owner)
|
|
107
|
-
|
|
108
|
-
|
|
108
|
+
source = ConcernPaths.module_source(root.to_s, mod, within: owner)
|
|
109
|
+
return source if source
|
|
110
|
+
|
|
111
|
+
path = SuperclassChain.resolve_in_scope(owner, mod) { |c| PathResolver.file_for_constant(root.to_s, c) }
|
|
109
112
|
path && SafeFile.read(path)
|
|
110
113
|
end
|
|
111
114
|
|
|
@@ -37,6 +37,8 @@ module RailsAiContext
|
|
|
37
37
|
# shift-assign, which does assign.
|
|
38
38
|
ASSIGNMENT = /(?<![=!<>~])=(?![=~])|(?<![<>])(?:<<|>>)=/
|
|
39
39
|
|
|
40
|
+
WALKED_METHODS = ObjectSpace::WeakMap.new
|
|
41
|
+
|
|
40
42
|
module_function
|
|
41
43
|
|
|
42
44
|
def framework?(klass, kind:)
|
|
@@ -115,30 +117,42 @@ module RailsAiContext
|
|
|
115
117
|
# its class methods, each as written (`full_name(sep = ' ')`). The owner
|
|
116
118
|
# defaults to the constant the file declares.
|
|
117
119
|
def public_methods_from_source(source, owner: nil, skip_underscored: true)
|
|
118
|
-
|
|
119
|
-
methods = methods.reject { |m| m[:name].start_with?("_") } if skip_underscored
|
|
120
|
-
methods.map { |m| signature(m) }.uniq
|
|
120
|
+
public_methods_in(source, owner: owner, skip_underscored: skip_underscored).map { |m| signature(m) }.uniq
|
|
121
121
|
end
|
|
122
122
|
|
|
123
123
|
def private_methods_from_source(source, owner: nil)
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
124
|
+
private_methods_in(source, owner: owner).map { |m| signature(m) }.uniq
|
|
125
|
+
end
|
|
126
|
+
|
|
127
|
+
# The walked methods behind those signatures, for a caller that prints each one's own body.
|
|
128
|
+
# `module_function:` also counts a module_function's instance copy, private to Ruby but callable from a view.
|
|
129
|
+
def public_methods_in(source, owner: nil, skip_underscored: true, module_function: false)
|
|
130
|
+
methods = own_methods_in(source, owner).select do |m|
|
|
131
|
+
m[:scope] == :instance && (m[:visibility] == :public || (module_function && m[:module_function]))
|
|
132
|
+
end
|
|
133
|
+
skip_underscored ? methods.reject { |m| m[:name].start_with?("_") } : methods
|
|
134
|
+
end
|
|
135
|
+
|
|
136
|
+
def private_methods_in(source, owner: nil)
|
|
137
|
+
own_methods_in(source, owner).select { |m| m[:scope] == :instance && m[:visibility] != :public }
|
|
127
138
|
end
|
|
128
139
|
|
|
129
140
|
# A bare `private` never reaches `def self.x`; it does reach a def
|
|
130
141
|
# inside `class_methods do` or `class << self`.
|
|
131
142
|
def class_methods_from_source(source, owner: nil)
|
|
132
143
|
own_methods_in(source, owner)
|
|
133
|
-
.select { |m| m[:scope] == :class &&
|
|
144
|
+
.select { |m| m[:scope] == :class && m[:visibility] == :public }
|
|
134
145
|
.map { |m| signature(m) }.uniq
|
|
135
146
|
end
|
|
136
147
|
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
148
|
+
ENTRY_POINTS = %w[perform execute].freeze
|
|
149
|
+
QUE_ENTRY_POINTS = %w[run].freeze
|
|
150
|
+
|
|
151
|
+
# `perform`, or `execute` where a base class owns perform and calls it; a Que job passes `run`.
|
|
152
|
+
# ponytail: those names only; another base's entry point reads as no signature.
|
|
153
|
+
def entry_point(methods, names: ENTRY_POINTS)
|
|
140
154
|
instance = methods.select { |m| m[:scope] == :instance }
|
|
141
|
-
|
|
155
|
+
names.lazy.filter_map { |name| instance.find { |m| m[:name] == name } }.first
|
|
142
156
|
end
|
|
143
157
|
|
|
144
158
|
# The method as written, minus a `self.` receiver: `build(attrs)`.
|
|
@@ -197,7 +211,8 @@ module RailsAiContext
|
|
|
197
211
|
end
|
|
198
212
|
|
|
199
213
|
def scanned_body(lines, method_name)
|
|
200
|
-
|
|
214
|
+
name_end = RailsAiContext::MethodName.definition_end(method_name)
|
|
215
|
+
start_idx = lines.index { |l| l.match?(/^\s*def\s+#{Regexp.escape(method_name.to_s)}#{name_end}/i) }
|
|
201
216
|
return nil unless start_idx
|
|
202
217
|
|
|
203
218
|
indent = lines[start_idx][/\A\s*/].length
|
|
@@ -241,8 +256,13 @@ module RailsAiContext
|
|
|
241
256
|
action_source.to_s.scan(/render\s+(?:json|xml):\s*@(\w+)/).flatten.uniq
|
|
242
257
|
end
|
|
243
258
|
|
|
259
|
+
# Keyed by the cached tree, so a tool asking one file for each of its
|
|
260
|
+
# callbacks walks it once.
|
|
244
261
|
def methods_in(source)
|
|
245
|
-
|
|
262
|
+
result = AstCache.parse_string(source.to_s)
|
|
263
|
+
(WALKED_METHODS[result.value] ||= Array(
|
|
264
|
+
SourceIntrospector.walk_dispatch(result, { methods: Listeners::MethodsListener })[:methods]
|
|
265
|
+
).each(&:freeze).freeze).dup
|
|
246
266
|
end
|
|
247
267
|
|
|
248
268
|
def own_methods_in(source, owner)
|
|
@@ -323,24 +343,16 @@ module RailsAiContext
|
|
|
323
343
|
found.uniq.sort
|
|
324
344
|
end
|
|
325
345
|
|
|
326
|
-
#
|
|
327
|
-
#
|
|
328
|
-
# listing under Settings::BaseController even when a top-level
|
|
329
|
-
# BaseController exists too. A qualified name the listing holds is taken as written, one
|
|
330
|
-
# it lacks resolves outward too, and a rooted or unresolved name comes back as written.
|
|
346
|
+
# A bare superclass resolves through Module.nesting: `module Settings; class ProfileController < BaseController`
|
|
347
|
+
# means Settings::BaseController where the listing holds it.
|
|
331
348
|
def resolve_entry_name(entries, name, within)
|
|
332
349
|
rooted = name.to_s.start_with?("::")
|
|
333
350
|
name = name&.to_s&.delete_prefix("::")
|
|
334
351
|
return name if name.nil? || within.nil? || rooted || (name.include?("::") && entries.key?(name))
|
|
335
352
|
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
return qualified if entries.key?(qualified)
|
|
340
|
-
|
|
341
|
-
scope.pop
|
|
342
|
-
end
|
|
343
|
-
name
|
|
353
|
+
info = entries[within]
|
|
354
|
+
nesting = info[:parent_nesting] if info.is_a?(Hash)
|
|
355
|
+
SuperclassChain.resolve_in_scope(within, name, nesting: nesting) { |qualified| qualified if entries.key?(qualified) } || name
|
|
344
356
|
end
|
|
345
357
|
|
|
346
358
|
# `action_methods` subtracts inherited methods only as far as the
|
|
@@ -36,9 +36,9 @@ module RailsAiContext
|
|
|
36
36
|
|
|
37
37
|
def extract_rich_text_fields
|
|
38
38
|
fields = []
|
|
39
|
-
|
|
39
|
+
model_classes.each do |model_name, record|
|
|
40
40
|
ast_data = SourceIntrospector.walk_source(record.source, { macros: Listeners::MacrosListener })
|
|
41
|
-
ast_data[:macros].each do |m|
|
|
41
|
+
ConcernMembership.owned_by(ast_data[:macros], model_name).each do |m|
|
|
42
42
|
next unless m[:macro] == :has_rich_text
|
|
43
43
|
fields << { model: model_name, field: m[:attribute] }
|
|
44
44
|
end
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module RailsAiContext
|
|
4
|
+
module Introspectors
|
|
5
|
+
# The table affixes, pluralize_table_names and schema_format the app's config and initializers
|
|
6
|
+
# set on Active Record. Read once per run, so a long-lived server sees the app's edits.
|
|
7
|
+
module ActiveRecordSettings
|
|
8
|
+
module_function
|
|
9
|
+
|
|
10
|
+
SETTINGS = { table_name_prefix: String, table_name_suffix: String, pluralize_table_names: [ true, false ], schema_format: %i[ruby sql] }.freeze
|
|
11
|
+
# Rails copies these from config.active_record onto the ActiveRecord module in an after_initialize hook, so the config wins.
|
|
12
|
+
MODULE_SETTINGS = %i[schema_format].freeze
|
|
13
|
+
# ActiveRecord::Base's class attributes, ActiveRecord's module ones, and self or the param in the base's load hook.
|
|
14
|
+
BASE_ROOTS = %w[ActiveRecord::Base ActiveRecord on_load(:active_record)].freeze
|
|
15
|
+
|
|
16
|
+
# {table_name_prefix: "op_", schema_format: :sql}
|
|
17
|
+
def for(root)
|
|
18
|
+
return {} unless root
|
|
19
|
+
|
|
20
|
+
root = File.expand_path(root.to_s)
|
|
21
|
+
RunCache.fetch([ :active_record_settings, root ]) { read(root) }
|
|
22
|
+
end
|
|
23
|
+
|
|
24
|
+
# Files in Rails' load order, the last assignment of each kind winning. A Base
|
|
25
|
+
# attribute set directly beats config, which the base's load hook copies first.
|
|
26
|
+
def read(root)
|
|
27
|
+
files = [ File.join(root, "config", "application.rb"), File.join(root, "config", "environments", "#{RailsAiContext.environment_name}.rb") ]
|
|
28
|
+
files = files.select { |path| File.file?(path) } + PathResolver.initializer_paths(root)
|
|
29
|
+
listeners = { config: -> { Listeners::ConfigAssignmentListener.new }, base: -> { Listeners::ConfigAssignmentListener.new(BASE_ROOTS) } }
|
|
30
|
+
configured = {}
|
|
31
|
+
direct = {}
|
|
32
|
+
files.each do |file|
|
|
33
|
+
walked = SourceIntrospector.walk(file, listeners)
|
|
34
|
+
collect(Array(walked[:config]).filter_map { |entry| [ entry, entry[:path].last ] if entry[:path].size == 2 && entry[:path].first == :active_record }, configured)
|
|
35
|
+
collect(Array(walked[:base]).filter_map { |entry| [ entry, entry[:path].first ] if entry[:path].size == 1 }, direct)
|
|
36
|
+
end
|
|
37
|
+
MODULE_SETTINGS.each { |name| direct.delete(name) if configured.key?(name) }
|
|
38
|
+
configured.merge(direct)
|
|
39
|
+
rescue StandardError, ScriptError => e
|
|
40
|
+
RailsAiContext.debug_fail(e, {}, label: "active_record_settings")
|
|
41
|
+
end
|
|
42
|
+
|
|
43
|
+
def collect(settings, found)
|
|
44
|
+
settings.sort_by { |entry, _| entry[:location] }.each do |entry, name|
|
|
45
|
+
allowed = SETTINGS[name]
|
|
46
|
+
next unless entry[:assignment] && allowed
|
|
47
|
+
|
|
48
|
+
value = entry[:value]
|
|
49
|
+
found[name] = value if allowed.is_a?(Array) ? allowed.include?(value) : value.is_a?(allowed)
|
|
50
|
+
end
|
|
51
|
+
end
|
|
52
|
+
|
|
53
|
+
private_class_method :read, :collect
|
|
54
|
+
end
|
|
55
|
+
end
|
|
56
|
+
end
|
|
@@ -28,7 +28,7 @@ module RailsAiContext
|
|
|
28
28
|
validations = []
|
|
29
29
|
variants = []
|
|
30
30
|
|
|
31
|
-
|
|
31
|
+
model_classes.each do |model_name, record|
|
|
32
32
|
ast = SourceIntrospector.walk_source(record.source, {
|
|
33
33
|
macros: Listeners::MacrosListener,
|
|
34
34
|
validations: Listeners::ValidationsListener,
|
|
@@ -15,6 +15,7 @@ module RailsAiContext
|
|
|
15
15
|
concerns: extract_concerns,
|
|
16
16
|
deprecators: extract_deprecators,
|
|
17
17
|
message_verifier_usage: extract_message_verifier_usage,
|
|
18
|
+
notification_subscriptions: scan_sources[:notification_subscriptions],
|
|
18
19
|
tagged_logging: detect_tagged_logging,
|
|
19
20
|
on_load_hooks: common_on_load_hooks,
|
|
20
21
|
cache_usage: detect_cache_usage
|
|
@@ -31,7 +32,8 @@ module RailsAiContext
|
|
|
31
32
|
concerns: extract_concerns,
|
|
32
33
|
deprecators: unavailable,
|
|
33
34
|
message_verifier_usage: extract_message_verifier_usage,
|
|
34
|
-
|
|
35
|
+
notification_subscriptions: scan_sources[:notification_subscriptions],
|
|
36
|
+
tagged_logging: detect_tagged_logging(static: true),
|
|
35
37
|
on_load_hooks: unavailable,
|
|
36
38
|
cache_usage: unavailable
|
|
37
39
|
}
|
|
@@ -65,7 +67,7 @@ module RailsAiContext
|
|
|
65
67
|
# An app/models/concerns directory holds classes too - every
|
|
66
68
|
# validator in some apps - and a class is not a concern, let
|
|
67
69
|
# alone a "plain module".
|
|
68
|
-
declarations = DeclaredConstant.declarations(content)
|
|
70
|
+
declarations = DeclaredConstant.declarations(content, path_name: mod_name)
|
|
69
71
|
declared = declarations.find { |d| d.name.split("::").last.casecmp?(mod_name.split("::").last) }
|
|
70
72
|
if declared
|
|
71
73
|
entry[:kind] = "class"
|
|
@@ -104,40 +106,114 @@ module RailsAiContext
|
|
|
104
106
|
RailsAiContext.debug_fail(e, [], label: "extract_deprecators")
|
|
105
107
|
end
|
|
106
108
|
|
|
107
|
-
# Scan `lib/` + `app/` for calls into ActiveSupport::MessageEncryptor and
|
|
108
|
-
# ActiveSupport::MessageVerifier. Used for tokens, signed IDs, etc.
|
|
109
109
|
def extract_message_verifier_usage
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
dir = File.join(root, rel)
|
|
113
|
-
next unless Dir.exist?(dir)
|
|
110
|
+
scan_sources[:message_verifier_usage]
|
|
111
|
+
end
|
|
114
112
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
113
|
+
SUBSCRIBE_CALLS = %w[subscribe monotonic_subscribe].freeze
|
|
114
|
+
# Prefilter: only the receivers subscriptions_from keeps, so a newsletter `subscribe` is not parsed.
|
|
115
|
+
SUBSCRIPTION_HINT = /Notifications\s*&?\.\s*(?:monotonic_)?subscribe\b|\battach_to\b/
|
|
116
|
+
VERIFIER_HINTS = %w[MessageEncryptor MessageVerifier message_verifier ActiveStorage.verifier].freeze
|
|
117
|
+
VERIFIER_CALLS = %w[message_verifier message_verifiers verifier].freeze
|
|
118
|
+
|
|
119
|
+
# One read of lib/, app/ and the initializers serves both lists; a file that
|
|
120
|
+
# mentions either is walked once, for both.
|
|
121
|
+
def scan_sources
|
|
122
|
+
@scan_sources ||= begin
|
|
123
|
+
verifier = []
|
|
124
|
+
subscriptions = []
|
|
125
|
+
source_paths.each do |path|
|
|
118
126
|
content = RailsAiContext::SafeFile.read(path) or next
|
|
119
|
-
# Mention of the class anywhere counts, so a text scan over 2000
|
|
120
|
-
# files beats parsing each one. Regex stays.
|
|
121
|
-
next unless content.match?(/MessageEncryptor|MessageVerifier/)
|
|
122
127
|
relative = path.sub("#{root}/", "")
|
|
123
|
-
|
|
128
|
+
verifies = VERIFIER_HINTS.any? { |hint| content.include?(hint) } && !relative.start_with?("config/")
|
|
129
|
+
subscribes = (content.include?("subscribe") || content.include?("attach_to")) && content.match?(SUBSCRIPTION_HINT)
|
|
130
|
+
next unless verifies || subscribes
|
|
131
|
+
|
|
132
|
+
walked = walk_usage(content, verifies: verifies, subscribes: subscribes)
|
|
133
|
+
usage = verifier_usage(walked)
|
|
134
|
+
verifier << { file: relative, **usage } if usage.values.any?
|
|
135
|
+
subscriptions.concat(subscriptions_from(walked, relative))
|
|
124
136
|
end
|
|
137
|
+
{ message_verifier_usage: verifier, notification_subscriptions: subscriptions.sort_by { |s| [ s[:file], s[:line], s[:event] ] } }
|
|
125
138
|
end
|
|
126
|
-
hits
|
|
127
|
-
rescue => e
|
|
128
|
-
RailsAiContext.debug_fail(e, [], label: "extract_message_verifier_usage")
|
|
129
139
|
end
|
|
130
140
|
|
|
131
|
-
|
|
141
|
+
# Sorted, since Dir.glob order is filesystem-dependent. No cap: the hint prefilter
|
|
142
|
+
# keeps a file nobody subscribes from to one read.
|
|
143
|
+
def source_paths
|
|
144
|
+
paths = %w[lib app].flat_map do |rel|
|
|
145
|
+
dir = File.join(root, rel)
|
|
146
|
+
Dir.exist?(dir) ? Dir.glob(File.join(dir, "**/*.rb")).sort : []
|
|
147
|
+
end
|
|
148
|
+
paths + PathResolver.initializer_paths(root)
|
|
149
|
+
end
|
|
150
|
+
|
|
151
|
+
def walk_usage(content, verifies:, subscribes:)
|
|
152
|
+
listeners = {}
|
|
153
|
+
if verifies
|
|
154
|
+
listeners[:constants] = -> { Listeners::ConstantReferenceListener.new(names: %w[MessageVerifier MessageEncryptor]) }
|
|
155
|
+
listeners[:verifier_calls] = -> { Listeners::MethodCallListener.new(names: VERIFIER_CALLS) }
|
|
156
|
+
end
|
|
157
|
+
if subscribes
|
|
158
|
+
listeners[:calls] = -> { Listeners::MethodCallListener.new(names: SUBSCRIBE_CALLS + %w[attach_to]) }
|
|
159
|
+
listeners[:methods] = Listeners::MethodsListener
|
|
160
|
+
end
|
|
161
|
+
SourceIntrospector.walk_source(content, listeners)
|
|
162
|
+
end
|
|
163
|
+
|
|
164
|
+
# The class itself, Rails.application.message_verifier(s) or ActiveStorage.verifier.
|
|
165
|
+
def verifier_usage(walked)
|
|
166
|
+
constants = Array(walked[:constants]).map { |ref| ref[:name] }
|
|
167
|
+
calls = Array(walked[:verifier_calls]).select do |call|
|
|
168
|
+
call[:name] != "verifier" || call[:receiver].to_s.match?(/(\A|::)ActiveStorage\z/)
|
|
169
|
+
end
|
|
170
|
+
{ encryptor: constants.include?("MessageEncryptor"), verifier: constants.include?("MessageVerifier") || calls.any? }
|
|
171
|
+
end
|
|
172
|
+
|
|
173
|
+
# A Subscriber's attach_to listens for "<public method>.<namespace>", one event per method.
|
|
174
|
+
def subscriptions_from(walked, relative)
|
|
175
|
+
Array(walked[:calls]).flat_map do |call|
|
|
176
|
+
if call[:name] == "attach_to"
|
|
177
|
+
attach_to_events(call, walked[:methods], relative)
|
|
178
|
+
elsif call[:receiver].to_s.match?(/(\A|::)Notifications\z/)
|
|
179
|
+
pattern = call[:arguments].first
|
|
180
|
+
event = pattern.nil? ? "every event" : pattern.to_s
|
|
181
|
+
[ { event: event, via: call[:name], file: relative, line: call[:line] } ]
|
|
182
|
+
else
|
|
183
|
+
[]
|
|
184
|
+
end
|
|
185
|
+
end
|
|
186
|
+
end
|
|
187
|
+
|
|
188
|
+
def attach_to_events(call, methods, relative)
|
|
189
|
+
namespace = call[:arguments].first
|
|
190
|
+
return [] unless namespace.is_a?(Symbol) || namespace.is_a?(String)
|
|
191
|
+
|
|
192
|
+
receiver = call[:receiver]&.to_s
|
|
193
|
+
bare = receiver.nil? || receiver == "self"
|
|
194
|
+
owner = bare ? call[:owner].join("::").presence : receiver
|
|
195
|
+
short = owner.to_s.split("::").last
|
|
196
|
+
names = Array(methods).select do |m|
|
|
197
|
+
m[:scope] == :instance && m[:visibility] == :public &&
|
|
198
|
+
(bare ? m[:owner] == call[:owner] : m[:owner]&.last.to_s.split("::").last == short)
|
|
199
|
+
end.map { |m| m[:name] }
|
|
200
|
+
via = [ owner, "attach_to" ].compact.join(".")
|
|
201
|
+
events = names.empty? ? [ "every public method of #{owner || "the subscriber"}, as <method>.#{namespace}" ] : names.map { |name| "#{name}.#{namespace}" }
|
|
202
|
+
events.map { |event| { event: event, via: via, file: relative, line: call[:line] } }
|
|
203
|
+
end
|
|
204
|
+
|
|
205
|
+
# config.log_tags is evaluated at boot, so a static run reads only the initializer.
|
|
206
|
+
def detect_tagged_logging(static: false)
|
|
132
207
|
result = { configured: false }
|
|
133
|
-
|
|
134
|
-
|
|
208
|
+
if static
|
|
209
|
+
result[:tags] = { unavailable: StaticTier.unavailable_reason }
|
|
210
|
+
elsif (config_logger = app.config.log_tags).is_a?(Array) && config_logger.any?
|
|
135
211
|
result[:configured] = true
|
|
136
212
|
result[:tags] = config_logger.map(&:to_s)
|
|
137
213
|
end
|
|
138
214
|
|
|
139
215
|
# Initializer pattern: Rails.logger = ActiveSupport::TaggedLogging.new(…)
|
|
140
|
-
|
|
216
|
+
PathResolver.initializer_paths(root).each do |path|
|
|
141
217
|
content = RailsAiContext::SafeFile.read(path) or next
|
|
142
218
|
if content.include?("ActiveSupport::TaggedLogging")
|
|
143
219
|
result[:configured] = true
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module RailsAiContext
|
|
4
|
+
module Introspectors
|
|
5
|
+
# The models an admin gem exposes, read from the folder each gem's
|
|
6
|
+
# generator writes to: ActiveAdmin and Trestle in app/admin, Administrate
|
|
7
|
+
# in app/dashboards, Avo in app/avo/resources, Madmin in
|
|
8
|
+
# app/madmin/resources. Read from source, so both tiers answer the same.
|
|
9
|
+
module AdminResources
|
|
10
|
+
DIRS = %w[app/admin app/dashboards app/avo/resources app/madmin/resources].freeze
|
|
11
|
+
CALLS = %i[register resource permit_params model_class=].freeze
|
|
12
|
+
|
|
13
|
+
module_function
|
|
14
|
+
|
|
15
|
+
# @return [Array<Hash>] framework, model, file (app-relative) and, for ActiveAdmin, params
|
|
16
|
+
def call(root)
|
|
17
|
+
root = root.to_s
|
|
18
|
+
DIRS.flat_map do |dir|
|
|
19
|
+
FileWalk.each_file(File.join(root, dir)).select { |path| path.end_with?(".rb") }.sort.flat_map do |path|
|
|
20
|
+
relative = path.delete_prefix("#{root}/")
|
|
21
|
+
source, = SafePath.read(relative, under: root)
|
|
22
|
+
source ? resources(dir, relative, source) : []
|
|
23
|
+
end
|
|
24
|
+
end
|
|
25
|
+
end
|
|
26
|
+
|
|
27
|
+
def line(resource)
|
|
28
|
+
permits = " - permits #{resource[:params].join(', ')}" if resource[:params].any?
|
|
29
|
+
"#{resource[:framework]} `#{resource[:model]}` (`#{resource[:file]}`)#{permits}"
|
|
30
|
+
end
|
|
31
|
+
|
|
32
|
+
def resources(dir, file, source)
|
|
33
|
+
walked = SourceIntrospector.walk_source(
|
|
34
|
+
source, { calls: -> { Listeners::MethodCallListener.new(names: CALLS) },
|
|
35
|
+
classes: Listeners::ClassDefinitionListener }
|
|
36
|
+
)
|
|
37
|
+
calls = Array(walked[:calls])
|
|
38
|
+
classes = Array(walked[:classes])
|
|
39
|
+
|
|
40
|
+
found = case dir
|
|
41
|
+
when "app/admin" then registered(calls) + trestle(calls)
|
|
42
|
+
when "app/dashboards" then named(classes, "Dashboard").map { |model| [ "Administrate", model, [] ] }
|
|
43
|
+
when "app/madmin/resources" then named(classes, "Resource").map { |model| [ "Madmin", model, [] ] }
|
|
44
|
+
else avo(classes, calls)
|
|
45
|
+
end
|
|
46
|
+
found.map { |framework, model, params| { framework: framework, model: model, file: file, params: params } }
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
# `ActiveAdmin.register User do`, each with the permit_params that
|
|
50
|
+
# follow it before the next register.
|
|
51
|
+
def registered(calls)
|
|
52
|
+
registers = calls.select { |c| c[:name] == "register" && c[:receiver] == "ActiveAdmin" && c[:arguments].first.is_a?(String) }
|
|
53
|
+
registers.each_with_index.map do |register, index|
|
|
54
|
+
stop = registers[index + 1]&.dig(:offset) || Float::INFINITY
|
|
55
|
+
params = calls.select { |c| c[:name] == "permit_params" && c[:offset] > register[:offset] && c[:offset] < stop }
|
|
56
|
+
.flat_map { |c| c[:arguments].select { |arg| arg.is_a?(Symbol) }.map(&:to_s) + permitted_keywords(c[:options]) }
|
|
57
|
+
[ "ActiveAdmin", register[:arguments].first, params ]
|
|
58
|
+
end
|
|
59
|
+
end
|
|
60
|
+
|
|
61
|
+
# permit_params forwards to params.permit: `tags: []` is an array, `meta: [:a, :b]` nested keys.
|
|
62
|
+
def permitted_keywords(options)
|
|
63
|
+
Array(options).filter_map do |key, value|
|
|
64
|
+
next unless key.is_a?(Symbol)
|
|
65
|
+
|
|
66
|
+
inner = case value
|
|
67
|
+
when Array then value.empty? ? "array" : value.map { |v| v.is_a?(Hash) ? v.keys.join(", ") : v.to_s }.join(", ")
|
|
68
|
+
when Hash then value.empty? ? "hash" : value.keys.join(", ")
|
|
69
|
+
end
|
|
70
|
+
inner ? "#{key} (#{inner})" : key.to_s
|
|
71
|
+
end
|
|
72
|
+
end
|
|
73
|
+
|
|
74
|
+
# `Trestle.resource(:people, model: Person)`; without model:, the name.
|
|
75
|
+
def trestle(calls)
|
|
76
|
+
calls.select { |c| c[:name] == "resource" && c[:receiver] == "Trestle" && c[:arguments].first.is_a?(Symbol) }.map do |call|
|
|
77
|
+
model = call[:options][:model]
|
|
78
|
+
[ "Trestle", model.is_a?(String) ? model.delete_prefix("::") : call[:arguments].first.to_s.classify, [] ]
|
|
79
|
+
end
|
|
80
|
+
end
|
|
81
|
+
|
|
82
|
+
def named(classes, suffix)
|
|
83
|
+
classes.map { |c| c[:name] }.select { |name| name.end_with?(suffix) && name != suffix }.map { |name| name.delete_suffix(suffix) }
|
|
84
|
+
end
|
|
85
|
+
|
|
86
|
+
# `self.model_class = ::Account` names the model; otherwise the resource's
|
|
87
|
+
# own name, less the Resource suffix Avo 2 (top-level UserResource) drops.
|
|
88
|
+
def avo(classes, calls)
|
|
89
|
+
resource = classes.first or return []
|
|
90
|
+
override = calls.find { |c| c[:name] == "model_class=" }&.dig(:arguments)&.first
|
|
91
|
+
name = resource[:name]
|
|
92
|
+
model = if override.is_a?(String) then override.delete_prefix("::")
|
|
93
|
+
elsif name.start_with?("Avo::Resources::") then name.demodulize
|
|
94
|
+
else name.demodulize.delete_suffix("Resource")
|
|
95
|
+
end
|
|
96
|
+
model.empty? ? [] : [ [ "Avo", model, [] ] ]
|
|
97
|
+
end
|
|
98
|
+
private_class_method :resources, :registered, :permitted_keywords, :trestle, :named, :avo
|
|
99
|
+
end
|
|
100
|
+
end
|
|
101
|
+
end
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module RailsAiContext
|
|
4
|
+
module Introspectors
|
|
5
|
+
# Each Anyway::Config class under config/configs and app/configs, with its
|
|
6
|
+
# attributes and the env names anyway_config reads them from.
|
|
7
|
+
module AnywayConfigs
|
|
8
|
+
DIRS = %w[config/configs app/configs].freeze
|
|
9
|
+
BASES = %w[Anyway::Config ApplicationConfig].freeze
|
|
10
|
+
MACROS = %i[attr_config required config_name env_prefix].freeze
|
|
11
|
+
|
|
12
|
+
module_function
|
|
13
|
+
|
|
14
|
+
# @return [Array<Hash>] { name:, file:, attributes: [{ name:, env:, required: }] }
|
|
15
|
+
def scan(root)
|
|
16
|
+
root = root.to_s
|
|
17
|
+
DIRS.flat_map { |dir| Dir.glob(File.join(root, dir, "**", "*.rb")).sort }.flat_map do |path|
|
|
18
|
+
file = path.delete_prefix("#{root}/")
|
|
19
|
+
source = SafePath.read(file, under: root).first
|
|
20
|
+
source ? classes(source, file) : []
|
|
21
|
+
end
|
|
22
|
+
end
|
|
23
|
+
|
|
24
|
+
def classes(source, file)
|
|
25
|
+
all = DeclaredConstant.declarations(source, path_name: File.basename(file, ".rb").camelize)
|
|
26
|
+
declared = all.select { |d| BASES.include?(d.superclass.to_s.delete_prefix("::")) }
|
|
27
|
+
return [] if declared.empty?
|
|
28
|
+
|
|
29
|
+
parsed = AstCache.parse_string(source)
|
|
30
|
+
calls = SourceIntrospector.walk_dispatch(parsed, { calls: -> { Listeners::GenericMacroListener.new(*MACROS) } })[:calls]
|
|
31
|
+
bodies = all.flat_map do |d|
|
|
32
|
+
DeclaredConstant.class_bodies(parsed.value, d.name).map { |body| [ d.name, body.location.start_offset...body.location.end_offset ] }
|
|
33
|
+
end
|
|
34
|
+
owned = calls.group_by { |call| innermost(bodies, call[:offset]) }
|
|
35
|
+
|
|
36
|
+
declared.filter_map { |d| config(d.name, file, Array(owned[d.name])) }
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
# A call belongs to the innermost class body around it, so a nested class keeps its own macros.
|
|
40
|
+
def innermost(bodies, offset)
|
|
41
|
+
bodies.select { |_, range| range.cover?(offset) }.min_by { |_, range| range.size }&.first
|
|
42
|
+
end
|
|
43
|
+
|
|
44
|
+
def config(name, file, calls)
|
|
45
|
+
by_macro = calls.group_by { |c| c[:macro] }
|
|
46
|
+
names = Array(by_macro[:attr_config]).flat_map { |c| c[:args].map(&:to_s) + c[:options].keys.map(&:to_s) }.uniq
|
|
47
|
+
return nil if names.empty?
|
|
48
|
+
|
|
49
|
+
required = Array(by_macro[:required]).flat_map { |c| c[:args].map(&:to_s) }
|
|
50
|
+
prefix = env_prefix(name, by_macro)
|
|
51
|
+
{ name: name, file: file, attributes: names.map { |n| { name: n, env: ("#{prefix}_#{n.upcase}" if prefix), required: required.include?(n) } } }
|
|
52
|
+
end
|
|
53
|
+
|
|
54
|
+
# anyway_config reads "#{env_prefix}_#{ATTR}"; the prefix defaults to the class name before `Config` (PAYMENT_*).
|
|
55
|
+
def env_prefix(class_name, by_macro)
|
|
56
|
+
explicit = Array(by_macro[:env_prefix]).last&.dig(:args, 0) || Array(by_macro[:config_name]).last&.dig(:args, 0)
|
|
57
|
+
return explicit.to_s.upcase if explicit
|
|
58
|
+
|
|
59
|
+
class_name[/\A(\w+)(?:::)?Config\z/, 1]&.upcase
|
|
60
|
+
end
|
|
61
|
+
private_class_method :classes, :innermost, :config, :env_prefix
|
|
62
|
+
end
|
|
63
|
+
end
|
|
64
|
+
end
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module RailsAiContext
|
|
4
|
+
module Introspectors
|
|
5
|
+
# The models an Apartment initializer keeps in the shared schema. Every
|
|
6
|
+
# other ActiveRecord model gets one table per tenant schema.
|
|
7
|
+
module ApartmentConfig
|
|
8
|
+
module_function
|
|
9
|
+
|
|
10
|
+
# @return [Hash, nil] { excluded_models: [names], file: } or, for a list the
|
|
11
|
+
# file computes, { excluded_models_source: text, file: }; nil without Apartment.configure
|
|
12
|
+
def read(root)
|
|
13
|
+
PathResolver.initializer_paths(root).each do |path|
|
|
14
|
+
source = SafeFile.read(path, max_size: RailsAiContext.configuration.max_file_size)
|
|
15
|
+
next unless source&.include?("Apartment.configure")
|
|
16
|
+
tree = AstCache.parse_string(source)
|
|
17
|
+
# A partial tree would read a cut-off list as no list.
|
|
18
|
+
next if tree.errors.any?
|
|
19
|
+
|
|
20
|
+
file = path.delete_prefix("#{root}/")
|
|
21
|
+
listener = -> { Listeners::ConfigAssignmentListener.new("Apartment.configure") }
|
|
22
|
+
# `+=`, `<<` or `concat` builds on a list the source does not show whole.
|
|
23
|
+
hit = SourceIntrospector.walk_dispatch(tree, { config: listener })[:config].reverse.find { |h| list_write?(h) }
|
|
24
|
+
return { excluded_models: [], file: file } unless hit
|
|
25
|
+
return { excluded_models_source: hit[:source], file: file } unless hit[:assignment] && literal_names?(hit[:value])
|
|
26
|
+
|
|
27
|
+
return { excluded_models: hit[:value].map { |name| name.delete_prefix("::") }, file: file }
|
|
28
|
+
end
|
|
29
|
+
nil
|
|
30
|
+
rescue StandardError => e
|
|
31
|
+
RailsAiContext.debug_fail(e, nil, label: "ApartmentConfig")
|
|
32
|
+
end
|
|
33
|
+
|
|
34
|
+
# A block on a read (`.each { }`) leaves the list as it was.
|
|
35
|
+
def list_write?(hit)
|
|
36
|
+
return hit[:path].size == 2 && hit[:path].first == :excluded_models if hit[:write] == :call
|
|
37
|
+
return false if hit[:write] == :block
|
|
38
|
+
|
|
39
|
+
hit[:path] == [ :excluded_models ] && (hit[:assignment] || hit[:write] == :operator)
|
|
40
|
+
end
|
|
41
|
+
|
|
42
|
+
def literal_names?(value)
|
|
43
|
+
value.is_a?(Array) && value.all?(String) && !value.include?(Confidence::INFERRED)
|
|
44
|
+
end
|
|
45
|
+
end
|
|
46
|
+
end
|
|
47
|
+
end
|