deployangel 0.1.33 → 0.1.35

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb68d7ed3170cb16932b6ab0de9304c4388e9df001067cf6c0b6678e92fae0d1
-  data.tar.gz: dc867b57741dc75e868284fd8a1f30450d756306fcb891f66331538dacf3486f
+  metadata.gz: 275f765f13eee93ddc36007727d1f2278b343a524562c062eeab1a258f8abb16
+  data.tar.gz: f167ad720f710b5cf3a527632795972a5dbbe972309bbbf470a937425d0282e7
 SHA512:
-  metadata.gz: 8427f099ce309a80180e0dbb3033e465e4d82c8ad6f0f72c803623594feb6b9a831a16e7ec25c21e866c792d0acfa50d39f453eb17b2d282f32bd765f8133be4
-  data.tar.gz: 4c19dc7ec0a6730724a466dc51b91f99bddf073b9dc3af480a584ee62417a7637543f64f8f9d4784be176416067162ad79200031e22ed180eb30c70da7ec7072
+  metadata.gz: cdd30481a4d28645ef05f5d570f253d73029258581743045677e5a7e1c19a395b28082656aa44f588eac2c8be074b01a93240102143a822d166fa250325efd93
+  data.tar.gz: 5190303791d16fb83affbed23cd01e5b20c1b28a245f94824ee9f01670ec454a9b6c9696d632cabc3ce7c0990da8d0809adb14b7c3eddeda7aa8a5ec077f7f54

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.1.35 (2026-11-01)
+
+- `deployangel exercise` prints each route's status codes (`404 ×1`)
+  instead of their class (`1 4xx`). When every page answers 404, 405, or
+  410, as when `--url` is the app's marketing site rather than its own
+  host, it says so, records nothing on the release, and exits 5.
+
+## 0.1.34 (2026-11-01)
+
+- `deployangel verify` prints a failed release's next steps: the last
+  cleared release a rollback would go to, with the migrations it would
+  cross, and where to look first. They come from the verdict document's new
+  `next_steps` field, so servers before 2026-11-01 show none. The coding
+  agent instructions mention them, and still say to ask before rolling back.
+
 ## 0.1.33 (2026-10-28)
 
 - An exception whose message has bytes that aren't valid UTF-8, as a

data/README.md

@@ -603,8 +603,10 @@ requests, about 5 a second, as `DeployAngel-Exercise`), then records what it
 sent on the release, where the page lists it under "Exercised from your
 side". It skips and names routes that change data or need a path
 parameter, and stops requesting a page after its first 404, sending its
-share to the pages that answered. A "CLI & coding agents" token can run
-it. `--dry-run` shows what it would send.
+share to the pages that answered. It prints each route's status codes. If
+every page answers 404, 405, or 410, it records nothing and exits 5, since
+the URL is probably not the app's own host (a marketing site, say). A "CLI
+& coding agents" token can run it. `--dry-run` shows what it would send.
 
 ### Suggested instructions for your coding agent
 
@@ -629,7 +631,8 @@ verdict: call the `wait_for_verification` MCP tool with the commit and
   The release is NOT cleared.
 - Exit 2 / inconclusive: the release is NOT verified. Do not claim success.
 - Exit 1 / failed: read the findings and exceptions (`get_exception`),
-  investigate the likely cause, and propose a fix. Do not roll back or change
+  investigate the likely cause, and propose a fix. `next_steps` names the last
+  cleared release a rollback would go to. Do not roll back or change
   production without explicit approval.
 - Exit 3: still verifying; run the command again.
 - Not cleared yet: call `get_exercise_plan` (or `bundle exec deployangel plan`).

data/lib/deployangel/cli/formatter.rb

@@ -110,7 +110,10 @@ module DeployAngel
           end ],
           [ "Changed but not yet exercised", changed.map { |item| item["key"] } ],
           [ "To clear sooner, exercise (deployangel plan for details)", exercisable_items(document).first(5) ],
-          [ "Late regressions", Array(document["late_regressions"]).map { |late| late["summary"] } ]
+          [ "Late regressions", Array(document["late_regressions"]).map { |late| late["summary"] } ],
+          # A failed release's rollback target and where to look first
+          # (servers from 2026-11-01 send them).
+          [ "Next steps", Array(document["next_steps"]).map { |step| step["text"] } ]
         ].reject { |_, items| items.empty? }
       end
 

data/lib/deployangel/cli.rb

@@ -108,7 +108,8 @@ module DeployAngel
         The release is NOT cleared.
       - Exit 2 / inconclusive: the release is NOT verified. Do not claim success.
       - Exit 1 / failed: read the findings and exceptions (`get_exception`),
-        investigate the likely cause, and propose a fix. Do not roll back or change
+        investigate the likely cause, and propose a fix. `next_steps` names the last
+        cleared release a rollback would go to. Do not roll back or change
         production without explicit approval.
       - Exit 3: still verifying; run the command again.
       - Not cleared yet: call `get_exercise_plan` (or `bundle exec deployangel plan`).
