fantasy-cli 1.2.6

data/lib/gsd/ai/cli.rb

@@ -0,0 +1,248 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/chat'
+require 'gsd/ai/repl'
+require 'gsd/ai/config'
+
+module Gsd
+  module AI
+    # AI CLI Command - Comando de linha de comando para IA
+    #
+    # Uso:
+    #   gsd ai                    # Inicia REPL interativo
+    #   gsd ai "sua mensagem"     # One-shot command
+    #   gsd ai --provider openai  # Usa OpenAI
+    #   gsd ai --model claude-3   # Modelo específico
+    #   gsd ai --help             # Ajuda
+    class CLI
+      attr_reader :options
+
+      # Inicializa o comando AI
+      #
+      # @param args [Array] Argumentos de linha de comando
+      # @param cwd [String] Diretório de trabalho
+      def initialize(args = [], cwd: Dir.pwd)
+        @args = args
+        @cwd = cwd
+        @options = parse_options
+      end
+
+      # Executa o comando AI
+      #
+      # @return [void]
+      def run
+        if @options[:help]
+          print_help
+          return
+        end
+
+        if @options[:version]
+          print_version
+          return
+        end
+
+        # Verifica se é comando config
+        if @args.first == 'config'
+          run_config(@args[1..])
+          return
+        end
+
+        # Cria o chat
+        chat = create_chat
+
+        # Verifica se é one-shot ou REPL
+        if @options[:message]
+          # One-shot command
+          run_one_shot(chat, @options[:message])
+        else
+          # REPL interativo
+          run_repl(chat)
+        end
+      end
+
+      private
+
+      # Parseia as opções de linha de comando
+      #
+      # @return [Hash] Opções parseadas
+      def parse_options
+        options = {
+          provider: :anthropic,
+          model: nil,
+          debug: false,
+          verbose: false,
+          help: false,
+          version: false,
+          message: nil
+        }
+
+        i = 0
+        while i < @args.length
+          arg = @args[i]
+
+          case arg
+          when '--provider', '-p'
+            options[:provider] = @args[i + 1]&.to_sym || :anthropic
+            i += 1
+          when '--model', '-m'
+            options[:model] = @args[i + 1]
+            i += 1
+          when '--debug', '-d'
+            options[:debug] = true
+          when '--verbose', '-v'
+            options[:verbose] = true
+          when '--help', '-h'
+            options[:help] = true
+          when '--version'
+            options[:version] = true
+          when /^--(.+)=/
+            # Named arguments like --provider=anthropic
+            key, value = arg[2..-1].split('=', 2)
+            options[key.to_sym] = value
+          when /^-/
+            # Unknown flag, ignore
+          else
+            # First non-flag argument is the message
+            options[:message] ||= arg
+          end
+
+          i += 1
+        end
+
+        options
+      end
+
+      # Cria uma instância de Chat
+      #
+      # @return [Chat] Instância do chat
+      def create_chat
+        Gsd::AI::Chat.new(
+          provider: @options[:provider],
+          model: @options[:model],
+          cwd: @cwd,
+          debug: @options[:debug]
+        )
+      rescue => e
+        puts "❌ Erro ao criar chat: #{e.message}"
+        puts "\nDicas:"
+        puts "  - Verifique se a API key está configurada"
+        puts "  - Use --provider ollama para LLMs locais"
+        puts "  - Use --help para ver todas as opções"
+        exit 1
+      end
+
+      # Executa comando one-shot
+      #
+      # @param chat [Chat] Instância do chat
+      # @param message [String] Mensagem do usuário
+      # @return [void]
+      def run_one_shot(chat, message)
+        begin
+          response = chat.send(message, stream: false)
+          puts response
+        rescue => e
+          puts "❌ Erro: #{e.message}"
+          exit 1
+        end
+      end
+
+      # Executa REPL interativo
+      #
+      # @param chat [Chat] Instância do chat
+      # @return [void]
+      def run_repl(chat)
+        repl = Gsd::AI::Repl.new(chat, verbose: @options[:verbose])
+        repl.start
+      end
+
+      # Imprime ajuda
+      #
+      # @return [void]
+      def print_help
+        puts <<~HELP
+
+          🤖 GSD AI Chat - Interface de Conversa com IA
+
+          USO:
+            gsd ai [opções] [mensagem]
+            gsd ai config <subcommand>  # Gerenciar API keys
+
+          COMANDOS:
+            gsd ai                        # Inicia REPL interativo
+            gsd ai "sua mensagem"         # One-shot command
+            gsd ai config list            # Listar API keys
+            gsd ai config set <p> <key>   # Configurar API key
+            gsd ai --help                 # Mostra esta ajuda
+
+          OPÇÕES:
+            -p, --provider <name>         Provider: anthropic, openai, ollama, openrouter
+            -m, --model <name>            Modelo do LLM
+            -d, --debug                   Habilita modo debug
+            -v, --verbose                 Modo verbose
+            --help, -h                    Mostra esta ajuda
+
+          CONFIG (API Keys):
+            gsd ai config list                      # Listar todas API keys
+            gsd ai config set openrouter <key>      # Configurar OpenRouter
+            gsd ai config set anthropic <key>       # Configurar Anthropic
+            gsd ai config set openai <key>          # Configurar OpenAI
+            gsd ai config remove <provider>         # Remover API key
+
+          EXEMPLOS:
+            # Iniciar REPL interativo
+            gsd ai
+
+            # One-shot command
+            gsd ai "qual o estado atual do projeto?"
+
+            # Configurar API key (OpenRouter - gratuito)
+            gsd ai config set openrouter sk-or-v1-...
+
+            # Usar OpenRouter com Qwen (gratuito)
+            gsd ai --provider openrouter --model qwen/qwen-3.6-plus-preview:free
+
+            # Usar OpenAI
+            gsd ai --provider openai "explique este código"
+
+            # Usar Ollama local
+            gsd ai --provider ollama --model llama2 "o que é este projeto?"
+
+          VARIÁVEIS DE AMBIENTE:
+            OPENROUTER_API_KEY          API key para OpenRouter (gratuito)
+            ANTHROPIC_API_KEY           API key para Anthropic
+            OPENAI_API_KEY              API key para OpenAI
+
+          PROVIDERS:
+            anthropic                     Anthropic Claude (pago)
+            openai                        OpenAI GPT (pago)
+            openrouter                    OpenRouter (Qwen, Llama - gratuito)
+            ollama                        Ollama (local, gratuito)
+            lmstudio                      LM Studio (local, gratuito)
+
+          MODELOS GRATUITOS (OpenRouter):
+            qwen/qwen-3.6-plus-preview:free    - Qwen 3.6 Plus (1M contexto)
+            qwen/qwen-2.5-72b-instruct         - Qwen 2.5 72B
+            meta-llama/llama-3-70b-instruct    - Llama 3 70B
+            mistralai/mistral-7b-instruct      - Mistral 7B
+
+        HELP
+      end
+
+      # Executa comando config
+      #
+      # @param args [Array] Argumentos
+      # @return [void]
+      def run_config(args)
+        config = Gsd::AI::ConfigCLI.new(cwd: @cwd)
+        config.run(args)
+      end
+
+      # Imprime versão
+      #
+      # @return [void]
+      def print_version
+        puts "GSD AI Chat v0.1.0"
+      end
+    end
+  end
+end

