rails-ai-bridge 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70c4f4fa10f3ab710b0fc739366e9b68f30c309ad18759c8f7d0e25f5c5ba9c1
-  data.tar.gz: 6efeb017419fd80d4c4ea28631640067f46823b29f9e42a7a92fddb95dfcb2f9
+  metadata.gz: 40f60ba64b6bd873a3cd1ebd9935e0c1b8250b9a8311135201bac1b66611f533
+  data.tar.gz: '08046f7af401786ad68cb95daaad9647eb2fec306b2dfb0a4b89987ccf8d081f'
 SHA512:
-  metadata.gz: 30f13fd84f004af9056801f31444b657f57278628b49ce2fb9ee4e77a1ba2845dbc91f3e1f2092c42205f321d328f4b07a92a645d22e3095098a3a02be40975a
-  data.tar.gz: b8ca2fde28e9c545c8cd38359e56382d17dd0d942164d3ce3c26bb52cef3a575e34abc32e7f04321888898b40c44b21dc6cb2f962a62f54d51f8255928ff808c
+  metadata.gz: 4ecb06105c4587df9114b465c8db3c88b462182b6462e1f07f841e92093693edeb52720b1fce378191323e38054412fa7637cc6198b91b371911396ebbf2f967
+  data.tar.gz: 65ac9a5d50ccf9f89535eaab7e229c90b685f35ef35a85b5edc4afb23047ac22f6ce1bc90398a4c682f99d19611a6678ba24935fccdffdb27af0c49c63265b49

data/.reek.yml

@@ -19,6 +19,12 @@ detectors:
     - RailsAiBridge::Config::Introspection#search_code_allowed_file_types
     - RailsAiBridge::Config::Introspection#search_code_pattern_max_bytes
     - RailsAiBridge::Config::Introspection#search_code_timeout_seconds
+    - RailsAiBridge::Config::Introspection#snapshot_ttl
+    - RailsAiBridge::Config::Introspection#cache_warm_on_boot
+    - RailsAiBridge::Config::Introspection#parallel_introspection
+    - RailsAiBridge::Config::Introspection#parallel_pool_size
+    - RailsAiBridge::Config::Introspection#parallel_timeout_seconds
+    - RailsAiBridge::Fingerprinter::CachedSnapshot#snapshot_ttl
     - RailsAiBridge::Config::Mcp#authorize
     - RailsAiBridge::Config::Mcp#http_log_json
     - RailsAiBridge::Config::Mcp#mode
@@ -47,6 +53,8 @@ detectors:
     - RailsAiBridge::Config::Rubydex#rubydex_index_path
     - RailsAiBridge::Config::Rubydex#semantic_context_depth
     - RailsAiBridge::Config::Rubydex#semantic_introspector_enabled
+    - RailsAiBridge::Config::Rubydex#rubydex_incremental_threshold
+    - RailsAiBridge::Config::Rubydex#rubydex_persist_index
     - RailsAiBridge#configuration
   BooleanParameter:
     exclude:
@@ -60,6 +68,7 @@ detectors:
     exclude:
     - RailsAiBridge::ContextProvider#rebuild
     - RailsAiBridge::Doctor::Checkers::BaseChecker#check
+    - RailsAiBridge::RubydexAdapter#apply_failure_state
     - RailsAiBridge::Doctor#initialize
     - RailsAiBridge::Introspectors::MiddlewareIntrospector#categorize_middleware
     - RailsAiBridge::Mcp::HttpRateLimiter#initialize
@@ -72,10 +81,12 @@ detectors:
     - RailsAiBridge::Watcher#initialize
     - RailsAiBridge::RubydexAdapter#declaration_to_hash
     - RailsAiBridge::Services::FileManagementService#validate_path!
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#build
   DataClump:
     exclude:
     - RailsAiBridge::Serializers::RegenerationFooter
     - RailsAiBridge::Introspectors::SemanticIntrospector
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer
   DuplicateMethodCall:
     exclude:
     - RailsAiBridge::Config::Introspection#excluded_table?
@@ -90,11 +101,13 @@ detectors:
     - RailsAiBridge::HttpTransportApp#build
     - RailsAiBridge::Introspector#app_name
     - RailsAiBridge::Introspector#call
+    - RailsAiBridge::Introspector::ParallelRunner#resolve_future
+    - RailsAiBridge::Introspector::TimedRunner#self.call
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#reindex
     - RailsAiBridge::Introspectors::ActiveStorageIntrospector#extract_attachments
     - RailsAiBridge::Introspectors::ControllerIntrospector#call
     - RailsAiBridge::Introspectors::ControllerIntrospector#discover_controllers
     - RailsAiBridge::Introspectors::ControllerIntrospector#eager_load_controllers!
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_filters
     - RailsAiBridge::Introspectors::ConventionDetector#detect_architecture
     - RailsAiBridge::Introspectors::DatabaseStatsIntrospector#call
     - RailsAiBridge::Introspectors::EngineIntrospector#discover_mounted_engines
@@ -110,11 +123,7 @@ detectors:
     - RailsAiBridge::Introspectors::ModelIntrospector#call
     - RailsAiBridge::Introspectors::ModelIntrospector#discover_models
     - RailsAiBridge::Introspectors::ModelIntrospector#eager_load_models!
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_associations
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_callbacks
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_source_macros
     - RailsAiBridge::Introspectors::ModelSemanticEnrichment#extract_semantic_summary
