feat(repos): complete typed repository tool outputs - #3392
Draft
SamMorrowDrums wants to merge 2 commits into
Draft
SamMorrowDrums wants to merge 2 commits into
SamMorrowDrums wants to merge 2 commits into
Conversation
Migrate the remaining 17 repository tools to concrete inputs and outputs. Preserve existing content, mutations, scopes, filtering, and protocol gating; add wire and schema conformance coverage. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
SamMorrowDrums
added this pull request to stack #3385
October 2, 2026 12:47
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
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.
Summary
Complete the remaining 17 typed MCP tools in
pkg/github/repositories.go, using the existing protocol-gatedNewTool[In, Out]foundation. Modern clients receive concrete output schemas and structured content; legacy/unknown clients retain their original content without output schemas or structured content.Why
Continue the file-focused typed-tool migration, stacked on #3391. No issue is closed by this slice.
Fixes # N/A
Exact parent/base:
7b0c05e0eae079b0a973d44ea73f6244a491b2a0(sammorrowdrums-type-core-issue-tools), based on repository layer4b6686b5fc361a702e50d7e37a55870e49da6900. The original parent01770e05065e86a964af3bc7834ebded7f03ed1eand original repository ancestor79f584df3f05c756e97904016e70985731fb6f77were verified before edits; the refreshed parent was synchronized safely before final validation.Exact slice head:
7e864d1e6c4eaadc2050c9d7d973d123471e4ea8.What changed
create_or_update_file,create_repository,delete_repository,get_file_contents,fork_repository,delete_file,create_branch,push_files,get_tag,list_releases,get_latest_release,get_release_by_tag,list_starred_repositories,star_repository,unstar_repository,get_file_blame, andlist_repository_collaborators.get_commit,list_commits,list_branches, andlist_tagsmigrations. Retain scopes, workflow challenges, feature gates, IFC labeling, sanitization, field filtering, deletion confirmation, and mutation behavior.contentarray; directory projections remain structured arrays. Text-only mutations use a structuredmessagematching the actual status response.MCP impact
Output schemas and typed
structuredContentare exposed only for protocol2026-07-28and newer. Existing content remains unchanged; legacy/unknown protocol clients receive neither output schemas nor structured content.Prompts tested (tool changes only)
Security / limits
Existing scopes, workflow-scope challenges, IFC labels, sanitization, field projections, 1 MiB resource-link behavior, blame limits, and repository deletion confirmation remain in place. Structured file output mirrors the already-returned content; it does not fetch additional data or bypass permissions.
Tool renaming
deprecated_tool_aliases.goNote: if you're renaming tools, you must add the tool aliases. For more information on how to do so, please refer to the official docs.
Lint & tests
Linted locally with
./script/lintTested locally with
./script/testUPDATE_TOOLSNAPS=true go test ./...— passed; all intended raw/negotiated output schemas snapshotted.script/lint— passed.script/test— passed (go test -race ./...).script/generate-docs— passed.git diff --check— passed.The required lint → race tests → documentation ordering was run on the refreshed exact parent. E2E tests requiring a live GitHub PAT were not run. CI will be inspected after PR creation. License-bot manifests were preserved without changes.
Docs
README explains protocol gating and the typed representations of content-only repository responses. Tool schemas include updated snapshots.