rails-ai-context 0.5.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8378145ec19882ed7d2eb8c088da05bca9df2cdea61f566d4690310f50d3825a
-  data.tar.gz: 53e3377b30f932baa6ed0d42e3b91dc2b20a5e5b05f459a6315716dbe48a7161
+  metadata.gz: 03fa54ba8f83f42735ee47382cfac1c5007486dbe1287f6e06a5f5ba1c884dce
+  data.tar.gz: '082eb0840ce4d1208d2acf33ebdede21437fe743709e404b3d3d87bba53038f0'
 SHA512:
-  metadata.gz: 629a78fe135ff955a71ceb870baf6a49c3d178e7358254ac9b88143cad6212e7b3190745835754b3b726148f0469080fd1a71d12c6c1eb1ab9b31a7bd095e3e8
-  data.tar.gz: aeb99f7ca9638fd00066b1f4a21758ad4cbcd1f447dae77c26245b55eb9f9954165a06f1114cf0cc2091a60925e9dc42ad747d9155c2e08bb070ca5b4247f47d
+  metadata.gz: ab1c6d28c824bfcfb022178a385d158ecebcb5858eb6d2ee2e65d4b0cf032d33c314dfd9d614545c30deb20bb4d047be1f6db2e22a86818ef66ffb6fc294cdbe
+  data.tar.gz: d4318f848e29b00ef5e4f19bc918e5be03d149ec2a59597e1c7ac7497628fef8a443fefc6e96bf117fbac7d548d38c3dcd62020b4d163a7c0860f390ad38eabf

data/CHANGELOG.md

@@ -5,6 +5,27 @@ 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).
 
+## [0.6.0] - 2026-03-18
+
+### Added
+
+- **Migrations introspector** — Discovers migration files, pending migrations, recent history, schema version, and migration statistics. Works without DB connection.
+- **Seeds introspector** — Analyzes db/seeds.rb structure, discovers seed files in db/seeds/, detects which models are seeded, and identifies patterns (Faker, environment conditionals, find_or_create_by).
+- **Middleware introspector** — Discovers custom Rack middleware in app/middleware/, detects patterns (auth, rate limiting, tenant isolation, logging), and categorizes the full middleware stack.
+- **Engine introspector** — Discovers mounted Rails engines from routes.rb with paths and descriptions for 23+ known engines (Sidekiq::Web, Flipper::UI, PgHero, ActiveAdmin, etc.).
+- **Multi-database introspector** — Discovers multiple databases, replicas, sharding config, and model-specific `connects_to` declarations. Works with database.yml parsing fallback.
+- **2 new MCP resources** — `rails://migrations`, `rails://engines`
+- **Migrations added to :standard preset** — AI tools now see migration context by default
+- **Doctor check** — New `check_migrations` diagnostic
+- **Fingerprinter** — Now watches `db/migrate/`, `app/middleware/`, and `config/database.yml`
+
+### Changed
+
+- Default `:standard` preset expanded from 8 to 9 introspectors (added `:migrations`)
+- Default `:full` preset expanded from 21 to 26 introspectors
+- Doctor checks expanded from 11 to 12
+- Static MCP resources expanded from 7 to 9
+
 ## [0.5.2] - 2026-03-18
 
 ### Fixed

data/CLAUDE.md

@@ -8,7 +8,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 - `lib/rails_ai_context.rb` — Main entry point, public API (Zeitwerk autoloaded)
 - `lib/rails_ai_context/configuration.rb` — User-facing config with presets (:standard, :full)
 - `lib/rails_ai_context/introspector.rb` — Orchestrates sub-introspectors
-- `lib/rails_ai_context/introspectors/` — 22 introspectors (schema, models, routes, jobs, gems, conventions, stimulus, database_stats, controllers, views, turbo, i18n, config, active_storage, action_text, auth, api, tests, rake_tasks, assets, devops, action_mailbox)
+- `lib/rails_ai_context/introspectors/` — 27 introspectors (schema, models, routes, jobs, gems, conventions, stimulus, database_stats, controllers, views, turbo, i18n, config, active_storage, action_text, auth, api, tests, rake_tasks, assets, devops, action_mailbox, migrations, seeds, middleware, engines, multi_database)
 - `lib/rails_ai_context/tools/` — 9 MCP tools using the official mcp SDK
 - `lib/rails_ai_context/serializers/` — Output formatters (claude, rules, copilot, markdown, JSON)
 - `lib/rails_ai_context/resources.rb` — MCP resources (static data AI clients read directly)
