From f7e05a3bc87f50b40abff77ff612f8b0e4d9f773 Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Tue, 1 Jul 2025 16:32:05 -0400
Subject: [PATCH] Remove mutation tests from CI

---
 .github/workflows/python-ci.yml |  5 -----
 README.md                       | 10 ++++++++++
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/python-ci.yml b/.github/workflows/python-ci.yml
index 118d32c..59492bd 100644
--- a/.github/workflows/python-ci.yml
+++ b/.github/workflows/python-ci.yml
@@ -80,11 +80,6 @@ jobs:
         run: |
           pytest ${STRESS_ARGS} --cov=src --cov-report=xml --cov-report=term-missing \
             --cov-fail-under=20 src/tests
-      - name: Run mutation tests
-        if: github.event_name == 'push' && runner.os == 'Linux'
-        run: |
-          python -m mutmut run --paths-to-mutate src --tests-dir src/tests --runner "python -m pytest -q" --use-coverage --no-progress
-          python -m mutmut results
       - name: Upload coverage report
         uses: actions/upload-artifact@v4
         with:
diff --git a/README.md b/README.md
index 0a2e1dd..341eaa0 100644
--- a/README.md
+++ b/README.md
@@ -195,6 +195,16 @@ pip install -r src/requirements.txt
 pytest -vv
 ```
 
+To run mutation tests locally, generate coverage data first and then execute `mutmut`:
+
+```bash
+pytest --cov=src src/tests
+python -m mutmut run --paths-to-mutate src --tests-dir src/tests --runner "python -m pytest -q" --use-coverage --no-progress
+python -m mutmut results
+```
+
+Mutation testing is disabled in the GitHub workflow due to reliability issues and should be run on a desktop environment instead.
+
 ## Security Considerations
 
 **Important:** The password you use to encrypt your parent seed is also required to decrypt the seed index data retrieved from Nostr. **It is imperative to remember this password** and be sure to use it with the same seed, as losing it means you won't be able to access your stored index. Secure your 12-word seed **and** your master password.