From 6a090dac9535fddb15ba82234d06c4e52ed6d5f0 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 05:22:17 +0000
Subject: [PATCH] docs: document export-fact-catalog hidden build-time tool

Add the missing export-fact-catalog command to docs/cli.md (Hidden
Build-Time Tools section) and update AGENTS.md docs index to mention it
alongside export-gate-schema.

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

diff --git a/AGENTS.md b/AGENTS.md
index 41667fac..a7a07c60 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -353,7 +353,7 @@ index to jump to the right page.
   `check`, `mcp`, `mcp-http`, `execute`, `secrets`, `enable`, `disable`,
   `remove`, `list`, `status`, `run`, `audit`, `mcp-author`, `trace`,
   `inspect`, `graph`, `whatif`, `lint`, `catalog`; `configure` is a
-  deprecated hidden alias and `export-gate-schema` is a hidden build-time tool).
+  deprecated hidden alias and `export-gate-schema` / `export-fact-catalog` are hidden build-time tools).
 - [`docs/agency-plugin.md`](docs/agency-plugin.md) — the Agency / Claude Code
   plugin (`agency/plugins/ado-aw/`): canonical layout, six skills, `mcp-author`
   wiring, the self-contained root marketplace catalogs, `init --agency`
diff --git a/docs/cli.md b/docs/cli.md
index 4bc2dbe7..7086f1c8 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -186,6 +186,8 @@ These commands are not shown in `--help` but are available for contributors work
 - `export-gate-schema` - Export the gate spec JSON Schema used by the `scripts/ado-script` TypeScript workspace for type codegen. Outputs JSON to stdout or to a file.
   - `--output, -o <path>` - Write the schema to a file instead of stdout. Parent directories are created automatically.
   - See [`docs/ado-script.md`](ado-script.md) for how this command fits into the ado-script build workflow (`cargo run -- export-gate-schema --output schema/gate-spec.schema.json`).
+- `export-fact-catalog` - Export the fact catalog JSON (kind, failure_policy, and dependencies for every gate `Fact`) — build-time drift guard for the trigger-e2e `FACT_META` mirror in the `scripts/ado-script` TypeScript workspace.
+  - `--output, -o <path>` - Write the catalog to a file instead of stdout.
 
 ## Pipeline IR Reference