rosett-ai 1.3.3 → 1.5.9

data/lib/rosett_ai/init/file_copier.rb

@@ -6,11 +6,16 @@
 require 'fileutils'
 
 module RosettAi
+  # Project and global directory initialization.
   module Init
     # Helper module for copying files during initialization
     module FileCopier
       module_function
 
+      # Copy global assets to the ~/.claude/ directory.
+      #
+      # @param base_dir [String] the target base directory
+      # @return [Array<String>] list of copied file names
       def copy_global_assets(base_dir)
         root = RosettAi.root
         copied = []
@@ -25,6 +30,10 @@ module RosettAi
         copied
       end
 
+      # Copy local assets to the project .claude/ directory.
+      #
+      # @param base_dir [String] the target base directory
+      # @return [Array<String>] list of copied file names
       def copy_local_assets(base_dir)
         copied = []
         # Local scope copies to .claude/conf/ (not XDG)
@@ -32,6 +41,12 @@ module RosettAi
         copied
       end
 
+      # Copy configuration assets (behaviours, schemas) to the target.
+      #
+      # @param source_root [Pathname] the source root directory
+      # @param conf_base [String] the target configuration directory
+      # @param copied [Array<String>] accumulator for copied file names
+      # @return [void]
       def copy_conf_assets(source_root, conf_base, copied)
         FileUtils.mkdir_p(File.join(conf_base, 'behaviour'))
         FileUtils.mkdir_p(File.join(conf_base, 'schemas'))
@@ -45,6 +60,13 @@ module RosettAi
                     copied, 'conf/adopt_redactions.yml')
       end
 
+      # Copy a single file to the target path.
+      #
+      # @param source [Pathname, String] source file path
+      # @param target [String] target file path
+      # @param copied [Array<String>] accumulator for copied file names
+      # @param name [String] display name for the copied file
+      # @return [void]
       def copy_single_file(source, target, copied, name)
         return if File.exist?(target) || !File.exist?(source)
 
@@ -52,6 +74,13 @@ module RosettAi
         copied << name
       end
 
+      # Copy an executable file preserving permissions.
+      #
+      # @param source [Pathname, String] source file path
+      # @param target [String] target file path
+      # @param copied [Array<String>] accumulator for copied file names
+      # @param name [String] display name for the copied file
+      # @return [void]
       def copy_executable(source, target, copied, name)
         return unless File.exist?(source)
 
@@ -60,6 +89,13 @@ module RosettAi
         copied << name
       end
 
+      # Recursively copy a directory tree to the target.
+      #
+      # @param source [Pathname, String] source directory path
+      # @param target [String] target directory path
+      # @param copied [Array<String>] accumulator for copied file names
+      # @param name [String] display name for the copied directory
+      # @return [void]
       def copy_directory(source, target, copied, name)
         return unless Dir.exist?(source)
 
@@ -67,6 +103,14 @@ module RosettAi
         copied << name
       end
 
+      # Copy files matching a glob pattern to the target directory.
+      #
+      # @param source_dir [Pathname, String] source directory to glob
+      # @param target_dir [String] target directory path
+      # @param pattern [String] glob pattern (e.g. '*.yml')
+      # @param prefix [String] display prefix for copied file names
+      # @param copied [Array<String>] accumulator for copied file names
+      # @return [void]
       def copy_glob_files(source_dir, target_dir, pattern, prefix, copied)
         return unless Dir.exist?(source_dir)
 
@@ -84,6 +128,13 @@ module RosettAi
         end
       end
 
+      # Copy a file only if the target does not already exist.
+      #
+      # @param source [Pathname, String] source file path
+      # @param target [String] target file path
+      # @param copied [Array<String>] accumulator for copied file names
+      # @param name [String] display name for the copied file
+      # @return [void]
       def copy_if_new(source, target, copied, name)
         return unless File.exist?(source) && !File.exist?(target)
 

data/lib/rosett_ai/init/mcp_registrar.rb

@@ -18,6 +18,7 @@ module RosettAi
     # @author hugo
     # @author claude
     class McpRegistrar
