kettle-jem 7.0.0 → 7.1.3

data/lib/kettle/jem/templates/gemfiles/modular/recording/r2.3/recording.gemfile.example

@@ -0,0 +1,16 @@
+# HTTP recording for deterministic specs
+# It seems that somehow just having a newer version of appraisal installed breaks
+#   Ruby 2.3 and 2.4 even if their bundle specifies an older version,
+#   and as a result it can only be a dependency in the appraisals.
+#   Putting it here in recording.gemfile will satisfy the rubies that can load latest vcr.
+# | An error occurred while loading spec_helper.
+# | Failure/Error: require "vcr"
+# |
+# | NoMethodError:
+# |   undefined method `delete_prefix' for "CONTENT_LENGTH":String
+# | # ./spec/config/vcr.rb:3:in `require'
+# | # ./spec/config/vcr.rb:3:in `<top (required)>'
+# | # ./spec/spec_helper.rb:8:in `require_relative'
+# | # ./spec/spec_helper.rb:8:in `<top (required)>'
+gem "vcr", "< 6"          # 6.0.0 appears to have been released accidentally without changing required_ruby_version in the gemspec.
+gem "webmock", "~> 3.0"   # Last version to support ruby >= 2.3

data/lib/kettle/jem/templates/gemfiles/modular/recording/r2.4/recording.gemfile.example

@@ -0,0 +1,18 @@
+# HTTP recording for deterministic specs
+# It seems that somehow just having a newer version of appraisal installed breaks
+#   Ruby 2.3 and 2.4 even if their bundle specifies an older version,
+#   and as a result it can only be a dependency in the appraisals.
+#   Putting it here in recording.gemfile will satisfy the rubies that can load latest vcr.
+# | An error occurred while loading spec_helper.
+# | Failure/Error: require "vcr"
+# |
+# | NoMethodError:
+# |   undefined method `delete_prefix' for "CONTENT_LENGTH":String
+# | # ./spec/config/vcr.rb:3:in `require'
+# | # ./spec/config/vcr.rb:3:in `<top (required)>'
+# | # ./spec/spec_helper.rb:8:in `require_relative'
+# | # ./spec/spec_helper.rb:8:in `<top (required)>'
+gem "vcr", "< 4"
+gem "webmock", ">= 3"
+
+# For now turning off Ruby 2.4 testing.

data/lib/kettle/jem/templates/gemfiles/modular/recording/r2.5/recording.gemfile.example

@@ -0,0 +1,16 @@
+# HTTP recording for deterministic specs
+# It seems that somehow just having a newer version of appraisal installed breaks
+#   Ruby 2.3 and 2.4 even if their bundle specifies an older version,
+#   and as a result it can only be a dependency in the appraisals.
+#   Putting it here in recording.gemfile will satisfy the rubies that can load latest vcr.
+# | An error occurred while loading spec_helper.
+# | Failure/Error: require "vcr"
+# |
+# | NoMethodError:
+# |   undefined method `delete_prefix' for "CONTENT_LENGTH":String
+# | # ./spec/config/vcr.rb:3:in `require'
+# | # ./spec/config/vcr.rb:3:in `<top (required)>'
+# | # ./spec/spec_helper.rb:8:in `require_relative'
+# | # ./spec/spec_helper.rb:8:in `<top (required)>'
+gem "vcr", ">= 6"
+gem "webmock", ">= 3"

data/lib/kettle/jem/templates/gemfiles/modular/recording/r3/recording.gemfile.example

@@ -0,0 +1,16 @@
+# HTTP recording for deterministic specs
+# It seems that somehow just having a newer version of appraisal installed breaks
+#   Ruby 2.3 and 2.4 even if their bundle specifies an older version,
+#   and as a result it can only be a dependency in the appraisals.
+#   Putting it here in recording.gemfile will satisfy the rubies that can load latest vcr.
+# | An error occurred while loading spec_helper.
+# | Failure/Error: require "vcr"
+# |
+# | NoMethodError:
+# |   undefined method `delete_prefix' for "CONTENT_LENGTH":String
+# | # ./spec/config/vcr.rb:3:in `require'
+# | # ./spec/config/vcr.rb:3:in `<top (required)>'
+# | # ./spec/spec_helper.rb:8:in `require_relative'
+# | # ./spec/spec_helper.rb:8:in `<top (required)>'
+gem "vcr", ">= 6"
+gem "webmock", ">= 3"

