rails-ai-context 2.0.3 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 582aebf4849cdb8617b33dff88f3822009b8960e1334bbd1aa2eb6a3f6a03350
-  data.tar.gz: 03c8eedbf4989f07a75f878fe86380b809dd4ae1e2afd0020836a848da99b5c3
+  metadata.gz: 70a0eb825c34329a1f0bc9d387a4a2bfd2a42b56717305dcaa5df4c0712264f7
+  data.tar.gz: 5a2e229f4bbcaf39d9eebe3e3851444ceed0860b79ad4bcccf11fdba9487ac0a
 SHA512:
-  metadata.gz: 5a2abfe4dc7c9c123dacd427354789810197c478fab741ac88e9aa0d8c95fcccc5cac2b5005f01615cf678f7229362d3e4ea5838d7c76d2210b28a8531edd9da
-  data.tar.gz: 3f04bb928f49325badb6a956a54c1adb9dec73ac2f73b9d7f81831f5da5931ac0ef1f4494a5c71780cdabcfa159c38ff11a4bd6f7fbcbb7ac79272aaf5de4e3b
+  metadata.gz: eca131443eb443b24a7681233f5e5adcef9a2c2fb3f4ee6d4e665c795470bed1e0bfdfa92f4f4861136f3e7c2b34210972273b2d0b976f3ffb7fa88834ed31b7
+  data.tar.gz: b2e96f95e25b8e9cf9fb140446969fc7a027ff22e210321c3ade42da59aa7c6ed702ceabc0c8be62e8a56c2fa25230dcb460bfd3182716c3a1ef1cc300b836bb

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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).
 
+## [2.0.4] - 2026-03-25
+
+### Added
+
+- **Orphaned table detection** — `get_schema` standard mode flags tables with no ActiveRecord model: "⚠ Orphaned tables: content_calendars, cook_comments"
+- **Concern method source code** — `get_concern(name:"X", detail:"full")` shows method bodies inline, same pattern as callbacks tool.
+- **analyze_feature: inherited filters** — shows `authenticate_user! (from ApplicationController)` in controller section.
+- **analyze_feature: code-ready route helpers** — `cook_path(@record)`, `cooks_path` inline with routes.
+- **analyze_feature: service test gaps** — checks services for missing test files, not just models/controllers/jobs.
+- **All 6 serializers updated** — Claude, Cursor, Copilot, Windsurf, OpenCode all document trace mode, concern source, orphaned tables, inherited filters.
+
 ## [2.0.3] - 2026-03-25
 
 ### Added

data/lib/rails_ai_context/serializers/claude_rules_serializer.rb

@@ -344,8 +344,8 @@ module RailsAiContext
           "",
           "## Tools (25)",
           "",
-          "**rails_get_schema** — database tables, columns, indexes, foreign keys",
-          "- `rails_get_schema(detail:\"summary\")` — all tables with column counts",
+          "**rails_get_schema** — database tables, columns, indexes, foreign keys, orphaned table detection",
+          "- `rails_get_schema(detail:\"summary\")` — all tables with column counts + orphaned tables (tables with no ActiveRecord model)",
           "- `rails_get_schema(table:\"users\")` — full detail for one table",
           "",
           "**rails_get_model_details** — associations, validations, scopes, enums, callbacks",
@@ -381,7 +381,7 @@ module RailsAiContext
           "- `rails_validate(files:[\"app/models/cook.rb\"])` — checks Ruby, ERB, JS syntax in one call",
           "",
           "**rails_analyze_feature** — combined schema + models + controllers + routes for a feature area",
-          "- `rails_analyze_feature(feature:\"authentication\")` — one call gets everything related to a feature",
+          "- `rails_analyze_feature(feature:\"authentication\")` — one call gets everything related to a feature, including inherited filters from parent controllers and code-ready route helpers",
           "",
           "**rails_get_design_system** — color palette, component patterns, canonical page examples",
           "- `rails_get_design_system(detail:\"standard\")` — colors + components + real HTML examples + design rules",
@@ -390,13 +390,17 @@ module RailsAiContext
           "**rails_get_config** — cache store, session, timezone, middleware, initializers",
           "**rails_get_gems** — notable gems categorized by function",
           "**rails_get_conventions** — architecture patterns, directory structure",
