dsh-engram 0.4.0 → 0.5.1

package/lib/api.js

@@ -12,7 +12,7 @@
 
 import { uuid, shortId } from "./util.js";
 import { collectToolCounts, collectUsageStats } from "./usage.js";
-import { SETTINGS_NS } from "./settings.js";
+import { SETTINGS_NS, WIRE_SETTINGS_NS, LEGACY_SETTINGS_NS } from "./settings.js";
 
 /** Route family prefix (kept in sync with the client half). */
 export const API_PREFIX = "/api/dsh-engram";
@@ -160,8 +160,9 @@ export function makeEngramRoutes(service) {
     writeJson(res, 200, {
       ...summary,
       indexes,
-      captures: service.captureStats ?? { total: 0, git: 0, file: 0, error: 0 },
+      captures: service.captureStats ?? { total: 0, git: 0, file: 0, error: 0, preference: 0 },
       gc: service.gcStats ?? { lastRun: 0, archivedMemories: 0, archivedTasks: 0, removedLinks: 0 },
+      activation: service.packTelemetry ? service.packTelemetry() : { boundaryPrune: null, recall: null },
       compaction: service.compactionStatus ?? { host: "unknown", web: { action: "unknown", presets: [] } },
       config: service.config ?? {},
       anonymous: {
@@ -512,6 +513,10 @@ export function makeEngramRoutes(service) {
         recallHitsPerQuery: queries > 0 ? +(hitsTotal / queries).toFixed(3) : null,
         detailFollowRate: queries > 0 ? +(detailFollows / queries).toFixed(4) : null,
       },
+      // SoL-Pi activation telemetry: the durable BoundaryPrune / ResultPack
+      // activation record (fires actually landed on this profile) + the
+      // [RECALL] injection-funnel leg (blocks actually injected into sessions).
+      activation: service.packTelemetry ? service.packTelemetry() : { boundaryPrune: null, recall: null },
     });
   };
 
@@ -561,8 +566,13 @@ export function makeEngramRoutes(service) {
       // Normalize both onto the HTTP contract {namespaces:[...]} the client uses.
       const payload = settings.describe();
       const namespaces = Array.isArray(payload) ? payload : (payload?.namespaces ?? []);
-      const view = namespaces.find((n) => n && n.ns === SETTINGS_NS);
-      writeJson(res, 200, view ? { namespaces: [view] } : { namespaces: [] });
+      // The seam carries the ACTIVE namespace — entry id `engram` on DSH
+      // ≥0.1.7 / 0.2.x, legacy `dsh-engram` on ≤0.1.5. The view is re-labelled
+      // onto the stable WIRE_SETTINGS_NS the client card filters on, so the
+      // shipped client works unchanged across generations.
+      const activeNs = settings.ns ?? SETTINGS_NS;
+      const view = namespaces.find((n) => n && (n.ns === activeNs || n.ns === LEGACY_SETTINGS_NS));
+      writeJson(res, 200, view ? { namespaces: [{ ...view, ns: WIRE_SETTINGS_NS }] } : { namespaces: [] });
     } catch (error) {
       writeError(res, 500, String(error?.message ?? error));
     }
@@ -586,10 +596,13 @@ export function makeEngramRoutes(service) {
       return writeError(res, 400, "body must provide ops (array of {op,path[,value]}) or patch (object)");
     }
     try {
+      // Drive the seam's ACTIVE namespace (entry id `engram` on DSH ≥0.1.7 /
+      // 0.2.x, legacy `dsh-engram` on ≤0.1.5), never the wire label.
+      const activeNs = settings.ns ?? SETTINGS_NS;
       if (Array.isArray(ops)) {
-        await settings.mutate(SETTINGS_NS, ops, expectedRevision);
+        await settings.mutate(activeNs, ops, expectedRevision);
       } else {
-        await settings.update(SETTINGS_NS, patch, expectedRevision);
+        await settings.update(activeNs, patch, expectedRevision);
       }
       writeJson(res, 200, { ok: true });
     } catch (error) {

package/lib/boundary-prune.js

@@ -40,6 +40,7 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
+import { sessionLogFile } from "./usage.js";
 import { workspaceKey as wk } from "./util.js";
 
 /** Fixed fallback for the repayment gate when no history exists yet. */
@@ -93,7 +94,7 @@ export function workspaceHistory(root = path.join(os.homedir(), ".dsh", "session
       let sessions = 0;
       const bdir = path.join(root, bucket);
       for (const sid of fs.readdirSync(bdir)) {
-        const file = path.join(bdir, sid, "session.jsonl.zstd");
+        const file = sessionLogFile(path.join(bdir, sid));
         try {
           const st = fs.statSync(file);
           if (st.size > 0) sessions += 1;
@@ -128,7 +129,7 @@ export function expectedSessionRequests(requestsSoFar, history, workspace, floor
 }
 
 /** Install the boundary-prune listener. Returns a disposer. */
-export function installBoundaryPrune(ctx, config, log) {
+export function installBoundaryPrune(ctx, config, log, hooks = {}, opts = {}) {
   const enabled = config?.boundaryPrune === true;
   if (!enabled) return () => {};
   const pruner = ctx.get?.("toolResultPruner");
@@ -139,7 +140,44 @@ export function installBoundaryPrune(ctx, config, log) {
   const minRemaining = Number.isFinite(config?.boundaryPruneMinRemaining)
     ? config.boundaryPruneMinRemaining
     : DEFAULT_MIN_REMAINING;
-  const history = workspaceHistory();
+  // History is injectable for tests; production reads the real session corpus.
+  const history = opts?.history ?? workspaceHistory();
+
+  // Optional threshold override (ResultPack L0, T2048 landing): the host pruner
+  // ships a fixed threshold (8192) that the plugin cannot change in place. When
+  // `boundaryPruneThresholdChars` is set, we instantiate our own pruner at that
+  // threshold — same deterministic head/middle/tail engine, lower budget — via
+  // the exported `ToolResultPruner` prototype (bypassing the cordis Service
+  // constructor, which needs a full context; the instance only uses its own
+  // `config` + `ctx.tokenMeter`). Falls back to the host pruner when the package
+  // or the token meter is unavailable. `boundaryPruneHeadChars` /
+  // `boundaryPruneTailChars` tune the retained edges (defaults stay at the
+  // host's 4096/1024).
+  let activePruner = pruner;
+  const thresholdOverride = Number.isFinite(config?.boundaryPruneThresholdChars)
+    ? Math.trunc(config.boundaryPruneThresholdChars)
+    : null;
+  if (thresholdOverride !== null && thresholdOverride > 0) {
+    activePruner = makeThresholdPruner(pruner, {
+      thresholdChars: thresholdOverride,
+      headChars: Number.isFinite(config?.boundaryPruneHeadChars) && config.boundaryPruneHeadChars > 0
+        ? Math.trunc(config.boundaryPruneHeadChars)
+        : 4096,
+      tailChars: Number.isFinite(config?.boundaryPruneTailChars) && config.boundaryPruneTailChars > 0
+        ? Math.trunc(config.boundaryPruneTailChars)
+        : 1024,
+    });
+    if (activePruner === null) {
+      log?.warn?.(
+        `engram boundary-prune: threshold override ${thresholdOverride} unavailable (pruner package/tokenMeter) — using host pruner ${pruner.config?.thresholdChars ?? "default"}`,
+      );
+      activePruner = pruner;
+    } else {
+      log?.info?.(
+        `engram boundary-prune: using threshold ${activePruner.config?.thresholdChars} (head ${activePruner.config?.headChars} / tail ${activePruner.config?.tailChars})`,
+      );
+    }
+  }
 
   /** Per-session boundary state (todo high-water mark, request count, total prunes). */
   const stateBySession = new Map();
@@ -150,12 +188,32 @@ export function installBoundaryPrune(ctx, config, log) {
       if (typeof sid !== "string" || sid.length === 0) return;
       let state = stateBySession.get(sid);
       if (!state) {
-        state = { todoCompleted: 0, requests: 0, prunes: 0, prunedResults: 0 };
+        state = { todoCompleted: 0, requests: 0, prunes: 0, prunedResults: 0, lastFireRequest: void 0 };
         stateBySession.set(sid, state);
       }
       const type = event?.type;
       if (type === "assistant/message") {
         state.requests += 1;
+        // Request-count boundary (SoL-Pi "step idle", default OFF): sessions
+        // with no todo progress / no goal never fire the event boundaries (L0
+        // corpus: ~62% of sessions), leaving their over-threshold replay
+        // exposure permanently untouched. When `boundaryPruneIdleCadence` is
+        // set, the counter itself is a boundary source: fire at most once per
+        // cadence requests, still under the repayment gate (so cadence ≠
+        // aggressive — the gate keeps per-session reuse healthy). The implied
+        // boundary kind is `step` so telemetry can attribute it.
+        const cadence = config?.boundaryPruneIdleCadence;
+        if (Number.isFinite(cadence) && cadence > 0 && state.requests % Math.trunc(cadence) === 0) {
+          const sinceLastPrune = state.lastFireRequest === void 0 ? state.requests : state.requests - state.lastFireRequest;
+          if (sinceLastPrune >= Math.trunc(cadence)) {
+            const workspace = wk(session?.header?.cwd);
+            const expectedTotal = expectedSessionRequests(state.requests, history, workspace, minRemaining);
+            if (state.requests + minRemaining <= expectedTotal) {
+              // reuse the same fire path via a synthetic boundary
+              return fireBoundary(session, { kind: "step" }, state, expectedTotal);
+            }
+          }
+        }
         return;
       }
       const boundary = isBoundary(event, state);
@@ -168,21 +226,43 @@ export function installBoundaryPrune(ctx, config, log) {
       const workspace = wk(session?.header?.cwd);
       const expectedTotal = expectedSessionRequests(state.requests, history, workspace, minRemaining);
       if (state.requests + minRemaining > expectedTotal) return;
-
-      const result = pruner.pruneSession(session);
-      const prunedNow = result?.pruned?.length ?? 0;
-      if (prunedNow > 0) {
-        state.prunes += 1;
-        state.prunedResults += prunedNow;
-        log?.info?.(
-          `engram boundary-prune (${boundary.kind} @${state.requests} reqs): pruned ${prunedNow} results, saved ${result.charsRemoved} chars`,
-        );
-      }
+      return fireBoundary(session, boundary, state, expectedTotal);
     } catch (error) {
       // fully contained — a prune bug must never disturb the session pipeline
       log?.warn?.(`engram boundary-prune threw: ${String(error)}`);
     }
   };
+
+  /** Shared fire path for every boundary source (event + step-cadence). */
+  const fireBoundary = (session, boundary, state, expectedTotal) => {
+    const result = activePruner.pruneSession(session);
+    const prunedNow = result?.pruned?.length ?? 0;
+    if (prunedNow > 0) {
+      state.prunes += 1;
+      state.prunedResults += prunedNow;
+      state.lastFireRequest = state.requests;
+      log?.info?.(
+        `engram boundary-prune (${boundary.kind} @${state.requests} reqs): pruned ${prunedNow} results, saved ${result.charsRemoved} chars`,
+      );
+      // L2 hook (ResultPack): archiving + handle tail is wired by index.js
+      // when `resultPack` is enabled. Contained there — never throws here.
+      // Attach the live pruner budgets so the archiver extracts the exact
+      // removed span (archives must match what the surface now displays).
+      try {
+        const budgets = {
+          headChars: activePruner.config?.headChars ?? 4096,
+          tailChars: activePruner.config?.tailChars ?? 1024,
+        };
+        for (const item of result?.pruned ?? []) {
+          if (item && typeof item === "object") Object.assign(item, budgets);
+        }
+        hooks?.onPruned?.(session, result, boundary);
+      } catch (error) {
+        log?.warn?.(`engram boundary-prune: L2 hook threw: ${String(error)}`);
+      }
+    }
+    void expectedTotal;
+  };
   const disposeListener = ctx.on("session/event", onEvent);
   const disposeSink = ctx.on("session/disposed", (session) => {
     stateBySession.delete(session?.id);
@@ -192,3 +272,24 @@ export function installBoundaryPrune(ctx, config, log) {
     disposeSink?.();
   };
 }
+
+/**
+ * Build a pruner at an override threshold by prototyping off the injected
+ * host service instance.
+ *
+ * The host `toolResultPruner` ships a fixed budget (8192/4096/1024) that
+ * cannot be mutated in place. DSH's pruner is a plain prototype-owning class
+ * whose methods only read `this.config` and `this.ctx.tokenMeter`, so we
+ * create a child object inheriting the host instance (methods + ctx shared,
+ * config overridden on the child). Zero LLM, deterministic, contained — the
+ * host instance and its config stay untouched.
+ */
+function makeThresholdPruner(pruner, cfg) {
+  try {
+    const clone = Object.create(pruner);
+    clone.config = cfg;
+    return clone;
+  } catch {
+    return null;
+  }
+}

package/lib/client.js

@@ -153,6 +153,28 @@ var EngramApi = class {
       })
     );
   }
+  /**
+   * Data contract (issue #3) — dump the selected workspace, or every
+   * workspace when omitted, as a `dsh-engram/export` v1 payload. The same
+   * format `POST /import` restores, so the dump is a portable backup.
+   */
+  async exportData(workspace) {
+    return readJson(await fetch(`${API_PREFIX}/export${query({ workspace })}`));
+  }
+  /**
+   * Data contract (issue #3) — restore a dump. `merge` adds missing rows
+   * (idempotent), `replace` wipes the target workspace first (the host then
+   * requires `confirm: "restore"`). `dryRun` plans without writing.
+   */
+  async importData(body) {
+    return readJson(
+      await fetch(`${API_PREFIX}/import`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body)
+      })
+    );
+  }
   /** Settings card transport — read the `dsh-engram` namespace through our
    *  own HTTP API instead of the host connection/remote RPC. */
   async getSettings() {
@@ -2209,6 +2231,7 @@ function EngramTelemetry({ api, workspace }) {
 var import_react6 = require("react");
 var import_jsx_runtime6 = require("react/jsx-runtime");
 var KIND_COLORS = {
+  preference: "#b45309",
   decision: "#2563eb",
   error: "#dc2626",
   procedure: "#7c3aed",
@@ -2218,6 +2241,7 @@ var KIND_COLORS = {
   task: "#4f46e5"
 };
 var KIND_LABEL = {
+  preference: "\u504F\u597D",
   decision: "\u51B3\u5B9A",
   error: "\u9519\u8BEF",
   procedure: "\u6D41\u7A0B",
@@ -2252,7 +2276,7 @@ function gapsOf(t) {
   if (!t.memoryRefs || t.memoryRefs.length === 0) gaps.push("memory_ref");
   return gaps;
 }
-function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMemory, onChanged }) {
+function EngramDetail({ target, api, tasks, nodes, links, memories = [], onClose, onNavigateMemory, onChanged }) {
   const { dark, vars } = useEngramTheme();
   const [gArt, setGArt] = (0, import_react6.useState)("");
   const [gEval, setGEval] = (0, import_react6.useState)("");
@@ -2272,6 +2296,15 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
     if (target.kind !== "node" || !node) return [];
     return links.filter((l) => l.source === node.id || l.target === node.id).map((l) => ({ l, outgoing: l.source === node.id }));
   }, [links, node, target.kind]);
+  const memoryLinks = (0, import_react6.useMemo)(() => {
+    if (target.kind !== "memory") return null;
+    const m = target.memory;
+    return {
+      m,
+      replacedBy: memories.filter((x) => x.status === "active" && x.supersedes === m.id),
+      contradictedBy: memories.filter((x) => x.status === "active" && x.contradicts === m.id)
+    };
+  }, [target, memories]);
   const hb2 = {
     root: {
       ...vars,
@@ -2302,6 +2335,8 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
     badge: { fontSize: 10.5, fontWeight: 700, padding: "2px 8px", borderRadius: 999, color: "#fff" },
     tag: { fontSize: 11, padding: "1px 8px", borderRadius: 999, background: "var(--dsh-color-hover-bg, #f3f4f6)", color: "var(--dsh-color-muted, #6b7280)", border: "1px solid var(--dsh-color-border, #e5e7eb)" },
     chip: { fontSize: 11, padding: "2px 9px", borderRadius: 999, background: "rgba(37,99,235,.1)", color: "#2563eb", border: "1px solid rgba(37,99,235,.25)", cursor: "pointer" },
+    chipSup: { fontSize: 11, padding: "2px 9px", borderRadius: 999, background: "rgba(124,58,237,.1)", color: "#7c3aed", border: "1px solid rgba(124,58,237,.25)", cursor: "pointer" },
+    chipDanger: { fontSize: 11, padding: "2px 9px", borderRadius: 999, background: "rgba(220,38,38,.1)", color: "#dc2626", border: "1px solid rgba(220,38,38,.25)", cursor: "pointer" },
     input: { fontSize: 12, padding: "5px 8px", border: "1px solid var(--dsh-color-border, #d1d5db)", borderRadius: 8, background: "var(--dsh-color-surface, #ffffff)", color: "var(--dsh-color-muted-strong, #374151)", width: "100%", boxSizing: "border-box" },
     btn: { fontSize: 11.5, fontWeight: 600, padding: "5px 10px", borderRadius: 8, cursor: "pointer", border: "1px solid var(--dsh-color-border, #d1d5db)", background: "transparent", color: "var(--dsh-color-muted-strong, #374151)" },
     btnPrimary: { fontSize: 11.5, fontWeight: 700, padding: "5px 12px", borderRadius: 8, cursor: "pointer", border: "none", background: "#2563eb", color: "#fff" },
@@ -2440,6 +2475,29 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
             t
           ] }, t)) })
         ] }),
