@modusensus/dsh-mneme 0.1.0 → 0.1.2

package/lib/client.js

@@ -1,187 +1,187 @@
-window.__ModuleLoader__.load({
-  id: "dsh-mneme",
-  factory: (require) => {
-    var module = { exports: {} };
-    var exports = module.exports;
-
-    let react = require("react");
-    let reactDom = require("react-dom");
-    let { useState, useEffect, useCallback, useRef } = react;
-    let { createPortal } = reactDom;
-
-    const inject = ["slots", "locale"];
-
-    const NS = "memory";
-
-    const dictionaries = {
-      zh: {
-        "memory.panel.title": "记忆库",
-        "memory.panel.search": "搜索记忆…",
-        "memory.panel.empty": "暂无记忆条目",
-        "memory.panel.open": "记忆",
-        "memory.tab.all": "全部",
-        "memory.tab.preference": "偏好",
-        "memory.tab.project": "项目",
-        "memory.tab.decision": "决策",
-        "memory.tab.history": "历史"
-      },
-      en: {
-        "memory.panel.title": "Memory",
-        "memory.panel.search": "Search memories…",
-        "memory.panel.empty": "No memories yet",
-        "memory.panel.open": "Memory",
-        "memory.tab.all": "All",
-        "memory.tab.preference": "Preferences",
-        "memory.tab.project": "Projects",
-        "memory.tab.decision": "Decisions",
-        "memory.tab.history": "History"
-      }
-    };
-
-    function typeLabel(t, type) {
-      const key = `memory.tab.${type}`;
-      const label = t(key);
-      return label && label !== key ? label : String(type);
-    }
-
-    function formatDate(value) {
-      if (!value) return "—";
-      const date = new Date(value);
-      return Number.isNaN(date.getTime()) ? "—" : date.toLocaleString();
-    }
-
-    function MemoryPanel({ t, onClose }) {
-      const [tab, setTab] = useState("all");
-      const [query, setQuery] = useState("");
-      const [items, setItems] = useState([]);
-      const [loading, setLoading] = useState(false);
-      const abortRef = useRef(null);
-
-      const load = useCallback(async () => {
-        abortRef.current?.abort();
-        const controller = new AbortController();
-        abortRef.current = controller;
-        setLoading(true);
-        try {
-          const params = new URLSearchParams();
-          if (tab !== "all") params.set("type", tab);
-          const url = query.trim()
-            ? `/api/dsh-mneme/search?q=${encodeURIComponent(query.trim())}`
-            : `/api/dsh-mneme/list?${params.toString()}`;
-          const res = await fetch(url, { signal: controller.signal });
-          const data = await res.json();
-          setItems(data.items || []);
-        } catch (error) {
-          if (error.name === "AbortError") return;
-          setItems([]);
-        } finally {
-          setLoading(false);
-        }
-      }, [tab, query]);
-
-      useEffect(() => {
-        load();
-        return () => abortRef.current?.abort();
-      }, [load]);
-
-      const tabs = ["all", "preference", "project", "decision", "history"];
-
-      return createPortal(
-        react.createElement("div", { style: styles.overlay },
-          react.createElement("div", { style: styles.panel },
-            react.createElement("div", { style: styles.header },
-              react.createElement("span", { style: styles.title }, t("memory.panel.title")),
-              react.createElement("button", { style: styles.close, onClick: onClose }, "×")
-            ),
-            react.createElement("input", {
-              style: styles.search,
-              placeholder: t("memory.panel.search"),
-              value: query,
-              onChange: (e) => setQuery(e.target.value)
-            }),
-            react.createElement("div", { style: styles.tabs },
-              tabs.map((key) =>
-                react.createElement("button", {
-                  key,
-                  style: { ...styles.tab, ...(tab === key ? styles.tabActive : {}) },
-                  onClick: () => setTab(key)
-                }, t(`memory.tab.${key}`))
-              )
-            ),
-            react.createElement("div", { style: styles.list },
-              loading
-                ? react.createElement("div", { style: styles.hint }, "…")
-                : items.length === 0
-                  ? react.createElement("div", { style: styles.hint }, t("memory.panel.empty"))
-                  : items.map((item) =>
-                      react.createElement("div", { key: item.id, style: styles.card },
-                        react.createElement("div", { style: styles.cardTitle },
-                          react.createElement("span", null, item.title),
-                          react.createElement("span", { style: styles.badge },
-                            `${typeLabel(t, item.type)} · ★${item.importance}`
-                          )
-                        ),
-                        react.createElement("div", { style: styles.cardContent }, item.content),
-                        react.createElement("div", { style: styles.cardMeta },
-                          formatDate(item.updated_at)
-                        )
-                      )
-                    )
-            )
-          )
-        ),
-        document.body
-      );
-    }
-
-    const styles = {
-      overlay: { position: "fixed", inset: 0, background: "rgba(0,0,0,0.4)", zIndex: 1000, display: "flex", alignItems: "center", justifyContent: "center" },
-      panel: { background: "var(--dsw-alias-bg-base, #fff)", borderRadius: 12, width: 640, maxWidth: "90vw", maxHeight: "80vh", display: "flex", flexDirection: "column", padding: 16, boxShadow: "0 8px 40px rgba(0,0,0,0.2)" },
-      header: { display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 12 },
-      title: { fontSize: 16, fontWeight: 600 },
-      close: { border: "none", background: "none", fontSize: 20, cursor: "pointer", color: "var(--dsw-alias-label-secondary, #666)" },
-      search: { padding: "8px 12px", borderRadius: 8, border: "1px solid var(--dsw-alias-border-l2, #ddd)", marginBottom: 12, fontSize: 14 },
-      tabs: { display: "flex", gap: 6, marginBottom: 12, flexWrap: "wrap" },
-      tab: { padding: "4px 10px", borderRadius: 999, border: "1px solid var(--dsw-alias-border-l2, #ddd)", background: "none", cursor: "pointer", fontSize: 12 },
-      tabActive: { background: "var(--dsw-alias-interactive-bg-active, #eee)" },
-      list: { overflowY: "auto", display: "flex", flexDirection: "column", gap: 8 },
-      hint: { color: "var(--dsw-alias-label-tertiary, #999)", padding: "24px 0", textAlign: "center" },
-      card: { border: "1px solid var(--dsw-alias-border-l1, #eee)", borderRadius: 8, padding: "10px 12px" },
-      cardTitle: { display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 4, fontSize: 14, fontWeight: 600 },
-      badge: { fontSize: 11, color: "var(--dsw-alias-label-tertiary, #999)" },
-      cardContent: { fontSize: 13, color: "var(--dsw-alias-label-secondary, #555)", marginBottom: 4, whiteSpace: "pre-wrap", wordBreak: "break-word" },
-      cardMeta: { fontSize: 11, color: "var(--dsw-alias-label-tertiary, #999)" },
-      footerButton: { padding: "4px 10px", borderRadius: 8, border: "1px solid var(--dsw-alias-border-l2, #ddd)", background: "none", cursor: "pointer", fontSize: 12, margin: "2px 8px" },
-      footerButtonActive: { background: "var(--dsw-alias-interactive-bg-active, #eee)" }
-    };
-
-    function apply(ctx) {
-      ctx.effect(() => ctx.locale.register(NS, dictionaries), "dsh-mneme: dictionaries");
-
-      ctx.effect(() => {
-        const t = ctx.locale.bind(NS);
-        return ctx.slots.inject("sidebar.footer.action", () =>
-          ctx.slots.register({
-            name: "sidebar.footer.action",
-            id: "memory",
-            locale: NS,
-            inject: () => ({})
-          }, () => {
-            const [open, setOpen] = react.useState(false);
-            return react.createElement(react.Fragment, null,
-              react.createElement("button", {
-                onClick: () => setOpen(true),
-                style: { ...styles.footerButton, ...(open ? styles.footerButtonActive : {}) }
-              }, t("memory.panel.open")),
-              open && react.createElement(MemoryPanel, { t, onClose: () => setOpen(false) })
-            );
-          })
-        );
-      }, "dsh-mneme: sidebar action");
-    }
-
-    exports.apply = apply;
-    exports.inject = inject;
-    return module.exports;
-  }
-});
+window.__ModuleLoader__.load({
+  id: "@modusensus/dsh-mneme",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+
+    let react = require("react");
+    let reactDom = require("react-dom");
+    let { useState, useEffect, useCallback, useRef } = react;
+    let { createPortal } = reactDom;
+
+    const inject = ["slots", "locale"];
+
+    const NS = "memory";
+
+    const dictionaries = {
+      zh: {
+        "memory.panel.title": "记忆库",
+        "memory.panel.search": "搜索记忆…",
+        "memory.panel.empty": "暂无记忆条目",
+        "memory.panel.open": "记忆",
+        "memory.tab.all": "全部",
+        "memory.tab.preference": "偏好",
+        "memory.tab.project": "项目",
+        "memory.tab.decision": "决策",
+        "memory.tab.history": "历史"
+      },
+      en: {
+        "memory.panel.title": "Memory",
+        "memory.panel.search": "Search memories…",
+        "memory.panel.empty": "No memories yet",
+        "memory.panel.open": "Memory",
+        "memory.tab.all": "All",
+        "memory.tab.preference": "Preferences",
+        "memory.tab.project": "Projects",
+        "memory.tab.decision": "Decisions",
+        "memory.tab.history": "History"
+      }
+    };
+
+    function typeLabel(t, type) {
+      const key = `memory.tab.${type}`;
+      const label = t(key);
+      return label && label !== key ? label : String(type);
+    }
+
+    function formatDate(value) {
+      if (!value) return "—";
+      const date = new Date(value);
+      return Number.isNaN(date.getTime()) ? "—" : date.toLocaleString();
+    }
+
+    function MemoryPanel({ t, onClose }) {
+      const [tab, setTab] = useState("all");
+      const [query, setQuery] = useState("");
+      const [items, setItems] = useState([]);
+      const [loading, setLoading] = useState(false);
+      const abortRef = useRef(null);
+
+      const load = useCallback(async () => {
+        abortRef.current?.abort();
+        const controller = new AbortController();
+        abortRef.current = controller;
+        setLoading(true);
+        try {
+          const params = new URLSearchParams();
+          if (tab !== "all") params.set("type", tab);
+          const url = query.trim()
+            ? `/api/dsh-mneme/search?q=${encodeURIComponent(query.trim())}`
+            : `/api/dsh-mneme/list?${params.toString()}`;
+          const res = await fetch(url, { signal: controller.signal });
+          const data = await res.json();
+          setItems(data.items || []);
+        } catch (error) {
+          if (error.name === "AbortError") return;
+          setItems([]);
+        } finally {
+          setLoading(false);
+        }
+      }, [tab, query]);
+
+      useEffect(() => {
+        load();
+        return () => abortRef.current?.abort();
+      }, [load]);
+
+      const tabs = ["all", "preference", "project", "decision", "history"];
+
+      return createPortal(
+        react.createElement("div", { style: styles.overlay },
+          react.createElement("div", { style: styles.panel },
+            react.createElement("div", { style: styles.header },
+              react.createElement("span", { style: styles.title }, t("memory.panel.title")),
+              react.createElement("button", { style: styles.close, onClick: onClose }, "×")
+            ),
+            react.createElement("input", {
+              style: styles.search,
+              placeholder: t("memory.panel.search"),
+              value: query,
+              onChange: (e) => setQuery(e.target.value)
+            }),
+            react.createElement("div", { style: styles.tabs },
+              tabs.map((key) =>
+                react.createElement("button", {
+                  key,
+                  style: { ...styles.tab, ...(tab === key ? styles.tabActive : {}) },
+                  onClick: () => setTab(key)
+                }, t(`memory.tab.${key}`))
+              )
+            ),
+            react.createElement("div", { style: styles.list },
+              loading
+                ? react.createElement("div", { style: styles.hint }, "…")
+                : items.length === 0
+                  ? react.createElement("div", { style: styles.hint }, t("memory.panel.empty"))
+                  : items.map((item) =>
+                      react.createElement("div", { key: item.id, style: styles.card },
+                        react.createElement("div", { style: styles.cardTitle },
+                          react.createElement("span", null, item.title),
+                          react.createElement("span", { style: styles.badge },
+                            `${typeLabel(t, item.type)} · ★${item.importance}`
+                          )
+                        ),
+                        react.createElement("div", { style: styles.cardContent }, item.content),
+                        react.createElement("div", { style: styles.cardMeta },
+                          formatDate(item.updated_at)
+                        )
+                      )
+                    )
+            )
+          )
+        ),
+        document.body
+      );
+    }
+
+    const styles = {
+      overlay: { position: "fixed", inset: 0, background: "rgba(0,0,0,0.4)", zIndex: 1000, display: "flex", alignItems: "center", justifyContent: "center" },
+      panel: { background: "var(--dsw-alias-bg-base, #fff)", borderRadius: 12, width: 640, maxWidth: "90vw", maxHeight: "80vh", display: "flex", flexDirection: "column", padding: 16, boxShadow: "0 8px 40px rgba(0,0,0,0.2)" },
+      header: { display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 12 },
+      title: { fontSize: 16, fontWeight: 600 },
+      close: { border: "none", background: "none", fontSize: 20, cursor: "pointer", color: "var(--dsw-alias-label-secondary, #666)" },
+      search: { padding: "8px 12px", borderRadius: 8, border: "1px solid var(--dsw-alias-border-l2, #ddd)", marginBottom: 12, fontSize: 14 },
+      tabs: { display: "flex", gap: 6, marginBottom: 12, flexWrap: "wrap" },
+      tab: { padding: "4px 10px", borderRadius: 999, border: "1px solid var(--dsw-alias-border-l2, #ddd)", background: "none", cursor: "pointer", fontSize: 12 },
+      tabActive: { background: "var(--dsw-alias-interactive-bg-active, #eee)" },
+      list: { overflowY: "auto", display: "flex", flexDirection: "column", gap: 8 },
+      hint: { color: "var(--dsw-alias-label-tertiary, #999)", padding: "24px 0", textAlign: "center" },
+      card: { border: "1px solid var(--dsw-alias-border-l1, #eee)", borderRadius: 8, padding: "10px 12px" },
+      cardTitle: { display: "flex", justifyContent: "space-between", alignItems: "center", marginBottom: 4, fontSize: 14, fontWeight: 600 },
+      badge: { fontSize: 11, color: "var(--dsw-alias-label-tertiary, #999)" },
+      cardContent: { fontSize: 13, color: "var(--dsw-alias-label-secondary, #555)", marginBottom: 4, whiteSpace: "pre-wrap", wordBreak: "break-word" },
+      cardMeta: { fontSize: 11, color: "var(--dsw-alias-label-tertiary, #999)" },
+      footerButton: { padding: "4px 10px", borderRadius: 8, border: "1px solid var(--dsw-alias-border-l2, #ddd)", background: "none", cursor: "pointer", fontSize: 12, margin: "2px 8px" },
+      footerButtonActive: { background: "var(--dsw-alias-interactive-bg-active, #eee)" }
+    };
+
+    function apply(ctx) {
+      ctx.effect(() => ctx.locale.register(NS, dictionaries), "dsh-mneme: dictionaries");
+
+      ctx.effect(() => {
+        const t = ctx.locale.bind(NS);
+        return ctx.slots.inject("sidebar.footer.action", () =>
+          ctx.slots.register({
+            name: "sidebar.footer.action",
+            id: "memory",
+            locale: NS,
+            inject: () => ({})
+          }, () => {
+            const [open, setOpen] = react.useState(false);
+            return react.createElement(react.Fragment, null,
+              react.createElement("button", {
+                onClick: () => setOpen(true),
+                style: { ...styles.footerButton, ...(open ? styles.footerButtonActive : {}) }
+              }, t("memory.panel.open")),
+              open && react.createElement(MemoryPanel, { t, onClose: () => setOpen(false) })
+            );
+          })
+        );
+      }, "dsh-mneme: sidebar action");
+    }
+
+    exports.apply = apply;
+    exports.inject = inject;
+    return module.exports;
+  }
+});

