René's URL Explorer Experiment


Title: Gate external PRs on an assigned, linked issue by maxisbey · Pull Request #3291 · modelcontextprotocol/python-sdk · GitHub

Open Graph Title: Gate external PRs on an assigned, linked issue by maxisbey · Pull Request #3291 · modelcontextprotocol/python-sdk

X Title: Gate external PRs on an assigned, linked issue by maxisbey · Pull Request #3291 · modelcontextprotocol/python-sdk

Description: Adds an intake gate for pull requests from outside the maintainer team: a PR stays open only if it links an open issue its author is assigned to (or one labeled help wanted). Everything else is closed by a bot with an explanation and reopens automatically once a maintainer assigns the author. CONTRIBUTING.md is rewritten around that policy. Motivation and Context Over the last six months this repo received ~640 pull requests from outside the maintainer team — 2.7× the previous six months — of which 24 were merged. 41% of newly opened issues now attract an external PR within 48 hours (median under 11 hours), the open-PR backlog is ~80% external, and CONTRIBUTING.md's existing "issue first, no drive-by agents" rules have no mechanical backing. Reviewing a PR properly costs the same as it always did; producing one no longer does. With the maintainer time we actually have, issues are the contribution we can use, and this makes the repo say so and behave accordingly. The workflow is adapted from PrefectHQ/fastmcp's require-issue-link.yml (which came from langchain's); pydantic and pydantic-ai run similar gates. Within this org, inspector has already gone issues-only and typescript-sdk restricted PR creation for a month in June for the same reason. Behaviour External, non-draft PR must Fixes / Closes / Resolves an open issue in this repo where the author is an assignee, or the issue carries help wanted. Otherwise: missing-issue-link label, one comment, closed. Exempt: anyone with triage or better on the repo (resolved from the collaborator-permission capability flags, so private org membership and custom roles don't matter), bot accounts, drafts (re-checked on ready-for-review). Ways back in: a maintainer assigns the author on the linked issue → the PR reopens itself; the author fixes the description → reopens on the edited event; anyone triage+ reopens the PR, removes the label, or adds bypass-issue-check → sticky override. If GitHub refuses to reopen (branch force-pushed or deleted while closed, or a sibling PR from the same branch is already open) the gate keeps the control label so the PR stays findable and replaces its comment with instructions covering those cases. PRs numbered below 3200 predate the gate and are left alone unless a maintainer evaluates one via workflow_dispatch; from 3200 up a PR is evaluated on its next event. Once labeled, a PR is managed normally regardless of number. Live from merge. Setting the repository variable PR_GATE_ENFORCE to false is a kill switch: runs then log PASS/FAIL and [dry-run] would … lines and mutate nothing. Differences from the fastmcp version (also listed in the file header): the rules live in .github/scripts/pr_intake_gate.js (with scenario tests beside it) and the workflow is just triggers and routing; one script serves all entry points (PR events, issue assignment, manual dispatch) so admission and reopening can't drift; PR state is always read live rather than from the event payload; linked issues must be open and still in this repo; gated PRs are found with the list API rather than Search; reopen happens before the label is removed and a refused reopen is explained rather than guessed at; trust from capability flags rather than role-name strings; the waiver label is our existing help wanted. Docs CONTRIBUTING.md: new "Why issues, not pull requests", "How pull requests get in", "Who we actively want to hear from" sections; the assignment rules (a bare "please assign me" is noise; engaging with the issue is the conversation we assign on; reporters have first claim); label table corrected (ready for work means queued for a maintainer, not an invitation). AGENTS.md: an agent-facing statement of the policy at the top, since that's the file coding agents load. .github/pull_request_template.md: a short repo-level template that leads with the Fixes # line the gate looks for, replacing the inherited org template here. How Has This Been Tested? .github/scripts/pr_intake_gate.test.js: 26 named scenarios (no link; link to help wanted; maintainer reopening their own vs a gated PR; triage-role and bot label removal; the bypass label; Dependabot; hand-closed and merged PRs; closed/transferred/cross-repo/PR-number references; refused reopen and the retry after it; issue assignment incl. past the reference cap; dispatch backfill; drafts; a planted marker comment) plus kill-switch and fail-safe cases, run in CI on Node 24. actionlint and zizmor --pedantic clean (the pull_request_target trigger carries an inline justification; the workflow never checks out or executes PR code and interpolates nothing from the PR into the script). The endpoint shapes it depends on (collaborators/{user}/permission capability flags for admins, outsiders and app logins; issues.listForRepo with creator+labels+state=closed; minimizeComment/unminimizeComment) were checked against the live API, and the same permission set is what fastmcp's copy has been running with since May. Real traffic gets exercised in dry-run after merge before enforcement is switched on. Breaking Changes None for SDK users. For contributors: PRs opened without an assigned, linked issue will be closed automatically once enforcement is on; CONTRIBUTING.md describes the path. Types of changes Bug fix (non-breaking change which fixes an issue) New feature (non-breaking change which adds functionality) Breaking change (fix or feature that would cause existing functionality to change) Documentation update Repository automation Checklist I have read the MCP Documentation My code follows the repository's style guidelines New and existing tests pass locally I have added appropriate error handling I have added or updated documentation as needed Additional context Rollout after merge: It is live from merge: new PRs are evaluated as they open, already-open PRs ≥ #3200 on their next edit. Watch Actions → Require Linked Issue for the first day; PR_GATE_ENFORCE=false pauses it. Label hygiene: update the help wanted / ready for work label descriptions to match CONTRIBUTING.md. Backfill any already-open PRs we want evaluated: gh workflow run require-linked-issue.yml -f pr_number=. Optionally stand up a triage-permission collaborators team for regular outside contributors; until then a maintainer reopening a PR is the per-PR equivalent. AI Disclaimer

