@jhizzard/termdeck 0.14.0 → 0.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jhizzard/termdeck",
-  "version": "0.14.0",
+  "version": "0.15.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

@@ -2479,56 +2479,20 @@
         return;
       }
 
-      // Sprint 45 T4: registry-driven shorthand resolution. Pre-Sprint-45
-      // had hardcoded claude/cc/gemini/python branches here; now the type
-      // detection consults state.agentAdapters (loaded from
-      // /api/agent-adapters at init), and only the Claude `cc` alias and
-      // the python-server detection (no adapter exists) stay as
-      // special-cases below. Adapter matching uses an anchored prefix on
-      // the adapter's binary name (`^binary\b`, case-insensitive) which
-      // fits all four Sprint-45 adapters (claude / codex / gemini / grok)
-      // since each binary is uniquely named.
-      let resolvedCommand = command;
-      let resolvedType = 'shell';
-      let resolvedCwd = undefined;
-      let resolvedProject = project || undefined;
-
-      // Claude `cc` alias normalization. Documented Claude shorthand —
-      // does not generalize to other adapters, so it stays in client UX,
-      // not in the server-side adapter contract.
-      let canonical = command;
-      if (/^cc\b/i.test(canonical)) {
-        canonical = canonical.replace(/^cc\b/i, 'claude');
-      }
-
-      const adapter = (state.agentAdapters || []).find((a) =>
-        a && a.binary && new RegExp(`^${a.binary}\\b`, 'i').test(canonical)
-      );
-
-      if (adapter) {
-        resolvedType = adapter.sessionType;
-        // Claude shorthand: `claude <project-or-cwd>` rewrites to `claude`
-        // and routes the trailing arg into either the project dropdown
-        // (if it's a known project name) or the cwd parameter. Other
-        // adapters' arg-parsing — codex sub-commands, gemini -p flag,
-        // grok --model — pass through unchanged via resolvedCommand.
-        if (adapter.name === 'claude') {
-          const argMatch = canonical.match(/^claude\s+(?:code\s+)?(.+)/i);
-          if (argMatch) {
-            const arg = argMatch[1].trim();
-            if (state.config.projects && state.config.projects[arg]) {
-              resolvedProject = arg;
-            } else {
-              resolvedCwd = arg;
-            }
-          }
-          resolvedCommand = adapter.binary;
-        }
-      } else if (/^python3?\b.*(?:runserver|uvicorn|flask|gunicorn)/i.test(canonical)) {
-        // python-server is a server SUBTYPE for status badges, not an
-        // agent adapter. No registry entry for it; detection stays here.
-        resolvedType = 'python-server';
-      }
+      // Sprint 45 T4 + Sprint 46 T4: resolver extracted to
+      // packages/client/public/launcher-resolver.js so the same routing
+      // logic runs in the browser AND under `node --test` (see
+      // tests/launcher-resolver.test.js for the contract pin). Sprint 46
+      // T4 also extended the python-server preemptive regex to recognize
+      // `http.server` so the python topbar quick-launch button is typed
+      // correctly from the first frame.
+      const { resolvedCommand, resolvedType, resolvedCwd, resolvedProject } =
+        LauncherResolver.resolve(
+          command,
+          project,
+          state.agentAdapters,
+          state.config.projects
+        );
 
       const session = await api('POST', '/api/sessions', {
         command: resolvedCommand,
@@ -4493,18 +4457,28 @@
       for (const sess of data.sessions) {
         const id = sess.sessionId || sess.session_id || 'unknown';
         const shortId = id.slice(0, 8);
-        const type = sess.type || 'shell';
+        // Server (/api/transcripts/recent) returns { sessions: [{ session_id, chunks: [...] }] }
+        // with chunks already grouped per session in DESC created_at order. Type/project
+        // metadata isn't on the transcripts table — fall back to optional fields if any
+        // future server enrichment ships them.
+        const chunks = Array.isArray(sess.chunks) ? sess.chunks : [];
+        const type = sess.type || (chunks.length ? 'session' : 'shell');
         const project = sess.project || '';
-        const lines = sess.lines || sess.preview || [];
-        const lineCount = sess.totalLines || lines.length;
+        const totalChunks = sess.totalLines || chunks.length;
+        // Build preview from the most-recent chunks. Server returns DESC order, so
+        // the first 6 entries are the newest — reverse for natural top-down reading.
+        const previewChunks = chunks.slice(0, 6).reverse();
+        const previewText = sess.preview
+          ? (Array.isArray(sess.preview) ? sess.preview.join('\n') : String(sess.preview))
+          : previewChunks.map(c => (c && typeof c.content === 'string') ? c.content : '').join('');
         html += `<div class="transcript-session" data-session-id="${escapeHtml(id)}">
           <div class="ts-header">
             <span class="ts-id">${escapeHtml(shortId)}</span>
             <span class="ts-type">${escapeHtml(type)}</span>
             ${project ? `<span class="ts-project">${escapeHtml(project)}</span>` : ''}
-            <span class="ts-lines">${lineCount} lines</span>
+            <span class="ts-lines">${totalChunks} chunks</span>
           </div>
-          <pre class="ts-preview">${escapeHtml(lines.slice(-6).join('\n'))}</pre>
+          <pre class="ts-preview">${escapeHtml(previewText)}</pre>
         </div>`;
       }
       body.innerHTML = html;
@@ -4544,7 +4518,11 @@
         const id = result.sessionId || result.session_id || 'unknown';
         const shortId = id.slice(0, 8);
         const line = result.line || result.content || '';
-        const ts = result.timestamp ? new Date(result.timestamp).toLocaleTimeString() : '';
+        // Server (/api/transcripts/search) sends `created_at`; legacy `timestamp` kept
+        // as a fallback in case a future enrichment swaps the field name.
+        const tsSource = result.timestamp || result.created_at || '';
+        const tsDate = tsSource ? new Date(tsSource) : null;
+        const ts = (tsDate && !isNaN(tsDate.getTime())) ? tsDate.toLocaleTimeString() : '';
         html += `<div class="transcript-result" data-session-id="${escapeHtml(id)}">
           <div class="tr-meta">
             <span class="tr-session">${escapeHtml(shortId)}</span>

package/packages/client/public/graph.js

@@ -552,7 +552,7 @@
       .attr('stroke-width', 1.2)
       .attr('filter', 'url(#nodeGlow)')
       .style('cursor', 'pointer')
-      .on('mouseenter', (event, d) => onNodeHover(d.id))
+      .on('mouseenter', (event, d) => { onNodeHover(d.id); showNodeTooltip(event, d); })
       .on('mouseleave', () => onNodeHover(null))
       .on('click', (event, d) => onNodeClick(d))
       .call(window.d3.drag()
@@ -738,6 +738,28 @@
     tip.hidden = false;
     moveTooltip(event);
   }
+
+  // Sprint 46 T1 — node hover tooltip. Shows project (color-coded) + a short
+  // content snippet so the user can scan the graph without having to open the
+  // drawer for every node. Click still opens the full detail drawer.
+  function showNodeTooltip(event, node) {
+    const tip = $('graphTooltip');
+    if (!tip || !node) return;
+    const proj = node.project || 'global';
+    const text = escapeHtml(truncate(node.label || node.snippet || '(no content)', 80));
+    const meta = node.source_type ? `<span style="opacity:0.7">${escapeHtml(node.source_type)}</span>` : '';
+    tip.innerHTML = `<strong style="color:${hashHue(proj)}">${escapeHtml(proj)}</strong> ${meta} · ${text}`;
+    tip.hidden = false;
+    moveTooltip(event);
+  }
+
+  function escapeHtml(s) {
+    return String(s == null ? '' : s)
+      .replace(/&/g, '&amp;')
+      .replace(/</g, '&lt;')
+      .replace(/>/g, '&gt;')
+      .replace(/"/g, '&quot;');
+  }
   function moveTooltip(event) {
     const tip = $('graphTooltip');
     if (tip.hidden) return;

package/packages/client/public/index.html

@@ -372,6 +372,7 @@
   <script src="https://cdn.jsdelivr.net/npm/@xterm/xterm@5.5.0/lib/xterm.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-fit@0.10.0/lib/addon-fit.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/@xterm/addon-web-links@0.11.0/lib/addon-web-links.min.js"></script>
+  <script src="launcher-resolver.js" defer></script>
   <script src="app.js" defer></script>
 </body>
 </html>

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

@@ -0,0 +1,68 @@
+// TermDeck launcher resolver — extracted Sprint 46 T4
+//
+// Pure function: given (command, project, agentAdapters, projects),
+// returns the resolved spawn parameters the launcher POSTs to /api/sessions.
+// Lives in its own file so the same code runs in the browser (via
+// <script src="launcher-resolver.js">) AND under `node --test` (via
+// `require('.../launcher-resolver')`). Sprint 46 T4 added this extraction
+// to close a zero-coverage gap on the client-side routing logic — see
+// tests/launcher-resolver.test.js for the contract pin.
+//
+// Sprint 45 T4 refactor lives here too: registry-driven shorthand
+// resolution. Pre-Sprint-45 had hardcoded claude/cc/gemini/python branches;
+// now the type detection consults `agentAdapters` (loaded from
+// /api/agent-adapters at init), and only the Claude `cc` alias and the
+// python-server detection (no adapter exists) stay as special-cases.
+// Adapter matching uses an anchored prefix on the adapter's binary name
+// (`^binary\b`, case-insensitive) which fits all four Sprint-45 adapters
+// (claude / codex / gemini / grok) since each binary is uniquely named.
+
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) {
+    module.exports = factory();
+  } else {
+    root.LauncherResolver = factory();
+  }
+})(typeof self !== 'undefined' ? self : this, function () {
+  function resolve(command, project, agentAdapters, projects) {
+    let resolvedCommand = command;
+    let resolvedType = 'shell';
+    let resolvedCwd;
+    let resolvedProject = project || undefined;
+
+    let canonical = command;
+    if (/^cc\b/i.test(canonical)) {
+      canonical = canonical.replace(/^cc\b/i, 'claude');
+    }
+
+    const adapter = (agentAdapters || []).find((a) =>
+      a && a.binary && new RegExp(`^${a.binary}\\b`, 'i').test(canonical)
+    );
+
+    if (adapter) {
+      resolvedType = adapter.sessionType;
+      if (adapter.name === 'claude') {
+        const argMatch = canonical.match(/^claude\s+(?:code\s+)?(.+)/i);
+        if (argMatch) {
+          const arg = argMatch[1].trim();
+          if (projects && projects[arg]) {
+            resolvedProject = arg;
+          } else {
+            resolvedCwd = arg;
+          }
+        }
+        resolvedCommand = adapter.binary;
+      }
+    } else if (/^python3?\b.*(?:runserver|uvicorn|flask|gunicorn|http\.server)/i.test(canonical)) {
+      // Sprint 46 T4: extended `http\.server` so the python topbar
+      // quick-launch button is preemptively typed correctly. Without
+      // this, the badge flickers through `shell` for ~1s before
+      // session.js's runtime detection (`/Serving HTTP on/`) catches up.
+      resolvedType = 'python-server';
+    }
+
+    return { resolvedCommand, resolvedType, resolvedCwd, resolvedProject };
+  }
+
+  return { resolve };
+});