File: CHANGELOG — Documentation by YARD 0.9.44

# Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning,
and yes, platform and engine support are part of the public API.
Please file a bug if you notice a violation of semantic versioning.

## Unreleased

### Added

### Changed

### Deprecated

### Removed

### Fixed

### Security

## 1.1.15 - 2026-08-01

- TAG: v1.1.15
- COVERAGE: 100.00% – 119/119 lines in 8 files
- BRANCH COVERAGE: 100.00% – 4/4 branches in 8 files
- 92.59% documented

### Changed

- kettle-jem-template-20260716-001 - Shim gemspec manifests now include
  `LICENSE.md` instead of nonexistent `LICENSE.txt`.

- kettle-jem-template-20260716-002 - Generated gemspec manifests now ship fewer
  repository-only files by default to reduce downstream distro packaging churn.

- kettle-jem-template-20260720-002 - Development Gemfiles now use the released
  `tree_sitter_language_pack` gem 1.13.3 or newer by default.
- kettle-jem-template-20260725-002 - Version specs now use `anonymous_loader` to
  cover `version.rb` without redefining constants, or are removed when version
  specs are not managed for the project.
- kettle-jem-template-20260728-001 - Generated Ruby workflows now use clearer
  setup-ruby-flash planning and can prepare appraisal-only jobs without
  installing the main Gemfile bundle.

### Added

- kettle-jem-template-20260720-001 - READMEs can now display configured
  corporate sponsor logos.
- kettle-jem-template-20260720-005 - README Support & Community links now
  include RubyForum.
- kettle-jem-template-20260726-001 - Projects now include YARD lint
  configuration and documentation dependencies so documentation issues fail
  before generated docs are refreshed.
- kettle-jem-template-20260727-001 - Spec harness documentation now lists the
  RSpec helpers provided by `kettle-test`.
- kettle-jem-template-20260729-005 - Gemspec metadata now publishes this
  project’s RubyForum tag as `mailing_list_uri`, and support docs link to the
  tagged RubyForum community alongside Discord.

### Fixed

- kettle-jem-template-20260720-003 - StructuredMerge Git diff driver config now
  uses the installed `smorg-rb` driver command.
- kettle-jem-template-20260720-004 - MRI-only projects now omit JRuby and
  TruffleRuby workflow jobs.
- kettle-jem-template-20260725-001 - Release pull request branches beginning
  with `feature/release` now run JRuby and TruffleRuby workflows.
- kettle-jem-template-20260726-002 - Generated version files now document their
  version namespace and constants, reducing warning-only YARD lint output.
- kettle-jem-template-20260726-003 - Coverage upload steps now treat Coveralls,
  QLTY, and Codecov as optional, so provider outages do not fail CI when local
  coverage thresholds still pass.
- kettle-jem-template-20260728-002 - Generated RuboCop configs now ignore the
  same `gemfiles/vendor/bundle` tree as `.gitignore`, so vendored dependency
  installs are not reported as project lint debt.
- kettle-jem-template-20260728-003 - Generated dep-heads workflows now run
  TruffleRuby jobs with current RubyGems and Bundler, avoiding setup failures
  before the test suite starts.
- kettle-jem-template-20260728-004 - Generated dep-heads workflows now use the
  setup-ruby Bundler install path for direct appraisal Gemfiles, avoiding rv
  lockfile parser failures on Git and path dependencies.
- kettle-jem-template-20260728-005 - VersionGem bootstrap now creates the
  missing canonical version spec when a project only has shim namespace version
  specs.
- kettle-jem-template-20260729-001 - Generated JRuby 9.4 workflows now use the
  legacy manual bundle install path, avoiding setup-time Bundler full-index
  failures against `gem.coop`.
- kettle-jem-template-20260729-002 - VersionGem bootstrap now preserves
  and templates dedicated `version_gem.rb` entrypoints even when the gemspec
  dependency is intentionally omitted, and generated anonymous-loader specs
  cover both `version.rb` and `version_gem.rb`.
- kettle-jem-template-20260729-003 - Old-Ruby gems below the VersionGem runtime
  floor now get managed minimal `version.rb` files and anonymous-loader version
  specs without adding `version_gem`.
- kettle-jem-template-20260730-001 - Gemspec package file enumeration now runs
  relative to the gemspec directory, so release package contents stay correct
  even when the gemspec is loaded from another working directory.

## 1.1.14 - 2026-07-13

- TAG: v1.1.14
- COVERAGE: 100.00% – 119/119 lines in 8 files
- BRANCH COVERAGE: 100.00% – 4/4 branches in 8 files
- 85.19% documented

### Fixed

- Package configured license files in gem release file lists.

## 1.1.13 - 2026-06-22

- TAG: v1.1.13
- COVERAGE: 48.74% – 58/119 lines in 8 files
- BRANCH COVERAGE: 0.00% – 0/4 branches in 8 files
- 85.19% documented

