githuh 0.3.0 → 0.4.0

data/lib/githuh/cli/commands/base.rb

@@ -34,19 +34,18 @@ module Githuh
                  per_page: DEFAULT_PAGE_SIZE,
                  verbose: false,
                  info: true)
-
           self.context  = Githuh
           self.verbose  = verbose
           self.info     = info
           self.token    = api_token || determine_github_token
-          self.per_page = per_page.to_i || DEFAULT_PAGE_SIZE
+          self.per_page = per_page.to_i
 
-          if info
-            begin
-              print_userinfo
-            rescue StandardError
-              nil
-            end
+          return unless info
+
+          begin
+            print_userinfo
+          rescue StandardError
+            nil
           end
         end
 
@@ -56,12 +55,12 @@ module Githuh
 
         protected
 
-        def puts(*args)
-          stdout.puts(*args)
+        def puts(*)
+          stdout.puts(*)
         end
 
-        def warn(*args)
-          stderr.puts(*args)
+        def warn(*)
+          stderr.puts(*)
         end
 
         def user_info
@@ -93,7 +92,7 @@ module Githuh
         end
 
         def determine_github_token
-          @github_token ||= (ENV['GITHUB_TOKEN'] || `git config --global --get user.token`.chomp)
+          @github_token ||= ENV['GITHUB_TOKEN'] || `git config --global --get user.token`.chomp
 
           return @github_token unless @github_token.empty?
 
@@ -108,15 +107,18 @@ module Githuh
         def print_userinfo
           duration = DateTime.now - DateTime.parse(user_info[:created_at].to_s)
           years    = (duration / 365).to_i
-          months   = ((duration - years * 365) / 30).to_i
-          days     = (duration - years * 365 - months * 30).to_i
+          months   = ((duration - (years * 365)) / 30).to_i
+          days     = (duration - (years * 365) - (months * 30)).to_i
 
           lines = []
-          lines << sprintf("  Github API Token: %s", h("#{token[0..9]}#{'.' * 20}#{token[-11..-1]}"))
+          lines << sprintf("  Github API Token: %s", h("#{token[0..9]}#{'.' * 20}#{token[-11..]}"))
           lines << sprintf("      Current User: %s", h(user_info.login))
           lines << sprintf("      Public Repos: %s", h(user_info.public_repos.to_s))
           lines << sprintf("         Followers: %s", h(user_info.followers.to_s))
-          lines << sprintf("        Member For: %s", h(sprintf("%d years, %d months, %d days", years, months, days)))
+          lines << sprintf(
+            "        Member For: %s",
+            h("%<years>d years, %<months>d months, %<days>d days" % { years:, months:, days: })
+          )
 
           self.box = TTY::Box.frame(*lines,
                                     padding: 0,

data/lib/githuh/cli/commands/issue/export.rb

@@ -6,9 +6,9 @@ require "bundler/setup"
 require "dry/cli"
 require "json"
 require "tty/progressbar"
-require "csv"
 require "active_support/inflector"
 require "yaml"
+require "csv"
 
 require_relative "../base"
 
@@ -19,7 +19,7 @@ module Githuh
         class Export < Base
           FORMATS = {
             json: "json",
-            csv: "csv",
+            csv:  "csv",
           }.freeze
 
           DEFAULT_FORMAT = :csv
@@ -27,16 +27,16 @@ module Githuh
 
           attr_accessor :filename, :file, :output, :repo, :issues, :format, :record_count, :mapping
 
-          desc "Export Repo issues into a CSV or JSON format\n" \
-               "  Default output file is " + DEFAULT_OUTPUT_FORMAT.bold.yellow
+          desc "Export Repo issues into a CSV or JSON format\n  " \
+               "Default output file is " + DEFAULT_OUTPUT_FORMAT.bold.yellow
 
           argument :repo, type: :string, required: true, desc: 'Name of the repo, eg "rails/rails"'
-          option :file, required: false, desc: "Output file, overrides " + DEFAULT_OUTPUT_FORMAT
+          option :file, required: false, desc: "Output file, overrides #{DEFAULT_OUTPUT_FORMAT}"
           option :format, values: FORMATS.keys.map(&:to_s), default: DEFAULT_FORMAT.to_s, required: false, desc: "Output format"
           option :mapping, type: :string, require: false, desc: "YAML file with label to estimates mapping"
 
-          def call(repo: nil, file: nil, format: nil, mapping: nil, **opts)
-            super(**opts)
+          def call(repo: nil, file: nil, format: nil, mapping: nil, **)
+            super(**)
 
             self.record_count = 0
             self.repo = repo
@@ -46,9 +46,10 @@ module Githuh
 
             self.mapping = {}
             if mapping && ::File.exist?(mapping)
-              self.mapping = ::YAML.safe_load(::File.read(mapping))['label-to-estimates'] || {}
+              self.mapping = ::YAML.safe_load_file(mapping)['label-to-estimates'] || {}
             end
 
+            Export.send(:remove_const, :LabelEstimates) if Export.const_defined?(:LabelEstimates)
             Export.const_set(:LabelEstimates, self.mapping)
 
             self.issues = []
@@ -139,14 +140,14 @@ module Githuh
                 CSV_HEADER.each do |column|
                   method = column.downcase.underscore.to_sym
                   value = if CSV_MAP[column]
-                      CSV_MAP[column][client, issue]
-                    else
-                      begin
-                        issue.to_h[method]
-                      rescue StandardError
-                        nil
-                      end
-                    end
+                            CSV_MAP[column][client, issue]
+                          else
+                            begin
+                              issue.to_h[method]
+                            rescue StandardError
+                              nil
+                            end
+                          end
                   value = value.strip if value.is_a?(String)
                   row << value
                 end
@@ -166,7 +167,7 @@ module Githuh
           def print_conclusion
             puts
             puts TTY::Box.info("Success: written a total of #{record_count} records to #{filename}",
-                               **{ width: ui_width, padding: 1 })
+                               width: ui_width, padding: 1)
             puts
           end
 
