@kody-ade/kody-engine 0.4.66 → 0.4.67

package/dist/bin/kody.js

@@ -864,7 +864,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.66",
+  version: "0.4.67",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -2328,7 +2328,7 @@ function coerceBare(spec, value) {
 init_issue();
 
 // src/executor.ts
-import { execFileSync as execFileSync29, spawn as spawn5 } from "child_process";
+import { execFileSync as execFileSync29, spawn as spawn6 } from "child_process";
 import * as fs31 from "fs";
 import * as path29 from "path";
 init_events();
@@ -9038,6 +9038,164 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
   }
 }
 
+// src/scripts/startLocalServer.ts
+import { spawn as spawn3 } from "child_process";
+import { existsSync as existsSync26, readFileSync as readFileSync24 } from "fs";
+import { join as join27 } from "path";
+var READY_TIMEOUT_MS = 12e4;
+var READY_POLL_MS = 1e3;
+var INSTALL_TIMEOUT_MS = 3e5;
+var FETCH_TIMEOUT_MS = 2e3;
+var DEFAULT_PORT = 3e3;
+var startLocalServer = async (ctx) => {
+  if (urlAlreadyResolved(ctx)) {
+    process.stderr.write("[kody startLocalServer] preview URL already set \u2014 skipping\n");
+    return;
+  }
+  const pkg = readPackageJson(ctx.cwd);
+  if (!pkg) return;
+  const scriptName = pickScript(pkg.scripts);
+  if (!scriptName) {
+    process.stderr.write("[kody startLocalServer] no dev/start script in package.json \u2014 skipping\n");
+    return;
+  }
+  const pm = detectPackageManager2(ctx.cwd);
+  const port = pickPort();
+  await ensureDependenciesInstalled(pm, ctx.cwd);
+  const url = `http://localhost:${port}`;
+  process.stderr.write(`[kody startLocalServer] spawning '${pm} run ${scriptName}' on ${url}
+`);
+  const child = spawnServer(pm, scriptName, port, ctx.cwd);
+  registerProcessCleanup(child);
+  const ready = await waitForReady(url, READY_TIMEOUT_MS);
+  if (!ready) {
+    safeKill(child);
+    throw new Error(
+      `startLocalServer: dev server at ${url} did not become reachable within ${READY_TIMEOUT_MS}ms`
+    );
+  }
+  process.env.PREVIEW_URL = url;
+  ctx.data.qaServerPid = child.pid;
+  ctx.data.qaServerScript = scriptName;
+  process.stderr.write(`[kody startLocalServer] ready: ${url}
+`);
+};
+function urlAlreadyResolved(ctx) {
+  const fromFlag = typeof ctx.args.previewUrl === "string" ? ctx.args.previewUrl.trim() : "";
+  if (fromFlag.length > 0) return true;
+  const fromEnv = (process.env.PREVIEW_URL ?? "").trim();
+  return fromEnv.length > 0;
+}
+function readPackageJson(cwd) {
+  const path32 = join27(cwd, "package.json");
+  if (!existsSync26(path32)) {
+    process.stderr.write("[kody startLocalServer] no package.json \u2014 skipping\n");
+    return null;
+  }
+  try {
+    const raw = JSON.parse(readFileSync24(path32, "utf8"));
+    return { scripts: raw.scripts ?? {} };
+  } catch (err) {
+    process.stderr.write(
+      `[kody startLocalServer] could not parse package.json: ${err.message}
+`
+    );
+    return null;
+  }
+}
+function pickScript(scripts) {
+  if (typeof scripts.dev === "string" && scripts.dev.length > 0) return "dev";
+  if (typeof scripts.start === "string" && scripts.start.length > 0) return "start";
+  return null;
+}
+function detectPackageManager2(cwd) {
+  if (existsSync26(join27(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync26(join27(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
+}
+function pickPort() {
+  const fromEnv = Number((process.env.PREVIEW_PORT ?? "").trim());
+  if (Number.isInteger(fromEnv) && fromEnv > 0) return fromEnv;
+  return DEFAULT_PORT;
+}
+async function ensureDependenciesInstalled(pm, cwd) {
+  if (existsSync26(join27(cwd, "node_modules"))) return;
+  process.stderr.write(`[kody startLocalServer] installing dependencies via ${pm}
+`);
+  await runOnce(pm, installArgs(pm), cwd, INSTALL_TIMEOUT_MS);
+}
+function installArgs(pm) {
+  if (pm === "pnpm") return ["install", "--frozen-lockfile"];
+  if (pm === "yarn") return ["install", "--frozen-lockfile"];
+  return ["ci"];
+}
+function spawnServer(pm, scriptName, port, cwd) {
+  const child = spawn3(pm, ["run", scriptName], {
+    cwd,
+    env: { ...process.env, PORT: String(port), NODE_ENV: "development" },
+    stdio: ["ignore", "pipe", "pipe"],
+    detached: false
+  });
+  child.stdout?.on("data", (b) => process.stderr.write(`[qa-server] ${b.toString("utf8")}`));
+  child.stderr?.on("data", (b) => process.stderr.write(`[qa-server] ${b.toString("utf8")}`));
+  return child;
+}
+function registerProcessCleanup(child) {
+  const cleanup = () => safeKill(child);
+  process.on("exit", cleanup);
+  process.on("SIGINT", cleanup);
+  process.on("SIGTERM", cleanup);
+}
+function safeKill(child) {
+  try {
+    child.kill("SIGTERM");
+  } catch {
+  }
+}
+async function runOnce(cmd, args, cwd, timeoutMs) {
+  await new Promise((resolve4, reject) => {
+    const c = spawn3(cmd, args, { cwd, stdio: "inherit" });
+    const timer = setTimeout(() => {
+      try {
+        c.kill("SIGKILL");
+      } catch {
+      }
+      reject(new Error(`${cmd} ${args.join(" ")} timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+    c.on("exit", (code) => {
+      clearTimeout(timer);
+      if (code === 0) {
+        resolve4();
+        return;
+      }
+      reject(new Error(`${cmd} ${args.join(" ")} exited with code ${code}`));
+    });
+    c.on("error", (err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+  });
+}
+async function waitForReady(url, timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    if (await probe(url)) return true;
+    await sleep2(READY_POLL_MS);
+  }
+  return false;
+}
+async function probe(url) {
+  try {
+    const res = await fetch(url, { method: "GET", signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+    return res.status < 500;
+  } catch {
+    return false;
+  }
+}
+function sleep2(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
 // src/scripts/syncFlow.ts
 import { execFileSync as execFileSync26 } from "child_process";
 init_issue();
@@ -9168,7 +9326,7 @@ var verify = async (ctx) => {
 };
 
 // src/scripts/verifyReproFails.ts
-import { spawn as spawn3 } from "child_process";
+import { spawn as spawn4 } from "child_process";
 var TEST_TIMEOUT_MS = 10 * 60 * 1e3;
 var TAIL_CHARS2 = 8e3;
 var ANSI_RE2 = /\x1B\[[0-?]*[ -/]*[@-~]/g;
@@ -9237,7 +9395,7 @@ function stripAnsi2(s) {
 }
 function runCommand2(command, cwd) {
   return new Promise((resolve4) => {
-    const child = spawn3(command, {
+    const child = spawn4(command, {
       cwd,
       shell: true,
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" },
@@ -9300,17 +9458,17 @@ var waitForCi = async (ctx, _profile, _agentResult, args) => {
     return;
   }
   const fixCiAttempts = state?.core.attempts?.["fix-ci"] ?? 0;
-  await sleep2(initialWaitSeconds * 1e3);
+  await sleep3(initialWaitSeconds * 1e3);
   const deadline = Date.now() + timeoutMinutes * 6e4;
   let lastSummary = "";
   while (Date.now() < deadline) {
     const rows = fetchChecks(prNumber, ctx.cwd);
     if (rows === null) {
-      await sleep2(pollSeconds * 1e3);
+      await sleep3(pollSeconds * 1e3);
       continue;
     }
     if (rows.length === 0) {
-      await sleep2(pollSeconds * 1e3);
+      await sleep3(pollSeconds * 1e3);
       continue;
     }
     const summary = summarize(rows);
@@ -9353,7 +9511,7 @@ var waitForCi = async (ctx, _profile, _agentResult, args) => {
       tryPostPr7(prNumber, `\u2705 kody waitForCi: all ${rows.length} checks green on PR #${prNumber}`, ctx.cwd);
       return;
     }
-    await sleep2(pollSeconds * 1e3);
+    await sleep3(pollSeconds * 1e3);
   }
   ctx.data.action = mkAction("CI_TIMEOUT", {
     reason: `CI did not complete within ${timeoutMinutes} minutes`,
@@ -9405,12 +9563,12 @@ function tryPostPr7(prNumber, body, cwd) {
   } catch {
   }
 }
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((res) => setTimeout(res, ms));
 }
 
 // src/scripts/warmupMcp.ts
-import { spawn as spawn4 } from "child_process";
+import { spawn as spawn5 } from "child_process";
 var PER_SERVER_TIMEOUT_MS = 6e4;
 var PER_REQUEST_TIMEOUT_MS = 2e4;
 var warmupMcp = async (_ctx, profile) => {
@@ -9432,7 +9590,7 @@ var warmupMcp = async (_ctx, profile) => {
   }
 };
 async function warmupOne(command, args, env) {
-  const child = spawn4(command, args, {
+  const child = spawn5(command, args, {
     stdio: ["pipe", "pipe", "pipe"],
     env: env ? { ...process.env, ...env } : process.env
   });
@@ -9672,6 +9830,7 @@ var preflightScripts = {
   buildSyntheticPlugin,
   resolveArtifacts,
   discoverQaContext,
+  startLocalServer,
   resolvePreviewUrl,
   resolveQaUrl,
   composePrompt,
@@ -10194,7 +10353,7 @@ async function runShellEntry(entry, ctx, profile) {
     env[`KODY_CFG_${k}`] = v;
   }
   const timeoutMs = resolveShellTimeoutMs(entry);
-  const child = spawn5("bash", [shellPath, ...positional], {
+  const child = spawn6("bash", [shellPath, ...positional], {
     cwd: ctx.cwd,
     env,
     stdio: ["pipe", "pipe", "pipe"],
@@ -10657,7 +10816,7 @@ function resolveAuthToken(env = process.env) {
   if (token && !env.GH_TOKEN) env.GH_TOKEN = token;
   return token;
 }
-function detectPackageManager2(cwd) {
+function detectPackageManager3(cwd) {
   if (fs32.existsSync(path30.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
   if (fs32.existsSync(path30.join(cwd, "yarn.lock"))) return "yarn";
   if (fs32.existsSync(path30.join(cwd, "bun.lockb"))) return "bun";
@@ -10859,7 +11018,7 @@ ${CI_HELP}`);
 `);
     resolveAuthToken();
     reactToTriggerComment(cwd);
-    const pm = args.packageManager ?? detectPackageManager2(cwd);
+    const pm = args.packageManager ?? detectPackageManager3(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
     if (!args.skipInstall) {
@@ -10931,7 +11090,7 @@ async function runScheduledFanOut(cwd, args, opts) {
     if (n > 0) process.stdout.write(`\u2192 kody: unpacked ${n} secret(s) from ALL_SECRETS
 `);
     resolveAuthToken();
-    const pm = args.packageManager ?? detectPackageManager2(cwd);
+    const pm = args.packageManager ?? detectPackageManager3(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
     if (!args.skipInstall) {

package/dist/executables/ui-review/profile.json

@@ -73,6 +73,7 @@
       { "script": "loadConventions" },
       { "script": "discoverQaContext" },
       { "script": "loadQaGuide" },
+      { "script": "startLocalServer" },
       { "script": "resolvePreviewUrl" },
       { "script": "composePrompt" }
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.66",
+  "version": "0.4.67",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,18 @@
     "templates",
     "kody.config.schema.json"
   ],
+  "scripts": {
+    "kody": "tsx bin/kody.ts",
+    "build": "tsup && node scripts/copy-assets.cjs",
+    "test": "vitest run tests/unit tests/int --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "prepublishOnly": "pnpm build"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -33,16 +45,5 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
-  "scripts": {
-    "kody": "tsx bin/kody.ts",
-    "build": "tsup && node scripts/copy-assets.cjs",
-    "test": "vitest run tests/unit tests/int --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write"
-  }
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
+}