+      # @return [String] MCP server name used in Claude Code settings.
       MCP_SERVER_NAME = 'rosett-ai'
 
       # @param settings_path [String] path to Claude Code settings.json

data/lib/rosett_ai/init/project_initializer.rb

@@ -14,6 +14,7 @@ module RosettAi
     # @author hugo
     # @author claude
     class ProjectInitializer
+      # @return [String] Default project directory name.
       PROJECT_DIR = '.rosett-ai'
 
       # Sets up the .rosett-ai/ project directory structure.

data/lib/rosett_ai/licensing/license_key.rb

@@ -15,9 +15,13 @@ module RosettAi
     # only verify signatures, not forge them.  The private signing key
     # is held server-side and NEVER distributed.
     class LicenseKey
+      # @return [String] Hex-encoded public key for license verification.
       PUBLIC_KEY_HEX = '91f54336c0d42a7c88642b8d7f8bacab3adba4a4d633a33002fc15f676bfd8f0'
+      # @return [String] Prefix for rosett-ai license key strings.
       RAI_PREFIX = 'NNCC-'
+      # @return [Integer] Days of grace period after license expiry.
       GRACE_PERIOD_DAYS = 14
+      # @return [Integer] Days of offline operation before license revalidation.
       OFFLINE_GRACE_DAYS = 30
 
       attr_reader :claims

data/lib/rosett_ai/licensing/license_store.rb

@@ -8,15 +8,23 @@ module RosettAi
     # Persists the license key at ~/.config/rosett-ai/license.key with
     # strict file permissions (0600, owned by current uid).
     class LicenseStore
+      # @return [Object] File permission mode for secure files.
       SAFE_FILE_MODE = 0o600
+      # @return [Object] Directory permission mode for secure directories.
       SAFE_DIR_MODE = 0o700
 
+      # Save the license key to persistent storage.
+      #
+      # @param raw_key [Object] the raw key
+      # @return [void]
       def save(raw_key)
         ensure_parent_directory!
         File.write(license_path.to_s, raw_key, mode: 'w', perm: SAFE_FILE_MODE)
         validate_permissions!
       end
 
+      # Load the license key from persistent storage.
+      # @return [LicenseKey, nil]
       def load
         return nil unless exists?
 
@@ -24,6 +32,9 @@ module RosettAi
         File.read(license_path.to_s).chomp
       end
 
+      # Remove the stored license key file.
+      #
+      # @return [void]
       def remove!
         File.delete(license_path.to_s) if exists?
       end

data/lib/rosett_ai/licensing/tier.rb

@@ -4,6 +4,7 @@
 # Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
 
 module RosettAi
+  # License key management and tier enforcement.
   module Licensing
     # Represents a license tier with comparable ordering.
     #
@@ -12,7 +13,9 @@ module RosettAi
     class Tier
       include Comparable
 
+      # @return [Hash] Ordered tier hierarchy from lowest to highest.
       HIERARCHY = { community: 0, supporter: 1, subscriber: 2, enterprise: 3 }.freeze
+      # @return [Object] Human-readable names for each tier.
       NAMES = HIERARCHY.keys.freeze
 
       attr_reader :name, :level
@@ -25,6 +28,10 @@ module RosettAi
         @level = HIERARCHY[sym]
       end
 
+      # Compare tier levels for sorting.
+      #
+      # @param other [Tier] the other tier to compare
+      # @return [Integer] -1, 0, or 1
       def <=>(other)
         level <=> other.level
       end
@@ -34,6 +41,8 @@ module RosettAi
         self >= other
       end
 
+      # Return the human-readable tier name.
+      # @return [String]
       def to_s
         name.to_s.capitalize
       end

data/lib/rosett_ai/mcp/admin/auditor.rb

@@ -5,6 +5,7 @@
 
 module RosettAi
   module Mcp
+    # MCP server administration: audit, health, registry.
     module Admin
       # Compliance auditor for MCP server configurations.
       #

data/lib/rosett_ai/mcp/admin/health_checker.rb

@@ -14,6 +14,7 @@ module RosettAi
       # @author hugo
       # @author claude
       class HealthChecker
+        # @return [Integer] Default timeout in seconds.
         DEFAULT_TIMEOUT = 5
 
         # @param timeout [Integer] maximum seconds per health check

