uv-suite 0.20.0 → 0.22.0

package/hooks/watchtower-send.sh

@@ -1,24 +1,37 @@
 #!/bin/bash
 # UV Suite Hook Helper: Send event to Watchtower server
-# Called by other hooks. Non-blocking. Fails silently if server not running.
+# Called by other hooks or directly from persona hook config.
+# Non-blocking. Fails silently if server not running.
 #
-# Usage: echo "$INPUT" | .claude/hooks/watchtower-send.sh "EventType"
+# Usage from hook config:
+#   "command": ".claude/hooks/watchtower-send.sh PostToolUse"
+# The hook input JSON comes via stdin from Claude Code.
 
 EVENT_TYPE="${1:-Unknown}"
 INPUT=$(cat)
 WATCHTOWER_URL="${UVS_WATCHTOWER_URL:-http://localhost:4200}"
 
-# Extract useful fields from the hook input
-SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
-TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty' 2>/dev/null)
-TOOL_INPUT=$(echo "$INPUT" | jq -c '.tool_input // {}' 2>/dev/null)
-CWD=$(echo "$INPUT" | jq -r '.cwd // empty' 2>/dev/null)
-SOURCE_APP=$(basename "$CWD" 2>/dev/null)
+# Forward the full hook input to the watchtower, adding event_type and source_app
+# jq merges the original JSON with our extra fields
+PAYLOAD=$(echo "$INPUT" | jq -c ". + {
+  event_type: \"$EVENT_TYPE\",
+  source_app: (.cwd // \"\" | split(\"/\") | last),
+  _hook_ts: now
+}" 2>/dev/null)
+
+# Fallback if jq isn't available or fails
+if [ -z "$PAYLOAD" ] || [ "$PAYLOAD" = "null" ]; then
+  SESSION_ID=$(echo "$INPUT" | grep -o '"session_id":"[^"]*"' | head -1 | cut -d'"' -f4)
+  TOOL_NAME=$(echo "$INPUT" | grep -o '"tool_name":"[^"]*"' | head -1 | cut -d'"' -f4)
+  CWD=$(echo "$INPUT" | grep -o '"cwd":"[^"]*"' | head -1 | cut -d'"' -f4)
+  SOURCE_APP=$(basename "$CWD" 2>/dev/null)
+  PAYLOAD="{\"event_type\":\"$EVENT_TYPE\",\"session_id\":\"$SESSION_ID\",\"source_app\":\"$SOURCE_APP\",\"tool_name\":\"$TOOL_NAME\",\"cwd\":\"$CWD\"}"
+fi
 
 # Send to watchtower (non-blocking, fire-and-forget)
 curl -s -X POST "$WATCHTOWER_URL/events" \
   -H "Content-Type: application/json" \
-  -d "{\"event_type\":\"$EVENT_TYPE\",\"session_id\":\"$SESSION_ID\",\"source_app\":\"$SOURCE_APP\",\"tool_name\":\"$TOOL_NAME\",\"tool_input\":$TOOL_INPUT,\"cwd\":\"$CWD\"}" \
+  -d "$PAYLOAD" \
   &>/dev/null &
 
 exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.20.0",
+  "version": "0.22.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/personas/auto.json

@@ -54,7 +54,16 @@
       {
         "matcher": "*",
         "hooks": [
-          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 }
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 },
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh SessionStart", "timeout": 2, "async": true }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh UserPromptSubmit", "timeout": 2, "async": true }
         ]
       }
     ],

package/personas/professional.json

@@ -56,6 +56,25 @@
             "type": "command",
             "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh SessionStart",
+            "timeout": 2,
+            "async": true
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh UserPromptSubmit",
+            "timeout": 2,
+            "async": true
           }
         ]
       }

package/personas/spike.json