data/lib/kettle/jem/templates/gemfiles/modular/recording/r4/recording.gemfile.example

@@ -0,0 +1,16 @@
+# HTTP recording for deterministic specs
+# It seems that somehow just having a newer version of appraisal installed breaks
+#   Ruby 2.3 and 2.4 even if their bundle specifies an older version,
+#   and as a result it can only be a dependency in the appraisals.
+#   Putting it here in recording.gemfile will satisfy the rubies that can load latest vcr.
+# | An error occurred while loading spec_helper.
+# | Failure/Error: require "vcr"
+# |
+# | NoMethodError:
+# |   undefined method `delete_prefix' for "CONTENT_LENGTH":String
+# | # ./spec/config/vcr.rb:3:in `require'
+# | # ./spec/config/vcr.rb:3:in `<top (required)>'
+# | # ./spec/spec_helper.rb:8:in `require_relative'
+# | # ./spec/spec_helper.rb:8:in `<top (required)>'
+gem "vcr", ">= 6"
+gem "webmock", ">= 3"

data/lib/kettle/jem/templates/gemfiles/modular/recording/vHEAD.gemfile.example

@@ -0,0 +1,2 @@
+gem "vcr", github: "vcr/vcr", branch: "master"
+gem "webmock", github: "bblimke/webmock", branch: "master"

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

@@ -0,0 +1,4 @@
+gem "rspec_junit_formatter",
+  github: "pboling/rspec_junit_formatter",
+  branch: "main",
+  ref: "9e6bcaaedd49477b62878ed568dc4ada5cc7cb5e"

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# To retain during kettle-jem templating:
+#     {KJ|FREEZE_TOKEN}:freeze
+#     # ... your code
+#     {KJ|FREEZE_TOKEN}:unfreeze
+#
+
+# Test against HEAD of runtime dependencies so we can proactively file bugs
+
+# Ruby >= 2.2
+gem "version_gem", github: "ruby-oauth/version_gem", branch: "main"
+
+eval_gemfile("x_std_libs/vHEAD.gemfile")

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+# To retain during kettle-jem templating:
+#     kettle-jem:freeze
+#     # ... your code
+#     kettle-jem:unfreeze
+#
+
+# Shunted development dependencies.
+#
+# These gems have been moved here from the gemspec because they require a
+# newer Ruby than the project's effective test/development floor:
+#
+#   effective_test_floor = max(gemspec required_ruby_version, ruby.test_minimum)
+#
+# They are loaded via the Appraisals "unlocked" group so that CI can still
+# test them on the Rubies they support, while older-Ruby CI jobs simply
+# skip this gemfile.
+#
+# This file is regenerated by `rake template` — add custom gems inside a
+# kettle-jem:freeze / kettle-jem:unfreeze block to preserve them.

data/lib/kettle/jem/templates/gemfiles/modular/stringio/r2/v3.0.gemfile.example

@@ -0,0 +1,5 @@
+# !!WARNING!!
+#   NOT SEMVER
+# Version 3.0.7 dropped support for Ruby <= 2.7
+# Version 3.0.0 dropped support for Ruby <= 2.4
+gem "stringio", ">= 3.0"

data/lib/kettle/jem/templates/gemfiles/modular/stringio/r2.4/v0.0.2.gemfile.example

@@ -0,0 +1,4 @@
+# !!WARNING!!
+#   NOT SEMVER
+# Last version to support Ruby <= 2.5
+gem "stringio", ">= 0.0.2"

data/lib/kettle/jem/templates/gemfiles/modular/stringio/r3/v3.0.gemfile.example

@@ -0,0 +1,5 @@
+# !!WARNING!!
+#   NOT SEMVER
+# Version 3.0.7 dropped support for Ruby <= 2.7
+# Version 3.0.0 dropped support for Ruby <= 2.4
+gem "stringio", ">= 3.0"

data/lib/kettle/jem/templates/gemfiles/modular/stringio/r4/v3.0.gemfile.example

@@ -0,0 +1,5 @@
+# !!WARNING!!
+#   NOT SEMVER
+# Version 3.0.7 dropped support for Ruby <= 2.7
+# Version 3.0.0 dropped support for Ruby <= 2.4
+gem "stringio", ">= 3.0"

