yardmcp 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9d5b8dbd42ee1273aeeff0a838eff6163149bb15d919fad96ca2805334e278a
-  data.tar.gz: 969fb019698cd02d4ee29c6d27c8133ecb9b9c88f804759fda894ff96093acd3
+  metadata.gz: d10bb618f1bd998034becf18059f3dee35e41437da51f88c88d2647cd8d119bb
+  data.tar.gz: 2c14c6fbccd58cac7ec149f401c607ddcbd4c66fbc3f83dada0640b6368d1a04
 SHA512:
-  metadata.gz: 40134673bfd201aa6e191a963f36d650e63beef01972c0b7c4e86f8d4932660ad6b529bd4755f0914d4a29357c8d80983439c539782d72837ee306e38a386c0e
-  data.tar.gz: '015892a44b95e688079da5b935d6913df45a634f90a125735e3f644b52872bf067b05a0b2bf4952a153e4db6bb4eef3ab9303ffa4fe8bf191c7dae6fc550e300'
+  metadata.gz: a872f2d3873ddcd8fe42a9088df79fc5ea939750515c93ddfa40fd49930d57a094b0cb43e0a862a32412918fd577f323450d2fa5291fd059189075bd8c1233ec
+  data.tar.gz: 1ff7d77c17dde0652bb185481be516ebe757b4ee0aea1b43527ada6707078b47d2a32537d1410a813fc9f3600b7e252c58fec0c68a96328df7317cf11e4d505f

data/lib/yardmcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module YardMCP
-  VERSION = '0.2.1'
+  VERSION = '0.2.2'
 end

data/lib/yardmcp.rb

@@ -9,7 +9,7 @@ require 'singleton'
 require_relative 'yardmcp/version'
 
 # Utility class for YARD operations
-class YardUtils
+class YardUtils # rubocop:disable Metrics/ClassLength
   include Singleton
 
   attr_reader :libraries, :logger, :object_to_gem
@@ -38,6 +38,7 @@ class YardUtils
     raise "Yardoc not found for #{gem_name}" unless yardoc_exists?(dir)
 
     YARD::Registry.load_yardoc(dir)
+    YARD::Registry.load_all
     @last_loaded_gem = gem_name
   end
 
@@ -54,7 +55,12 @@ class YardUtils
   #
   # @return [Array<String>] An array of gem names with .yardoc files.
   def list_gems
-    libraries.keys.sort
+    libraries.keys.select do |name|
+      lib = libraries[name].first
+      ver = "= #{lib.version}"
+      dir = YARD::Registry.yardoc_file_for_gem(name, ver)
+      dir && File.directory?(dir)
+    end.sort
   end
 
   # Lists all classes and modules in the loaded YARD registry.
@@ -160,7 +166,7 @@ class YardUtils
     end
     {
       superclass: obj.respond_to?(:superclass) && obj.superclass ? obj.superclass.path : nil,
-      included_modules: obj.respond_to?(:included_modules) ? obj.included_modules.map(&:path) : [],
+      included_modules: obj.respond_to?(:mixins) ? obj.mixins.map(&:path) : [],
       mixins: obj.respond_to?(:mixins) ? obj.mixins.map(&:path) : []
     }
   end
@@ -183,7 +189,7 @@ class YardUtils
   #
   # @param path [String] The YARD path of the class/module.
   # @return [Hash] A hash with :included_modules, :mixins, :subclasses.
-  def related_objects(path) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+  def related_objects(path)
     ensure_yardoc_loaded_for_object!(path)
     obj = YARD::Registry.at(path)
     unless obj
@@ -191,9 +197,10 @@ class YardUtils
       return {}
     end
     subclasses = YARD::Registry.all(:class).select { |c| c.superclass && c.superclass.path == obj.path }.map(&:path)
+    mixins_list = obj.respond_to?(:mixins) ? obj.mixins.map(&:path) : []
     {
-      included_modules: obj.respond_to?(:included_modules) ? obj.included_modules.map(&:path) : [],
-      mixins: obj.respond_to?(:mixins) ? obj.mixins.map(&:path) : [],
+      included_modules: mixins_list,
+      mixins: mixins_list,
       subclasses:
     }
   end
