deployangel 0.1.38 → 0.1.40

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a0944295d3cbddf9d6ff41ce21ad608b3c9615dc2910bfed6ef9745ffde6e93
-  data.tar.gz: 7197967f339bb1af5057528e2b08b9e894379051401d059f02a91ec6cd3083ad
+  metadata.gz: 4e8adef48eb597e4b49551c9935dd0308a465ab3ad302de263ed47035293e15a
+  data.tar.gz: 98928fa20dfe57fc11b8f99b56ec2f9c33010c023de4a78f0fdffb59cdd29e65
 SHA512:
-  metadata.gz: 9fc73a15daea7553d4a04121c001a49feef7a15195b0313b1115ab572a387cc053bf80196d6c8d79baee8c980df2833c198cdf7a2e0dcdeda18d81235dd3c208
-  data.tar.gz: 4d5fe66f67476bd5c0e41137d6f3f38746d31da776ea295526e4becd463da21f61bf4d23a5d0ebfaac61df4c84d0d4692b67e49797d5e05a6cb63fa5e59a706f
+  metadata.gz: 37dd0621d760a588e12ea465902aefe678f6e9c171a15721d7ded7071af03e2e80996a8239e1f7fae4e7ca2583d647b73d403a3ef501d0dc4906499fae735c9c
+  data.tar.gz: d581a5108ccc9bdb4e2c13747ce556c4857a14275939aa0756d05e518da03933b76189aea11269d87fe78c6b9e7faa879c8bc0cd7f989175eeee7b1350e42ff3

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.1.40 (2026-11-04)
+
+- Rails apps get two checkpoints with nothing to add: `rails.mail.delivered`,
+  counted from Action Mailer's deliveries, and `rails.storage.stored`, from
+  Active Storage's uploads. A release after which mail or uploads quietly
+  stop fails for it, the way a checkpoint the app records would. Counts
+  only: never a recipient, a filename, or a key. Off with
+  `config.derived_checkpoints = false` or
+  `DEPLOYANGEL_DERIVED_CHECKPOINTS=false`.
+
+## 0.1.39 (2026-11-04)
+
+- `deployangel doctor` warns when the project's AGENTS.md or CLAUDE.md has
+  an older copy of the block `deployangel install agents` writes, and
+  `deployangel status` says so on stderr at the start of a session, where
+  a coding agent reads it. Running `deployangel install agents` updates
+  it. Hand-written instructions without the block's markers aren't
+  checked.
+
 ## 0.1.38 (2026-11-04)
 
 - `deployangel verify` shows a volume drop (servers from 2026-11-04) as

data/lib/deployangel/cli.rb

@@ -258,6 +258,7 @@ module DeployAngel
         output(document, options[:format]) { Formatter.verification(document) }
         step_summary(Formatter.markdown(document))
         @stderr.puts("deployangel: timed out; verification is still in progress") if outcome.timed_out
+        stale_instructions_note if status
         outcome.exit_code
       end
 
@@ -406,6 +407,15 @@ module DeployAngel
       # What this checkout will report and what DeployAngel has seen of the
       # app. Warnings are advice, so only errors (a rejected token, an
       # unreachable server, no agent in the bundle) fail it.
+      # At the start of a session (`status`), where an agent reads it and can
+      # update the instructions it's following.
+      def stale_instructions_note
+        stale = Doctor.stale_instructions(@root)
+        return if stale.empty?
+
+        @stderr.puts("deployangel: #{Doctor.stale_instructions_note(stale)}; run `deployangel install agents` to update")
+      end
+
       def doctor
         format = parse(format: nil) { |o, opts| o.on("--format=FORMAT", %w[text json]) { |v| opts[:format] = v } }[:format]
         doctor = Doctor.new(root: @root, client: doctor_client, env: @env)

data/lib/deployangel/configuration.rb

@@ -12,7 +12,7 @@ module DeployAngel
     attr_accessor :token, :endpoint, :enabled, :environments, :release_version, :revision,
       :flush_interval, :open_timeout, :read_timeout, :max_queued_payloads, :max_routes, :logger,
       :file_digests, :critical_flows, :ignored_routes, :sidekiq_cron_schedule_file, :exception_messages,
-      :recurring_jobs
+      :recurring_jobs, :derived_checkpoints
 
     def initialize(env = ENV)
       @token = env["DEPLOYANGEL_TOKEN"]
@@ -43,6 +43,9 @@ module DeployAngel
       # cron line or Fugit's words ("every day at 4am"), optionally ending
       # in a time zone.
       @recurring_jobs = {}
+      # Checkpoints counted from Rails' own notifications, with nothing to
+      # add: mail delivered and files stored (DeployAngel::Rails::Checkpoints).
+      @derived_checkpoints = parse_boolean(env["DEPLOYANGEL_DERIVED_CHECKPOINTS"]) != false
     end
 
     # Reports only with a token, and by default in every environment but

