clay-server 4.1.0-beta.9 → 4.1.0

package/lib/public/modules/filebrowser.js

@@ -2,15 +2,14 @@ import { iconHtml, refreshIcons } from './icons.js';
 import { escapeHtml, copyToClipboard } from './utils.js';
 import { renderMarkdown, highlightCodeBlocks, renderMermaidBlocks, exportMarkdownAsPdf } from './markdown.js';
 import { closeSidebar } from './sidebar.js';
-import { closeTerminal } from './terminal.js';
+import { claimRightWorkbench, registerRightWorkbench, releaseRightWorkbench, isRightWorkbenchCurrent } from './right-workbench.js';
 import { renderUnifiedDiff, renderSplitDiff } from './diff.js';
 import { initFileIcons, getFileIconSvg, getFolderIconSvg } from './fileicons.js';
 import { copyMarkdownFormatting } from './rich-clipboard.js';
 import { animateMarkdownChange, beginMarkdownPresentation, cancelMarkdownFollow, isFollowingMarkdown } from './markdown-live-edit.js';
 import { store } from './store.js';
 import { enterMarkdownSlides, exitMarkdownSlides, handleMarkdownSlideKey, syncMarkdownSlidesButton, toggleMarkdownSlideLevelMenu } from './markdown-slides.js';
-import { initFileViewerTabs, openFileViewerTab, previewFileViewerTab, updateFileViewerTab, closeFileViewerTab, focusedFileViewerTab, clearFileViewerTabs } from './filebrowser-tabs.js';
-import { closeIssues } from './issues.js';
+import { initFileViewerTabs, openFileViewerTab, previewFileViewerTab, updateFileViewerTab, closeFileViewerTab, focusedFileViewerTab, focusedFileViewerTabData, clearFileViewerTabs } from './filebrowser-tabs.js';
 import { initFileBrowserContextMenu, downloadProjectFile } from './filebrowser-context-menu.js';
 import { registerClayFileLinkOpener } from './clay-file-links.js';
 
