Add proactive staleness warnings with actionable guidance to status command by Copilot · Pull Request #6211 · github/gh-aw

Copilot · 2025-12-12T04:21:39Z

Plan: Add Proactive Staleness Warnings with Actionable Guidance

Implementation Summary

Features Added

ActionNeeded Column: New column in status table showing copy-paste ready commands
- Shows "gh aw compile workflow.md" for workflows needing compilation
- Empty for up-to-date workflows
- Included in both console and JSON output
- Always visible (no flag required)
Color-Coded Compiled Status: Visual indicators for workflow state
- 🟢 Green "Yes" - Up-to-date workflows
- 🟡 Yellow "Stale" - Modified source files (timestamp mismatch)
- 🔴 Red "No" - Never compiled
- Colors only shown in TTY terminals, plain text otherwise
Summary Footer: Actionable summary after status table
- Shows count: "Workflows needing compilation: X"
- Displays bulk command: "⚡ gh aw compile"
- Shows success message when all workflows are up-to-date
- Always visible (no flag required)

Testing

✅ All unit tests pass
✅ New tests added for ActionNeeded field
✅ Linting passes
✅ Manual verification completed
✅ JSON output validated

Files Modified

pkg/cli/status.go - Command definition (removed --fix-suggestions flag)
pkg/cli/status_command.go - Core implementation
pkg/cli/status_command_test.go - New tests
pkg/cli/commands_test.go - Updated test calls

Design Decisions

Action Needed column and summary footer are always displayed rather than hidden behind a flag
Summary message rephrased to "Workflows needing compilation: X" to avoid pluralization complexity
Removed pluralize helper function to simplify code

Original prompt

This section details on the original issue you should resolve

<issue_title>[plan] Add proactive staleness warnings with actionable guidance</issue_title>
<issue_description>## Objective

Enhance gh aw status output to provide clear, actionable guidance when workflows are stale or uncompiled. Add color-coded status, "Action Needed" column, summary line with bulk commands, and optional fix script generation.

Context

Current status output shows "Compiled: No" but provides no guidance on what to do next. Users must figure out commands themselves, leading to confusion and inconsistent workflow states.

Approach

1. Enhance WorkflowStatus Struct

Add new field:
ActionNeeded  string   `json:"action_needed" console:"header:Action Needed,omitempty"`
Generate commands based on staleness type:

Never compiled: "Run: gh aw compile workflow.md"

Stale (hash): "Run: gh aw compile workflow.md (content changed)"

Stale (timestamp): "Run: gh aw compile workflow.md (timestamp mismatch)"

Up-to-date: "" (empty)

2. Add Summary Footer

After status table, print:
⚠️  5 workflows need compilation
  Run: gh aw compile --all
Or if all up-to-date:
✓ All workflows are up-to-date
3. Add Color Coding

Using console package:

Green: Compiled == "Yes" (up-to-date)

Yellow: Compiled contains "Stale"

Red: Compiled == "No" (never compiled)

4. Add --fix-suggestions Flag

