swarm_cli 2.1.13 → 3.0.0.alpha2

metadata

@@ -1,303 +1,88 @@
 --- !ruby/object:Gem::Specification
 name: swarm_cli
 version: !ruby/object:Gem::Version
-  version: 2.1.13
+  version: 3.0.0.alpha2
 platform: ruby
 authors:
 - Paulo Arruda
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 1980-01-01 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: fast-mcp
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
-- !ruby/object:Gem::Dependency
-  name: pastel
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: reline
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.3
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.6.3
 - !ruby/object:Gem::Dependency
   name: swarm_sdk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
+        version: 3.0.alpha
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.7'
-- !ruby/object:Gem::Dependency
-  name: tty-box
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: tty-cursor
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: tty-link
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.0.alpha
 - !ruby/object:Gem::Dependency
   name: tty-markdown
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: tty-option
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: tty-spinner
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: tty-tree
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: zeitwerk
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: csv
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: docx
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.10'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.10'
-- !ruby/object:Gem::Dependency
-  name: pdf-reader
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.15'
+        version: '0.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.15'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
-  name: reverse_markdown
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 3.0.0
-- !ruby/object:Gem::Dependency
-  name: roo
+  name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: '2.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: '2.6'
 description: |
-  SwarmCLI provides a command-line interface for SwarmSDK, the lightweight multi-agent
-  AI orchestration framework. Built with the TTY toolkit, it offers an intuitive and interactive
-  way to define, manage, and execute AI agent swarms with progress indicators, formatted output,
-  and comprehensive help documentation.
+  SwarmCLI V3 provides a lightweight command-line interface for SwarmSDK V3 agents.
+  Features interactive REPL mode with always-available input, single-prompt execution,
+  and memory maintenance commands. Uses minimal dependencies with custom ANSI styling
+  and raw terminal input handling for a responsive experience.
 email:
 - parrudaj@gmail.com
 executables:
-- swarm
+- swarm3
 extensions: []
 extra_rdoc_files: []
 files:
-- exe/swarm
-- lib/swarm_cli.rb
-- lib/swarm_cli/cli.rb
-- lib/swarm_cli/command_registry.rb
-- lib/swarm_cli/commands/mcp_serve.rb
-- lib/swarm_cli/commands/mcp_tools.rb
-- lib/swarm_cli/commands/migrate.rb
-- lib/swarm_cli/commands/run.rb
-- lib/swarm_cli/config_loader.rb
-- lib/swarm_cli/formatters/human_formatter.rb
-- lib/swarm_cli/formatters/json_formatter.rb
-- lib/swarm_cli/interactive_repl.rb
-- lib/swarm_cli/mcp_serve_options.rb
-- lib/swarm_cli/mcp_tools_options.rb
-- lib/swarm_cli/migrate_options.rb
-- lib/swarm_cli/migrator.rb
-- lib/swarm_cli/options.rb
-- lib/swarm_cli/ui/components/agent_badge.rb
-- lib/swarm_cli/ui/components/content_block.rb
-- lib/swarm_cli/ui/components/divider.rb
-- lib/swarm_cli/ui/components/panel.rb
-- lib/swarm_cli/ui/components/usage_stats.rb
-- lib/swarm_cli/ui/formatters/cost.rb
-- lib/swarm_cli/ui/formatters/number.rb
-- lib/swarm_cli/ui/formatters/text.rb
-- lib/swarm_cli/ui/formatters/time.rb
-- lib/swarm_cli/ui/icons.rb
-- lib/swarm_cli/ui/renderers/event_renderer.rb
-- lib/swarm_cli/ui/state/agent_color_cache.rb
-- lib/swarm_cli/ui/state/depth_tracker.rb
-- lib/swarm_cli/ui/state/spinner_manager.rb
-- lib/swarm_cli/ui/state/usage_tracker.rb
-- lib/swarm_cli/version.rb
+- LICENSE
+- exe/swarm3
+- lib/swarm_cli/v3.rb
+- lib/swarm_cli/v3/activity_indicator.rb
+- lib/swarm_cli/v3/ansi_colors.rb
+- lib/swarm_cli/v3/cli.rb
+- lib/swarm_cli/v3/command_completer.rb
+- lib/swarm_cli/v3/display.rb
+- lib/swarm_cli/v3/dropdown.rb
+- lib/swarm_cli/v3/event_renderer.rb
+- lib/swarm_cli/v3/file_completer.rb
+- lib/swarm_cli/v3/raw_input_reader.rb
+- lib/swarm_cli/v3/reboot_tool.rb
+- lib/swarm_cli/v3/text_input.rb
 homepage: https://github.com/parruda/swarm
 licenses:
 - MIT
 metadata:
   source_code_uri: https://github.com/parruda/swarm
