rosett-ai 1.3.3 → 1.5.9

data/lib/rosett_ai/mcp/resources/hooks_resource.rb

@@ -5,6 +5,7 @@
 
 module RosettAi
   module Mcp
+    # MCP resource implementations for data access.
     module Resources
       # MCP resource provider for installed hook scripts.
       #
@@ -14,8 +15,10 @@ module RosettAi
       # @author hugo
       # @author claude
       class HooksResource
+        # @return [String] URI prefix for MCP resource discovery.
         URI_PREFIX = 'rosett-ai://hooks/'
 
+        # @return [Hash] Supported configuration scope names.
         SCOPES = {
           'global' => -> { RosettAi.paths.global_dir.join('hooks') },
           'project' => -> { RosettAi.context.project_root.join('.claude', 'hooks') }

data/lib/rosett_ai/mcp/resources/provenance_resource.rb

@@ -13,7 +13,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class ProvenanceResource
+        # @return [String] URI prefix for MCP resource discovery.
         URI_PREFIX = 'rosett-ai://provenance/'
+        # @return [String] Default provenance data filename.
         PROVENANCE_FILE = '.ai-provenance.yml'
 
         # Lists available provenance resources.

data/lib/rosett_ai/mcp/resources/rules_resource.rb

@@ -14,6 +14,7 @@ module RosettAi
       # @author hugo
       # @author claude
       class RulesResource
+        # @return [String] URI prefix for MCP resource discovery.
         URI_PREFIX = 'rosett-ai://rules/'
 
         # Lists all available compiled rule resources.

data/lib/rosett_ai/mcp/resources/schema_resource.rb

@@ -14,6 +14,7 @@ module RosettAi
       # @author hugo
       # @author claude
       class SchemaResource
+        # @return [String] URI prefix for MCP resource discovery.
         URI_PREFIX = 'rosett-ai://schema/'
 
         # Lists all available schema resources.

data/lib/rosett_ai/mcp/server.rb

@@ -4,6 +4,7 @@
 # Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
 
 module RosettAi
+  # Model Context Protocol server and tool framework.
   module Mcp
     # MCP server for Rosett-AI — exposes validation, compilation, and
     # configuration management as MCP tools, resources, and prompts.
@@ -16,8 +17,11 @@ module RosettAi
     # @author hugo
     # @author claude
     class Server
+      # @return [String] Supported MCP protocol specification version.
       MCP_SPEC_VERSION = '2025-03-26'
+      # @return [Integer] Default port number for the server.
       DEFAULT_PORT = 8484
+      # @return [String] Default hostname for the server.
       DEFAULT_HOST = 'localhost'
 
       attr_reader :security_config
@@ -108,6 +112,8 @@ module RosettAi
 
       def ensure_http_available!
         require 'puma'
+        require 'puma/configuration'
+        require 'puma/launcher'
         require 'rackup'
       rescue LoadError => e
         raise RosettAi::McpError,
@@ -129,7 +135,7 @@ module RosettAi
       def build_rack_app
         server = build_server
         transport = ::MCP::Server::Transports::StreamableHTTPTransport.new(server)
-        app = transport.method(:call)
+        app = ->(env) { transport.handle_request(Rack::Request.new(env)) }
         security = @security_config
 
         Rack::Builder.new do

data/lib/rosett_ai/mcp/settings/trust_manager.rb

@@ -5,6 +5,7 @@
 
 module RosettAi
   module Mcp
+    # MCP server settings and trust management.
     module Settings
       # Manages trust sources for MCP server installation.
       #
@@ -15,7 +16,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class TrustManager
+        # @return [String] Configuration directory path.
         CONFIG_DIR = '.config/rosett-ai/mcp'
+        # @return [String] Filename for user trust configuration.
         USER_TRUST_FILE = 'user_trust.yml'
 
         # @param config_dir [Pathname, nil] override config directory

data/lib/rosett_ai/mcp/tools/adopt_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class AdoptTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_adopt'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Run rai adopt analysis (local structural checks)'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/backup_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class BackupTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_backup'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Create rai configuration backup'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => false,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/behaviour_display_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class BehaviourDisplayTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_behaviour_display'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Display behaviour configuration overview'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/behaviour_list_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class BehaviourListTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_behaviour_list'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'List all rai behaviour configuration files'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,

data/lib/rosett_ai/mcp/tools/behaviour_manage_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class BehaviourManageTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_behaviour_manage'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Add, modify, or delete rai behaviour files'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => false,
           'destructiveHint' => true,
@@ -24,8 +27,10 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Array] Set of permitted action values.
         VALID_ACTIONS = ['add', 'modify', 'delete'].freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/behaviour_show_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class BehaviourShowTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_behaviour_show'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Show details of a specific rai behaviour'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/compile_status_tool.rb

