apex-mutation-testing 1.6.1 → 1.7.0

package/README.md

@@ -113,7 +113,8 @@ The config file supports the following attributes:
   },
   "threshold": 80,
   "skipPatterns": ["System\\.debug", "Logger\\."],
-  "lines": ["1-10", "25-30", "42"]
+  "lines": ["1-10", "25-30", "42"],
+  "mutationGrouping": true
 }
 ```
 
@@ -126,6 +127,7 @@ The config file supports the following attributes:
 | `threshold`           | `number`   | Minimum mutation score (0–100) required for the command to succeed                                                |
 | `skipPatterns`        | `string[]` | RE2 regex patterns to skip lines from mutation (e.g., `System\\.debug`)                                           |
 | `lines`               | `string[]` | Line ranges to restrict mutation to (e.g., `1-10`, `42`)                                                          |
+| `mutationGrouping`    | `boolean`  | Pack mutations whose covering tests are disjoint into a single deploy + test run; runs the full pipeline (test-induced clique lower bound → DSATUR → exact backtracking coloring). Off by default.                |
 
 **Mutual exclusivity:** You cannot specify both `include` and `exclude` within the same group.
 For example, setting both `mutators.include` and `mutators.exclude` will result in an error.
@@ -217,6 +219,31 @@ Config file equivalent:
 }
 ```
 
+#### Mutation Grouping
+
+Run multiple independent mutations in a single deployment + test run by passing `--mutation-grouping`. The flag turns on a three-stage pipeline:
+
+1. **Lower-bound clique** — for every test method, gather the mutations it covers; the largest such set is a clique in the conflict graph and a free lower bound on the chromatic number.
+2. **DSATUR** — pre-color the witness clique, then partition the remaining mutations with the strongest polynomial-time graph-coloring heuristic (Brélaz 1979). Two mutations share a group iff their covering tests are pairwise disjoint.
+3. **Exact backtracking coloring** — binary-search for the chromatic number using DSATUR-style backtracking, seeded by the witness clique. Confirms DSATUR was already optimal or finds a strictly smaller partition. No external solver, no runtime dependency — pure TypeScript.
+
+Each group is then deployed once and its union of covering tests run once; per-method test outcomes are reverse-mapped back to individual mutations. This reduces the number of Tooling-API class updates and async test-run kickoffs (the network-bound dominant cost) without changing test execution time. Off by default.
+
+```sh
+# Enable mutation grouping
+sf apex mutation test run --apex-class MyClass --test-class MyClassTest --mutation-grouping
+```
+
+Config file equivalent:
+
+```json
+{
+  "mutationGrouping": true
+}
+```
+
+If a batched deploy or test run fails, the affected group automatically falls back to per-mutant evaluation — so worst case is identical to today's behavior plus one wasted batch attempt.
+
 ##### Diff-Based Mutation Testing with Git
 
 You can derive line ranges from `git diff` to focus mutation testing on recently changed code. This is particularly useful in CI pipelines to only test mutations on lines affected by a pull request.
@@ -337,7 +364,7 @@ USAGE
   $ sf apex mutation test run -c <value> -t <value> -o <value> [--json] [--flags-dir <value>] [-r <value>] [-d]
     [--include-mutators <value>... | --exclude-mutators <value>...] [--include-test-methods <value>... |
     --exclude-test-methods <value>...] [--threshold <value>] [-s <value>...] [-l <value>...] [--config-file <value>]
-    [--api-version <value>]
+    [--mutation-grouping] [--api-version <value>]
 
 FLAGS
   -c, --apex-class=<value>               (required) Apex class name to mutate
@@ -356,6 +383,10 @@ FLAGS
       --exclude-test-methods=<value>...  Test method names to exclude
       --include-mutators=<value>...      Mutator names to include (e.g. ArithmeticOperator, BoundaryCondition)
       --include-test-methods=<value>...  Test method names to include