@@ -175,7 +176,7 @@ module Githuh
             puts TTY::Box.info("Format : #{self.format}\n" \
                                "File   : #{filename}\n" \
                                "Repo   : #{repo}\n",
-                               **{ width: ui_width, padding: 1 })
+                               width: ui_width, padding: 1)
             puts
           end
 

data/lib/githuh/cli/commands/repo/list.rb

@@ -4,10 +4,12 @@
 # vim: ft=ruby
 require 'bundler/setup'
 require 'dry/cli'
+require 'base64'
 require 'json'
 require 'tty/progressbar'
 
 require_relative '../base'
+require_relative '../../../llm'
 
 module Githuh
   module CLI
@@ -23,18 +25,42 @@ module Githuh
           DEFAULT_OUTPUT_FORMAT = "<username>.repositories.<format>"
           FORK_OPTIONS          = %w(exclude include only).freeze
 
-          attr_accessor :filename, :file, :output, :repos, :format, :forks, :private, :record_count
+          attr_accessor :filename, :file, :output, :repos, :format,
+                        :forks, :private, :record_count, :llm_adapter
 
-          desc "List owned repositories and render the output in markdown or JSON\n" \
-               "  Default output file is " + DEFAULT_OUTPUT_FORMAT.bold.yellow
+          desc "List owned repositories and render the output in markdown or JSON\n  " \
+               "Default output file is " + DEFAULT_OUTPUT_FORMAT.bold.yellow
 
-          option :file, required: false, desc: 'Output file, overrides ' + DEFAULT_OUTPUT_FORMAT
-          option :format, values: FORMATS.keys, default: DEFAULT_FORMAT.to_s, required: false, desc: 'Output format'
-          option :forks, type: :string, values: FORK_OPTIONS, default: FORK_OPTIONS.first, required: false, desc: 'Include or exclude forks'
-          option :private, type: :boolean, default: nil, required: false, desc: 'If specified, returns only private repos for true, public for false'
+          option :file,
+                 required: false,
+                 desc:     "Output file, overrides #{DEFAULT_OUTPUT_FORMAT}"
 
-          def call(file: nil, format: nil, forks: nil, private: nil, **opts)
-            super(**opts)
+          option :format,
+                 values:   FORMATS.keys,
+                 default:  DEFAULT_FORMAT.to_s,
+                 required: false,
+                 desc:     'Output format'
+
+          option :forks, type:     :string,
+                         values:   FORK_OPTIONS,
+                         default:  FORK_OPTIONS.first,
+                         required: false,
+                         desc:     'Include or exclude forks'
+
+          option :private,
+                 type:     :boolean,
+                 default:  nil,
+                 required: false,
+                 desc:     'If specified, returns only private repos for true, public for false'
+
+          option :llm,
+                 type:     :boolean,
+                 default:  false,
+                 required: false,
+                 desc:     'Use LLM (ANTHROPIC_API_KEY or OPENAI_API_KEY) to summarize README'
+
+          def call(file: nil, format: nil, forks: nil, private: nil, llm: false, **)
+            super(**)
 
             self.record_count = 0
             self.forks        = forks
