From e032775eba18ff4663a0647f993c5cb511bc9dd2 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 14 Jul 2026 20:52:33 +0000 Subject: [PATCH] docs: add trigger-e2e test harness to architecture tree and ado-script reference The scripts/ado-script/src/trigger-e2e/ directory exists in the repo as a deterministic trigger-condition E2E harness (analogous to executor-e2e) but was not mentioned in AGENTS.md or docs/ado-script.md. - Add trigger-e2e/ entry to AGENTS.md architecture tree - Add 'Test-only, not shipped: trigger-e2e' callout to docs/ado-script.md Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- AGENTS.md | 1 + docs/ado-script.md | 9 +++++++++ 2 files changed, 10 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 41667fac..d910cf40 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -268,6 +268,7 @@ fail-closed and only pauses when the agent actually proposed a reviewed output. │ ├── approval-summary/ # Safe-outputs summary renderer (bundled to approval-summary.js; end-of-Agent-job summary tab) │ ├── github-app-token/ # GitHub App token minter (bundled to github-app-token.js; mints installation token in Agent + Detection when engine.github-app-token is set) │ ├── executor-e2e/ # Stage 3 safe-output E2E test harness (not a bundle; runs deterministic scenarios against a real ADO project and files a GitHub issue on failure) +│ ├── trigger-e2e/ # Trigger-condition (gate / synth-PR) E2E test harness (not a bundle; queues a victim pipeline under a battery of trigger scenarios and files a GitHub issue on failure) │ ├── prepare-pr-base/ # create-pull-request base-ref preparer (bundled to prepare-pr-base.js; fetches/deepens target branch so mcp.rs finds a diff base on shallow-default pools — issue #1413; emitted in BOTH the Agent job and the SafeOutputs job before the executor's worktree add — issue #1453) │ └── shared/ # Shared modules across bundles (auth, ado-client, env-facts, types.gen.ts) ├── tests/ # Integration tests and fixtures diff --git a/docs/ado-script.md b/docs/ado-script.md index 10a7dd81..a55e1e1b 100644 --- a/docs/ado-script.md +++ b/docs/ado-script.md @@ -106,6 +106,15 @@ pipeline** as runtime helpers. Today it produces thirteen bundles: > `NON_BUNDLE_DIRS` in `src/__tests__/bundle-coverage.test.ts` so the > shipped-bundle guard ignores it. The compiler never references it. +> **Test-only, not shipped: `trigger-e2e`.** The workspace also contains a +> `src/trigger-e2e/` harness that drives the deterministic trigger-condition +> (gate / synth-PR) E2E suite. It queues a victim pipeline under a battery of +> real trigger scenarios, asserts the observable gate decision (build tags + +> result), and files a GitHub issue on failure. It is **not** a runtime bundle: +> it is built separately by `npm run build:trigger-e2e` and listed in +> `NON_BUNDLE_DIRS` so the shipped-bundle guard ignores it. The compiler never +> references it. + ## What `gate.js` does `gate.js` is a single-shot Node program that runs as a step in the