aia 2.0.0.0.pre.alpha → 2.0.0.0.pre.beta2

data/aia.gemspec

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require_relative 'lib/aia/version'
+
+Gem::Specification.new do |spec|
+  spec.name     = 'aia'
+  spec.version  = AIA::VERSION
+  spec.authors  = ['Dewayne VanHoozer']
+  spec.email    = ['dvanhoozer@gmail.com']
+
+  spec.summary      = 'Multi-model AI CLI with dynamic prompts, consensus responses, shell & Ruby integration, and seamless chat workflows.'
+  spec.description  = <<~DESC
+    AIA is a powerful CLI console application that brings multi-model AI capabilities to your command line, supporting 20+ providers including OpenAI, Anthropic, and Google. Built on robot_lab for robust robot orchestration, AIA v2 provides a thin CLI shell over a rich execution engine. Run multiple AI models simultaneously for comparison, get consensus responses from collaborative AI teams, or compare individual outputs side-by-side. With dynamic prompt management, embedded directives, shell and Ruby integration, interactive chats, and comprehensive history tracking, AIA transforms how you interact with AI.
+  DESC
+
+  spec.homepage     = 'https://github.com/MadBomber/aia'
+  spec.license      = 'MIT'
+
+  spec.required_ruby_version = '>= 4.0.0'
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+
+  spec.metadata['homepage_uri']     = spec.homepage
+  spec.metadata['source_code_uri']  = spec.homepage
+  spec.metadata['changelog_uri']    = spec.homepage
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git Gemfile])
+    end + ['.version']
+  end
+
+  spec.bindir         = 'bin'
+  spec.executables    = %w[aia]
+  spec.require_paths  = %w[lib]
+
+  # Pin bigdecimal to 4.x — Ruby 4 ships it as a default gem, but some transitive
+  # deps declare >= 3.0 which can cause RubyGems to activate 3.x first.
+  spec.add_dependency 'bigdecimal',   '>= 4.0'
+
+  # Core dependencies
+  spec.add_dependency 'robot_lab',    '~> 0.2'                # Execution engine: robots, networks, tools, MCP, memory
+  spec.add_dependency 'myway_config'               # AIA-specific config (CLI settings, prompts, UI)
+  spec.add_dependency 'prompt_manager', '~> 1.0.2' # Prompt parsing/directive DSL
+  spec.add_dependency 'lumberjack', '~> 2.1'       # Structured logging, 3 loggers (aia, llm, mcp); 2.x API (LogFile shift_age/autoflush)
+  spec.add_dependency 'activesupport'              # Required by robot_lab (missing from its gemspec)
+  spec.add_dependency 'simple_flow'
+  spec.add_dependency 'trak_flow'
+
+  # CLI & UI
+  spec.add_dependency 'reline'                     # Interactive chat input with history
+  spec.add_dependency 'tty-screen'                 # Terminal width detection
+  spec.add_dependency 'tty-spinner'                # Loading animation and concurrent MCP connection spinners
+  spec.add_dependency 'tty-table',    '~> 0.12'   # Adaptive terminal-width table rendering for metrics
+  spec.add_dependency 'classifier',  '~> 2.3'     # TF-IDF similarity (Option A tool filtering)
+  spec.add_dependency 'word_wrapper'               # Terminal text wrapping for tool listings
+  spec.add_dependency 'amazing_print'              # Config dump formatting (--dump, /config)
+  spec.add_dependency 'clipboard'                  # System clipboard access (/paste directive)
+
+  # Utilities
+  spec.add_dependency 'faraday'                    # HTTP client for /webpage directive
+  spec.add_dependency 'listen'                     # File-watch for live plugin reload (polling fallback if absent)
+  spec.add_dependency 'shellwords'                 # Shell escaping
+
+  spec.add_development_dependency 'debug_me'
+  spec.add_development_dependency 'minitest'
+  spec.add_development_dependency 'minitest-reporters'
+  spec.add_development_dependency 'mocha'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'simplecov_lcov_formatter'
+  spec.add_development_dependency 'tocer'
+  spec.add_development_dependency 'webmock'
+
+  spec.post_install_message = <<~MSG
+
+    ╔══════════════════════════════════════════════════════════════╗
+    ║               AIA — AI Assistant v2.0                        ║
+    ║                                                              ║
+    ║  v2 is powered by robot_lab for robust orchestration          ║
+    ║  Full CLI backward compatibility with v1                     ║
+    ╚══════════════════════════════════════════════════════════════╝
+
+    Get started:  aia --help
+    Full docs:    https://madbomber.github.io/aia
+
+  MSG
+end

data/config/aia.yml

