gem_hadar 1.26.0 → 1.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3fefed7b5fd9123e2944de9cf2defcd9f1794aaa7d0058621539b22a2e076d3
-  data.tar.gz: 8734f8f3cf30c0a0b501e5484a58bc5b4bbc4190258133f6de7b1105f17c7383
+  metadata.gz: 0e57d99439c8c2f1dc0538ece4d25ba460afc75d96ba37b7ce26ff64053fea65
+  data.tar.gz: 4a19dd7d7968dab5f5c4090cb4daeb4f329b589dff80d926dcfbf5123619f215
 SHA512:
-  metadata.gz: 867a63019ba90544ba9b0c91478482128d3527221d9c11473929d9f18b5c74673d2fc3ab5844bc26779680b724965a9a7a455518286c5ca9a496342371c31c1a
-  data.tar.gz: a6fa278536336a668d025947b3d9f274d4cc02ae9e2a3d50bb2a2a87b42ee2d351bfb191d9eb472bd215b521c34b561c4ee5d9f15cfcec93576f98871df23c10
+  metadata.gz: caa877d26d2a9057fe6889924f164bc51ef1d902dba3300bc988b8da7ae6c9bd912341bfd161c017f4501308cdcd80b5b40df765643a0610eeb9fc41b2debd0e
+  data.tar.gz: af306f158d730ac15b557cdb2543d6e0dece6d752be01cd10493aa2f91dc829b7495b4102061a436eef5a2af2fe406abe31cb3d6bd3b2f260d262f83095b021c

data/README.md

@@ -77,7 +77,7 @@ graph TD
 
 The source of this library is located at
 
-* http://github.com/flori/gem\_hadar
+* http://github.com/flori/gem_hadar
 
 or can be installed via
 
