@tekyzinc/gsd-t 3.18.12 → 3.18.13

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [3.18.13] - 2026-04-23
+
+### Fixed
+
+- **Dashboard `/transcripts` returned raw JSON to browsers** — after the v3.18.12 always-enabled Live Stream button fix, opening the dashboard with no spawn data and clicking Live Stream landed the user on `{"spawns":[]}` because `/transcripts` always served JSON. The route now does Accept-header content negotiation: browsers (`Accept: text/html`) get a proper dark-themed HTML index page with a sortable table of spawns (or a friendly empty state with a `/gsd-t-quick` CTA when no transcripts exist); programmatic clients (`fetch()` default `*/*`, or explicit `application/json`) keep getting the JSON shape the dashboard polling code already consumes — full back-compat.
+
 ## [3.18.12] - 2026-04-23
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "3.18.12",
+  "version": "3.18.13",
   "description": "GSD-T: Contract-Driven Development for Claude Code — 54 slash commands with headless-by-default workflow spawning, unattended supervisor relay with event stream, graph-powered code analysis, real-time agent dashboard, task telemetry, doc-ripple enforcement, backlog management, impact analysis, test sync, milestone archival, and PRD generation",
   "author": "Tekyz, Inc.",
   "license": "MIT",

package/scripts/gsd-t-dashboard-server.js

@@ -181,10 +181,97 @@ function handleTranscriptsList(req, res, projectDir) {
   const sorted = idx.spawns
     .slice()
     .sort((a, b) => (Date.parse(b.startedAt) || 0) - (Date.parse(a.startedAt) || 0));
+
+  // Content negotiation: browser navigations send Accept: text/html, fetch()
+  // defaults to */*. We serve HTML only when the client explicitly asks for it,
+  // so the existing dashboard fetch (which expects JSON) stays unaffected.
+  const accept = String(req.headers["accept"] || "");
+  if (accept.includes("text/html")) {
+    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+    res.end(renderTranscriptsHtml(sorted));
+    return;
+  }
   res.writeHead(200, { "Content-Type": "application/json" });
   res.end(JSON.stringify({ spawns: sorted }));
 }
 
