Improve help text for outputs when used in nested composite actions

Co-authored-by: MariusStorhaug <[email protected]>

Author: Copilot

scripts/outputs.ps1

@@ -35,10 +35,20 @@ try {
         $blue = $PSStyle.Foreground.Blue
         $reset = $PSStyle.Reset
         LogGroup " - $blue$($output.Name)$reset" {
-            $outputAccess = "Accessible via: [$blue`${{ fromJson(steps.$env:GITHUB_ACTION.outputs.result).$($output.Name) }}$reset]"
-            $outputFence = ('─' * ($outputAccess.Length - 9))
-            Write-Output $outputAccess
-            Write-Output $outputFence
+            # Provide help text for both direct and nested usage scenarios
+            if (-not [string]::IsNullOrEmpty($env:GITHUB_ACTION)) {
+                $directUsage = "Direct usage: [$blue`${{ fromJson(steps.$env:GITHUB_ACTION.outputs.result).$($output.Name) }}$reset]"
+                $nestedUsage = "Nested usage: [$blue`${{ fromJson(steps.<your-step-id>.outputs.result).$($output.Name) }}$reset]"
+                Write-Output $directUsage
+                Write-Output $nestedUsage
+                $outputFence = ('─' * ([Math]::Max($directUsage.Length, $nestedUsage.Length) - 9))
+                Write-Output $outputFence
+            } else {
+                $genericUsage = "Accessible via: [$blue`${{ fromJson(steps.<step-id>.outputs.result).$($output.Name) }}$reset]"
+                Write-Output $genericUsage
+                $outputFence = ('─' * ($genericUsage.Length - 9))
+                Write-Output $outputFence
+            }
             $output.Value | Format-List | Out-String
         }
     }