Skip to content

docs: fix AGENTS.md accuracy — add trigger-e2e to ado-script tree and export-fact-catalog to CLI index #1583

Description

@github-actions

Agent Documentation Update

Findings

Area Issue File(s)
Architecture tree trigger-e2e/ directory missing from scripts/ado-script/src/ listing AGENTS.md
CLI documentation index Only export-gate-schema listed as a hidden build-time tool; export-fact-catalog omitted AGENTS.md

Applied Fixes

  • Added trigger-e2e/ entry to the scripts/ado-script/src/ architecture tree, with description matching docs/ado-script.md
  • Updated the docs/cli.md index entry to list both export-gate-schema and export-fact-catalog as hidden build-time tools

Notes

Verified against:

  • scripts/ado-script/src/ directory listing confirms trigger-e2e/ exists alongside executor-e2e/, prepare-pr-base/, shared/, etc.
  • src/main.rs Commands enum confirms both ExportGateSchema and ExportFactCatalog are #[command(hide = true)] variants
  • docs/ado-script.md lines 109 and 568 already document trigger-e2e/ correctly — this brings AGENTS.md into sync
  • docs/cli.md lines 186–192 already documents both hidden tools correctly — this brings AGENTS.md into sync

Created by the agent-documentation maintainer workflow.

Generated by Agent Documentation Maintainer · 115.8 AIC · ⌖ 11.9 AIC · ⊞ 8.7K ·


Note

This was originally intended as a pull request, but PR creation failed. The changes have been pushed to the branch docs/fix-agents-md-accuracy-d749e633e7aceed4.

Original error: ERR_API: [2026-07-20T01:17:52.860Z] create pull request in githubnext/ado-aw failed after 5 retry attempts

Original error: No server is currently available to service your request. Sorry about that. Please try resubmitting your request and contact us if the problem persists.
Retryable: true
Suggestion: All retry attempts exhausted. This may be a persistent issue. Check GitHub status or try again later.

To create the pull request manually:

gh pr create --title "docs: fix AGENTS.md accuracy — add trigger-e2e to ado-script tree and export-fact-catalog to CLI index" --base main --head docs/fix-agents-md-accuracy-d749e633e7aceed4 --repo githubnext/ado-aw
Show patch preview (43 of 43 lines)
From 9a215b180f66d67f45bcd02e3f47666b55e0d4bb Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Mon, 20 Jul 2026 01:04:16 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20fix=20AGENTS.md=20accuracy=20=E2=80=94?=
 =?UTF-8?q?=20add=20trigger-e2e=20to=20ado-script=20tree=20and=20export-fa?=
 =?UTF-8?q?ct-catalog=20to=20CLI=20index?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add missing trigger-e2e/ directory entry in scripts/ado-script/src/ architecture tree
- Update docs/cli.md index entry to list both export-gate-schema and export-fact-catalog as hidden build-time tools

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

diff --git a/AGENTS.md b/AGENTS.md
index 41667fa..9da1188 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -269,6 +269,7 @@ 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/ # Test-only: FACT_META gate-spec table + trigger-evaluation E2E scenarios (not a bundle; drift-guarded by export-fact-catalog + fact-catalog.gen.json)
 │           └── shared/   # Shared modules across bundles (auth, ado-client, env-facts, types.gen.ts)
 ├── tests/                # Integratio
... (truncated)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions