claude-code-kanban 3.5.1 → 3.6.0

package/cli.js

@@ -42,6 +42,16 @@ const COMMANDS = {
         },
         run: runSessionViewCli,
       },
+      pin: {
+        summary: 'Pin (or unpin) a session in the sidebar of connected browser tabs',
+        usage: 'claude-code-kanban session pin <id> [--sticky] [--unpin]',
+        flags: {
+          '<id>': 'Full session id, or a unique prefix',
+          '--sticky': 'Set sticky state (always shown, top of list)',
+          '--unpin': 'Clear pin/sticky state',
+        },
+        run: runSessionPinCli,
+      },
       peek: {
         summary: 'Show the last N messages from a session',
         usage: 'claude-code-kanban session peek <id> [--limit <n>] [--json]',
@@ -361,6 +371,31 @@ async function runSessionOpenCli(args) {
   } catch (e) { reportCliError(e); return 1; }
 }
 
+async function runSessionPinCli(args) {
+  const idArg = args.find(a => !a.startsWith('--'));
+  if (!idArg) {
+    printLeafHelp('session pin', COMMANDS.session.verbs.pin);
+    return 1;
+  }
+  const state = args.includes('--unpin') ? 'none' : args.includes('--sticky') ? 'sticky' : 'pinned';
+  const resolved = await resolveSessionByIdOrPrefix(idArg);
+  if (!resolved) return 1;
+  try {
+    const res = await cliFetch('/api/session/pin', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id: resolved.id, state })
+    });
+    if (!res.ok) {
+      console.error(`Pin failed (${res.status}): ${await res.text()}`);
+      return 1;
+    }
+    const label = state === 'none' ? 'unpinned' : state;
+    console.log(`Session ${label}: ${resolved.id}${resolved.customTitle ? ` (${resolved.customTitle})` : ''}`);
+    return 0;
+  } catch (e) { reportCliError(e); return 1; }
+}
+
 async function runSessionViewCli(args) {
   const idArg = args.find(a => !a.startsWith('--'));
   if (!idArg) {

package/lib/parsers.js

@@ -182,10 +182,22 @@ function scrapeScalarFromBlob(blob, re) {
   try { return JSON.parse(`"${m[1]}"`); } catch (e) { return null; }
 }
 
+const sessionInfoCache = new Map();
+const SESSION_INFO_CACHE_MAX = 2000;
+
 function readSessionInfoFromJsonl(jsonlPath) {
   const result = { slug: null, projectPath: null, cwd: null, gitBranch: null, customTitle: null };
   let stat;
   let fd;
+  try {
+    stat = statSync(jsonlPath);
+    const cached = sessionInfoCache.get(jsonlPath);
+    if (cached && cached.mtimeMs === stat.mtimeMs && cached.size === stat.size) {
+      return { ...cached.result, customTitle: readCustomTitle(jsonlPath, stat) };
+    }
+  } catch (_) {
+    return result;
+  }
   // State shared across head-chunk parse, leftover flush, and tail parse.
   let lastCwdFromHead = null;
   const applyLine = (line) => {
@@ -200,7 +212,6 @@ function readSessionInfoFromJsonl(jsonlPath) {
     } catch (e) {}
   };
   try {
-    stat = statSync(jsonlPath);
     fd = fs.openSync(jsonlPath, 'r');
     const CHUNK_SIZE = 16384;
     const TAIL_SIZE = 16384;
@@ -264,6 +275,14 @@ function readSessionInfoFromJsonl(jsonlPath) {
     if (fd !== undefined) { try { fs.closeSync(fd); } catch (e) {} }
   }
 
+  if (stat) {
+    const { customTitle: _ct, ...rest } = result;
+    sessionInfoCache.set(jsonlPath, { mtimeMs: stat.mtimeMs, size: stat.size, result: rest });
+    if (sessionInfoCache.size > SESSION_INFO_CACHE_MAX) {
+      const firstKey = sessionInfoCache.keys().next().value;
+      sessionInfoCache.delete(firstKey);
+    }
+  }
   result.customTitle = readCustomTitle(jsonlPath, stat);
   return result;
 }
@@ -695,6 +714,27 @@ function buildAgentProgressMap(jsonlPath) {
 
 function readCompactSummaries(jsonlPath) {
   const results = [];
+  // Inline format: newer Claude Code stores the summary directly in the parent
+  // session JSONL as a user message with isCompactSummary: true (no subagent file).
+  try {
+    const content = readFileSync(jsonlPath, 'utf8');
+    for (const line of content.split('\n')) {
+      if (!line.trim() || !line.includes('isCompactSummary')) continue;
+      try {
+        const obj = JSON.parse(line);
+        if (!obj.isCompactSummary) continue;
+        const c = obj.message?.content;
+        let text = typeof c === 'string'
+          ? c
+          : Array.isArray(c) ? c.filter(b => b?.type === 'text' && b.text).map(b => b.text).join('\n') : '';
+        if (!text) continue;
+        // Strip the "This session is being continued..." preamble if present.
+        text = text.replace(/^This session is being continued[^\n]*\n+(The summary below[^\n]*\n+)?/i, '').trim();
+        if (text) results.push({ timestamp: obj.timestamp, summary: text });
+      } catch (_) {}
+    }
+  } catch (_) {}
+  // Legacy format: summary lives in subagents/agent-acompact-*.jsonl.
   try {
     const subagentsDir = path.join(path.dirname(jsonlPath), path.basename(jsonlPath, '.jsonl'), 'subagents');
     const files = readdirSync(subagentsDir).filter(f => f.startsWith('agent-acompact-') && f.endsWith('.jsonl'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "3.5.1",
+  "version": "3.6.0",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "bin": {
@@ -51,6 +51,7 @@
     "public/**/*"
   ],
   "devDependencies": {
+    "@biomejs/biome": "2.4.14",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
     "husky": "^9.1.7"

package/plugin/plugins/claude-code-kanban/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "claude-code-kanban",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Agent activity tracking for claude-code-kanban dashboard"
 }

package/plugin/plugins/claude-code-kanban/skills/kanban/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kanban
-description: Drive the claude-code-kanban browser dashboard from this Claude session. Use this skill when the user mentions "kanban" together with "session" — e.g. "open this session in kanban", "show kanban", "focus current session in kanban", "preview this file in kanban", or asks to peek/view a kanban session.
+description: Drive the claude-code-kanban browser dashboard from this Claude session. Use this skill when the user mentions "kanban" together with "session" — e.g. "open this session in kanban", "show kanban", "focus current session in kanban", "pin/unpin a session in kanban", "preview this file in kanban", or asks to peek/view a kanban session.
 compatibility: Requires the `claude-code-kanban` CLI on PATH and the server running locally (default port 3456).
 ---
 
@@ -22,6 +22,20 @@ claude-code-kanban session open ${CLAUDE_SESSION_ID}
 
 Trigger phrases: "show this session in kanban", "focus current session", "open in kanban".
 
+## Pin the current session in kanban
+
+Pins the active Claude session in the sidebar so it stays visible regardless of filters. Three states: `pinned` (default), `sticky` (always at the top), or cleared via `--unpin`.
+
+```bash
+claude-code-kanban session pin ${CLAUDE_SESSION_ID}            # pin
+claude-code-kanban session pin ${CLAUDE_SESSION_ID} --sticky   # sticky at top
+claude-code-kanban session pin ${CLAUDE_SESSION_ID} --unpin    # clear
+```
+
+State applies to every connected browser tab (broadcast via SSE) and persists in each tab's localStorage. With no tabs open the command is a no-op.
+
+Trigger phrases: "pin this session", "pin in kanban", "make this session sticky", "unpin session".
+
 ## Preview a file in kanban
 
 Opens a markdown file in the preview modal:

package/public/app.js

@@ -1335,6 +1335,19 @@ function toggleSessionSticky(sessionId) {
   renderSessions();
 }
 
+function handleSessionPinEvent({ id, state }) {
+  if (!id) return;
+  pinnedSessionIds.delete(id);
+  stickySessionIds.delete(id);
+  if (state === 'pinned') pinnedSessionIds.add(id);
+  if (state === 'sticky') {
+    pinnedSessionIds.add(id);
+    stickySessionIds.add(id);
+  }
+  savePinnedSessions();
+  renderSessions();
+}
+
 function getSessionPinState(sessionId) {
   if (stickySessionIds.has(sessionId)) return 'sticky';
   if (pinnedSessionIds.has(sessionId)) return 'pinned';
@@ -1610,9 +1623,9 @@ function getToolDetail(tool, params, detail) {
     const parts = [];
     if (params.offset) parts.push(`L${params.offset}`);
     if (params.limit) parts.push(`+${params.limit}`);
-    if (parts.length) extra = ` <span style="color:var(--text-muted);opacity:.7">${parts.join(' ')}</span>`;
+    if (parts.length) extra = ` <span style="color:var(--text-muted)">${parts.join(' ')}</span>`;
   }
-  return ` <span style="color:var(--text-muted)">${escapeHtml(detail)}</span>${extra}`;
+  return ` <span style="color:var(--text-secondary)">${escapeHtml(detail)}</span>${extra}`;
 }
 function renderTaskResult(toolResult) {
   if (!toolResult) return '';
@@ -2264,7 +2277,10 @@ function renderSessions() {
     const hasInProgress = session.inProgress > 0;
     const isLive =
       hasInProgress || (session.modifiedAt && Date.now() - new Date(session.modifiedAt).getTime() <= LIVE_INDICATOR_MS);
-    const sessionName = session.name || session.id;
+    const rawName = session.name || session.id;
+    const sessionName = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(rawName)
+      ? rawName.slice(0, 8)
+      : rawName;
     const useGrouped = sessionFilter === 'active' && session.project;
     const primaryName = useGrouped ? sessionName : session.project ? session.project.split('/').pop() : sessionName;
     const secondaryName = useGrouped ? null : session.project ? sessionName : null;
@@ -2286,8 +2302,9 @@ function renderSessions() {
     const showCtx = !!session.contextStatus;
     const linkedDocsCount = getSessionPreviewPaths(session.id).length;
     const bookmarksCount = loadPins(session.id).length;
+    const tempClass = session.hasRecentLog || session.inProgress || session.hasWaitingForUser ? 'warm' : 'stale';
     return `
-          <button onclick="fetchTasks('${session.id}')" data-session-id="${session.id}" class="session-item ${isActive ? 'active' : ''} ${session.hasWaitingForUser ? 'permission-pending' : ''} ${!session.hasRecentLog && !session.inProgress && !session.hasWaitingForUser ? 'stale' : ''} ${showCtx ? 'has-context' : ''}" title="${tooltip}">
+          <button onclick="fetchTasks('${session.id}')" data-session-id="${session.id}" class="session-item ${isActive ? 'active' : ''} ${session.hasWaitingForUser ? 'permission-pending' : ''} ${tempClass} ${showCtx ? 'has-context' : ''}" title="${tooltip}">
             <span class="session-pin-btn${pinClass}" onclick="event.stopPropagation();toggleSessionPin('${escapeHtml(session.id)}')" title="${pinTitle} session">${SESSION_PIN_SVG}</span>
             <div class="session-name">${escapeHtml(primaryName)}</div>
             ${secondaryName ? `<div class="session-secondary">${escapeHtml(secondaryName)}</div>` : ''}
@@ -3944,6 +3961,19 @@ function matchKey(e, ...keys) {
   return keys.some((k) => e.key === k || e.code === k);
 }
 
+const MODAL_ESC_PRIORITY = ['preview-modal', 'msg-detail-modal', 'plan-modal'];
+const MODAL_CLOSERS = {
+  'preview-modal': () => closePreviewModal(),
+  'msg-detail-modal': () => {
+    closeMsgDetailModal();
+    msgDetailFollowLatest = false;
+  },
+  'plan-modal': () => closePlanModal(),
+  'team-modal': () => closeTeamModal(),
+  'agent-modal': () => closeAgentModal(),
+  'help-modal': () => closeHelpModal(),
+};
+
 document.addEventListener('keydown', (e) => {
   if (e.target.tagName === 'INPUT' || e.target.tagName === 'TEXTAREA' || e.target.tagName === 'SELECT') {
     return;
@@ -3956,9 +3986,13 @@ document.addEventListener('keydown', (e) => {
         closeScratchpad();
         return;
       }
-      // biome-ignore lint/suspicious/useIterableCallbackReturn: forEach side-effect
-      document.querySelectorAll('.modal-overlay.visible').forEach((m) => m.classList.remove('visible'));
-      msgDetailFollowLatest = false;
+      // Close only the topmost so a child Esc doesn't also dismiss its parent.
+      const visible = [...document.querySelectorAll('.modal-overlay.visible')];
+      const topId = MODAL_ESC_PRIORITY.find((id) => visible.some((m) => m.id === id)) || visible[visible.length - 1].id;
+      const close = MODAL_CLOSERS[topId];
+      if (close) close();
+      else document.getElementById(topId).classList.remove('visible');
+      e.stopImmediatePropagation();
     } else if (
       e.code === 'KeyM' &&
       e.shiftKey &&
@@ -4153,6 +4187,7 @@ document.addEventListener('keydown', (e) => {
     lastTasksHash = '';
     const refreshes = [fetchSessions()];
     if (currentSessionId) refreshes.push(fetchTasks(currentSessionId));
+    refreshRateLimits();
     Promise.all(refreshes)
       .then(() => showToast('Data refreshed', 'success'))
       .finally(() => {
@@ -4227,8 +4262,24 @@ function openPreviewModal(filePath, content) {
   currentPreviewPath = filePath;
   document.getElementById('preview-modal-title').textContent = filePath.split(/[\\/]/).pop();
   const { fm, body } = /\.(md|markdown)$/i.test(filePath) ? splitFrontmatter(content) : { fm: null, body: content };
-  document.getElementById('preview-modal-body').innerHTML =
-    (fm ? renderFrontmatterBlock(fm) : '') + renderMarkdown(body);
+  const bodyEl = document.getElementById('preview-modal-body');
+  bodyEl.innerHTML = (fm ? renderFrontmatterBlock(fm) : '') + renderMarkdown(body);
+  if (!bodyEl.dataset.relLinkBound) {
+    bodyEl.addEventListener('click', (e) => {
+      const a = e.target.closest('a[href]');
+      if (!a) return;
+      const href = a.getAttribute('href');
+      if (!href || href.startsWith('#')) return;
+      const isAbsoluteUrl = /^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith('//');
+      const isAbsolutePath = href.startsWith('/') || /^[a-zA-Z]:[\\/]/.test(href);
+      if (isAbsoluteUrl) return;
+      if (!/\.(md|markdown)(#.*)?$/i.test(href)) return;
+      e.preventDefault();
+      const cleanHref = href.replace(/#.*$/, '');
+      openPreviewByPath(cleanHref, isAbsolutePath ? undefined : currentPreviewPath);
+    });
+    bodyEl.dataset.relLinkBound = '1';
+  }
   document.getElementById('preview-modal-meta').textContent = filePath;
   document.getElementById('preview-modal').classList.add('visible');
   updatePreviewLinkBtn();
@@ -4299,7 +4350,6 @@ function refreshInfoModalLinkedDocs() {
   bindLinkedDocsHandlers(node, _infoModalSessionId);
 }
 
-// biome-ignore lint/correctness/noUnusedVariables: used in HTML
 function closePreviewModal() {
   resetModalFullscreen('preview-modal');
   currentPreviewPath = null;
@@ -4311,10 +4361,12 @@ function openPreviewInEditor() {
   postAndToast('/api/open-in-editor', { file: currentPreviewPath }, 'in editor');
 }
 
-async function openPreviewByPath(filePath) {
+async function openPreviewByPath(filePath, base) {
   if (!filePath) return;
   try {
-    const r = await fetch(`/api/preview?path=${encodeURIComponent(filePath)}`);
+    const qs = new URLSearchParams({ path: filePath });
+    if (base) qs.set('base', base);
+    const r = await fetch(`/api/preview?${qs}`);
     if (!r.ok) {
       showToast('Preview file unavailable');
       return;
@@ -4358,22 +4410,33 @@ async function handlePreviewOpenEvent(data) {
   openPreviewModal(filePath, content);
 }
 
+function getSessionBaseDir(sessionId) {
+  const s = sessions.find((x) => x.id === sessionId);
+  return s?.cwd || s?.project || '';
+}
+
 function renderLinkedDocsHtml(sessionId) {
   const paths = getSessionPreviewPaths(sessionId);
   if (!paths.length) return '';
+  const baseDir = getSessionBaseDir(sessionId);
   const items = paths
     .map((p, i) => {
       const name = p.split(/[\\/]/).pop();
-      return `<a href="#" class="linked-doc-link" data-idx="${i}" title="${escapeHtml(p)}" style="color:var(--accent-text);text-decoration:underline;text-decoration-style:dotted;text-underline-offset:3px;">${escapeHtml(name)}</a>`;
+      const rel = baseDir ? toRelativeIfUnder(p, baseDir) : null;
+      const pathSpan = rel ? `<span class="linked-doc-path" title="${escapeHtml(p)}">${escapeHtml(rel)}</span>` : '';
+      return `<li class="linked-doc-item">
+        <a href="#" class="linked-doc-link" data-idx="${i}" title="${escapeHtml(p)}">${escapeHtml(name)}</a>
+        ${pathSpan}
+      </li>`;
     })
-    .join(', ');
+    .join('');
   return `<div class="linked-docs-section" style="margin-bottom:16px;font-size:12px;">
     <div style="font-size:11px;font-weight:500;color:var(--text-muted);text-transform:uppercase;letter-spacing:0.5px;margin-bottom:6px;display:flex;align-items:center;gap:6px;">
       ${linkSvg(12)}
       <span>Linked documents</span>
       <span style="background:var(--bg-elevated);border:1px solid var(--border);border-radius:10px;padding:0 6px;font-size:10px;color:var(--text-secondary);">${paths.length}</span>
     </div>
-    <div>${items}</div>
+    <ul class="linked-doc-list">${items}</ul>
   </div>`;
 }
 
@@ -4382,10 +4445,11 @@ function bindLinkedDocsHandlers(container, sessionId) {
   const links = container.querySelectorAll('.linked-doc-link');
   if (!links.length) return;
   const paths = getSessionPreviewPaths(sessionId);
+  const base = getSessionBaseDir(sessionId);
   for (const link of links) {
     link.addEventListener('click', (e) => {
       e.preventDefault();
-      openPreviewByPath(paths[+link.dataset.idx]);
+      openPreviewByPath(paths[+link.dataset.idx], base);
     });
   }
 }
@@ -4515,6 +4579,10 @@ function setupEventSource() {
         handleSessionOpenEvent(data);
       }
 
+      if (data.type === 'session:pin') {
+        handleSessionPinEvent(data);
+      }
+
       if (data.type === 'team-update') {
         const teamSession = sessions.find((s) => s.isTeam && s.teamName === data.teamName);
         if (teamSession) {
@@ -4730,6 +4798,18 @@ function escapeHtml(text) {
   return div.innerHTML;
 }
 
+function toRelativeIfUnder(filePath, baseDir) {
+  if (!filePath || !baseDir) return null;
+  const fp = filePath.replace(/\\/g, '/').replace(/\/+$/, '');
+  const bd = baseDir.replace(/\\/g, '/').replace(/\/+$/, '');
+  const isWin = /^[a-zA-Z]:\//.test(fp) || /^[a-zA-Z]:\//.test(bd);
+  const a = isWin ? fp.toLowerCase() : fp;
+  const b = isWin ? bd.toLowerCase() : bd;
+  if (a === b) return '.';
+  if (!a.startsWith(`${b}/`)) return null;
+  return fp.slice(bd.length + 1);
+}
+
 function renderMarkdown(text) {
   if (typeof DOMPurify !== 'undefined' && typeof marked !== 'undefined') {
     return DOMPurify.sanitize(marked.parse(text));
@@ -5725,7 +5805,11 @@ function refreshRateLimits() {
     fetch('/api/context-status')
       .then((r) => r.json())
       .then((all) => {
-        const rl = Object.values(all || {}).find((e) => e?.rate_limits)?.rate_limits || null;
+        let freshest = null;
+        for (const e of Object.values(all || {})) {
+          if (e?.rate_limits && (!freshest || (e._updatedAt || 0) > (freshest._updatedAt || 0))) freshest = e;
+        }
+        const rl = freshest?.rate_limits || null;
         const fh = rl?.five_hour?.used_percentage ?? null;
         const sd = rl?.seven_day?.used_percentage ?? null;
         const key = `${fh}|${sd}`;
@@ -5845,6 +5929,25 @@ document.addEventListener('keydown', (e) => {
   }
 });
 
+document.addEventListener('click', (e) => {
+  if (!window.__HUB__?.enabled) return;
+  const a = e.target.closest?.('a[href]');
+  if (!a) return;
+  const href = a.getAttribute('href');
+  if (!href) return;
+  let url;
+  try {
+    url = new URL(href, window.location.href);
+  } catch (_) {
+    return;
+  }
+  if (url.origin === window.location.origin) return;
+  if (url.protocol !== 'http:' && url.protocol !== 'https:') return;
+  e.preventDefault();
+  e.stopPropagation();
+  window.parent?.postMessage({ type: 'hub:openExternal', url: url.href }, '*');
+});
+
 window.hubNavigate = function hubNavigate(app, url) {
   if (!window.__HUB__?.enabled) return;
   window.parent?.postMessage({ type: 'hub:navigate', app, url }, '*');

package/public/style.css

@@ -549,14 +549,13 @@ body::before {
 
 .session-branch {
   font-size: 10px;
-  color: var(--text-muted);
+  color: var(--text-secondary);
   margin-top: 2px;
   display: block;
   font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Fira Code', monospace;
   white-space: nowrap;
   overflow: hidden;
   text-overflow: ellipsis;
-  opacity: 0.7;
 }
 
 .session-plan {
@@ -1877,7 +1876,7 @@ body::before {
   width: 16px;
   height: 16px;
   margin-top: 2px;
-  opacity: 0.6;
+  opacity: 0.9;
 }
 .msg-body {
   flex: 1;
@@ -2575,6 +2574,40 @@ body::before {
   color: var(--text-primary);
 }
 
+.linked-doc-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+}
+
+.linked-doc-item {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+  min-width: 0;
+}
+
+.linked-doc-link {
+  color: var(--accent-text);
+  text-decoration: underline;
+  text-decoration-style: dotted;
+  text-underline-offset: 3px;
+  flex-shrink: 0;
+}
+
+.linked-doc-path {
+  color: var(--text-muted);
+  font-size: 11px;
+  opacity: 0.7;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+}
+
 /* #endregion */
 
 /* #region PERMISSION_PENDING */
@@ -3678,7 +3711,39 @@ pre.mermaid svg {
 .session-item.kb-selected::before {
   width: 0;
 }
+.session-item.stale .session-time,
+.session-item.warm .session-time {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+}
+.session-item.stale .session-time::before,
+.session-item.warm .session-time::before {
+  content: '';
+  width: 6px;
+  height: 6px;
+  border-radius: 50%;
+  flex-shrink: 0;
+}
+.session-item.warm .session-time {
+  color: var(--success);
+}
+.session-item.warm .session-time::before {
+  background: var(--success);
+}
 .session-item.stale {
-  opacity: 0.6;
+  opacity: 0.85;
+}
+.session-item.stale:hover,
+.session-item.stale.active,
+.session-item.stale.kb-selected {
+  opacity: 1;
+}
+.session-item.stale .session-time {
+  color: var(--text-muted);
+}
+.session-item.stale .session-time::before {
+  background: transparent;
+  border: 1px solid var(--text-muted);
 }
 /* #endregion */

package/server.js

@@ -119,11 +119,18 @@ function isAgentFresh(agent) {
   return (Date.now() - new Date(ts).getTime()) < AGENT_TTL_MS;
 }
 
+const sessionLogStatCache = new Map();
 function getSessionLogStat(meta) {
   if (!meta.jsonlPath) return { mtime: null, hasMessages: false };
   try {
     const st = statSync(meta.jsonlPath);
-    return { mtime: st.mtimeMs, hasMessages: st.size > 1000 };
+    const cached = sessionLogStatCache.get(meta.jsonlPath);
+    if (cached && cached.mtime === st.mtimeMs) return cached;
+    const content = readFileSync(meta.jsonlPath, 'utf8');
+    const hasMessages = content.includes('"type":"assistant"');
+    const data = { mtime: st.mtimeMs, hasMessages };
+    sessionLogStatCache.set(meta.jsonlPath, data);
+    return data;
   } catch (e) { return { mtime: null, hasMessages: false }; }
 }
 
@@ -1475,15 +1482,26 @@ async function readMarkdownFile(absPath) {
   }
 }
 
-function resolvePreviewPath(filePath) {
+function resolvePreviewPath(filePath, base) {
   if (!filePath || typeof filePath !== 'string') return null;
-  return path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+  if (path.isAbsolute(filePath)) return filePath;
+  if (base && typeof base === 'string' && path.isAbsolute(base)) {
+    let baseDir = base;
+    try {
+      if (statSync(base).isFile()) baseDir = path.dirname(base);
+    } catch {
+      // base doesn't exist — fall back to dirname if it looks like a file
+      if (path.extname(base)) baseDir = path.dirname(base);
+    }
+    return path.resolve(baseDir, filePath);
+  }
+  return path.resolve(filePath);
 }
 
 app.post('/api/preview', async (req, res) => {
   try {
-    const { path: filePath, sessionId } = req.body || {};
-    const abs = resolvePreviewPath(filePath);
+    const { path: filePath, sessionId, base } = req.body || {};
+    const abs = resolvePreviewPath(filePath, base);
     if (!abs) return res.status(400).json({ error: 'path is required' });
     const content = await readMarkdownFile(abs);
     broadcast({ type: 'preview:open', path: abs, content, sessionId: sessionId || null });
@@ -1531,9 +1549,24 @@ app.post('/api/session/open', async (req, res) => {
   }
 });
 
+app.post('/api/session/pin', async (req, res) => {
+  try {
+    const { id, state } = req.body || {};
+    if (!id || typeof id !== 'string') return res.status(400).json({ error: 'id is required' });
+    if (!['none', 'pinned', 'sticky'].includes(state)) {
+      return res.status(400).json({ error: 'state must be none|pinned|sticky' });
+    }
+    broadcast({ type: 'session:pin', id, state });
+    res.json({ success: true, id, state });
+  } catch (error) {
+    console.error('Error in /api/session/pin:', error);
+    res.status(500).json({ error: error.message || 'Failed' });
+  }
+});
+
 app.get('/api/preview', async (req, res) => {
   try {
-    const abs = resolvePreviewPath(req.query.path);
+    const abs = resolvePreviewPath(req.query.path, req.query.base);
     if (!abs) return res.status(400).json({ error: 'path is required' });
     const content = await readMarkdownFile(abs);
     res.json({ path: abs, content });
@@ -1746,6 +1779,7 @@ contextStatusWatcher.on('all', (event, filePath) => {
   if (event === 'add' || event === 'change') {
     try {
       const data = JSON.parse(readFileSync(filePath, 'utf8'));
+      try { data._updatedAt = statSync(filePath).mtimeMs; } catch (_) { data._updatedAt = Date.now(); }
       contextStatusCache.set(sessionId, data);
       evictStaleCache(contextStatusCache);
     } catch (e) { /* ignore malformed */ }