jules-ruby 0.0.67

data/lib/jules-ruby/cli/interactive.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require_relative 'prompts'
+require_relative 'interactive/session_creator'
+require_relative 'interactive/session_manager'
+require_relative 'interactive/source_manager'
+
+module JulesRuby
+  # Interactive mode for jules-ruby CLI
+  class Interactive
+    def initialize
+      @client = JulesRuby::Client.new
+      @prompt = Prompts.prompt
+    end
+
+    def start
+      loop do
+        Prompts.clear_screen
+        Prompts.print_banner
+
+        choice = main_menu_selection
+
+        case choice
+        when :create_session
+          SessionCreator.new(@client, @prompt).run
+        when :view_sessions
+          SessionManager.new(@client, @prompt).run
+        when :browse_sources
+          SourceManager.new(@client, @prompt).run
+        when :exit
+          puts Prompts.rgb_color("\nGoodbye! 👋", :purple)
+          break
+        end
+      end
+    end
+
+    private
+
+    def main_menu_selection
+      @prompt.select(Prompts.rgb_color('What would you like to do?', :lavender), cycle: true) do |menu|
+        menu.choice Prompts.rgb_color('Create new session', :purple), :create_session
+        menu.choice Prompts.rgb_color('View sessions', :purple), :view_sessions
+        menu.choice Prompts.rgb_color('Browse sources', :purple), :browse_sources
+        menu.choice Prompts.rgb_color('Exit', :purple), :exit
+      end
+    end
+  end
+end

data/lib/jules-ruby/cli/prompts.rb

@@ -0,0 +1,184 @@
+# frozen_string_literal: true
+
+require 'pastel'
+require 'tty-prompt'
+require 'tty-spinner'
+require_relative 'banner'
+
+module JulesRuby
+  # Helper methods for interactive prompts
+  module Prompts
+    # Custom true-color RGB theme matching Jules CLI design
+    PASTEL = Pastel.new
+
+    # RGB color values matching the reference CLI screenshot
+    COLORS = {
+      purple: [147, 112, 219],     # Selection highlight #9370DB
+      lavender: [196, 181, 253],   # Accent text #C4B5FD
+      muted: [139, 92, 246],       # Muted purple #8B5CF6
+      dim: [107, 114, 128]         # Dim gray #6B7280
+    }.freeze
+
+    # Define custom symbols for the prompt
+    PROMPT_SYMBOLS = {
+      marker: '❯',
+      radio_on: '◉',
+      radio_off: '◯'
+    }.freeze
+
+    # State emoji indicators
+    STATE_EMOJI = {
+      'QUEUED' => '⏳',
+      'PLANNING' => '🔵',
+      'AWAITING_PLAN_APPROVAL' => '🟡',
+      'AWAITING_USER_FEEDBACK' => '🟠',
+      'IN_PROGRESS' => '🔵',
+      'PAUSED' => '⏸️',
+      'FAILED' => '🔴',
+      'COMPLETED' => '🟢'
+    }.freeze
+
+    STATE_LABELS = {
+      'QUEUED' => 'Queued',
+      'PLANNING' => 'Planning',
+      'AWAITING_PLAN_APPROVAL' => 'Needs Approval',
+      'AWAITING_USER_FEEDBACK' => 'Needs Feedback',
+      'IN_PROGRESS' => 'Working',
+      'PAUSED' => 'Paused',
+      'FAILED' => 'Failed',
+      'COMPLETED' => 'Done'
+    }.freeze
+
+    class << self
+      # Apply true-color RGB to text using ANSI escape sequences
+      def rgb_color(text, color_name)
+        r, g, b = COLORS[color_name]
+        "\e[38;2;#{r};#{g};#{b}m#{text}\e[0m"
+      end
+
+      def prompt
+        @prompt ||= TTY::Prompt.new(
+          interrupt: :exit,
+          symbols: PROMPT_SYMBOLS,
+          active_color: :magenta,
+          help_color: :cyan
+        )
+      end
+
+      def spinner(message)
+        TTY::Spinner.new(
+          "[:spinner] #{rgb_color(message, :purple)}",
+          format: :dots,
+          success_mark: PASTEL.green('✓'),
+          error_mark: PASTEL.red('✗')
+        )
+      end
+
+      def with_spinner(message)
+        spin = spinner(message)
+        spin.auto_spin
+        result = yield
+        spin.success(PASTEL.green('done'))
+        result
+      rescue StandardError => e
+        spin.error(PASTEL.red('failed'))
+        raise e
+      end
+
+      def state_emoji(state)
+        # API returns nil for completed sessions
+        return '🟢' if state.nil?
+
+        STATE_EMOJI[state] || '❓'
+      end
+
+      def state_label(state)
+        # API returns nil for completed sessions
+        return 'Completed' if state.nil?
+
+        STATE_LABELS[state] || state
+      end
+
+      def format_session_choice(session)
+        emoji = state_emoji(session.state)
+        label = state_label(session.state)
+        title = session.title || session.prompt&.slice(0, 25) || 'Untitled'
+        title = "#{title[0..22]}..." if title.length > 25
+        time_ago = time_ago_in_words(session.update_time)
+        {
+          name: "#{emoji} #{rgb_color(title.ljust(27),
+                                      :purple)} #{rgb_color(label.ljust(15), :lavender)} #{rgb_color(time_ago, :dim)}",
+          value: session
+        }
+      end
+
+      def format_source_choice(source)
+        repo_name = source.github_repo&.full_name || source.name
+        {
+          name: rgb_color(repo_name, :purple),
+          value: source
+        }
+      end
+
+      def time_ago_in_words(time_string)
+        return 'N/A' unless time_string
+
+        time = Time.parse(time_string)
+        diff = Time.now - time
+        case diff
+        when 0..59
+          'just now'
+        when 60..3599
+          "#{(diff / 60).to_i}m ago"
+        when 3600..86_399
+          "#{(diff / 3600).to_i}h ago"
+        else
+          "#{(diff / 86_400).to_i}d ago"
+        end
+      end
+
+      def format_datetime(time_string)
+        return 'N/A' unless time_string
+
+        time = Time.parse(time_string)
+        today = Time.now.to_date
+        date = time.to_date
+
+        if date == today
+          "Today #{time.strftime('%l:%M %p').strip}"
+        elsif date == today - 1
+          "Yesterday #{time.strftime('%l:%M %p').strip}"
+        else
+          time.strftime('%b %d, %Y %l:%M %p').strip
+        end
+      end
+
+      def clear_screen
+        print "\e[2J\e[H"
+      end
+
+      def header(title)
+        puts
+        puts "  🚀 #{rgb_color(title, :lavender)}"
+        puts "  #{rgb_color('─' * 50, :muted)}"
+        puts
+      end
+
+      def divider
+        rgb_color('─' * 50, :muted)
+      end
+
+      def highlight(text)
+        rgb_color(text, :lavender)
+      end
+
+      def muted(text)
+        rgb_color(text, :dim)
+      end
+
+      def print_banner
+        Banner.print_banner
+      end
+    end
+  end
+end

