aia 1.1.0 → 2.0.0.0.pre.alpha

data/lib/aia/config/cli_parser.rb

@@ -11,6 +11,7 @@ require_relative 'model_spec'
 require_relative '../skill_utils'
 
 module AIA
+  # rubocop:disable Metrics/ModuleLength
   module CLIParser
     class << self
       # Parse CLI arguments and return a hash of overrides
@@ -23,8 +24,8 @@ module AIA
           parser = create_option_parser(options)
           parser.parse!
         rescue OptionParser::InvalidOption, OptionParser::MissingArgument => e
-          warn "ERROR: #{e.message}"
-          warn "       use --help for usage report"
+          $stderr.puts "ERROR: #{e.message}"
+          $stderr.puts "       use --help for usage report"
           exit 1
         end
 
@@ -51,8 +52,8 @@ module AIA
       end
 
       def setup_banner(opts)
-        opts.banner = "Usage: aia [options] [PROMPT_ID] [CONTEXT_FILE]*\n" +
-                      "       aia [options] --chat [PROMPT_ID] [CONTEXT_FILE]*"
+        opts.banner = "Usage: aia [options] [PROMPT_ID] [CONTEXT_FILE]*\n       " \
+                      "aia [options] --chat [PROMPT_ID] [CONTEXT_FILE]*"
       end
 
       def setup_mode_options(opts, options)
@@ -64,14 +65,34 @@ module AIA
 
         opts.on("-f", "--fuzzy", "Use fuzzy matching for prompt search") do
           unless system("which fzf > /dev/null 2>&1")
-            warn "Error: 'fzf' is not installed. Please install 'fzf' to use the --fuzzy option."
+            $stderr.puts "Error: 'fzf' is not installed. Please install 'fzf' to use the --fuzzy option."
             exit 1
           end
           options[:fuzzy] = true
         end
 
-        opts.on("--terse", "[DEPRECATED] No longer supported") do
-          warn "Warning: --terse is deprecated and has no effect."
+        opts.on("--expert-routing", "Route each prompt to a specialist robot based on domain classification") do
+          options[:expert_routing] = true
+        end
+
+        opts.on("--track-pipeline", "Track pipeline execution in TrakFlow") do
+          options[:track_pipeline] = true
+        end
+
+        opts.on("--concurrent-auto", "Automatically parallelize independent MCP servers") do
+          options[:concurrent_auto] = true
+        end
+
+        opts.on("-A", "--[no-]auto-tool-filter", "Use TF-IDF similarity-based tool filtering (default: on)") do |v|
+          options[:auto_tool_filter] = v
+        end
+
+        opts.on("--load", "Load persisted tool filter databases from ~/.config/aia/") do
+          options[:tool_filter_load] = true
+        end
+
+        opts.on("--save", "Save tool filter databases to ~/.config/aia/") do
+          options[:tool_filter_save] = true
         end
       end
 
@@ -82,8 +103,10 @@ module AIA
           list_available_models(query)
         end
 
-        opts.on("-m MODEL", "--model MODEL", "Set LLM model(s) to use. Format: MODEL[=ROLE][,MODEL[=ROLE]]...") do |model_string|
-          options[:models] = parse_models_with_roles(model_string)
+        opts.on("-m MODEL", "--model MODEL",
+                "Set LLM model(s). Format: MODEL[=ROLE][,MODEL[=ROLE]]... " \
+                "Multiple models run in parallel; use --consensus to synthesize results") do |model_string|
+          options[:models] = (options[:models] || []) + parse_models_with_roles(model_string)
         end
 
         opts.on("--[no-]consensus", "Enable/disable consensus mode for multi-model responses") do |consensus|
@@ -112,13 +135,13 @@ module AIA
         end
 
         opts.on("-o", "--[no-]output [FILE]", "Write response to FILE (default: temp.md; --no-output to disable)") do |file|
-          if file == false
-            options[:output] = nil
-          elsif file.nil?
-            options[:output] = 'temp.md'
-          else
-            options[:output] = File.expand_path(file, Dir.pwd)
-          end
+          options[:output] = if file == false
+                               nil
+                             elsif file.nil?
+                               'temp.md'
+                             else
+                               File.expand_path(file, Dir.pwd)
+                             end
         end
 
         opts.on("-a", "--[no-]append", "Append to output file instead of overwriting") do |append|
@@ -141,6 +164,10 @@ module AIA
           options[:prompts_dir] = dir
         end
 