### Added

- Added support for JRuby 10.1 and TruffleRuby 34.0.

### Changed

- Retemplated project metadata and CI/development automation with `kettle-jem` v7.0.0.

### Fixed

- Corrected RubyGems homepage metadata to point at the gem documentation site.

- Corrected persisted Open Collective metadata to use the `ruby-oauth`
  collective.

- Updated the SimpleCov bootstrap so `.simplecov` remains configuration-only
  and coverage starts before the test harness can load `version_gem`.

## 1.1.12 - 2026-06-14

- TAG: v1.1.12
- COVERAGE: 100.00% – 58/58 lines in 2 files
- BRANCH COVERAGE: 0.00% – 0/0 branches in 2 files
- 85.19% documented

### Changed

- Retemplated repository metadata, workflows, modular gemfiles, and documentation
  scaffolding with the current `kettle-jem` template.

### Fixed

- Restored `docs/CNAME` so the generated documentation site keeps its custom domain.
- Corrected misspelled contact metadata to use `galtzo.com`.

## 1.1.11 - 2026-06-06

- TAG: v1.1.11
- COVERAGE: 100.00% – 58/58 lines in 2 files
- BRANCH COVERAGE: 0.00% – 0/0 branches in 2 files
- 85.19% documented

### Added

- Added the generated `appraisal2` binstub.

### Changed

- Refreshed generated CI workflows, README support badges, gemspec development
  dependency floors, and template metadata from the current kettle-jem
  template.
- Updated generated Appraisal2 integration to use the `appraisal2-rubocop`
  plugin DSL and raised the generated `appraisal2` / `appraisal2-rubocop`
  dependency floors.

## 1.1.10 - 2026-06-02

- TAG: v1.1.10
- COVERAGE: 100.00% – 58/58 lines in 2 files
- BRANCH COVERAGE: 0.00% – 0/0 branches in 2 files
- 85.19% documented

### Added

- StructuredMerge-managed template configuration under `.structuredmerge/`,
  including semantic Git diff driver settings and kettle-drift integration.
- `rubocop-gradual` baseline tracking for style checks.

### Changed

- Re-templated the project with the current kettle-jem / StructuredMerge
  template.
- Development and test dependency floors now use current template floors:
  `kettle-dev` 2.0.7, `kettle-test` 2.0.3, `kettle-soup-cover` 2.0.0,
  `turbo_tests2` 3.1.1, `rubocop-lts` 8.3.0, and
  `rubocop-lts-rspec` 1.0.3.
- Development and test tooling now targets Ruby 2.4 or newer while the
  published runtime Ruby requirement remains Ruby 2.2 or newer.
- RSpec setup now loads `kettle-test` helpers and kettle-soup-cover coverage
  bootstrap from `spec/spec_helper.rb`.
- Templating dependencies now load only when `K_JEM_TEMPLATING=true`, with
  local StructuredMerge and Kettle workspace dependencies wired through
  `STRUCTUREDMERGE_DEV`, `KETTLE_DEV_DEV`, and `nomono`.
- Gem metadata and packaging inventory were refreshed by the template,
  including homepage, wiki, license-file, and packaged file handling.

### Removed

- Removed the obsolete `.yard_gfm_support.rb` documentation hook; YARD setup now
  uses the current template-managed plugin configuration.
- Removed obsolete CI workflows for Ruby 2.3, JRuby 9.1, TruffleRuby 23.2,
  CodeQL, framework CI, and Discord notifications.
- Removed legacy generated binstubs in favor of the current curated
  `kettle-check-eof`, `kettle-test`, and retained documentation binstubs.

### Fixed

- logo at top of README.md

- Fixed the Style workflow RBS validation command so CI uses the bundled `rbs`
  executable instead of the non-executable `bin/rbs` binstub.
- Fixed the Coverage workflow so Codecov repository-registration/upload errors
  do not fail CI after local coverage reports have already been generated and
  verified.

## 1.1.9 - 2025-09-02

- TAG: v1.1.9
- COVERAGE: 100.00% – 118/118 lines in 8 files
- BRANCH COVERAGE: 100.00% – 4/4 branches in 8 files
- 84.62% documented

### Added

- re-templated gem using kettle-dev v1.1.2
  - new binstubs for changelog, readme, commit message, & release management
  - new CI workflows
  - enhanced project documentation
- More RBS types
- docs site: https://version-gem.galtzo.com

### Fixed

- RBS types are more accurate

## 1.1.8 2025-05-06

- TAG: 1.1.8
- COVERAGE: 100.00% – 118/118 lines in 8 files
- BRANCH COVERAGE: 100.00% – 4/4 branches in 8 files
- 84.62% documented

### Added