+      --mutation-grouping                Group mutations whose covering tests are disjoint into a single deploy + test
+                                         run. Reduces deployments and async test-run kickoffs at the cost of larger
+                                         blast radius on compile errors. Runs the full pipeline: test-induced clique
+                                         lower bound → DSATUR heuristic → exact backtracking coloring. Off by default.
       --threshold=<value>                Minimum mutation score (0-100) required for the command to succeed
 
 GLOBAL FLAGS
@@ -381,7 +412,7 @@ EXAMPLES
     $ sf apex mutation test run --apex-class MyClass --test-class MyClassTest --dry-run
 ```
 
-_See code: [src/commands/apex/mutation/test/run.ts](https://github.com/scolladon/apex-mutation-testing/blob/v1.6.1/src/commands/apex/mutation/test/run.ts)_
+_See code: [src/commands/apex/mutation/test/run.ts](https://github.com/scolladon/apex-mutation-testing/blob/v1.7.0/src/commands/apex/mutation/test/run.ts)_
 <!-- commandsstop -->
 <!-- markdownlint-enable MD040 -->
 

package/lib/commands/apex/mutation/test/run.d.ts

@@ -19,6 +19,7 @@ export default class ApexMutationTest extends SfCommand<ApexMutationTestResult>
         'skip-patterns': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         lines: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'config-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'mutation-grouping': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
         'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };

package/lib/commands/apex/mutation/test/run.js

@@ -71,6 +71,9 @@ export default class ApexMutationTest extends SfCommand {
             summary: messages.getMessage('flags.config-file.summary'),
             exists: true,
         }),
+        'mutation-grouping': Flags.boolean({
+            summary: messages.getMessage('flags.mutation-grouping.summary'),
+        }),
         'target-org': Flags.requiredOrg(),
         'api-version': Flags.orgApiVersion(),
     };
@@ -90,6 +93,7 @@ export default class ApexMutationTest extends SfCommand {
             skipPatterns: flags['skip-patterns'],
             lines: flags['lines'],
             configFile: flags['config-file'],
+            mutationGrouping: flags['mutation-grouping'],
         };
         const configReader = new ConfigReader();
         const resolvedParameters = await configReader.resolve(parameters);

package/lib/commands/apex/mutation/test/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../../src/commands/apex/mutation/test/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../../src/commands/apex/mutation/test/run.ts"],"names":[],"mappings":"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"}

package/lib/service/configReader.js

@@ -14,6 +14,7 @@ export class ConfigReader {
             threshold: parameter.threshold ?? fileConfig?.threshold,
             skipPatterns: parameter.skipPatterns ?? fileConfig?.skipPatterns,
             lines: parameter.lines ?? fileConfig?.lines,
+            mutationGrouping: parameter.mutationGrouping ?? fileConfig?.mutationGrouping,
         };
         this.validate(resolved);
         return resolved;

package/lib/service/configReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"configReader.js","sourceRoot":"","sources":["../../src/service/configReader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configReader.js","sourceRoot":"","sources":["../../src/service/configReader.ts"],"names":[],"mappings":"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"}

package/lib/service/exactColoring.d.ts

@@ -0,0 +1,25 @@
+export declare const buildAdjacency: (tests: ReadonlyArray<Set<string>>) => number[][];
+export declare const tryKColoring: (adjacency: ReadonlyArray<ReadonlyArray<number>>, n: number, k: number, witness: ReadonlyArray<number>) => number[] | null;
+export type SolveColoringInput = {
+    adjacency: ReadonlyArray<ReadonlyArray<number>>;
+    n: number;
+    lowerBound: number;
+    dsaturColors: number;
+    witness: ReadonlyArray<number>;
+    dsaturColoring: ReadonlyArray<number>;
+};
+export type SolveColoringResult = {
+    coloring: ReadonlyArray<number>;
+    lowerBound: number;
+    optimal: boolean;
+};
+type ExactDecision = {
+    useGroups: 'exact';
+    suffix: string;
+} | {
+    useGroups: 'dsatur';
+    suffix: string;
+};
+export declare const decideExactOutcome: (exact: SolveColoringResult, dsaturColors: number) => ExactDecision;
+export declare const solveColoring: (input: SolveColoringInput) => SolveColoringResult;
+export {};

package/lib/service/exactColoring.js

@@ -0,0 +1,143 @@
+// Exact graph k-coloring via DSATUR-style backtracking. Pure TypeScript,
+// no external SAT solver — at our scale (n ≤ 200) the witness clique
+// from D2 already fixes the most-constrained vertices, so the backtracking
+// search converges fast on real Apex graphs.
+// Build the conflict-graph adjacency list. Vertex i and j are adjacent iff
+// `tests(i) ∩ tests(j) ≠ ∅`. Same definition as in mutationGrouper; lives
+// here so the exact-coloring driver and the DSATUR driver share one source
+// of truth.
+export const buildAdjacency = (tests) => {
+    const n = tests.length;
+    const adjacency = Array.from({ length: n }, () => []);
+    for (let i = 0; i < n; ++i) {
+        for (let j = i + 1; j < n; ++j) {
+            if (intersects(tests[i], tests[j])) {
+                adjacency[i].push(j);
+                adjacency[j].push(i);
+            }
+        }
+    }
+    return adjacency;
+};
+const intersects = (a, b) => {
+    const [small, large] = a.size <= b.size ? [a, b] : [b, a];
+    for (const t of small) {
+        if (large.has(t))
+            return true;
+    }
+    return false;
+};
+// Decide whether the graph admits a valid k-coloring; return one if it does,
+// `null` otherwise. Pre-colors the witness clique (whose vertices must
+// receive distinct colors in any valid coloring), then runs DSATUR-style
+// backtracking on the remaining vertices: at each step, pick the most
+// constrained uncolored vertex (highest saturation, then highest degree,
+// then lowest input index) and try the smallest available color first.
+export const tryKColoring = (adjacency, n, k, witness) => {
+    if (k < witness.length)
+        return null;
+    const color = new Array(n).fill(-1);
+    for (let i = 0; i < witness.length; ++i)
+        color[witness[i]] = i;
+    const degree = adjacency.map(neighbors => neighbors.length);
+    return backtrack(adjacency, n, k, color, degree);
+};
+const backtrack = (adjacency, n, k, color, degree) => {
+    const v = pickMostConstrained(adjacency, color, degree);
+    if (v === -1)
+        return color.slice();
+    const used = neighborColors(adjacency[v], color);
+    if (used.size >= k)
+        return null;
+    for (let c = 0; c < k; ++c) {
+        if (used.has(c))
+            continue;
+        color[v] = c;
+        // Forward checking: skip the recurse if assigning c to v would strand
+        // some uncolored neighbor (no color left for it). Catches the dead end
+        // one level earlier, dodging an entire `pickMostConstrained` scan.
+        if (!wouldStrandNeighbor(adjacency, color, v, k)) {
+            const result = backtrack(adjacency, n, k, color, degree);
+            if (result !== null)
+                return result;
+        }
+    }
+    color[v] = -1;
+    return null;
+};
+// True iff some uncolored neighbor of `v` now has zero available colors —
+// i.e. every color in [0, k) appears on one of its colored neighbors.
+const wouldStrandNeighbor = (adjacency, color, v, k) => {
+    for (const u of adjacency[v]) {
+        if (color[u] !== -1)
+            continue;
+        if (neighborColors(adjacency[u], color).size >= k)
+            return true;
+    }
+    return false;
+};
+// DSATUR vertex selection: highest saturation (number of distinct neighbor
+// colors), tiebreak on degree, tiebreak on input index. Strict `>`
+// comparisons keep the lowest unprocessed index winning ties — same
+// determinism contract as `mutationGrouper.pickNextVertex`.
+const pickMostConstrained = (adjacency, color, degree) => {
+    let pick = -1;
+    let pickSaturation = -1;
+    for (let v = 0; v < color.length; ++v) {
+        if (color[v] !== -1)
+            continue;
+        const saturation = neighborColors(adjacency[v], color).size;
+        if (pick === -1 ||
+            saturation > pickSaturation ||
+            (saturation === pickSaturation && degree[v] > degree[pick])) {
+            pick = v;
+            pickSaturation = saturation;
+        }
+    }
+    return pick;
+};
+const neighborColors = (neighbors, color) => {
+    const used = new Set();
+    for (const u of neighbors) {
+        if (color[u] !== -1)
+            used.add(color[u]);
+    }
+    return used;
+};
+export const decideExactOutcome = (exact, dsaturColors) => {
+    const exactColors = exact.coloring.reduce((m, c) => (c > m ? c : m), -1) + 1;
+    if (exactColors < dsaturColors) {
+        return {
+            useGroups: 'exact',
+            suffix: ` — exact: improved by ${dsaturColors - exactColors} deploy(s)`,
+        };
+    }
+    return { useGroups: 'dsatur', suffix: ' — exact: confirmed optimal' };
+};
+// Binary search on k = chromatic number, using `tryKColoring` to certify
+// or improve the DSATUR result. Runs every iteration to completion. The
+// loop exits when lo == hi (provably optimal). Result is never worse than
+// DSATUR alone.
+export const solveColoring = (input) => {
+    const { adjacency, n, dsaturColors, witness, dsaturColoring } = input;
+    const initialLowerBound = input.lowerBound;
+    if (initialLowerBound < witness.length) {
+        throw new Error(`solveColoring: lowerBound=${initialLowerBound} is below witness size ${witness.length}`);
+    }
+    let lo = initialLowerBound;
+    let hi = dsaturColors;
+    let best = dsaturColoring.slice();
+    while (lo < hi) {
+        const k = Math.floor((lo + hi) / 2);
+        const coloring = tryKColoring(adjacency, n, k, witness);
+        if (coloring !== null) {
+            best = coloring;
+            hi = k;
+        }
+        else {
+            lo = k + 1;
+        }
+    }
+    return { coloring: best, lowerBound: lo, optimal: lo === hi };
+};
+//# sourceMappingURL=exactColoring.js.map

package/lib/service/exactColoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exactColoring.js","sourceRoot":"","sources":["../../src/service/exactColoring.ts"],"names":[],"mappings":"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"}

package/lib/service/groupExecutor.d.ts

@@ -0,0 +1,29 @@
+import { Messages } from '@salesforce/core';
+import { Progress } from '@salesforce/sf-plugins-core';
+import type { CommonTokenStream } from 'apex-parser';
+import { ApexClassRepository } from '../adapter/apexClassRepository.js';
+import { ApexTestRunner } from '../adapter/apexTestRunner.js';
+import { ApexClass } from '../type/ApexClass.js';
+import { ApexMutationTestResult } from '../type/ApexMutationTestResult.js';
+import { MutantGenerator } from './mutantGenerator.js';
+import { MutationGroup } from './mutationGrouper.js';
+export declare class GroupExecutor {
+    private readonly apexClass;
+    private readonly apexClassName;
+    private readonly apexTestClassName;
+    private readonly apexClassContent;
+    private readonly tokenStream;
+    private readonly testMethodsPerLine;
+    private readonly mutantGenerator;
+    private readonly apexTestRunner;
+    private readonly apexClassRepository;
+    private readonly progress;
+    private readonly messages;
+    constructor(apexClass: ApexClass, apexClassName: string, apexTestClassName: string, apexClassContent: string, tokenStream: CommonTokenStream, testMethodsPerLine: Map<number, Set<string>>, mutantGenerator: MutantGenerator, apexTestRunner: ApexTestRunner, apexClassRepository: ApexClassRepository, progress: Progress, messages: Messages<string>);
+    evaluate(group: MutationGroup, completedSoFar: number, loopStartTime: number, totalMutations: number): Promise<ApexMutationTestResult['mutants']>;
+    private announceGroup;
+    private evaluateGroup;
+    private hasCoverageGap;
+    private buildGroupProgressMessage;
+    private buildMutantResult;
+}

package/lib/service/groupExecutor.js

@@ -0,0 +1,194 @@
+import { calculateMutationPosition, extractMutationOriginalText, } from './mutationLocation.js';
+import { formatRemainingTime } from './timeUtils.js';
+// Classify a deploy/test-run error into a per-mutant outcome plus a progress
+// message. The three branches match Salesforce-side failure modes: a compile
+// error from the Tooling API deploy, a governor-limit kill (which is a real
+// kill, not a runtime error), and any other thrown error.
+const classifyError = (error, mutation) => {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message.startsWith('Deployment failed:')) {
+        return {
+            status: 'CompileError',
+            statusReason: message,
+            progressMessage: `Mutation result: compile error at line ${mutation.target.startToken.line}`,
+        };
+    }
+    if (message.includes('LIMIT_USAGE_FOR_NS')) {
+        return {
+            status: 'Killed',
+            progressMessage: `Mutation result: mutant killed (${message})`,
+        };
+    }
+    return {
+        status: 'RuntimeError',
+        statusReason: message,
+        progressMessage: `Mutation result: runtime error (${message})`,
+    };
+};
+// Owns per-iteration evaluation: deploy mutated source, run union of covering
+// tests, attribute outcomes per mutation. A singleton group (k=1) is the leaf
+// case — error classification and status determination live here. Multi-mutation
+// groups (k>1) recurse into singletons on any failure (deploy, run, missing
+// outcome). All progress UI for a single iteration is emitted from this class
+// so the lifecycle service stays focused on orchestration.
+export class GroupExecutor {
+    apexClass;
+    apexClassName;
+    apexTestClassName;
+    apexClassContent;
+    tokenStream;
+    testMethodsPerLine;
+    mutantGenerator;
+    apexTestRunner;
+    apexClassRepository;
+    progress;
+    messages;
+    constructor(apexClass, apexClassName, apexTestClassName, apexClassContent, tokenStream, testMethodsPerLine, mutantGenerator, apexTestRunner, apexClassRepository, progress, messages) {
+        this.apexClass = apexClass;
+        this.apexClassName = apexClassName;
+        this.apexTestClassName = apexTestClassName;
+        this.apexClassContent = apexClassContent;
+        this.tokenStream = tokenStream;
+        this.testMethodsPerLine = testMethodsPerLine;
+        this.mutantGenerator = mutantGenerator;
+        this.apexTestRunner = apexTestRunner;
+        this.apexClassRepository = apexClassRepository;
+        this.progress = progress;
+        this.messages = messages;
+    }
+    async evaluate(group, completedSoFar, loopStartTime, totalMutations) {
+        const remainingText = formatRemainingTime(loopStartTime, completedSoFar, totalMutations);
+        this.announceGroup(group, remainingText, completedSoFar);
+        const { mutantResults, progressMessage } = await this.evaluateGroup(group, completedSoFar);
+        const newCompleted = completedSoFar + group.mutations.length;
+        const updatedRemainingText = formatRemainingTime(loopStartTime, newCompleted, totalMutations);
+        this.progress.update(newCompleted, {
+            info: `${updatedRemainingText}${progressMessage}`,
+        });
+        return mutantResults;
+    }
+    announceGroup(group, remainingText, completedSoFar) {
+        if (group.mutations.length === 1) {
+            const m = group.mutations[0];
+            this.progress.update(completedSoFar, {
+                info: `${remainingText}Deploying "${m.replacement}" mutation at line ${m.target.startToken.line}`,
+            });
+            const testMethods = this.testMethodsPerLine.get(m.target.startToken.line);
+            if (testMethods) {
+                this.progress.update(completedSoFar, {
+                    info: `${remainingText}Running ${testMethods.size} tests methods for "${m.replacement}" mutation at line ${m.target.startToken.line}`,
+                });
+            }
+            return;
+        }
+        const lines = group.mutations
+            .map(m => m.target.startToken.line)
+            .sort((a, b) => a - b)
+            .join(', ');
+        this.progress.update(completedSoFar, {
+            info: `${remainingText}Evaluating ${group.mutations.length} mutations on lines ${lines}`,
+        });
+    }
+    async evaluateGroup(group, completedSoFar) {
+        const mutated = this.mutantGenerator.mutateMany(group.mutations, this.tokenStream);
+        let testResult;
+        let batchError;
+        try {
+            await this.apexClassRepository.update({
+                Id: this.apexClass.Id,
+                Body: mutated,
+            });
+            testResult = await this.apexTestRunner.runTestMethods(this.apexTestClassName, group.testMethods);
+        }
+        catch (error) {
+            batchError = error;
+        }
+        // For k>1, a batch error or a coverage gap (test runner did not report
+        // every expected method) makes attribution ambiguous. Recurse with each
+        // mutation as its own singleton group; each child call hits the leaf and
+        // either succeeds or classifies its error directly.
+        if (group.mutations.length > 1 &&
+            (batchError !== undefined ||
+                this.hasCoverageGap(testResult, group.testMethods))) {
+            this.progress.update(completedSoFar, {
+                info: this.messages.getMessage('info.groupingFallback', [
+                    String(group.mutations.length),
+                ]),
+            });
+            const fallbackResults = [];
+            for (const m of group.mutations) {
+                const singleton = {
+                    mutations: [m],
+                    // extractCoveredLines guarantees the line is in the map.
+                    testMethods: this.testMethodsPerLine.get(m.target.startToken.line),
+                };
+                const { mutantResults } = await this.evaluateGroup(singleton, completedSoFar);
+                fallbackResults.push(...mutantResults);
+            }
+            return {
+                mutantResults: fallbackResults,
+                progressMessage: `Fallback for group of ${group.mutations.length} complete`,
+            };
+        }
+        // Leaf for k=1 with caught error: classify the error directly. (k>1 with
+        // an error was handled above by recursing into singletons.)
+        if (batchError !== undefined) {
+            const mutation = group.mutations[0];
+            const c = classifyError(batchError, mutation);
+            return {
+                mutantResults: [
+                    this.buildMutantResult(mutation, c.status, c.statusReason),
+                ],
+                progressMessage: c.progressMessage,
+            };
+        }
+        // Success path. Per-method outcomes when present (required for k>1
+        // attribution); fall back to summary-derived outcome when the test
+        // runner did not report per-method data (legacy behaviour for k=1).
+        const outcomeByMethod = new Map((testResult.tests ?? []).map(t => [t.methodName, t.outcome]));
+        const summaryFallback = testResult.summary.outcome === 'Passed' ? 'Pass' : 'Fail';
+        const mutantResults = group.mutations.map(m => {
+            const myMethods = this.testMethodsPerLine.get(m.target.startToken.line) ??
+                new Set();
+            // No covering tests (only possible in mocked or uncovered-line scenarios)
+            // → fall back to the summary outcome so behaviour matches the legacy
+            // evaluateMutation path.
+            const killed = myMethods.size === 0
+                ? summaryFallback !== 'Pass'
+                : [...myMethods].some(name => (outcomeByMethod.get(name) ?? summaryFallback) !== 'Pass');
+            return this.buildMutantResult(m, killed ? 'Killed' : 'Survived');
+        });
+        return {
+            mutantResults,
+            progressMessage: this.buildGroupProgressMessage(mutantResults),
+        };
+    }
+    hasCoverageGap(testResult, expectedMethods) {
+        const reported = new Set(testResult.tests.map(t => t.methodName));
+        for (const name of expectedMethods) {
+            if (!reported.has(name))
+                return true;
+        }
+        return false;
+    }
+    buildGroupProgressMessage(mutantResults) {
+        if (mutantResults.length === 1) {
+            return `Mutation result: ${mutantResults[0].status === 'Survived' ? 'zombie' : 'mutant killed'}`;
+        }
+        const killed = mutantResults.filter(r => r.status === 'Killed').length;
+        return `Group of ${mutantResults.length} evaluated: ${killed} killed, ${mutantResults.length - killed} survived`;
+    }
+    buildMutantResult(mutation, status, statusReason) {
+        const start = mutation.target.startToken;
+        return {
+            id: `${this.apexClassName}-${start.line}-${start.charPositionInLine}-${start.tokenIndex}-${Date.now()}`,
+            mutatorName: mutation.mutationName,
+            status,
+            ...(statusReason && { statusReason }),
+            location: calculateMutationPosition(mutation),
+            replacement: mutation.replacement,
+            original: extractMutationOriginalText(mutation, this.apexClassContent),
+        };
+    }
+}
+//# sourceMappingURL=groupExecutor.js.map

package/lib/service/groupExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groupExecutor.js","sourceRoot":"","sources":["../../src/service/groupExecutor.ts"],"names":[],"mappings":"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"}

package/lib/service/mutantGenerator.d.ts

@@ -17,6 +17,8 @@ export declare class MutantGenerator {
         exclude?: string[];
     }, skipPatterns?: RE2Instance[], allowedLines?: Set<number>, preParsed?: PreParsedInput): MutantGeneratorComputeResult;
     mutate(mutation: ApexMutation, tokenStream: CommonTokenStream): string;
+    mutateMany(mutations: ReadonlyArray<ApexMutation>, tokenStream: CommonTokenStream): string;
+    private assertNonOverlappingRanges;
     private filterRegistry;
     private warnUnknownMutators;
 }

package/lib/service/mutantGenerator.js

@@ -183,10 +183,35 @@ export class MutantGenerator {
         return { mutations: listener.getMutations(), tokenStream };
     }
     mutate(mutation, tokenStream) {
+        return this.mutateMany([mutation], tokenStream);
+    }
+    // Apply N non-overlapping mutations on a single rewriter, producing one
+    // mutated source. Used by the grouping path to deploy a batch of independent
+    // mutations in one Tooling-API class update.
+    //
+    // Caller guarantees mutations have non-overlapping token ranges (groupers
+    // enforce this naturally — same-line mutations always share covering tests
+    // and therefore conflict in the conflict graph). Defensively asserted.
+    mutateMany(mutations, tokenStream) {
+        this.assertNonOverlappingRanges(mutations);
         const rewriter = new TokenStreamRewriter(tokenStream);
-        rewriter.replace(mutation.target.startToken.tokenIndex, mutation.target.endToken.tokenIndex, mutation.replacement);
+        for (const mutation of mutations) {
+            rewriter.replace(mutation.target.startToken.tokenIndex, mutation.target.endToken.tokenIndex, mutation.replacement);
+        }
         return rewriter.getText();
     }
+    assertNonOverlappingRanges(mutations) {
+        if (mutations.length < 2)
+            return;
+        const sorted = [...mutations].sort((a, b) => a.target.startToken.tokenIndex - b.target.startToken.tokenIndex);
+        for (let i = 1; i < sorted.length; ++i) {
+            const prevEnd = sorted[i - 1].target.endToken.tokenIndex;
+            const currStart = sorted[i].target.startToken.tokenIndex;
+            if (currStart <= prevEnd) {
+                throw new Error(`mutateMany: overlapping token ranges (token ${currStart} ≤ ${prevEnd})`);
+            }
+        }
+    }
     filterRegistry(mutatorFilter) {
         if (!mutatorFilter) {
             return MUTATOR_REGISTRY;