data/lib/deployangel/doctor.rb

@@ -36,10 +36,29 @@ module DeployAngel
     def checks
       @checks ||= begin
         @setup, server = server_checks
-        [ *agent_checks, here_check, schedule_check, *server, release_check, *comparison_checks ].compact
+        [ *agent_checks, here_check, schedule_check, *server, release_check, *comparison_checks, instructions_check ].compact
       end
     end
 
+    # Files whose DeployAngel block (between the markers `deployangel install
+    # agents` writes) differs from this version's: agents keep following the
+    # older copy until it's updated. Hand-written instructions without the
+    # markers aren't checked.
+    def self.stale_instructions(root)
+      block = /#{Regexp.escape(CLI::AGENTS_START)}.*?#{Regexp.escape(CLI::AGENTS_END)}/m
+      %w[AGENTS.md CLAUDE.md].select do |name|
+        path = File.join(root, name)
+        found = File.file?(path) && File.read(path)[block]
+        found && found != CLI::AGENT_INSTRUCTIONS.chomp
+      end
+    rescue SystemCallError
+      []
+    end
+
+    def self.stale_instructions_note(files)
+      "#{files.join(" and ")} #{files.one? ? "has" : "have"} an older copy of DeployAngel's agent instructions"
+    end
+
     def failed?
       checks.any? { |check| check.status == :error }
     end
@@ -57,6 +76,14 @@ module DeployAngel
         [ Check.new(status: :error, message: "The agent isn't in the bundle", fix: "Add gem \"deployangel\" to the Gemfile and run bundle install.") ]
       end
 
+      def instructions_check
+        stale = self.class.stale_instructions(@root)
+        return if stale.empty?
+
+        Check.new(status: :warn, message: self.class.stale_instructions_note(stale),
+          fix: "Run deployangel install agents to update #{stale.one? ? "it" : "them"}.")
+      end
+
       def schedule_check
         counts = local_schedules.group_by { |schedule| schedule["source"] }.map { |source, list| "#{SOURCES.fetch(source, source)} #{list.size}" }
         later = [ ("GoodJob's cron" if read("Gemfile.lock").to_s.include?(" good_job (")), "config.recurring_jobs" ].compact

data/lib/deployangel/rails/checkpoints.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module DeployAngel
+  module Rails
+    # Checkpoints the app gets without adding a line (spec §17, Silent
+    # failures): mail delivered and files stored, counted from Rails' own
+    # notifications. Work that quietly stops is what verdicts miss most, and
+    # these two are where it most often stops. Counts only, never a
+    # recipient, a filename, or a key. Off with config.derived_checkpoints =
+    # false, or DEPLOYANGEL_DERIVED_CHECKPOINTS=false.
+    module Checkpoints
+      MAIL_DELIVERED = "rails.mail.delivered"
+      FILE_STORED = "rails.storage.stored"
+
+      def self.install
+        return if @installed
+
+        @installed = true
+        ::ActiveSupport::Notifications.subscribe("deliver.action_mailer") { DeployAngel.checkpoint(MAIL_DELIVERED) }
+        ::ActiveSupport::Notifications.subscribe("service_upload.active_storage") { DeployAngel.checkpoint(FILE_STORED) }
+      end
+    end
+  end
+end

data/lib/deployangel/rails/railtie.rb

@@ -9,6 +9,10 @@ module DeployAngel
         app.config.middleware.insert(0, DeployAngel::Rails::Http)
       end
 
+      initializer "deployangel.checkpoints" do
+        DeployAngel::Rails::Checkpoints.install if DeployAngel.configuration.derived_checkpoints
+      end
+
       initializer "deployangel.jobs" do
         ActiveSupport.on_load(:active_job) { DeployAngel::Rails::ActiveJob.install }
         DeployAngel::Sidekiq.install

data/lib/deployangel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DeployAngel
-  VERSION = "0.1.38"
+  VERSION = "0.1.40"
 end

data/lib/deployangel.rb

@@ -133,6 +133,7 @@ end
 require_relative "deployangel/rack/http"
 require_relative "deployangel/rails/http"
 require_relative "deployangel/rails/active_job"
+require_relative "deployangel/rails/checkpoints"
 require_relative "deployangel/rails/error_subscriber"
 require_relative "deployangel/tasks"
 require_relative "deployangel/metadata"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: deployangel
 version: !ruby/object:Gem::Version
-  version: 0.1.38
+  version: 0.1.40
 platform: ruby
 authors:
 - Jordan Owens
@@ -60,6 +60,7 @@ files:
 - lib/deployangel/queue_backlog.rb
 - lib/deployangel/rack/http.rb
 - lib/deployangel/rails/active_job.rb
+- lib/deployangel/rails/checkpoints.rb
 - lib/deployangel/rails/error_subscriber.rb
 - lib/deployangel/rails/http.rb
 - lib/deployangel/rails/metadata.rb