kettle-family 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5116144628e718706163387018ab7eaedc531e3792f1e170e7b64b38ecbfe959
-  data.tar.gz: a30da1750923d4ca49729234405926594802a293e0cbe9f8b456397158196867
+  metadata.gz: 3a7c89b89e309502af9e996022c4c93d5b02b0118279464d197537e76bd2c65a
+  data.tar.gz: f80c4406bda1cd8e3a0d42c47da1e4fa645303b71f1cd68a5381053c041e0351
 SHA512:
-  metadata.gz: 51c828bd1d1dacb0ad5eea8670d16666e47a225398ebc25fa6539aba4732ad05a0a596a3d85a25d0ed0a6f5b1776f361b4ee91af6c4621a635c762f6f512f907
-  data.tar.gz: 975b89c1f3f31291f322119c6e7af7e277a18d42ced28f54380f6c01e8e0a31e53c57cee977628486207dd3581efe08de657f1401fe008f42a3913b282a541e5
+  metadata.gz: 5160695320d1ce2a37cbb6e4cfa8dd45026a6784d660a932678aa601b5c4b5a22903530109537cf9e9d58f6658f20d0e2ea8d36ead281f0258a1743da7c1e565
+  data.tar.gz: 324f032033f94e3d7891d9935efd8ca1583c081eac9e14d265c2dcb3d258ffdbb310e8fb0e89587ccb55db73d265ced7cd10e681954a778cbcd981668f375a19

data/CHANGELOG.md

@@ -30,6 +30,39 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [0.1.2] - 2026-06-13
+
+- TAG: [v0.1.2][0.1.2t]
+- COVERAGE: 94.17% -- 840/892 lines in 19 files
+- BRANCH COVERAGE: 78.06% -- 242/310 branches in 19 files
+- 41.80% documented
+
+## [0.1.1] - 2026-06-13
+
+- TAG: [v0.1.1][0.1.1t]
+- COVERAGE: 94.16% -- 838/890 lines in 19 files
+- BRANCH COVERAGE: 77.92% -- 240/308 branches in 19 files
+- 41.80% documented
+
+### Added
+
+- Added configurable member discovery excludes via `members.exclude` /
+  `members.ignore`.
+- Added `kettle-family release-state` to report changelog release state across
+  family members using `kettle-changelog --release-state --json`.
+
+### Changed
+
+- Retemplated generated project files with `kettle-dev` >= 2.2.7.
+
+### Fixed
+
+- Member discovery now filters configured excludes and git-ignored paths before
+  loading gemspecs, avoiding duplicate fixture/tmp gemspecs in recursive family
+  roots.
+- Member discovery now skips default `spec/` and `test/` fixture trees before
+  loading gemspecs, avoiding fixture load failures in family roots.
+
 ## [0.1.0] - 2026-06-10
 
 - TAG: [v0.1.0][0.1.0t]
@@ -58,6 +91,10 @@ Please file a bug if you notice a violation of semantic versioning.
 - Fixed CI load failures on engines without compatible `pty` support by falling back to Open3 for interactive release commands.
 - Fixed Ruby 3.2 version-bump support by loading Prism lazily and wiring the Prism gem only for MRI versions that need it.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v0.1.2...HEAD
+[0.1.2]: https://github.com/kettle-dev/kettle-family/compare/v0.1.1...v0.1.2
+[0.1.2t]: https://github.com/kettle-dev/kettle-family/releases/tag/v0.1.2
+[0.1.1]: https://github.com/kettle-dev/kettle-family/compare/v0.1.0...v0.1.1
+[0.1.1t]: https://github.com/kettle-dev/kettle-family/releases/tag/v0.1.1
 [0.1.0]: https://github.com/kettle-dev/kettle-family/compare/e4a9ca8ed52605b6375bbdd4f745b905a68b8b24...v0.1.0
 [0.1.0t]: https://github.com/kettle-dev/kettle-family/releases/tag/v0.1.0

data/README.md

@@ -126,6 +126,22 @@ gem install kettle-family
 `kettle-family` reads `.kettle-family.yml` from the family root by default.
 Use `--config PATH` to load a different file.
 