data/lib/kettle/jem/templates/gemfiles/modular/stringio/vHEAD.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.5 (dependency of omniauth)
+gem "stringio", github: "ruby/stringio", branch: "master"

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# To retain during kettle-jem templating:
+#     {KJ|FREEZE_TOKEN}:freeze
+#     # ... your code
+#     {KJ|FREEZE_TOKEN}:unfreeze
+#
+
+# Style tasks run on the latest Ruby; RuboCop-LTS selects the compatibility
+# rules for the configured Ruby floor independently from task dependency floors.
+
+gem "reek", "~> 6.5", ">= 6.5.0"
+
+platform :mri do
+  gem "appraisal2-rubocop", "~> 1.0", ">= 1.0.1", require: false
+  gem "rubocop-gradual", "~> 0.4", ">= 0.4.0"
+  gem "rubocop-minitest", "~> 0.40", ">= 0.40.0"
+  gem "rubocop-on-rbs", "~> 2.0", ">= 2.0.0"        # ruby >= 3.2.0
+  # gem "rubocop", "~> 1.73", ">= 1.73.2" # constrained by standard
+  gem "rubocop-packaging",
+    github: "pboling/rubocop-packaging",
+    ref: "3539ba858d379740d638566faee9e56b2b854145"
+  gem "standard", "~> 1.56", ">= 1.56.0"
+
+  if ENV.fetch("RUBOCOP_LTS_LOCAL", "false").casecmp("false").zero?
+    declared_gems = instance_variable_get(:@dependencies).to_a.map(&:name)
+    gem "rubocop-lts", {KJ|RUBOCOP_LTS_CONSTRAINT} unless declared_gems.include?("rubocop-lts")
+    gem "rubocop-lts-rspec", "~> 1.0", ">= 1.0.5" unless declared_gems.include?("rubocop-lts-rspec")
+    gem "{KJ|RUBOCOP_RUBY_GEM}", {KJ|RUBOCOP_RUBY_CONSTRAINT} unless declared_gems.include?("{KJ|RUBOCOP_RUBY_GEM}")
+  else
+    eval_gemfile("style_local.gemfile")
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+# Style tasks run on the latest Ruby; RuboCop-LTS selects the compatibility
+# rules for the configured Ruby floor independently from task dependency floors.
+
+# Local path overrides for development.
+# Loaded by the associated non-local gemfile when RUBOCOP_LTS_LOCAL != "false".
+
+{KJ|LOCAL_GEMFILE_NOMONO_BOOTSTRAP}
+
+local_gems = %w[rubocop-lts rubocop-lts-rspec {KJ|RUBOCOP_RUBY_GEM} standard-rubocop-lts]
+declared_gems = instance_variable_get(:@dependencies).to_a.map(&:name)
+local_gems_to_eval = local_gems - %w[{KJ|PACKAGE_NAME}] - declared_gems
+
+# export VENDORED_GEMS=rubocop-lts,rubocop-lts-rspec,{KJ|RUBOCOP_RUBY_GEM},standard-rubocop-lts
+platform :mri do
+  eval_nomono_gems(
+    gems: local_gems_to_eval,
+    prefix: "RUBOCOP_LTS",
+    path_env: "RUBOCOP_LTS_LOCAL",
+    vendored_gems_env: "VENDORED_GEMS",
+    vendor_gem_dir_env: "VENDOR_GEM_DIR",
+    debug_env: "RUBOCOP_LTS_DEBUG",
+    root: ["src", "rubocop-lts"]
+  )
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+structuredmerge_remote = ENV.fetch("STRUCTUREDMERGE_DEV", "false").casecmp("false").zero?
+kettle_remote = ENV.fetch("KETTLE_DEV_DEV", "false").casecmp("false").zero?
+
+tslp_dev = ENV.fetch("TSLP_DEV", nil).to_s
+tslp_dev = nil if tslp_dev.empty? || %w[false 0 no off].include?(tslp_dev.downcase)
+if tslp_dev.to_s.empty?
+  if structuredmerge_remote
+    # Parser dependencies for released installs.
+    gem "tree_sitter_language_pack", "~> 1.14", ">= 1.14.3"
+  end
+else
+  # Explicit local override for unreleased TSLP debugging.
+  gem "tree_sitter_language_pack", path: tslp_dev
+end
+
+if structuredmerge_remote
+  # Merge recipes for released installs.
+  gem "kettle-jem", ">= 7.0"
+end
+
+if kettle_remote
+  # Template/plugin checks for released installs.
+  gem "kettle-drift", "~> 1.0", ">= 1.0.12", require: false
+end
+
+# Set STRUCTUREDMERGE_DEV=/path/to/structuredmerge/ruby/gems for local development with path-based dependencies.
+# When false (default / CI), released kettle-jem brings merge gems and parser dependencies.
+# Local path overrides bring the same dependencies from sibling gemspecs.
+#
+# Set KETTLE_DEV_DEV=/path/to/my for local development with Kettle plugin gems.
+# When false (default / CI), released Kettle plugin gems are used.
+eval_gemfile "templating_local.gemfile" unless structuredmerge_remote && kettle_remote

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+# Local path overrides for templating development.
+# Loaded by the associated non-local gemfile when STRUCTUREDMERGE_DEV or KETTLE_DEV_DEV
+# is not "false".
+
+{KJ|LOCAL_GEMFILE_NOMONO_BOOTSTRAP}
+
+structuredmerge_local_gems = %w[
+  tree_haver
+  ast-merge
+  ast-merge-git
+  ast-template
+  bash-merge
+  binary-merge
+  commonmarker-merge
+  citrus-toml-merge
+  dotenv-merge
+  go-merge
+  html-merge
+  json-merge
+  kettle-jem
+  kramdown-merge
+  markdown-merge
+  markly-merge
+  parslet-toml-merge
+  plain-merge
+  prism-merge
+  psych-merge
+  rbs-merge
+  ruby-merge
+  rust-merge
+  smorg-rb
+  typescript-merge
+  toml-merge
+  yaml-merge
+  zip-merge
+  ast-crispr
+  ast-crispr-markdown-markly
+  ast-crispr-ruby-prism
+]
+
+kettle_dev_local_gems = %w[
+  {KJ|KETTLE_DEV_LOCAL_GEMS}
+]
+declared_gems = instance_variable_get(:@dependencies).to_a.map(&:name)
+structuredmerge_local_gems_to_eval = structuredmerge_local_gems - %w[{KJ|PACKAGE_NAME}]
+kettle_dev_local_gems_to_eval = kettle_dev_local_gems - %w[{KJ|PACKAGE_NAME}] - (declared_gems - %w[kettle-dev])
+
+platform :mri do
+  if ENV.fetch("STRUCTUREDMERGE_DEV", "false").casecmp("false") != 0
+    eval_nomono_gems(
+      gems: structuredmerge_local_gems_to_eval,
+      prefix: "STRUCTUREDMERGE",
+      path_env: "STRUCTUREDMERGE_DEV",
+      vendored_gems_env: "VENDORED_GEMS",
+      vendor_gem_dir_env: "VENDOR_GEM_DIR",
+      debug_env: "STRUCTUREDMERGE_DEBUG"
+    )
+  end
+
+  if ENV.fetch("KETTLE_DEV_DEV", "false").casecmp("false") != 0
+    eval_nomono_gems(
+      gems: kettle_dev_local_gems_to_eval,
+      prefix: "KETTLE_DEV",
+      path_env: "KETTLE_DEV_DEV",
+      vendored_gems_env: "VENDORED_GEMS",
+      vendor_gem_dir_env: "VENDOR_GEM_DIR",
+      debug_env: "KETTLE_DEV_DEBUG",
+      root: ["src", "my", "kettle-dev"]
+    )
+  end
+end