+        opts.on("--plugins-dir DIR", "Set directory containing AIA plugin files") do |dir|
+          options[:plugins_dir] = dir
+        end
+
         opts.on("--roles-prefix PREFIX", "Set subdirectory name for role files (default: roles)") do |prefix|
           options[:roles_prefix] = prefix
         end
@@ -149,6 +176,19 @@ module AIA
           options[:role] = role
         end
 
+        opts.on("--skills-dir DIR", "Set directory containing skill subdirectories") do |dir|
+          options[:skills_dir] = dir
+        end
+
+        opts.on("-s", "--skill SKILL_IDS", "Append skill(s) to prompt; comma-separated IDs or paths") do |skill_ids|
+          options[:skills] ||= []
+          options[:skills] += skill_ids.split(',').map(&:strip).reject(&:empty?)
+        end
+
+        opts.on("--list-skills", "List available skills and exit") do
+          options[:list_skills] = true
+        end
+
         opts.on("-n", "--next PROMPT_ID", "Set next prompt to process") do |next_prompt|
           options[:pipeline] ||= []
           options[:pipeline] << next_prompt
@@ -159,32 +199,9 @@ module AIA
           options[:pipeline] += pipeline.split(',').map(&:strip)
         end
 
-
         opts.on("--system-prompt PROMPT_ID", "Set system prompt for chat sessions") do |prompt_id|
           options[:system_prompt] = prompt_id
         end
-
-        opts.on('--regex PATTERN', '[DEPRECATED] Parameter regex (PM v1.0.0 uses ERB parameters)') do |pattern|
-          warn "Warning: --regex is deprecated. PM v1.0.0 uses ERB parameters (<%= param %>)."
-          options[:parameter_regex] = pattern
-        end
-
-        opts.on("--skills-dir DIR", "Set directory containing skill subdirectories") do |dir|
-          options[:skills_dir] = dir
-        end
-
-        opts.on("--skills-prefix PREFIX", "Set subdirectory name for skill files (default: skills)") do |prefix|
-          options[:skills_prefix] = prefix
-        end
-
-        opts.on("-s", "--skill SKILL_IDS", "Prepend skill(s) to prompt (comma-separated IDs or paths)") do |ids|
-          options[:skills] ||= []
-          options[:skills] += ids.split(',').map(&:strip)
-        end
-
-        opts.on("--list-skills", "List available skills and exit") do
-          options[:list_skills] = true
-        end
       end
 
       def setup_ai_parameters(opts, options)
@@ -194,7 +211,7 @@ module AIA
           options[:temperature] = temp
         end
 
-        opts.on("--max-tokens TOKENS", Integer, "Set maximum tokens for text generation (default: 2048)") do |tokens|
+        opts.on("--max-tokens TOKENS", Integer, "Set maximum tokens for text generation (default: 32767)") do |tokens|
           options[:max_tokens] = tokens
         end
 
@@ -218,10 +235,22 @@ module AIA
           options[:speak] = true
         end
 
-        opts.on("--voice VOICE", "Set voice for speech output (default: alloy)") do |voice|
+        opts.on("--voice VOICE", "Set voice for speech output") do |voice|
           options[:voice] = voice
         end
 
+        opts.on("--speak-command CMD", "Command used for TTS (default: say)") do |cmd|
+          options[:speak_command] = cmd
+        end
+
+        opts.on("--paint", "Generate an image from the prompt instead of a text response") do
+          options[:paint] = true
+        end
+
+        opts.on("--im", "--image-model MODEL", "Set image model for generation (default: dall-e-3)") do |model|
+          options[:image_model] = model
+        end
+
         opts.on("--is", "--image-size SIZE", "Set image size for generation (default: 1024x1024)") do |size|
           options[:image_size] = size
         end
@@ -238,6 +267,10 @@ module AIA
       def setup_tool_options(opts, options)
         opts.separator "\nTool & Extension Options:"
 
+        opts.on('--allow-ruby-eval', 'Enable /ruby directive (executes arbitrary Ruby code with full process privileges)') do
+          options[:allow_ruby_eval] = true
+        end
+
         opts.on("--rq LIBS", "--require LIBS", "Require Ruby libraries for Ruby directive") do |libs|
           options[:require_libs] ||= []
           options[:require_libs] += libs.split(',')
@@ -264,11 +297,17 @@ module AIA
 
       def setup_utility_options(opts, options)
         opts.separator "\nUtility Options:"
