@maintainer-pro/ai-cli 0.1.9 → 0.1.11

package/dist/index.cjs

@@ -62,6 +62,7 @@ __export(index_exports, {
   createToolValidator: () => createToolValidator,
   defaultAiServerApp: () => defaultAiServerApp,
   detectHostAppsFromFiles: () => detectHostAppsFromFiles,
+  detectHostAppsFromFolders: () => detectHostAppsFromFolders,
   ensureAiServerApp: () => ensureAiServerApp,
   ensureProjectDataDir: () => ensureProjectDataDir,
   ensureSingleHost: () => ensureSingleHost,
@@ -71,6 +72,7 @@ __export(index_exports, {
   getProviderPreference: () => getProviderPreference,
   hostAppsCachePath: () => hostAppsCachePath2,
   hostAppsFingerprint: () => hostAppsFingerprint,
+  hostAppsFingerprintForFolders: () => hostAppsFingerprintForFolders,
   inspectAndRepairWorkspace: () => inspectAndRepairWorkspace,
   inspectConfigOnly: () => inspectConfigOnly,
   isDevMode: () => isDevMode,
@@ -105,6 +107,7 @@ __export(index_exports, {
   sanitizeProjectId: () => sanitizeProjectId,
   saveChatAttachments: () => saveChatAttachments,
   toNextRoute: () => toNextRoute,
+  unionHostApps: () => unionHostApps,
   upsertManagedIgnoreFile: () => upsertManagedIgnoreFile,
   writeCollaboraterApps: () => writeCollaboraterApps,
   writeHostAppsCache: () => writeHostAppsCache
@@ -2601,9 +2604,9 @@ var inspectJsonSchema = import_zod.z.object({
   name: import_zod.z.string().max(200).optional(),
   summary: import_zod.z.string().max(800).optional(),
   scripts: import_zod.z.object({
-    ui: import_zod.z.string().min(1).max(64).optional(),
-    backend: import_zod.z.string().min(1).max(64).optional(),
-    app: import_zod.z.string().min(1).max(64).optional()
+    ui: import_zod.z.string().min(1).max(200).optional(),
+    backend: import_zod.z.string().min(1).max(200).optional(),
+    app: import_zod.z.string().min(1).max(200).optional()
   }).optional(),
   ports: import_zod.z.object({
     ui: import_zod.z.number().int().min(1).max(65535).optional(),
@@ -2631,12 +2634,12 @@ function setupSystemPrompt(input) {
 Workspace: ${input.workspaceDir}
 App name: ${input.appName || "the app"}
 
-Inspect this repository (package.json, README, lockfiles, existing env files, how the UI and API start).
+Inspect this repository (package.json, README, lockfiles, Maven/Gradle/sbt files, Spring/Play config, existing env files, how the UI and API start).
 You MAY edit files to fix setup problems that would block local run or the chat widget (env keys, widget mount, missing config).
 Do NOT start long-lived dev servers, tunnels, or install global tools.
 Do NOT run \`npm run dev\` or similar.
 
-Script names you report MUST already exist in package.json. Omit chat/ai-server scripts.
+Script names you report MUST already exist in package.json, OR be a real JVM start command (./gradlew bootRun, mvn spring-boot:run, sbt run). Omit chat/ai-server scripts.
 
 End with a short human summary AND one \`\`\`json fence with:
 
@@ -2708,7 +2711,21 @@ ${lock}`);
     "vite.config.mjs",
     "next.config.js",
     "next.config.mjs",
-    "next.config.ts"
+    "next.config.ts",
+    "pom.xml",
+    "build.gradle",
+    "build.gradle.kts",
+    "build.sbt",
+    "application.yml",
+    "application.yaml",
+    "application.properties",
+    "application.conf",
+    "src/main/resources/application.yml",
+    "src/main/resources/application.yaml",
+    "src/main/resources/application.properties",
+    "src/main/resources/application.conf",
+    "src/main/resources/application-dev.yml",
+    "conf/application.conf"
   ]) {
     const body = readSnippet(import_node_path7.default.join(folder, rel), 2500);
     if (body) parts.push(`### ${rel}
@@ -2736,7 +2753,7 @@ DO NOT edit, create, or delete any files.
 DO NOT run shell commands, install packages, or start servers.
 Only infer how this project runs locally from the excerpts.
 
-Script names you report MUST appear in package.json scripts. Omit chat/ai-server scripts.
+Script names you report MUST appear in package.json scripts, OR be a JVM start command such as \`./gradlew bootRun\`, \`mvn spring-boot:run\`, or \`sbt run\`. Omit chat/ai-server scripts.
 
 Reply with a short human summary AND one \`\`\`json fence with:
 
@@ -2744,8 +2761,8 @@ Reply with a short human summary AND one \`\`\`json fence with:
   "kind": "next" | "vite" | "html" | "empty" | "other",
   "name": "package or folder name",
   "summary": "one sentence about this project",
-  "scripts": { "ui": "dev:client", "backend": "dev:server" },
-  "ports": { "ui": 5173, "backend": 4100 },
+  "scripts": { "ui": "dev:client", "backend": "sbt run" },
+  "ports": { "ui": 5173, "backend": 9000 },
   "issues": ["uncertainties"],
   "fixes": [],
   "ready": true
@@ -2908,7 +2925,8 @@ function normalizeHostApp(raw) {
       row.source
     ) ? row.source : "manual",
     locked: row.locked === true || id === AI_SERVER_APP_ID || role === "ai-server",
-    host: role !== "ai-server" && id !== AI_SERVER_APP_ID && row.host === true
+    host: role !== "ai-server" && id !== AI_SERVER_APP_ID && row.host === true,
+    folderPath: typeof row.folderPath === "string" && row.folderPath.trim() ? row.folderPath.trim().slice(0, 500) : null
   };
 }
 function ensureSingleHost(apps) {
@@ -3021,19 +3039,151 @@ function configPort(folder, files) {
   }
   return 0;
 }
-function hostAppsFingerprint(folder) {
+var JVM_CONFIG_FILES = [
+  "pom.xml",
+  "build.gradle",
+  "build.gradle.kts",
+  "settings.gradle",
+  "settings.gradle.kts",
+  "build.sbt",
+  "gradle.properties",
+  "application.yml",
+  "application.yaml",
+  "application.properties",
+  "application.conf",
+  "src/main/resources/application.yml",
+  "src/main/resources/application.yaml",
+  "src/main/resources/application.properties",
+  "src/main/resources/application.conf",
+  "src/main/resources/application-dev.yml",
+  "src/main/resources/application-dev.yaml",
+  "src/main/resources/application-dev.properties",
+  "src/main/resources/application-local.yml",
+  "conf/application.conf",
+  "conf/application.yml"
+];
+var FINGERPRINT_FILES = [
+  "package.json",
+  ...ENV_FILES,
+  "vite.config.ts",
+  "vite.config.js",
+  "vite.config.mjs",
+  "next.config.js",
+  "next.config.mjs",
+  "next.config.ts",
+  ...JVM_CONFIG_FILES
+];
+function fileExists(folder, rel) {
+  return import_node_fs4.default.existsSync(import_node_path8.default.join(folder, rel));
+}
+function jvmPortFromText(text) {
+  const patterns = [
+    /(?:^|\n)\s*server\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*SERVER_PORT\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*play\.http\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*play\.server\.http\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*http\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /-Dserver\.port=(\d{2,5})/i,
+    /systemProperty\s*\(?\s*["']server\.port["']\s*,\s*["']?(\d{2,5})/i,
+    /["']play\.http\.port["']\s*->\s*["']?(\d{2,5})/i
+  ];
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    const port = parsePort(match?.[1]);
+    if (port) return port;
+  }
+  const yaml = text.match(
+    /(?:^|\n)server:\s*\n(?:[ \t].*\n)*?[ \t]+port:\s*["']?(\d{2,5})/i
+  );
+  return parsePort(yaml?.[1]);
+}
+function looksLike(haystack, ...needles) {
+  const lower = haystack.toLowerCase();
+  return needles.some((needle) => lower.includes(needle.toLowerCase()));
+}
+function wrapperCommand(folder, unixName, winName, fallback) {
+  if (process.platform === "win32") {
+    return fileExists(folder, winName) ? `.\\${winName}` : fallback;
+  }
+  return fileExists(folder, unixName) ? `./${unixName}` : fallback;
+}
+function detectJvmHostApp(folder, opts = {}) {
+  const resolved = import_node_path8.default.resolve(folder);
+  const texts = [];
+  let foundMarker = false;
+  for (const rel of JVM_CONFIG_FILES) {
+    const text = readText(import_node_path8.default.join(resolved, rel));
+    if (!text) continue;
+    foundMarker = true;
+    texts.push(text);
+  }
+  const hasGradle = fileExists(resolved, "build.gradle") || fileExists(resolved, "build.gradle.kts") || fileExists(resolved, "settings.gradle") || fileExists(resolved, "settings.gradle.kts") || fileExists(resolved, "gradlew") || fileExists(resolved, "gradlew.bat");
+  const hasMaven = fileExists(resolved, "pom.xml");
+  const hasSbt = fileExists(resolved, "build.sbt");
+  if (!foundMarker && !hasGradle && !hasMaven && !hasSbt) return null;
+  const blob = texts.join("\n");
+  const { merged } = readProjectEnvLayers(resolved);
+  const envPort = parsePort(merged.SERVER_PORT) || parsePort(merged.PLAY_HTTP_PORT) || parsePort(merged.HTTP_PORT) || parsePort(merged.PORT);
+  let port = envPort || jvmPortFromText(blob);
+  const isPlay = looksLike(
+    blob,
+    "play.http.port",
+    "enablePlugins(Play",
+    "com.typesafe.play",
+    "play-scala",
+    "play-java"
+  );
+  const isSpring = looksLike(
+    blob,
+    "spring-boot",
+    "springframework.boot",
+    "org.springframework"
+  );
+  const isQuarkus = looksLike(blob, "quarkus", "io.quarkus");
+  if (!port) {
+    port = isPlay ? 9e3 : 8080;
+  }
+  let startCommand = null;
+  if (hasGradle) {
+    const gradle = wrapperCommand(resolved, "gradlew", "gradlew.bat", "gradle");
+    startCommand = isQuarkus ? `${gradle} quarkusDev` : isPlay ? `${gradle} run` : `${gradle} bootRun`;
+  } else if (hasMaven) {
+    const mvn = wrapperCommand(resolved, "mvnw", "mvnw.cmd", "mvn");
+    startCommand = isQuarkus ? `${mvn} quarkus:dev` : `${mvn} spring-boot:run`;
+  } else if (hasSbt) {
+    startCommand = "sbt run";
+  }
+  const framework = isPlay ? "Play" : isSpring ? "Spring" : isQuarkus ? "Quarkus" : hasSbt ? "Scala" : "JVM";
+  return {
+    id: "backend",
+    name: opts.appName ? `${opts.appName} API` : `${framework} backend`,
+    role: "backend",
+    port,
+    startCommand,
+    source: envPort ? "env" : "package",
+    folderPath: resolved
+  };
+}
+function uniqueWorkspaceDirs(primary, extra) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of [primary, ...extra || []]) {
+    if (!raw || typeof raw !== "string") continue;
+    const resolved = import_node_path8.default.resolve(raw.trim());
+    const key = process.platform === "win32" ? resolved.toLowerCase() : resolved;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(resolved);
+  }
+  return out;
+}
+function folderSlug(folder) {
+  return import_node_path8.default.basename(import_node_path8.default.resolve(folder)).replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 24) || "app";
+}
+function fingerprintOneFolder(folder) {
   const resolved = import_node_path8.default.resolve(folder);
   const parts = [];
-  for (const rel of [
-    "package.json",
-    ...ENV_FILES,
-    "vite.config.ts",
-    "vite.config.js",
-    "vite.config.mjs",
-    "next.config.js",
-    "next.config.mjs",
-    "next.config.ts"
-  ]) {
+  for (const rel of FINGERPRINT_FILES) {
     const file = import_node_path8.default.join(resolved, rel);
     if (!import_node_fs4.default.existsSync(file)) continue;
     try {
@@ -3042,7 +3192,16 @@ function hostAppsFingerprint(folder) {
     } catch {
     }
   }
-  return (0, import_node_crypto4.createHash)("sha256").update(parts.join("|") || resolved).digest("hex").slice(0, 32);
+  return parts.join("|") || resolved;
+}
+function hostAppsFingerprint(folder) {
+  const resolved = import_node_path8.default.resolve(folder);
+  return (0, import_node_crypto4.createHash)("sha256").update(fingerprintOneFolder(resolved)).digest("hex").slice(0, 32);
+}
+function hostAppsFingerprintForFolders(folders) {
+  const dirs = uniqueWorkspaceDirs(folders[0] || "", folders.slice(1));
+  const parts = dirs.map((dir) => `${dir}:${fingerprintOneFolder(dir)}`);
+  return (0, import_node_crypto4.createHash)("sha256").update(parts.join("||") || "empty").digest("hex").slice(0, 32);
 }
 function pickScript(scripts, names) {
   return names.find((name) => scripts[name] && !isChatScript(name, scripts[name])) || null;
@@ -3061,9 +3220,14 @@ function detectHostAppsFromFiles(folder, opts = {}) {
     source: envAi ? "env" : "default"
   });
   const envPorts = {
-    PORT: layers.filter((layer) => layer.file !== ".env.example").map((layer) => ({ file: layer.file, port: parsePort(layer.values.PORT) })).filter((row) => row.port),
+    PORT: layers.filter((layer) => layer.file !== ".env.example").map((layer) => ({
+      file: layer.file,
+      port: parsePort(layer.values.PORT) || parsePort(layer.values.SERVER_PORT) || parsePort(layer.values.PLAY_HTTP_PORT)
+    })).filter((row) => row.port),
     APP_URL: parsePort(merged.APP_URL || merged.NEXT_PUBLIC_APP_URL || merged.PUBLIC_URL),
-    API_PORT: parsePort(merged.API_PORT || merged.API_URL || merged.VITE_API_URL)
+    API_PORT: parsePort(
+      merged.API_PORT || merged.API_URL || merged.VITE_API_URL || merged.SERVER_PORT || merged.PLAY_HTTP_PORT || merged.HTTP_PORT
+    )
   };
   const portValues = [...new Set(envPorts.PORT.map((row) => row.port))];
   if (portValues.length > 1) {
@@ -3108,7 +3272,8 @@ function detectHostAppsFromFiles(folder, opts = {}) {
       port,
       startCommand: `npm run ${uiScript}`,
       source: uiFromEnv ? "env" : scriptPort ? "package" : "package",
-      host: true
+      host: true,
+      folderPath: resolved
     });
   } else if (uiFromEnv) {
     apps.push({
@@ -3118,7 +3283,8 @@ function detectHostAppsFromFiles(folder, opts = {}) {
       port: uiFromEnv,
       startCommand: scripts.dev ? "npm run dev" : null,
       source: "env",
-      host: true
+      host: true,
+      folderPath: resolved
     });
   }
   if (apiScript && apiScript !== uiScript) {
@@ -3130,19 +3296,83 @@ function detectHostAppsFromFiles(folder, opts = {}) {
       role: "backend",
       port,
       startCommand: `npm run ${apiScript}`,
-      source: envPorts.API_PORT ? "env" : "package"
+      source: envPorts.API_PORT ? "env" : "package",
+      folderPath: resolved
     });
   }
-  const hostApps = apps.filter((app) => app.role !== "ai-server");
+  const hasHostApp = apps.some((app) => app.role !== "ai-server");
+  const usedPorts = new Set(
+    apps.filter((app) => app.role !== "ai-server").map((app) => app.port)
+  );
+  const jvm = detectJvmHostApp(resolved, { appName: opts.appName });
+  if (jvm && !usedPorts.has(jvm.port)) {
+    apps.push({
+      ...jvm,
+      id: apps.some((app) => app.id === "backend") ? `backend-${folderSlug(resolved)}` : "backend",
+      host: !hasHostApp
+    });
+  } else if (jvm && usedPorts.has(jvm.port) && !hasHostApp) {
+    reasons.push(
+      `JVM config suggests port ${jvm.port}, which is already used by another detected app`
+    );
+  }
+  const tagged = apps.map(
+    (app) => app.role === "ai-server" || app.folderPath ? app : { ...app, folderPath: resolved }
+  );
+  const hostApps = tagged.filter((app) => app.role !== "ai-server");
   if (pkg && Object.keys(scripts).length && hostApps.length === 0) {
     reasons.push("Found package.json scripts but no host app port in env or config");
   }
   return {
-    apps: ensureAiServerApp(apps, aiPort),
+    apps: ensureAiServerApp(tagged, aiPort),
     reasons,
     confused: reasons.length > 0
   };
 }
+function detectHostAppsFromFolders(folders, opts = {}) {
+  const dirs = uniqueWorkspaceDirs(folders[0] || "", folders.slice(1));
+  const reasons = [];
+  let confused = false;
+  const apps = [];
+  const usedIds = /* @__PURE__ */ new Set();
+  const usedPortSet = /* @__PURE__ */ new Set();
+  const primary = dirs[0];
+  for (const folder of dirs) {
+    const detected = detectHostAppsFromFiles(folder, opts);
+    confused = confused || detected.confused;
+    const base = import_node_path8.default.basename(folder);
+    for (const reason of detected.reasons) {
+      reasons.push(dirs.length > 1 ? `${base}: ${reason}` : reason);
+    }
+    for (const app of detected.apps) {
+      if (app.role === "ai-server") {
+        if (!apps.some((row) => row.role === "ai-server")) apps.push(app);
+        continue;
+      }
+      let id = app.id;
+      if (usedIds.has(id)) id = `${app.id}-${folderSlug(folder)}`;
+      usedIds.add(id);
+      if (usedPortSet.has(app.port)) {
+        reasons.push(
+          `${base}: port ${app.port} is also used by another attached folder`
+        );
+        confused = true;
+      }
+      usedPortSet.add(app.port);
+      apps.push({
+        ...app,
+        id,
+        folderPath: import_node_path8.default.resolve(folder),
+        name: dirs.length > 1 && primary && folder !== primary && !app.name.includes(base) ? `${app.name} (${base})` : app.name
+      });
+    }
+  }
+  return {
+    apps: ensureAiServerApp(apps, opts.preferredAiPort),
+    reasons,
+    confused
+  };
+}
 function readHostAppsCache(folder, extra) {
   try {
     const raw = JSON.parse(
@@ -3187,12 +3417,37 @@ function mergeDesiredHostApps(desired, detected) {
       ...local,
       ...app,
       startCommand: app.startCommand || local?.startCommand || null,
+      folderPath: app.folderPath || local?.folderPath || null,
       locked: app.locked || app.id === AI_SERVER_APP_ID || app.role === "ai-server",
       host: app.role === "ai-server" || app.id === AI_SERVER_APP_ID ? false : app.host === true || app.host !== false && local?.host === true
     };
   });
   return ensureAiServerApp(merged);
 }
+function unionHostApps(desired, detected) {
+  const merged = mergeDesiredHostApps(desired, detected);
+  const seenIds = new Set(merged.map((app) => app.id));
+  const seenPorts = new Set(merged.map((app) => app.port));
+  for (const app of detected) {
+    if (app.role === "ai-server") continue;
+    if (seenIds.has(app.id) || seenPorts.has(app.port)) continue;
+    seenIds.add(app.id);
+    seenPorts.add(app.port);
+    merged.push(app);
+  }
+  return ensureAiServerApp(merged);
+}
+function startCommandFromScript(script) {
+  if (!script || !script.trim()) return null;
+  const value = script.trim();
+  if (/\s/.test(value) || /[\\/]/.test(value) || value.includes(":")) {
+    if (/^(npm|pnpm|yarn|npx)\s/i.test(value)) return value;
+    if (/^(sbt|mvn|gradle|gradlew|mvnw|\.\\|\.\/)/i.test(value) || /\s/.test(value)) {
+      return value;
+    }
+  }
+  return `npm run ${value}`;
+}
 function appsFromInspectPorts(ports, scripts, name) {
   const apps = [];
   if (ports.ui || scripts.ui) {
@@ -3201,7 +3456,7 @@ function appsFromInspectPorts(ports, scripts, name) {
       name,
       role: "ui",
       port: parsePort(ports.ui, 5173),
-      startCommand: scripts.ui ? `npm run ${scripts.ui}` : null,
+      startCommand: startCommandFromScript(scripts.ui),
       source: "ai"
     });
   }
@@ -3210,8 +3465,8 @@ function appsFromInspectPorts(ports, scripts, name) {
       id: "backend",
       name: "Backend",
       role: "backend",
-      port: parsePort(ports.backend, 4100),
-      startCommand: scripts.backend ? `npm run ${scripts.backend}` : null,
+      port: parsePort(ports.backend, 8080),
+      startCommand: startCommandFromScript(scripts.backend),
       source: "ai"
     });
   }
@@ -3221,7 +3476,7 @@ function appsFromInspectPorts(ports, scripts, name) {
       name,
       role: "app",
       port: parsePort(ports.app, 3e3),
-      startCommand: scripts.app ? `npm run ${scripts.app}` : null,
+      startCommand: startCommandFromScript(scripts.app),
       source: "ai"
     });
   }
@@ -3299,11 +3554,12 @@ function projectSummaryFromDetect(folder, apps, opts = {}) {
   return `${name}: ${hostApps.map((app) => `${app.name} on ${app.port}${app.startCommand ? ` (${app.startCommand})` : ""}`).join(", ")}.`;
 }
 async function proposeHostAppsFromConfig(input) {
-  const folder = import_node_path8.default.resolve(input.workspaceDir);
+  const dirs = uniqueWorkspaceDirs(input.workspaceDir, input.workspaceDirs);
+  const folder = dirs[0] || import_node_path8.default.resolve(input.workspaceDir);
   const preferredAi = parsePort(input.preferredAiPort, AI_SERVER_DEFAULT_PORT);
-  const fingerprint = hostAppsFingerprint(folder);
+  const fingerprint = hostAppsFingerprintForFolders(dirs);
   const allowAi = input.allowAi !== false;
-  const detected = detectHostAppsFromFiles(folder, {
+  const detected = detectHostAppsFromFolders(dirs, {
     preferredAiPort: preferredAi,
     appName: input.appName
   });
@@ -3322,8 +3578,9 @@ async function proposeHostAppsFromConfig(input) {
         appName: input.appName,
         extraContext: [
           "File-based detection was uncertain or incomplete.",
+          dirs.length > 1 ? `This sandbox also has folders: ${dirs.slice(1).join(", ")}` : "",
           ...reasons
-        ].join("\n")
+        ].filter(Boolean).join("\n")
       });
       usedAi = true;
       const fromAi = appsFromInspectPorts(
@@ -3332,9 +3589,12 @@ async function proposeHostAppsFromConfig(input) {
         inspected.name || input.appName || "App"
       );
       if (fromAi.length) {
-        apps = ensureAiServerApp(
-          [defaultAiServerApp(preferredAi), ...fromAi],
-          preferredAi
+        apps = unionHostApps(
+          ensureAiServerApp(
+            [defaultAiServerApp(preferredAi), ...fromAi],
+            preferredAi
+          ),
+          detected.apps
         );
       }
       if (inspected.summary) projectSummary = inspected.summary;
@@ -3347,9 +3607,9 @@ async function proposeHostAppsFromConfig(input) {
       );
     }
   }
-  const alternatives = collectScriptAlternatives(folder, apps, {
-    appName: input.appName
-  });
+  const alternatives = dirs.flatMap(
+    (dir) => collectScriptAlternatives(dir, apps, { appName: input.appName })
+  );
   const confidence = proposalConfidence(apps, reasons, usedAi);
   const needsReview = confidence !== "high" || detected.confused || apps.filter((app) => app.role !== "ai-server").length === 0;
   return {
@@ -3364,11 +3624,12 @@ async function proposeHostAppsFromConfig(input) {
   };
 }
 async function resolveHostApps(input) {
-  const folder = import_node_path8.default.resolve(input.workspaceDir);
+  const dirs = uniqueWorkspaceDirs(input.workspaceDir, input.workspaceDirs);
+  const folder = dirs[0] || import_node_path8.default.resolve(input.workspaceDir);
   const loc = { sandboxId: input.sandboxId, dataDir: input.dataDir };
-  const fingerprint = hostAppsFingerprint(folder);
+  const fingerprint = hostAppsFingerprintForFolders(dirs);
   const preferredAi = parsePort(input.preferredAiPort, AI_SERVER_DEFAULT_PORT);
-  const detected = detectHostAppsFromFiles(folder, {
+  const detected = detectHostAppsFromFolders(dirs, {
     preferredAiPort: preferredAi,
     appName: input.appName
   });
@@ -3504,6 +3765,7 @@ Return the real local ports and npm script names.`
   createToolValidator,
   defaultAiServerApp,
   detectHostAppsFromFiles,
+  detectHostAppsFromFolders,
   ensureAiServerApp,
   ensureProjectDataDir,
   ensureSingleHost,
@@ -3513,6 +3775,7 @@ Return the real local ports and npm script names.`
   getProviderPreference,
   hostAppsCachePath,
   hostAppsFingerprint,
+  hostAppsFingerprintForFolders,
   inspectAndRepairWorkspace,
   inspectConfigOnly,
   isDevMode,
@@ -3547,6 +3810,7 @@ Return the real local ports and npm script names.`
   sanitizeProjectId,
   saveChatAttachments,
   toNextRoute,
+  unionHostApps,
   upsertManagedIgnoreFile,
   writeCollaboraterApps,
   writeHostAppsCache

package/dist/index.d.cts

@@ -538,9 +538,13 @@ type HostApp = {
     locked?: boolean;
     /** Share URL — the page the browser opens. */
     host?: boolean;
+    /** Project folder this process should start in (multi-folder sandboxes). */
+    folderPath?: string | null;
 };
 type HostAppsResolveInput = {
     workspaceDir: string;
+    /** Extra attached folders for the same sandbox (UI + JVM backend, etc.). */
+    workspaceDirs?: string[];
     appName?: string;
     preferredAiPort?: number;
     /** Desired list from Maintainer Pro — used as source of truth when present. */
@@ -582,6 +586,8 @@ type SetupProposal = {
 };
 type ProposeHostAppsInput = {
     workspaceDir: string;
+    /** Extra attached folders for the same sandbox. */
+    workspaceDirs?: string[];
     appName?: string;
     preferredAiPort?: number;
     /**
@@ -608,6 +614,7 @@ declare function readProjectEnvLayers(folder: string): {
     }>;
 };
 declare function hostAppsFingerprint(folder: string): string;
+declare function hostAppsFingerprintForFolders(folders: string[]): string;
 declare function detectHostAppsFromFiles(folder: string, opts?: {
     preferredAiPort?: number;
     appName?: string;
@@ -616,6 +623,14 @@ declare function detectHostAppsFromFiles(folder: string, opts?: {
     reasons: string[];
     confused: boolean;
 };
+declare function detectHostAppsFromFolders(folders: string[], opts?: {
+    preferredAiPort?: number;
+    appName?: string;
+}): {
+    apps: HostApp[];
+    reasons: string[];
+    confused: boolean;
+};
 declare function readHostAppsCache(folder: string, extra?: {
     sandboxId?: string | null;
     dataDir?: string | null;
@@ -633,6 +648,8 @@ declare function writeHostAppsCache(folder: string, apps: HostApp[], extra?: Rec
 /** @deprecated Use writeHostAppsCache. */
 declare const writeCollaboraterApps: typeof writeHostAppsCache;
 declare function mergeDesiredHostApps(desired: HostApp[], detected: HostApp[]): HostApp[];
+/** Keep saved apps, and append newly detected ones that are not already listed. */
+declare function unionHostApps(desired: HostApp[], detected: HostApp[]): HostApp[];
 /**
  * Fast, interactive onboarding propose: file detect first, optional read-only AI.
  * Never edits the repository.
@@ -645,4 +662,4 @@ declare function proposeHostAppsFromConfig(input: ProposeHostAppsInput): Promise
  */
 declare function resolveHostApps(input: HostAppsResolveInput): Promise<HostAppsResolveResult>;
 
-export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, AI_SERVER_APP_ID, AI_SERVER_DEFAULT_PORT, type AiCliProviderId, type AiProvider, type AiResponse, COLLABORATER_DIR, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, HOST_APPS_FILE, type HostApp, type HostAppAlternative, type HostAppRole, type HostAppSource, type HostAppsResolveInput, type HostAppsResolveResult, type LocalStoredMessage, MAINTAINER_PRO_HOME_DIR, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProjectDataInput, type ProposeHostAppsInput, type ProviderPreference, type SetupProposal, type SetupProposalConfidence, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, defaultAiServerApp, detectHostAppsFromFiles, ensureAiServerApp, ensureProjectDataDir, ensureSingleHost, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, hostAppsCachePath, hostAppsFingerprint, inspectAndRepairWorkspace, inspectConfigOnly, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, maintainerProHome, mergeDesiredHostApps, normalizeHostApp, normalizeHostApps, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, parsePort, previewText, hostAppsCachePath$1 as projectHostAppsPath, projectIdForFolder, projectUploadsDir, proposeHostAppsFromConfig, providerLabel, readCollaboraterApps, readHostAppsCache, readProjectEnvLayers, renderManagedIgnoreBlock, resolveCliBinary, resolveHostApps, resolveIgnorePaths, resolveLogLevel, resolveProjectDataDir, resolveProvider, sanitizeProjectId, saveChatAttachments, toNextRoute, upsertManagedIgnoreFile, writeCollaboraterApps, writeHostAppsCache };
+export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, AI_SERVER_APP_ID, AI_SERVER_DEFAULT_PORT, type AiCliProviderId, type AiProvider, type AiResponse, COLLABORATER_DIR, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, HOST_APPS_FILE, type HostApp, type HostAppAlternative, type HostAppRole, type HostAppSource, type HostAppsResolveInput, type HostAppsResolveResult, type LocalStoredMessage, MAINTAINER_PRO_HOME_DIR, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProjectDataInput, type ProposeHostAppsInput, type ProviderPreference, type SetupProposal, type SetupProposalConfidence, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, defaultAiServerApp, detectHostAppsFromFiles, detectHostAppsFromFolders, ensureAiServerApp, ensureProjectDataDir, ensureSingleHost, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, hostAppsCachePath, hostAppsFingerprint, hostAppsFingerprintForFolders, inspectAndRepairWorkspace, inspectConfigOnly, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, maintainerProHome, mergeDesiredHostApps, normalizeHostApp, normalizeHostApps, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, parsePort, previewText, hostAppsCachePath$1 as projectHostAppsPath, projectIdForFolder, projectUploadsDir, proposeHostAppsFromConfig, providerLabel, readCollaboraterApps, readHostAppsCache, readProjectEnvLayers, renderManagedIgnoreBlock, resolveCliBinary, resolveHostApps, resolveIgnorePaths, resolveLogLevel, resolveProjectDataDir, resolveProvider, sanitizeProjectId, saveChatAttachments, toNextRoute, unionHostApps, upsertManagedIgnoreFile, writeCollaboraterApps, writeHostAppsCache };

package/dist/index.d.ts

@@ -538,9 +538,13 @@ type HostApp = {
     locked?: boolean;
     /** Share URL — the page the browser opens. */
     host?: boolean;
+    /** Project folder this process should start in (multi-folder sandboxes). */
+    folderPath?: string | null;
 };
 type HostAppsResolveInput = {
     workspaceDir: string;
+    /** Extra attached folders for the same sandbox (UI + JVM backend, etc.). */
+    workspaceDirs?: string[];
     appName?: string;
     preferredAiPort?: number;
     /** Desired list from Maintainer Pro — used as source of truth when present. */
@@ -582,6 +586,8 @@ type SetupProposal = {
 };
 type ProposeHostAppsInput = {
     workspaceDir: string;
+    /** Extra attached folders for the same sandbox. */
+    workspaceDirs?: string[];
     appName?: string;
     preferredAiPort?: number;
     /**
@@ -608,6 +614,7 @@ declare function readProjectEnvLayers(folder: string): {
     }>;
 };
 declare function hostAppsFingerprint(folder: string): string;
+declare function hostAppsFingerprintForFolders(folders: string[]): string;
 declare function detectHostAppsFromFiles(folder: string, opts?: {
     preferredAiPort?: number;
     appName?: string;
@@ -616,6 +623,14 @@ declare function detectHostAppsFromFiles(folder: string, opts?: {
     reasons: string[];
     confused: boolean;
 };
+declare function detectHostAppsFromFolders(folders: string[], opts?: {
+    preferredAiPort?: number;
+    appName?: string;
+}): {
+    apps: HostApp[];
+    reasons: string[];
+    confused: boolean;
+};
 declare function readHostAppsCache(folder: string, extra?: {
     sandboxId?: string | null;
     dataDir?: string | null;
@@ -633,6 +648,8 @@ declare function writeHostAppsCache(folder: string, apps: HostApp[], extra?: Rec
 /** @deprecated Use writeHostAppsCache. */
 declare const writeCollaboraterApps: typeof writeHostAppsCache;
 declare function mergeDesiredHostApps(desired: HostApp[], detected: HostApp[]): HostApp[];
+/** Keep saved apps, and append newly detected ones that are not already listed. */
+declare function unionHostApps(desired: HostApp[], detected: HostApp[]): HostApp[];
 /**
  * Fast, interactive onboarding propose: file detect first, optional read-only AI.
  * Never edits the repository.
@@ -645,4 +662,4 @@ declare function proposeHostAppsFromConfig(input: ProposeHostAppsInput): Promise
  */
 declare function resolveHostApps(input: HostAppsResolveInput): Promise<HostAppsResolveResult>;
 
-export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, AI_SERVER_APP_ID, AI_SERVER_DEFAULT_PORT, type AiCliProviderId, type AiProvider, type AiResponse, COLLABORATER_DIR, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, HOST_APPS_FILE, type HostApp, type HostAppAlternative, type HostAppRole, type HostAppSource, type HostAppsResolveInput, type HostAppsResolveResult, type LocalStoredMessage, MAINTAINER_PRO_HOME_DIR, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProjectDataInput, type ProposeHostAppsInput, type ProviderPreference, type SetupProposal, type SetupProposalConfidence, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, defaultAiServerApp, detectHostAppsFromFiles, ensureAiServerApp, ensureProjectDataDir, ensureSingleHost, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, hostAppsCachePath, hostAppsFingerprint, inspectAndRepairWorkspace, inspectConfigOnly, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, maintainerProHome, mergeDesiredHostApps, normalizeHostApp, normalizeHostApps, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, parsePort, previewText, hostAppsCachePath$1 as projectHostAppsPath, projectIdForFolder, projectUploadsDir, proposeHostAppsFromConfig, providerLabel, readCollaboraterApps, readHostAppsCache, readProjectEnvLayers, renderManagedIgnoreBlock, resolveCliBinary, resolveHostApps, resolveIgnorePaths, resolveLogLevel, resolveProjectDataDir, resolveProvider, sanitizeProjectId, saveChatAttachments, toNextRoute, upsertManagedIgnoreFile, writeCollaboraterApps, writeHostAppsCache };
+export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, AI_SERVER_APP_ID, AI_SERVER_DEFAULT_PORT, type AiCliProviderId, type AiProvider, type AiResponse, COLLABORATER_DIR, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, HOST_APPS_FILE, type HostApp, type HostAppAlternative, type HostAppRole, type HostAppSource, type HostAppsResolveInput, type HostAppsResolveResult, type LocalStoredMessage, MAINTAINER_PRO_HOME_DIR, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProjectDataInput, type ProposeHostAppsInput, type ProviderPreference, type SetupProposal, type SetupProposalConfidence, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, defaultAiServerApp, detectHostAppsFromFiles, detectHostAppsFromFolders, ensureAiServerApp, ensureProjectDataDir, ensureSingleHost, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, hostAppsCachePath, hostAppsFingerprint, hostAppsFingerprintForFolders, inspectAndRepairWorkspace, inspectConfigOnly, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, maintainerProHome, mergeDesiredHostApps, normalizeHostApp, normalizeHostApps, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, parsePort, previewText, hostAppsCachePath$1 as projectHostAppsPath, projectIdForFolder, projectUploadsDir, proposeHostAppsFromConfig, providerLabel, readCollaboraterApps, readHostAppsCache, readProjectEnvLayers, renderManagedIgnoreBlock, resolveCliBinary, resolveHostApps, resolveIgnorePaths, resolveLogLevel, resolveProjectDataDir, resolveProvider, sanitizeProjectId, saveChatAttachments, toNextRoute, unionHostApps, upsertManagedIgnoreFile, writeCollaboraterApps, writeHostAppsCache };

package/dist/index.js

@@ -2488,9 +2488,9 @@ var inspectJsonSchema = z.object({
   name: z.string().max(200).optional(),
   summary: z.string().max(800).optional(),
   scripts: z.object({
-    ui: z.string().min(1).max(64).optional(),
-    backend: z.string().min(1).max(64).optional(),
-    app: z.string().min(1).max(64).optional()
+    ui: z.string().min(1).max(200).optional(),
+    backend: z.string().min(1).max(200).optional(),
+    app: z.string().min(1).max(200).optional()
   }).optional(),
   ports: z.object({
     ui: z.number().int().min(1).max(65535).optional(),
@@ -2518,12 +2518,12 @@ function setupSystemPrompt(input) {
 Workspace: ${input.workspaceDir}
 App name: ${input.appName || "the app"}
 
-Inspect this repository (package.json, README, lockfiles, existing env files, how the UI and API start).
+Inspect this repository (package.json, README, lockfiles, Maven/Gradle/sbt files, Spring/Play config, existing env files, how the UI and API start).
 You MAY edit files to fix setup problems that would block local run or the chat widget (env keys, widget mount, missing config).
 Do NOT start long-lived dev servers, tunnels, or install global tools.
 Do NOT run \`npm run dev\` or similar.
 
-Script names you report MUST already exist in package.json. Omit chat/ai-server scripts.
+Script names you report MUST already exist in package.json, OR be a real JVM start command (./gradlew bootRun, mvn spring-boot:run, sbt run). Omit chat/ai-server scripts.
 
 End with a short human summary AND one \`\`\`json fence with:
 
@@ -2595,7 +2595,21 @@ ${lock}`);
     "vite.config.mjs",
     "next.config.js",
     "next.config.mjs",
-    "next.config.ts"
+    "next.config.ts",
+    "pom.xml",
+    "build.gradle",
+    "build.gradle.kts",
+    "build.sbt",
+    "application.yml",
+    "application.yaml",
+    "application.properties",
+    "application.conf",
+    "src/main/resources/application.yml",
+    "src/main/resources/application.yaml",
+    "src/main/resources/application.properties",
+    "src/main/resources/application.conf",
+    "src/main/resources/application-dev.yml",
+    "conf/application.conf"
   ]) {
     const body = readSnippet(path7.join(folder, rel), 2500);
     if (body) parts.push(`### ${rel}
@@ -2623,7 +2637,7 @@ DO NOT edit, create, or delete any files.
 DO NOT run shell commands, install packages, or start servers.
 Only infer how this project runs locally from the excerpts.
 
-Script names you report MUST appear in package.json scripts. Omit chat/ai-server scripts.
+Script names you report MUST appear in package.json scripts, OR be a JVM start command such as \`./gradlew bootRun\`, \`mvn spring-boot:run\`, or \`sbt run\`. Omit chat/ai-server scripts.
 
 Reply with a short human summary AND one \`\`\`json fence with:
 
@@ -2631,8 +2645,8 @@ Reply with a short human summary AND one \`\`\`json fence with:
   "kind": "next" | "vite" | "html" | "empty" | "other",
   "name": "package or folder name",
   "summary": "one sentence about this project",
-  "scripts": { "ui": "dev:client", "backend": "dev:server" },
-  "ports": { "ui": 5173, "backend": 4100 },
+  "scripts": { "ui": "dev:client", "backend": "sbt run" },
+  "ports": { "ui": 5173, "backend": 9000 },
   "issues": ["uncertainties"],
   "fixes": [],
   "ready": true
@@ -2795,7 +2809,8 @@ function normalizeHostApp(raw) {
       row.source
     ) ? row.source : "manual",
     locked: row.locked === true || id === AI_SERVER_APP_ID || role === "ai-server",
-    host: role !== "ai-server" && id !== AI_SERVER_APP_ID && row.host === true
+    host: role !== "ai-server" && id !== AI_SERVER_APP_ID && row.host === true,
+    folderPath: typeof row.folderPath === "string" && row.folderPath.trim() ? row.folderPath.trim().slice(0, 500) : null
   };
 }
 function ensureSingleHost(apps) {
@@ -2908,19 +2923,151 @@ function configPort(folder, files) {
   }
   return 0;
 }
-function hostAppsFingerprint(folder) {
+var JVM_CONFIG_FILES = [
+  "pom.xml",
+  "build.gradle",
+  "build.gradle.kts",
+  "settings.gradle",
+  "settings.gradle.kts",
+  "build.sbt",
+  "gradle.properties",
+  "application.yml",
+  "application.yaml",
+  "application.properties",
+  "application.conf",
+  "src/main/resources/application.yml",
+  "src/main/resources/application.yaml",
+  "src/main/resources/application.properties",
+  "src/main/resources/application.conf",
+  "src/main/resources/application-dev.yml",
+  "src/main/resources/application-dev.yaml",
+  "src/main/resources/application-dev.properties",
+  "src/main/resources/application-local.yml",
+  "conf/application.conf",
+  "conf/application.yml"
+];
+var FINGERPRINT_FILES = [
+  "package.json",
+  ...ENV_FILES,
+  "vite.config.ts",
+  "vite.config.js",
+  "vite.config.mjs",
+  "next.config.js",
+  "next.config.mjs",
+  "next.config.ts",
+  ...JVM_CONFIG_FILES
+];
+function fileExists(folder, rel) {
+  return fs7.existsSync(path8.join(folder, rel));
+}
+function jvmPortFromText(text) {
+  const patterns = [
+    /(?:^|\n)\s*server\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*SERVER_PORT\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*play\.http\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*play\.server\.http\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /(?:^|\n)\s*http\.port\s*[:=]\s*["']?(\d{2,5})/im,
+    /-Dserver\.port=(\d{2,5})/i,
+    /systemProperty\s*\(?\s*["']server\.port["']\s*,\s*["']?(\d{2,5})/i,
+    /["']play\.http\.port["']\s*->\s*["']?(\d{2,5})/i
+  ];
+  for (const pattern of patterns) {
+    const match = text.match(pattern);
+    const port = parsePort(match?.[1]);
+    if (port) return port;
+  }
+  const yaml = text.match(
+    /(?:^|\n)server:\s*\n(?:[ \t].*\n)*?[ \t]+port:\s*["']?(\d{2,5})/i
+  );
+  return parsePort(yaml?.[1]);
+}
+function looksLike(haystack, ...needles) {
+  const lower = haystack.toLowerCase();
+  return needles.some((needle) => lower.includes(needle.toLowerCase()));
+}
+function wrapperCommand(folder, unixName, winName, fallback) {
+  if (process.platform === "win32") {
+    return fileExists(folder, winName) ? `.\\${winName}` : fallback;
+  }
+  return fileExists(folder, unixName) ? `./${unixName}` : fallback;
+}
+function detectJvmHostApp(folder, opts = {}) {
+  const resolved = path8.resolve(folder);
+  const texts = [];
+  let foundMarker = false;
+  for (const rel of JVM_CONFIG_FILES) {
+    const text = readText(path8.join(resolved, rel));
+    if (!text) continue;
+    foundMarker = true;
+    texts.push(text);
+  }
+  const hasGradle = fileExists(resolved, "build.gradle") || fileExists(resolved, "build.gradle.kts") || fileExists(resolved, "settings.gradle") || fileExists(resolved, "settings.gradle.kts") || fileExists(resolved, "gradlew") || fileExists(resolved, "gradlew.bat");
+  const hasMaven = fileExists(resolved, "pom.xml");
+  const hasSbt = fileExists(resolved, "build.sbt");
+  if (!foundMarker && !hasGradle && !hasMaven && !hasSbt) return null;
+  const blob = texts.join("\n");
+  const { merged } = readProjectEnvLayers(resolved);
+  const envPort = parsePort(merged.SERVER_PORT) || parsePort(merged.PLAY_HTTP_PORT) || parsePort(merged.HTTP_PORT) || parsePort(merged.PORT);
+  let port = envPort || jvmPortFromText(blob);
+  const isPlay = looksLike(
+    blob,
+    "play.http.port",
+    "enablePlugins(Play",
+    "com.typesafe.play",
+    "play-scala",
+    "play-java"
+  );
+  const isSpring = looksLike(
+    blob,
+    "spring-boot",
+    "springframework.boot",
+    "org.springframework"
+  );
+  const isQuarkus = looksLike(blob, "quarkus", "io.quarkus");
+  if (!port) {
+    port = isPlay ? 9e3 : 8080;
+  }
+  let startCommand = null;
+  if (hasGradle) {
+    const gradle = wrapperCommand(resolved, "gradlew", "gradlew.bat", "gradle");
+    startCommand = isQuarkus ? `${gradle} quarkusDev` : isPlay ? `${gradle} run` : `${gradle} bootRun`;
+  } else if (hasMaven) {
+    const mvn = wrapperCommand(resolved, "mvnw", "mvnw.cmd", "mvn");
+    startCommand = isQuarkus ? `${mvn} quarkus:dev` : `${mvn} spring-boot:run`;
+  } else if (hasSbt) {
+    startCommand = "sbt run";
+  }
+  const framework = isPlay ? "Play" : isSpring ? "Spring" : isQuarkus ? "Quarkus" : hasSbt ? "Scala" : "JVM";
+  return {
+    id: "backend",
+    name: opts.appName ? `${opts.appName} API` : `${framework} backend`,
+    role: "backend",
+    port,
+    startCommand,
+    source: envPort ? "env" : "package",
+    folderPath: resolved
+  };
+}
+function uniqueWorkspaceDirs(primary, extra) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of [primary, ...extra || []]) {
+    if (!raw || typeof raw !== "string") continue;
+    const resolved = path8.resolve(raw.trim());
+    const key = process.platform === "win32" ? resolved.toLowerCase() : resolved;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(resolved);
+  }
+  return out;
+}
+function folderSlug(folder) {
+  return path8.basename(path8.resolve(folder)).replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 24) || "app";
+}
+function fingerprintOneFolder(folder) {
   const resolved = path8.resolve(folder);
   const parts = [];
-  for (const rel of [
-    "package.json",
-    ...ENV_FILES,
-    "vite.config.ts",
-    "vite.config.js",
-    "vite.config.mjs",
-    "next.config.js",
-    "next.config.mjs",
-    "next.config.ts"
-  ]) {
+  for (const rel of FINGERPRINT_FILES) {
     const file = path8.join(resolved, rel);
     if (!fs7.existsSync(file)) continue;
     try {
@@ -2929,7 +3076,16 @@ function hostAppsFingerprint(folder) {
     } catch {
     }
   }
-  return createHash2("sha256").update(parts.join("|") || resolved).digest("hex").slice(0, 32);
+  return parts.join("|") || resolved;
+}
+function hostAppsFingerprint(folder) {
+  const resolved = path8.resolve(folder);
+  return createHash2("sha256").update(fingerprintOneFolder(resolved)).digest("hex").slice(0, 32);
+}
+function hostAppsFingerprintForFolders(folders) {
+  const dirs = uniqueWorkspaceDirs(folders[0] || "", folders.slice(1));
+  const parts = dirs.map((dir) => `${dir}:${fingerprintOneFolder(dir)}`);
+  return createHash2("sha256").update(parts.join("||") || "empty").digest("hex").slice(0, 32);
 }
 function pickScript(scripts, names) {
   return names.find((name) => scripts[name] && !isChatScript(name, scripts[name])) || null;
@@ -2948,9 +3104,14 @@ function detectHostAppsFromFiles(folder, opts = {}) {
     source: envAi ? "env" : "default"
   });
   const envPorts = {
-    PORT: layers.filter((layer) => layer.file !== ".env.example").map((layer) => ({ file: layer.file, port: parsePort(layer.values.PORT) })).filter((row) => row.port),
+    PORT: layers.filter((layer) => layer.file !== ".env.example").map((layer) => ({
+      file: layer.file,
+      port: parsePort(layer.values.PORT) || parsePort(layer.values.SERVER_PORT) || parsePort(layer.values.PLAY_HTTP_PORT)
+    })).filter((row) => row.port),
     APP_URL: parsePort(merged.APP_URL || merged.NEXT_PUBLIC_APP_URL || merged.PUBLIC_URL),
-    API_PORT: parsePort(merged.API_PORT || merged.API_URL || merged.VITE_API_URL)
+    API_PORT: parsePort(
+      merged.API_PORT || merged.API_URL || merged.VITE_API_URL || merged.SERVER_PORT || merged.PLAY_HTTP_PORT || merged.HTTP_PORT
+    )
   };
   const portValues = [...new Set(envPorts.PORT.map((row) => row.port))];
   if (portValues.length > 1) {
@@ -2995,7 +3156,8 @@ function detectHostAppsFromFiles(folder, opts = {}) {
       port,
       startCommand: `npm run ${uiScript}`,
       source: uiFromEnv ? "env" : scriptPort ? "package" : "package",
-      host: true
+      host: true,
+      folderPath: resolved
     });
   } else if (uiFromEnv) {
     apps.push({
@@ -3005,7 +3167,8 @@ function detectHostAppsFromFiles(folder, opts = {}) {
       port: uiFromEnv,
       startCommand: scripts.dev ? "npm run dev" : null,
       source: "env",
-      host: true
+      host: true,
+      folderPath: resolved
     });
   }
   if (apiScript && apiScript !== uiScript) {
@@ -3017,19 +3180,83 @@ function detectHostAppsFromFiles(folder, opts = {}) {
       role: "backend",
       port,
       startCommand: `npm run ${apiScript}`,
-      source: envPorts.API_PORT ? "env" : "package"
+      source: envPorts.API_PORT ? "env" : "package",
+      folderPath: resolved
     });
   }
-  const hostApps = apps.filter((app) => app.role !== "ai-server");
+  const hasHostApp = apps.some((app) => app.role !== "ai-server");
+  const usedPorts = new Set(
+    apps.filter((app) => app.role !== "ai-server").map((app) => app.port)
+  );
+  const jvm = detectJvmHostApp(resolved, { appName: opts.appName });
+  if (jvm && !usedPorts.has(jvm.port)) {
+    apps.push({
+      ...jvm,
+      id: apps.some((app) => app.id === "backend") ? `backend-${folderSlug(resolved)}` : "backend",
+      host: !hasHostApp
+    });
+  } else if (jvm && usedPorts.has(jvm.port) && !hasHostApp) {
+    reasons.push(
+      `JVM config suggests port ${jvm.port}, which is already used by another detected app`
+    );
+  }
+  const tagged = apps.map(
+    (app) => app.role === "ai-server" || app.folderPath ? app : { ...app, folderPath: resolved }
+  );
+  const hostApps = tagged.filter((app) => app.role !== "ai-server");
   if (pkg && Object.keys(scripts).length && hostApps.length === 0) {
     reasons.push("Found package.json scripts but no host app port in env or config");
   }
   return {
-    apps: ensureAiServerApp(apps, aiPort),
+    apps: ensureAiServerApp(tagged, aiPort),
     reasons,
     confused: reasons.length > 0
   };
 }
+function detectHostAppsFromFolders(folders, opts = {}) {
+  const dirs = uniqueWorkspaceDirs(folders[0] || "", folders.slice(1));
+  const reasons = [];
+  let confused = false;
+  const apps = [];
+  const usedIds = /* @__PURE__ */ new Set();
+  const usedPortSet = /* @__PURE__ */ new Set();
+  const primary = dirs[0];
+  for (const folder of dirs) {
+    const detected = detectHostAppsFromFiles(folder, opts);
+    confused = confused || detected.confused;
+    const base = path8.basename(folder);
+    for (const reason of detected.reasons) {
+      reasons.push(dirs.length > 1 ? `${base}: ${reason}` : reason);
+    }
+    for (const app of detected.apps) {
+      if (app.role === "ai-server") {
+        if (!apps.some((row) => row.role === "ai-server")) apps.push(app);
+        continue;
+      }
+      let id = app.id;
+      if (usedIds.has(id)) id = `${app.id}-${folderSlug(folder)}`;
+      usedIds.add(id);
+      if (usedPortSet.has(app.port)) {
+        reasons.push(
+          `${base}: port ${app.port} is also used by another attached folder`
+        );
+        confused = true;
+      }
+      usedPortSet.add(app.port);
+      apps.push({
+        ...app,
+        id,
+        folderPath: path8.resolve(folder),
+        name: dirs.length > 1 && primary && folder !== primary && !app.name.includes(base) ? `${app.name} (${base})` : app.name
+      });
+    }
+  }
+  return {
+    apps: ensureAiServerApp(apps, opts.preferredAiPort),
+    reasons,
+    confused
+  };
+}
 function readHostAppsCache(folder, extra) {
   try {
     const raw = JSON.parse(
@@ -3074,12 +3301,37 @@ function mergeDesiredHostApps(desired, detected) {
       ...local,
       ...app,
       startCommand: app.startCommand || local?.startCommand || null,
+      folderPath: app.folderPath || local?.folderPath || null,
       locked: app.locked || app.id === AI_SERVER_APP_ID || app.role === "ai-server",
       host: app.role === "ai-server" || app.id === AI_SERVER_APP_ID ? false : app.host === true || app.host !== false && local?.host === true
     };
   });
   return ensureAiServerApp(merged);
 }
+function unionHostApps(desired, detected) {
+  const merged = mergeDesiredHostApps(desired, detected);
+  const seenIds = new Set(merged.map((app) => app.id));
+  const seenPorts = new Set(merged.map((app) => app.port));
+  for (const app of detected) {
+    if (app.role === "ai-server") continue;
+    if (seenIds.has(app.id) || seenPorts.has(app.port)) continue;
+    seenIds.add(app.id);
+    seenPorts.add(app.port);
+    merged.push(app);
+  }
+  return ensureAiServerApp(merged);
+}
+function startCommandFromScript(script) {
+  if (!script || !script.trim()) return null;
+  const value = script.trim();
+  if (/\s/.test(value) || /[\\/]/.test(value) || value.includes(":")) {
+    if (/^(npm|pnpm|yarn|npx)\s/i.test(value)) return value;
+    if (/^(sbt|mvn|gradle|gradlew|mvnw|\.\\|\.\/)/i.test(value) || /\s/.test(value)) {
+      return value;
+    }
+  }
+  return `npm run ${value}`;
+}
 function appsFromInspectPorts(ports, scripts, name) {
   const apps = [];
   if (ports.ui || scripts.ui) {
@@ -3088,7 +3340,7 @@ function appsFromInspectPorts(ports, scripts, name) {
       name,
       role: "ui",
       port: parsePort(ports.ui, 5173),
-      startCommand: scripts.ui ? `npm run ${scripts.ui}` : null,
+      startCommand: startCommandFromScript(scripts.ui),
       source: "ai"
     });
   }
@@ -3097,8 +3349,8 @@ function appsFromInspectPorts(ports, scripts, name) {
       id: "backend",
       name: "Backend",
       role: "backend",
-      port: parsePort(ports.backend, 4100),
-      startCommand: scripts.backend ? `npm run ${scripts.backend}` : null,
+      port: parsePort(ports.backend, 8080),
+      startCommand: startCommandFromScript(scripts.backend),
       source: "ai"
     });
   }
@@ -3108,7 +3360,7 @@ function appsFromInspectPorts(ports, scripts, name) {
       name,
       role: "app",
       port: parsePort(ports.app, 3e3),
-      startCommand: scripts.app ? `npm run ${scripts.app}` : null,
+      startCommand: startCommandFromScript(scripts.app),
       source: "ai"
     });
   }
@@ -3186,11 +3438,12 @@ function projectSummaryFromDetect(folder, apps, opts = {}) {
   return `${name}: ${hostApps.map((app) => `${app.name} on ${app.port}${app.startCommand ? ` (${app.startCommand})` : ""}`).join(", ")}.`;
 }
 async function proposeHostAppsFromConfig(input) {
-  const folder = path8.resolve(input.workspaceDir);
+  const dirs = uniqueWorkspaceDirs(input.workspaceDir, input.workspaceDirs);
+  const folder = dirs[0] || path8.resolve(input.workspaceDir);
   const preferredAi = parsePort(input.preferredAiPort, AI_SERVER_DEFAULT_PORT);
-  const fingerprint = hostAppsFingerprint(folder);
+  const fingerprint = hostAppsFingerprintForFolders(dirs);
   const allowAi = input.allowAi !== false;
-  const detected = detectHostAppsFromFiles(folder, {
+  const detected = detectHostAppsFromFolders(dirs, {
     preferredAiPort: preferredAi,
     appName: input.appName
   });
@@ -3209,8 +3462,9 @@ async function proposeHostAppsFromConfig(input) {
         appName: input.appName,
         extraContext: [
           "File-based detection was uncertain or incomplete.",
+          dirs.length > 1 ? `This sandbox also has folders: ${dirs.slice(1).join(", ")}` : "",
           ...reasons
-        ].join("\n")
+        ].filter(Boolean).join("\n")
       });
       usedAi = true;
       const fromAi = appsFromInspectPorts(
@@ -3219,9 +3473,12 @@ async function proposeHostAppsFromConfig(input) {
         inspected.name || input.appName || "App"
       );
       if (fromAi.length) {
-        apps = ensureAiServerApp(
-          [defaultAiServerApp(preferredAi), ...fromAi],
-          preferredAi
+        apps = unionHostApps(
+          ensureAiServerApp(
+            [defaultAiServerApp(preferredAi), ...fromAi],
+            preferredAi
+          ),
+          detected.apps
         );
       }
       if (inspected.summary) projectSummary = inspected.summary;
@@ -3234,9 +3491,9 @@ async function proposeHostAppsFromConfig(input) {
       );
     }
   }
-  const alternatives = collectScriptAlternatives(folder, apps, {
-    appName: input.appName
-  });
+  const alternatives = dirs.flatMap(
+    (dir) => collectScriptAlternatives(dir, apps, { appName: input.appName })
+  );
   const confidence = proposalConfidence(apps, reasons, usedAi);
   const needsReview = confidence !== "high" || detected.confused || apps.filter((app) => app.role !== "ai-server").length === 0;
   return {
@@ -3251,11 +3508,12 @@ async function proposeHostAppsFromConfig(input) {
   };
 }
 async function resolveHostApps(input) {
-  const folder = path8.resolve(input.workspaceDir);
+  const dirs = uniqueWorkspaceDirs(input.workspaceDir, input.workspaceDirs);
+  const folder = dirs[0] || path8.resolve(input.workspaceDir);
   const loc = { sandboxId: input.sandboxId, dataDir: input.dataDir };
-  const fingerprint = hostAppsFingerprint(folder);
+  const fingerprint = hostAppsFingerprintForFolders(dirs);
   const preferredAi = parsePort(input.preferredAiPort, AI_SERVER_DEFAULT_PORT);
-  const detected = detectHostAppsFromFiles(folder, {
+  const detected = detectHostAppsFromFolders(dirs, {
     preferredAiPort: preferredAi,
     appName: input.appName
   });
@@ -3390,6 +3648,7 @@ export {
   createToolValidator,
   defaultAiServerApp,
   detectHostAppsFromFiles,
+  detectHostAppsFromFolders,
   ensureAiServerApp,
   ensureProjectDataDir,
   ensureSingleHost,
@@ -3399,6 +3658,7 @@ export {
   getProviderPreference,
   hostAppsCachePath2 as hostAppsCachePath,
   hostAppsFingerprint,
+  hostAppsFingerprintForFolders,
   inspectAndRepairWorkspace,
   inspectConfigOnly,
   isDevMode,
@@ -3433,6 +3693,7 @@ export {
   sanitizeProjectId,
   saveChatAttachments,
   toNextRoute,
+  unionHostApps,
   upsertManagedIgnoreFile,
   writeCollaboraterApps,
   writeHostAppsCache

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maintainer-pro/ai-cli",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Maintainer Pro server SDK: Claude/Cursor CLI, chat HTTP handlers, and optional SQL persistence",
   "keywords": [
     "maintainer-pro",