deployangel 0.1.38 → 0.1.39

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a0944295d3cbddf9d6ff41ce21ad608b3c9615dc2910bfed6ef9745ffde6e93
-  data.tar.gz: 7197967f339bb1af5057528e2b08b9e894379051401d059f02a91ec6cd3083ad
+  metadata.gz: d930ff0701b6c48f6793339eaff985418ae4a6b0332689e7c87d85047f80a082
+  data.tar.gz: a1848b93327d98249e6bd98acf595047b62b926604c9940ed92f17334db3b093
 SHA512:
-  metadata.gz: 9fc73a15daea7553d4a04121c001a49feef7a15195b0313b1115ab572a387cc053bf80196d6c8d79baee8c980df2833c198cdf7a2e0dcdeda18d81235dd3c208
-  data.tar.gz: 4d5fe66f67476bd5c0e41137d6f3f38746d31da776ea295526e4becd463da21f61bf4d23a5d0ebfaac61df4c84d0d4692b67e49797d5e05a6cb63fa5e59a706f
+  metadata.gz: '00943ef2bac8f6acb697ec20243c211b96779b4eb33dc8c4da1aff53cd789b14ca569320fa06d960de7811a0dd15e4aacab06e6656f4ffe1240a8b63cf1467eb'
+  data.tar.gz: 9e8ede3e14497f6afaf02b08f0438876397ee73b95f7ba79bbff8d43dc84ad69e018e0bffb903ce722458b1a5df48c2eb372580c034699a00315f09335a92235

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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/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/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: deployangel
 version: !ruby/object:Gem::Version
-  version: 0.1.38
+  version: 0.1.39
 platform: ruby
 authors:
 - Jordan Owens