+        setup_logging_options(opts, options)
+        setup_output_options(opts, options)
+        setup_mcp_options(opts, options)
+        setup_meta_options(opts, options)
+      end
 
+      def setup_logging_options(opts, options)
         opts.on("--log-level LEVEL", "Set log level (debug|info|warn|error|fatal)") do |level|
           level = level.downcase
           unless %w[debug info warn error fatal].include?(level)
-            warn "ERROR: Invalid log level '#{level}'. Must be one of: debug, info, warn, error, fatal"
+            $stderr.puts "ERROR: Invalid log level '#{level}'. Must be one of: debug, info, warn, error, fatal"
             exit 1
           end
           options[:log_level_override] = level
@@ -296,6 +335,21 @@ module AIA
         opts.on("-v", "--[no-]verbose", "Enable verbose output") do |value|
           options[:verbose] = value
         end
+      end
+
+      def setup_output_options(opts, options)
+        opts.on("--[no-]thinking", "Show raw thinking/reasoning blocks in output (default: off)") do |v|
+          options[:thinking] = v
+        end
+
+        opts.on("--tokens", "Display token usage and elapsed response time after each turn") do
+          options[:tokens] = true
+        end
+
+        opts.on("--cost", "Display cost calculations and elapsed time (implies --tokens)") do
+          options[:cost] = true
+          options[:tokens] = true
+        end
 
         opts.on("--refresh DAYS", Integer, "Set refresh interval (days) for cached models list (default: 7)") do |days|
           options[:refresh] = days || 0
@@ -308,16 +362,9 @@ module AIA
         opts.on("--completion SHELL", "Generate shell completion script (bash|zsh|fish) and exit") do |shell|
           options[:completion] = shell
         end
+      end
 
-        opts.on("--tokens", "Display token usage") do
-          options[:tokens] = true
-        end
-
-        opts.on("--cost", "Display cost calculations (implies --tokens)") do
-          options[:cost] = true
-          options[:tokens] = true  # --cost implies --tokens
-        end
-
+      def setup_mcp_options(opts, options)
         opts.on("--mcp FILE", "Load MCP server(s) from JSON file (repeatable)") do |file|
           options[:mcp_files] ||= []
           options[:mcp_files] << file
@@ -340,47 +387,55 @@ module AIA
           options[:mcp_skip] ||= []
           options[:mcp_skip] += names.split(',').map(&:strip)
         end
+      end
 
+      def setup_meta_options(opts, _options)
         opts.on("--version", "Show version and exit") do
           puts AIA::VERSION
           exit
         end
 
         opts.on("-h", "--help", "Show this help and exit") do