@@ -0,0 +1,13 @@
+logger:
+  aia:
+    file: ~/.config/aia/logs/aia.log
+    level: info
+    flush: true
+  llm:
+    file: ~/.config/aia/logs/llm.log
+    level: info
+    flush: true
+  mcp:
+    file: ~/.config/aia/logs/mcp.log
+    level: info
+    flush: true

data/lib/aia/chat_loop.rb

@@ -11,8 +11,11 @@ require "reline"
 require "pm"
 
 module AIA
+  # :reek:TooManyInstanceVariables -- interactive-loop hub wires robot, presenter, tracker, routers, and handlers together by design
+  # :reek:TooManyMethods -- one private helper per loop concern (context, metrics, speech, history)
   class ChatLoop
     include ContentExtractor
+    include Speech
 
     def initialize(robot, ui_presenter, directive_processor,
                    session_tracker: nil, alias_registry: nil, filters: {})
@@ -42,6 +45,7 @@ module AIA
     end
 
     # Start the interactive chat session
+    # :reek:BooleanParameter -- lets Session skip re-sending context files after a pipeline; two entry methods would duplicate rescue/ensure
     def start(skip_context_files: false)
       setup_session
       process_initial_context(skip_context_files)
@@ -62,9 +66,10 @@ module AIA
     end
 
     def process_initial_context(skip_context_files)
-      return if skip_context_files || !AIA.config.context_files || AIA.config.context_files.empty?
+      files = AIA.config.context_files
+      return if skip_context_files || !files || files.empty?
 
-      context = AIA.config.context_files.map do |file|
+      context = files.map do |file|
         File.read(file) rescue "Error reading file: #{file}"
       end.join("\n\n")
 
@@ -262,6 +267,7 @@ module AIA
     # Each robot_result.duration holds the elapsed seconds.
     # Similarity scores compare each model's response text against the
     # first model using TF-IDF cosine similarity.
+    # :reek:TooManyStatements -- one pass builds paired metric and similarity arrays; splitting hides the pairing
     def display_network_metrics(flow_result)
       metrics_list = []
       response_texts = []
@@ -337,55 +343,5 @@ module AIA
 
       File.open(out_file, "a") { |f| f.puts "\nYou: #{input}" }
     end
-
-    def speak(content)
-      return unless AIA.speak?
-
-      audio   = AIA.config.audio
-      command = audio.speak_command || 'say'
-      env     = {}
-      env['SPEECH_MODEL'] = audio.speech_model if audio.speech_model
-
-      if command == 'say'
-        # Local TTS: say converts and plays in one step
-        run_with_spinner("Speaking...") do
-          if audio.voice && !audio.voice.to_s.strip.empty?
-            system(env, command, '-v', audio.voice, content.to_s)
-          else
-            system(env, command, content.to_s)
-          end
-        end
-      else
-        # Custom TTS script: stage 2 = convert text → audio file,
-        # stage 3 = play the file. AIA passes the output path as $2.
-        require 'tempfile'
-        tmpfile = Tempfile.new(['aia-tts-', '.mp3'])
-        tmpfile.close
-        begin
-          run_with_spinner("Converting to audio...") do
-            system(env, command, content.to_s, tmpfile.path)
-          end
-          if File.size?(tmpfile.path)
-            run_with_spinner("Speaking...") do
-              system('afplay', tmpfile.path)
-            end
-          end
-        ensure
-          tmpfile.unlink
-        end
-      end
-    rescue StandardError => e
-      $stderr.puts "Warning: Speech failed: #{e.message}"
-    end
-
-    def run_with_spinner(message)
-      spinner = TTY::Spinner.new("[:spinner] #{message}", format: :bouncing_ball, output: $stderr)
-      spinner.auto_spin
-      begin
-        yield
-      ensure
-        spinner.stop
-      end
-    end
   end
 end

data/lib/aia/config/cli_parser.rb

@@ -56,6 +56,7 @@ module AIA
                       "aia [options] --chat [PROMPT_ID] [CONTEXT_FILE]*"
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_mode_options(opts, options)
         opts.separator "\nMode Options:"
 
@@ -96,6 +97,7 @@ module AIA
         end
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_model_options(opts, options)
         opts.separator "\nModel Options:"
 
@@ -127,6 +129,7 @@ module AIA
         end
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_file_options(opts, options)
         opts.separator "\nFile & Output Options:"
 
@@ -157,6 +160,8 @@ module AIA
         end
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
+      # :reek:DuplicateMethodCall -- options[:pipeline] is appended inside two separate OptionParser closures
       def setup_prompt_options(opts, options)
         opts.separator "\nPrompt Options:"
 
@@ -228,6 +233,7 @@ module AIA
         end
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_audio_image_options(opts, options)
         opts.separator "\nAudio & Image Options:"
 
@@ -264,6 +270,7 @@ module AIA
         end
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_tool_options(opts, options)
         opts.separator "\nTool & Extension Options:"
 
