@jhizzard/termdeck 0.3.0 → 0.3.1

package/packages/client/public/style.css

@@ -1432,6 +1432,343 @@
       border-color: var(--tg-accent);
     }
 
+    /* ===== HEALTH BADGE (Sprint 6 T4) ===== */
+    .health-badge {
+      display: inline-flex;
+      align-items: center;
+      gap: 5px;
+      font-family: var(--tg-mono);
+      font-size: 11px;
+      padding: 2px 8px;
+      border-radius: 10px;
+      border: 1px solid var(--tg-border);
+      background: var(--tg-surface);
+      color: var(--tg-text-dim);
+      cursor: pointer;
+      transition: all 0.15s;
+    }
+    .health-badge:hover {
+      color: var(--tg-text);
+      border-color: var(--tg-border-active);
+    }
+    .health-badge .hb-icon { font-size: 12px; line-height: 1; }
+    .health-badge.hb-green {
+      color: var(--tg-green);
+      border-color: rgba(158, 206, 106, 0.3);
+    }
+    .health-badge.hb-amber {
+      color: var(--tg-amber);
+      border-color: var(--tg-amber);
+      background: rgba(224, 175, 104, 0.08);
+      animation: health-pulse 2s ease-in-out infinite;
+    }
+    .health-badge.hb-red {
+      color: var(--tg-red);
+      border-color: var(--tg-red);
+      background: rgba(247, 118, 142, 0.08);
+      animation: health-pulse 2s ease-in-out infinite;
+    }
+    @keyframes health-pulse {
+      0%, 100% { opacity: 1; }
+      50% { opacity: 0.6; }
+    }
+
+    /* Health dropdown */
+    .health-dropdown {
+      display: none;
+      position: fixed;
+      z-index: 3100;
+      background: var(--tg-surface);
+      border: 1px solid var(--tg-border);
+      border-radius: var(--tg-radius);
+      box-shadow: 0 8px 32px rgba(0, 0, 0, 0.45);
+      padding: 10px 14px;
+      min-width: 300px;
+      max-width: 420px;
+      font-family: var(--tg-mono);
+      font-size: 11px;
+    }
+    .health-dropdown.open { display: block; }
+    .hd-check {
+      display: grid;
+      grid-template-columns: 16px 1fr auto auto;
+      gap: 6px;
+      align-items: baseline;
+      padding: 5px 0;
+      border-bottom: 1px solid var(--tg-border);
+    }
+    .hd-check:last-child { border-bottom: none; }
+    .hd-icon { text-align: center; font-weight: 700; }
+    .hd-ok .hd-icon { color: var(--tg-green); }
+    .hd-fail .hd-icon { color: var(--tg-red); }
+    .hd-name { color: var(--tg-text); }
+    .hd-dots {
+      border-bottom: 1px dotted var(--tg-border);
+      min-width: 20px;
+      align-self: end;
+      margin-bottom: 3px;
+    }
+    .hd-status { font-weight: 600; }
+    .hd-ok .hd-status { color: var(--tg-green); }
+    .hd-fail .hd-status { color: var(--tg-red); }
+    .hd-detail {
+      grid-column: 2 / -1;
+      color: var(--tg-text-dim);
+      font-size: 10px;
+    }
+    .hd-detail:empty { display: none; }
+    .hd-remediation {
+      grid-column: 2 / -1;
+      color: var(--tg-amber);
+      font-size: 10px;
+      padding: 2px 6px;
+      background: rgba(224, 175, 104, 0.08);
+      border-radius: 3px;
+      margin-top: 2px;
+    }
+    .hd-loading, .hd-empty {
+      color: var(--tg-text-dim);
+      padding: 8px 0;
+      text-align: center;
+    }
+
+    /* ===== TRANSCRIPT MODAL (Sprint 6 T4) ===== */
+    .transcript-modal {
+      display: none;
+      position: fixed;
+      inset: 0;
+      z-index: 3000;
+      align-items: center;
+      justify-content: center;
+    }
+    .transcript-modal.open { display: flex; }
+    .transcript-backdrop {
+      position: absolute;
+      inset: 0;
+      background: rgba(0, 0, 0, 0.72);
+    }
+    .transcript-card {
+      position: relative;
+      background: var(--tg-surface);
+      border: 1px solid var(--tg-accent-dim);
+      border-radius: 10px;
+      width: 800px;
+      max-width: calc(100vw - 40px);
+      max-height: calc(100vh - 80px);
+      display: flex;
+      flex-direction: column;
+      box-shadow: 0 16px 48px rgba(0, 0, 0, 0.55);
+      font-family: var(--tg-sans);
+      color: var(--tg-text);
+    }
+    .transcript-card header {
+      padding: 18px 22px 10px;
+      border-bottom: 1px solid var(--tg-border);
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+    }
+    .transcript-card header h3 {
+      margin: 0;
+      font-size: 15px;
+      color: var(--tg-accent);
+    }
+    .transcript-tabs {
+      display: flex;
+      gap: 4px;
+    }
+    .transcript-tab {
+      background: none;
+      border: 1px solid var(--tg-border);
+      color: var(--tg-text-dim);
+      font-size: 11px;
+      padding: 4px 12px;
+      border-radius: 3px;
+      cursor: pointer;
+      font-family: var(--tg-sans);
+      transition: all 0.1s;
+    }
+    .transcript-tab:hover { color: var(--tg-text); border-color: var(--tg-border-active); }
+    .transcript-tab.active {
+      color: var(--tg-accent);
+      border-color: var(--tg-accent-dim);
+      background: var(--tg-bg);
+    }
+    .transcript-search-bar {
+      padding: 10px 22px;
+      border-bottom: 1px solid var(--tg-border);
+    }
+    .transcript-search-bar .ctrl-input {
+      width: 100%;
+    }
+    .transcript-body {
+      flex: 1;
+      overflow-y: auto;
+      padding: 12px 22px;
+      min-height: 200px;
+      max-height: 60vh;
+    }
+    .transcript-loading, .transcript-empty {
+      color: var(--tg-text-dim);
+      font-size: 12px;
+      text-align: center;
+      padding: 40px 0;
+      font-family: var(--tg-mono);
+    }
+    .transcript-card footer {
+      padding: 10px 22px 14px;
+      border-top: 1px solid var(--tg-border);
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+    }
+
+    /* Transcript session cards (recent view) */
+    .transcript-session {
+      padding: 10px 12px;
+      border: 1px solid var(--tg-border);
+      border-radius: var(--tg-radius-sm);
+      margin-bottom: 8px;
+      cursor: pointer;
+      transition: border-color 0.15s;
+    }
+    .transcript-session:hover { border-color: var(--tg-accent-dim); }
+    .ts-header {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      margin-bottom: 6px;
+      font-size: 11px;
+    }
+    .ts-id {
+      font-family: var(--tg-mono);
+      color: var(--tg-accent);
+      font-weight: 600;
+    }
+    .ts-type {
+      color: var(--tg-text-dim);
+      font-family: var(--tg-mono);
+    }
+    .ts-project {
+      padding: 1px 6px;
+      border-radius: 3px;
+      background: var(--tg-bg);
+      border: 1px solid var(--tg-accent-dim);
+      color: var(--tg-accent);
+      font-size: 10px;
+    }
+    .ts-lines {
+      color: var(--tg-text-dim);
+      font-size: 10px;
+      margin-left: auto;
+    }
+    .ts-preview {
+      font-family: var(--tg-mono);
+      font-size: 11px;
+      color: var(--tg-text-dim);
+      background: var(--tg-bg);
+      padding: 6px 8px;
+      border-radius: 3px;
+      margin: 0;
+      max-height: 80px;
+      overflow: hidden;
+      white-space: pre-wrap;
+      word-break: break-word;
+    }
+
+    /* Transcript search results */
+    .transcript-result {
+      padding: 8px 10px;
+      border: 1px solid var(--tg-border);
+      border-radius: var(--tg-radius-sm);
+      margin-bottom: 6px;
+      cursor: pointer;
+      transition: border-color 0.15s;
+    }
+    .transcript-result:hover { border-color: var(--tg-accent-dim); }
+    .tr-meta {
+      display: flex;
+      gap: 8px;
+      font-size: 10px;
+      color: var(--tg-text-dim);
+      margin-bottom: 4px;
+    }
+    .tr-session { font-family: var(--tg-mono); color: var(--tg-accent); }
+    .tr-time { font-family: var(--tg-mono); }
+    .tr-line {
+      font-family: var(--tg-mono);
+      font-size: 11px;
+      color: var(--tg-text);
+      margin: 0;
+      white-space: pre-wrap;
+      word-break: break-word;
+    }
+    mark.tr-highlight {
+      background: rgba(224, 175, 104, 0.25);
+      color: var(--tg-amber);
+      border-radius: 2px;
+      padding: 0 1px;
+    }
+
+    /* Transcript replay view */
+    .transcript-replay-header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      margin-bottom: 10px;
+    }
+    .tr-replay-id {
+      font-family: var(--tg-mono);
+      font-size: 12px;
+      color: var(--tg-accent);
+    }
+    .transcript-copy {
+      background: none;
+      border: 1px solid var(--tg-border);
+      color: var(--tg-text-dim);
+      font-family: var(--tg-mono);
+      font-size: 11px;
+      padding: 4px 10px;
+      border-radius: 3px;
+      cursor: pointer;
+      transition: all 0.15s;
+    }
+    .transcript-copy:hover {
+      color: var(--tg-text);
+      border-color: var(--tg-border-active);
+    }
+    .transcript-copy.copied {
+      color: var(--tg-green);
+      border-color: var(--tg-green);
+    }
+    .transcript-replay-content {
+      font-family: var(--tg-mono);
+      font-size: 11px;
+      color: var(--tg-text);
+      background: var(--tg-bg);
+      padding: 12px 14px;
+      border-radius: var(--tg-radius-sm);
+      margin: 0;
+      white-space: pre-wrap;
+      word-break: break-word;
+      max-height: 50vh;
+      overflow-y: auto;
+    }
+    .transcript-back {
+      background: none;
+      border: 1px solid var(--tg-border);
+      color: var(--tg-text-dim);
+      font-family: var(--tg-sans);
+      font-size: 11px;
+      padding: 5px 14px;
+      border-radius: 3px;
+      cursor: pointer;
+    }
+    .transcript-back:hover {
+      color: var(--tg-text);
+      border-color: var(--tg-border-active);
+    }
+
     /* ===== SCROLLBAR ===== */
     ::-webkit-scrollbar { width: 6px; }
     ::-webkit-scrollbar-track { background: transparent; }

