claude-code-memory-explorer 0.2.5 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-memory-explorer",
-  "version": "0.2.5",
+  "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')) {
@@ -458,6 +462,12 @@ async function renderPreview() {
   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 += `<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>';
@@ -474,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>`;
@@ -493,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) {
@@ -574,6 +584,54 @@ async function _submitDeleteFile() {
   }
 }
 
+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 {

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>
@@ -122,6 +122,24 @@
     </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;

package/server.js

@@ -160,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 = [];
 
@@ -202,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),
@@ -293,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),
@@ -553,13 +558,18 @@ app.post('/api/refresh', (_req, res) => {
   res.json({ ok: true });
 });
 
-app.delete('/api/file', (req, res) => {
-  const { path: filePath } = req.body || {};
-  if (!filePath) return res.status(400).json({ error: 'path required' });
+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 res.status(403).json({ error: 'path outside allowed roots' });
+  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' });
@@ -572,6 +582,37 @@ app.delete('/api/file', (req, res) => {
   }
 });
 
+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' });