-    - RailsAiBridge::Introspectors::ModelSemanticEnrichment#find_similar_models
     - RailsAiBridge::Introspectors::MultiDatabaseIntrospector#detect_model_connections
     - RailsAiBridge::Introspectors::MultiDatabaseIntrospector#discover_databases
     - RailsAiBridge::Introspectors::NonArModelsIntrospector#collect_safe_object_space_entries
@@ -122,7 +131,6 @@ detectors:
     - RailsAiBridge::Introspectors::NonArModelsIntrospector#eager_load_app_models_dir
     - RailsAiBridge::Introspectors::NonArModelsIntrospector#safe_to_process?
     - RailsAiBridge::Introspectors::RakeTaskIntrospector#parse_rake_file
-    - RailsAiBridge::Introspectors::RouteIntrospector#detect_api_namespaces
     - RailsAiBridge::Introspectors::RouteIntrospector#detect_mounted_engines
     - RailsAiBridge::Introspectors::RouteIntrospector#extract_routes
     - RailsAiBridge::Introspectors::SemanticIntrospector#detect_code_patterns
@@ -239,7 +247,6 @@ detectors:
     - RailsAiBridge::Introspectors::ConfigIntrospector#detect_cache_store
     - RailsAiBridge::Introspectors::ConfigIntrospector#extract_credentials_keys
     - RailsAiBridge::Introspectors::ConfigIntrospector#extract_middleware
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_filters
     - RailsAiBridge::Introspectors::ConventionDetector#detect_patterns
     - RailsAiBridge::Introspectors::ConventionDetector#scan_directory_structure
     - RailsAiBridge::Introspectors::DevOpsIntrospector#extract_docker_info
@@ -251,7 +258,6 @@ detectors:
     - RailsAiBridge::Introspectors::MiddlewareIntrospector#discover_custom_middleware
     - RailsAiBridge::Introspectors::MigrationIntrospector#pending_migrations
     - RailsAiBridge::Introspectors::ModelIntrospector#discover_models
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_source_macros
     - RailsAiBridge::Introspectors::ModelIntrospector#extract_validations
     - RailsAiBridge::Introspectors::ModelIntrospector#model_table_excluded?
     - RailsAiBridge::Introspectors::ModelSemanticEnrichment#find_similar_models
@@ -272,6 +278,8 @@ detectors:
     - RailsAiBridge::Introspectors::ViewIntrospector#detect_template_engines
     - RailsAiBridge::RubydexAdapter#constant_references
     - RailsAiBridge::RubydexAdapter#count_methods
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#find_modified_files
+    - RailsAiBridge::RubydexAdapter#indexer_options
     - RailsAiBridge::RubydexAdapter#declaration_to_hash
     - RailsAiBridge::RubydexAdapter#definition_to_hash
     - RailsAiBridge::RubydexAdapter#format_location
@@ -334,6 +342,7 @@ detectors:
     - RailsAiBridge::Tools::GetView::FullFormatter
     - RailsAiBridge::Tools::GetView::StandardFormatter
     - RailsAiBridge::Tools::GetView::SummaryFormatter
+    - RailsAiBridge::Fingerprinter::CachedSnapshot
   IrresponsibleModule:
     exclude:
     - RailsAiBridge::Generators::InstallGenerator
@@ -349,6 +358,7 @@ detectors:
     - RailsAiBridge::Doctor::Checkers::BaseChecker#check
     - RailsAiBridge::Doctor::Checkers::BaseChecker#new_check
     - RailsAiBridge::Mcp::HttpStructuredLog#emit
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#initialize
     - RailsAiBridge::Serializers::ContextFileSerializer#generate_split_rules
     - RailsAiBridge::Serializers::ProviderDocumentHeader#call
     - RailsAiBridge::Tools::GetRoutes#self.call
@@ -363,12 +373,13 @@ detectors:
     - RailsAiBridge::Tools::SearchCode#self.process_file_for_search
     - RailsAiBridge::Tools::SearchCode#self.search_with_ripgrep
     - RailsAiBridge::Tools::SearchCode#self.search_with_ruby
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#call
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#build
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#reindex
   ManualDispatch:
     exclude:
     - RailsAiBridge::Introspector#app_name
     - RailsAiBridge::Introspectors::ConfigIntrospector#extract_credentials_keys
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_action_condition
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_filters
     - RailsAiBridge::Introspectors::MigrationIntrospector#pending_migrations
     - RailsAiBridge::Introspectors::ModelIntrospector#extract_enums
     - RailsAiBridge::Introspectors::MultiDatabaseIntrospector#discover_databases
@@ -385,7 +396,14 @@ detectors:
     - RailsAiBridge::RubydexAdapter#descendants
     - RailsAiBridge::RubydexAdapter#format_location
     - RailsAiBridge::RubydexAdapter#safe_count
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#patch_graph
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#re_index_file
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#remove_from_graph
     - RailsAiBridge::Services::FileManagementService#default_allowed_base_dir
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#apply_incremental_changes
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#reindex_file
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#remove_file
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#log_error
   MissingSafeMethod:
     exclude:
     - RailsAiBridge::AssistantFormatsPreference
