uv-suite 0.27.0 → 0.29.0

package/watchtower/dashboard.html

@@ -305,7 +305,12 @@
   .pill.priority-high { background: rgba(255, 69, 58, 0.18);   color: var(--danger); }
   .pill.kind-long-running { background: rgba(100, 210, 255, 0.18); color: var(--info); }
   .pill.kind-outcome      { background: rgba(255, 105, 97, 0.18);  color: var(--peach); }
+  .pill.lifecycle-active     { background: rgba(48, 209, 88, 0.18);  color: var(--success); }
+  .pill.lifecycle-idle       { background: rgba(154, 154, 163, 0.18); color: var(--text-muted); }
+  .pill.lifecycle-terminated { background: rgba(255, 69, 58, 0.16);   color: var(--danger); }
 
+  .session-tag.lifecycle-terminated { opacity: 0.55; }
+  .session-tag.lifecycle-terminated strong { text-decoration: line-through; }
   .session-tag.priority-low  { opacity: 0.6; }
   .session-tag .meta-line {
     display: block;
@@ -404,6 +409,124 @@
     font-size: 12px;
     margin-left: 8px;
   }
+
+  /* Header buttons (snapshot, snapshots-list) */
+  .header-btn {
+    background: transparent;
+    color: var(--text-muted);
+    border: 1px solid var(--border);
+    border-radius: 7px;
+    height: 30px;
+    padding: 0 12px;
+    font-size: 13px;
+    font-family: inherit;
+    cursor: pointer;
+    transition: color 0.15s ease, border-color 0.15s ease, background-color 0.15s ease;
+  }
+  .header-btn:hover { color: var(--text); border-color: var(--text-dim); background: var(--surface); }
+  .header-btn.primary { background: var(--accent); color: var(--accent-contrast); border-color: var(--accent); }
+  .header-btn.primary:hover { opacity: 0.9; }
+  .header-btn:disabled { opacity: 0.5; cursor: not-allowed; }
+
+  /* Snapshots modal overlay */
+  .modal-overlay {
+    position: fixed;
+    inset: 0;
+    background: rgba(0,0,0,0.45);
+    display: none;
+    align-items: center;
+    justify-content: center;
+    z-index: 100;
+  }
+  .modal-overlay.open { display: flex; }
+  .modal {
+    background: var(--bg);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    width: 720px;
+    max-width: 92vw;
+    max-height: 80vh;
+    overflow: hidden;
+    display: flex;
+    flex-direction: column;
+  }
+  .modal-header {
+    padding: 16px 20px;
+    border-bottom: 1px solid var(--border-subtle);
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+  }
+  .modal-header h2 { font-size: 16px; font-weight: 600; }
+  .modal-body { padding: 16px 20px; overflow-y: auto; flex: 1; }
+  .modal-close {
+    background: transparent;
+    color: var(--text-dim);
+    border: none;
+    font-size: 22px;
+    cursor: pointer;
+    line-height: 1;
+  }
+  .modal-close:hover { color: var(--text); }
+
+  .snapshot-list { display: flex; flex-direction: column; gap: 8px; }
+  .snapshot-row {
+    padding: 12px 14px;
+    border: 1px solid var(--border-subtle);
+    border-radius: 7px;
+    cursor: pointer;
+    transition: background-color 0.15s ease, border-color 0.15s ease;
+  }
+  .snapshot-row:hover { background: var(--surface); border-color: var(--text-dim); }
+  .snapshot-row .id { font-family: var(--font-mono); font-size: 12.5px; color: var(--text-muted); }
+  .snapshot-row .meta { display: flex; justify-content: space-between; align-items: center; }
+
+  .snapshot-detail .sess-row {
+    margin-bottom: 14px;
+    padding: 12px 14px;
+    border: 1px solid var(--border-subtle);
+    border-radius: 7px;
+  }
+  .snapshot-detail .sess-row .head {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 6px;
+    gap: 8px;
+  }
+  .snapshot-detail .sess-row .name { font-weight: 600; }
+  .snapshot-detail .sess-row .preview {
+    color: var(--text-muted);
+    font-size: 12.5px;
+    line-height: 1.55;
+    white-space: pre-wrap;
+    max-height: 100px;
+    overflow-y: auto;
+  }
+  .snapshot-toast {
+    position: fixed;
+    bottom: 20px;
+    right: 20px;
+    background: var(--surface);
+    border: 1px solid var(--border);
+    color: var(--text);
+    padding: 10px 14px;
+    border-radius: 7px;
+    font-size: 13px;
+    box-shadow: 0 4px 12px rgba(0,0,0,0.25);
+    display: none;
+    z-index: 200;
+    max-width: 480px;
+  }
+  .snapshot-toast.show { display: block; }
+  .snapshot-toast pre {
+    margin-top: 6px;
+    padding: 8px;
+    background: var(--bg);
+    border-radius: 4px;
+    font-size: 11.5px;
+    overflow-x: auto;
+  }
 </style>
 </head>
 <body>
