fantasy-cli 1.2.6

data/lib/gsd/plugins/cli.rb

@@ -0,0 +1,330 @@
+# frozen_string_literal: true
+
+require 'gsd/plugins/manager'
+require 'gsd/plugins/installer'
+require 'gsd/plugins/marketplace'
+require 'gsd/plugins/search'
+
+module Gsd
+  module Plugins
+    # Plugin CLI - Interface de linha de comando para plugins
+    #
+    # Comandos:
+    #   gsd plugins list
+    #   gsd plugins install <name|url>
+    #   gsd plugins uninstall <name>
+    #   gsd plugins update <name>
+    #   gsd plugins search <query>
+    #   gsd plugins info <name>
+    #   gsd plugins enable <name>
+    #   gsd plugins disable <name>
+    class CLI
+      attr_reader :manager, :installer, :marketplace, :search
+
+      # Inicializa o CLI
+      #
+      # @param args [Array] Argumentos de linha de comando
+      def initialize(args = [])
+        @args = args
+        @manager = Manager.new
+        @installer = Installer.new
+        @marketplace = MarketplaceClient.new
+        @search = Search.new(client: @marketplace)
+      end
+
+      # Executa o comando
+      #
+      # @return [Integer] Exit code
+      def run
+        command = @args.first
+
+        case command
+        when 'list'
+          cmd_list
+        when 'install'
+          cmd_install
+        when 'uninstall'
+          cmd_uninstall
+        when 'update'
+          cmd_update
+        when 'search'
+          cmd_search
+        when 'info'
+          cmd_info
+        when 'enable'
+          cmd_enable
+        when 'disable'
+          cmd_disable
+        when 'help', '--help', '-h', nil
+          print_help
+          0
+        else
+          warn "Unknown command: #{command}"
+          print_help
+          1
+        end
+      rescue => e
+        warn "Error: #{e.message}"
+        1
+      end
+
+      private
+
+      # Comando: list
+      #
+      # @return [Integer] Exit code
+      def cmd_list
+        plugins = @manager.list
+
+        if plugins.empty?
+          puts "No plugins installed."
+          puts "\nInstall plugins with:"
+          puts "  gsd plugins install <name|url>"
+          return 0
+        end
+
+        puts "Installed plugins:"
+        puts "=" * 60
+
+        plugins.each do |plugin|
+          status = plugin[:enabled] ? '✓' : '✗'
+          puts "#{status} #{plugin[:name]} v#{plugin[:version]}"
+          puts "   #{plugin[:description]}"
+          puts "   Author: #{plugin[:author]}" if plugin[:author]
+          puts
+        end
+
+        stats = @manager.stats
+        puts "=" * 60
+        puts "Total: #{stats[:total]} | Enabled: #{stats[:enabled]} | Disabled: #{stats[:disabled]}"
+
+        0
+      end
+
+      # Comando: install
+      #
+      # @return [Integer] Exit code
+      def cmd_install
+        source = @args[1]
+
+        unless source
+          warn "Usage: gsd plugins install <name|url>"
+          return 1
+        end
+
+        puts "Installing plugin: #{source}..."
+
+        if @installer.install(source)
+          puts "✓ Plugin installed successfully!"
+          0
+        else
+          warn "✗ Failed to install plugin"
+          1
+        end
+      end
+
+      # Comando: uninstall
+      #
+      # @return [Integer] Exit code
+      def cmd_uninstall
+        name = @args[1]
+
+        unless name
+          warn "Usage: gsd plugins uninstall <name>"
+          return 1
+        end
+
+        unless @installer.installed?(name)
+          warn "Plugin not installed: #{name}"
+          return 1
+        end
+
+        print "Uninstalling plugin #{name}... "
+
+        if @installer.uninstall(name)
+          puts "✓"
+          0
+        else
+          puts "✗"
+          1
+        end
+      end
+
+      # Comando: update
+      #
+      # @return [Integer] Exit code
+      def cmd_update
+        name = @args[1]
+
+        unless name
+          warn "Usage: gsd plugins update <name>"
+          return 1
+        end
+
+        puts "Updating plugin: #{name}..."
+
+        if @installer.update(name)
+          puts "✓ Plugin updated successfully!"
+          0
+        else
+          warn "✗ Failed to update plugin"
+          1
+        end
+      end
+
+      # Comando: search
+      #
+      # @return [Integer] Exit code
+      def cmd_search
+        query = @args[1]
+
+        unless query
+          warn "Usage: gsd plugins search <query>"
+          return 1
+        end
+
+        puts "Searching for: #{query}..."
+        puts "=" * 60
+
+        begin
+          results = @search.search(query)
+
+          if results.empty?
+            puts "No plugins found."
+            return 0
+          end
+
+          results.each do |plugin|
+            puts "#{plugin['name']} v#{plugin['version']}"
+            puts "   #{plugin['description']}"
+            puts "   Rating: #{plugin['rating']} ⭐ | Downloads: #{plugin['downloads']}"
+            puts
+          end
+
+          puts "=" * 60
+          puts "Found #{results.count} plugin(s)"
+
+        rescue => e
+          warn "Search error: #{e.message}"
+          return 1
+        end
+
+        0
+      end
+
+      # Comando: info
+      #
+      # @return [Integer] Exit code
+      def cmd_info
+        name = @args[1]
+
+        unless name
+          warn "Usage: gsd plugins info <name>"
+          return 1
+        end
+
+        begin
+          plugin = @marketplace.get_plugin(name)
+
+          unless plugin
+            warn "Plugin not found: #{name}"
+            return 1
+          end
+
+          puts "Plugin: #{plugin['name']} v#{plugin['version']}"
+          puts "=" * 60
+          puts "Description: #{plugin['description']}"
+          puts "Author: #{plugin['author']}" if plugin['author']
+          puts "Category: #{plugin['category']}" if plugin['category']
+          puts "Tags: #{plugin['tags'].join(', ')}" if plugin['tags']
+          puts "Rating: #{plugin['rating']} ⭐ (#{plugin['downloads']} downloads)"
+          puts "Source: #{plugin['source_url']}" if plugin['source_url']
+          puts "Updated: #{plugin['updated_at']}" if plugin['updated_at']
+          puts "=" * 60
+
+        rescue => e
+          warn "Error: #{e.message}"
+          return 1
+        end
+
+        0
+      end
+
+      # Comando: enable
+      #
+      # @return [Integer] Exit code
+      def cmd_enable
+        name = @args[1]
+
+        unless name
+          warn "Usage: gsd plugins enable <name>"
+          return 1
+        end
+
+        if @manager.enable(name)
+          puts "✓ Plugin #{name} enabled"
+          0
+        else
+          warn "✗ Failed to enable plugin #{name}"
+          1
+        end
+      end
+
+      # Comando: disable
+      #
+      # @return [Integer] Exit code
+      def cmd_disable
+        name = @args[1]
+
+        unless name
+          warn "Usage: gsd plugins disable <name>"
+          return 1
+        end
+
+        if @manager.disable(name)
+          puts "✓ Plugin #{name} disabled"
+          0
+        else
+          warn "✗ Failed to disable plugin #{name}"
+          1
+        end
+      end
+
+      # Imprime ajuda
+      #
+      # @return [void]
+      def print_help
+        puts <<~HELP
+
+          GSD Plugins CLI
+
+          USAGE:
+            gsd plugins <command> [args]
+
+          COMMANDS:
+            list                     List installed plugins
+            install <name|url>       Install plugin
+            uninstall <name>         Uninstall plugin
+            update <name>            Update plugin
+            search <query>           Search marketplace
+            info <name>              Plugin information
+            enable <name>            Enable plugin
+            disable <name>           Disable plugin
+            help                     Show this help
+
+          EXAMPLES:
+            gsd plugins list
+            gsd plugins install github-plugin
+            gsd plugins install https://github.com/user/plugin.zip
+            gsd plugins uninstall github-plugin
+            gsd plugins update github-plugin
+            gsd plugins search github
+            gsd plugins info github-plugin
+            gsd plugins enable github-plugin
+            gsd plugins disable github-plugin
+
+        HELP
+      end
+    end
+  end
+end

