docs(dedup): add deduplication guides

Document static deduplication and Java coverage-based dedup Docker requirements.

Add Vale vocabulary entries for Java dedup terminology.

Signed-off-by: Asish Kumar <officialasishkumar@gmail.com>

Author: officialasishkumar

vale_styles/config/vocabularies/Base/accept.txt

@@ -12,10 +12,13 @@ Cmd
 Cobertura
 config
 containerName
+classpath
 custom_functions
 DBs
 declaratively
 Deduplication
+Distroless
+distroless
 distros
 dockerfile
 Docusaurus
@@ -105,3 +108,11 @@ updated_at
 shipping_address_id
 [Ll]inux
 [Ee]nv
+[Kk]8s
+[Dd]edup
+[Cc]ron
+[Tt]oolchain
+[Rr]untime[s]?
+normalisation
+behaviour
+polyglot

versioned_docs/version-3.0.0/keploy-cloud/deduplication.md

@@ -12,6 +12,7 @@ keywords:
   - deduplication
   - duplicate tests
   - golang
+  - java
   - testcases
 ---
 
@@ -113,3 +114,97 @@ In order to remove all the duplicate test cases, run the following command:
 ```bash
 keploy dedup --rm
 ```
+
+### For Java Applications
+
+**1. Pre-requisite**
+
+Attach a JaCoCo agent when you start the application for replay. Keploy reads coverage directly from JaCoCo during `keploy test`.
+
+Do **not** package `org.jacoco.agent` inside the application runtime classpath or fat jar. Keep it as a standalone agent jar and attach it only through `-javaagent`.
+
+**2. Native Run Configuration**
+
+Build the application and keep a `jacocoagent.jar` next to the app artifact:
+
+```bash
+mvn clean package -DskipTests
+```
+
+Run deduplication natively with:
+
+```bash
+keploy test -c "java -javaagent:target/jacocoagent.jar -jar target/app.jar" --dedup
+```
+
+**3. Dockerfile Configuration (Important for Docker Users)**
+
+Your runtime image must copy the JaCoCo agent jar and start Java with `destfile=/tmp/jacoco.exec`.
+
+Example fat-jar runtime image:
+
+```dockerfile
+FROM eclipse-temurin:17-jre
+
+WORKDIR /app
+
+COPY target/app.jar /app/app.jar
+COPY target/jacocoagent.jar /app/jacocoagent.jar
+
+ENTRYPOINT ["java", "-javaagent:/app/jacocoagent.jar=destfile=/tmp/jacoco.exec", "-jar", "/app/app.jar"]
+```
+
+Example exploded-classpath runtime image:
+
+```dockerfile
+FROM eclipse-temurin:17-jre
+
+WORKDIR /app
+
+COPY target/classes /app/classes
+COPY target/dependency /app/libs
+COPY target/jacocoagent.jar /app/jacocoagent.jar
+
+ENV KEPLOY_JAVA_CLASS_DIRS=/app/classes
+
+ENTRYPOINT ["java", "-javaagent:/app/jacocoagent.jar=destfile=/tmp/jacoco.exec", "-cp", "/app/classes:/app/libs/*", "com.example.Main"]
+```
+
+Keep these Docker constraints in mind:
+
+- Rebuild the image before replay with `docker compose build` so Keploy runs the current jar, agent, and Dockerfile.
+- Leave `/tmp` available to the container. Keploy injects a shared `/tmp` mount during `keploy test`, so do not pre-bind or replace `/tmp` in your Compose service.
+- Distroless and read-only root filesystem images are supported as long as the image still includes a Java launcher, copies `jacocoagent.jar`, and leaves `/tmp` writable at runtime.
+- Fat-jar images do not need `KEPLOY_JAVA_CLASS_DIRS`. Exploded-classpath images do.
+- The current Java dedup sample is validated in CI on Java 8, 17, and 21. The distroless example uses Java 17.
+
+**4. Run Deduplication**
+
+For Docker, run:
+
+```bash
+docker compose build
+keploy test -c "docker compose up" --containerName containerName --dedup
+```
+
+For Native, run:
+
+```bash
+keploy test -c "java -javaagent:target/jacocoagent.jar -jar target/app.jar" --dedup
+```
+
+This will generate a `dedupData.yaml` file.
+
+After this, run:
+
+```bash
+keploy dedup
+```
+
+This command will create a `duplicates.yaml` file which will contain all the test cases which were found to be duplicate.
+
+In order to remove all the duplicate test cases, run the following command:
+
+```bash
+keploy dedup --rm
+```