package/lib/config.js

@@ -1,15 +1,15 @@
-import z from "@deepseek-ai/schemastery";
-
-export const Config = z.object({
-  memoryDir: z.string().default("~/.dsh/memory"),
-  autoInject: z.boolean().default(true),
-  autoSummarize: z.boolean().default(true),
-  maxInjectedItems: z.natural().min(1).max(20).default(5),
-  importanceThreshold: z.natural().min(1).max(5).default(3),
-  autoDream: z.boolean().default(true),
-  dreamThresholdCount: z.natural().min(1).max(1000).default(10),
-  dreamThresholdChars: z.natural().min(100).max(100000).default(5000),
-  dreamDelayMs: z.natural().min(0).max(60000).default(2000),
-  dreamProvider: z.string(),
-  dreamModel: z.string()
-});
+import z from "@deepseek-ai/schemastery";
+
+export const Config = z.object({
+  memoryDir: z.string().default("~/.dsh/memory"),
+  autoInject: z.boolean().default(true),
+  autoSummarize: z.boolean().default(true),
+  maxInjectedItems: z.natural().min(1).max(20).default(5),
+  importanceThreshold: z.natural().min(1).max(5).default(3),
+  autoDream: z.boolean().default(true),
+  dreamThresholdCount: z.natural().min(1).max(1000).default(10),
+  dreamThresholdChars: z.natural().min(100).max(100000).default(5000),
+  dreamDelayMs: z.natural().min(0).max(60000).default(2000),
+  dreamProvider: z.string(),
+  dreamModel: z.string()
+});

