@hasna/mementos 0.14.63 → 0.14.65

package/dist/cli/commands/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4M5D"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkN5D"}

package/dist/cli/commands/io-clean.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io-clean.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-clean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoC3D"}
+{"version":3,"file":"io-clean.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/io-clean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmCzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC3D"}

package/dist/cli/commands/system-doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0CzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgP5D"}
+{"version":3,"file":"system-doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/system-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwP5D"}

package/dist/cli/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/cli/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/cli/helpers.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -5422,7 +5422,8 @@ function getEntity(id, db) {
     return data;
   }
   const d = db || getDatabase();
-  const row = d.query("SELECT * FROM entities WHERE id = ?").get(id);
+  const resolvedId = resolvePartialId(d, "entities", id) ?? id;
+  const row = d.query("SELECT * FROM entities WHERE id = ?").get(resolvedId);
   if (!row)
     throw new EntityNotFoundError(id);
   return parseEntityRow(row);
@@ -5517,19 +5518,39 @@ function mergeEntities(sourceId, targetId, db) {
     return data;
   }
   const d = db || getDatabase();
-  getEntity(sourceId, d);
-  getEntity(targetId, d);
-  d.run(`UPDATE OR IGNORE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [targetId, sourceId]);
-  d.run(`UPDATE OR IGNORE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [
-    sourceId,
-    sourceId
-  ]);
-  d.run(`UPDATE OR IGNORE entity_memories SET entity_id = ? WHERE entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [sourceId]);
-  d.run("DELETE FROM entities WHERE id = ?", [sourceId]);
-  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now2(), targetId]);
-  return getEntity(targetId, d);
+  const src = getEntity(sourceId, d).id;
+  const tgt = getEntity(targetId, d).id;
+  d.run(`DELETE FROM relations
+       WHERE source_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.source_entity_id = ?
+             AND e.target_entity_id = relations.target_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [tgt, src]);
+  d.run(`DELETE FROM relations
+       WHERE target_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.target_entity_id = ?
+             AND e.source_entity_id = relations.source_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [src, src]);
+  d.run(`DELETE FROM entity_memories
+       WHERE entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM entity_memories e
+           WHERE e.entity_id = ?
+             AND e.memory_id = entity_memories.memory_id
+         )`, [src, tgt]);
+  d.run(`UPDATE entity_memories SET entity_id = ? WHERE entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [src]);
+  d.run("DELETE FROM entities WHERE id = ?", [src]);
+  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now2(), tgt]);
+  return getEntity(tgt, d);
 }
 var init_entities = __esm(() => {
   init_database();
@@ -5617,6 +5638,14 @@ function resolveEntityArg(nameOrId, type) {
   const byName = getEntityByName(nameOrId, type);
   if (byName)
     return byName;
+  if (isApiMode()) {
+    try {
+      return getEntity(nameOrId);
+    } catch {
+      console.error(chalk.red(`Entity not found: ${nameOrId}`));
+      process.exit(1);
+    }
+  }
   const db = getDatabase();
   const id = resolvePartialId(db, "entities", nameOrId);
   if (id)
@@ -62222,7 +62251,7 @@ function deprioritizeStale(days, db) {
   const count = d.query(`SELECT COUNT(*) as c FROM memories WHERE ${deprioWhere}`).get(cutoff).c;
   if (count > 0) {
     d.run(`UPDATE memories
-       SET importance = MAX(importance - 1, 1),
+       SET importance = importance - 1,
            version = version + 1,
            updated_at = ?
        WHERE ${deprioWhere}`, [timestamp, cutoff]);
@@ -62240,14 +62269,22 @@ function runCleanup(config, db) {
 }
 
 // src/cli/commands/io-clean.ts
+init_api_mode();
 init_helpers();
+function runCleanupViaApi() {
+  const empty = { expired: 0, evicted: 0, archived: 0, unused_archived: 0, deprioritized: 0 };
+  const { status, data } = apiJson("POST", "/maintenance/cleanup");
+  if (status !== 404 && data)
+    return { ...empty, ...data };
+  const legacy = apiJson("POST", "/memories/clean");
+  return { ...empty, expired: legacy.data?.cleaned ?? 0 };
+}
 function registerCleanCommand(program2) {
   const handleError = makeHandleError(program2);
   program2.command("clean").description("Remove expired memories and enforce quotas").action(() => {
     try {
       const globalOpts = program2.opts();
-      const config = loadConfig();
-      const result = runCleanup(config);
+      const result = isApiMode() ? runCleanupViaApi() : runCleanup(loadConfig());
       if (globalOpts.json) {
         outputJson(result);
       } else {
@@ -62640,24 +62677,28 @@ function registerAgentCommands(program2) {
       console.log(chalk22.green(`\u2665 ${agent.name} (${agent.id}) \u2014 heartbeat sent`));
   });
   program2.command("set-focus [project]").description("Focus this agent on a project (or clear focus if no project given)").option("--agent <id>", "Agent ID").action((project, opts) => {
-    const globalOpts = program2.opts();
-    const agentId = opts?.agent || globalOpts.agent;
-    if (!agentId) {
-      process.stderr.write(`Agent ID required. Use --agent.
+    try {
+      const globalOpts = program2.opts();
+      const agentId = opts?.agent || globalOpts.agent;
+      if (!agentId) {
+        process.stderr.write(`Agent ID required. Use --agent.
 `);
-      process.exit(1);
-    }
-    let target = project ?? null;
-    if (project) {
-      const proj = getProject(project);
-      if (proj)
-        target = proj.id;
+        process.exit(1);
+      }
+      let target = project ?? null;
+      if (project) {
+        const proj = getProject(project);
+        if (proj)
+          target = proj.id;
+      }
+      setFocus(agentId, target);
+      if (project)
+        console.log(chalk22.green(`Focused: ${agentId} \u2192 project ${project}`));
+      else
+        console.log(chalk22.dim(`Focus cleared for ${agentId}`));
+    } catch (e) {
+      handleError(e);
     }
-    setFocus(agentId, target);
-    if (project)
-      console.log(chalk22.green(`Focused: ${agentId} \u2192 project ${project}`));
-    else
-      console.log(chalk22.dim(`Focus cleared for ${agentId}`));
   });
   program2.command("get-focus").description("Show the current project focus for an agent").option("--agent <id>", "Agent ID").action((opts) => {
     const globalOpts = program2.opts();
@@ -63551,6 +63592,7 @@ import {
   statSync as statSync3,
   constants as fsConstants
 } from "fs";
+init_api_mode();
 init_helpers();
 async function runCommandWithTimeout(args, timeoutMs) {
   const proc = Bun.spawn(args, { stdout: "pipe", stderr: "pipe" });
@@ -63572,6 +63614,10 @@ function registerDoctorCommand(program2) {
   program2.command("doctor").description("Diagnose common issues with the mementos installation").action(async () => {
     const globalOpts = program2.opts();
     const checks = [];
+    if (isApiMode()) {
+      await runCloudDoctor(globalOpts, checks);
+      return;
+    }
     const version = getPackageVersion();
     checks.push({ name: "Version", status: "ok", detail: version });
     const dbPath = getDbPath();
@@ -63758,6 +63804,109 @@ function registerDoctorCommand(program2) {
     outputDoctorResults(globalOpts, checks);
   });
 }
+async function runCloudDoctor(globalOpts, checks) {
+  checks.push({ name: "Version", status: "ok", detail: getPackageVersion() });
+  const cfg = getApiConfig();
+  checks.push({
+    name: "Storage mode",
+    status: "ok",
+    detail: `self-hosted API (${cfg?.baseUrl ?? "unknown endpoint"})`
+  });
+  let healthy = false;
+  try {
+    const { status, data } = apiJson("GET", "/health");
+    healthy = status >= 200 && status < 300 && !!data;
+    if (healthy && data) {
+      const serverStatus = data.status === "warn" ? "warn" : "ok";
+      checks.push({
+        name: "Cloud connection",
+        status: serverStatus,
+        detail: `reachable \u2014 server v${data.version ?? "?"} (${data.status ?? "ok"})`
+      });
+      const total = data.memories?.total ?? 0;
+      const expired = data.memories?.expired ?? 0;
+      checks.push({ name: "Memories", status: "ok", detail: `${total} total` });
+      checks.push({
+        name: "  Expired",
+        status: expired > 10 ? "warn" : "ok",
+        detail: expired > 10 ? `${expired} (run 'mementos clean' to remove)` : String(expired)
+      });
+      checks.push({ name: "Agents", status: "ok", detail: String(data.agents ?? 0) });
+      checks.push({ name: "Projects", status: "ok", detail: String(data.projects ?? 0) });
+    } else {
+      checks.push({ name: "Cloud connection", status: "fail", detail: "health endpoint returned no data" });
+    }
+  } catch (e) {
+    checks.push({
+      name: "Cloud connection",
+      status: "fail",
+      detail: e instanceof Error ? e.message : String(e)
+    });
+  }
+  try {
+    loadConfig();
+    checks.push({ name: "Config", status: "ok", detail: "valid" });
+  } catch (e) {
+    checks.push({ name: "Config", status: "fail", detail: e instanceof Error ? e.message : String(e) });
+  }
+  try {
+    const activeProfile = getActiveProfile();
+    const profiles = listProfiles();
+    checks.push({
+      name: "Active profile",
+      status: "ok",
+      detail: activeProfile ? `${activeProfile} (${profiles.length} total)` : `default \u2014 ${profiles.length} profile(s) available`
+    });
+  } catch (e) {
+    checks.push({ name: "Active profile", status: "warn", detail: e instanceof Error ? e.message : String(e) });
+  }
+  try {
+    const { stdout: mcpOut, exitCode: mcpExit, timedOut } = await runCommandWithTimeout(["claude", "mcp", "list"], 1500);
+    if (timedOut) {
+      checks.push({ name: "MCP server", status: "warn", detail: "health check timed out" });
+    } else if (mcpExit === 0 && mcpOut.includes("mementos")) {
+      checks.push({ name: "MCP server", status: "ok", detail: "registered with Claude Code" });
+    } else if (mcpExit !== 0) {
+      checks.push({ name: "MCP server", status: "warn", detail: "claude not installed or not accessible" });
+    } else {
+      checks.push({ name: "MCP server", status: "warn", detail: "not registered  \u2192  run: mementos init" });
+    }
+  } catch {
+    checks.push({ name: "MCP server", status: "warn", detail: "could not check (is claude CLI installed?)" });
+  }
+  try {
+    const settingsFilePath = join7(homedir4(), ".claude", "settings.json");
+    if (existsSync7(settingsFilePath)) {
+      const settings = JSON.parse(readFileSync5(settingsFilePath, "utf-8"));
+      const hooksObj = settings["hooks"] || {};
+      const stopHooks = hooksObj["Stop"] || [];
+      const hasMementos = stopHooks.some((e) => e.hooks?.some((h) => h.command && h.command.includes("mementos")));
+      checks.push({
+        name: "Stop hook",
+        status: hasMementos ? "ok" : "warn",
+        detail: hasMementos ? "installed (sessions \u2192 memories)" : "not installed  \u2192  run: mementos init"
+      });
+    } else {
+      checks.push({ name: "Stop hook", status: "warn", detail: "~/.claude/settings.json not found  \u2192  run: mementos init" });
+    }
+  } catch {
+    checks.push({ name: "Stop hook", status: "warn", detail: "could not check stop hook" });
+  }
+  if (process.platform === "darwin") {
+    const plistFilePath = join7(homedir4(), "Library", "LaunchAgents", "com.hasna.mementos.plist");
+    checks.push({
+      name: "Auto-start",
+      status: existsSync7(plistFilePath) ? "ok" : "warn",
+      detail: existsSync7(plistFilePath) ? "configured (starts on login)" : "not configured  \u2192  run: mementos init"
+    });
+  } else {
+    checks.push({ name: "Auto-start", status: "ok", detail: `n/a on ${process.platform}` });
+  }
+  outputDoctorResults(globalOpts, checks);
+  if (checks.some((c) => c.status === "fail")) {
+    process.exitCode = 1;
+  }
+}
 function outputDoctorResults(globalOpts, checks) {
   if (globalOpts.json) {
     outputJson({ checks, healthy: checks.every((c) => c.status === "ok") });

package/dist/db/entities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/db/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAQ3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAWnE;AAMD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAmE5E;AAMD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAY3D;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CAgCf;AAMD,wBAAgB,YAAY,CAC1B,MAAM,GAAE;IACN,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CA+CV;AAMD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAsCR;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAS5D;AAMD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAiDR;AAgCD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,MAAY,EACvB,EAAE,CAAC,EAAE,QAAQ,GACZ,mBAAmB,EAAE,CA2CvB;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,gBAAgB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,oBAAoB,CA4JtB"}
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/db/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI1D,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACX,MAAM,mBAAmB,CAAC;AAQ3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAWnE;AAMD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAmE5E;AAMD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAkB3D;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,EACjB,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,GAAG,IAAI,CAgCf;AAMD,wBAAgB,YAAY,CAC1B,MAAM,GAAE;IACN,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,EAAE,CA+CV;AAMD,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAsCR;AAMD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAS5D;AAMD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAyER;AAgCD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,MAAY,EACvB,EAAE,CAAC,EAAE,QAAQ,GACZ,mBAAmB,EAAE,CA2CvB;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,gBAAgB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,EACN,EAAE,CAAC,EAAE,QAAQ,GACZ,oBAAoB,CA4JtB"}

package/dist/index.js

@@ -51318,7 +51318,8 @@ function getEntity(id, db) {
     return data;
   }
   const d = db || getDatabase();
-  const row = d.query("SELECT * FROM entities WHERE id = ?").get(id);
+  const resolvedId = resolvePartialId(d, "entities", id) ?? id;
+  const row = d.query("SELECT * FROM entities WHERE id = ?").get(resolvedId);
   if (!row)
     throw new EntityNotFoundError(id);
   return parseEntityRow2(row);
@@ -51446,19 +51447,39 @@ function mergeEntities(sourceId, targetId, db) {
     return data;
   }
   const d = db || getDatabase();
-  getEntity(sourceId, d);
-  getEntity(targetId, d);
-  d.run(`UPDATE OR IGNORE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [targetId, sourceId]);
-  d.run(`UPDATE OR IGNORE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [
-    sourceId,
-    sourceId
-  ]);
-  d.run(`UPDATE OR IGNORE entity_memories SET entity_id = ? WHERE entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [sourceId]);
-  d.run("DELETE FROM entities WHERE id = ?", [sourceId]);
-  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now(), targetId]);
-  return getEntity(targetId, d);
+  const src = getEntity(sourceId, d).id;
+  const tgt = getEntity(targetId, d).id;
+  d.run(`DELETE FROM relations
+       WHERE source_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.source_entity_id = ?
+             AND e.target_entity_id = relations.target_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [tgt, src]);
+  d.run(`DELETE FROM relations
+       WHERE target_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.target_entity_id = ?
+             AND e.source_entity_id = relations.source_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [src, src]);
+  d.run(`DELETE FROM entity_memories
+       WHERE entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM entity_memories e
+           WHERE e.entity_id = ?
+             AND e.memory_id = entity_memories.memory_id
+         )`, [src, tgt]);
+  d.run(`UPDATE entity_memories SET entity_id = ? WHERE entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [src]);
+  d.run("DELETE FROM entities WHERE id = ?", [src]);
+  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now(), tgt]);
+  return getEntity(tgt, d);
 }
 
 // src/lib/decay.ts
@@ -52827,7 +52848,7 @@ function deprioritizeStale(days, db) {
   const count = d.query(`SELECT COUNT(*) as c FROM memories WHERE ${deprioWhere}`).get(cutoff).c;
   if (count > 0) {
     d.run(`UPDATE memories
-       SET importance = MAX(importance - 1, 1),
+       SET importance = importance - 1,
            version = version + 1,
            updated_at = ?
        WHERE ${deprioWhere}`, [timestamp, cutoff]);

package/dist/lib/retention.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/lib/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAUrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA0C3E;AAMD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAwBrE;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAoBjE;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA2BrE;AAMD,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EACtB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAgBxG;AAOD,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuEtB"}
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/lib/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAUrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CA0C3E;AAMD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAwBrE;AAMD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAoBjE;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAgCrE;AAMD,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EACtB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAgBxG;AAOD,wBAAgB,mBAAmB,CACjC,SAAS,CAAC,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAuEtB"}

package/dist/mcp/index.js

@@ -3591,7 +3591,8 @@ function getEntity(id, db) {
     return data;
   }
   const d = db || getDatabase();
-  const row = d.query("SELECT * FROM entities WHERE id = ?").get(id);
+  const resolvedId = resolvePartialId(d, "entities", id) ?? id;
+  const row = d.query("SELECT * FROM entities WHERE id = ?").get(resolvedId);
   if (!row)
     throw new EntityNotFoundError(id);
   return parseEntityRow2(row);
@@ -3719,19 +3720,39 @@ function mergeEntities(sourceId, targetId, db) {
     return data;
   }
   const d = db || getDatabase();
-  getEntity(sourceId, d);
-  getEntity(targetId, d);
-  d.run(`UPDATE OR IGNORE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [targetId, sourceId]);
-  d.run(`UPDATE OR IGNORE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [
-    sourceId,
-    sourceId
-  ]);
-  d.run(`UPDATE OR IGNORE entity_memories SET entity_id = ? WHERE entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [sourceId]);
-  d.run("DELETE FROM entities WHERE id = ?", [sourceId]);
-  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now(), targetId]);
-  return getEntity(targetId, d);
+  const src = getEntity(sourceId, d).id;
+  const tgt = getEntity(targetId, d).id;
+  d.run(`DELETE FROM relations
+       WHERE source_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.source_entity_id = ?
+             AND e.target_entity_id = relations.target_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [tgt, src]);
+  d.run(`DELETE FROM relations
+       WHERE target_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.target_entity_id = ?
+             AND e.source_entity_id = relations.source_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [src, src]);
+  d.run(`DELETE FROM entity_memories
+       WHERE entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM entity_memories e
+           WHERE e.entity_id = ?
+             AND e.memory_id = entity_memories.memory_id
+         )`, [src, tgt]);
+  d.run(`UPDATE entity_memories SET entity_id = ? WHERE entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [src]);
+  d.run("DELETE FROM entities WHERE id = ?", [src]);
+  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now(), tgt]);
+  return getEntity(tgt, d);
 }
 function trigramSimilarity(a, b) {
   const trigramsOf = (s) => {
@@ -11746,7 +11767,7 @@ function deprioritizeStale(days, db) {
   const count = d.query(`SELECT COUNT(*) as c FROM memories WHERE ${deprioWhere}`).get(cutoff).c;
   if (count > 0) {
     d.run(`UPDATE memories
-       SET importance = MAX(importance - 1, 1),
+       SET importance = importance - 1,
            version = version + 1,
            updated_at = ?
        WHERE ${deprioWhere}`, [timestamp, cutoff]);

package/dist/server/index.js

@@ -3132,7 +3132,8 @@ function getEntity(id, db) {
     return data;
   }
   const d = db || getDatabase();
-  const row = d.query("SELECT * FROM entities WHERE id = ?").get(id);
+  const resolvedId = resolvePartialId(d, "entities", id) ?? id;
+  const row = d.query("SELECT * FROM entities WHERE id = ?").get(resolvedId);
   if (!row)
     throw new EntityNotFoundError(id);
   return parseEntityRow2(row);
@@ -3260,19 +3261,39 @@ function mergeEntities(sourceId, targetId, db) {
     return data;
   }
   const d = db || getDatabase();
-  getEntity(sourceId, d);
-  getEntity(targetId, d);
-  d.run(`UPDATE OR IGNORE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [targetId, sourceId]);
-  d.run(`UPDATE OR IGNORE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [
-    sourceId,
-    sourceId
-  ]);
-  d.run(`UPDATE OR IGNORE entity_memories SET entity_id = ? WHERE entity_id = ?`, [targetId, sourceId]);
-  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [sourceId]);
-  d.run("DELETE FROM entities WHERE id = ?", [sourceId]);
-  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now(), targetId]);
-  return getEntity(targetId, d);
+  const src = getEntity(sourceId, d).id;
+  const tgt = getEntity(targetId, d).id;
+  d.run(`DELETE FROM relations
+       WHERE source_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.source_entity_id = ?
+             AND e.target_entity_id = relations.target_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET source_entity_id = ? WHERE source_entity_id = ?`, [tgt, src]);
+  d.run(`DELETE FROM relations
+       WHERE target_entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM relations e
+           WHERE e.target_entity_id = ?
+             AND e.source_entity_id = relations.source_entity_id
+             AND e.relation_type = relations.relation_type
+         )`, [src, tgt]);
+  d.run(`UPDATE relations SET target_entity_id = ? WHERE target_entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM relations WHERE source_entity_id = ? OR target_entity_id = ?", [src, src]);
+  d.run(`DELETE FROM entity_memories
+       WHERE entity_id = ?
+         AND EXISTS (
+           SELECT 1 FROM entity_memories e
+           WHERE e.entity_id = ?
+             AND e.memory_id = entity_memories.memory_id
+         )`, [src, tgt]);
+  d.run(`UPDATE entity_memories SET entity_id = ? WHERE entity_id = ?`, [tgt, src]);
+  d.run("DELETE FROM entity_memories WHERE entity_id = ?", [src]);
+  d.run("DELETE FROM entities WHERE id = ?", [src]);
+  d.run("UPDATE entities SET updated_at = ? WHERE id = ?", [now(), tgt]);
+  return getEntity(tgt, d);
 }
 function graphTraverse(startEntityId, options = {}, db) {
   if (!db && isApiMode()) {
@@ -5689,6 +5710,13 @@ function addRoute(method, path, handler) {
     handler
   });
 }
+function safeDecodeParam(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
 function matchRoute(method, pathname) {
   let bestMatch = null;
   for (const route of routes) {
@@ -5698,7 +5726,7 @@ function matchRoute(method, pathname) {
     if (match) {
       const params = {};
       route.paramNames.forEach((name, i) => {
-        params[name] = match[i + 1];
+        params[name] = safeDecodeParam(match[i + 1]);
       });
       if (!bestMatch || route.specificity > bestMatch.route.specificity || route.specificity === bestMatch.route.specificity && route.order < bestMatch.route.order) {
         bestMatch = { route, params };
@@ -53400,6 +53428,88 @@ function isInMemoryDb(path) {
 function homeDir() {
   return process.env["HOME"] || process.env["USERPROFILE"] || homedir();
 }
+var DEFAULT_CONFIG = {
+  default_scope: "private",
+  default_category: "knowledge",
+  default_importance: 5,
+  max_entries: 1000,
+  max_entries_per_scope: {
+    global: 500,
+    shared: 300,
+    private: 200,
+    working: 100
+  },
+  injection: {
+    max_tokens: 500,
+    min_importance: 5,
+    categories: ["preference", "fact"],
+    refresh_interval: 5
+  },
+  extraction: {
+    enabled: true,
+    min_confidence: 0.5
+  },
+  sync_agents: ["claude", "codex", "gemini"],
+  auto_cleanup: {
+    enabled: true,
+    expired_check_interval: 3600,
+    unused_archive_days: 7,
+    stale_deprioritize_days: 14
+  }
+};
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key of Object.keys(source)) {
+    const sourceVal = source[key];
+    const targetVal = result[key];
+    if (sourceVal !== null && typeof sourceVal === "object" && !Array.isArray(sourceVal) && targetVal !== null && typeof targetVal === "object" && !Array.isArray(targetVal)) {
+      result[key] = deepMerge(targetVal, sourceVal);
+    } else {
+      result[key] = sourceVal;
+    }
+  }
+  return result;
+}
+var VALID_SCOPES = ["global", "shared", "private", "working"];
+var VALID_CATEGORIES = [
+  "preference",
+  "fact",
+  "knowledge",
+  "history"
+];
+function isValidScope(value) {
+  return VALID_SCOPES.includes(value);
+}
+function isValidCategory(value) {
+  return VALID_CATEGORIES.includes(value);
+}
+function loadConfig() {
+  const configPath = join(homeDir(), ".hasna", "mementos", "config.json");
+  let fileConfig = {};
+  if (existsSync(configPath)) {
+    try {
+      const raw = readFileSync(configPath, "utf-8");
+      fileConfig = JSON.parse(raw);
+    } catch {}
+  }
+  const merged = deepMerge(DEFAULT_CONFIG, fileConfig);
+  const envScope = process.env["MEMENTOS_DEFAULT_SCOPE"];
+  if (envScope && isValidScope(envScope)) {
+    merged.default_scope = envScope;
+  }
+  const envCategory = process.env["MEMENTOS_DEFAULT_CATEGORY"];
+  if (envCategory && isValidCategory(envCategory)) {
+    merged.default_category = envCategory;
+  }
+  const envImportance = process.env["MEMENTOS_DEFAULT_IMPORTANCE"];
+  if (envImportance) {
+    const parsed = parseInt(envImportance, 10);
+    if (!Number.isNaN(parsed) && parsed >= 1 && parsed <= 10) {
+      merged.default_importance = parsed;
+    }
+  }
+  return merged;
+}
 function findFileWalkingUp(filename) {
   let dir = process.cwd();
   const legacyHomeMementosDb = resolve(homeDir(), ".mementos", "mementos.db");
@@ -56410,6 +56520,79 @@ addRoute("POST", "/api/memories/bulk-upsert", async (req) => {
 // src/server/routes/memories-misc.ts
 init_memories();
 
+// src/lib/retention.ts
+init_database();
+init_memories();
+function enforceQuotas(config, db) {
+  const d = db || getDatabase();
+  let totalEvicted = 0;
+  const scopes = ["global", "shared", "private", "working"];
+  for (const scope of scopes) {
+    const limit = config.max_entries_per_scope[scope];
+    if (!limit || limit <= 0)
+      continue;
+    const countRow = d.query("SELECT COUNT(*) as cnt FROM memories WHERE scope = ? AND status = 'active'").get(scope);
+    const count = countRow.cnt;
+    if (count <= limit)
+      continue;
+    const excess = count - limit;
+    const subquery = `SELECT id FROM memories
+        WHERE scope = ? AND status = 'active' AND pinned = 0
+        ORDER BY importance ASC, created_at ASC
+        LIMIT ?`;
+    const delCount = d.query(`SELECT COUNT(*) as c FROM (${subquery})`).get(scope, excess).c;
+    d.run(`DELETE FROM memories WHERE id IN (${subquery})`, [scope, excess]);
+    totalEvicted += delCount;
+  }
+  return totalEvicted;
+}
+function archiveStale(staleDays, db) {
+  const d = db || getDatabase();
+  const timestamp = now();
+  const cutoff = new Date(Date.now() - staleDays * 24 * 60 * 60 * 1000).toISOString();
+  const archiveWhere = `status = 'active' AND pinned = 0 AND COALESCE(accessed_at, created_at) < ?`;
+  const count = d.query(`SELECT COUNT(*) as c FROM memories WHERE ${archiveWhere}`).get(cutoff).c;
+  if (count > 0) {
+    d.run(`UPDATE memories SET status = 'archived', updated_at = ? WHERE ${archiveWhere}`, [timestamp, cutoff]);
+  }
+  return count;
+}
+function archiveUnused(days, db) {
+  const d = db || getDatabase();
+  const timestamp = now();
+  const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+  const unusedWhere = `status = 'active' AND pinned = 0 AND access_count = 0 AND created_at < ?`;
+  const count = d.query(`SELECT COUNT(*) as c FROM memories WHERE ${unusedWhere}`).get(cutoff).c;
+  if (count > 0) {
+    d.run(`UPDATE memories SET status = 'archived', updated_at = ? WHERE ${unusedWhere}`, [timestamp, cutoff]);
+  }
+  return count;
+}
+function deprioritizeStale(days, db) {
+  const d = db || getDatabase();
+  const timestamp = now();
+  const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+  const deprioWhere = `status = 'active' AND pinned = 0 AND importance > 1 AND COALESCE(accessed_at, updated_at) < ?`;
+  const count = d.query(`SELECT COUNT(*) as c FROM memories WHERE ${deprioWhere}`).get(cutoff).c;
+  if (count > 0) {
+    d.run(`UPDATE memories
+       SET importance = importance - 1,
+           version = version + 1,
+           updated_at = ?
+       WHERE ${deprioWhere}`, [timestamp, cutoff]);
+  }
+  return count;
+}
+function runCleanup(config, db) {
+  const d = db || getDatabase();
+  const expired = cleanExpiredMemories(d);
+  const evicted = enforceQuotas(config, d);
+  const archived = archiveStale(90, d);
+  const unused_archived = archiveUnused(config.auto_cleanup.unused_archive_days ?? 7, d);
+  const deprioritized = deprioritizeStale(config.auto_cleanup.stale_deprioritize_days ?? 14, d);
+  return { expired, evicted, archived, unused_archived, deprioritized };
+}
+
 // src/lib/machine-visibility.ts
 function resolveVisibleMachineId(machineId, db) {
   if (machineId !== undefined) {
@@ -56532,6 +56715,10 @@ addRoute("POST", "/api/memories/clean", () => {
   const cleaned = cleanExpiredMemories();
   return json({ cleaned });
 });
+addRoute("POST", "/api/maintenance/cleanup", () => {
+  const result = runCleanup(loadConfig());
+  return json(result);
+});
 addRoute("GET", "/api/inject", (_req, url) => {
   const q = getSearchParams(url);
   const maxTokens = q["max_tokens"] ? parseInt(q["max_tokens"], 10) : 500;
@@ -58697,7 +58884,7 @@ function registerSystemToolRoutes() {
   });
   addRoute("GET", "/api/tool-insights/:tool_name", (_req, url, params) => {
     const q = getSearchParams(url);
-    const toolName = decodeURIComponent(params["tool_name"]);
+    const toolName = params["tool_name"];
     const projectId = q["project_id"];
     const lessonsLimit = q["limit"] ? parseInt(q["limit"], 10) : 20;
     const stats = getToolStats(toolName, projectId || undefined);
@@ -58712,7 +58899,7 @@ init_memories();
 init_router();
 function registerSystemChainRoutes() {
   addRoute("GET", "/api/chains/:sequence_group", (_req, url, params) => {
-    const sequenceGroup = decodeURIComponent(params["sequence_group"]);
+    const sequenceGroup = params["sequence_group"];
     const projectId = getSearchParams(url)["project_id"];
     const chain = getMemoryChain(sequenceGroup, projectId, getDatabase());
     return json({ chain, count: chain.length, sequence_group: sequenceGroup });

package/dist/server/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/server/router.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAElC,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,eAAO,MAAM,MAAM,EAAE,KAAK,EAAO,CAAC;AAUlC,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,IAAI,CAeN;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CA8BlE"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/server/router.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAElC,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,eAAO,MAAM,MAAM,EAAE,KAAK,EAAO,CAAC;AAUlC,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,GACpB,IAAI,CAeN;AAWD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAiClE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.14.63",
+  "version": "0.14.65",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",