myrlin-workbook 0.9.27 → 0.9.28

package/logs/server.pid

@@ -1 +1 @@
-44496
+55976

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "myrlin-workbook",
-  "version": "0.9.27",
+  "version": "0.9.28",
   "description": "Browser-based project manager for Claude Code sessions - session discovery, multi-terminal, cost tracking, docs, and kanban board",
   "main": "src/index.js",
   "bin": {

package/src/core/td-adapter.js

@@ -82,7 +82,8 @@ async function listIssues(cwd, filters = {}, binary = DEFAULT_TD_BINARY) {
   if (filters.status) args.push('--status', filters.status);
   const { stdout } = await runTd(binary, args, cwd);
   const parsed = JSON.parse(stdout);
-  // td --json returns either an array or { issues: [...] }
+  // td --json returns either an array, { issues: [...] }, or null (empty repo)
+  if (!parsed) return [];
   return Array.isArray(parsed) ? parsed : (parsed.issues || []);
 }
 

package/src/web/public/app.js

@@ -4763,13 +4763,83 @@ class CWMApp {
     if (name === 'files') this.renderTasksFilesPanel();
   }
 
-  async renderTasksTdPanel() {
-    const panel = document.getElementById('tasks-td-panel');
+  /**
+   * Render the project switcher toolbar inside a td panel toolbar element.
+   * Populates a <select> from this._tdProjects (loaded async).
+   * @param {HTMLElement} toolbar
+   * @param {string} currentDir - the currently shown repo dir
+   */
+  _renderTdToolbar(toolbar, currentDir) {
+    toolbar.textContent = '';
+    const label = document.createElement('span');
+    label.className = 'tasks-td-toolbar-label';
+    label.textContent = 'Project';
+    toolbar.appendChild(label);
+
+    const sel = document.createElement('select');
+    sel.className = 'tasks-td-project-select';
+
+    const projects = this._tdProjects || [];
+
+    // Always include the current dir even if not yet in projects list
+    const allDirs = new Map();
+    allDirs.set(currentDir, this._tdProjectName(currentDir));
+    for (const p of projects) allDirs.set(p.repoDir, p.name || this._tdProjectName(p.repoDir));
+
+    for (const [dir, name] of allDirs) {
+      const opt = document.createElement('option');
+      opt.value = dir;
+      opt.textContent = name;
+      opt.selected = dir === currentDir;
+      sel.appendChild(opt);
+    }
+
+    sel.addEventListener('change', () => {
+      this._tdPanelDir = sel.value;
+      // Mark as manually pinned so pane focus changes don't override the selection
+      this._tdPanelDirPinned = (sel.value !== this._getTdPanelDir());
+      this.renderTasksTdPanel();
+    });
+
+    toolbar.appendChild(sel);
+
+    // Refresh button
+    const refreshBtn = document.createElement('button');
+    refreshBtn.className = 'btn btn-ghost btn-icon btn-sm tasks-td-refresh';
+    refreshBtn.title = 'Refresh';
+    refreshBtn.innerHTML = '&#8635;';
+    refreshBtn.addEventListener('click', () => this.renderTasksTdPanel());
+    toolbar.appendChild(refreshBtn);
+  }
+
+  /** Extract a short project name from a directory path */
+  _tdProjectName(dir) {
+    if (!dir) return '(unknown)';
+    return dir.split('/').filter(Boolean).pop() || dir;
+  }
+
+  /**
+   * Resolve the td repo dir for the currently focused terminal pane.
+   * Falls back to the active workspace's resolved dir.
+   * Returns null if nothing useful found.
+   */
+  _getTdPanelDir() {
+    // 1. Prefer the focused terminal pane's working dir
+    const slot = this._activeTerminalSlot;
+    const tp = slot !== null ? this.terminalPanes[slot] : null;
+    if (tp && tp.spawnOpts && tp.spawnOpts.cwd) return tp.spawnOpts.cwd;
+    // 2. Fall back to any open pane's cwd
+    for (const p of this.terminalPanes) {
+      if (p && p.spawnOpts && p.spawnOpts.cwd) return p.spawnOpts.cwd;
+    }
+    return null;
+  }
+
+  async renderTasksTdPanel(container = null) {
+    const panel = container || document.getElementById('tasks-td-panel');
     if (!panel) return;
     if (!this.getSetting('enableTd')) return;
 
-    const ws = this.state.activeWorkspace;
-
     const showPlaceholder = (msg, isError) => {
       panel.textContent = '';
       const el = document.createElement('div');
@@ -4778,24 +4848,44 @@ class CWMApp {
       panel.appendChild(el);
     };
 
-    if (!ws) {
-      showPlaceholder('No active project selected', false);
+    // Determine which dir to show: manually selected > active pane > nothing
+    const autoDir = this._getTdPanelDir();
+    if (!this._tdPanelDir && autoDir) this._tdPanelDir = autoDir;
+    const dir = this._tdPanelDir;
+
+    if (!dir) {
+      showPlaceholder('Open a project in a terminal pane to see its td issues', false);
       return;
     }
 
     showPlaceholder('Loading td issues\u2026', false);
 
+    // Load projects list for dropdown (non-blocking, updates after issues load)
+    this.api('GET', '/api/td/projects').then(projectsData => {
+      this._tdProjects = projectsData.projects || [];
+      // Re-render toolbar if panel is still showing the td view
+      const toolbar = panel.querySelector('.tasks-td-toolbar');
+      if (toolbar) this._renderTdToolbar(toolbar, dir);
+    }).catch(() => {});
+
     try {
-      const data = await this.api('GET', `/api/workspaces/${ws.id}/td/issues`);
+      const data = await this.api('GET', `/api/td/issues?dir=${encodeURIComponent(dir)}`);
       const issues = data.issues || [];
 
+      panel.textContent = '';
+      const toolbar = document.createElement('div');
+      toolbar.className = 'tasks-td-toolbar';
+      this._renderTdToolbar(toolbar, dir);
+      panel.appendChild(toolbar);
+
       if (issues.length === 0) {
-        showPlaceholder('No open td issues for this project', false);
+        const empty = document.createElement('div');
+        empty.className = 'tasks-placeholder';
+        empty.textContent = 'No open td issues for this project';
+        panel.appendChild(empty);
         return;
       }
 
-      panel.textContent = '';
-
       // Group by status in display order
       const STATUS_ORDER = ['in_progress', 'in_review', 'blocked', 'open'];
       const STATUS_LABELS = {
@@ -4869,6 +4959,10 @@ class CWMApp {
       if (msg.includes('not initialized')) {
         // td isn't initialized — show a helpful prompt rather than a raw error
         panel.textContent = '';
+        const toolbar = document.createElement('div');
+        toolbar.className = 'tasks-td-toolbar';
+        this._renderTdToolbar(toolbar, dir);
+        panel.appendChild(toolbar);
         const wrap = document.createElement('div');
         wrap.style.cssText = 'display:flex;flex-direction:column;align-items:center;gap:12px;padding:32px 24px;';
         const info = document.createElement('div');
@@ -4877,7 +4971,7 @@ class CWMApp {
         info.textContent = 'td is not initialized for this project.';
         const hint = document.createElement('div');
         hint.style.cssText = 'font-size:12px;color:var(--subtext0);text-align:center;';
-        hint.textContent = 'Run td init in the project root to enable task tracking. If this repo uses a git worktree, td should be initialized in the main repo.';
+        hint.textContent = 'Run td init in the project root to enable task tracking.';
         const initBtn = document.createElement('button');
         initBtn.className = 'btn btn-primary btn-sm';
         initBtn.textContent = 'Run td init';
@@ -4885,7 +4979,14 @@ class CWMApp {
           initBtn.disabled = true;
           initBtn.textContent = 'Initializing\u2026';
           try {
-            await this.api('POST', `/api/workspaces/${ws.id}/td/init`, {});
+            // Use the workspace-scoped init if we can find the ws, otherwise use the dir directly
+            const ws = this.state.activeWorkspace;
+            if (ws) {
+              await this.api('POST', `/api/workspaces/${ws.id}/td/init`, { repoDir: dir });
+            } else {
+              // Fallback: run td init via a generic endpoint if workspace isn't known
+              throw new Error('No active workspace to run td init against. Run `td init` manually in ' + dir);
+            }
             this.renderTasksTdPanel();
           } catch (e) {
             initBtn.disabled = false;
@@ -9978,6 +10079,24 @@ class CWMApp {
           });
         }
 
+        // Pinned notes (bookmark) button — shows modal of all pinned notes for this pane's session
+        const pinDocBtn = pane.querySelector('.terminal-pane-pinnedoc');
+        if (pinDocBtn) {
+          pinDocBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            this._showPinnedNotesModal(slotIdx);
+          });
+        }
+
+        // Pane view back button — restores terminal after a non-terminal view (E003)
+        const backBtn = pane.querySelector('.pane-view-back');
+        if (backBtn) {
+          backBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            if (this.restoreTerminalInPane) this.restoreTerminalInPane(slotIdx);
+          });
+        }
+
         // Drag-to-reposition: make pane header draggable to swap panes
         const header = pane.querySelector('.terminal-pane-header');
         if (header) {
@@ -10166,6 +10285,9 @@ class CWMApp {
     if (this.state.settings.paneColorHighlights) {
       this.renderWorkspaces();
     }
+
+    // Refresh pinned-notes badge for this pane now that a session is loaded
+    this._refreshPanePin(slotIdx);
   }
 
   /**
@@ -10206,6 +10328,31 @@ class CWMApp {
     el.innerHTML = `<span class="activity-dot ${dotClass}"></span>${label}${detail}`;
   }
 
+  /**
+   * Show a modal listing all pinned notes for the session currently open in the given pane slot.
+   * Fetches notes from the backend and displays them with timestamps.
+   * If there are no pinned notes, shows an info toast instead.
+   * @param {number} slotIdx - The terminal pane slot index
+   */
+  async _showPinnedNotesModal(slotIdx) {
+    const tp = this.terminalPanes[slotIdx];
+    if (!tp || !tp.sessionId) return;
+    const ws = this.state.activeWorkspace;
+    if (!ws) return;
+    const data = await this.api('GET', `/api/workspaces/${ws.id}/pinned-notes/${tp.sessionId}`);
+    const notes = data.notes || [];
+    if (notes.length === 0) {
+      this.showToast('No pinned notes for this session', 'info');
+      return;
+    }
+    const body = notes.map(n => `[${n.timestamp}]\n${n.text}`).join('\n\n---\n\n');
+    await this.showPromptModal({
+      title: 'Pinned Notes',
+      fields: [{ key: 'body', type: 'textarea', value: body }],
+      confirmText: 'Close',
+    });
+  }
+
   showTerminalContextMenu(slotIdx, x, y) {
     const tp = this.terminalPanes[slotIdx];
     if (!tp) return;
@@ -10227,6 +10374,26 @@ class CWMApp {
       });
     }
 
+    // Save to Notes (only show when there's a selection)
+    if (tp.term && tp.term.hasSelection()) {
+      items.push({
+        label: 'Save to Notes', icon: '&#128221;', action: async () => {
+          const selected = tp.term.getSelection();
+          const ws = this.state.activeWorkspace;
+          if (!ws) { this.showToast('No active workspace', 'error'); return; }
+          const result = await this.showPromptModal({
+            title: 'Save to Notes',
+            fields: [{ key: 'text', type: 'textarea', value: selected }],
+            confirmText: 'Save Note'
+          });
+          if (!result) return;
+          await this.api('POST', '/api/workspaces/' + ws.id + '/docs/notes', { text: result.text.trim() });
+          this.loadDocs();
+          this.showToast('Saved to Notes', 'success');
+        },
+      });
+    }
+
     // Paste from clipboard
     items.push({
       label: 'Paste', icon: '&#128203;', action: () => {
@@ -10992,6 +11159,15 @@ class CWMApp {
       tp.setFocused(true);
       tp.focus();
     }
+
+    // If Tasks > td tab is visible and not manually pinned, update to this pane's project
+    if (this._activeTasksTab === 'td' && !this._tdPanelDirPinned) {
+      const newDir = tp && tp.spawnOpts && tp.spawnOpts.cwd ? tp.spawnOpts.cwd : null;
+      if (newDir && newDir !== this._tdPanelDir) {
+        this._tdPanelDir = newDir;
+        this.renderTasksTdPanel();
+      }
+    }
   }
 
   /**
@@ -11810,16 +11986,54 @@ class CWMApp {
     if (this.els.docsRoadmapCount) this.els.docsRoadmapCount.textContent = (docs.roadmap || []).length;
     if (this.els.docsRulesCount) this.els.docsRulesCount.textContent = (docs.rules || []).length;
 
-    // Notes
+    // Notes — built with DOM APIs to support pin buttons safely (no user HTML injected)
     if (this.els.docsNotesList) {
-      this.els.docsNotesList.innerHTML = (docs.notes || []).length > 0
-        ? (docs.notes || []).map((n, i) => `
-          <div class="docs-item" data-index="${i}">
-            <span class="docs-note-time">${this.escapeHtml(n.timestamp || '')}</span>
-            <span class="docs-note-text">${this.escapeHtml(n.text)}</span>
-            <button class="docs-item-delete btn btn-ghost btn-icon btn-sm" data-section="notes" data-index="${i}" title="Remove">&times;</button>
-          </div>`).join('')
-        : '<div class="docs-empty">No notes yet. Click + to add one.</div>';
+      const notes = docs.notes || [];
+      while (this.els.docsNotesList.firstChild) {
+        this.els.docsNotesList.removeChild(this.els.docsNotesList.firstChild);
+      }
+      if (notes.length === 0) {
+        const empty = document.createElement('div');
+        empty.className = 'docs-empty';
+        empty.textContent = 'No notes yet. Click + to add one.';
+        this.els.docsNotesList.appendChild(empty);
+      } else {
+        notes.forEach((n, noteIndex) => {
+          const noteRow = document.createElement('div');
+          noteRow.className = 'docs-item';
+          noteRow.dataset.index = noteIndex;
+
+          const timeSpan = document.createElement('span');
+          timeSpan.className = 'docs-note-time';
+          timeSpan.textContent = n.timestamp || '';
+          noteRow.appendChild(timeSpan);
+
+          const textSpan = document.createElement('span');
+          textSpan.className = 'docs-note-text';
+          textSpan.textContent = n.text;
+          noteRow.appendChild(textSpan);
+
+          const pinBtn = document.createElement('button');
+          pinBtn.className = 'doc-pin-btn btn btn-ghost btn-icon btn-sm';
+          pinBtn.textContent = '📌';
+          pinBtn.title = 'Pin to focused terminal session';
+          pinBtn.addEventListener('click', (e) => {
+            e.stopPropagation();
+            this._toggleNotePin(noteIndex, pinBtn);
+          });
+          noteRow.appendChild(pinBtn);
+
+          const delBtn = document.createElement('button');
+          delBtn.className = 'docs-item-delete btn btn-ghost btn-icon btn-sm';
+          delBtn.dataset.section = 'notes';
+          delBtn.dataset.index = noteIndex;
+          delBtn.title = 'Remove';
+          delBtn.textContent = '×';
+          noteRow.appendChild(delBtn);
+
+          this.els.docsNotesList.appendChild(noteRow);
+        });
+      }
     }
 
     // Goals
@@ -11971,6 +12185,52 @@ class CWMApp {
     }
   }
 
+  /**
+   * Toggle a pinned note on the currently focused terminal pane session.
+   * @param {number} noteIndex - 0-based index of the note in the workspace docs.notes array
+   * @param {HTMLButtonElement} buttonEl - The pin button element to update visually
+   */
+  async _toggleNotePin(noteIndex, buttonEl) {
+    const slot = this._activeTerminalSlot;
+    const tp = (slot !== null && slot !== undefined) ? this.terminalPanes[slot] : null;
+    if (!tp || !tp.sessionId) {
+      this.showToast('Focus a terminal pane first', 'error');
+      return;
+    }
+    const ws = this.state.activeWorkspace;
+    if (!ws) return;
+    const isPinned = buttonEl.classList.contains('pinned');
+    const action = isPinned ? 'unpin' : 'pin';
+    await this.api('POST', `/api/workspaces/${ws.id}/pinned-notes`, {
+      sessionId: tp.sessionId,
+      noteIndex,
+      action
+    });
+    buttonEl.classList.toggle('pinned', !isPinned);
+    await this._refreshPanePin(slot);
+  }
+
+  /**
+   * Refresh the pinned-notes badge on a terminal pane header.
+   * Shows/hides the badge button and updates the count label.
+   * @param {number} slotIdx - Terminal pane slot index (0-based)
+   */
+  async _refreshPanePin(slotIdx) {
+    const tp = this.terminalPanes[slotIdx];
+    if (!tp || !tp.sessionId) return;
+    const ws = this.state.activeWorkspace;
+    if (!ws) return;
+    const data = await this.api('GET', `/api/workspaces/${ws.id}/pinned-notes`);
+    const pins = data[tp.sessionId] || [];
+    const paneEl = document.getElementById(`term-pane-${slotIdx}`);
+    if (!paneEl) return;
+    const pinDocBtn = paneEl.querySelector('.terminal-pane-pinnedoc');
+    if (!pinDocBtn) return;
+    pinDocBtn.hidden = pins.length === 0;
+    const countEl = pinDocBtn.querySelector('.pane-pin-count');
+    if (countEl) countEl.textContent = pins.length > 0 ? pins.length : '';
+  }
+
 
   /* ═══════════════════════════════════════════════════════════
      TD ISSUES — docs panel integration

package/src/web/public/index.html

@@ -558,6 +558,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -604,6 +605,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -650,6 +652,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -696,6 +699,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -742,6 +746,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>
@@ -788,6 +793,7 @@
                   <path d="M5.5 0a.5.5 0 0 1 .5.5v4A1.5 1.5 0 0 1 4.5 6h-4a.5.5 0 0 1 0-1h4a.5.5 0 0 0 .5-.5v-4a.5.5 0 0 1 .5-.5zm5 0a.5.5 0 0 1 .5.5v4a.5.5 0 0 0 .5.5h4a.5.5 0 0 1 0 1h-4A1.5 1.5 0 0 1 10 4.5v-4a.5.5 0 0 1 .5-.5zM0 10.5a.5.5 0 0 1 .5-.5h4A1.5 1.5 0 0 1 6 11.5v4a.5.5 0 0 1-1 0v-4a.5.5 0 0 0-.5-.5h-4a.5.5 0 0 1-.5-.5zm10 1a1.5 1.5 0 0 1 1.5-1.5h4a.5.5 0 0 1 0 1h-4a.5.5 0 0 0-.5.5v4a.5.5 0 0 1-1 0v-4z"/>
                 </svg>
               </button>
+              <button class="terminal-pane-pinnedoc btn btn-ghost btn-icon btn-sm" title="Pinned notes" hidden>📌<span class="pane-pin-count"></span></button>
               <button class="terminal-pane-close btn btn-ghost btn-icon btn-sm" hidden>
                 <svg width="14" height="14" viewBox="0 0 16 16" fill="currentColor"><path d="M4.646 4.646a.5.5 0 0 1 .708 0L8 7.293l2.646-2.647a.5.5 0 0 1 .708.708L8.707 8l2.647 2.646a.5.5 0 0 1-.708.708L8 8.707l-2.646 2.647a.5.5 0 0 1-.708-.708L7.293 8 4.646 5.354a.5.5 0 0 1 0-.708z"/></svg>
               </button>

package/src/web/public/styles.css

@@ -4313,6 +4313,19 @@ textarea.input {
   color: var(--red);
 }
 
+.doc-pin-btn {
+  opacity: 0.4;
+  transition: opacity 0.15s;
+  flex-shrink: 0;
+  cursor: pointer;
+}
+
+.doc-pin-btn:hover,
+.doc-pin-btn.pinned {
+  opacity: 1;
+  color: var(--mauve);
+}
+
 /* Roadmap items */
 .roadmap-status-dot {
   background: none;
@@ -5031,6 +5044,15 @@ textarea.input {
 @media (prefers-reduced-motion: reduce) {
   .terminal-pane-mic.mic-active { animation: none; }
 }
+.pane-pin-count {
+  font-size: 10px;
+  background: var(--mauve);
+  color: var(--base);
+  border-radius: 8px;
+  padding: 0 4px;
+  margin-left: 2px;
+  font-weight: 600;
+}
 /* Voice interim transcript overlay - shown at bottom of terminal pane during recording */
 .voice-interim-overlay {
   position: absolute;
@@ -6321,6 +6343,20 @@ html.activity-indicators-disabled .terminal-pane-activity {
   flex: 1;
   overflow-y: auto;
   min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+/* td panel needs its toolbar fixed at top, list scrolls below */
+#tasks-td-panel {
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+#tasks-td-panel .tasks-td-toolbar { flex-shrink: 0; }
+#tasks-td-panel .tasks-td-group-header,
+#tasks-td-panel .tasks-td-row,
+#tasks-td-panel .tasks-placeholder {
+  flex-shrink: 0;
 }
 
 /* ── Placeholder / empty states ──────────────────────── */
@@ -6394,6 +6430,40 @@ html.activity-indicators-disabled .terminal-pane-activity {
 .td-priority-badge.priority-p2 { background: var(--yellow); color: var(--base); }
 .td-priority-badge.priority-p3 { background: var(--surface2); color: var(--text); }
 
+/* ── td panel project switcher toolbar ───────────────── */
+.tasks-td-toolbar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px 12px;
+  border-bottom: 1px solid var(--surface1);
+  background: var(--mantle);
+  flex-shrink: 0;
+}
+.tasks-td-toolbar-label {
+  font-size: 11px;
+  color: var(--subtext0);
+  font-weight: 600;
+  white-space: nowrap;
+}
+.tasks-td-project-select {
+  flex: 1;
+  font-size: 12px;
+  background: var(--surface0);
+  color: var(--text);
+  border: 1px solid var(--surface2);
+  border-radius: 4px;
+  padding: 2px 6px;
+  min-width: 0;
+  cursor: pointer;
+}
+.tasks-td-project-select:focus { outline: none; border-color: var(--mauve); }
+.tasks-td-refresh {
+  font-size: 14px;
+  padding: 2px 6px;
+  flex-shrink: 0;
+}
+
 /* ─── New Task Dialog form elements ──────────────────── */
 .form-group {
   margin-bottom: 14px;

package/src/web/server.js

@@ -750,6 +750,151 @@ app.delete('/api/workspaces/:id/docs/:section/:index', requireAuth, (req, res) =
   return res.json({ success: true });
 });
 
+// ──────────────────────────────────────────────────────────
+//  PINNED NOTES
+//  Per-session pinned note indices, persisted as JSON files
+//  under ~/.myrlin/pinned-notes/{workspaceId}.json
+//  Format: { [sessionId]: [noteIndex, ...] }
+// ──────────────────────────────────────────────────────────
+
+/**
+ * Return the directory used to store pinned-note files.
+ * Creates it if it does not already exist.
+ * @returns {string}
+ */
+function getPinnedNotesDir() {
+  const dir = path.join(getDataDir(), 'pinned-notes');
+  require('fs').mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+/**
+ * Read the pinned-notes map for a workspace from disk.
+ * Returns {} if the file does not exist or cannot be parsed.
+ * @param {string} workspaceId
+ * @returns {{ [sessionId: string]: number[] }}
+ */
+function getPinnedNotes(workspaceId) {
+  const file = path.join(getPinnedNotesDir(), `${workspaceId}.json`);
+  try {
+    const raw = require('fs').readFileSync(file, 'utf-8');
+    return JSON.parse(raw);
+  } catch (_) {
+    return {};
+  }
+}
+
+/**
+ * Atomically write the pinned-notes map for a workspace.
+ * Writes to a temp file then renames to ensure no partial reads.
+ * @param {string} workspaceId
+ * @param {{ [sessionId: string]: number[] }} data
+ */
+function savePinnedNotes(workspaceId, data) {
+  const fs = require('fs');
+  const dir = getPinnedNotesDir();
+  const file = path.join(dir, `${workspaceId}.json`);
+  const tmp = path.join(dir, `.tmp.${Date.now()}.${workspaceId}.json`);
+  fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf-8');
+  fs.renameSync(tmp, file);
+}
+
+/**
+ * Add noteIndex to the pinned list for sessionId, deduplicating.
+ * @param {string} wsId
+ * @param {string} sessionId
+ * @param {number} noteIndex
+ */
+function pin(wsId, sessionId, noteIndex) {
+  const data = getPinnedNotes(wsId);
+  const existing = data[sessionId] || [];
+  if (!existing.includes(noteIndex)) {
+    existing.push(noteIndex);
+  }
+  data[sessionId] = existing;
+  savePinnedNotes(wsId, data);
+}
+
+/**
+ * Remove noteIndex from the pinned list for sessionId.
+ * @param {string} wsId
+ * @param {string} sessionId
+ * @param {number} noteIndex
+ */
+function unpin(wsId, sessionId, noteIndex) {
+  const data = getPinnedNotes(wsId);
+  if (!data[sessionId]) return;
+  data[sessionId] = data[sessionId].filter(i => i !== noteIndex);
+  savePinnedNotes(wsId, data);
+}
+
+/**
+ * GET /api/workspaces/:id/pinned-notes
+ * Returns the full pinned-notes map: { [sessionId]: [noteIndex, ...] }
+ */
+app.get('/api/workspaces/:id/pinned-notes', requireAuth, (req, res) => {
+  const store = getStore();
+  const ws = store.getWorkspace(req.params.id);
+  if (!ws) return res.status(404).json({ error: 'Workspace not found.' });
+
+  const data = getPinnedNotes(req.params.id);
+  return res.json(data);
+});
+
+/**
+ * POST /api/workspaces/:id/pinned-notes
+ * Body: { sessionId, noteIndex, action: 'pin' | 'unpin' }
+ * Pins or unpins a note index for a session.
+ */
+app.post('/api/workspaces/:id/pinned-notes', requireAuth, (req, res) => {
+  const store = getStore();
+  const ws = store.getWorkspace(req.params.id);
+  if (!ws) return res.status(404).json({ error: 'Workspace not found.' });
+
+  const { sessionId, noteIndex, action } = req.body || {};
+  if (!sessionId || noteIndex === undefined || noteIndex === null) {
+    return res.status(400).json({ error: 'sessionId and noteIndex are required.' });
+  }
+  const idx = parseInt(noteIndex, 10);
+  if (isNaN(idx) || idx < 0) {
+    return res.status(400).json({ error: 'noteIndex must be a non-negative integer.' });
+  }
+
+  if (action === 'unpin') {
+    unpin(req.params.id, sessionId, idx);
+  } else {
+    pin(req.params.id, sessionId, idx);
+  }
+  return res.json({ success: true });
+});
+
+/**
+ * GET /api/workspaces/:id/pinned-notes/:sessionId
+ * Returns resolved note objects for the session's pinned indices.
+ * Response: { notes: [{ text, timestamp }, ...] }
+ * Returns empty array (not 404) if the session has no pins.
+ */
+app.get('/api/workspaces/:id/pinned-notes/:sessionId', requireAuth, (req, res) => {
+  const store = getStore();
+  const ws = store.getWorkspace(req.params.id);
+  if (!ws) return res.status(404).json({ error: 'Workspace not found.' });
+
+  const data = getPinnedNotes(req.params.id);
+  const indices = data[req.params.sessionId] || [];
+
+  if (indices.length === 0) {
+    return res.json({ notes: [] });
+  }
+
+  const docs = store.getWorkspaceDocs(req.params.id);
+  const allNotes = (docs && docs.notes) ? docs.notes : [];
+  const notes = indices
+    .filter(i => i >= 0 && i < allNotes.length)
+    .map(i => ({ text: allNotes[i].text, timestamp: allNotes[i].timestamp }));
+
+  return res.json({ notes });
+});
+
 // ──────────────────────────────────────────────────────────
 //  TD TASK INTEGRATION
 //  These endpoints bridge myrlin's docs panel to the `td` CLI
@@ -858,6 +1003,39 @@ app.put('/api/workspaces/:id/td/repodir', requireAuth, (req, res) => {
   return res.json({ success: true, repoDir });
 });
 
+/**
+ * GET /api/td/projects
+ * Return all workspaces that have td initialized, with their resolved repo dirs.
+ * Used by the Tasks > td panel dropdown.
+ */
+app.get('/api/td/projects', requireAuth, (req, res) => {
+  const store = getStore();
+  const allWorkspaces = store.getAllWorkspacesList();
+  const projects = [];
+  for (const ws of allWorkspaces) {
+    const repoDir = resolveTdRepoDir(store, ws.id);
+    if (repoDir && td.isInitialized(repoDir)) {
+      projects.push({ name: ws.name, repoDir, workspaceId: ws.id });
+    }
+  }
+  return res.json({ projects });
+});
+
+/**
+ * GET /api/td/issues?dir=<path>
+ * List td issues for an explicit repo directory (not workspace-scoped).
+ * Allows the Tasks panel to show issues for whatever dir is focused.
+ * Query: ?dir=<absolute-path>, ?status=open|in_progress|...
+ */
+app.get('/api/td/issues', requireAuth, async (req, res) => {
+  const dir = req.query.dir ? decodeURIComponent(req.query.dir) : null;
+  if (!dir) return res.status(400).json({ error: 'dir query parameter required.' });
+  if (!td.isInitialized(dir)) return res.status(400).json({ error: 'td is not initialized in this directory.' });
+  const filters = req.query.status ? { status: req.query.status } : {};
+  const issues = await td.listIssues(dir, filters, getTdBinary());
+  return res.json({ issues, repoDir: dir });
+});
+
 /**
  * GET /api/workspaces/:id/td/issues
  * List td issues for this workspace's repo.