fix(scripts): make mvnw invocation cross-platform for Windows support

Replace Unix-only `./mvnw` calls in npm scripts with a cross-platform
TypeScript runner that resolves `./mvnw` (Unix) or `mvnw.cmd` (Windows)
based on `process.platform`.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: FelixTJDietrich

package.json

@@ -18,8 +18,8 @@
 		"generate:api": "npm run generate:api:intelligence-service && npm run generate:api:application-server",
 		"format:java": "node --import tsx scripts/run-quiet.ts prettier --write \"server/application-server/src/**/*.java\" --config-precedence prefer-file --config server/application-server/.prettierrc.yaml --ignore-path server/application-server/.prettierignore",
 		"format:java:check": "node --import tsx scripts/run-quiet.ts prettier --check \"server/application-server/src/**/*.java\" --config-precedence prefer-file --config server/application-server/.prettierrc.yaml --ignore-path server/application-server/.prettierignore",
-		"lint:java": "cd server/application-server && ./mvnw pmd:check -q",
-		"lint:java:report": "cd server/application-server && ./mvnw pmd:pmd && echo 'Report: server/application-server/target/site/pmd.html'",
+		"lint:java": "node --import tsx scripts/run-mvnw.ts pmd:check -q",
+		"lint:java:report": "node --import tsx scripts/run-mvnw.ts pmd:pmd && echo 'Report: server/application-server/target/site/pmd.html'",
 		"format:intelligence-service": "npm -w server/intelligence-service run format",
 		"format:intelligence-service:check": "npm -w server/intelligence-service run format:check",
 		"lint:intelligence-service": "npm -w server/intelligence-service run lint",

scripts/run-mvnw.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform Maven wrapper runner.
+ * Resolves ./mvnw (Unix) or mvnw.cmd (Windows) automatically.
+ *
+ * Usage: node --import tsx scripts/run-mvnw.ts [maven-args...]
+ * Example: node --import tsx scripts/run-mvnw.ts pmd:check -q
+ */
+
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const mvnwDir = path.resolve(__dirname, "..", "server", "application-server");
+const isWindows = process.platform === "win32";
+
+function main(): void {
+	// shell: true is required on Windows for .cmd files (CVE-2024-27980).
+	// Safe here because args come from hardcoded npm scripts, not user input.
+	const result = spawnSync(
+		isWindows ? "mvnw.cmd" : "./mvnw",
+		process.argv.slice(2),
+		{
+			stdio: "inherit",
+			cwd: mvnwDir,
+			shell: isWindows,
+		},
+	);
+
+	if (result.error) {
+		const errCode = (result.error as NodeJS.ErrnoException).code;
+		if (errCode === "ENOENT") {
+			console.error(
+				`Maven wrapper not found in ${mvnwDir}. Is the Maven wrapper installed?`,
+			);
+		} else {
+			console.error(`Failed to run Maven wrapper: ${result.error.message}`);
+		}
+		process.exitCode = 1;
+		return;
+	}
+
+	if (result.signal) {
+		process.kill(process.pid, result.signal);
+		return;
+	}
+
+	process.exitCode = result.status ?? 1;
+}
+
+main();