Open Graph Description: Adds an intake gate for pull requests from outside the maintainer team: a PR stays open only if it links an open issue its author is assigned to (or one labeled help wanted). Everything else is clo...

X Description: Adds an intake gate for pull requests from outside the maintainer team: a PR stays open only if it links an open issue its author is assigned to (or one labeled help wanted). Everything else is clo...

Opengraph URL: https://github.com/modelcontextprotocol/python-sdk/pull/3291

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:f4cb3930-53e8-69aa-f2bf-1770bce6bec8
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idA350:19114D:263C37:326AB1:6B00C038
html-safe-nonce1618aa58eedb76fd3ec46da63ae128e7826fe32b114eafa9fe5df083136a4e5e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBMzUwOjE5MTE0RDoyNjNDMzc6MzI2QUIxOjZCMDBDMDM4IiwidmlzaXRvcl9pZCI6Ijc1Nzk5MDA3NTQxMzYxODY5MzciLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ==
visitor-hmacf4d77811fa1fbc9e941c0f1c0b095236963c0cb6d859c9c2daeaa87a618bcd62
hovercard-subject-tagpull_request:4256207437
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/modelcontextprotocol/python-sdk/pull/3291/files
twitter:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/224885523?s=400&v=4
og:image:altAdds an intake gate for pull requests from outside the maintainer team: a PR stays open only if it links an open issue its author is assigned to (or one labeled help wanted). Everything else is clo...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None93edd3bebc4afb7ce711ee74cb5d2a95927850b082a4d43e212222389cb1c415
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/modelcontextprotocol/python-sdk git https://github.com/modelcontextprotocol/python-sdk.git
octolytics-dimension-user_id182288589
octolytics-dimension-user_loginmodelcontextprotocol
octolytics-dimension-repository_id862584018
octolytics-dimension-repository_nwomodelcontextprotocol/python-sdk
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id862584018
octolytics-dimension-repository_network_root_nwomodelcontextprotocol/python-sdk
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release1fee81a280ea86312b69448e261b418189bfd5b5
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F3291%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fmodelcontextprotocol%2Fpython-sdk%2Fpull%2F3291%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=modelcontextprotocol%2Fpython-sdk
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Reloadhttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
modelcontextprotocolhttps://github.com/modelcontextprotocol
python-sdkhttps://github.com/modelcontextprotocol/python-sdk
Codehttps://github.com/modelcontextprotocol/python-sdk
Issues308 (308)https://github.com/modelcontextprotocol/python-sdk/issues
Pull requests112 (112)https://github.com/modelcontextprotocol/python-sdk/pulls
Actionshttps://github.com/modelcontextprotocol/python-sdk/actions
Projectshttps://github.com/modelcontextprotocol/python-sdk/projects
Security and quality12 (12)https://github.com/modelcontextprotocol/python-sdk/security
Insightshttps://github.com/modelcontextprotocol/python-sdk/insights
Sign up for GitHub https://github.com/signup?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fmodelcontextprotocol%2Fpython-sdk%2Fissues%2Fnew%2Fchoose
maxisbeyhttps://github.com/maxisbey
mainhttps://github.com/modelcontextprotocol/python-sdk/tree/main
pr-intake-gatehttps://github.com/modelcontextprotocol/python-sdk/tree/pr-intake-gate
Conversation 85 https://github.com/modelcontextprotocol/python-sdk/pull/3291
Commits 2 https://github.com/modelcontextprotocol/python-sdk/pull/3291/commits
Checks 45 https://github.com/modelcontextprotocol/python-sdk/pull/3291/checks
Files changed https://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Gate external PRs on an assigned, linked issue https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#top
Show all changes 2 commits https://github.com/modelcontextprotocol/python-sdk/pull/3291/files
1e7b8d9 Gate external PRs on an assigned, linked issue maxisbey Aug 16, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3291/commits/1e7b8d9a1ca2fddc7a38ae8b32f9753736557f31
6624252 Intake gate: isolate per-PR failures on assignment; key assignment ru… maxisbey Aug 17, 2026 https://github.com/modelcontextprotocol/python-sdk/pull/3291/commits/66242520a61057c1b086b6f7d2bdfc1f33cb2408
Clear filters https://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
pull_request_template.md https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-b2496e80299b8c3150b1944450bd81c622e04e13d15c411d291db0927d75fd6b
pr_intake_gate.js https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-425568e0b917891b554902d1e1090f6303889fea30d85f311ea35c4c2842975c
pr_intake_gate.test.js https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-ac4c382e65fe89f4fad2eb03a8883a0acfb51d6b331ec6b2b79c5bdf2f4670ed
require-linked-issue.yml https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-911f1848182e5efbcaede0af0b9a3e8ee872e45b0434122dc044a0147b4fe201
shared.yml https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-9852c0f7d79fa9d5200f11511ffdbadc321f7115fe1c5e8d2f2e63863d2441ee
AGENTS.md https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-a54ff182c7e8acf56acfd6e4b9c3ff41e2c41a31c9b211b2deb9df75d9a478f9
CONTRIBUTING.md https://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-eca12c0a30e25b4b46522ebf89465a03ba72a03f540796c979137931d8f92055
.github/pull_request_template.mdhttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-b2496e80299b8c3150b1944450bd81c622e04e13d15c411d291db0927d75fd6b
View file https://github.com/modelcontextprotocol/python-sdk/blob/66242520a61057c1b086b6f7d2bdfc1f33cb2408/.github/pull_request_template.md
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3291/{{ revealButtonHref }}
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
.github/scripts/pr_intake_gate.jshttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files#diff-425568e0b917891b554902d1e1090f6303889fea30d85f311ea35c4c2842975c
View file https://github.com/modelcontextprotocol/python-sdk/blob/66242520a61057c1b086b6f7d2bdfc1f33cb2408/.github/scripts/pr_intake_gate.js
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/modelcontextprotocol/python-sdk/pull/3291/{{ revealButtonHref }}
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
Please reload this pagehttps://github.com/modelcontextprotocol/python-sdk/pull/3291/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.