Tooling compatibility matrix

Tooling Compatibility Matrix

Offline baseline for /harden-plan and high/critical /refactor-plan tooling recommendations. This skill never fetches versions. Every emitted version must include verify-latest-at-execution: true and an executor task to verify the chosen version is current and CVE-free before installation.

Standing rules

• Prefer existing project conventions when present.
• Use this matrix for deterministic first-pass versions and compatibility notes.
• Pair every install task with a build verification command.
• If a version or plugin compatibility is uncertain, mark it as hypothesis and require verification before install.
• Web fetch remains denied for harness workers.

Java matrix

Detected stack	Baseline tooling	Compatibility notes
Java 8 + Maven/Gradle	JUnit 5.x via junit-bom, AssertJ 3.x, Mockito, JaCoCo 0.8.x, PIT Java-8-compatible line + pitest-junit5-plugin	Choose a PIT line compatible with Java 8; verify plugin/JUnit 5 compatibility before install.
Java 11+ + Maven/Gradle	JUnit 5.x via junit-bom, AssertJ 3.x, Mockito, ApprovalTests when snapshots help, JaCoCo 0.8.x, current PIT + pitest-junit5-plugin	PIT >=1.15 requires Java 11+; plugin must match JUnit 5.x.
Existing JUnit 4	Keep JUnit 4 characterization if cheapest; add JUnit Vintage only when running JUnit 4 tests under JUnit Platform is required	Do not migrate tests as part of refactor safety unless required for execution.

Maven snippet templates

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.junit</groupId>
      <artifactId>junit-bom</artifactId>
      <version>${junit.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependency>
  <groupId>org.junit.jupiter</groupId>
  <artifactId>junit-jupiter</artifactId>
  <scope>test</scope>
</dependency>

<plugin>
  <groupId>org.pitest</groupId>
  <artifactId>pitest-maven</artifactId>
  <version>${pit.version}</version>
  <dependencies>
    <dependency>
      <groupId>org.pitest</groupId>
      <artifactId>pitest-junit5-plugin</artifactId>
      <version>${pitest.junit5.plugin.version}</version>
    </dependency>
  </dependencies>
</plugin>

Gradle snippet templates

dependencies {
  testImplementation(platform("org.junit:junit-bom:${junitVersion}"))
  testImplementation("org.junit.jupiter:junit-jupiter")
  testImplementation("org.assertj:assertj-core:${assertjVersion}")
}

test {
  useJUnitPlatform()
}

JavaScript and TypeScript matrix

Detected stack	Baseline tooling	Compatibility notes
Vite/Vitest present	Vitest, Testing Library when UI is present, @stryker-mutator/core + Vitest runner/plugin	Verify Node floor required by Stryker and runner plugin before install.
Jest present or non-Vite project	Jest, Testing Library when UI is present, @stryker-mutator/core + Jest runner/plugin	Keep Jest if already configured; avoid runner migration as safety-plan work.
No runner detected	Prefer Vitest for modern ESM/Vite projects; prefer Jest for existing CommonJS or Jest ecosystem clues	Record heuristic and verification task.

package.json snippet template

{
  "devDependencies": {
    "vitest": "${vitestVersion}",
    "@stryker-mutator/core": "${strykerVersion}"
  },
  "scripts": {
    "test": "vitest run"
  }
}

Python matrix

Detected stack	Baseline tooling	Compatibility notes
pytest present or no runner	pytest, coverage.py, mutmut	mutmut is the default mutation option for simple projects; verify Python version support.
parallel or distributed mutation need	pytest, coverage.py, cosmic-ray	cosmic-ray is heavier; use only when parallel execution materially matters.
unittest-only project	Keep unittest characterization initially; add pytest only if it lowers execution friction	Do not migrate tests for style alone.

Python snippet templates

[project.optional-dependencies]
test = [
  "pytest==${pytestVersion}",
  "coverage==${coverageVersion}",
  "mutmut==${mutmutVersion}",
]

[tool.pytest.ini_options]
testpaths = ["tests"]

pytest==${pytestVersion}
coverage==${coverageVersion}
mutmut==${mutmutVersion}

Characterization tooling

Need	Baseline option	Notes
Golden master / approval of large outputs	ApprovalTests (Java, .NET, Python, JS variants)	Anchors current output verbatim; good first net for monster methods and report-like outputs.
Characterizing persistence or external boundaries	Testcontainers	Real dependency in a disposable container; heavier — prefer at pinch points, not per unit.
Comparing JSON outputs	JsonUnit (Java) or snapshot testing in JS/TS	Whole-document asserts with ignorable fields; aligns with whole-object assert conventions.

Verification commands

Build tool	Verification command
Maven	mvn -q verify
Gradle wrapper	./gradlew check
Gradle	gradle check
npm/pnpm/yarn	npm test / pnpm test / yarn test matching existing lockfile
Python	pytest -q