kaizen-agent 1.6.7 → 1.6.9

package/cli/web.ts

@@ -1,6 +1,6 @@
 // `kaizen web`: the board in a browser. A loopback HTTP server over state.ts and
 // one HTML page; the page never sees the filesystem, only JSON.
-import { existsSync, readFileSync, readdirSync, statSync, watch, type FSWatcher } from "node:fs";
+import { existsSync, readFileSync, readdirSync, statSync, watch, appendFileSync, type FSWatcher } from "node:fs";
 import { join, dirname } from "node:path";
 import {
   home, type Item, boardCards, knownProjects, remember, locate, label, tilde,
@@ -14,6 +14,17 @@ const DEFAULT_PORT = 7420;
 type Opts = { port?: number; open?: boolean };
 
 export async function web(repoDir: string, opts: Opts = {}) {
+  // A board started from the shortcut has no terminal to show a crash in, so any
+  // crash is written where it can be read afterwards.
+  const log = join(home, ".kaizen", "web.log");
+  for (const ev of ["uncaughtException", "unhandledRejection"] as const) {
+    process.on(ev, (err: unknown) => {
+      const line = `${new Date().toISOString()} ${ev}: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`;
+      try { appendFileSync(log, line); } catch { /* nowhere to write */ }
+      console.error(line);
+      if (ev === "uncaughtException") process.exit(1);
+    });
+  }
   const state = locate();
   if (state && dirname(state) !== home) remember(dirname(state));
   const project = state ? label(state) : null;
@@ -56,7 +67,9 @@ export async function web(repoDir: string, opts: Opts = {}) {
     for (const w of watchers) { try { w.close(); } catch { /* gone */ } }
     watchers.length = 0;
     for (const dir of states(true)) {
-      try { watchers.push(watch(dir, { recursive: true }, changed)); } catch { /* poll covers it */ }
+      // An unhandled 'error' on a watcher (Windows: a watched dir renamed, EPERM on
+      // a locked file) would end the process; the poll covers what the watch misses.
+      try { watchers.push(watch(dir, { recursive: true }, changed).on("error", () => {})); } catch { /* poll covers it */ }
     }
   };
   watchAll();
@@ -83,14 +96,24 @@ export async function web(repoDir: string, opts: Opts = {}) {
   const BOOT = Date.now().toString(36);
   const ping = setInterval(() => { for (const c of clients) { try { c.enqueue(": ping\n\n"); } catch { clients.delete(c); } } }, 8000);
   // A launcher clicked while a board is already up should show that board, not die.
-  const port = opts.port ?? DEFAULT_PORT;
-  const server = (() => { try { return serve(); } catch (e) {
-    if ((e as { code?: string }).code !== "EADDRINUSE") throw e;
-    return null;
-  } })();
-  if (!server) { const url = `http://127.0.0.1:${port}/`; console.log(`\n  kaizen web already at ${url}\n`); if (opts.open !== false) await openApp(url); return; }
-
-  function serve() { return Bun.serve({
+  // A bind can fail because a board is already there, or because the OS will not
+  // hand out the port at all (Windows reserves whole ranges for Hyper-V and WSL,
+  // and reports either as "in use"). Only a board that answers is "already
+  // running"; otherwise walk up to the next port that binds.
+  let port = opts.port ?? DEFAULT_PORT;
+  let server: ReturnType<typeof serve> | null = null;
+  for (let tries = 0; tries < 10 && !server; tries++, port++) {
+    try { server = serve(port); } catch (e) {
+      if (!["EADDRINUSE", "EACCES"].includes((e as { code?: string }).code ?? "")) throw e;
+      const url = `http://127.0.0.1:${port}/`;
+      const up = await fetch(url, { signal: AbortSignal.timeout(1500) }).then((r) => r.ok, () => false);
+      if (up) { console.log(`\n  kaizen web already at ${url}\n`); if (opts.open !== false) await openApp(url); return; }
+      console.log(`  port ${port} refused by the OS and nothing answers there; trying ${port + 1}`);
+    }
+  }
+  if (!server) { console.log(`\n  kaizen web could not bind any port from ${opts.port ?? DEFAULT_PORT}\n`); return; }
+
+  function serve(port: number) { return Bun.serve({
     hostname: "127.0.0.1",
     port,
     async fetch(req) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaizen-agent",
-  "version": "1.6.7",
+  "version": "1.6.9",
   "description": "Staged workflow for AI agents — code, writing, research, operations: plan, human approval, build, independent review, bounded fix loop.",
   "type": "module",
   "bin": {