Skip to content

Commit 83f5bdd

Browse files
committed
docs: unify PIT — trim generic invocation mechanics to the policy
Slim the CLAUDE.md PIT pointer to the uniform cross-repo form and trim the 'Run mutation tests' block (CLAUDE.md + README) to the command plus a short note; the @{argLine}/jacoco rationale now lives only in the workspace PIT policy. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017i6A5bMhgCSbiKibQhxwuz
1 parent 783d085 commit 83f5bdd

2 files changed

Lines changed: 4 additions & 10 deletions

File tree

CLAUDE.md

Lines changed: 3 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,11 @@ mvn install -Dgpg.skip=true # Install to local repo without GPG signing
1616
mvn test -Dtest=StreamBufferTest#testSimpleRoundTrip
1717
```
1818

19-
**Run mutation tests:**
19+
**Run mutation tests** (the `test-compile` prefix is required — see the
20+
[PIT policy](../workspace/policies/pit-mutation-testing.md)):
2021
```bash
2122
mvn test-compile org.pitest:pitest-maven:mutationCoverage
2223
```
23-
The `test-compile` prefix is required: it triggers JaCoCo's `prepare-agent` so the
24-
surefire `@{argLine}` resolves. The bare `mvn org.pitest:pitest-maven:mutationCoverage`
25-
fails with `NoSuchFileException: {argLine}`. See
26-
[`../workspace/policies/pit-mutation-testing.md`](../workspace/policies/pit-mutation-testing.md).
2724

2825
**Run JMH benchmarks:**
2926

@@ -116,9 +113,7 @@ See [`../workspace/policies/ci-test-diagnostics.md`](../workspace/policies/ci-te
116113
## PIT Mutation Testing
117114

118115
See [`../workspace/policies/pit-mutation-testing.md`](../workspace/policies/pit-mutation-testing.md).
119-
Run PIT with the lifecycle prefix — `mvn test-compile org.pitest:pitest-maven:mutationCoverage`
120-
(the bare goal fails with `NoSuchFileException: {argLine}`). The gate covers the whole
121-
`net.ladenthin.streambuffer` package at a 100% threshold.
116+
Run PIT with the lifecycle prefix — `mvn test-compile org.pitest:pitest-maven:mutationCoverage`.
122117

123118
## JPMS Module Descriptor
124119

README.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -381,8 +381,7 @@ Run a single test:
381381
mvn test -Dtest=StreamBufferTest#testSimpleRoundTrip
382382
```
383383

384-
Run mutation tests (the `test-compile` prefix is required so JaCoCo's `prepare-agent`
385-
resolves the surefire `@{argLine}`; the bare goal fails with `NoSuchFileException: {argLine}`):
384+
Run mutation tests (the `test-compile` prefix is required so PIT inherits JaCoCo's agent):
386385

387386
```bash
388387
mvn test-compile org.pitest:pitest-maven:mutationCoverage

0 commit comments

Comments
 (0)