package/packages/server/src/index.js

@@ -47,6 +47,8 @@ const { initDatabase, logCommand, getSessionHistory, getProjectSessions } = requ
 const { RAGIntegration } = require('./rag');
 const { createBridge } = require('./mnestra-bridge');
 const { writeSessionLog } = require('./session-logger');
+const { TranscriptWriter } = require('./transcripts');
+const { createHealthHandler } = require('./preflight');
 const { themes, statusColors } = require('./themes');
 const { loadConfig, addProject } = require('./config');
 
@@ -87,12 +89,33 @@ function createServer(config) {
   const mnestraBridge = createBridge(config);
   console.log(`[mnestra-bridge] mode=${mnestraBridge.mode}`);
 
+  // Initialize transcript writer (Session Transcripts — Sprint 6)
+  const transcriptConfig = config.transcripts || {};
+  const transcriptEnabled = transcriptConfig.enabled !== undefined
+    ? transcriptConfig.enabled
+    : !!process.env.DATABASE_URL;
+  let transcriptWriter = null;
+  if (transcriptEnabled && process.env.DATABASE_URL) {
+    transcriptWriter = new TranscriptWriter(process.env.DATABASE_URL, {
+      batchSize: transcriptConfig.batchSize || 50,
+      flushIntervalMs: transcriptConfig.flushIntervalMs || 2000,
+      enabled: true
+    });
+    console.log('[transcript] Writer initialized (flush every %dms, batch %d)',
+      transcriptConfig.flushIntervalMs || 2000, transcriptConfig.batchSize || 50);
+  } else {
+    console.log('[transcript] Writer disabled (no DATABASE_URL or transcripts.enabled=false)');
+  }
+
   // Wire RAG to session events
   sessions.on('session:created', (s) => rag.onSessionCreated(s));
   sessions.on('session:removed', (s) => rag.onSessionEnded(s));
 
   // ==================== REST API ====================
 
+  // GET /api/health - preflight health checks (Sprint 6 T1, wired by T3)
+  app.get('/api/health', createHealthHandler(config));
+
   // GET /api/sessions - list all active sessions
   app.get('/api/sessions', (req, res) => {
     res.json(sessions.getAll());
@@ -157,7 +180,7 @@ function createServer(config) {
         session.pid = term.pid;
         session.meta.status = 'active';
 
-        // PTY output → analyze + broadcast to WebSocket
+        // PTY output → analyze + broadcast to WebSocket + transcript archive
         term.onData((data) => {
           session.analyzeOutput(data);
 
@@ -165,6 +188,15 @@ function createServer(config) {
           if (session.ws && session.ws.readyState === 1) {
             session.ws.send(JSON.stringify({ type: 'output', data }));
           }
+
+          // Archive to transcript writer (non-blocking, failure-safe)
+          if (transcriptWriter) {
+            try {
+              transcriptWriter.append(session.id, data, Buffer.byteLength(data, 'utf8'));
+            } catch (err) {
+              // Never let transcript failures disrupt the PTY data path
+            }
+          }
         });
 
         term.onExit(({ exitCode, signal }) => {
@@ -447,6 +479,53 @@ function createServer(config) {
     });
   });
 
+  // ==================== Transcript endpoints (Sprint 6 T3) ====================
+
+  // GET /api/transcripts/search - FTS across all sessions
+  // (Must be registered before :sessionId to avoid route collision)
+  app.get('/api/transcripts/search', async (req, res) => {
+    if (!transcriptWriter) return res.json([]);
+    const q = req.query.q;
+    if (!q) return res.status(400).json({ error: 'Missing q parameter' });
+    const since = req.query.since || null;
+    const limit = Math.min(Math.max(parseInt(req.query.limit) || 50, 1), 200);
+    try {
+      const results = await transcriptWriter.search(q, { since, limit });
+      res.json(results);
+    } catch (err) {
+      console.error('[transcript] search endpoint error:', err.message);
+      res.status(500).json({ error: 'Transcript search failed' });
+    }
+  });
+
+  // GET /api/transcripts/recent - time-windowed crash recovery
+  app.get('/api/transcripts/recent', async (req, res) => {
+    if (!transcriptWriter) return res.json([]);
+    const minutes = Math.min(Math.max(parseInt(req.query.minutes) || 60, 1), 1440);
+    const limit = Math.min(Math.max(parseInt(req.query.limit) || 500, 1), 2000);
+    try {
+      const results = await transcriptWriter.getRecent(minutes, limit);
+      res.json(results);
+    } catch (err) {
+      console.error('[transcript] recent endpoint error:', err.message);
+      res.status(500).json({ error: 'Transcript recent query failed' });
+    }
+  });
+
+  // GET /api/transcripts/:sessionId - ordered chunks for a session
+  app.get('/api/transcripts/:sessionId', async (req, res) => {
+    if (!transcriptWriter) return res.json([]);
+    const limit = req.query.limit ? Math.min(Math.max(parseInt(req.query.limit), 1), 5000) : undefined;
+    const since = req.query.since || undefined;
+    try {
+      const chunks = await transcriptWriter.getSessionTranscript(req.params.sessionId, { limit, since });
+      res.json(chunks);
+    } catch (err) {
+      console.error('[transcript] session transcript endpoint error:', err.message);
+      res.status(500).json({ error: 'Transcript retrieval failed' });
+    }
+  });
+
   // ==================== Rumen insights (Sprint 4 T2) ====================
   // Read-only access to rumen_insights + rumen_jobs in the petvetbid Postgres
   // instance. Contract frozen in docs/sprint-4-rumen-integration/API-CONTRACT.md.
@@ -717,7 +796,7 @@ function createServer(config) {
     res.sendFile(path.join(clientDir, 'index.html'));
   });
 
-  return { app, server, wss, sessions, rag, db };
+  return { app, server, wss, sessions, rag, db, transcriptWriter };
 }
 
 // Start server
@@ -733,10 +812,29 @@ if (require.main === module) {
     config.sessionLogs = { ...(config.sessionLogs || {}), enabled: true };
   }
 
-  const { server } = createServer(config);
+  const { server, transcriptWriter } = createServer(config);
   const port = config.port || 3000;
   const host = config.host || '127.0.0.1';
 
+  // Graceful shutdown — flush transcript buffer before exit
+  let shutdownInProgress = false;
+  async function handleShutdown(signal) {
+    if (shutdownInProgress) return;
+    shutdownInProgress = true;
+    console.log(`\n[server] ${signal} received, shutting down...`);
+    if (transcriptWriter) {
+      console.log('[transcript] Flushing buffer before exit...');
+      try { await transcriptWriter.close(); } catch (err) {
+        console.error('[transcript] Shutdown flush failed:', err.message);
+      }
+    }
+    server.close(() => process.exit(0));
+    // Force exit after 5s if server.close hangs
+    setTimeout(() => process.exit(1), 5000).unref();
+  }
+  process.on('SIGINT', () => handleShutdown('SIGINT'));
+  process.on('SIGTERM', () => handleShutdown('SIGTERM'));
+
   server.listen(port, host, () => {
     console.log(`\n  TermDeck running at http://${host}:${port}\n`);
     console.log(`  Terminals:  0 active`);
@@ -744,6 +842,7 @@ if (require.main === module) {
     console.log(`  PTY:        ${pty ? 'node-pty OK' : 'unavailable (install node-pty)'}`);
     console.log(`  RAG:        ${config.rag?.supabaseUrl ? 'configured' : 'not configured'}`);
     console.log(`  Session logs: ${config.sessionLogs?.enabled ? '~/.termdeck/sessions/ (on exit)' : 'off'}`);
+    console.log(`  Transcripts:  ${transcriptWriter ? 'streaming to Supabase' : 'off (no DATABASE_URL)'}`);
     console.log(`\n  WARNING: TermDeck binds to ${host} only.`);
     console.log(`  Do NOT expose this to the network without authentication.`);
     console.log(`  Terminal sessions have full shell access.\n`);

package/packages/server/src/mnestra-bridge/index.js

@@ -207,7 +207,7 @@ function createBridge(config) {
     } catch (err) {
       // Kill child so it respawns next call
       if (state.mcpChild) {
-        try { state.mcpChild.kill(); } catch {}
+        try { state.mcpChild.kill(); } catch (err) { /* process may already be dead */ }
         state.mcpChild = null;
       }
       throw err;