From 68a65fd82bb7a95e6925df1e03292d03cf59b7b3 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Apr 2026 15:23:44 +0000
Subject: [PATCH 1/3] Initial plan


From f3c412d519d12e2fdecbdac65ab68eaf481f8625 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Apr 2026 15:41:01 +0000
Subject: [PATCH 2/3] docs: add breaking changes to changelog for 2026-04-20
 analysis

Agent-Logs-Url: https://github.com/github/gh-aw/sessions/ed8aff1d-4435-4582-8e99-b83b94d22c23

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 CHANGELOG.md | 52 +++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 51 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 58c18c882e0..69648791fd1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -452,6 +452,57 @@ Run `gh aw fix` to automatically update your workflow files to use the new termi
 
 **Note:** The external `gh agent-task` CLI command name remains unchanged as it is maintained separately.
 
+#### Rename `app:` to `github-app:`
+
+The deprecated `app:` workflow frontmatter field was removed and replaced with
+`github-app:`. Workflows still using `app:` will now fail validation.
+
+**Migration:**
+- Replace `app:` with `github-app:`
+- Run `gh aw fix` to apply the codemod automatically
+
+#### Rename `supportsLLMGateway` to `llmGatewayPort`
+
+Engine configuration now requires an explicit `llmGatewayPort` value instead of
+the old `supportsLLMGateway: true` flag. The `SupportsLLMGateway` interface
+hooks were also removed.
+
+**Migration:**
+- Replace `supportsLLMGateway: true` with `llmGatewayPort: <port>`
+- Update custom engine implementations that relied on `SupportsLLMGateway`
+
+#### Decouple status comment from AI reaction defaults
+
+Status comments are no longer enabled implicitly. Workflows that relied on the
+default started/completed status comment must now enable it explicitly.
+
+**Migration:**
+- Add `status-comment: true` to workflow frontmatter when status comments are needed
+
+#### Remove top-level `sandbox: false`
+
+The deprecated top-level `sandbox: false` flag was removed. Workflows using it
+will fail validation.
+
+**Migration:**
+- Replace `sandbox: false` with:
+  ```yaml
+  sandbox:
+    agent: false
+  ```
+- Run `gh aw fix` to apply the codemod automatically
+
+#### MCP Gateway v0.1.5 validation tightening
+
+MCP Gateway v0.1.5 introduces stricter MCP server validation:
+- stdio servers must use Docker-only TOML configuration
+- mounts must include explicit mount modes
+- HTTP servers cannot define mounts
+
+**Migration:**
+- Review and update MCP server definitions for the new requirements
+- Run `gh aw compile` to detect and fix invalid configurations before upgrading
+
 ## v0.35.1 - 2026-01-06
 
 Maintenance release with dependency updates and minor improvements.
@@ -2966,4 +3017,3 @@ Updated the Codex engine's remote GitHub MCP server configuration to use the new
 
 - Convert TypeScript safe output files to CommonJS and remove TypeScript compilation
 - Update Claude Code CLI to version 2.0.10
-

From 1dd19d94ef65da6ad97a79d36dd1f4b7f6dc936d Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 20 Apr 2026 15:47:24 +0000
Subject: [PATCH 3/3] docs: clarify breaking change changelog wording

Agent-Logs-Url: https://github.com/github/gh-aw/sessions/ed8aff1d-4435-4582-8e99-b83b94d22c23

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
---
 CHANGELOG.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 69648791fd1..d59b8bfd68c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -452,7 +452,7 @@ Run `gh aw fix` to automatically update your workflow files to use the new termi
 
 **Note:** The external `gh agent-task` CLI command name remains unchanged as it is maintained separately.
 
-#### Rename `app:` to `github-app:`
+#### Replace removed `app:` with `github-app:`
 
 The deprecated `app:` workflow frontmatter field was removed and replaced with
 `github-app:`. Workflows still using `app:` will now fail validation.
@@ -461,7 +461,7 @@ The deprecated `app:` workflow frontmatter field was removed and replaced with
 - Replace `app:` with `github-app:`
 - Run `gh aw fix` to apply the codemod automatically
 
-#### Rename `supportsLLMGateway` to `llmGatewayPort`
+#### Replace `supportsLLMGateway` flag with `llmGatewayPort`
 
 Engine configuration now requires an explicit `llmGatewayPort` value instead of
 the old `supportsLLMGateway: true` flag. The `SupportsLLMGateway` interface
@@ -495,7 +495,8 @@ will fail validation.
 #### MCP Gateway v0.1.5 validation tightening
 
 MCP Gateway v0.1.5 introduces stricter MCP server validation:
-- stdio servers must use Docker-only TOML configuration
+- stdio servers must use Docker-based TOML configuration (non-Docker stdio
+  definitions are no longer supported)
 - mounts must include explicit mount modes
 - HTTP servers cannot define mounts