@@ -397,6 +415,7 @@ detectors:
     - RailsAiBridge::Services::FileManagementService
     - RailsAiBridge::Tools::BaseTool
     - RailsAiBridge::Watcher::BridgeRegenerator
+    - RailsAiBridge::Fingerprinter::CachedSnapshot
   NestedIterators:
     exclude:
     - RailsAiBridge::Fingerprinter#snapshot
@@ -405,15 +424,11 @@ detectors:
     - RailsAiBridge::Introspectors::ActionTextIntrospector#extract_rich_text_fields
     - RailsAiBridge::Introspectors::ActiveStorageIntrospector#detect_direct_upload
     - RailsAiBridge::Introspectors::ActiveStorageIntrospector#extract_attachments
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_filters
     - RailsAiBridge::Introspectors::DevOpsIntrospector#extract_procfile
     - RailsAiBridge::Introspectors::EngineIntrospector#discover_mounted_engines
     - RailsAiBridge::Introspectors::GemIntrospector#categorize_gems
     - RailsAiBridge::Introspectors::JobIntrospector#extract_channels
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_callbacks
-    - RailsAiBridge::Introspectors::ModelSemanticEnrichment#find_similar_models
     - RailsAiBridge::Introspectors::MultiDatabaseIntrospector#detect_model_connections
-    - RailsAiBridge::Introspectors::RouteIntrospector#group_by_controller
     - RailsAiBridge::Introspectors::SeedsIntrospector#detect_seeded_models
     - RailsAiBridge::Introspectors::TestIntrospector#detect_test_helpers
     - RailsAiBridge::Introspectors::TurboIntrospector#extract_turbo_frames
@@ -446,6 +461,7 @@ detectors:
     exclude:
     - RailsAiBridge::AssistantFormatsPreference#formats_for_default_bridge_task
     - RailsAiBridge::Config::Introspection#excluded_table?
+    - RailsAiBridge::RubydexAdapter#sanitize_index_path
     - RailsAiBridge::Config::Mcp#effective_http_rate_limit_max_requests
     - RailsAiBridge::Generators::InstallGenerator#profile_from_option
     - RailsAiBridge::Introspectors::ControllerIntrospector#discover_controllers
@@ -485,10 +501,12 @@ detectors:
     - RailsAiBridge::Config::Introspection
     - RailsAiBridge::Config::Mcp
     - RailsAiBridge::Config::Output
+    - RailsAiBridge::Config::Rubydex
     - RailsAiBridge::Config::Server
     - RailsAiBridge::Configuration
     - RailsAiBridge::Mcp::HttpRateLimiter
     - RailsAiBridge::RubydexAdapter
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer
     - RailsAiBridge::Tools::GetModelDetails::ResponseFormatter
     - RailsAiBridge::Tools::GetRoutes::ResponseFormatter
     - RailsAiBridge::Tools::GetSchema::ResponseFormatter
@@ -497,6 +515,7 @@ detectors:
     - RailsAiBridge::Generators::InstallGenerator
     - RailsAiBridge::Introspectors::ModelIntrospector
     - RailsAiBridge::RubydexAdapter
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer
     - RailsAiBridge::Serializers::Providers::BaseProviderSerializer
   TooManyConstants:
     exclude:
@@ -507,6 +526,9 @@ detectors:
     - RailsAiBridge#validate_auto_mount_configuration!
     - RailsAiBridge::AssistantFormatsPreference#formats_for_default_bridge_task
     - RailsAiBridge::AssistantFormatsPreference#write!
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#call
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#patch_graph
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#run_reindex
     - RailsAiBridge::Config::Mcp#effective_http_rate_limit_max_requests
     - RailsAiBridge::ContextProvider#fetch
     - RailsAiBridge::ContextProvider#fetch_section
@@ -520,6 +542,10 @@ detectors:
     - RailsAiBridge::Generators::InstallGenerator#show_instructions
     - RailsAiBridge::HttpTransportApp#build
     - RailsAiBridge::Introspector#call
+    - RailsAiBridge::Introspector#run_single
+    - RailsAiBridge::Introspector::ParallelRunner#call
+    - RailsAiBridge::Introspector::ParallelRunner#resolve_future
+    - RailsAiBridge::Introspector::TimedRunner#self.call
     - RailsAiBridge::Introspectors::ActionMailboxIntrospector#extract_mailboxes
     - RailsAiBridge::Introspectors::ActionTextIntrospector#extract_rich_text_fields
     - RailsAiBridge::Introspectors::ActiveStorageIntrospector#detect_direct_upload
@@ -536,7 +562,6 @@ detectors:
     - RailsAiBridge::Introspectors::AuthIntrospector#scan_models_for
     - RailsAiBridge::Introspectors::ConfigIntrospector#detect_current_attributes
     - RailsAiBridge::Introspectors::ControllerIntrospector#call
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_filters
     - RailsAiBridge::Introspectors::ConventionDetector#detect_architecture
     - RailsAiBridge::Introspectors::ConventionDetector#detect_patterns
     - RailsAiBridge::Introspectors::ConventionDetector#scan_directory_structure
@@ -559,10 +584,7 @@ detectors:
     - RailsAiBridge::Introspectors::MigrationIntrospector#migration_stats
     - RailsAiBridge::Introspectors::MigrationIntrospector#pending_migrations
     - RailsAiBridge::Introspectors::ModelIntrospector#call
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_associations
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_callbacks
     - RailsAiBridge::Introspectors::ModelIntrospector#extract_model_details
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_source_macros
     - RailsAiBridge::Introspectors::ModelSemanticEnrichment#calculate_complexity_score
     - RailsAiBridge::Introspectors::ModelSemanticEnrichment#extract_semantic_data
     - RailsAiBridge::Introspectors::ModelSemanticEnrichment#extract_semantic_summary
@@ -620,6 +642,11 @@ detectors:
     - RailsAiBridge::RubydexAdapter#index!
     - RailsAiBridge::RubydexAdapter#instance
     - RailsAiBridge::RubydexAdapter#search
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#call
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#reindex
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#update_mtimes
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#load_mtimes
+    - RailsAiBridge::RubydexAdapter#handle_index_result
     - RailsAiBridge::Serializers::ContextFileSerializer#call
     - RailsAiBridge::Serializers::ContextFileSerializer#generate_split_rules
     - RailsAiBridge::Serializers::ContextFileSerializer#serialize
@@ -774,7 +801,6 @@ detectors:
     - RailsAiBridge::Introspectors::ConfigIntrospector#extract_initializers
     - RailsAiBridge::Introspectors::ConfigIntrospector#extract_middleware
     - RailsAiBridge::Introspectors::ControllerIntrospector#call
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_filters
     - RailsAiBridge::Introspectors::ConventionDetector#detect_config_files
     - RailsAiBridge::Introspectors::ConventionDetector#detect_patterns
     - RailsAiBridge::Introspectors::DatabaseStatsIntrospector#call
@@ -796,11 +822,6 @@ detectors:
     - RailsAiBridge::Introspectors::MigrationIntrospector#migration_stats
     - RailsAiBridge::Introspectors::MigrationIntrospector#pending_migrations
     - RailsAiBridge::Introspectors::ModelIntrospector#call
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_public_class_methods
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_public_instance_methods
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_source_macros
-    - RailsAiBridge::Introspectors::ModelIntrospector#sanitize_options
-    - RailsAiBridge::Introspectors::ModelSemanticEnrichment#find_similar_models
     - RailsAiBridge::Introspectors::MultiDatabaseIntrospector#call
     - RailsAiBridge::Introspectors::MultiDatabaseIntrospector#detect_model_connections
     - RailsAiBridge::Introspectors::MultiDatabaseIntrospector#discover_replicas
@@ -809,9 +830,7 @@ detectors:
     - RailsAiBridge::Introspectors::NonArModelsIntrospector#safe_to_process?
     - RailsAiBridge::Introspectors::RakeTaskIntrospector#call
     - RailsAiBridge::Introspectors::RakeTaskIntrospector#parse_rake_file
-    - RailsAiBridge::Introspectors::RouteIntrospector#detect_api_namespaces
     - RailsAiBridge::Introspectors::RouteIntrospector#detect_mounted_engines
-    - RailsAiBridge::Introspectors::RouteIntrospector#group_by_controller
     - RailsAiBridge::Introspectors::Schema::StaticSchemaParser#skip_table?
     - RailsAiBridge::Introspectors::SchemaIntrospector#table_names
     - RailsAiBridge::Introspectors::SeedsIntrospector#analyze_seeds_file
@@ -937,13 +956,20 @@ detectors:
   UtilityFunction:
     exclude:
     - RailsAiBridge::Doctor#compute_score
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#file_mtime
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#current_files
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#reindex_file
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#remove_file
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#threshold_exceeded?
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#mtimes_path
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#serialize_mtimes
+    - RailsAiBridge::RubydexAdapter::IncrementalIndexer#deserialize_mtimes
     - RailsAiBridge::Doctor::Checkers::BaseChecker#new_check
     - RailsAiBridge::Doctor::Checkers::StimulusMcpToolChecker#tool_registered?
     - RailsAiBridge::Doctor::Checkers::ViewMcpToolChecker#tool_registered?
     - RailsAiBridge::Introspectors::ControllerIntrospector#api_controller?
     - RailsAiBridge::Introspectors::ControllerIntrospector#discover_controllers
     - RailsAiBridge::Introspectors::ControllerIntrospector#eager_load_controllers!
-    - RailsAiBridge::Introspectors::ControllerIntrospector#extract_action_condition
     - RailsAiBridge::Introspectors::ControllerIntrospector#extract_actions
     - RailsAiBridge::Introspectors::ControllerIntrospector#extract_concerns
     - RailsAiBridge::Introspectors::ControllerIntrospector#extract_respond_to
@@ -957,12 +983,8 @@ detectors:
     - RailsAiBridge::Introspectors::JobIntrospector#extract_mailers
     - RailsAiBridge::Introspectors::MigrationIntrospector#detect_migration_actions
     - RailsAiBridge::Introspectors::ModelIntrospector#eager_load_models!
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_associations
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_callbacks
     - RailsAiBridge::Introspectors::ModelIntrospector#extract_concerns
     - RailsAiBridge::Introspectors::ModelIntrospector#extract_enums
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_public_class_methods
-    - RailsAiBridge::Introspectors::ModelIntrospector#extract_public_instance_methods
     - RailsAiBridge::Introspectors::ModelIntrospector#sanitize_options
     - RailsAiBridge::Introspectors::ModelSemanticEnrichment#calculate_complexity_score
     - RailsAiBridge::Introspectors::ModelSemanticEnrichment#extract_semantic_summary
