Initial workflow-stopper setup for Pezkuwi SDK CI/CD

README.md

@@ -0,0 +1,35 @@
+# Pezkuwi Workflow Stopper
+
+Stops all running and queued workflows in a repository when a CI job fails. This saves compute resources by preventing unnecessary workflow runs from continuing after a failure is detected.
+
+## How It Works
+
+1. When a CI job fails in `pezkuwi-sdk`, the `workflow-stopper` action is triggered
+2. This action dispatches a workflow in this repository
+3. The workflow uses GitHub API to cancel all running/queued workflows for the same commit SHA
+
+## Setup
+
+### Required Secrets
+
+In this repository (`pezkuwichain/workflow-stopper`):
+- `WORKFLOW_STOPPER_TOKEN` - A GitHub PAT or App token with `actions:write` permission on `pezkuwichain/pezkuwi-sdk`
+
+In the target repository (`pezkuwichain/pezkuwi-sdk`):
+- `WORKFLOW_STOPPER_RUNNER_APP_ID` - GitHub App ID
+- `WORKFLOW_STOPPER_RUNNER_APP_KEY` - GitHub App private key
+
+### GitHub App Setup
+
+1. Create a GitHub App in your organization settings
+2. Grant it `actions:write` permission
+3. Install it on both `workflow-stopper` and `pezkuwi-sdk` repositories
+4. Add the App ID and private key as secrets
+
+## Usage
+
+This workflow is triggered via `workflow_dispatch` from the `pezkuwi-sdk` repository's CI pipelines.
+
+## License
+
+Apache-2.0 (same as Pezkuwi SDK)