data/lib/gsd/ai/command_parser.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Gsd
+  module AI
+    # CommandParser - Parser de comandos (/) e referências (@)
+    #
+    # Responsável por:
+    # - Detectar comandos que começam com /
+    # - Detectar referências que começam com @
+    # - Extrair argumentos e opções
+    class CommandParser
+      # Resultado do parsing
+      ParseResult = Struct.new(:type, :command, :args, :references, :raw, keyword_init: true)
+
+      # Parse input do usuário
+      #
+      # @param input [String] Texto digitado
+      # @return [ParseResult] Resultado estruturado
+      def self.parse(input)
+        return ParseResult.new(type: :empty, raw: input) if input.nil? || input.strip.empty?
+
+        trimmed = input.strip
+
+        # Comando: começa com /
+        if trimmed.start_with?('/')
+          return parse_command(trimmed)
+        end
+
+        # Referência: contém @
+        if trimmed.include?('@')
+          return parse_references(trimmed)
+        end
+
+        # Mensagem normal
+        ParseResult.new(type: :message, raw: input)
+      end
+
+      # Extrai referências de um texto
+      #
+      # @param text [String] Texto com @referências
+      # @return [Array<String>] Lista de referências sem o @
+      def self.extract_references(text)
+        return [] unless text.include?('@')
+
+        # Pattern: @path (até espaço, vírgula, ou fim)
+        text.scan(/@([^\s,]+)/).flatten
+      end
+
+      # Verifica se texto tem referências
+      #
+      # @param text [String] Texto a verificar
+      # @return [Boolean] true se tem @
+      def self.has_references?(text)
+        text&.include?('@') || false
+      end
+
+      # Verifica se é comando
+      #
+      # @param text [String] Texto a verificar
+      # @return [Boolean] true se começa com /
+      def self.command?(text)
+        text&.strip&.start_with?('/') || false
+      end
+
+      class << self
+        private
+
+        def parse_command(input)
+          # Remove / inicial e split
+          parts = input[1..].split
+          command = parts.first&.downcase
+          args = parts[1..] || []
+
+          ParseResult.new(
+            type: :command,
+            command: command,
+            args: args,
+            references: [],
+            raw: input
+          )
+        end
+
+        def parse_references(input)
+          refs = extract_references(input)
+
+          ParseResult.new(
+            type: :reference,
+            command: nil,
+            args: [],
+            references: refs,
+            raw: input
+          )
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/base.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Gsd
+  module AI
+    module Commands
+      # Base class para comandos /
+      class Base
+        attr_reader :chat, :args
+
+        # Inicializa comando
+        #
+        # @param chat [Chat] Instância do chat
+        # @param args [Array<String>] Argumentos do comando
+        def initialize(chat, args = [])
+          @chat = chat
+          @args = args
+        end
+
+        # Executa o comando
+        #
+        # @return [String] Resposta do comando
+        def execute
+          raise NotImplementedError
+        end
+
+        # Descrição do comando para help
+        #
+        # @return [String] Descrição
+        def description
+          self.class::DESCRIPTION
+        end
+
+        # Uso do comando para help
+        #
+        # @return [String] Uso
+        def usage
+          self.class::USAGE
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/clear.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/commands/base'
+
+module Gsd
+  module AI
+    module Commands
+      # /clear - Limpa histórico
+      class Clear < Base
+        DESCRIPTION = 'Limpa o histórico atual'
+        USAGE = '/clear'
+
+        def execute
+          chat.clear_history
+          '🧹 Histórico limpo.'
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/context.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/commands/base'
+
+module Gsd
+  module AI
+    module Commands
+      # /context - Mostra tamanho do contexto
+      class Context < Base
+        DESCRIPTION = 'Mostra tamanho do contexto'
+        USAGE = '/context'
+
+        def execute
+          ctx = chat.context
+          info = ctx.cache_info rescue { size: 'unknown', age: 'unknown' }
+          size = ctx.size rescue 0
+
+          <<~CONTEXT
+            📊 Contexto atual:
+
+            Mensagens: #{chat.history.messages.count}
+            Tamanho cache: #{size} bytes
+            Cache info: #{info[:size]}
+            Idade cache: #{info[:age]}s
+          CONTEXT
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/cost.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/commands/base'
+
+module Gsd
+  module AI
+    module Commands
+      # /cost - Mostra estatísticas de custo
+      class Cost < Base
+        DESCRIPTION = 'Mostra estatísticas de custo'
+        USAGE = '/cost'
+
+        def execute
+          stats = chat.cost_tracker.stats
+
+          <<~COST
+            💰 Estatísticas de custo:
+
+            Total gasto: $#{stats[:total_cost]&.round(4) || 0}
+            Total tokens: #{stats[:total_tokens] || 0}
+            Orçamento: $#{stats[:budget] || 100}
+            Restante: $#{stats[:budget_remaining]&.round(4) || 100}
+            Usado: #{stats[:budget_used_percent]&.round(2) || 0}%
+            Requisições: #{stats[:requests_count] || 0}
+          COST
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/export.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/commands/base'
+require 'json'
+require 'time'
+
+module Gsd
+  module AI
+    module Commands
+      # /export - Exporta histórico
+      class Export < Base
+        DESCRIPTION = 'Exporta histórico para arquivo'
+        USAGE = '/export [arquivo.json]'
+
+        DEFAULT_FILE = '.gsd/ai/history_export.json'
+
+        def execute
+          filename = args.first || DEFAULT_FILE
+          path = File.expand_path(filename, chat.instance_variable_get(:@cwd))
+
+          export_data = {
+            exported_at: Time.now.iso8601,
+            model: begin
+              chat.provider.model
+            rescue
+              'unknown'
+            end,
+            cost: chat.cost_tracker.stats,
+            messages: chat.history.messages
+          }
+
+          FileUtils.mkdir_p(File.dirname(path))
+          File.write(path, JSON.pretty_generate(export_data))
+
+          "💾 Histórico exportado para: #{path}"
+        rescue => e
+          "❌ Erro ao exportar: #{e.message}"
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/help.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/commands/base'
+
+module Gsd
+  module AI
+    module Commands
+      # /help - Lista comandos disponíveis
+      class Help < Base
+        DESCRIPTION = 'Lista comandos disponíveis'
+        USAGE = '/help [comando]'
+
+        # Comandos registrados
+        COMMANDS = {
+          'help' => 'Lista comandos disponíveis',
+          'clear' => 'Limpa o histórico atual',
+          'reset' => 'Reseta contexto e histórico',
+          'model' => 'Muda ou lista modelos',
+          'cost' => 'Mostra estatísticas de custo',
+          'context' => 'Mostra tamanho do contexto',
+          'export' => 'Exporta histórico para arquivo'
+        }.freeze
+
+        def execute
+          if args.any?
+            cmd = args.first.downcase
+            return "Comando desconhecido: /#{cmd}" unless COMMANDS.key?(cmd)
+
+            <<~HELP
+              /#{cmd} - #{COMMANDS[cmd]}
+              Uso: #{usage_for(cmd)}
+            HELP
+          else
+            list = COMMANDS.map { |cmd, desc| "  /#{cmd} - #{desc}" }.join("\n")
+            <<~HELP
+              Comandos disponíveis:
+              #{list}
+
+              Referências:
+                @arquivo.rb - Injeta conteúdo do arquivo
+                @pasta/ - Lista arquivos da pasta
+                @imagem.png - Anexa imagem (se suportado)
+
+              Use /help <comando> para detalhes.
+            HELP
+          end
+        end
+
+        private
+
+        def usage_for(cmd)
+          case cmd
+          when 'model' then '/model [nome] (sem nome lista disponíveis)'
+          when 'export' then '/export [arquivo.json]'
+          else "/#{cmd}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/model.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/commands/base'
+
+module Gsd
+  module AI
+    module Commands
+      # /model - Muda ou lista modelos
+      class Model < Base
+        DESCRIPTION = 'Muda ou lista modelos disponíveis'
+        USAGE = '/model [nome]'
+
+        # Modelos disponíveis por provider
+        MODELS = {
+          'anthropic' => %w[claude-sonnet-4-5-20250929 claude-3-opus-20240229 claude-3-haiku-20240307],
+          'openai' => %w[gpt-4-turbo gpt-4 gpt-3.5-turbo],
+          'ollama' => %w[llama3.3 mistral qwen2.5],
+          'openrouter' => %w[qwen/qwen-3.6-plus-preview:free meta-llama/llama-3-70b-instruct]
+        }.freeze
+
+        def execute
+          if args.any?
+            change_model(args.first)
+          else
+            list_models
+          end
+        end
+
+        private
+
+        def change_model(model_name)
+          provider = chat.provider
+
+          if provider.respond_to?(:model=)
+            provider.model = model_name
+            "✅ Modelo alterado para: #{model_name}"
+          else
+            "⚠️ Provider atual não suporta troca de modelo em runtime.\nUse --model ao iniciar."
+          end
+        rescue => e
+          "❌ Erro ao alterar modelo: #{e.message}"
+        end
+
+        def list_models
+          current = begin
+            chat.provider.model
+          rescue
+            'unknown'
+          end
+
+          lines = MODELS.map do |provider, models|
+            list = models.map { |m| m == current ? "→ #{m}" : "  #{m}" }.join("\n")
+            "#{provider}:\n#{list}"
+          end
+
+          <<~MODELS
+            Modelos disponíveis (atual: #{current}):
+
+            #{lines.join("\n\n")}
+
+            Use /model <nome> para trocar.
+          MODELS
+        end
+      end
+    end
+  end
+end

data/lib/gsd/ai/commands/reset.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'gsd/ai/commands/base'
+
+module Gsd
+  module AI
+    module Commands
+      # /reset - Reseta tudo
+      class Reset < Base
+        DESCRIPTION = 'Reseta contexto e histórico'
+        USAGE = '/reset'
+
+        def execute
+          chat.clear_history
+          chat.context.clear_cache if chat.context.respond_to?(:clear_cache)
+          chat.cost_tracker.reset if chat.cost_tracker.respond_to?(:reset)
+          '🔄 Contexto e histórico resetados.'
+        end
+      end
+    end
+  end
+end