-          puts <<~HELP
-
-            AIA - Your AI Assistant (v#{AIA::VERSION})
-              - Manage AI prompts with embedded directives
-              - Integrate with shell and Ruby (ERB) processing
-              - Run batch processes and prompt pipelines
-              - Engage in interactive chat sessions
-              - Use custom tools and MCP servers
-
-          HELP
-
-          puts opts
-
-          puts <<~EXTRA
-
-            Explore Further:
-            - AIA GitHub Repository: https://github.com/MadBomber/aia
-            - AIA Documentation:     https://madbomber.github.io/aia
-            - AIA Changelog:         https://github.com/MadBomber/aia/blob/main/CHANGELOG.md
-            - AIA Examples:          https://github.com/MadBomber/aia/tree/main/examples
-            - Report an Issue:       https://github.com/MadBomber/aia/issues
-            - RubyLLM Documentation: https://rubyllm.com
-            - RubyLLM Tool Docs:     https://rubyllm.com/guides/tools
-            - PromptManager Docs:    https://madbomber.github.io/prompt_manager
-            - ERB Documentation:     https://docs.ruby-lang.org/en/master/ERB.html
-            - MCP Specification:     https://modelcontextprotocol.io
-            - MCP Client Docs:       https://github.com/patvice/ruby_llm-mcp/blob/main/README.md
-
-          EXTRA
-
+          print_help(opts)
           exit
         end
       end
 
+      def print_help(opts)
+        puts <<~HELP
+
+          AIA - Your AI Assistant (v#{AIA::VERSION})
+            - Manage AI prompts with embedded directives
+            - Integrate with shell and Ruby (ERB) processing
+            - Run batch processes and prompt pipelines
+            - Engage in interactive chat sessions
+            - Use custom tools and MCP servers
+            - Compare the same prompt across multiple models (--model m1,m2,m3 [--consensus])
+            - Measure response time and token usage with --tokens; add cost with --cost
+            - Benchmark concurrent vs. serial performance (/decompose reports speedup metrics)
+
+        HELP
+
+        puts opts
+
+        puts <<~EXTRA
+
+          Explore Further:
+          - AIA GitHub Repository: https://github.com/MadBomber/aia
+          - AIA Documentation:     https://madbomber.github.io/aia
+          - AIA Changelog:         https://github.com/MadBomber/aia/blob/main/CHANGELOG.md
+          - AIA Examples:          https://github.com/MadBomber/aia/tree/main/examples
+          - Report an Issue:       https://github.com/MadBomber/aia/issues
+          - RubyLLM Documentation: https://rubyllm.com
+          - RubyLLM Tool Docs:     https://rubyllm.com/guides/tools
+          - PromptManager Docs:    https://madbomber.github.io/prompt_manager
+          - ERB Documentation:     https://docs.ruby-lang.org/en/master/ERB.html
+          - MCP Specification:     https://modelcontextprotocol.io
+          - MCP Client Docs:       https://github.com/patvice/ruby_llm-mcp/blob/main/README.md
+
+        EXTRA
+      end
+
       # Parse model string into array of ModelSpec-compatible hashes
       #
       # @param model_string [String] comma-separated models with optional roles
@@ -389,6 +444,7 @@ module AIA
         models = []
         model_counts = Hash.new(0)
 
+        # rubocop:disable Metrics/BlockLength
         model_string.split(',').each do |spec|
           spec.strip!
 
@@ -424,6 +480,7 @@ module AIA
             }
           end
         end
+        # rubocop:enable Metrics/BlockLength
 
         models
       end
@@ -433,10 +490,11 @@ module AIA
           expanded = File.expand_path(role_id)
           expanded += '.md' if File.extname(expanded).empty?
           raise ArgumentError, "Role file not found: #{expanded}" unless File.exist?(expanded)
+
           return
         end
 
-        prompts_dir = ENV.fetch('AIA_PROMPTS__DIR', File.join(ENV['HOME'], '.prompts'))
+        prompts_dir = ENV.fetch('AIA_PROMPTS__DIR', File.join(Dir.home, '.prompts'))
         roles_prefix = ENV.fetch('AIA_PROMPTS__ROLES_PREFIX', 'roles')
 
         unless role_id.start_with?(roles_prefix)
@@ -445,26 +503,25 @@ module AIA
 
         role_file_path = File.join(prompts_dir, "#{role_id}.md")
 
-        unless File.exist?(role_file_path)
-          available_roles = list_available_role_names(prompts_dir, roles_prefix)
-
-          error_msg = "Role file not found: #{role_file_path}\n\n"
+        return if File.exist?(role_file_path)
+        available_roles = list_available_role_names(prompts_dir, roles_prefix)
 
-          if available_roles.empty?
-            error_msg += "No roles directory found at #{File.join(prompts_dir, roles_prefix)}\n"
-            error_msg += "Create the directory and add role files to use this feature."
-          else
-            error_msg += "Available roles:\n"
-            error_msg += available_roles.map { |r| "  - #{r}" }.join("\n")
-            error_msg += "\n\nCreate the role file or use an existing role."
-          end
+        error_msg = "Role file not found: #{role_file_path}\n\n"
 
-          raise ArgumentError, error_msg
+        if available_roles.empty?
+          error_msg += "No roles directory found at #{File.join(prompts_dir, roles_prefix)}\n"
+          error_msg += "Create the directory and add role files to use this feature."
+        else
+          error_msg += "Available roles:\n"
+          error_msg += available_roles.map { |r| "  - #{r}" }.join("\n")
+          error_msg += "\n\nCreate the role file or use an existing role."
         end
+
+        raise ArgumentError, error_msg
       end
 
       def list_available_roles
-        prompts_dir = ENV.fetch('AIA_PROMPTS__DIR', File.join(ENV['HOME'], '.prompts'))
+        prompts_dir = ENV.fetch('AIA_PROMPTS__DIR', File.join(Dir.home, '.prompts'))
         roles_prefix = ENV.fetch('AIA_PROMPTS__ROLES_PREFIX', 'roles')
         roles_dir = File.join(prompts_dir, roles_prefix)
 
@@ -484,13 +541,16 @@ module AIA
 
         roles.each do |role_id|
           role_file = File.join(roles_dir, "#{role_id}.md")
-          fm = AIA::SkillUtils.parse_front_matter(role_file)
+          front_matter = AIA::SkillUtils.parse_front_matter(role_file)
 
           puts "## #{role_id}"
           puts
           puts "| Key | Value |"
           puts "|-----|-------|"
-          fm.each { |key, value| puts "| #{key} | #{value} |" }
+          front_matter.each do |key, value|
+            safe_value = value.to_s.gsub('|', '\\|')
+            puts "| #{key} | #{safe_value} |"
+          end
           puts
         end
       end
@@ -500,19 +560,21 @@ module AIA
         return [] unless Dir.exist?(roles_dir)
 
         Dir.glob("**/*.md", base: roles_dir)
-          .map { |f| f.chomp('.md') }
-          .reject { |f| f.split('/').any? { |part| part.start_with?('_') } }
-          .sort
+           .map { |f| f.chomp('.md') }
+           .reject { |f| f.split('/').any? { |part| part.start_with?('_') } }
+           .sort
       end
 
+      # rubocop:disable Metrics/AbcSize
       def list_available_models(query)
         require 'ruby_llm'
 
-        if query.nil?
-          query = []
-        else
-          query = query.split(',')
-        end
+        query = if query.nil?
+                  []
+                else
+                  query.split(',')
+                end
+        # rubocop:enable Metrics/AbcSize
 
         header = "\nAvailable LLMs"
         header += " for #{query.join(' and ')}" if query.any?
@@ -546,28 +608,29 @@ module AIA
           end
         end
 
-        puts if counter > 0
+        puts if counter.positive?
         puts "#{counter} LLMs matching your query"
         puts
 
         exit
       end
+      # rubocop:enable Metrics/ModuleLength
 
       def process_tools_paths(path_list)
         paths = []
 
         if path_list.empty?
-          warn "No list of paths for --tools option"
+          $stderr.puts "No list of paths for --tools option"
           exit 1
         end
 
         path_list.split(',').map(&:strip).uniq.each do |a_path|
           if File.exist?(a_path)
             if File.file?(a_path)
-              if '.rb' == File.extname(a_path)
+              if File.extname(a_path) == '.rb'
                 paths << a_path
               else
-                warn "file should have *.rb extension: #{a_path}"
+                $stderr.puts "file should have *.rb extension: #{a_path}"
                 exit 1
               end
             elsif File.directory?(a_path)
@@ -575,7 +638,7 @@ module AIA
               paths += rb_files
             end
           else
-            warn "file/dir path is not valid: #{a_path}"
+            $stderr.puts "file/dir path is not valid: #{a_path}"
             exit 1
           end
         end

data/lib/aia/config/defaults.yml

@@ -1,4 +1,4 @@
-# AIA Configuration Schema and Defaults
+# AIA v2 Configuration Schema and Defaults
 #
 # This file is the SINGLE SOURCE OF TRUTH for AIA configuration.
 # All attributes must be declared here to be recognized.
@@ -28,8 +28,8 @@ defaults:
   # ---------------------------------------------------------------------------
   llm:
     temperature: 0.7
-    max_tokens: 2048
-    top_p: 1.0
+    max_tokens: 32767
+    top_p: ~ # nil by default — some models reject requests with both temperature AND top_p
     frequency_penalty: 0.0
     presence_penalty: 0.0
 
@@ -65,13 +65,11 @@ defaults:
     roles_prefix: roles
     #
     skills: []
-    skills_prefix: skills
     #
     tool: ~
     tools_prefix: tools
     #
     system_prompt: ~
-    parameter_regex: ~
 
   roles:
     dir: ~/.prompts/roles
@@ -96,10 +94,10 @@ defaults:
   # Env: AIA_AUDIO__VOICE, AIA_AUDIO__SPEAK_COMMAND, etc.
   # ---------------------------------------------------------------------------
   audio:
-    voice: alloy
-    speak_command: afplay
-    speech_model: tts-1
-    transcription_model: whisper-1
+    voice: ~
+    speak_command: say
+    speech_model: ~
+    transcription_model: ~
 
   # ---------------------------------------------------------------------------
   # Image Configuration
@@ -145,26 +143,31 @@ defaults:
     tokens: false
     no_mcp: false
     speak: false
-    terse: false  # DEPRECATED: no longer used
     shell: true
     erb: true
     clear: false
     consensus: false
+    track_pipeline: false
+    expert_routing: false
+    auto_tool_filter: true
+    tool_filter_load: false
+    tool_filter_save: false
+    allow_ruby_eval: false
+    paint: false
+    thinking: false
+
+  # ---------------------------------------------------------------------------
+  # Tool Filter Configuration
+  # Access: AIA.config.tool_filter.timeout_s
+  # Env: AIA_TOOL_FILTER__TIMEOUT_S
+  # ---------------------------------------------------------------------------
+  tool_filter:
+    timeout_s: 10
 
   # ---------------------------------------------------------------------------
   # Logger Configuration
   # Access: AIA.config.logger.aia.file, AIA.config.logger.llm.level, etc.
   # Env: AIA_LOGGER__AIA__FILE, AIA_LOGGER__LLM__LEVEL, etc.
-  #
-  # Configures logging for three systems:
-  #   aia: AIA application logging
-  #   llm: RubyLLM gem logging
-  #   mcp: RubyLLM::MCP gem logging
-  #
-  # file: STDOUT, STDERR, or a file path (e.g., ~/.aia/aia.log)
-  #       All three loggers can write to the same file safely.
-  # level: debug, info, warn, error, fatal
-  # flush: true = immediate write (no buffering), false = buffered writes
   # ---------------------------------------------------------------------------
   logger:
     aia:
@@ -190,7 +193,6 @@ defaults:
   # Model Registry Configuration
   # Access: AIA.config.registry.refresh
   # Env: AIA_REGISTRY__REFRESH
-  # Note: last_refresh is derived from models.json file modification time
   # ---------------------------------------------------------------------------
   registry:
     refresh: 7 # days between refreshes (0 = disable periodic refresh)
@@ -204,14 +206,6 @@ defaults:
   # ---------------------------------------------------------------------------
   # MCP Servers Configuration
   # Access: AIA.config.mcp_servers (array of server configs)
-  #
-  # Example:
-  #   mcp_servers:
-  #     - name: my-server
-  #       command: /path/to/server
-  #       args: []
-  #       env: {}
-  #       timeout: 8000
   # ---------------------------------------------------------------------------
   mcp_servers: []
   mcp_use: ~
@@ -219,15 +213,50 @@ defaults:
 
   # ---------------------------------------------------------------------------
   # Paths Configuration
-  # Access: AIA.config.paths.aia_dir, AIA.config.paths.config_file
+  # Access: AIA.config.paths.aia_dir, AIA.config.paths.config_file, AIA.config.paths.plugins_dir
   # Env: AIA_PATHS__AIA_DIR, AIA_PATHS__CONFIG_FILE
-  #
-  # Note: MywayConfig uses XDG Base Directory Specification by default.
-  # User config is loaded from ~/.config/aia/aia.yml
+  # Special-case env: AIA_PLUGINS_DIR
   # ---------------------------------------------------------------------------
   paths:
     aia_dir: ~/.config/aia
     config_file: ~/.config/aia/aia.yml
+    plugins_dir: ~
+
+  # ---------------------------------------------------------------------------
+  # Model Aliases (user-defined aliases override defaults)
+  # Access: AIA.config.model_aliases
+  # ---------------------------------------------------------------------------
+  model_aliases: {}
+
+  # ---------------------------------------------------------------------------
+  # Model Switch History Mode
+  # Controls conversation history transfer when switching models mid-chat.
+  # Values: clean (fresh start), replay (replay messages), summarize (summary)
+  # Access: AIA.config.model_switch_history
+  # ---------------------------------------------------------------------------
+  model_switch_history: clean
+
+  # ---------------------------------------------------------------------------
+  # Concurrency Configuration
+  # Controls automatic MCP server parallelization.
+  # Access: AIA.config.concurrency.auto, etc.
+  # ---------------------------------------------------------------------------
+  concurrency:
+    auto: false
+    independent_servers: []
+    threshold: 2
+    mcp_timeout: 120
+
+  # ---------------------------------------------------------------------------
+  # Rules Configuration (Enhanced Multi-KB in v2)
+  # Access: AIA.config.rules.dir, AIA.config.rules.enabled, etc.
+  # Env: AIA_RULES__DIR, AIA_RULES__ENABLED
+  # ---------------------------------------------------------------------------
+  rules:
+    dir: ~/.config/aia/rules
+    enabled: true
+    store: memory
+    db_path: ~/.config/aia/rules.db
 
   # ---------------------------------------------------------------------------
   # Context Files (set at runtime)