fantasy-cli 1.2.6

data/lib/gsd/buddy/gacha.rb

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+require 'digest/md5'
+
+module Gsd
+  module Buddy
+    # Gacha - Sistema gacha para obter buddies
+    #
+    # Features:
+    # - Deterministic (seed = userId)
+    # - Rarity weights
+    # - Pity system (guaranteed epic+ after 50 pulls)
+    class Gacha
+      attr_reader :user_id, :pull_count, :pity_count
+
+      # Inicializa o Gacha
+      #
+      # @param user_id [String] ID do usuário (seed)
+      def initialize(user_id:)
+        @user_id = user_id
+        @pull_count = 0
+        @pity_count = 0
+        @seed = Digest::MD5.hexdigest(user_id).to_i(16)
+      end
+
+      # Faz um pull no gacha
+      #
+      # @return [Hash] Resultado do pull
+      def pull
+        @pull_count += 1
+        @pity_count += 1
+
+        # Pity system: guaranteed epic+ after 50 pulls
+        if @pity_count >= 50
+          result = pull_with_rarity(:epic_or_legendary)
+          @pity_count = 0
+          return result
+        end
+
+        # Roll for rarity
+        rarity = roll_rarity
+
+        # Pull species of that rarity
+        pull_with_rarity(rarity)
+      end
+
+      # Faz múltiplos pulls
+      #
+      # @param count [Integer] Número de pulls
+      # @return [Array<Hash>] Resultados
+      def pull_many(count)
+        count.times.map { pull }
+      end
+
+      # Reseta pity counter
+      #
+      # @return [void]
+      def reset_pity
+        @pity_count = 0
+      end
+
+      # Estatísticas do gacha
+      #
+      # @return [Hash] Estatísticas
+      def stats
+        {
+          user_id: @user_id,
+          pull_count: @pull_count,
+          pity_count: @pity_count,
+          seed: @seed
+        }
+      end
+
+      private
+
+      # Roll para determinar raridade
+      #
+      # @return [Symbol] Raridade
+      def roll_rarity
+        weights = Species.rarity_weights
+        total = weights.values.sum
+        roll = seeded_random % total
+
+        cumulative = 0
+        weights.each do |rarity, weight|
+          cumulative += weight
+          return rarity if roll < cumulative
+        end
+
+        :common
+      end
+
+      # Pull com raridade específica
+      #
+      # @param rarity [Symbol] Raridade
+      # @return [Hash] Resultado
+      def pull_with_rarity(rarity)
+        # Handle epic_or_legendary for pity
+        if rarity == :epic_or_legendary
+          rarity = seeded_random(2) == 0 ? :epic : :legendary
+        end
+
+        # Get species of that rarity
+        species_keys = Species.by_rarity(rarity)
+        species_key = species_keys[seeded_random(species_keys.length)]
+        species = Species.get(species_key)
+
+        # Generate stats with some variance
+        stats = generate_stats(species[:base_stats])
+
+        result = {
+          species: species_key,
+          name: species[:name],
+          rarity: rarity,
+          stats: stats,
+          ascii: species[:ascii],
+          pull_number: @pull_count
+        }
+
+        result
+      end
+
+      # Gera stats com variância
+      #
+      # @param base_stats [Hash] Stats base
+      # @return [Hash] Stats gerados
+      def generate_stats(base_stats)
+        stats = {}
+        base_stats.each do |stat, value|
+          # Variance: -1 to +2
+          variance = seeded_random(4) - 1
+          stats[stat] = [1, value + variance, 10].clamp
+        end
+        stats
+      end
+
+      # Random number generator com seed
+      #
+      # @param max [Integer] Maximum value
+      # @return [Integer] Random number
+      def seeded_random(max = 100)
+        # Linear congruential generator
+        @seed = (@seed * 1103515245 + 12345) & 0x7fffffff
+        @seed % max
+      end
+    end
+  end
+end