-          "**rails_search_code** — regex search: `rails_search_code(pattern:\"regex\", file_type:\"rb\")`",
+          "**rails_search_code** — regex search with trace mode for deep call-chain analysis",
+          "- `rails_search_code(pattern:\"regex\", file_type:\"rb\")` — basic regex search across files",
+          "- `rails_search_code(pattern:\"can_cook?\", match_type:\"trace\")` — trace mode: definition + class context + source + siblings + callers with route chain + test coverage",
+          "- `rails_search_code(pattern:\"cook\", exclude_tests: true)` — search app code only, skip test files",
           "",
           "**rails_security_scan** — Brakeman security analysis",
           "- `rails_security_scan` — run security scan, returns warnings by confidence",
           "",
           "**rails_get_concern** — concern methods and includers",
           "- `rails_get_concern(name:\"Searchable\")` — methods, included modules, includers",
+          "- `rails_get_concern(name:\"Searchable\", detail:\"full\")` — + method source code",
           "",
           "**rails_get_callbacks** — model callbacks in execution order",
           "- `rails_get_callbacks(model:\"User\")` — before/after/around callbacks by type",

data/lib/rails_ai_context/serializers/claude_serializer.rb

@@ -214,11 +214,11 @@ module RailsAiContext
           "### Quick Reference",
           "| Need | Use this MCP tool | Do NOT use |",
           "|------|-------------------|------------|",
-          "| Column types | `rails_get_schema(table:\"x\")` | Read db/schema.rb |",
+          "| Column types | `rails_get_schema(table:\"x\")` — includes orphaned table warnings | Read db/schema.rb |",
           "| Model associations | `rails_get_model_details(model:\"X\")` | Read app/models/x.rb |",
           "| Route paths | `rails_get_routes(controller:\"x\")` | Read config/routes.rb |",
-          "| Feature overview | `rails_analyze_feature(feature:\"x\")` | Explore agent / Grep |",
-          "| Find code | `rails_search_code(pattern:\"x\")` | Grep tool |",
+          "| Feature overview | `rails_analyze_feature(feature:\"x\")` — models + controllers (inherited filters) + routes (code-ready helpers) + services + jobs + views + tests + gaps | Explore agent / Grep |",
+          "| Find code | `rails_search_code(pattern:\"x\", match_type:\"trace\")` | Grep tool |",
           "| Validate edits | `rails_validate(files:[...])` | ruby -c / erb / node |",
           "| Controller logic | `rails_get_controllers(controller:\"X\", action:\"y\")` | Read controller file |",
           "| UI patterns | `rails_get_design_system` | Read view files |",
@@ -227,10 +227,11 @@ module RailsAiContext
           "| Full context | `rails_get_context(model:\"X\")` | Multiple Read calls |",
           "",
           "### More Tools",
-          "- `rails_get_view(controller:\"x\")` | `rails_get_concern(name:\"X\")` | `rails_get_callbacks(model:\"X\")`",
+          "- `rails_get_view(controller:\"x\")` | `rails_get_concern(name:\"X\", detail:\"full\")` — concern methods with source code | `rails_get_callbacks(model:\"X\")`",
           "- `rails_get_helper_methods` | `rails_get_service_pattern` | `rails_get_job_pattern`",
           "- `rails_get_env` | `rails_get_partial_interface(path:\"shared/_form\")` | `rails_get_turbo_map`",
           "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
+          "- `rails_search_code(pattern:\"method\", match_type:\"trace\")` — **trace mode**: definition + class context + source + siblings + callers + test coverage in one call",
           "- `rails_get_edit_context(file:\"path\", near:\"keyword\")` — surgical edit helper with line numbers",
           ""
         ]

data/lib/rails_ai_context/serializers/copilot_instructions_serializer.rb

@@ -250,7 +250,13 @@ module RailsAiContext
           "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
           "- `rails_get_concern` | `rails_get_callbacks` | `rails_get_helper_methods` | `rails_get_service_pattern`",
           "- `rails_get_job_pattern` | `rails_get_env` | `rails_get_partial_interface` | `rails_get_turbo_map`",
-          "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call"
+          "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call",
+          "",
+          "## Power Features",
+          "- `rails_search_code(pattern:\"method\", match_type:\"trace\")` — trace: definition + source + siblings + callers + tests",
+          "- `rails_get_concern(name:\"X\", detail:\"full\")` — concern methods with source code",
+          "- `rails_analyze_feature` — full-stack with inherited filters, route helpers, test gaps",
+          "- `rails_get_schema` — columns, indexes, defaults, encrypted hints, orphaned table warnings"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/serializers/cursor_rules_serializer.rb

@@ -290,7 +290,13 @@ module RailsAiContext
           "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
           "- `rails_get_concern` | `rails_get_callbacks` | `rails_get_helper_methods` | `rails_get_service_pattern`",
           "- `rails_get_job_pattern` | `rails_get_env` | `rails_get_partial_interface` | `rails_get_turbo_map`",
