legion-mcp 0.5.9 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be92d2fce17740050cde5ca1b45deb3d678e5e2e48fca5e1fc4d7057118b068c
-  data.tar.gz: 4a01d5e8f26ee0f0203f59bc584cec5caffb04d45d6137f9dced2b7dc1d925b4
+  metadata.gz: 19e316cc546a5fae512d371abccff4f2b6eef90d2902ee7df75a97eb5680dc01
+  data.tar.gz: 0b9d4d42b3a3677e66d289454e5d496c0535f8d99e71c1a20a9a2d718c18305a
 SHA512:
-  metadata.gz: ed9a3d3eb3a686443a213fce62729d92e0c892b3ced57921ac0ec6312974e3ac4dd588c7cb01eb32943a2063dcdaf84e03f4f1b9cf48783c08489e3be738ee03
-  data.tar.gz: bdf60cb8ebb7f994097f50e50bcef95ae2b4da27c3958edce57d8d897bdac8f3c5fee3d3b668fd4f971b9b06c6375e203df8e9aad7204b24e581fb0032590b95
+  metadata.gz: c15a8d8c104f8fbbfeccbc50e6a58363a7989ca84e28c13d9b8199fe6ea700733e3f449cb619ecc4c5948ca947f9f9b756eda51a707705f765504145faa64543
+  data.tar.gz: 3001f29ecd4a9da497c4ee5824086bdb7288a99db51202d017d031df38a0f987f4db0ba123cf61e527f1e961be5422307aac394001b55250c3a461514e20c466

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # legion-mcp Changelog
 
+## [Unreleased]
+
+## [0.6.0] - 2026-03-26
+
+### Added
+- `legion.knowledge_context` MCP tool (59th tool) — scoped RAG query with local/global/all routing
+
 ## [0.5.9] - 2026-03-26
 
 ### Added

data/CLAUDE.md

@@ -7,7 +7,7 @@
 Standalone gem providing the Model Context Protocol (MCP) server for LegionIO. Extracted from LegionIO to enable independent versioning and reuse. Includes semantic tool matching, observation pipeline, context compilation, tiered inference (Tier 0/1/2), and tool governance.
 
 **GitHub**: https://github.com/LegionIO/legion-mcp
-**Version**: 0.5.5
+**Version**: 0.6.0
 **License**: Apache-2.0
 **Ruby**: >= 3.4
 
@@ -25,7 +25,7 @@ Legion::MCP
 ├── PatternStore        # 4-layer degrading storage (L0 memory, L1 cache, L2 local SQLite)
 ├── TierRouter          # Confidence-gated tier selection (Tier 0/1/2)
 ├── ContextGuard        # Staleness, rapid-fire, anomaly detection guards
-├── Tools/              # 41 MCP::Tool subclasses (legion.* namespace)
+├── Tools/              # 59 MCP::Tool subclasses (legion.* namespace)
 └── Resources/          # RunnerCatalog, ExtensionInfo
 ```
 
@@ -75,16 +75,21 @@ All optional dependencies use `defined?()` guards:
 | `lib/legion/mcp/pattern_store.rb` | 4-layer degrading storage (L0/L1/L2) with thread-safe access |
 | `lib/legion/mcp/tier_router.rb` | Confidence-gated tier selection, tool chain execution |
 | `lib/legion/mcp/context_guard.rb` | Staleness, rapid-fire, anomaly detection |
-| `lib/legion/mcp/tools/` | 41 MCP::Tool subclasses (legion.* namespace) |
+| `lib/legion/mcp/tools/` | 59 MCP::Tool subclasses (legion.* namespace) |
 | `lib/legion/mcp/tools/do_action.rb` | Natural language intent routing with Tier 0 fast path |
 | `lib/legion/mcp/tools/discover_tools.rb` | Dynamic tool discovery with context |
 | `lib/legion/mcp/tools/run_task.rb` | Execute runner function via dot notation |
-| `legion.mind_growth_status` | Current growth cycle state |
-| `legion.mind_growth_propose` | Trigger concept proposal (category, description, name) |
-| `legion.mind_growth_approve` | Approve a proposal by ID |
-| `legion.mind_growth_build_queue` | List approved proposals ready to build |
-| `legion.mind_growth_cognitive_profile` | Current architecture analysis |
-| `legion.mind_growth_health` | Extension fitness validation |
+| `lib/legion/mcp/tools/query_knowledge.rb` | Query Apollo knowledge store |
+| `lib/legion/mcp/tools/knowledge_health.rb` | Knowledge store health and quality report |
+| `lib/legion/mcp/tools/knowledge_context.rb` | Scoped RAG query (local/global/all) for current-task context |
+| `lib/legion/mcp/tools/eval_*.rb` | Evaluation management (list/run/results) |
+| `lib/legion/mcp/tools/experiment_results.rb` | A/B experiment result comparison |
+| `lib/legion/mcp/tools/dataset_*.rb` | Dataset browsing (list/show) |
+| `lib/legion/mcp/tools/prompt_*.rb` | Prompt template management (list/show/run) |
+| `lib/legion/mcp/tools/plan_action.rb` | Agentic planning with action decomposition |
+| `lib/legion/mcp/tools/ask_peer.rb` / `notify_peer.rb` / `broadcast_peers.rb` / `list_peers.rb` | Agent mesh communication |
+| `lib/legion/mcp/tools/mesh_status.rb` | Mesh topology status |
+| `lib/legion/mcp/tools/mind_growth_*.rb` | Mind growth tools (status/propose/approve/build_queue/cognitive_profile/health) |
 | `lib/legion/mcp/resources/runner_catalog.rb` | `legion://runners` resource |
 | `lib/legion/mcp/resources/extension_info.rb` | `legion://extensions/{name}` resource template |
 
