@bakapiano/ccsm 0.5.0 → 0.8.3

package/server.js

@@ -6,6 +6,7 @@ const express = require('express');
 
 const { listSessions, listRecentSessions, findSessionMetadata } = require('./lib/sessions');
 const { listFavorites, addFavorite, removeFavorite, loadFavorites } = require('./lib/favorites');
+const { loadLabels, setLabel, removeLabel } = require('./lib/labels');
 const { loadConfig, saveConfig, DATA_DIR } = require('./lib/config');
 const {
   saveSnapshot,
@@ -31,6 +32,35 @@ const {
   snapshotWindowsOf,
   focusNewlyOpenedHwnd,
 } = require('./lib/focus');
+const webTerminal = require('./lib/webTerminal');
+
+// One unified exit path so every reason-for-shutdown gets the same
+// cleanup: final snapshot save (so the next launch can restore current
+// state) + PTY children killed. Idempotent — concurrent triggers are no-ops.
+let shuttingDown = false;
+async function gracefulShutdown(reason) {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  console.log(`[ccsm] shutting down · ${reason}`);
+
+  // Final snapshot. Wrap in a race so a wedged disk doesn't hang us
+  // indefinitely — 2s is generous (typical save is <300ms).
+  try {
+    const cfg = await loadConfig();
+    await Promise.race([
+      saveSnapshot({ keep: cfg.snapshotHistoryKeep }),
+      new Promise((_, reject) => setTimeout(() => reject(new Error('save timeout (2s)')), 2000)),
+    ]);
+    console.log('[ccsm] final snapshot saved');
+  } catch (e) {
+    console.error('[ccsm] final snapshot skipped:', e.message);
+  }
+
+  // Kill any in-process PTY children so they don't outlive us.
+  try { webTerminal.killAll(); } catch {}
+
+  process.exit(0);
+}
 
 async function autoFocusAfterLaunch({ terminal, beforeHwnds, autoFocus }) {
   if (!autoFocus) return;
@@ -45,7 +75,68 @@ async function autoFocusAfterLaunch({ terminal, beforeHwnds, autoFocus }) {
 
 const app = express();
 app.use(express.json({ limit: '1mb' }));
-app.use(express.static(path.join(__dirname, 'public')));
+
+// CORS · allow the hosted-frontend (GH Pages) origin to call /api/* and
+// open WebSockets. Listed explicitly — never reflect Origin or use '*' so
+// random web pages can't reach the local backend. Localhost dev calls
+// stay same-origin (browser doesn't add Origin header → middleware is a
+// no-op for them).
+const ALLOWED_ORIGINS = new Set([
+  'https://bakapiano.github.io',
+]);
+app.use((req, res, next) => {
+  const origin = req.headers.origin;
+  if (origin && ALLOWED_ORIGINS.has(origin)) {
+    res.setHeader('Access-Control-Allow-Origin', origin);
+    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+    res.setHeader('Vary', 'Origin');
+  }
+  if (req.method === 'OPTIONS') return res.sendStatus(204);
+  next();
+});
+
+// Dev mode = running from a checkout (not from an npm-install location).
+// Used to gate two things: (a) serving static frontend from local public/
+// so a contributor can iterate without pushing to GH Pages; (b) hot-reload
+// SSE endpoint that watches public/ for changes. CCSM_NO_DEV=1 disables
+// both explicitly. In production (npm-installed), backend is API-only —
+// frontend lives at https://bakapiano.github.io/cssm/v1/.
+const IS_DEV = !__dirname.includes(`${path.sep}node_modules${path.sep}`) && process.env.CCSM_NO_DEV !== '1';
+
+if (IS_DEV) {
+  app.use(express.static(path.join(__dirname, 'public')));
+}
+
+const reloadClients = new Set();
+if (IS_DEV) {
+  app.get('/api/dev/ping', (_req, res) => res.json({ dev: true }));
+  app.get('/api/dev/reload', (req, res) => {
+    res.setHeader('Content-Type', 'text/event-stream');
+    res.setHeader('Cache-Control', 'no-cache, no-transform');
+    res.setHeader('Connection', 'keep-alive');
+    res.flushHeaders();
+    res.write(': connected\n\n');
+    reloadClients.add(res);
+    // Heartbeat every 25s so intermediate proxies don't kill the stream.
+    const hb = setInterval(() => { try { res.write(': ping\n\n'); } catch {} }, 25000);
+    req.on('close', () => { clearInterval(hb); reloadClients.delete(res); });
+  });
+  const publicDir = path.join(__dirname, 'public');
+  const fs = require('node:fs');
+  let debounce = null;
+  fs.watch(publicDir, { recursive: true }, (_event, filename) => {
+    clearTimeout(debounce);
+    debounce = setTimeout(() => {
+      if (reloadClients.size === 0) return;
+      console.log(`[dev] reload · ${filename || '?'} → ${reloadClients.size} client(s)`);
+      for (const r of reloadClients) {
+        try { r.write(`event: reload\ndata: ${Date.now()}\n\n`); } catch {}
+      }
+    }, 80);
+  });
+  console.log('[dev] hot-reload watching public/');
+}
 
 function asyncH(fn) {
   return (req, res) => {
@@ -105,6 +196,29 @@ app.delete('/api/favorites/:sessionId', asyncH(async (req, res) => {
   res.json({ removed });
 }));
 
+// ---- labels (rename overrides) ----
+// Custom display titles keyed by sessionId. Empty body / empty label is
+// treated as a delete.
+app.get('/api/labels', asyncH(async (_req, res) => {
+  const labels = await loadLabels();
+  res.json({ labels });
+}));
+
+app.put('/api/labels/:sessionId', asyncH(async (req, res) => {
+  const label = req.body && req.body.label;
+  if (!label || !String(label).trim()) {
+    const removed = await removeLabel(req.params.sessionId);
+    return res.json({ removed });
+  }
+  const saved = await setLabel(req.params.sessionId, label);
+  res.json({ label: saved });
+}));
+
+app.delete('/api/labels/:sessionId', asyncH(async (req, res) => {
+  const removed = await removeLabel(req.params.sessionId);
+  res.json({ removed });
+}));
+
 // ---- config ----
 
 app.get('/api/config', asyncH(async (_req, res) => {
@@ -259,22 +373,48 @@ app.post('/api/sessions/new', async (req, res) => {
     const shouldLaunch = req.body && req.body.launch !== false;
     let launched = null;
     if (shouldLaunch) {
-      const beforeHwnds = await snapshotWindowsOf(
-        processNameFor(cfg.terminal) || 'WindowsTerminal.exe'
-      );
-      launched = launchNewClaude({
-        cwd: workspace.path,
-        title: workspace.name,
-        terminal: cfg.terminal,
-        claudeCommand: cfg.claudeCommand,
-      commandShell: cfg.commandShell || "pwsh",
-      });
-      emit({ type: 'launched', launched });
-      autoFocusAfterLaunch({
-        terminal: cfg.terminal,
-        beforeHwnds,
-        autoFocus: cfg.autoFocusOnLaunch !== false,
-      });
+      // mode = 'web' → spawn the claude command as an in-process PTY whose
+      //                stdio is bridged to xterm.js via WebSocket. The session
+      //                lives in webTerminal's pool until killed or claude
+      //                exits. No wt window opens.
+      // mode = 'wt' (default) → existing behaviour: launch via wt window.
+      const mode = req.body && req.body.terminal === 'web' ? 'web' : 'wt';
+
+      if (mode === 'web') {
+        if (!webTerminal.available) {
+          return fail('node-pty is not installed · web terminal mode unavailable');
+        }
+        // Wrap in pwsh so config.claudeCommand can be an alias / function
+        // defined in the user's profile (e.g. `cc`), same trick wt uses.
+        const cmd = cfg.claudeCommand || 'claude';
+        const wrap = (cfg.commandShell || 'pwsh') === 'powershell' ? 'powershell.exe' : 'pwsh.exe';
+        const entry = webTerminal.spawn({
+          command: wrap,
+          args: ['-NoExit', '-NoLogo', '-Command', `Set-Location -LiteralPath '${workspace.path.replace(/'/g, "''")}'; & '${cmd.replace(/'/g, "''")}'`],
+          cwd: workspace.path,
+          meta: { title: workspace.name, workspace: workspace.name, cwd: workspace.path },
+        });
+        launched = { mode: 'web', id: entry.id, pid: entry.meta.pid, terminal: 'web' };
+        emit({ type: 'launched', launched });
+      } else {
+        const beforeHwnds = await snapshotWindowsOf(
+          processNameFor(cfg.terminal) || 'WindowsTerminal.exe'
+        );
+        launched = launchNewClaude({
+          cwd: workspace.path,
+          title: workspace.name,
+          terminal: cfg.terminal,
+          claudeCommand: cfg.claudeCommand,
+          commandShell: cfg.commandShell || 'pwsh',
+        });
+        launched = { mode: 'wt', ...launched };
+        emit({ type: 'launched', launched });
+        autoFocusAfterLaunch({
+          terminal: cfg.terminal,
+          beforeHwnds,
+          autoFocus: cfg.autoFocusOnLaunch !== false,
+        });
+      }
     }
 
     emit({
@@ -340,11 +480,13 @@ app.post('/api/sessions/:sessionId/focus', asyncH(async (req, res) => {
   const sessions = await listSessions();
   const s = sessions.find((x) => x.sessionId === sessionId);
   if (!s) return res.status(404).json({ error: `session ${sessionId} not live` });
+  const cfg = await loadConfig();
   const result = await focusBySession({
     pid: s.pid,
     sessionId: s.sessionId,
     title: s.title,
     cwd: s.cwd,
+    moveToCenter: !!cfg.focusMovesToCenter,
   });
   res.json({ session: { pid: s.pid, sessionId: s.sessionId, cwd: s.cwd, title: s.title }, ...result });
 }));
@@ -352,8 +494,60 @@ app.post('/api/sessions/:sessionId/focus', asyncH(async (req, res) => {
 // ---- terminal kinds ----
 app.get('/api/terminals', (_req, res) => res.json({ terminals: listTerminalKinds() }));
 
+// ---- capabilities probe · used by the frontend to decide whether to show
+// the "open in this page" radio option. node-pty is optional, install-failure
+// degrades us to wt-only. ----
+app.get('/api/capabilities', (_req, res) => res.json({
+  webTerminal: webTerminal.available,
+  webTerminalError: webTerminal.available ? null : String(webTerminal.loadError?.message || 'unavailable'),
+}));
+
+// ---- web terminals · list / kill ----
+// (creation happens through /api/sessions/new with terminal:'web'; attach is
+// over WebSocket below.)
+app.get('/api/sessions/web', (_req, res) => res.json({ terminals: webTerminal.list() }));
+
+app.delete('/api/sessions/web/:id', (req, res) => {
+  const ok = webTerminal.kill(req.params.id);
+  res.json({ killed: ok });
+});
+
 // ---- health ----
-app.get('/api/health', (_req, res) => res.json({ ok: true, pid: process.pid }));
+const pkg = require('./package.json');
+app.get('/api/health', (_req, res) => res.json({ ok: true, pid: process.pid, version: pkg.version, name: pkg.name }));
+
+// ---- lifecycle ----
+// State shared by /api/spawn-browser (opens another window into this server)
+// and the heartbeat watchdog (exits the server if no client has pinged for
+// HEARTBEAT_TIMEOUT_MS). Heartbeat is the safety net behind the primary
+// "browser child exits → server exits" mechanism wired up after listen.
+let currentPort = 0;
+let frontendUrl = '';
+let lastHeartbeat = Date.now();
+let heartbeatSeen = false;
+const HEARTBEAT_TIMEOUT_MS = 90_000;
+
+app.post('/api/heartbeat', (_req, res) => {
+  lastHeartbeat = Date.now();
+  heartbeatSeen = true;
+  res.json({ ok: true });
+});
+
+app.post('/api/spawn-browser', asyncH(async (_req, res) => {
+  const cfg = await loadConfig();
+  const mode = cfg.browserMode || (cfg.autoOpenBrowser === false ? 'none' : 'app');
+  openInBrowser(frontendUrl || `http://localhost:${currentPort}`, mode);
+  res.json({ ok: true, mode, url: frontendUrl });
+}));
+
+// Graceful shutdown · the uninstall script and the auto-upgrade path in
+// the launcher both call this. We reply first so the caller doesn't see
+// a torn connection, then exit on the next tick.
+app.post('/api/shutdown', (_req, res) => {
+  res.json({ ok: true, bye: 'shutting down' });
+  // setImmediate so the response flushes before we tear the server down.
+  setImmediate(() => gracefulShutdown('/api/shutdown'));
+});
 
 // ---- auto-snapshot scheduler ----
 let snapshotTimer = null;
@@ -451,26 +645,115 @@ function openInBrowser(url, mode) {
 
 (async () => {
   const cfg = await loadConfig();
-  const { port } = await listenWithFallback(cfg.port);
-  const url = `http://localhost:${port}`;
-  console.log(`ccsm listening on ${url}${port !== cfg.port ? `  (requested ${cfg.port}, was taken)` : ''}`);
+  const { server, port } = await listenWithFallback(cfg.port);
+  currentPort = port;
+
+  // WebSocket upgrade for /ws/terminal/:id → bridges xterm.js to a PTY
+  // entry in webTerminal's pool. Only enabled when node-pty loaded; the
+  // /api/capabilities endpoint advertises this to the frontend.
+  if (webTerminal.available) {
+    let WebSocketServer;
+    try { ({ WebSocketServer } = require('ws')); } catch {}
+    if (WebSocketServer) {
+      const wss = new WebSocketServer({ noServer: true });
+      server.on('upgrade', (req, socket, head) => {
+        // Origin check · same allow-list as REST CORS. Browsers always
+        // send Origin on WebSocket upgrades; missing Origin = non-browser
+        // client which we tolerate (curl etc).
+        const origin = req.headers.origin;
+        if (origin && !ALLOWED_ORIGINS.has(origin) && !/^https?:\/\/(localhost|127\.0\.0\.1)(:\d+)?$/i.test(origin)) {
+          socket.destroy();
+          return;
+        }
+        const m = req.url && req.url.match(/^\/ws\/terminal\/([^\/?#]+)/);
+        if (!m) { socket.destroy(); return; }
+        const id = decodeURIComponent(m[1]);
+        wss.handleUpgrade(req, socket, head, (ws) => webTerminal.attach(id, ws));
+      });
+      console.log('[ccsm] web terminal bridge active (WebSocket /ws/terminal/:id)');
+    }
+  }
+
+  // OS signals · run a graceful shutdown (which saves a final snapshot
+  // and kills PTY children) before exiting.
+  for (const sig of ['SIGINT', 'SIGTERM']) {
+    process.on(sig, () => gracefulShutdown(sig));
+  }
+  // Last-resort cleanup on sync exit (process.on('exit') can't await
+  // anything, so it's only a safety net for PTY children).
+  process.on('exit', () => { try { webTerminal.killAll(); } catch {} });
+  const apiUrl = `http://localhost:${port}`;
+  // What URL we open in the auto-spawned browser:
+  //   dev  → localhost (backend still serves public/ here)
+  //   prod → hosted frontend on GH Pages (backend is API-only)
+  const FRONTEND_URL = IS_DEV
+    ? apiUrl
+    : 'https://bakapiano.github.io/cssm/v1/';
+  frontendUrl = FRONTEND_URL;
+  console.log(`ccsm listening on ${apiUrl}${port !== cfg.port ? `  (requested ${cfg.port}, was taken)` : ''}`);
+  console.log(`frontend at      ${FRONTEND_URL}`);
   console.log(`data dir:        ${DATA_DIR}`);
   console.log(`work dir:        ${cfg.workDir}`);
   console.log(`terminal:        ${cfg.terminal} · ${cfg.claudeCommand}${cfg.terminal === 'wt' ? ` (via ${cfg.commandShell})` : ''}`);
-  const mode = cfg.browserMode || (cfg.autoOpenBrowser === false ? 'none' : 'app');
-  const opened = openInBrowser(url, mode);
-
-  // Interactive npx-style launch: tie server lifetime to the chromeless
-  // browser window. When the user closes the window, msedge.exe (with its
-  // own --user-data-dir process group) exits — we hear that and shut down
-  // so the terminal returns. Headless / nohup launches stay running.
-  if (opened.kind === 'app' && opened.child && process.stdout.isTTY) {
+  // CCSM_NO_BROWSER=1 (set by the launcher when responding to a ccsm://
+  // protocol click) suppresses the auto-spawned browser window — the
+  // caller already has one open and just needs the backend to come up.
+  const mode = process.env.CCSM_NO_BROWSER === '1'
+    ? 'none'
+    : (cfg.browserMode || (cfg.autoOpenBrowser === false ? 'none' : 'app'));
+  const opened = openInBrowser(FRONTEND_URL, mode);
+
+  // Primary lifecycle: tie this server's lifetime to the chromeless
+  // browser window. msedge.exe runs with its own --user-data-dir process
+  // group, so when the user closes the window it actually exits — and
+  // the spawned child handle we hold here fires 'exit'. Skip if the user
+  // explicitly asked the server to stay alive (e.g. an automation host).
+  if (opened.kind === 'app' && opened.child && process.env.CCSM_KEEP_ALIVE !== '1') {
+    const launchedAt = Date.now();
     opened.child.on('exit', () => {
-      console.log('[ccsm] browser window closed · shutting down');
-      process.exit(0);
+      const alive = Date.now() - launchedAt;
+      // Edge --app= often spawns a process that immediately hands its URL
+      // off to an existing Edge profile process group and exits — our
+      // child handle dies milliseconds after creation. Treat any exit
+      // inside the first 5s as a hand-off, not a real close.
+      if (alive < 5000) {
+        console.log(`[ccsm] spawned browser child exited in ${alive}ms · handed off to an existing Edge instance, staying alive`);
+        return;
+      }
+      // Defer the kill decision by one full frontend ping cycle (~12s,
+      // matching the 10s heartbeat cadence below). Any heartbeat that
+      // arrives AFTER this moment must be from a DIFFERENT client (the
+      // closing browser couldn't ping after it died) — so a hosted-tab
+      // user is still around and we should stay alive.
+      const closedAt = Date.now();
+      setTimeout(() => {
+        if (lastHeartbeat > closedAt + 100) {
+          console.log('[ccsm] browser closed but another client is heartbeating · staying alive');
+          return;
+        }
+        gracefulShutdown('browser window closed');
+      }, 12_000);
     });
     console.log('[ccsm] tied to browser window — close it to stop ccsm');
   }
+
+  // Heartbeat watchdog · only activated when launched via bin/ccsm.js
+  // (CCSM_LAUNCHER=1). Catches cases the primary mechanism misses: the
+  // browser was killed forcibly, msedge crashed without a clean exit, or
+  // the user opened the URL in tab-mode in their own browser instead of
+  // the chromeless app window. We don't kill until we've seen at least
+  // one heartbeat — that way a freshly-booted server with no client yet
+  // doesn't suicide.
+  if (process.env.CCSM_LAUNCHER === '1' && process.env.CCSM_KEEP_ALIVE !== '1') {
+    setInterval(() => {
+      if (!heartbeatSeen) return;
+      if (Date.now() - lastHeartbeat > HEARTBEAT_TIMEOUT_MS) {
+        gracefulShutdown(`no heartbeat for ${HEARTBEAT_TIMEOUT_MS / 1000}s`);
+      }
+    }, 30_000);
+    console.log('[ccsm] heartbeat watchdog active');
+  }
+
   startSnapshotLoop();
 })().catch((err) => {
   console.error('startup failed:', err);