@@ -303,6 +310,7 @@ module AIA
         setup_meta_options(opts, options)
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_logging_options(opts, options)
         opts.on("--log-level LEVEL", "Set log level (debug|info|warn|error|fatal)") do |level|
           level = level.downcase
@@ -337,6 +345,7 @@ module AIA
         end
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_output_options(opts, options)
         opts.on("--[no-]thinking", "Show raw thinking/reasoning blocks in output (default: off)") do |v|
           options[:thinking] = v
@@ -364,6 +373,7 @@ module AIA
         end
       end
 
+      # :reek:TooManyStatements -- one opts.on registration per CLI flag; splitting the group would scatter related flags
       def setup_mcp_options(opts, options)
         opts.on("--mcp FILE", "Load MCP server(s) from JSON file (repeatable)") do |file|
           options[:mcp_files] ||= []
@@ -440,11 +450,12 @@ module AIA
       #
       # @param model_string [String] comma-separated models with optional roles
       # @return [Array<Hash>] array of model specs
+      # :reek:TooManyStatements -- one-pass parser over MODEL[=ROLE] specs sharing the instance counter
       def parse_models_with_roles(model_string)
         models = []
         model_counts = Hash.new(0)
 
-        # rubocop:disable Metrics/BlockLength
+        # rubocop:disable-next Metrics/BlockLength
         model_string.split(',').each do |spec|
           spec.strip!
 
@@ -480,46 +491,45 @@ module AIA
             }
           end
         end
-        # rubocop:enable Metrics/BlockLength
 
         models
       end
 
       def validate_role_exists(role_id)
-        if AIA::SkillUtils.path_based_id?(role_id)
-          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 validate_role_path!(role_id) if AIA::SkillUtils.path_based_id?(role_id)
 
