@modusensus/dsh-mneme 0.7.4 → 0.7.6

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

@@ -65,6 +65,8 @@ window.__ModuleLoader__.load({
         "memory.tab.project": "项目",
         "memory.tab.decision": "决策",
         "memory.tab.history": "历史",
+        "memory.tab.user": "用户",
+        "memory.tab.fact": "事实",
         "memory.settings.title": "记忆库设置",
         "memory.settings.profile": "用户画像",
         "memory.settings.profileHint": "描述你自己（角色、背景、偏好），Agent 会在每轮遵循",
@@ -100,6 +102,7 @@ window.__ModuleLoader__.load({
         "memory.explorer.tabGraph": "图谱",
         "memory.explorer.tabDirectory": "目录",
         "memory.explorer.tabSettings": "设置",
+        "memory.explorer.tabOverview": "总览",
         "memory.explorer.search": "搜索标题或内容…",
         "memory.explorer.searchTitle": "语义检索",
         "memory.explorer.types": "分类",
@@ -122,6 +125,14 @@ window.__ModuleLoader__.load({
         "memory.explorer.importance": "重要性",
         "memory.explorer.topK": "返回数量",
         "memory.explorer.topKOption": "返回 {n} 条",
+        "memory.overview.empty": "还没有记忆。开始对话后 Agent 会自动沉淀记忆，这里会展示分层总览",
+        "memory.overview.profileEmpty": "暂无用户画像记忆，可在对话中让 AI 记录",
+        "memory.overview.distribution": "类型分布",
+        "memory.overview.layers": "记忆分层",
+        "memory.overview.trend": "近 7 天趋势",
+        "memory.overview.none": "暂无",
+        "memory.overview.badgeInject": "常注入",
+        "memory.overview.badgeImportance": "按重要性",
         "memory.directory.untagged": "无标签",
         "memory.directory.loading": "加载中…",
         "memory.directory.empty": "暂无记忆条目",
@@ -179,6 +190,8 @@ window.__ModuleLoader__.load({
         "memory.tab.project": "Projects",
         "memory.tab.decision": "Decisions",
         "memory.tab.history": "History",
+        "memory.tab.user": "User",
+        "memory.tab.fact": "Facts",
         "memory.settings.title": "Memory Settings",
         "memory.settings.profile": "User Profile",
         "memory.settings.profileHint": "Describe yourself — the agent follows this every turn",
@@ -214,6 +227,7 @@ window.__ModuleLoader__.load({
         "memory.explorer.tabGraph": "Graph",
         "memory.explorer.tabDirectory": "Directory",
         "memory.explorer.tabSettings": "Settings",
+        "memory.explorer.tabOverview": "Overview",
         "memory.explorer.search": "Search title or content…",
         "memory.explorer.searchTitle": "Semantic Search",
         "memory.explorer.types": "Types",
@@ -236,6 +250,14 @@ window.__ModuleLoader__.load({
         "memory.explorer.importance": "Importance",
         "memory.explorer.topK": "Results limit",
         "memory.explorer.topKOption": "Return {n}",
+        "memory.overview.empty": "No memories yet. Once you chat, the agent starts saving memories and the layered overview appears here",
+        "memory.overview.profileEmpty": "No user-profile memories yet — ask the agent to remember things about you in chat",
+        "memory.overview.distribution": "By Type",
+        "memory.overview.layers": "Memory Layers",
+        "memory.overview.trend": "Last 7 days",
+        "memory.overview.none": "None",
+        "memory.overview.badgeInject": "Auto-inject",
+        "memory.overview.badgeImportance": "By importance",
         "memory.directory.untagged": "Untagged",
         "memory.directory.loading": "Loading…",
         "memory.directory.empty": "No memories yet",
@@ -466,6 +488,32 @@ window.__ModuleLoader__.load({
       // --- settings sub-view ---
       ".mneme-xsettings{flex:1;min-height:0;overflow-y:auto;padding:24px 24px 48px}",
       ".mneme-xsettings-inner{max-width:640px}",
+      // --- overview sub-view (layered stats dashboard, .mneme-ov-* only) ---
+      ".mneme-ov-wrap{flex:1;min-height:0;overflow-y:auto;display:flex;flex-direction:column;gap:12px;padding:12px 16px 28px}",
+      ".mneme-ov-profile{gap:8px}",
+      ".mneme-ov-prow{display:flex;flex-direction:column;gap:2px;padding:4px 0;border-top:1px solid var(--dsw-alias-border-l1)}",
+      ".mneme-ov-prow:first-of-type{border-top:none}",
+      ".mneme-ov-ptitle{font-size:13px;font-weight:600;line-height:18px;color:var(--dsw-alias-label-primary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
+      ".mneme-ov-ppreview{font-size:12px;line-height:17px;color:var(--dsw-alias-label-tertiary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
+      ".mneme-ov-dist{display:flex;flex-direction:column;gap:6px}",
+      ".mneme-ov-distrow{display:flex;align-items:center;gap:8px}",
+      ".mneme-ov-distlabel{flex:none;width:76px;font-size:12px;line-height:16px;color:var(--dsw-alias-label-secondary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
+      ".mneme-ov-distcount{flex:none;width:34px;font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;text-align:right}",
+      ".mneme-ov-disttrack{flex:1;min-width:0;height:8px;border-radius:4px;background:var(--dsw-alias-border-l2)}",
+      ".mneme-ov-distbar{height:100%;min-width:2px;border-radius:4px;background:var(--dsw-alias-state-business-primary)}",
+      ".mneme-ov-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(190px,1fr));gap:10px}",
+      ".mneme-ov-tile{box-sizing:border-box;text-align:left;border:none;cursor:pointer;font-family:inherit;gap:6px;overflow:hidden}",
+      ".mneme-ov-tile:hover{background:var(--dsw-alias-interactive-bg-hover)}",
+      ".mneme-ov-tilehead{display:flex;align-items:center;gap:6px}",
+      ".mneme-ov-tiletitle{min-width:0;font-size:13px;font-weight:600;line-height:18px;color:var(--dsw-alias-label-primary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
+      ".mneme-ov-tilecount{flex:none;margin-left:auto;font-size:12px;line-height:16px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums}",
+      ".mneme-ov-badge{flex:none;font-size:11px;line-height:16px;padding:0 6px;border-radius:8px;background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 12%,transparent);color:var(--dsw-alias-state-business-primary)}",
+      ".mneme-ov-badge--dim{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-tertiary)}",
+      ".mneme-ov-tilelatest{font-size:12px;line-height:17px;color:var(--dsw-alias-label-secondary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}",
+      ".mneme-ov-trend{display:flex;align-items:flex-end;gap:8px;padding:8px 4px 0}",
+      ".mneme-ov-trendcol{flex:1;min-width:0;display:flex;flex-direction:column;align-items:center;gap:4px}",
+      ".mneme-ov-trendbar{width:min(100%,30px);border-radius:4px 4px 0 0;background:var(--dsw-alias-state-business-primary)}",
+      ".mneme-ov-trenddate{font-size:10px;line-height:12px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;white-space:nowrap}",
       // --- hero fallback: full-viewport memory library when no tab ring exists ---
       // The host hides the whole conversation tab ring while a session is
       // blank (hero screen), so the sidebar entry cannot activate the tab
@@ -1371,10 +1419,139 @@ window.__ModuleLoader__.load({
       );
     }
 
-    const EXPLORER_TYPES = ["preference", "project", "decision", "summary", "history"];
+    // --- Overview sub-view (layered stats dashboard) ---
+    // Card grid of every memory type (fixed display order, strays appended
+    // alphabetically), plus a user-profile card, a CSS-only type distribution
+    // bar chart and a 7-day creation trend. Data comes from /stats; each tile
+    // probes /list?type=X&limit=1 for a representative latest title (the list
+    // API sorts importance-first, so limit=1 is the type's most prominent row).
+    const OVERVIEW_TYPE_ORDER = ["preference", "project", "decision", "history", "user", "fact", "summary", "pattern"];
+    // Injection-priority tiers from service.js (summary > preference/user >
+    // importance): these layers ride into nearly every prompt.
+    const OVERVIEW_INJECT_TYPES = ["summary", "user", "preference"];
+
+    function OverviewPanel({ t, onPickType }) {
+      const [stats, setStats] = useState(null); // null = loading
+      const [profile, setProfile] = useState(null); // user-type memories (list card)
+      const [latest, setLatest] = useState({}); // type -> representative memory | null
+
+      useEffect(() => {
+        let cancelled = false;
+        apiFetch("/api/dsh-mneme/stats?days=7")
+          .then((r) => (r.ok ? r.json() : null))
+          .then((d) => { if (!cancelled) setStats(d && d.byType ? d : { byType: {}, total: 0, recent: [] }); })
+          .catch(() => { if (!cancelled) setStats({ byType: {}, total: 0, recent: [] }); });
+        apiFetch("/api/dsh-mneme/list?type=user&limit=20")
+          .then((r) => (r.ok ? r.json() : { items: [] }))
+          .then((d) => { if (!cancelled) setProfile(Array.isArray(d.items) ? d.items : []); })
+          .catch(() => { if (!cancelled) setProfile([]); });
+        return () => { cancelled = true; };
+      }, []);
+
+      const byType = stats ? stats.byType : {};
+      const gridTypes = stats
+        ? OVERVIEW_TYPE_ORDER.filter((k) => byType[k]).concat(
+            Object.keys(byType).filter((k) => !OVERVIEW_TYPE_ORDER.includes(k)).sort())
+        : [];
+
+      // Representative-latest probe, one small request per visible layer.
+      // Derived purely from stats, so [stats] is the full dependency set.
+      useEffect(() => {
+        if (!stats || gridTypes.length === 0) return;
+        let cancelled = false;
+        Promise.all(gridTypes.map((k) =>
+          apiFetch(`/api/dsh-mneme/list?type=${encodeURIComponent(k)}&limit=1`)
+            .then((r) => (r.ok ? r.json() : { items: [] }))
+            .then((d) => [k, (Array.isArray(d.items) && d.items[0]) || null])
+            .catch(() => [k, null])
+        )).then((pairs) => { if (!cancelled) setLatest(Object.fromEntries(pairs)); });
+        return () => { cancelled = true; };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+      }, [stats]);
+
+      if (!stats) return h("div", { className: "mneme-ov-wrap" }, h("div", { className: "mneme-hint" }, t("memory.directory.loading")));
+      if (stats.total === 0) return h("div", { className: "mneme-ov-wrap" }, h("div", { className: "mneme-hint" }, t("memory.overview.empty")));
+
+      const distRow = (key) => {
+        const count = byType[key] || 0;
+        const pct = stats.total > 0 ? Math.round((count / stats.total) * 100) : 0;
+        return h("div", { key, className: "mneme-ov-distrow" },
+          h("span", { className: "mneme-ov-distlabel" }, typeLabel(t, key)),
+          h("span", { className: "mneme-ov-distcount" }, String(count)),
+          h("div", { className: "mneme-ov-disttrack" },
+            h("div", { className: "mneme-ov-distbar", style: { width: `${pct}%` } }))
+        );
+      };
+
+      const tile = (key) => {
+        const inject = OVERVIEW_INJECT_TYPES.includes(key);
+        const last = latest[key];
+        return h("button", {
+          key,
+          type: "button",
+          className: "mneme-card mneme-ov-tile",
+          title: t("memory.card.open"),
+          onClick: () => onPickType && onPickType(key)
+        },
+          h("div", { className: "mneme-ov-tilehead" },
+            h("span", { className: "mneme-ov-tiletitle" }, typeLabel(t, key)),
+            h("span", { className: inject ? "mneme-ov-badge" : "mneme-ov-badge mneme-ov-badge--dim" },
+              inject ? t("memory.overview.badgeInject") : t("memory.overview.badgeImportance")),
+            h("span", { className: "mneme-ov-tilecount" }, String(byType[key] || 0))
+          ),
+          h("div", { className: "mneme-ov-tilelatest" },
+            (last && (last.title || (last.content || "").slice(0, 40))) || t("memory.overview.none"))
+        );
+      };
+
+      // Trend bars scale to the busiest day; heights are fixed px so they do
+      // not depend on percentage resolution inside the flex columns.
+      const recent = Array.isArray(stats.recent) ? stats.recent : [];
+      const maxTrend = Math.max(1, ...recent.map((d) => d.count || 0));
+      const trendCol = (d) => {
+        const count = d.count || 0;
+        const px = count > 0 ? 6 + Math.round((count / maxTrend) * 90) : 0;
+        return h("div", {
+          key: d.date,
+          className: "mneme-ov-trendcol",
+          title: `${d.date} · ${t("memory.explorer.count").replace("{n}", String(count))}`
+        },
+          h("div", { className: "mneme-ov-trendbar", style: { height: `${px}px` } }),
+          h("div", { className: "mneme-ov-trenddate" }, (d.date || "").slice(5)) // MM-DD
+        );
+      };
+
+      return h("div", { className: "mneme-ov-wrap" },
+        h("div", { className: "mneme-card mneme-ov-profile", role: "region", "aria-label": t("memory.settings.profile") },
+          h("div", { className: "mneme-xcolhead" }, t("memory.settings.profile")),
+          profile === null
+            ? h("div", { className: "mneme-ov-ppreview" }, t("memory.directory.loading"))
+            : profile.length === 0
+              ? h("div", { className: "mneme-ov-ppreview" }, t("memory.overview.profileEmpty"))
+              : profile.map((m) => h("div", { key: m.id, className: "mneme-ov-prow" },
+                  h("span", { className: "mneme-ov-ptitle" }, m.title || "—"),
+                  h("span", { className: "mneme-ov-ppreview" }, (m.content_preview || m.content || "").slice(0, 100))
+                ))
+        ),
+        h("div", { className: "mneme-card", role: "region", "aria-label": t("memory.overview.distribution") },
+          h("div", { className: "mneme-xcolhead" }, t("memory.overview.distribution")),
+          h("div", { className: "mneme-ov-dist" }, gridTypes.map(distRow))
+        ),
+        h("div", { className: "mneme-xcolhead" }, t("memory.overview.layers")),
+        h("div", { className: "mneme-ov-grid" }, gridTypes.map(tile)),
+        h("div", { className: "mneme-card", role: "region", "aria-label": t("memory.overview.trend") },
+          h("div", { className: "mneme-xcolhead" }, t("memory.overview.trend")),
+          recent.length === 0
+            ? h("div", { className: "mneme-ov-tilelatest" }, t("memory.overview.none"))
+            : h("div", { className: "mneme-ov-trend" }, recent.map(trendCol))
+        )
+      );
+    }
+
+    const EXPLORER_TYPES = ["preference", "project", "decision", "summary", "history", "user", "fact"];
 
     function MemoryExplorer({ t }) {
-      const [view, setView] = useState("memory"); // memory | directory | graph | settings
+      const [view, setView] = useState("memory"); // memory | overview | directory | graph | settings
       const [items, setItems] = useState([]);
       const [loading, setLoading] = useState(true);
       const [type, setType] = useState("all");
@@ -1586,8 +1763,15 @@ window.__ModuleLoader__.load({
         setView("graph");
       };
 
+      // Overview tile click: dive into the memory view filtered to that layer.
+      const pickLayerType = (key) => {
+        setType(key);
+        setView("memory");
+      };
+
       const subviews = [
         { key: "memory", label: t("memory.explorer.tabMemory") },
+        { key: "overview", label: t("memory.explorer.tabOverview") },
         { key: "directory", label: t("memory.explorer.tabDirectory") },
         { key: "graph", label: t("memory.explorer.tabGraph") },
         { key: "settings", label: t("memory.explorer.tabSettings") }
@@ -1776,6 +1960,7 @@ window.__ModuleLoader__.load({
             )
           )
         ),
+        view === "overview" && h(OverviewPanel, { t, onPickType: pickLayerType }),
         view === "directory" && h(DirectoryPanel, { t, onJump: jumpToMemory, collapsed: dirCollapsed, setCollapsed: setDirCollapsed }),
         view === "graph" && h(GraphPanel, { t, focusEntity: graphFocus, onJumpMemory: jumpToMemory }),
         view === "settings" && h("div", { className: "mneme-xsettings" },

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

@@ -7,7 +7,9 @@ export const TYPE_FILE = {
   project: "projects.md",
   decision: "decisions.md",
   history: "history.md",
-  summary: "summary.md"
+  summary: "summary.md",
+  user: "user.md",
+  fact: "facts.md"
 };
 
 const ESCAPE = /([\\`*_[\]{}()#+.!|>~-])/g;

package/{lib → dsh-mneme/lib}/quality-filter.js

@@ -34,7 +34,9 @@ const TYPE_LABELS = {
   decision: ["decision", "决策", "决定"],
   history: ["history", "历史", "事件"],
   summary: ["summary", "总结", "摘要", "总览"],
-  pattern: ["pattern", "模式", "规律"]
+  pattern: ["pattern", "模式", "规律"],
+  user: ["user", "用户"],
+  fact: ["fact", "事实", "原子事实"]
 };
 
 /** Normalized bigram-overlap similarity in [0,1]; 0 for tiny/empty inputs. */

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

@@ -7,7 +7,7 @@ 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"]);
+const INJECT_TYPES = new Set(["preference", "project", "decision", "summary", "user", "fact"]);
 
 // Epistemic trust weights (v0.4.5): when config.trustEpistemicWeighting is on,
 // each recall candidate's existing score is multiplied by the weight of its
@@ -1047,12 +1047,15 @@ export function createService({ store, mirror, config, onWrite, logger, settings
     // (quality_score null) count as 100 (weight 1), so legacy stores keep their
     // exact summary>preference>importance ordering.
     const qualityWeight = (m) => (m.quality_score != null ? m.quality_score / 100 : 1);
+    // summary/user/preference are injected regardless of importance (context
+    // layers); every other INJECT_TYPES type (e.g. fact) only when
+    // importance >= threshold — the frontend "常注入" badge maps to this split.
     const items = store.list({ limit: 200, includeForgotten: false })
       .filter((m) => !m.archived && INJECT_TYPES.has(m.type) && !m.forgotten &&
-        (m.type === "summary" || m.type === "preference" || m.importance >= threshold))
+        (m.type === "summary" || m.type === "preference" || m.type === "user" || m.importance >= threshold))
       .sort((a, b) => {
-        const pa = a.type === "summary" ? 0 : a.type === "preference" ? 1 : 2;
-        const pb = b.type === "summary" ? 0 : b.type === "preference" ? 1 : 2;
+        const pa = a.type === "summary" ? 0 : (a.type === "preference" || a.type === "user") ? 1 : 2;
+        const pb = b.type === "summary" ? 0 : (b.type === "preference" || b.type === "user") ? 1 : 2;
         return pa - pb || (b.importance * qualityWeight(b)) - (a.importance * qualityWeight(a));
       });
     let candidates = items;
@@ -1068,7 +1071,7 @@ export function createService({ store, mirror, config, onWrite, logger, settings
           const hits = vectorIndex.search(queryVector, { limit: maxItems * 2, threshold: 0 });
           for (const m of hits) {
             if (m && !m.archived && INJECT_TYPES.has(m.type) && !m.forgotten &&
-              (m.type === "summary" || m.type === "preference" || m.importance >= threshold)) {
+              (m.type === "summary" || m.type === "preference" || m.type === "user" || m.importance >= threshold)) {
               semanticItems.push(m);
             }
           }
@@ -1606,7 +1609,46 @@ export function createService({ store, mirror, config, onWrite, logger, settings
     list: (o) => store.list(o),
     all: () => store.all(),
     count: (type, opts) => store.count(type, opts),
+    stats: (opts) => store.stats(opts),
     getById: (id) => store.getById(id),
+    // issue #48: resolve a possibly-truncated id to its canonical full id.
+    // Exact hit wins; otherwise the input is treated as a prefix of the id
+    // PRIMARY KEY. Never guesses on ambiguity — returns the candidates and the
+    // caller must pass a full id. Outcome is {ok:true,id} or {ok:false,reason,
+    // message} with reason ∈ invalid | not-found | ambiguous. warnMiss logs the
+    // silent-miss case the delete tool previously swallowed (no return channel
+    // for it, so observability has to live here in the service layer).
+    resolveMemoryId: (input, { warnMiss = false } = {}) => {
+      const bad = (reason, message) => ({ ok: false, reason, message });
+      if (typeof input !== "string") return bad("invalid", "memory id is required");
+      // 手抄/上下文压缩来的 id 可能带首尾空白，统一 trim 后再做精确与前缀解析。
+      const id = input.trim();
+      if (!id) return bad("invalid", "memory id is required");
+      const exact = store.getById(id);
+      if (exact) return { ok: true, id: exact.id };
+      const matches = store.listByIdPrefix(id);
+      if (matches.length === 0) {
+        if (warnMiss) {
+          logger?.warn?.(
+            `[dsh-mneme] memory id "${id}" matched nothing (exact or prefix) — ` +
+            "no entry was deleted; ids are full-length, pass one from memory_list/memory_search output or delete by query=…"
+          );
+        }
+        return bad(
+          "not-found",
+          `memory not found: ${id} (checked exact id and prefix; use a full id from memory_list/memory_search output)`
+        );
+      }
+      if (matches.length > 1) {
+        const sample = matches.slice(0, 5).map((m) => m.id);
+        const tail = matches.length > sample.length ? ` …(+${matches.length - sample.length})` : "";
+        return bad(
+          "ambiguous",
+          `memory id prefix "${id}" matches ${matches.length} entries (${sample.join(", ")}${tail}); refusing to guess — pass a full id`
+        );
+      }
+      return { ok: true, id: matches[0].id };
+    },
     remove: (id) => {
       store.remove(id);
       afterSync("write");

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

@@ -242,7 +242,7 @@ CREATE TABLE IF NOT EXISTS mirror_state (
 );
 `;
 
-const TYPES = new Set(["preference", "project", "decision", "history", "summary", "pattern"]);
+const TYPES = new Set(["preference", "project", "decision", "history", "summary", "pattern", "user", "fact"]);
 
 // Epistemic status: what kind of evidence a memory rests on. Defaults to
 // 'subjective' so legacy rows (and rows without any signal) stay compatible.
@@ -659,11 +659,65 @@ export function createStore(path) {
     return db.prepare(`SELECT count(*) AS c FROM memories ${where}`).get(...params).c;
   }
 
+  /**
+   * Aggregated stats for the Web panel layered overview: per-type distribution
+   * plus a recent daily creation trend. Counts live (non-forgotten /
+   * non-archived / not session-disposed) memories only, matching `count`.
+   * created_at is ISO TEXT, so date strings compare lexicographically.
+   */
+  function stats({ days = 7 } = {}) {
+    const LIVE = "forgotten = 0 AND archived = 0 AND session_disposed_at IS NULL";
+    // Clamp + integer-coerce so fractional strings (e.g. ?days=7.5) can't
+    // produce ragged trend windows (kimi-k2.7-code 复验 S2).
+    days = Math.min(30, Math.max(1, Math.floor(Number(days) || 7)));
+    const now = Date.now(); // single clock read so the window doesn't span a day boundary
+    const byType = db.prepare(
+      `SELECT type, count(*) AS c FROM memories WHERE ${LIVE} GROUP BY type`
+    ).all();
+    const byTypeCounts = {};
+    for (const row of byType) byTypeCounts[row.type] = row.c;
+    const since = new Date(now - (days - 1) * 86400000).toISOString().slice(0, 10);
+    const trend = db.prepare(
+      `SELECT substr(created_at, 1, 10) AS d, count(*) AS c FROM memories
+       WHERE ${LIVE} AND created_at >= ? GROUP BY d ORDER BY d`
+    ).all(since);
+    const trendCounts = {};
+    for (const row of trend) trendCounts[row.d] = row.c;
+    const recent = [];
+    for (let i = days - 1; i >= 0; i--) {
+      const d = new Date(now - i * 86400000).toISOString().slice(0, 10);
+      recent.push({ date: d, count: trendCounts[d] ?? 0 });
+    }
+    const total = Object.values(byTypeCounts).reduce((s, n) => s + n, 0);
+    return { byType: byTypeCounts, total, recent, days };
+  }
+
   function getById(id) {
     const row = db.prepare("SELECT * FROM memories WHERE id = ?").get(id);
     return toRow(row);
   }
 
+  /**
+   * issue #48: resolve a truncated id — as can leak through an agent's context
+   * window when list/search output is shortened — by matching it as a prefix of
+   * the id PRIMARY KEY. Exact lookups keep using getById; this only serves
+   * resolving a *candidate* id. Returns up to 51 rows so the caller can tell
+   * "unique" from "ambiguous" without a second query. LIKE wildcards are
+   * stripped from the input (a valid id fragment is hex/UUID text, never % or
+   * _). Prefix over a PK stays an index scan, so this is cheap even at scale.
+   */
+  function listByIdPrefix(idPrefix) {
+    if (typeof idPrefix !== "string" || !idPrefix.trim()) return [];
+    // LIKE 通配符不参与 id 匹配，一律剥掉。若剥完为空（如 id="%"），
+    // 不能让 SQL 退化成 `LIKE '%'` 全表命中——那会让单条记忆被误删，
+    // 一律视为无匹配返回。
+    const safe = idPrefix.replace(/[\\%_]/g, "");
+    if (!safe) return [];
+    const rows = db.prepare("SELECT * FROM memories WHERE id LIKE ? LIMIT 51")
+      .all(`${safe}%`);
+    return rows.map(toRow);
+  }
+
   /**
    * Case-insensitive exact title lookup (v0.6.1 wiki-link). COLLATE NOCASE
    * folds ASCII case (CJK titles are inherently case-free, so they match
@@ -2175,7 +2229,9 @@ export function createStore(path) {
   return {
     db,
     count,
+    stats,
     getById,
+    listByIdPrefix,
     save,
     update,
     compareAndUpdate,

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

@@ -1,7 +1,7 @@
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
 
 const SUMMARY_PROMPT = `你是记忆库提炼助手。根据下面的会话内容，提炼 2-3 条值得跨会话记住的记忆。
-只输出 JSON 数组，每项形如 {"type":"preference|project|decision|history","title":"简短标题","content":"一句话内容","importance":1-5}。
+只输出 JSON 数组，每项形如 {"type":"preference|project|decision|history|user|fact","title":"简短标题","content":"一句话内容","importance":1-5}。
 不要输出任何其他文字。`;
 
 /** Extract a JSON array from LLM output that may contain prose around it. */
@@ -17,7 +17,7 @@ export function parseSummaryJson(raw) {
     return [];
   }
   if (!Array.isArray(arr)) return [];
-  const VALID = new Set(["preference", "project", "decision", "history"]);
+  const VALID = new Set(["preference", "project", "decision", "history", "user", "fact"]);
   return arr.filter(
     (item) =>
       item &&

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

@@ -192,7 +192,7 @@ export function createTools(ctx, service, config, embedder) {
         "Call this when the user states a durable preference, a project decision is made, or a lesson is learned. " +
         "Merges into an existing entry of the same type when the title matches.",
       parameters: {
-        type: { type: "string", required: true, enum: ["preference", "project", "decision", "history"], description: "preference=user profile; project=project knowledge/state; decision=key decision; history=conversation summary" },
+        type: { type: "string", required: true, enum: ["preference", "project", "decision", "history", "user", "fact"], description: "preference=user preference; project=project knowledge/state; decision=key decision; history=conversation summary; user=user profile (background/identity); fact=atomic factual statement" },
         title: { type: "string", required: true, description: "Short unique title" },
         content: { type: "string", required: true, description: "Memory body" },
         tags: { type: "array", items: { type: "string" }, description: "Optional tags" },
@@ -266,7 +266,7 @@ export function createTools(ctx, service, config, embedder) {
       name: "memory_list",
       description: "List at most 50 memory entries by type, high-importance first, then newest, paginated. Set include_archived=true to also list archived (hidden) entries so they can be located and restored. The JSONL summary reports returned/shown/omitted, offset/total/next_offset, and each rendered entry's exact id, type, title, importance, updated_at, tags, and truncated content_preview.",
       parameters: {
-        type: { type: "string", enum: ["preference", "project", "decision", "history"], description: "Filter by type; omit for all" },
+        type: { type: "string", enum: ["preference", "project", "decision", "history", "user", "fact"], description: "Filter by type; omit for all" },
         limit: { type: "integer", description: "Page size (default and maximum 50; nonpositive values use 50)" },
         offset: { type: "integer", description: "Page offset (default 0)" },
         include_archived: { type: "boolean", description: "Include archived (hidden) entries so they can be found and restored (default false)" }
@@ -302,10 +302,10 @@ export function createTools(ctx, service, config, embedder) {
       name: "memory_update",
       description: "Modify an existing memory entry (title, content, type, tags, importance).",
       parameters: {
-        id: { type: "string", required: true, description: "Memory id" },
+        id: { type: "string", required: true, description: "Memory id (full id from memory_list/memory_search output, or a unique prefix of it)" },
         title: { type: "string" },
         content: { type: "string" },
-        type: { type: "string", enum: ["preference", "project", "decision", "history"] },
+        type: { type: "string", enum: ["preference", "project", "decision", "history", "user", "fact"] },
         tags: { type: "array", items: { type: "string" } },
         importance: { type: "integer", description: "1-5" },
         reason: { type: "string", description: "Optional context for the correction (what the user actually said/wanted), recorded for reflection" }
@@ -329,7 +329,9 @@ export function createTools(ctx, service, config, embedder) {
         render: (_args, value) => TEXT_OUTPUT(`Updated memory ${value.memory.id}: ${value.memory.title}`)
       },
       async execute(args) {
-        const memory = service.update(args.id, {
+        const resolved = service.resolveMemoryId(args.id);
+        if (!resolved.ok) throw new Error(resolved.message);
+        const memory = service.update(resolved.id, {
           title: args.title,
           content: args.content,
           type: args.type,
@@ -342,9 +344,9 @@ export function createTools(ctx, service, config, embedder) {
 
     defineTool({
       name: "memory_delete",
-      description: "Permanently delete a memory entry. Pass id for exact delete, or query to delete the single best-matching entry by text — lets the agent honor 'delete the memory about X' without a prior list/search round trip.",
+      description: "Permanently delete a memory entry. Pass id for exact delete (full id, or a unique prefix of it — ambiguous prefixes are rejected), or query to delete the single best-matching entry by text — lets the agent honor 'delete the memory about X' without a prior list/search round trip. An id that matches nothing is logged as a warning instead of failing silently.",
       parameters: {
-        id: { type: "string", description: "Exact memory id to delete (from memory_list/memory_search output)" },
+        id: { type: "string", description: "Memory id to delete: full id (from memory_list/memory_search output) or a unique prefix of it; a miss is logged (warn) and returns deleted:false" },
         query: { type: "string", description: "Delete the best-matching entry for this text (searches title/content/tags; uses hybrid recall when an embedder is configured)" }
       },
       output: {
@@ -353,13 +355,19 @@ export function createTools(ctx, service, config, embedder) {
           additionalProperties: false,
           properties: { deleted: { type: "boolean", required: true } }
         },
-        render: (_args, value) => TEXT_OUTPUT(value.deleted ? "Memory deleted." : "Memory not found.")
+        render: (_args, value) => TEXT_OUTPUT(value.deleted
+          ? "Memory deleted."
+          : "Memory not found — nothing was deleted. Pass a full id (or a unique prefix) from memory_list/memory_search output, or delete by query=… instead.")
       },
       async execute(args) {
         if (args.id) {
-          const existed = service.getById(args.id) !== undefined;
-          if (existed) service.remove(args.id);
-          return { deleted: existed };
+          const resolved = service.resolveMemoryId(args.id, { warnMiss: true });
+          if (!resolved.ok) {
+            if (resolved.reason === "ambiguous") throw new Error(resolved.message);
+            return { deleted: false };
+          }
+          service.remove(resolved.id);
+          return { deleted: true };
         }
         if (args.query) {
           const [best] = await service.searchMemories(args.query, { mode: "auto", topK: 1, useRerank: true });
@@ -378,7 +386,7 @@ export function createTools(ctx, service, config, embedder) {
         "Stop a memory from being auto-injected and from appearing in searches and lists without deleting it. " +
         "The entry stays in storage; pass forgotten: false to restore it.",
       parameters: {
-        id: { type: "string", required: true },
+        id: { type: "string", required: true, description: "Memory id: full id (from memory_list/memory_search output) or a unique prefix of it; ambiguous prefixes are rejected" },
         forgotten: { type: "boolean", description: "Suppress (true, default) or restore (false) the entry's visibility" }
       },
       output: {
@@ -399,10 +407,9 @@ export function createTools(ctx, service, config, embedder) {
         render: (_args, value) => TEXT_OUTPUT(`Memory ${value.memory.id} injection ${value.memory.forgotten ? "suppressed" : "restored"}.`)
       },
       async execute(args) {
-        if (service.getById(args.id) === undefined) {
-          throw new Error("memory not found");
-        }
-        const memory = service.setForget(args.id, args.forgotten ?? true);
+        const resolved = service.resolveMemoryId(args.id);
+        if (!resolved.ok) throw new Error(resolved.message);
+        const memory = service.setForget(resolved.id, args.forgotten ?? true);
         return { memory: { id: memory.id, forgotten: memory.forgotten } };
       }
     }),
@@ -414,7 +421,7 @@ export function createTools(ctx, service, config, embedder) {
         "Archived entries stay in storage and are recoverable: pass archived=false to restore, and use memory_list with " +
         "include_archived=true to find archived entries.",
       parameters: {
-        id: { type: "string", required: true, description: "Memory id" },
+        id: { type: "string", required: true, description: "Memory id: full id (from memory_list/memory_search output) or a unique prefix of it; ambiguous prefixes are rejected" },
         archived: { type: "boolean", description: "Archive (true, default) or restore (false) the entry" }
       },
       output: {
@@ -435,10 +442,9 @@ export function createTools(ctx, service, config, embedder) {
         render: (_args, value) => TEXT_OUTPUT(`Memory ${value.memory.id} ${value.memory.archived ? "archived" : "restored"}.`)
       },
       async execute(args) {
-        if (service.getById(args.id) === undefined) {
-          throw new Error("memory not found");
-        }
-        const memory = service.setArchived(args.id, args.archived ?? true);
+        const resolved = service.resolveMemoryId(args.id);
+        if (!resolved.ok) throw new Error(resolved.message);
+        const memory = service.setArchived(resolved.id, args.archived ?? true);
         return { memory: { id: memory.id, archived: memory.archived } };
       }
     })