feat(node): implement runtime process manager and java launcher (#108)

README.md

@@ -111,9 +111,12 @@ Node.js adapter work is tracked in issue `#106` and lives under `packages/memory
 
 Current state:
 - package scaffold exists (`@jongodb/memory-server`)
-- runtime process manager is in progress (`#108`)
+- runtime process manager is implemented (`#108`)
 - Jest/Vitest helpers and compatibility smoke suites are planned (`#109`, `#110`)
 
+Node runtime note:
+- provide Java classpath via `classpath` option or `JONGODB_CLASSPATH`
+
 ## Transaction Contract (Current)
 
 Supported in current scope:

build.gradle.kts

@@ -322,6 +322,15 @@ tasks.register<JavaExec>("r2CompatibilityEvidence") {
     )
 }
 
+tasks.register("printLauncherClasspath") {
+    group = "help"
+    description = "Prints the runtime classpath required for TcpMongoServerLauncher."
+    dependsOn("classes")
+    doLast {
+        println(sourceSets["main"].runtimeClasspath.asPath)
+    }
+}
+
 tasks.register<JavaExec>("r2CanaryCertificationEvidence") {
     group = "verification"
     description = "Generates R2 canary certification artifacts from project canary results."

packages/memory-server/README.md

@@ -3,8 +3,21 @@
 Node.js adapter package for starting a `jongodb` test server and obtaining a MongoDB URI.
 
 Current status:
-- package scaffold is in place
-- runtime process manager is tracked in issue `#108`
+- runtime process manager is implemented
+- Jest/Vitest convenience wrappers are tracked separately (`#109`)
+
+## Runtime Prerequisite
+
+The launcher requires a Java classpath that contains `jongodb` and runtime dependencies.
+
+- pass `classpath` in `startJongodbMemoryServer({ classpath })`, or
+- set `JONGODB_CLASSPATH` environment variable.
+
+Repository-local helper:
+
+```bash
+./.tooling/gradle-8.10.2/bin/gradle -q printLauncherClasspath
+```
 
 ## Local Commands
 

packages/memory-server/package.json

@@ -29,6 +29,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.17.57",
+    "mongodb": "^6.21.0",
     "typescript": "^5.9.2"
   }
 }