data/lib/kettle/jem/templates/gemfiles/modular/webrick/r4/v1.9.gemfile.example

@@ -0,0 +1 @@
+gem "webrick", "~> 1.9"

data/lib/kettle/jem/templates/gemfiles/modular/webrick/vHEAD.gemfile.example

@@ -0,0 +1 @@
+gem "webrick", ">= 1.9"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/r2/libs.gemfile.example

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2/v3.0.gemfile"
+eval_gemfile "../../mutex_m/r2/v0.3.gemfile"
+eval_gemfile "../../stringio/r2/v3.0.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/r2.3/libs.gemfile.example

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2.3/default.gemfile"
+eval_gemfile "../../mutex_m/r2.4/v0.1.gemfile"
+eval_gemfile "../../stringio/r2.4/v0.0.2.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/r2.4/libs.gemfile.example

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2.6/v2.2.gemfile"
+eval_gemfile "../../mutex_m/r2.4/v0.1.gemfile"
+eval_gemfile "../../stringio/r2.4/v0.0.2.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/r2.6/libs.gemfile.example

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2.6/v2.2.gemfile"
+eval_gemfile "../../mutex_m/r2/v0.3.gemfile"
+eval_gemfile "../../stringio/r2/v3.0.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/r3/libs.gemfile.example

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r3/v5.0.gemfile"
+eval_gemfile "../../mutex_m/r3/v0.3.gemfile"
+eval_gemfile "../../stringio/r3/v3.0.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/r3.1/libs.gemfile.example

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+eval_gemfile "../../erb/r3.1/v4.0.gemfile"
+eval_gemfile "../../mutex_m/r3/v0.3.gemfile"
+eval_gemfile "../../stringio/r3/v3.0.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/r4/libs.gemfile.example

