Instance Method Details
- #gems(gems:, prefix: "NOMONO_GEMS", allowlist: gems, path_env: nil, vendored_gems_env: nil, vendor_gem_dir_env: nil, debug_env: nil, root: ["src", "my"], strict: true) ⇒ Object
+ #gems(gems:, prefix: "NOMONO_GEMS", allowlist: gems, path_env: nil, vendored_gems_env: nil, vendor_gem_dir_env: nil, debug_env: nil, path_aliases: nil, path_aliases_env: nil, root: ["src", "my"], strict: true, **_options) ⇒ Object
@@ -288,13 +288,16 @@
37
38
39
-40
+40
+41
+42
+43
# File 'lib/nomono/resolver.rb', line 14
def gems(gems:, prefix: "NOMONO_GEMS", allowlist: gems, path_env: nil, vendored_gems_env: nil, vendor_gem_dir_env: nil,
- debug_env: nil, root: ["src", "my"], strict: true)
+ debug_env: nil, path_aliases: nil, path_aliases_env: nil, root: ["src", "my"], strict: true, **)
requested = normalize_gems(gems)
allowed = normalize_gems(allowlist)
requested.each { |gem_name| validate_gem_name!(gem_name, allowed, strict: strict) }
@@ -307,10 +310,13 @@
vendored = parse_vendored(fetch_with_fallback(vendored_gems_env || "#{prefix}_VENDORED_GEMS", "", "VENDORED_GEMS"), allowed)
vendor_dir_value = fetch_with_fallback(vendor_gem_dir_env || "#{prefix}_VENDOR_GEM_DIR", File.join(dev_root, "vendor"), "VENDOR_GEM_DIR")
vendor_dir = absolutize(vendor_dir_value)
+ aliases = normalize_path_aliases(
+ path_aliases || fetch_with_fallback(path_aliases_env || "#{prefix}_PATH_ALIASES", "", "NOMONO_PATH_ALIASES")
+ )
gem_paths = requested.each_with_object({}) do |gem_name, memo|
base = vendored.include?(gem_name) ? vendor_dir : dev_root
- memo[gem_name] = File.join(base, gem_name)
+ memo[gem_name] = normalize_path_alias(File.join(base, gem_name), aliases)
end
debug_key = debug_env || "#{prefix}_DEBUG"
@@ -330,9 +336,9 @@
diff --git a/docs/Nomono/Version.html b/docs/Nomono/Version.html
index ed941b6..bcb01f1 100644
--- a/docs/Nomono/Version.html
+++ b/docs/Nomono/Version.html
@@ -6,7 +6,7 @@
Module: Nomono::Version
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -98,7 +98,7 @@
VERSION =
- "1.0.8""1.1.0"
diff --git a/docs/_index.html b/docs/_index.html
index ead611a..d7a25a5 100644
--- a/docs/_index.html
+++ b/docs/_index.html
@@ -4,7 +4,7 @@
- Documentation by YARD 0.9.44
+ Documentation by YARD 0.9.45
@@ -54,7 +54,7 @@
-
diff --git a/docs/file.AGENTS.html b/docs/file.AGENTS.html
index 33a432c..ddb5a59 100644
--- a/docs/file.AGENTS.html
+++ b/docs/file.AGENTS.html
@@ -6,7 +6,7 @@
File: AGENTS
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -410,9 +410,9 @@
diff --git a/docs/file.AGPL-3.0-only.html b/docs/file.AGPL-3.0-only.html
index 672a8cb..3ab78b7 100644
--- a/docs/file.AGPL-3.0-only.html
+++ b/docs/file.AGPL-3.0-only.html
@@ -6,7 +6,7 @@
File: AGPL-3.0-only
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -342,9 +342,9 @@
diff --git a/docs/file.CHANGELOG.html b/docs/file.CHANGELOG.html
index 445a003..4abc5ec 100644
--- a/docs/file.CHANGELOG.html
+++ b/docs/file.CHANGELOG.html
@@ -6,7 +6,7 @@
File: CHANGELOG
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -70,7 +70,7 @@
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
+Unreleased
Added
@@ -84,6 +84,60 @@ Fixed
Security
+
+1.1.0 - 2026-07-21
+
+
+ - TAG: v1.1.0
+
+ - COVERAGE: 97.56% – 120/123 lines in 7 files
+ - BRANCH COVERAGE: 86.67% – 39/45 branches in 7 files
+ - 12.50% documented
+
+
+Added
+
+
+ - Added opt-in path alias normalization so local sibling paths can be rewritten
+to a configured canonical spelling before Bundler writes them to lockfiles.
+
+
+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-001 - Generated READMEs can now render
+template-managed corporate sponsor logos from project or family config.
+ - kettle-jem-template-20260720-002 - Generated development Gemfiles now use the
+released tree_sitter_language_pack gem 1.13.3 or newer by default.
+ - kettle-jem-template-20260720-003 - Generated StructuredMerge Git diff driver
+config now uses the installed smorg-rb Ruby driver name.
+ - kettle-jem-template-20260720-004 - Generated multi-engine workflow files now
+omit JRuby and TruffleRuby jobs when project config declares MRI-only engines.
+ - kettle-jem-template-20260720-005 - Generated README Support & Community rows
+now include a RubyForum help badge.
+
+
+Fixed
+
+
+ -
+
Documented why nomono uses an explicit Gemfile loader instead of the
+Bundler plugin DSL or RubyGems plugin autoload hooks, and simplified
+nomono’s own local Gemfiles to load the local Bundler integration directly.
+
+ -
+
Addressed review feedback by keeping split license detail links pointed at
+the source repository, keeping tree_sitter_language_pack in the templating
+dependency path only, and regenerating YARD documentation.
+
+
+
1.0.8 - 2026-07-13
@@ -106,7 +160,7 @@
12.50% documented
-Fixed
+Fixed
- Package configured license files in gem release file lists.
@@ -123,7 +177,7 @@
- 8.70% documented
-Fixed
+Fixed
- Removed
version_gem from nomono’s default load path, allowing Gemfiles
@@ -145,23 +199,23 @@
- 12.50% documented
-Added
+Added
- Added support for JRuby 10.1 and TruffleRuby 34.0.
-Changed
+Changed
- Retemplated project metadata and CI/development automation with
kettle-jem v7.0.0.
-Fixed
+Fixed
- Corrected OpenCollective funding metadata to use the
kettle-dev collective.
- - Updated the default local workspace root from
$HOME/src/kettle-rb to
+ - Updated the default local workspace root from
$HOME/src/kettle-dev to
$HOME/src/my.
@@ -176,14 +230,14 @@
12.50% documented
-Changed
+Changed
- Retemplated with the current kettle-jem template set, refreshing generated
README metadata, the templating dependency floor, and the development lockfile.
-Fixed
+Fixed
- Removed a duplicate RBS
Nomono::VERSION declaration and strengthened the
@@ -201,14 +255,14 @@
- 12.50% documented
-Changed
+Changed
- Development tooling now resolves
kettle-dev 2.2.3, kettle-test 2.0.5,
kettle-soup-cover 2.0.2, and yard-fence 0.9.3 or newer.
-Fixed
+Fixed
-
@@ -231,14 +285,14 @@
- 12.50% documented
-Added
+Added
- Added StructuredMerge git diff driver configuration and the incident response
plan from the current kettle-jem template.
-Changed
+Changed
- Retemplated with the current kettle-jem template set, including the
@@ -247,7 +301,7 @@ Changed
kettle-dev 2.0.6 development dependency floor.
-Fixed
+Fixed
- Fixed generated documentation URLs that incorrectly pointed at a monorepo
@@ -267,19 +321,19 @@
- 12.50% documented
-Added
+Added
- Improved documentation of ENV variables and overrides in README.md
-Changed
+Changed
- Retemplated with the current kettle-jem template set.
-Fixed
+Fixed
- (dev) Updated the development dependency floor to
kettle-dev 2.0.1 so the
@@ -304,9 +358,9 @@
diff --git a/docs/file.CODE_OF_CONDUCT.html b/docs/file.CODE_OF_CONDUCT.html
index 323b6de..80d09d4 100644
--- a/docs/file.CODE_OF_CONDUCT.html
+++ b/docs/file.CODE_OF_CONDUCT.html
@@ -6,7 +6,7 @@
File: CODE_OF_CONDUCT
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -193,9 +193,9 @@ Attribution
diff --git a/docs/file.CONTRIBUTING.html b/docs/file.CONTRIBUTING.html
index 15456e4..d1f9aa0 100644
--- a/docs/file.CONTRIBUTING.html
+++ b/docs/file.CONTRIBUTING.html
@@ -6,7 +6,7 @@
File: CONTRIBUTING
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -94,6 +94,22 @@ Help out!
- Announce it in the channel for this org in the Discord!
+Ruby engine CI branches
+
+Pull requests run MRI workflows by default. JRuby and TruffleRuby workflows are
+available by branch naming convention so ordinary PRs do not spend CI time on
+alternate Ruby engines.
+
+
+ - Use a branch named
jruby/* to run JRuby workflows for a pull request.
+ - Use a branch named
truffleruby/* to run TruffleRuby workflows for a pull
+request.
+ - Use a branch named
engines/* to run both JRuby and TruffleRuby workflows for
+a pull request.
+
+
+Pushes to the default branch continue to run the configured engine workflows.
+
Executables vs Rake tasks
Executables shipped by dependencies, such as kettle-dev, and stone_checksums, are available
@@ -195,7 +211,7 @@
Environment Variables for L
- Use
git diff --no-ext-diff to compare against Git’s built-in diff output.
- Use
git diff --no-textconv when a textconv projection obscures the raw file bytes you need to inspect.
- If Git reports a missing
smorg-* executable, rerun bundle install and the setup command above, then check git config --local --get-regexp '^diff\.smorg-'.
- - To remove managed local entries, run
K_JEM_TEMPLATING=true kettle-jem install --undo; remove global command registrations with git config --global --unset-all diff.smorg-ruby.command.
+ - To remove managed local entries, run
K_JEM_TEMPLATING=true kettle-jem install --undo; remove global command registrations with git config --global --unset-all diff.smorg-rb.command, git config --global --unset-all merge.smorg-rb.driver, and git config --global --unset-all merge.smorg-rb.name.
For a quick starting point, this repository’s mise.toml defines the shared defaults, and .env.local can override them locally. Copy .env.local.example to .env.local, use KEY=value lines, and either activate mise in your shell or run commands through mise exec -C /path/to/project -- ....
@@ -360,9 +376,9 @@ Manual process
diff --git a/docs/file.FUNDING.html b/docs/file.FUNDING.html
index 1bc9f91..d80c1ba 100644
--- a/docs/file.FUNDING.html
+++ b/docs/file.FUNDING.html
@@ -6,7 +6,7 @@
File: FUNDING
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -101,9 +101,9 @@ Another Way to Support Open
diff --git a/docs/file.IRP.html b/docs/file.IRP.html
index a323fc1..a2fc672 100644
--- a/docs/file.IRP.html
+++ b/docs/file.IRP.html
@@ -6,7 +6,7 @@
File: IRP
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -98,9 +98,9 @@ Follow-up
diff --git a/docs/file.LICENSE.html b/docs/file.LICENSE.html
index be78b5b..cdbbd60 100644
--- a/docs/file.LICENSE.html
+++ b/docs/file.LICENSE.html
@@ -6,7 +6,7 @@
File: LICENSE
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -65,7 +65,7 @@
Choose the option that best fits your use case:
If none of the above licenses fit your use case, please contact us to discuss a custom commercial license.
@@ -78,9 +78,9 @@ Copyright Notice
diff --git a/docs/file.README.html b/docs/file.README.html
index c97f364..9255932 100644
--- a/docs/file.README.html
+++ b/docs/file.README.html
@@ -6,7 +6,7 @@
File: README
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -139,13 +139,13 @@ 💡 Info you can shake a stick at
Support & Community
-
+ 
Source
-
+ 
@@ -385,21 +385,23 @@ ⚙️ Configuration
NOMONO_GEMS_VENDOR_GEM_DIR (or legacy VENDOR_GEM_DIR) is the base path of the vendor directory used for gems listed in NOMONO_GEMS_VENDORED_GEMS. Defaults to $workspace_root/vendor. This is not an alternative form of the workspace root — it only affects vendored gems.
+NOMONO_GEMS_PATH_ALIASES (or global fallback NOMONO_PATH_ALIASES) is a comma-delimited list of source=canonical absolute path aliases. Each pair must resolve to the same real directory. Matching local gem paths are rewritten to the canonical spelling before Bundler receives them, preventing Gemfile.lock churn from equivalent paths such as /var/home/... and /home/....
+
NOMONO_GEMS_DEBUG enables debug output from nomono.
Examples
-For example, in the kettle-dev family of gems, which nomono is a part of, the parameters used are prefix: "KETTLE_RB", path_env: "KETTLE_RB_DEV".
+
For example, in the kettle-dev family of gems, which nomono is a part of, the parameters used are prefix: "KETTLE_DEV", path_env: "KETTLE_DEV_DEV".
This means that the following is true:
-
-
KETTLE_RB_DEV=false (or unset) — released gems from configured gem server (CI / single-gem development default)
+KETTLE_DEV_DEV=false (or unset) — released gems from configured gem server (CI / single-gem development default)
-
-
KETTLE_RB_DEV=true — local sibling gems from $HOME/src/kettle-dev/<gem> (recommended for full-workspace development)
+KETTLE_DEV_DEV=true — local sibling gems from $HOME/src/kettle-dev/<gem> (recommended for full-workspace development)
-
-
KETTLE_RB_DEV=/custom/path — local sibling gems from /custom/path/<gem> (non-standard workspace layout only)
+KETTLE_DEV_DEV=/custom/path — local sibling gems from /custom/path/<gem> (non-standard workspace layout only)
You can override the env variable names via options. Here is an example for use with rubocop-lts gems:
@@ -422,10 +424,10 @@ 🔧 Basic Usage
source "https://gem.coop"
-if ENV.fetch("KETTLE_RB_DEV", "false").casecmp("false").zero?
+if ENV.fetch("KETTLE_DEV_DEV", "false").casecmp("false").zero?
gem "kettle-dev", "~> 2.2", ">= 2.2.15"
gem "kettle-test", "~> 2.0", ">= 2.0.6"
- gem "kettle-soup-cover", "~> 3.0.a", ">= 3.0.0.rc4"
+ gem "kettle-soup-cover", "~> 3.0", ">= 3.0.1"
else
eval_gemfile "gemfiles/modular/local.gemfile"
end
@@ -437,8 +439,11 @@ 🔧 Basic Usage
eval_nomono_gems(
gems: %w[kettle-dev kettle-test kettle-soup-cover],
- prefix: "KETTLE_RB",
- path_env: "KETTLE_RB_DEV",
+ prefix: "KETTLE_DEV",
+ path_env: "KETTLE_DEV_DEV",
+ path_aliases: {
+ "/var/home/pboling" => "/home/pboling"
+ },
vendored_gems_env: "VENDORED_GEMS",
vendor_gem_dir_env: "VENDOR_GEM_DIR",
debug_env: "KETTLE_DEV_DEBUG"
@@ -447,9 +452,22 @@ 🔧 Basic Usage
This is the pattern generated by kettle-jem: the Gemfile remains readable,
and nomono owns the path normalization for sibling repositories. When
-KETTLE_RB_DEV=false or is unset, the modular local override is skipped and
+KETTLE_DEV_DEV=false or is unset, the modular local override is skipped and
Bundler resolves released gems normally.
+nomono uses an explicit require "nomono/bundler" loader instead of the
+Bundler plugin DSL. Bundler plugins are installed extensions for Bundler
+commands, source handlers, and lifecycle hooks; nomono only needs to install
+Gemfile macros while Bundler is evaluating a Gemfile. The root Gemfile should
+declare the compatible nomono version, and modular local Gemfiles should fail
+normally if that loader is unavailable or incompatible.
+
+nomono also avoids RubyGems plugin autoload hooks for this path. Those hooks
+are appropriate for gems that must globally patch RubyGems or Bundler before
+dependency resolution can work. Local sibling overrides do not need cold-boot
+global patches: the root Gemfile installs nomono, and the ENV-gated modular
+Gemfile explicitly loads the macros only when it needs them.
+
🔐 Security
See SECURITY.md.
@@ -536,7 +554,7 @@ 📌 Versioning
📄 License
-The gem is available under the following license: AGPL-3.0-only.
+
The gem is available under the following license: AGPL-3.0-only.
See LICENSE.md for details.
If none of the available licenses suit your use case, please contact us to discuss a custom commercial license.
@@ -590,9 +608,9 @@ Please give the project a star ⭐ ♥
diff --git a/docs/file.RUBOCOP.html b/docs/file.RUBOCOP.html
index 6b0ac26..bd82bbc 100644
--- a/docs/file.RUBOCOP.html
+++ b/docs/file.RUBOCOP.html
@@ -6,7 +6,7 @@
File: RUBOCOP
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -89,12 +89,14 @@ Checking RuboCop Violations
Understanding the Lock File
-
The .rubocop_gradual.lock file tracks all current RuboCop violations in the project. This allows the team to:
+The .rubocop_gradual.lock file is a work list, not a permanent baseline. Every entry represents a style issue that should be resolved by either fixing the code or making an intentional exception explicit.
+
+This allows the team to:
- - Prevent new violations while gradually fixing existing ones
+ - Prevent new violations while existing issues are handled deliberately
- Track progress on code style improvements
- - Ensure CI builds don’t fail due to pre-existing violations
+ - Distinguish temporary work items from intentional project style exceptions
Common Commands
@@ -126,29 +128,30 @@ Workflow
- Before submitting a PR, run
bundle exec rake rubocop_gradual:autocorrect
a. or just the default bundle exec rake, as autocorrection is a pre-requisite of the default task.
- - If there are new violations, either:
+
- If there are violations, either:
- Fix them in your code
- - Run
bundle exec rake rubocop_gradual:force_update to update the lock file (only for violations you can’t fix immediately)
+ - Normalize intentional deviations with an explicit config or inline exception
+ - Run
bundle exec rake rubocop_gradual:force_update only for temporary work items you cannot fix immediately
- Commit the updated
.rubocop_gradual.lock file along with your changes
-Never add inline RuboCop disables
+Explicit Style Exceptions
-Do not add inline rubocop:disable / rubocop:enable comments anywhere in the codebase (including specs, except when following the few existing rubocop:disable patterns for a rule already being disabled elsewhere in the code). We handle exceptions in two supported ways:
+Do not treat .rubocop_gradual.lock as a baseline. Treat it as a list of work that must be fixed or normalized into the styleguide.
-
- - Permanent/structural exceptions: prefer adjusting the RuboCop configuration (e.g., in
.rubocop.yml) to exclude a rule for a path or file pattern when it makes sense project-wide.
- - Temporary exceptions while improving code: record the current violations in
.rubocop_gradual.lock via the gradual workflow:
-
- -
-
bundle exec rake rubocop_gradual:autocorrect (preferred; will autocorrect what it can and update the lock only if no new violations were introduced)
- - If needed,
bundle exec rake rubocop_gradual:force_update (as a last resort when you cannot fix the newly reported violations immediately)
-
-
-
+Prefer this order:
+
+
+ - Fix the code so it follows the configured styleguide.
+ - For intentional project conventions, add the narrowest useful override in
.rubocop.yml or .rubocop_rspec.yml.
+ - For local intentional deviations, add a tightly scoped inline
rubocop:disable / rubocop:enable around the exact line or block.
+ - Keep an entry in
.rubocop_gradual.lock only as temporary work to be resolved later.
+
+
+Use configuration overrides when a deviation is structural, generated, path-specific, or applies consistently to a small set of files. Use inline disables when the exception is local and the reason is clearer at the code site than in global config.
In general, treat the rules as guidance to follow; fix violations rather than ignore them. For example, RSpec conventions in this project expect described_class to be used in specs that target a specific class under test.
@@ -156,16 +159,16 @@ Benefits of rubocop_gradual
- Allows incremental adoption of code style rules
- - Prevents CI failures due to pre-existing violations
- - Provides a clear record of code style debt
+ - Prevents CI failures due to temporary pre-existing violations
+ - Provides a clear work list of code style debt
- Enables focused efforts on improving code quality over time
diff --git a/docs/file.SECURITY.html b/docs/file.SECURITY.html
index 829aaff..33b8e6c 100644
--- a/docs/file.SECURITY.html
+++ b/docs/file.SECURITY.html
@@ -6,7 +6,7 @@
File: SECURITY
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -72,7 +72,7 @@ Supported Versions
- 1.0.latest
+ 1.1.latest
✅
@@ -93,9 +93,9 @@ Additional Support
diff --git a/docs/frames.html b/docs/frames.html
index 3223ddd..4a6186c 100644
--- a/docs/frames.html
+++ b/docs/frames.html
@@ -2,7 +2,7 @@
- Documentation by YARD 0.9.44
+ Documentation by YARD 0.9.45
# File 'lib/nomono/resolver.rb', line 14 def gems(gems:, prefix: "NOMONO_GEMS", allowlist: gems, path_env: nil, vendored_gems_env: nil, vendor_gem_dir_env: nil, - debug_env: nil, root: ["src", "my"], strict: true) + debug_env: nil, path_aliases: nil, path_aliases_env: nil, root: ["src", "my"], strict: true, **) requested = normalize_gems(gems) allowed = normalize_gems(allowlist) requested.each { |gem_name| validate_gem_name!(gem_name, allowed, strict: strict) } @@ -307,10 +310,13 @@vendored = parse_vendored(fetch_with_fallback(vendored_gems_env || "#{prefix}_VENDORED_GEMS", "", "VENDORED_GEMS"), allowed) vendor_dir_value = fetch_with_fallback(vendor_gem_dir_env || "#{prefix}_VENDOR_GEM_DIR", File.join(dev_root, "vendor"), "VENDOR_GEM_DIR") vendor_dir = absolutize(vendor_dir_value) + aliases = normalize_path_aliases( + path_aliases || fetch_with_fallback(path_aliases_env || "#{prefix}_PATH_ALIASES", "", "NOMONO_PATH_ALIASES") + ) gem_paths = requested.each_with_object({}) do |gem_name, memo| base = vendored.include?(gem_name) ? vendor_dir : dev_root - memo[gem_name] = File.join(base, gem_name) + memo[gem_name] = normalize_path_alias(File.join(base, gem_name), aliases) end debug_key = debug_env || "#{prefix}_DEBUG" @@ -330,9 +336,9 @@
diff --git a/docs/Nomono/Version.html b/docs/Nomono/Version.html index ed941b6..bcb01f1 100644 --- a/docs/Nomono/Version.html +++ b/docs/Nomono/Version.html @@ -6,7 +6,7 @@
Module: Nomono::Version - — Documentation by YARD 0.9.44 + — Documentation by YARD 0.9.45 @@ -98,7 +98,7 @@
VERSION = -+ "1.0.8"@@ -114,9 +114,9 @@ "1.1.0"diff --git a/docs/_index.html b/docs/_index.html index ead611a..d7a25a5 100644 --- a/docs/_index.html +++ b/docs/_index.html @@ -4,7 +4,7 @@
- Documentation by YARD 0.9.44 + Documentation by YARD 0.9.45 @@ -54,7 +54,7 @@ -diff --git a/docs/file.AGPL-3.0-only.html b/docs/file.AGPL-3.0-only.html index 672a8cb..3ab78b7 100644 --- a/docs/file.AGPL-3.0-only.html +++ b/docs/file.AGPL-3.0-only.html @@ -6,7 +6,7 @@diff --git a/docs/file.AGENTS.html b/docs/file.AGENTS.html index 33a432c..ddb5a59 100644 --- a/docs/file.AGENTS.html +++ b/docs/file.AGENTS.html @@ -6,7 +6,7 @@File: AGENTS - — Documentation by YARD 0.9.44 + — Documentation by YARD 0.9.45 @@ -410,9 +410,9 @@File: AGPL-3.0-only - — Documentation by YARD 0.9.44 + — Documentation by YARD 0.9.45 @@ -342,9 +342,9 @@ diff --git a/docs/file.CHANGELOG.html b/docs/file.CHANGELOG.html index 445a003..4abc5ec 100644 --- a/docs/file.CHANGELOG.html +++ b/docs/file.CHANGELOG.html @@ -6,7 +6,7 @@File: CHANGELOG - — Documentation by YARD 0.9.44 + — Documentation by YARD 0.9.45 @@ -70,7 +70,7 @@ 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
+Unreleased
Added
@@ -84,6 +84,60 @@Fixed
Security
++1.1.0 - 2026-07-21
+ ++
+ +- TAG: v1.1.0 +
+- COVERAGE: 97.56% – 120/123 lines in 7 files
+- BRANCH COVERAGE: 86.67% – 39/45 branches in 7 files
+- 12.50% documented
+Added
+ ++
+ +- Added opt-in path alias normalization so local sibling paths can be rewritten
+
+to a configured canonical spelling before Bundler writes them to lockfiles.Changed
+ ++
+ +- kettle-jem-template-20260716-001 - Shim gemspec manifests now include
+
+LICENSE.mdinstead of nonexistentLICENSE.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-001 - Generated READMEs can now render
+
+template-managed corporate sponsor logos from project or family config.- kettle-jem-template-20260720-002 - Generated development Gemfiles now use the
+
+releasedtree_sitter_language_packgem 1.13.3 or newer by default.- kettle-jem-template-20260720-003 - Generated StructuredMerge Git diff driver
+
+config now uses the installedsmorg-rbRuby driver name.- kettle-jem-template-20260720-004 - Generated multi-engine workflow files now
+
+omit JRuby and TruffleRuby jobs when project config declares MRI-only engines.- kettle-jem-template-20260720-005 - Generated README Support & Community rows
+
+now include a RubyForum help badge.Fixed
+ ++
+- +
+Documented why
+nomonouses an explicit Gemfile loader instead of the
+Bundler plugin DSL or RubyGems plugin autoload hooks, and simplified
+nomono’s own local Gemfiles to load the local Bundler integration directly.- +
+Addressed review feedback by keeping split license detail links pointed at
+
+the source repository, keepingtree_sitter_language_packin the templating
+dependency path only, and regenerating YARD documentation.1.0.8 - 2026-07-13
@@ -106,7 +160,7 @@
Fixed
+Fixed
- Package configured license files in gem release file lists. @@ -123,7 +177,7 @@
- 8.70% documented
Fixed
+Fixed
- Removed
version_gemfrom nomono’s default load path, allowing Gemfiles
@@ -145,23 +199,23 @@ - 12.50% documented
Added
+Added
- Added support for JRuby 10.1 and TruffleRuby 34.0.
Changed
+Changed
- Retemplated project metadata and CI/development automation with
kettle-jemv7.0.0.
Fixed
+Fixed
- Corrected OpenCollective funding metadata to use the
kettle-devcollective.
- - Updated the default local workspace root from
$HOME/src/kettle-rbto
+ - Updated the default local workspace root from
$HOME/src/kettle-devto
$HOME/src/my.
Changed
+Changed
- Retemplated with the current kettle-jem template set, refreshing generated
README metadata, the templating dependency floor, and the development lockfile.
Fixed
+Fixed
- Removed a duplicate RBS
Nomono::VERSIONdeclaration and strengthened the
@@ -201,14 +255,14 @@ - 12.50% documented
Changed
+Changed
- Development tooling now resolves
kettle-dev2.2.3,kettle-test2.0.5,
kettle-soup-cover2.0.2, andyard-fence0.9.3 or newer.
Fixed
+Fixed
-
@@ -231,14 +285,14 @@
- 12.50% documented
Added
+Added
- Added StructuredMerge git diff driver configuration and the incident response
plan from the current kettle-jem template.
Changed
+Changed
- Retemplated with the current kettle-jem template set, including the
@@ -247,7 +301,7 @@Changed
kettle-dev2.0.6 development dependency floor.
Fixed
+Fixed
- Fixed generated documentation URLs that incorrectly pointed at a monorepo
@@ -267,19 +321,19 @@ - 12.50% documented
Added
+Added
- Improved documentation of ENV variables and overrides in README.md
Changed
+Changed
- Retemplated with the current kettle-jem template set.
Fixed
+Fixed
- (dev) Updated the development dependency floor to
kettle-dev2.0.1 so the
@@ -304,9 +358,9 @@diff --git a/docs/file.CODE_OF_CONDUCT.html b/docs/file.CODE_OF_CONDUCT.html index 323b6de..80d09d4 100644 --- a/docs/file.CODE_OF_CONDUCT.html +++ b/docs/file.CODE_OF_CONDUCT.html @@ -6,7 +6,7 @@
File: CODE_OF_CONDUCT - — Documentation by YARD 0.9.44 + — Documentation by YARD 0.9.45 @@ -193,9 +193,9 @@Attribution
diff --git a/docs/file.CONTRIBUTING.html b/docs/file.CONTRIBUTING.html index 15456e4..d1f9aa0 100644 --- a/docs/file.CONTRIBUTING.html +++ b/docs/file.CONTRIBUTING.html @@ -6,7 +6,7 @@File: CONTRIBUTING - — Documentation by YARD 0.9.44 + — Documentation by YARD 0.9.45 @@ -94,6 +94,22 @@Help out!
- Announce it in the channel for this org in the Discord! +
- Use a branch named
jruby/*to run JRuby workflows for a pull request.
+ - Use a branch named
truffleruby/*to run TruffleRuby workflows for a pull
+request.
+ - Use a branch named
engines/*to run both JRuby and TruffleRuby workflows for
+a pull request.
+ - Use
git diff --no-ext-diffto compare against Git’s built-in diff output. - Use
git diff --no-textconvwhen a textconv projection obscures the raw file bytes you need to inspect. - If Git reports a missing
smorg-*executable, rerunbundle installand the setup command above, then checkgit config --local --get-regexp '^diff\.smorg-'.
- - To remove managed local entries, run
K_JEM_TEMPLATING=true kettle-jem install --undo; remove global command registrations withgit config --global --unset-all diff.smorg-ruby.command.
+ - To remove managed local entries, run
K_JEM_TEMPLATING=true kettle-jem install --undo; remove global command registrations withgit config --global --unset-all diff.smorg-rb.command,git config --global --unset-all merge.smorg-rb.driver, andgit config --global --unset-all merge.smorg-rb.name.
Ruby engine CI branches
+ +Pull requests run MRI workflows by default. JRuby and TruffleRuby workflows are
+available by branch naming convention so ordinary PRs do not spend CI time on
+alternate Ruby engines.
-
+
Pushes to the default branch continue to run the configured engine workflows.
+Executables vs Rake tasks
Executables shipped by dependencies, such as kettle-dev, and stone_checksums, are available
@@ -195,7 +211,7 @@
Environment Variables for L
For a quick starting point, this repository’s mise.toml defines the shared defaults, and .env.local can override them locally. Copy .env.local.example to .env.local, use KEY=value lines, and either activate mise in your shell or run commands through mise exec -C /path/to/project -- ....
Manual process
diff --git a/docs/file.FUNDING.html b/docs/file.FUNDING.html index 1bc9f91..d80c1ba 100644 --- a/docs/file.FUNDING.html +++ b/docs/file.FUNDING.html @@ -6,7 +6,7 @@Another Way to Support Open
diff --git a/docs/file.IRP.html b/docs/file.IRP.html
index a323fc1..a2fc672 100644
--- a/docs/file.IRP.html
+++ b/docs/file.IRP.html
@@ -6,7 +6,7 @@
File: IRP
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -98,9 +98,9 @@ Follow-up
diff --git a/docs/file.LICENSE.html b/docs/file.LICENSE.html
index be78b5b..cdbbd60 100644
--- a/docs/file.LICENSE.html
+++ b/docs/file.LICENSE.html
@@ -6,7 +6,7 @@
File: LICENSE
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -65,7 +65,7 @@
Choose the option that best fits your use case:
If none of the above licenses fit your use case, please contact us to discuss a custom commercial license.
@@ -78,9 +78,9 @@Copyright Notice
diff --git a/docs/file.README.html b/docs/file.README.html index c97f364..9255932 100644 --- a/docs/file.README.html +++ b/docs/file.README.html @@ -6,7 +6,7 @@💡 Info you can shake a stick at
+
+
⚙️ Configuration
NOMONO_GEMS_VENDOR_GEM_DIR (or legacy VENDOR_GEM_DIR) is the base path of the vendor directory used for gems listed in NOMONO_GEMS_VENDORED_GEMS. Defaults to $workspace_root/vendor. This is not an alternative form of the workspace root — it only affects vendored gems.NOMONO_GEMS_PATH_ALIASES (or global fallback NOMONO_PATH_ALIASES) is a comma-delimited list of source=canonical absolute path aliases. Each pair must resolve to the same real directory. Matching local gem paths are rewritten to the canonical spelling before Bundler receives them, preventing Gemfile.lock churn from equivalent paths such as /var/home/... and /home/....NOMONO_GEMS_DEBUG enables debug output from nomono.Examples
-For example, in the kettle-dev family of gems, which nomono is a part of, the parameters used are prefix: "KETTLE_RB", path_env: "KETTLE_RB_DEV".
+
For example, in the kettle-dev family of gems, which nomono is a part of, the parameters used are prefix: "KETTLE_DEV", path_env: "KETTLE_DEV_DEV".
This means that the following is true:
-
-
KETTLE_RB_DEV=false(or unset) — released gems from configured gem server (CI / single-gem development default)
+ -
-
KETTLE_RB_DEV=true— local sibling gems from$HOME/src/kettle-dev/<gem>(recommended for full-workspace development)
+ -
-
KETTLE_RB_DEV=/custom/path— local sibling gems from/custom/path/<gem>(non-standard workspace layout only)
+
KETTLE_DEV_DEV=false (or unset) — released gems from configured gem server (CI / single-gem development default)
KETTLE_DEV_DEV=true — local sibling gems from $HOME/src/kettle-dev/<gem> (recommended for full-workspace development)
KETTLE_DEV_DEV=/custom/path — local sibling gems from /custom/path/<gem> (non-standard workspace layout only)
You can override the env variable names via options. Here is an example for use with rubocop-lts gems:
@@ -422,10 +424,10 @@🔧 Basic Usage
source "https://gem.coop"
-if ENV.fetch("KETTLE_RB_DEV", "false").casecmp("false").zero?
+if ENV.fetch("KETTLE_DEV_DEV", "false").casecmp("false").zero?
gem "kettle-dev", "~> 2.2", ">= 2.2.15"
gem "kettle-test", "~> 2.0", ">= 2.0.6"
- gem "kettle-soup-cover", "~> 3.0.a", ">= 3.0.0.rc4"
+ gem "kettle-soup-cover", "~> 3.0", ">= 3.0.1"
else
eval_gemfile "gemfiles/modular/local.gemfile"
end
@@ -437,8 +439,11 @@ 🔧 Basic Usage
eval_nomono_gems(
gems: %w[kettle-dev kettle-test kettle-soup-cover],
- prefix: "KETTLE_RB",
- path_env: "KETTLE_RB_DEV",
+ prefix: "KETTLE_DEV",
+ path_env: "KETTLE_DEV_DEV",
+ path_aliases: {
+ "/var/home/pboling" => "/home/pboling"
+ },
vendored_gems_env: "VENDORED_GEMS",
vendor_gem_dir_env: "VENDOR_GEM_DIR",
debug_env: "KETTLE_DEV_DEBUG"
@@ -447,9 +452,22 @@ 🔧 Basic Usage
This is the pattern generated by kettle-jem: the Gemfile remains readable,
and nomono owns the path normalization for sibling repositories. When
-KETTLE_RB_DEV=false or is unset, the modular local override is skipped and
+KETTLE_DEV_DEV=false or is unset, the modular local override is skipped and
Bundler resolves released gems normally.
+nomono uses an explicit require "nomono/bundler" loader instead of the
+Bundler plugin DSL. Bundler plugins are installed extensions for Bundler
+commands, source handlers, and lifecycle hooks; nomono only needs to install
+Gemfile macros while Bundler is evaluating a Gemfile. The root Gemfile should
+declare the compatible nomono version, and modular local Gemfiles should fail
+normally if that loader is unavailable or incompatible.
+
+nomono also avoids RubyGems plugin autoload hooks for this path. Those hooks
+are appropriate for gems that must globally patch RubyGems or Bundler before
+dependency resolution can work. Local sibling overrides do not need cold-boot
+global patches: the root Gemfile installs nomono, and the ENV-gated modular
+Gemfile explicitly loads the macros only when it needs them.
+
🔐 Security
See SECURITY.md.
@@ -536,7 +554,7 @@ 📌 Versioning
📄 License
-The gem is available under the following license: AGPL-3.0-only.
+
The gem is available under the following license: AGPL-3.0-only.
See LICENSE.md for details.
If none of the available licenses suit your use case, please contact us to discuss a custom commercial license.
@@ -590,9 +608,9 @@ Please give the project a star ⭐ ♥
diff --git a/docs/file.RUBOCOP.html b/docs/file.RUBOCOP.html
index 6b0ac26..bd82bbc 100644
--- a/docs/file.RUBOCOP.html
+++ b/docs/file.RUBOCOP.html
@@ -6,7 +6,7 @@
File: RUBOCOP
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -89,12 +89,14 @@ Checking RuboCop Violations
Understanding the Lock File
-
The .rubocop_gradual.lock file tracks all current RuboCop violations in the project. This allows the team to:
+The .rubocop_gradual.lock file is a work list, not a permanent baseline. Every entry represents a style issue that should be resolved by either fixing the code or making an intentional exception explicit.
+
+This allows the team to:
- - Prevent new violations while gradually fixing existing ones
+ - Prevent new violations while existing issues are handled deliberately
- Track progress on code style improvements
- - Ensure CI builds don’t fail due to pre-existing violations
+ - Distinguish temporary work items from intentional project style exceptions
Common Commands
@@ -126,29 +128,30 @@ Workflow
- Before submitting a PR, run
bundle exec rake rubocop_gradual:autocorrect
a. or just the default bundle exec rake, as autocorrection is a pre-requisite of the default task.
- - If there are new violations, either:
+
- If there are violations, either:
- Fix them in your code
- - Run
bundle exec rake rubocop_gradual:force_update to update the lock file (only for violations you can’t fix immediately)
+ - Normalize intentional deviations with an explicit config or inline exception
+ - Run
bundle exec rake rubocop_gradual:force_update only for temporary work items you cannot fix immediately
- Commit the updated
.rubocop_gradual.lock file along with your changes
-Never add inline RuboCop disables
+Explicit Style Exceptions
-Do not add inline rubocop:disable / rubocop:enable comments anywhere in the codebase (including specs, except when following the few existing rubocop:disable patterns for a rule already being disabled elsewhere in the code). We handle exceptions in two supported ways:
+Do not treat .rubocop_gradual.lock as a baseline. Treat it as a list of work that must be fixed or normalized into the styleguide.
-
- - Permanent/structural exceptions: prefer adjusting the RuboCop configuration (e.g., in
.rubocop.yml) to exclude a rule for a path or file pattern when it makes sense project-wide.
- - Temporary exceptions while improving code: record the current violations in
.rubocop_gradual.lock via the gradual workflow:
-
- -
-
bundle exec rake rubocop_gradual:autocorrect (preferred; will autocorrect what it can and update the lock only if no new violations were introduced)
- - If needed,
bundle exec rake rubocop_gradual:force_update (as a last resort when you cannot fix the newly reported violations immediately)
-
-
-
+Prefer this order:
+
+
+ - Fix the code so it follows the configured styleguide.
+ - For intentional project conventions, add the narrowest useful override in
.rubocop.yml or .rubocop_rspec.yml.
+ - For local intentional deviations, add a tightly scoped inline
rubocop:disable / rubocop:enable around the exact line or block.
+ - Keep an entry in
.rubocop_gradual.lock only as temporary work to be resolved later.
+
+
+Use configuration overrides when a deviation is structural, generated, path-specific, or applies consistently to a small set of files. Use inline disables when the exception is local and the reason is clearer at the code site than in global config.
In general, treat the rules as guidance to follow; fix violations rather than ignore them. For example, RSpec conventions in this project expect described_class to be used in specs that target a specific class under test.
@@ -156,16 +159,16 @@ Benefits of rubocop_gradual
- Allows incremental adoption of code style rules
- - Prevents CI failures due to pre-existing violations
- - Provides a clear record of code style debt
+ - Prevents CI failures due to temporary pre-existing violations
+ - Provides a clear work list of code style debt
- Enables focused efforts on improving code quality over time
diff --git a/docs/file.SECURITY.html b/docs/file.SECURITY.html
index 829aaff..33b8e6c 100644
--- a/docs/file.SECURITY.html
+++ b/docs/file.SECURITY.html
@@ -6,7 +6,7 @@
File: SECURITY
- — Documentation by YARD 0.9.44
+ — Documentation by YARD 0.9.45
@@ -72,7 +72,7 @@ Supported Versions
- 1.0.latest
+ 1.1.latest
✅
@@ -93,9 +93,9 @@ Additional Support
diff --git a/docs/frames.html b/docs/frames.html
index 3223ddd..4a6186c 100644
--- a/docs/frames.html
+++ b/docs/frames.html
@@ -2,7 +2,7 @@
- Documentation by YARD 0.9.44
+ Documentation by YARD 0.9.45