data/lib/jules-ruby/cli/sessions.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module JulesRuby
+  module Commands
+    # Sessions subcommand
+    class Sessions < Base
+      desc 'list', 'List all sessions'
+      format_option
+      def list
+        sessions = client.sessions.all
+        if options[:format] == 'json'
+          puts JSON.pretty_generate(sessions.map(&:to_h))
+        else
+          print_sessions_table(sessions)
+        end
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      desc 'show ID', 'Show details for a session'
+      format_option
+      def show(id)
+        session = client.sessions.find(id)
+        if options[:format] == 'json'
+          puts JSON.pretty_generate(session.to_h)
+        else
+          print_session_details(session)
+        end
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      desc 'create', 'Create a new session'
+      long_desc <<~LONGDESC
+        Create a new Jules coding session.
+
+        You must provide a prompt either inline with --prompt or from a file with --prompt-file.
+        If both are provided, --prompt-file takes precedence.
+
+        Examples:
+          # Create with inline prompt
+          $ jules-ruby sessions create --source=sources/github/owner/repo --prompt="Fix the login bug"
+          # Create with prompt from file
+          $ jules-ruby sessions create --source=sources/github/owner/repo --prompt-file=./task-instructions.md
+          # Create with custom branch and auto-PR
+          $ jules-ruby sessions create --source=sources/github/owner/repo --branch=develop --prompt="Add tests" --auto-pr
+      LONGDESC
+      option :source, required: true, desc: 'Source name (e.g., sources/github/owner/repo)'
+      option :branch, default: 'main', desc: 'Starting branch'
+      option :prompt, desc: 'Task prompt (inline text)'
+      option :prompt_file, desc: 'Path to file containing task prompt'
+      option :title, desc: 'Session title'
+      option :auto_pr, type: :boolean, default: false, desc: 'Auto-create PR when done'
+      def create
+        prompt_text = resolve_prompt
+        raise Thor::Error, 'You must provide --prompt or --prompt-file' if prompt_text.nil? || prompt_text.strip.empty?
+
+        session = create_session(prompt_text)
+        print_creation_success(session)
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      desc 'approve ID', 'Approve the plan for a session'
+      long_desc <<~LONGDESC
+        Approve the generated plan for a session.
+        Example:
+          $ jules-ruby sessions approve SESSION_ID
+      LONGDESC
+      def approve(id)
+        session = client.sessions.approve_plan(id)
+        puts "Plan approved for session: #{session.name}"
+        puts "State: #{session.state}"
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      desc 'message ID', 'Send a message to a session'
+      long_desc <<~LONGDESC
+        Send a message to an existing session.
+        Examples:
+          $ jules-ruby sessions message SESSION_ID --prompt="Please also add unit tests"
+      LONGDESC
+      option :prompt, required: true, desc: 'Message to send'
+      def message(id)
+        session = client.sessions.send_message(id, prompt: options[:prompt])
+        puts "Message sent to session: #{session.name}"
+        puts "State: #{session.state}"
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      desc 'delete ID', 'Delete a session'
+      def delete(id)
+        client.sessions.destroy(id)
+        puts "Session deleted: #{id}"
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      private
+
+      def resolve_prompt
+        if options[:prompt_file]
+          file_path = File.expand_path(options[:prompt_file])
+          raise Thor::Error, "Prompt file not found: #{file_path}" unless File.exist?(file_path)
+
+          File.read(file_path)
+        else
+          options[:prompt]
+        end
+      end
+
+      def create_session(prompt_text)
+        params = build_create_params(prompt_text)
+        client.sessions.create(**params)
+      end
+
+      def build_create_params(prompt_text)
+        source_context = {
+          'source' => options[:source],
+          'githubRepoContext' => { 'startingBranch' => options[:branch] }
+        }
+
+        params = {
+          prompt: prompt_text,
+          source_context: source_context
+        }
+        params[:title] = options[:title] if options[:title]
+        params[:automation_mode] = 'AUTO_CREATE_PR' if options[:auto_pr]
+        params
+      end
+
+      def print_creation_success(session)
+        puts "Session created: #{session.name}"
+        puts "URL: #{session.url}"
+        puts "State: #{session.state}"
+      end
+
+      def print_sessions_table(sessions)
+        if sessions.empty?
+          puts 'No sessions found.'
+          return
+        end
+        puts 'ID                   TITLE                          STATE                UPDATED        '
+        puts '-' * 90
+        sessions.each do |s|
+          title = truncate(s.title || s.prompt, 28)
+          updated = s.update_time ? Time.parse(s.update_time).strftime('%Y-%m-%d %H:%M') : 'N/A'
+          puts format('%<id>-20s %<title>-30s %<state>-20s %<updated>-15s',
+                      id: s.id, title: title, state: s.state, updated: updated)
+        end
+      end
+
+      def print_session_details(session)
+        print_session_basic_info(session)
+        print_session_outputs(session.outputs) if session.outputs&.any?
+      end
+
+      def print_session_basic_info(session)
+        puts "Name:    #{session.name}"
+        puts "ID:      #{session.id}"
+        puts "Title:   #{session.title}" if session.title
+        puts "Prompt:  #{session.prompt}"
+        puts "State:   #{session.state}"
+        puts "URL:     #{session.url}" if session.url
+        puts "Created: #{session.create_time}"
+        puts "Updated: #{session.update_time}"
+      end
+
+      def print_session_outputs(outputs)
+        puts "\nOutputs:"
+        outputs.each do |output|
+          if output.respond_to?(:url)
+            puts "  - PR: #{output.url}"
+          else
+            puts "  - #{output}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jules-ruby/cli/sources.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module JulesRuby
+  module Commands
+    # Sources subcommand
+    class Sources < Base
+      desc 'list', 'List all connected repositories'
+      long_desc <<~LONGDESC
+        List all GitHub repositories connected to your Jules account.
+
+        Examples:
+          $ jules-ruby sources list
+          $ jules-ruby sources list --format=json
+      LONGDESC
+      format_option
+      def list
+        sources = client.sources.all
+        if options[:format] == 'json'
+          puts JSON.pretty_generate(sources.map(&:to_h))
+        else
+          print_sources_table(sources)
+        end
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      desc 'show NAME', 'Show details for a source'
+      long_desc <<~LONGDESC
+        Show details for a specific source.
+
+        Example:
+          $ jules-ruby sources show sources/github/owner/repo
+      LONGDESC
+      format_option
+      def show(name)
+        source = client.sources.find(name)
+        if options[:format] == 'json'
+          puts JSON.pretty_generate(source.to_h)
+        else
+          print_source_details(source)
+        end
+      rescue JulesRuby::Error => e
+        error_exit(e)
+      end
+
+      private
+
+      def print_sources_table(sources)
+        if sources.empty?
+          puts 'No sources found.'
+          return
+        end
+        puts 'NAME                                               REPOSITORY          '
+        puts '-' * 72
+        sources.each do |s|
+          puts format('%<name>-50s %<repo>-20s', name: s.name, repo: s.github_repo&.full_name || 'N/A')
+        end
+      end
+
+      def print_source_details(source)
+        puts "Name:       #{source.name}"
+        puts "ID:         #{source.id}"
+        return unless source.github_repo
+
+        puts "Repository: #{source.github_repo.full_name}"
+        puts "URL:        #{source.github_repo.url}" if source.github_repo.respond_to?(:url)
+      end
+    end
+  end
+end

