From 10f1f7b68ddad72b7c2159c86c4b081986ab3eff Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 25 Jul 2026 05:34:51 +0000 Subject: [PATCH] docs: add compiler-smoke-e2e to ado-script architecture tree The scripts/ado-script/src/compiler-smoke-e2e/ directory exists in the filesystem but was missing from both the AGENTS.md architecture tree and docs/ado-script.md. Add it to both locations alongside the existing executor-e2e and trigger-e2e entries, with a description matching the implementation in scripts/ado-script/src/compiler-smoke-e2e/index.ts. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- AGENTS.md | 1 + docs/ado-script.md | 14 +++++++++++++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 556717cd..0f0309b3 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) +│ ├── compiler-smoke-e2e/ # CI compiler smoke-test harness (not a bundle; stages the compiler candidate via supply-chain.pipeline-artifact across 5 fixtures, pushes to a short-lived mirror branch, queues the candidate-lane pipelines, and asserts they all go green) │ ├── prepare-pr-base/ # create-pull-request preparer (bundled to prepare-pr-base.js): Agent mode uses ADO diff metadata + bounded dual-ref fallback to make the merge-base reachable; SafeOutputs mode fetches only the target worktree tip │ ├── trigger-e2e/ # Test-only gate-spec / trigger-evaluation harness (not a bundle): mirrors Rust `Fact::ALL` in `gate-spec.ts`; `fact-catalog.gen.json` is generated by `export-fact-catalog` and drift-guarded by CI │ └── shared/ # Shared modules across bundles (auth, ado-client, env-facts, types.gen.ts) diff --git a/docs/ado-script.md b/docs/ado-script.md index dbcb9021..71c9b193 100644 --- a/docs/ado-script.md +++ b/docs/ado-script.md @@ -101,6 +101,17 @@ 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: `compiler-smoke-e2e`.** The workspace also +> contains a `src/compiler-smoke-e2e/` harness that orchestrates the CI +> compiler smoke E2E suite. It stages the compiler candidate produced by the +> current PR or nightly `main` build as a `supply-chain.pipeline-artifact` +> source across the five real fixtures documented in +> `tests/safe-outputs/README.md`, pushes to a short-lived branch on the mirror +> repo, queues the five FIXED "candidate lane" pipeline definitions (tracked in +> `tests/compiler-smoke-e2e/REGISTERED.md`), and asserts they all go green. It +> is **not** a runtime bundle and is not part of the main `build` chain. The +> compiler never references it directly. + > **Test-only, not shipped: `trigger-e2e`.** The workspace also contains a > `src/trigger-e2e/` harness (with its own `__tests__/` subdirectory) that > provides the `FACT_META` gate-spec table and end-to-end trigger-evaluation @@ -564,7 +575,8 @@ scripts/ado-script/ │ │ ├── gate-spec.ts # FACT_META mirror of Rust Fact::ALL; drift-guarded by export-fact-catalog + fact-catalog.gen.json │ │ ├── fact-catalog.gen.json # generated by `cargo run -- export-fact-catalog`; deep-compared by gate-spec.test.ts │ │ └── __tests__/ # gate-spec drift tests and trigger-evaluation scenario tests -│ └── executor-e2e/ # test-only: Stage 3 safe-output E2E harness (not a bundle; built to test-bin/executor-e2e.js) +│ ├── executor-e2e/ # test-only: Stage 3 safe-output E2E harness (not a bundle; built to test-bin/executor-e2e.js) +│ └── compiler-smoke-e2e/ # test-only: CI compiler smoke-test harness (not a bundle; stages the compiler candidate across 5 fixtures on a mirror branch and asserts the candidate-lane pipelines go green) ├── test/ # End-to-end smoke tests (gate, import, exec-context-pr) ├── gate.js # ncc bundle output (gitignored) ├── import.js # ncc bundle output (gitignored)