@@ -85,6 +85,151 @@ or can be installed via
 $ gem install gem_hadar
 ```
 
+## Configuration
+
+### Environment Variables
+
+The following environment variables can be used to configure `gem_hadar`:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `GEM_HOST_API_KEY` | API key for gem hosting services | Not set |
+| `GITHUB_API_TOKEN` | GitHub personal access token for releases | Not set |
+| `OLLAMA_MODEL` | Ollama model name for AI generation | `llama3.1` |
+| `OLLAMA_HOST` | Ollama server host URL | `localhost:11434` |
+| `OLLAMA_URL` | Direct Ollama API URL (takes precedence over `OLLAMA_HOST`) | Not set |
+| `OLLAMA_MODEL_OPTIONS` | JSON configuration for Ollama model | Not set |
+| `HOME` | User's home directory (used for config file locations) | System default |
+| `XDG_CONFIG_HOME` | XDG configuration directory override | System default |
+| `MAKE` | Make program to use for building extensions | `gmake` or `make` |
+| `VERSION` | Override the version string for some tasks | Not set |
+| `FORCE` | Force certain operations (1 to enable) | 0 |
+| `GIT_REMOTE` | Git remote name(s) for operations, space separated | `origin` |
+| `GITHUB_RELEASE_ENABLED` | Enable GitHub releases (yes/no) | Auto-detected |
+| `EDITOR` | Editor to use for interactive tasks | `vi` |
+
+### Rubygems API
+
+To publish gems to RubyGems.org, you'll need to set up an API key:
+
+1. Generate a new API key at: https://rubygems.org/profile/api_keys/new
+2. Set the environment variable:
+
+```bash
+export GEM_HOST_API_KEY="your_api_key_here"
+```
+
+**Security Note**: Never commit your API key to version control. Use a `.env`
+file or your shell's configuration with appropriate loading mechanisms.
+
+This key is required for tasks like `rake release` which push the gem package to RubyGems.org.
+
+### Github API
+
+To enable GitHub release creation and other GitHub API interactions, you'll
+need to set up a personal access token.
+
+1. Generate a new token at: https://github.com/settings/tokens/new
+2. Grant it `repo` scope for full repository access
+3. Set the environment variable:
+
+```bash
+export GITHUB_API_TOKEN="your_token_here"
+```
+
+**Security Note**: Never commit your token to version control. Use a `.env`
+file or your shell's configuration with appropriate loading mechanisms.
+
+This token is required for tasks like `rake github:release` which create GitHub
+releases with AI-generated changelogs.
+
+### Local Ollama AI
+
+The gem supports AI-powered changelog generation using Ollama. To configure
+this functionality:
+
+1. Install and run Ollama locally: https://ollama.com/download
+2. Pull the desired model (e.g., `ollama pull deepseek-r1:32b`)
+3. Set the following environment variables:
+
+```bash
+export OLLAMA_HOST="http://localhost:11434"
+export OLLAMA_MODEL="deepseek-r1:32b"
+export OLLAMA_MODEL_OPTIONS='{"num_ctx":16384,"seed":-1,"num_predict":512,"temperature":0.4,"top_p":0.95,"top_k":20,"min_p":0}'
+```
+
+The default model is `llama3.1` and the default host is
+`http://localhost:11434`. These can be overridden based on your local Ollama
+setup.
+
+The model options example configures:
+
+- `num_ctx`: Context window size (16384 tokens)
+- `temperature`: Response randomness (0.4 for balanced output)
+- `num_predict`: Maximum tokens to generate (512)
+- `top_p`, `top_k`, `min_p`: Sampling parameters for controlled generation
+
+This functionality is used by the `rake github:release` and `rake version:bump`
+task to generate AI-powered changelogs or suggest a version bump.
+
+### Custom AI Prompts
+
+To customize the AI prompts used by `gem_hadar`, you can override the default
+prompt files in your XDG configuration directory.
+
+First, display the current default prompts using:
+
+```bash
+$ rake gem_hadar:config
+```
+
+This will show you the `XDG_CONFIG_HOME`, default system and user prompts for
+version bumping and release generation. The output includes the exact template
+variables that are available for use in your custom prompts.
+
+Then, create the following files in your XDG configuration home directory:
+
+- `version_bump_system_prompt.txt`
+- `version_bump_prompt.txt` 
+- `release_system_prompt.txt`
+- `release_prompt.txt`
+
+Start with the default values shown by `rake gem_hadar:config` and modify them
+to suit your needs. The prompts support standard Ruby string interpolation with
+the following variables:
+
+For version bump prompts:
+- `%{version}` - Current gem version
+- `%{log_diff}` - Git diff of changes
+
+For release prompts:
+- `%{name}` - Gem name
+- `%{version}` - New version being released
+- `%{log_diff}` - Git diff of changes
+
+This approach ensures your custom prompts work correctly with the template
+variables while maintaining consistency with the gem's expected input format.
+
+### Output current configuration
+
+To debug or verify your `gem_hadar` configuration, you can use the following
+rake task:
+
+```bash
+$ rake gem_hadar:config
+```
+
+This task displays all current configuration values including:
+- GitHub API token (masked)
+- RubyGems API key (masked)  
+- Ollama model settings
+- Repository information (gem name, version)
+- Build parameters (MAKE, EDITOR)
+- Git configuration (remote)
+- Other flags (FORCE, VERSION, GITHUB_RELEASE_ENABLED)
+- XDG/HOME directories
+- AI prompt defaults
+
 ## Usage
 
 ### Pre-requisites
@@ -160,6 +305,115 @@ end
 
 Note that `gem_hadar` is ["self hosted"](Rakefile)
 