- CITATION.cff (@pboling)
- Cryptographically signed with new 20-year cert (@pboling)
  - expires 2045-04-29
- Improved documentation (@pboling)
- Addressed entire REEK list (@pboling)
- GitLab CI, as an addition to existing GHA (@pboling)

## 1.1.7 2025-04-15

- TAG: 1.1.7
- Line Coverage: 100.0% (117 / 117)
- Branch Coverage: 100.0% (4 / 4)
- 76.92% documented

### Added

- Support for Epoch Semantic Versioning (@pboling)
  - `extend VersionGem::Epoch` in your library’s `MyLib::Version` module
- Support for JRuby 10 (@pboling)
- More documentation (@pboling)

### Removed

- Ruby 2.2 removed from CI, though technically still supported
  - can’t run directly in GHA anymore

## 1.1.6 2025-02-24

- TAG: 1.1.6
- Line Coverage: 100.0% (77 / 77)
- Branch Coverage: 100.0% (2 / 2)
- 77.78% documented

### Added

- Support for JRuby 9.1, 9.2, 9.3, 9.4, and head (@pboling)
- Support for Truffle Ruby 22.3, 23.0, 23.1, 24.1, and head (@pboling)
- Evergreen current latest engine release workflow (@pboling)
  - Runs ruby, truffleruby, and jruby, always latest release
- Improved developer experience for contributors (@pboling)
- More documentation (@pboling)
- Switch to stone_checksums for checksum generation (@pboling)

### Changed

- Code of Conduct updated - Contributor Covenant v2.0 => v2.1 (@pboling)

## 1.1.5 2025-02-22

- TAG: 1.1.5
- Line Coverage: 100.0% (77 / 77)
- Branch Coverage: 100.0% (2 / 2)
- 77.78% documented

### Added

- Document approach to get code coverage on your gem’s version.rb file (@pboling)
- More documentation, and yard task for documentation (@pboling)
- Documentation of Ruby version and SemVer support (@pboling)

### Fixed

- #3 - Allow packaging without signing (@pboling)
  - to support secure linux distros which have alternate means of signing packages within their package managers
- Code coverage tracking (@pboling)
- Documentation of usage in gemspec via `Kernel.load` (@pboling)
- Improved gemspec config (@pboling)

## 1.1.4 2024-03-21

- TAG: 1.1.4

### Added

- Ruby 3.3 to CI (@pboling)

### Fixed

- Remove the executable bit from non-executable files (@Fryguy)

## 1.1.3 2023-06-05

- TAG: 1.1.3

### Added

- More test coverage (now 100% 🎉) (@pboling)
- Improved documentation (now 77% 🎉) (@pboling)
- Gemfile context pattern (@pboling)
- Improved linting (via rubocop-lts) (@pboling)
- More robust GHA config (@pboling)
- (dev) Dependencies (@pboling)
  - yard-junk
  - redcarpet
  - pry, IRB alternative
  - pry-suite
  - debase, for IDE debugging
- (dev) Rake task for rubocop_gradual (@pboling)

### Fixed

- (dev) `yard` documentation task (@pboling)

### Removed

- Formally drop Ruby 2.2 support
  - Ruby 2.2 was already de facto minimum version supported, which is why this wasn’t a 2.0 release.

## 1.1.2 - 2023-03-17

- TAG: 1.1.2

### Added

- `VersionGem::Ruby` to help library CI integration against many different versions of Ruby (@pboling)
  - Experimental, optional, require (not loaded by default, which is why this can be in a patch)
- Spec coverage is now 100%, lines and branches, including the fabled `version.rb` (@pboling)
- Full RBS Signatures (@pboling)

## 1.1.1 - 2022-09-19

- TAG: 1.1.1

### Added

- Alternatives section to README.md (@pboling)
- Signing cert for gem releases (@pboling)
- Mailing List and other metadata URIs (@pboling)
- Checksums for released gems (@pboling)

### Changed

- SECURITY.md policy (@pboling)

- Version methods are now memoized ( |  | =) on initial call for performance (@pboling)

- Gem releases are now cryptographically signed (@pboling)

## 1.1.0 - 2022-06-24

- TAG: 1.1.0

### Added

- RSpec Matchers and Shared Example (@pboling)

### Fixed

- `to_a` uses same type casting as major, minor, patch, and pre (@pboling)

## 1.0.2 - 2022-06-23

- TAG: 1.0.2

### Added

- Delay loading of library code until after code coverage tool is loaded (@pboling)

## 1.0.1 - 2022-06-23

- TAG: 1.0.1

### Added

- CI Build improvements (@pboling)
- Code coverage reporting (@pboling)
- Documentation improvements (@pboling)
- Badges! (@pboling)

## 1.0.0 - 2022-06-21

- TAG: 1.0.0

### Added

- Initial release, with basic version parsing API (@pboling)