Skip to content

docs: fix CLI and architecture-tree drift for ado-proxy export commands #1855

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
github-actions wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

docs: fix CLI and architecture-tree drift for ado-proxy export commands #1855

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -164,6 +164,7 @@ fail-closed and only pauses when the agent actually proposed a reviewed output.
│ │ ├── url.rs # Build-reference parsing (bare ID, full ADO URL)
│ │ ├── analyzers/ # Per-signal analyzers that populate AuditData sections
│ │ │ ├── mod.rs
│ │ │ ├── ado_proxy.rs # Sanitized ado-proxy decision/lifecycle log analysis
│ │ │ ├── custom_jobs.rs # Job-level audit correlation for custom safe-output jobs
│ │ │ ├── detection.rs # Detection-stage artifact analysis
│ │ │ ├── firewall.rs # AWF network log analysis
Expand Down Expand Up @@ -395,7 +396,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`
Expand Down
6 changes: 6 additions & 0 deletions docs/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -192,6 +192,12 @@ These commands are not shown in `--help` but are available for contributors work
- `--output, -o <path>` - 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 `ado-proxy` catalog JSON Schema, used by the `ado-proxy` TypeScript bundle for type codegen (`../shared/ado-proxy-catalog.types.gen.ts`).
- `--output, -o <path>` - Write the schema to a file instead of stdout. Parent directories are created automatically.

- `export-ado-proxy-catalog` - Export the versioned `ado-proxy` operation catalog data as JSON (`catalog.gen.json`). Drift-guards the `ado-proxy` bundle's committed catalog snapshot against the Rust-side catalog in `src/ado_proxy/catalog.rs`; a `catalog_version` mismatch fails closed at ado-proxy startup.
- `--output, -o <path>` - Write the catalog to a file instead of stdout. Parent directories are created automatically.

### 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:
Expand Down