@@ -30,13 +30,13 @@ structure to AI assistants via the Model Context Protocol (MCP).
 6. **Diff-aware** — context regeneration skips unchanged files
 7. **Per-assistant serializers** — each AI tool gets tailored output format
 8. **Zeitwerk autoloading** — files loaded on-demand, not all upfront
-9. **Introspector presets** — `:standard` (8 core) default, `:full` (21) for power users
+9. **Introspector presets** — `:standard` (9 core) default, `:full` (26) for power users
 10. **MCP auto-discovery** — `.mcp.json` generated by install generator
 
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (253 examples)
+bundle exec rspec           # Run specs (282 examples)
 bundle exec rubocop         # Lint
 ```
 

data/README.md

@@ -5,7 +5,7 @@
 [![CI](https://github.com/crisnahine/rails-ai-context/actions/workflows/ci.yml/badge.svg)](https://github.com/crisnahine/rails-ai-context/actions)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-![Demo](demo.gif?v=0.5.2)
+![Demo](https://raw.githubusercontent.com/crisnahine/rails-ai-context/main/demo.gif)
 
 `rails-ai-context` automatically introspects your Rails application and exposes your models, routes, schema, controllers, views, jobs, gems, auth, API, tests, config, and conventions to AI assistants through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io).
 
@@ -126,6 +126,8 @@ In addition to tools, the gem registers MCP resources that AI clients can read d
 | `rails://controllers` | All controllers with actions and filters (JSON) |
 | `rails://config` | Application configuration (JSON) |
 | `rails://tests` | Test infrastructure details (JSON) |
+| `rails://migrations` | Migration history and statistics (JSON) |
+| `rails://engines` | Mounted engines with paths and descriptions (JSON) |
 | `rails://models/{name}` | Per-model details (resource template) |
 
 ---
@@ -169,7 +171,7 @@ In addition to tools, the gem registers MCP resources that AI clients can read d
 RailsAiContext.configure do |config|
   # Introspector presets:
   #   :standard — 8 core introspectors (default, fast)
-  #   :full     — all 21 introspectors (thorough)
+  #   :full     — all 26 introspectors (thorough)
   config.preset = :standard
 
   # Or cherry-pick on top of a preset:

data/demo_script.sh

@@ -8,7 +8,7 @@ echo 'Fetching gem metadata from https://rubygems.org...'
 sleep 0.3
 echo 'Resolving dependencies...'
 sleep 0.3
-echo 'Installing rails-ai-context 0.5.2'
+echo 'Installing rails-ai-context 0.6.0'
 echo ''
 sleep 1
 

data/lib/rails_ai_context/configuration.rb

@@ -3,8 +3,10 @@
 module RailsAiContext
   class Configuration
     PRESETS = {
-      standard: %i[schema models routes jobs gems conventions controllers tests],
-      full: %i[schema models routes jobs gems conventions stimulus controllers views turbo i18n config active_storage action_text auth api tests rake_tasks assets devops action_mailbox]
+      standard: %i[schema models routes jobs gems conventions controllers tests migrations],
+      full: %i[schema models routes jobs gems conventions stimulus controllers views turbo
+               i18n config active_storage action_text auth api tests rake_tasks assets
+               devops action_mailbox migrations seeds middleware engines multi_database]
     }.freeze
 
     # MCP server settings
@@ -28,9 +30,6 @@ module RailsAiContext
     # Models/tables to exclude from introspection
     attr_accessor :excluded_models
 
-    # Maximum depth for association traversal
-    attr_accessor :max_association_depth
-
     # TTL in seconds for cached introspection (default: 30)
     attr_accessor :cache_ttl
 
@@ -50,7 +49,6 @@ module RailsAiContext
         ActionText::RichText ActionText::EncryptedRichText
         ActionMailbox::InboundEmail ActionMailbox::Record
       ]
-      @max_association_depth = 2
       @cache_ttl            = 30
     end
 

data/lib/rails_ai_context/doctor.rb

@@ -15,6 +15,7 @@ module RailsAiContext
       check_views
       check_i18n
       check_tests
+      check_migrations
       check_context_files
       check_mcp_buildable
       check_ripgrep
@@ -110,6 +111,16 @@ module RailsAiContext
       end
     end
 