@@ -318,9 +319,18 @@ module DeployAngel
 
         result = exerciser.run(plan)
         @stdout.puts("Sent #{result.sent} requests to #{options[:url]}:",
-          *result.routes.map { |r| "  #{r["key"]} ×#{r["requests"]}: #{r["statuses"].map { |kind, n| "#{n} #{kind}" }.join(", ")}" })
+          *result.routes.map { |r| "  #{r["key"]} ×#{r["requests"]}: #{status_codes(result.codes[r["key"]])}" })
         @stdout.puts("Skipped:", *result.skipped.map { |s| "  #{s["key"]} (#{s["reason"]})" }) if result.skipped.any?
         @stdout.puts("Stopped early: #{options[:url]} isn't answering.") if result.unreachable
+        # Requests that reached no page aren't worth recording: the app
+        # likely never saw them.
+        if result.routes.any? && result.nothing_served? && !result.unreachable
+          @stdout.puts("", "No page answered at #{options[:url]}: every route said it doesn't exist. Is that the app's own host, " \
+            "and not a marketing site or a different domain? Pass the URL where the app's pages load.")
+          @stdout.puts("#{result.unsent} more requests weren't sent, since no route answered.") if result.unsent.positive?
+          @stdout.puts("Nothing was recorded on the release.")
+          return USAGE_ERROR
+        end
         if result.routes.any?
           client.record_exercise(document.dig("deployment", "id"), routes: result.routes, skipped: result.skipped, ran_at: @clock.call.utc.iso8601)
           @stdout.puts("Recorded on the release. Wait for the verdict with: deployangel verify --wait")
@@ -328,6 +338,11 @@ module DeployAngel
         result.unreachable ? USAGE_ERROR : 0
       end
 
+      # "200 ×4, 500 ×1", in the order they came.
+      def status_codes(codes)
+        codes.map { |code, n| "#{code || "no answer"} ×#{n}" }.join(", ")
+      end
+
       def exception
         fingerprint = @argv.shift or return usage_error("exception needs a FINGERPRINT")
         format = parse(format: nil) { |o, opts| o.on("--format=FORMAT", %w[text json]) { |v| opts[:format] = v } }[:format]

data/lib/deployangel/exerciser.rb

@@ -23,7 +23,18 @@ module DeployAngel
     PARAMETER = /\/[:*{<]/
 
     Target = Struct.new(:key, :path, :count)
-    Result = Struct.new(:routes, :skipped, :sent, :unreachable, keyword_init: true)
+    # codes: each route's exact status codes, nil for no answer, for
+    # display; routes carries status classes, which is what's recorded.
+    # unsent: requests the plan wanted that went nowhere, since no route
+    # answered.
+    Result = Struct.new(:routes, :skipped, :sent, :unreachable, :codes, :unsent, keyword_init: true) do
+      # Every answer said the page isn't served. Usually the wrong host,
+      # like the app's marketing site.
+      def nothing_served?
+        answers = codes.values.flat_map(&:keys)
+        answers.any? && answers.all? { |code| NOT_SERVED.include?(code) }
+      end
+    end
 
     def initialize(base_url:, max_requests: MAX_REQUESTS, sleeper: ->(seconds) { sleep(seconds) }, requester: nil)
       @base = URI(base_url)
@@ -59,6 +70,7 @@ module DeployAngel
     def run(exercise_plan)
       targets, skipped = plan(exercise_plan)
       @statuses = Hash.new { |hash, key| hash[key] = Hash.new(0) }
+      @codes = Hash.new { |hash, key| hash[key] = Hash.new(0) }
       @sent = 0
       @errors_in_a_row = 0
       leftover = 0
@@ -76,12 +88,14 @@ module DeployAngel
         answered << target if @statuses[target.key].keys.intersect?(%w[2xx 3xx])
       end
       leftover.times { |i| send_request(answered[i % answered.size]) unless unreachable? } if answered.any?
+      unsent = answered.empty? ? leftover : 0
 
       routes = targets.filter_map do |target|
         statuses = @statuses.fetch(target.key, nil) or next
         { "key" => target.key, "requests" => statuses.values.sum, "statuses" => statuses.to_h }
       end
-      Result.new(routes: routes, skipped: skipped, sent: @sent, unreachable: unreachable?)
+      Result.new(routes: routes, skipped: skipped, sent: @sent, unreachable: unreachable?,
+        codes: routes.to_h { |route| [ route["key"], @codes[route["key"]].to_h ] }, unsent: unsent)
     end
 
     def url_for(path)
@@ -98,6 +112,7 @@ module DeployAngel
         @sent += 1
         kind = status ? "#{status / 100}xx" : "error"
         @statuses[target.key][kind] += 1
+        @codes[target.key][status] += 1
         @errors_in_a_row = kind == "error" ? @errors_in_a_row + 1 : 0
         status
       end

data/lib/deployangel/mcp.rb

@@ -18,7 +18,8 @@ module DeployAngel
         DeployAngel verifies deployments in production. After deploying, call wait_for_verification
         with until "initial" (about 15 minutes) or "verdict". Verdicts: verified means cleared, so you may
         report the release as successful. inconclusive means NOT verified: never report it as success.
-        failed means production regressed: read the findings and exceptions and investigate.
+        failed means production regressed: read the findings and exceptions and investigate. next_steps
+        names the last cleared release a rollback would go to and the migrations it would cross.
         Confidence medium clears a release just as high does (high also needs 80% coverage and a full
         baseline): never call a medium clearance weak. suspicious true means warnings DeployAngel is
         watching closely, not a failure: report them as "watching closely:" and the watching_closely items,

data/lib/deployangel/version.rb

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

metadata

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