+### Configuration settings in the GemHadar block
+
+#### Core Required Attributes (Mapped to GemSpec)
+
+- **`name`** - Required gem name (raises error if not set)
+- **`version`** - Required version with fallback to `VERSION` file or ENV override
+- **`authors`** - Required author names (mapped from `author`)
+- **`email`** - Required author email (raises error if not set)
+- **`homepage`** - Required homepage URL (raises error if not set). **Validation**: When `developing` is false, validates that the URL returns an HTTP OK status after following redirects.
+- **`summary`** - Required summary description (raises error if not set)
+- **`description`** - Required full description (raises error if not set)
+
+#### Core Recommended Attributes
+
+- **`licenses`** - Default: `Set[]`. License information for the gem
+- **`required_ruby_version`** - Default: `nil`. Ruby version requirement
+
+#### Build and Package Configuration
+
+- **`require_paths`** - Default: `Set['lib']` (mapped to `require_paths`)
+- **`test_dir`** - Default: `nil`
+- **`spec_dir`** - Default: `nil`
+- **`extensions`** - Default: `FileList['ext/**/extconf.rb']` (mapped to `extensions`)
+- **`make`** - Default: `ENV['MAKE']` or system detection
+- **`executables`** - Default: `Set[]` (mapped to `executables`)
+- **`ignore_files`** - Default: `Set[]`
+- **`package_ignore_files`** - Default: `Set[]`
+
+#### Documentation and Files
+
+- **`readme`** - Default: `nil`
+- **`title`** - Default: `nil`
+- **`doc_files`** - Default: `nil`
+- **`yard_dir`** - Default: `nil`
+
+#### Testing Configuration
+
+- **`test_files`** - Default: `nil`
+- **`spec_pattern`** - Default: `nil`
+- **`bindir`** - Default: `nil` (mapped to `bindir`)
+
+#### RVM Configuration (Nested)
+
+```ruby
+rvm do
+  use     # Default: detected ruby version from `rvm tools strings`
+  gemset  # Default: gem name
+end
+```
+
+#### Task Dependencies
+
+- **`default_task_dependencies`** - Default: `[:gemspec, :test]`
+- **`build_task_dependencies`** - Default: `[:clobber, :gemspec, :package, :'version:tag']`
+- **`push_task_dependencies`** - Default: `[:modified, :build, :master:push, :version:push, :gem:push, :github:release]`
+
+#### Configuration Flags
+
+- **`developing`** - Default: `false`. When set to `true`, skips URL validation including homepage link verification for faster development cycles.
+
+### Paths and Module Types
+
+- **`path_name`** - Default: `name`. Returns the raw gem name value by default.
+  It is used for generating file paths and module names. This is particularly
+  useful for creating consistent directory structures and file naming
+  conventions. It's used internally by `GemHadar` to create the root directory
+  for the gem (`lib/my_gem` for name "my\_gem") and generate a `version.rb` file
+  in that location.
+
+  This can be changed for nested namespaces if desired.
+
+  **Example**: For gems in namespaces like `ACME` like
+  `ACME::BrainfuckCompiler`, you might set `path_name` to
+  `"acme/brainfuck_compiler"` to create the directory structure
+  `lib/acme/brainfuck_compiler/`.
+
+- **`path_module`** - Default: `path_name.camelize`. Automatically converts the
+  gem name to CamelCase format (e.g., "my\_gem" becomes "MyGem",
+  "namespace/my\_gem" becomes "Namespace::MyGem") for use in Ruby module and
+  class declarations, ensuring consistency with Ruby naming
+  conventions. This value can be overridden if needed.
+
+- **`module_type`** - Default: `:module`. Determines whether the generated code
+  structure for the version module should be a `:module` or `:class`. This
+  controls the type of Ruby construct created when generating code skeletons and
+  version files. The value
+  can be set to either:
+
+    - `:module` (default) - Generates module-based structure
+    - `:class` - Generates class-based structure
+
+    This is used in the generated `version.rb` file to create either:
+    ```ruby
+    module MyGem
+      # ... version constants
+    end
+    ```
+    or
+    ```ruby
+    class MyGem
+      # ... version constants
+    end
+    ```
+
+These computed values serve as intelligent defaults that can be overridden
+based on your specific requirements. They are automatically derived from other
+DSL accessors and provide powerful convenience features that enable `GemHadar`
+to generate consistent, well-structured Ruby code automatically.
+
 ### Available Tasks
 
 You can list all available tasks with:
@@ -222,7 +476,51 @@ $ rake -T
 - `rake github:release` - Create a new GitHub release for the current version
   with AI-generated changelog
 
-### Update Version
+### Code Coverage with SimpleCov
+
+To enable detailed code coverage reporting in your project using `GemHadar`,
+follow these steps:
+
+1. **Install Required Dependencies**
+
+   Ensure that `simplecov` is included in your `Gemfile`:
+
+   ```ruby
+   gem 'simplecov'
+   ```
+
+2. **Initialize Coverage in Your Test Setup**
+
+   Add this line to the top of your test helper file (e.g., `spec_helper.rb`,
+   `test_helper.rb`):
+
+   ```ruby
+   require 'gem_hadar/simplecov'
+   GemHadar::SimpleCov.start
+   ```
+
+3. **Enable Coverage Reporting**
+
+   Run tests with the environment variable `START_SIMPLECOV=1`:
+
+   ```bash
+   START_SIMPLECOV=1 bundle exec rspec
+   ```
+
+   This will generate coverage reports in both HTML and JSON formats.
+
+4. **Viewing Reports**
+
+   After running tests, you can view:
+   - **HTML Report**: `coverage/index.html`
+   - **JSON Context**: `coverage/coverage_context.json`
+
+> 🧪 *Tip:* Enable coverage reporting by setting the `START_SIMPLECOV`
+> environment variable to `1`. The JSON output includes detailed line and
+> branch coverage statistics per file, making it ideal for integration with CI
+> tools or custom dashboards.
+
+### Update Gem Version
 
 Use one of the following rake tasks to bump the version:
 