data/lib/rosett_ai/mcp/admin/registry.rb

@@ -14,6 +14,7 @@ module RosettAi
       # @author hugo
       # @author claude
       class Registry
+        # @return [String] Configuration directory path.
         CONFIG_DIR = '.config/rosett-ai/mcp/servers'
 
         # @param config_dir [Pathname, nil] override config directory

data/lib/rosett_ai/mcp/enforcement/hook_generator.rb

@@ -34,13 +34,16 @@ module RosettAi
         #   :priority, :description
         # @param behaviour_name [String] source behaviour name
         # @param behaviour_version [String] source behaviour version
+        # @param contextual_rules [Array<Hash>] rules without extractable regex patterns;
+        #   listed in header for visibility but not enforced at hook time
         # @return [String] complete Ruby hook script
-        def generate(rules, behaviour_name:, behaviour_version:)
+        def generate(rules, behaviour_name:, behaviour_version:, contextual_rules: [])
           timestamp = Time.now.utc.iso8601
           parts = []
           parts << shebang_and_magic
           parts << yard_documentation(rules)
-          parts << traceability_header(behaviour_name, behaviour_version, rules, timestamp)
+          parts << traceability_header(behaviour_name, behaviour_version, rules, timestamp,
+                                       contextual_rules)
           parts << ai_client_instructions
           parts << rule_constant(rules)
           parts << enforcement_body
@@ -83,9 +86,11 @@ module RosettAi
         # @param behaviour_version [String]
         # @param rules [Array<Hash>]
         # @param timestamp [String]
+        # @param contextual_rules [Array<Hash>]
         # @return [String]
-        def traceability_header(behaviour_name, behaviour_version, rules, timestamp)
-          <<~RUBY
+        def traceability_header(behaviour_name, behaviour_version, rules, timestamp,
+                                contextual_rules = [])
+          header = <<~RUBY
             # --- Traceability ---
             # Source behaviour: #{behaviour_name}
             # Behaviour version: #{behaviour_version}
@@ -94,6 +99,24 @@ module RosettAi
             # Rule count: #{rules.size}
             # Rule IDs: #{rules.map { |r| r[:rule_id] }.join(', ')}
           RUBY
+          header + contextual_warning(contextual_rules)
+        end
+
+        # Generates a contextual rules warning section for rules that cannot be
+        # regex-enforced. Listed for visibility; not enforced at hook time.
+        #
+        # @param contextual_rules [Array<Hash>]
+        # @return [String]
+        def contextual_warning(contextual_rules)
+          return '' if contextual_rules.empty?
+
+          lines = contextual_rules.map do |r|
+            "#   #{r[:behaviour]}/#{r[:rule_id]} (P#{r[:priority]})"
+          end
+          <<~RUBY
+            # Contextual rules (no regex pattern — human-reviewed only):
+            #{lines.join("\n")}
+          RUBY
         end
 
         # @return [String]

data/lib/rosett_ai/mcp/enforcement/validator.rb

@@ -5,6 +5,7 @@
 
 module RosettAi
   module Mcp
+    # Rule enforcement pipeline for MCP operations.
     module Enforcement
       # Validates enforcement blocks in behaviour rules.
       #
@@ -27,7 +28,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class Validator
+        # @return [Array] Set of permitted type values.
         VALID_TYPES = ['enforceable', 'advisory', 'informational'].freeze
+        # @return [Array] Set of permitted action values.
         VALID_ACTIONS = ['block', 'warn', 'log'].freeze
 
         # Patterns that match everything or nearly everything — unsafe for hooks.
@@ -44,6 +47,8 @@ module RosettAi
           /\A\(\.\+\)\z/    # (.+)
         ].freeze
 
+        # Struct holding rule context for enforcement validation.
+        #
         # @!attribute [r] behaviour
         #   @return [String] behaviour name for error messages
         # @!attribute [r] rule_id
@@ -148,7 +153,7 @@ module RosettAi
         # @param prefix [String] error message prefix
         # @return [Array<String>]
         def check_pattern(pattern, prefix)
