Add raptor-download-url input to override the raptor binary source

Optional input; when non-empty the install step downloads the raptor
linux-amd64 binary from that exact URL (raptor_version ignored), otherwise
behavior is unchanged. Escape hatch for testing/pre-release raptor builds
and enterprise mirrors. Documented in the README inputs table.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: anujhydrabadi

module-ci-action/README.md

@@ -63,7 +63,8 @@ modules live at `infra/modules/...`).
 | `username` | yes | — | Facets username. Pass the `FACETS_USERNAME` secret. |
 | `token` | yes | — | Facets API token. Pass the `FACETS_TOKEN` secret. |
 | `github_token` | no | `""` | GitHub token. Enables the PR **preview comment** and, in **cleanup**, reading the PR's commit SHAs for the ownership check. When absent, those are skipped (cleanup does nothing, safely). |
-| `raptor_version` | no | `latest` | `latest`, or an exact release tag such as `v1.2.3`. |
+| `raptor_version` | no | `latest` | `latest`, or an exact release tag such as `v1.2.3`. Ignored when `raptor-download-url` is set. |
+| `raptor-download-url` | no | `""` | Exact URL to download the raptor `linux-amd64` binary from, bypassing the default `Facets-cloud/raptor-releases` location. When set, `raptor_version` is ignored. An escape hatch for testing / pre-release raptor builds and enterprise mirrors. |
 | `all-modules` | no | `false` | When `true`, operate on **every** module under `<path-prefix>modules/` instead of only the ones the event changed. |
 | `mode` | no | `auto` | `auto` \| `preview` \| `publish` \| `cleanup`. `auto` derives the mode from the event (see the table above). Set explicitly to override. |
 | `path-prefix` | no | `""` | Sub-path to the `modules/` tree relative to the repo root (e.g. `infra/`). Empty means `modules/` is at the root. |

module-ci-action/action.yml

@@ -17,9 +17,13 @@ inputs:
     required: false
     default: ""
   raptor_version:
-    description: "raptor CLI version to install: 'latest' or an exact release tag (e.g. v1.2.3)."
+    description: "raptor CLI version to install: 'latest' or an exact release tag (e.g. v1.2.3). Ignored when raptor-download-url is set."
     required: false
     default: "latest"
+  raptor-download-url:
+    description: "Exact URL to download the raptor linux-amd64 binary from, bypassing the default Facets-cloud/raptor-releases location. When set, raptor_version is ignored. Escape hatch for testing/pre-release builds and enterprise mirrors."
+    required: false
+    default: ""
   all-modules:
     description: "When 'true', operate on every module under <path-prefix>modules/ instead of only the ones changed by the triggering event."
     required: false
@@ -46,7 +50,11 @@ runs:
       run: |
         set -euo pipefail
         VERSION="${{ inputs.raptor_version }}"
-        if [ -z "$VERSION" ] || [ "$VERSION" = "latest" ]; then
+        DOWNLOAD_URL="${{ inputs.raptor-download-url }}"
+        if [ -n "$DOWNLOAD_URL" ]; then
+          # Explicit override: fetch the binary from exactly this URL (raptor_version ignored).
+          URL="$DOWNLOAD_URL"
+        elif [ -z "$VERSION" ] || [ "$VERSION" = "latest" ]; then
           URL="https://github.com/Facets-cloud/raptor-releases/releases/latest/download/raptor-linux-amd64"
         else
           URL="https://github.com/Facets-cloud/raptor-releases/releases/download/${VERSION}/raptor-linux-amd64"