github/gh-aw v0.38.4

on GitHub

🌟 Release Highlights

This release brings powerful new workflow composition capabilities with imports and sharing, stability improvements to campaigns, and enhanced workflow tooling.

✨ What's New

📦 Workflow Imports & Composition

• Classic GitHub Actions import support (#12775) - Import existing .yml workflows alongside agentic workflows for hybrid automation
• Agent and repository imports (#12771) - Import agents and workflows from other repositories with runtime .github folder merging
• Runtime markdown imports (#12687) - Use runtime-import to load workflow bodies dynamically without inlining
• Recursive import testing (#12753) - Comprehensive test coverage ensures complex import graphs work reliably

Learn more about imports

🎯 GitHub Projects Integration

• Project creation command (#12697) - New gh aw project command to create and configure GitHub Projects V2
• Project URL validation (#12720) - Support placeholder values and pass-through from frontmatter to safe outputs (#12690)
• Temporary ID resolution (#12805) - Fix project updates using temporary IDs

📊 Workflow Health Monitoring

• Health command with cost metrics (#12662) - Monitor workflow health and track usage with gh aw health
• Deterministic frontmatter hashing (#12589) - SHA-256 hash-based stale detection for workflows with imports and template expressions

🐛 Bug Fixes & Improvements

Campaign Stability

• Fixed campaign views/fields setup (#12797) and recompiled workflows after changes (#12783)
• Improved project field handling (#12715) and validation (#12683)
• Added experimental warnings to campaign docs (#12705)

MCP Gateway Reliability

• Enhanced health check retry logging (#12808) and timing instrumentation (#12803)
• Disabled pre-activation optimization for stability (#12802)

Testing & Quality

• Fixed compiler size validation tests (#12773) and stdout/stderr routing (#12750)
• Fixed CI cleaner workflow with noop handling (#12691)
• Added debug logging to CLI and workflow modules (#12692)

📚 Documentation

• GitHub Actions primer (#12755) - New guide for developers transitioning to agentic workflows
• Runtime import documentation (#12754) - Clarify when recompilation is required vs optional
• Consolidated developer specs (#12719) - Unified instructions for contributors
• Campaign documentation improvements (#12727, #12721, #12731) - Separated getting started from conceptual overview
• Glossary updates (#12716) - Daily terminology maintenance

🔧 Breaking Changes

⚠️ Timeout Configuration Removed (#12702)

• The timeout_minutes field is completely removed
• Action required: Run gh aw fix to automatically migrate workflows to use GitHub Actions native timeout syntax
• Workflows using timeout_minutes will fail compilation until migrated

📋 Campaign Command Removed (#12638)

• The undocumented gh aw campaign CLI command has been removed
• Campaigns are now managed through workflow files and GitHub Projects

🎨 Developer Experience

• Console formatting integration (#12671) - Validation errors now use consistent console formatting
• Error aggregation (#12661) - Multiple validation errors reported together using errors.Join
• Stderr routing standardization (#12704) - Diagnostic output to stderr, structured data to stdout
• Go formatting enforcement (#12694, #12665) - Code quality improvements

For complete details, see CHANGELOG.

Ahoy! This treasure was crafted by 🏴‍☠️ Release

What's Changed

• Add error aggregation for validation using errors.Join by @Copilot in #12661
• Fix custom agent name references in log parser tests by @Copilot in #12649
• Add workflow health monitoring command with cost metrics (gh aw health) by @Copilot in #12662
• Remove campaign command and related code by @Copilot in #12638
• Remove two-file workflow structure from documentation templates by @Copilot in #12650
• Integrate console formatting with validation errors by @Copilot in #12671
• Implement deterministic SHA-256 hash for workflow frontmatter with imports, template expressions, versions, and hash-based stale detection by @Copilot in #12589
• Fix CI Cleaner: Add repo checkout and noop handling for passing CI by @Copilot in #12691
• Pass project URL from frontmatter to safe output handlers as default by @Copilot in #12690
• [log] Add debug logging to CLI and workflow processing modules by @github-actions[bot] in #12692
• Document and test existing pass-through field validation by @Copilot in #12683
• Update campaign docs to reflect workflows with imports pattern by @Copilot in #12685
• Add project command to create GitHub Projects V2 by @Copilot in #12697
• Add experimental warning banner to campaign documentation by @Copilot in #12705
• refactor: standardize short project field handling by @mnkiefer in #12715
• chore: reduce campaign docs and add glossary entry by @Copilot in #12721
• docs: separate getting started content from conceptual overview by @Copilot in #12727
• [docs] Update glossary - daily scan by @github-actions[bot] in #12716
• [docs] Consolidate developer specifications into instructions file by @github-actions[bot] in #12719
• Document GH_AW_AGENT_TOKEN in campaign getting started by @Copilot in #12731
• Route diagnostic output to stderr, preserve structured data on stdout by @Copilot in #12704
• Completely remove timeout_minutes - use codemod to migrate by @Copilot in #12702
• Use runtime-import for markdown body instead of inlining (with recursive processing) by @Copilot in #12687
• Add GitHub Actions primer guide to documentation by @Copilot in #12755
• Document runtime markdown loading: when recompilation is required vs optional by @Copilot in #12754
• Remove undocumented campaign CLI command from documentation by @Copilot in #12762
• Optimize security-guard workflow: explicit model configuration by @Copilot in #12761
• Add comprehensive test coverage for recursive runtime-import graphs by @Copilot in #12753
• chore: rm default copilot assignment for create-issue in campaigns by @mnkiefer in #12782
• Add support for importing classic GitHub Actions workflows (.yml) by @Copilot in #12775
• Implement agent and repository imports with runtime .github folder merging by @Copilot in #12771
• docs: rearrange sections in campaigns guide by @mnkiefer in #12795
• chore: re-add default campaign views/fields setup by @Copilot in #12797
• 🔧 Disable optimization for workflow pre-activation by @dsyme in #12802
• Add timing instrumentation to MCP gateway setup scripts by @Copilot in #12803
• Fix: Add temporary ID resolution to update_project handler by @Copilot in #12805
• Add retry progress logging to MCP gateway health checks by @Copilot in #12808

Full Changelog: v0.38.3...v0.38.4