-  changelog_uri: https://github.com/parruda/swarm/blob/main/docs/v2/CHANGELOG.swarm_cli.md
+  changelog_uri: https://github.com/parruda/swarm/blob/main/docs/v3/CHANGELOG.md
 rdoc_options: []
 require_paths:
 - lib
@@ -314,5 +99,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Command-line interface for SwarmSDK
+summary: Lightweight CLI for SwarmSDK V3 agents
 test_files: []

data/exe/swarm

@@ -1,6 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "swarm_cli"
-
-SwarmCLI::CLI.start(ARGV)

data/lib/swarm_cli/cli.rb

@@ -1,201 +0,0 @@
-# frozen_string_literal: true
-
-module SwarmCLI
-  class CLI
-    class << self
-      def start(args)
-        new(args).run
-      end
-    end
-
-    def initialize(args)
-      @args = args
-    end
-
-    def run
-      # Handle special cases first
-      if @args.empty? || @args.include?("--help") || @args.include?("-h")
-        print_help
-        exit(0)
-      end
-
-      if @args.include?("--version") || @args.include?("-v")
-        print_version
-        exit(0)
-      end
-
-      # Extract command
-      command = @args.first
-
-      # Route to command
-      case command
-      when "run"
-        run_command(@args[1..])
-      when "mcp"
-        mcp_command(@args[1..])
-      when "migrate"
-        migrate_command(@args[1..])
-      else
-        # Check if it's an extension command
-        if CommandRegistry.registered?(command)
-          extension_command(command, @args[1..])
-        else
-          $stderr.puts "Unknown command: #{command}"
-          $stderr.puts
-          print_help
-          exit(1)
-        end
-      end
-    rescue StandardError => e
-      $stderr.puts "Fatal error: #{e.message}"
-      exit(1)
-    end
-
-    private
-
-    def mcp_command(args)
-      # MCP has subcommands
-      subcommand = args.first
-
-      case subcommand
-      when "serve"
-        mcp_serve_command(args[1..])
-      when "tools"
-        mcp_tools_command(args[1..])
-      else
-        $stderr.puts "Unknown mcp subcommand: #{subcommand}"
-        $stderr.puts
-        $stderr.puts "Available mcp subcommands:"
-        $stderr.puts "  serve     Start an MCP server exposing swarm lead agent"
-        $stderr.puts "  tools     Start an MCP server exposing SwarmSDK tools"
-        exit(1)
-      end
-    end
-
-    def mcp_serve_command(args)
-      # Parse options
-      options = McpServeOptions.new
-      options.parse(args)
-
-      # Execute mcp serve command
-      Commands::McpServe.new(options).execute
-    rescue TTY::Option::InvalidParameter, TTY::Option::InvalidArgument => e
-      $stderr.puts "Error: #{e.message}"
-      $stderr.puts
-      $stderr.puts options.help
-      exit(1)
-    end
-
-    def mcp_tools_command(args)
-      # Parse options
-      options = McpToolsOptions.new
-      options.parse(args)
-
-      # Execute mcp tools command
-      Commands::McpTools.new(options).execute
-    rescue TTY::Option::InvalidParameter, TTY::Option::InvalidArgument => e
-      $stderr.puts "Error: #{e.message}"
-      $stderr.puts
-      $stderr.puts options.help
-      exit(1)
-    end
-
-    def run_command(args)
-      # Parse options
-      options = Options.new
-      options.parse(args)
-
-      # Execute run command
-      Commands::Run.new(options).execute
-    rescue TTY::Option::InvalidParameter, TTY::Option::InvalidArgument => e
-      $stderr.puts "Error: #{e.message}"
-      $stderr.puts
-      $stderr.puts options.help
-      exit(1)
-    end
-
-    def migrate_command(args)
-      # Parse options
-      options = MigrateOptions.new
-      options.parse(args)
-
-      # Execute migrate command
-      Commands::Migrate.new(options).execute
-    rescue TTY::Option::InvalidParameter, TTY::Option::InvalidArgument => e
-      $stderr.puts "Error: #{e.message}"
-      $stderr.puts
-      $stderr.puts options.help
-      exit(1)
-    end
-
-    def extension_command(command_name, args)
-      # Get extension command class from registry
-      command_class = CommandRegistry.get(command_name)
-
-      # Execute extension command
-      command_class.execute(args)
-    end
-
-    def print_help
-      puts
-      puts "SwarmCLI v#{VERSION} - AI Agent Orchestration"
-      puts
-      puts "Usage:"
-      puts "  swarm run CONFIG_FILE -p PROMPT [options]"
-      puts "  swarm migrate INPUT_FILE [--output OUTPUT_FILE]"
-      puts "  swarm mcp serve CONFIG_FILE"
-      puts "  swarm mcp tools [TOOL_NAMES...]"
-
-      # Show extension commands dynamically
-      CommandRegistry.commands.each do |cmd|
-        puts "  swarm #{cmd} ..."
-      end
-
-      puts
-      puts "Commands:"
-      puts "  run           Execute a swarm with AI agents"
-      puts "  migrate       Migrate Claude Swarm v1 config to SwarmSDK v2 format"
-      puts "  mcp serve     Start an MCP server exposing swarm lead agent"
-      puts "  mcp tools     Start an MCP server exposing SwarmSDK tools"
-
-      # Show extension command descriptions (if registered)
-      if CommandRegistry.registered?("memory")
-        puts "  memory        Manage SwarmMemory embeddings"
-      end
-
-      puts
-      puts "Options:"
-      puts "  -p, --prompt PROMPT          Task prompt for the swarm"
-      puts "  -o, --output FILE            Output file for migrated config (default: stdout)"
-      puts "  --output-format FORMAT       Output format: 'human' or 'json' (default: human)"
-      puts "  -q, --quiet                  Suppress progress output (human format only)"
-      puts "  --truncate                   Truncate long outputs for concise view"
-      puts "  --verbose                    Show system reminders and additional debug information"
-      puts "  -h, --help                   Print help"
-      puts "  -v, --version                Print version"
-      puts
-      puts "Examples:"
-      puts "  swarm run team.yml -p 'Build a REST API'"
-      puts "  echo 'Build a REST API' | swarm run team.yml"
-      puts "  swarm run team.yml -p 'Refactor code' --output-format json"
-      puts "  swarm migrate old-config.yml"
-      puts "  swarm migrate old-config.yml --output new-config.yml"
-      puts "  swarm mcp serve team.yml"
-      puts "  swarm mcp tools                              # Expose all SwarmSDK tools"
-      puts "  swarm mcp tools Bash Grep Read               # Space-separated tools"
-      puts "  swarm mcp tools ScratchpadWrite,ScratchpadRead  # Comma-separated tools"
-
-      # Show extension command examples dynamically
-      if CommandRegistry.registered?("memory")
-        puts "  swarm memory setup                           # Setup embeddings (download model)"
-        puts "  swarm memory status                          # Check embedding status"
-      end
-
-      puts
-    end
-
-    def print_version
-      puts "SwarmCLI v#{VERSION}"
-    end
-  end
-end