-          return
-        end
-
-        prompts_dir = ENV.fetch('AIA_PROMPTS__DIR', File.join(Dir.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)
-          role_id = "#{roles_prefix}/#{role_id}"
-        end
+        role_id      = "#{roles_prefix}/#{role_id}" unless role_id.start_with?(roles_prefix)
 
         role_file_path = File.join(prompts_dir, "#{role_id}.md")
-
         return if 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"
+        raise ArgumentError, role_not_found_message(role_file_path, prompts_dir, roles_prefix)
+      end
+
+      # A path-based role id must resolve to an existing file.
+      def validate_role_path!(role_id)
+        expanded = File.expand_path(role_id)
+        expanded += '.md' if File.extname(expanded).empty?
+        raise ArgumentError, "Role file not found: #{expanded}" unless File.exist?(expanded)
+      end
+
+      def role_not_found_message(role_file_path, prompts_dir, roles_prefix)
+        available_roles = list_available_role_names(prompts_dir, roles_prefix)
+        message = "Role file not found: #{role_file_path}\n\n"
 
         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."
+          message + "No roles directory found at #{File.join(prompts_dir, roles_prefix)}\n" \
+                    "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."
+          message + "Available roles:\n" +
+            available_roles.map { |r| "  - #{r}" }.join("\n") +
+            "\n\nCreate the role file or use an existing role."
         end
-
-        raise ArgumentError, error_msg
       end
 
+      # :reek:TooManyStatements -- sequential terminal report: guards, then a markdown table per role; exits after printing
       def list_available_roles
         prompts_dir = ENV.fetch('AIA_PROMPTS__DIR', File.join(Dir.home, '.prompts'))
         roles_prefix = ENV.fetch('AIA_PROMPTS__ROLES_PREFIX', 'roles')
@@ -565,48 +575,19 @@ module AIA
            .sort
       end
 
-      # rubocop:disable Metrics/AbcSize
+      # :reek:TooManyStatements -- sequential --available-models report: parse query, print matches, summary, exit
       def list_available_models(query)
         require 'ruby_llm'
 
-        query = if query.nil?
-                  []
-                else
-                  query.split(',')
-                end
-        # rubocop:enable Metrics/AbcSize
+        query = query.nil? ? [] : query.split(',')
+        modality_terms, substring_terms = parse_model_query(query)
 
         header = "\nAvailable LLMs"
         header += " for #{query.join(' and ')}" if query.any?
-
         puts header + ':'
         puts
 
-        q1 = query.select { |q| q.include?('_to_') }.map { |q| q[0] == ':' ? q[1..] : q }
-        q2 = query.reject { |q| q.include?('_to_') }
-
-        counter = 0
-
-        RubyLLM.models.all.each do |llm|
-          inputs = llm.modalities.input.join(',')
-          outputs = llm.modalities.output.join(',')
-          entry = "- #{llm.id} (#{llm.provider}) #{inputs} to #{outputs}"
-
-          if query.nil? || query.empty?
-            counter += 1
-            puts entry
-            next
-          end
-
-          show_it = true
-          q1.each { |q| show_it &&= llm.modalities.send("#{q}?") }
-          q2.each { |q| show_it &&= entry.include?(q) }
-
-          if show_it
-            counter += 1
-            puts entry
-          end
-        end
+        counter = print_matching_models(modality_terms, substring_terms)
 
         puts if counter.positive?
         puts "#{counter} LLMs matching your query"
@@ -614,8 +595,36 @@ module AIA
 
         exit
       end
+
+      # Print each matching model entry; returns the number printed.
+      def print_matching_models(modality_terms, substring_terms)
+        RubyLLM.models.all.count do |llm|
+          entry = format_model_entry(llm)
+          visible = model_entry_visible?(llm, entry, modality_terms, substring_terms)
+          puts entry if visible
+          visible
+        end
+      end
+
+      # Split a query into modality terms (e.g. "text_to_text", leading ':'
+      # stripped) and plain substring terms.
+      def parse_model_query(query)
+        modality, substrings = query.partition { |q| q.include?('_to_') }
+        [modality.map { |q| q.delete_prefix(':') }, substrings]
+      end
+
+      def format_model_entry(llm)
+        modalities = llm.modalities
+        "- #{llm.id} (#{llm.provider}) #{modalities.input.join(',')} to #{modalities.output.join(',')}"
+      end
+
+      def model_entry_visible?(llm, entry, modality_terms, substring_terms)
+        modality_terms.all? { |q| llm.modalities.send("#{q}?") } &&
+          substring_terms.all? { |q| entry.include?(q) }
+      end
       # rubocop:enable Metrics/ModuleLength
 
+      # :reek:DuplicateMethodCall -- each `exit 1` terminates a distinct validation failure; there is no value to hoist
       def process_tools_paths(path_list)
         paths = []
 

data/lib/aia/config/mcp_parser.rb

@@ -45,6 +45,7 @@ module AIA
       #
       # @param file_paths [Array<String>] paths to JSON configuration files
       # @return [Array<Hash>] array of server configurations with nested transport
+      # :reek:TooManyStatements -- per-file loop with warn-and-continue handling for missing files, bad JSON, and read errors
       def parse_files(file_paths)
         return [] if file_paths.nil? || file_paths.empty?
 
@@ -93,23 +94,29 @@ module AIA
       # @return [Array<Hash>] array of server configurations
       def convert_mcp_servers_format(mcp_servers)
         mcp_servers.map do |name, config|
-          transport = { type: config['type'] || 'stdio' }
-          transport[:command] = config['command'] if config['command']
-          transport[:args]    = Array(config['args']) if config['args']
-          transport[:env]     = config['env'] if config['env']
-          transport[:url]     = config['url'] if config['url']
-          transport[:headers] = config['headers'] if config['headers']
-
-          server = { name: name, transport: transport }
+          server = { name: name, transport: build_transport(config) }
           server[:timeout] = config['timeout'].to_i if config['timeout']
+          server.merge!(routing_metadata(config))
+        end
+      end
 
-          # Preserve routing metadata for KBS/AIA
-          server[:topics]      = Array(config['topics']) if config['topics']
-          server[:independent] = config['independent'] unless config['independent'].nil?
-          server[:group]       = config['group'] if config['group']
+      def build_transport(config)
+        transport = { type: config['type'] || 'stdio' }
+        transport[:command] = config['command'] if config['command']
+        transport[:args]    = Array(config['args']) if config['args']
+        transport[:env]     = config['env'] if config['env']
+        transport[:url]     = config['url'] if config['url']
+        transport[:headers] = config['headers'] if config['headers']
+        transport
+      end
 
-          server
-        end
+      # Routing metadata preserved for KBS/AIA
+      def routing_metadata(config)
+        meta = {}
+        meta[:topics]      = Array(config['topics']) if config['topics']
+        meta[:independent] = config['independent'] unless config['independent'].nil?
+        meta[:group]       = config['group'] if config['group']
+        meta
       end
 
       # Convert simple format to robot_lab nested transport format
@@ -123,12 +130,13 @@ module AIA
 
         transport = { type: parsed['type'] || 'stdio' }
 
-        if parsed['command'].is_a?(Array)
+        command = parsed['command']
+        if command.is_a?(Array)
           # Command is an array: first element is command, rest are args
-          transport[:command] = parsed['command'].first
-          transport[:args] = parsed['command'][1..] || []
-        elsif parsed['command']
-          transport[:command] = parsed['command']
+          transport[:command] = command.first
+          transport[:args] = command[1..] || []
+        elsif command
+          transport[:command] = command
           transport[:args] = parsed['args'] || []
         end