claude-memory-layer 2.5.0 → 2.5.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-memory-layer",
   "description": "Learn from conversations to provide personalized assistance. The more you use it, the smarter it gets.",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "author": {
     "name": "Buzzni"
   },

package/dist/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-memory-layer",
   "description": "Learn from conversations to provide personalized assistance. The more you use it, the smarter it gets.",
-  "version": "2.5.0",
+  "version": "2.5.1",
   "author": {
     "name": "Buzzni"
   },

package/dist/cli/index.js

@@ -38,7 +38,7 @@ function emptyLatencyAggregate() {
   return { count: 0, failedCount: 0, totalMs: 0, maxMs: 0 };
 }
 function runtimeVersion() {
-  const value = "2.5.0"?.trim();
+  const value = "2.5.1"?.trim();
   return sanitizeRuntimeVersion(value || "development");
 }
 function sanitizeRuntimeVersion(value) {
@@ -25704,7 +25704,7 @@ import { Command } from "commander";
 import { exec } from "child_process";
 import * as fs40 from "fs";
 import * as path50 from "path";
-import * as os26 from "os";
+import * as os27 from "os";
 import { pathToFileURL as pathToFileURL2 } from "url";
 
 // src/services/lesson-consolidation-service.ts
@@ -32160,20 +32160,77 @@ init_sqlite_wrapper();
 
 // src/core/mongo-sync-worker.ts
 import { randomUUID as randomUUID27 } from "crypto";
-import * as os18 from "os";
+import * as os19 from "os";
 import { MongoClient } from "mongodb";
+
+// src/core/mongo-sync-config.ts
+import * as dns from "dns";
+import * as os18 from "os";
+var UNPARSEABLE_URI = "<unparseable MongoDB connection string>";
+function splitMongoUri(uri) {
+  const match = /^([a-z][a-z0-9+.-]*:\/\/)(.*)$/is.exec(uri);
+  if (!match) return null;
+  const [, scheme, rest] = match;
+  const authorityEnd = rest.search(/[/?]/);
+  const authority = authorityEnd === -1 ? rest : rest.slice(0, authorityEnd);
+  const remainder = authorityEnd === -1 ? "" : rest.slice(authorityEnd);
+  if (remainder.includes("@") || authority.indexOf("@") !== authority.lastIndexOf("@")) return null;
+  const atIdx = authority.indexOf("@");
+  const creds = atIdx === -1 ? null : authority.slice(0, atIdx);
+  const hosts = authority.slice(atIdx + 1);
+  if (!hosts) return null;
+  const colonIdx = creds?.indexOf(":") ?? -1;
+  const queryIdx = remainder.indexOf("?");
+  return {
+    scheme,
+    username: creds === null ? null : colonIdx === -1 ? creds : creds.slice(0, colonIdx),
+    password: creds === null || colonIdx === -1 ? null : creds.slice(colonIdx + 1),
+    hosts,
+    path: queryIdx === -1 ? remainder : remainder.slice(0, queryIdx),
+    query: queryIdx === -1 ? null : remainder.slice(queryIdx + 1)
+  };
+}
 function redactMongoUri(uri) {
-  const schemeIdx = uri.indexOf("://");
-  if (schemeIdx === -1) return uri;
-  const atIdx = uri.indexOf("@", schemeIdx + 3);
-  if (atIdx === -1) return uri;
-  const creds = uri.slice(schemeIdx + 3, atIdx);
-  const colonIdx = creds.indexOf(":");
-  if (colonIdx === -1) return uri;
-  const prefix = uri.slice(0, schemeIdx + 3 + colonIdx + 1);
-  const suffix = uri.slice(atIdx);
-  return `${prefix}***${suffix}`;
+  const parts = splitMongoUri(uri);
+  if (!parts) return UNPARSEABLE_URI;
+  const creds = parts.username === null ? "" : parts.password === null ? `${parts.username}@` : `${parts.username}:***@`;
+  const query = parts.query === null ? "" : "?***";
+  return `${parts.scheme}${creds}${parts.hosts}${parts.path}${query}`;
+}
+var PARSE_ERROR_NAMES = /* @__PURE__ */ new Set([
+  "MongoParseError",
+  "MongoInvalidArgumentError",
+  "MongoAPIError",
+  "MongoRuntimeError",
+  "MongoMissingCredentialsError",
+  "TypeError",
+  "URIError"
+]);
+var PARSE_HINT = "connection string could not be parsed; percent-encode special characters in the password and check option names";
+var ERRNO_CODES = /* @__PURE__ */ new Set([
+  ...Object.keys(os18.constants.errno),
+  ...Object.values(dns).filter((value) => typeof value === "string" && /^E[A-Z_]+$/.test(value)),
+  "EAI_AGAIN"
+]);
+function describeMongoConnectionError(error, uri) {
+  const name = error instanceof Error ? error.name : "Error";
+  if (!splitMongoUri(uri) || PARSE_ERROR_NAMES.has(name)) return `${name}: ${PARSE_HINT}`;
+  const facts = connectionErrorFacts(error);
+  return facts.length > 0 ? `${name} (${facts.join(", ")})` : name;
 }
+function connectionErrorFacts(error) {
+  const facts = /* @__PURE__ */ new Set();
+  let current = error;
+  for (let depth = 0; depth < 5 && current instanceof Error; depth++) {
+    const { code, codeName } = current;
+    if (typeof code === "string" && ERRNO_CODES.has(code)) facts.add(code);
+    if (typeof codeName === "string" && /^[A-Za-z]+$/.test(codeName)) facts.add(codeName);
+    current = current.cause;
+  }
+  return [...facts];
+}
+
+// src/core/mongo-sync-worker.ts
 function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -32306,7 +32363,8 @@ var MongoSyncWorker = class {
       this.events = this.db.collection("cml_events");
     } catch (err) {
       const safeUri = redactMongoUri(this.config.uri);
-      throw new Error(`MongoDB connection failed (${safeUri}, db=${this.config.dbName}): ${String(err)}`);
+      const reason = describeMongoConnectionError(err, this.config.uri);
+      throw new Error(`MongoDB connection failed (${safeUri}, db=${this.config.dbName}): ${reason}`);
     }
   }
   async disconnect() {
@@ -32367,7 +32425,7 @@ var MongoSyncWorker = class {
       if (batch.length === 0) break;
       const startSeq = await this.allocateSeqRange("events", batch.length);
       const now = /* @__PURE__ */ new Date();
-      const hostname2 = os18.hostname();
+      const hostname2 = os19.hostname();
       const ops = batch.map((item, idx) => {
         const event = item.event;
         const seq = startSeq + idx;
@@ -32708,7 +32766,7 @@ function defaultInvocation(options) {
 
 // src/apps/cli/mcp-client-config.ts
 import * as fs25 from "node:fs";
-import * as os19 from "node:os";
+import * as os20 from "node:os";
 import * as path32 from "node:path";
 function isClaudeMemoryMcpServer(serverName, server) {
   if (!server || typeof server !== "object" || Array.isArray(server)) return false;
@@ -32720,7 +32778,7 @@ function isClaudeMemoryMcpServer(serverName, server) {
   return /memory/i.test(serverName) && /(?:^|[\s/])(?:\.\/)?(?:dist|src)\/(?:extensions\/)?mcp\/index\.(?:js|ts)(?:\s|$)/i.test(invocation);
 }
 function readMcpClientConfigs(options = {}) {
-  const homeDir = options.homeDir ?? os19.homedir();
+  const homeDir = options.homeDir ?? os20.homedir();
   const cwd = options.cwd ?? process.cwd();
   return [
     readConfig("claude-code", path32.join(homeDir, ".claude.json"), (text) => {
@@ -34110,7 +34168,7 @@ init_retrieval_trace_ledger();
 init_lesson_usage_audit();
 init_retrieval_telemetry();
 import * as fs33 from "node:fs";
-import * as os20 from "node:os";
+import * as os21 from "node:os";
 import * as path41 from "node:path";
 var MEMORY_AUDIT_SCHEMA_VERSION = "memory-audit-v1";
 var TEST_NAME_PATTERN = /(^|[-_])(?:tmp|temp|test|testing|fixture|scratch|sandbox|playground|happy-testing-ground|happy-codex-instructions)([-_]|$)/i;
@@ -34397,7 +34455,7 @@ function auditOneStore(store, options) {
 }
 function buildMemoryAuditReport(options = {}) {
   const projectClasses = validateProjectClasses(options.projectClasses ?? {});
-  const homeDir = options.homeDir ?? os20.homedir();
+  const homeDir = options.homeDir ?? os21.homedir();
   const memoryRoot = path41.join(homeDir, ".claude-code", "memory");
   const now = options.now ?? /* @__PURE__ */ new Date();
   const discovered = discoverMemoryStores(memoryRoot);
@@ -35281,7 +35339,7 @@ init_project_path();
 init_memory_service();
 init_vector_store();
 import * as fs34 from "node:fs";
-import * as os21 from "node:os";
+import * as os22 from "node:os";
 import * as path43 from "node:path";
 var DEFAULT_MAINTENANCE_MIN_FREE_BYTES = 5 * 1024 * 1024 * 1024;
 var DEFAULT_MAINTENANCE_MAX_PROJECTS = 25;
@@ -35298,7 +35356,7 @@ function parseMaintenanceMinFreeBytes(value) {
   return Math.floor(gigabytes * 1024 * 1024 * 1024);
 }
 function getMaintenanceDiskStatus(options = {}) {
-  const homeDir = options.homeDir ?? os21.homedir();
+  const homeDir = options.homeDir ?? os22.homedir();
   const memoryRoot = path43.join(homeDir, ".claude-code", "memory");
   const probePath = findExistingAncestor(memoryRoot);
   const stats = fs34.statfsSync(probePath);
@@ -35326,7 +35384,7 @@ function discoverMaintenanceTargets(options = {}) {
       modifiedAtMs: getStoreModifiedAtMs(storagePath)
     }] : [];
   }
-  const homeDir = options.homeDir ?? os21.homedir();
+  const homeDir = options.homeDir ?? os22.homedir();
   const memoryRoot = path43.join(homeDir, ".claude-code", "memory");
   const registry = loadSessionRegistry({ homeDir });
   const latestByHash = /* @__PURE__ */ new Map();
@@ -35571,7 +35629,7 @@ function maintenanceAggregateReport(report) {
 function maintenanceRunRequiresAttention(report) {
   return report.errors > 0 || report.blocked > 0 || report.quarantined > 0 || report.compactionFailures > 0 || !report.disk.healthy;
 }
-function writeMaintenanceLastRunStatus(report, homeDir = os21.homedir()) {
+function writeMaintenanceLastRunStatus(report, homeDir = os22.homedir()) {
   const filePath = getMaintenanceLastRunStatusPath(homeDir);
   const status = {
     version: 3,
@@ -35600,7 +35658,7 @@ function writeMaintenanceLastRunStatus(report, homeDir = os21.homedir()) {
   fs34.renameSync(tempPath, filePath);
   return filePath;
 }
-function readMaintenanceLastRunStatus(homeDir = os21.homedir()) {
+function readMaintenanceLastRunStatus(homeDir = os22.homedir()) {
   try {
     const value = JSON.parse(fs34.readFileSync(getMaintenanceLastRunStatusPath(homeDir), "utf8"));
     if (value.version !== 1 && value.version !== 2 && value.version !== 3 || typeof value.startedAt !== "string" || !Number.isFinite(Date.parse(value.startedAt)) || typeof value.finishedAt !== "string" || !Number.isFinite(Date.parse(value.finishedAt))) return null;
@@ -35860,7 +35918,7 @@ function sanitizeMaintenanceError(message) {
 // src/apps/cli/maintenance-scheduler.ts
 import { execFileSync as execFileSync4 } from "node:child_process";
 import * as fs35 from "node:fs";
-import * as os22 from "node:os";
+import * as os23 from "node:os";
 import * as path44 from "node:path";
 var MAINTENANCE_LABEL = "com.claude-memory-layer.maintenance";
 var DEFAULT_MAINTENANCE_INTERVAL_SECONDS = 300;
@@ -35877,7 +35935,7 @@ function resolveMaintenancePlatform(platform = process.platform) {
   if (platform === "darwin" || platform === "linux") return platform;
   throw new Error(`maintenance scheduling is not supported on ${platform}; use "claude-memory-layer maintenance run" from your scheduler`);
 }
-function getMaintenanceSchedulerPaths(platform = process.platform, homeDir = os22.homedir()) {
+function getMaintenanceSchedulerPaths(platform = process.platform, homeDir = os23.homedir()) {
   const supported = resolveMaintenancePlatform(platform);
   const logPath = path44.join(homeDir, ".claude-code", "memory", "logs", "maintenance.log");
   if (supported === "darwin") {
@@ -35954,7 +36012,7 @@ WantedBy=timers.target
 }
 function installMaintenanceScheduler(options, deps = {}) {
   const platform = resolveMaintenancePlatform(options.platform);
-  const homeDir = options.homeDir ?? os22.homedir();
+  const homeDir = options.homeDir ?? os23.homedir();
   const intervalSeconds = parseMaintenanceInterval(options.intervalSeconds);
   validateExecutablePath(options.nodePath, "Node executable");
   validateExecutablePath(options.cliPath, "CLI entrypoint");
@@ -36011,7 +36069,7 @@ function installMaintenanceScheduler(options, deps = {}) {
 }
 function getMaintenanceSchedulerStatus(options = {}, deps = {}) {
   const platform = resolveMaintenancePlatform(options.platform);
-  const paths = getMaintenanceSchedulerPaths(platform, options.homeDir ?? os22.homedir());
+  const paths = getMaintenanceSchedulerPaths(platform, options.homeDir ?? os23.homedir());
   const installed = paths.definitionPaths.every((file) => fs35.existsSync(file));
   if (!installed) return { ...paths, installed: false, active: false };
   const runner = deps.execFileSync ?? execFileSync4;
@@ -36020,7 +36078,7 @@ function getMaintenanceSchedulerStatus(options = {}, deps = {}) {
 }
 function uninstallMaintenanceScheduler(options = {}, deps = {}) {
   const platform = resolveMaintenancePlatform(options.platform);
-  const paths = getMaintenanceSchedulerPaths(platform, options.homeDir ?? os22.homedir());
+  const paths = getMaintenanceSchedulerPaths(platform, options.homeDir ?? os23.homedir());
   const runner = deps.execFileSync ?? execFileSync4;
   if (platform === "darwin") {
     const [plistPath] = paths.definitionPaths;
@@ -36118,7 +36176,7 @@ function systemdUnavailableMessage() {
 
 // src/apps/cli/import-command.ts
 init_project_path();
-import * as os23 from "node:os";
+import * as os24 from "node:os";
 import * as path45 from "node:path";
 function resolveImportCommandLockOptions(options, deps = {}) {
   if (options.lockPath !== void 0 && options.lockPath.trim().length === 0) {
@@ -36126,7 +36184,7 @@ function resolveImportCommandLockOptions(options, deps = {}) {
   }
   const useGlobalStorage = options.all === true && !options.project && !options.session;
   if (useGlobalStorage) {
-    const globalStoragePath = path45.join((deps.homedir ?? os23.homedir)(), ".claude-code", "memory");
+    const globalStoragePath = path45.join((deps.homedir ?? os24.homedir)(), ".claude-code", "memory");
     return {
       storageScope: "global",
       lockPath: options.lockPath ?? path45.join(globalStoragePath, "vector-worker.lock")
@@ -36156,7 +36214,7 @@ init_sqlite_wrapper();
 init_project_path();
 init_session_registry();
 import * as fs36 from "node:fs";
-import * as os24 from "node:os";
+import * as os25 from "node:os";
 import * as path46 from "node:path";
 function parseProjectScopeAuditDays(value) {
   if (value === void 0) return 7;
@@ -36168,7 +36226,7 @@ function parseProjectScopeAuditDays(value) {
 }
 function auditProjectScope(options = {}, deps = {}) {
   const resolved = {
-    homeDir: options.homeDir ?? os24.homedir(),
+    homeDir: options.homeDir ?? os25.homedir(),
     days: parseProjectScopeAuditDays(options.days),
     groupByProject: options.groupByProject === true
   };
@@ -36399,11 +36457,11 @@ function isLocalDirectory2(directory) {
 init_existing_store();
 init_repo_identity();
 import * as fs37 from "node:fs";
-import * as os25 from "node:os";
+import * as os26 from "node:os";
 import * as path47 from "node:path";
 function inspectProjectBootstrapHealth(options) {
   const projectPath = path47.resolve(options.projectPath);
-  const homeDir = options.homeDir ?? os25.homedir();
+  const homeDir = options.homeDir ?? os26.homedir();
   const identity = resolveCanonicalRepoIdentity(projectPath);
   const store = resolveExistingStore(projectPath, { homeDir });
   const settingsText = readText(path47.join(homeDir, ".claude", "settings.json"));
@@ -36900,20 +36958,6 @@ async function findOldestGap(remote, projectKey, localSeqs, pullCursor) {
   };
 }
 
-// src/core/mongo-sync-config.ts
-function redactMongoUri2(uri) {
-  const schemeIdx = uri.indexOf("://");
-  if (schemeIdx === -1) return uri;
-  const atIdx = uri.indexOf("@", schemeIdx + 3);
-  if (atIdx === -1) return uri;
-  const creds = uri.slice(schemeIdx + 3, atIdx);
-  const colonIdx = creds.indexOf(":");
-  if (colonIdx === -1) return uri;
-  const prefix = uri.slice(0, schemeIdx + 3 + colonIdx + 1);
-  const suffix = uri.slice(atIdx);
-  return `${prefix}***${suffix}`;
-}
-
 // src/apps/cli/mongo-sync-command.ts
 init_sqlite_event_store();
 init_project_path();
@@ -37074,8 +37118,8 @@ async function runMongoSyncAudit(options, deps = {}) {
     const report = await auditMongoSync(store, connection.collection, { projectKey });
     return { status: report.status, projectKey, detail: summarizeAudit(report), report };
   } catch (error) {
-    const safeUri = redactMongoUri2(uri).split("?")[0];
-    const message = (error instanceof Error ? error.message : String(error)).split(uri).join(safeUri);
+    const safeUri = redactMongoUri(uri);
+    const message = describeMongoConnectionError(error, uri);
     return { status: "fail", projectKey, detail: `Mongo sync audit failed (${safeUri}, db=${dbName}): ${message}` };
   } finally {
     await connection?.close().catch(() => void 0);
@@ -37238,8 +37282,8 @@ function normalizeClass(value) {
 }
 
 // src/apps/cli/index.ts
-var CLAUDE_SETTINGS_PATH = path50.join(os26.homedir(), ".claude", "settings.json");
-var CODEX_HOOKS_PATH = path50.join(os26.homedir(), ".codex", "hooks.json");
+var CLAUDE_SETTINGS_PATH = path50.join(os27.homedir(), ".claude", "settings.json");
+var CODEX_HOOKS_PATH = path50.join(os27.homedir(), ".codex", "hooks.json");
 function getPluginPath() {
   const possiblePaths = [
     path50.join(__dirname, ".."),
@@ -37255,7 +37299,7 @@ function getPluginPath() {
       return p;
     }
   }
-  return path50.join(os26.homedir(), ".npm-global", "lib", "node_modules", "claude-memory-layer", "dist");
+  return path50.join(os27.homedir(), ".npm-global", "lib", "node_modules", "claude-memory-layer", "dist");
 }
 function readEnginesNodeRange(packageRoot) {
   try {
@@ -37334,7 +37378,7 @@ function resolveHealthProjectIdentity(projectPath) {
   return { scope: "project", id: /^[a-f0-9]{8}$/.test(normalized) ? normalized : hashProjectPath(normalized) };
 }
 function scanCanonicalProjectStores(canonicalId) {
-  const memoryRoot = path50.join(os26.homedir(), ".claude-code", "memory");
+  const memoryRoot = path50.join(os27.homedir(), ".claude-code", "memory");
   const projectsRoot = path50.join(memoryRoot, "projects");
   let scannedStoreCount = 0;
   let matchingStoreCount = 0;
@@ -37770,7 +37814,7 @@ async function runOperationCli(action, label) {
   }
 }
 var program = new Command();
-program.name("claude-memory-layer").description("Claude Code Memory Plugin CLI").version("2.5.0");
+program.name("claude-memory-layer").description("Claude Code Memory Plugin CLI").version("2.5.1");
 program.command("market-context").description("Fetch read-only DART/FRED/Finnhub context with structured MarketContextSnapshot bull/bear/risk/catalyst analysis").option("--company <name>", "Company name for DART fallback search and report subject").option("--dart-corp-code <code>", "Exact DART corp_code for issuer-specific filings").option("--symbol <ticker>", "Listed ticker for Finnhub company profile").option("--providers <list>", "Comma-separated providers: dart,fred,finnhub").option("--fred-series <list>", "Comma-separated FRED series IDs").option("--json", "Print structured JSON including analysis.marketSnapshot").option("--no-snapshot", "Disable MarketContextSnapshot and DART company snapshot analysis").action(async (options) => {
   try {
     await runMarketContextCommand(options);
@@ -37919,7 +37963,7 @@ program.command("doctor").description("Diagnose the environment: Node version, e
     ...readMcpClientConfigs({ cwd: process.cwd() }).map((read) => checkMcpClientConfig(read, packageRoot, mcpServerEntry)),
     checkProjectStoreAccess(projectStorePath)
   ];
-  const memoryRoot = path50.join(os26.homedir(), ".claude-code", "memory");
+  const memoryRoot = path50.join(os27.homedir(), ".claude-code", "memory");
   const { output, exitCode } = await runDoctor(checks, {
     fix: options.fix === true,
     repairEmbeddingBackend: (check) => repairEmbeddingBackend(check, {