versioned_docs/version-4.0.0/keploy-cloud/deduplication.md

@@ -2,7 +2,7 @@
 id: deduplication
 title: Remove Duplicates Tests
 sidebar_label: Remove Duplicate Tests
-description: "Remove duplicate test cases with Keploy Enterprise deduplication — save time and resources by eliminating redundant tests."
+description: "Remove duplicate test cases with Keploy Enterprise deduplication: save time and resources by eliminating redundant tests."
 tags:
   - explanation
   - feature guide
@@ -13,6 +13,7 @@ keywords:
   - deduplication
   - duplicate tests
   - golang
+  - java
   - testcases
 ---
 
@@ -114,3 +115,97 @@ In order to remove all the duplicate test cases, run the following command:
 ```bash
 keploy dedup --rm
 ```
+
+### For Java Applications
+
+**1. Pre-requisite**
+
+Attach a JaCoCo agent when you start the application for replay. Keploy reads coverage directly from JaCoCo during `keploy test`.
+
+Do **not** package `org.jacoco.agent` inside the application runtime classpath or fat jar. Keep it as a standalone agent jar and attach it only through `-javaagent`.
+
+**2. Native Run Configuration**
+
+Build the application and keep a `jacocoagent.jar` next to the app artifact:
+
+```bash
+mvn clean package -DskipTests
+```
+
+Run deduplication natively with:
+
+```bash
+keploy test -c "java -javaagent:target/jacocoagent.jar -jar target/app.jar" --dedup
+```
+
+**3. Dockerfile Configuration (Important for Docker Users)**
+
+Your runtime image must copy the JaCoCo agent jar and start Java with `destfile=/tmp/jacoco.exec`.
+
+Example fat-jar runtime image:
+
+```dockerfile
+FROM eclipse-temurin:17-jre
+
+WORKDIR /app
+
+COPY target/app.jar /app/app.jar
+COPY target/jacocoagent.jar /app/jacocoagent.jar
+
+ENTRYPOINT ["java", "-javaagent:/app/jacocoagent.jar=destfile=/tmp/jacoco.exec", "-jar", "/app/app.jar"]
+```
+
+Example exploded-classpath runtime image:
+
+```dockerfile
+FROM eclipse-temurin:17-jre
+
+WORKDIR /app
+
+COPY target/classes /app/classes
+COPY target/dependency /app/libs
+COPY target/jacocoagent.jar /app/jacocoagent.jar
+
+ENV KEPLOY_JAVA_CLASS_DIRS=/app/classes
+
+ENTRYPOINT ["java", "-javaagent:/app/jacocoagent.jar=destfile=/tmp/jacoco.exec", "-cp", "/app/classes:/app/libs/*", "com.example.Main"]
+```
+
+Keep these Docker constraints in mind:
+
+- Rebuild the image before replay with `docker compose build` so Keploy runs the current jar, agent, and Dockerfile.
+- Leave `/tmp` available to the container. Keploy injects a shared `/tmp` mount during `keploy test`, so do not pre-bind or replace `/tmp` in your Compose service.
+- Distroless and read-only root filesystem images are supported as long as the image still includes a Java launcher, copies `jacocoagent.jar`, and leaves `/tmp` writable at runtime.
+- Fat-jar images do not need `KEPLOY_JAVA_CLASS_DIRS`. Exploded-classpath images do.
+- The current Java dedup sample is validated in CI on Java 8, 17, and 21. The distroless example uses Java 17.
+
+**4. Run Deduplication**
+
+For Docker, run:
+
+```bash
+docker compose build
+keploy test -c "docker compose up" --containerName containerName --dedup
+```
+
+For Native, run:
+
+```bash
+keploy test -c "java -javaagent:target/jacocoagent.jar -jar target/app.jar" --dedup
+```
+
+This will generate a `dedupData.yaml` file.
+
+After this, run:
+
+```bash
+keploy dedup
+```
+
+This command will create a `duplicates.yaml` file which will contain all the test cases which were found to be duplicate.
+
+In order to remove all the duplicate test cases, run the following command:
+
+```bash
+keploy dedup --rm
+```