@@ -42,6 +68,7 @@ module Githuh
             self.repos        = []
             self.output       = StringIO.new
             self.format       = (format || DEFAULT_FORMAT).to_sym
+            self.llm_adapter  = build_llm_adapter if llm
 
             self.filename = file || "#{user_info.login}.repositories.#{FORMATS[self.format]}"
             self.file     = File.open(filename, 'w')
@@ -100,55 +127,137 @@ module Githuh
           def bar_size
             return 1 if client&.last_response.nil?
 
-            client&.last_response.rels[:last].href.match(/page=(\d+).*$/)[1].to_i
+            client&.last_response&.rels&.[](:last)&.href&.match(/page=(\d+).*$/)&.[](1)&.to_i # rubocop:disable Style/SafeNavigationChainLength
           end
 
           def render_as_markdown(repositories)
             output.puts "### #{client.user.name}'s Repos\n"
+
+            llm_bar = build_llm_progress_bar(repositories.size) if llm_adapter
+
             repositories.each_with_index do |repo, index|
               output.puts repo_as_markdown(index, repo)
+              llm_bar&.advance
+            end
+
+            if llm_bar
+              llm_bar.finish
+              puts
             end
+
             output.string
           end
 
+          def build_llm_progress_bar(total)
+            return unless info || verbose
+
+            color = llm_adapter.class.const_defined?(:BAR_COLOR) ? llm_adapter.class::BAR_COLOR : :cyan
+            provider = llm_adapter.class.name.split('::').last
+
+            puts
+            puts " • Summarizing #{total} READMEs with #{provider}…".send(color)
+            TTY::ProgressBar.new("[:bar]",
+                                 title:    'LLM Summaries',
+                                 total:    total,
+                                 width:    ui_width - 2,
+                                 head:     '',
+                                 complete: '▉'.send(color))
+          end
+
           def render_as_json(repositories)
             JSON.pretty_generate(repositories.map(&:to_hash))
           end
 
           def repo_as_markdown(index, repo)
+            description = describe(repo)
+
             <<~REPO
 
               ### #{index + 1}. [#{repo.name}](#{repo.url}) (#{repo.stargazers_count} ★)
 
-              #{repo.language ? "**#{repo.language}**. " : ''}
-              #{repo.license ? "Distributed under the **#{repo.license.name}** license." : ''}
+              #{"**#{repo.language}**. " if repo.language}
+              #{"Distributed under the **#{repo.license.name}** license." if repo.license}
 
-              #{repo.description}
+              #{description}
 
             REPO
           end
 
+          def describe(repo)
+            return repo.description unless llm_adapter
+
+            readme = fetch_readme(repo)
+            return repo.description if readme.nil? || readme.empty?
+
+            llm_adapter.summarize(readme)
+          rescue StandardError => e
+            warn "LLM summary failed for #{repo_full_name(repo)}: #{e.message}" if verbose
+            repo.description
+          end
+
+          def fetch_readme(repo)
+            readme = client.readme(repo_full_name(repo))
+            return nil unless readme
+
+            encoded = readme.respond_to?(:content) ? readme.content : readme[:content]
+            return nil if encoded.nil? || encoded.to_s.empty?
+
+            Base64.decode64(encoded).force_encoding('UTF-8')
+          rescue StandardError => e
+            warn "README fetch failed for #{repo_full_name(repo)}: #{e.message}" if verbose
+            nil
+          end
+
+          def repo_full_name(repo)
+            repo.respond_to?(:full_name) && repo.full_name ? repo.full_name : repo.name
+          end
+
+          def build_llm_adapter
+            adapter = Githuh::LLM.build
+            raise Githuh::LLM::Error, '--llm was specified but neither ANTHROPIC_API_KEY nor OPENAI_API_KEY is set' unless adapter
+
+            announce_llm(adapter) if info
+            adapter
+          end
+
+          def announce_llm(adapter)
+            provider = adapter.class.name.split('::').last
+            model    = adapter.class.const_defined?(:MODEL) ? adapter.class::MODEL : 'n/a'
+
+            puts
+            puts TTY::Box.info(
+              "LLM summaries: ENABLED\n" \
+              "Provider     : #{provider}\n" \
+              "Model        : #{model}\n" \
+              "\n" \
+              "For each repository, the README will be fetched and summarized\n" \
+              "into a 5-6 sentence description before writing to the output file.",
+              width: ui_width, padding: 1
+            )
+            puts
+          end
+
           private
 
           def filter_result!(result)
             result.reject! do |r|
               fork_reject = case forks