+Member discovery is recursive under the configured member roots. Discovery skips
+gemspecs ignored by git and any configured `members.exclude` glob patterns before
+loading gemspec metadata, so fixture or temporary gemspecs do not create duplicate
+members. Exclude patterns are matched relative to the family root and to each
+member root.
+
+```yaml
+family:
+  members_root: gems
+
+members:
+  exclude:
+    - "**/tmp/**"
+    - "**/vendor/**"
+```
+
 For a flat repository that releases from multiple long-lived branches, list the
 release branches under `release.target_branches`. The branch list is processed
 in order. Each branch must be clean enough for `git checkout`, and each branch
@@ -170,6 +186,16 @@ kettle-family discover
 kettle-family release
 ```
 
+Audit changelog release state across the selected family members:
+
+```console
+kettle-family release-state
+```
+
+The release-state report lists each gem's current `version.rb`, latest published
+release, latest versioned `CHANGELOG.md` section, and whether pending changelog
+work exists in either `Unreleased` or an unpublished prepared release section.
+
 Run release prep/build phases without publishing:
 
 ```console
@@ -547,7 +573,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-0.787-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.892-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-family/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/family/cli.rb

@@ -6,7 +6,7 @@ require "optparse"
 module Kettle
   module Family
     class CLI
-      COMMANDS = %w[discover plan report check test lint docs template bump-version release branch-lanes].freeze
+      COMMANDS = %w[discover plan report check test lint docs template bump-version release branch-lanes release-state].freeze
       WORKFLOW_COMMANDS = %w[check test lint docs template release].freeze
 
       def self.call(argv, out: $stdout, err: $stderr)
@@ -61,6 +61,7 @@ module Kettle
               bump-version    Check, plan, or execute family version alignment
               release         Plan or execute release build/publish phases
               branch-lanes    Audit configured branch lane release mappings
+              release-state   Report changelog release state for family members
 
           Options:
               --root PATH      Workspace or family root (default: current directory)
@@ -138,7 +139,11 @@ module Kettle
       def build_report(command, options)
         config = Config.load(root: options[:root], path: options[:config])
         members = Discovery.new(config: config).members
-        ordered = Orderer.new(members: members, mode: config.order_mode, hints: config.order_hints).ordered
+        ordered = if command == "release-state"
+          members.sort_by(&:name)
+        else
+          Orderer.new(members: members, mode: config.order_mode, hints: config.order_hints).ordered
+        end
         selected = Selection.new(members: ordered).apply(only: options[:only], start_at: options[:start_at])
         result_members = if command == "branch-lanes"
           ordered
@@ -163,6 +168,7 @@ module Kettle
       def command_results(command:, config:, members:, options:)
         return bump_version_results(members: members, options: options) if command == "bump-version"
         return branch_lane_results(config: config, members: members) if command == "branch-lanes"