@@ -0,0 +1,6 @@
+eval_gemfile "../../erb/r4/v5.0.gemfile"
+eval_gemfile "../../mutex_m/r4/v0.3.gemfile"
+eval_gemfile "../../stringio/r4/v3.0.gemfile"
+eval_gemfile "../../benchmark/r4/v0.5.gemfile"
+eval_gemfile "../../cgi/r4/v0.5.gemfile"
+eval_gemfile "../../webrick/r4/v1.9.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/x_std_libs/vHEAD.gemfile.example

@@ -0,0 +1,6 @@
+eval_gemfile "../erb/vHEAD.gemfile"
+eval_gemfile "../mutex_m/vHEAD.gemfile"
+eval_gemfile "../stringio/vHEAD.gemfile"
+eval_gemfile "../benchmark/vHEAD.gemfile"
+eval_gemfile "../cgi/vHEAD.gemfile"
+eval_gemfile "../webrick/vHEAD.gemfile"

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

@@ -0,0 +1,12 @@
+### Std Lib Extracted Gems
+ruby_version = Gem::Version.new(RUBY_VERSION)
+
+if ruby_version >= Gem::Version.new("4.0")
+  eval_gemfile "x_std_libs/r4/libs.gemfile"
+elsif ruby_version >= Gem::Version.new("3.2")
+  eval_gemfile "x_std_libs/r3/libs.gemfile"
+elsif ruby_version >= Gem::Version.new("3.1")
+  eval_gemfile "x_std_libs/r3.1/libs.gemfile"
+else
+  eval_gemfile "x_std_libs/r2/libs.gemfile"
+end

data/lib/kettle/jem/templates/lib/gem/version.rb.example

@@ -0,0 +1 @@
+{KJ|VERSION_GEM:VERSION_RB}

data/lib/kettle/jem/templates/lib/gem/version_gem.rb.example

@@ -0,0 +1 @@
+{KJ|VERSION_GEM:VERSION_GEM_RB}

data/lib/kettle/jem/templates/mise.toml.example

@@ -0,0 +1,25 @@
+# Shared development environment for this gem.
+# Local overrides belong in .env.local (loaded via dotenvy through mise).
+
+[env]
+FLOSS_CFG_FUND_DEBUG = "false"
+FLOSS_CFG_FUND_LOGFILE = "tmp/log/debug.log"
+FUNDING_ORG = "{KJ|OPENCOLLECTIVE_ORG}"
+KETTLE_DEV_DEBUG = "false"
+KETTLE_TEST_SILENT = "true"
+K_SOUP_COV_COMMAND_NAME = "Test Coverage"
+K_SOUP_COV_DO = "true"
+K_SOUP_COV_FORMATTERS = "html,xml,rcov,lcov,json,tty"
+K_SOUP_COV_MIN_BRANCH = "76"
+K_SOUP_COV_MIN_HARD = "true"
+K_SOUP_COV_MIN_LINE = "92"
+K_SOUP_COV_MULTI_FORMATTERS = "true"
+K_SOUP_COV_OPEN_BIN = ""
+MAX_ROWS = "1"
+OPENCOLLECTIVE_HANDLE = "{KJ|OPENCOLLECTIVE_ORG}"
+_.file = { path = ".env.local", redact = true }
+_.path = ["exe", "bin"]
+_.source = ".config/mise/env.sh"
+
+[tools]
+ruby = "4.0.6"

