deployangel 0.1.12 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3835d3c334a91d9ad7a75a3247ede4797a27e207b123f684bc1563fffd33cb0
-  data.tar.gz: c578f30dc3f828dabce95b7c4e48682b1248d306b0982d50483f17d3c3cf57c8
+  metadata.gz: ff074e43a43cb39394f9c21d99c1c004c55f68ac7c5a54467acc49b4f0ce1753
+  data.tar.gz: 57f860c0f680e70f46f12756f3f638307cb13ec6aa4131e5ebaac0e1cfe16494
 SHA512:
-  metadata.gz: 5a8e5b23a9d1a06732add016e3d31e813d08a10afc13016408c26944112098948476cfe51d7c39c60710c9f411cf6d0af01d145a4bd0a125ebcc90728d06b695
-  data.tar.gz: 7dea64425c2cd98cda899277a2561d67dde2d0871e38156c9efad654769fdcb6198ab94089d56fad0d72c7e15e48300d5b40d5018851491c6378043b435bb470
+  metadata.gz: 10d7c45fac648fedae41d360d845b3f874be6026bd331e77d063eaf65a036b4f0ba616a0c74df6e18ede073df87789fee71ac84910902d8456306c2ccb3bb0af
+  data.tar.gz: b68c68f332fe45d48be53f3d47e0b5c8bd41b012adf9deb6fc654e4ba9489ed20c3b4b790f6a860723f962ea8774b11082f0a1ce4f0c2f74bb9379b55d0937bf

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.14 (2026-10-06)
+
+- `deployangel plan` separates what clearance waits on ("Needed to clear")
+  from changed and rarely used paths that are only worth running, and
+  `deployangel verify` and the GitHub Actions job summary list only what's
+  needed. The MCP tool `get_exercise_plan` describes the server's new
+  `needed` flag on each item.
+
+## 0.1.13 (2026-10-06)
+
+- The MCP tools `list_deployments` and `list_late_regressions` return their
+  lists inside an object (`{"deployments": [...]}`, `{"late_regressions":
+  [...]}`). MCP requires a tool's structured content to be an object, so
+  clients such as Claude Code rejected the bare lists before the agent saw
+  them.
+
 ## 0.1.12 (2026-10-06)
 
 - `deployangel plan` and the MCP tool `get_exercise_plan` say what stands

data/README.md

@@ -387,9 +387,20 @@ choose with `--format=text|json`. Exit codes:
 ### MCP server
 
 ```bash
-claude mcp add deployangel -- bundle exec deployangel mcp
+claude mcp add deployangel -- bundle exec deployangel mcp    # Claude Code
 ```
 
+For Codex, in `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.deployangel]
+command = "bundle"
+args = ["exec", "deployangel", "mcp"]
+```
+
+Any other MCP client (Cursor, VS Code, Zed, ...) runs the same command. The
+server needs `DEPLOYANGEL_API_TOKEN` in the environment it starts in.
+
 Tools: `get_verification`, `wait_for_verification` (up to 5 minutes per call),
 `get_exercise_plan`, `list_deployments`, `get_exception`,
 `list_late_regressions`, and `register_deployment` when the token allows it.
