From 084693f48e46375bc38f31491bada679268081ca Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Fri, 18 Sep 2026 20:42:44 +0000 Subject: [PATCH] docs: fix mcp-author tool surface drift (graph_dump json format, catalog ado-proxy kind) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- docs/mcp-author.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/mcp-author.md b/docs/mcp-author.md index 4c9327967..7c4e327a6 100644 --- a/docs/mcp-author.md +++ b/docs/mcp-author.md @@ -17,13 +17,13 @@ workflows. | --- | --- | --- | | `inspect_workflow` | Build and return the public `PipelineSummary`. | `{ "source_path": "agents/example.md" }` | | `graph_summary` | Return the resolved `GraphSummary`. | `{ "source_path": "agents/example.md" }` | -| `graph_dump` | Render the graph as text or Graphviz DOT. | `{ "source_path": "...", "format": "text" \| "dot" }` | +| `graph_dump` | Render the graph as text, structured `GraphSummary` JSON, or Graphviz DOT. | `{ "source_path": "...", "format": "text" \| "json" \| "dot" }` | | `step_dependencies` | Traverse dependencies for a step or job id. | `{ "source_path": "...", "step_id": "Agent", "direction": "upstream" \| "downstream" }` | | `step_outputs` | List declared outputs and consumers. | `{ "source_path": "...", "producer": null, "consumer": null }` | | `trace_failure` | Trace a build's failed-job chain using audit data plus any local IR graph. | `{ "build_id_or_url": "123", "step": null, "org": null, "project": null, "pat": null }` | | `whatif` | Classify downstream jobs if a step or job fails. | `{ "source_path": "...", "failing_id": "Agent" }` | | `lint_workflow` | Run structural lint checks. | `{ "source_path": "agents/example.md" }` | -| `catalog` | List safe-outputs, runtimes, tools, engines, models, and pinned versions. | `{ "kind": "safe-outputs" }` | +| `catalog` | List safe-outputs, runtimes, tools, engines, models, pinned versions, and the `ado-proxy` policy catalog. | `{ "kind": "safe-outputs" }` | | `audit_build` | Download and analyze a build; same shape as `ado-aw audit --json`. | `{ "build_id_or_url": "123", "org": null, "project": null, "pat": null, "artifacts": null, "no_cache": false }` | ## Trust model