githuh 0.2.1 → 0.4.0

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.2.1'
+  VERSION = '0.4.0'
 end

data/lib/githuh.rb

@@ -9,9 +9,12 @@ require 'dry/cli'
 require 'forwardable'
 
 require_relative 'githuh/version'
+require_relative 'githuh/env_loader'
+
+Githuh::EnvLoader.load!
 
 module Githuh
-  BANNER  = "Githuh Version #{VERSION}"
+  BANNER  = "Githuh Version #{VERSION}".freeze
   BINARY  = File.expand_path('../exe/githuh', __dir__).freeze
 
   module CLI
@@ -19,11 +22,9 @@ module Githuh
       extend Dry::CLI::Registry
     end
   end
-end
 
-require 'githuh/cli/launcher'
+  require 'githuh/cli/launcher'
 
-module Githuh
   class << self
     attr_accessor :launcher, :in_test
 
@@ -39,12 +40,12 @@ module Githuh
       end
 
       Kernel.module_eval do
-        def puts(*args)
-          ::Githuh.stdout.puts(*args)
+        def puts(*)
+          ::Githuh.stdout.puts(*)
         end
 
-        def warn(*args)
-          ::Githuh.stderr.puts(*args)
+        def warn(*)
+          ::Githuh.stderr.puts(*)
         end
       end
 
@@ -83,6 +84,7 @@ module Githuh
   end
 end
 
+require 'githuh/llm'
 require 'githuh/cli/commands/base'
 require 'githuh/cli/commands/version'
 require 'githuh/cli/commands/user/info'

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: githuh
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Konstantin Gredeskoul
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-09-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -39,35 +38,35 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3'
 - !ruby/object:Gem::Dependency
-  name: dry-cli
+  name: csv
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: octokit
+  name: dry-cli
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: tty-box
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +80,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tty-progressbar
+  name: faraday-retry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -95,7 +94,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: tty-screen
+  name: hashie
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -109,97 +108,27 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: aruba
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '='
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-- !ruby/object:Gem::Dependency
-  name: awesome_print
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3'
-- !ruby/object:Gem::Dependency
-  name: rspec-its
+  name: octokit
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1'
-  type: :development
+        version: '0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: tty-box
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -207,13 +136,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: tty-progressbar
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -221,13 +150,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov-formatter-badge
+  name: tty-screen
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -249,18 +178,24 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
+- ".secrets.baseline"
+- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
-- LICENSE
+- LICENSE.txt
 - README.adoc
 - Rakefile
 - WARRANTY.md
 - codecov.yml
+- config/label-mapping.yml
+- docs/img/badge.svg
+- docs/img/coverage.png
 - docs/img/coverage.svg
 - docs/img/githuh-issue-export.png
 - exe/githuh
 - githuh.gemspec
-- issues.json
+- justfile
+- lefthook.yml
 - lib/githuh.rb
 - lib/githuh/cli/commands/base.rb
 - lib/githuh/cli/commands/issue/export.rb
@@ -269,28 +204,32 @@ files:
 - lib/githuh/cli/commands/user/info.rb
 - lib/githuh/cli/commands/version.rb
 - lib/githuh/cli/launcher.rb
+- lib/githuh/env_loader.rb
+- lib/githuh/llm.rb
+- lib/githuh/llm/anthropic.rb
+- lib/githuh/llm/base.rb
+- lib/githuh/llm/openai.rb
 - lib/githuh/version.rb
 homepage: https://github.com/kigster/githuh
 licenses:
 - MIT
-metadata: {}
-post_install_message:
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - "~>"
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key:
+rubygems_version: 4.0.10
 specification_version: 4
 summary: Extensible CLI helper client for Github, for automating various tasks, such
   as — generating a list of org's repos and converting it into a pretty markdown,