feat: add new wait-for-workflow composite action

[FidelusAleksander]

Changes

This pull request introduces a new GitHub Action called "Wait for Workflow Run" that allows one workflow to wait for another workflow run to reach a specified status, without relying on the workflow_run trigger. The changes provide a reusable composite action with configurable inputs and outputs, along with clear documentation for usage.

New GitHub Action: Wait for Workflow Run

• Action implementation and configuration:
  Added action.yml defining the composite action, its inputs (such as workflow-id, head-sha, status, polling interval, timeout, etc.), outputs (the workflow run's conclusion), and the polling logic using actions/github-script. This enables workflows to wait for another workflow run to reach a target status, with timeout and error handling.

Documentation

• Comprehensive README:
  Added README.md with a description of the action, input/output details, and a usage example, making it easy for users to understand and integrate the action into their workflows.

Example

I'm using this in reusable-workflows exercise

Checklist

• I have added or updated appropriate labels to this PR
• I have tested my changes
• I have updated the documentation if needed

[Copilot]

Pull request overview

Adds a new reusable composite GitHub Action (wait-for-workflow) that polls the GitHub Actions API until a workflow run reaches a target status, plus documentation for using it in workflows.

Changes:

• Added actions/wait-for-workflow/action.yml implementing polling, timeout handling, and outputting the run conclusion.
• Added actions/wait-for-workflow/README.md documenting inputs/outputs and providing a usage example.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

File	Description
actions/wait-for-workflow/action.yml	New composite action that polls actions.listWorkflowRuns until the run reaches the requested status, then outputs the conclusion (or timeout).
actions/wait-for-workflow/README.md	Usage docs for the new action, including input/output reference and sample workflow snippet.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.