package/lib/dream/decisions.js

@@ -1,121 +1,121 @@
-const ACTIONS = new Set(["keep", "merge", "archive", "conflict"]);
-
-/**
- * Validate a dream decision list against a snapshot of eligible memories.
- * @param decisions - LLM-produced decision list.
- * @param snapshot - Map<id, memory> of eligible (non-archived, non-summary) entries.
- * @returns {{ok: boolean, errors: string[]}}
- */
-export function validateDecisions(decisions, snapshot) {
-  const errors = [];
-  if (!Array.isArray(decisions) || decisions.length === 0) {
-    return { ok: false, errors: ["decision list must be a non-empty array"] };
-  }
-  const claimed = new Set();
-  for (const [index, d] of decisions.entries()) {
-    const at = `decision[${index}]`;
-    if (!d || typeof d !== "object" || !ACTIONS.has(d.action)) {
-      errors.push(`${at}: invalid action ${JSON.stringify(d?.action)}`);
-      continue;
-    }
-    const ids = d.action === "conflict" ? [d.winner, d.loser] : (d.ids ?? []);
-    if (d.action === "conflict") {
-      if (!d.winner || !d.loser || d.winner === d.loser) {
-        errors.push(`${at}: conflict needs distinct winner and loser`);
-        continue;
-      }
-    } else if (!Array.isArray(d.ids) || d.ids.length === 0) {
-      errors.push(`${at}: ${d.action} needs non-empty ids`);
-      continue;
-    }
-    for (const id of ids) {
-      const mem = snapshot.get(id);
-      if (!mem) {
-        errors.push(`${at}: unknown id ${JSON.stringify(id)}`);
-      } else if (mem.archived || mem.type === "summary") {
-        errors.push(`${at}: id ${JSON.stringify(id)} is archived or summary (not eligible)`);
-      }
-      if (claimed.has(id)) {
-        errors.push(`${at}: id ${JSON.stringify(id)} claimed by multiple decisions`);
-      }
-      claimed.add(id);
-    }
-    if (d.action === "merge") {
-      if (!d.keepSource || !d.ids.includes(d.keepSource)) {
-        errors.push(`${at}: merge keepSource must be one of ids`);
-      }
-      if (typeof d.title !== "string" || !d.title.trim() || typeof d.content !== "string" || !d.content.trim()) {
-        errors.push(`${at}: merge needs non-empty title and content`);
-      }
-      if (d.importance !== undefined && (!Number.isInteger(d.importance) || d.importance < 1 || d.importance > 5)) {
-        errors.push(`${at}: merge importance must be an integer 1-5 when provided`);
-      }
-      // Merging across types would blur preference/project/decision boundaries
-      // in the injected context; the snapshot carries each entry's type.
-      const mergeTypes = new Set(d.ids.map((id) => snapshot.get(id)?.type));
-      if (mergeTypes.size > 1) {
-        errors.push(`${at}: merge ids span multiple types (${[...mergeTypes].join(", ")})`);
-      }
-    }
-  }
-  // Every snapshot id must appear in at least one decision
-  for (const id of snapshot.keys()) {
-    if (!claimed.has(id)) errors.push(`memory ${JSON.stringify(id)} missing from decisions`);
-  }
-  return { ok: errors.length === 0, errors };
-}
-
-/**
- * Apply a validated decision list to the service. Caller must validate first.
- *
- * Note: merge is intentionally non-atomic — the keeper is updated before the
- * other sources are archived, so a failure between the two never loses content.
- *
- * @param decisions - validated decision list.
- * @param service - memory service (saveWithDedupe/getById/update/setArchived).
- * @param logger - optional logger ({ warn }); per-decision failures are logged.
- * @returns number of applied decisions (archive counts each archived memory as one).
- */
-export function applyDecisions(decisions, service, logger = null) {
-  let applied = 0;
-  for (const [i, d] of decisions.entries()) {
-    try {
-      if (d.action === "keep") continue;
-      if (d.action === "archive") {
-        for (const id of d.ids) {
-          const mem = service.getById(id);
-          if (mem && !mem.archived) { service.setArchived(id, true); applied++; }
-        }
-      } else if (d.action === "merge") {
-        const keeper = service.getById(d.keepSource);
-        if (!keeper || keeper.archived) continue;
-        service.update(d.keepSource, {
-          title: d.title,
-          content: d.content,
-          importance: d.importance ?? Math.max(keeper.importance, ...d.ids.map((id) => service.getById(id)?.importance ?? 1))
-        });
-        for (const id of d.ids) {
-          if (id !== d.keepSource) {
-            const mem = service.getById(id);
-            if (mem && !mem.archived) { service.setArchived(id, true); }
-          }
-        }
-        applied++;
-      } else if (d.action === "conflict") {
-        const winner = service.getById(d.winner);
-        const loser = service.getById(d.loser);
-        if (!winner || !loser) continue;
-        service.update(d.winner, {
-          content: `${winner.content}\n\n（已否决旧信息：${[...loser.content].slice(0, 100).join("")}）`
-        });
-        service.setArchived(d.loser, true);
-        applied++;
-      }
-    } catch (error) {
-      // Skip individual bad decision; never corrupt the store. The optional
-      // logger makes the failure visible instead of failing silently.
-      logger?.warn?.(`dsh-mneme dream: failed to apply ${d.action} at index ${i}: ${error.message}`);
-    }
-  }
-  return applied;
-}
+const ACTIONS = new Set(["keep", "merge", "archive", "conflict"]);
+
+/**
+ * Validate a dream decision list against a snapshot of eligible memories.
+ * @param decisions - LLM-produced decision list.
+ * @param snapshot - Map<id, memory> of eligible (non-archived, non-summary) entries.
+ * @returns {{ok: boolean, errors: string[]}}
+ */
+export function validateDecisions(decisions, snapshot) {
+  const errors = [];
+  if (!Array.isArray(decisions) || decisions.length === 0) {
+    return { ok: false, errors: ["decision list must be a non-empty array"] };
+  }
+  const claimed = new Set();
+  for (const [index, d] of decisions.entries()) {
+    const at = `decision[${index}]`;
+    if (!d || typeof d !== "object" || !ACTIONS.has(d.action)) {
+      errors.push(`${at}: invalid action ${JSON.stringify(d?.action)}`);
+      continue;
+    }
+    const ids = d.action === "conflict" ? [d.winner, d.loser] : (d.ids ?? []);
+    if (d.action === "conflict") {
+      if (!d.winner || !d.loser || d.winner === d.loser) {
+        errors.push(`${at}: conflict needs distinct winner and loser`);
+        continue;
+      }
+    } else if (!Array.isArray(d.ids) || d.ids.length === 0) {
+      errors.push(`${at}: ${d.action} needs non-empty ids`);
+      continue;
+    }
+    for (const id of ids) {
+      const mem = snapshot.get(id);
+      if (!mem) {
+        errors.push(`${at}: unknown id ${JSON.stringify(id)}`);
+      } else if (mem.archived || mem.type === "summary") {
+        errors.push(`${at}: id ${JSON.stringify(id)} is archived or summary (not eligible)`);
+      }
+      if (claimed.has(id)) {
+        errors.push(`${at}: id ${JSON.stringify(id)} claimed by multiple decisions`);
+      }
+      claimed.add(id);
+    }
+    if (d.action === "merge") {
+      if (!d.keepSource || !d.ids.includes(d.keepSource)) {
+        errors.push(`${at}: merge keepSource must be one of ids`);
+      }
+      if (typeof d.title !== "string" || !d.title.trim() || typeof d.content !== "string" || !d.content.trim()) {
+        errors.push(`${at}: merge needs non-empty title and content`);
+      }
+      if (d.importance !== undefined && (!Number.isInteger(d.importance) || d.importance < 1 || d.importance > 5)) {
+        errors.push(`${at}: merge importance must be an integer 1-5 when provided`);
+      }
+      // Merging across types would blur preference/project/decision boundaries
+      // in the injected context; the snapshot carries each entry's type.
+      const mergeTypes = new Set(d.ids.map((id) => snapshot.get(id)?.type));
+      if (mergeTypes.size > 1) {
+        errors.push(`${at}: merge ids span multiple types (${[...mergeTypes].join(", ")})`);
+      }
+    }
+  }
+  // Every snapshot id must appear in at least one decision
+  for (const id of snapshot.keys()) {
+    if (!claimed.has(id)) errors.push(`memory ${JSON.stringify(id)} missing from decisions`);
+  }
+  return { ok: errors.length === 0, errors };
+}
+
+/**
+ * Apply a validated decision list to the service. Caller must validate first.
+ *
+ * Note: merge is intentionally non-atomic — the keeper is updated before the
+ * other sources are archived, so a failure between the two never loses content.
+ *
+ * @param decisions - validated decision list.
+ * @param service - memory service (saveWithDedupe/getById/update/setArchived).
+ * @param logger - optional logger ({ warn }); per-decision failures are logged.
+ * @returns number of applied decisions (archive counts each archived memory as one).
+ */
+export function applyDecisions(decisions, service, logger = null) {
+  let applied = 0;
+  for (const [i, d] of decisions.entries()) {
+    try {
+      if (d.action === "keep") continue;
+      if (d.action === "archive") {
+        for (const id of d.ids) {
+          const mem = service.getById(id);
+          if (mem && !mem.archived) { service.setArchived(id, true); applied++; }
+        }
+      } else if (d.action === "merge") {
+        const keeper = service.getById(d.keepSource);
+        if (!keeper || keeper.archived) continue;
+        service.update(d.keepSource, {
+          title: d.title,
+          content: d.content,
+          importance: d.importance ?? Math.max(keeper.importance, ...d.ids.map((id) => service.getById(id)?.importance ?? 1))
+        });
+        for (const id of d.ids) {
+          if (id !== d.keepSource) {
+            const mem = service.getById(id);
+            if (mem && !mem.archived) { service.setArchived(id, true); }
+          }
+        }
+        applied++;
+      } else if (d.action === "conflict") {
+        const winner = service.getById(d.winner);
+        const loser = service.getById(d.loser);
+        if (!winner || !loser) continue;
+        service.update(d.winner, {
+          content: `${winner.content}\n\n（已否决旧信息：${[...loser.content].slice(0, 100).join("")}）`
+        });
+        service.setArchived(d.loser, true);
+        applied++;
+      }
+    } catch (error) {
+      // Skip individual bad decision; never corrupt the store. The optional
+      // logger makes the failure visible instead of failing silently.
+      logger?.warn?.(`dsh-mneme dream: failed to apply ${d.action} at index ${i}: ${error.message}`);
+    }
+  }
+  return applied;
+}