@@ -40,7 +40,16 @@
       {
         "matcher": "*",
         "hooks": [
-          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 }
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 },
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh SessionStart", "timeout": 2, "async": true }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh UserPromptSubmit", "timeout": 2, "async": true }
         ]
       }
     ],

package/personas/sport.json

@@ -26,7 +26,16 @@
       {
         "matcher": "*",
         "hooks": [
-          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 }
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/session-start.sh", "timeout": 5 },
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh SessionStart", "timeout": 2, "async": true }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          { "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/watchtower-send.sh UserPromptSubmit", "timeout": 2, "async": true }
         ]
       }
     ],

package/watchtower/dashboard.html

@@ -23,20 +23,35 @@
   .stat { text-align: center; }
   .stat .n { font-size: 20px; font-weight: 600; }
   .stat .l { font-size: 10px; color: #86868b; text-transform: uppercase; letter-spacing: 0.5px; margin-top: 2px; }
+  .stat .n.alert { color: #ff375f; }
 
   .sessions { padding: 12px 24px; border-bottom: 1px solid #1d1d1f; display: flex; gap: 8px; flex-wrap: wrap; }
   .session-tag { padding: 3px 10px; border-radius: 12px; font-size: 11px; font-weight: 500; cursor: pointer; border: 1px solid transparent; }
   .session-tag:hover { border-color: #424245; }
   .session-tag.active { border-color: #fff; }
 
-  .timeline { padding: 8px 0; overflow-y: auto; max-height: calc(100vh - 220px); }
-  .event { padding: 6px 24px; display: grid; grid-template-columns: 70px 100px 120px 1fr 80px; gap: 8px; align-items: center; font-size: 12px; border-bottom: 1px solid #0d0d0d; }
+  .timeline { padding: 8px 0; overflow-y: auto; max-height: calc(100vh - 240px); }
+  .event { padding: 8px 24px; display: grid; grid-template-columns: 70px 110px 120px 60px 1fr; gap: 8px; align-items: start; font-size: 12px; border-bottom: 1px solid #0d0d0d; transition: background 0.15s; }
   .event:hover { background: #0d0d0d; }
   .event .time { color: #6e6e73; font-variant-numeric: tabular-nums; font-family: 'SF Mono', monospace; font-size: 11px; }
   .event .type { font-weight: 500; }
   .event .session { font-size: 11px; border-radius: 8px; padding: 1px 8px; display: inline-block; }
-  .event .detail { color: #a1a1a6; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-  .event .duration { color: #6e6e73; font-family: 'SF Mono', monospace; font-size: 11px; text-align: right; }
+  .event .tool { color: #a1a1a6; font-family: 'SF Mono', monospace; font-size: 11px; }
+  .event .detail { color: #a1a1a6; font-size: 11px; line-height: 1.4; }
+  .event .detail .filepath { color: #64d2ff; }
+  .event .detail .cmd { color: #ffd60a; }
+
+  /* Human intervention — pulsing highlight */
+  .event.needs-human { background: #ff375f12; border-left: 3px solid #ff375f; }
+  .event.needs-human .type { color: #ff375f; }
+  .event.needs-human::after { content: 'NEEDS HUMAN'; position: absolute; right: 24px; font-size: 9px; font-weight: 700; color: #ff375f; letter-spacing: 0.5px; }
+  .event.needs-human { position: relative; }
+
+  /* Failure highlight */
+  .event.failure { background: #ff696112; border-left: 3px solid #ff6961; }
+
+  /* Session start/end highlight */
+  .event.session-boundary { background: #30d15808; }
 
   .empty { padding: 60px 24px; text-align: center; color: #6e6e73; }
   .empty p { margin-top: 8px; font-size: 13px; }
@@ -67,6 +82,7 @@
   <div class="stat"><div class="n" id="eventCount">0</div><div class="l">Events</div></div>
   <div class="stat"><div class="n" id="toolCount">0</div><div class="l">Tool calls</div></div>
   <div class="stat"><div class="n" id="errorCount">0</div><div class="l">Errors</div></div>
+  <div class="stat"><div class="n" id="humanCount">0</div><div class="l">Need human</div></div>
 </div>
 
 <div class="sessions" id="sessionBar"></div>
@@ -74,6 +90,7 @@
 <div class="filters">
   <select id="filterType"><option value="">All events</option></select>
   <select id="filterSession"><option value="">All sessions</option></select>
+  <button id="btnHumanOnly" onclick="toggleHumanOnly()">Human needed</button>
   <button id="btnClear" onclick="clearEvents()">Clear</button>
   <button id="btnAutoScroll" class="active" onclick="toggleAutoScroll()">Auto-scroll</button>
 </div>
@@ -97,16 +114,16 @@ const sessionBar = document.getElementById('sessionBar');
 let events = [];
 let sessions = {};
 let autoScroll = true;
+let humanOnly = false;
 let selectedSession = '';
 let selectedType = '';
-let ws;
 
-// Session colors
+// Session colors and naming
 const palette = ['#0a84ff','#30d158','#ff9f0a','#bf5af2','#ff375f','#64d2ff','#ffd60a','#ac8ee0','#ff6961','#5e5ce6'];
 let colorIdx = 0;
 function sessionColor(id) {
   if (!sessions[id]) {
-    sessions[id] = { color: palette[colorIdx++ % palette.length], count: 0, lastEvent: null };
+    sessions[id] = { color: palette[colorIdx++ % palette.length], count: 0, lastEvent: null, label: null, app: null };
     updateSessionBar();
     updateFilterSession();
   }
@@ -115,41 +132,145 @@ function sessionColor(id) {
   return sessions[id].color;
 }
 
+// Build a meaningful session label from the first user prompt or app name
+function updateSessionLabel(sid, ev) {
+  if (!sessions[sid]) return;
+  // Capture source_app as fallback name
+  if (!sessions[sid].app && ev.source_app) {
+    sessions[sid].app = ev.source_app;
+  }
+  // Use first UserPromptSubmit content as the session label
+  if (!sessions[sid].label && ev.event_type === 'UserPromptSubmit') {
+    const prompt = ev.tool_input?.prompt || ev.tool_input?.content || ev.message || '';
+    if (prompt.length > 0) {
+      // Take first 40 chars, trim to last word boundary
+      let label = prompt.slice(0, 40).replace(/\s+\S*$/, '');
+      if (prompt.length > label.length) label += '...';
+      sessions[sid].label = label;
+      updateSessionBar();
+      updateFilterSession();
+    }
+  }
+}
+
+function sessionDisplayName(id) {
+  const s = sessions[id];
+  if (!s) return shortId(id);
+  if (s.label) return s.label;
+  if (s.app) return s.app;
+  return shortId(id);
+}
+
+function shortId(id) {
+  if (!id) return '—';
+  return id.length > 10 ? id.slice(0, 8) + '..' : id;
+}
+
 function formatTime(ts) {
   const d = new Date(ts);
   return d.toLocaleTimeString('en-US', { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' });
 }
 
 function shortSession(id) {
-  if (!id) return '—';
-  return id.length > 12 ? id.slice(0, 8) + '...' : id;
+  return sessionDisplayName(id);
 }
 
+// Detect if event needs human intervention
+function needsHuman(ev) {
+  const type = ev.event_type || ev.hook_event_name || '';
+  // Permission requests always need human
+  if (type === 'PermissionRequest') return true;
+  // Notifications that are permission prompts
+  if (type === 'Notification' && ev.notification_type === 'permission_prompt') return true;
+  // Tool failures after multiple attempts
+  if (type === 'PostToolUseFailure') return true;
+  // Stuck indicators in messages
+  if (ev.message && /stuck|blocked|escalat|need.*help|can.?t.*find/i.test(ev.message)) return true;
+  return false;
+}
+
+function isFailure(ev) {
+  const type = ev.event_type || ev.hook_event_name || '';
+  return type.includes('Failure') || type === 'StopFailure';
+}
+
+function isSessionBoundary(ev) {
+  const type = ev.event_type || ev.hook_event_name || '';
+  return type === 'SessionStart' || type === 'SessionEnd' || type === 'Stop';
+}
+
+// Build rich detail string
 function eventDetail(ev) {
-  if (ev.tool_name) return ev.tool_name + (ev.tool_input?.command ? ': ' + ev.tool_input.command.slice(0, 60) : '');
-  if (ev.tool_input?.file_path) return ev.tool_input.file_path;
-  if (ev.source_app) return ev.source_app;
-  if (ev.message) return ev.message;
-  return '';
+  const parts = [];
+  const tool = ev.tool_name || '';
+  const input = ev.tool_input || {};
+
+  if (tool === 'Read' && input.file_path) {
+    parts.push(`<span class="filepath">${input.file_path}</span>`);
+    if (input.offset) parts.push(`offset:${input.offset}`);
+    if (input.limit) parts.push(`limit:${input.limit}`);
+  } else if (tool === 'Write' && input.file_path) {
+    parts.push(`<span class="filepath">${input.file_path}</span>`);
+    if (input.content) parts.push(`(${input.content.length} chars)`);
+  } else if (tool === 'Edit' && input.file_path) {
+    parts.push(`<span class="filepath">${input.file_path}</span>`);
+    if (input.old_string) parts.push(`replacing "${input.old_string.slice(0, 30)}..."`);
+  } else if (tool === 'Bash' && input.command) {
+    parts.push(`<span class="cmd">$ ${input.command.slice(0, 80)}</span>`);
+    if (input.timeout) parts.push(`timeout:${input.timeout}ms`);
+  } else if (tool === 'Grep' && input.pattern) {
+    parts.push(`pattern: "${input.pattern}"`);
+    if (input.path) parts.push(`in <span class="filepath">${input.path}</span>`);
+  } else if (tool === 'Glob' && input.pattern) {
+    parts.push(`<span class="filepath">${input.pattern}</span>`);
+  } else if (tool === 'Agent') {
+    parts.push(input.description || input.prompt?.slice(0, 60) || 'subagent');
+  } else if (tool === 'WebSearch' && input.query) {
+    parts.push(`"${input.query.slice(0, 60)}"`);
+  } else if (tool === 'WebFetch' && input.url) {
+    parts.push(`<span class="filepath">${input.url.slice(0, 60)}</span>`);
+  } else if (ev.message) {
+    parts.push(ev.message.slice(0, 80));
+  } else if (input.file_path) {
+    parts.push(`<span class="filepath">${input.file_path}</span>`);
+  } else if (input.command) {
+    parts.push(`<span class="cmd">$ ${input.command.slice(0, 60)}</span>`);
+  } else if (ev.source_app) {
+    parts.push(ev.source_app);
+  }
+
+  return parts.join(' ');
 }
 
 function renderEvent(ev) {
   const sid = ev.session_id || ev.source_app || 'unknown';
   const color = sessionColor(sid);
+  const type = ev.event_type || ev.hook_event_name || '?';
+  const tool = ev.tool_name || '';
+  const human = needsHuman(ev);
+  const fail = isFailure(ev);
+  const boundary = isSessionBoundary(ev);
+
   const div = document.createElement('div');
-  div.className = 'event';
+  let cls = 'event';
+  if (human) cls += ' needs-human';
+  else if (fail) cls += ' failure';
+  else if (boundary) cls += ' session-boundary';
+  div.className = cls;
+
   div.innerHTML = `
     <span class="time">${formatTime(ev._ts)}</span>
-    <span class="type type-${ev.event_type || ev.hook_event_name || ''}">${ev.event_type || ev.hook_event_name || '?'}</span>
+    <span class="type type-${type}">${type}</span>
     <span class="session" style="background:${color}22;color:${color}">${shortSession(sid)}</span>
-    <span class="detail" title="${eventDetail(ev)}">${eventDetail(ev)}</span>
-    <span class="duration">${ev.duration_ms ? ev.duration_ms + 'ms' : ''}</span>
+    <span class="tool">${tool}</span>
+    <span class="detail">${eventDetail(ev)}</span>
   `;
 
   // Check filters
-  const typeMatch = !selectedType || (ev.event_type || ev.hook_event_name) === selectedType;
+  const typeMatch = !selectedType || type === selectedType;
   const sessMatch = !selectedSession || sid === selectedSession;
-  if (!typeMatch || !sessMatch) div.style.display = 'none';
+  const humanMatch = !humanOnly || human;
+  if (!typeMatch || !sessMatch || !humanMatch) div.style.display = 'none';
 
   return div;
 }
@@ -157,6 +278,8 @@ function renderEvent(ev) {
 function addEvent(ev) {
   events.push(ev);
   if (emptyState.parentNode) emptyState.remove();
+  const sid = ev.session_id || ev.source_app || 'unknown';
+  updateSessionLabel(sid, ev);
   timeline.appendChild(renderEvent(ev));
   updateStats();
   updateFilterType(ev);
@@ -167,7 +290,12 @@ function updateStats() {
   document.getElementById('sessionCount').textContent = Object.keys(sessions).length;
   document.getElementById('eventCount').textContent = events.length;
   document.getElementById('toolCount').textContent = events.filter(e => (e.event_type || e.hook_event_name || '').includes('ToolUse')).length;
-  document.getElementById('errorCount').textContent = events.filter(e => (e.event_type || e.hook_event_name || '').includes('Failure')).length;
+  const errors = events.filter(e => (e.event_type || e.hook_event_name || '').includes('Failure')).length;
+  document.getElementById('errorCount').textContent = errors;
+  document.getElementById('errorCount').className = 'n' + (errors > 0 ? ' alert' : '');
+  const humans = events.filter(needsHuman).length;
+  document.getElementById('humanCount').textContent = humans;
+  document.getElementById('humanCount').className = 'n' + (humans > 0 ? ' alert' : '');
 }
 
 function updateSessionBar() {
@@ -211,7 +339,9 @@ function refilter() {
     const ev = events[i];
     const sid = ev.session_id || ev.source_app || 'unknown';
     const type = ev.event_type || ev.hook_event_name || '';
-    const show = (!selectedType || type === selectedType) && (!selectedSession || sid === selectedSession);
+    const show = (!selectedType || type === selectedType)
+              && (!selectedSession || sid === selectedSession)
+              && (!humanOnly || needsHuman(ev));
     row.style.display = show ? '' : 'none';
   });
 }
@@ -224,8 +354,13 @@ function toggleAutoScroll() {
   autoScroll = !autoScroll;
   document.getElementById('btnAutoScroll').classList.toggle('active', autoScroll);
 }
+function toggleHumanOnly() {
+  humanOnly = !humanOnly;
+  document.getElementById('btnHumanOnly').classList.toggle('active', humanOnly);
+  refilter();
+}
 
-// Server-Sent Events connection (replaces WebSocket — simpler, auto-reconnects)
+// Server-Sent Events connection
 function connect() {
   const source = new EventSource('/stream');
 
@@ -237,7 +372,6 @@ function connect() {
   source.onerror = () => {
     statusDot.className = 'dot off';
     statusText.textContent = 'Reconnecting...';
-    // EventSource auto-reconnects — no manual retry needed
   };
 
   source.onmessage = (msg) => {
@@ -248,9 +382,7 @@ function connect() {
       } else {
         addEvent(data);
       }
-    } catch (e) {
-      // ignore parse errors (ping frames, etc.)
-    }
+    } catch (e) {}
   };
 }