kettle-jem 7.1.17 → 7.1.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c3ad54df2b54121762eefe7bbab5a247a907c54d3203951874ccce1bf02b7bb
-  data.tar.gz: c664d32ba553aca8a01a3afbcd253677cc6ae4f0fee217c5337a2e07648b82c9
+  metadata.gz: be68d8013118874cc390f1ed0ee3ac2bb5047dad4967781c72ab88e291523bc6
+  data.tar.gz: f747bfbdfc041849dc03930274640454e213e699047e1c122e1c27bc44169375
 SHA512:
-  metadata.gz: 52ef26400eb399ba2d9b49bca4d3cc7b24f391f66e675abb523fb44737321f6bf75b86c8739a26c43e1dcde786b7eef58f404038ae783f1ab19ba08a2af9a846
-  data.tar.gz: 4f8c864f65140ec7f8aef3c13ed485b7bc627aed15b3e0fc5798a08572f1e75e2e02d07bf62e8bef2a3377dc15e828aaaf43d54bfe71926df0d92c5cd2b519d2
+  metadata.gz: a91adad416b7b8ece732239a70b4d863a02b81c9fc7799ef9abe68e8acf30bb0303863ba5661eaca3db9865082d711a6c15e86c82f5a448f93261d77ba0fb8cc
+  data.tar.gz: cebb54159f8fce55202b1863e0d03bee63f2668448e4b526d8dd4d1645b676bd59e4c96daa995a78d679912f61a73963cb1f91b2c5bd4178ff31e1e2b144af88

data/CHANGELOG.md

@@ -30,6 +30,44 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [7.1.19] - 2026-09-07
+
+- TAG: [v7.1.19][7.1.19t]
+- COVERAGE: 93.62% -- 11176/11937 lines in 16 files
+- BRANCH COVERAGE: 77.01% -- 4759/6180 branches in 16 files
+- 18.01% documented
+
+### Changed
+
+- [kc] kettle-jem-deps-floor: Update kettle-jem template dependency floors:
+  - kettle-family (>= 1.2.93 -> >= 1.2.94)
+  - kettle-jem (>= 7.1.17 -> >= 7.1.18)
+
+## [7.1.18] - 2026-09-07
+
+- TAG: [v7.1.18][7.1.18t]
+- COVERAGE: 93.62% -- 11176/11937 lines in 16 files
+- BRANCH COVERAGE: 77.01% -- 4759/6180 branches in 16 files
+- 18.01% documented
+
+### Changed
+
+- [kc] kettle-jem-deps-floor: Update kettle-jem template dependency floors:
+  - kettle-family (>= 1.2.84 -> >= 1.2.93)
+
+- [kc] kettle-jem/prepare: updated 15 project files:
+  - dependencies (15)
+
+- [kc] kettle-jem/template: updated 4 project files:
+  - code and tests (2)
+  - other (2)
+
+### Fixed
+
+- Allocate template worker pools from the active kettle-family wave width when provided.
+
+- Apply the family template worker budget to post-template Appraisal generation.
+
 ## [7.1.17] - 2026-09-06
 
 - TAG: [v7.1.17][7.1.17t]
@@ -1851,7 +1889,11 @@ Please file a bug if you notice a violation of semantic versioning.
 - Released kettle-jem as part of the initial StructuredMerge Ruby 7.0.0 gem set.
 - Included packaged templates and parser-backed merge support for Ruby gem templating.
 