+    def check_migrations
+      migrate_dir = File.join(app.root, "db/migrate")
+      if Dir.exist?(migrate_dir) && Dir.glob(File.join(migrate_dir, "*.rb")).any?
+        count = Dir.glob(File.join(migrate_dir, "*.rb")).size
+        Check.new(name: "Migrations", status: :pass, message: "#{count} migration files found", fix: nil)
+      else
+        Check.new(name: "Migrations", status: :warn, message: "No migrations found in db/migrate/", fix: "Run `rails generate migration` to create one")
+      end
+    end
+
     def check_context_files
       claude_path = File.join(app.root, "CLAUDE.md")
       if File.exist?(claude_path)

data/lib/rails_ai_context/fingerprinter.rb

@@ -9,6 +9,7 @@ module RailsAiContext
     WATCHED_FILES = %w[
       db/schema.rb
       config/routes.rb
+      config/database.yml
       Gemfile.lock
     ].freeze
 
@@ -20,7 +21,9 @@ module RailsAiContext
       app/mailers
       app/channels
       app/javascript/controllers
+      app/middleware
       config/initializers
+      db/migrate
       lib/tasks
     ].freeze
 

data/lib/rails_ai_context/introspector.rb

@@ -69,6 +69,11 @@ module RailsAiContext
       when :assets         then Introspectors::AssetPipelineIntrospector.new(app)
       when :devops         then Introspectors::DevOpsIntrospector.new(app)
       when :action_mailbox then Introspectors::ActionMailboxIntrospector.new(app)
+      when :migrations      then Introspectors::MigrationIntrospector.new(app)
+      when :seeds           then Introspectors::SeedsIntrospector.new(app)
+      when :middleware       then Introspectors::MiddlewareIntrospector.new(app)
+      when :engines         then Introspectors::EngineIntrospector.new(app)
+      when :multi_database  then Introspectors::MultiDatabaseIntrospector.new(app)
       else
         raise ConfigurationError, "Unknown introspector: #{name}"
       end

data/lib/rails_ai_context/introspectors/engine_introspector.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Introspectors
+    # Discovers mounted Rails engines and Rack apps from config/routes.rb.
+    # Identifies well-known engines and provides context about what each does.
+    class EngineIntrospector # rubocop:disable Metrics/ClassLength
+      attr_reader :app
+
+      KNOWN_ENGINES = {
+        "Sidekiq::Web" => { category: :admin, description: "Sidekiq background job dashboard" },
+        "GoodJob::Engine" => { category: :admin, description: "GoodJob dashboard for background jobs" },
+        "MissionControl::Jobs::Engine" => { category: :admin, description: "Rails Mission Control for SolidQueue jobs" },
+        "ActiveAdmin::Engine" => { category: :admin, description: "ActiveAdmin administration framework" },
+        "RailsAdmin::Engine" => { category: :admin, description: "Rails Admin dashboard" },
+        "Administrate::Engine" => { category: :admin, description: "Thoughtbot Administrate dashboard" },
+        "Avo::Engine" => { category: :admin, description: "Avo admin panel" },
+        "Madmin::Engine" => { category: :admin, description: "Madmin admin interface" },
+        "Flipper::UI" => { category: :feature_flags, description: "Flipper feature flag dashboard" },
+        "Flipper::Api" => { category: :feature_flags, description: "Flipper feature flag API" },
+        "PgHero::Engine" => { category: :monitoring, description: "PgHero PostgreSQL performance dashboard" },
+        "Blazer::Engine" => { category: :monitoring, description: "Blazer SQL query dashboard" },
+        "Coverband::Engine" => { category: :monitoring, description: "Coverband code coverage in production" },
+        "Rswag::Api::Engine" => { category: :api_docs, description: "Rswag API documentation (Swagger)" },
+        "Rswag::Ui::Engine" => { category: :api_docs, description: "Rswag Swagger UI" },
+        "GraphiQL::Rails::Engine" => { category: :api_docs, description: "GraphiQL in-browser IDE for GraphQL" },
+        "Lookbook::Engine" => { category: :ui, description: "Lookbook ViewComponent previews" },
+        "LetterOpenerWeb::Engine" => { category: :dev_tools, description: "Letter Opener Web email preview" },
+        "ActionCable.server" => { category: :realtime, description: "Action Cable WebSocket server" },
+        "Devise::Engine" => { category: :auth, description: "Devise authentication engine" },
+        "Doorkeeper::Engine" => { category: :auth, description: "Doorkeeper OAuth 2 provider" },
+        "ActionMailbox::Engine" => { category: :mail, description: "Action Mailbox inbound email processing" },
+        "ActiveStorage::Engine" => { category: :storage, description: "Active Storage file uploads" }
+      }.freeze
+
+      def initialize(app)
+        @app = app
+      end
+
+      # @return [Hash] mounted engines with paths and descriptions
+      def call
+        {
+          mounted_engines: discover_mounted_engines,
+          rails_engines: discover_rails_engines
+        }
+      rescue => e
+        { error: e.message }
+      end
+
+      private
+
+      def root
+        app.root.to_s
+      end
+
+      def discover_mounted_engines
+        routes_path = File.join(root, "config/routes.rb")
+        return [] unless File.exist?(routes_path)
+
+        content = File.read(routes_path)
+        engines = []
+
+        # Match: mount Sidekiq::Web => "/sidekiq"
+        # Match: mount Sidekiq::Web, at: "/sidekiq"
+        content.scan(/mount\s+([\w:]+(?:\.\w+)?)\s*(?:=>|,\s*at:\s*)?\s*["']([^"']+)["']/).each do |engine_name, path|
+          info = { engine: engine_name, path: path }
+          known = KNOWN_ENGINES[engine_name]
+          if known
+            info[:category] = known[:category].to_s
+            info[:description] = known[:description]
+          end
+          engines << info
+        end
+
+        # Fallback: match mount without captured path
+        content.scan(/mount\s+([\w:]+(?:\.\w+)?)[\s,]/).each do |match|
+          engine_name = match[0]
+          next if engines.any? { |e| e[:engine] == engine_name }
+
+          known = KNOWN_ENGINES[engine_name]
+          next unless known
+
+          engines << {
+            engine: engine_name,
+            path: "unknown",
+            category: known[:category].to_s,
+            description: known[:description]
+          }
+        end
+
+        engines.sort_by { |e| e[:engine] }
+      end
+
+      def discover_rails_engines
+        return [] unless defined?(Rails::Engine)
+
+        Rails::Engine.subclasses.filter_map do |engine|
+          next if engine.name.nil?
+          next if engine.name == "RailsAiContext::Engine"
+          next if engine.name.start_with?("Rails::", "ActionPack::", "ActionView::", "ActiveModel::")
+
+          { name: engine.name, root: engine.root.to_s.sub("#{Gem.dir}/gems/", "") }
+        rescue
+          nil
+        end.sort_by { |e| e[:name] }
+      rescue
+        []
+      end
+    end
+  end
+end

