@godzillaba/mutest 1.2.2 → 1.3.3

package/README.md

@@ -15,16 +15,18 @@ Pass one or more Solidity files. Mutest will:
 3. Run `forge test` against each mutant across the worker copies
 4. Report which mutants were killed (tests caught them) or survived (coverage gap)
 
-Example output:
+Surviving mutants are written to `gambit_out/survivors.json`.
 
-```
-[KILLED]   #1 DeleteExpressionMutation src/Counter.sol
-[KILLED]   #2 AssignmentMutation src/Counter.sol
-[SURVIVED] #3 AssignmentMutation src/Counter.sol
+### Re-testing survivors
+
+Run without arguments to re-test only the survivors from a previous run:
 
-3 mutants tested: 2 killed, 1 survived
+```sh
+npx @godzillaba/mutest
 ```
 
+This reads `gambit_out/survivors.json` (or falls back to `gambit_out/gambit_results.json`) and re-runs the test suite against those mutants. Useful after improving your tests to check if previously surviving mutants are now caught.
+
 ## Requirements
 
 - [Foundry](https://getfoundry.sh/) (`forge`)

package/index.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S npx tsx
 import { execFile as execFileCb } from "child_process";
-import { readFile, cp, rm } from "fs/promises";
+import { readFile, writeFile, cp, rm } from "fs/promises";
 import { promisify } from "util";
 
 const execFile = promisify(execFileCb);
@@ -65,8 +65,8 @@ async function processMutants(
   for (let i = 0; i < mutants.length; i++)
     queues[i % workerCount].push(mutants[i]);
 
-  let killed = 0;
-  let survived = 0;
+  let done = 0;
+  const survivors: Mutant[] = [];
 
   const workers = queues.map(async (queue, workerIdx) => {
     const workerDir = `${tempDir}/worker-${workerIdx}`;
@@ -74,26 +74,29 @@ async function processMutants(
       await cp(`gambit_out/${mutant.name}`, `${workerDir}/${mutant.original}`);
       try {
         await execFile("forge", ["test", "--optimize", "false", "--root", workerDir]);
-        survived++;
-        console.log(
-          `[SURVIVED] #${mutant.id} ${mutant.description} ${mutant.original}`,
-        );
-      } catch {
-        killed++;
-        console.log(
-          `[KILLED]   #${mutant.id} ${mutant.description} ${mutant.original}`,
-        );
-      }
+        survivors.push(mutant);
+      } catch {}
+      done++;
+      console.log(`${done}/${mutants.length} tested`);
     }
   });
 
   await Promise.all(workers);
-  console.log(
-    `\n${killed + survived} mutants tested: ${killed} killed, ${survived} survived`,
-  );
+  const killed = mutants.length - survivors.length;
+  console.log(`\n\n${killed} killed, ${survivors.length} survived`);
+  await writeFile("gambit_out/survivors.json", JSON.stringify(survivors, null, 2) + "\n");
+  console.log(`Wrote survivors.json`);
 }
 
 async function loadExistingMutants(): Promise<Mutant[]> {
+  try {
+    const raw = await readFile("gambit_out/survivors.json", "utf-8");
+    const survivors: Mutant[] = JSON.parse(raw);
+    if (survivors.length > 0) {
+      console.log(`Found survivors.json, re-testing ${survivors.length} survivors...`);
+      return survivors;
+    }
+  } catch {}
   const raw = await readFile("gambit_out/gambit_results.json", "utf-8");
   return JSON.parse(raw);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@godzillaba/mutest",
-  "version": "1.2.2",
+  "version": "1.3.3",
   "bin": {
     "mutest": "./index.ts"
   },