x_aeon_agents 1.0.28

data/lib/x_aeon_agents/cli.rb

@@ -0,0 +1,384 @@
+require 'thor'
+
+module XAeonAgents
+  # Main X-Aeon Agents CLI
+  class Cli < Thor
+    # Global options
+    class_option :session_id, type: :string, desc: 'Session ID for persistence'
+    class_option :debug, type: :boolean, default: false, desc: 'Enable debug mode'
+
+    # --------------------------------------------------------------------------- #
+    # review-comments: Address Pull Request review comments
+    # --------------------------------------------------------------------------- #
+
+    desc 'review-comments [PULL_REQUEST_NUMBER]', 'Address review comments on a GitHub Pull Request'
+    long_desc <<~LONGDESC
+      Reads Pull Request comments addressed to the agent, improves or fixes
+      the code based on those comments, and replies to each one. The Pull
+      Request is identified by its number in the current GitHub repository,
+      or auto-detected from the current git branch when no number is given.
+
+      Examples:
+
+        $   xaa review-comments 42
+
+        $   xaa review-comments
+
+        $   xaa review-comments 42 --session-id my-session
+    LONGDESC
+    # Addresses review comments on a GitHub Pull Request.
+    #
+    # @param pull_request_number [Integer, nil] The GitHub Pull Request number to process, or nil to auto-detect
+    def review_comments(pull_request_number = nil)
+      Agents::ReviewResolverAgent.new(session_id: options[:session_id]).run(
+        pull_request_number: pull_request_number ? Integer(pull_request_number) : nil
+      )
+    end
+
+    # --------------------------------------------------------------------------- #
+    # commit: Commit staged changes with an AI-generated message
+    # --------------------------------------------------------------------------- #
+
+    desc 'commit', 'Commit staged changes with an AI-generated commit message'
+    long_desc <<~LONGDESC
+      Analyzes the currently staged changes and generates a meaningful commit
+      message before committing.
+
+      The --stage option controls how files are staged before committing:
+
+        --stage all       Always stage all changes (tracked and untracked)
+        --stage if_empty  Stage all changes only if the staging area is empty (default)
+        --stage none      Do not stage anything; only commit already staged changes
+
+      Examples:
+
+        $   xaa commit
+
+        $   xaa commit --stage all
+
+        $   xaa commit --stage none
+    LONGDESC
+    option(
+      :stage,
+      type: :string,
+      default: 'if_empty',
+      desc: 'Staging strategy: all, if_empty, or none'
+    )
+    # Commits staged changes with an AI-generated commit message.
+    def commit
+      Agents::CommitterAgent.new(
+        session_id: options[:session_id],
+        stage: options[:stage].to_sym
+      ).run
+    end
+
+    # --------------------------------------------------------------------------- #
+    # create-pr: Push on Github and create a Pull Request if not already existing
+    # --------------------------------------------------------------------------- #
+
+    desc 'create-pr', 'Push on Github and create a Pull Request if not already existing'
+    long_desc <<~LONGDESC
+      Analyzes the current changes between the existing branch and its base,
+      pushes the branch on Github and generates a meaningful Pull Request on it.
+
+      The --base option gives the base ref of the Pull Request (defaults to main).
+
+      The --requirements option gives an optional description of requirements behind this Pull Request.
+
+      Examples:
+
+        $   xaa create-pr
+
+        $   xaa create-pr --base master
+
+        $   xaa create-pr --requirements "Add a new Home button on main screen"
+    LONGDESC
+    option :base, type: :string, default: 'main', desc: 'Base git ref to compare the existing base with for the Pull Request'
+    option :requirements, type: :string, default: nil, desc: 'Optional requirements that describe this Pull Request purpose'
+    # Push changes on Github and create a Pull Request.
+    def create_pr
+      agent_kwargs = {
+        base_sha: options[:base]
+      }
+      agent_kwargs[:requirements] = options[:requirements] if options[:requirements]
+      Agents::PullRequestCreatorAgent.new(session_id: options[:session_id]).run(**agent_kwargs)
+    end
+
+    # --------------------------------------------------------------------------- #
+    # generate-readme: Generate or update the project README
+    # --------------------------------------------------------------------------- #
+
+    desc 'generate-readme', 'Generate a comprehensive README from the codebase'
+    long_desc <<~LONGDESC
+      Uses AI to analyze the project and generate a README file with the
+      following sections (all enabled by default):
+
+        --about
+        --quick-start
+        --requirements
+        --features
+        --public-api
+        --documentation
+        --how-it-works
+        --development
+        --contributing
+        --license
+
+      Disable individual sections with --no-<section>.
+
+      Examples:
+
+        $   xaa generate-readme
+
+        $   xaa generate-readme --no-features --no-license --session-id my-session
+
+        $   xaa generate-readme --readme-file-path /path/to/custom/README.md
+    LONGDESC
+    option :about, type: :boolean, default: true, desc: 'Generate the About section'
+    option :quick_start, type: :boolean, default: true, desc: 'Generate the Quick Start section'
+    option :requirements, type: :boolean, default: true, desc: 'Generate the Requirements section'
+    option :features, type: :boolean, default: true, desc: 'Generate the Features section'
+    option :public_api, type: :boolean, default: true, desc: 'Generate the Public API section'
+    option :documentation, type: :boolean, default: true, desc: 'Generate the Documentation section'
+    option :how_it_works, type: :boolean, default: true, desc: 'Generate the How It Works section'
+    option :development, type: :boolean, default: true, desc: 'Generate the Development section'
+    option :contributing, type: :boolean, default: true, desc: 'Generate the Contributing section'
+    option :license, type: :boolean, default: true, desc: 'Generate the License section'
+    option :readme_file_path, type: :string, default: nil, desc: 'Path to the README file to generate or update'
+    # Generates or updates the project README file.
+    def generate_readme
+      agent_kwargs = {
+        gen_about: options[:about],
+        gen_quick_start: options[:quick_start],
+        gen_requirements: options[:requirements],
+        gen_features: options[:features],
+        gen_public_api: options[:public_api],
+        gen_documentation: options[:documentation],
+        gen_how_it_works: options[:how_it_works],
+        gen_development: options[:development],
+        gen_contributing: options[:contributing],
+        gen_license: options[:license]
+      }
+      agent_kwargs[:readme_file_path] = options[:readme_file_path] if options[:readme_file_path]
+      Agents::ReadmeGeneratorAgent.new(session_id: options[:session_id]).run(**agent_kwargs)
+    end
+
+    # --------------------------------------------------------------------------- #
+    # generate-skills: Generate skill files from ERB templates
+    # --------------------------------------------------------------------------- #
+
+    desc 'generate-skills', 'Generate skill files from ERB templates in skills.src/'
+    long_desc <<~LONGDESC
+      Processes the skills.src/ directory and writes generated skill files to
+      the output directory (default: skills/).  ERB templates (.erb) are
+      evaluated; all other files are copied as-is.
+
+      Examples:
+
+        $   xaa generate-skills
+
+        $   xaa generate-skills --output-dir custom_skills
+    LONGDESC
+    option :output_dir, type: :string, default: 'skills', desc: 'Output directory for generated skills'
+    option(
+      :skill,
+      type: :string,
+      repeatable: true,
+      desc: 'Skill name(s) to generate. Can be repeated: --skill name1 --skill name2 or comma-separated: --skill name1,name2. Omit to generate all skills.'
+    )
+    # Generates skill files from ERB templates in skills.src/.
+    #
+    # @note Exits with status 1 if skill generation fails
+    def generate_skills
+      result = Agents::SkillGeneratorAgent.new(session_id: options[:session_id]).run(
+        output_dir: options[:output_dir],
+        skill_names: options[:skill]
+      )
+      exit 1 unless result[:success]
+    end
+
+    # --------------------------------------------------------------------------- #
+    # implement-issue: Implement a GitHub issue
+    # --------------------------------------------------------------------------- #
+
+    desc 'implement-issue ISSUE_NUMBER', 'Implement a GitHub issue using AI'
+    long_desc <<~LONGDESC
+      Reads the content (and comments) of a GitHub issue and delegates the
+      implementation to the Developer agent.  The agent commits changes and
+      opens a Pull Request automatically.
+
+      Examples:
+
+        $   xaa implement-issue 15
+
+        $   xaa implement-issue 15 --session-id my-session
+    LONGDESC
+    # Implements a GitHub issue using AI.
+    #
+    # @param github_issue_number [Integer] The GitHub issue number to implement
+    def implement_issue(github_issue_number)
+      Agents::IssueImplementerAgent.new(
+        commit: true,
+        pull_request: true,
+        session_id: options[:session_id]
+      ).run(github_issue_number: Integer(github_issue_number))
+    end
+
+    # --------------------------------------------------------------------------- #
+    # implement: Implement arbitrary requirements
+    # --------------------------------------------------------------------------- #
+
+    desc 'implement REQUIREMENTS', 'Implement given requirements with AI'
+    long_desc <<~LONGDESC
+      Pass free-form requirements to the Developer agent, which will analyze
+      the codebase and produce the requested changes.
+
+      Examples:
+
+        $   xaa implement "Add authentication middleware"
+
+        $   xaa implement "Refactor the database layer" --commit --pr --session-id my-session
+    LONGDESC
+    option :commit, type: :boolean, default: false, desc: 'Commit files at every step'
+    option :pr, type: :boolean, default: false, desc: 'Create a GitHub Pull Request for the changes'
+    # Implements arbitrary requirements using AI.
+    #
+    # @param requirements [String] Free-form requirements describing the desired changes
+    def implement(requirements)
+      Agents::DeveloperAgent.new(
+        commit: options[:commit],
+        pull_request: options[:pr],
+        session_id: options[:session_id]
+      ).run(requirements:)
+    end
+
+    # --------------------------------------------------------------------------- #
+    # interpret-diffs: Summarize current git diffs
+    # --------------------------------------------------------------------------- #
+
+    desc 'interpret-diffs [BASE]', 'Summarize git diffs relative to a base ref'
+    long_desc <<~LONGDESC
+      Produces a one-line summary and a description of the intent behind the
+      changes in the working tree relative to BASE (default: HEAD).
+
+      Examples:
+
+        $   xaa interpret-diffs
+
+        $   xaa interpret-diffs main
+
+        $   xaa interpret-diffs HEAD~3
+    LONGDESC
+    # Summarizes current git diffs relative to a base ref.
+    #
+    # @param base [String] Git reference to diff against
+    def interpret_diffs(base = 'HEAD')
+      output = Agents::GitDiffInterpreterAgent.new(session_id: options[:session_id]).run(git_ref_base: base)
+      puts <<~EO_OUTPUT
+        ===== Code diffs interpretation:
+
+        #{output[:one_line_summary].strip}
+
+        #{output[:change_intent].strip}
+      EO_OUTPUT
+    end
+
+    # --------------------------------------------------------------------------- #
+    # prompt: Send a one-shot prompt to the AI agent
+    # --------------------------------------------------------------------------- #
+
+    desc 'prompt PROMPT', 'Send a one-shot prompt to the AI agent and print the response'
+    long_desc <<~LONGDESC
+      Executes a single prompt against the free simple AI model and prints
+      the last message of the conversation.
+
+      Examples:
+
+        $   xaa prompt "What is the capital of France?"
+
+        $   xaa prompt "Explain this code: puts 'hello'"
+    LONGDESC
+    # Sends a one-shot prompt to the AI agent and prints the response.
+    #
+    # @param user_prompt [String] The prompt text to send to the AI agent
+    def prompt(user_prompt)
+      agent = Agents::ExecutorAgent.new(session_id: options[:session_id], **Config.agent_options['free_simple'])
+      agent.run(user_instructions: user_prompt)
+      puts agent.conversation.last[:message]
+    end
+
+    # --------------------------------------------------------------------------- #
+    # install-skills: Install skills from the .skills manifest
+    # --------------------------------------------------------------------------- #
+
+    desc 'install-skills', 'Install skills and their dependencies from the .skills manifest'
+    long_desc <<~LONGDESC
+      Reads the .skills manifest file and installs every listed skill,
+      together with their recursively-resolved dependencies.
+
+      Example:
+
+        $   xaa install-skills
+
+        $   xaa install-skills --agent cline
+    LONGDESC
+    option :agent, type: :string, default: 'cline', desc: 'Agent name to be used to install skills'
+    # Installs skills and their dependencies from the .skills manifest.
+    def install_skills
+      Agents::SkillInstallerAgent.new(session_id: options[:session_id]).run(
+        agent: options[:agent].to_sym
+      )
+    end
+
+    # --------------------------------------------------------------------------- #
+    # start-task: Open a new git worktree for a task
+    # --------------------------------------------------------------------------- #
+
+    desc 'start-task', 'Open a new git worktree for a feature branch'
+    long_desc <<~LONGDESC
+      Interactive command that prompts for a branch name, creates the branch
+      (if it does not exist), sets up a git worktree in .worktrees/, pushes
+      the branch upstream, and opens it in VSCodium.
+
+      The --branch option gives the branch name directly, so the command is
+      not interactive anymore (no prompt to STDIN).
+
+      Example:
+
+        $   xaa start-task
+
+        $   xaa start-task --branch feature/my-task
+    LONGDESC
+    option :branch, type: :string, default: nil, desc: 'Branch name to create a worktree for. If omitted, the branch name is read interactively from STDIN.'
+    # Opens a new git worktree for a feature branch.
+    def start_task
+      branch = options[:branch] || begin
+        puts 'Branch name:'
+        $stdin.gets.strip
+      end
+      Agents::TaskStarterAgent.new(session_id: options[:session_id]).run(branch_name: branch)
+    end
+
+    # --------------------------------------------------------------------------- #
+    # Exit on failure for consistent scripting
+    # --------------------------------------------------------------------------- #
+
+    # Returns whether to exit on command failure.
+    #
+    # @return [Boolean] Always returns true so Thor exits with a non-zero status on command failure
+    def self.exit_on_failure?
+      true
+    end
+
+    no_commands do
+      # Initializes the CLI and applies global configuration from options.
+      #
+      # @param args [Array<Object>] Arguments forwarded to Thor's constructor
+      def initialize(*)
+        super
+        # Handle all the global setup from options
+        Config.debug = options[:debug]
+      end
+    end
+  end
+end