data/lib/kettle/jem/templates/mise.toml.no-osc.example

@@ -0,0 +1,25 @@
+# Shared development environment for this gem.
+# Local overrides belong in .env.local (loaded via dotenvy through mise).
+
+[env]
+FLOSS_CFG_FUND_DEBUG = "false"
+FLOSS_CFG_FUND_LOGFILE = "tmp/log/debug.log"
+FUNDING_ORG = "false"
+KETTLE_DEV_DEBUG = "false"
+KETTLE_TEST_SILENT = "true"
+K_SOUP_COV_COMMAND_NAME = "Test Coverage"
+K_SOUP_COV_DO = "true"
+K_SOUP_COV_FORMATTERS = "html,xml,rcov,lcov,json,tty"
+K_SOUP_COV_MIN_BRANCH = "76"
+K_SOUP_COV_MIN_HARD = "true"
+K_SOUP_COV_MIN_LINE = "92"
+K_SOUP_COV_MULTI_FORMATTERS = "true"
+K_SOUP_COV_OPEN_BIN = ""
+MAX_ROWS = "1"
+OPENCOLLECTIVE_HANDLE = "false"
+_.file = { path = ".env.local", redact = true }
+_.path = ["exe", "bin"]
+_.source = ".config/mise/env.sh"
+
+[tools]
+ruby = "4.0.6"

data/lib/kettle/jem/templates/parsers.toml.example

@@ -0,0 +1,19 @@
+# tsdl configuration — tree-sitter grammar versions
+# https://github.com/stackmystack/tsdl
+#
+# Run: tsdl build --out-dir /usr/local/lib
+# Or let .devcontainer/scripts/setup-tree-sitter.sh handle it.
+
+out-dir = "/usr/local/lib"
+
+[parsers]
+json = "v0.24.8"
+bash = "v0.25.1"
+
+[parsers.toml]
+ref = "v0.7.0"
+from = "https://github.com/tree-sitter-grammars/tree-sitter-toml"
+
+[parsers.rbs]
+ref = "v0.2.2"
+from = "https://github.com/joker1007/tree-sitter-rbs"

data/lib/kettle/jem/templates/readme/partials/basic_usage.md.example

@@ -0,0 +1,28 @@
+```console
+kettle-jem
+K_JEM_TEMPLATING=true kettle-jem install
+K_JEM_TEMPLATING=true kettle-jem selftest
+```
+
+`kettle-jem` setup creates or updates `.structuredmerge/kettle-jem.yml`,
+installs template support, and runs the template workflow. `kettle-jem install`
+reapplies full template updates and regenerates local finishing artifacts such
+as binstubs.
+Use `kettle-jem template --only PATH` for scoped file updates. `kettle-jem
+selftest` checks template drift in a temporary workspace. The `kettle:jem:*`
+rake tasks are internal targets used by the executable after it prepares the
+templating environment.
+
+Useful runtime controls:
+
+| Setting | Use |
+|---|---|
+| `KETTLE_JEM_VERBOSE=true` | Show detailed template output. |
+| `PARSE_ERROR_MODE=fail` | Fail when an AST/parser-backed merge cannot run. |
+| `PARSE_ERROR_MODE=skip` | Preserve the destination when parsing is unavailable. |
+| `FAILURE_MODE=error` | Raise on merge failure. |
+| `FAILURE_MODE=rescue` | Warn and keep unmerged content on merge failure. |
+| `only=glob,glob` | Limit the template run to matching paths. |
+| `include=glob,glob` | Add matching paths to the run. |
+| `hook_templates=l|g|n` | Install local hooks, global hooks, or no hooks. |
+| `git_drivers=semantic-diff|builtin-diff|global|include-file|check|undo|none` | Install, verify, remove, or skip StructuredMerge Git diff driver setup. |

data/lib/kettle/jem/templates/readme/partials/configuration.md.example