-[Unreleased]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.17...HEAD
+[Unreleased]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.19...HEAD
+[7.1.19]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.18...v7.1.19
+[7.1.19t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.19
+[7.1.18]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.17...v7.1.18
+[7.1.18t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.18
 [7.1.17]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.16...v7.1.17
 [7.1.17t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.17
 [7.1.16]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.15...v7.1.16

data/README.md

@@ -879,7 +879,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-11.920-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-11.937-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/structuredmerge/structuredmerge-ruby/blob/main/SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/lib/kettle/jem/tasks/install_task.rb

@@ -1290,6 +1290,7 @@ module Kettle
           command_env["K_JEM_TEMPLATING"] = "true" if templating_requested
           command_env["BUNDLE_DISABLE_CHECKSUM_VALIDATION"] = disable_checksum_validation unless disable_checksum_validation.nil?
           apply_kettle_family_local_install_env!(command_env)
+          apply_kettle_family_appraisal_workers!(command_env)
           command_env["K_JEM_TEMPLATING"] = if templating_requested && local_path_development_env?(command_env)
             "true"
           else
@@ -1339,6 +1340,17 @@ module Kettle
           command_env["KETTLE_DEV_DEV"] = kettle_root if kettle_root && !command_env.key?("KETTLE_DEV_DEV")
         end
 
+        # Appraisal generation is an install finishing step, so it runs after
+        # template recipe/file pools have completed. In a family template
+        # wave, keep its worker count within the same member budget unless the
+        # caller deliberately selected APPRAISAL_JOBS.
+        def apply_kettle_family_appraisal_workers!(command_env)
+          return if command_env.key?("APPRAISAL_JOBS")
+          return unless Kettle::Jem::Tasks::TemplateTask.family_wave_jobs(command_env)
+
+          command_env["APPRAISAL_JOBS"] = Kettle::Jem::Tasks::TemplateTask.default_thread_worker_count(command_env).to_s
+        end
+
         def kettle_family_local_install_marker(command_env)
           path = command_env["KETTLE_FAMILY_LOCAL_INSTALL_MARKER"].to_s
           path = File.join(Dir.home, ".kettle-family", "local-install.json") if path.empty?

data/lib/kettle/jem/tasks/template_task.rb

@@ -42,7 +42,7 @@ module Kettle
           options = env_run_options(env || {}).merge(run_options || {})
           return options if worker_or_strategy_option_provided?(env || {}, options)
 
-          workers = default_thread_worker_count
+          workers = default_thread_worker_count(env)
           options.merge(
             recipe_planning_strategy: "classified",
             recipe_planning_thread_workers: workers,
@@ -78,8 +78,31 @@ module Kettle
           }.compact
         end
 
-        def default_thread_worker_count
-          [1, Etc.nprocessors / 2].max
+        # A standalone template run may use half of the available CPUs. When
+        # kettle-family supplies its rolling wave width, each member keeps its
+        # base process and receives an equal share of the remaining CPUs for
+        # command-internal work. Explicit KETTLE_JEM_* worker settings remain
+        # authoritative and bypass this default.
+        def default_thread_worker_count(env = ENV)
+          cpu_count = Etc.nprocessors
+          standalone_limit = [cpu_count / 2, 1].max
+          wave_jobs = family_wave_jobs(env)
+          return standalone_limit unless wave_jobs
+
+          available_per_member = (cpu_count - wave_jobs) / wave_jobs
+          [standalone_limit, [available_per_member, 1].max].min
+        end
+
+        def family_wave_jobs(env)
+          value = env["KETTLE_FAMILY_WAVE_JOBS"]
+          return nil if value.nil? || value.strip.empty?
+
+          wave_jobs = Integer(value)
+          raise ArgumentError, "KETTLE_FAMILY_WAVE_JOBS must be positive" unless wave_jobs.positive?
+
+          wave_jobs
+        rescue ArgumentError
+          raise ArgumentError, "KETTLE_FAMILY_WAVE_JOBS must be a positive integer"
         end
 
         def worker_or_strategy_option_provided?(env, run_options)

data/lib/kettle/jem/templates/gem.gemspec.example

@@ -118,7 +118,7 @@ Gem::Specification.new do |spec|
   #       and preferably a modular one (see gemfiles/modular/*.gemfile).
 
   # Dev, Test, & Release Tasks
-  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.30")             # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.31")             # ruby >= {KJ|MIN_TEST_RUBY}
 
   # Security
   spec.add_development_dependency("bundler-audit", "~> 0.9.3")                      # ruby >= 2.0.0

data/lib/kettle/jem/templates/gemfiles/modular/templating.gemfile.example

@@ -9,7 +9,7 @@ if structuredmerge_remote || !tslp_dev.to_s.empty?
   # Keep one Bundler declaration so the local debugging override cannot be
   # mistaken for a second dependency declaration.
   tslp_requirements = if tslp_dev.to_s.empty?
-                        ["~> 1.15", ">= 1.15.7"]
+                        ["~> 1.16", ">= 1.16.2"]
                       else
                         [{ path: tslp_dev }]
                       end

data/lib/kettle/jem/templates/shim/gem.gemspec.example

@@ -30,7 +30,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "{KJ|SHIMMED_GEM_NAME}"
 
   # Dev, Test, & Release Tasks
-  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.30")             # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.31")             # ruby >= {KJ|MIN_TEST_RUBY}
 
   # Tasks
   spec.add_development_dependency "rake", "~> 13.0"

data/lib/kettle/jem/version.rb

@@ -5,7 +5,7 @@ module Kettle
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "7.1.17"
+      VERSION = "7.1.19"
     end
     # Current gem version exposed at the traditional constant location.
     VERSION = Version::VERSION # Traditional Constant Location

data/lib/kettle/jem.rb

@@ -5442,10 +5442,10 @@ module Kettle
       [
         {name: "appraisal2", source: %(gem "appraisal2", "~> 3.2", ">= 3.2.3"\n)},
         {name: "bundler-audit", source: %(gem "bundler-audit", "~> 0.9.3"\n)},
-        {name: "kettle-dev", source: %(gem "kettle-dev", "~> 3.0", ">= 3.0.30"\n)},
+        {name: "kettle-dev", source: %(gem "kettle-dev", "~> 3.0", ">= 3.0.31"\n)},
         {name: "kettle-drift", source: %(gem "kettle-drift", "~> 1.0", ">= 1.0.13"\n)},
-        {name: "kettle-family", source: %(gem "kettle-family", "~> 1.2", ">= 1.2.84"\n)},
-        {name: "kettle-jem", source: %(gem "kettle-jem", "~> 7.1", ">= 7.1.16"\n)},
+        {name: "kettle-family", source: %(gem "kettle-family", "~> 1.2", ">= 1.2.94"\n)},
+        {name: "kettle-jem", source: %(gem "kettle-jem", "~> 7.1", ">= 7.1.18"\n)},
         {name: "kettle-test", source: %(gem "kettle-test", "~> 2.0", ">= 2.0.21"\n)},
         {name: "rake", source: %(gem "rake", "~> 13.0"\n)},
         {name: "rspec", source: %(gem "rspec", "~> 3.0"\n)},
@@ -15390,7 +15390,7 @@ module Kettle
     def main_gemfile_kettle_family_gem(package_name)
       return "" if package_name.to_s == "kettle-family"
 
-      %(gem "kettle-family", "~> 1.2", ">= 1.2.84"\n)
+      %(gem "kettle-family", "~> 1.2", ">= 1.2.94"\n)
     end
 
     def main_gemfile_nomono_bootstrap(package_name)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-jem
 version: !ruby/object:Gem::Version
-  version: 7.1.17
+  version: 7.1.19
 platform: ruby
 authors:
 - Peter H. Boling
@@ -66,7 +66,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -76,7 +76,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: ast-crispr-ruby-prism
   requirement: !ruby/object:Gem::Requirement
@@ -86,7 +86,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -96,7 +96,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: ast-merge
   requirement: !ruby/object:Gem::Requirement
@@ -106,7 +106,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -116,7 +116,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: bash-merge
   requirement: !ruby/object:Gem::Requirement
@@ -126,7 +126,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -136,7 +136,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: citrus-toml-merge
   requirement: !ruby/object:Gem::Requirement
@@ -146,7 +146,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -156,7 +156,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: commonmarker-merge
   requirement: !ruby/object:Gem::Requirement
@@ -166,7 +166,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -176,7 +176,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: dotenv-merge
   requirement: !ruby/object:Gem::Requirement
@@ -186,7 +186,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -196,7 +196,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: json-merge
   requirement: !ruby/object:Gem::Requirement
@@ -206,7 +206,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -216,7 +216,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: kettle-changelog
   requirement: !ruby/object:Gem::Requirement
@@ -326,7 +326,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -336,7 +336,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: markdown-merge
   requirement: !ruby/object:Gem::Requirement
@@ -346,7 +346,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -356,7 +356,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: markly-merge
   requirement: !ruby/object:Gem::Requirement
@@ -366,7 +366,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -376,7 +376,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: parslet
   requirement: !ruby/object:Gem::Requirement
@@ -400,7 +400,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -410,7 +410,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: psych-merge
   requirement: !ruby/object:Gem::Requirement
@@ -420,7 +420,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -430,7 +430,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: rbs
   requirement: !ruby/object:Gem::Requirement
@@ -454,7 +454,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -464,7 +464,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: ruby-merge
   requirement: !ruby/object:Gem::Requirement
@@ -474,7 +474,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -484,7 +484,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: token-resolver
   requirement: !ruby/object:Gem::Requirement
@@ -514,7 +514,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -524,7 +524,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: toml-rb
   requirement: !ruby/object:Gem::Requirement
@@ -548,7 +548,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -558,7 +558,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: yaml-merge
   requirement: !ruby/object:Gem::Requirement
@@ -568,7 +568,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -578,7 +578,7 @@ dependencies:
         version: '7.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 7.1.7
+        version: 7.1.8
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -976,10 +976,10 @@ licenses:
 - PolyForm-Small-Business-1.0.0
 metadata:
   homepage_uri: https://structuredmerge.org
-  source_code_uri: https://github.com/structuredmerge/structuredmerge-ruby/tree/v7.1.17
-  changelog_uri: https://github.com/structuredmerge/structuredmerge-ruby/blob/v7.1.17/CHANGELOG.md
+  source_code_uri: https://github.com/structuredmerge/structuredmerge-ruby/tree/v7.1.19
+  changelog_uri: https://github.com/structuredmerge/structuredmerge-ruby/blob/v7.1.19/CHANGELOG.md
   bug_tracker_uri: https://github.com/structuredmerge/structuredmerge-ruby/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-jem/7.1.17
+  documentation_uri: https://www.rubydoc.info/gems/kettle-jem/7.1.19
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/structuredmerge/structuredmerge-ruby/wiki
   news_uri: https://www.railsbling.com/tags/kettle-jem