Skip to content

Document 2026-04-20 major breaking changes in Unreleased changelog #27383

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 3 commits into from
Apr 20, 2026
+52 −1
Merged

Document 2026-04-20 major breaking changes in Unreleased changelog #27383

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
68a65fd
Initial plan
Copilot Apr 20, 2026
f3c412d
docs: add breaking changes to changelog for 2026-04-20 analysis
Copilot Apr 20, 2026
1dd19d9
docs: clarify breaking change changelog wording
Copilot Apr 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 52 additions & 1 deletion CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -452,6 +452,58 @@ 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.

#### 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.

**Migration:**
- Replace `app:` with `github-app:`
- Run `gh aw fix` to apply the codemod automatically
Comment on lines +460 to +462

#### Replace `supportsLLMGateway` flag with `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-based TOML configuration (non-Docker stdio
definitions are no longer supported)
- 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.
Expand Down Expand Up @@ -2966,4 +3018,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

Loading