Develop

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Project requirements and documentation
+    url: https://github.com/mongo/ms-agent-framework-mongodb#readme
+    about: Review project scope, requirements, and documentation before opening an issue.
+  - name: Report a security vulnerability privately
+    url: https://github.com/mongo/ms-agent-framework-mongodb/security/advisories/new
+    about: Do not disclose credentials, private data, or security vulnerabilities in a public issue.

.github/ISSUE_TEMPLATE/dotnet-issue.yml

@@ -0,0 +1,97 @@
+name: .NET bug report
+description: Report a bug in the .NET MongoDB provider
+title: "[.NET] Bug: "
+labels: [".NET"]
+type: bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a problem. Remove credentials, connection strings, user content, embeddings, and retrieved documents before submitting.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: Describe the observed and expected behavior.
+      placeholder: |
+        - What happened?
+        - What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: Provide the smallest code sample and steps that reproduce the issue.
+      placeholder: |
+        // Redact secrets and private data.
+        // Include provider construction and the failing operation.
+      render: csharp
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Redacted errors and logs
+      description: Include the complete exception chain and relevant logs after removing sensitive values and content.
+      render: shell
+    validations:
+      required: false
+
+  - type: input
+    id: provider-version
+    attributes:
+      label: Provider version
+      placeholder: "MongoDB.AgentFramework 1.0.0"
+    validations:
+      required: true
+
+  - type: input
+    id: dependency-versions
+    attributes:
+      label: Runtime and dependency versions
+      description: Include the .NET runtime, Microsoft Agent Framework, and MongoDB.Driver versions.
+      placeholder: ".NET 8.0; Microsoft.Agents.AI 1.x; MongoDB.Driver 3.x"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: feature
+    attributes:
+      label: Feature area
+      options:
+        - Memory
+        - Chat History
+        - RAG - vector
+        - RAG - full text
+        - RAG - hybrid
+        - Index management
+        - Session Store or Workflow Checkpoint Store
+        - Packaging, samples, or documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: mongodb-environment
+    attributes:
+      label: MongoDB environment
+      description: Include deployment type, server version, driver-visible topology, search mode, and index status. Do not include hostnames or credentials.
+      placeholder: |
+        Deployment: Atlas / Enterprise / Community
+        MongoDB version:
+        Search mode: ANN / ENN / full text / hybrid / not applicable
+        Index status and queryable state:
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: Include cancellation, ownership, filtering, or regression details that may affect diagnosis.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,90 @@
+name: Feature Request
+description: Propose a feature for the MongoDB Agent Framework providers
+title: "[Feature]: "
+type: feature
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Check the project requirements, non-goals, and proposed ADRs before filing. Hard-to-reverse architecture or public schema changes require an ADR.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem and scenario
+      description: Describe the user problem and concrete scenario without prescribing an implementation.
+      placeholder: |
+        Who needs this?
+        What are they trying to accomplish?
+        What prevents them from doing it today?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: feature
+    attributes:
+      label: Feature area
+      options:
+        - Memory
+        - Chat History
+        - RAG
+        - Index management
+        - Session Store
+        - Workflow Checkpoint Store
+        - Shared infrastructure
+        - Packaging, samples, or documentation
+        - New or unclear boundary
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-behavior
+    attributes:
+      label: Proposed behavior or API
+      description: Show the expected observable behavior and an optional minimal API sketch.
+      placeholder: |
+        Describe inputs, outputs, failure behavior, and lifecycle effects.
+    validations:
+      required: false
+
+  - type: dropdown
+    id: language
+    attributes:
+      label: Language/SDK
+      description: Which language/SDK does this feature apply to?
+      options:
+        - Both
+        - .NET
+        - Python
+        - Other / Not Applicable
+      default: 0
+    validations:
+      required: true
+
+  - type: textarea
+    id: security-lifecycle
+    attributes:
+      label: Security, data, and lifecycle impact
+      description: Explain tenant filtering, reads/writes, resource ownership, retention/deletion, logging/privacy, cancellation, and index effects.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives and compatibility
+      description: List alternatives, compatibility or migration impact, and any related requirement or ADR.
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Scope checks
+      options:
+        - label: I reviewed the requirements and non-goals.
+          required: true
+        - label: I am not proposing model-controlled raw BSON, filters, operators, field paths, index names, or aggregation pipelines.
+          required: true
+        - label: I described whether equivalent Python and .NET behavior is expected.
+          required: true

.github/ISSUE_TEMPLATE/python-issue.yml

@@ -0,0 +1,97 @@
+name: Python bug report
+description: Report a bug in the Python MongoDB provider
+title: "[Python] Bug: "
+labels: ["Python"]
+type: bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a problem. Remove credentials, connection strings, user content, embeddings, and retrieved documents before submitting.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: Describe the observed and expected behavior.
+      placeholder: |
+        - What happened?
+        - What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal reproduction
+      description: Provide the smallest code sample and steps that reproduce the issue.
+      placeholder: |
+        # Redact secrets and private data.
+        # Include provider construction and the failing operation.
+      render: python
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Redacted errors and logs
+      description: Include the complete exception chain and relevant logs after removing sensitive values and content.
+      render: shell
+    validations:
+      required: false
+
+  - type: input
+    id: provider-version
+    attributes:
+      label: Provider version
+      placeholder: "agent-framework-mongodb 1.0.0"
+    validations:
+      required: true
+
+  - type: input
+    id: dependency-versions
+    attributes:
+      label: Runtime and dependency versions
+      description: Include Python, agent-framework-core, and PyMongo versions.
+      placeholder: "Python 3.11; agent-framework-core 1.x; pymongo 4.x"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: feature
+    attributes:
+      label: Feature area
+      options:
+        - Memory
+        - Chat History
+        - RAG - vector
+        - RAG - full text
+        - RAG - hybrid
+        - Index management
+        - Session Store or Workflow Checkpoint Store
+        - Packaging, samples, or documentation
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: mongodb-environment
+    attributes:
+      label: MongoDB environment
+      description: Include deployment type, server version, driver-visible topology, search mode, and index status. Do not include hostnames or credentials.
+      placeholder: |
+        Deployment: Atlas / Enterprise / Community
+        MongoDB version:
+        Search mode: ANN / ENN / full text / hybrid / not applicable
+        Index status and queryable state:
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional context
+      description: Include cancellation, ownership, filtering, or regression details that may affect diagnosis.
+    validations:
+      required: false