data/VERSION

@@ -1 +1 @@
-1.26.0
+1.28.0

data/gem_hadar.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: gem_hadar 1.26.0 ruby lib
+# stub: gem_hadar 1.28.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "gem_hadar".freeze
-  s.version = "1.26.0".freeze
+  s.version = "1.28.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -12,8 +12,8 @@ Gem::Specification.new do |s|
   s.description = "This library contains some useful functionality to support the development of Ruby Gems".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["gem_hadar".freeze]
-  s.extra_rdoc_files = ["README.md".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze]
-  s.files = [".gitignore".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/gem_hadar".freeze, "gem_hadar.gemspec".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/simplecov.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze]
+  s.files = [".gitignore".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/gem_hadar".freeze, "gem_hadar.gemspec".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/simplecov.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze]
   s.homepage = "https://github.com/flori/gem_hadar".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "GemHadar - Library for the development of Ruby Gems".freeze, "--main".freeze, "README.md".freeze]
@@ -22,7 +22,7 @@ Gem::Specification.new do |s|
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.26".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.27".freeze])
   s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.0".freeze])
   s.add_runtime_dependency(%q<term-ansicolor>.freeze, ["~> 1.0".freeze])
   s.add_runtime_dependency(%q<ollama-ruby>.freeze, ["~> 1.0".freeze])

data/lib/gem_hadar/simplecov.rb

