@kody-ade/kody-engine-lite 0.1.133 → 0.1.134

package/dist/bin/cli.js

@@ -1183,8 +1183,8 @@ async function tryStartLitellm(url, projectDir, generatedConfig) {
       logger.info(`  Loaded API keys: ${Object.keys(dotenvVars).join(", ")}`);
     }
   }
-  const { spawn: spawn2 } = await import("child_process");
-  const child = spawn2(cmd, args2, {
+  const { spawn: spawn3 } = await import("child_process");
+  const child = spawn3(cmd, args2, {
     stdio: ["ignore", "pipe", "pipe"],
     detached: true,
     env: { ...process.env, ...dotenvVars }
@@ -2610,8 +2610,8 @@ async function startProxy(config, url) {
   fs13.writeFileSync(CONFIG_PATH, config);
   const portMatch = url.match(/:(\d+)/);
   const port = portMatch ? portMatch[1] : "4099";
-  const { spawn: spawn2 } = await import("child_process");
-  const child = spawn2("litellm", ["--config", CONFIG_PATH, "--port", port], {
+  const { spawn: spawn3 } = await import("child_process");
+  const child = spawn3("litellm", ["--config", CONFIG_PATH, "--port", port], {
     stdio: ["ignore", "pipe", "pipe"],
     detached: true,
     env: process.env
@@ -3741,7 +3741,15 @@ function getDevServerInfo(taskDir) {
 }
 function getBrowserToolGuidance(stageName, taskDir) {
   const devServer = getDevServerInfo(taskDir);
-  const devServerBlock = devServer ? `
+  const engineManagedServer = process.env.KODY_DEV_SERVER_READY !== void 0;
+  const serverReady = process.env.KODY_DEV_SERVER_READY === "true";
+  const serverUrl = process.env.KODY_DEV_SERVER_URL ?? devServer?.url;
+  const devServerBlock = engineManagedServer ? serverReady ? `
+### Dev Server
+The dev server is already running at ${serverUrl}. Do NOT start it yourself.
+You can use browser tools to navigate to ${serverUrl} directly.` : `
+### Dev Server
+The dev server failed to start (e.g. DB connection issues). Skip browser verification and proceed with code-only changes. Do NOT attempt to start the dev server yourself \u2014 it will hang.` : devServer ? `
 ### Dev Server Setup (REQUIRED before browsing)
 You MUST start the dev server before using any browser navigation tools:
 \`\`\`bash
@@ -3963,6 +3971,76 @@ var init_runner_selection = __esm({
   }
 });
 
+// src/dev-server.ts
+import { spawn as spawn2 } from "child_process";
+async function pollReady(url, timeoutSec) {
+  const deadline = Date.now() + timeoutSec * 1e3;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(url, { signal: AbortSignal.timeout(2e3) });
+      if (res.ok || res.status >= 200 && res.status < 400) return true;
+    } catch {
+    }
+    await new Promise((r) => setTimeout(r, 1e3));
+  }
+  return false;
+}
+async function startDevServer(opts) {
+  const timeout = opts.readyTimeout ?? 30;
+  const [cmd, ...args2] = opts.command.split(/\s+/);
+  let child;
+  try {
+    child = spawn2(cmd, args2, {
+      stdio: ["ignore", "pipe", "pipe"],
+      detached: true,
+      shell: true,
+      env: { ...process.env, ...opts.envVars }
+    });
+  } catch (err) {
+    logger.warn(`  Dev server failed to spawn: ${err instanceof Error ? err.message : String(err)}`);
+    return { ready: false, url: opts.url, pid: void 0, stop: () => {
+    } };
+  }
+  let stderr = "";
+  child.stderr?.on("data", (chunk) => {
+    stderr += chunk.toString();
+  });
+  let exited = false;
+  child.on("exit", () => {
+    exited = true;
+  });
+  child.unref();
+  const ready = await pollReady(opts.url, timeout);
+  if (!ready) {
+    if (exited) {
+      logger.warn(`  Dev server exited before becoming ready`);
+    } else {
+      logger.warn(`  Dev server did not respond within ${timeout}s at ${opts.url}`);
+    }
+    if (stderr) {
+      logger.warn(`  Dev server stderr (last 500 chars): ${stderr.slice(-500)}`);
+    }
+  }
+  const pid = child.pid;
+  const stop = () => {
+    try {
+      if (pid) process.kill(-pid, "SIGTERM");
+    } catch {
+    }
+    try {
+      child.kill("SIGTERM");
+    } catch {
+    }
+  };
+  return { ready, url: opts.url, pid, stop };
+}
+var init_dev_server = __esm({
+  "src/dev-server.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
 // src/stages/agent.ts
 import * as fs19 from "fs";
 import * as path17 from "path";
@@ -4020,6 +4098,29 @@ async function executeAgentStage(ctx, def) {
   if (mcpConfigJson) {
     logger.info(`  MCP servers enabled for ${def.name}`);
   }
+  let devServerHandle = null;
+  const ds = config.mcp?.devServer;
+  if (mcpConfigJson && ds && taskHasUI(ctx.taskDir)) {
+    logger.info(`  Starting dev server: ${ds.command}`);
+    const envVars = {};
+    for (const varName of ds.env ?? []) {
+      if (process.env[varName]) envVars[varName] = process.env[varName];
+    }
+    devServerHandle = await startDevServer({
+      command: ds.command,
+      url: ds.url,
+      readyTimeout: ds.readyTimeout ?? 30,
+      envVars
+    });
+    if (devServerHandle.ready) {
+      logger.info(`  Dev server ready at ${ds.url}`);
+      extraEnv.KODY_DEV_SERVER_URL = ds.url;
+      extraEnv.KODY_DEV_SERVER_READY = "true";
+    } else {
+      logger.warn(`  Dev server not ready \u2014 Claude will work without browser verification`);
+      extraEnv.KODY_DEV_SERVER_READY = "false";
+    }
+  }
   const runner = getRunnerForStage(ctx, def.name);
   const maxRetries = def.maxRetries ?? 0;
   let lastResult = await runner.run(def.name, prompt, model, def.timeout, ctx.taskDir, {
@@ -4047,6 +4148,10 @@ async function executeAgentStage(ctx, def) {
       mcpConfigJson
     });
   }
+  if (devServerHandle) {
+    devServerHandle.stop();
+    logger.info(`  Dev server stopped`);
+  }
   if (lastResult.outcome !== "completed") {
     return { outcome: lastResult.outcome, error: lastResult.error, retries };
   }
@@ -4137,6 +4242,7 @@ var init_agent = __esm({
     init_config();
     init_mcp_config();
     init_runner_selection();
+    init_dev_server();
     init_logger();
     SESSION_GROUP = {
       taskify: "explore",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine-lite",
-  "version": "0.1.133",
+  "version": "0.1.134",
   "description": "Autonomous SDLC pipeline: Kody orchestration + Claude Code + LiteLLM",
   "license": "MIT",
   "type": "module",