-          return ["#{prefix}: pattern missing or empty"] if pattern.nil? || blank?(pattern)
+          return ["#{prefix}: pattern missing or empty"] if blank?(pattern.to_s)
 
           Regexp.new(pattern)
           return ["#{prefix}: pattern '#{pattern}' is degenerate (matches everything)"] if degenerate?(pattern)
@@ -170,17 +175,32 @@ module RosettAi
         end
 
         # Validates the action field.
+        # A nil/absent action is allowed — priority-based default applies.
         #
         # @param action [String, nil]
         # @param prefix [String] error message prefix
         # @return [Array<String>]
         def check_action(action, prefix)
+          return [] if action.to_s.strip.empty?
           return [] if VALID_ACTIONS.include?(action)
 
           allowed = VALID_ACTIONS.join(', ')
           ["#{prefix}: action '#{action}' invalid (must be one of: #{allowed})"]
         end
 
+        # Derives action from priority when none is explicitly set.
+        # Priority >= 80 → block; priority < 80 → warn.
+        #
+        # @param enforcement [Hash]
+        # @param priority [Integer]
+        # @return [String]
+        def derive_action(enforcement, priority)
+          action = enforcement['action'].to_s.strip
+          return action unless action.empty?
+
+          priority.to_i >= 80 ? 'block' : 'warn'
+        end
+
         # Tests whether a string is blank (nil, empty, or whitespace-only).
         #
         # @param value [String]
@@ -204,10 +224,11 @@ module RosettAi
         # @param ctx [RuleContext]
         # @return [Hash]
         def build_valid_entry(rule, enforcement, ctx)
+          priority = rule['priority'] || 0
           { rule_id: ctx.rule_id, behaviour: ctx.behaviour, type: 'enforceable',
             pattern: enforcement['pattern'], applies_to: enforcement['applies_to'],
-            action: enforcement['action'], message: enforcement['message'],
-            priority: rule['priority'] || 0, description: rule['description'].to_s.strip }
+            action: derive_action(enforcement, priority), message: enforcement['message'],
+            priority: priority, description: rule['description'].to_s.strip }
         end
       end
     end

data/lib/rosett_ai/mcp/governance.rb

@@ -13,6 +13,7 @@ module RosettAi
     # @author hugo
     # @author claude
     module Governance
+      # @return [Array] Registered MCP tool implementation classes.
       TOOL_CLASSES = [
         Tools::ValidateTool,
         Tools::CompileTool,
@@ -49,6 +50,7 @@ module RosettAi
         Tools::SchemaGetTool
       ].freeze
 
+      # @return [Array] Registered MCP resource implementation classes.
       RESOURCE_CLASSES = [
         Resources::BehaviourResource,
         Resources::DesignResource,
@@ -59,6 +61,7 @@ module RosettAi
         Resources::HooksResource
       ].freeze
 
+      # @return [Array] Registered MCP prompt implementation classes.
       PROMPT_CLASSES = [
         Prompts::ValidationPrompt,
         Prompts::CompilationPrompt,
@@ -66,6 +69,7 @@ module RosettAi
         Prompts::DiagnosticsPrompt
       ].freeze
 
+      # @return [Array] Parameter types passed as keyword arguments.
       KEYWORD_PARAM_TYPES = [:keyreq, :key].freeze
 
       module_function
@@ -125,6 +129,11 @@ module RosettAi
         end
       end
 
+      # Look up the MCP resource handler for a URI.
+      #
+      # @param resources [Array] registered resource instances
+      # @param uri [String] the resource URI to match
+      # @return [Object, nil] the matching resource, or nil
       def find_resource_for_uri(resources, uri)
         resources.find { |r| resource_matches_uri?(r, uri) }
       end

data/lib/rosett_ai/mcp/http_security_config.rb

@@ -46,6 +46,7 @@ module RosettAi
       class AuthConfig
         attr_accessor :type, :key_source, :keyfile_path, :api_key_env
 
+        # @return [String] Default keyfile name constant.
         DEFAULT_KEYFILE_NAME = 'rosett-ai-mcp-keys.yml'
 
         def initialize