data/lib/jules-ruby/cli.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+require 'thor'
+require_relative 'cli/interactive'
+require_relative 'cli/prompts'
+require_relative 'cli/sources'
+require_relative 'cli/sessions'
+require_relative 'cli/activities'
+
+module JulesRuby
+  # Command-line interface for jules-ruby
+  class CLI < Thor
+    package_name 'jules-ruby'
+
+    def self.exit_on_failure?
+      true
+    end
+
+    def self.help(shell, subcommand = false)
+      Prompts.print_banner
+
+      shell.say <<~BANNER
+        QUICK START EXAMPLES:
+
+          # Start interactive mode (default)
+          $ jules-ruby
+
+          # List your connected repositories
+          $ jules-ruby sources list
+
+          # Create a new coding session
+          $ jules-ruby sessions create --source=sources/github/owner/repo --prompt="Fix the login bug"
+
+          # Create a session with prompt from file
+          $ jules-ruby sessions create --source=sources/github/owner/repo --prompt-file=./task.md
+
+          # List all sessions
+          $ jules-ruby sessions list
+
+          # View session activities
+          $ jules-ruby activities list SESSION_ID
+
+          # Approve a session's plan
+          $ jules-ruby sessions approve SESSION_ID
+
+        CONFIGURATION:
+
+          Set your API key via environment variable:
+          $ export JULES_API_KEY=your_api_key
+
+      BANNER
+      super
+    end
+
+    desc 'interactive', 'Start interactive mode'
+    def interactive
+      JulesRuby::Interactive.new.start
+    end
+
+    map %w[-i] => :interactive
+    default_command :interactive
+
+    desc 'sources SUBCOMMAND', 'Manage sources (connected repositories)'
+    long_desc <<~LONGDESC
+      Manage connected GitHub repositories (sources).
+
+      Examples:
+
+        # List all connected repositories
+        $ jules-ruby sources list
+
+        # Show details for a specific source
+        $ jules-ruby sources show sources/github/owner/repo
+
+        # Output as JSON
+        $ jules-ruby sources list --format=json
+    LONGDESC
+    subcommand 'sources', JulesRuby::Commands::Sources
+
+    desc 'sessions SUBCOMMAND', 'Manage coding sessions'
+    long_desc <<~LONGDESC
+      Manage Jules coding sessions.
+
+      Examples:
+
+        # List all sessions
+        $ jules-ruby sessions list
+
+        # Show session details
+        $ jules-ruby sessions show SESSION_ID
+
+        # Create a session with inline prompt
+        $ jules-ruby sessions create --source=sources/github/owner/repo --prompt="Fix the login bug"
+
+        # Create a session with prompt from file
+        $ jules-ruby sessions create --source=sources/github/owner/repo --prompt-file=./task.md
+
+        # Create a session with auto-PR
+        $ jules-ruby sessions create --source=sources/github/owner/repo --prompt="Add tests" --auto-pr
+    LONGDESC
+    subcommand 'sessions', JulesRuby::Commands::Sessions
+
+    desc 'activities SUBCOMMAND', 'View session activities'
+    long_desc <<~LONGDESC
+      View activities (messages, plans, progress) for Jules sessions.
+
+      Examples:
+
+        # List all activities for a session
+        $ jules-ruby activities list SESSION_ID
+
+        # Show details for a specific activity
+        $ jules-ruby activities show sessions/SESSION_ID/activities/ACTIVITY_ID
+
+        # Output as JSON
+        $ jules-ruby activities list SESSION_ID --format=json
+    LONGDESC
+    subcommand 'activities', JulesRuby::Commands::Activities
+
+    desc 'version', 'Show jules-ruby version'
+    def version
+      puts "jules-ruby #{JulesRuby::VERSION}"
+    end
+
+    map %w[-v --version] => :version
+  end
+end