@@ -17,9 +17,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class CompileStatusTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_compile_status'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Show compiled rules staleness — source vs compiled checksums'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -27,6 +30,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/compile_tool.rb

@@ -18,9 +18,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class CompileTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_compile'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Compile rai behaviours to engine-native format'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => false,
           'destructiveHint' => false,
@@ -28,6 +31,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/comply_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class ComplyTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_comply'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Run rosett-ai compliance checks (CRA, license, SPDX headers)'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/config_compile_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class ConfigCompileTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_config_compile'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Compile rai configuration scopes to JSON settings'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => false,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/config_status_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class ConfigStatusTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_config_status'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Show rai configuration and project status'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,

data/lib/rosett_ai/mcp/tools/content_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class ContentTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_content'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'List, install, or update rai content packs'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => false,
           'destructiveHint' => false,
@@ -24,8 +27,10 @@ module RosettAi
           'openWorldHint' => true
         }.freeze
 
+        # @return [Array] Set of permitted action values.
         VALID_ACTIONS = ['list', 'install', 'update'].freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/context_query_tool.rb

@@ -18,9 +18,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class ContextQueryTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_context_query'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Query applicable rules for a file path, tool name, or action'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -28,6 +31,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/design_list_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class DesignListTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_design_list'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'List all rai design documents'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,

data/lib/rosett_ai/mcp/tools/design_show_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class DesignShowTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_design_show'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Show details of a specific rai design document'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/doctor_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class DoctorTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_doctor'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Run rosett-ai diagnostic checks'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,6 +27,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/documentation_status_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class DocumentationStatusTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_documentation_status'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Show rai documentation status'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,

data/lib/rosett_ai/mcp/tools/engines_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class EnginesTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rosett_ai_engines'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'List, detect, or show status of rai engines'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,8 +27,10 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Array] Set of permitted action values.
         VALID_ACTIONS = ['list', 'detect', 'status'].freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/hook_install_tool.rb

@@ -19,9 +19,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class HookInstallTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_hook_install'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Install enforcement hook: generate script, write to disk, register in settings'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => false,
           'destructiveHint' => true,
@@ -29,6 +32,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {
@@ -52,8 +56,11 @@ module RosettAi
           }
         }.freeze
 
+        # @return [String] Subdirectory name for hook scripts.
         HOOK_DIR_NAME = 'hooks'
+        # @return [String] Default filename for generated hook scripts.
         HOOK_FILENAME = 'rai-enforce.rb'
+        # @return [String] File extension appended to backup copies.
         BACKUP_SUFFIX = '.rai-backup'
 
         # Installs the enforcement hook.

data/lib/rosett_ai/mcp/tools/hook_preview_tool.rb

@@ -21,9 +21,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class HookPreviewTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_hook_preview'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Preview generated enforcement hook script (read-only, no side effects)'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -31,6 +34,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {
@@ -88,27 +92,44 @@ module RosettAi
         #
         # @param behaviours [Array<Hash>]
         # @param rule_id [String, nil]
-        # @return [Hash] :rules, :downgraded, :behaviour_name, :behaviour_version
+        # @return [Hash] :rules, :downgraded, :contextual_rules, :behaviour_name,
+        #   :behaviour_version
         def validate_and_collect(behaviours, rule_id)
           validator = Enforcement::Validator.new
           all_rules = []
           all_downgraded = []
+          all_contextual = []
           names = []
 
           behaviours.each do |data|
-            result = validator.validate(data)
-            rules = result[:valid].select { |r| r[:type] == 'enforceable' }
-            rules = rules.select { |r| r[:rule_id] == rule_id } if rule_id
-            all_rules.concat(rules)
-            all_downgraded.concat(result[:downgraded])
+            slices = collect_from_behaviour(validator, data, rule_id)
+            all_rules.concat(slices[:rules])
+            all_downgraded.concat(slices[:downgraded])
+            all_contextual.concat(slices[:contextual])
             names << data['name']
           end
 
           { rules: all_rules, downgraded: all_downgraded,
+            contextual_rules: all_contextual,
             behaviour_name: names.join(', '),
             behaviour_version: behaviours.first&.fetch('version', '0.0.0') || '0.0.0' }
         end
 
+        # Collects validated rules from a single behaviour, returned as slices.
+        #
+        # @param validator [Enforcement::Validator]
+        # @param data [Hash] behaviour data
+        # @param rule_id [String, nil] optional rule filter
+        # @return [Hash] :rules, :downgraded, :contextual arrays
+        def collect_from_behaviour(validator, data, rule_id)
+          result = validator.validate(data)
+          enforceable = result[:valid].select { |r| r[:type] == 'enforceable' }
+          enforceable = enforceable.select { |r| r[:rule_id] == rule_id } if rule_id
+          non_enforceable = result[:valid].reject { |r| r[:type] == 'enforceable' }
+          { rules: enforceable, downgraded: result[:downgraded],
+            contextual: result[:skipped] + non_enforceable }
+        end
+
         # Generates the hook script via HookGenerator.
         #
         # @param validated [Hash]
@@ -118,7 +139,8 @@ module RosettAi
           generator.generate(
             validated[:rules],
             behaviour_name: validated[:behaviour_name],
-            behaviour_version: validated[:behaviour_version]
+            behaviour_version: validated[:behaviour_version],
+            contextual_rules: validated[:contextual_rules]
           )
         end
 
@@ -127,12 +149,15 @@ module RosettAi
         # @param scope [String, nil]
         # @return [Hash]
         def build_response(script, validated, scope)
+          contextual = validated[:contextual_rules] || []
           response = {
             script: script,
             rules_count: validated[:rules].size,
             behaviours: validated[:rules].map { |r| r[:behaviour] }.uniq,
             scope: scope || 'global',
-            preview_only: true
+            preview_only: true,
+            contextual_count: contextual.size,
+            contextual_rules: contextual
           }
           response[:downgraded] = validated[:downgraded] unless validated[:downgraded].empty?
           response

data/lib/rosett_ai/mcp/tools/hooks_status_tool.rb

@@ -14,9 +14,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class HooksStatusTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_hooks_status'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Show git hooks list and installation status'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => true,
           'destructiveHint' => false,
@@ -24,8 +27,10 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Array] Set of permitted action values.
         VALID_ACTIONS = ['list', 'status'].freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {

data/lib/rosett_ai/mcp/tools/init_tool.rb

@@ -5,6 +5,7 @@
 
 module RosettAi
   module Mcp
+    # MCP tool implementations exposing raictl functionality.
     module Tools
       # MCP tool: initialize rosett-ai structure.
       #
@@ -14,9 +15,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class InitTool
+        # @return [String] MCP tool identifier string.
         TOOL_NAME = 'rai_init'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Initialize rosett-ai directory structure (global, local, or project)'
 
+        # @return [Hash] MCP protocol annotations describing tool capabilities.
         ANNOTATIONS = {
           'readOnlyHint' => false,
           'destructiveHint' => false,
@@ -24,6 +28,7 @@ module RosettAi
           'openWorldHint' => false
         }.freeze
 
+        # @return [Hash] JSON Schema defining the tool input parameters.
         INPUT_SCHEMA = {
           type: 'object',
           properties: {