@@ -64,6 +65,10 @@ module RosettAi
           File.exist?(File.expand_path(@keyfile_path)) ? 'keyfile' : 'env'
         end
 
+        # Apply authentication configuration from a hash.
+        #
+        # @param hash [Hash] configuration values
+        # @return [void]
         def apply(hash)
           return unless hash.is_a?(Hash)
 
@@ -84,6 +89,10 @@ module RosettAi
           @key_path = nil
         end
 
+        # Apply TLS configuration from a hash.
+        #
+        # @param hash [Hash] configuration values
+        # @return [void]
         def apply(hash)
           return unless hash.is_a?(Hash)
 
@@ -95,6 +104,7 @@ module RosettAi
 
       # Origin validation sub-configuration.
       class OriginConfig
+        # @return [Array] Default allowed origins for origin validation.
         DEFAULT_ORIGINS = ['http://localhost:*', 'http://127.0.0.1:*'].freeze
 
         attr_accessor :allowed_origins, :strict_mode
@@ -104,6 +114,10 @@ module RosettAi
           @strict_mode = false
         end
 
+        # Apply origin validation configuration from a hash.
+        #
+        # @param hash [Hash] configuration values
+        # @return [void]
         def apply(hash)
           return unless hash.is_a?(Hash)
 
@@ -122,6 +136,10 @@ module RosettAi
           @authenticated_rpm = 300
         end
 
+        # Apply rate limit configuration from a hash.
+        #
+        # @param hash [Hash] configuration values
+        # @return [void]
         def apply(hash)
           return unless hash.is_a?(Hash)
 
@@ -143,6 +161,10 @@ module RosettAi
           @max_age = 86_400
         end
 
+        # Apply CORS configuration from a hash.
+        #
+        # @param hash [Hash] configuration values
+        # @return [void]
         def apply(hash)
           return unless hash.is_a?(Hash)
 

data/lib/rosett_ai/mcp/key_hasher.rb

@@ -16,7 +16,9 @@ module RosettAi
     # @author hugo
     # @author claude
     module KeyHasher
+      # @return [Integer] Number of random bytes used for key salting.
       SALT_BYTES = 16
+      # @return [String] Prefix for hashed API key identifiers.
       KEY_PREFIX = 'nncc_'
 
       module_function
@@ -53,8 +55,8 @@ module RosettAi
 
       # Constant-time string comparison to prevent timing attacks.
       #
-      # @param a [String] first string
-      # @param b [String] second string
+      # @param a_str [String] first string
+      # @param b_str [String] second string
       # @return [Boolean] true if strings match
       def secure_compare(a_str, b_str)
         return false unless a_str.bytesize == b_str.bytesize

data/lib/rosett_ai/mcp/keyfile.rb

@@ -14,9 +14,13 @@ module RosettAi
     # @author hugo
     # @author claude
     class Keyfile
+      # @return [String] Current version of the rosett-ai gem.
       VERSION = '1.0'
+      # @return [Object] Maximum number of permissions per key.
       MAX_PERMISSIONS = 0o600
+      # @return [String] Default filename for the MCP keyfile.
       DEFAULT_FILENAME = 'rosett-ai-mcp-keys.yml'
+      # @return [Integer] Days before expiry to show warnings.
       EXPIRY_WARNING_DAYS = 7
 
       # @param path [String] path to the keyfile

data/lib/rosett_ai/mcp/middleware/cors.rb

@@ -5,6 +5,7 @@
 
 module RosettAi
   module Mcp
+    # HTTP middleware: CORS, rate limiting, origin validation.
     module Middleware
       # Rack middleware for CORS header handling and preflight.
       #
@@ -17,8 +18,11 @@ module RosettAi
         # @param app [#call] the next Rack application
         # @param config [#origins, #methods, #headers, #max_age] CORS config
         DEFAULT_METHODS = ['POST', 'GET', 'DELETE'].freeze
+        # @return [Array] Default CORS headers.
         DEFAULT_HEADERS = ['Content-Type', 'Authorization', 'Accept', 'Mcp-Session-Id'].freeze
+        # @return [Object] Default CORS preflight cache duration in seconds.
         DEFAULT_MAX_AGE = 86_400
