From 571a6c6aec61e038ca01a58d1d853c318736d5c9 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 7 Aug 2026 12:47:31 +0000 Subject: [PATCH] docs: document hidden export-ado-proxy-catalog CLI commands --- AGENTS.md | 4 +++- docs/cli.md | 8 ++++++++ 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 3f3727e2..283c3363 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -395,7 +395,9 @@ index to jump to the right page. `check`, `mcp`, `execute`, `secrets`, `enable`, `disable`, `remove`, `list`, `status`, `run`, `audit`, `mcp-author`, `trace`, `inspect`, `graph`, `whatif`, `lint`, `catalog`; `configure` is a - deprecated hidden alias; `export-gate-schema` and `export-fact-catalog` are hidden build-time tools). + deprecated hidden alias; `export-gate-schema`, `export-fact-catalog`, + `export-ado-proxy-catalog-schema`, and `export-ado-proxy-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 29bee84f..bc061284 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -192,6 +192,14 @@ These commands are not shown in `--help` but are available for contributors work - `--output, -o ` - Write the catalog to a file instead of stdout. Parent directories are created automatically. - Typical use: `cargo run -- export-fact-catalog --output scripts/ado-script/src/trigger-e2e/fact-catalog.gen.json` +- `export-ado-proxy-catalog-schema` - Export the JSON Schema for the `ado-proxy` deny-by-default operation catalog, used for TypeScript type codegen in `scripts/ado-script/src/ado-proxy/`. + - `--output, -o ` - Write the schema to a file instead of stdout. Parent directories are created automatically. + - See [`docs/ado-script.md`](ado-script.md#bundle-inventory) for how this fits into the `ado-proxy` build workflow. + +- `export-ado-proxy-catalog` - Export the versioned `ado-proxy` catalog data as JSON (`catalog.gen.json`). Drift-guarded against `scripts/ado-script/src/ado-proxy/catalog.gen.json` by `catalog-drift.test.ts`; a `catalog_version` mismatch fails closed at runtime. + - `--output, -o ` - Write the catalog to a file instead of stdout. Parent directories are created automatically. + - Typical use: `cargo run -- export-ado-proxy-catalog --output scripts/ado-script/src/ado-proxy/catalog.gen.json` + ### Hidden Pipeline-Internal Commands These commands are started by the pipeline itself (or by AWF on its behalf) and are not part of the authoring surface: