claude-code-kanban 4.28.0 → 4.29.0

package/lib/priority.js

@@ -0,0 +1,45 @@
+'use strict';
+
+// Windows boosts the threads of the foreground window, and a process behind a hidden ConPTY never
+// gets that, so the one the user types into competes on equal terms with every busy agent.
+// Elsewhere a raise needs root, and a raised nice value would pass on to every child, so this is
+// Windows only. There a child of an above-normal process starts at normal, so the tools it runs
+// stay unboosted.
+const { execFile } = require('node:child_process');
+const os = require('node:os');
+
+const { PRIORITY_ABOVE_NORMAL } = os.constants.priority;
+
+function enabled(platform, env) {
+  return platform === 'win32' && env.CCK_PRIORITY_BOOST !== '0';
+}
+
+function raise(pid = 0, platform = process.platform, env = process.env) {
+  if (!enabled(platform, env)) return null;
+  try {
+    const before = os.getPriority(pid);
+    if (before <= PRIORITY_ABOVE_NORMAL) return null;
+    os.setPriority(pid, PRIORITY_ABOVE_NORMAL);
+    return before;
+  } catch {
+    return null;
+  }
+}
+
+function restore(pid, before) {
+  try { os.setPriority(pid, before); } catch { /* the process is gone */ }
+}
+
+// ConPTY's console host relays every byte between cck and the shell, and node-pty does not expose
+// its pid. Under load a normal-priority host starves for seconds, until Windows' anti-starvation
+// boost picks it up.
+function raiseConsoleHosts(done) {
+  if (!enabled(process.platform, process.env)) return done?.();
+  const query = `(Get-CimInstance Win32_Process -Filter "ParentProcessId=${process.pid} AND (Name='conhost.exe' OR Name='OpenConsole.exe')").ProcessId`;
+  execFile('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', query], { windowsHide: true, timeout: 30000 }, (err, stdout) => {
+    if (!err) for (const pid of stdout.split(/\s+/).filter(Boolean)) raise(Number(pid));
+    done?.();
+  });
+}
+
+module.exports = { raise, restore, raiseConsoleHosts };

package/lib/terminal.js

@@ -13,6 +13,7 @@ const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
 const { isContained } = require('./contain');
+const priority = require('./priority');
 
 const WS_PATH = '/api/terminal/ws';
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
@@ -32,6 +33,7 @@ const PROMPT_QUIET_MS = 400;
 const HIGH_WATER = 128 * 1024;
 const LOW_WATER = 16 * 1024;
 const HELLO_TIMEOUT_MS = 5000;
+const BOOST_TRIES = 30;
 const MAX_PAYLOAD = 1024 * 1024;
 // The hub hands its children PORT=0 and friends; a dev server started in the terminal
 // would otherwise bind a random port, and a nested `claude` would think it runs inside one.
@@ -224,6 +226,7 @@ function refuse(socket, status, reason) {
  */
 function createTerminalService(o) {
   const { config, net } = o;
+  if (config.enabled) priority.raise();
   const token = o.token || crypto.randomBytes(32).toString('hex');
   const sessions = new Map();
   let pty = null;
@@ -302,6 +305,43 @@ function createTerminalService(o) {
     };
   }
 
+  // The process a viewer types into: claude, found through its registry entry, or the shell.
+  function inputPid(s) {
+    if (s.mode === 'shell') return s.pty.pid;
+    if (s.claudePid || s.mode === 'pick') return s.claudePid;
+    const live = o.liveSessions();
+    const own = live.find((l) => l.pid && l.sessionId === s.id && l.startedAt >= s.startedAt - PICK_START_SLACK_MS);
+    if (own || s.mode !== 'fork') return own?.pid;
+    const claimed = new Set([...sessions.values()].map((x) => x.claudePid).filter(Boolean));
+    return findPickProcess(live, s, claimed);
+  }
+
+  // claude writes its registry entry a moment after it starts, so the pid is polled for.
+  function syncBoost(s) {
+    const want = s.sockets.size > 0 && !s.exited;
+    if (want && !s.boost) {
+      if (s.boostTimer) return;
+      let tries = 0;
+      const tryBoost = () => {
+        const pid = inputPid(s);
+        if (!pid && ++tries < BOOST_TRIES) return;
+        clearInterval(s.boostTimer);
+        s.boostTimer = null;
+        if (!pid) return;
+        if (s.mode !== 'shell') s.claudePid = pid;
+        const before = priority.raise(pid);
+        s.boost = { pid, before };
+      };
+      s.boostTimer = setInterval(tryBoost, PICK_POLL_MS);
+      tryBoost();
+    } else if (!want) {
+      clearInterval(s.boostTimer);
+      s.boostTimer = null;
+      if (s.boost && s.boost.before !== null && !s.exited) priority.restore(s.boost.pid, s.boost.before);
+      s.boost = null;
+    }
+  }
+
   function spawnSession(id, mode, cwdCandidate, cols, rows, spec, extraEnv) {
     const cwd = cwdCandidate && fs.existsSync(cwdCandidate) ? cwdCandidate : os.homedir();
     const env = { ...ptyEnv({ claudeDir: o.claudeDir, isDefaultDir: o.isDefaultDir, noFlicker: config.noFlicker }), ...extraEnv };
@@ -335,6 +375,7 @@ function createTerminalService(o) {
     proc.onExit(({ exitCode }) => {
       s.exited = true;
       clearInterval(s.pickTimer);
+      clearInterval(s.boostTimer);
       if (sessions.get(s.id) === s) sessions.delete(s.id);
       o.onExit?.(s.id);
       if (!s.ended) o.onChange?.();
@@ -345,6 +386,7 @@ function createTerminalService(o) {
       term.dispose();
     });
     sessions.set(id, s);
+    priority.raiseConsoleHosts();
     o.onChange?.();
     return s;
   }
@@ -389,6 +431,7 @@ function createTerminalService(o) {
   function attach(ws, s, attached) {
     ws.unacked = 0;
     s.sockets.add(ws);
+    syncBoost(s);
     send(ws, { t: 'ready', attached });
     const snapshot = s.serializer.serialize();
     if (snapshot) sendOutput(ws, Buffer.from(snapshot, 'utf8'));
@@ -411,6 +454,7 @@ function createTerminalService(o) {
     });
     ws.on('close', () => {
       s.sockets.delete(ws);
+      syncBoost(s);
       if (!s.exited) updateFlow(s);
     });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "4.28.0",
+  "version": "4.29.0",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "bin": {