claude-code-memory-explorer 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-memory-explorer",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Memory explorer dashboard for Claude Code",
   "main": "server.js",
   "bin": {

package/public/app.js

@@ -401,6 +401,10 @@ function navigateGroup(direction) {
 
 // #region MEMORY_INDEX
 
+function isMemoryIndex(source) {
+  return (source.scope === 'memory' || source.scope === 'user-memory') && source.name === 'MEMORY.md';
+}
+
 function parseMemoryIndex(content) {
   const entries = [];
   for (const line of content.split('\n')) {
@@ -457,8 +461,16 @@ async function renderPreview() {
   html += '<div class="preview-title">';
   html += `<span class="scope-badge scope-${source.scope}">${esc(source.scope)}</span>`;
   html += `<span class="file-path">${esc(source.name)}</span>`;
+  html += '<div class="preview-actions">';
+  if (isMemoryIndex(source)) {
+    const broken = (source.unresolvedImports || []).length;
+    if (broken) {
+      html += `<button class="action-btn small" onclick="_cleanupOrphans('${escJs(source.path)}')" title="Cleanup ${broken} orphaned refs"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M3 6h18"/><path d="M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/><path d="M19 6l-1 14a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2L5 6"/><path d="M12 11v6"/></svg><span style="margin-left:3px">${broken}</span></button>`;
+    }
+  }
   html += `<button class="action-btn small" onclick="openInEditor('${escJs(source.path)}')" title="Open in VS Code"><svg width="12" height="12" viewBox="0 0 24 24" fill="currentColor" stroke="none"><path d="M17.583 2.207a1.1 1.1 0 0 1 1.541.033l2.636 2.636a1.1 1.1 0 0 1 .033 1.541L10.68 17.53a1.1 1.1 0 0 1-.345.247l-4.56 1.903a.55.55 0 0 1-.725-.725l1.903-4.56a1.1 1.1 0 0 1 .247-.345zm.902 1.87-8.794 8.793-.946 2.268 2.268-.946 8.794-8.793z"/></svg></button>`;
-  html += '</div>';
+  html += `<button class="action-btn small" onclick="_confirmDeleteFile('${escJs(source.path)}','${escJs(source.name)}')" title="Delete file"><svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="3 6 5 6 21 6"/><path d="M19 6l-1 14a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2L5 6"/><path d="M10 11v6M14 11v6"/><path d="M9 6V4a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1v2"/></svg></button>`;
+  html += '</div></div>';
 
   // Badges row
   html += '<div class="preview-badges">';
@@ -472,10 +484,13 @@ async function renderPreview() {
   }
   html += '</div>';
 
-  // Imports — only show children (files that have this source as parent)
+  const content = fileData.content || '';
+  const memoryEntries = isMemoryIndex(source) ? parseMemoryIndex(content) : [];
+  const showMemoryTable = memoryEntries.length > 0;
+
   const children = stackData.filter((s) => s.parentId === source.id);
   const unresolved = source.unresolvedImports || [];
-  if (children.length || unresolved.length) {
+  if (!showMemoryTable && (children.length || unresolved.length)) {
     html += '<div class="preview-imports">';
     for (const child of children) {
       html += `<a class="import-link" href="#" onclick="selectFile('${escJs(child.id)}');return false" title="${esc(child.path)}">${esc(child.name)}</a>`;
@@ -491,19 +506,16 @@ async function renderPreview() {
   // File path
   html += `<div class="preview-filepath">${esc(source.path)}</div>`;
 
-  // Content — with cutoff line for auto memory startup files
-  const content = fileData.content || '';
   const hl = (text) => {
     const { text: processed, placeholders } = linkifyImports(text, source.id);
     return restorePlaceholders(highlightSource(processed, source.name), placeholders);
   };
 
-  // Memory index view — render structured table for MEMORY.md index files
-  if ((source.scope === 'memory' || source.scope === 'user-memory') && source.name === 'MEMORY.md') {
-    const entries = parseMemoryIndex(content);
-    if (entries.length) {
-      html += renderMemoryIndexTable(entries);
-    }
+  if (showMemoryTable) {
+    html += renderMemoryIndexTable(memoryEntries);
+    html += `<pre class="preview-code"><code>${hl(content)}</code></pre>`;
+    panel.innerHTML = html;
+    return;
   }
 
   if ((source.scope === 'memory' || source.scope === 'user-memory') && source.load === 'startup' && source.maxLines) {
@@ -530,6 +542,96 @@ function formatBytes(b) {
   return `${(b / 1024).toFixed(1)}KB`;
 }
 
+function _confirmDeleteFile(filePath, fileName) {
+  const modal = document.getElementById('deleteConfirmModal');
+  modal.dataset.filePath = filePath;
+  document.getElementById('deleteFileName').textContent = fileName;
+  document.getElementById('deleteFilePath').textContent = filePath;
+  modal.classList.add('open');
+}
+
+async function _submitDeleteFile() {
+  const modal = document.getElementById('deleteConfirmModal');
+  const filePath = modal.dataset.filePath;
+  if (!filePath) return;
+  const btn = document.getElementById('deleteConfirmSubmit');
+  btn.disabled = true;
+  btn.textContent = 'Deleting...';
+  try {
+    const res = await fetch('/api/file', {
+      method: 'DELETE',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ path: filePath }),
+    });
+    if (!res.ok) {
+      const msg = await res
+        .json()
+        .then((e) => e.error)
+        .catch(() => `Delete failed (${res.status})`);
+      showToast(msg, 'error');
+      return;
+    }
+    closeModal('deleteConfirmModal');
+    delete modal.dataset.filePath;
+    selectedFileId = null;
+    await loadData();
+    showToast('File deleted', 'success');
+  } catch (err) {
+    showToast(err.message, 'error');
+  } finally {
+    btn.disabled = false;
+    btn.textContent = 'Delete';
+  }
+}
+
+function _cleanupOrphans(filePath) {
+  const source = stackData.find((s) => s.path === filePath);
+  const broken = source?.unresolvedImports || [];
+  if (!broken.length) {
+    showToast('No orphaned refs', 'info');
+    return;
+  }
+  const modal = document.getElementById('cleanupOrphansModal');
+  modal.dataset.filePath = filePath;
+  document.getElementById('cleanupOrphansCount').textContent = broken.length;
+  document.getElementById('cleanupOrphansList').innerHTML = broken.map((r) => `<li>${esc(r)}</li>`).join('');
+  modal.classList.add('open');
+}
+
+async function _submitCleanupOrphans() {
+  const modal = document.getElementById('cleanupOrphansModal');
+  const filePath = modal.dataset.filePath;
+  if (!filePath) return;
+  const btn = document.getElementById('cleanupOrphansSubmit');
+  btn.disabled = true;
+  btn.textContent = 'Cleaning...';
+  try {
+    const res = await fetch('/api/memory/cleanup-orphans', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ path: filePath }),
+    });
+    if (!res.ok) {
+      const msg = await res
+        .json()
+        .then((e) => e.error)
+        .catch(() => `Cleanup failed (${res.status})`);
+      showToast(msg, 'error');
+      return;
+    }
+    const data = await res.json();
+    closeModal('cleanupOrphansModal');
+    delete modal.dataset.filePath;
+    await loadData();
+    showToast(`Removed ${data.removed.length} orphaned ref${data.removed.length === 1 ? '' : 's'}`, 'success');
+  } catch (err) {
+    showToast(err.message, 'error');
+  } finally {
+    btn.disabled = false;
+    btn.textContent = 'Remove';
+  }
+}
+
 async function openInEditor(filePath) {
   showToast('Opening...', 'info');
   try {
@@ -617,7 +719,7 @@ async function refreshData() {
   try {
     await fetch('/api/refresh', { method: 'POST' });
     await loadData();
-    showToast('Refreshed', 'success');
+    showToast('Data Refreshed', 'success');
   } catch (err) {
     showToast(err.message, 'error');
   }
@@ -765,18 +867,21 @@ document.addEventListener('DOMContentLoaded', async () => {
   loadTheme();
   initResize();
   bindModalKeys('projectPathInput', 'projectPickerModal', submitProjectPicker);
-  // Handle ?project= query param
+  // Handle ?project= query param, else restore last-used project from localStorage
   const params = new URLSearchParams(location.search);
-  if (params.has('project')) {
-    const projectPath = params.get('project');
+  let desiredProject = params.get('project');
+  if (!desiredProject) desiredProject = getRecentProjects()[0] || null;
+  if (desiredProject) {
     try {
       const res = await fetch('/api/project', {
         method: 'PUT',
         headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({ path: projectPath }),
+        body: JSON.stringify({ path: desiredProject }),
       });
-      if (!res.ok) showToast('Failed to switch project', 'error');
+      if (!res.ok && params.has('project')) showToast('Failed to switch project', 'error');
     } catch {}
+  }
+  if (params.has('project')) {
     params.delete('project');
     const qs = params.toString();
     history.replaceState(null, '', qs ? `?${qs}` : location.pathname + location.hash);

package/public/index.html

@@ -34,12 +34,12 @@
     <button class="topbar-btn" id="refreshBtn" title="Refresh (r)" onclick="refreshData()">
       <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="23 4 23 10 17 10"/><path d="M20.49 15a9 9 0 11-2.12-9.36L23 10"/></svg>
     </button>
-    <button class="topbar-btn" id="helpBtn" title="Keyboard shortcuts (?)" onclick="toggleHelpModal()">
-      <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><circle cx="12" cy="17" r="0.5" fill="currentColor"/></svg>
-    </button>
     <button class="topbar-btn" id="themeBtn" title="Toggle theme (t)" onclick="toggleTheme()">
       <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/></svg>
     </button>
+    <button class="topbar-btn" id="helpBtn" title="Keyboard shortcuts (?)" onclick="toggleHelpModal()">
+      <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><circle cx="12" cy="17" r="0.5" fill="currentColor"/></svg>
+    </button>
     <a class="topbar-btn" href="https://github.com/NikiforovAll/claude-code-memory" target="_blank" rel="noopener" title="GitHub">
       <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" stroke="none"><path d="M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0024 12c0-6.63-5.37-12-12-12z"/></svg>
     </a>
@@ -104,6 +104,42 @@
     </div>
   </div>
 
+  <!-- Delete confirmation modal -->
+  <div class="modal-overlay" id="deleteConfirmModal" onclick="if(event.target===this)closeModal('deleteConfirmModal')">
+    <div class="modal">
+      <div class="modal-header">
+        <h3>Delete file?</h3>
+        <button class="modal-close" onclick="closeModal('deleteConfirmModal')">&#10005;</button>
+      </div>
+      <div class="modal-body">
+        <p class="modal-desc">This will permanently delete <strong id="deleteFileName"></strong> from disk.</p>
+        <div class="modal-filepath" id="deleteFilePath"></div>
+        <div class="modal-actions">
+          <button class="action-btn" onclick="closeModal('deleteConfirmModal')">Cancel</button>
+          <button class="action-btn danger" id="deleteConfirmSubmit" onclick="_submitDeleteFile()">Delete</button>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Cleanup orphans modal -->
+  <div class="modal-overlay" id="cleanupOrphansModal" onclick="if(event.target===this)closeModal('cleanupOrphansModal')">
+    <div class="modal">
+      <div class="modal-header">
+        <h3>Cleanup orphaned refs?</h3>
+        <button class="modal-close" onclick="closeModal('cleanupOrphansModal')">&#10005;</button>
+      </div>
+      <div class="modal-body">
+        <p class="modal-desc">Remove <strong id="cleanupOrphansCount"></strong> bullet line(s) from MEMORY.md that point to files missing on disk.</p>
+        <ul id="cleanupOrphansList" class="modal-orphan-list"></ul>
+        <div class="modal-actions">
+          <button class="action-btn" onclick="closeModal('cleanupOrphansModal')">Cancel</button>
+          <button class="action-btn danger" id="cleanupOrphansSubmit" onclick="_submitCleanupOrphans()">Remove</button>
+        </div>
+      </div>
+    </div>
+  </div>
+
   <!-- Help modal -->
   <div class="modal-overlay" id="helpModal" onclick="if(event.target===this)toggleHelpModal()">
     <div class="modal">

package/public/style.css

@@ -411,20 +411,27 @@ body.light .tree-conditional .file-name {
 }
 .memory-index-row {
   display: grid;
-  grid-template-columns: 72px 160px 1fr;
+  grid-template-columns: 72px max-content 1fr;
   align-items: baseline;
   gap: 8px;
   padding: 3px 0;
 }
 .memory-index-type {
-  flex-shrink: 0;
+  text-align: center;
+  justify-self: center;
+}
+.modal-orphan-list {
+  margin: 0;
+  padding: 8px 12px 8px 28px;
+  list-style: disc;
+  font-family: var(--font-mono);
+  font-size: 11px;
+  color: var(--text-muted);
 }
 .memory-index-name {
   font-size: 11px;
   font-family: var(--font-mono);
   white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
 }
 .memory-index-desc {
   font-size: 10px;
@@ -665,10 +672,33 @@ body.light .tree-conditional .file-name {
 .action-btn.primary:hover {
   filter: brightness(1.1);
 }
+.action-btn.danger {
+  background: var(--error);
+  border-color: var(--error);
+  color: #fff;
+}
+.action-btn.danger:hover {
+  filter: brightness(1.1);
+}
+.modal-filepath {
+  font-family: 'IBM Plex Mono', monospace;
+  font-size: 11px;
+  color: var(--text-tertiary);
+  background: var(--bg-deep);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 6px 8px;
+  margin: 8px 0 12px;
+  word-break: break-all;
+}
+.preview-actions {
+  margin-left: auto;
+  display: inline-flex;
+  gap: 4px;
+}
 .action-btn.small {
   padding: 2px 6px;
   font-size: 10px;
-  margin-left: auto;
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -787,8 +817,8 @@ kbd {
   color: var(--error);
 }
 .toast.success {
-  border-color: var(--success);
-  color: var(--success);
+  border-color: #2ea043;
+  color: #2ea043;
 }
 @keyframes slideIn {
   from {

package/server.js

@@ -5,6 +5,7 @@ const express = require('express');
 const path = require('path');
 const fs = require('fs');
 const os = require('os');
+const { execFileSync } = require('child_process');
 
 // #region CLI_ARGS
 
@@ -159,6 +160,11 @@ function spreadImports(filePath, content) {
   return { imports: resolved, softImports: resolvedSoft, unresolvedImports: unresolved };
 }
 
+function hasPathsFilter(frontmatter) {
+  if (!frontmatter || !frontmatter.paths) return false;
+  return Array.isArray(frontmatter.paths) ? frontmatter.paths.length > 0 : true;
+}
+
 function discoverMemorySources(projectPath) {
   const sources = [];
 
@@ -201,7 +207,7 @@ function discoverMemorySources(projectPath) {
         id: `user-rule-${path.basename(file, '.md')}`,
         name: path.basename(file),
         scope: 'rule',
-        load: 'conditional',
+        load: hasPathsFilter(info.frontmatter) ? 'conditional' : 'always',
         ...info,
         ruleSource: 'user',
         ...spreadImports(info.path, info.content),
@@ -292,7 +298,7 @@ function discoverMemorySources(projectPath) {
         id: `project-rule-${path.basename(file, '.md')}`,
         name: path.basename(file),
         scope: 'rule',
-        load: 'conditional',
+        load: hasPathsFilter(info.frontmatter) ? 'conditional' : 'always',
         ...info,
         ruleSource: 'project',
         ...spreadImports(info.path, info.content),
@@ -446,15 +452,38 @@ function findMemoryDir(projectPath) {
   const encoded = encodeProjectPath(projectPath);
   const memDir = path.join(projectsDir, encoded, 'memory');
   if (fs.existsSync(memDir)) return memDir;
+  const main = findMainWorktreePath(projectPath);
+  if (main) {
+    const mainMem = path.join(projectsDir, encodeProjectPath(main), 'memory');
+    if (fs.existsSync(mainMem)) return mainMem;
+  }
   return findMemoryDirBySubstring(projectPath);
 }
 
+function findMainWorktreePath(projectPath) {
+  try {
+    const out = execFileSync('git', ['-C', projectPath, 'rev-parse', '--git-common-dir'], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+      timeout: 2000,
+    }).trim();
+    if (!out) return null;
+    const resolved = path.resolve(projectPath, out);
+    if (path.basename(resolved) !== '.git') return null;
+    const main = path.dirname(resolved);
+    if (main === path.resolve(projectPath)) return null;
+    return main;
+  } catch {
+    return null;
+  }
+}
+
 function encodeProjectPath(projectPath) {
-  // Claude Code uses double-dash encoding: C--Users-nikiforovall-dev-foo
+  // Claude Code encoding: `:` and `/` both become `-`, so `C:\Users\foo` → `C--Users-foo`
   return projectPath
     .replace(/\\/g, '/')
-    .replace(/^([A-Za-z]):/, '$1')  // strip colon but keep drive letter
-    .replace(/\//g, '-');           // slashes become single dash; drive letter boundary becomes double dash naturally
+    .replace(/:/g, '-')
+    .replace(/\//g, '-');
 }
 
 function findMemoryDirBySubstring(projectPath) {
@@ -517,8 +546,10 @@ app.put('/api/project', (req, res) => {
   if (!dirPath) return res.status(400).json({ error: 'path required' });
   const resolved = path.resolve(dirPath.replace(/^~/, os.homedir()));
   if (!fs.existsSync(resolved)) return res.status(404).json({ error: 'directory not found' });
-  currentProjectPath = resolved;
-  clearCache();
+  if (resolved !== path.resolve(currentProjectPath)) {
+    currentProjectPath = resolved;
+    clearCache();
+  }
   res.json({ path: currentProjectPath, name: path.basename(currentProjectPath) });
 });
 
@@ -527,6 +558,61 @@ app.post('/api/refresh', (_req, res) => {
   res.json({ ok: true });
 });
 
+function resolveAllowedPath(filePath) {
+  if (!filePath) return { error: { status: 400, message: 'path required' } };
+  const resolved = path.resolve(filePath.replace(/^~/, os.homedir()));
+  const roots = [path.resolve(CLAUDE_DIR), path.resolve(currentProjectPath)];
+  const inRoot = roots.some((r) => resolved === r || resolved.startsWith(r + path.sep));
+  if (!inRoot) return { error: { status: 403, message: 'path outside allowed roots' } };
+  return { resolved };
+}
+
+app.delete('/api/file', (req, res) => {
+  const { resolved, error } = resolveAllowedPath(req.body?.path);
+  if (error) return res.status(error.status).json({ error: error.message });
+  try {
+    const stat = fs.statSync(resolved);
+    if (!stat.isFile()) return res.status(400).json({ error: 'not a file' });
+    fs.unlinkSync(resolved);
+    clearCache();
+    res.json({ ok: true });
+  } catch (err) {
+    if (err.code === 'ENOENT') return res.status(404).json({ error: 'file not found' });
+    res.status(500).json({ error: err.message });
+  }
+});
+
+app.post('/api/memory/cleanup-orphans', (req, res) => {
+  const { resolved, error } = resolveAllowedPath(req.body?.path);
+  if (error) return res.status(error.status).json({ error: error.message });
+  if (path.basename(resolved) !== 'MEMORY.md') return res.status(400).json({ error: 'not a MEMORY.md file' });
+  try {
+    const content = fs.readFileSync(resolved, 'utf-8');
+    const dir = path.dirname(resolved);
+    const lines = content.split('\n');
+    const removed = [];
+    const kept = [];
+    const linkRe = /^\s*-\s*\[([^\]]+)\]\(([^)]+\.md)\)/;
+    for (const line of lines) {
+      const m = line.match(linkRe);
+      if (m) {
+        const target = path.resolve(dir, m[2]);
+        if (!fs.existsSync(target)) {
+          removed.push({ name: m[1], file: m[2] });
+          continue;
+        }
+      }
+      kept.push(line);
+    }
+    if (removed.length === 0) return res.json({ ok: true, removed: [] });
+    fs.writeFileSync(resolved, kept.join('\n'), 'utf-8');
+    clearCache();
+    res.json({ ok: true, removed });
+  } catch (err) {
+    res.status(500).json({ error: err.message });
+  }
+});
+
 app.post('/api/open-in-editor', (req, res) => {
   const { path: filePath } = req.body;
   if (!filePath) return res.status(400).json({ error: 'path required' });