@@ -0,0 +1,182 @@
+require 'term/ansicolor'
+require 'tins/xt/secure_write'
+require 'fileutils'
+require 'pathname'
+
+class GemHadar
+end
+
+module GemHadar::SimpleCov
+  module WarnModule
+    # The warn method displays warning messages using orange colored output.
+    #
+    # This method takes an array of message strings, applies orange color
+    # formatting to each message, and then passes them to the superclass's warn
+    # method for display. The uplevel: 1 option ensures that the warning
+    # originates from the caller's context rather than from within this method
+    # itself.
+    #
+    # @param msgs [ Array<String> ] the array of message strings to display as warnings
+    def warn(*msgs)
+      msgs.map! { |m| color(208) { m } }
+      super(*msgs, uplevel: 1)
+    end
+  end
+
+  class ContextFormatter
+    include FileUtils
+
+    # The format method processes code coverage results and generates a
+    # detailed JSON report.
+    #
+    # This method takes a SimpleCov result object and transforms its coverage
+    # data into a structured format that includes both line and branch coverage
+    # statistics for individual files, as well as overall project coverage
+    # metrics. It calculates various percentages and counts, then writes the
+    # complete coverage data to a JSON file in the coverage directory.
+    #
+    # @param result [ SimpleCov::Result ] the coverage result object containing files and statistics
+    #
+    # @return [ String ] an empty string, as the method's primary purpose is to write data to a file
+    def format(result)
+      files = result.files.map do |file|
+        line_coverage_statistics = extract_coverage_info(file.coverage_statistics[:line])
+        branch_coverage_statistics = extract_coverage_info(file.coverage_statistics[:branch])
+        {
+          filename: file.filename,
+          line_coverage_statistics:,
+          branch_coverage_statistics:,
+        }
+      end
+      covered_files = result.files.count { |file| file.coverage_statistics[:line].covered > 0 }
+      uncovered_files = result.files.count { |file| file.coverage_statistics[:line].covered == 0 }
+      files_count = result.files.length
+      files_covered_percent = files_count > 0 ? (100 * covered_files.to_f / files_count).round(2) : 0
+      branch_covered_percent =
+        result.total_branches > 0 ? (result.covered_branches.to_f / result.total_branches * 100).round(2) : 0
+      coverage_data = {
+        project_name:,
+        version:,
+        timestamp: Time.now.iso8601,
+        files:,
+        overall_coverage: {
+          covered_percent: result.covered_percent.round(2),
+          total_lines: result.total_lines,
+          covered_lines: result.covered_lines,
+          missed_lines: result.missed_lines,
+          branch_covered_percent:,
+          total_branches: result.total_branches,
+          covered_branches: result.covered_branches,
+          missed_branches: result.missed_branches,
+          coverage_strength: result.covered_strength.round(2),
+          least_covered_file: result.least_covered_file,
+          covered_files:,
+          uncovered_files:,
+          files_count:,
+          files_covered_percent:,
+        },
+      }
+
+      # Write to a dedicated coverage data file,
+      coverage_dir = Pathname.new('coverage')
+      mkdir_p coverage_dir
+      filename = File.expand_path(coverage_dir + 'coverage_context.json')
+      File.secure_write(filename, JSON.pretty_generate(coverage_data))
+      STDERR.puts "Wrote detailed coverage context to #{filename.to_s.inspect}."
+      ""
+    end
+
+    private
+
+    include WarnModule
+
+    # The project_name method retrieves the name of the current working
+    # directory.
+    #
+    # This method obtains the absolute path of the current working directory
+    # and extracts its basename, returning it as a string. It is typically used
+    # to identify the project name based on the directory structure.
+    #
+    # @return [ String ] the name of the current working directory
+    def project_name
+      Pathname.pwd.basename.to_s # I hope…
+    end
+
+    # The version method reads and returns the current version string from the
+    # VERSION file.
+    #
+    # This method attempts to read the contents of the VERSION file, removing
+    # any trailing whitespace. If the VERSION file does not exist, it returns
+    # the string 'unknown' instead.
+    #
+    # @return [ String ] the version string read from the VERSION file, or
+    # 'unknown' if the file is missing
+    def version
+      File.read('VERSION').chomp
+    rescue Errno::ENOENT => e
+      warn "Using version 'unknown', caught #{e.class}: #{e}"
+      'unknown'
+    end
+
+    # The extract_coverage_info method transforms coverage statistics into a
+    # structured hash format.
+    #
+    # This method takes a coverage statistics object and extracts specific
+    # attributes into a new hash, making the data more accessible for reporting
+    # and analysis.
+    #
+    # @param coverage_statistics [ SimpleCov::CoverageStatistics ] the coverage
+    # statistics object to process
+    #
+    # @return [ Hash ] a hash containing the extracted coverage metrics with
+    # keys :total, :covered, :missed, :strength, and :percent
+    def extract_coverage_info(coverage_statistics)
+      %i[ total covered missed strength percent ].each_with_object({}) do |attr, hash|
+        hash[attr] = coverage_statistics.send(attr)
+      end
+    end
+  end
+
+  class << self
+    include Term::ANSIColor
+
+    # The start method initializes and configures SimpleCov for code coverage
+    # analysis.
+    #
+    # This method checks if the START_SIMPLECOV environment variable is set to
+    # 1 before proceeding with SimpleCov setup. If disabled, it outputs a
+    # message indicating that SimpleCov startup is skipped. When enabled, it
+    # requires the simplecov gem, configures coverage to include branch
+    # coverage, adds a filter based on the caller's directory, and sets up
+    # multiple formatters including SimpleFormatter, HTMLFormatter, and a
+    # custom ContextFormatter.
+    def start
+      if ENV['START_SIMPLECOV'].to_i != 1
+        STDERR.puts color(226) {
+          "Skip starting Simplecov for code coverage, "\
+          "enable by setting env var: START_SIMPLECOV=1"
+        }
+        return
+      end
+      require 'simplecov'
+      STDERR.puts color(76) { "Configuring Simplecov for code coverage." }
+      filter = "#{File.basename(File.dirname(caller.first))}/"
+      SimpleCov.start do
+        enable_coverage :branch
+        add_filter filter
+        formatter SimpleCov::Formatter::MultiFormatter.new([
+          SimpleCov::Formatter::SimpleFormatter,
+          SimpleCov::Formatter::HTMLFormatter,
+          GemHadar::SimpleCov::ContextFormatter,
+        ])
+      end
+    rescue LoadError => e
+      warn "Caught #{e.class}: #{e}"
+      STDERR.puts "Install with: gem install simplecov"
+    end
+
+    private
+
+    include WarnModule
+  end
+end