data/lib/x_aeon_agents/config.rb

@@ -0,0 +1,110 @@
+require 'agents'
+require 'ruby_llm'
+require 'secret_string'
+
+module XAeonAgents
+  # Singleton module to get all configuration of X-Aeon Agents
+  module Config
+    # TODO: Add test cases for this module
+    class << self
+      include Logger
+
+      # @!group Public API
+
+      # Automatically generate accessors for secrets taken from the ENV or the Launcher
+      %i[
+        cline_api_key
+        openrouter_api_key
+        github_token
+      ].each do |secret_name|
+        # Set the secret from a string
+        #
+        # @param secret [String] The secret value
+        define_method(:"#{secret_name}=") do |secret|
+          @secrets ||= {}
+          @secrets[secret_name] = SecretString.new(secret)
+        end
+
+        # Get the unprotected secret as a string.
+        # Use defaults if the secret was never set.
+        #
+        # @return [String, nil] The secret value, or nil if none
+        define_method(secret_name) do
+          @secrets ||= {}
+          @secrets[secret_name] ||= begin
+            env_secret = ENV.fetch(secret_name.to_s.upcase, nil)
+            env_secret ? SecretString.new(env_secret.dup) : Helpers.keys_from_launcher[secret_name]
+          end
+          @secrets[secret_name]&.to_unprotected
+        end
+      end
+
+      # @return [String] X-Aeon Agents data directory
+      attr_writer :data_dir
+
+      # @return [String] X-Aeon Agents data directory
+      def data_dir
+        @data_dir ||= '.x_aeon_agents'
+      end
+
+      # @return [Hash{Symbol => Object}] Default Cline CLI arguments
+      attr_writer :default_cline_cli_args
+
+      # @return [Hash{Symbol => Object}] Default Cline CLI arguments
+      def default_cline_cli_args
+        @default_cline_cli_args ||= { thinking: 'xhigh' }
+      end
+
+      # @return [Boolean] The debug mode
+      def debug=(value)
+        @debug = value
+        Logger.debug = debug
+      end
+
+      # @return [Boolean] The debug mode
+      def debug
+        @debug ||= ENV['X_AEON_AGENTS_DEBUG'] == '1'
+      end
+
+      # @return [AgentOptions] The available agent options.
+      def agent_options
+        @agent_options ||= AgentOptions.new
+      end
+
+      # Configure X-Aeon Agents
+      #
+      # @param kwargs [Hash] Any configuration property that can be set
+      def configure(**kwargs)
+        kwargs.each do |property, value|
+          send(:"#{property}=", value)
+        end
+        Logger.debug = debug
+      end
+
+      # @!group Internal
+
+      # Setup composable_agents in a lazy and memoized way
+      def setup_composable_agents
+        ENV['COMPOSABLE_AGENTS_DEBUG'] = '1' if debug
+      end
+
+      # Setup ai-agents in a lazy and memoized way
+      def setup_ai_agents
+        ENV['RUBYLLM_DEBUG'] = '1' if debug
+        ::Agents.configure do |ai_agents_config|
+          ai_agents_config.debug = debug
+        end
+        RubyLLM.configure do |ruby_llm_config|
+          ruby_llm_config.openrouter_api_key = openrouter_api_key
+        end
+        # Discover all the models
+        RubyLLM::Models.refresh!
+      end
+
+      # Setup Cline in a lazy and memoized way
+      def setup_cline
+        # Nothing to do
+      end
+    end
+  end
+end