@modusensus/dsh-mneme 0.6.11 → 0.7.1

package/{lib → dsh-mneme/lib}/dream/sleep.js

@@ -18,6 +18,7 @@ import { randomUUID, createHash } from "node:crypto";
 import { validateDecisions, applyDecisions } from "./decisions.js";
 import { findPotentialConflicts } from "./clustering.js";
 import { buildReceipt } from "../dream.js";
+import { computeHeat } from "../heat.js";
 
 const SUMMARY_MAX = 120;
 // Conflict similarity threshold per strictness level (v0.4.0):
@@ -247,10 +248,21 @@ function phaseDemotion(service, config, logger, runId, signal = null) {
   for (const m of service.all()) {
     if (signal?.aborted) break;
     if (m.archived || m.forgotten || m.session_disposed_at) continue;
-    const ref = m.last_accessed_at ?? m.updated_at ?? m.created_at;
+    // v0.7.0 语义修正：ref 只用 last_accessed_at，缺失退 created_at；不再
+    // fallback updated_at —— 合并/更新刷的 updated_at 不是访问，防止
+    // autoDream 合并动作重置新鲜度时钟而伪装成"刚被召回"。
+    const ref = m.last_accessed_at ?? m.created_at;
     if (!ref) continue;
     const t = new Date(ref).getTime();
     if (Number.isNaN(t)) continue;
+    // v0.7.0 热联合判定（待办③）：时间窗之外再加两道保护闸——热度低于
+    // sleepHeatThreshold 且 importance<5 才允许降级。λ=0 的免疫类型 heat 恒
+    // 1.0 天然豁免（preference/pattern/summary 永不因 sleep 降级）；importance
+    // ≥5 的紧要记忆无论多冷都保留。`冷但重要` 与 `热但低值` 均不满足条件。
+    const heat = computeHeat(m, Date.now(), config);
+    const heatProtected = heat >= (config.sleepHeatThreshold ?? 0.05);
+    const important = (m.importance ?? 0) >= 5;
+    if (heatProtected || important) continue;
     if (t < compressCut) {
       service.setArchived(m.id, true);
       archived.push(m.id);

package/{lib → dsh-mneme/lib}/dream.js

@@ -559,7 +559,7 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
     if (inFlight) await inFlight.catch(() => {});
   }
 
-  async function runDream(ctx, service, config) {
+  async function runDream(ctx, service, config, settings) {
     const logger = ctx.logger;
     let memories = service.all().filter((m) => !m.archived && m.type !== "summary");
     if (memories.length === 0) return { ok: true, applied: 0, skipped: true, summary: false };
@@ -838,7 +838,12 @@ export function createDreamScheduler({ onRun, thresholdCount = 10, thresholdChar
     // and always fail-safe — a tag failure must never change the consolidation
     // outcome reported below (it is logged and counted, nothing more).
     let autoTagged = 0;
-    if (config.autoTagEnabled === true) {
+    // Effective opt-in (issue #31): the Web panel's settings toggle
+    // (user_settings) overrides the zod plugin config when explicitly stored;
+    // unset → fall back to config.autoTagEnabled. settings is null-safe (absent
+    // in tests / direct calls) so behaviour is unchanged without it.
+    const autoTagEnabled = settings?.getAutoTagConfig?.().autoTagEnabled ?? config.autoTagEnabled;
+    if (autoTagEnabled === true) {
       try {
         const tagResult = await runAutoTag({ ctx, service, config, route });
         autoTagged = tagResult?.tagged ?? 0;

package/dsh-mneme/lib/heat.js

@@ -0,0 +1,136 @@
+// dsh-mneme/src/heat.js
+// 热度（heat）纯函数模块：基于类遗忘曲线计算 memory 的当前热度。
+// 零数据库依赖，不引入任何外部依赖。
+
+/**
+ * 默认的 per-type 衰减因子 λ。
+ * λ = 0 表示该类型免疫热度衰减，热度恒为 1.0。
+ */
+export const TYPE_DECAY_DEFAULTS = Object.freeze({
+  preference: 0,    // 免疫：用户画像需长期保持
+  pattern: 0,       // 免疫：发现型稳定规律
+  summary: 0,       // 免疫：已是压缩产物
+  project: 0.0008,  // 慢衰减
+  decision: 0.002,  // 中速衰减
+  history: 0.006,   // 较快（会话摘要不断被合并）
+});
+
+const HOUR_MS = 3600000;
+const DEFAULT_ALPHA = 1.2;
+const DEFAULT_LAMBDA = 0.002;
+
+/**
+ * 将可能的日期值统一转成毫秒时间戳。
+ * 支持 Date、number、ISO 字符串；无法解析时返回 NaN。
+ */
+function toTimestamp(value) {
+  if (value === null || value === undefined) return NaN;
+
+  if (value instanceof Date) {
+    return Number.isFinite(value.getTime()) ? value.getTime() : NaN;
+  }
+
+  if (typeof value === 'number') {
+    return Number.isFinite(value) ? value : NaN;
+  }
+
+  if (typeof value === 'string') {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : NaN;
+  }
+
+  return NaN;
+}
+
+/**
+ * 获取用于计算热度的参考时间点 ref。
+ * 优先取 last_accessed_at；缺失时退到 created_at。
+ * 绝不 fallback 到 updated_at。
+ */
+function getRef(memory) {
+  if (!memory || typeof memory !== 'object') return NaN;
+  return toTimestamp(memory.last_accessed_at ?? memory.created_at);
+}
+
+/**
+ * 解析并校验配置，提供安全的 alpha 与衰减表。
+ */
+function resolveConfig(config) {
+  const safe = config && typeof config === 'object' ? config : {};
+
+  let alpha = safe.heatGlobalAlpha ?? DEFAULT_ALPHA;
+  if (!Number.isFinite(alpha) || alpha <= 0) {
+    alpha = DEFAULT_ALPHA;
+  }
+
+  const decayMap = safe.heatTypeDecay ?? TYPE_DECAY_DEFAULTS;
+
+  return { alpha, decayMap };
+}
+
+/**
+ * 构建热度信号对象，便于调试与后续扩展。
+ *
+ * @param {object} memory - memory 记录
+ * @param {object} config - 插件配置
+ * @param {number} [now=Date.now()] - 当前毫秒时间戳
+ * @returns {{ type, ref, lambda, alpha, deltaHours }}
+ */
+export function buildHeatSignals(memory, config, now = Date.now()) {
+  const nowMs = Number.isFinite(now) ? now : Date.now();
+  const ref = getRef(memory);
+  const { alpha, decayMap } = resolveConfig(config);
+
+  const type = memory?.type;
+
+  // 取对应类型的 λ，未知类型走默认
+  let lambda = decayMap[type];
+  if (!Number.isFinite(lambda)) {
+    lambda = DEFAULT_LAMBDA;
+  }
+  // λ < 0 视为非法，回退到默认；λ === 0 保留为免疫
+  if (lambda < 0) {
+    lambda = DEFAULT_LAMBDA;
+  }
+
+  let deltaHours;
+  if (!Number.isFinite(ref)) {
+    deltaHours = NaN;
+  } else if (nowMs < ref) {
+    deltaHours = 0;
+  } else {
+    deltaHours = (nowMs - ref) / HOUR_MS;
+  }
+
+  return { type, ref, lambda, alpha, deltaHours };
+}
+
+/**
+ * 计算 memory 的热度 H ∈ [0, 1]。
+ *
+ * 公式：H = 1 / (1 + λ · ΔtHours)^α
+ *
+ * @param {object} memory - memory 记录
+ * @param {number} [now=Date.now()] - 当前毫秒时间戳
+ * @param {object} [config={}] - 插件配置
+ * @returns {number} 热度值
+ */
+export function computeHeat(memory, now = Date.now(), config = {}) {
+  const signals = buildHeatSignals(memory, config, now);
+  const { alpha, lambda, deltaHours, ref } = signals;
+
+  // 无有效参考时间、或未来时间，热度视为满格
+  if (!Number.isFinite(ref) || deltaHours <= 0) {
+    return 1.0;
+  }
+
+  // λ = 0 的类型免疫，热度恒满
+  if (lambda === 0) {
+    return 1.0;
+  }
+
+  const heat = 1 / Math.pow(1 + lambda * deltaHours, alpha);
+
+  // 防止浮点误差越界
+  return Math.min(1, Math.max(0, heat));
+}

package/{lib → dsh-mneme/lib}/index.js

@@ -52,8 +52,20 @@ export const apply = (ctx, config) => {
       store.deleteOldLlmAudits(new Date(Date.now() - retentionMs * 86400000).toISOString());
     }
   } catch { /* non-fatal */ }
+  // v0.7.0: recall_runs 滚动清理 —— recordRecall 默认开且注入路径也记账，表随
+  // 活跃度增长；启动时按 recallRetentionDays（默认 90 天）清一次，防膨胀。
+  // 与 llm_audit 同策略：纯 bookkeeping，清理失败绝不阻塞插件启动。
+  try {
+    const recallRetentionDays = Number.isInteger(cfg.recallRetentionDays) ? cfg.recallRetentionDays : 90;
+    store.purgeRecallRunsOlderThan(recallRetentionDays);
+  } catch { /* non-fatal */ }
   const mirror = createMirror(memoryDir);
-  const service = createService({ store, mirror, config: cfg, logger: ctx.logger });
+  // User-configurable settings (profile, rules) and custom commands share the
+  // same SQLite file but live in dedicated tables, isolated from memories.
+  // Created before the service so the tag-config resolver (issue #31) can merge
+  // the Web panel's persisted toggles over the plugin config at runtime.
+  const settings = createSettings(store.db);
+  const service = createService({ store, mirror, config: cfg, logger: ctx.logger, settings });
 
   // F-NEW-03: if the mirror sync failed last run (persisted dirty state), retry
   // a safe re-render at boot so a stale mirror converges without needing a
@@ -78,10 +90,6 @@ export const apply = (ctx, config) => {
     } catch { /* non-fatal: recall recording is bookkeeping */ }
   });
 
-  // User-configurable settings (profile, rules) and custom commands share the
-  // same SQLite file but live in dedicated tables, isolated from memories.
-  const settings = createSettings(store.db);
-
   // Semantic pipeline: a local/ollama embedder when configured, otherwise the
   // legacy OpenAI-compatible embedder (settings-driven). The vector index wraps
   // the store's embedding column and tracks the active model fingerprint. A
@@ -244,7 +252,7 @@ export const apply = (ctx, config) => {
       delayMs: cfg.dreamDelayMs,
       logger: ctx.logger,
       semantic: { embedder, vectorIndex },
-      onRun: () => (dream ? dream.runDream(ctx, service, cfg) : Promise.resolve({ ok: true, skipped: true }))
+      onRun: () => (dream ? dream.runDream(ctx, service, cfg, settings) : Promise.resolve({ ok: true, skipped: true }))
     });
     service.setDreamHook(() => dream.maybeSchedule(service));
   }

package/{src → dsh-mneme/lib}/service.js

@@ -5,6 +5,7 @@ import { createBM25Index } from "./search/bm25.js";
 import { adaptiveThreshold } from "./search/adaptive.js";
 import { parseWikiLinks } from "./parser/wiki-link.js";
 import { extractQueryTags, applyTagBoost } from "./search/tag-boost.js";
+import { computeHeat } from "./heat.js";
 
 const INJECT_TYPES = new Set(["preference", "project", "decision", "summary"]);
 
@@ -64,7 +65,7 @@ export function computeRetrievalMetrics(actualIds, expectedIds) {
   };
 }
 
-export function createService({ store, mirror, config, onWrite, logger }) {
+export function createService({ store, mirror, config, onWrite, logger, settings }) {
   // Optional dream scheduler hook, installed via setDreamHook after creation
   // (the scheduler holds a reference back to the service, so it cannot be
   // passed in the constructor). Fired on the same write events as onWrite.
@@ -90,6 +91,20 @@ export function createService({ store, mirror, config, onWrite, logger }) {
   let vectorIndex = null;
   let reranker = null;
 
+  // Effective tag toggles (issue #31): the settings layer (Web panel switches,
+  // persisted in user_settings) overrides the plugin config when explicitly
+  // stored; unset keys fall back to the zod config default. This is the single
+  // runtime source of truth for setMemoryTags' manual gate and the Web panel's
+  // getTagConfig display — the panel toggle and the dream autoTag gate were
+  // previously writing/reading two disconnected stores.
+  const tagConfig = () => {
+    const stored = settings?.getAutoTagConfig?.() ?? {};
+    return {
+      autoTagEnabled: typeof stored.autoTagEnabled === "boolean" ? stored.autoTagEnabled : (config.autoTagEnabled ?? false),
+      manualTagEnabled: typeof stored.manualTagEnabled === "boolean" ? stored.manualTagEnabled : (config.manualTagEnabled ?? true)
+    };
+  };
+
   // Optional recall recorder, installed via setRecallRecorder after creation.
   // When searchMemories is called with recordRecall=true it receives the
   // actual merged recall scene (candidates + scores + source + threshold) so
@@ -467,14 +482,15 @@ export function createService({ store, mirror, config, onWrite, logger }) {
   }
 
   /**
-   * Sleep touch (v0.4.0): when sleep is enabled, any memory surfaced by recall
-   * or auto-injection gets its last_accessed_at bumped, so the "unrecalled N
-   * days → demote/archive" tiering counts real access. Best-effort and gated on
-   * config.sleepModeEnabled — when sleep is off this is a complete no-op (no
-   * writes on the hot recall path). A touch failure must never break search/inject.
+   * Recall touch (v0.7.0 数据前提): any memory surfaced by recall or
+   * auto-injection gets its last_accessed_at bumped so the heat model has a
+   * truthful access clock. Previously gated on config.sleepModeEnabled — now
+   * gated on config.heatEnabled (default on) so heat data is collected
+   * independently of sleep mode; sleep consumes it when it runs. Best-effort:
+   * a touch failure must never break search/inject.
    */
   function touchRecalled(memories) {
-    if (config?.sleepModeEnabled !== true || !Array.isArray(memories) || memories.length === 0) return;
+    if (config?.heatEnabled === false || !Array.isArray(memories) || memories.length === 0) return;
     for (const m of memories) {
       if (!m?.id) continue;
       try {
@@ -484,7 +500,15 @@ export function createService({ store, mirror, config, onWrite, logger }) {
   }
 
   async function searchMemories(query, options = {}) {
-    const { mode = "auto", topK = 20, threshold, useRerank = true, recordRecall = false } = options;
+    // v0.7.0: recall_runs 记录默认开（config.recallRecordDefault，默认 true）；
+    // 显式传 recordRecall:false 或配置 recallRecordDefault:false 可关。
+    const {
+      mode = "auto",
+      topK = 20,
+      threshold,
+      useRerank = true,
+      recordRecall = options.recordRecall ?? (config?.recallRecordDefault ?? true)
+    } = options;
     const raw = String(query ?? "").trim();
     if (!raw) return [];
 
@@ -683,12 +707,16 @@ export function createService({ store, mirror, config, onWrite, logger }) {
           mode,
           topK: lim,
           threshold: threshold ?? null,
+          // v0.7.0 recall-layer 强度标记：搜索帧一律 injected:false（被召回 =
+          // 检索直接命中）；注入上下文帧由 injectCandidates 以 injected:true
+          // 单独记账（被注入 = 替对话搭建上下文），两档强度可区分。
           candidates: result.map((m) => ({
             id: m.id,
             title: m.title,
             content: m.content,
             score: m.score ?? null,
-            source: m.source ?? "keyword"
+            source: m.source ?? "keyword",
+            injected: false
           })),
           createdAt: new Date().toISOString()
         });
@@ -919,6 +947,13 @@ export function createService({ store, mirror, config, onWrite, logger }) {
       });
       // Bug7: a degraded/archived result is applied on top of the merged row.
       const result = applyQualityDisposition(merged, quality, qf);
+      // Bridge tool-passed tags (plus any quality signal tags) into the
+      // entity_attrs tag store so directory / tag: recall / tagBoost see them
+      // (issue #31). Must run before afterSync so the mirror re-render reads
+      // the bridged row. Unconditional on the array (empty included): a merge
+      // that clears tags must also invalidate any stale entity_attrs row from
+      // an earlier save, or the directory keeps showing the old tag.
+      if (Array.isArray(result.tags)) store.setMemoryTags(result.id, result.tags);
       afterSync("write");
       notifyWrite();
       scheduleEmbed(result);
@@ -938,6 +973,11 @@ export function createService({ store, mirror, config, onWrite, logger }) {
       ...(quality ? { quality_score: quality.score } : {})
     });
     const result = applyQualityDisposition(created, quality, qf);
+    // Bridge tool-passed tags (plus any quality signal tags) into the
+    // entity_attrs tag store so directory / tag: recall / tagBoost see them
+    // (issue #31). Must run before afterSync so the mirror re-render reads
+    // the bridged row.
+    if (Array.isArray(result.tags) && result.tags.length) store.setMemoryTags(result.id, result.tags);
     afterSync("write");
     notifyWrite();
     scheduleEmbed(result);
@@ -1060,6 +1100,32 @@ export function createService({ store, mirror, config, onWrite, logger }) {
       } catch { /* topic re-rank unavailable: keep rule-based order */ }
     }
     const selected = candidates.slice(0, maxItems);
+    // v0.7.0 recall-layer 强度标记：注入场景也走 recall_runs 记账（mode="inject"、
+    // injected:true），与 searchMemories 的搜索帧（injected:false）互补，区分
+    // "被召回"与"被注入上下文"两个消耗强度。与搜索侧同受 recallRecordDefault
+    // 门控；记账失败绝不阻断注入本身。
+    if (recallRecorder && config.recallRecordDefault !== false) {
+      try {
+        recallRecorder({
+          query: q,
+          mode: "inject",
+          topK: selected.length,
+          threshold: null,
+          candidates: selected.map((m) => ({
+            id: m.id,
+            title: m.title,
+            content: m.content,
+            score: m.score ?? null,
+            // 注入帧的 source 固定为帧级标记 "inject"，与搜索帧的
+            // keyword/vector/rerank 对齐（记忆行自带的 source 是来源列，
+            // 与检索层级无关，不混入）。
+            source: "inject",
+            injected: true
+          })),
+          createdAt: new Date().toISOString()
+        });
+      } catch { /* recall receipt is best effort */ }
+    }
     touchRecalled(selected);
     return selected;
   }
@@ -1558,6 +1624,11 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     update: (id, p, ctx = {}) => {
       const old = store.getById(id);
       const updated = store.update(id, p);
+      // Bridge tag edits made through update (memory_update tool / panel) into
+      // the entity_attrs tag store too (issue #31) — same convergence as
+      // saveWithDedupe. An explicit empty array clears the live tag row, moving
+      // the memory back to `untagged`.
+      if (p?.tags !== undefined) store.setMemoryTags(updated.id, updated.tags);
       // Record a user correction when any meaningful field changed and the
       // reflection failure tracker is enabled. expected = what it became,
       // actual = what it was before; query (when provided) captures the
@@ -1696,13 +1767,28 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     saveWikiLinks: (r) => store.saveWikiLinks(r),
     listEntities: (o) => store.listEntities(o),
     getRelations: (id) => store.getRelations(id),
+    // v0.7.0 实体热投影：实体热 = 关联记忆 heat 聚合（取 max）。无关联记忆
+    // 或 heatEnabled=false 时返回 null；前端据此决定图谱节点大小/明暗。
+    entityHeat: (entityId) => {
+      if (config.heatEnabled === false) return null;
+      const rels = store.getRelations(entityId) ?? [];
+      let max = -Infinity;
+      for (const rel of rels) {
+        if (!rel.memory_id) continue;
+        const mem = store.getById(rel.memory_id);
+        if (!mem) continue;
+        const h = computeHeat(mem, Date.now(), config);
+        if (h > max) max = h;
+      }
+      return max === -Infinity ? null : max;
+    },
     // Tag system (v0.6.2). setMemoryTags is the manual/user path: gated by
     // config.manualTagEnabled (default true), re-renders the mirror and fires
     // the write hook. applyMemoryTags is the raw write used by the autoDream
     // tag pass (gated by autoTagEnabled, wrapped in a transaction by the
     // extractor so the mirror re-renders exactly once).
     setMemoryTags: (memoryId, tags) => {
-      if (config.manualTagEnabled === false) {
+      if (tagConfig().manualTagEnabled === false) {
         return { ok: false, error: "manualTagEnabled is off" };
       }
       const stored = store.setMemoryTags(memoryId, tags);
@@ -1713,7 +1799,10 @@ export function createService({ store, mirror, config, onWrite, logger }) {
     getMemoryTags: (memoryId) => store.getMemoryTags(memoryId),
     // Read-only gate flag so the Web panel can hide tag editing when the
     // manual path is disabled (default: manual tagging is on).
-    manualTagEnabled: () => config.manualTagEnabled !== false,
+    manualTagEnabled: () => tagConfig().manualTagEnabled !== false,
+    // Effective tag toggle pair (settings-over-config merge) for the panel
+    // (/api/dsh-mneme/config GET/PUT).
+    getTagConfig: tagConfig,
     applyMemoryTags: (memoryId, tags) => store.setMemoryTags(memoryId, tags),
     saveAttr: (r) => store.saveAttr(r),
     createEntity: (r) => store.createEntity(r),

package/{lib → dsh-mneme/lib}/settings.js

@@ -148,9 +148,13 @@ export function createSettings(db) {
           if (j && typeof j === "object") stored = j;
         } catch { /* fall through to defaults */ }
       }
+      // null = never explicitly stored → callers fall back to the plugin
+      // config default, so the settings layer can't override a toggle the
+      // user never touched (issue #31). This also unifies the manualTagEnabled
+      // default (settings no longer invents false where plugin config says true).
       return {
-        autoTagEnabled: stored.autoTagEnabled === true,
-        manualTagEnabled: stored.manualTagEnabled === true
+        autoTagEnabled: typeof stored.autoTagEnabled === "boolean" ? stored.autoTagEnabled : null,
+        manualTagEnabled: typeof stored.manualTagEnabled === "boolean" ? stored.manualTagEnabled : null
       };
     },
     setAutoTagConfig(partial) {
@@ -161,10 +165,15 @@ export function createSettings(db) {
           return j && typeof j === "object" ? j : {};
         } catch { return {}; }
       })();
-      const cfg = {
-        autoTagEnabled: partial.autoTagEnabled === undefined ? cur.autoTagEnabled === true : partial.autoTagEnabled === true,
-        manualTagEnabled: partial.manualTagEnabled === undefined ? cur.manualTagEnabled === true : partial.manualTagEnabled === true
-      };
+      const cfg = {};
+      // Only persist keys the caller explicitly set (or already stored). A
+      // partial update must never invent `false` for a key the user left
+      // alone — that would silently disable manual tagging on a toggle of
+      // autoTag alone (issue #31).
+      if (partial.autoTagEnabled !== undefined) cfg.autoTagEnabled = partial.autoTagEnabled === true;
+      else if (cur.autoTagEnabled !== undefined) cfg.autoTagEnabled = cur.autoTagEnabled === true;
+      if (partial.manualTagEnabled !== undefined) cfg.manualTagEnabled = partial.manualTagEnabled === true;
+      else if (cur.manualTagEnabled !== undefined) cfg.manualTagEnabled = cur.manualTagEnabled === true;
       setSetting("autoTag", JSON.stringify(cfg));
       return cfg;
     }

package/{lib → dsh-mneme/lib}/store.js

@@ -725,6 +725,9 @@ export function createStore(path) {
     return getById(id);
   }
 
+  // v0.7.0 语义：updated_at 只记录内容变更，绝不当访问（与 last_accessed_at
+  // 正交，sleep/heat 永不 fallback 到它）。合并/更新刷 updated_at 不应
+  // 重置热度时钟 —— 防 autoDream 合并动作伪装成"刚被召回"。
   function update(id, patch) {
     const existing = getById(id);
     if (!existing) throw new Error(`memory not found: ${id}`);
@@ -1288,6 +1291,19 @@ export function createStore(path) {
     return rows.map(toRecallRun);
   }
 
+  /**
+   * Rolling purge of the recall_runs production audit (v0.7.0): with recordRecall
+   * defaulting ON, the table would otherwise grow unboundedly on a busy store.
+   * Drop rows older than `days` (config.recallRetentionDays, default 90).
+   * created_at is an ISO TEXT string, so the ISO bound compares lexicographically.
+   * Returns the number of rows deleted (bookkeeping — never throws on empty).
+   */
+  function purgeRecallRunsOlderThan(days) {
+    const cutoff = new Date(Date.now() - days * 86400000).toISOString();
+    const result = db.prepare("DELETE FROM recall_runs WHERE created_at < ?").run(cutoff);
+    return result.changes;
+  }
+
   // --- recall evaluation trail (方案 B: separate from the production audit) -
 
   /**
@@ -1727,6 +1743,11 @@ export function createStore(path) {
            VALUES (?, ?, 'tags', ?, ?, ?, NULL, 1.0, 'manual')`
         ).run(id, memoryId, JSON.stringify(arr), memoryId, now);
       }
+      // Keep memories.tags (the display/search column) as a mirror of the
+      // entity_attrs source of truth, so API rows and keyword search never
+      // drift from the directory/tag store (issue #31).
+      db.prepare("UPDATE memories SET tags = ?, updated_at = ? WHERE id = ?")
+        .run(JSON.stringify(arr), now, memoryId);
       db.exec("RELEASE set_memory_tags");
     } catch (e) {
       db.exec("ROLLBACK TO set_memory_tags");
@@ -2185,6 +2206,7 @@ export function createStore(path) {
     saveRecallRun,
     getRecallRun,
     listRecallRuns,
+    purgeRecallRunsOlderThan,
     saveRecallEval,
     getRecallEval,
     listRecallEvals,