discharger 0.3.2 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 487fc4990548d3bae797d7538d41363f6c02064c1e0682ff3ef11bdeac4de7de
-  data.tar.gz: 7125f6b47e9fea4e457d418fcda09ef12045ed72c5c96200b4d1887ae832a658
+  metadata.gz: 25a6ab71ff65d9ada8fe82ce0a706b08d335aaa533b10c1b57a652434149cd91
+  data.tar.gz: 524b68d60300a017c7d83bc7162f1962819b44f1be1255ec1fd8651b47740374
 SHA512:
-  metadata.gz: 5e485c19d5c6285108dad2f14172b818046edcc4cec7fd9a3e5936c76e2a76df65fb4db0729b9862fc9f6e6ebb0750cb18f1fb23080920321438e19078626d5b
-  data.tar.gz: 61431222b20ebd419407d1db9d2f969df34993cbdbce465c302d26bd80081aabacda5085f85e5e2aae758c23641f31124c2c9edbce1ff9ff733a9e5b014dbb73
+  metadata.gz: 7b67aaf1127f81ca25f3f4f78ce3fc5884920048baa022128b46dfa24e4ab01dee3b4574894d7e3305026cdfc7eb4659351b3cf649dc509e2d8c76982207bf01
+  data.tar.gz: 894a03d8fd806db6d0c831a1c47191332aa5cae0ab02fdf7709a040cab2e50f9e8a2ee02030d6e5015bfe2ab03d8a5e7ae806d6e79e9f0fe3f020a8f2cdc8a75

data/CHANGELOG.md

@@ -5,19 +5,14 @@ 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.2] - 2026-07-15
+## [0.3.4] - 2026-07-22
 
-### Changed
-
-- Treat generated pg_tools setup as opt-in for apps that use structure.sql or PostgreSQL CLI workflows.
-
-### Fixed
+### Added
 
-- 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)
+- Runbook announcement on stage builds, previewing post-release steps before production (c77b552)
 
-## [0.3.1] - 2026-05-13
+## [0.3.3] - 2026-07-22
 
 ### Added
 
-- database.prefer_docker setup.yml option for explicit Docker vs native PostgreSQL selection (2fca81e)
+- Post-release runbook announcement in the Slack release thread, from Reissue's runbook_file (0cf9620)

data/README.md

@@ -89,6 +89,56 @@ 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. Discharger posts the checklist to Slack as
+a reply in the deploy thread — both on the stage build (`rake release:build` /
+`rake release:stage`, threaded under "Building…") and after the production release
+(threaded under the release announcement, right after the changelog):
+
+```
+*Post-release runbook for 1.2.3* — 2 steps
+
+• Run `rake data:cleanup` (abc1234)
+• Re-index search documents (def5678)
+```
+
+Staging shows the steps as a preview so the team sees what production will need before it
+happens; the production thread repeats them when the release actually lands.
+
+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,40 @@ 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
+
+    # Post the runbook as a reply in a Slack thread, when a runbook is
+    # configured. Reuses the same message on the stage build and the
+    # production release. Returns the message posted, or nil when there is
+    # no thread to reply to or no runbook to announce.
+    def post_runbook_to_thread(version, thread_ts)
+      return unless thread_ts.present?
+      return unless (message = runbook_announcement(version))
+
+      tasker["#{name}:slack"].reenable
+      tasker["#{name}:slack"].invoke(message, release_message_channel, ":clipboard:", thread_ts)
+      message
+    end
+
     def existing_pr_number(base, head)
       stdout, _, status = Open3.capture3(
         "gh", "pr", "list",
@@ -286,10 +321,14 @@ 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)
+
+            post_runbook_to_thread(current_version, thread_ts)
           end
           # Signal success — no branch switch needed since we stay on working_branch throughout
           true
@@ -356,6 +395,7 @@ module Discharger
           ) do
             current_version = Object.const_get(version_constant)
             tasker["#{name}:slack"].invoke("Building #{app_name} #{current_version} (#{commit_identifier.call}) on #{staging_branch}.", release_message_channel)
+            post_runbook_to_thread(current_version, last_message_ts)
             syscall ["git checkout #{build_branch}"]
           end
         end

data/lib/discharger/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: discharger
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.4
 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