-              when 'exclude'
-                r.fork
-              when 'only'
-                !r.fork
-              when 'include'
-                false
-              end
+                            when 'exclude'
+                              r.fork
+                            when 'only'
+                              !r.fork
+                            when 'include'
+                              false
+                            end
 
               private_reject = case private
-              when true
-                !r.private
-              when false
-                r.private
-              when nil
-                false
-              end
+                               when true
+                                 !r.private
+                               when false
+                                 r.private
+                               when nil
+                                 false
+                               end
 
               fork_reject || private_reject
             end

data/lib/githuh/cli/commands/user/info.rb

@@ -15,8 +15,8 @@ module Githuh
         class Info < Base
           desc "Print user information"
 
-          def call(**opts)
-            super(**opts)
+          def call(**)
+            super
             ap client.user.to_hash
           end
         end

data/lib/githuh/cli/launcher.rb

@@ -13,12 +13,10 @@ module Githuh
     class Launcher
       attr_accessor :argv, :stdin, :stdout, :stderr, :kernel, :command
 
-      def initialize(argv, stdin = STDIN, stdout = STDOUT, stderr = STDERR, kernel = nil)
-        if ::Githuh.launcher
-          raise(ArgumentError, "Another instance of CLI Launcher was detected, aborting.")
-        else
-          Githuh.launcher = self
-        end
+      def initialize(argv, stdin = $stdin, stdout = $stdout, stderr = $stderr, kernel = nil)
+        raise(ArgumentError, "Another instance of CLI Launcher was detected, aborting.") if ::Githuh.launcher
+
+        Githuh.launcher = self
 
         self.argv   = argv
         self.stdin  = stdin
@@ -28,7 +26,7 @@ module Githuh
       end
 
       def execute!
-        if argv.empty? || !(%w(--help -h) & argv).empty?
+        if argv.empty? || !!%w(--help -h).intersect?(argv)
           stdout.puts BANNER
           Githuh.configure_kernel_behavior! help: true
         else
@@ -39,17 +37,15 @@ module Githuh
         self.command = ::Dry::CLI.new(::Githuh::CLI::Commands)
         command.call(arguments: argv, out: stdout, err: stderr)
       rescue StandardError => e
-        lines = [e.message.gsub(/\n/, ', ')]
-        if e.backtrace && !(ARGV & %w[-v --verbose]).empty?
+        lines = [e.message.gsub("\n", ', ')]
+        if e.backtrace && !!ARGV.intersect?(%w[-v --verbose])
           lines << ''
           lines.concat(e.backtrace)
         end
 
         box = TTY::Box.frame(*lines,
-                             **BOX_OPTIONS.merge(
-                               width: TTY::Screen.width,
-                               title: { top_center: "┤ #{e.class.name} ├" },
-                             ))
+                             **BOX_OPTIONS, width: TTY::Screen.width,
+                                            title: { top_center: "┤ #{e.class.name} ├" })
         stderr.puts
         stderr.print box
       ensure
@@ -62,7 +58,7 @@ module Githuh
       end
     end
 
-    BANNER = <<~BANNER
+    BANNER = <<~BANNER.freeze
 
       #{'Githuh CLI'.bold.yellow} #{::Githuh::VERSION.bold.green} — API client for Github.com.
       #{'© 2020 Konstantin Gredeskoul, All rights reserved.  MIT License.'.cyan}

data/lib/githuh/env_loader.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Githuh
+  module EnvLoader
+    # Load a simple KEY=VALUE .env file from the current working directory
+    # and/or HOME, without clobbering already-set ENV entries.
+    def self.load!
+      [File.join(Dir.pwd, '.env'), File.join(Dir.home, '.env')].uniq.each do |path|
+        next unless File.file?(path) && File.readable?(path)
+
+        File.foreach(path) do |raw|
+          line = raw.strip
+          next if line.empty? || line.start_with?('#')
+
+          key, value = line.split('=', 2)
+          next if key.nil? || value.nil?
+
+          key = key.strip
+          value = strip_quotes(value.strip)
+          ENV[key] ||= value
+        end
+      end
+    end
+
+    def self.strip_quotes(value)
+      if (value.start_with?('"') && value.end_with?('"')) ||
+         (value.start_with?("'") && value.end_with?("'"))
+        value[1..-2]
+      else
+        value
+      end
+    end
+  end
+end

