@tekyzinc/gsd-t 3.20.12 → 3.20.13

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [3.20.13] - 2026-05-05
+
+### Fixed — visualizer: surface in-session NDJSONs when `.index.json` is empty
+
+The dashboard's `/transcripts` endpoint only read `.gsd-t/transcripts/.index.json` to populate the left-rail spawn list. The M45 D2 conversation-capture hook writes `in-session-{sessionId}.ndjson` directly to `transcripts/` but does NOT update the index — the index is owned by the spawn lifecycle, not the in-session hook. Result: the visualizer's left rail showed "no spawns yet" even when the in-session conversation was actively being captured to disk. Discovered when the M43 D1 + M45 D2 hooks were installed (v3.20.12) and the conversation NDJSONs were appearing on disk but invisible in the UI.
+
+**Changes:**
+- `scripts/gsd-t-dashboard-server.js`: new `listInSessionTranscripts(projectDir)` function scans `transcripts/` for `in-session-*.ndjson` files and returns spawn-shaped entries with `spawnId: in-session-{sessionId}`. Filenames are validated through `isValidSpawnId` for path-traversal safety. `handleTranscriptsList` merges these with the index entries (index takes precedence on dup `spawnId`). The viewer's existing `in-session-` prefix detection then applies the `💬 conversation` badge.
+- `test/dashboard-server.test.js`: 5 new regression tests covering the empty-dir case, missing-dir case, find/filter behavior, mixed file types, and malformed-filename rejection.
+
+**Migration:** existing dashboards picking up the new code will surface in-session conversations automatically on next refresh of `/transcripts`. No state migration needed; the index is read-only here.
+
+**Suite:** 2047/2047 pass.
+
+**Side cleanup:** killed 144 + 20 orphan `gsd-t-dashboard-server.js` processes (164 total) accumulated from prior detached spawns whose parents had exited and been reparented to launchd. 3 stale pidfiles cleaned. Per-project `transcripts/` directories pre-created in 15 GSD-T projects so the M45 D2 hook can write without first-run delay.
+
 ## [3.20.12] - 2026-05-05
 
 ### Fixed — install: auto-configure M43 D1 + M45 D2 in-session hooks

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "3.20.12",
+  "version": "3.20.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

@@ -176,9 +176,47 @@ function isValidSpawnId(id) {
   return typeof id === "string" && /^[a-zA-Z0-9._-]+$/.test(id) && id.length <= 200;
 }
 
+// M45 D2 follow-up: filesystem-walk fallback for in-session conversation NDJSONs.
+// The conversation-capture hook writes `in-session-{sessionId}.ndjson` directly
+// to `transcripts/`, but does NOT update `.index.json` (the index is owned by
+// the spawn lifecycle, not by the in-session hook). Without this scan, the
+// dashboard's left rail never shows in-session conversations even though the
+// NDJSONs are on disk. Synthesizes a spawn-shaped entry per in-session file
+// using filesystem timestamps; the viewer's `in-session-` prefix detection
+// then labels it as `💬 conversation`.
+function listInSessionTranscripts(projectDir) {
+  const dir = transcriptsDir(projectDir);
+  let files;
+  try { files = fs.readdirSync(dir); } catch { return []; }
+  const out = [];
+  for (const f of files) {
+    if (!f.startsWith("in-session-") || !f.endsWith(".ndjson")) continue;
+    const spawnId = f.slice(0, -".ndjson".length); // "in-session-{sessionId}"
+    if (!isValidSpawnId(spawnId)) continue;
+    let stat;
+    try { stat = fs.statSync(path.join(dir, f)); } catch { continue; }
+    out.push({
+      spawnId,
+      command: "in-session conversation",
+      startedAt: stat.birthtime ? stat.birthtime.toISOString() : stat.mtime.toISOString(),
+      lastUpdatedAt: stat.mtime.toISOString(),
+      status: "active", // best-effort; the viewer doesn't currently use this field
+      kind: "in-session",
+    });
+  }
+  return out;
+}
+
 function handleTranscriptsList(req, res, projectDir, transcriptHtmlPath) {
   const idx = readTranscriptsIndex(projectDir);
-  const sorted = idx.spawns
+
+  // Merge index entries with in-session NDJSONs from the filesystem.
+  // De-dupe by spawnId — index entries take precedence (richer metadata).
+  const known = new Set(idx.spawns.map((s) => s.spawnId));
+  const inSession = listInSessionTranscripts(projectDir).filter((s) => !known.has(s.spawnId));
+  const merged = idx.spawns.concat(inSession);
+
+  const sorted = merged
     .slice()
     .sort((a, b) => (Date.parse(b.startedAt) || 0) - (Date.parse(a.startedAt) || 0));
 
@@ -723,6 +761,7 @@ module.exports = {
   writeTranscriptsIndex,
   readIndexEntry,
   isValidSpawnId,
+  listInSessionTranscripts,
   handleTranscriptsList,
   handleTranscriptStream,
   handleTranscriptPage,