data/lib/gem_hadar/utils.rb

@@ -1,4 +1,20 @@
+require 'pathname'
+
 module GemHadar::Utils
+  # The xdg_config_home method determines the path to the XDG configuration
+  # directory.
+  #
+  # It first checks if the XDG_CONFIG_HOME environment variable is set and not
+  # empty. If it is set, the method returns the value as a Pathname object. If
+  # XDG_CONFIG_HOME is not set, it defaults to using the HOME environment
+  # variable to construct the path within the standard .config directory.
+  #
+  # @return [ Pathname ] the Pathname object representing the XDG configuration directory
+  def xdg_config_home
+    ENV['XDG_CONFIG_HOME'].full? { Pathname.new(_1) } ||
+      Pathname.new(ENV.fetch('HOME')) + '.config'
+  end
+
   # The xdg_config_filename method constructs the full path to a configuration
   # file based on the XDG Base Directory specification.
   #
@@ -12,11 +28,7 @@ module GemHadar::Utils
   #
   # @return [ String ] the full path to the configuration file
   def xdg_config_filename(name)
-    if xdg = ENV['XDG_CONFIG_HOME'].full?
-      File.join(xdg, name)
-    else
-      File.join(ENV.fetch('HOME'), '.config', name)
-    end
+    xdg_config_home + name
   end
 
   memoize method:

data/lib/gem_hadar/version.rb

@@ -1,6 +1,6 @@
 class GemHadar
   # GemHadar version
-  VERSION         = '1.26.0'
+  VERSION         = '1.28.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/gem_hadar.rb

@@ -1082,12 +1082,79 @@ class GemHadar
     task :yard => %i[ yard:private yard:view ]
   end
 
+  def config_task
+    namespace :gem_hadar do
+      desc "Display current gem_hadar configuration"
+      task :config do
+        puts "=== GemHadar Configuration ==="
+
+        # RubyGems
+        if ENV['GEM_HOST_API_KEY'].present?
+          puts "RubyGems API Key: *** (set)"
+        else
+          puts "RubyGems API Key: Not set"
+        end
+
+        # GitHub
+        if ENV['GITHUB_API_TOKEN'].present?
+          puts "GitHub API Token: *** (set)"
+        else
+          puts "GitHub API Token: Not set"
+        end
+
+        # Ollama
+        puts "Ollama Model: #{ollama_model} (default is #{ollama_model_default})"
+
+        if url = ollama_client&.full?(:base_url)&.to_s
+          puts "Ollama Base URL: #{url.inspect}"
+        else
+          puts "Ollama Base URL: Not set"
+        end
+
+        if ENV['OLLAMA_MODEL_OPTIONS']
+          puts "Ollama Model Options: #{ENV['OLLAMA_MODEL_OPTIONS']}"
+        else
+          puts "Ollama Model Options: Not set (using defaults)"
+        end
+
+        # XDG config home
+        puts "XDG config home: #{xdg_config_home.to_s.inspect}"
+
+        # General
+        puts "Gem Name: #{name}"
+        puts "Version: #{version}"
+
+        # Build/Development
+        puts "MAKE: #{ENV['MAKE'] || 'Not set (will use gmake or make)'}"
+        puts "EDITOR: #{ENV['EDITOR'] || 'Not set (will use vi)'}"
+
+        # Git
+        puts "Git Remote(s): #{ENV['GIT_REMOTE'] || 'origin'}"
+
+        # Other
+        puts "Force Operations: #{ENV['FORCE'] || '0'}"
+        puts "Version Override: #{ENV['VERSION'] || 'Not set'}"
+        puts "GitHub Release Enabled: #{ENV['GITHUB_RELEASE_ENABLED'] || 'Not set'}"
+
+        puts "\n=== AI Prompt Configuration (Default Values) ==="
+        arrow = ?⤵
+        puts bold{"version_bump_system_prompt.txt"} + "#{arrow}\n" + italic{default_version_bump_system_prompt}
+        puts bold{"version_bump_prompt.txt"} + "#{arrow}\n#{default_version_bump_prompt}"
+        puts bold{"release_system_prompt.txt"} + "#{arrow}\n" + italic{default_git_release_system_prompt}
+        puts bold{"release_prompt.txt"} + "#{arrow}\n" + italic{default_git_release_prompt}
+
+        puts "=== End Configuration ==="
+      end
+    end
+  end
+
   # The create_all_tasks method sets up and registers all the Rake tasks for
   # the gem project.
   #
   # @return [GemHadar] the instance of GemHadar
   def create_all_tasks
     default_task