-          "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call"
+          "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call",
+          "",
+          "## Power Features",
+          "- `rails_search_code(pattern:\"method\", match_type:\"trace\")` — trace: definition + source + siblings + callers + tests",
+          "- `rails_get_concern(name:\"X\", detail:\"full\")` — concern methods with source code",
+          "- `rails_analyze_feature` — full-stack with inherited filters, route helpers, test gaps",
+          "- `rails_get_schema` — columns, indexes, defaults, encrypted hints, orphaned table warnings"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/serializers/opencode_serializer.rb

@@ -172,7 +172,7 @@ module RailsAiContext
           "Start with `detail:\"summary\"`, then drill into specifics.",
           "",
           "### Mandatory Workflow",
-          "1. **Before exploring a feature**: `rails_analyze_feature(feature:\"...\")` — NOT file reads or grep",
+          "1. **Before exploring a feature**: `rails_analyze_feature(feature:\"...\")` — models + controllers (inherited filters) + routes (code-ready helpers) + services + jobs + views + tests + gaps",
           "2. **Before writing migrations**: `rails_get_schema(table:\"...\")` — NOT reading db/schema.rb",
           "3. **Before modifying a model**: `rails_get_model_details(model:\"...\")` — NOT reading the model file",
           "4. **Before adding routes**: `rails_get_routes(controller:\"...\")` — Read only when you will edit",
@@ -182,10 +182,10 @@ module RailsAiContext
           "### Do NOT Bypass",
           "| Instead of... | Use this MCP tool |",
           "|---------------|-------------------|",
-          "| Reading db/schema.rb | `rails_get_schema(table:\"x\")` |",
+          "| Reading db/schema.rb | `rails_get_schema(table:\"x\")` — includes orphaned table warnings |",
           "| Reading model files | `rails_get_model_details(model:\"X\")` |",
           "| Reading routes.rb | `rails_get_routes(controller:\"x\")` |",
-          "| Grep for code | `rails_search_code(pattern:\"x\")` |",
+          "| Grep for code | `rails_search_code(pattern:\"x\", match_type:\"trace\")` |",
           "| Reading test files | `rails_get_test_info(model:\"X\")` |",
           "| Reading controller | `rails_get_controllers(controller:\"X\", action:\"y\")` |",
           "| ruby -c / erb / node | `rails_validate(files:[...])` |",
@@ -195,8 +195,9 @@ module RailsAiContext
           "- `rails_get_view` | `rails_get_stimulus` | `rails_get_test_info` | `rails_analyze_feature`",
           "- `rails_get_design_system` | `rails_get_edit_context` | `rails_validate` | `rails_search_code`",
           "- `rails_get_config` | `rails_get_gems` | `rails_get_conventions` | `rails_security_scan`",
-          "- `rails_get_concern` | `rails_get_callbacks` | `rails_get_helper_methods` | `rails_get_service_pattern`",
+          "- `rails_get_concern(name:\"X\", detail:\"full\")` — concern methods with source code | `rails_get_callbacks` | `rails_get_helper_methods` | `rails_get_service_pattern`",
           "- `rails_get_job_pattern` | `rails_get_env` | `rails_get_partial_interface` | `rails_get_turbo_map`",
+          "- `rails_search_code(pattern:\"method\", match_type:\"trace\")` — **trace mode**: definition + class context + source + siblings + callers + test coverage in one call",
           "- `rails_get_context(model:\"X\")` — composite cross-layer context in one call",
           ""
         ]

data/lib/rails_ai_context/serializers/windsurf_rules_serializer.rb

@@ -95,7 +95,13 @@ module RailsAiContext
           "- rails_get_config | rails_get_gems | rails_get_conventions | rails_security_scan",
           "- rails_get_concern | rails_get_callbacks | rails_get_helper_methods | rails_get_service_pattern",
           "- rails_get_job_pattern | rails_get_env | rails_get_partial_interface | rails_get_turbo_map",
-          "- rails_get_context(model:\"X\") — composite cross-layer context in one call"
+          "- rails_get_context(model:\"X\") — composite cross-layer context in one call",
+          "",
+          "Power Features:",
+          "- rails_search_code(pattern:\"method\", match_type:\"trace\") — trace: definition + source + siblings + callers + tests",
+          "- rails_get_concern(name:\"X\", detail:\"full\") — concern methods with source code",
+          "- rails_analyze_feature — full-stack with inherited filters, route helpers, test gaps",
+          "- rails_get_schema — columns, indexes, defaults, encrypted hints, orphaned table warnings"
         ]
 
         lines.join("\n")