data/lib/gsd/buddy/renderer.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module Gsd
+  module Buddy
+    # Renderer - Renderiza buddy no terminal
+    #
+    # Features:
+    # - ASCII art
+    # - Stats display
+    # - Stage indicator
+    class Renderer
+      # Renderiza buddy
+      #
+      # @param buddy [Buddy] Buddy para renderizar
+      # @return [String] Buddy renderizado
+      def render(buddy)
+        lines = []
+
+        # ASCII art
+        lines << buddy.ascii
+        lines << ''
+
+        # Info
+        lines << "Name: #{buddy.name}"
+        lines << "Stage: #{buddy.stage}"
+        lines << "Level: #{buddy.level}"
+        lines << ''
+
+        # Stats
+        lines << 'Stats:'
+        buddy.stats.all.each do |stat, value|
+          bar = render_bar(value, 10)
+          lines << "  #{stat.to_s.upcase.ljust(12)}: #{bar} #{value}/10"
+        end
+        lines << ''
+
+        # Interactions
+        lines << "Interactions: #{buddy.interactions}"
+        lines << "Total Score: #{buddy.stats.total_score}"
+
+        lines.join("\n")
+      end
+
+      # Renderiza lista de buddies
+      #
+      # @param buddies [Array<Buddy>] Lista de buddies
+      # @return [String] Lista renderizada
+      def render_list(buddies)
+        lines = []
+        lines << 'Your Buddies:'
+        lines << '=' * 60
+
+        buddies.each do |buddy|
+          lines << "#{buddy.ascii}  #{buddy.name} (#{buddy.rarity}) - Level #{buddy.level}"
+          lines << "   Stage: #{buddy.stage} | Score: #{buddy.stats.total_score}"
+          lines << ''
+        end
+
+        lines << '=' * 60
+        lines << "Total: #{buddies.count} buddy(ies)"
+
+        lines.join("\n")
+      end
+
+      # Renderiza barra de progresso
+      #
+      # @param current [Integer] Valor atual
+      # @param max [Integer] Valor máximo
+      # @param filled [String] Caractere preenchido
+      # @param empty [String] Caractere vazio
+      # @return [String] Barra renderizada
+      def render_bar(current, max, filled: '█', empty: '░')
+        filled_count = (current.to_f / max * 10).round
+        empty_count = 10 - filled_count
+        filled * filled_count + empty * empty_count
+      end
+
+      # Renderiza comparação de stats
+      #
+      # @param buddy1 [Buddy] Primeiro buddy
+      # @param buddy2 [Buddy] Segundo buddy
+      # @return [String] Comparação renderizada
+      def render_comparison(buddy1, buddy2)
+        lines = []
+        lines << 'Stats Comparison:'
+        lines << '=' * 60
+
+        Buddy::Stats::STAT_NAMES.each do |stat|
+          v1 = buddy1.stats.get(stat)
+          v2 = buddy2.stats.get(stat)
+
+          bar1 = render_bar(v1, 10)
+          bar2 = render_bar(v2, 10)
+
+          lines << "#{stat.to_s.upcase.ljust(12)}:"
+          lines << "  #{buddy1.name.ljust(15)}: #{bar1} #{v1}"
+          lines << "  #{buddy2.name.ljust(15)}: #{bar2} #{v2}"
+          lines << ''
+        end
+
+        lines << '=' * 60
+        lines << "Total: #{buddy1.stats.total_score} vs #{buddy2.stats.total_score}"
+
+        lines.join("\n")
+      end
+    end
+  end
+end

