feat: add bigDataTestRun task for interactive troubleshooting mode

- Introduced `bigDataTestRun` Gradle task for starting containers and keeping them active until interrupted, enabling manual debugging workflows.
- Updated Spring plugin README and user guide with usage instructions and examples.
- Bumped `org.openprojectx.bigdata-test` version to `0.1.17-SNAPSHOT`.

Author: CoderYellow

doc/user-guide.adoc

@@ -1544,11 +1544,19 @@ bigDataTest {
 
 The plugin registers:
 
-* `bigDataTestStart` - starts the configured kit in the Gradle daemon.
-* `bigDataTestStop` - explicitly stops it.
+* `bigDataTestStart` - starts the configured kit for the current Gradle build and then returns. This task is intended as a dependency of app/test tasks.
+* `bigDataTestRun` - starts the configured kit and keeps the Gradle process running until interrupted. Use this for manual troubleshooting.
+* `bigDataTestStop` - explicitly stops the kit in the current Gradle build.
 
 By default, the plugin wires `bigDataTestStart` before `JavaExec` and `Test` tasks and injects endpoint and extension output properties as JVM system properties immediately before the task launches. It also injects environment variables derived from the same property map. The kit is closed automatically when the Gradle build service closes at the end of the build.
 
+`bigDataTestStart` is not an interactive keep-alive command. If you run it directly, it starts the kit, prints the injected property count, and exits when the build finishes. For a long-running local environment, run:
+
+[source,bash]
+----
+GRADLE_USER_HOME=/data/.gradle ./gradlew bigDataTestRun
+----
+
 Disable automatic task wiring when you want explicit task dependencies:
 
 [source,kotlin]

example/spring-gradle-plugin/README.md

@@ -16,6 +16,12 @@ cd example/spring-gradle-plugin
 GRADLE_USER_HOME=/data/.gradle ../../gradlew bootRunLocal
 ```
 
+For manual troubleshooting without starting the Spring app, keep the containers running with:
+
+```bash
+GRADLE_USER_HOME=/data/.gradle ../../gradlew bigDataTestRun
+```
+
 The Gradle plugin starts Kerberos, HDFS, and LocalStack S3 before `bootRunLocal` launches the
 Spring JVM, runs the TOML extensions, and injects endpoint/extension output as JVM system
 properties and environment variables. The application reads the JVM properties from

example/spring-gradle-plugin/build.gradle.kts

@@ -3,11 +3,11 @@ plugins {
     kotlin("plugin.spring") version "2.2.21"
     id("org.springframework.boot") version "4.0.5"
     id("io.spring.dependency-management") version "1.1.7"
-    id("org.openprojectx.bigdata-test") version "0.1.12-SNAPSHOT"
+    id("org.openprojectx.bigdata-test") version "0.1.17-SNAPSHOT"
 }
 
 group = "org.openprojectx.bigdata.test.example"
-version = "0.1.12-SNAPSHOT"
+version = "0.1.17-SNAPSHOT"
 
 kotlin {
     jvmToolchain(17)

gradle-plugin/src/main/kotlin/org/openprojectx/bigdata/test/gradle/BigDataTestGradlePlugin.kt

@@ -115,7 +115,13 @@ class BigDataTestGradlePlugin : Plugin<Project> {
 
         val startTask = project.tasks.register("bigDataTestStart", BigDataTestStartTask::class.java) { task ->
             task.group = "bigdata-test"
-            task.description = "Start configured bigdata-test containers in the Gradle daemon."
+            task.description = "Start configured bigdata-test containers for this Gradle build."
+            task.kitService.set(service)
+            task.usesService(service)
+        }
+        project.tasks.register("bigDataTestRun", BigDataTestRunTask::class.java) { task ->
+            task.group = "bigdata-test"
+            task.description = "Start configured bigdata-test containers and keep them running until the Gradle process is interrupted."
             task.kitService.set(service)
             task.usesService(service)
         }
@@ -132,7 +138,9 @@ class BigDataTestGradlePlugin : Plugin<Project> {
 
             if (extension.enabled.get() && extension.autoConfigureJavaExecTasks.get()) {
                 project.tasks.withType(JavaExec::class.java).configureEach { task ->
-                    if (task.name == "bigDataTestStart" || task.name == "bigDataTestStop") return@configureEach
+                    if (task.name == "bigDataTestStart" || task.name == "bigDataTestRun" || task.name == "bigDataTestStop") {
+                        return@configureEach
+                    }
                     task.dependsOn(startTask)
                     task.usesService(service)
                     task.doFirst {

gradle-plugin/src/main/kotlin/org/openprojectx/bigdata/test/gradle/BigDataTestTasks.kt

@@ -18,6 +18,26 @@ abstract class BigDataTestStartTask : DefaultTask() {
     }
 }
 
+@DisableCachingByDefault(because = "Starts external Docker containers and waits for user interruption.")
+abstract class BigDataTestRunTask : DefaultTask() {
+    @get:Internal
+    abstract val kitService: Property<BigDataTestGradleService>
+
+    @TaskAction
+    fun run() {
+        val properties = kitService.get().startIfNeeded()
+        logger.lifecycle("bigdata-test started; injected ${properties.size} properties")
+        logger.lifecycle("bigdata-test is running. Press Ctrl+C to stop the Gradle process and close containers.")
+        try {
+            while (!Thread.currentThread().isInterrupted) {
+                Thread.sleep(1_000)
+            }
+        } catch (_: InterruptedException) {
+            Thread.currentThread().interrupt()
+        }
+    }
+}
+
 @DisableCachingByDefault(because = "Stops external Docker containers and has no cacheable outputs.")
 abstract class BigDataTestStopTask : DefaultTask() {
     @get:Internal