docs: add versions to catalog descriptions in AGENTS.md and mcp-author.md#1479
Merged
jamesadevine merged 1 commit intoJul 13, 2026
Merged
Conversation
…hor.md The catalog command/tool exposes a 'versions' category that emits the compiler's pinned semver versions (copilot_cli, awf, mcpg). This was accurately documented in docs/cli.md but omitted from: - AGENTS.md: catalog.rs module description listed "(tools, runtimes, models, etc.)" — now lists all six categories explicitly. - docs/mcp-author.md: catalog tool row said "engines, and models" — now says "engines, models, and pinned versions" matching the source tool description in src/mcp_author/mod.rs. Verified against src/inspect/catalog.rs models() / engines() functions and the CatalogParams comment in src/mcp_author/mod.rs. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Agent Documentation Update
Findings
catalogcommand/tool descriptions omit theversionscategoryAGENTS.md,docs/mcp-author.mdApplied Fixes
AGENTS.mdline 170:catalog.rsmodule description now lists all six catalog categories —safe-outputs, runtimes, tools, engines, models, pinned versions— instead of the vague(tools, runtimes, models, etc.).docs/mcp-author.mdtable row forcatalog: description updated from "engines, and models" to "engines, models, and pinned versions", matching the tool's actualdescriptionstring insrc/mcp_author/mod.rs.Notes
The
versionscategory emits the compiler's pinned semver versions forcopilot_cli,awf, andmcpg— used by CI to read version pins without scraping Rust source (e.g.ado-aw catalog --kind versions --json | jq -r '.versions.copilot_cli'). It was accurately documented indocs/cli.mdbut omitted from the two files above.Verified against:
src/inspect/catalog.rs—models(),engines(), andCatalogResultstructsrc/mcp_author/mod.rs—CatalogParamsdoc comment andcatalogtool description stringdocs/cli.md— already accurate reference:--kind <safe-outputs|runtimes|tools|engines|models|versions>Created by the agent-documentation maintainer workflow.