@prom.codes/memory-mcp 0.5.1 → 0.7.0

package/dist/bin.js

@@ -1307,6 +1307,45 @@ function reciprocalRankFusion(lists, options = {}) {
   return options.limit !== void 0 && options.limit >= 0 ? merged.slice(0, options.limit) : merged;
 }
 
+// dist/temporal.js
+var RRF_K = 60;
+var DEFAULT_TEMPORAL_WEIGHT = 2;
+var RECENT_RE = /\b(latest|most[\s-]?recent|recently|recent|current|currently|now|nowadays|today|newest|up[\s-]?to[\s-]?date|so far)\b/i;
+var EARLIEST_RE = /\b(earliest|oldest|first|initial|initially|original|originally|at the (?:very )?(?:start|beginning)|back then)\b/i;
+function detectTemporalIntent(query) {
+  if (query === "")
+    return null;
+  const recent = RECENT_RE.test(query);
+  const earliest = EARLIEST_RE.test(query);
+  if (recent === earliest)
+    return null;
+  return { direction: recent ? "recent" : "earliest" };
+}
+function parseTimestamp(iso) {
+  if (iso === null || iso === void 0 || iso === "")
+    return null;
+  const ms = Date.parse(iso);
+  return Number.isFinite(ms) ? ms : null;
+}
+function applyTemporalRanking(hits, intent, getTimestampMs, weight = DEFAULT_TEMPORAL_WEIGHT) {
+  if (hits.length <= 1 || weight <= 0)
+    return [...hits];
+  const stamped = hits.map((hit, index) => ({ hit, index, ts: getTimestampMs(hit) })).filter((x) => x.ts !== null);
+  if (stamped.length <= 1)
+    return [...hits];
+  const byTime = [...stamped].sort((a, b) => intent.direction === "recent" ? b.ts - a.ts : a.ts - b.ts);
+  const tempRank = /* @__PURE__ */ new Map();
+  byTime.forEach((x, rank) => tempRank.set(x.index, rank));
+  const scored = hits.map((hit, index) => {
+    const posScore = 1 / (RRF_K + index);
+    const tr = tempRank.get(index);
+    const tempScore = tr === void 0 ? 0 : 1 / (RRF_K + tr);
+    return { hit, index, score: posScore + weight * tempScore };
+  });
+  scored.sort((a, b) => b.score - a.score || a.index - b.index);
+  return scored.map((s) => s.hit);
+}
+
 // dist/types.js
 var MEMORY_SCOPES = [
   "system",
@@ -1480,6 +1519,8 @@ var SqliteMemoryBackend = class {
   embedder;
   reranker;
   rewriter;
+  temporalEnabled;
+  temporalWeight;
   /** Record ids whose vector is missing/stale, awaiting a batched embed. */
   pendingEmbed = /* @__PURE__ */ new Set();
   closed = false;
@@ -1496,6 +1537,8 @@ var SqliteMemoryBackend = class {
     this.embedder = opts.embedder;
     this.reranker = opts.reranker;
     this.rewriter = opts.rewriter;
+    this.temporalEnabled = opts.temporal?.enabled ?? false;
+    this.temporalWeight = opts.temporal?.weight ?? DEFAULT_TEMPORAL_WEIGHT;
     if (this.embedder !== void 0)
       this.queueUnembedded();
   }
@@ -1619,7 +1662,20 @@ var SqliteMemoryBackend = class {
       ], { limit: poolLimit }).map((f) => f.payload);
     }
     const reranked = input.rerank === false ? pool : await this.rerankPool(input.query, pool, finalLimit);
-    return reranked.slice(0, finalLimit);
+    const temporalOn = input.temporal ?? this.temporalEnabled;
+    const ordered = temporalOn ? this.applyTemporal(input.query, reranked) : reranked;
+    return ordered.slice(0, finalLimit);
+  }
+  /**
+   * M5: blend the current order with a timestamp order when the query expresses
+   * a clear temporal direction. Uses `updatedAt` (falls back to `createdAt`) as
+   * the record's time. No-op when no intent is detected.
+   */
+  applyTemporal(query, hits) {
+    const intent = detectTemporalIntent(query);
+    if (intent === null)
+      return hits;
+    return applyTemporalRanking(hits, intent, (h) => parseTimestamp(h.record.updatedAt) ?? parseTimestamp(h.record.createdAt), this.temporalWeight);
   }
   /**
    * M4: rewrite the query for the retrieval channels (HyDE concat). Returns the
@@ -2076,6 +2132,18 @@ function discoverMemoryRewriter(env) {
   }
   throw new Error(`unknown PROMETHEUS_MEMORY_REWRITE_PROVIDER="${forced}" (expected "none", "mistral", "openai", or "generic")`);
 }
+function discoverMemoryTemporal(env) {
+  const raw = (env.PROMETHEUS_MEMORY_TEMPORAL ?? "on").toLowerCase();
+  const enabled = !(raw === "off" || raw === "0" || raw === "false" || raw === "no");
+  const rawWeight = env.PROMETHEUS_MEMORY_TEMPORAL_WEIGHT;
+  let weight = DEFAULT_TEMPORAL_WEIGHT;
+  if (rawWeight !== void 0 && rawWeight !== "") {
+    const n = Number.parseFloat(rawWeight);
+    if (Number.isFinite(n) && n >= 0)
+      weight = n;
+  }
+  return { enabled, weight };
+}
 function composeFromEnv(opts) {
   const env = opts.env;
   const override = (opts.workspaceRootOverride ?? "").trim();
@@ -2090,10 +2158,12 @@ function composeFromEnv(opts) {
   const { id: rerankerId, provider: reranker } = discoverMemoryReranker(env);
   const { id: extractorId, provider: extractor } = discoverMemoryExtractor(env);
   const { id: rewriterId, provider: rewriter } = discoverMemoryRewriter(env);
+  const temporal = discoverMemoryTemporal(env);
   const backend = new SqliteMemoryBackend(dbPath, {
     ...embedder !== void 0 ? { embedder } : {},
     ...reranker !== null ? { reranker } : {},
-    ...rewriter !== null ? { rewriter } : {}
+    ...rewriter !== null ? { rewriter } : {},
+    temporal
   });
   return {
     backend,
@@ -2109,6 +2179,7 @@ function composeFromEnv(opts) {
     extractorId,
     rewriter,
     rewriterId,
+    temporalEnabled: temporal.enabled,
     close: () => backend.close()
   };
 }
@@ -2735,7 +2806,7 @@ async function main() {
       env,
       ...override !== void 0 && override !== "" ? { workspaceRootOverride: override } : {}
     });
-    process.stderr.write(`prometheus-memory-mcp: workspace=${composed.workspaceRoot} (via ${via}) project=${composed.projectName} (${composed.projectId}) db=${composed.dbPath} embed=${composed.embedderId}${composed.embeddingsEnabled ? "" : " (keyword-only)"} rerank=${composed.rerankerId} extract=${composed.extractorId} rewrite=${composed.rewriterId}
+    process.stderr.write(`prometheus-memory-mcp: workspace=${composed.workspaceRoot} (via ${via}) project=${composed.projectName} (${composed.projectId}) db=${composed.dbPath} embed=${composed.embedderId}${composed.embeddingsEnabled ? "" : " (keyword-only)"} rerank=${composed.rerankerId} extract=${composed.extractorId} rewrite=${composed.rewriterId} temporal=${composed.temporalEnabled ? "on" : "off"}
 `);
     registerTools(server, composed);
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prom.codes/memory-mcp",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "prom.codes Memory — persistent, local-first agent memory as an MCP server.",
   "type": "module",
   "bin": {