data/lib/rails_ai_context/tools/analyze_feature.rb

@@ -114,11 +114,17 @@ module RailsAiContext
               actions = info[:actions]&.join(", ") || "none"
               lines << "" << "### #{name}"
               lines << "- **Actions:** #{actions}"
+
+              # Inherited filters from parent controller
+              parent_filters = detect_parent_filters_for_analyze(info[:parent_class], controllers)
+              if parent_filters.any?
+                lines << "- **Inherited filters:** #{parent_filters.map { |f| "#{f[:name]} _(from #{info[:parent_class]})_" }.join(', ')}"
+              end
+
               filters = (info[:filters] || []).select { |f| f.is_a?(Hash) }.map do |f|
                 label = "#{f[:kind]} #{f[:name]}"
                 label += " only: #{Array(f[:only]).join(', ')}" if f[:only]&.any?
                 label += " except: #{Array(f[:except]).join(', ')}" if f[:except]&.any?
-                label += " unless: #{f[:unless]}" if f[:unless]
                 label
               end
               lines << "- **Filters:** #{filters.join('; ')}" if filters.any?
@@ -139,8 +145,14 @@ module RailsAiContext
             lines << "## Routes (#{route_count})"
             matched.sort.each do |ctrl, actions|
               actions.each do |r|
-                name_part = r[:name] ? " `#{r[:name]}`" : ""
-                lines << "- `#{r[:verb]}` `#{r[:path]}` → #{ctrl}##{r[:action]}#{name_part}"
+                params = r[:path].scan(/:(\w+)/).flatten
+                helper = if r[:name]
+                  args = params.any? ? "(#{params.map { |p| p == "id" ? "@record" : ":#{p}" }.join(', ')})" : ""
+                  " `#{r[:name]}_path#{args}`"
+                else
+                  ""
+                end
+                lines << "- `#{r[:verb]}` `#{r[:path]}` → #{ctrl}##{r[:action]}#{helper}"
               end
             end
           else
@@ -321,6 +333,18 @@ module RailsAiContext
             end
           end
 
+          # Check services
+          service_dir = File.join(root, "app", "services")
+          if Dir.exist?(service_dir)
+            Dir.glob(File.join(service_dir, "**", "*.rb")).each do |path|
+              next unless File.basename(path, ".rb").include?(pattern)
+              snake = File.basename(path, ".rb")
+              unless test_basenames.any? { |t| t.include?(snake) }
+                gaps << "Service `#{snake}` — no test file found"
+              end
+            end
+          end
+
           return if gaps.empty?
 
           lines << "## Test Coverage Gaps"
@@ -330,6 +354,28 @@ module RailsAiContext
           nil
         end
 
+        # Detect inherited filters from parent controller
+        def detect_parent_filters_for_analyze(parent_class, all_controllers)
+          return [] unless parent_class
+          parent_data = all_controllers[parent_class]
+          if parent_data
+            return (parent_data[:filters] || []).select { |f| f.is_a?(Hash) && f[:kind] == "before" && !f[:only]&.any? }
+          end
+
+          # Fallback: read source file
+          path = Rails.root.join("app", "controllers", "#{parent_class.underscore}.rb")
+          return [] unless File.exist?(path)
+          source = File.read(path, encoding: "UTF-8") rescue nil
+          return [] unless source
+
+          source.each_line.filter_map do |line|
+            next if line.include?("only:") || line.include?("except:")
+            { name: $1 } if line.match(/\A\s*before_action\s+:(\w+)/)
+          end
+        rescue
+          []
+        end
+
         # --- AF6: Related Models via Associations ---
         def discover_related_models(ctx, matched_models, lines)
           return if matched_models.empty?

data/lib/rails_ai_context/tools/get_concern.rb

@@ -18,13 +18,18 @@ module RailsAiContext
             type: "string",
             enum: %w[model controller all],
             description: "Filter by concern type. model: app/models/concerns/. controller: app/controllers/concerns/. all: both (default)."
+          },
+          detail: {
+            type: "string",
+            enum: %w[summary standard full],
+            description: "Detail level. summary: concern names only. standard: names + method signatures (default). full: method signatures with source code."
           }
         }
       )
 
       annotations(read_only_hint: true, destructive_hint: false, idempotent_hint: true, open_world_hint: false)
 
