Merge branch 'chore/add-schema-dereference-middleware' of github.com:vl-kp/fastmcp into chore/add-schema-dereference-middleware

Author: vl-kp

.github/ISSUE_TEMPLATE/bug.yml

@@ -5,7 +5,20 @@ labels: [bug, pending]
 body:
   - type: markdown
     attributes:
-      value: Thank you for contributing to FastMCP! 🙏
+      value: Thanks for contributing to FastMCP! 🙏
+
+  - type: markdown
+    attributes:
+      value: |
+        ### Before you submit
+
+        To help us help you, please:
+
+        - 🔄 **Make sure you're testing on the latest version of FastMCP** - many issues are already fixed in newer versions
+        - 🔍 **Check if someone else has already reported this issue** or if it's been fixed on the main branch
+        - 📋 **You MUST include a copy/pasteable and properly formatted MRE** (minimal reproducible example) below or your issue may be closed without response
+
+        Thanks for helping to make FastMCP better! 🚀
 
   - type: textarea
     id: description
@@ -25,46 +38,34 @@ body:
       description: >
         If applicable, please provide a self-contained,
         [minimal, reproducible example](https://stackoverflow.com/help/minimal-reproducible-example)
-        demonstrating the bug.
-
-        If possible, your example should be a single-file script. Instead of `.run()`-ing an MCP server, use a `Client` to directly interact with it (`async with Client(mcp) as client: ...`) and demonstrate the issue.
+        demonstrating the bug. If possible, your example should be a single-file script.
 
       placeholder: |
+        import asyncio
         from fastmcp import FastMCP, Client
 
         mcp = FastMCP()
 
-        async with Client(mcp) as client:
-            ...
+        async def demo():
+            async with Client(mcp) as client:
+                ... # show the bug here
+
+        if __name__ == "__main__":
+            asyncio.run(demo())
       render: Python
 
   - type: textarea
     id: version
     attributes:
       label: Version Information
       description: |
-        Please provide information about your FastMCP version, MCP version, Python version, and OS.
+        Please tell us about your FastMCP version, MCP version, Python version, and OS, as well as any other relevant details about your environment.
 
-        To get this information, run the following command in your terminal and paste the output below:
+        To get the basic information, run the following command in your terminal and paste the output below:
 
         ```bash
         fastmcp version --copy
         ```
-
-        *Note: if you're using FastMCP < 2.10.3, run `fastmcp version` instead.*
-
-        If there is other information that would be helpful, please include it as well.
       render: Text
     validations:
       required: true
-
-  - type: textarea
-    id: additional_context
-    attributes:
-      label: Additional Context
-      description: |
-        Add any other context about the problem here. This could include:
-        - The full error message and traceback (if applicable)
-        - Information about your environment (e.g., virtual environment, installed packages)
-        - Steps to reproduce the issue
-        - Any recent changes in your code or setup that might be relevant

.github/ISSUE_TEMPLATE/enhancement.yml

@@ -5,34 +5,30 @@ labels: [enhancement, pending]
 body:
   - type: markdown
     attributes:
-      value: Thank you for contributing to FastMCP! We value your ideas for improving the framework. 💡
+      value: Thanks for contributing to FastMCP! 🙏
+
+  - type: markdown
+    attributes:
+      value: |
+        ### Before you submit
+
+        To help us evaluate your enhancement request:
+
+        - 🔍 **Check if this has already been requested** - search existing issues first
+        - 💭 **Think about the broader impact** - how would this affect other users?
+        - 📋 **Consider implementation complexity** - is this a small change or a major feature?
+
+        Thanks for helping to make FastMCP better! 🚀
 
   - type: textarea
     id: description
     attributes:
-      label: Enhancement Description
+      label: Enhancement
       description: |
-        Please describe the enhancement you'd like to see in FastMCP.
+        Please describe the enhancement:
 
-        - What problem would this solve?
-        - How would this improve your workflow or experience with FastMCP?
+        - What problem or use case would it solve?
+        - How would it improve your workflow or experience with FastMCP?
         - Are there any alternative solutions you've considered?
     validations:
       required: true
-
-  - type: textarea
-    id: use_case
-    attributes:
-      label: Use Case
-      description: |
-        Describe a specific use case or scenario where this enhancement would be beneficial.
-        If possible, provide an example of how you envision using this feature.
-
-  - type: textarea
-    id: example
-    attributes:
-      label: Proposed Implementation
-      description: >
-        If you have ideas about how this enhancement could be implemented,
-        please share them here. Code snippets, pseudocode, or general approaches are welcome.
-      render: Python

.github/copilot-instructions.md

@@ -0,0 +1 @@
+../AGENTS.md

.github/labeler.yml

@@ -0,0 +1,28 @@
+## Description
+<!-- 
+Please provide a clear and concise description of the changes made in this pull request.
+
+Using AI to generate code? Please include a note in the description with which AI tool you used.
+-->
+
+**Contributors Checklist**
+<!--
+NOTE:
+1. You must create an issue in the repository before making a Pull Request.
+2. You must not create a Pull Request for an issue that is already assigned to someone else.
+
+If you do not follow these steps, your Pull Request will be closed without review.
+-->
+
+- [ ] My change is related to issue #(issue number)
+- [ ] I have followed the repository's development workflow
+- [ ] I have tested my changes manually and by adding relevant tests
+- [ ] I have performed all required documentation updates
+
+**Review Checklist**
+<!-- Your Pull Request will not be reviewed if tests are failing, you have not self-reviewed your changes, or you have not checked all of the following: -->
+
+- [ ] I have self-reviewed my changes
+- [ ] My Pull Request is ready for review
+
+---

.github/pull_request_template.md

@@ -7,17 +7,13 @@ changelog:
     - title: New Features 🎉
       labels:
         - feature
-      exclude:
-        labels:
-          - contrib
 
     - title: Enhancements 🔧
       labels:
         - enhancement
       exclude:
         labels:
           - breaking change
-          - contrib
 
     - title: Fixes 🐞
       labels:

.github/release.yml

@@ -0,0 +1,28 @@
+name: Auto-close duplicate issues
+description: Auto-closes issues that are duplicates of existing issues
+on:
+  schedule:
+    - cron: "0 9 * * *" # Run daily at 9 AM UTC
+  workflow_dispatch:
+
+jobs:
+  auto-close-duplicates:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Auto-close duplicate issues
+        run: uv run scripts/auto_close_duplicates.py
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPOSITORY_OWNER: ${{ github.repository_owner }}
+          GITHUB_REPOSITORY_NAME: ${{ github.event.repository.name }}

.github/workflows/auto-close-duplicates.yml

@@ -0,0 +1,80 @@
+name: Marvin Issue Dedupe
+description: Automatically dedupe GitHub issues using Marvin
+on:
+  issues:
+    types: [opened]
+  workflow_dispatch:
+    inputs:
+      issue_number:
+        description: "Issue number to process for duplicate detection"
+        required: true
+        type: string
+
+jobs:
+  marvin-dedupe-issues:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+      issues: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+
+      - name: Generate Marvin App token
+        id: marvin-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.MARVIN_APP_ID }}
+          private-key: ${{ secrets.MARVIN_APP_PRIVATE_KEY }}
+
+      - name: Create dedupe prompt
+        run: |
+          mkdir -p /tmp/claude-prompts
+          cat > /tmp/claude-prompts/dedupe-prompt.txt << 'EOF'
+          Find up to 3 likely duplicate issues for GitHub issue ${{ github.repository }}/issues/${{ github.event.issue.number || inputs.issue_number }}.
+
+          Follow these steps precisely:
+
+          1. Use the Task tool to check if the GitHub issue (a) is closed, (b) does not need to be deduped (eg. because it is broad product feedback without a specific solution, or positive feedback), or (c) already has a duplicates comment that you made earlier. If so, do not proceed.
+
+          2. Use the Task tool to view the GitHub issue, and ask the agent to return a summary of the issue
+
+          3. Then, launch 3 parallel agents using the Task tool to search GitHub for duplicates of this issue, using diverse keywords and search approaches, using the summary from step 2
+
+          4. Next, feed the results from steps 2 and 3 into another agent using the Task tool, so that it can filter out false positives that are likely not actually duplicates of the original issue. If there are no duplicates remaining, do not proceed.
+
+          5. Finally, comment back on the issue with a list of up to three duplicate issues (or zero, if there are no likely duplicates). If there are no duplicates, DO NOT COMMENT. Just exit.
+
+          Notes for your agents:
+          - Use `gh` to interact with GitHub, rather than web fetch
+          - Do not use other tools, beyond `gh` and Task (eg. don't use other MCP servers, file edit, etc.)
+          - Make a todo list first
+
+          For your comment, follow this format precisely (example with 3 suspected duplicates):
+
+          ---
+          Found 3 possible duplicate issues:
+
+          1. #123: Issue title here
+          2. #456: Another issue title  
+          3. #789: Third issue title
+
+          This issue will be automatically closed as a duplicate in 3 days.
+
+          - If your issue is a duplicate, please close it and 👍 the existing issue instead
+          - To prevent auto-closure, add a comment or 👎 this comment
+
+          ---
+          EOF
+
+      - name: Run Marvin dedupe command
+        uses: anthropics/claude-code-base-action@beta
+        with:
+          model: claude-3-5-haiku-latest
+          prompt_file: /tmp/claude-prompts/dedupe-prompt.txt
+          allowed_tools: "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh api:*),Bash(gh issue comment:*),Task"
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY_FOR_CI }}
+          claude_env: |
+            GH_TOKEN: ${{ steps.marvin-token.outputs.token }}