+        memoryLinks && (memoryLinks.m.supersedes || memoryLinks.m.contradicts || memoryLinks.replacedBy.length > 0 || memoryLinks.contradictedBy.length > 0) && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: hb2.section, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: hb2.k, children: "\u66FF\u6362 / \u51B2\u7A81" }),
+          /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { display: "flex", gap: 5, flexWrap: "wrap", marginTop: 3 }, children: [
+            memoryLinks.m.supersedes && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipSup, title: `\u672C\u6761\u66FF\u4EE3 ${memoryLinks.m.supersedes}\uFF08\u65E7\u884C\u4FDD\u7559\u3001\u53EC\u56DE\u964D\u7EA7\uFF09`, onClick: () => onNavigateMemory(memoryLinks.m.supersedes), children: [
+              "\u66FF\u4EE3 #",
+              memoryLinks.m.supersedes.slice(0, 8)
+            ] }),
+            memoryLinks.m.contradicts && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipDanger, title: `\u672C\u6761\u4E0E ${memoryLinks.m.contradicts} \u51B2\u7A81\uFF08\u4E24\u6761\u90FD\u4FDD\u7559\uFF09`, onClick: () => onNavigateMemory(memoryLinks.m.contradicts), children: [
+              "\u51B2\u7A81 #",
+              memoryLinks.m.contradicts.slice(0, 8)
+            ] }),
+            memoryLinks.replacedBy.map((x) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipSup, title: `\u5DF2\u88AB ${x.text.slice(0, 40)}\u2026 \u66FF\u4EE3`, onClick: () => onNavigateMemory(x.id), children: [
+              "\u2190 \u88AB #",
+              x.id.slice(0, 8),
+              " \u66FF\u4EE3"
+            ] }, x.id)),
+            memoryLinks.contradictedBy.map((x) => /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { style: hb2.chipDanger, title: `${x.text.slice(0, 40)}\u2026 \u4E0E\u672C\u6761\u51B2\u7A81`, onClick: () => onNavigateMemory(x.id), children: [
+              "\u21C4 #",
+              x.id.slice(0, 8),
+              " \u51B2\u7A81"
+            ] }, x.id))
+          ] })
+        ] }),
         /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: hb2.section, children: [
           /* @__PURE__ */ (0, import_jsx_runtime6.jsx)("div", { style: hb2.k, children: "\u5143\u6570\u636E" }),
           /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 2, marginTop: 3, fontSize: 11.5, fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace", color: "var(--dsh-color-muted, #6b7280)" }, children: [
@@ -2467,6 +2525,18 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
               " \xB7 updated ",
               fmtDate(target.memory.updatedAt)
             ] }),
