claude-memory-layer 2.5.0 → 2.5.1

package/dist/hooks/codex-session-import-worker.js

@@ -1823,7 +1823,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) {

package/dist/hooks/codex-session-start.js

@@ -206,7 +206,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) {
@@ -21936,7 +21936,7 @@ async function main(options = {}) {
             triggerType: "session_start",
             deliveryClient,
             requestId: `${requestPrefix}:core`,
-            runtimeVersion: "2.5.0",
+            runtimeVersion: "2.5.1",
             outcomeDiagnostics: {
               outcomeReason: "selected",
               laneCandidateCounts: {},
@@ -21997,7 +21997,7 @@ async function main(options = {}) {
               triggerType: "session_start",
               deliveryClient,
               requestId: `${requestPrefix}:lessons`,
-              runtimeVersion: "2.5.0",
+              runtimeVersion: "2.5.1",
               outcomeDiagnostics: {
                 outcomeReason: shownIds.length > 0 ? "selected" : "unknown",
                 laneCandidateCounts: {},
@@ -22087,7 +22087,7 @@ You have worked on this project before. Here are some relevant memories:
             triggerType: "session_start",
             deliveryClient,
             requestId: `${requestPrefix}:recent`,
-            runtimeVersion: "2.5.0",
+            runtimeVersion: "2.5.1",
             outcomeDiagnostics: {
               outcomeReason: "selected",
               laneCandidateCounts: {},

package/dist/hooks/codex-user-prompt-submit.js

@@ -206,7 +206,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) {
@@ -22671,7 +22671,7 @@ async function main(options = {}) {
             triggerType: "user_prompt",
             deliveryClient,
             requestId: retrievalRequestId,
-            runtimeVersion: "2.5.0",
+            runtimeVersion: "2.5.1",
             outcomeDiagnostics
           });
         } catch {

package/dist/hooks/post-tool-use.js

@@ -254,7 +254,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) {

package/dist/hooks/semantic-daemon.js

@@ -260,7 +260,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) {

package/dist/hooks/session-end-handler.js

@@ -253,7 +253,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) {

package/dist/hooks/session-end.js

@@ -447,7 +447,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) {

package/dist/hooks/session-start.js

@@ -258,7 +258,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) {
@@ -20872,7 +20872,7 @@ async function main(options = {}) {
             triggerType: "session_start",
             deliveryClient,
             requestId: `${requestPrefix}:core`,
-            runtimeVersion: "2.5.0",
+            runtimeVersion: "2.5.1",
             outcomeDiagnostics: {
               outcomeReason: "selected",
               laneCandidateCounts: {},
@@ -20933,7 +20933,7 @@ async function main(options = {}) {
               triggerType: "session_start",
               deliveryClient,
               requestId: `${requestPrefix}:lessons`,
-              runtimeVersion: "2.5.0",
+              runtimeVersion: "2.5.1",
               outcomeDiagnostics: {
                 outcomeReason: shownIds.length > 0 ? "selected" : "unknown",
                 laneCandidateCounts: {},
@@ -21023,7 +21023,7 @@ You have worked on this project before. Here are some relevant memories:
             triggerType: "session_start",
             deliveryClient,
             requestId: `${requestPrefix}:recent`,
-            runtimeVersion: "2.5.0",
+            runtimeVersion: "2.5.1",
             outcomeDiagnostics: {
               outcomeReason: "selected",
               laneCandidateCounts: {},

package/dist/hooks/stop.js

@@ -254,7 +254,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) {

package/dist/hooks/user-prompt-submit.js

@@ -260,7 +260,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) {
@@ -21605,7 +21605,7 @@ async function main(options = {}) {
             triggerType: "user_prompt",
             deliveryClient,
             requestId: retrievalRequestId,
-            runtimeVersion: "2.5.0",
+            runtimeVersion: "2.5.1",
             outcomeDiagnostics
           });
         } catch {

package/dist/index.js

@@ -4684,7 +4684,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) {
@@ -25588,20 +25588,77 @@ var SyncWorker = class {
 
 // src/core/mongo-sync-worker.ts
 import { randomUUID as randomUUID27 } from "crypto";
-import * as os8 from "os";
+import * as os9 from "os";
 import { MongoClient } from "mongodb";
+
+// src/core/mongo-sync-config.ts
+import * as dns from "dns";
+import * as os8 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(os8.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);
 }
@@ -25734,7 +25791,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() {
@@ -25795,7 +25853,7 @@ var MongoSyncWorker = class {
       if (batch.length === 0) break;
       const startSeq = await this.allocateSeqRange("events", batch.length);
       const now = /* @__PURE__ */ new Date();
-      const hostname2 = os8.hostname();
+      const hostname2 = os9.hostname();
       const ops = batch.map((item, idx) => {
         const event = item.event;
         const seq = startSeq + idx;
@@ -29307,11 +29365,11 @@ function redactSecrets(input) {
 }
 
 // src/services/memory-service.ts
-import * as os13 from "os";
+import * as os14 from "os";
 
 // src/core/registry/existing-store.ts
 import * as fs14 from "node:fs";
-import * as os9 from "node:os";
+import * as os10 from "node:os";
 import * as path16 from "node:path";
 var PROJECT_HASH_PATTERN = /^[a-f0-9]{8}$/;
 var SQLITE_HEADER = Buffer.from("SQLite format 3\0", "utf8");
@@ -29331,7 +29389,7 @@ function resolveExistingStore(projectOrHash, options = {}) {
   return probe;
 }
 function locateExistingStore(projectOrHash, options) {
-  const homeDir = options.homeDir ?? os9.homedir();
+  const homeDir = options.homeDir ?? os10.homedir();
   const memoryRoot = path16.join(homeDir, ".claude-code", "memory");
   const parsed = parseStoreInput(projectOrHash);
   if (parsed.status === "invalid") return { candidate: false, resolution: parsed };
@@ -29485,7 +29543,7 @@ var MemoryStoreResolutionError = class extends Error {
 };
 
 // src/core/engine/memory-service-composition.ts
-import * as os10 from "os";
+import * as os11 from "os";
 import * as path17 from "path";
 
 // src/core/metadata-extractor.ts
@@ -29618,15 +29676,15 @@ function createMemoryServiceComposition(options) {
 }
 function defaultExpandPath(targetPath) {
   if (targetPath.startsWith("~")) {
-    return path17.join(os10.homedir(), targetPath.slice(1));
+    return path17.join(os11.homedir(), targetPath.slice(1));
   }
   return targetPath;
 }
 
 // src/services/memory-service-config.ts
-import * as os11 from "os";
+import * as os12 from "os";
 import * as path18 from "path";
-var SHARED_STORAGE_PATH = path18.join(os11.homedir(), ".claude-code", "memory", "shared");
+var SHARED_STORAGE_PATH = path18.join(os12.homedir(), ".claude-code", "memory", "shared");
 var DISABLED_SHARED_STORE_CONFIG = {
   enabled: false,
   autoPromote: false,
@@ -29797,12 +29855,12 @@ function createMemoryServiceRegistry(deps) {
 
 // src/services/operations-config-loader.ts
 import * as fs15 from "fs";
-import * as os12 from "os";
+import * as os13 from "os";
 import * as path20 from "path";
 function resolveOperationsConfigPath() {
   const override = process.env.CLAUDE_MEMORY_OPERATIONS_CONFIG_PATH;
   if (override && override.trim().length > 0) return override.trim();
-  return path20.join(os12.homedir(), ".claude-code", "memory", "operations.json");
+  return path20.join(os13.homedir(), ".claude-code", "memory", "operations.json");
 }
 var cached = null;
 function loadMemoryOperationsConfig() {
@@ -30434,7 +30492,7 @@ var defaultRegistry = createMemoryServiceRegistry({
   hashProjectPath,
   getProjectStoragePath,
   getSessionProject,
-  homedir: os13.homedir,
+  homedir: os14.homedir,
   disabledSharedStoreConfig: DISABLED_SHARED_STORE_CONFIG
 });
 var getDefaultMemoryService = defaultRegistry.getDefaultMemoryService;
@@ -30500,7 +30558,7 @@ async function shutdownMemoryServices(reason = "process-shutdown") {
 // src/services/codex-session-history-importer.ts
 import * as fs16 from "fs";
 import * as path21 from "path";
-import * as os14 from "os";
+import * as os15 from "os";
 import * as readline from "readline";
 import { createHash as createHash14, randomUUID as randomUUID31 } from "crypto";
 
@@ -30558,7 +30616,7 @@ function extractTextFromContent(content) {
   return extractCodexContentText(content).text;
 }
 function getDefaultCodexSessionsDir() {
-  return path21.join(os14.homedir(), ".codex", "sessions");
+  return path21.join(os15.homedir(), ".codex", "sessions");
 }
 function listCodexSessionFilesRecursive(rootDir) {
   if (!fs16.existsSync(rootDir)) return [];
@@ -30893,7 +30951,7 @@ var CodexSessionHistoryImporter = class {
   sessionsRoot;
   constructor(memoryService, options = {}) {
     this.memoryService = memoryService;
-    this.sessionsRoot = options.sessionsDir ? path21.resolve(options.sessionsDir) : path21.join(os14.homedir(), ".codex", "sessions");
+    this.sessionsRoot = options.sessionsDir ? path21.resolve(options.sessionsDir) : path21.join(os15.homedir(), ".codex", "sessions");
   }
   getSessionsRoot() {
     return this.sessionsRoot;