@hasna/mementos 0.14.64 → 0.14.65

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/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();
@@ -62230,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]);
@@ -62248,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 {

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()) {
@@ -53407,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");
@@ -56417,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) {
@@ -56539,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;

package/package.json

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