data/lib/githuh/llm/anthropic.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Githuh
+  module LLM
+    class Anthropic < Base
+      ENDPOINT = URI('https://api.anthropic.com/v1/messages').freeze
+      MODEL = 'claude-haiku-4-5-20251001'
+      MAX_TOKENS = 800
+      BAR_COLOR = :yellow
+
+      def summarize(readme)
+        headers = {
+          'x-api-key' => api_key,
+          'anthropic-version' => '2023-06-01'
+        }
+        body = {
+          model:      MODEL,
+          max_tokens: MAX_TOKENS,
+          messages:   [{ role: 'user', content: prompt_for(readme) }]
+        }
+
+        payload = parse!(post_json(ENDPOINT, headers, body))
+        payload.dig('content', 0, 'text').to_s.strip
+      end
+    end
+  end
+end

data/lib/githuh/llm/base.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module Githuh
+  module LLM
+    class Base
+      # Hard cap to keep prompts cheap and within model context.
+      README_CHAR_LIMIT = 12_000
+      REQUEST_TIMEOUT = 30
+
+      PROMPT = <<~PROMPT
+        You are summarizing a GitHub repository for a public directory page.
+        Below is the README. Write a user-friendly description of 5–6 sentences.
+        Focus on: what the project *is*, what problem it *solves*, who would
+        use it, and any notable technical approach or feature. Keep it flowing
+        prose — no bullet points, no headings, no quotes, no markdown syntax.
+        Do NOT include installation instructions, badges, license mentions,
+        or author credits. Return ONLY the description prose — no preamble.
+
+        README:
+        ---
+        %<readme>s
+        ---
+      PROMPT
+
+      attr_reader :api_key, :name
+
+      def initialize(api_key:)
+        @api_key = api_key
+        @name = self.class.name.split('::').last.downcase
+      end
+
+      # @param readme [String] raw README markdown
+      # @return [String] a 2-4 sentence description
+      def summarize(readme)
+        raise NotImplementedError
+      end
+
+      protected
+
+      def prompt_for(readme)
+        format(PROMPT, readme: readme.to_s[0, README_CHAR_LIMIT])
+      end
+
+      def post_json(uri, headers, body)
+        req = Net::HTTP::Post.new(uri)
+        headers.each { |k, v| req[k] = v }
+        req['Content-Type'] = 'application/json'
+        req.body = JSON.dump(body)
+
+        Net::HTTP.start(uri.hostname, uri.port,
+                        use_ssl:      uri.scheme == 'https',
+                        read_timeout: REQUEST_TIMEOUT,
+                        open_timeout: REQUEST_TIMEOUT) do |http|
+          http.request(req)
+        end
+      end
+
+      def parse!(response)
+        raise Error, "#{name} API #{response.code}: #{response.body}" unless response.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(response.body)
+      end
+    end
+  end
+end

data/lib/githuh/llm/openai.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Githuh
+  module LLM
+    class OpenAI < Base
+      ENDPOINT = URI('https://api.openai.com/v1/chat/completions').freeze
+      MODEL = 'gpt-4o-mini'
+      MAX_TOKENS = 800
+      BAR_COLOR = :green
+
+      def summarize(readme)
+        headers = { 'Authorization' => "Bearer #{api_key}" }
+        body = {
+          model:      MODEL,
+          max_tokens: MAX_TOKENS,
+          messages:   [{ role: 'user', content: prompt_for(readme) }]
+        }
+
+        payload = parse!(post_json(ENDPOINT, headers, body))
+        payload.dig('choices', 0, 'message', 'content').to_s.strip
+      end
+    end
+  end
+end

data/lib/githuh/llm.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Githuh
+  module LLM
+    class Error < StandardError; end
+
+    # Returns an adapter instance based on available env vars.
+    # Priority: ANTHROPIC_API_KEY > OPENAI_API_KEY.
+    # Returns nil if no key is set (caller decides how to handle).
+    def self.build
+      if (key = env('ANTHROPIC_API_KEY'))
+        Anthropic.new(api_key: key)
+      elsif (key = env('OPENAI_API_KEY'))
+        OpenAI.new(api_key: key)
+      end
+    end
+
+    def self.available?
+      !build.nil?
+    end
+
+    def self.env(name)
+      value = ENV.fetch(name, nil)
+      value && !value.strip.empty? ? value.strip : nil
+    end
+  end
+end
+
+require_relative 'llm/base'
+require_relative 'llm/anthropic'
+require_relative 'llm/openai'

data/lib/githuh/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Githuh
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end