@staff0rd/assist 0.191.2 → 0.192.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.191.2",
+  version: "0.192.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -49,10 +49,12 @@ var package_default = {
     "is-wsl": "^3.1.0",
     minimatch: "^10.1.1",
     "node-notifier": "^10.0.1",
+    "node-pty": "^1.1.0",
     semver: "^7.7.3",
     "shell-quote": "^1.8.3",
     "ts-morph": "^27.0.2",
     typescript: "^5.9.3",
+    ws: "^8.20.0",
     yaml: "^2.8.2",
     zod: "^4.3.6"
   },
@@ -70,7 +72,10 @@ var package_default = {
     "@types/react-dom": "^19.2.3",
     "@types/semver": "^7.7.1",
     "@types/shell-quote": "^1.7.5",
+    "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^4.1.2",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/xterm": "^6.0.0",
     esbuild: "^0.27.3",
     jotai: "^2.18.0",
     jscpd: "^4.0.5",
@@ -1175,7 +1180,7 @@ function getTranscriptConfig() {
 // src/commands/backlog/spawnClaude.ts
 function spawnClaude(prompt, options2 = {}) {
   const config = loadConfig();
-  const finalPrompt = config.caveman ? `/caveman
+  const finalPrompt = config.caveman ? `/caveman:caveman
 
 ${prompt}` : prompt;
   const args = [finalPrompt];
@@ -1573,20 +1578,20 @@ function createBundleHandler(importMetaUrl, bundlePath) {
     res.end(cache);
   };
 }
-function createHtmlHandler(getHtml3) {
+function createHtmlHandler(getHtml4) {
   return (_req, res) => {
     res.writeHead(200, { "Content-Type": "text/html" });
-    res.end(getHtml3());
+    res.end(getHtml4());
   };
 }
 function parseRoute(req, port) {
   const url = new URL(req.url ?? "/", `http://localhost:${port}`);
   return { method: req.method ?? "GET", pathname: url.pathname };
 }
-function createRouteHandler(routes3) {
+function createRouteHandler(routes4) {
   return async (req, res, port) => {
     const { method, pathname } = parseRoute(req, port);
-    const handler = routes3[`${method} ${pathname}`];
+    const handler = routes4[`${method} ${pathname}`];
     if (handler) {
       await handler(req, res);
       return;
@@ -1605,6 +1610,25 @@ function startWebServer(label2, port, handler) {
     console.log(chalk16.dim("Press Ctrl+C to stop"));
     exec(`open ${url}`);
   });
+  return server;
+}
+
+// src/shared/createFallbackHandler.ts
+function createFallbackHandler(routes4, htmlHandler3, extra) {
+  const baseHandler = createRouteHandler(routes4);
+  return async (req, res, port) => {
+    const { method, pathname } = parseRoute(req, port);
+    if (extra && await extra(req, res, pathname)) return;
+    if (routes4[`${method} ${pathname}`]) {
+      await baseHandler(req, res, port);
+      return;
+    }
+    if (method === "GET" && !pathname.startsWith("/api/")) {
+      await htmlHandler3(req, res);
+      return;
+    }
+    await baseHandler(req, res, port);
+  };
 }
 
 // src/commands/backlog/web/getHtml.ts
@@ -1711,8 +1735,9 @@ async function patchItemStatus(req, res, id) {
 }
 
 // src/commands/backlog/web/handleRequest.ts
+var htmlHandler = createHtmlHandler(getHtml);
 var routes = {
-  "GET /": createHtmlHandler(getHtml),
+  "GET /": htmlHandler,
   "GET /bundle.js": createBundleHandler(
     import.meta.url,
     "commands/backlog/web/bundle.js"
@@ -1726,8 +1751,6 @@ var itemRoutes = {
   PATCH: (req, res, id) => patchItemStatus(req, res, id),
   DELETE: (_req, res, id) => deleteItem2(res, id)
 };
-var serveHtml = createHtmlHandler(getHtml);
-var baseHandler = createRouteHandler(routes);
 async function handleItemRoute(req, res, pathname) {
   const match = pathname.match(/^\/api\/items\/(\d+)$/);
   if (!match) return false;
@@ -1736,21 +1759,11 @@ async function handleItemRoute(req, res, pathname) {
   await handler(req, res, Number.parseInt(match[1], 10));
   return true;
 }
-async function handleRequest(req, res, port) {
-  const url = new URL(req.url ?? "/", `http://localhost:${port}`);
-  const method = req.method ?? "GET";
-  const pathname = url.pathname;
-  if (await handleItemRoute(req, res, pathname)) return;
-  if (routes[`${method} ${pathname}`]) {
-    await baseHandler(req, res, port);
-    return;
-  }
-  if (method === "GET" && !pathname.startsWith("/api/")) {
-    await serveHtml(req, res);
-    return;
-  }
-  await baseHandler(req, res, port);
-}
+var handleRequest = createFallbackHandler(
+  routes,
+  htmlHandler,
+  handleItemRoute
+);
 
 // src/commands/backlog/web/index.ts
 async function web(options2) {
@@ -12373,6 +12386,272 @@ function screenshot(processName) {
   }
 }
 
+// src/commands/sessions/web/index.ts
+import { WebSocketServer } from "ws";
+
+// src/commands/sessions/web/handleRequest.ts
+import { readFileSync as readFileSync34 } from "fs";
+import { createRequire as createRequire2 } from "module";
+
+// src/commands/sessions/web/getHtml.ts
+function getHtml3() {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Sessions</title>
+<link rel="stylesheet" href="/xterm.css">
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  html, body, #app { width: 100%; height: 100%; overflow: hidden; background: #1e1e1e; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; }
+  ::-webkit-scrollbar { width: 6px; }
+  ::-webkit-scrollbar-track { background: transparent; }
+  ::-webkit-scrollbar-thumb { background: #555; border-radius: 3px; }
+  ::-webkit-scrollbar-thumb:hover { background: #777; }
+</style>
+</head>
+<body>
+<div id="app"></div>
+<script src="/bundle.js"></script>
+</body>
+</html>`;
+}
+
+// src/commands/sessions/web/handleRequest.ts
+var require3 = createRequire2(import.meta.url);
+function createCssHandler(packageEntry) {
+  let cache;
+  return (_req, res) => {
+    if (!cache) {
+      const resolved = require3.resolve(packageEntry);
+      cache = readFileSync34(resolved, "utf-8");
+    }
+    res.writeHead(200, { "Content-Type": "text/css" });
+    res.end(cache);
+  };
+}
+var htmlHandler2 = createHtmlHandler(getHtml3);
+var routes3 = {
+  "GET /": htmlHandler2,
+  "GET /bundle.js": createBundleHandler(
+    import.meta.url,
+    "commands/sessions/web/bundle.js"
+  ),
+  "GET /xterm.css": createCssHandler("@xterm/xterm/css/xterm.css")
+};
+var handleRequest3 = createFallbackHandler(routes3, htmlHandler2);
+
+// src/commands/sessions/web/handleSocket.ts
+function handleSocket(ws, manager) {
+  manager.addClient(ws);
+  ws.on("message", (msg) => {
+    let data;
+    try {
+      data = JSON.parse(msg.toString());
+    } catch {
+      return;
+    }
+    switch (data.type) {
+      case "create": {
+        const id = manager.spawn(data.prompt);
+        ws.send(JSON.stringify({ type: "created", sessionId: id }));
+        break;
+      }
+      case "input":
+        manager.writeToSession(data.sessionId, data.data);
+        break;
+      case "resize":
+        manager.resizeSession(
+          data.sessionId,
+          data.cols,
+          data.rows
+        );
+        break;
+      case "dismiss":
+        manager.dismissSession(data.sessionId);
+        break;
+    }
+  });
+  ws.on("close", () => {
+    manager.removeClient(ws);
+  });
+}
+
+// src/commands/sessions/web/spawnClaude.ts
+import * as pty from "node-pty";
+function spawnClaude2(prompt) {
+  const shell = process.platform === "win32" ? "cmd.exe" : process.env.SHELL ?? "bash";
+  const args = buildArgs(prompt);
+  return pty.spawn(shell, args, {
+    name: "xterm-256color",
+    cols: 120,
+    rows: 30,
+    cwd: process.cwd(),
+    env: { ...process.env }
+  });
+}
+function buildArgs(prompt) {
+  if (process.platform === "win32") {
+    return prompt ? ["/c", "claude", prompt] : ["/c", "claude"];
+  }
+  return prompt ? ["-c", 'exec claude "$0"', prompt] : ["-c", "claude"];
+}
+
+// src/commands/sessions/web/createSession.ts
+function createSession(id, prompt) {
+  return {
+    id,
+    name: prompt?.slice(0, 40) || `Session ${id}`,
+    status: "running",
+    startedAt: Date.now(),
+    pty: spawnClaude2(prompt),
+    scrollback: "",
+    idleTimer: null,
+    lastResizeAt: 0
+  };
+}
+
+// src/commands/sessions/web/scheduleIdle.ts
+var IDLE_MS = 3e3;
+function scheduleIdle(session, onIdle) {
+  if (session.idleTimer) clearTimeout(session.idleTimer);
+  if (session.status === "done") return;
+  session.idleTimer = setTimeout(() => {
+    if (session.status === "running") onIdle();
+  }, IDLE_MS);
+}
+function clearIdle(session) {
+  if (session.idleTimer) clearTimeout(session.idleTimer);
+}
+
+// src/commands/sessions/web/wsBroadcast.ts
+function wsSend(ws, msg) {
+  if (ws.readyState === ws.OPEN) ws.send(JSON.stringify(msg));
+}
+function wsBroadcast(clients, msg) {
+  const json = JSON.stringify(msg);
+  for (const ws of clients) {
+    if (ws.readyState === ws.OPEN) ws.send(json);
+  }
+}
+
+// src/commands/sessions/web/wirePtyEvents.ts
+var MAX_SCROLLBACK = 256 * 1024;
+var RESIZE_GRACE_MS = 500;
+function appendScrollback(session, data) {
+  session.scrollback += data;
+  if (session.scrollback.length > MAX_SCROLLBACK) {
+    session.scrollback = session.scrollback.slice(-MAX_SCROLLBACK);
+  }
+}
+function wirePtyEvents(session, clients, onStatusChange) {
+  session.pty.onData((data) => {
+    appendScrollback(session, data);
+    const isRedraw = Date.now() - session.lastResizeAt < RESIZE_GRACE_MS;
+    if (!isRedraw && session.status !== "running")
+      onStatusChange(session, "running");
+    if (!isRedraw)
+      scheduleIdle(session, () => onStatusChange(session, "waiting"));
+    wsBroadcast(clients, { type: "output", sessionId: session.id, data });
+  });
+  session.pty.onExit(() => {
+    clearIdle(session);
+    onStatusChange(session, "done");
+  });
+}
+
+// src/commands/sessions/web/SessionManager.ts
+var SessionManager = class {
+  sessions = /* @__PURE__ */ new Map();
+  clients = /* @__PURE__ */ new Set();
+  nextId = 1;
+  addClient(ws) {
+    this.clients.add(ws);
+    wsSend(ws, { type: "sessions", sessions: this.listSessions() });
+    for (const s of this.sessions.values()) {
+      if (s.scrollback)
+        wsSend(ws, { type: "output", sessionId: s.id, data: s.scrollback });
+    }
+  }
+  removeClient(ws) {
+    this.clients.delete(ws);
+  }
+  spawn(prompt) {
+    const id = String(this.nextId++);
+    const session = createSession(id, prompt);
+    this.sessions.set(id, session);
+    wirePtyEvents(session, this.clients, (s, status2) => {
+      s.status = status2;
+      this.notify();
+    });
+    scheduleIdle(session, () => {
+      session.status = "waiting";
+      this.notify();
+    });
+    this.notify();
+    return id;
+  }
+  writeToSession(id, data) {
+    const s = this.sessions.get(id);
+    if (s && s.status !== "done") s.pty.write(data);
+  }
+  resizeSession(id, cols, rows) {
+    const s = this.sessions.get(id);
+    if (s && s.status !== "done") {
+      s.lastResizeAt = Date.now();
+      s.pty.resize(cols, rows);
+    }
+  }
+  dismissSession(id) {
+    const s = this.sessions.get(id);
+    if (!s) return;
+    if (s.status !== "done") s.pty.kill();
+    clearIdle(s);
+    this.sessions.delete(id);
+    this.notify();
+  }
+  listSessions() {
+    return [...this.sessions.values()].map(
+      ({ id, name, status: status2, startedAt }) => ({
+        id,
+        name,
+        status: status2,
+        startedAt
+      })
+    );
+  }
+  notify() {
+    wsBroadcast(this.clients, {
+      type: "sessions",
+      sessions: this.listSessions()
+    });
+  }
+};
+
+// src/commands/sessions/web/index.ts
+async function web3(options2) {
+  const port = Number.parseInt(options2.port, 10);
+  const server = startWebServer("Sessions", port, handleRequest3);
+  const manager = new SessionManager();
+  const wss = new WebSocketServer({ noServer: true });
+  server.on("upgrade", (req, socket, head) => {
+    if (req.url === "/ws") {
+      wss.handleUpgrade(req, socket, head, (ws) => {
+        handleSocket(ws, manager);
+      });
+    } else {
+      socket.destroy();
+    }
+  });
+}
+
+// src/commands/sessions/registerSessions.ts
+function registerSessions(program2) {
+  const cmd = program2.command("sessions").description("Web dashboard for Claude Code sessions").action(() => web3({ port: "3100" }));
+  cmd.command("web").description("Start the sessions web dashboard").option("-p, --port <number>", "Port to listen on", "3100").action(web3);
+}
+
 // src/commands/statusLine.ts
 import chalk134 from "chalk";
 
@@ -12627,6 +12906,7 @@ registerRavendb(program);
 registerSeq(program);
 registerTranscript(program);
 registerVoice(program);
+registerSessions(program);
 registerDeny(program);
 program.command("next").description("Alias for backlog next -w").action(() => next({ allowEdits: true }));
 program.command("draft").alias("feat").description("Launch Claude in /draft mode, chain into next on /next signal").action(() => launchMode("draft"));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.191.2",
+	"version": "0.192.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {
@@ -43,10 +43,12 @@
 		"is-wsl": "^3.1.0",
 		"minimatch": "^10.1.1",
 		"node-notifier": "^10.0.1",
+		"node-pty": "^1.1.0",
 		"semver": "^7.7.3",
 		"shell-quote": "^1.8.3",
 		"ts-morph": "^27.0.2",
 		"typescript": "^5.9.3",
+		"ws": "^8.20.0",
 		"yaml": "^2.8.2",
 		"zod": "^4.3.6"
 	},
@@ -64,7 +66,10 @@
 		"@types/react-dom": "^19.2.3",
 		"@types/semver": "^7.7.1",
 		"@types/shell-quote": "^1.7.5",
+		"@types/ws": "^8.18.1",
 		"@vitest/coverage-v8": "^4.1.2",
+		"@xterm/addon-fit": "^0.11.0",
+		"@xterm/xterm": "^6.0.0",
 		"esbuild": "^0.27.3",
 		"jotai": "^2.18.0",
 		"jscpd": "^4.0.5",