build: trim sdk-example to the plain mockwebserver3 artifact

Depend on the non-junit5 `mockwebserver3` in the sample: it manages the
embedded server's lifecycle by hand from main() and the smoke test, so the
JUnit 5 extension — and the JUnit it would otherwise drag onto the runtime
classpath — is not needed.

Also document the retry pillar's idempotency behavior in the sample (the
POST is retried because its in-memory body is replayable, so point readers
at IdempotencyKeyStep for non-idempotent writes) and update the module count
in CLAUDE.md to eleven, noting sdk-example as an unpublished usage sample.

Author: OmarAlJarrah

CLAUDE.md

@@ -29,9 +29,10 @@ modules) to skip it. See that module's `build.gradle.kts` for the pipeline.
 
 ## Repository Layout
 
-Ten Gradle modules (see `settings.gradle.kts`). `gradle/libs.versions.toml` is the single source of truth
-for dependency and plugin versions. Group `org.dexpace`, version `0.0.1-alpha.1`. (The tenth,
-`sdk-shrink-test`, is a test-only, unpublished R8 shrink-survival guard — not listed below.)
+Eleven Gradle modules (see `settings.gradle.kts`). `gradle/libs.versions.toml` is the single source of
+truth for dependency and plugin versions. Group `org.dexpace`, version `0.0.1-alpha.1`. (Two are
+unpublished and not listed below: `sdk-shrink-test`, a test-only R8 shrink-survival guard, and
+`sdk-example`, a runnable end-to-end usage sample.)
 
 | Module | Purpose | JVM target |
 |---|---|---|

gradle/libs.versions.toml

@@ -28,6 +28,7 @@ kotlinx-coroutines-test = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-t
 okio = { module = "com.squareup.okio:okio", version.ref = "okio" }
 okhttp = { module = "com.squareup.okhttp3:okhttp", version.ref = "okhttp" }
 okhttp-tls = { module = "com.squareup.okhttp3:okhttp-tls", version.ref = "okhttp" }
+okhttp-mockwebserver = { module = "com.squareup.okhttp3:mockwebserver3", version.ref = "mockwebserver" }
 okhttp-mockwebserver-junit5 = { module = "com.squareup.okhttp3:mockwebserver3-junit5", version.ref = "mockwebserver" }
 reactor-core = { module = "io.projectreactor:reactor-core", version.ref = "reactor" }
 reactor-test = { module = "io.projectreactor:reactor-test", version.ref = "reactor" }

sdk-example/build.gradle.kts

@@ -38,7 +38,10 @@ dependencies {
 
     // MockWebServer ships in the OkHttp project as a generic embedded HTTP server. The sample
     // drives it from `main()` so the end-to-end exchange runs deterministically with no network.
-    implementation(libs.okhttp.mockwebserver.junit5)
+    // The plain `mockwebserver3` artifact is used (not the `-junit5` variant): the sample manages
+    // the server lifecycle by hand from `main()` and the smoke test, so no JUnit 5 extension — and
+    // none of the JUnit it would drag onto the runtime classpath — is needed here.
+    implementation(libs.okhttp.mockwebserver)
     // okhttp-tls mints a self-signed certificate so the embedded server can speak HTTPS — the
     // AUTH pillar step refuses to stamp credentials over plaintext, so the sample uses TLS exactly
     // as a production caller would. `OkHttpClient` is configured directly here, hence the explicit

sdk-example/src/main/kotlin/org/dexpace/sdk/example/ExampleApp.kt

@@ -139,7 +139,11 @@ public fun buildPipeline(transport: HttpClient): HttpPipeline =
     HttpPipelineBuilder(transport)
         // REDIRECT pillar — follow 3xx responses within a hop budget.
         .append(DefaultRedirectStep())
-        // RETRY pillar — exponential backoff that honours `Retry-After`.
+        // RETRY pillar — exponential backoff that honours `Retry-After`. This re-sends a request
+        // when its method is idempotent or its body is replayable; the sample's POST carries a
+        // replayable (in-memory) body, so it qualifies. A real caller retrying a non-idempotent
+        // write should pair this with an idempotency key (see `IdempotencyKeyStep`) so a retried
+        // POST cannot create a duplicate server-side.
         .append(DefaultRetryStep())
         // AUTH pillar — stamp a static API key into the `Authorization` header.
         .append(