github/gh-aw v0.48.4

on GitHub

🌟 Release Highlights

This release promotes Google Gemini CLI to general availability, improves validation error quality, and consolidates network configuration with a migration codemod for Playwright users.

⚠️ Breaking Changes

• Playwright allowed_domains/allowed_hosts removed — These fields have been moved from tools.playwright to the unified network.allowed configuration. Run the migration codemod to update your workflows automatically:

  gh aw fix --write

  The codemod playwright-allowed-domains-migration handles the conversion. (#17629)

✨ What's New

• Google Gemini CLI is now GA — The Gemini engine graduates from experimental status and is ready for production workflows. Gemini gains /tmp/gh-aw/ read access outside the workspace, neutral tool mappings for settings compatibility, and improved diagnostics (DEBUG env var support, error log artifacts). (#17656, #17642, #17612, #17558)

• Repo-memory branch scoped by workflow ID — Default repo-memory branches are now qualified with the workflow ID, preventing collisions when multiple workflows share the same repository memory. (#17657)

• Smarter schema validation errors — Validation failures now include caret (^) pointers to the exact problem location, plain-English constraint descriptions, and contextual examples — making it much easier to fix frontmatter issues at a glance. (#17551)

• Parent author allowed in add_comment — Workflows can now mention the author of the parent issue, PR, or discussion when posting comments, enabling more targeted notifications. (#17628)

🐛 Bug Fixes & Improvements

• Audit surfaces pre-agent step errors — gh aw audit now reports errors that occur before the agent executes (e.g., setup failures), so investigations no longer require manual log digging. (#17623)
• Standardized error codes in safe-output handlers — All safe output handlers now emit structured error codes (e.g., USE-001) for consistent error tracking and automation. (#17557)
• PR triage scoped to fork PRs — Triage workflows now correctly restrict processing to fork-originated pull requests, reducing noise on internal PRs. (#17576)
• Preserve expression-based draft boolean — The create-pull-request handler no longer drops expression values for the draft field during config compilation. (#17597)
• Status comments enabled on all smoke workflows — All smoke-* workflows now post status comments, improving end-to-end validation coverage. (#17566)

📚 Documentation

• Workflow Editors reference page — A new Workflow Editors page consolidates all available editors including the Agentic Prompt Generator. (#17570, #17574)
• Supported runners table — The frontmatter reference now includes a table of supported runner types. (#17361)
• Create Workflows page enhanced — Scenario-based AstroTabs examples replace the single prompt, giving new users concrete starting points. (#17560)

For complete details, see CHANGELOG.

Generated by Release

What's Changed

• Fix schema validation error quality: caret pointer, duplicate path prefix, plain-English constraints, contextual examples by @Copilot in #17551
• fix(workflows): add Python network preset to shared/trending-charts-simple.md by @Copilot in #17554
• docs: replace single prompt with AstroTabs scenario examples on Create Workflows page by @Copilot in #17560
• Enable status-comment on all smoke-* workflows by @Copilot in #17566
• docs: convert Compiler Playground sidebar link into Workflow Editors reference page by @Copilot in #17570
• feat(triage): restrict PR triage to fork PRs only by @Copilot in #17576
• docs: add Agentic Prompt Generator to reference/editors page by @Copilot in #17574
• Improve Gemini engine diagnostics: DEBUG env var, error log artifacts, and remove model fallback by @Copilot in #17558
• Copilot/weekly workflow editor checks by @pelikhan in #17585
• Copilot/update firewall access editors by @pelikhan in #17599
• fix(USE-001): add standardized error codes to all safe output handlers by @Copilot in #17557
• Copilot/update parser log javascript by @pelikhan in #17605
• [instructions] Sync github-agentic-workflows.md with v0.40.1 by @github-actions[bot] in #17622
• Allow parent issue/PR/discussion author as an allowed mention in add_comment by @Copilot in #17628
• [docs] docs: unbloat dispatch-ops by condensing bullet lists and thin sections by @github-actions[bot] in #17626
• [jsweep] Clean add_copilot_reviewer.cjs by @github-actions[bot] in #17641
• fix(audit): surface pre-agent step errors when agent never executed by @Copilot in #17623
• [docs] Update documentation for features from 2026-02-22 by @github-actions[bot] in #17647
• Refactor: Extract shared missing issue handler logic into missing_issue_helpers.cjs by @Copilot in #17644
• fix: preserve expression-based draft boolean in create-pull-request handler config by @Copilot in #17597
• Remove tools.playwright allowed_domains/allowed_hosts; add codemod to migrate to network.allowed by @Copilot in #17629
• feat(gemini): fix /tmp/ access and add neutral tool mapping for Gemini CLI settings by @Copilot in #17642
• docs: add supported runners table to frontmatter reference by @Mossaka in #17361
• Promote Google Gemini CLI from experimental to GA by @Copilot in #17656
• Qualify default repo-memory branch by workflow ID by @Copilot in #17657

Full Changelog: v0.48.3...v0.48.4