githubnext / githubnext/ado-aw
docs: fix AGENTS.md accuracy — add trigger-e2e to ado-script tree and export-fact-catalog to CLI index
- Dominant language
- Rust
- Stars
- 23
- Forks
- 8
- Avg merge
- 4d 9h
- Merged PRs (30d)
- 22
Description
## 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
- [x] Added `trigger-e2e/` entry to the `scripts/ado-script/src/` architecture tree, with description matching `docs/ado-script.md`
- [x] 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](https://github.com/githubnext/ado-aw/actions/runs/29710255499) · 115.8 AIC · ⌖ 11.9 AIC · ⊞ 8.7K · [◷](https://github.com/search?q=repo%3Agithubnext%2Fado-aw+%22gh-aw-workflow-id%3A+doc-freshness-check%22&type=pullrequests)
---
> [!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`](https://github.com/githubnext/ado-aw/tree/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:
```sh
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)
```diff
From 9a215b180f66d67f45bcd02e3f47666b55e0d4bb Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
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)
```
Contributor guide
No contributing guide indexed for this repository
Research direction
Review AGENTS.md, then compare its scripts/ado-script/src/ tree with the directory listing and check src/main.rs for the hidden Commands variants. Use docs/ado-script.md and docs/cli.md as the existing references; done means AGENTS.md accurately lists trigger-e2e and both hidden build-time CLI tools, with the documentation changes verified.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- rust
- Domain
- cli, documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 25/100