discharger 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 487fc4990548d3bae797d7538d41363f6c02064c1e0682ff3ef11bdeac4de7de
-  data.tar.gz: 7125f6b47e9fea4e457d418fcda09ef12045ed72c5c96200b4d1887ae832a658
+  metadata.gz: 22ff9b0cc383ea213a6a8766f713ef4afa97a114c679c76b37954f73872b74e3
+  data.tar.gz: a3cfa43c5c9665704e13bce7a3bb19e36ccd4810b700b149a2646815fcca9f6a
 SHA512:
-  metadata.gz: 5e485c19d5c6285108dad2f14172b818046edcc4cec7fd9a3e5936c76e2a76df65fb4db0729b9862fc9f6e6ebb0750cb18f1fb23080920321438e19078626d5b
-  data.tar.gz: 61431222b20ebd419407d1db9d2f969df34993cbdbce465c302d26bd80081aabacda5085f85e5e2aae758c23641f31124c2c9edbce1ff9ff733a9e5b014dbb73
+  metadata.gz: 0e01ea39ed9eba5c973951784d44b5488a1f6f00effc59a1192d5f1f3cfd2aafbe14895a1d6ce920520acb7c501bc79720febc7360bed35a301c742ab30728ad
+  data.tar.gz: 309f1fd0b7ea3d78814aedd8c8bb945e0c63806260007dc8391126863254d4f19d87adc0e9ec7cdd584c3173982fd69465e87c06a13a97f90870aa60d93b2f6d

data/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.3.3] - 2026-07-22
+
+### Added
+
+- Post-release runbook announcement in the Slack release thread, from Reissue's runbook_file (0cf9620)
+
 ## [0.3.2] - 2026-07-15
 
 ### Changed
@@ -15,9 +21,3 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 - Retry `brew bundle` once before failing setup, so transient Homebrew lock contention (e.g. two `bin/setup` runs on the same host) doesn't hard-fail the whole run.
 - pg-tools wrappers no longer forward localhost -h/-p flags into docker exec, where the host-mapped port doesn't exist; remote hosts still pass through untouched (a3869d2)
-
-## [0.3.1] - 2026-05-13
-
-### Added
-
-- database.prefer_docker setup.yml option for explicit Docker vs native PostgreSQL selection (2fca81e)

data/README.md

@@ -89,6 +89,51 @@ changelog.d/
 
 Each fragment file should contain the changelog entry for a specific change or feature.
 
+### Post-release Runbook
+
+Some releases need manual follow-up: run a rake task, backfill data, re-index documents.
+Reissue collects those steps from `Runbook:` commit trailers, and Discharger announces
+them to your team in the release thread.
+
+```ruby
+Discharger::Task.create do |task|
+  # ... other configuration ...
+  task.runbook_file = "RUNBOOK.md"  # Default: nil (disabled)
+end
+```
+
+Add steps as you work, in the same commit as the change that requires them:
+
+```bash
+git commit -m "Add data migration
+
+Fixed: Duplicate user records
+Runbook: Run \`rake data:cleanup\` after deploy"
+```
+
+`rake release:prepare` finalizes the runbook alongside the changelog, so the release tag
+records exactly which steps that version needs. After the production release, Discharger
+posts the checklist to Slack as a reply in the release thread, right after the changelog:
+
+```
+*Post-release runbook for 1.2.3* — 2 steps
+
+• Run `rake data:cleanup` (abc1234)
+• Re-index search documents (def5678)
+```
+
+When a release needs no follow-up, the thread says so explicitly rather than staying
+silent, so nobody has to wonder whether the check was skipped:
+
+```
+*Post-release runbook for 1.2.3*
+No runbook tasks for this release.
+```
+
+Leave `runbook_file` unset and Discharger posts nothing extra. See the
+[Reissue runbook documentation](https://github.com/SOFware/reissue#post-release-runbook)
+for how items are collected and merged.
+
 ## Available Tasks
 
 The gem creates several Rake tasks for managing your deployment workflow:

data/lib/discharger/task.rb

@@ -24,6 +24,7 @@ module Discharger
         reissue.fragment = task.fragment
         reissue.clear_fragments = task.clear_fragments
         reissue.tag_pattern = task.tag_pattern
+        reissue.runbook_file = task.runbook_file
       end
       task.define
       task
@@ -179,6 +180,27 @@ module Discharger
       stdout.strip
     end
 
+    # The post-release steps collected from "Runbook:" commit trailers.
+    # Empty when no runbook is configured or the file has yet to be written.
+    def runbook_items
+      return [] unless runbook_file
+
+      Reissue::Runbook.new(Rails.root.join(runbook_file).to_s).items
+    end
+
+    # Build the Slack message listing the post-release steps for a version.
+    # Returns nil when the project does not use a runbook, which is distinct
+    # from a configured runbook that happens to have no steps this release.
+    def runbook_announcement(version, items = runbook_items)
+      return nil unless runbook_file
+
+      header = "*Post-release runbook for #{version}*"
+      return "#{header}\nNo runbook tasks for this release." if items.empty?
+
+      "#{header} — #{items.size} step#{"s" unless items.size == 1}\n\n" +
+        items.map { |item| "• #{item}" }.join("\n")
+    end
+
     def existing_pr_number(base, head)
       stdout, _, status = Open3.capture3(
         "gh", "pr", "list",
@@ -286,10 +308,17 @@ module Discharger
           ["git push origin v#{current_version}"]
         ) do
           tasker["#{name}:slack"].invoke("Released #{app_name} #{current_version} (#{commit_identifier.call}) to production.", release_message_channel, ":chipmunk:")
-          if last_message_ts.present?
+          # Capture the root before replying; each post overwrites last_message_ts.
+          thread_ts = last_message_ts
+          if thread_ts.present?
             text = File.read(Rails.root.join(changelog_file))
             tasker["#{name}:slack"].reenable
-            tasker["#{name}:slack"].invoke(text, release_message_channel, ":log:", last_message_ts)
+            tasker["#{name}:slack"].invoke(text, release_message_channel, ":log:", thread_ts)
+
+            if (runbook_message = runbook_announcement(current_version))
+              tasker["#{name}:slack"].reenable
+              tasker["#{name}:slack"].invoke(runbook_message, release_message_channel, ":clipboard:", thread_ts)
+            end
           end
           # Signal success — no branch switch needed since we stay on working_branch throughout
           true

data/lib/discharger/version.rb

@@ -1,3 +1,3 @@
 module Discharger
-  VERSION = "0.3.2"
+  VERSION = "0.3.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: discharger
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - Jim Gay
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.5'
 - !ruby/object:Gem::Dependency
   name: slack-ruby-client
   requirement: !ruby/object:Gem::Requirement