data/lib/swarm_cli/command_registry.rb

@@ -1,61 +0,0 @@
-# frozen_string_literal: true
-
-module SwarmCLI
-  # Registry for CLI command extensions
-  #
-  # Allows gems (like swarm_memory) to register additional CLI commands
-  # that integrate seamlessly with the main swarm CLI.
-  #
-  # @example
-  #   # In swarm_memory gem
-  #   SwarmCLI::CommandRegistry.register(:memory, MyMemoryCommand)
-  #
-  #   # User runs:
-  #   swarm memory status
-  #
-  #   # SwarmCLI routes to MyMemoryCommand.execute(["status"])
-  class CommandRegistry
-    @extensions = {}
-
-    class << self
-      # Register a command extension
-      #
-      # @param command_name [Symbol, String] Command name (e.g., :memory)
-      # @param command_class [Class] Command class with execute(args) method
-      # @return [void]
-      #
-      # @example
-      #   CommandRegistry.register(:memory, SwarmMemory::CLI::Commands)
-      def register(command_name, command_class)
-        @extensions ||= {}
-        @extensions[command_name.to_s] = command_class
-      end
-
-      # Get command class by name
-      #
-      # @param command_name [String] Command name
-      # @return [Class, nil] Command class or nil if not found
-      def get(command_name)
-        @extensions ||= {}
-        @extensions[command_name.to_s]
-      end
-
-      # Check if a command is registered
-      #
-      # @param command_name [String] Command name
-      # @return [Boolean] True if command exists
-      def registered?(command_name)
-        @extensions ||= {}
-        @extensions.key?(command_name.to_s)
-      end
-
-      # Get all registered command names
-      #
-      # @return [Array<String>] Command names
-      def commands
-        @extensions ||= {}
-        @extensions.keys
-      end
-    end
-  end
-end