@@ -0,0 +1,112 @@
+`kettle-jem` reads `.structuredmerge/kettle-jem.yml` from the project root. When
+only the legacy root `.kettle-jem.yml` exists, `kettle-jem install` migrates it
+to the structured config directory. The config controls template sources, README
+section partials, token values, merge defaults, per-file strategies, workflow
+generation, Git driver setup, and plugin loading.
+
+<details markdown="1">
+<summary>Configuration shape</summary>
+
+```yaml
+project_emoji: "💎"
+engines:
+  - ruby
+ruby:
+  test_minimum: "2.4"
+licenses:
+  - MIT
+templates:
+  root: packaged
+  apply: true
+  entries:
+    - README.md
+readme:
+  section_partials:
+    synopsis: readme/partials/synopsis.md
+    configuration: readme/partials/configuration.md
+    basic_usage: readme/partials/basic_usage.md
+defaults:
+  preference: template
+  add_template_only_nodes: true
+  freeze_token: kettle-jem
+patterns:
+  - path: "certs/**"
+    strategy: raw_copy
+files:
+  Rakefile:
+    strategy: merge
+    preference: destination
+git_drivers: semantic-diff
+plugins:
+  - kettle-drift
+```
+
+</details>
+
+<details markdown="1">
+<summary>Strategies, tokens, and freeze blocks</summary>
+
+Template strategies:
+
+| Strategy | Behavior |
+|---|---|
+| `merge` | Resolve tokens, then merge template and destination using the selected recipe. |
+| `accept_template` | Resolve tokens and write the template result. |
+| `keep_destination` | Leave the destination file untouched. |
+| `raw_copy` | Copy bytes exactly, with no token resolution or merge. |
+
+`raw_copy` exists for bootstrap files that may be needed before the full
+templating stack is available. Because it bypasses normal template processing,
+do not use it for templates that contain `{KJ\|...}` tokens or require
+StructuredMerge normalization.
+
+Merge entries may set `preference`, `add_template_only_nodes`, `freeze_token`,
+`file_type`, and `recipe`. `files` entries match exact paths. `patterns`
+entries are glob-based and the first match wins.
+
+Tokens use `{KJ\|TOKEN}` syntax. Environment values win over
+`.structuredmerge/kettle-jem.yml`, and config values win over safe
+gemspec-derived defaults.
+
+Freeze blocks use the configured token, defaulting to `kettle-jem`:
+
+```ruby
+# kettle-jem:freeze
+gem "local-only", path: "../local-only"
+# kettle-jem:unfreeze
+```
+
+Content inside a freeze block is preserved from the destination.
+
+</details>
+
+<details markdown="1">
+<summary>Merge engines and workflows</summary>
+
+`kettle-jem` routes files through recipes selected by target path and
+`file_type`. Current Ruby recipes cover README metadata/style, changelog
+normalization, managed text blocks, GitHub funding, GitHub Actions workflows,
+obsolete workflow cleanup, Open Collective cleanup, selected template source
+application, and Rakefile scaffold cleanup.
+
+`workflows.preset: framework` generates a Ruby x framework-version CI matrix.
+`workflows.exec_cmd` sets the default command for generated test workflows
+(default: `kettle-test`; ENV override: `KJ_EXEC_CMD`).
+`ruby.test_minimum` sets the lowest MRI Ruby version used for generated CI
+workflows and Appraisals. It defaults to `2.4`, and the effective generated
+floor is never lower than the gemspec `required_ruby_version`.
+`workflows.coverage` enables coverage workflow generation. Existing custom
+workflows can receive pinned-action snippets without replacing the whole file.
+
+`git_drivers` defaults to `semantic-diff` during `kettle-jem install`, writing
+managed `.gitattributes` entries plus repo-local `diff.smorg-*` command config.
+Use `builtin-diff` to keep Git's built-in language drivers, `global` to register
+driver commands once per user, `include-file` to write `.git/smorg/config`, and
+`none` to opt out. `check` verifies the local setup, and `undo` removes managed
+driver entries.
+
+`plugins` lists extension gems. A plugin is required by gem name, resolved to a
+constant, and called through `register_kettle_jem_plugin(registrar)`. The
+registrar supports `before_phase`, `after_phase`, and `on_phase` hooks.
+
+</details>

data/lib/kettle/jem/templates/readme/partials/synopsis.md.example

@@ -0,0 +1,3 @@
+`{KJ|NAMESPACE}` is the Ruby implementation of the Kettle template tool. It
+keeps Ruby gems aligned with a shared template while preserving package-owned
+README sections and project-specific files.