+    config_task
     build_task
     rvm_task
     version_task
@@ -1144,20 +1211,53 @@ class GemHadar
     temp_file&.close&.unlink
   end
 
+  dsl_accessor :ollama_model_default, 'llama3.1'.freeze
+
+  # The ollama_model method retrieves the name of the Ollama AI model to be
+  # used for generating responses.
+  #
+  # It first checks the OLLAMA_MODEL environment variable for a custom model
+  # specification. If the environment variable is not set, it falls back to
+  # using the default model name, which is determined by the
+  # ollama_model_default dsl method.
+  #
+  # @return [ String ] the name of the Ollama AI model to be used
+  def ollama_model
+    ENV.fetch('OLLAMA_MODEL', ollama_model_default)
+  end
+
+  # The ollama_client method creates and returns an Ollama::Client instance
+  # configured with a base URL derived from environment variables.
+  #
+  # It first checks for the OLLAMA_URL environment variable to determine the
+  # base URL. If that is not set, it falls back to using the OLLAMA_HOST
+  # environment variable, defaulting to 'localhost:11434' if that is also not
+  # set. The method then constructs the full base URL and initializes an
+  # Ollama::Client with appropriate timeouts for read and connect operations.
+  #
+  # @return [Ollama::Client, nil] An initialized Ollama::Client instance if a valid base URL is present, otherwise nil.
+  def ollama_client
+    base_url = ENV['OLLAMA_URL']
+    if base_url.blank?
+      host = ENV.fetch('OLLAMA_HOST', 'localhost:11434')
+      base_url = 'http://%s' % host
+    end
+    base_url.present? or return
+    ollama = Ollama::Client.new(base_url:, read_timeout: 600, connect_timeout: 60)
+  end
+
   # Generates a response from an AI model using the Ollama::Client.
   #
   # @param [String] system The system prompt for the AI model.
   # @param [String] prompt The user prompt to generate a response to.
   # @return [String, nil] The generated response or nil if generation fails.
   def ollama_generate(system:, prompt:)
-    base_url = ENV['OLLAMA_URL']
-    if base_url.blank? && host = ENV['OLLAMA_HOST'].full?
-      base_url = 'http://%s' % host
+    unless ollama = ollama_client
+      warn "Ollama is not configured. => Returning."
+      return
     end
-    base_url.present? or return
-    ollama   = Ollama::Client.new(base_url:, read_timeout: 600, connect_timeout: 60)
-    model    = ENV.fetch('OLLAMA_MODEL', 'llama3.1')
-    options  = ENV['OLLAMA_OPTIONS'].full? { |o| JSON.parse(o) } || {}
+    model    = ollama_model
+    options  = ENV['OLLAMA_MODEL_OPTIONS'].full? { |o| JSON.parse(o) } || {}
     options |= { "temperature" => 0, "top_p" => 1, "min_p" => 0.1 }
     ollama.generate(model:, system:, prompt:, options:, stream: false, think: false).response
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gem_hadar
 version: !ruby/object:Gem::Version
-  version: 1.26.0
+  version: 1.28.0
 platform: ruby
 authors:
 - Florian Frank
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.26'
+        version: '1.27'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.26'
+        version: '1.27'
 - !ruby/object:Gem::Dependency
   name: tins
   requirement: !ruby/object:Gem::Requirement
@@ -119,6 +119,7 @@ extra_rdoc_files:
 - lib/gem_hadar/github.rb
 - lib/gem_hadar/prompt_template.rb
 - lib/gem_hadar/setup.rb
+- lib/gem_hadar/simplecov.rb
 - lib/gem_hadar/template_compiler.rb
 - lib/gem_hadar/utils.rb
 - lib/gem_hadar/version.rb
@@ -135,6 +136,7 @@ files:
 - lib/gem_hadar/github.rb
 - lib/gem_hadar/prompt_template.rb
 - lib/gem_hadar/setup.rb
+- lib/gem_hadar/simplecov.rb
 - lib/gem_hadar/template_compiler.rb
 - lib/gem_hadar/utils.rb
 - lib/gem_hadar/version.rb