Skip to content

Commit e83e008

Browse files
docs: fix filter-ir gate-eval distribution description (#508)
1 parent 12c2866 commit e83e008

1 file changed

Lines changed: 10 additions & 6 deletions

File tree

docs/filter-ir.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -302,7 +302,7 @@ The spec is declarative — it uses fact *kinds* (e.g., `"pr_title"`,
302302
`"pr_metadata"`) not raw REST endpoints. The Python evaluator owns
303303
acquisition logic.
304304

305-
#### Python Gate Evaluator (`src/data/gate-eval.py`)
305+
#### Python Gate Evaluator (`scripts/gate-eval.py`)
306306

307307
The evaluator is a self-contained Python script embedded via
308308
`include_str!()`. It handles:
@@ -355,8 +355,9 @@ When Tier 2/3 filters are configured, the `TriggerFiltersExtension`
355355
(`src/compile/extensions/trigger_filters.rs`) activates via
356356
`collect_extensions()`. It implements `CompilerExtension` and controls:
357357

358-
1. **Download step** — fetches `gate-eval.py` from the ado-aw release
359-
artifacts to `/tmp/ado-aw-scripts/gate-eval.py`
358+
1. **Download step** — downloads `scripts.zip` from the ado-aw release
359+
artifacts, verifies its SHA256 checksum via `checksums.txt`, then
360+
extracts `gate-eval.py` to `/tmp/ado-aw-scripts/gate-eval.py`
360361
2. **Gate step** — calls `compile_gate_step_external()` to generate a step
361362
that references the downloaded script (no inline heredoc)
362363
3. **Validation** — runs `validate_pr_filters()` / `validate_pipeline_filters()`
@@ -405,9 +406,12 @@ The `expression` escape hatch is also ANDed if present.
405406
### Scripts Distribution
406407

407408
`gate-eval.py` lives at `scripts/gate-eval.py` in the repository and is
408-
shipped as a release artifact alongside the ado-aw binary. The download URL
409-
is deterministic based on the ado-aw version:
410-
`https://github.com/githubnext/ado-aw/releases/download/v{VERSION}/gate-eval.py`
409+
shipped inside a `scripts.zip` archive alongside the ado-aw binary. The
410+
download URL is deterministic based on the ado-aw version:
411+
`https://github.com/githubnext/ado-aw/releases/download/v{VERSION}/scripts.zip`
412+
413+
A `checksums.txt` file is also published at the same URL base and used to
414+
verify the SHA256 integrity of `scripts.zip` before extraction.
411415

412416
## Adding New Filter Types
413417

0 commit comments

Comments
 (0)