-      def self.call(name: nil, type: "all", server_context: nil)
+      def self.call(name: nil, type: "all", detail: "standard", server_context: nil)
         root = rails_app.root.to_s
         max_size = RailsAiContext.configuration.max_file_size
 
@@ -36,7 +41,7 @@ module RailsAiContext
 
         # Specific concern — full detail
         if name
-          return show_concern(name, concern_dirs, root, max_size)
+          return show_concern(name, concern_dirs, root, max_size, detail)
         end
 
         # List all concerns
@@ -67,7 +72,7 @@ module RailsAiContext
         end
       end
 
-      private_class_method def self.show_concern(name, concern_dirs, root, max_size)
+      private_class_method def self.show_concern(name, concern_dirs, root, max_size, detail = "standard")
         # Find the concern file — try underscore variants and nested paths
         underscore = name.underscore
         file_path = nil
@@ -121,14 +126,47 @@ module RailsAiContext
         public_methods = parse_public_methods(source)
         if public_methods.any?
           lines << "" << "## Public Methods"
-          public_methods.each { |m| lines << "- `#{m}`" }
+          if detail == "full"
+            public_methods.each do |m|
+              method_name = m.to_s.split("(").first
+              method_source = extract_method_source(source, method_name)
+              if method_source
+                lines << "### #{m}"
+                lines << "```ruby"
+                lines << method_source
+                lines << "```"
+                lines << ""
+              else
+                lines << "- `#{m}`"
+              end
+            end
+          else
+            public_methods.each { |m| lines << "- `#{m}`" }
+          end
         end
 
         # Parse class methods (inside class_methods block or def self.)
         class_methods = parse_class_methods(source)
         if class_methods.any?
           lines << "" << "## Class Methods"
-          class_methods.each { |m| lines << "- `#{m}`" }
+          if detail == "full"
+            class_methods.each do |m|
+              method_name = m.to_s.split("(").first
+              # Try both `def method_name` and `def self.method_name`
+              method_source = extract_method_source(source, method_name) || extract_method_source(source, "self.#{method_name}")
+              if method_source
+                lines << "### #{m}"
+                lines << "```ruby"
+                lines << method_source
+                lines << "```"
+                lines << ""
+              else
+                lines << "- `#{m}`"
+              end
+            end
+          else
+            class_methods.each { |m| lines << "- `#{m}`" }
+          end
         end
 
         # Parse callbacks defined in the concern
@@ -345,6 +383,25 @@ module RailsAiContext
         []
       end
 
+      # Extract method source from raw source string using indentation-based matching
+      private_class_method def self.extract_method_source(source, method_name)
+        source_lines = source.lines
+        start_idx = source_lines.index { |l| l.match?(/\A\s*def\s+#{Regexp.escape(method_name.to_s)}\b/) }
+        return nil unless start_idx
+
+        def_indent = source_lines[start_idx][/\A\s*/].length
+        result = []
+
+        source_lines[start_idx..].each_with_index do |line, i|
+          result << line.rstrip
+          break if i > 0 && line.match?(/\A\s{#{def_indent}}end\b/)
+        end
+
+        result.join("\n")
+      rescue
+        nil
+      end
+
       private_class_method def self.find_includers(concern_name, root, concern_type)
         includers = []
         search_dirs = []

data/lib/rails_ai_context/tools/get_schema.rb

@@ -160,6 +160,14 @@ module RailsAiContext
             lines << cols
             lines << ""
           end
+
+          # Detect orphaned tables (no ActiveRecord model maps to them)
+          orphaned = paginated.select { |name| models_for_table(name).empty? }
+          if orphaned.any?
+            lines << "\u26A0 **Orphaned tables** (no ActiveRecord model): #{orphaned.join(', ')}"
+            lines << ""
+          end
+
           lines << "_Use `detail:\"summary\"` for all #{total} tables, `detail:\"full\"` for indexes/FKs, or `table:\"name\"` for one table._" if total > limit
           text_response(lines.join("\n"))
 

data/lib/rails_ai_context/version.rb

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

data/server.json

@@ -7,11 +7,11 @@
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"
   },
-  "version": "2.0.3",
+  "version": "2.0.4",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v2.0.3/rails-ai-context-mcp.mcpb",
+      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v2.0.4/rails-ai-context-mcp.mcpb",
       "fileSha256": "dd711a0ad6c4de943ae4da94eaf59a6dc9494b9d57f726e24649ed4e2f156990",
       "transport": {
         "type": "stdio"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 2.0.3
+  version: 2.0.4
 platform: ruby
 authors:
 - crisnahine