Generate executable shell script:
gh aw status --fix-suggestions > fix-workflows.sh
Output:
#!/bin/bash
# Generated by gh aw status --fix-suggestions
gh aw compile workflow1.md
gh aw compile workflow2.md
git add .github/workflows/*.lock.yml
echo "Done! Review changes with: git diff --cached"
Files to Modify

pkg/cli/status_command.go - Enhance output and add features

pkg/console/*.go - Add color formatting utilities if needed

pkg/cli/status_command_test.go - Test new output format

Acceptance Criteria

Status output includes "Action Needed" column

Commands are copy-paste ready

Summary line shows total needing compilation

Color-coded output for terminal display

--fix-suggestions generates valid shell script

Verbose mode explains staleness reason

Tests verify output format correctness

Documentation updated with examples
Related to [plan] Workflow Lifecycle Management & Staleness Detection Improvements #6181

AI generated by Plan Command for discussion #6133

Comments on the Issue (you are @copilot in this section)

Fixes [plan] Add proactive staleness warnings with actionable guidance #6184

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

… status command Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>

Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>

pelikhan · 2025-12-12T05:47:49Z

@copilot the user can run "gh aw compile" to recompile all workflows

…d of 'gh aw compile --all' Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot · 2025-12-12T05:53:59Z

@copilot the user can run "gh aw compile" to recompile all workflows

Fixed in f213bde. The summary footer now shows gh aw compile instead of the incorrect gh aw compile --all.

Updated output:

⚠ 4 workflows need compilation
  Run: ⚡ gh aw compile

pelikhan · 2025-12-12T05:59:52Z

 			ref, _ := cmd.Flags().GetString("ref")
 			labelFilter, _ := cmd.Flags().GetString("label")
-			return StatusWorkflows(pattern, verbose, jsonFlag, ref, labelFilter)
+			fixSuggestions, _ := cmd.Flags().GetBool("fix-suggestions")


@copilot always on

Done in 960481d. Removed the --fix-suggestions flag. The Action Needed column and summary footer are now always displayed.

Output now shows:

│Action Needed │ │- │ │gh aw compile code-health-file-diet.campaign.md│

And summary footer:

⚠ 4 workflows need compilation Run: ⚡ gh aw compile

pelikhan · 2025-12-12T06:00:03Z

 			ref, _ := cmd.Flags().GetString("ref")
 			labelFilter, _ := cmd.Flags().GetString("label")
-			return StatusWorkflows(pattern, verbose, jsonFlag, ref, labelFilter)
+			fixSuggestions, _ := cmd.Flags().GetBool("fix-suggestions")


@copilot remove flag

Done in 960481d. The --fix-suggestions flag has been removed and the functionality is now always on.

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

pelikhan · 2025-12-12T06:12:43Z

 }
+
+// pluralize returns "s" if count != 1, otherwise empty string
+func pluralize(count int) string {


@copilot rephrase so you do not have to pluralize, remove function

Done in ea40e0c. Rephrased the message to "Workflows needing compilation: X" which doesn't require pluralization, and removed the pluralize function.

Updated output:

⚠ Workflows needing compilation: 4 Run: ⚡ gh aw compile

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

Initial plan

54d528c

Copilot AI assigned Copilot and mnkiefer Dec 12, 2025

Copilot started work on behalf of mnkiefer December 12, 2025 04:22 View session

Copilot AI and others added 2 commits December 12, 2025 04:34

Add ActionNeeded field, summary footer, and --fix-suggestions flag to…

02652f7

… status command Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>

Add color coding to Compiled column and tests for ActionNeeded field

5967c8a

Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Enhance gh aw status with actionable staleness guidance~~ Add proactive staleness warnings with actionable guidance to status command Dec 12, 2025

Copilot AI requested a review from mnkiefer December 12, 2025 04:56

Copilot finished work on behalf of mnkiefer December 12, 2025 04:56

Copilot started work on behalf of pelikhan December 12, 2025 05:48 View session

Fix bulk compile command in status footer: use 'gh aw compile' instea…

f213bde

…d of 'gh aw compile --all' Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Copilot AI requested a review from pelikhan December 12, 2025 05:56

Copilot finished work on behalf of pelikhan December 12, 2025 05:56

pelikhan reviewed Dec 12, 2025

View reviewed changes

Copilot started work on behalf of pelikhan December 12, 2025 06:01 View session

Remove --fix-suggestions flag, keep Action Needed column and summary …

960481d

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

Copilot AI requested a review from pelikhan December 12, 2025 06:10

Copilot finished work on behalf of pelikhan December 12, 2025 06:10

pelikhan reviewed Dec 12, 2025

View reviewed changes

Copilot started work on behalf of pelikhan December 12, 2025 06:13 View session

Rephrase summary message to avoid pluralization and remove pluralize …

ea40e0c

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

Copilot AI requested a review from pelikhan December 12, 2025 06:20

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

pelikhan closed this Dec 12, 2025

pelikhan deleted the copilot/add-proactive-staleness-warnings branch December 15, 2025 04:49

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add proactive staleness warnings with actionable guidance to status command#6211

Add proactive staleness warnings with actionable guidance to status command#6211
Copilot wants to merge 6 commits intomainfrom
copilot/add-proactive-staleness-warnings

Copilot AI commented Dec 12, 2025 •

edited

Loading

Uh oh!

pelikhan commented Dec 12, 2025

Uh oh!

Copilot AI commented Dec 12, 2025

Uh oh!

pelikhan Dec 12, 2025

Uh oh!

Copilot AI Dec 12, 2025

Uh oh!

pelikhan Dec 12, 2025

Uh oh!

Copilot AI Dec 12, 2025

Uh oh!

pelikhan Dec 12, 2025

Uh oh!

Copilot AI Dec 12, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

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

Uh oh!

Plan: Add Proactive Staleness Warnings with Actionable Guidance

Implementation Summary

Features Added

Testing

Files Modified

Design Decisions

Context

Approach

1. Enhance WorkflowStatus Struct

2. Add Summary Footer

3. Add Color Coding

4. Add --fix-suggestions Flag

Files to Modify

Acceptance Criteria

Comments on the Issue (you are @copilot in this section)

Uh oh!

pelikhan commented Dec 12, 2025

Uh oh!

Copilot AI commented Dec 12, 2025

Uh oh!

pelikhan Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

pelikhan Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

pelikhan Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented Dec 12, 2025 •

edited

Loading