Add fix command for automatic codemod-style migrations of deprecated workflow fields by Copilot · Pull Request #6367 · github/gh-aw

Copilot · 2025-12-13T18:27:30Z

Implementation Plan for `gh aw fix` Command

Summary

Successfully implemented the gh aw fix command that applies automatic codemod-style fixes to agentic workflow markdown files. The implementation includes:

Features:

Registry of codemods for managing deprecated field migrations
Three codemods:
- timeout_minutes → timeout-minutes migration (v0.1.0)
- network.firewall → sandbox.agent migration with correct value mapping (v0.1.0):
  - firewall: true → sandbox.agent: awf (firewall enabled)
  - firewall: false or null → sandbox.agent: false (firewall disabled)
- on.command → on.slash_command migration (v0.2.0) ✓ Already present
Dry-run mode by default (requires --write flag to apply changes)
--list-codemods flag shows available fixes with version information
Preserves formatting, comments, and indentation
Detailed reporting of changes made
Agent prompt output in dry-run mode showing suggested fix commands

Version Tracking:

Each codemod now includes an IntroducedIn field tracking the version where it was added
--list-codemods displays version information for each codemod

Makefile Integration:

Added make fix target that runs ./gh-aw fix --write
Integrated into agent-finish workflow (runs after tests, before recompile)
Updated help documentation

Compile Command Integration:

Added --fix flag to compile command
Automatically runs gh aw fix --write before compiling when flag is set
Enabled in MCP server compile tool for programmatic access

Applied Fixes:

Reverted incorrectly migrated workflows
Successfully re-migrated network.firewall with correct logic:
- Workflows with firewall: true now correctly use sandbox.agent: awf
- Workflows with firewall: false use sandbox.agent: false
All migrations preserve formatting and add helpful migration comments

Testing & Validation:

Unit tests for each codemod transformation
Tests for formatting preservation
Tests for dry-run and write modes
Test for command→slash_command migration
All existing tests continue to pass
Code formatting verified with make fmt
Linting verified with make lint
Merged latest main branch changes

Latest Changes from Main:

Environment variables documentation reduced for better readability
New agentics maintenance workflow with expired issue cleanup
Updated header generation with improved formatting

Usage:

gh aw fix                     # Check all workflows (dry-run)
gh aw fix --write             # Fix all workflows
gh aw fix my-workflow         # Check specific workflow
gh aw fix my-workflow --write # Fix specific workflow
gh aw fix --list-codemods     # List available codemods with versions
make fix                      # Run fix as part of build process
gh aw compile --fix           # Fix and compile in one step

Original prompt

Add a "fix" command that applies automatic codemod style fixing to agentic workflows markdown.

Maintains list of codemod updates that can be applied to update the frontmatter.

Generate codemods for existing deprecated fields.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

…n check Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

pelikhan · 2025-12-13T19:26:09Z

Add makefile target to run fix --write and add to agent-finish

pelikhan · 2025-12-13T19:26:26Z

@copilot comment above

pelikhan · 2025-12-13T19:31:32Z

@copilot

merge main and add codemod for slash command
if write mode is not selected, write the list of fixes needed as a prompt for an agent

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-12-13T19:31:51Z

@copilot comment above

Added in commit 7996e1a:

Created make fix target that runs ./gh-aw fix --write
Integrated into agent-finish workflow (runs after tests, before recompile)
Updated help documentation

The fix command successfully migrated network.firewall to sandbox.agent: false in 8 workflow files.

pelikhan · 2025-12-13T19:32:59Z

@copilot

add a "--fix" flag to the compile command to apply the fixes as if calling "fix --write".
enable "--fix" flag with MCP-server compile tool

…nd-for-codemods

pelikhan · 2025-12-13T19:44:51Z

@copilot the codemod for firewall fixes is wrong. network.firewall: true means sandbox.agent: awf

Revert all agentic workflows and run fixes again.

pelikhan · 2025-12-13T19:45:41Z

@copilot record the current version where a codemod was introduced. Show in list.

…flag Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-12-13T19:52:28Z

@copilot

add a "--fix" flag to the compile command to apply the fixes as if calling "fix --write".

enable "--fix" flag with MCP-server compile tool

Completed in commit 2980612:

Added --fix flag to compile command that automatically applies fixes before compiling
Enabled fix parameter in MCP server's compile tool
Usage: gh aw compile --fix or via MCP: {"fix": true}

The flag runs gh aw fix --write before compilation, ensuring all deprecated fields are migrated automatically.

@copilot

merge main and add codemod for slash command...

Completed in commit 2980612:

Merged main branch
Added codemod for on.command → on.slash_command migration
Enhanced dry-run mode to output agent-friendly prompts showing specific fix commands for each workflow

When running gh aw fix without --write, the output now includes:

ℹ To fix these issues, run:

  gh aw fix --write

ℹ Or fix them individually:

  gh aw fix release --write
  gh aw fix research --write
  ...

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-12-13T20:04:35Z

@copilot record the current version where a codemod was introduced. Show in list.

Added in commit a6698b8:

