legion-mcp 0.5.8 → 0.5.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ff0343837c41b8a3c90e88f6d307244d57d0b37ca8c48cc9c4b8b346aefeb51
-  data.tar.gz: 6e222e352d5f1484a4f40e8893c8c2c9b71315052d3bfbda72a48c6f4f2369a4
+  metadata.gz: be92d2fce17740050cde5ca1b45deb3d678e5e2e48fca5e1fc4d7057118b068c
+  data.tar.gz: 4a01d5e8f26ee0f0203f59bc584cec5caffb04d45d6137f9dced2b7dc1d925b4
 SHA512:
-  metadata.gz: 3fa4b7fab3a42f425bd63d91bc2a97802a12ecb5374313b85d21f959e4b8f63fff13ef8daf7d0c95f3de698bb07ad4cf3aacedbcddfbe391383a54d31a4b422b
-  data.tar.gz: 3d74c974da483a0384ebaee0fb2420541e2aa9f00de38e562be09ecef2673ab284080821e030616268e9b5947345e82bce8d29da7a7fc1d8dd3114f32c584299
+  metadata.gz: ed9a3d3eb3a686443a213fce62729d92e0c892b3ced57921ac0ec6312974e3ac4dd588c7cb01eb32943a2063dcdaf84e03f4f1b9cf48783c08489e3be738ee03
+  data.tar.gz: bdf60cb8ebb7f994097f50e50bcef95ae2b4da27c3958edce57d8d897bdac8f3c5fee3d3b668fd4f971b9b06c6375e203df8e9aad7204b24e581fb0032590b95

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # legion-mcp Changelog
 
+## [0.5.9] - 2026-03-26
+
+### Added
+- `legion.knowledge_health` MCP tool: health report for document knowledge base (local, Apollo, sync stats)
+  - Optional `path:` input (falls back to Settings corpus_path)
+  - Tool count: 57 → 58
+
 ## [0.5.8] - 2026-03-26
 
 ### Added

data/lib/legion/mcp/server.rb

@@ -65,6 +65,7 @@ require_relative 'tools/mind_growth_build_queue'
 require_relative 'tools/mind_growth_cognitive_profile'
 require_relative 'tools/mind_growth_health'
 require_relative 'tools/query_knowledge'
+require_relative 'tools/knowledge_health'
 require_relative 'catalog_bridge'
 require_relative 'resources/runner_catalog'
 require_relative 'resources/extension_info'
@@ -129,7 +130,8 @@ module Legion
         Tools::MindGrowthBuildQueue,
         Tools::MindGrowthCognitiveProfile,
         Tools::MindGrowthHealth,
-        Tools::QueryKnowledge
+        Tools::QueryKnowledge,
+        Tools::KnowledgeHealth
       ].freeze
 
       class << self

data/lib/legion/mcp/tools/knowledge_health.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class KnowledgeHealth < ::MCP::Tool
+        tool_name 'legion.knowledge_health'
+        description 'Get health report for the document knowledge base. Returns local, Apollo, and sync stats.'
+
+        input_schema(
+          properties: {
+            path: { type: 'string', description: 'Corpus directory path (falls back to settings)' }
+          }
+        )
+
+        class << self
+          def call(path: nil)
+            return error_response('lex-knowledge is not available') unless knowledge_available?
+
+            resolved = resolve_path(path)
+            return error_response('No corpus path configured') unless resolved
+
+            result = Legion::Extensions::Knowledge::Runners::Maintenance.health(path: resolved)
+            text_response(result)
+          rescue StandardError => e
+            Legion::Logging.warn("KnowledgeHealth#call failed: #{e.message}") if defined?(Legion::Logging)
+            error_response("Knowledge health failed: #{e.message}")
+          end
+
+          private
+
+          def knowledge_available?
+            defined?(Legion::Extensions::Knowledge::Runners::Maintenance)
+          end
+
+          def resolve_path(path)
+            return path if path && !path.empty?
+            return nil unless defined?(Legion::Settings)
+
+            Legion::Settings.dig(:knowledge, :corpus_path)
+          rescue StandardError
+            nil
+          end
+
+          def text_response(data)
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(data) }])
+          end
+
+          def error_response(msg)
+            body = { error: msg }
+            ::MCP::Tool::Response.new([{ type: 'text', text: Legion::JSON.dump(body) }], error: true)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module MCP
-    VERSION = '0.5.8'
+    VERSION = '0.5.9'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-mcp
 version: !ruby/object:Gem::Version
-  version: 0.5.8
+  version: 0.5.9
 platform: ruby
 authors:
 - Esity
@@ -171,6 +171,7 @@ files:
 - lib/legion/mcp/tools/get_status.rb
 - lib/legion/mcp/tools/get_task.rb
 - lib/legion/mcp/tools/get_task_logs.rb
+- lib/legion/mcp/tools/knowledge_health.rb
 - lib/legion/mcp/tools/list_chains.rb
 - lib/legion/mcp/tools/list_extensions.rb
 - lib/legion/mcp/tools/list_peers.rb