+            target.memory.source && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
+              "source ",
+              target.memory.source
+            ] }),
+            target.memory.conditions && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
+              "conditions ",
+              target.memory.conditions
+            ] }),
+            target.memory.filePath && /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
+              "file ",
+              target.memory.filePath
+            ] }),
             /* @__PURE__ */ (0, import_jsx_runtime6.jsxs)("span", { children: [
               "TTL ",
               daysLeft(target.memory.expiresAt)
@@ -2567,6 +2637,7 @@ function EngramDetail({ target, api, tasks, nodes, links, onClose, onNavigateMem
 // client/src/EngramSection.tsx
 var import_jsx_runtime7 = require("react/jsx-runtime");
 var KIND_COLORS2 = {
+  preference: "#b45309",
   decision: "#2563eb",
   error: "#dc2626",
   procedure: "#7c3aed",
@@ -2576,6 +2647,7 @@ var KIND_COLORS2 = {
   task: "#4f46e5"
 };
 var KIND_LABEL2 = {
+  preference: "\u504F\u597D",
   decision: "\u51B3\u5B9A",
   error: "\u9519\u8BEF",
   procedure: "\u6D41\u7A0B",
@@ -2787,6 +2859,14 @@ function EngramSection({ api, t }) {
   const [closeEval, setCloseEval] = (0, import_react7.useState)("");
   const [closeRefs, setCloseRefs] = (0, import_react7.useState)("");
   const [closeBusy, setCloseBusy] = (0, import_react7.useState)(false);
+  const [importDump, setImportDump] = (0, import_react7.useState)(null);
+  const [importName, setImportName] = (0, import_react7.useState)("");
+  const [importMode, setImportMode] = (0, import_react7.useState)("merge");
+  const [importDryRun, setImportDryRun] = (0, import_react7.useState)(true);
+  const [importReplaceOk, setImportReplaceOk] = (0, import_react7.useState)(false);
+  const [importBusy, setImportBusy] = (0, import_react7.useState)(false);
+  const [importReport, setImportReport] = (0, import_react7.useState)(null);
+  const [dataError, setDataError] = (0, import_react7.useState)(null);
   const refresh = (0, import_react7.useCallback)(async () => {
     setBusy(true);
     setError(null);
@@ -2843,6 +2923,24 @@ function EngramSection({ api, t }) {
     for (const t2 of tasks) map.set(t2.id, t2.name);
     return (id) => map.get(id) ?? id;
   }, [nodes, tasks]);
+  const supersedeIndex = (0, import_react7.useMemo)(() => {
+    const replacedBy = /* @__PURE__ */ new Map();
+    const contradictedBy = /* @__PURE__ */ new Map();
+    for (const m of memories) {
+      if (m.status !== "active") continue;
+      if (m.supersedes) {
+        const list = replacedBy.get(m.supersedes) ?? [];
+        list.push(m);
+        replacedBy.set(m.supersedes, list);
+      }
+      if (m.contradicts) {
+        const list = contradictedBy.get(m.contradicts) ?? [];
+        list.push(m);
+        contradictedBy.set(m.contradicts, list);
+      }
+    }
+    return { replacedBy, contradictedBy };
+  }, [memories]);
   (0, import_react7.useEffect)(() => {
     if (!newTaskWs && workspaces.length > 0 && !workspace) setNewTaskWs(workspaces[0]);
   }, [newTaskWs, workspaces, workspace]);
@@ -2876,6 +2974,60 @@ function EngramSection({ api, t }) {
       setGcRunning(false);
     }
   };
+  const downloadExport = async () => {
+    setDataError(null);
+    try {
+      const dump = await api.exportData(workspace || void 0);
+      const blob = new Blob([JSON.stringify(dump, null, 2)], { type: "application/json" });
+      const url = URL.createObjectURL(blob);
+      const a = document.createElement("a");
+      const safe = (workspace || "all").replace(/[^a-zA-Z0-9._-]+/g, "_");
+      a.href = url;
+      a.download = `dsh-engram-export-${safe}-${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}.json`;
+      a.click();
+      URL.revokeObjectURL(url);
+    } catch (e) {
+      setDataError(e instanceof Error ? e.message : String(e));
+    }
+  };
+  const pickImportFile = async (file) => {
+    setDataError(null);
+    setImportReport(null);
+    setImportDump(null);
+    setImportName("");
+    if (!file) return;
+    try {
+      const text = await file.text();
+      setImportDump(JSON.parse(text));
+      setImportName(file.name);
+    } catch (e) {
+      setDataError(`\u65E0\u6CD5\u89E3\u6790 ${file.name}\uFF1A${e instanceof Error ? e.message : String(e)}`);
+    }
+  };
+  const runImport = async () => {
+    if (importDump === null) return;
+    if (importMode === "replace" && !importReplaceOk) {
+      setDataError("\u66FF\u6362\u6A21\u5F0F\u4F1A\u5148\u6E05\u7A7A\u76EE\u6807\u5DE5\u4F5C\u533A \u2014 \u8BF7\u5148\u52FE\u9009\u786E\u8BA4");
+      return;
+    }
+    setImportBusy(true);
+    setDataError(null);
+    try {
+      const report = await api.importData({
+        payload: importDump,
+        mode: importMode,
+        dryRun: importDryRun,
+        workspace: workspace || void 0,
+        confirm: importMode === "replace" ? "restore" : void 0
+      });
+      setImportReport(report);
+      if (!report.dryRun) await refresh();
+    } catch (e) {
+      setDataError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setImportBusy(false);
+    }
+  };
   const groupedRows = workspace === "" ? groupByWorkspace(memories) : [[workspace, memories]];
   const taskGroups = workspace === "" ? groupByWorkspace(tasks) : [[workspace, tasks]];
   const linkGroups = workspace === "" ? groupByWorkspace(links) : [[workspace, links]];
@@ -2995,6 +3147,7 @@ function EngramSection({ api, t }) {
               /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(StatCard, { num: String(wsCounts ? wsCounts.nodes ?? 0 : overview.totals.nodes ?? 0), label: wsCounts ? "\u8282\u70B9" : "\u8282\u70B9 (\u5168\u5C40)" }),
               /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(StatCard, { num: String(workspaces.length), label: "\u5DE5\u4F5C\u533A" }),
               /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(StatCard, { num: String(overview.captures.total), label: "\u81EA\u52A8\u6355\u83B7" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(StatCard, { num: String(overview.captures.preference ?? 0), label: "\u504F\u597D\u6355\u83B7" }),
               /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
                 StatCard,
                 {
@@ -3064,6 +3217,90 @@ function EngramSection({ api, t }) {
               ] }, l.id))
             ] })
           ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: s2.subPanel, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: 10, flexWrap: "wrap" }, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { fontWeight: 700, fontSize: 13 }, children: "\u6570\u636E\u5907\u4EFD\uFF08export / import\uFF09" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { style: s2.btn, title: "\u4E0B\u8F7D\u5F53\u524D\u5DE5\u4F5C\u533A\uFF08\u6216\u5168\u90E8\uFF09\u7684 dsh-engram/export v1 \u8F6C\u50A8", onClick: () => void downloadExport(), children: "\u5BFC\u51FA JSON" }),
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("label", { style: { ...s2.btn, display: "inline-flex", alignItems: "center", gap: 6, cursor: "pointer" }, children: [
+                "\u9009\u62E9\u5BFC\u5165\u6587\u4EF6\u2026",
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+                  "input",
+                  {
+                    type: "file",
+                    accept: "application/json,.json",
+                    style: { display: "none" },
+                    onChange: (e) => {
+                      void pickImportFile(e.target.files?.[0] ?? null);
+                      e.currentTarget.value = "";
+                    }
+                  }
+                )
+              ] }),
+              importName && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: s2.mono, children: importName })
+            ] }),
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { fontSize: 11.5, color: "var(--dsh-color-muted, #6b7280)", marginTop: 4 }, children: [
+              "\u5BFC\u51FA\u5373\u53EF\u79FB\u690D\u5907\u4EFD\uFF08\u8BB0\u5FC6/\u4EFB\u52A1/\u5173\u7CFB/\u8282\u70B9\uFF0C\u542B\u5F52\u6863\uFF09\uFF1B",
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("b", { children: "merge" }),
+              " \u53EA\u8865\u7F3A\u5931\uFF08\u5E42\u7B49\uFF09\uFF0C",
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("b", { children: "replace" }),
+              " \u5148\u6E05\u7A7A\u76EE\u6807\u5DE5\u4F5C\u533A\u518D\u6062\u590D\u3002\u8BB0\u5FC6\u6B63\u6587\u4E0E\u6240\u6709\u5199\u5165\u8DEF\u5F84\u4E00\u6837\u8FC7\u8131\u654F\u3002"
+            ] }),
+            importDump !== null && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { marginTop: 8, display: "flex", flexDirection: "column", gap: 6 }, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { display: "flex", gap: 10, alignItems: "center", flexWrap: "wrap", fontSize: 12.5 }, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("label", { style: { display: "inline-flex", gap: 4, alignItems: "center" }, children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("input", { type: "checkbox", checked: importDryRun, onChange: (e) => setImportDryRun(e.target.checked) }),
+                  "\u4EC5\u9884\u89C8\uFF08dry run\uFF09"
+                ] }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+                  "select",
+                  {
+                    style: s2.input,
+                    value: importMode,
+                    onChange: (e) => {
+                      const mode = e.target.value;
+                      setImportMode(mode);
+                      if (mode !== "replace") setImportReplaceOk(false);
+                    },
+                    children: [
+                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("option", { value: "merge", children: "\u5408\u5E76\uFF08merge\uFF0C\u5E42\u7B49\uFF09" }),
+                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("option", { value: "replace", children: "\u66FF\u6362\uFF08replace\uFF0C\u5148\u6E05\u7A7A\u5DE5\u4F5C\u533A\uFF09" })
+                    ]
+                  }
+                ),
+                importMode === "replace" && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("label", { style: { display: "inline-flex", gap: 4, alignItems: "center", color: "#b45309" }, children: [
+                  /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("input", { type: "checkbox", checked: importReplaceOk, onChange: (e) => setImportReplaceOk(e.target.checked) }),
+                  "\u6211\u786E\u8BA4\u66FF\u6362",
+                  workspace ? `\uFF08${workspace}\uFF09` : "\uFF08\u9700\u5148\u9009\u5DE5\u4F5C\u533A\uFF09"
+                ] }),
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+                  "button",
+                  {
+                    style: s2.btnPrimary,
+                    disabled: importBusy || importMode === "replace" && (!importReplaceOk || !workspace),
+                    onClick: () => void runImport(),
+                    children: importBusy ? "\u2026" : importDryRun ? "\u9884\u89C8\u5BFC\u5165" : "\u6267\u884C\u5BFC\u5165"
+                  }
+                )
+              ] }),
+              importReport && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: { fontSize: 12.5 }, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { children: [
+                  importReport.dryRun ? "dry-run \u9884\u89C8\uFF1A" : "\u5DF2\u5BFC\u5165\uFF1A",
+                  " ",
+                  Object.entries(importReport.written).map(([k, v]) => `${k} ${v}`).join(" \xB7 ") || "\u2014",
+                  importReport.skipped.length > 0 ? ` \xB7 \u8DF3\u8FC7 ${importReport.skipped.length}` : ""
+                ] }),
+                importReport.skipped.slice(0, 5).map((x, i) => /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: s2.mono, children: [
+                  "- ",
+                  x.table,
+                  " ",
+                  x.id ? x.id.slice(0, 8) : "?",
+                  ": ",
+                  x.reason
+                ] }, `${x.table}-${x.id ?? i}`))
+              ] }),
+              dataError && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: { fontSize: 12, color: "#dc2626", fontWeight: 600 }, children: dataError })
+            ] })
+          ] }),
           /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { style: s2.row, children: [
             /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("select", { style: s2.input, value: kind, onChange: (e) => setKind(e.target.value), children: [
               /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("option", { value: "", children: "\u5168\u90E8\u7C7B\u578B" }),
@@ -3137,7 +3374,8 @@ function EngramSection({ api, t }) {
                 ] }) }, `h-${r.ws}`) : /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("tr", { children: [
                   /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("td", { style: { ...s2.td, whiteSpace: "nowrap" }, children: [
                     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.badge, background: KIND_COLORS2[r.m.kind] ?? "#6b7280" }, children: KIND_LABEL2[r.m.kind] ?? r.m.kind }),
-                    r.m.status === "archived" && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.tag, color: "#b45309", background: "#fef3c7" }, children: "archived" })
+                    r.m.status === "archived" && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.tag, color: "#b45309", background: "#fef3c7" }, children: "archived" }),
+                    supersedeIndex.replacedBy.has(r.m.id) && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: { ...s2.tag, color: "#b45309", background: "#fef3c7" }, title: `\u5DF2\u88AB ${(supersedeIndex.replacedBy.get(r.m.id) ?? []).map((x) => `#${x.id.slice(0, 8)}`).join(", ")} \u66FF\u4EE3\uFF08\u65E7\u884C\u4FDD\u7559\u3001\u53EC\u56DE\u964D\u7EA7\uFF09`, children: "\u5DF2\u66FF\u6362" })
                   ] }),
                   /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("td", { style: { ...s2.td, minWidth: 0 }, children: [
                     /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { title: r.m.text, style: expandedRows.has(r.m.id) ? s2.expanded : s2.clamp3, children: r.m.text }),
@@ -3154,7 +3392,11 @@ function EngramSection({ api, t }) {
                         " \xB7 ",
                         daysLeft2(r.m.expiresAt)
                       ] }),