data/lib/gsd/plugins/config.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'fileutils'
+
+module Gsd
+  module Plugins
+    # Plugin Config - Gerencia configurações de plugins
+    #
+    # Responsável por:
+    # - Armazenar configurações por plugin
+    # - Carregar configurações salvas
+    # - Validar configurações
+    class Config
+      attr_reader :config_dir
+
+      # Inicializa o Config
+      #
+      # @param config_dir [String] Diretório de configurações
+      def initialize(config_dir: nil)
+        @config_dir = config_dir || File.join(Dir.home, '.gsd', 'plugins', 'config')
+        ensure_config_dir
+      end
+
+      # Obtém configuração de um plugin
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @param key [String, nil] Chave específica
+      # @return [Hash, Object] Configuração ou valor
+      def get(plugin_name, key = nil)
+        config = load_config(plugin_name)
+        key ? config[key] : config
+      end
+
+      # Define configuração de um plugin
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @param key [String, Hash] Chave ou hash de configurações
+      # @param value [Object] Valor (se key for string)
+      # @return [void]
+      def set(plugin_name, key, value = nil)
+        config = load_config(plugin_name)
+
+        if key.is_a?(Hash)
+          config.merge!(key)
+        else
+          config[key] = value
+        end
+
+        save_config(plugin_name, config)
+      end
+
+      # Remove configuração de um plugin
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @param key [String, nil] Chave específica
+      # @return [void]
+      def delete(plugin_name, key = nil)
+        return unless config_exists?(plugin_name)
+
+        if key
+          config = load_config(plugin_name)
+          config.delete(key)
+          save_config(plugin_name, config)
+        else
+          remove_config(plugin_name)
+        end
+      end
+
+      # Verifica se plugin tem configuração
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @return [Boolean] true se existe
+      def config_exists?(plugin_name)
+        File.exist?(config_file(plugin_name))
+      end
+
+      # Lista todos os plugins com configuração
+      #
+      # @return [Array<String>] Nomes dos plugins
+      def list_plugins
+        Dir.children(@config_dir).select do |child|
+          File.file?(File.join(@config_dir, child)) && child.end_with?('.json')
+        end.map { |f| f.gsub('.json', '') }
+      end
+
+      # Reseta configuração de um plugin
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @return [void]
+      def reset(plugin_name)
+        remove_config(plugin_name)
+      end
+
+      # Exporta configurações
+      #
+      # @return [Hash] Todas as configurações
+      def export
+        result = {}
+        list_plugins.each do |plugin_name|
+          result[plugin_name] = load_config(plugin_name)
+        end
+        result
+      end
+
+      # Importa configurações
+      #
+      # @param configs [Hash] Configurações para importar
+      # @return [void]
+      def import(configs)
+        configs.each do |plugin_name, config|
+          save_config(plugin_name, config)
+        end
+      end
+
+      private
+
+      # Garante que diretório existe
+      #
+      # @return [void]
+      def ensure_config_dir
+        FileUtils.mkdir_p(@config_dir) unless File.directory?(@config_dir)
+      end
+
+      # Caminho do arquivo de configuração
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @return [String] Caminho do arquivo
+      def config_file(plugin_name)
+        File.join(@config_dir, "#{plugin_name}.json")
+      end
+
+      # Carrega configuração
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @return [Hash] Configuração
+      def load_config(plugin_name)
+        return {} unless config_exists?(plugin_name)
+
+        JSON.parse(File.read(config_file(plugin_name)))
+      rescue => e
+        warn "[Plugin Config] Error loading config for #{plugin_name}: #{e.message}"
+        {}
+      end
+
+      # Salva configuração
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @param config [Hash] Configuração
+      # @return [void]
+      def save_config(plugin_name, config)
+        File.write(config_file(plugin_name), JSON.pretty_generate(config))
+      end
+
+      # Remove configuração
+      #
+      # @param plugin_name [String] Nome do plugin
+      # @return [void]
+      def remove_config(plugin_name)
+        File.delete(config_file(plugin_name)) if config_exists?(plugin_name)
+      end
+    end
+  end
+end