+        # @return [Array] Configuration field names for CORS middleware.
         CONFIG_FIELDS = [:origins, :methods, :headers, :max_age].freeze
 
         def initialize(app, config: nil)

data/lib/rosett_ai/mcp/middleware/origin_validation.rb

@@ -15,6 +15,7 @@ module RosettAi
       # @author hugo
       # @author claude
       class OriginValidation
+        # @return [Array] Default allowed origins for origin validation.
         DEFAULT_ORIGINS = ['http://localhost:*', 'http://127.0.0.1:*'].freeze
 
         # @param app [#call] the next Rack application

data/lib/rosett_ai/mcp/middleware/rate_limit.rb

@@ -15,9 +15,12 @@ module RosettAi
       # @author hugo
       # @author claude
       class RateLimit
+        # @return [Integer] Default rate limit for unauthenticated requests per minute.
         DEFAULT_UNAUTH_RPM = 60
+        # @return [Integer] Default rate limit for authenticated requests per minute.
         DEFAULT_AUTH_RPM = 300
         BUCKET_WINDOW = 60 # seconds
+        # @return [Integer] Interval between rate limit bucket cleanup sweeps.
         CLEANUP_INTERVAL = 100
 
         # @param app [#call] the next Rack application

data/lib/rosett_ai/mcp/plugins.rb

@@ -16,6 +16,7 @@ module RosettAi
     # @author hugo
     # @author claude
     module Plugins
+      # @return [Mutex] Mutex for thread-safe plugin registration.
       PLUGIN_MUTEX = Mutex.new
 
       module_function

data/lib/rosett_ai/mcp/prompts/compilation_prompt.rb

@@ -14,7 +14,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class CompilationPrompt
+        # @return [String] MCP prompt identifier string.
         PROMPT_NAME = 'rai_compilation_workflow'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Compile rai behaviours and review output'
 
         # Generates the compilation prompt messages.

data/lib/rosett_ai/mcp/prompts/compliance_prompt.rb

@@ -5,6 +5,7 @@
 
 module RosettAi
   module Mcp
+    # MCP prompt implementations for guided workflows.
     module Prompts
       # MCP prompt: compliance workflow.
       #
@@ -14,7 +15,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class CompliancePrompt
+        # @return [String] MCP prompt identifier string.
         PROMPT_NAME = 'rai_compliance_workflow'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Run compliance checks and interpret results'
 
         # Generates the compliance prompt messages.

data/lib/rosett_ai/mcp/prompts/diagnostics_prompt.rb

@@ -14,7 +14,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class DiagnosticsPrompt
+        # @return [String] MCP prompt identifier string.
         PROMPT_NAME = 'rai_diagnostics_workflow'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Run diagnostics and troubleshoot issues'
 
         # Generates the diagnostics prompt messages.

data/lib/rosett_ai/mcp/prompts/validation_prompt.rb

@@ -14,7 +14,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class ValidationPrompt
+        # @return [String] MCP prompt identifier string.
         PROMPT_NAME = 'rai_validation_workflow'
+        # @return [String] Human-readable description of this tool.
         DESCRIPTION = 'Validate rai configuration and suggest fixes'
 
         # Generates the validation prompt messages.

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

@@ -18,8 +18,10 @@ module RosettAi
       # @author hugo
       # @author claude
       class BehaviourResource
+        # @return [String] URI prefix for MCP resource discovery.
         URI_PREFIX = 'rosett-ai://behaviour/'
 
+        # @return [Hash] Directory names for each configuration tier.
         TIER_DIRS = {
           'project' => -> { RosettAi.conf_root.join('conf', 'behaviour') },
           'xdg' => -> { RosettAi.paths.rai_conf_dir.join('behaviour') },

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

@@ -13,7 +13,9 @@ module RosettAi
       # @author hugo
       # @author claude
       class ConfigResource
+        # @return [String] URI prefix for MCP resource discovery.
         URI_PREFIX = 'rosett-ai://config/'
+        # @return [Array] Supported configuration scope names.
         SCOPES = ['managed', 'user', 'project', 'local'].freeze
 
         # Lists available config resources.

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

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