@@ -974,9 +996,6 @@ detectors:
     - RailsAiBridge::Introspectors::NonArModelsIntrospector#safe_to_process?
     - RailsAiBridge::Introspectors::NonArModelsIntrospector#sanitize_error_message
     - RailsAiBridge::Introspectors::RakeTaskIntrospector#parse_rake_file
-    - RailsAiBridge::Introspectors::RouteIntrospector#detect_api_namespaces
-    - RailsAiBridge::Introspectors::RouteIntrospector#extract_constraints
-    - RailsAiBridge::Introspectors::RouteIntrospector#group_by_controller
     - RailsAiBridge::Introspectors::SchemaIntrospector#active_record_connected?
     - RailsAiBridge::Introspectors::SchemaIntrospector#adapter_name
     - RailsAiBridge::Introspectors::SchemaIntrospector#connection

data/.rubocop.yml

@@ -1,7 +1,6 @@
 plugins:
   - rubocop-rails
   - rubocop-rspec
-
 AllCops:
   TargetRubyVersion: 3.2
   NewCops: enable
@@ -10,19 +9,15 @@ AllCops:
     - "vendor/**/*"
     - "spec/internal/**/*"
     - "gemfiles/**/*"
-
 Naming/FileName:
   Exclude:
     - "lib/rails-ai-bridge.rb"
 Naming/RescuedExceptionsVariableName:
   PreferredName: error
-
 Style/Documentation:
   Enabled: false
-
 Metrics/ClassLength:
   Max: 240
-
 Metrics/BlockLength:
   Max: 120
   Exclude:
@@ -73,3 +68,4 @@ Metrics/CyclomaticComplexity:
   Max: 35
 Metrics/ParameterLists:
   Max: 6
+inherit_from: .rubocop_todo.yml

data/.rubocop_todo.yml

@@ -0,0 +1,7 @@
+Rails/ApplicationJob:
+  Exclude:
+    - 'spec/lib/rails_ai_bridge/introspectors/job_introspector_spec.rb'
+
+Rails/ApplicationMailer:
+  Exclude:
+    - 'spec/lib/rails_ai_bridge/introspectors/job_introspector_spec.rb'

data/AGENTS.md

@@ -53,3 +53,10 @@ Uses combustion gem for testing Rails engine behavior in isolation.
 - All tools prefixed with `rails_` per MCP naming best practices
 - `generate_context` returns `{ written: [], skipped: [] }` hash
 - Zeitwerk autoloads all files — no `require_relative` needed for new classes
+
+<!-- lean-ctx -->
+## lean-ctx
+
+Prefer lean-ctx MCP tools over native equivalents for token savings.
+Full rules: @LEAN-CTX.md
+<!-- /lean-ctx -->

data/CHANGELOG.md