@@ -412,6 +535,8 @@
   <h1>UV Suite Watchtower</h1>
   <div class="meta">
     <div class="status"><span class="dot" id="statusDot"></span><span id="statusText">Connecting...</span></div>
+    <button class="header-btn primary" id="btnSnapshot" type="button" title="Snapshot every active session now">Snapshot all</button>
+    <button class="header-btn" id="btnSnapshotsList" type="button" title="Open the list of past snapshots">Snapshots…</button>
     <button class="theme-toggle" id="themeToggle" type="button" aria-label="Toggle theme" title="Toggle theme">
       <svg class="icon-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
         <circle cx="12" cy="12" r="4"/>
@@ -454,6 +579,18 @@
   </div>
 </div>
 
+<div class="modal-overlay" id="snapshotsModal">
+  <div class="modal">
+    <div class="modal-header">
+      <h2 id="snapshotsModalTitle">Snapshots</h2>
+      <button class="modal-close" id="snapshotsModalClose" type="button" aria-label="Close">×</button>
+    </div>
+    <div class="modal-body" id="snapshotsModalBody"></div>
+  </div>
+</div>
+
+<div class="snapshot-toast" id="snapshotToast"></div>
+
 
 <script>
 const timeline = document.getElementById('timeline');
@@ -487,9 +624,10 @@ function sessionColor(id) {
   if (!sessions[id]) {
     sessions[id] = {
       color: palette[colorIdx++ % palette.length],
-      count: 0, lastEvent: null,
+      count: 0, lastEvent: null, lastEventTs: 0,
       name: '', kind: '', purpose: '', priority: '', persona: '',
       app: null, label: null,
+      terminated: false, terminatedAt: 0,
     };
     updateSessionBar();
     updateFilterSession();
@@ -505,6 +643,7 @@ function updateSessionLabel(sid, ev) {
   let changed = false;
 
   if (!s.app && ev.source_app) { s.app = ev.source_app; changed = true; }
+  if (ev._ts && ev._ts > (s.lastEventTs || 0)) s.lastEventTs = ev._ts;
 
   // Configured metadata wins over heuristics. Update on every event so a
   // mid-session /session-init relabel is reflected without a refresh.
@@ -519,8 +658,17 @@ function updateSessionLabel(sid, ev) {
     }
   }
 
-  // Fall back to first UserPromptSubmit if no configured name yet
+  // Lifecycle: a session is Terminated when we receive Stop / SessionEnd
+  // (Claude Code's natural exit signal) OR when ev.lifecycle === 'terminated'
+  // (the /session-end slash command). Time-idleness alone does NOT terminate.
   const type = ev.event_type || ev.hook_event_name || '';
+  if (!s.terminated && (type === 'Stop' || type === 'SessionEnd' || ev.lifecycle === 'terminated')) {
+    s.terminated = true;
+    s.terminatedAt = ev._ts || Date.now();
+    changed = true;
+  }
+
+  // Fall back to first UserPromptSubmit if no configured name yet
   if (!s.name && !s.label && type === 'UserPromptSubmit') {
     const prompt = ev.tool_input?.prompt || ev.tool_input?.content || ev.message || '';
     if (prompt.length > 0) {
@@ -537,6 +685,16 @@ function updateSessionLabel(sid, ev) {
   }
 }
 
+// Active = event in last ACTIVE_WINDOW_MS; Terminated = explicit signal seen;
+// Idle = anything else (including long-running sessions sitting dormant).
+const ACTIVE_WINDOW_MS = 5 * 60 * 1000;
+function sessionStatus(s) {
+  if (!s) return 'idle';
+  if (s.terminated) return 'terminated';
+  if ((Date.now() - (s.lastEventTs || 0)) <= ACTIVE_WINDOW_MS) return 'active';
+  return 'idle';
+}
+
 function sessionDisplayName(id) {
   const s = sessions[id];
   if (!s) return shortId(id);
@@ -744,6 +902,10 @@ setInterval(() => {
   if (events.length > 0) updateWaitingText(events[events.length - 1]);
 }, 5000);
 
+// Refresh the session bar periodically so Active→Idle transitions show up
+// without requiring a new event to arrive.
+setInterval(updateSessionBar, 30000);
+
 function updateStats() {
   document.getElementById('sessionCount').textContent = Object.keys(sessions).length;
   document.getElementById('eventCount').textContent = events.length;
@@ -771,11 +933,18 @@ function pill(cls, label) {
   return `<span class="pill ${cls}">${escapeHtml(label)}</span>`;
 }
 
+// Lifecycle sort: active first, then idle, terminated last.
+const LIFECYCLE_ORDER = { active: 0, idle: 1, terminated: 2 };
+
 function updateSessionBar() {
   sessionBar.innerHTML = '';
-  // Sort: high priority first, then med/unset, then low; within a tier, most
-  // recent activity wins so the dashboard surfaces what's happening now.
+  // Sort: lifecycle (active → idle → terminated) trumps priority (high → low),
+  // then most-recent activity. So a high-priority terminated session sits
+  // below a low-priority active one — what's running now matters more.
   const ids = Object.keys(sessions).sort((a, b) => {
+    const la = LIFECYCLE_ORDER[sessionStatus(sessions[a])];
+    const lb = LIFECYCLE_ORDER[sessionStatus(sessions[b])];
+    if (la !== lb) return la - lb;
     const pa = PRIORITY_ORDER[sessions[a].priority] ?? PRIORITY_ORDER[''];
     const pb = PRIORITY_ORDER[sessions[b].priority] ?? PRIORITY_ORDER[''];
     if (pa !== pb) return pa - pb;
@@ -784,16 +953,19 @@ function updateSessionBar() {
 
   for (const id of ids) {
     const s = sessions[id];
+    const lifecycle = sessionStatus(s);
     const tag = document.createElement('span');
     let cls = 'session-tag';
     if (selectedSession === id) cls += ' active';
     if (s.priority === 'low')   cls += ' priority-low';
+    cls += ' lifecycle-' + lifecycle;
     tag.className = cls;
     tag.style.background = s.color + '22';
     tag.style.color = s.color;
     tag.title = `${id}${s.purpose ? '\n' + s.purpose : ''}`;
 
     const pills = [];
+    pills.push(pill('lifecycle-' + lifecycle, lifecycle));
     if (s.persona)  pills.push(pill('persona-' + s.persona, s.persona));
     if (s.priority) pills.push(pill('priority-' + s.priority, 'P:' + s.priority));
     if (s.kind)     pills.push(pill('kind-' + s.kind, s.kind));
@@ -905,6 +1077,135 @@ mql.addEventListener('change', () => {
   if (!localStorage.getItem(THEME_KEY)) applyTheme(resolvedTheme());
 });
 
+// --- Snapshot + Restore UI ---
+const btnSnapshot = document.getElementById('btnSnapshot');
+const btnSnapshotsList = document.getElementById('btnSnapshotsList');
+const snapshotsModal = document.getElementById('snapshotsModal');
+const snapshotsModalTitle = document.getElementById('snapshotsModalTitle');
+const snapshotsModalBody = document.getElementById('snapshotsModalBody');
+const snapshotsModalClose = document.getElementById('snapshotsModalClose');
+const snapshotToast = document.getElementById('snapshotToast');
+
+function showToast(html, ms = 5000) {
+  snapshotToast.innerHTML = html;
+  snapshotToast.classList.add('show');
+  clearTimeout(showToast._t);
+  showToast._t = setTimeout(() => snapshotToast.classList.remove('show'), ms);
+}
+
+function openModal() { snapshotsModal.classList.add('open'); }
+function closeModal() { snapshotsModal.classList.remove('open'); }
+snapshotsModalClose.onclick = closeModal;
+snapshotsModal.onclick = (e) => { if (e.target === snapshotsModal) closeModal(); };
+
+btnSnapshot.onclick = async () => {
+  btnSnapshot.disabled = true;
+  btnSnapshot.textContent = 'Snapshotting…';
+  try {
+    const r = await fetch('/snapshots', { method: 'POST' });
+    if (!r.ok) throw new Error('snapshot request failed: ' + r.status);
+    const manifest = await r.json();
+    showToast(`Snapshot <strong>${escapeHtml(manifest.id)}</strong> captured: ${manifest.sessions.length} active session${manifest.sessions.length === 1 ? '' : 's'}.`);
+  } catch (err) {
+    showToast(`Snapshot failed: ${escapeHtml(err.message)}`);
+  } finally {
+    btnSnapshot.disabled = false;
+    btnSnapshot.textContent = 'Snapshot all';
+  }
+};
+
+btnSnapshotsList.onclick = async () => {
+  snapshotsModalTitle.textContent = 'Snapshots';
+  snapshotsModalBody.innerHTML = '<p style="color:var(--text-muted)">Loading…</p>';
+  openModal();
+  try {
+    const r = await fetch('/snapshots');
+    const list = await r.json();
+    if (!list.length) {
+      snapshotsModalBody.innerHTML = '<p style="color:var(--text-muted)">No snapshots yet. Click "Snapshot all" in the header to take one.</p>';
+      return;
+    }
+    const rows = list.map(s => `
+      <div class="snapshot-row" data-id="${escapeHtml(s.id)}">
+        <div class="meta">
+          <span class="id">${escapeHtml(s.id)}</span>
+          <span style="color:var(--text-muted); font-size:12.5px">${s.session_count} session${s.session_count === 1 ? '' : 's'}</span>
+        </div>
+        <div style="color:var(--text-dim); font-size:12px; margin-top:4px">${new Date(s.created_at).toLocaleString()}</div>
+      </div>
+    `).join('');
+    snapshotsModalBody.innerHTML = `<div class="snapshot-list">${rows}</div>`;
+    snapshotsModalBody.querySelectorAll('.snapshot-row').forEach(row => {
+      row.onclick = () => openSnapshotDetail(row.dataset.id);
+    });
+  } catch (err) {
+    snapshotsModalBody.innerHTML = `<p style="color:var(--danger)">Failed to load snapshots: ${escapeHtml(err.message)}</p>`;
+  }
+};
+
+async function openSnapshotDetail(id) {
+  snapshotsModalTitle.textContent = 'Snapshot ' + id;
+  snapshotsModalBody.innerHTML = '<p style="color:var(--text-muted)">Loading…</p>';
+  try {
+    const r = await fetch('/snapshots/' + encodeURIComponent(id));
+    if (!r.ok) throw new Error('snapshot not found');
+    const m = await r.json();
+    if (!m.sessions || m.sessions.length === 0) {
+      snapshotsModalBody.innerHTML = '<p style="color:var(--text-muted)">No active sessions were captured in this snapshot.</p>';
+      return;
+    }
+    const restoreAll = `<button class="header-btn primary" id="btnRestoreAll" type="button">Restore all (${m.sessions.length})</button>`;
+    const back = `<button class="header-btn" id="btnBackToSnapshots" type="button">← Back to list</button>`;
+    const sessions = m.sessions.map(s => `
+      <div class="sess-row" data-sid="${escapeHtml(s.uvs_session_id)}">
+        <div class="head">
+          <div>
+            <span class="name">${escapeHtml(s.name || '(unlabeled)')}</span>
+            <span style="color:var(--text-dim); font-size:12px; margin-left:8px">${escapeHtml((s.uvs_session_id || '').slice(0,8))}</span>
+            <span class="pill persona-${escapeHtml(s.persona || '')}" style="margin-left:6px">${escapeHtml(s.persona || '?')}</span>
+            ${s.priority ? `<span class="pill priority-${escapeHtml(s.priority)}">P:${escapeHtml(s.priority)}</span>` : ''}
+          </div>
+          <button class="header-btn restore-btn" type="button">Open in new terminal</button>
+        </div>
+        <div style="color:var(--text-dim); font-size:12px; margin-bottom:6px">${escapeHtml(s.cwd || '')}${s.purpose ? ' — ' + escapeHtml(s.purpose) : ''}</div>
+        <div class="preview">${s.summary_preview ? escapeHtml(s.summary_preview) : '<em style="color:var(--text-dim)">(no checkpoint summary yet)</em>'}</div>
+      </div>
+    `).join('');
+    snapshotsModalBody.innerHTML = `
+      <div style="display:flex; justify-content:space-between; margin-bottom:14px">${back}${restoreAll}</div>
+      <div class="snapshot-detail">${sessions}</div>
+    `;
+
+    document.getElementById('btnBackToSnapshots').onclick = () => btnSnapshotsList.onclick();
+    document.getElementById('btnRestoreAll').onclick = () => {
+      m.sessions.forEach(s => restoreSession(id, s.uvs_session_id));
+    };
+    snapshotsModalBody.querySelectorAll('.sess-row').forEach(row => {
+      row.querySelector('.restore-btn').onclick = () => restoreSession(id, row.dataset.sid);
+    });
+  } catch (err) {
+    snapshotsModalBody.innerHTML = `<p style="color:var(--danger)">Failed to load: ${escapeHtml(err.message)}</p>`;
+  }
+}
+
+async function restoreSession(snapshotId, sid) {
+  try {
+    const r = await fetch(`/snapshots/${encodeURIComponent(snapshotId)}/sessions/${encodeURIComponent(sid)}/restore`, { method: 'POST' });
+    const result = await r.json();
+    if (result.ok) {
+      showToast(`Opened new terminal for <strong>${escapeHtml(sid.slice(0,8))}</strong>.`);
+    } else {
+      // Fallback: show the copy-paste command
+      showToast(
+        `Couldn't auto-open a terminal on this platform (<code>${escapeHtml(result.platform)}</code>). Copy and run:<pre>${escapeHtml(result.command || '')}</pre>`,
+        12000,
+      );
+    }
+  } catch (err) {
+    showToast(`Restore failed: ${escapeHtml(err.message)}`);
+  }
+}
+
 connect();
 </script>
 </body>

package/watchtower/events.json

@@ -1 +1,74 @@
-[]
+[
+  {
+    "event_type": "PostToolUse",
+    "uvs_session_id": "snap-test-A",
+    "session_id": "cc-A",
+    "cwd": "/tmp/uvs-tierb-test",
+    "session_name": "snapshot test A",
+    "session_kind": "outcome",
+    "session_priority": "high",
+    "persona": "auto",
+    "tool_name": "Edit",
+    "_ts": 1778537691312,
+    "_id": "95a2a933-1f9e-4e0b-95fd-9e43fa8050a1"
+  },
+  {
+    "event_type": "PostToolUse",
+    "uvs_session_id": "snap-test-B",
+    "session_id": "cc-B",
+    "cwd": "/tmp/uvs-tierb-test",
+    "session_name": "snapshot test B",
+    "session_kind": "long-running",
+    "persona": "sport",
+    "tool_name": "Read",
+    "_ts": 1778537691332,
+    "_id": "0424ce0d-f8b5-4f7e-8ca2-60b23d8ebc11"
+  },
+  {
+    "event_type": "AutoCheckpoint",
+    "source_app": "uvs-tierb-test",
+    "cwd": "/tmp/uvs-tierb-test",
+    "uvs_session_id": "snap-test-A",
+    "session_id": "snap-test-A",
+    "session_name": "snapshot test A",
+    "session_kind": "outcome",
+    "session_priority": "high",
+    "persona": "auto",
+    "checkpoint_kind": "auto-semantic",
+    "checkpoint_path": "/tmp/uvs-tierb-test/uv-out/checkpoints/snap-test-A/auto-2026-05-11-2214-semantic.md",
+    "checkpoint_summary": "_(no conversation transcript available; only mechanical activity below)_",
+    "checkpoint_preview": "---\nuvs_session_id: snap-test-A\nsession_name: snapshot test A\nsession_kind: outcome\nsession_purpose: \nsession_priority: high\npersona: auto\ncheckpoint_at: 2026-05-11T22:14:51.348Z\ncheckpoint_kind: auto-semantic\ntranscript_messages: 0\ntool_calls_in_window: 1\n---\n# Auto-checkpoint (semantic): 2026-05-11T22:14:51.348Z\n\n## Summary\n\n_(no conversation transcript available; only mechanical activity below)_\n\n## Conversation\n\n_(no transcript content found; only mechanical activity captured below)_\n\n## Mechanical\n\n### Tool calls\n- 1× Edit\n\n## Git\n\n**Branch:** main\n\n**Status:**\n```\n?? .uv-suite-state/\n?? fakebin/\n?? parser-test.js\n?? tierB-test.js\n?? uv-out/\n```\n\n**Recent commits:**\n```\n09105d2 initial\n```\n",
+    "interval_minutes": 1,
+    "tool_calls_in_window": 1,
+    "transcript_messages": 0,
+    "_ts": 1778537691348,
+    "_id": "a5b91efb-8286-45eb-a98a-f6e51da816f4"
+  },
+  {
+    "event_type": "AutoCheckpoint",
+    "source_app": "uvs-tierb-test",
+    "cwd": "/tmp/uvs-tierb-test",
+    "uvs_session_id": "snap-test-B",
+    "session_id": "snap-test-B",
+    "session_name": "snapshot test B",
+    "session_kind": "long-running",
+    "session_priority": "",
+    "persona": "sport",
+    "checkpoint_kind": "auto-semantic",
+    "checkpoint_path": "/tmp/uvs-tierb-test/uv-out/checkpoints/snap-test-B/auto-2026-05-11-2214-semantic.md",
+    "checkpoint_summary": "_(no conversation transcript available; only mechanical activity below)_",
+    "checkpoint_preview": "---\nuvs_session_id: snap-test-B\nsession_name: snapshot test B\nsession_kind: long-running\nsession_purpose: \nsession_priority: \npersona: sport\ncheckpoint_at: 2026-05-11T22:14:51.451Z\ncheckpoint_kind: auto-semantic\ntranscript_messages: 0\ntool_calls_in_window: 1\n---\n# Auto-checkpoint (semantic): 2026-05-11T22:14:51.451Z\n\n## Summary\n\n_(no conversation transcript available; only mechanical activity below)_\n\n## Conversation\n\n_(no transcript content found; only mechanical activity captured below)_\n\n## Mechanical\n\n### Tool calls\n- 1× Read\n\n## Git\n\n**Branch:** main\n\n**Status:**\n```\n?? .uv-suite-state/\n?? fakebin/\n?? parser-test.js\n?? tierB-test.js\n?? uv-out/\n```\n\n**Recent commits:**\n```\n09105d2 initial\n```\n",
+    "interval_minutes": 1,
+    "tool_calls_in_window": 1,
+    "transcript_messages": 0,
+    "_ts": 1778537691451,
+    "_id": "6f09091b-1bf1-4bc8-bb02-2d6ab7badbb1"
+  },
+  {
+    "event_type": "SnapshotTaken",
+    "snapshot_id": "2026-05-11-22-1451",
+    "session_count": 2,
+    "_ts": 1778537691524,
+    "_id": "e2a54e27-92de-4f18-aa2c-6044d1adde7e"
+  }
+]

package/watchtower/server.js

@@ -9,6 +9,7 @@ const fs = require("fs");
 const path = require("path");
 const crypto = require("crypto");
 const autoCheckpointRunner = require("./auto-checkpoint-runner");
+const snapshotManager = require("./snapshot-manager");
 
 const PORT = process.env.UVS_WATCHTOWER_PORT || 4200;
 const DATA_FILE = path.join(__dirname, "events.json");
@@ -120,6 +121,68 @@ const server = http.createServer((req, res) => {
     return;
   }
 
+  // POST /snapshots — take a snapshot of every active session
+  if (req.method === "POST" && req.url === "/snapshots") {
+    (async () => {
+      try {
+        const manifest = await snapshotManager.takeSnapshot({
+          runner: autoCheckpointRunner,
+          getEvents: () => events,
+          broadcast: (ev) => {
+            ev._ts = ev._ts || Date.now();
+            ev._id = crypto.randomUUID();
+            events.push(ev);
+            broadcast(ev);
+            saveEvents();
+          },
+        });
+        res.writeHead(200, { "Content-Type": "application/json" });
+        res.end(JSON.stringify(manifest));
+      } catch (err) {
+        res.writeHead(500, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: err.message }));
+      }
+    })();
+    return;
+  }
+
+  // GET /snapshots — list bundles
+  if (req.method === "GET" && req.url === "/snapshots") {
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(snapshotManager.listSnapshots()));
+    return;
+  }
+
+  // GET /snapshots/<id> — get manifest
+  const snapshotMatch = req.url.match(/^\/snapshots\/([^/]+)$/);
+  if (req.method === "GET" && snapshotMatch) {
+    const m = snapshotManager.getSnapshot(snapshotMatch[1]);
+    if (!m) {
+      res.writeHead(404);
+      return res.end("not found");
+    }
+    res.writeHead(200, { "Content-Type": "application/json" });
+    return res.end(JSON.stringify(m));
+  }
+
+  // POST /snapshots/<id>/sessions/<sid>/restore — open a new terminal tab
+  // that restores the given session.
+  const restoreMatch = req.url.match(
+    /^\/snapshots\/([^/]+)\/sessions\/([^/]+)\/restore$/,
+  );
+  if (req.method === "POST" && restoreMatch) {
+    const [, snapId, sid] = restoreMatch;
+    const m = snapshotManager.getSnapshot(snapId);
+    const session = m?.sessions?.find((s) => s.uvs_session_id === sid);
+    if (!session) {
+      res.writeHead(404);
+      return res.end(JSON.stringify({ error: "session not in snapshot" }));
+    }
+    const result = snapshotManager.openTerminalForSession(session);
+    res.writeHead(200, { "Content-Type": "application/json" });
+    return res.end(JSON.stringify(result));
+  }
+
   // GET / — serve dashboard
   if (req.method === "GET" && (req.url === "/" || req.url === "/index.html")) {
     const html = fs.readFileSync(