kettle-jem 7.0.0 → 7.1.3

data/lib/kettle/jem/templates/.config/mise/env.sh

@@ -0,0 +1,26 @@
+# shellcheck shell=bash
+
+prepend_unique_path_value() {
+  local value="$1"
+  local current="$2"
+
+  if [[ -z "$current" ]]; then
+    printf '%s' "$value"
+  elif [[ ":$current:" == *":$value:"* ]]; then
+    printf '%s' "$current"
+  else
+    printf '%s:%s' "$value" "$current"
+  fi
+}
+
+# Preserve existing values while prepending the project defaults needed by TreeHaver.
+_tree_sitter_runtime_lib="${TREE_SITTER_RUNTIME_LIB:-/home/linuxbrew/.linuxbrew/Cellar/tree-sitter/0.26.6/lib/libtree-sitter.so}"
+_tree_sitter_runtime_dir="$(dirname "${_tree_sitter_runtime_lib}")"
+_tree_sitter_java_jars_dir="${TREE_SITTER_JAVA_JARS_DIR:-}"
+
+if [[ -n "${_tree_sitter_java_jars_dir}" ]]; then
+  _tree_sitter_java_jar="${_tree_sitter_java_jars_dir}/jtreesitter-0.26.0.jar"
+  export CLASSPATH="$(prepend_unique_path_value "${_tree_sitter_java_jar}" "${CLASSPATH:-}")"
+fi
+
+export LD_LIBRARY_PATH="$(prepend_unique_path_value "${_tree_sitter_runtime_dir}" "${LD_LIBRARY_PATH:-}")"

data/lib/kettle/jem/templates/.devcontainer/apt-install/devcontainer-feature.json.example

@@ -0,0 +1,9 @@
+{
+  "name": "Apt Install Packages",
+  "id": "apt-install",
+  "version": "1.0.0",
+  "description": "More packages are needed",
+  "install": {
+    "script": "install.sh"
+  }
+}

data/lib/kettle/jem/templates/.devcontainer/apt-install/install.sh.example

@@ -0,0 +1,19 @@
+#!/bin/sh
+set -e  # Exit on error
+
+# Install basic development dependencies for Ruby & JRuby projects
+apt-get update -y
+apt-get install -y direnv default-jdk git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev
+
+# Support for PostgreSQL (commented out by default)
+# apt-get install -y postgresql libpq-dev
+
+# NOTE: Tree-sitter setup is NOT done here because the workspace is not mounted yet
+# during the devcontainer build phase. Tree-sitter setup happens in postCreateCommand
+# after the workspace is mounted. See devcontainer.json for details.
+# This gem needs ALL grammars for top-level merging tool (handled by setup-tree-sitter.sh).
+
+echo "Basic apt packages installed. Tree-sitter will be set up after workspace mount."
+
+# Adds the direnv setup script to ~/.bashrc file (at the end)
+echo 'eval "$(direnv hook bash)"' >> ~/.bashrc

data/lib/kettle/jem/templates/.devcontainer/devcontainer.json.example

@@ -0,0 +1,27 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/ruby
+{
+  "name": "Ruby",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "mcr.microsoft.com/devcontainers/ruby:1-3-bookworm",
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  "features": {
+    "./apt-install": {}
+  },
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+
+  // Use 'postCreateCommand' to run commands after the container is created.
+  // First setup tree-sitter (auto-detects sudo requirement), then run bundle as the regular user
+  // Use ${containerWorkspaceFolder} to get the actual workspace path in the container
+  "postCreateCommand": "bash ${containerWorkspaceFolder}/.devcontainer/scripts/setup-tree-sitter.sh --workspace=${containerWorkspaceFolder} && bundle update --bundler",
+  // Configure tool-specific properties.
+  "customizations": {
+    "jetbrains": {
+      "backend": "RubyMine"
+    }
+  }
+
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  // "remoteUser": "root"
+}

data/lib/kettle/jem/templates/.devcontainer/scripts/setup-tree-sitter.sh.example

