From eeb9bc463878a01683f7122602e68cea93481c92 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 16 Jul 2026 05:36:08 +0000
Subject: [PATCH] docs: add trigger-e2e and __tests__ dirs to AGENTS.md
 architecture tree
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Both directories exist in scripts/ado-script/src/ but were missing from
the architecture tree:

- trigger-e2e/ — defines FACT_META (TypeScript mirror of the Rust Fact
  registry), fact-catalog.gen.json (drift-guard artifact generated by
  `export-fact-catalog`), and gate-spec.test.ts (CI drift check).
  This directory is already cross-referenced in docs/cli.md for the
  `export-fact-catalog` command but was absent from the tree.
- __tests__/ — top-level ado-script unit tests (bundle-coverage.test.ts).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 AGENTS.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 41667fac..3baa5d03 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -269,6 +269,8 @@ fail-closed and only pauses when the agent actually proposed a reviewed output.
 │           ├── 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)
 │           ├── 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)
+│           ├── trigger-e2e/ # Trigger/filter E2E test harness: gate-spec.ts defines FACT_META (the TypeScript mirror of the Rust Fact registry); fact-catalog.gen.json is the committed drift-guard artifact generated by `cargo run -- export-fact-catalog`; gate-spec.test.ts deep-compares FACT_META against that artifact in CI
+│           ├── __tests__/   # Top-level ado-script unit tests (bundle-coverage.test.ts)
 │           └── shared/   # Shared modules across bundles (auth, ado-client, env-facts, types.gen.ts)
 ├── tests/                # Integration tests and fixtures
 ├── docs/                 # Per-concept reference documentation (see index below)