kettle-gha-pins 0.3.8 → 0.3.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0a1c43269ba88dfec876d3107fb7883511cbcec7456353a8e239d74071d0d94e
-  data.tar.gz: 7499e3b722b86736e91a8a1dfde9ea53ab4f261428e5ec6816a83db73f428ece
+  metadata.gz: 40a359f61e73b1b17ee62829c001c9690844f8ccfb944b776ecb21cbd402b382
+  data.tar.gz: c5f15b58492474aefb12423903e34e3b4107f8e01dc92d964a0f0ad9c8320408
 SHA512:
-  metadata.gz: d05a9abcb27812e5db10f60e44e3eb9b2e40cd9747476078a22008dab208a578ed816a93255093255ee86f24ccb5856f2ae1fda212659cd97f005d12a5b6bbfb
-  data.tar.gz: 06bf550cb1113a1acb1363307d6dc4faa902c8d283aae15ecdfffaba658b9391d09606cb8005bb6071a30031bcd72b3046aae3674f2b359789793b78c2e82f59
+  metadata.gz: 786283e4de7a16524b78e7c30552a8622465d559df4edeb8cbfd1808dda7c3cd7c5ad730c19f5d3c35cc328c11cb9829f0fc056f531e787997961bb442ee97ca
+  data.tar.gz: c8d901235c8b8ebb5e9aae9fa0918a58965abdd1a61f612a76985df9068ddfa5aaac871e7ace466a2732a0a03821cb3352be232641e692283c4083287b8b4beb

data/CHANGELOG.md

@@ -30,6 +30,17 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [0.3.9] - 2026-08-05
+
+- TAG: [v0.3.9][0.3.9t]
+- COVERAGE: 98.36% -- 961/977 lines in 8 files
+- BRANCH COVERAGE: 89.95% -- 394/438 branches in 8 files
+- 25.71% documented
+
+### Fixed
+
+- Emit NDJSON progress events for family orchestration without replaying the full human report.
+
 ## [0.3.8] - 2026-08-05
 
 - TAG: [v0.3.8][0.3.8t]
@@ -271,7 +282,9 @@ Please file a bug if you notice a violation of semantic versioning.
 - kettle-jem-template-20260720-005 - Generated README Support & Community rows
   now include a RubyForum help badge.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-gha-pins/compare/v0.3.8...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-gha-pins/compare/v0.3.9...HEAD
+[0.3.9]: https://github.com/kettle-dev/kettle-gha-pins/compare/v0.3.8...v0.3.9
+[0.3.9t]: https://github.com/kettle-dev/kettle-gha-pins/releases/tag/v0.3.9
 [0.3.8]: https://github.com/kettle-dev/kettle-gha-pins/compare/v0.3.7...v0.3.8
 [0.3.8t]: https://github.com/kettle-dev/kettle-gha-pins/releases/tag/v0.3.8
 [0.3.7]: https://github.com/kettle-dev/kettle-gha-pins/compare/v0.3.6...v0.3.7

data/README.md

@@ -563,7 +563,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.961-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.977-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-gha-pins/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/gha/pins/cli.rb

@@ -59,6 +59,7 @@ module Kettle
             dry_run: true,
             token: ENV["GITHUB_TOKEN"] || ENV["GH_TOKEN"],
             json: false,
+            events: false,
             validate: true,
             write: false,
             check: false,
@@ -104,8 +105,10 @@ module Kettle
           }
 
           progress_message("Discovering workflow files under #{display_path(@options[:root])}...")
+          emit_event("start", root: @options[:root])
           workflow_files = discover_workflow_files(@options[:root], @options[:reject_patterns])
           progress_message("Discovered #{workflow_files.length} workflow file(s).")
+          emit_event("workflows", total: workflow_files.length)
 
           workflows = load_workflows(workflow_files, state)
           action_count = workflows.sum { |workflow| workflow[:uses_nodes].count { |node| classify_action_ref(node[:value].to_s) } }
