🩹 [Patch]: Improve help text on output when this action is used inside another composite action

[Copilot]

Problem

When the GitHub-Script action is used directly in a workflow, the output help text correctly shows:

${{ fromJson(steps.my-step-id.outputs.result).MyOutput }}

However, when the GitHub-Script action is used inside another composite action, this help text becomes incorrect because users need to reference the outer composite action's step ID, not the internal step ID.

Example of the issue:

# Direct usage (help text is correct)
- uses: PSModule/GitHub-Script@v1
  id: my-script
# Access: ${{ fromJson(steps.my-script.outputs.result).MyOutput }}

# Nested in composite action (help text was wrong)
- uses: my-org/my-composite@v1  # internally uses GitHub-Script
  id: my-composite
# Need: ${{ fromJson(steps.my-composite.outputs.result).MyOutput }}
# But help showed: ${{ fromJson(steps.internal-id.outputs.result).MyOutput }}

Solution

Modified scripts/outputs.ps1 to provide comprehensive help text that covers both scenarios:

When step ID is available:

• Direct usage: ${{ fromJson(steps.actual-step-id.outputs.result).OutputName }}
• Nested usage: ${{ fromJson(steps.<your-step-id>.outputs.result).OutputName }}

When step ID is unavailable (fallback):

• Generic: ${{ fromJson(steps.<step-id>.outputs.result).OutputName }}

Changes Made

• Enhanced help text generation logic in scripts/outputs.ps1
• Added conditional display showing both direct and nested usage examples
• Improved fence line calculation to handle variable text lengths
• Maintained backward compatibility and existing functionality

Testing

• ✅ Integration tests confirm both scenarios work correctly
• ✅ Syntax validation passed for all PowerShell scripts
• ✅ Edge cases handled (missing GITHUB_ACTION)
• ✅ Minimal code changes (only modified help text display)

Fixes #54

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• www.powershellgallery.com
  • Triggering command: pwsh -c Install-Module -Name PSScriptAnalyzer -Force -Scope CurrentUser (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to my firewall allow list

---

💡 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.

[MariusStorhaug]

Try again