data/lib/gsd/buddy/species.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+module Gsd
+  module Buddy
+    # Species - Definição das 18 espécies de buddies
+    #
+    # Espécies por raridade:
+    # - Common (50%): Pebblecrab, Codebug, Scriptling
+    # - Uncommon (30%): Bytebird, Loopfox, Debugdeer
+    # - Rare (15%): Testurtle, Refactoray, Mergebat
+    # - Epic (4%): Deploydragon, Pipelineon, Commitcat
+    # - Legendary (1%): Nebulynx, Quantumquail
+    module Species
+      # Todas as espécies
+      ALL = {
+        # Common
+        pebblecrab: {
+          name: 'Pebblecrab',
+          rarity: :common,
+          base_stats: { debugging: 3, chaos: 2, snark: 1, focus: 4, creativity: 2 },
+          ascii: '/ᐠ｡‿｡ᐟ\\',
+          description: 'A cute crab that lives in pebbles. Good at debugging.'
+        },
+        codebug: {
+          name: 'Codebug',
+          rarity: :common,
+          base_stats: { debugging: 4, chaos: 3, snark: 1, focus: 3, creativity: 1 },
+          ascii: '🐛',
+          description: 'A friendly bug that helps find other bugs.'
+        },
+        scriptling: {
+          name: 'Scriptling',
+          rarity: :common,
+          base_stats: { debugging: 2, chaos: 2, snark: 2, focus: 3, creativity: 3 },
+          ascii: '📜',
+          description: 'A small spirit that inhabits scripts.'
+        },
+
+        # Uncommon
+        bytebird: {
+          name: 'Bytebird',
+          rarity: :uncommon,
+          base_stats: { debugging: 4, chaos: 2, snark: 2, focus: 4, creativity: 3 },
+          ascii: '🐦',
+          description: 'A bird that carries bytes of information.'
+        },
+        loopfox: {
+          name: 'Loopfox',
+          rarity: :uncommon,
+          base_stats: { debugging: 5, chaos: 3, snark: 3, focus: 4, creativity: 2 },
+          ascii: '🦊',
+          description: 'A clever fox that loops around problems.'
+        },
+        debugdeer: {
+          name: 'Debugdeer',
+          rarity: :uncommon,
+          base_stats: { debugging: 6, chaos: 2, snark: 2, focus: 5, creativity: 2 },
+          ascii: '🦌',
+          description: 'A deer with antlers that point to bugs.'
+        },
+
+        # Rare
+        testurtle: {
+          name: 'Testurtle',
+          rarity: :rare,
+          base_stats: { debugging: 5, chaos: 1, snark: 2, focus: 6, creativity: 3 },
+          ascii: '🐢',
+          description: 'A slow but steady turtle that tests everything.'
+        },
+        refactoray: {
+          name: 'Refactoray',
+          rarity: :rare,
+          base_stats: { debugging: 4, chaos: 2, snark: 3, focus: 5, creativity: 5 },
+          ascii: '✨',
+          description: 'A manta ray that glides through code refactoring.'
+        },
+        mergebat: {
+          name: 'Mergebat',
+          rarity: :rare,
+          base_stats: { debugging: 5, chaos: 4, snark: 3, focus: 4, creativity: 3 },
+          ascii: '🦇',
+          description: 'A bat that merges code in the dark.'
+        },
+
+        # Epic
+        deploydragon: {
+          name: 'Deploydragon',
+          rarity: :epic,
+          base_stats: { debugging: 7, chaos: 5, snark: 4, focus: 6, creativity: 5 },
+          ascii: '🐉',
+          description: 'A mighty dragon that breathes fire on deployments.'
+        },
+        pipelineon: {
+          name: 'Pipelineon',
+          rarity: :epic,
+          base_stats: { debugging: 6, chaos: 3, snark: 3, focus: 8, creativity: 4 },
+          ascii: '🔷',
+          description: 'A lion that rules the CI/CD pipeline.'
+        },
+        commitcat: {
+          name: 'Commitcat',
+          rarity: :epic,
+          base_stats: { debugging: 6, chaos: 4, snark: 5, focus: 6, creativity: 5 },
+          ascii: '🐱',
+          description: 'A cat that commits code with style.'
+        },
+
+        # Legendary
+        nebulynx: {
+          name: 'Nebulynx',
+          rarity: :legendary,
+          base_stats: { debugging: 9, chaos: 4, snark: 5, focus: 8, creativity: 7 },
+          ascii: '🔮',
+          description: 'A mystical lynx from the nebula. Ultimate debugging powers.'
+        },
+        quantumquail: {
+          name: 'Quantumquail',
+          rarity: :legendary,
+          base_stats: { debugging: 8, chaos: 6, snark: 4, focus: 7, creativity: 9 },
+          ascii: '⚛️',
+          description: 'A quail that exists in multiple states simultaneously.'
+        }
+      }.freeze
+
+      # Retorna espécie por nome
+      #
+      # @param name [Symbol] Nome da espécie
+      # @return [Hash, nil] Espécie ou nil
+      def self.get(name)
+        ALL[name]
+      end
+
+      # Retorna espécies por raridade
+      #
+      # @param rarity [Symbol] Raridade
+      # @return [Array<Symbol>] Lista de espécies
+      def self.by_rarity(rarity)
+        ALL.select { |_, s| s[:rarity] == rarity }.keys
+      end
+
+      # Retorna todas as espécies comuns
+      #
+      # @return [Array<Symbol>] Espécies comuns
+      def self.common
+        by_rarity(:common)
+      end
+
+      # Retorna todas as espécies incomuns
+      #
+      # @return [Array<Symbol>] Espécies incomuns
+      def self.uncommon
+        by_rarity(:uncommon)
+      end
+
+      # Retorna todas as espécies raras
+      #
+      # @return [Array<Symbol>] Espécies raras
+      def self.rare
+        by_rarity(:rare)
+      end
+
+      # Retorna todas as espécies épicas
+      #
+      # @return [Array<Symbol>] Espécies épicas
+      def self.epic
+        by_rarity(:epic)
+      end
+
+      # Retorna todas as espécies lendárias
+      #
+      # @return [Array<Symbol>] Espécies lendárias
+      def self.legendary
+        by_rarity(:legendary)
+      end
+
+      # Pesos de raridade para gacha
+      #
+      # @return [Hash] Pesos
+      def self.rarity_weights
+        {
+          common: 50,
+          uncommon: 30,
+          rare: 15,
+          epic: 4,
+          legendary: 1
+        }
+      end
+    end
+  end
+end

