claude-memory-admin 1.2.0 → 1.4.0

package/src/pathcheck.mjs

@@ -0,0 +1,108 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+export const MAX_PATH_CHECKS = 200;
+export const MAX_INDEXED_FILES = 60000;
+
+export const SKIP_DIRS = new Set([
+  '.git', 'node_modules', 'bin', 'obj', 'dist', 'build', 'out', 'target', 'vendor',
+  '.next', '.nuxt', '.svelte-kit', '.venv', 'venv', '__pycache__', '.gradle', '.idea',
+  'Pods', 'DerivedData', 'coverage', '.turbo', '.cache', '.angular', '.parcel-cache',
+]);
+
+const CODE_SPAN = /`([^`\n]+)`/g;
+const SOURCE_EXT = /\.(mjs|cjs|jsx?|tsx?|json|jsonc|md|mdx|css|scss|less|html|vue|svelte|py|rb|go|rs|java|kt|swift|cs|fs|php|sh|zsh|ya?ml|toml|xml|sql|proto|lock|gradle|csproj|sln)$/i;
+const BARE_EXTENSION = /^\.[A-Za-z0-9]+$/;
+const LINE_SUFFIX = /:\d+(?:[-:]\d+)?$/;
+const GLOB_OR_SHELL = /[*?{}[\]()<>|$=!"'\\]/;
+
+function candidate(raw) {
+  let token = raw.trim();
+  if (!token || /\s/.test(token)) return null;
+  if (token.includes('://') || token.startsWith('@')) return null;
+  if (GLOB_OR_SHELL.test(token)) return null;
+
+  token = token.replace(LINE_SUFFIX, '').replace(/[.,;:]+$/, '').replace(/\/+$/, '');
+  if (token.startsWith('./')) token = token.slice(2);
+  if (!token || token.startsWith('/') || token.startsWith('~')) return null;
+  if (token.split('/').includes('..')) return null;
+  if (token.includes('...') || token.length > 200) return null;
+  if (BARE_EXTENSION.test(token)) return null;
+  if (!SOURCE_EXT.test(token)) return null;
+  if (token.split('/').some((segment) => SKIP_DIRS.has(segment))) return null;
+
+  return token;
+}
+
+export function pathCandidates(body) {
+  const found = new Set();
+  for (const match of String(body || '').matchAll(CODE_SPAN)) {
+    const token = candidate(match[1]);
+    if (token) found.add(token);
+  }
+  return [...found];
+}
+
+export function indexProject(root, { skipDirs = SKIP_DIRS, limit = MAX_INDEXED_FILES } = {}) {
+  const byLastSegment = new Map();
+  let count = 0;
+  let truncated = false;
+
+  const walk = (dir, prefix) => {
+    if (truncated) return;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (count >= limit) {
+        truncated = true;
+        return;
+      }
+      if (skipDirs.has(entry.name)) continue;
+
+      const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+      count += 1;
+      if (!byLastSegment.has(entry.name)) byLastSegment.set(entry.name, []);
+      byLastSegment.get(entry.name).push(relative);
+
+      if (entry.isDirectory()) walk(path.join(dir, entry.name), relative);
+    }
+  };
+
+  walk(root, '');
+  return { byLastSegment, count, truncated };
+}
+
+function resolvesInProject(index, token) {
+  const matches = index.byLastSegment.get(token.split('/').pop());
+  if (!matches) return false;
+  if (!token.includes('/')) return true;
+  return matches.some((relative) => relative === token || relative.endsWith(`/${token}`));
+}
+
+export function verifyPaths(projectDir, memories) {
+  const root = path.resolve(projectDir);
+  const index = indexProject(root);
+  const missing = [];
+  let checked = 0;
+  let capped = false;
+
+  for (const memory of memories) {
+    for (const token of pathCandidates(memory.body)) {
+      if (checked >= MAX_PATH_CHECKS) {
+        capped = true;
+        break;
+      }
+      checked += 1;
+      if (!resolvesInProject(index, token)) {
+        missing.push({ kind: 'stale-path', severity: 'warn', file: memory.file, name: memory.name, token });
+      }
+    }
+    if (capped) break;
+  }
+
+  return { projectDir: root, checked, capped, indexed: index.count, truncated: index.truncated, missing };
+}

package/src/settings.mjs

@@ -19,6 +19,21 @@ export const USER_SETTINGS = path.join(os.homedir(), '.claude', 'settings.json')
 /** Default when nothing sets cleanupPeriodDays; transcripts older than this are swept. */
 export const DEFAULT_CLEANUP_PERIOD_DAYS = 30;
 
+export const SETTINGS_SEVERITY = {
+  unparseable: 'bad',
+  unreadable: 'bad',
+  'not-object': 'bad',
+  'invalid-auto-memory-directory': 'bad',
+};
+
+export function summariseSettings(problems) {
+  const list = problems || [];
+  return {
+    count: list.length,
+    severity: list.some((problem) => problem.severity === 'bad') ? 'bad' : list.length ? 'warn' : 'ok',
+  };
+}
+
 function managedDir() {
   if (process.platform === 'darwin') return '/Library/Application Support/ClaudeCode';
   if (process.platform === 'win32') return 'C:\\Program Files\\ClaudeCode';
@@ -226,12 +241,19 @@ export function settingsReport(options = {}) {
 
   const problems = layers
     .filter((layer) => layer.status !== 'ok' && layer.status !== 'absent')
-    .map((layer) => ({ kind: layer.status, scope: layer.scope, file: layer.file, detail: layer.error }));
+    .map((layer) => ({
+      kind: layer.status,
+      severity: SETTINGS_SEVERITY[layer.status] || 'warn',
+      scope: layer.scope,
+      file: layer.file,
+      detail: layer.error,
+    }));
 
   const directory = resolveMemoryDirectory(options);
   if (directory && directory.invalid) {
     problems.push({
       kind: 'invalid-auto-memory-directory',
+      severity: SETTINGS_SEVERITY['invalid-auto-memory-directory'],
       scope: directory.scope,
       file: directory.file,
       detail: `"${directory.raw}" is ${directory.invalid}`,