-                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { style: s2.linkBtn, onClick: () => toggleExpand(r.m.id), children: expandedRows.has(r.m.id) ? "\u6536\u8D77" : "\u5C55\u5F00\u5168\u6587" })
+                      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("button", { style: s2.linkBtn, onClick: () => toggleExpand(r.m.id), children: expandedRows.has(r.m.id) ? "\u6536\u8D77" : "\u5C55\u5F00\u5168\u6587" }),
+                      r.m.supersedes && /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("button", { style: s2.linkBtn, title: `\u6253\u5F00\u88AB\u66FF\u4EE3\u7684\u65E7\u8BB0\u5FC6 ${r.m.supersedes}`, onClick: () => openMemory(r.m.supersedes), children: [
+                        "\u66FF\u4EE3 #",
+                        r.m.supersedes.slice(0, 8)
+                      ] })
                     ] }),
                     r.m.tags.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("div", { style: { marginTop: 3, display: "flex", flexWrap: "wrap", gap: 4 }, children: r.m.tags.map((tag) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { style: s2.tag, children: tag }, tag)) })
                   ] }),
@@ -3354,6 +3596,7 @@ ${r.m.text.slice(0, 60)}`)) void act(() => api.remove(r.m.id, r.m.workspace));
             tasks,
             nodes,
             links,
+            memories,
             onClose: () => setDetail(null),
             onNavigateMemory: openMemory,
             onChanged: () => void refresh()
@@ -3369,6 +3612,10 @@ var import_react8 = require("react");
 var import_jsx_runtime8 = require("react/jsx-runtime");
 var COMMON_FIELDS = [
   { key: "autoCapture", label: "\u81EA\u52A8\u6355\u83B7", hint: "\u96F6 LLM \u4ECE\u5DE5\u5177\u7ED3\u679C\u63D0\u53D6\u8BB0\u5FC6\uFF08git/\u5173\u952E\u6587\u4EF6/\u9519\u8BEF\uFF09", kind: "bool" },
+  { key: "autoCapturePreferences", label: "\u504F\u597D\u6355\u83B7", hint: "\u7528\u6237\u7EA0\u6B63/\u504F\u597D\u5B66\u4E60\uFF1A\u68C0\u6D4B\u6D88\u606F\u91CC\u7684\u300C\u4E0D\u8981\u7528X/\u6539\u7528Y/prefer/never use\u300D\u53E5\u5F0F\uFF0C\u81EA\u52A8\u6C89\u6DC0\u4E3A preference \u8BB0\u5FC6\u5E76\u7F6E\u9876 [ENGRAM]\uFF08correx/PAHF \u5F0F\uFF0C\u96F6 LLM\uFF09", kind: "bool" },
+  { key: "boundaryPrune", label: "\u8FB9\u754C\u526A\u679D", hint: "ResultPack L1\uFF1Atodo \u5B8C\u6210/goal \u7EC8\u6001\u8FB9\u754C\u4E3B\u52A8\u526A\u6389\u8D85\u9608\u503C\u65E7\u5DE5\u5177\u7ED3\u679C\uFF08DSH \u786E\u5B9A\u6027 surface-replace\u3001\u507F\u8FD8\u95E8\u3001\u96F6 LLM\uFF1B\u9ED8\u8BA4\u5173\uFF09", kind: "bool" },
+  { key: "boundaryPruneThresholdChars", label: "\u526A\u679D\u9608\u503C(\u5B57\u7B26)", hint: "\u8986\u76D6\u5BBF\u4E3B 8192\uFF1A\u8BBE 2048 \u53EF\u66F4\u65E9\u5F00\u526A\uFF0C\u5E76\u914D L2 \u5F52\u6863\u627E\u56DE\u88AB\u526A\u4E2D\u6BB5\uFF1B\u7559\u7A7A=\u5BBF\u4E3B\u9ED8\u8BA4\u3002\u5EFA\u8BAE\u540C\u65F6\u628A\u4FDD\u7559\u8FB9\u7F18\u8C03\u5C0F\uFF08\u5982 1024/256\uFF09\u4EE5\u83B7\u5F97\u6700\u5927\u8282\u7701", kind: "num", min: 256, max: 16384, step: 256 },
+  { key: "resultPack", label: "\u7ED3\u679C\u5F52\u6863\u53EC\u56DE", hint: "ResultPack L2\uFF1A\u526A\u6389\u7684\u4E2D\u6BB5\u8131\u654F\u5F52\u6863\uFF0C\u8282\u70B9\u5C3E\u90E8\u9644 handle\uFF0C\u6A21\u578B\u53EF\u7528 result_recall(callId) \u6309\u9875\u53EC\u56DE\uFF08\u5B8C\u6574 ObservationPack\uFF1B\u9700\u4E0E\u8FB9\u754C\u526A\u679D\u4E00\u8D77\u5F00\uFF09", kind: "bool" },
   { key: "autoRecallOnStart", label: "\u4F1A\u8BDD\u542F\u52A8\u81EA\u52A8\u53EC\u56DE", hint: "\u65B0\u4F1A\u8BDD\u6309\u9996\u6761\u6D88\u606F\u81EA\u52A8\u628A\u6700\u76F8\u5173\u8BB0\u5FC6\u6CE8\u5165 [RECALL] \u5757\uFF08\u65E0\u9700\u6A21\u578B\u60F3\u8D77\u8C03 engram_recall\uFF09\uFF1B\u5173\u6389=\u56DE\u5230\u7EAF\u62C9\u53D6", kind: "bool" },
   { key: "maxRecallPerSession", label: "\u6BCF\u4F1A\u8BDD\u53BB\u91CD\u4E0A\u9650", hint: "recall \u6BCF\u4F1A\u8BDD\u6700\u591A\u4FDD\u7559 N \u6761\uFF08\u8DE8\u4F1A\u8BDD\u53BB\u91CD\uFF09", kind: "num", min: 1, max: 10 },
   { key: "expireDays", label: "TTL\uFF08\u5929\uFF09", hint: "0 = \u4E0D\u8FC7\u671F", kind: "num", min: 0, max: 3650 },
@@ -3381,6 +3628,9 @@ var ADVANCED_GROUPS = [
     description: "\u5176\u4F59\u6355\u83B7/\u641C\u7D22\u65CB\u94AE",
     fields: [
       { key: "autoCapturePerSession", label: "\u6BCF\u4F1A\u8BDD\u6355\u83B7\u4E0A\u9650", hint: "\u5355\u4F1A\u8BDD\u81EA\u52A8\u6355\u83B7\u6761\u6570\u4E0A\u9650", kind: "num", min: 0, max: 1e3 },
+      { key: "boundaryPruneHeadChars", label: "\u526A\u679D\u4FDD\u7559\u5934\u90E8(\u5B57\u7B26)", hint: "\u9608\u503C\u8986\u76D6\u751F\u6548\u65F6\u7ED3\u679C\u5F00\u5934\u4FDD\u7559\u957F\u5EA6\uFF08\u9ED8\u8BA4 4096\uFF09\uFF1B\u8C03\u5C0F\uFF08\u5982 1024\uFF09\u914D\u5408 T2048 \u66F4\u7701", kind: "num", min: 0, max: 16384, step: 128 },
+      { key: "boundaryPruneTailChars", label: "\u526A\u679D\u4FDD\u7559\u5C3E\u90E8(\u5B57\u7B26)", hint: "\u9608\u503C\u8986\u76D6\u751F\u6548\u65F6\u7ED3\u679C\u7ED3\u5C3E\u4FDD\u7559\u957F\u5EA6\uFF08\u9ED8\u8BA4 1024\uFF09\uFF1B\u8C03\u5C0F\uFF08\u5982 256\uFF09\u914D\u5408 T2048 \u66F4\u7701", kind: "num", min: 0, max: 16384, step: 128 },
+      { key: "boundaryPruneIdleCadence", label: "\u7A7A\u95F2\u6B65\u6570\u8FB9\u754C", hint: "\u6700\u591A\u6BCF N \u8BF7\u6C42\u89E6\u53D1\u4E00\u6B21\u526A\u679D\uFF0C\u8986\u76D6\u65E0 todo/goal \u7684\u4F1A\u8BDD\uFF08\u7EA6 62% \u4F1A\u8BDD\uFF09\uFF1B\u4ECD\u53D7\u507F\u8FD8\u95E8\u7EA6\u675F\uFF1B\u7559\u7A7A=\u4EC5\u4E8B\u4EF6\u8FB9\u754C", kind: "num", min: 10, max: 1e3, step: 10 },
       { key: "autoRecallLimit", label: "\u81EA\u52A8\u53EC\u56DE\u6761\u6570", hint: "[RECALL] \u5757\u6700\u591A\u6CE8\u5165\u7684\u8BB0\u5FC6\u6761\u6570\uFF08\u5C11\u800C\u51C6\uFF09", kind: "num", min: 1, max: 8 },
       { key: "sessionSearch", label: "\u4F1A\u8BDD\u5386\u53F2\u641C\u7D22", hint: "engram_recall \u652F\u6301\u8DE8\u4F1A\u8BDD FTS \u515C\u5E95", kind: "bool" },
       { key: "recallScope", label: "\u53EC\u56DE\u8303\u56F4", hint: "workspace=\u4E25\u683C\u5F53\u524D\u5DE5\u4F5C\u533A\u9694\u79BB\uFF08\u9ED8\u8BA4\uFF0Ctoken \u7EAA\u5F8B\uFF09\uFF1Bglobal=\u672C\u5DE5\u4F5C\u533A\u547D\u4E2D\u5F31/\u7A7A\u65F6\u4ECE\u5176\u5B83\u5DE5\u4F5C\u533A\u6C60\u53EC\u56DE\u5E76\u6807 [W:<workspace>] \u6765\u6E90\uFF08\u4F1A\u6253\u7834\u9694\u79BB\uFF09", kind: "select", options: ["workspace", "global"] }