@@ -402,7 +413,8 @@ A quiet app can take hours to clear a release. `deployangel plan` (or the
 clearance, in the numbers of the rule it's judged by, and what to exercise
 against production so it clears sooner: normally active routes short of
 their runs, routes this release changed that haven't run, and critical
-flows. Requests to them count like any traffic. Routes that change data
+flows. It separates what clearance waits on from changed and rarely used
+paths that are only worth running. Requests to them count like any traffic. Routes that change data
 are marked; use a test account for them, or ask first. Report what you
 ran with the `deployangel check` command the plan gives you. A passing
 check labels what it covered; only the requests themselves count as

data/lib/deployangel/cli/formatter.rb

@@ -122,18 +122,37 @@ module DeployAngel
           shortfall.each { |line| lines << "  #{line}" }
         end
         items = Array(plan["items"])
-        if items.any?
-          lines << (EXERCISABLE.include?(plan["status"]) ? "Exercise against production:" : "Optional:")
-          items.each { |item| lines << "  #{item_line(item)}" }
-          lines << "Use a test account, or ask first, for routes marked [changes data]." if items.any? { |item| item["mutating"] }
+        if EXERCISABLE.include?(plan["status"])
+          needed, extra = items.partition { |item| needed?(item) }
+          item_group(lines, "Needed to clear, exercise against production:", needed)
+          item_group(lines, "Also worth running, not needed to clear (changed or rarely used, watched on first use):", extra)
+        else
+          item_group(lines, "Optional:", items)
         end
+        lines << "Use a test account, or ask first, for routes marked [changes data]." if items.any? { |item| item["mutating"] }
         lines << "Then report it: #{plan["report_with"]}" if plan["report_with"]
         lines.join("\n")
       end
 
+      # Only what clearance waits on: the rest is in `deployangel plan`.
       def exercisable_items(document)
         plan = document["exercise_plan"] || {}
-        EXERCISABLE.include?(plan["status"]) ? Array(plan["items"]).map { |item| item_line(item) } : []
+        return [] unless EXERCISABLE.include?(plan["status"])
+
+        Array(plan["items"]).select { |item| needed?(item) }.map { |item| item_line(item) }
+      end
+
+      # Whether clearance waits on the item. Servers older than the needed
+      # flag listed normally active items first, so count those.
+      def needed?(item)
+        item.key?("needed") ? item["needed"] : item["reason"] == "normally_active"
+      end
+
+      def item_group(lines, heading, items)
+        return if items.empty?
+
+        lines << heading
+        items.each { |item| lines << "  #{item_line(item)}" }
       end
 
       def shortfall_lines(shortfall)

data/lib/deployangel/mcp.rb

@@ -22,7 +22,8 @@ module DeployAngel
         Findings are deterministic evidence; any "investigation" field is AI inference. These tools cannot
         change production. Do not roll back or change production without explicit approval.
         If a release isn't cleared yet, get_exercise_plan says what to exercise against production so it
-        clears sooner. Only act on status "exercisable" or "waiting_for_activity"; for "warm_up" or
+        clears sooner. Items with needed true are what clearance waits on; the rest are only worth running.
+        Only act on status "exercisable" or "waiting_for_activity"; for "warm_up" or
         "no_baseline" nothing you run can clear it. Exercise routes marked mutating only with a test account
         or after asking. Report what you ran with the plan's report_with command (deployangel check).
       TEXT
@@ -102,7 +103,8 @@ module DeployAngel
             )),
           tool("get_exercise_plan", "What stands between a release and clearance, and what to exercise against " \
             "production so it clears sooner: normally active routes short of their runs, routes this release changed " \
-            "that haven't run, and critical flows. Routes marked mutating change data: use a test account or ask first. " \
+            "that haven't run, and critical flows. needed marks what clearance waits on; the rest are only worth running. " \
+            "Routes marked mutating change data: use a test account or ask first. " \
             "Your requests count as ordinary traffic; report what you ran with report_with. Defaults to the current git HEAD.",
             TARGET_PROPERTIES),
           tool("list_deployments", "Recent deployments with their verification state and verdict.",
@@ -137,9 +139,11 @@ module DeployAngel
             when "get_verification" then waiter.wait(target(arguments), wait: false).then { |o| verification_content(o) }
             when "wait_for_verification" then wait_content(arguments)
             when "get_exercise_plan" then waiter.wait(target(arguments), wait: false).then { |o| plan_content(o) }
-            when "list_deployments" then @client.deployments(limit: arguments.fetch("limit", 10))
+            # MCP requires structured content to be an object, never a bare list.
+            when "list_deployments" then { "deployments" => @client.deployments(limit: arguments.fetch("limit", 10)) }
             when "get_exception" then @client.exception(arguments.fetch("fingerprint") { raise ArgumentError, "fingerprint is required" })
-            when "list_late_regressions" then @client.late_regressions(since: arguments["since"], limit: arguments.fetch("limit", 10))
+            when "list_late_regressions"
+              { "late_regressions" => @client.late_regressions(since: arguments["since"], limit: arguments.fetch("limit", 10)) }
             when "register_deployment"
               raise ArgumentError, "register_deployment is not available for this token" unless scopes.include?("deployments")
 

data/lib/deployangel/version.rb

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

metadata

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