@@ -92,7 +97,7 @@ All optional dependencies use `defined?()` guards:
 
 ```bash
 bundle install
-bundle exec rspec       # 278 examples, 0 failures
+bundle exec rspec       # 0 failures
 bundle exec rubocop -A  # auto-fix
 bundle exec rubocop     # lint check
 ```

data/README.md

@@ -2,7 +2,7 @@
 
 MCP (Model Context Protocol) server for the LegionIO framework. Provides semantic tool matching, observation pipeline, context compilation, and tiered behavioral intelligence (Tier 0/1/2 routing).
 
-**Version**: 0.5.5
+**Version**: 0.6.0
 
 Extracted from [LegionIO](https://github.com/LegionIO/LegionIO) for independent versioning and reuse.
 
@@ -32,7 +32,7 @@ Legion::MCP
 ├── PatternStore        # 4-layer degrading storage (L0 memory → L1 cache → L2 SQLite)
 ├── TierRouter          # Confidence-gated tier selection (0/1/2)
 ├── ContextGuard        # Staleness, rapid-fire, anomaly detection
-├── Tools/              # 41 MCP::Tool subclasses (legion.* namespace)
+├── Tools/              # 59 MCP::Tool subclasses (legion.* namespace)
 └── Resources/          # RunnerCatalog, ExtensionInfo
 ```
 
@@ -77,7 +77,7 @@ All persistence wraps in `begin/rescue => nil` — failed writes never block Tie
 
 ## Tools
 
-41 MCP tools in the `legion.*` namespace:
+59 MCP tools in the `legion.*` namespace:
 
 | Tool | Purpose |
 |------|---------|
@@ -97,6 +97,16 @@ All persistence wraps in `begin/rescue => nil` — failed writes never block Tie
 | `legion.rbac_assignments` / `rbac_check` / `rbac_grants` | Access control |
 | `legion.mind_growth_status` / `mind_growth_propose` / `mind_growth_approve` | Cognitive architecture growth |
 | `legion.mind_growth_build_queue` / `mind_growth_cognitive_profile` / `mind_growth_health` | Growth analysis and health |
+| `legion.query_knowledge` | Query Apollo knowledge store |
+| `legion.knowledge_health` | Knowledge store health and quality report |
+| `legion.knowledge_context` | Scoped RAG knowledge retrieval (local/global/all) |
+| `legion.eval_list` / `eval_run` / `eval_results` | Evaluation management |
+| `legion.experiment_results` | A/B experiment result comparison |
+| `legion.dataset_list` / `dataset_show` | Dataset browsing |
+| `legion.prompt_list` / `prompt_show` / `prompt_run` | Prompt template management |
+| `legion.plan_action` | Agentic planning with action decomposition |
+| `legion.ask_peer` / `notify_peer` / `broadcast_peers` / `list_peers` | Agent mesh communication |
+| `legion.mesh_status` | Mesh topology status |
 
 ## Resources
 
@@ -176,7 +186,7 @@ All configuration is optional and read via `Legion::Settings` when available:
 
 ```bash
 bundle install
-bundle exec rspec       # 278 examples, 0 failures
+bundle exec rspec       # 0 failures
 bundle exec rubocop -A  # auto-fix
 bundle exec rubocop     # lint check
 ```

data/lib/legion/mcp/server.rb

@@ -66,6 +66,7 @@ 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 'tools/knowledge_context'
 require_relative 'catalog_bridge'
 require_relative 'resources/runner_catalog'
 require_relative 'resources/extension_info'
@@ -131,7 +132,8 @@ module Legion
         Tools::MindGrowthCognitiveProfile,
         Tools::MindGrowthHealth,
         Tools::QueryKnowledge,
-        Tools::KnowledgeHealth
+        Tools::KnowledgeHealth,
+        Tools::KnowledgeContext
       ].freeze
 
       class << self

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

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Legion
+  module MCP
+    module Tools
+      class KnowledgeContext < ::MCP::Tool
+        tool_name 'legion.knowledge_context'
+        description 'Retrieve knowledge relevant to the current task. Call this when you need context about ' \
+                    'the codebase, architecture, past decisions, or known gotchas.'
+
+        input_schema(
+          properties: {
+            question: { type: 'string',  description: 'What do you need to know?' },
+            scope:    { type: 'string',  description: 'Knowledge scope: local (this node), global (shared), all (merged). Default: all',
+                        enum: %w[local global all] },
+            top_k:    { type: 'integer', description: 'Number of source chunks to retrieve (default 5)' }
+          },
+          required:   %w[question]
+        )
+
+        class << self
+          def call(question:, scope: 'all', top_k: 5)
+            return error_response('lex-knowledge is not available') unless knowledge_available?(scope)
+
+            result = case scope
+                     when 'local'  then query_local(question: question, top_k: top_k)
+                     when 'global' then query_global(question: question, top_k: top_k)
+                     else               query_all(question: question, top_k: top_k)
+                     end
+
+            text_response(result)
+          rescue StandardError => e
+            Legion::Logging.warn("KnowledgeContext#call failed: #{e.message}") if defined?(Legion::Logging)
+            error_response("Knowledge context failed: #{e.message}")
+          end
+
+          private
+
+          def knowledge_available?(scope = 'all')
+            return defined?(Legion::Apollo::Local) || defined?(Legion::Extensions::Knowledge::Runners::Query) if scope == 'local'
+
+            defined?(Legion::Extensions::Knowledge::Runners::Query)
+          end
+
+          def query_global(question:, top_k:)
+            result = Legion::Extensions::Knowledge::Runners::Query.query(
+              question:   question,
+              top_k:      top_k,
+              synthesize: true
+            )
+            result.merge(scope: 'global')
+          end
+
+          def query_local(question:, top_k:)
+            if defined?(Legion::Apollo::Local)
+              result = Legion::Apollo::Local.query(question: question, top_k: top_k)
+              result.merge(scope: 'local')
+            else
+              Legion::Logging.warn('KnowledgeContext: Apollo::Local not available, falling back to global') if defined?(Legion::Logging)
+              query_global(question: question, top_k: top_k)
+            end
+          end
+
+          def query_all(question:, top_k:)
+            global = query_global(question: question, top_k: top_k)
+            return global unless defined?(Legion::Apollo::Local)
+
+            local = Legion::Apollo::Local.query(question: question, top_k: top_k)
+            merge_results(global, local)
+          end
+
+          def merge_results(global, local)
+            global_sources = Array(global[:sources] || global['sources'])
+            local_sources  = Array(local[:sources]  || local['sources'])
+
+            seen        = {}
+            deduped     = []
+            (local_sources + global_sources).each do |src|
+              key = src[:content_hash] || src['content_hash'] || src[:content] || src['content']
+              next if seen[key]
+
+              seen[key] = true
+              deduped << src
+            end
+
+            global_answer = global[:answer] || global['answer']
+            local_answer  = local[:answer]  || local['answer']
+            answer        = global_answer.nil? || global_answer.to_s.empty? ? local_answer : global_answer
+            { answer: answer, sources: deduped, scope: 'all' }
+          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.9'
+    VERSION = '0.6.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-mcp
 version: !ruby/object:Gem::Version
-  version: 0.5.9
+  version: 0.6.0
 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_context.rb
 - lib/legion/mcp/tools/knowledge_health.rb
 - lib/legion/mcp/tools/list_chains.rb
 - lib/legion/mcp/tools/list_extensions.rb