From f834b12ae7914622856360b45e52c1d7f3f5ab8e Mon Sep 17 00:00:00 2001
From: unlimitedengineer <277619522+unlimitedengineer@users.noreply.github.com>
Date: Sun, 27 Sep 2026 13:56:43 +0100
Subject: [PATCH] chore: add GitHub issue templates
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Closes #304
Closes #306
Closes #307
Closes #312

Adds three issue templates under .github/ISSUE_TEMPLATE/:
- bug_report.md   — structured bug report with repro steps, environment,
                    and expected vs actual behaviour fields
- feature_request.md — proposal template with motivation, solution,
                       and alternatives sections
- missing_test.md — targeted template for flagging untested functions
                    or error paths (matches the dominant issue type in
                    this repo's backlog)
---
 .github/ISSUE_TEMPLATE/bug_report.md      | 39 +++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/feature_request.md | 27 ++++++++++++++++
 .github/ISSUE_TEMPLATE/missing_test.md    | 23 +++++++++++++
 3 files changed, 89 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md
 create mode 100644 .github/ISSUE_TEMPLATE/missing_test.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 0000000..6cd1631
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,39 @@
+---
+name: Bug report
+about: Report a bug in a MergeFi contract or tooling
+title: "[Bug] "
+labels: bug
+assignees: ''
+---
+
+## Description
+
+<!-- A clear, concise description of the bug. -->
+
+## Contract / component
+
+<!-- Which contract or file is affected? e.g. escrow, milestones, maintenance-pool, scripts/ -->
+
+## Steps to reproduce
+
+1. 
+2. 
+3. 
+
+## Expected behaviour
+
+<!-- What should happen. -->
+
+## Actual behaviour
+
+<!-- What happens instead. Include error messages, panic output, or tx hashes where available. -->
+
+## Environment
+
+- Network: <!-- testnet / mainnet / local -->
+- Soroban SDK version:
+- Rust toolchain (`rustc --version`):
+
+## Additional context
+
+<!-- Attach logs, screenshots, or links to failing CI runs if relevant. -->
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 0000000..20136e4
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,27 @@
+---
+name: Feature request
+about: Suggest a new function, behaviour, or improvement
+title: "[Feature] "
+labels: enhancement
+assignees: ''
+---
+
+## Problem / motivation
+
+<!-- What problem does this solve, or what opportunity does it address? -->
+
+## Proposed solution
+
+<!-- Describe what you'd like to see added or changed. Include pseudocode or a function signature if helpful. -->
+
+## Contract / component
+
+<!-- Which contract(s) would be affected? e.g. escrow, milestones, maintenance-pool -->
+
+## Alternatives considered
+
+<!-- Any other approaches you evaluated and why you prefer this one. -->
+
+## Additional context
+
+<!-- Links to related issues, specs, or prior art. -->
diff --git a/.github/ISSUE_TEMPLATE/missing_test.md b/.github/ISSUE_TEMPLATE/missing_test.md
new file mode 100644
index 0000000..b1a1824
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/missing_test.md
@@ -0,0 +1,23 @@
+---
+name: Missing test
+about: Flag a function or behaviour that lacks test coverage
+title: "[Test] "
+labels: testing
+assignees: ''
+---
+
+## What is not tested
+
+<!-- Describe the function, error path, or invariant that has no test. Include the file and line number if known. -->
+
+## Why it matters
+
+<!-- What failure mode could go undetected without this test? -->
+
+## Suggested test approach
+
+<!-- Optional: a sketch of the test, e.g. which env helpers to use (mock_all_auths, set_auths, try_*, etc.) -->
+
+## Contract / file
+
+<!-- e.g. contracts/escrow/src/test.rs -->