data/lib/rails_ai_context/introspectors/middleware_introspector.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Introspectors
+    # Discovers custom Rack middleware in app/middleware/ and detects
+    # middleware inserted via initializers.
+    class MiddlewareIntrospector
+      attr_reader :app
+
+      def initialize(app)
+        @app = app
+      end
+
+      # @return [Hash] custom middleware files and middleware stack analysis
+      def call
+        custom = discover_custom_middleware
+        {
+          custom_middleware: custom,
+          middleware_stack: extract_middleware_stack,
+          middleware_count: middleware_count(custom)
+        }
+      rescue => e
+        { error: e.message }
+      end
+
+      private
+
+      def root
+        app.root.to_s
+      end
+
+      def discover_custom_middleware
+        middleware_dir = File.join(root, "app/middleware")
+        return [] unless Dir.exist?(middleware_dir)
+
+        Dir.glob(File.join(middleware_dir, "**/*.rb")).sort.map do |path|
+          content = File.read(path)
+          class_name = File.basename(path, ".rb").camelize
+
+          info = {
+            file: path.sub("#{root}/", ""),
+            class_name: class_name,
+            has_call_method: content.match?(/def\s+call\b/),
+            initializes_app: content.match?(/def\s+initialize\s*\(\s*app/)
+          }
+
+          patterns = []
+          patterns << "authentication" if content.match?(/auth|token|session|jwt/i)
+          patterns << "rate_limiting" if content.match?(/rate.?limit|throttl/i)
+          patterns << "logging" if content.match?(/log|Logger/i)
+          patterns << "cors" if content.match?(/cors|origin|Access-Control/i)
+          patterns << "caching" if content.match?(/cache|Cache-Control|etag/i)
+          patterns << "error_handling" if content.match?(/rescue|error|exception/i)
+          patterns << "tenant" if content.match?(/tenant|subdomain|account/i)
+          info[:detected_patterns] = patterns if patterns.any?
+
+          info
+        rescue => e
+          { file: path.sub("#{root}/", ""), error: e.message }
+        end
+      end
+
+      def extract_middleware_stack
+        app.middleware.map do |middleware|
+          name = middleware.name || middleware.klass.to_s
+          { name: name, category: categorize_middleware(name) }
+        end
+      rescue
+        []
+      end
+
+      def middleware_count(custom)
+        {
+          total: app.middleware.size,
+          custom: custom.size
+        }
+      rescue
+        {}
+      end
+
+      def categorize_middleware(name)
+        case name
+        when /ActionDispatch::SSL|ForceSSL/ then "security"
+        when /Session|Cookie/ then "session"
+        when /Cache|ETag|Conditional/ then "caching"
+        when /Logger|RequestId/ then "logging"
+        when /Static|Files/ then "static_files"
+        when /Rack::Attack/ then "rate_limiting"
+        when /Cors|CORS/ then "cors"
+        when /Executor|Reloader/ then "rails_internal"
+        when /ActionDispatch/ then "request_handling"
+        when /ActiveRecord/ then "database"
+        else "other"
+        end
+      end
+    end
+  end
+end

data/lib/rails_ai_context/introspectors/migration_introspector.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Introspectors
+    # Discovers migration files, pending migrations, and recent migration history.
+    # Works without a database connection by parsing db/migrate/ filenames.
+    class MigrationIntrospector
+      attr_reader :app
+
+      def initialize(app)
+        @app = app
+      end
+
+      # @return [Hash] migration info including recent, pending, and stats
+      def call
+        {
+          total: all_migrations.size,
+          recent: recent_migrations(10),
+          pending: pending_migrations,
+          schema_version: current_schema_version,
+          migration_stats: migration_stats
+        }
+      rescue => e
+        { error: e.message }
+      end
+
+      private
+
+      def root
+        app.root.to_s
+      end
+
+      def migrate_dir
+        File.join(root, "db/migrate")
+      end
+
+      # Parse all migration files from db/migrate/
+      def all_migrations
+        @all_migrations ||= begin
+          return [] unless Dir.exist?(migrate_dir)
+
+          Dir.glob(File.join(migrate_dir, "*.rb")).sort.map do |path|
+            filename = File.basename(path, ".rb")
+            version = filename.split("_").first
+            name = filename.sub(/\A\d+_/, "").tr("_", " ").capitalize
+
+            content = File.read(path)
+            actions = detect_migration_actions(content)
+
+            {
+              version: version,
+              name: name,
+              filename: File.basename(path),
+              actions: actions
+            }
+          rescue => e
+            { version: "unknown", name: File.basename(path), error: e.message }
+          end
+        end
+      end
+
+      def recent_migrations(count)
+        all_migrations.last(count).reverse
+      end
+
+      # Detect pending migrations by comparing against schema version
+      def pending_migrations
+        if defined?(ActiveRecord::Base) && ActiveRecord::Base.connection_pool.connected?
+          begin
+            context = ActiveRecord::MigrationContext.new(migrate_dir)
+            if context.respond_to?(:pending_migrations)
+              return context.pending_migrations.map do |m|
+                { version: m.version.to_s, name: m.name }
+              end
+            end
+          rescue => _e
+            # Fall through to file-based detection
+          end
+        end
+
+        schema_ver = current_schema_version
+        return [] unless schema_ver
+
+        all_migrations.select { |m| m[:version].to_i > schema_ver.to_i }.map do |m|
+          { version: m[:version], name: m[:name] }
+        end
+      end
+
+      def current_schema_version
+        schema_path = File.join(root, "db/schema.rb")
+        return nil unless File.exist?(schema_path)
+
+        content = File.read(schema_path)
+        match = content.match(/version:\s*([\d_]+)/)
+        match ? match[1].delete("_") : nil
+      rescue
+        nil
+      end
+
+      def migration_stats
+        return {} if all_migrations.empty?
+
+        by_year = all_migrations.group_by do |m|
+          version = m[:version].to_s
+          version.length >= 4 ? version[0..3] : "unknown"
+        end
+
+        {
+          by_year: by_year.transform_values(&:count),
+          total_create_table: all_migrations.count { |m| m[:actions]&.include?("create_table") },
+          total_add_column: all_migrations.count { |m| m[:actions]&.include?("add_column") },
+          total_add_index: all_migrations.count { |m| m[:actions]&.include?("add_index") }
+        }
+      end
+
+      def detect_migration_actions(content)
+        %w[
+          create_table drop_table rename_table
+          add_column remove_column rename_column change_column
+          add_index remove_index add_reference remove_reference
+          add_foreign_key remove_foreign_key
+          add_timestamps create_join_table enable_extension execute
+        ].select { |action| content.include?(action) }
+      end
+    end
+  end
+end

data/lib/rails_ai_context/introspectors/multi_database_introspector.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Introspectors
+    # Discovers multi-database configuration: multiple databases, replicas,
+    # sharding, and database-specific model assignments.
+    class MultiDatabaseIntrospector
+      attr_reader :app
+
+      def initialize(app)
+        @app = app
+      end
+
+      # @return [Hash] multi-database configuration
+      def call
+        dbs = discover_databases
+        {
+          databases: dbs,
+          replicas: discover_replicas,
+          sharding: detect_sharding,
+          model_connections: detect_model_connections,
+          multi_db: dbs.size > 1
+        }
+      rescue => e
+        { error: e.message }
+      end
+
+      private
+
+      def root
+        app.root.to_s
+      end
+
+      def discover_databases
+        if defined?(ActiveRecord::Base)
+          configs = ActiveRecord::Base.configurations.configs_for(env_name: Rails.env)
+          configs.map do |config|
+            info = { name: config.name, adapter: config.adapter }
+            info[:database] = anonymize_db_name(config.database) if config.database
+            info[:replica] = true if config.respond_to?(:replica?) && config.replica?
+            info
+          end
+        else
+          parse_database_yml
+        end
+      rescue
+        parse_database_yml
+      end
+
+      def discover_replicas
+        if defined?(ActiveRecord::Base)
+          configs = ActiveRecord::Base.configurations.configs_for(env_name: Rails.env)
+          configs.select { |c| c.respond_to?(:replica?) && c.replica? }.map do |config|
+            { name: config.name, adapter: config.adapter }
+          end
+        else
+          []
+        end
+      rescue
+        []
+      end
+
+      def detect_sharding
+        database_yml = File.join(root, "config/database.yml")
+        return nil unless File.exist?(database_yml)
+
+        content = File.read(database_yml)
+        { detected: true, note: "Sharding configuration found in database.yml" } if content.match?(/shard/i)
+      rescue
+        nil
+      end
+
+      def detect_model_connections
+        models_dir = File.join(root, "app/models")
+        return [] unless Dir.exist?(models_dir)
+
+        connections = []
+        Dir.glob(File.join(models_dir, "**/*.rb")).each do |path|
+          content = File.read(path)
+          model_name = File.basename(path, ".rb").camelize
+
+          if (match = content.match(/connects_to\s+(.*?\n(?:\s+.*\n)*)/m))
+            connects_to_text = match[1].strip.gsub(/\s+/, " ")
+            connections << {
+              model: model_name,
+              connects_to: connects_to_text
+            }
+          end
+
+          if content.match?(/connected_to\b/)
+            connections << { model: model_name, uses_connected_to: true } unless connections.any? { |c| c[:model] == model_name }
+          end
+        rescue
+          next
+        end
+
+        connections.sort_by { |c| c[:model] }
+      end
+
+      def parse_database_yml
+        path = File.join(root, "config/database.yml")
+        return [] unless File.exist?(path)
+
+        content = File.read(path)
+        databases = []
+        current_env = defined?(Rails) ? Rails.env : "development"
+        in_env = false
+        skip_keys = %w[adapter database host port username password encoding pool timeout socket url]
+
+        content.each_line do |line|
+          if line.match?(/\A#{current_env}:/)
+            in_env = true
+            next
+          elsif line.match?(/\A\w+:/) && in_env
+            break
+          end
+
+          next unless in_env
+
+          if line.match?(/\A\s{2}(\w+):/) && !line.include?("<<")
+            db_name = line.strip.chomp(":")
+            databases << { name: db_name } unless skip_keys.include?(db_name)
+          end
+        end
+
+        databases
+      rescue
+        []
+      end
+
+      def anonymize_db_name(name)
+        return name unless name
+
+        if name.start_with?("postgres://", "mysql://", "sqlite://")
+          URI.parse(name).path.sub("/", "")
+        else
+          name
+        end
+      rescue
+        "external"
+      end
+    end
+  end
+end

data/lib/rails_ai_context/introspectors/seeds_introspector.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module RailsAiContext
+  module Introspectors
+    # Discovers database seed configuration: db/seeds.rb structure,
+    # seed files in db/seeds/ directory, and what models they populate.
+    class SeedsIntrospector
+      attr_reader :app
+
+      def initialize(app)
+        @app = app
+      end
+
+      # @return [Hash] seed file info and detected models
+      def call
+        {
+          seeds_file: analyze_seeds_file,
+          seed_files: discover_seed_files,
+          models_seeded: detect_seeded_models
+        }
+      rescue => e
+        { error: e.message }
+      end
+
+      private
+
+      def root
+        app.root.to_s
+      end
+
+      def analyze_seeds_file
+        path = File.join(root, "db/seeds.rb")
+        return nil unless File.exist?(path)
+
+        content = File.read(path)
+        {
+          exists: true,
+          lines: content.lines.count,
+          uses_find_or_create: content.match?(/find_or_create_by/),
+          uses_create: content.match?(/\.create[!(]?/),
+          uses_upsert: content.match?(/\.upsert/),
+          uses_insert_all: content.match?(/\.insert_all/),
+          uses_faker: content.match?(/Faker::/),
+          uses_factory_bot: content.match?(/FactoryBot/),
+          loads_directory: content.match?(/Dir\[|Dir\.glob|load.*seeds/),
+          environment_conditional: content.match?(/Rails\.env/)
+        }
+      rescue => e
+        { exists: false, error: e.message }
+      end
+
+      def discover_seed_files
+        seeds_dir = File.join(root, "db/seeds")
+        return [] unless Dir.exist?(seeds_dir)
+
+        Dir.glob(File.join(seeds_dir, "**/*.rb")).sort.map do |path|
+          {
+            file: path.sub("#{root}/", ""),
+            name: File.basename(path, ".rb")
+          }
+        end
+      end
+
+      def detect_seeded_models
+        models = Set.new
+        seed_files = [ File.join(root, "db/seeds.rb") ]
+
+        seeds_dir = File.join(root, "db/seeds")
+        seed_files += Dir.glob(File.join(seeds_dir, "**/*.rb")) if Dir.exist?(seeds_dir)
+
+        non_models = %w[File Dir ENV Rails Faker FactoryBot ActiveRecord IO Pathname YAML JSON CSV]
+
+        seed_files.each do |path|
+          next unless File.exist?(path)
+          content = File.read(path)
+
+          content.scan(/\b([A-Z][A-Za-z0-9]+(?:::[A-Z][A-Za-z0-9]+)*)\s*\.\s*(?:create|find_or_create_by|upsert|insert_all|new|first_or_create|seed)/).each do |match|
+            model_name = match[0]
+            models << model_name unless non_models.include?(model_name)
+          end
+        rescue
+          next
+        end
+
+        models.sort.to_a
+      end
+    end
+  end
+end

data/lib/rails_ai_context/resources.rb

@@ -48,6 +48,18 @@ module RailsAiContext
         description: "Test framework, factories, fixtures, CI, and coverage configuration",
         mime_type: "application/json",
         key: :tests
+      },
+      "rails://migrations" => {
+        name: "Migrations",
+        description: "Migration history, pending migrations, and migration statistics",
+        mime_type: "application/json",
+        key: :migrations
+      },
+      "rails://engines" => {
+        name: "Mounted Engines",
+        description: "Mounted Rails engines and Rack apps with paths and descriptions",
+        mime_type: "application/json",
+        key: :engines
       }
     }.freeze
 

data/lib/rails_ai_context/serializers/markdown_serializer.rb

@@ -36,6 +36,11 @@ module RailsAiContext
         sections << rake_tasks_section if context[:rake_tasks]
         sections << devops_section if context[:devops]
         sections << action_mailbox_section if context[:action_mailbox]
+        sections << migrations_section if context[:migrations]
+        sections << seeds_section if context[:seeds]
+        sections << middleware_section if context[:middleware]
+        sections << engines_section if context[:engines]
+        sections << multi_database_section if context[:multi_database]
         sections << footer
         sections.compact.join("\n\n")
       end
@@ -387,6 +392,108 @@ module RailsAiContext
         lines.join("\n")
       end
 
+      def migrations_section
+        data = context[:migrations]
+        return if data[:error]
+
+        lines = [ "## Migrations" ]
+        lines << "- Total: #{data[:total]}"
+        lines << "- Schema version: #{data[:schema_version]}" if data[:schema_version]
+
+        if data[:pending]&.any?
+          lines << "### Pending Migrations (#{data[:pending].size})"
+          data[:pending].each { |m| lines << "- `#{m[:version]}` #{m[:name]}" }
+        end
+
+        if data[:recent]&.any?
+          lines << "### Recent Migrations"
+          data[:recent].each do |m|
+            actions = m[:actions]&.any? ? " (#{m[:actions].join(', ')})" : ""
+            lines << "- `#{m[:version]}` #{m[:name]}#{actions}"
+          end
+        end
+
+        lines.join("\n")
+      end
+
+      def seeds_section
+        data = context[:seeds]
+        return if data[:error]
+
+        lines = [ "## Database Seeds" ]
+        if data[:seeds_file]
+          lines << "- Seeds file: #{data[:seeds_file][:exists] ? 'exists' : 'missing'}"
+          lines << "- Uses Faker: yes" if data[:seeds_file][:uses_faker]
+          lines << "- Environment-conditional: yes" if data[:seeds_file][:environment_conditional]
+        end
+        lines << "- Models seeded: #{data[:models_seeded].join(', ')}" if data[:models_seeded]&.any?
+
+        if data[:seed_files]&.any?
+          lines << "### Seed Files"
+          data[:seed_files].each { |f| lines << "- `#{f[:file]}`" }
+        end
+
+        lines.join("\n")
+      end
+
+      def middleware_section
+        data = context[:middleware]
+        return if data[:error]
+
+        lines = [ "## Custom Middleware" ]
+        if data[:custom_middleware]&.any?
+          data[:custom_middleware].each do |m|
+            detail = "- `#{m[:class_name]}` (#{m[:file]})"
+            detail += " — #{m[:detected_patterns].join(', ')}" if m[:detected_patterns]&.any?
+            lines << detail
+          end
+        else
+          lines << "- No custom middleware in app/middleware/"
+        end
+
+        lines.join("\n")
+      end
+
+      def engines_section
+        data = context[:engines]
+        return if data[:error]
+
+        lines = [ "## Mounted Engines" ]
+        if data[:mounted_engines]&.any?
+          data[:mounted_engines].each do |e|
+            desc = e[:description] ? " — #{e[:description]}" : ""
+            lines << "- `#{e[:engine]}` at `#{e[:path]}`#{desc}"
+          end
+        else
+          lines << "- No mounted engines"
+        end
+
+        lines.join("\n")
+      end
+
+      def multi_database_section
+        data = context[:multi_database]
+        return if data[:error]
+        return unless data[:multi_db]
+
+        lines = [ "## Multi-Database" ]
+        if data[:databases]&.any?
+          data[:databases].each do |db|
+            replica = db[:replica] ? " (replica)" : ""
+            lines << "- `#{db[:name]}` — #{db[:adapter]}#{replica}"
+          end
+        end
+
+        if data[:model_connections]&.any?
+          lines << "### Model Connections"
+          data[:model_connections].each do |c|
+            lines << "- `#{c[:model]}` → #{c[:connects_to] || 'custom connection'}"
+          end
+        end
+
+        lines.join("\n")
+      end
+
       def footer
         <<~MD
           ---

data/lib/rails_ai_context/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAiContext
-  VERSION = "0.5.2"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.6.0
 platform: ruby
 authors:
 - crisnahine
@@ -208,13 +208,18 @@ files:
 - lib/rails_ai_context/introspectors/convention_detector.rb
 - lib/rails_ai_context/introspectors/database_stats_introspector.rb
 - lib/rails_ai_context/introspectors/devops_introspector.rb
+- lib/rails_ai_context/introspectors/engine_introspector.rb
 - lib/rails_ai_context/introspectors/gem_introspector.rb
 - lib/rails_ai_context/introspectors/i18n_introspector.rb
 - lib/rails_ai_context/introspectors/job_introspector.rb
+- lib/rails_ai_context/introspectors/middleware_introspector.rb
+- lib/rails_ai_context/introspectors/migration_introspector.rb
 - lib/rails_ai_context/introspectors/model_introspector.rb
+- lib/rails_ai_context/introspectors/multi_database_introspector.rb
 - lib/rails_ai_context/introspectors/rake_task_introspector.rb
 - lib/rails_ai_context/introspectors/route_introspector.rb
 - lib/rails_ai_context/introspectors/schema_introspector.rb
+- lib/rails_ai_context/introspectors/seeds_introspector.rb
 - lib/rails_ai_context/introspectors/stimulus_introspector.rb
 - lib/rails_ai_context/introspectors/test_introspector.rb
 - lib/rails_ai_context/introspectors/turbo_introspector.rb