data/lib/gsd/buddy/stats.rb

@@ -0,0 +1,156 @@
+# frozen_string_literal: true
+
+module Gsd
+  module Buddy
+    # Stats - Gerenciamento de stats do buddy
+    #
+    # Stats:
+    # - DEBUGGING: Habilidade de debug
+    # - CHAOS: Tendência a causar bugs
+    # - SNARK: Sarcasmo nas respostas
+    # - FOCUS: Concentração em tarefas
+    # - CREATIVITY: Criatividade em soluções
+    class Stats
+      STAT_NAMES = [:debugging, :chaos, :snark, :focus, :creativity].freeze
+
+      attr_reader :stats, :interactions, :level
+
+      # Inicializa os Stats
+      #
+      # @param base_stats [Hash] Stats base da espécie
+      def initialize(base_stats)
+        @stats = base_stats.dup
+        @interactions = 0
+        @level = 1
+        @exp = 0
+      end
+
+      # Incrementa interação
+      #
+      # @return [void]
+      def increment_interaction
+        @interactions += 1
+        @exp += 10
+        check_level_up
+      end
+
+      # Verifica se subiu de nível
+      #
+      # @return [Boolean] true se subiu de nível
+      def check_level_up
+        exp_needed = @level * 100
+
+        if @exp >= exp_needed
+          @level += 1
+          @exp = 0
+          level_up
+          true
+        else
+          false
+        end
+      end
+
+      # Sobe de nível
+      #
+      # @return [void]
+      def level_up
+        # Increase random stat
+        stat = STAT_NAMES.sample
+        @stats[stat] = [@stats[stat] + 1, 10].min
+      end
+
+      # Obtém stat
+      #
+      # @param name [Symbol] Nome do stat
+      # @return [Integer] Valor do stat
+      def get(name)
+        @stats[name] || 0
+      end
+
+      # Define stat
+      #
+      # @param name [Symbol] Nome do stat
+      # @param value [Integer] Valor
+      # @return [void]
+      def set(name, value)
+        @stats[name] = value.clamp(1, 10)
+      end
+
+      # Retorna todos os stats
+      #
+      # @return [Hash] Stats
+      def all
+        @stats.dup
+      end
+
+      # Retorna stat mais alto
+      #
+      # @return [Symbol] Nome do stat
+      def highest_stat
+        @stats.max_by { |_, v| v }&.first
+      end
+
+      # Retorna stat mais baixo
+      #
+      # @return [Symbol] Nome do stat
+      def lowest_stat
+        @stats.min_by { |_, v| v }&.first
+      end
+
+      # Calcula score total
+      #
+      # @return [Integer] Score total
+      def total_score
+        @stats.values.sum
+      end
+
+      # Verifica se pode evoluir
+      #
+      # @param stage [Symbol] Stage atual
+      # @return [Boolean] true se pode evoluir
+      def can_evolve?(stage)
+        case stage
+        when :baby
+          @interactions >= 10
+        when :juvenile
+          @interactions >= 50 && @level >= 5
+        when :adult
+          @interactions >= 100 && @level >= 10 && total_score >= 40
+        else
+          false
+        end
+      end
+
+      # Retorna stage atual
+      #
+      # @return [Symbol] Stage
+      def stage
+        if @interactions < 10
+          :baby
+        elsif @interactions < 50
+          :juvenile
+        elsif @interactions < 100
+          :adult
+        else
+          :master
+        end
+      end
+
+      # Exporta stats para hash
+      #
+      # @return [Hash] Stats exportados
+      def to_h
+        {
+          stats: @stats,
+          interactions: @interactions,
+          level: @level,
+          exp: @exp,
+          stage: stage,
+          total_score: total_score,
+          highest_stat: highest_stat,
+          lowest_stat: lowest_stat
+        }
+      end
+    end
+  end
+end

data/lib/gsd/buddy.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# GSD Buddy Module
+#
+# Tamagotchi-style companion system for GSD Tools
+#
+# Uso:
+#   require 'gsd/buddy'
+#
+#   # Pull gacha
+#   gacha = Gsd::Buddy::Gacha.new(user_id: 'user-123')
+#   result = gacha.pull
+#
+#   # CLI
+#   cli = Gsd::Buddy::CLI.new(['get'])
+#   cli.run
+
+module Gsd
+  module Buddy
+  end
+end
+
+# Load buddy files
+require 'gsd/buddy/species'
+require 'gsd/buddy/gacha'
+require 'gsd/buddy/stats'
+require 'gsd/buddy/renderer'
+require 'gsd/buddy/cli'