Add fallback resolution for workflows in .github/workflows/ directory

[Copilot]

Problem

The add command was unable to resolve workflow files stored in .github/workflows/ when using the three-part specification format. For example:

gh aw add githubnext/aw-wsg/3_15-ensure-that-your-code-is-secure

This command would fail because it only looked for workflows at:

<package>/githubnext/aw-wsg/workflows/3_15-ensure-that-your-code-is-secure.md

But the actual file was located at:

<package>/githubnext/aw-wsg/.github/workflows/3_15-ensure-that-your-code-is-secure.md

Solution

This PR implements a fallback mechanism in the findWorkflowInPackageForRepo function. When a workflow path starting with workflows/ is not found at the initial location, the function now automatically tries .github/workflows/ as a fallback.

The fallback logic:

1. Attempts to read from the original workflows/ path
2. If that fails and the path starts with workflows/, extracts the filename and tries .github/workflows/
3. Returns an error only if both attempts fail

Example

After this change, the following command now works correctly:

gh aw add githubnext/aw-wsg/3_15-ensure-that-your-code-is-secure

It successfully resolves to @githubnext/aw-wsg/.github/workflows/3_15-ensure-that-your-code-is-secure.md.

Testing

Added comprehensive test coverage with 4 new tests:

• Verifies fallback behavior when only .github/workflows/ path exists
• Verifies original path is prioritized when it exists
• Verifies proper error handling when neither path exists
• Verifies non-workflows/ paths don't trigger fallback

All existing tests continue to pass, ensuring backward compatibility.

Backward Compatibility

This change is fully backward compatible:

• If a workflow exists at workflows/, it will be used (no behavior change)
• The fallback only activates when the original path doesn't exist
• Custom paths (not starting with workflows/) are unaffected

Original prompt

Update the "add" command to try to resolve the agentic workflow file from the ".github/workflows" folder if it does not find it immediately using the full relative path.

So this command should work:

gh aw add githubnext/aw-wsg/3_15-ensure-that-your-code-is-secure 

and resolve to @githubnext/aw-wsg/files/.github/workflows/3_15-ensure-that-your-code-is-secure.md

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[github-actions]

Agentic Changeset Generator triggered by this pull request