@@ -0,0 +1,210 @@
+#!/bin/bash
+set -e
+
+# Setup script for tree-sitter dependencies (Ubuntu/Debian)
+# Works for both GitHub Actions and devcontainer environments
+#
+# Dual-Environment Design:
+# - GitHub Actions: Runs as non-root user, auto-detects need for sudo
+# - Devcontainer: Can run as root (apt-install feature) or non-root (postCreateCommand)
+# - Auto-detection: Checks if running as root (id -u = 0), uses sudo if non-root
+#
+# Grammar building is delegated to tsdl (https://github.com/stackmystack/tsdl).
+# Configure grammars and versions in parsers.toml at the project root.
+#
+# Options:
+#   --sudo: Force use of sudo (optional, auto-detected by default)
+#   --cli:  Install tree-sitter-cli via npm (optional)
+#   --build: Build and install the tree-sitter C runtime from source when distro packages are missing (optional)
+#   --tsdl-version VERSION: Pin tsdl release version (default: v2.0.0)
+#   --workspace PATH: Workspace root path for informational/debugging purposes only
+
+SUDO=""
+INSTALL_CLI=false
+BUILD_FROM_SOURCE=false
+TSDL_VERSION="v2.0.0"
+WORKSPACE_ROOT="/workspaces/${PWD##*/}"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --sudo)           SUDO="sudo"; shift ;;
+    --cli)            INSTALL_CLI=true; shift ;;
+    --build)          BUILD_FROM_SOURCE=true; shift ;;
+    --tsdl-version)   TSDL_VERSION="$2"; shift 2 ;;
+    --tsdl-version=*) TSDL_VERSION="${1#*=}"; shift ;;
+    --workspace)      WORKSPACE_ROOT="$2"; shift 2 ;;
+    --workspace=*)    WORKSPACE_ROOT="${1#*=}"; shift ;;
+    *) echo "Unknown option: $1" >&2; shift ;;
+  esac
+done
+
+# Auto-detect if we need sudo (running as non-root)
+if [ -z "$SUDO" ] && [ "$(id -u)" -ne 0 ]; then
+  SUDO="sudo"
+fi
+
+echo "Configuration:"
+echo "  Workspace root: $WORKSPACE_ROOT (informational only)"
+echo "  Using sudo: $([ -n "$SUDO" ] && echo "yes" || echo "no")"
+echo "  Install CLI: $INSTALL_CLI"
+echo "  Build from source: $BUILD_FROM_SOURCE"
+echo "  tsdl version: $TSDL_VERSION"
+echo ""
+
+have_cmd() { command -v "$1" >/dev/null 2>&1; }
+
+have_tree_sitter() {
+  [ -f /usr/include/tree-sitter/api.h ] && return 0
+  [ -f /usr/local/include/tree-sitter/api.h ] && return 0
+  [ -f /usr/local/include/tree-sitter/lib/include/api.h ] && return 0
+  ldconfig -p 2>/dev/null | grep -q libtree-sitter && return 0 || return 1
+}
+
+install_tree_sitter_from_source() {
+  echo "[tree-sitter] Building runtime from source..."
+  tmpdir=$(mktemp -d /tmp/tree-sitter-src-XXXX)
+  trap 'rm -rf "$tmpdir"' EXIT
+  git clone --depth 1 https://github.com/tree-sitter/tree-sitter.git "$tmpdir" || return 1
+  pushd "$tmpdir" >/dev/null || return 1
+  if ! make; then
+    echo "[tree-sitter] ERROR: 'make' failed" >&2
+    popd >/dev/null
+    return 1
+  fi
+  $SUDO mkdir -p /usr/local/include/tree-sitter
+  $SUDO cp -r lib/include/* /usr/local/include/tree-sitter/ || true
+  $SUDO cp -a lib/libtree-sitter.* /usr/local/lib/ 2>/dev/null || true
+  have_cmd ldconfig && $SUDO ldconfig || true
+  popd >/dev/null
+  echo "[tree-sitter] Runtime installed to /usr/local."
+  return 0
+}
+
+install_tsdl() {
+  if have_cmd tsdl; then
+    echo "[tsdl] Already installed: $(tsdl --version)"
+    return 0
+  fi
+
+  echo "[tsdl] Installing tsdl ${TSDL_VERSION}..."
+  local arch
+  arch="$(uname -m)"
+  case "$arch" in
+    x86_64)  arch="x64" ;;
+    aarch64) arch="arm64" ;;
+    armv7l)  arch="arm" ;;
+    i686)    arch="x86" ;;
+    *) echo "[tsdl] ERROR: Unsupported architecture: $arch" >&2; return 1 ;;
+  esac
+
+  local os
+  os="$(uname -s | tr '[:upper:]' '[:lower:]')"
+  case "$os" in
+    linux)  os="linux" ;;
+    darwin) os="macos" ;;
+    *) echo "[tsdl] ERROR: Unsupported OS: $os" >&2; return 1 ;;
+  esac
+
+  local url="https://github.com/stackmystack/tsdl/releases/download/${TSDL_VERSION}/tsdl-${os}-${arch}.gz"
+  local tmpbin
+  tmpbin=$(mktemp /tmp/tsdl-XXXX)
+
+  if ! wget -q "$url" -O "${tmpbin}.gz"; then
+    echo "[tsdl] ERROR: Failed to download from $url" >&2
+    return 1
+  fi
+  gunzip -f "${tmpbin}.gz"
+  chmod +x "$tmpbin"
+  $SUDO mv "$tmpbin" /usr/local/bin/tsdl
+  echo "[tsdl] Installed: $(tsdl --version)"
+}
+
+# --- 1. System dependencies ---
+echo "Installing system dependencies..."
+$SUDO apt-get update -y
+if ! $SUDO apt-get install -y \
+  build-essential \
+  pkg-config \
+  $( [ "$BUILD_FROM_SOURCE" = false ] && echo "libtree-sitter-dev" ) \
+  wget \
+  gcc \
+  g++ \
+  make \
+  zlib1g-dev \
+  libssl-dev \
+  libreadline-dev \
+  libyaml-dev \
+  libxml2-dev \
+  libxslt1-dev \
+  libcurl4-openssl-dev \
+  software-properties-common \
+  libffi-dev; then
+  echo "ERROR: apt-get failed to install required packages." >&2
+  exit 1
+fi
+
+# --- 2. Tree-sitter runtime ---
+if [ "$BUILD_FROM_SOURCE" = true ]; then
+  echo "[tree-sitter] --build specified; building runtime from source."
+fi
+
+if ! have_tree_sitter; then
+  if [ "$BUILD_FROM_SOURCE" = true ]; then
+    if ! install_tree_sitter_from_source; then
+      echo "[tree-sitter] ERROR: Failed to build runtime. Aborting." >&2
+      exit 1
+    fi
+  else
+    echo "[tree-sitter] ERROR: Runtime (headers/libs) not found." >&2
+    echo "Install libtree-sitter-dev or re-run with --build." >&2
+    exit 1
+  fi
+fi
+
+# --- 3. tree-sitter-cli (optional) ---
+if [ "$INSTALL_CLI" = true ]; then
+  echo "Installing tree-sitter-cli via npm..."
+  $SUDO npm install -g tree-sitter-cli
+else
+  echo "Skipping tree-sitter-cli (use --cli to install)"
+fi
+
+# --- 4. Install tsdl and build grammars ---
+install_tsdl
+
+echo ""
+echo "Building tree-sitter grammars via tsdl..."
+# Use parsers.toml from the project root if it exists, otherwise build defaults.
+# tsdl automatically reads parsers.toml in the current directory.
+if [ -f parsers.toml ]; then
+  echo "[tsdl] Using parsers.toml config"
+  $SUDO tsdl build --out-dir /usr/local/lib --progress plain
+else
+  echo "[tsdl] No parsers.toml found; building default grammars: toml json bash rbs"
+  $SUDO tsdl build toml json bash rbs --out-dir /usr/local/lib --progress plain
+fi
+
+$SUDO ldconfig || echo "WARNING: ldconfig failed" >&2
+
+echo ""
+echo "tree-sitter setup complete!"
+echo ""
+echo "Detected library paths:"
+
+if [ -f /usr/lib/x86_64-linux-gnu/libtree-sitter.so.0 ]; then
+  echo "  TREE_SITTER_RUNTIME_LIB=/usr/lib/x86_64-linux-gnu/libtree-sitter.so.0"
+elif [ -f /usr/lib/x86_64-linux-gnu/libtree-sitter.so ]; then
+  echo "  TREE_SITTER_RUNTIME_LIB=/usr/lib/x86_64-linux-gnu/libtree-sitter.so"
+elif [ -f /usr/lib/libtree-sitter.so.0 ]; then
+  echo "  TREE_SITTER_RUNTIME_LIB=/usr/lib/libtree-sitter.so.0"
+elif [ -f /usr/lib/libtree-sitter.so ]; then
+  echo "  TREE_SITTER_RUNTIME_LIB=/usr/lib/libtree-sitter.so"
+else
+  echo "  WARNING: Could not find libtree-sitter runtime library!"
+fi
+
+echo ""
+echo "Grammar libraries:"
+for lib in /usr/local/lib/libtree-sitter-*.so; do
+  [ -f "$lib" ] && echo "  $lib"
+done

data/lib/kettle/jem/templates/.env.local.example

@@ -0,0 +1,67 @@
+#
+# DO NOT EDIT THIS FILE
+#
+# COPY THIS FILE TO .env.local
+#
+# That file is ignored by .gitignore. This file is not.
+# mise loads .env.local via dotenvy, so use KEY=value lines (not shell `export` statements).
+#
+DEBUG=false # do not allow byebug statements (override in .env.local)
+FLOSS_FUNDING_DEBUG=false # extra logging to help diagnose issues (override in .env.local)
+AUTOGEN_FIXTURE_CLEANUP=false # autogenerated gem fixture cleanup after every RSpec run
+GIT_HOOK_FOOTER_APPEND=false
+GIT_HOOK_FOOTER_APPEND_DEBUG=false
+GIT_HOOK_FOOTER_SENTINEL="⚡️ A message from a fellow meat-based-AI"
+
+# Tokens used by ci:act and CI helpers for reading workflow/pipeline status via APIs
+# GitHub (either GITHUB_TOKEN or GH_TOKEN will be used; fine-grained recommended)
+# - Scope/permissions: For fine-grained tokens, grant repository access (Read) and Actions: Read
+# - For classic tokens, public repos need no scopes; private repos typically require repo
+GITHUB_TOKEN="<your GH token for GHA status; NEVER COMMIT>"
+# Alternatively:
+# GH_TOKEN="<your GH token>"
+
+# GitLab (either GITLAB_TOKEN or GL_TOKEN will be used)
+# - Scope: read_api is sufficient to read pipelines
+GITLAB_TOKEN="<your GitLab token for pipeline status; NEVER COMMIT>"
+# Alternatively:
+# GL_TOKEN="<your GitLab token>"
+
+# If this gem does not have an open source collective uncomment and set these to false.
+# OPENCOLLECTIVE_HANDLE=false
+# FUNDING_ORG=false
+
+# ── Kettle-Jem Token Replacements ──────────────────────────────────────────────
+# Used by `apply_common_replacements` during templating.
+# Set these to your own values. Blank/unset values leave the token unresolved.
+
+# ── Forge Repository Owner ────────────────────────────────────────────────────
+# Used for scaffolded repository URLs before a forge origin remote exists.
+# FORGE_ORG=<your preferred forge organization or owner>
+# KJ_GH_ORG=<your GitHub organization or owner>
+
+# ── Forge Users ────────────────────────────────────────────────────────────────
+# KJ_GH_USER=<your GitHub username>
+# KJ_GL_USER=<your GitLab username>
+# KJ_CB_USER=<your CodeBerg username>
+# KJ_SH_USER=<your SourceHut username>
+
+# ── Author Identity ───────────────────────────────────────────────────────────
+# KJ_AUTHOR_NAME=<your full name>
+# KJ_AUTHOR_GIVEN_NAMES=<your given/first names>
+# KJ_AUTHOR_FAMILY_NAMES=<your family/last name>
+# KJ_AUTHOR_EMAIL=<your email>
+# KJ_AUTHOR_ORCID=<your ORCID identifier>
+# KJ_AUTHOR_DOMAIN=<your domain, e.g. example.com>
+
+# ── Funding Platforms ─────────────────────────────────────────────────────────
+# KJ_FUNDING_KOFI=<your Ko-fi ID>
+# KJ_FUNDING_PAYPAL=<your PayPal.me username>
+# KJ_FUNDING_BUYMEACOFFEE=<your Buy Me a Coffee username>
+# KJ_FUNDING_LIBERAPAY=<your Liberapay username>
+
+# ── Social / Community ────────────────────────────────────────────────────────
+# KJ_SOCIAL_MASTODON=<your Mastodon username>
+# KJ_SOCIAL_BLUESKY=<your Bluesky handle>
+# KJ_SOCIAL_LINKTREE=<your Linktree username>
+# KJ_SOCIAL_DEVTO=<your dev.to username>

data/lib/kettle/jem/templates/.envrc.example

@@ -0,0 +1,4 @@
+# This project uses mise.toml for environment management.
+# Install/activate mise, or run commands with:
+#   mise exec -C /path/to/project -- <command>
+true

data/lib/kettle/jem/templates/.envrc.no-osc.example

@@ -0,0 +1,4 @@
+# This project uses mise.toml for environment management.
+# Install/activate mise, or run commands with:
+#   mise exec -C /path/to/project -- <command>
+true

data/lib/kettle/jem/templates/.gemrc.example

@@ -0,0 +1 @@
+gem: --no-document

data/lib/kettle/jem/templates/.git-hooks/commit-msg.example

@@ -0,0 +1,60 @@
+#!/usr/bin/env ruby
+# vim: set syntax=ruby
+
+# kettle-jem:freeze
+# To retain chunks of comments & code during kettle-jem templating:
+# Wrap custom sections with freeze markers (e.g., as above and below this comment chunk).
+# kettle-jem will then preserve content between those markers across template runs.
+# kettle-jem:unfreeze
+
+# Do not rely on Bundler; allow running outside a Bundler context
+begin
+  require "rubygems"
+rescue LoadError
+  # continue
+end
+
+begin
+  # External gems
+  require "gitmoji/regex"
+
+  full_text = File.read(ARGV[0])
+  # Is the first character a GitMoji?
+  gitmoji_index = full_text =~ Gitmoji::Regex::REGEX
+  if gitmoji_index == 0
+    exit(0)
+  else
+    denied = <<~EOM
+      Oh snap, think again...
+
+       ______    _______      ___  _______  _______  _______  _______  ______   __
+      |    _ |  |       |    |   ||       ||       ||       ||       ||      | |  |
+      |   | ||  |    ___|    |   ||    ___||       ||_     _||    ___||  _    ||  |
+      |   |_||_ |   |___     |   ||   |___ |       |  |   |  |   |___ | | |   ||  |
+      |    __  ||    ___| ___|   ||    ___||      _|  |   |  |    ___|| |_|   ||__|
+      |   |  | ||   |___ |       ||   |___ |     |_   |   |  |   |___ |       | __
+      |___|  |_||_______||_______||_______||_______|  |___|  |_______||______| |__|
+
+
+      Did you forget to add a relevant gitmoji? (see https://gitmoji.dev/ for tools)
+      In this project, a Gitmoji must be the first grapheme of the commit message.
+      What's a grapheme?
+      A symbol rendered to be visually identifiable as a single character, but which may be composed of multiple Unicode code points)
+      Must match: #{Gitmoji::Regex::REGEX}
+      #{"Found a gitmoji at character index #{gitmoji_index}... not good enough.\n" if gitmoji_index}
+      Example: git commit -m "✨ My excellent new feature"
+
+    EOM
+    puts denied
+    exit(1)
+  end
+rescue LoadError => e
+  failure = <<~EOM
+    gitmoji-regex gem not found: #{e.class}: #{e.message}.
+      Skipping gitmoji check and allowing commit to proceed.
+      Recommendation: add 'gitmoji-regex' to your development dependencies to enable this check.
+
+  EOM
+  warn(failure)
+  exit(0)
+end

data/lib/kettle/jem/templates/.git-hooks/commit-subjects-goalie.txt.example

@@ -0,0 +1,8 @@
+🔖 Prepare release v
+🔒️ Checksums for v
+
+# Lines beginning with # are ignored.
+# This file is read by .git-hooks/prepare-commit-msg in each project.
+# Each line of this file will be matched against the commit subject using `starts_with?`.
+# If any `starts_with?` match the project script bin/prepare-commit-msg will run.
+# 🔒️ Checksums for v is the standard commit message by stone_checksums.

data/lib/kettle/jem/templates/.git-hooks/footer-template.erb.txt.example

@@ -0,0 +1,16 @@
+⚡️ A message from a fellow meat-based-AI ⚡️
+- [❤️] Finely-crafted open-source tools like <%= @gem_name %> (& many more) require time and effort.
+- [❤️] Though I adore my work, it lacks financial sustainability.
+- [❤️] Please, help me continue enhancing your tools by becoming a sponsor:
+  - [💲] https://liberapay.com/{KJ|FUNDING:LIBERAPAY}/donate
+  - [💲] https://github.com/sponsors/{KJ|GH:USER}
+
+<% if ENV["GIT_HOOK_FOOTER_APPEND_DEBUG"] == "true" %>
+    @pwd = <%= @pwd %>
+    @gemspecs = <%= @gemspecs %>
+    @spec = <%= @spec %>
+    @gemspec_path = <%= @gemspec_path %>
+    @gem_name <%= @gem_name %>
+    @spec_name <%= @spec_name %>
+    @content <%= @content %>
+<% end %>

data/lib/kettle/jem/templates/.git-hooks/prepare-commit-msg.example

@@ -0,0 +1,9 @@
+#!/bin/sh
+
+# Fail on error and unset variables
+set -eu
+
+# Run the generated wrapper directly so hook execution does not depend on shell activation.
+# We are not using direnv exec here because mise and direnv can result in conflicting PATH settings:
+# See: https://mise.jdx.dev/direnv.html
+exec "kettle-commit-msg" "$@"

data/lib/kettle/jem/templates/.github/.codecov.yml.example

@@ -0,0 +1,14 @@
+codecov:
+  bot: "autobolt"
+  max_report_age: 24
+  disable_default_path_fixes: no
+  require_ci_to_pass: yes
+  notify:
+    after_n_builds: 2
+    wait_for_ci: yes
+coverage:
+  status:
+    project:
+      default:
+        target: 100%
+        threshold: 1%

data/lib/kettle/jem/templates/.github/FUNDING.yml.example

@@ -0,0 +1,10 @@
+# These are supported funding model platforms
+
+buy_me_a_coffee: "{KJ|FUNDING:BUYMEACOFFEE}"
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+github: ["{KJ|GH:USER}"] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+ko_fi: "{KJ|FUNDING:KOFI}" # Replace with a single Ko-fi username
+liberapay: "{KJ|FUNDING:LIBERAPAY}" # Replace with a single Liberapay username
+open_collective: "{KJ|OPENCOLLECTIVE_ORG}"
+thanks_dev: u/gh/{KJ|GH:USER}
+tidelift: rubygems/{KJ|GEM_NAME}

data/lib/kettle/jem/templates/.github/FUNDING.yml.no-osc.example

@@ -0,0 +1,10 @@
+# These are supported funding model platforms
+
+buy_me_a_coffee: "{KJ|FUNDING:BUYMEACOFFEE}"
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+github: ["{KJ|GH:USER}"] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+ko_fi: "{KJ|FUNDING:KOFI}" # Replace with a single Ko-fi username
+liberapay: "{KJ|FUNDING:LIBERAPAY}" # Replace with a single Liberapay username
+open_collective: # Replace with a single Open Collective slug e.g., orgs/cloud-foundry
+thanks_dev: u/gh/{KJ|GH:USER}
+tidelift: rubygems/{KJ|GEM_NAME}

data/lib/kettle/jem/templates/.github/copilot_instructions.md.example

@@ -0,0 +1 @@
+See AGENTS.md for important information on tool use and project context.

data/lib/kettle/jem/templates/.github/dependabot.yml.example

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: bundler
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    ignore:
+      - dependency-name: "rubocop-lts"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

data/lib/kettle/jem/templates/.github/workflows/auto-assign.yml.example

@@ -0,0 +1,21 @@
+name: Auto Assign
+on:
+  issues:
+    types: [opened]
+  pull_request:
+    types: [opened]
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    steps:
+    - name: 'Auto-assign issue'
+      uses: pozil/auto-assign-issue@af6beea6bdf1e8eb373f061c5bc168681fc6d011 # v4.0.1
+      with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          assignees: "{KJ|GH:USER}"
+          abortIfPreviousAssignees: true
+          allowSelfAssign: true
+          numOfAssignee: 1

data/lib/kettle/jem/templates/.github/workflows/coverage.yml.example

@@ -0,0 +1,102 @@
+name: Test Coverage
+
+permissions:
+  contents: read
+  pull-requests: write
+  id-token: write
+
+env:
+  K_SOUP_COV_MIN_BRANCH: 100
+  K_SOUP_COV_MIN_LINE: 100
+  K_SOUP_COV_MIN_HARD: true
+  K_SOUP_COV_FORMATTERS: "xml,rcov,lcov,tty"
+  K_SOUP_COV_DO: true
+  K_SOUP_COV_MULTI_FORMATTERS: true
+  K_SOUP_COV_COMMAND_NAME: "Test Coverage"
+
+on:
+  push:
+    branches:
+      - 'main'
+      - '*-stable'
+    tags:
+      - '!*' # Do not execute on tags
+  pull_request:
+    branches:
+      - '*'
+  # Allow manually triggering the workflow.
+  workflow_dispatch:
+
+# Cancels all previous workflow runs for the same branch that have not yet completed.
+concurrency:
+  # The concurrency group contains the workflow name and the branch name.
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  coverage:
+    if: "github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))"
+    name: Code Coverage on ${{ matrix.ruby }}@current
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}
+    env: # $BUNDLE_GEMFILE must be set at job level, so it is set for all steps
+      BUNDLE_GEMFILE: ${{ github.workspace }}/Appraisal.root.gemfile
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          # Coverage
+          - ruby: "ruby"
+            appraisal: "coverage"
+            exec_cmd: "{KJ|CI:EXEC_CMD}"
+            rubygems: latest
+            bundler: latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Setup Ruby & RubyGems
+        uses: appraisal-rb/setup-ruby-flash@925395edf973d2dc0a629919f407f3547a03d4b5 # v2.1 compatibility bundle installation
+        with:
+          ruby-version: "${{ matrix.ruby }}"
+          rubygems: "${{ matrix.rubygems }}"
+          bundler: "${{ matrix.bundler }}"
+          bundler-cache: true
+          manual-compatibility-bundle: true
+          gem-install-retries: 7
+
+      - name: "[Attempt 1] Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}"
+        id: bundleAppraisalAttempt1
+        run: bundle exec appraisal ${{ matrix.appraisal }} install
+        # Continue to the next step on failure
+        continue-on-error: true
+
+      # Effectively an automatic retry of the previous step.
+      - name: "[Attempt 2] Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}"
+        id: bundleAppraisalAttempt2
+        # If bundleAppraisalAttempt1 failed, try again here; Otherwise skip.
+        if: ${{ steps.bundleAppraisalAttempt1.outcome == 'failure' }}
+        run: bundle exec appraisal ${{ matrix.appraisal }} install
+
+      - name: Restore RSpec status log
+        if: "${{!env.ACT}}"
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: .rspec_status
+          key: rspec-status-coverage-${{matrix.ruby}}-${{matrix.appraisal}}-${{hashFiles('**/Gemfile.lock','Appraisal.root.gemfile','gemfiles/**/*.gemfile')}}-${{github.run_id}}-${{github.run_attempt}}
+          restore-keys: |
+            rspec-status-coverage-${{matrix.ruby}}-${{matrix.appraisal}}-${{hashFiles('**/Gemfile.lock','Appraisal.root.gemfile','gemfiles/**/*.gemfile')}}-
+            rspec-status-coverage-${{matrix.ruby}}-${{matrix.appraisal}}-
+
+      - name: Tests for ${{ matrix.ruby }}@current via ${{ matrix.exec_cmd }}
+        run: bundle exec appraisal ${{ matrix.appraisal }} bundle exec ${{ matrix.exec_cmd }}
+
+      - name: Verify coverage reports
+        run: |
+          test -s coverage/lcov.info
+          test -s coverage/coverage.xml
+
+{KJ|GITHUB_ACTIONS:COVERAGE_UPLOAD_STEPS}