@@ -119,6 +122,7 @@ module Kettle
           )
           action_plan_cache = {}
 
+          completed_actions = 0
           workflows.each do |workflow|
             path = workflow.fetch(:path)
             text = workflow.fetch(:text)
@@ -134,6 +138,7 @@ module Kettle
                 action = parsed_ref[:action]
                 repo_ref = "#{action[:owner]}/#{action[:repo]}"
                 old_ref = action[:ref]
+                cached_before = action_plan_cache.key?(repo_ref)
                 upgrade_plan = resolve_action_plan(
                   cache: action_plan_cache,
                   client: client,
@@ -141,6 +146,16 @@ module Kettle
                   repo_ref: repo_ref,
                   old_ref: old_ref
                 )
+                completed_actions += 1
+                emit_event(
+                  "action",
+                  action_ref: repo_ref,
+                  path: path,
+                  line: node[:line] + 1,
+                  completed: completed_actions,
+                  total: action_count,
+                  cache: (cached_before || (client.respond_to?(:last_versions_cache_hit) && client.last_versions_cache_hit)) ? "hit" : "miss"
+                )
 
                 updates = nil
                 if upgrade_plan[:updates]
@@ -261,6 +276,15 @@ module Kettle
           end
           action_progress.stop
           progress_message("Action resolution checks: #{action_progress.cached_count} cached, #{action_progress.live_count} live.") if action_count.positive?
+          emit_event(
+            "summary",
+            files_scanned: state[:files_scanned],
+            changed_files: state[:changed_files].length,
+            updates: state[:updates],
+            failures: state[:failures],
+            cached: action_progress.cached_count,
+            live: action_progress.live_count
+          )
 
           print_report(state)
           return 2 unless state[:failures].zero?
@@ -310,6 +334,9 @@ module Kettle
             opt.on("--json", "Emit JSON report") do
               @options[:json] = true
             end
+            opt.on("--events", "Emit line-delimited JSON events") do
+              @options[:events] = true
+            end
             opt.on("--[no-]progress", "Show progress feedback on STDERR (default: on unless --json)") do |bool|
               @options[:progress] = bool
             end
@@ -384,7 +411,13 @@ module Kettle
         def progress_enabled?
           return @options[:progress] unless @options[:progress].nil?
 
-          !@options[:json]
+          !@options[:json] && !@options[:events]
+        end
+
+        def emit_event(action, payload = {})
+          return unless @options[:events]
+
+          puts JSON.generate({"event_version" => 1, "type" => "gha_sha_pins_#{action}", "action" => action}.merge(payload))
         end
 
         def progress_message(message)
@@ -858,8 +891,12 @@ module Kettle
             lines << "Recommended fix: kettle-gha-pins --write --upgrade #{@options[:upgrade]}"
           end
 
-          puts lines.join("
-")
+          output = lines.join("\n")
+          if @options[:events]
+            @err.puts output
+          else
+            puts output
+          end
         end
       end
     end

data/lib/kettle/gha/pins/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-gha-pins
 version: !ruby/object:Gem::Version
-  version: 0.3.8
+  version: 0.3.9
 platform: ruby
 authors:
 - Peter H. Boling
@@ -301,10 +301,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/kettle-dev/kettle-gha-pins
-  source_code_uri: https://github.com/kettle-dev/kettle-gha-pins/tree/v0.3.8
-  changelog_uri: https://github.com/kettle-dev/kettle-gha-pins/blob/v0.3.8/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-gha-pins/tree/v0.3.9
+  changelog_uri: https://github.com/kettle-dev/kettle-gha-pins/blob/v0.3.9/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-gha-pins/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-gha-pins/0.3.8
+  documentation_uri: https://www.rubydoc.info/gems/kettle-gha-pins/0.3.9
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-gha-pins/wiki
   news_uri: https://www.railsbling.com/tags/kettle-gha-pins