@@ -5,6 +5,73 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.4.0] - 2026-05-21
+
+### Added
+
+- **`TimedRunner` — per-introspector wall-clock timing** (#36) — new `RailsAiBridge::Introspector::TimedRunner.call(klass, app)` value object wraps any introspector class and returns `{ result:, duration_ms: }`. Uses `Process.clock_gettime(CLOCK_MONOTONIC)` for accurate measurement regardless of system clock adjustments. Duration is recorded even when the introspector raises, so you can diagnose slow-then-failing classes. Sequential runs now log duration at `debug` level via `Rails.logger.debug`.
+- **Config-driven `ParallelRunner` pool size** (#36) — `config.parallel_pool_size` (default `4`) sets the upper bound for the `Concurrent::FixedThreadPool`; the actual size is `min(introspector_count, pool_size)` so no idle threads are ever created.
+- **Per-future timeout for parallel introspection** (#36) — `config.parallel_timeout_seconds` (default `10`) is enforced on each `Concurrent::Future` via `future.value(timeout)`. Introspectors that exceed their budget are cancelled and return `{ error: "timed out after Ns" }` without blocking the rest of the pool. The pool's `wait_for_termination` also uses this value.
+- **Rubydex incremental indexing** (#38) — new `RailsAiBridge::RubydexAdapter::IncrementalIndexer` service skips unchanged files on re-index using mtime tracking (integer seconds, no IEEE 754 precision loss). A full rebuild is triggered when the ratio of changed files exceeds `config.rubydex_incremental_threshold` (default `0.3`). The mtime snapshot can optionally survive process restarts via `config.rubydex_persist_index` (default `false`).
+- **`config.rubydex_incremental_threshold`** (#38) (default `0.3`) — ratio of changed-to-total files above which the incremental indexer falls back to a full rebuild.
+- **`config.rubydex_persist_index`** (#38) (default `false`) — when `true`, the rubydex mtime snapshot is written to disk alongside the index so incremental re-indexing survives process restarts.
+- **Path-traversal guard for rubydex index path** (#38) — `RubydexAdapter#indexer_options` now sanitises `config.rubydex_index_path` through a `Pathname#cleanpath` + root-prefix check, returning `nil` (and falling back to the default) for any path that escapes `Rails.root`.
+- **Bridge file freshness stamps** (#37) — generated bridge files (CLAUDE.md, AGENTS.md, GEMINI.md, .cursorrules, etc.) now embed a freshness header containing the generation timestamp, a 12-character source fingerprint (SHA-256 of `db/schema.rb` + `config/routes.rb`), and the gem version. Files are skipped on re-generation when their fingerprint matches, eliminating unnecessary timestamps and noisy git diffs.
+- **`Fingerprinter.source_fingerprint`** (#37) — new singleton method that hashes the app's schema and routes files into a compact 12-char hex fingerprint used by the freshness system.
+
+### Fixed (Security & Architecture Audit)
+
+- **ReDoS Vulnerability in `RubySearch`** — Added a 2-second timeout to the `Regexp.new` engine to prevent catastrophic backtracking denial-of-service on malicious search patterns.
+- **Path Traversal via Symlinks in `RubydexAdapter`** — `sanitize_index_path` now uses `Pathname#realpath` to strictly validate that the configured index path resolves safely inside the `Rails.root` boundary.
+- **TOCTOU Race Condition in `IncrementalIndexer`** — Upgraded mtime tracking from integer seconds (`to_i`) to rational (`to_r`) for precise sub-second caching, preventing scenarios where high-frequency file modifications within the same second bypassed change detection.
+- **Threshold Edge Case in `IncrementalIndexer`** — Changed the rebuild cutoff comparison from `>` to `>=` so that precise boundary thresholds (like 100% of files) trigger full rebuilds correctly.
+- **Memory Leaks & Exhaustion in `ParallelRunner`** — Replaced deprecated `clear_active_connections!` with `connection_pool.release_connection`, and explicitly added `pool.kill` to forcefully shut down long-running threads on timeouts.
+- **State Leakage in Extractors** — Refactored `FilterExtractor`, `AssociationExtractor`, and `SourceMacroExtractor` to eliminate shared mutable state, establishing purely functional object APIs and tightening private encapsulation.
+- **`db/structure.sql` fallback** (#37) — `source_fingerprint` automatically falls back to `db/structure.sql` when `db/schema.rb` is absent (apps using SQL schema format are now supported).
+- **`FreshnessHeader` module** (#37) — centralized utility for embedding and extracting freshness metadata from bridge files. Supports both Markdown (HTML comment header) and JSON (`_meta` object) formats, with backward-compatible parsing of older files that lack the gem-version field.
+- **Bridge freshness Doctor check** (#37) — a new `BridgeFreshnessChecker` is registered with the `Doctor` service. It reports stale bridge files (fingerprint mismatch) or missing bridge files as `:warn`, and fresh files as `:pass`. The Doctor now runs 16 total checks.
+- **`rails ai:check` rake task** (#37) — runs all diagnostic checks and exits with code `1` if any check fails, enabling straightforward CI/CD integration (e.g., `rails ai:check || exit 1`).
+- **`CHECK=1` pre-generation guard** (#37) — pass `CHECK=1` to `rails ai:bridge` (or any bridge sub-task) to run Doctor diagnostics first; generation is aborted if any check fails.
+- **`RailsAiBridge::RakeHelpers` module** (#37) — extracted top-level rake helper methods (`print_result`, `apply_context_mode_override`, `conflict_strategy`, `run_pre_generation_checks`) from global `Object` scope into a properly namespaced module.
+- **`CacheWarmer` & `CachedSnapshot`** (#36) — implemented TTL-based thread-safe caching system with `config.cache_warm_on_boot` to preemptively load context into memory on application start.
+
+### Changed
+
+- **`rubydex` enabled by default** — The `rubydex` gem (v0.2.3) is now a mandatory dependency and semantic analysis is enabled out of the box (`@rubydex_enabled = true`). This provides zero-config code graph and semantic context functionality to all users.
+- **Improved IDE configurations in documentation** — Promoted HTTP/SSE as the primary and highly recommended connection method for `rbenv`/`rvm` users within IDEs (like Antigravity and Cursor) to bypass subprocess ruby environment pathing issues.
+- **`Introspector#run_single`** (#36) — sequential execution is now routed through `TimedRunner` instead of a bare `rescue` block. Error handling behaviour is unchanged (`{ error: message }`), but every introspector call now produces a debug-level duration log entry.
+- **`ParallelRunner#resolve_future`** (#36) — uses `future.value(timeout)` + `future.complete?` check instead of blocking `future.value!`. A `nil` return from a timed-out future is no longer misinterpreted as a successful result.
+- **`ParallelRunner` pool shutdown** (#36) — `wait_for_termination` now uses `config.parallel_timeout_seconds` instead of a hardcoded `10`.
+- **`RubydexAdapter#handle_index_result`** (#38) — on `:reindex!` failure, existing `@graph` and `@indexed` state is preserved rather than reset to `nil`/`false`, preventing a full context blackout on transient indexing errors.
+- **Integer mtimes throughout `IncrementalIndexer`** (#38) — `serialize_mtimes`, `deserialize_mtimes`, and `file_mtime` now all operate in integer seconds (`Time#to_i`) to avoid IEEE 754 floating-point comparison drift.
+- **`FreshnessHeader`** (#37) — expanded API with `embed_for(fmt, ...)`, `extract_metadata_for(fmt, content)`, and `extract_fingerprint_for(fmt, content)` dispatching methods. JSON and Markdown branching is now fully centralized here, removing format-aware `if fmt == :json` conditionals from callers.
+- **`ContextFileSerializer`** (#37) — refactored to use a new `FreshnessWriter` inner class that encapsulates freshness metadata embedding and file write decisions. This eliminates `ControlParameter`, `UtilityFunction`, and `LongParameterList` Reek warnings.
+- **`BridgeFreshnessChecker`** (#37) — refactored with a `ScanResult` struct to eliminate the 6-parameter `check_file` method; introduced `scan_files`, `accumulate_file_result`, `stale?`, and `freshness_check` helpers reducing `TooManyStatements` and `DuplicateMethodCall` Reek warnings.
+- **`Fingerprinter.source_fingerprint`** (#37) — extracted `schema_path(root)` and `read_source_content(paths)` private helpers to reduce method statement count.
+- **`RubySearch`** (#35) — wrapped the 5 search params into a `SearchParams` struct to resolve the `TooManyInstanceVariables` Reek warning; extracted `secret_file?(basename)` from `skip_file?` to fix `FeatureEnvy`; added `SECRET_EXTENSIONS` constant.
+- **`RipgrepSearch::CommandBuilder`** (#35) — moved hardcoded secret file globs to a `SECRET_EXCLUDES` constant; renamed helpers to `excluded_path_flags` / `secret_exclude_flags`; added `# :reek:UtilityFunction` suppressions for intentional stateless helpers.
+- **`Validator`** (#35) — extracted `effective_max_bytes`, `present?`, `normalize_extension`, `safe_extension?`, `build_search_path`, `within_root?`, `path_not_found`, and `pattern_too_long_error` helpers. Fixes `DuplicateMethodCall` on `BaseTool.text_response("Path not found: ...")` in `validate_path_security`.
+- **`SourceMacroExtractor`** (#35) — split `add_attachment_macros` into three single-step helpers (`add_single_attached`, `add_many_attached`, `add_rich_text`) to reduce statement counts.
+- **Rake namespace splitting** (#35) — `namespace :ai` reopened across multiple smaller blocks in `rails_ai_bridge.rake` to comply with `Metrics/BlockLength` RuboCop limit.
+
+### Fixed
+
+- **`ASSISTANT_TABLE` constant redefinition warning** (#35) — wrapped constant definition in `unless defined?` to prevent warnings when Rake tasks are loaded multiple times in test environments.
+
+### Tests
+
+- Added **68 new examples** covering:
+  - `TimedRunner` — result forwarding, error capture, monotonic duration, error-path duration
+  - `ParallelRunner` — config-driven pool size, per-future timeout, pool shutdown, mixed success/failure, `available?` with pool-size and missing-constant edge cases
+  - `Introspector` — sequential `TimedRunner` wiring (plain result, no `duration_ms` envelope), error capture in sequential mode, debug log assertion
+  - `AppOverviewFormatter` — nil/error guards, optional fields, field ordering
+  - `GemsFormatter` — nil/error guards, total count, Notable Gems section, category+name sort order
+  - `MigrationsFormatter` — nil/error guards, schema version, pending migrations count, recent migrations with and without actions
+  - `RubySearch` / `FileProcessor` — pattern matching, max_results cap, secret file skipping (`.env`, `.key`, `.pem`, `.p12`, `.pfx`, `.crt`), excluded paths, file_type filtering, case-insensitive search, relative paths, unreadable file recovery, `:full` return signal
+  - `Fingerprinter` — restored `.compute` and `.changed?` unit tests; added `db/structure.sql` fallback and schema.rb-wins-when-both-exist edge cases
+  - `FreshnessHeader` — backward-compatible parsing of headers without gem version
+- **Total: 1,745 examples, 0 failures, 94.49% line coverage** (up from 94.04%)
+
 ## [3.2.0] - 2026-05-04
 
 ### Added

data/README.md

@@ -261,7 +261,7 @@ The gem exposes **12 built-in tools** via MCP that AI clients call on-demand (ho
 | `rails_get_conventions` | Architecture patterns, directory structure |
 | `rails_search_code` | Ripgrep (or Ruby) search under `Rails.root` with allowlisted extensions, pattern size cap, and optional wall-clock timeout |
 | `rails_get_view` | View layouts, templates, partials; optional per-file detail under the configured `app/views` path |
-| `rails_search_semantic` | Semantic code search using rubydex — find declarations by name with types, locations, and relationships (requires rubydex) |
+| `rails_search_semantic` | Semantic code search using rubydex — find declarations by name with types, locations, and relationships |
 | `rails_get_stimulus` | Stimulus controllers: targets, values, actions, outlets (requires `:stimulus` introspector) |
 
 All tools are **read-only** — they never modify your application or database.
@@ -485,6 +485,9 @@ end
 | `http_port` | `6029` | HTTP server port |
 | `cache_ttl` | `30` | Cache TTL in seconds |
 | `watcher_formats` | `:all` | Formats regenerated by `rails ai:watch` (e.g. `%i[claude cursor]` to limit churn) |
+| `parallel_introspection` | `false` | Run introspectors concurrently (requires `concurrent-ruby`, which is already a Rails dependency) |
+| `parallel_pool_size` | `4` | Max threads in the parallel pool; capped at the number of active introspectors so no idle threads are created |
+| `parallel_timeout_seconds` | `10` | Per-introspector future timeout (seconds); timed-out introspectors return `{ error: "timed out after Ns" }` without blocking the others |
 
 Other HTTP MCP knobs live only on the nested object, for example `RailsAiBridge.configuration.mcp.authorize`, `mcp.mode`, `mcp.security_profile`, and `mcp.require_auth_in_production` — see [docs/GUIDE.md](docs/GUIDE.md) and [docs/mcp-security.md](docs/mcp-security.md).
 </details>
@@ -513,19 +516,17 @@ Built-in MCP tools and resources now read through a shared runtime context provi
 
 ### Rubydex Integration (Semantic Code Analysis)
 
-[Rubydex](https://github.com/Shopify/rubydex) is Shopify's high-performance Ruby static analysis toolkit. When installed, rails-ai-bridge can leverage rubydex for semantic code understanding:
+[Rubydex](https://github.com/Shopify/rubydex) is Shopify's high-performance Ruby static analysis toolkit. rails-ai-bridge leverages rubydex out-of-the-box for semantic code understanding.
 
 **Setup:**
 
-1. Add rubydex to your Gemfile:
-   ```ruby
-   gem 'rubydex', '>= 0.1.0.beta9'
-   ```
+Rubydex is installed automatically as a core dependency and is enabled by default.
+
+To customize it in your initializer (`config/initializers/rails_ai_bridge.rb`):
 
-2. Enable in your initializer:
    ```ruby
    RailsAiBridge.configure do |config|
-     config.rubydex_enabled = true
+     # config.rubydex_enabled = false # Set to false to disable semantic analysis
 
      # Optional: enable the semantic introspector (adds :semantic to introspectors)
      config.semantic_introspector_enabled = true
@@ -533,6 +534,10 @@ Built-in MCP tools and resources now read through a shared runtime context provi
 
      # Optional: control semantic context depth in generated files
      # config.semantic_context_depth = :standard  # :summary, :standard, or :full
+
+     # Optional: incremental re-indexing (skip unchanged files on subsequent runs)
+     # config.rubydex_incremental_threshold = 0.3  # full rebuild if >30% of files changed
+     # config.rubydex_persist_index = true          # survive process restarts
    end
    ```
 
@@ -545,19 +550,22 @@ Built-in MCP tools and resources now read through a shared runtime context provi
 | Semantic introspector | Codebase-wide pattern detection, inheritance analysis, and complexity hotspots |
 | `rails://semantic/analysis` resource | Full semantic analysis accessible via MCP resource read |
 | Context file enrichment | Semantic insights automatically included in generated AI context files |
+| Incremental re-indexing | Only changed files are re-parsed on subsequent calls; unchanged files are skipped |
 
-**Internal architecture:** The `RubydexAdapter` wraps the rubydex API as a thin coordinator delegating to three single-responsibility collaborators: `Serializer` (hash conversion), `Indexer` (graph construction + source file scanning), and `MethodCounter` (flat method-counting pipeline). See [CONTRIBUTING.md](CONTRIBUTING.md#project-structure) for the full project layout.
+**Internal architecture:** The `RubydexAdapter` wraps the rubydex API as a thin coordinator delegating to three single-responsibility collaborators: `Serializer` (hash conversion), `Indexer` (graph construction + source file scanning), and `MethodCounter` (flat method-counting pipeline). Incremental re-indexing is handled by the `IncrementalIndexer` service, which tracks file mtimes and triggers a full rebuild when the changed-file ratio exceeds `rubydex_incremental_threshold`. See [CONTRIBUTING.md](CONTRIBUTING.md#project-structure) for the full project layout.
 
 **Configuration options:**
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `rubydex_enabled` | `false` | Enable rubydex integration |
-| `rubydex_index_path` | `"tmp/rubydex_index"` | Path for the rubydex index |
+| `rubydex_enabled` | `true` | Enable rubydex integration |
+| `rubydex_index_path` | `"tmp/rubydex_index"` | Path for the rubydex index (must stay within `Rails.root`) |
 | `semantic_introspector_enabled` | `false` | Enable the dedicated semantic introspector |
-| `semantic_context_depth` | `:standard` | Depth of semantic context in generated files |
+| `semantic_context_depth` | `:standard` | Depth of semantic context in generated files (`:summary`, `:standard`, `:full`) |
+| `rubydex_incremental_threshold` | `0.3` | Fraction of changed files (0.0–1.0) above which a full rebuild replaces incremental patching |
+| `rubydex_persist_index` | `false` | Persist the mtime snapshot to disk so incremental re-indexing survives process restarts |
 
-**Performance considerations:** Rubydex indexes your Ruby source files at startup. For large codebases, the initial indexing may take a few seconds. The index is cached in memory and shared across MCP tool calls.
+**Performance considerations:** Rubydex indexes your Ruby source files at startup. For large codebases, the initial indexing may take a few seconds. Subsequent calls re-use the in-memory index and only re-parse changed files, keeping re-indexing overhead proportional to churn rather than codebase size.
 
 ---