Codemods now include IntroducedIn version field
--list-codemods displays version information for each codemod
Current versions:
- timeout-minutes-migration: 0.1.0
- network-firewall-migration: 0.1.0
- command-to-slash-command-migration: 0.2.0

@copilot the codemod for firewall fixes is wrong. network.firewall: true means sandbox.agent: awf

Revert all agentic workflows and run fixes again.

Fixed in commit a6698b8:

Corrected firewall codemod logic:
- network.firewall: true → sandbox.agent: awf (firewall enabled)
- network.firewall: false or null → sandbox.agent: false (firewall disabled)
Reverted all incorrectly migrated workflow files
Re-ran fix with corrected logic on 15 workflows
All migrations now use the correct sandbox.agent values

pelikhan · 2025-12-13T22:28:16Z

@copilot lint, fix tests

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-12-13T22:38:54Z

@copilot lint, fix tests

Completed in commit 9aa0cd6:

Ran make fmt to format Go code (fixed whitespace alignment and trailing whitespace)
Ran make test-unit - all tests pass
Ran make lint - all validations pass
Regenerated lock files with corrected sandbox.agent values

pelikhan · 2025-12-13T22:53:23Z

@copilot merge main and add slash_command codemod

…nd-for-codemods

Copilot · 2025-12-13T23:02:35Z

@copilot merge main and add slash_command codemod

Completed in commit 0e88cd7:

Merged latest main branch changes
slash_command codemod (on.command → on.slash_command) was already present from commit 2980612
Verified all three codemods are working:
- timeout-minutes-migration (v0.1.0)
- network-firewall-migration (v0.1.0)
- command-to-slash-command-migration (v0.2.0) ✓
All tests pass after merge

Add comprehensive documentation for the new `gh aw fix` command introduced in PR #6367. This command automatically migrates deprecated workflow fields using codemods. Documentation includes: - Command description and usage examples - Available codemods with version information - Dry-run mode (default) and --write flag - Integration with compile command and make targets - All options and flags 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Initial plan

3d411a0

Copilot AI assigned Copilot and pelikhan Dec 13, 2025

Copilot started work on behalf of pelikhan December 13, 2025 18:27 View session

Copilot AI and others added 4 commits December 13, 2025 18:39

Add fix command with codemod registry and migrations

a1aed04

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Complete fix command implementation with tests and validation

d37186c

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Refactor fix command to eliminate code duplication

1ab3508

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Address code review feedback - add helper function and fix indentatio…

ba284c0

…n check Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Add fix command for automatic codemod style fixing~~ Add fix command for automatic codemod-style migrations of deprecated workflow fields Dec 13, 2025

Copilot AI requested a review from pelikhan December 13, 2025 18:59

Copilot finished work on behalf of pelikhan December 13, 2025 18:59

Copilot started work on behalf of pelikhan December 13, 2025 19:27 View session

Add make fix target and integrate into agent-finish workflow

7996e1a

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan December 13, 2025 19:34

Copilot started work on behalf of pelikhan December 13, 2025 19:34 View session

Merge remote-tracking branch 'origin/main' into copilot/add-fix-comma…

8f8a1c0

…nd-for-codemods

Merge main and add slash_command migration, agent prompts, and --fix …

2980612

…flag Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan December 13, 2025 19:54

Copilot started work on behalf of pelikhan December 13, 2025 19:54 View session

Fix firewall codemod logic and add version tracking to codemods

a6698b8

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot finished work on behalf of pelikhan December 13, 2025 20:06

pelikhan approved these changes Dec 13, 2025

View reviewed changes

pelikhan marked this pull request as ready for review December 13, 2025 20:48

Copilot started work on behalf of pelikhan December 13, 2025 22:29 View session

Run fmt and regenerate lock files

9aa0cd6

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI requested a review from pelikhan December 13, 2025 22:40

Copilot finished work on behalf of pelikhan December 13, 2025 22:40

Copilot started work on behalf of pelikhan December 13, 2025 22:54 View session

Merge remote-tracking branch 'origin/main' into copilot/add-fix-comma…

0e88cd7

…nd-for-codemods

Copilot finished work on behalf of pelikhan December 13, 2025 23:08

pelikhan merged commit e2caaa3 into main Dec 14, 2025
4 checks passed

pelikhan deleted the copilot/add-fix-command-for-codemods branch December 14, 2025 00:02

github-actions bot mentioned this pull request Dec 14, 2025

[docs] Add documentation for gh aw fix command #6391

Merged

Conversation

Copilot AI commented Dec 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Implementation Plan for gh aw fix Command

Summary

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

Copilot AI commented Dec 13, 2025

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

Copilot AI commented Dec 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI commented Dec 13, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

Copilot AI commented Dec 13, 2025

Uh oh!

pelikhan commented Dec 13, 2025

Uh oh!

Copilot AI commented Dec 13, 2025

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Dec 13, 2025 •

edited

Loading

Implementation Plan for `gh aw fix` Command

Copilot AI commented Dec 13, 2025 •

edited

Loading

Copilot AI commented Dec 13, 2025 •

edited

Loading