@@ -329,6 +336,7 @@ end
 # Tool: List all gems with .yardoc files
 class ListGemsTool < FastMcp::Tool
   description 'List all installed gems that have a .yardoc file'
+  annotations(title: 'List all installed gems', read_only_hint: true)
 
   def call
     gems = YardUtils.instance.list_gems
@@ -339,6 +347,7 @@ end
 # Tool: List all classes and modules in the loaded YARD registry
 class ListClassesTool < FastMcp::Tool
   description 'List all classes and modules in the loaded YARD registry'
+  annotations(title: 'List all classes and modules', read_only_hint: true)
   arguments do
     required(:gem_name).filled(:string).description('Name of the gem to list classes for')
   end
@@ -352,6 +361,7 @@ end
 # Tool: Fetch documentation for a YARD object
 class GetDocTool < FastMcp::Tool
   description 'Fetch documentation and metadata for a class/module/method from YARD'
+  annotations(title: 'Fetch documentation', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description("YARD path (e.g. 'String#upcase')")
     optional(:gem_name).filled(:string).description("Optional gem name to load specific gem's documentation")
@@ -365,6 +375,7 @@ end
 # Tool: List children under a namespace
 class ChildrenTool < FastMcp::Tool
   description 'List children under a namespace (class/module) in YARD'
+  annotations(title: 'List children under a namespace', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description('YARD path of the namespace')
   end
@@ -378,6 +389,7 @@ end
 # Tool: List methods for a class/module
 class MethodsListTool < FastMcp::Tool
   description 'List methods for a class/module in YARD'
+  annotations(title: 'List methods for a class/module', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description('YARD path of the class/module')
   end
@@ -391,6 +403,7 @@ end
 # Tool: Return inheritance and inclusion info
 class HierarchyTool < FastMcp::Tool
   description 'Return inheritance and inclusion info for a class/module in YARD'
+  annotations(title: 'Return inheritance and inclusion info', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description('YARD path of the class/module')
   end
@@ -403,6 +416,7 @@ end
 # Tool: Perform fuzzy/full-text search
 class SearchTool < FastMcp::Tool
   description 'Perform fuzzy/full-text search in YARD registry'
+  annotations(title: 'Perform fuzzy/full-text search', read_only_hint: true)
   arguments do
     required(:query).filled(:string).description('Search query')
   end
@@ -417,6 +431,7 @@ end
 # Tool: Fetch source file and line number for a YARD object
 class SourceLocationTool < FastMcp::Tool
   description 'Fetch the source file and line number for a class/module/method from YARD'
+  annotations(title: 'Fetch the source file and line number', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description("YARD path (e.g. 'String#upcase')")
   end
@@ -429,6 +444,7 @@ end
 # Tool: Fetch code snippet for a YARD object from installed gems
 class CodeSnippetTool < FastMcp::Tool
   description 'Fetch the code snippet for a class/module/method from installed gems using YARD'
+  annotations(title: 'Fetch the code snippet', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description("YARD path (e.g. 'String#upcase')")
   end
@@ -442,6 +458,7 @@ end
 # Tool: Fetch the full ancestor chain (superclasses and included modules) for a class/module in YARD
 class AncestorsTool < FastMcp::Tool
   description 'Fetch the full ancestor chain (superclasses and included modules) for a class/module in YARD'
+  annotations(title: 'Fetch the full ancestor chain', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description('YARD path of the class/module')
   end
@@ -455,6 +472,7 @@ end
 # Tool: List related objects: included modules, mixins, and subclasses for a class/module in YARD
 class RelatedObjectsTool < FastMcp::Tool
   description 'List related objects: included modules, mixins, and subclasses for a class/module in YARD'
+  annotations(title: 'List related objects', read_only_hint: true)
   arguments do
     required(:path).filled(:string).description('YARD path of the class/module')
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yardmcp
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Roman Shterenzon