@jhizzard/termdeck 0.17.0 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.17.0",
+  "version": "1.0.0",
   "description": "Browser-based terminal multiplexer with metadata overlays, panel flashback memory recall, and AI-aware session management",
   "bin": {
     "termdeck": "./packages/cli/src/index.js"

package/packages/client/public/app.js

@@ -4,6 +4,13 @@
     const WS_PROTOCOL = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
     const WS_BASE = `${WS_PROTOCOL}//${window.location.host}/ws`;
 
+    // ===== Utilities =====
+    function escapeHtml(str) {
+      const div = document.createElement('div');
+      div.textContent = str;
+      return div.innerHTML;
+    }
+
     // State
     const state = {
       sessions: new Map(),   // id → { session, terminal, ws, fitAddon, el }
@@ -46,6 +53,20 @@
         }
       } catch (_) { /* keep bootstrap fallback */ }
 
+      // Sprint 50 T3 — adapter-driven launcher buttons. Render one button
+      // per registered agent in the topbar quick-launch and the empty-state
+      // tile group. Replaces the pre-Sprint-50 hardcoded `claude` button
+      // that left Codex/Gemini/Grok with no one-click launcher (forcing
+      // free-form `codex`/`gemini`/`grok` typing in the prompt bar — a v1.0.0
+      // gate-blocker UX gap surfaced during the Sprint 49 mixed-agent
+      // dogfood). Static `shell` + `python` entries stay (non-adapter
+      // built-ins). HTML fallback shapes are preserved if rendering fails.
+      try {
+        renderQuickLaunchers();
+      } catch (err) {
+        console.warn('[client] launcher render failed, keeping HTML fallback:', err);
+      }
+
       // Populate project dropdown
       const sel = document.getElementById('promptProject');
       for (const name of Object.keys(state.config.projects || {})) {
@@ -1579,6 +1600,98 @@
       launchTerminal();
     }
 
+    // ===== Adapter-driven launcher buttons (Sprint 50 T3) =====
+    //
+    // Built-in non-adapter entries that flank the adapter list. `shell` is
+    // the always-on fallback panel; `python` is the HTTP-server convenience
+    // launcher that long predates the multi-agent registry.
+    const BUILTIN_LAUNCHERS = {
+      pre: [
+        { command: 'zsh', label: 'shell', title: 'Open a zsh shell' },
+      ],
+      post: [
+        {
+          command: 'python3 -m http.server 8080',
+          label: 'python',
+          title: 'Open a Python HTTP server on :8080',
+        },
+      ],
+    };
+
+    // One launcher button. Reuses the same `quickLaunch(cmd)` path the
+    // hardcoded HTML buttons used so command resolution (LauncherResolver
+    // + /api/sessions) is unchanged.
+    function makeLauncherButton(cmd, label, title, className) {
+      const btn = document.createElement('button');
+      btn.type = 'button';
+      btn.className = className;
+      btn.textContent = label;
+      if (title) btn.title = title;
+      btn.dataset.command = cmd;
+      btn.addEventListener('click', () => quickLaunch(cmd));
+      return btn;
+    }
+
+    function adapterLauncherEntries() {
+      const adapters = Array.isArray(state.agentAdapters) ? state.agentAdapters : [];
+      return adapters.map((a) => ({
+        command: a.binary || a.name,
+        label: (a.displayName || a.name || a.binary || '').toLowerCase(),
+        // Title text gets the canonical displayName so the tooltip preserves
+        // the proper-cased "Claude Code" / "Codex CLI" form even when the
+        // button face renders lowercase to match TermDeck's chrome style.
+        title: `Open ${a.displayName || a.name || a.binary}`,
+      }));
+    }
+
+    function renderQuickLaunchers() {
+      const adapters = adapterLauncherEntries();
+      const ordered = [
+        ...BUILTIN_LAUNCHERS.pre,
+        ...adapters,
+        ...BUILTIN_LAUNCHERS.post,
+      ];
+
+      // Topbar — compact buttons.
+      const topbar = document.getElementById('topbarQuickLaunch');
+      if (topbar) {
+        topbar.replaceChildren();
+        for (const entry of ordered) {
+          topbar.appendChild(
+            makeLauncherButton(entry.command, entry.label, entry.title, 'topbar-ql-btn'),
+          );
+        }
+      }
+
+      // Empty state — taller tiles with the raw command rendered as a
+      // secondary line. Mirrors the pre-Sprint-50 markup so existing CSS
+      // classes (`quick-launch-btn`, `ql-cmd`, `ql-desc`) keep their styling.
+      const emptyGroup = document.querySelector('#emptyState .quick-launch-group');
+      if (emptyGroup) {
+        emptyGroup.replaceChildren();
+        for (const entry of ordered) {
+          const btn = document.createElement('button');
+          btn.type = 'button';
+          btn.className = 'quick-launch-btn';
+          btn.title = entry.title;
+          btn.dataset.command = entry.command;
+
+          const cmd = document.createElement('span');
+          cmd.className = 'ql-cmd';
+          cmd.textContent = entry.command;
+
+          const desc = document.createElement('span');
+          desc.className = 'ql-desc';
+          desc.textContent = entry.title;
+
+          btn.appendChild(cmd);
+          btn.appendChild(desc);
+          btn.addEventListener('click', () => quickLaunch(entry.command));
+          emptyGroup.appendChild(btn);
+        }
+      }
+    }
+
     // ===== Add Project modal =====
     function rebuildProjectDropdown(selectName) {
       const sel = document.getElementById('promptProject');
@@ -2564,10 +2677,23 @@
     }
 
     function getTypeLabel(type) {
+      // Sprint 50 T3 — adapter-driven panel header labels. Consult
+      // state.agentAdapters first so a freshly-launched Codex/Gemini/Grok
+      // panel reads its agent's displayName (rather than the raw
+      // sessionType string or — worse — falling through to "Shell" when
+      // the type label map didn't have an entry). Adding a new agent now
+      // requires only an adapter file with `displayName`; no client-side
+      // edit. Built-in non-adapter types (shell / python-server / etc.)
+      // keep their static labels.
+      const adapters = Array.isArray(state.agentAdapters) ? state.agentAdapters : [];
+      const adapter = adapters.find((a) => a && a.sessionType === type);
+      if (adapter && adapter.displayName) return adapter.displayName;
       const labels = {
         'shell': 'Shell',
         'claude-code': 'Claude Code',
+        'codex': 'Codex CLI',
         'gemini': 'Gemini CLI',
+        'grok': 'Grok CLI',
         'python-server': 'Python Server',
         'one-shot': 'One-shot'
       };
@@ -2617,7 +2743,18 @@
 
       if (dot) {
         dot.style.background = getStatusColor(meta.status);
-        dot.classList.toggle('pulsing', meta.status === 'thinking');
+        // Sprint 50 T3 — pulse the status dot for ALL in-flight states
+        // (thinking, editing, active), not just thinking. Pre-Sprint-50 the
+        // dot only pulsed on `thinking`; during a long agent task the
+        // status fluctuated through editing/active as different regex
+        // patterns matched the live PTY stream, removing the pulsing class
+        // each time and making the visual cue feel "frozen" between thinking
+        // hits. Pulsing across all work-in-progress states keeps the
+        // animation alive end-to-end. Idle / exited / errored stay solid.
+        const inflight = meta.status === 'thinking'
+          || meta.status === 'editing'
+          || meta.status === 'active';
+        dot.classList.toggle('pulsing', inflight);
       }
       if (status) status.textContent = meta.statusDetail || meta.status;
       if (metaLast && meta.lastCommands?.length) {
@@ -2654,12 +2791,6 @@
       }
     }
 