+        return release_state_results(members: members) if command == "release-state"
         return [] unless WORKFLOW_COMMANDS.include?(command)
 
         Workflow.new(
@@ -201,6 +207,10 @@ module Kettle
         BranchLaneAudit.new(config: config, members: members).results
       end
 
+      def release_state_results(members:)
+        ReleaseStateCheck.new(members: members).results
+      end
+
       def write_report(report, options)
         return unless options[:report]
 

data/lib/kettle/family/command_result.rb

@@ -13,8 +13,7 @@ module Kettle
       :stderr,
       :elapsed_seconds,
       :skipped,
-      :reason,
-      keyword_init: true
+      :reason
     ) do
       def to_h
         {

data/lib/kettle/family/config.rb

@@ -6,6 +6,7 @@ module Kettle
   module Family
     class Config
       DEFAULT_PATHS = [".kettle-family.yml", ".structuredmerge/kettle-family.yml"].freeze
+      DEFAULT_MEMBER_EXCLUDES = ["**/vendor/**", "**/tmp/**", "**/spec/**", "**/test/**"].freeze
 
       attr_reader :data, :path, :root
 
@@ -62,6 +63,12 @@ module Kettle
         members.fetch("discover", true)
       end
 
+      def member_exclude_patterns
+        members = data.fetch("members", {})
+        patterns = members.fetch("exclude", nil) || members.fetch("ignore", nil) || []
+        DEFAULT_MEMBER_EXCLUDES + Array(patterns)
+      end
+
       def order_mode
         fetch_path("members", "order", "mode") || "dependency"
       end

data/lib/kettle/family/discovery.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "open3"
+
 module Kettle
   module Family
     class Discovery
@@ -30,7 +32,7 @@ module Kettle
         gemspecs = config.member_roots.flat_map do |root|
           Dir.glob(File.join(root, "**", "*.gemspec"))
         end
-        gemspecs.reject! { |path| path.include?("/vendor/") }
+        gemspecs.reject! { |path| excluded_gemspec?(path) }
         gemspecs.map { |path| member_from_gemspec(path) }
       end
 
@@ -78,6 +80,42 @@ module Kettle
       rescue => error
         raise Error, "could not load gemspec #{path}: #{error.message}"
       end
+
+      def excluded_gemspec?(path)
+        ignored_by_git?(path) || excluded_by_pattern?(path)
+      end
+
+      def ignored_by_git?(path)
+        _stdout, _stderr, status = Open3.capture3("git", "check-ignore", "--quiet", "--", path, chdir: config.root)
+        status.success?
+      end
+
+      def excluded_by_pattern?(path)
+        config.member_exclude_patterns.any? do |pattern|
+          path_matches_pattern?(path, pattern)
+        end
+      end
+
+      def path_matches_pattern?(path, pattern)
+        relative_candidates(path).any? do |relative|
+          File.fnmatch?(pattern, relative, File::FNM_DOTMATCH | File::FNM_EXTGLOB)
+        end
+      end
+
+      def relative_candidates(path)
+        ([config.root] + config.member_roots).filter_map do |root|
+          relative_path(path, root)
+        end
+      end
+
+      def relative_path(path, root)
+        expanded_path = File.expand_path(path)
+        expanded_root = File.expand_path(root)
+        prefix = "#{expanded_root}/"
+        return unless expanded_path.start_with?(prefix)
+
+        expanded_path.delete_prefix(prefix)
+      end
     end
   end
 end

data/lib/kettle/family/member.rb

@@ -8,8 +8,7 @@ module Kettle
       :gemspec_path,
       :version_file,
       :version,
-      :dependencies,
-      keyword_init: true
+      :dependencies
     ) do
       def to_h
         {

data/lib/kettle/family/release_state_check.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "json"
+require "open3"
+
+module Kettle
+  module Family
+    class ReleaseStateCheck
+      COMMAND = ["bundle", "exec", "kettle-changelog", "--release-state", "--json"].freeze
+
+      def initialize(members:)
+        @members = members
+      end
+
+      def results
+        members.map { |member| check_member(member) }
+      end
+
+      private
+
+      attr_reader :members
+
+      def check_member(member)
+        started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        stdout, stderr, status = Open3.capture3(*COMMAND, chdir: member.root)
+        elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - started
+        success = status.success?
+        state = success ? JSON.parse(stdout) : {}
+        result(member: member, stdout: stdout, stderr: stderr, status: status.exitstatus, elapsed: elapsed, success: success, state: state)
+      rescue JSON::ParserError => error
+        result(member: member, stdout: stdout, stderr: stderr, status: 1, elapsed: elapsed || 0.0, success: false, state: {}, reason: "invalid release-state JSON: #{error.message}")
+      end
+
+      def result(member:, stdout:, stderr:, status:, elapsed:, success:, state:, reason: nil)
+        ReleaseStateResult.new(
+          member_name: member.name,
+          command: COMMAND,
+          workdir: member.root,
+          status: status,
+          success: success,
+          stdout: stdout,
+          stderr: stderr,
+          elapsed_seconds: elapsed,
+          state: state,
+          reason: reason || (success ? nil : "release state check failed")
+        )
+      end
+    end
+  end
+end

data/lib/kettle/family/release_state_result.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Kettle
+  module Family
+    class ReleaseStateResult
+      attr_reader :member_name, :phase, :command, :workdir, :status, :success, :stdout, :stderr, :elapsed_seconds, :skipped, :reason, :state
+
+      def initialize(member_name:, command:, workdir:, status:, success:, stdout:, stderr:, elapsed_seconds:, state:, reason: nil)
+        @member_name = member_name
+        @phase = "release_state"
+        @command = command
+        @workdir = workdir
+        @status = status
+        @success = success
+        @stdout = stdout
+        @stderr = stderr
+        @elapsed_seconds = elapsed_seconds
+        @skipped = false
+        @reason = reason
+        @state = state
+      end
+
+      def ok?
+        success
+      end
+
+      def to_h
+        {
+          "member" => member_name,
+          "phase" => phase,
+          "command" => command,
+          "workdir" => workdir,
+          "status" => status,
+          "success" => success,
+          "stdout" => stdout.to_s.lines.last(20).map(&:chomp).join("\n"),
+          "stderr" => stderr.to_s.lines.last(20).map(&:chomp).join("\n"),
+          "elapsed_seconds" => elapsed_seconds,
+          "skipped" => skipped,
+          "reason" => reason,
+          "release_state" => state
+        }
+      end
+    end
+  end
+end

data/lib/kettle/family/report.rb

@@ -65,6 +65,7 @@ module Kettle
 
       def append_results(lines)
         return if results.empty?
+        return append_release_state_results(lines) if command == "release-state"
 
         lines << "results:"
         results.each do |result|
@@ -81,6 +82,55 @@ module Kettle
         "failed"
       end
 
+      def append_release_state_results(lines)
+        lines << "release state:"
+        rows = [["gem", "version.rb", "latest released", "latest changelog", "unreleased", "prepared", "pending"]]
+        results.each do |result|
+          rows << release_state_row(result)
+        end
+        lines.concat(format_table(rows).map { |line| "  #{line}" })
+        failures = results.reject(&:ok?)
+        return if failures.empty?
+
+        lines << "release state errors:"
+        failures.each do |result|
+          lines << "  failed #{result.member_name} #{result.reason || ""}".rstrip
+          lines << "    #{result.stderr}" unless result.stderr.to_s.empty?
+        end
+      end
+
+      def release_state_row(result)
+        state = result.state || {}
+        [
+          state.fetch("gem_name", result.member_name).to_s,
+          state.fetch("version", "unknown").to_s,
+          state.fetch("latest_released", nil).to_s.empty? ? "unknown" : state.fetch("latest_released").to_s,
+          state.fetch("latest_changelog_version", nil).to_s.empty? ? "none" : state.fetch("latest_changelog_version").to_s,
+          yes_no(state.fetch("unreleased_entries", nil)),
+          yes_no(state.fetch("prepared_release_pending", nil)),
+          yes_no(state.fetch("pending_release", nil))
+        ]
+      end
+
+      def format_table(rows)
+        widths = rows.transpose.map { |column| column.map(&:length).max }
+        rows.flat_map.with_index do |row, index|
+          line = row.each_with_index.map { |value, i| value.ljust(widths.fetch(i)) }.join("  ").rstrip
+          index.zero? ? [line, widths.map { |width| "-" * width }.join("  ")] : [line]
+        end
+      end
+
+      def yes_no(value)
+        case value
+        when true
+          "yes"
+        when false
+          "no"
+        else
+          "unknown"
+        end
+      end
+
       def resume_hint
         failed = results.find { |result| !result.ok? }
         resume_hint_for(failed) if failed

data/lib/kettle/family/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Family
     module Version
-      VERSION = "0.1.0"
+      VERSION = "0.1.2"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

data/lib/kettle/family.rb

@@ -5,12 +5,14 @@ require "version_gem"
 require_relative "family/version"
 require_relative "family/member"
 require_relative "family/command_result"
+require_relative "family/release_state_result"
 require_relative "family/command_runner"
 require_relative "family/readiness_check"
 require_relative "family/changelog_check"
 require_relative "family/git_status"
 require_relative "family/version_bump"
 require_relative "family/branch_lane_audit"
+require_relative "family/release_state_check"
 require_relative "family/workflow"
 require_relative "family/config"
 require_relative "family/discovery"

data/sig/kettle/family.rbs

@@ -1,6 +1,5 @@
 module Kettle
   module Family
-    VERSION: String
     # See the writing guide of rbs: https://github.com/ruby/rbs#guides
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Peter H. Boling
@@ -80,7 +80,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.3
+        version: 2.2.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -90,7 +90,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.3
+        version: 2.2.7
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -148,7 +148,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.1
+        version: 3.1.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -158,7 +158,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.1
+        version: 3.1.2
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -294,6 +294,8 @@ files:
 - lib/kettle/family/member.rb
 - lib/kettle/family/orderer.rb
 - lib/kettle/family/readiness_check.rb
+- lib/kettle/family/release_state_check.rb
+- lib/kettle/family/release_state_result.rb
 - lib/kettle/family/report.rb
 - lib/kettle/family/selection.rb
 - lib/kettle/family/version.rb
@@ -306,10 +308,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-family.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v0.1.0
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v0.1.0/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v0.1.2
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v0.1.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/0.1.0
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/0.1.2
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-family/wiki
   news_uri: https://www.railsbling.com/tags/kettle-family