uv-suite 0.17.0 → 0.19.0

package/bin/cli.js

@@ -86,10 +86,26 @@ function personaLabel(p) {
   return labels[p] || p;
 }
 
+function ensureInstalled(persona) {
+  const settings = path.resolve('.claude/personas', `${persona}.json`);
+  if (!fs.existsSync(settings)) {
+    console.log('UV Suite not installed in this project. Installing...');
+    console.log('');
+    const installScript = path.join(UV_SUITE_DIR, 'install.sh');
+    try {
+      execSync(`bash "${installScript}" --persona ${persona}`, { stdio: 'inherit', timeout: 60000 });
+    } catch (e) {
+      // Install may timeout on pip installs but core files are already copied
+    }
+    console.log('');
+  }
+}
+
 function launchClaude(persona, extra) {
+  ensureInstalled(persona);
   const settings = path.resolve('.claude/personas', `${persona}.json`);
   if (!fs.existsSync(settings)) {
-    console.error(`Error: ${settings} not found. Run 'uv install' first.`);
+    console.error(`Error: installation failed. Run 'uvs install --persona ${persona}' manually.`);
     process.exit(1);
   }
   console.log(`UV Suite | Claude Code | ${personaLabel(persona)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Portable framework for AI-assisted software development. 10 agents, 9 skills, 5 hooks, 4 personas. Works with Claude Code, Cursor, and Codex.",
   "author": "Utsav Anand",
   "license": "MIT",

package/watchtower/dashboard.html

@@ -225,28 +225,31 @@ function toggleAutoScroll() {
   document.getElementById('btnAutoScroll').classList.toggle('active', autoScroll);
 }
 
-// WebSocket connection
+// Server-Sent Events connection (replaces WebSocket — simpler, auto-reconnects)
 function connect() {
-  const proto = location.protocol === 'https:' ? 'wss:' : 'ws:';
-  ws = new WebSocket(`${proto}//${location.host}/ws`);
+  const source = new EventSource('/stream');
 
-  ws.onopen = () => {
+  source.onopen = () => {
     statusDot.className = 'dot on';
     statusText.textContent = 'Connected';
   };
 
-  ws.onclose = () => {
+  source.onerror = () => {
     statusDot.className = 'dot off';
-    statusText.textContent = 'Disconnected — reconnecting...';
-    setTimeout(connect, 2000);
+    statusText.textContent = 'Reconnecting...';
+    // EventSource auto-reconnects — no manual retry needed
   };
 
-  ws.onmessage = (msg) => {
-    const data = JSON.parse(msg.data);
-    if (data.type === 'init' && data.events) {
-      data.events.forEach(addEvent);
-    } else {
-      addEvent(data);
+  source.onmessage = (msg) => {
+    try {
+      const data = JSON.parse(msg.data);
+      if (data.type === 'init' && data.events) {
+        data.events.forEach(addEvent);
+      } else {
+        addEvent(data);
+      }
+    } catch (e) {
+      // ignore parse errors (ping frames, etc.)
     }
   };
 }

package/watchtower/events.json

@@ -7,5 +7,16 @@
     "cwd": "/tmp",
     "_ts": 1776756371726,
     "_id": "3f130976-6226-47ea-a477-18a16e194415"
+  },
+  {
+    "event_type": "PostToolUse",
+    "session_id": "test-session",
+    "source_app": "my-project",
+    "tool_name": "Edit",
+    "tool_input": {
+      "file_path": "src/app.ts"
+    },
+    "_ts": 1776757586012,
+    "_id": "efa9ae75-c0e0-48c2-a078-e7075ccef5a7"
   }
 ]

package/watchtower/server.js

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
 
 // UV Suite Watchtower — lightweight observability server
-// Zero dependencies beyond Node.js (uses built-in http, fs, ws via raw upgrade)
+// Zero dependencies beyond Node.js
+// Uses Server-Sent Events (SSE) instead of WebSocket — simpler, auto-reconnects
 
 const http = require('http');
 const fs = require('fs');
 const path = require('path');
+const crypto = require('crypto');
 
 const PORT = process.env.UVS_WATCHTOWER_PORT || 4200;
 const DATA_FILE = path.join(__dirname, 'events.json');
@@ -21,64 +23,29 @@ try {
   events = [];
 }
 
-// WebSocket clients
-const clients = new Set();
+// SSE clients
+const sseClients = new Set();
 
 function broadcast(event) {
-  const msg = JSON.stringify(event);
-  for (const ws of clients) {
-    try { ws.send(msg); } catch (e) { clients.delete(ws); }
+  const data = JSON.stringify(event);
+  for (const res of sseClients) {
+    try {
+      res.write(`data: ${data}\n\n`);
+    } catch (e) {
+      sseClients.delete(res);
+    }
   }
 }
 
 function saveEvents() {
-  // Keep only the last MAX_EVENTS
   if (events.length > MAX_EVENTS) {
     events = events.slice(-MAX_EVENTS);
   }
-  fs.writeFileSync(DATA_FILE, JSON.stringify(events, null, 2));
-}
-
-// Minimal WebSocket handshake (no dependency needed)
-const crypto = require('crypto');
-
-function upgradeToWebSocket(req, socket) {
-  const key = req.headers['sec-websocket-key'];
-  const accept = crypto.createHash('sha1')
-    .update(key + '258EAFA5-E914-47DA-95CA-5AB5DC085B11')
-    .digest('base64');
-
-  socket.write(
-    'HTTP/1.1 101 Switching Protocols\r\n' +
-    'Upgrade: websocket\r\n' +
-    'Connection: Upgrade\r\n' +
-    `Sec-WebSocket-Accept: ${accept}\r\n` +
-    '\r\n'
-  );
-
-  const ws = {
-    send(data) {
-      const buf = Buffer.from(data);
-      const frame = [];
-      frame.push(0x81); // text frame
-      if (buf.length < 126) {
-        frame.push(buf.length);
-      } else if (buf.length < 65536) {
-        frame.push(126, (buf.length >> 8) & 0xff, buf.length & 0xff);
-      } else {
-        frame.push(127);
-        for (let i = 7; i >= 0; i--) frame.push((buf.length >> (i * 8)) & 0xff);
-      }
-      socket.write(Buffer.concat([Buffer.from(frame), buf]));
-    }
-  };
-
-  clients.add(ws);
-  socket.on('close', () => clients.delete(ws));
-  socket.on('error', () => clients.delete(ws));
-
-  // Send recent events on connect
-  ws.send(JSON.stringify({ type: 'init', events: events.slice(-100) }));
+  try {
+    fs.writeFileSync(DATA_FILE, JSON.stringify(events, null, 2));
+  } catch (e) {
+    // ignore write errors
+  }
 }
 
 const server = http.createServer((req, res) => {
@@ -114,7 +81,32 @@ const server = http.createServer((req, res) => {
     return;
   }
 
-  // GET /events — fetch recent events
+  // GET /stream — SSE endpoint (replaces WebSocket)
+  if (req.method === 'GET' && req.url === '/stream') {
+    res.writeHead(200, {
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache',
+      'Connection': 'keep-alive',
+    });
+
+    // Send recent events as init
+    res.write(`data: ${JSON.stringify({ type: 'init', events: events.slice(-100) })}\n\n`);
+
+    sseClients.add(res);
+
+    // Keep-alive ping every 15 seconds
+    const keepAlive = setInterval(() => {
+      try { res.write(': ping\n\n'); } catch (e) { clearInterval(keepAlive); }
+    }, 15000);
+
+    req.on('close', () => {
+      sseClients.delete(res);
+      clearInterval(keepAlive);
+    });
+    return;
+  }
+
+  // GET /events — fetch recent events (REST fallback)
   if (req.method === 'GET' && req.url.startsWith('/events')) {
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify(events.slice(-100)));
@@ -133,14 +125,6 @@ const server = http.createServer((req, res) => {
   res.end('not found');
 });
 
-server.on('upgrade', (req, socket, head) => {
-  if (req.url === '/ws') {
-    upgradeToWebSocket(req, socket);
-  } else {
-    socket.destroy();
-  }
-});
-
 server.listen(PORT, () => {
   console.log(`UV Suite Watchtower running at http://localhost:${PORT}`);
   console.log(`${events.length} events loaded from disk`);