-    function escapeHtml(str) {
-      const div = document.createElement('div');
-      div.textContent = str;
-      return div.innerHTML;
-    }
-
     function updateGlobalStats(sessions) {
       let active = 0, thinking = 0, idle = 0;
       for (const s of sessions) {
@@ -4257,12 +4388,6 @@
       dropdown.innerHTML = html;
     }
 
-    function escapeHtml(str) {
-      const div = document.createElement('div');
-      div.textContent = str;
-      return div.innerHTML;
-    }
-
     function toggleHealthDropdown() {
       if (healthState.dropdownOpen) {
         closeHealthDropdown();

package/packages/client/public/flashback-history.html

@@ -271,6 +271,41 @@
       margin-bottom: 16px;
       font-size: 13px;
     }
+
+    /* Pagination (Sprint 49 T2) */
+    .fb-pagination {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      gap: 12px;
+      padding: 16px;
+      margin-top: 8px;
+    }
+    .fb-pag-info {
+      font-size: 12px;
+      color: var(--tg-text-dim);
+      font-family: var(--tg-mono);
+    }
+    .fb-pag-btn {
+      background: var(--tg-bg);
+      color: var(--tg-text);
+      border: 1px solid var(--tg-border);
+      border-radius: var(--tg-radius-sm);
+      padding: 4px 10px;
+      font-size: 12px;
+      font-family: var(--tg-mono);
+      cursor: pointer;
+      transition: all 0.15s;
+    }
+    .fb-pag-btn:hover:not(:disabled) {
+      background: var(--tg-surface-hover);
+      border-color: var(--tg-border-active);
+      color: var(--tg-text-bright);
+    }
+    .fb-pag-btn:disabled {
+      opacity: 0.3;
+      cursor: not-allowed;
+    }
   </style>
 </head>
 <body class="fb-page">

package/packages/client/public/flashback-history.js

@@ -13,10 +13,13 @@
 // Vanilla JS, no framework — matches the rest of public/.
 
 (() => {
-  const API = window.location.origin;
+const API = window.location.origin;
+const PAGE_SIZE = 25;
 
-  const els = {
-    windowSel: document.getElementById('fbWindow'),
+let _allEvents = [];
+let _currentPage = 1;
+
+const els = {    windowSel: document.getElementById('fbWindow'),
     refreshBtn: document.getElementById('fbRefresh'),
     errorBanner: document.getElementById('fbErrorBanner'),
     content: document.getElementById('fbContent'),
@@ -154,8 +157,12 @@
     `;
   }
 
-  function renderTable(events) {
-    const rows = events.map((e) => {
+  function renderTable(events, page = 1) {
+    const totalPages = Math.ceil(events.length / PAGE_SIZE) || 1;
+    const start = (page - 1) * PAGE_SIZE;
+    const slice = events.slice(start, start + PAGE_SIZE);
+
+    const rows = slice.map((e) => {
       const projectCell = e.project
         ? `<span class="fb-cell-project">${escapeHtml(e.project)}</span>`
         : `<span class="fb-cell-project" style="color:var(--tg-text-dim)">—</span>`;
@@ -183,7 +190,7 @@
       `;
     }).join('');
 
-    els.content.innerHTML = `
+    let html = `
       <div class="fb-table-wrap">
         <table class="fb-table">
           <thead>
@@ -200,6 +207,36 @@
         </table>
       </div>
     `;
+
+    if (events.length > PAGE_SIZE) {
+      html += `
+        <div class="fb-pagination">
+          <button type="button" class="fb-pag-btn" id="fbPrev" ${page <= 1 ? 'disabled' : ''}>&larr; Prev</button>
+          <span class="fb-pag-info">Page ${page} of ${totalPages}</span>
+          <button type="button" class="fb-pag-btn" id="fbNext" ${page >= totalPages ? 'disabled' : ''}>Next &rarr;</button>
+        </div>
+      `;
+    }
+
+    els.content.innerHTML = html;
+
+    // Wire pagination buttons
+    const prevBtn = document.getElementById('fbPrev');
+    const nextBtn = document.getElementById('fbNext');
+    if (prevBtn) {
+      prevBtn.onclick = () => {
+        _currentPage--;
+        localStorage.setItem('fbHistoryPage', String(_currentPage));
+        renderTable(_allEvents, _currentPage);
+      };
+    }
+    if (nextBtn) {
+      nextBtn.onclick = () => {
+        _currentPage++;
+        localStorage.setItem('fbHistoryPage', String(_currentPage));
+        renderTable(_allEvents, _currentPage);
+      };
+    }
   }
 
   function showError(msg) {
@@ -211,7 +248,7 @@
     els.errorBanner.textContent = '';
   }
 
-  async function refresh() {
+  async function refresh(resetPage = true) {
     clearError();
     els.content.innerHTML = `<div class="fb-loading">Loading flashback history…</div>`;
 
@@ -219,7 +256,7 @@
     const since = sinceFromWindow(winKey);
     const qs = new URLSearchParams();
     if (since) qs.set('since', since);
-    qs.set('limit', '200');
+    qs.set('limit', '500'); // Sprint 49: raised from 200 for better pagination scale
 
     let data;
     try {
@@ -235,24 +272,34 @@
       return;
     }
 
+    _allEvents = data.events || [];
     renderFunnel(data.funnel || { fires: 0, dismissed: 0, clicked_through: 0 });
 
-    if (!Array.isArray(data.events) || data.events.length === 0) {
+    if (_allEvents.length === 0) {
       renderZeroState(winKey);
       return;
     }
 
-    renderTable(data.events);
+    if (resetPage) {
+      _currentPage = 1;
+      localStorage.setItem('fbHistoryPage', '1');
+    } else {
+      _currentPage = parseInt(localStorage.getItem('fbHistoryPage') || '1', 10);
+      const maxPage = Math.ceil(_allEvents.length / PAGE_SIZE) || 1;
+      if (_currentPage > maxPage) _currentPage = 1;
+    }
+
+    renderTable(_allEvents, _currentPage);
   }
 
   // Wire controls
   els.windowSel.addEventListener('change', () => {
     writeStateToUrl();
-    refresh();
+    refresh(true);
   });
-  els.refreshBtn.addEventListener('click', () => refresh());
+  els.refreshBtn.addEventListener('click', () => refresh(true));
 
   // Boot
   loadStateFromUrl();
-  refresh();
+  refresh(false);
 })();

package/packages/client/public/graph.html

@@ -40,6 +40,11 @@
     </div>
   </header>
 
+  <div class="graph-presets" id="graphPresets" role="toolbar" aria-label="Filter presets">
+    <button type="button" class="gf-preset" id="presetAll">All</button>
+    <button type="button" class="gf-preset" id="presetNone">None</button>
+  </div>
+
   <div class="graph-filters" id="graphFilters" role="toolbar" aria-label="Edge type filters"></div>
 
   <div class="graph-filters graph-filters-row2" id="graphControls" role="toolbar" aria-label="Graph view controls">

package/packages/client/public/graph.js

@@ -410,6 +410,7 @@
     const keys = Object.keys(EDGE_COLORS).filter((k) => present.has(k));
     if (keys.length === 0) {
       wrap.style.display = 'none';
+      updatePresetButtons();
       return;
     }
     wrap.style.display = '';
@@ -429,10 +430,27 @@
         if (state.activeKinds.has(k)) state.activeKinds.delete(k);
         else state.activeKinds.add(k);
         chip.classList.toggle('active');
+        updatePresetButtons();
         applyFilter();
       });
       wrap.appendChild(chip);
     }
+    updatePresetButtons();
+  }
+
+  function isAllKindsActive() {
+    return state.activeKinds.size === Object.keys(EDGE_COLORS).length;
+  }
+
+  function isNoKindsActive() {
+    return state.activeKinds.size === 0;
+  }
+
+  function updatePresetButtons() {
+    const allBtn = $('presetAll');
+    const noneBtn = $('presetNone');
+    if (allBtn) allBtn.disabled = isAllKindsActive();
+    if (noneBtn) noneBtn.disabled = isNoKindsActive();
   }
 
   function applyFilter() {
@@ -843,6 +861,25 @@
     });
     $('graphFit').addEventListener('click', () => fitToView());
 
+    // Sprint 49 T3 — chip filter presets (All/None). Wire once; renderFilters()
+    // keeps their disabled state in sync with activeKinds boundary conditions.
+    const presetAll = $('presetAll');
+    const presetNone = $('presetNone');
+    if (presetAll) {
+      presetAll.addEventListener('click', () => {
+        state.activeKinds = new Set(Object.keys(EDGE_COLORS));
+        renderFilters();
+        applyFilter();
+      });
+    }
+    if (presetNone) {
+      presetNone.addEventListener('click', () => {
+        state.activeKinds = new Set();
+        renderFilters();
+        applyFilter();
+      });
+    }
+
     // Sprint 43 T1 — graph view-controls. Hydrate input values from state, then
     // wire change handlers that mutate state.controls + URL + re-render from
     // the cached raw fetch so toggling is fast (no API round-trip).

package/packages/client/public/index.html

@@ -58,9 +58,8 @@
         <button class="topbar-ql-btn" onclick="quickLaunch('python3 -m http.server 8080')" title="Open a Python HTTP server on :8080">python</button>
       </div>
       <div class="topbar-row-2-spacer"></div>
-      <button id="btn-status">status</button>
-      <button id="btn-config">config</button>
-      <button id="btn-sprint" title="Define and kick off a 4+1 sprint">sprint</button>
+      <button id="btn-status" title="Global metrics: session counts, RAG mode, and memory bridge status">status</button>
+      <button id="btn-config" title="Configuration: project list, theme defaults, and live RAG-mode toggle">config</button>      <button id="btn-sprint" title="Define and kick off a 4+1 sprint">sprint</button>
       <button id="btn-graph" title="Open the knowledge-graph view (memory_items + memory_relationships, force-directed)" onclick="window.open('/graph.html','_blank','noopener')">graph</button>
       <button id="btn-flashback-history" title="Audit dashboard: every Flashback fire, dismiss/click-through funnel" onclick="window.open('/flashback-history.html','_blank','noopener')">flashback history</button>
       <button id="btn-how" title="Walkthrough of every TermDeck feature">how this works</button>

package/packages/client/public/launcher-resolver.js

@@ -24,6 +24,10 @@
     root.LauncherResolver = factory();
   }
 })(typeof self !== 'undefined' ? self : this, function () {
+  function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  }
+
   function resolve(command, project, agentAdapters, projects) {
     let resolvedCommand = command;
     let resolvedType = 'shell';
@@ -36,7 +40,7 @@
     }
 
     const adapter = (agentAdapters || []).find((a) =>
-      a && a.binary && new RegExp(`^${a.binary}\\b`, 'i').test(canonical)
+      a && a.binary && new RegExp(`^${escapeRegex(a.binary)}\\b`, 'i').test(canonical)
     );
 
     if (adapter) {

package/packages/client/public/style.css

@@ -3567,6 +3567,37 @@
       background: rgba(255, 255, 255, 0.08);
     }
 
+    /* Sprint 49 T3 — graph chip filter presets (Surface 2 from Sprint 46 audit).
+       Subtle variant of .gf-chip: smaller, no dot/count, secondary tint,
+       disabled state for boundary (all/none already active). Placed above
+       the chip row. */
+    .graph-presets {
+      display: flex;
+      gap: 6px;
+      padding: 8px 16px 4px;
+      background: var(--tg-surface);
+      border-bottom: 1px solid var(--tg-border);
+      flex-shrink: 0;
+    }
+    .gf-preset {
+      padding: 2px 10px;
+      font-size: 10px;
+      font-family: var(--tg-mono);
+      color: var(--tg-text-dim);
+      background: var(--tg-bg);
+      border: 1px solid var(--tg-border);
+      border-radius: 999px;
+      cursor: pointer;
+      transition: all 150ms;
+      opacity: 0.7;
+    }
+    .gf-preset:hover { opacity: 1; background: var(--tg-surface-hover); }
+    .gf-preset:disabled {
+      opacity: 0.35;
+      cursor: not-allowed;
+      background: transparent;
+    }
+
     /* Sprint 43 T1 — second toolbar row: hide-isolated / min-degree / window
        / layout selectors. Mirrors .graph-filters spacing but shifts the
        background a notch darker so the two rows are visually distinguishable

package/packages/server/src/agent-adapters/claude.js

@@ -75,6 +75,52 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1 (10th adapter field).
+//
+// Claude Code stores per-session JSONL transcripts at
+//   ~/.claude/projects/<dir-hash>/<claude-session-uuid>.jsonl
+// where <dir-hash> is `cwd` with `/` replaced by `-`. The inner UUID is
+// Claude's own session id — distinct from TermDeck's `session.id` — so we
+// can't compute the path; we list the directory and pick the most recently
+// modified .jsonl whose mtime is at-or-after `session.meta.createdAt`.
+//
+// IMPORTANT: server-side `onPanelClose` SKIPS claude-typed sessions so
+// Claude's existing SessionEnd hook (registered in ~/.claude/settings.json)
+// remains the sole writer for Claude rows — no double-writes. This
+// implementation exists for contract uniformity + the unit-test surface +
+// future tooling that may want to look up Claude transcripts directly.
+// ──────────────────────────────────────────────────────────────────────────
+
+async function resolveTranscriptPath(session) {
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const dirHash = session.meta.cwd.replace(/\//g, '-');
+  const projectsDir = path.join(os.homedir(), '.claude', 'projects', dirHash);
+  let entries;
+  try { entries = fs.readdirSync(projectsDir); }
+  catch (_) { return null; }
+  const createdAtMs = session.meta.createdAt
+    ? Date.parse(session.meta.createdAt)
+    : 0;
+  let bestPath = null;
+  let bestMtime = -Infinity;
+  for (const name of entries) {
+    if (!name.endsWith('.jsonl')) continue;
+    const full = path.join(projectsDir, name);
+    let st;
+    try { st = fs.statSync(full); } catch (_) { continue; }
+    if (createdAtMs && st.mtimeMs < createdAtMs) continue;
+    if (st.mtimeMs > bestMtime) {
+      bestMtime = st.mtimeMs;
+      bestPath = full;
+    }
+  }
+  return bestPath;
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Claude Code JSONL format, lifted from
 // packages/stack-installer/assets/hooks/memory-session-end.js:88-102.
@@ -137,6 +183,12 @@ function bootPromptTemplate(lane = {}, sprint = {}) {
 const claudeAdapter = {
   name: 'claude',
   sessionType: 'claude-code',
+  // Sprint 50 T3 — human-readable label for launcher buttons + panel headers.
+  // Drives /api/agents projection and getTypeLabel() in the dashboard so a
+  // freshly-launched Codex/Gemini/Grok panel header reads its agent name
+  // (not the previous "Shell" fallback). Single source of truth — adding a
+  // new adapter no longer requires touching the client's hardcoded label map.
+  displayName: 'Claude Code',
   matches: (cmd) => typeof cmd === 'string' && /claude/i.test(cmd),
   spawn: {
     binary: 'claude',
@@ -156,6 +208,9 @@ const claudeAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. See header for skip-claude rule
+  // (onPanelClose ignores claude-typed sessions).
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'pay-per-token',
   // Sprint 47 T3 — Claude Code's input box accepts bracketed-paste cleanly.

package/packages/server/src/agent-adapters/codex.js

@@ -101,6 +101,83 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1.
+//
+// Codex stores chat-shape JSONL rollouts at
+//   ~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl
+// (verified 2026-05-02 substrate probe — first line is
+// `{type:'session_meta', payload:{cwd, ...}}`). `~/.codex/history.jsonl` at
+// the top level is a flat command-history shape, NOT chat — Sprint 49
+// close-out tried that and got `session-too-short: 0 messages
+// (parser=codex)` from the bundled hook against a real lane session.
+//
+// Attribution strategy: we don't know Codex's internal session UUID at
+// spawn time, so we walk today's + yesterday's rollout directories in
+// newest-mtime order, parse each file's first line, and return the first
+// match where `session_meta.payload.cwd === session.meta.cwd` AND
+// `mtime >= session.meta.createdAt`. Returns null when no rollout exists
+// (e.g., Codex panel was opened but never sent a turn) — onPanelClose
+// no-ops cleanly.
+// ──────────────────────────────────────────────────────────────────────────
+
+function _codexCandidateDirs(homedir, now) {
+  const path = require('path');
+  const day = new Date(now);
+  const yesterday = new Date(now - 24 * 60 * 60 * 1000);
+  const fmt = (d) => ({
+    Y: String(d.getUTCFullYear()),
+    M: String(d.getUTCMonth() + 1).padStart(2, '0'),
+    D: String(d.getUTCDate()).padStart(2, '0'),
+  });
+  const out = [];
+  for (const d of [day, yesterday]) {
+    const { Y, M, D } = fmt(d);
+    out.push(path.join(homedir, '.codex', 'sessions', Y, M, D));
+  }
+  return out;
+}
+
+async function resolveTranscriptPath(session) {
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const cwd = session.meta.cwd;
+  const createdAtMs = session.meta.createdAt
+    ? Date.parse(session.meta.createdAt)
+    : 0;
+  const candidates = [];
+  for (const dir of _codexCandidateDirs(os.homedir(), Date.now())) {
+    let entries;
+    try { entries = fs.readdirSync(dir); }
+    catch (_) { continue; }
+    for (const name of entries) {
+      if (!name.startsWith('rollout-') || !name.endsWith('.jsonl')) continue;
+      const full = path.join(dir, name);
+      let st;
+      try { st = fs.statSync(full); } catch (_) { continue; }
+      if (createdAtMs && st.mtimeMs < createdAtMs) continue;
+      candidates.push({ full, mtime: st.mtimeMs });
+    }
+  }
+  candidates.sort((a, b) => b.mtime - a.mtime);
+  for (const { full } of candidates) {
+    let firstLine;
+    try {
+      const buf = fs.readFileSync(full, 'utf8');
+      const nl = buf.indexOf('\n');
+      firstLine = nl >= 0 ? buf.slice(0, nl) : buf;
+    } catch (_) { continue; }
+    let meta;
+    try { meta = JSON.parse(firstLine); } catch (_) { continue; }
+    if (!meta || meta.type !== 'session_meta') continue;
+    if (!meta.payload || meta.payload.cwd !== cwd) continue;
+    return full;
+  }
+  return null;
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Codex JSONL format.
 //
@@ -173,6 +250,8 @@ function bootPromptTemplate(lane = {}, sprint = {}) {
 const codexAdapter = {
   name: 'codex',
   sessionType: 'codex',
+  // Sprint 50 T3 — see claude.js for rationale.
+  displayName: 'Codex CLI',
   matches: (cmd) => typeof cmd === 'string' && /\bcodex\b/i.test(cmd),
   spawn: {
     binary: 'codex',
@@ -192,6 +271,9 @@ const codexAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. See header above for substrate
+  // findings + attribution strategy.
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'pay-per-token',
   // Sprint 47 T3 — Codex's Ratatui TUI accepts bracketed-paste per the

package/packages/server/src/agent-adapters/gemini.js

@@ -46,6 +46,59 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1.
+//
+// Gemini CLI persists chats at
+//   ~/.gemini/tmp/<basename(cwd)>/chats/session-<ISO-ts>-<short-id>.json
+// (single-JSON-object shape that matches parseGeminiJson, verified
+// 2026-05-02 substrate probe). Pick the most recently modified file whose
+// mtime is at-or-after `session.meta.createdAt`. Falls back to walking
+// every project directory under `~/.gemini/tmp/*/chats/` if the basename
+// heuristic produces no candidate (e.g., Gemini renormalized the project
+// name to deduplicate against an existing one).
+// ──────────────────────────────────────────────────────────────────────────
+
+async function resolveTranscriptPath(session) {
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const createdAtMs = session.meta.createdAt
+    ? Date.parse(session.meta.createdAt)
+    : 0;
+  const tmpRoot = path.join(os.homedir(), '.gemini', 'tmp');
+  const cwdBase = path.basename(session.meta.cwd);
+  const primary = path.join(tmpRoot, cwdBase, 'chats');
+  const extras = [];
+  try {
+    for (const proj of fs.readdirSync(tmpRoot)) {
+      const candidate = path.join(tmpRoot, proj, 'chats');
+      if (candidate !== primary) extras.push(candidate);
+    }
+  } catch (_) { /* tmp root absent */ }
+  let bestPath = null;
+  let bestMtime = -Infinity;
+  const scan = (dir) => {
+    let entries;
+    try { entries = fs.readdirSync(dir); } catch (_) { return; }
+    for (const name of entries) {
+      if (!name.startsWith('session-') || !name.endsWith('.json')) continue;
+      const full = path.join(dir, name);
+      let st;
+      try { st = fs.statSync(full); } catch (_) { continue; }
+      if (createdAtMs && st.mtimeMs < createdAtMs) continue;
+      if (st.mtimeMs > bestMtime) {
+        bestMtime = st.mtimeMs;
+        bestPath = full;
+      }
+    }
+  };
+  scan(primary);
+  if (!bestPath) for (const dir of extras) scan(dir);
+  return bestPath;
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Gemini CLI session JSON format (NOT JSONL).
 //
@@ -177,6 +230,8 @@ function buildMnestraBlock({ secrets } = {}) {
 const geminiAdapter = {
   name: 'gemini',
   sessionType: 'gemini',
+  // Sprint 50 T3 — see claude.js for rationale.
+  displayName: 'Gemini CLI',
   matches: (cmd) => typeof cmd === 'string' && /gemini/i.test(cmd),
   spawn: {
     binary: 'gemini',
@@ -199,6 +254,8 @@ const geminiAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. Walks ~/.gemini/tmp/<proj>/chats.
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'pay-per-token',
   // Sprint 47 T3 — Gemini's CLI is paste-friendly per the single-JSON-object

package/packages/server/src/agent-adapters/grok.js

@@ -121,6 +121,83 @@ function statusFor(data) {
   return null;
 }
 
+// ──────────────────────────────────────────────────────────────────────────
+// resolveTranscriptPath — Sprint 50 T1.
+//
+// Grok stores messages in `~/.grok/grok.db` (SQLite, STRICT schema requiring
+// SQLite ≥3.37 — macOS system sqlite3 3.36 cannot read it; better-sqlite3
+// bundles a recent build). The bundled hook (vendored to ~/.claude/hooks/)
+// can't `require('better-sqlite3')` because that path is outside TermDeck's
+// node_modules tree. So `resolveTranscriptPath` does the SQLite extraction
+// in-process here (the server has better-sqlite3 as a top-level dep), writes
+// the messages as a JSON envelope to `os.tmpdir()/termdeck-grok-<id>.json`,
+// and returns the tempfile path. The hook then reads that path with
+// `parseGrokJson` (a flat JSON-array parser — no SQLite needed downstream).
+//
+// Workspace mapping: grok.db's `workspaces.canonical_path` is the agent's
+// cwd-at-startup. We match against `session.meta.cwd` to find the
+// workspace_id, then pick the most recent session in that workspace whose
+// `created_at >= session.meta.createdAt` (allowing a small clock-skew
+// epsilon). Returns null gracefully if better-sqlite3 isn't loadable, the
+// DB doesn't open, the workspace isn't found, or no session matches.
+// ──────────────────────────────────────────────────────────────────────────
+
+const _GROK_RESOLVE_EPSILON_MS = 5_000;
+
+async function resolveTranscriptPath(session) {
+  if (!session || !session.meta || !session.meta.cwd) return null;
+  const fs = require('fs');
+  const path = require('path');
+  const os = require('os');
+  let Database;
+  try { Database = require('better-sqlite3'); }
+  catch (_) { return null; }  // dep missing → no-op
+  const dbPath = path.join(os.homedir(), '.grok', 'grok.db');
+  if (!fs.existsSync(dbPath)) return null;
+  let db;
+  try {
+    db = new Database(dbPath, { readonly: true, fileMustExist: true });
+  } catch (_) { return null; }
+  try {
+    const ws = db.prepare(
+      'SELECT id FROM workspaces WHERE canonical_path = ? LIMIT 1'
+    ).get(session.meta.cwd);
+    if (!ws) return null;
+    const createdAtMs = session.meta.createdAt
+      ? Date.parse(session.meta.createdAt) - _GROK_RESOLVE_EPSILON_MS
+      : 0;
+    const grokSession = db.prepare(
+      'SELECT id, created_at FROM sessions WHERE workspace_id = ? ORDER BY created_at DESC LIMIT 1'
+    ).get(ws.id);
+    if (!grokSession) return null;
+    if (createdAtMs && Date.parse(grokSession.created_at) < createdAtMs) {
+      return null;  // most recent grok session predates this panel — no match
+    }
+    const rows = db.prepare(
+      'SELECT message_json FROM messages WHERE session_id = ? ORDER BY seq ASC'
+    ).all(grokSession.id);
+    if (!rows || rows.length === 0) return null;
+    const envelope = [];
+    for (const row of rows) {
+      let parsed;
+      try { parsed = JSON.parse(row.message_json); } catch (_) { continue; }
+      if (!parsed || typeof parsed !== 'object') continue;
+      const role = parsed.role;
+      if (role !== 'user' && role !== 'assistant') continue;
+      envelope.push({ role, content: parsed.content });
+    }
+    if (envelope.length === 0) return null;
+    const safeId = String(session.id || `unknown-${Date.now()}`).replace(/[^a-zA-Z0-9._-]/g, '_');
+    const tmpfile = path.join(os.tmpdir(), `termdeck-grok-${safeId}.json`);
+    fs.writeFileSync(tmpfile, JSON.stringify(envelope), 'utf8');
+    return tmpfile;
+  } catch (_) {
+    return null;
+  } finally {
+    try { db.close(); } catch (_) { /* fail-soft */ }
+  }
+}
+
 // ──────────────────────────────────────────────────────────────────────────
 // parseTranscript — Grok stores messages in SQLite (~/.grok/grok.db), not
 // in a JSONL file. The adapter contract is `(raw: string) => Memory[]`, so
@@ -360,6 +437,8 @@ function _mergeMnestraIntoGrokSettings(rawText, { secrets } = {}) {
 const grokAdapter = {
   name: 'grok',
   sessionType: 'grok',
+  // Sprint 50 T3 — see claude.js for rationale.
+  displayName: 'Grok CLI',
   matches: (cmd) => typeof cmd === 'string' && /(?:^|\s|\/)grok(?:\b|$)/i.test(cmd),
   spawn: {
     binary: 'grok',
@@ -382,6 +461,9 @@ const grokAdapter = {
   },
   statusFor,
   parseTranscript,
+  // Sprint 50 T1 — 10th adapter field. SQLite extraction → tempfile JSON
+  // envelope (see header above for rationale + workspace mapping).
+  resolveTranscriptPath,
   bootPromptTemplate,
   costBand: 'subscription',
   // Sprint 47 T3 — Grok's Bun+OpenTUI input box hasn't been empirically

package/packages/server/src/index.js

@@ -9,6 +9,7 @@ const path = require('path');
 const os = require('os');
 const fs = require('fs');
 const dns = require('dns');
+const { spawn: spawnChild } = require('child_process');
 const { v4: uuidv4 } = require('uuid');
 const { createCachedLookup, createFailureLogger } = require('./rumen-pool-resilience');
 
@@ -128,6 +129,97 @@ function readTermdeckSecretsForPty() {
 // Test hook — clear the cache between tests that mutate the on-disk file.
 function _resetTermdeckSecretsCache() { _termdeckSecretsCache = null; }
 
+// Sprint 50 T1 — Per-agent SessionEnd hook trigger.
+//
+// `_spawnSessionEndHookImpl` is the production spawn path; tests swap it
+// out via `_setSpawnSessionEndHookImplForTesting` to capture the
+// payload + arguments deterministically. The reason this indirection
+// exists rather than mocking `child_process.spawn`: `node:test` doesn't
+// run detached + stdio:['pipe','ignore','ignore'] children inside the
+// test runner (verified — direct spawn with the same options fails to
+// even invoke the script's first line). Mocking `child_process` would
+// require module-level mocking which the runner doesn't support out of
+// the box. A single-function injection keeps the surface tiny.
+function _defaultSpawnSessionEndHookImpl(hookPath, payload, env) {
+  const child = spawnChild('node', [hookPath], {
+    stdio: ['pipe', 'ignore', 'ignore'],
+    detached: true,
+    env,
+  });
+  child.on('error', (err) => {
+    console.error('[onPanelClose] hook spawn error:', err && err.message ? err.message : err);
+  });
+  try {
+    child.stdin.write(JSON.stringify(payload));
+    child.stdin.end();
+  } catch (err) {
+    console.error('[onPanelClose] hook stdin write failed:', err && err.message ? err.message : err);
+  }
+  child.unref();
+  return child;
+}
+let _spawnSessionEndHookImpl = _defaultSpawnSessionEndHookImpl;
+function _setSpawnSessionEndHookImplForTesting(fn) {
+  _spawnSessionEndHookImpl = typeof fn === 'function' ? fn : _defaultSpawnSessionEndHookImpl;
+}
+
+// Fires when a panel's PTY exits. Routes through the adapter registry's
+// new `resolveTranscriptPath` field (10th adapter field, Sprint 50) and
+// invokes the bundled `~/.claude/hooks/memory-session-end.js` with the
+// right payload so Codex / Gemini / Grok panels write a `session_summary`
+// row the same way Claude Code already does.
+//
+// Skip rules (in order):
+//   1. Claude — its own SessionEnd hook (registered in
+//      ~/.claude/settings.json) ingests Claude rows. Double-firing here
+//      would either insert two rows per session or race the Claude hook.
+//   2. Adapters without `resolveTranscriptPath` — older adapters or types
+//      not in the registry (shell, python-server, one-shot). No-op.
+//   3. `resolveTranscriptPath` returns null — adapter declares no
+//      transcript exists for this session (panel never sent a turn).
+//   4. ~/.claude/hooks/memory-session-end.js missing — user hasn't
+//      installed the TermDeck stack hook. No-op.
+//
+// Fail-soft contract: any error logs to stderr and exits cleanly. Never
+// blocks panel teardown — the spawn is fire-and-forget (detached + unref).
+//
+// `source_agent` is included in the payload (T2 consumes it via the new
+// `memory_items.source_agent` column). T1 just passes the value; if T2
+// hasn't migrated the column yet at the moment of first fire, Supabase
+// rejects the row and the hook logs `supabase-insert-failed: HTTP 4xx`.
+async function onPanelClose(session) {
+  try {
+    if (!session || !session.meta) return;
+    const adapter = AGENT_ADAPTERS[session.meta.type]
+      || Object.values(AGENT_ADAPTERS).find((a) => a.sessionType === session.meta.type);
+    if (!adapter) return;
+    if (adapter.sessionType === 'claude-code') return;
+    if (typeof adapter.resolveTranscriptPath !== 'function') return;
+
+    const transcriptPath = await adapter.resolveTranscriptPath(session);
+    if (!transcriptPath) return;
+
+    const hookPath = path.join(os.homedir(), '.claude', 'hooks', 'memory-session-end.js');
+    if (!fs.existsSync(hookPath)) return;
+
+    const payload = {
+      transcript_path: transcriptPath,
+      cwd: session.meta.cwd,
+      session_id: session.id,
+      sessionType: adapter.sessionType,
+      // Sprint 50 — T2 consumes this via the new memory_items.source_agent column.
+      source_agent: adapter.name,
+    };
+
+    _spawnSessionEndHookImpl(hookPath, payload, {
+      ...process.env,
+      ...readTermdeckSecretsForPty(),
+    });
+  } catch (err) {
+    console.error('[onPanelClose] error:', err && err.message ? err.message : err);
+  }
+}
+
 // Sprint 37 T3 — lazy resolution of T2's CLI modules. The orchestration-preview
 // helper is decoupled from T2's templates.js / init-project.js; we resolve
 // them here and pass them into the helper. If a module is missing (e.g.
@@ -926,6 +1018,15 @@ function createServer(config) {
 
           // Fire-and-forget session log (T2.5)
           writeSessionLog({ session, config, db, getSessionHistory });
+
+          // Sprint 50 T1 — fire the bundled SessionEnd hook for non-Claude
+          // panels so Codex / Gemini / Grok /exits write to Mnestra the way
+          // Claude Code already does. onPanelClose handles dispatch +
+          // skip-claude + skip-when-no-transcript. Fire-and-forget; any
+          // error logs and never blocks teardown.
+          onPanelClose(session).catch((err) => {
+            console.error('[onPanelClose] async error:', err && err.message ? err.message : err);
+          });
         });
 
         // Wire command logging to SQLite + RAG
@@ -1324,6 +1425,9 @@ function createServer(config) {
   //   • binary      — canonical command name; client matches `^binary\b` (i)
   //   • costBand    — 'free' | 'pay-per-token' | 'subscription' (Sprint 46
   //                   surfaces this in PLANNING.md cost annotations)
+  //   • displayName — Sprint 50 T3: human-readable label for launcher buttons
+  //                   and panel headers. Backwards-compat: existing clients
+  //                   that ignore the field continue to work unchanged.
   // Functions / RegExps are NOT serialized — match logic lives client-side
   // and uses the binary as the prefix anchor. Adapter-specific shorthand
   // (e.g. `cc` → `claude`) is normalized in app.js before this lookup.
@@ -1333,6 +1437,29 @@ function createServer(config) {
       sessionType: a.sessionType,
       binary: a.spawn && a.spawn.binary,
       costBand: a.costBand,
+      displayName: a.displayName || a.name,
+    }));
+    res.json(list);
+  });
+
+  // GET /api/agents - Sprint 50 T3: richer adapter projection used by the
+  // dashboard launcher to render one button per registered agent and by the
+  // mixed-agent dogfood inject script to discover available agents. Adds
+  // the full spawn descriptor (binary + defaultArgs) so callers don't need
+  // to re-derive it from the binary alone. Coexists with /api/agent-adapters
+  // (kept stable for the launcher-resolver client contract).
+  app.get('/api/agents', (req, res) => {
+    const list = Object.values(AGENT_ADAPTERS).map((a) => ({
+      name: a.name,
+      sessionType: a.sessionType,
+      displayName: a.displayName || a.name,
+      spawn: {
+        binary: (a.spawn && a.spawn.binary) || a.name,
+        defaultArgs: (a.spawn && Array.isArray(a.spawn.defaultArgs))
+          ? a.spawn.defaultArgs.slice()
+          : [],
+      },
+      costBand: a.costBand,
     }));
     res.json(list);
   });
@@ -2228,4 +2355,9 @@ module.exports = {
   // Sprint 48 T4 — exported for unit testing the secrets.env → PTY env merge.
   readTermdeckSecretsForPty,
   _resetTermdeckSecretsCache,
+  // Sprint 50 T1 — exported for unit testing the per-agent SessionEnd
+  // hook trigger (skip-claude, no-transcript, no-hook-installed,
+  // payload shape, fire-and-forget).
+  onPanelClose,
+  _setSpawnSessionEndHookImplForTesting,
 };