data/lib/gsd/plugins/hooks.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module Gsd
+  module Plugins
+    # Plugin Hooks - Sistema de hooks para plugins
+    #
+    # Responsável por:
+    # - Registrar hooks de plugins
+    # - Executar hooks em eventos
+    # - Gerenciar prioridade de hooks
+    class Hooks
+      attr_reader :hooks
+
+      # Hook types
+      HOOK_TYPES = [
+        :pre_command,
+        :post_command,
+        :pre_tool,
+        :post_tool,
+        :pre_commit,
+        :post_phase,
+        :on_enable,
+        :on_disable
+      ].freeze
+
+      # Inicializa o Hooks
+      def initialize
+        @hooks = {}
+        HOOK_TYPES.each { |type| @hooks[type] = [] }
+      end
+
+      # Registra um hook
+      #
+      # @param type [Symbol] Tipo do hook
+      # @param plugin [String] Nome do plugin
+      # @param callback [Proc] Callback para executar
+      # @param priority [Integer] Prioridade (maior = primeiro)
+      # @return [void]
+      def register(type, plugin, callback, priority: 0)
+        unless HOOK_TYPES.include?(type)
+          raise ArgumentError, "Invalid hook type: #{type}"
+        end
+
+        @hooks[type] << {
+          plugin: plugin,
+          callback: callback,
+          priority: priority,
+          registered_at: Time.now
+        }
+
+        # Ordena por prioridade
+        @hooks[type].sort_by! { |h| -h[:priority] }
+      end
+
+      # Remove hook de um plugin
+      #
+      # @param plugin [String] Nome do plugin
+      # @return [void]
+      def unregister(plugin)
+        @hooks.each do |type, hook_list|
+          @hooks[type] = hook_list.reject { |h| h[:plugin] == plugin }
+        end
+      end
+
+      # Executa hooks de um tipo
+      #
+      # @param type [Symbol] Tipo do hook
+      # @param context [Hash] Contexto para o hook
+      # @return [Array] Resultados dos hooks
+      def run(type, context = {})
+        unless HOOK_TYPES.include?(type)
+          raise ArgumentError, "Invalid hook type: #{type}"
+        end
+
+        results = []
+        @hooks[type].each do |hook|
+          begin
+            result = hook[:callback].call(context)
+            results << {
+              plugin: hook[:plugin],
+              result: result,
+              success: true
+            }
+          rescue => e
+            results << {
+              plugin: hook[:plugin],
+              error: e.message,
+              success: false
+            }
+            warn "[Hooks] Error in #{type} hook (#{hook[:plugin]}): #{e.message}"
+          end
+        end
+
+        results
+      end
+
+      # Lista hooks registrados
+      #
+      # @param type [Symbol, nil] Tipo específico
+      # @return [Array<Hash>] Lista de hooks
+      def list(type = nil)
+        if type
+          @hooks[type] || []
+        else
+          @hooks
+        end
+      end
+
+      # Conta hooks por tipo
+      #
+      # @return [Hash] Contagem por tipo
+      def count
+        @hooks.transform_values(&:count)
+      end
+
+      # Limpa todos os hooks
+      #
+      # @return [void]
+      def clear
+        HOOK_TYPES.each { |type| @hooks[type] = [] }
+      end
+
+      # Limpa hooks de um tipo
+      #
+      # @param type [Symbol] Tipo do hook
+      # @return [void]
+      def clear_type(type)
+        @hooks[type] = [] if HOOK_TYPES.include?(type)
+      end
+    end
+  end
+end