@@ -41,10 +40,13 @@ export function initFileBrowser(_ctx) {
   if (mainPanels && ctx.fileViewerEl) mainPanels.appendChild(ctx.fileViewerEl);
   initFileViewerTabs({
     onFocus: function(path) {
+      claimRightWorkbench("file-viewer");
+      ctx.fileViewerEl.classList.remove("hidden");
       if (path !== currentFilePath) requestFileContent(path);
     },
     onEmpty: function() { teardownFileViewer(); },
   });
+  registerRightWorkbench("file-viewer", teardownFileViewer);
 
   // Load material file icons in background
   initFileIcons().then(function () {
@@ -149,7 +151,7 @@ export function initFileBrowser(_ctx) {
 
   // Close button
   document.getElementById("file-viewer-close").addEventListener("click", function () {
-    closeFileViewerTab(focusedFileViewerTab());
+    closeFileViewer();
   });
 
   // Full-viewport presentation toggle
@@ -395,6 +397,7 @@ function kbCollapseOrAscend() {
 function kbActivate() {
   if (!_kbFocused) return;
   if (!isDirRow(_kbFocused) && _kbFocused.dataset.path) {
+    claimRightWorkbench("file-viewer");
     openFileViewerTab(_kbFocused.dataset.path);
   }
   _kbFocused.click();
@@ -477,10 +480,7 @@ function ensureRenderedMarkdown() {
 }
 
 export function closeFileViewer() {
-  if (focusedFileViewerTab()) {
-    closeFileViewerTab(focusedFileViewerTab());
-    return;
-  }
+  releaseRightWorkbench("file-viewer");
   teardownFileViewer();
 }
 
@@ -512,6 +512,7 @@ export function setFileViewerFullscreen(enabled) {
 }
 
 export function resetFileBrowser() {
+  releaseRightWorkbench("file-viewer");
   clearFileViewerTabs();
   teardownFileViewer();
   // Clear all cached state
@@ -552,12 +553,13 @@ export function openFile(filePath, opts) {
   if (!state.connected) return false;
   if (opts && opts.projectSlug && opts.projectSlug !== state.currentSlug) return false;
   if (opts && opts.sessionId && String(opts.sessionId) !== String(state.activeSessionId)) return false;
-  closeIssues();
+  var workbenchRevision = claimRightWorkbench("file-viewer");
   if (followedFileChanged(filePath) || (opts && opts.diff && isFollowingMarkdown(filePath))) {
     cancelMarkdownFollow();
   }
   pendingRenderedOpen = !!(opts && opts.rendered);
   store.set({ pendingFileNavigation: opts && opts.line ? { path: filePath, line: opts.line, column: opts.column || null, requestId: null } : null });
+  store.set({ fileViewerOpenRevision: workbenchRevision });
   openFileViewerTab(filePath);
   if (opts && opts.diff) {
     pendingOpenMode = { type: "diff", oldStr: opts.diff.oldStr, newStr: opts.diff.newStr };
@@ -567,9 +569,28 @@ export function openFile(filePath, opts) {
   requestFileContent(filePath);
 }
 
+export function reopenFileViewer() {
+  var workbenchRevision = claimRightWorkbench("file-viewer");
+  store.set({ fileViewerOpenRevision: workbenchRevision });
+  if (!focusedFileViewerTab()) return false;
+  ctx.fileViewerEl.classList.remove("hidden");
+  var tab = focusedFileViewerTabData();
+  if (currentFilePath === focusedFileViewerTab() && currentContent != null) {
+    sendWatch(currentFilePath);
+    return true;
+  }
+  if (tab && tab.content != null) {
+    showFileContent({ path: focusedFileViewerTab(), content: tab.content, size: tab.content.length });
+    return true;
+  }
+  requestFileContent(focusedFileViewerTab());
+  return true;
+}
+
 export function openWorkingTreeDiff(diff) {
   if (!diff || !diff.path) return;
-  closeIssues();
+  var workbenchRevision = claimRightWorkbench("file-viewer");
+  store.set({ fileViewerOpenRevision: workbenchRevision });
   openFileViewerTab(diff.path);
   pendingRenderedOpen = false;
   pendingOpenMode = diff.binary ? null : {
@@ -588,6 +609,8 @@ export function openWorkingTreeDiff(diff) {
 
 export function presentMarkdownEdit(msg) {
   if (!msg || !beginMarkdownPresentation(msg.path)) return;
+  var workbenchRevision = claimRightWorkbench("file-viewer");
+  store.set({ fileViewerOpenRevision: workbenchRevision });
   openFileViewerTab(msg.path, { content: msg.content });
   pendingOpenMode = null;
   pendingRenderedOpen = true;
@@ -687,7 +710,7 @@ function requestDirectory(dirPath) {
 function requestFileContent(filePath) {
   var requestId = "file-read-" + Date.now() + "-" + Math.random().toString(36).slice(2);
   var state = store.snap();
-  store.set({ fileReadRequest: { requestId: requestId, path: filePath, projectSlug: state.currentSlug || null, sessionId: state.activeSessionId != null ? String(state.activeSessionId) : null, accountId: state.myUserId || null } });
+  store.set({ fileReadRequest: { requestId: requestId, path: filePath, projectSlug: state.currentSlug || null, sessionId: state.activeSessionId != null ? String(state.activeSessionId) : null, accountId: state.myUserId || null, workbenchRevision: store.get('rightWorkbenchRevision') || 0 } });
   var pending = store.get('pendingFileNavigation');
   if (pending && pending.path === filePath) store.set({ pendingFileNavigation: Object.assign({}, pending, { requestId: requestId }) });
   if (ctx.ws && ctx.connected) {
@@ -811,6 +834,7 @@ function renderFilteredTree(container, tree, depth, query) {
       (function (rowEl, childEl, folderName) {
         rowEl.addEventListener("click", function (e) {
           e.stopPropagation();
+          claimRightWorkbench("file-viewer");
           var isExpanded = rowEl.classList.contains("expanded");
           rowEl.classList.toggle("expanded");
           childEl.classList.toggle("hidden", isExpanded);
@@ -833,6 +857,7 @@ function renderFilteredTree(container, tree, depth, query) {
       (function (filePath, rowEl) {
         rowEl.addEventListener("click", function (e) {
           e.stopPropagation();
+          claimRightWorkbench("file-viewer");
           if (followedFileChanged(filePath)) cancelMarkdownFollow();
           var prev = ctx.fileTreeEl.querySelector(".file-tree-item.active");
           if (prev) prev.classList.remove("active");
@@ -843,7 +868,7 @@ function renderFilteredTree(container, tree, depth, query) {
         });
         rowEl.addEventListener("dblclick", function (e) {
           e.stopPropagation();
-          openFileViewerTab(filePath);
+          openFile(filePath);
         });
       })(entry.path, row);
 
@@ -973,7 +998,7 @@ export function handleFsRead(msg) {
   if ((request.projectSlug || null) !== (msg.projectSlug || null)) return;
   if ((request.sessionId || null) !== (msg.sessionId == null ? null : String(msg.sessionId))) return;
   if ((request.accountId || null) !== (msg.accountId || null)) return;
-  showFileContent(msg);
+  showFileContent(msg, request.workbenchRevision);
 }
 
 // --- Tree rendering ---
@@ -1040,6 +1065,7 @@ function renderEntries(container, entries, depth) {
       (function (dirPath, childEl, rowEl, folderName) {
         rowEl.addEventListener("click", function (e) {
           e.stopPropagation();
+          claimRightWorkbench("file-viewer");
           var isExpanded = rowEl.classList.contains("expanded");
           if (isExpanded) {
             rowEl.classList.remove("expanded");
@@ -1079,6 +1105,7 @@ function renderEntries(container, entries, depth) {
       (function (filePath, rowEl) {
         rowEl.addEventListener("click", function (e) {
           e.stopPropagation();
+          claimRightWorkbench("file-viewer");
           if (followedFileChanged(filePath)) cancelMarkdownFollow();
           // Mark active
           var prev = ctx.fileTreeEl.querySelector(".file-tree-item.active");
@@ -1093,7 +1120,7 @@ function renderEntries(container, entries, depth) {
         });
         rowEl.addEventListener("dblclick", function (e) {
           e.stopPropagation();
-          openFileViewerTab(filePath);
+          openFile(filePath);
         });
       })(entry.path, row);
 
@@ -1105,8 +1132,9 @@ function renderEntries(container, entries, depth) {
 
 // --- File viewer ---
 
-function showFileContent(msg) {
+function showFileContent(msg, expectedRevision) {
   if (!updateFileViewerTab(msg.path, { content: msg.content })) return;
+  if (expectedRevision != null && !isRightWorkbenchCurrent("file-viewer", expectedRevision)) return;
   var pathEl = document.getElementById("file-viewer-path");
   var bodyEl = document.getElementById("file-viewer-body");
   var renderBtn = document.getElementById("file-viewer-render");
@@ -1183,7 +1211,6 @@ function showFileContent(msg) {
     }
   }
 
-  closeTerminal();
   ctx.fileViewerEl.classList.remove("hidden");
   sendWatch(msg.path);
   refreshIcons();
@@ -1291,7 +1318,7 @@ function pathsReferToSameFile(left, right) {
 }
 
 export function handleFileChanged(msg) {
-  if (!msg.path || msg.path !== currentFilePath) return;
+  if (!msg.path || !pathsReferToSameFile(msg.path, currentFilePath)) return;
   if (ctx.fileViewerEl.classList.contains("hidden")) return;
   if (historyVisible || inlineDiffActive) return;
   if (msg.content === currentContent) return;
@@ -1299,7 +1326,7 @@ export function handleFileChanged(msg) {
   var bodyEl = document.getElementById("file-viewer-body");
   var scrollPos = bodyEl ? bodyEl.scrollTop : 0;
   pendingRefresh = true;
-  showFileContent(msg);
+  showFileContent(msg.path === currentFilePath ? msg : Object.assign({}, msg, { path: currentFilePath }));
   if (bodyEl) bodyEl.scrollTop = scrollPos;
 }
 

package/lib/public/modules/issues-render.js

@@ -1,24 +1,50 @@
 import { escapeHtml } from './utils.js';
 import { renderMarkdown } from './markdown.js';
+import { authorLine, relativeTime } from './project-logs-render.js';
 export function statusLabel(status) { return { open: 'Open', in_progress: 'In progress', resolved: 'Resolved', closed: 'Closed' }[status] || 'Issue'; }
 function esc(value) { return escapeHtml(String(value || '')); }
 function options(values, selected) { return values.map(function (value) { return '<option value="' + value + '"' + (value === selected ? ' selected' : '') + '>' + esc(statusLabel(value) === 'Issue' ? value.replace(/_/g, ' ') : statusLabel(value)) + '</option>'; }).join(''); }
+function label(value) { return value ? value.charAt(0).toUpperCase() + value.slice(1).replace(/_/g, ' ') : ''; }
+function statusChip(status) { return '<span class="issue-status" data-status="' + esc(status) + '">' + statusLabel(status) + '</span>'; }
+function priorityChip(priority) { return priority && priority !== 'normal' ? '<span class="project-log-priority" data-priority="' + esc(priority) + '">' + esc(label(priority)) + '</span>' : ''; }
+function action(attribute, icon, text, extra) { return '<button type="button" ' + attribute + (extra || '') + '><i data-lucide="' + icon + '"></i>' + text + '</button>'; }
+function prose(text, className) { return '<div class="markdown-body ' + (className || '') + '">' + renderMarkdown(text || '') + '</div>'; }
 export function renderIssueList(result) {
   var filtered = !!(result.query || result.status || result.type);
   if (!result.issues.length) return '<div class="issues-empty"><i data-lucide="circle-dot"></i><h2>' + (filtered ? 'No matching issues' : 'No issues yet') + '</h2><p>' + (filtered ? 'Try a different search or filter.' : 'Manage issues through Driver chat.') + '</p></div>';
   return result.issues.map(function (entry) {
-    return '<button class="issue-row" data-open-issue="' + esc(entry.ref) + '"><div class="issue-row-head"><span class="issue-type">' + esc(entry.type) + '</span><span class="issue-status" data-status="' + entry.status + '">' + statusLabel(entry.status) + '</span></div><strong>' + esc(entry.title) + '</strong><p>' + esc(entry.summary) + '</p><small>' + esc(entry.priority) + ' · revision ' + entry.revision + '</small></button>';
-  }).join('') + (result.nextCursor ? '<button data-issues-more="' + esc(result.nextCursor) + '">Load more</button>' : '');
+    var meta = [authorLine(entry), relativeTime(entry.updatedAt || entry.createdAt)];
+    if (entry.revision > 1) meta.push('v' + entry.revision);
+    if (entry.commentCount) meta.push(entry.commentCount + (entry.commentCount === 1 ? ' comment' : ' comments'));
+    return '<button type="button" class="issue-row" data-open-issue="' + esc(entry.ref) + '">' +
+      '<div class="issue-row-head"><span class="issue-type">' + esc(entry.type) + '</span>' + priorityChip(entry.priority) + '<strong>' + esc(entry.title) + '</strong></div>' +
+      (entry.summary ? '<p>' + esc(entry.summary) + '</p>' : '') +
+      '<div class="issue-row-meta">' + statusChip(entry.status) + '<span>' + esc(meta.filter(Boolean).join(' · ')) + '</span></div></button>';
+  }).join('') + (result.nextCursor ? '<div class="issues-load-more"><button data-issues-more="' + esc(result.nextCursor) + '">Load more</button></div>' : '');
+}
+function renderComment(comment) {
+  var actor = comment.author || {};
+  var review = comment.review;
+  return '<article class="issue-comment"><div class="issue-comment-meta">' + esc(actor.displayName || actor.userId || 'Project member') + ' · ' + esc(new Date(comment.at).toLocaleString()) + '</div>' +
+    prose(comment.body, 'issue-comment-body') + (review ? '<div class="issue-comment-review"><span>' + esc(label(review.action)) + '</span>' + prose(review.response) + '</div>' : '') + '</article>';
 }
 export function renderIssueDetail(entry) {
-  var author = entry.updatedBy || entry.author || {};
-  var comments = (entry.comments || []).map(function (comment) { var commentAuthor = comment.author || {}; var review = comment.review; return '<article class="issue-comment"><div class="issue-comment-meta">' + esc(commentAuthor.displayName || commentAuthor.userId || 'Project member') + ' · ' + esc(new Date(comment.at).toLocaleString()) + '</div><p>' + esc(comment.body) + '</p>' + (review ? '<small>' + esc(review.action) + ' · ' + esc(review.response) + '</small>' : '') + '</article>'; }).join('');
-  return '<div class="issue-detail"><span class="issue-status" data-status="' + entry.status + '">' + statusLabel(entry.status) + '</span><h2>' + esc(entry.title) + '</h2><p>' + esc(entry.summary) + '</p><small>' + esc(entry.type) + ' · ' + esc(entry.priority) + ' · revision ' + entry.revision + ' · ' + esc(author.displayName || author.userId || 'Local user') + '</small><div class="markdown-body">' + renderMarkdown(entry.body || '') + '</div>' +
-    (entry.verifiedCommit ? '<section><h3>Resolution</h3><p>' + esc(entry.resolutionSummary) + '</p><code>' + esc(entry.verifiedCommit.sha) + '</code><p>' + esc(entry.verifiedCommit.subject) + '</p></section>' : '') +
-    (entry.closeReason ? '<section class="issue-evidence"><h3>Closure</h3><p>' + esc(entry.closeReason.replace(/_/g, ' ')) + '</p></section>' : '') +
-    '<div class="issue-actions"><button data-issue-edit>Edit</button><button data-issue-work' + (entry.status === 'resolved' || entry.status === 'closed' ? ' disabled title="Reopen this issue to start work"' : '') + '>Start work</button><button data-issue-history>History</button><button data-issue-copy>Copy reference</button>' + (entry.canDelete ? '<button data-issue-delete>Delete issue</button>' : '') + '</div>' +
-    ((entry.linkedWorkSessions || []).length ? '<section><h3>Linked work sessions</h3>' + entry.linkedWorkSessions.map(function (link) { return '<button data-issue-session="' + esc(link.sessionId) + '">Open Driver session</button>'; }).join('') + '</section>' : '') +
-    ((entry.resolutionHistory || []).length ? '<section class="issue-evidence"><h3>Resolution history</h3>' + entry.resolutionHistory.map(function (item) { return '<p>' + esc(item.resolutionSummary) + ' <code>' + esc(item.verifiedCommit && item.verifiedCommit.sha) + '</code></p>'; }).join('') + '</section>' : '') + '<section class="issue-discussion"><h3>Discussion' + (comments ? ' (' + entry.comments.length + ')' : '') + '</h3>' + (comments || '<p class="issue-discussion-empty">No comments yet.</p>') + '<form id="issue-comment-form"><label for="issue-comment-input">Add a comment</label><textarea id="issue-comment-input" rows="3" required placeholder="Add context, a correction, or a question."></textarea><p class="issue-comment-status" role="status"></p><button type="submit">Comment</button></form></section></div>';
+  var comments = (entry.comments || []).map(renderComment).join('');
+  var closed = entry.status === 'resolved' || entry.status === 'closed';
+  var time = entry.updatedAt || entry.createdAt;
+  var byline = [authorLine(entry), time ? new Date(time).toLocaleString() : '', 'v' + entry.revision].filter(Boolean).join(' · ');
+  return '<article class="issue-detail"><div class="issue-doc-chips"><span class="issue-type">' + esc(entry.type) + '</span>' + priorityChip(entry.priority) + statusChip(entry.status) + '</div>' +
+    '<h2 class="issue-doc-title">' + esc(entry.title) + '</h2>' + prose(entry.summary, 'issue-doc-summary') + '<div class="issue-byline">' + esc(byline) + '</div>' +
+    '<div class="issue-actions">' + action('data-issue-work', 'play', 'Start work', ' class="issue-primary"' + (closed ? ' disabled title="Reopen this issue to start work"' : '')) +
+    action('data-issue-edit', 'pencil', 'Edit') + action('data-issue-history', 'history', 'History') + action('data-issue-copy', 'link', 'Copy reference') +
+    (entry.canDelete ? action('data-issue-delete', 'trash-2', 'Delete', ' class="issue-danger"') : '') + '</div>' +
+    prose(entry.body, 'issue-doc-body') +
+    (entry.verifiedCommit ? '<section class="issue-evidence"><h3>Resolution</h3>' + prose(entry.resolutionSummary) + '<code>' + esc(entry.verifiedCommit.sha) + '</code><p>' + esc(entry.verifiedCommit.subject) + '</p></section>' : '') +
+    (entry.closeReason ? '<section class="issue-evidence"><h3>Closure</h3><p>' + esc(label(entry.closeReason)) + '</p></section>' : '') +
+    ((entry.linkedWorkSessions || []).length ? '<section class="issue-evidence"><h3>Linked work sessions</h3>' + entry.linkedWorkSessions.map(function (link) { return action('data-issue-session="' + esc(link.sessionId) + '"', 'messages-square', 'Open Driver session'); }).join('') + '</section>' : '') +
+    ((entry.resolutionHistory || []).length ? '<section class="issue-evidence"><h3>Resolution history</h3>' + entry.resolutionHistory.map(function (item) { return prose(item.resolutionSummary) + '<code>' + esc(item.verifiedCommit && item.verifiedCommit.sha) + '</code>'; }).join('') + '</section>' : '') +
+    '<section class="issue-discussion"><h3>Discussion' + (comments ? ' <span>' + entry.comments.length + '</span>' : '') + '</h3>' + (comments || '<p class="issue-discussion-empty">No comments yet.</p>') +
+    '<form id="issue-comment-form"><label for="issue-comment-input">Add a comment</label><textarea id="issue-comment-input" rows="3" required placeholder="Add context, a correction, or a question."></textarea><p class="issue-comment-status" role="status"></p><div class="issue-comment-actions"><button type="submit" class="issue-primary">Comment</button></div></form></section></article>';
 }
 export function renderIssueForm(entry) {
   var item = entry || {};

package/lib/public/modules/issues.js

@@ -1,22 +1,76 @@
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { showToast } from './utils.js';
-import { closeProjectLogs } from './project-logs.js';
-import { closeScheduledTasks } from './scheduled-tasks.js';
-import { closeNotesBrowser } from './sticky-notes-browser.js';
-import { closeFileViewer } from './filebrowser.js';
-import { closeTerminal } from './terminal.js';
+import { claimRightWorkbench, registerRightWorkbench, releaseRightWorkbench } from './right-workbench.js';
 import { refreshIcons } from './icons.js';
-import { renderIssueList, renderIssueDetail, renderIssueForm, renderIssueHistory, statusLabel } from './issues-render.js';
+import { enhanceClayLogLinks } from './clay-log-links.js';
+import { updateIssueLink } from './clay-issue-links.js';
+import { renderIssueList, renderIssueDetail, renderIssueForm, renderIssueHistory } from './issues-render.js';
 function panel() { return document.getElementById('issues-panel'); }
 function content() { return panel().querySelector('.issues-content'); }
+function clearUpdateNotice() {
+  store.set({ issuesUpdateAvailable: null });
+  var action = content() && content().querySelector('[data-issue-update-notice]');
+  if (action) action.remove();
+}
+function renderContextualUpdate() {
+  var update = store.get('issuesUpdateAvailable');
+  var issueContent = content();
+  var actions = issueContent && (issueContent.querySelector('.issue-detail .issue-actions') || issueContent.querySelector('#issue-form .issue-actions'));
+  if (!actions || !update) return;
+  var existing = actions.querySelector('[data-issue-update-notice]');
+  if (existing) existing.remove();
+  var notice = document.createElement('span');
+  notice.className = 'issues-inline-update';
+  notice.dataset.issueUpdateNotice = 'true';
+  notice.appendChild(document.createTextNode(store.get('issuesView') === 'edit' ? 'Updated remotely · Finish editing to refresh' : 'Updated remotely'));
+  var refresh = document.createElement('button');
+  refresh.type = 'button';
+  refresh.dataset.issueRefresh = update.ref;
+  refresh.textContent = 'Refresh';
+  refresh.disabled = store.get('issuesView') === 'edit';
+  if (refresh.disabled) refresh.title = 'Finish editing to refresh';
+  notice.appendChild(refresh);
+  actions.insertBefore(notice, actions.firstChild);
+}
+function captureDraft() {
+  var state = store.snap();
+  if (state.issuesView !== 'detail' && state.issuesView !== 'edit') return null;
+  var draft = { ref: entryRef(), view: state.issuesView, comment: null };
+  var comment = panel() && panel().querySelector('#issue-comment-input');
+  if (comment) draft.comment = comment.value;
+  return draft;
+}
+function restoreCommentDraft(draft) {
+  if (!draft || draft.comment === null) return;
+  var input = panel().querySelector('#issue-comment-input');
+  if (input) input.value = draft.comment;
+}
+function canRestoreCommentDraft(draft, ref) {
+  return !!draft && draft.ref === ref;
+}
+function hasNewerDraft(item) {
+  return (item.intent === 'detail' || item.intent === 'refresh') && item.viewGeneration !== (store.get('issuesViewGeneration') || 0);
+}
+function noteIssueUpdate(ref, revision) {
+  var current = store.get('issuesUpdateAvailable');
+  if (!current || current.ref !== ref || Number(revision || 0) >= Number(current.revision || 0)) {
+    store.set({ issuesUpdateAvailable: { ref: ref, revision: Number(revision || 0) } });
+  }
+  renderContextualUpdate();
+}
+function refreshSelectedIssue(ref) {
+  var selected = store.get('issuesSelected');
+  if (!selected || selected.ref !== ref || store.get('issuesView') === 'edit') return;
+  store.set({ issuesViewRequest: request('issue_read', { ref: ref }, 'refresh') });
+}
 function bumpViewGeneration() { store.set({ issuesViewGeneration: (store.get('issuesViewGeneration') || 0) + 1 }); }
 function request(action, args, intent) {
   var ws = getWs();
   if (!ws || ws.readyState !== 1) { showToast('Reconnect to use Issues', 'warn'); return; }
   var id = 'issues-' + crypto.randomUUID();
   var pending = Object.assign({}, store.get('issuesRequests') || {});
-  pending[id] = { action: action, intent: intent, slug: store.get('currentSlug'), sourceRef: entryRef(), view: store.get('issuesView'), viewGeneration: store.get('issuesViewGeneration') || 0 };
+  pending[id] = { action: action, intent: intent, slug: store.get('currentSlug'), sourceRef: entryRef(), view: store.get('issuesView'), viewGeneration: store.get('issuesViewGeneration') || 0, draft: captureDraft() };
   store.set({ issuesRequests: pending });
   ws.send(JSON.stringify({ type: action, args: args || {}, requestId: id }));
   return id;
@@ -43,7 +97,9 @@ function detail(entry) {
   panel().querySelector('.issues-filters').hidden = true;
   panel().querySelector('[data-issues-back]').classList.remove('hidden');
   content().innerHTML = renderIssueDetail(entry);
+  enhanceClayLogLinks(content());
   refreshIcons();
+  renderContextualUpdate();
 }
 function entryRef() {
   var entry = store.get('issuesSelected');
@@ -81,6 +137,7 @@ function confirmDelete() {
   store.set({ issuesMutationRequest: request('issue_delete', { ref: entry.ref, expectedRevision: entry.revision }, 'delete') });
 }
 export function closeIssues() {
+  releaseRightWorkbench("issues");
   bumpViewGeneration();
   if (panel()) panel().classList.add('hidden');
   store.set({ issuesOpen: false });
@@ -90,8 +147,9 @@ export function closeIssues() {
 export function openIssues(ref) {
   if (!panel() || store.get('isMate')) return;
   panel().querySelector('.issues-notice').textContent = '';
+  clearUpdateNotice();
   bumpViewGeneration();
-  closeProjectLogs(); closeScheduledTasks(); closeNotesBrowser(); closeFileViewer(); closeTerminal();
+  claimRightWorkbench("issues");
   panel().classList.remove('hidden');
   store.set({ issuesOpen: true });
   var button = document.getElementById('issues-btn');
@@ -102,9 +160,10 @@ export function openIssues(ref) {
 export function initIssues() {
   var host = document.getElementById('main-panels');
   if (!host || panel()) return;
+  registerRightWorkbench("issues", closeIssues);
   var el = document.createElement('section');
   el.id = 'issues-panel'; el.className = 'hidden'; el.setAttribute('aria-label', 'Project Issues');
-  el.innerHTML = '<header class="issues-topbar"><button class="issues-icon-btn" data-issues-back aria-label="Back to issues" title="Back to issue list"><i data-lucide="arrow-left"></i></button><span class="issues-title"><i data-lucide="circle-dot"></i>Issues</span><span class="issues-subtitle">Manage issues through Driver chat.</span><div class="issues-window-actions"><button class="issues-icon-btn" data-issues-wide aria-label="Widen Issues" title="Widen Issues" aria-pressed="false"><i data-lucide="chevrons-left-right"></i></button><button class="issues-icon-btn" data-issues-full aria-label="Toggle Issues fullscreen" title="Toggle fullscreen" aria-pressed="false"><i data-lucide="maximize-2"></i></button><button class="issues-icon-btn" data-issues-close aria-label="Close Issues" title="Close Issues"><i data-lucide="x"></i></button></div></header><div class="issues-filters"><label class="issues-search"><i data-lucide="search"></i><input name="query" type="search" placeholder="Search issues" aria-label="Search issues"></label><select name="filter-status" aria-label="Filter status"><option value="">All statuses</option><option value="open">Open</option><option value="in_progress">In progress</option><option value="resolved">Resolved</option><option value="closed">Closed</option></select><select name="filter-type" aria-label="Filter type"><option value="">All types</option><option>bug</option><option>feature</option><option>plan</option></select></div><p class="issues-notice" role="status"></p><main class="issues-content" role="region" aria-live="polite"></main><div class="issues-delete-dialog hidden" role="dialog" aria-modal="true" aria-labelledby="issues-delete-heading"><div class="issues-delete-card"><h2 id="issues-delete-heading">Delete this issue?</h2><p>This removes the issue from the board but preserves its history.</p><p class="issues-delete-title"></p><p class="issues-delete-status" role="status"></p><div><button type="button" data-issue-delete-cancel>Cancel</button><button type="button" data-issue-delete-confirm>Delete issue</button></div></div></div>';
+  el.innerHTML = '<header class="issues-topbar"><button class="issues-icon-btn" data-issues-back aria-label="Back to issues" title="Back to issue list"><i data-lucide="arrow-left"></i></button><span class="issues-title"><i data-lucide="circle-dot"></i>Issues</span><span class="issues-subtitle">Manage issues through Driver chat.</span><div class="issues-window-actions"><button class="issues-icon-btn" data-issues-wide aria-label="Widen Issues" title="Widen Issues" aria-pressed="false"><i data-lucide="chevrons-left-right"></i></button><button class="issues-icon-btn" data-issues-full aria-label="Toggle Issues fullscreen" title="Toggle fullscreen" aria-pressed="false"><i data-lucide="maximize-2"></i></button><button class="issues-icon-btn" data-issues-close aria-label="Close Issues" title="Close Issues"><i data-lucide="x"></i></button></div></header><div class="issues-filters"><label class="issues-search"><i data-lucide="search"></i><input name="query" type="search" placeholder="Search issues" aria-label="Search issues"></label><select name="filter-status" aria-label="Filter status"><option value="">All statuses</option><option value="open">Open</option><option value="in_progress">In progress</option><option value="resolved">Resolved</option><option value="closed">Closed</option></select><select name="filter-type" aria-label="Filter type"><option value="">All types</option><option value="bug">Bug</option><option value="feature">Feature</option><option value="plan">Plan</option></select></div><p class="issues-notice" role="status"></p><main class="issues-content" role="region" aria-live="polite"></main><div class="issues-delete-dialog hidden" role="dialog" aria-modal="true" aria-labelledby="issues-delete-heading"><div class="issues-delete-card"><h2 id="issues-delete-heading">Delete this issue?</h2><p>This removes the issue from the board but preserves its history.</p><p class="issues-delete-title"></p><p class="issues-delete-status" role="status"></p><div><button type="button" data-issue-delete-cancel>Cancel</button><button type="button" data-issue-delete-confirm>Delete issue</button></div></div></div>';
   host.appendChild(el);
   var button = document.getElementById('issues-btn');
   if (button) button.addEventListener('click', function () { if (store.get('issuesOpen')) closeIssues(); else openIssues(); });
@@ -120,6 +179,7 @@ export function initIssues() {
     else if (target.hasAttribute('data-issue-delete-confirm')) confirmDelete();
     else if (target.hasAttribute('data-issue-edit')) showIssueEdit(entry);
     else if (target.hasAttribute('data-issue-cancel')) detail(entry);
+    else if (target.dataset.issueRefresh) refreshSelectedIssue(target.dataset.issueRefresh);
     else if (target.dataset.openIssue) openIssues(target.dataset.openIssue);
     else if (target.hasAttribute('data-issues-more')) listing(target.dataset.issuesMore);
     else if (target.hasAttribute('data-issue-history')) { bumpViewGeneration(); store.set({ issuesView: 'history', issuesViewRequest: request('issue_history', { ref: entry.ref }, 'history') }); }
@@ -175,6 +235,7 @@ function showIssueEdit(entry) {
   }
   formEl.addEventListener('change', syncFields);
   syncFields();
+  renderContextualUpdate();
 }
 export function handleIssuesMessage(msg) {
   if (msg.type === 'issue_commented') {
@@ -204,8 +265,11 @@ export function handleIssuesMessage(msg) {
   }
   if (msg.type === 'issue_updated') {
     var cache = Object.assign({}, store.get('issuesCache') || {}); cache[msg.ref] = Object.assign({}, cache[msg.ref] || {}, msg, { projectSlug: store.get('currentSlug') }); store.set({ issuesCache: cache });
-    document.querySelectorAll('[data-issue-ref]').forEach(function (node) { if (node.dataset.issueRef === msg.ref) { node.textContent = statusLabel(msg.status) + ' · ' + msg.title; node.dataset.status = msg.status; } });
-    if (store.get('issuesOpen')) panel().querySelector('.issues-notice').textContent = 'An issue changed. Back returns to the latest list; reopening an issue loads its latest revision.';
+    document.querySelectorAll('[data-issue-ref]').forEach(function (node) { if (node.dataset.issueRef === msg.ref) updateIssueLink(node, msg); });
+    var selected = store.get('issuesSelected');
+    var view = store.get('issuesView');
+    if (store.get('issuesOpen') && selected && selected.ref === msg.ref && (view === 'detail' || view === 'edit')) noteIssueUpdate(msg.ref, msg.revision);
+    else if (store.get('issuesOpen') && view === 'list') listing();
     return true;
   }
   if (msg.type !== 'issues_result') return false;
@@ -241,6 +305,16 @@ export function handleIssuesMessage(msg) {
     return true;
   }
   panel().querySelector('.issues-notice').textContent = '';
+  if (hasNewerDraft(item)) {
+    if (!msg.error && msg.result && msg.result.ref) {
+      var refreshedCache = Object.assign({}, store.get('issuesCache') || {});
+      refreshedCache[msg.result.ref] = Object.assign({}, msg.result, { canDelete: msg.canDelete === true, projectSlug: store.get('currentSlug') });
+      store.set({ issuesCache: refreshedCache });
+      if (Number(msg.result.revision || 0) > Number((store.get('issuesSelected') || {}).revision || 0)) noteIssueUpdate(msg.result.ref, msg.result.revision);
+    }
+    return true;
+  }
+  if (item.intent !== 'detail' && item.intent !== 'refresh') clearUpdateNotice();
   if (item.intent === 'work') { closeIssues(); return true; }
   if (item.intent === 'comment') {
     var commented = Object.assign({}, msg.result, { canDelete: msg.canDelete === true });
@@ -264,7 +338,15 @@ export function handleIssuesMessage(msg) {
       status: panel().querySelector('[name="filter-status"]').value, type: panel().querySelector('[name="filter-type"]').value });
     store.set({ issuesRows: result.issues }); content().innerHTML = renderIssueList(result); refreshIcons();
   } else if (item.intent === 'history') { content().innerHTML = renderIssueHistory(msg.result); refreshIcons(); }
-  else if (item.intent === 'revision') { content().innerHTML = '<p class="issues-history-note">Historical revision · use Back to return to current issues</p>' + renderIssueDetail(msg.result); content().querySelectorAll('.issue-actions, [data-issue-session]').forEach(function (node) { node.remove(); }); refreshIcons(); }
-  else detail(Object.assign({}, msg.result, { canDelete: msg.canDelete === true }));
+  else if (item.intent === 'revision') { content().innerHTML = '<p class="issues-history-note">Historical revision · use Back to return to current issues</p>' + renderIssueDetail(msg.result); content().querySelectorAll('.issue-actions, [data-issue-session], .issue-discussion form').forEach(function (node) { node.remove(); }); enhanceClayLogLinks(content()); refreshIcons(); }
+  else if (item.intent === 'save') {
+    detail(Object.assign({}, msg.result, { canDelete: msg.canDelete === true }));
+  } else {
+    var available = store.get('issuesUpdateAvailable');
+    if (available && available.ref === msg.result.ref && Number(msg.result.revision || 0) >= Number(available.revision || 0)) clearUpdateNotice();
+    var refreshed = Object.assign({}, msg.result, { canDelete: msg.canDelete === true });
+    detail(refreshed);
+    if (canRestoreCommentDraft(item.draft, msg.result.ref) && (item.intent === 'detail' || item.intent === 'refresh')) restoreCommentDraft(item.draft);
+  }
   return true;
 }

package/lib/public/modules/markdown.js

@@ -2,7 +2,7 @@ import { copyToClipboard, escapeHtml } from './utils.js';
 import { refreshIcons } from './icons.js';
 import { getMermaidThemeVars } from './theme.js';
 import { store } from './store.js';
-import { enhanceClayLogLinks } from './clay-log-links.js';
+import { enhanceClayLogLinks, renderClayRecordLink } from './clay-log-links.js';
 import { renderLocalFileLink, enhanceClayFileLinks } from './clay-file-links.js';
 
 // Initialize markdown parser
@@ -12,6 +12,8 @@ marked.use({ gfm: true, breaks: false });
 marked.use({
   renderer: {
     link({ href, title, text }) {
+      var recordLink = renderClayRecordLink(href, text);
+      if (recordLink) return recordLink;
       var localLink = renderLocalFileLink(href, title, text);
       if (localLink) return localLink;
       var isExternal = href && (href.startsWith('http://') || href.startsWith('https://'));

package/lib/public/modules/pane-bridge.js

@@ -4,11 +4,9 @@
 // Same-origin messages only, both directions.
 
 import { store } from './store.js';
-import { applyContextView, getContextView } from './app-panels.js';
+import { getEffectiveContextView } from './context-view-preference.js';
 import { forceExternalLinkToNewTab } from './pane-links.js';
 
-var panelOpen = false;
-
 export function reportPaneContext(data) {
   if (!store.get('paneMode') || window.parent === window) return;
   window.parent.postMessage({
@@ -38,11 +36,17 @@ export function forwardPaneMarkdownPresentation(message) {
   return true;
 }
 
-// Toggle without setContextView: panes share localStorage with the main app,
-// so persisting here would silently rewrite the user's main-view preference.
+export function forwardPaneIssueReference(ref, projectSlug) {
+  if (!store.get('paneMode') || window.parent === window) return false;
+  window.parent.postMessage({ type: "clay-pane-open-issue", ref: ref, projectSlug: projectSlug || store.get('currentSlug') }, window.location.origin);
+  return true;
+}
+
+// Toggle without setContextView: panes use a transient override and must not
+// rewrite the user's server-persisted main-view preference.
 function togglePaneContextPanel() {
-  panelOpen = !panelOpen;
-  applyContextView(panelOpen ? "panel" : "off");
+  var effectiveView = getEffectiveContextView();
+  store.set({ contextViewOverride: effectiveView === "panel" ? "off" : "panel" });
 }
 
 function preparePaneLink(event) {
@@ -55,7 +59,9 @@ function preparePaneLink(event) {
 
 export function initPaneBridge() {
   if (!store.get('paneMode')) return;
-  panelOpen = getContextView() === "panel";
+  // Hydration may still replace the persisted mode. Leave the override null
+  // so the first header toggle derives from the actual effective view.
+  store.set({ contextViewOverride: null });
   document.addEventListener("click", preparePaneLink, true);
   document.addEventListener("auxclick", preparePaneLink, true);
   window.addEventListener("message", function (event) {

package/lib/public/modules/pane-issue-bridge.js

@@ -0,0 +1,27 @@
+import { store } from './store.js';
+import { openIssues } from './issues.js';
+
+function isIssueReference(ref) {
+  return typeof ref === "string" && /^issue:[A-Za-z0-9_-]{24}$/.test(ref);
+}
+
+function isPaneSource(host, source) {
+  var frames = host.querySelectorAll(".split-pane-frame");
+  for (var i = 0; i < frames.length; i++) {
+    if (frames[i].contentWindow === source) return true;
+  }
+  return false;
+}
+
+export function handlePaneIssueMessage(event, host) {
+  if (!event || event.origin !== window.location.origin || !host) return false;
+  var msg = event.data;
+  if (!msg || msg.type !== "clay-pane-open-issue") return false;
+  if (!isIssueReference(msg.ref) || !isPaneSource(host, event.source)) return true;
+
+  var issueTarget = store.get('issuesCache') && store.get('issuesCache')[msg.ref];
+  var projectSlug = (issueTarget && issueTarget.projectSlug) || msg.projectSlug || store.get('currentSlug');
+  if (projectSlug === store.get('currentSlug')) openIssues(msg.ref);
+  else window.location.assign('/p/' + encodeURIComponent(projectSlug) + '/?issue=' + encodeURIComponent(msg.ref));
+  return true;
+}

package/lib/public/modules/permission-hints.js

@@ -0,0 +1,13 @@
+import { store } from './store.js';
+
+export function applyPermissionHints(container, hints) {
+  if (!container || !hints) return;
+  if (hints.suppressAlwaysAllowRule) {
+    var persistent = container.querySelectorAll('.permission-allow-session, .mate-permission-always, .notif-banner-always');
+    persistent.forEach(function(button) { button.remove(); });
+  }
+  if (hints.defaultToNo && !store.get('replayingHistory')) {
+    var decline = container.querySelector('.permission-deny, .mate-permission-deny, .notif-banner-deny');
+    if (decline) decline.focus({ preventScroll: true });
+  }
+}