+function renderTranscriptsHtml(spawns) {
+  const escape = (s) => String(s == null ? "" : s)
+    .replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+  const fmtDuration = (a, b) => {
+    const start = Date.parse(a); const end = Date.parse(b || "") || Date.now();
+    if (!Number.isFinite(start)) return "—";
+    const ms = Math.max(0, end - start);
+    const s = Math.floor(ms / 1000); const m = Math.floor(s / 60); const r = s % 60;
+    return m > 0 ? `${m}m ${r}s` : `${r}s`;
+  };
+  const fmtTime = (s) => { const d = new Date(s); return Number.isFinite(d.getTime()) ? d.toLocaleString() : "—"; };
+  const liveStatuses = new Set(["initializing", "running"]);
+  const isLive = (s) => liveStatuses.has(s);
+
+  const rows = spawns.map((s) => {
+    const live = isLive(s.status);
+    const statusBadge = `<span class="status status-${escape(s.status || 'unknown')}">${escape(s.status || 'unknown')}</span>`;
+    return `<tr class="${live ? 'row-live' : ''}">
+      <td><a href="/transcript/${encodeURIComponent(s.spawnId)}">${escape(s.spawnId)}</a></td>
+      <td>${escape(s.command || '—')}</td>
+      <td>${escape(s.description || '—')}</td>
+      <td>${statusBadge}</td>
+      <td>${escape(fmtTime(s.startedAt))}</td>
+      <td>${escape(fmtDuration(s.startedAt, s.endedAt))}</td>
+    </tr>`;
+  }).join("");
+
+  const empty = `<div class="empty">
+    <h2>No spawn transcripts yet</h2>
+    <p>Transcripts appear here as soon as the first agent spawns. Run any GSD-T command (for example <code>/gsd-t-quick</code>) to generate one.</p>
+    <p><a href="/">← Back to dashboard</a></p>
+  </div>`;
+
+  const table = spawns.length ? `<table>
+    <thead><tr><th>Spawn ID</th><th>Command</th><th>Description</th><th>Status</th><th>Started</th><th>Duration</th></tr></thead>
+    <tbody>${rows}</tbody>
+  </table>` : empty;
+
+  return `<!DOCTYPE html>
+<html lang="en"><head><meta charset="UTF-8"><title>GSD-T Transcripts</title>
+<style>
+:root{--bg:#0d1117;--surface:#161b22;--border:#30363d;--text:#e6edf3;--muted:#7d8590;
+  --green:#3fb950;--green-bg:#1a3a1e;--blue:#388bfd;--blue-bg:#1f3a5f;--yellow:#d29922;--red:#f85149;
+  --font:'SF Mono','Fira Code',Menlo,monospace;}
+*{box-sizing:border-box;margin:0;padding:0}
+body{background:var(--bg);color:var(--text);font-family:var(--font);font-size:13px;padding:20px;line-height:1.5}
+.hdr{display:flex;align-items:center;gap:12px;margin-bottom:18px;padding-bottom:12px;border-bottom:1px solid var(--border)}
+.logo{color:var(--blue);font-weight:bold;font-size:14px}
+.hright{margin-left:auto;color:var(--muted);font-size:11px}
+a{color:var(--blue);text-decoration:none}a:hover{text-decoration:underline}
+table{width:100%;border-collapse:collapse;background:var(--surface);border:1px solid var(--border);border-radius:6px;overflow:hidden}
+th,td{padding:8px 12px;text-align:left;border-bottom:1px solid var(--border);font-size:12px}
+th{background:#1c2128;color:var(--muted);text-transform:uppercase;font-size:10px;letter-spacing:0.5px}
+tbody tr:last-child td{border-bottom:none}
+tbody tr:hover{background:#1c2128}
+tr.row-live{background:var(--green-bg)}
+.status{display:inline-block;padding:2px 8px;border-radius:10px;font-size:10px;text-transform:uppercase;letter-spacing:0.5px;border:1px solid}
+.status-running,.status-initializing{background:var(--green-bg);color:var(--green);border-color:var(--green)}
+.status-done{background:var(--blue-bg);color:var(--blue);border-color:var(--blue)}
+.status-stopped{background:#2a2a2a;color:var(--muted);border-color:var(--border)}
+.status-failed,.status-crashed{background:#3a1a1a;color:var(--red);border-color:var(--red)}
+.status-unknown{color:var(--muted);border-color:var(--border)}
+.empty{text-align:center;padding:60px 20px;color:var(--muted);background:var(--surface);border:1px solid var(--border);border-radius:6px}
+.empty h2{color:var(--text);margin-bottom:12px;font-size:16px}
+.empty p{margin-bottom:8px}
+.empty code{background:#1c2128;padding:2px 6px;border-radius:3px;color:var(--green)}
+</style></head><body>
+<div class="hdr">
+  <span class="logo">GSD-T Transcripts</span>
+  <a href="/" style="font-size:11px">← Dashboard</a>
+  <span class="hright">${spawns.length} spawn${spawns.length === 1 ? '' : 's'}</span>
+</div>
+${table}
+</body></html>`;
+}
+
 function handleTranscriptPage(req, res, spawnId, transcriptHtmlPath) {
   if (!isValidSpawnId(spawnId)) { res.writeHead(400); res.end("Invalid spawn id"); return; }
   fs.readFile(transcriptHtmlPath, (err, data) => {
@@ -587,6 +674,7 @@ module.exports = {
   readIndexEntry,
   isValidSpawnId,
   handleTranscriptsList,
+  renderTranscriptsHtml,
   handleTranscriptStream,
   handleTranscriptPage,
   handleTranscriptKill,