@modusensus/dsh-mneme 0.6.11 → 0.7.1

package/{test → dsh-mneme/test}/tag.test.js

@@ -12,6 +12,7 @@ import { join } from "node:path";
 import { createStore } from "../src/store.js";
 import { createService } from "../src/service.js";
 import { createMirror } from "../src/mirror.js";
+import { createSettings } from "../src/settings.js";
 import { parseTags, sanitizeTags, MAX_TAG_LENGTH } from "../src/parser/tag.js";
 import { runAutoTag } from "../src/dream/tag-extractor.js";
 import { createDreamScheduler } from "../src/dream.js";
@@ -310,3 +311,116 @@ test("service.setMemoryTags respects manualTagEnabled=false gate", () => {
   assert.equal(r.ok, false);
   assert.match(r.error, /manualTagEnabled/);
 });
+
+// ============================================================ issue #31 fixes
+
+test("memory_save with tags bridges into the entity_attrs tag store (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({
+    type: "project", title: "桥接", content: "c", tags: ["linux", "考研"]
+  });
+  assert.deepEqual(store.getMemoryTags(memory.id), ["linux", "考研"], "tool-passed tags land in entity_attrs");
+  assert.deepEqual(store.getMemoryTagsMap([memory.id]).get(memory.id), ["linux", "考研"], "tag map sees them");
+  const dir = store.getDirectory();
+  assert.deepEqual(dir.groups.map((g) => g.tag).sort(), ["linux", "考研"], "directory groups by tool-passed tags");
+  assert.equal(dir.untagged.length, 0, "not dumped in the untagged bucket");
+  assert.ok(store.findMemoriesByTags(["linux"]).some((m) => m.id === memory.id), "tag: recall finds it");
+  store.close();
+});
+
+test("saveWithDedupe merge with tags bridges into the tag store too (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({
+    type: "project", title: "同题", content: "第一段", tags: ["linux"]
+  });
+  assert.deepEqual(store.getMemoryTags(memory.id), ["linux"]);
+  const { action, memory: merged } = service.saveWithDedupe({
+    type: "project", title: "同题", content: "第二段", tags: ["bash"]
+  });
+  assert.equal(action, "merged");
+  assert.deepEqual(store.getMemoryTags(merged.id), ["bash"], "merge overwrites tags and bridges them");
+  store.close();
+});
+
+test("saveWithDedupe merge with empty tags clears stale entity_attrs tags (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({ type: "project", title: "清空", content: "第一段", tags: ["old"] });
+  assert.deepEqual(store.getMemoryTags(memory.id), ["old"]);
+  const { action, memory: merged } = service.saveWithDedupe({
+    type: "project", title: "清空", content: "第二段", tags: []
+  });
+  assert.equal(action, "merged");
+  assert.deepEqual(store.getMemoryTags(merged.id), [], "empty tags on merge invalidate the stale live row");
+  const dir = store.getDirectory();
+  assert.equal(dir.groups.length, 0, "directory no longer shows the stale tag");
+  assert.equal(dir.untagged.length, 1, "memory back to untagged");
+  store.close();
+});
+
+test("memory_update (service.update) with tags bridges and clearing moves to untagged (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({ type: "project", title: "更新", content: "c", tags: ["old"] });
+  const updated = service.update(memory.id, { tags: ["new", "考研"] });
+  assert.deepEqual(store.getMemoryTags(updated.id), ["new", "考研"], "update bridges new tags");
+  assert.ok(store.getDirectory().groups.some((g) => g.tag === "new"), "directory reflects update tags");
+  service.update(updated.id, { tags: [] });
+  assert.deepEqual(store.getMemoryTags(updated.id), [], "clearing removes the live row");
+  const dir = store.getDirectory();
+  assert.equal(dir.groups.length, 0, "no tag groups after clearing");
+  assert.equal(dir.untagged.length, 1, "memory back to untagged");
+  store.close();
+});
+
+test("setMemoryTags keeps the memories.tags column in sync with entity_attrs (issue #31)", () => {
+  const { store, service } = makeService();
+  const { memory } = service.saveWithDedupe({ type: "project", title: "列同步", content: "c" });
+  service.setMemoryTags(memory.id, ["linux"]);
+  assert.deepEqual(store.getById(memory.id).tags, ["linux"], "column mirrors the live tag row");
+  service.setMemoryTags(memory.id, []);
+  assert.deepEqual(store.getById(memory.id).tags, [], "clearing also clears the column");
+  store.close();
+});
+
+test("runDream auto-tag respects the settings toggle over plugin config (issue #31)", async () => {
+  const store = createStore(":memory:");
+  const settings = createSettings(store.db);
+  settings.setAutoTagConfig({ autoTagEnabled: true });
+  // plugin config says auto-tagging is OFF; the settings toggle flips it on.
+  const service = createService({ store, mirror: null, config: { autoTagEnabled: false }, settings });
+  const a = service.saveWithDedupe({ type: "preference", title: "旧1", content: "第一段" }).memory;
+  const b = service.saveWithDedupe({ type: "preference", title: "旧2", content: "第二段" }).memory;
+  const keep = (id) => JSON.stringify([{ action: "keep", ids: [id] }]);
+  let calls = 0;
+  const ctx = {
+    llm: {
+      stream: async function* () {
+        calls++;
+        if (calls === 1) yield { type: "text-delta", text: keep(a.id) }; // consolidation
+        else if (calls === 2) yield { type: "text-delta", text: JSON.stringify([{ id: a.id, tags: ["内核"] }]) }; // auto-tag
+        else yield { type: "text-delta", text: "总览" }; // summary
+        yield { type: "finish", reason: { kind: "ok" } };
+      }
+    },
+    logger: { warn: () => {}, info: () => {} }
+  };
+  const dream = createDreamScheduler({ thresholdCount: 1, thresholdChars: 0, delayMs: 0 });
+  const result = await dream.runDream(ctx, service, {
+    dreamProvider: "deepseek", dreamModel: "deepseek-chat", autoTagEnabled: false
+  }, settings);
+  assert.equal(result.ok, true);
+  assert.deepEqual(store.getMemoryTags(a.id), ["内核"], "settings toggle enabled auto-tag despite config.autoTagEnabled=false");
+  store.close();
+});
+
+test("service.setMemoryTags manual gate follows the settings toggle (issue #31)", () => {
+  const store = createStore(":memory:");
+  const settings = createSettings(store.db);
+  settings.setAutoTagConfig({ manualTagEnabled: false });
+  const service = createService({ store, mirror: null, config: {}, settings });
+  const a = service.saveWithDedupe({ type: "preference", title: "Alpha", content: "正文" }).memory;
+  const r = service.setMemoryTags(a.id, ["linux"]);
+  assert.equal(r.ok, false, "settings gate blocks manual tagging");
+  assert.match(r.error, /manualTagEnabled/);
+  assert.equal(service.manualTagEnabled(), false, "gate flag reflects the settings override");
+  store.close();
+});

package/dsh-mneme/test/updated-at-semantics.test.js

@@ -0,0 +1,113 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { runSleep } from "../src/dream/sleep.js";
+import { createStore } from "../src/store.js";
+import { createService } from "../src/service.js";
+
+// v0.7.0 语义修正（待办④ updated_at 不算访问）：
+//  - merge/update 刷 updated_at 绝不当访问，last_accessed_at 与 updated_at 正交；
+//  - sleep 降级 ref 只用 last_accessed_at ?? created_at，杜绝 autoDream 合并
+//    动作把"刚更新过内容"伪装成"刚被召回"；
+//  - 触达数据采集（touchRecalled）由 heatEnabled 控制，不再依赖 sleepModeEnabled。
+
+const DAY = 86400000;
+
+function setup(config = {}) {
+  const store = createStore(":memory:");
+  const service = createService({ store, mirror: null, config });
+  return { store, service };
+}
+
+function saveMemory(service, title, content, type = "project") {
+  return service.saveWithDedupe({ type, title, content, importance: 3 }).memory;
+}
+
+test("store.update bumps updated_at but never last_accessed_at", () => {
+  const { store, service } = setup();
+  const mem = saveMemory(service, "项目A", "状态：进行中");
+  assert.equal(mem.last_accessed_at, undefined, "saved memory has no last_accessed_at");
+
+  const touched = service.touchLastAccess(mem.id, new Date(Date.now() - 5 * DAY).toISOString());
+  assert.equal(touched, true, "explicit touch succeeds");
+  const afterTouch = store.getById(mem.id);
+  assert.ok(afterTouch.last_accessed_at, "last_accessed_at set after touch");
+
+  const updatedAtBefore = afterTouch.updated_at;
+  store.update(mem.id, { content: "状态：已交付" });
+  const afterUpdate = store.getById(mem.id);
+  assert.notEqual(afterUpdate.updated_at, updatedAtBefore, "updated_at changed by update");
+  assert.equal(
+    afterUpdate.last_accessed_at,
+    afterTouch.last_accessed_at,
+    "last_accessed_at untouched by update (content change ≠ access)"
+  );
+  store.close();
+});
+
+test("search bumps last_accessed_at by default (heatEnabled on) and is gated off by heatEnabled=false", async () => {
+  // Default config: heatEnabled 默认开 → last_accessed_at 被采集（与 sleep 开关解耦）。
+  const a = setup();
+  saveMemory(a.service, "量子计算", "入门");
+  await a.service.searchMemories("量子", { mode: "keyword" });
+  const rowA = a.store.getById(a.service.all()[0].id);
+  assert.ok(rowA.last_accessed_at, "touch runs with heatEnabled default on even when sleepModeEnabled off");
+  a.store.close();
+
+  // heatEnabled=false → 热路径零写入。
+  const b = setup({ heatEnabled: false });
+  saveMemory(b.service, "量子计算", "入门");
+  await b.service.searchMemories("量子", { mode: "keyword" });
+  const rowB = b.store.getById(b.service.all()[0].id);
+  assert.equal(rowB.last_accessed_at, undefined, "no touch when heatEnabled=false");
+  b.store.close();
+});
+
+test("sleep demotion anchors on last_accessed_at — a merge-bumped updated_at does not reset the fresh clock", async () => {
+  const { store, service } = setup();
+  const now = Date.now();
+  const idle = saveMemory(service, "冷查记忆A", "很久没被召回");
+  // 模拟一次 autoDream 合并：updated_at 刷成"现在"，但真实访问在 100 天前。
+  store.update(idle.id, { content: "合并带来的内容更新" });
+  const wait = saveMemory(service, "冷查记忆B", "40 天未访问");
+
+  service.touchLastAccess(idle.id, new Date(now - 100 * DAY).toISOString());
+  service.touchLastAccess(wait.id, new Date(now - 40 * DAY).toISOString());
+
+  // runSleep 的最低配置：demotion 阶段不需要 LLM/语义，其余阶段会 skip。
+  const ctx = {
+    logger: { warn: () => {}, info: () => {} },
+    agentDefaultModel: { currentSelection: () => ({ provider: "mock", model: "sleep-model" }) },
+    llm: {
+      async *stream() {
+        yield { type: "text-delta", index: 0, text: "[]" };
+        yield { type: "finish", reason: { kind: "stop" } };
+      }
+    }
+  };
+  const config = {
+    sleepModeEnabled: true,
+    sleepConflictStrictness: "normal",
+    sleepArchiveDays: 30,
+    sleepCompressDays: 90,
+    sleepPatternMinMemories: 100,
+    sleepMaxPatternPerRun: 3,
+    // v0.7.0 热联合判定：project λ=0.0008 默认太慢衰减，40/100 天热值都高于
+    // 阈值、被热闸保护——本测试只验证"updated_at 不算访问"的 ref 语义，故把
+    // λ 调快到 0.02 打开降级路径（默认保守语义由 sleep-heat.test.js 覆盖）。
+    heatTypeDecay: { project: 0.02 }
+  };
+
+  const result = await runSleep(ctx, service, config, { warn: () => {}, info: () => {} }, null, null);
+
+  const demotion = result.phases?.["demotion"];
+  assert.ok(demotion, "demotion phase ran");
+  // A：last_accessed 100 天前（即使 updated_at 是"现在"）→ 越过 90 天归档线。
+  assert.ok(demotion.archived.includes(idle.id), "A archived by last_accessed_at (updated_at ignored)");
+  const afterA = store.getById(idle.id);
+  assert.equal(afterA.archived, true, "A is archived in store");
+  // B：last_accessed 40 天前 → 进入 30 天压缩窗口，被降级为摘要。
+  assert.ok(demotion.demoted.includes(wait.id), "B demoted in 30d compress window");
+  const afterB = store.getById(wait.id);
+  assert.ok(afterB._full_content, "B full body parked in _full_content");
+  store.close();
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@modusensus/dsh-mneme",
-  "description": "Cross-session memory plugin for DeepSeek Harness with autoDream consolidation: SQLite store, Markdown mirrors, 7 model tools, automatic injection, session summarization, user profile/rules, custom slash commands, vector (semantic) search, and a Web GUI panel",
-  "version": "0.6.11",
+  "version": "0.7.1",
+  "description": "Structured memory engine for DeepSeek Harness. Offline semantic search, entity-attribute-timeline, autoDream self-consolidation, and human-editable Markdown storage.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -12,23 +12,16 @@
     "url": "https://github.com/modusensus/dsh-mneme/issues"
   },
   "type": "module",
-  "main": "lib/index.js",
+  "main": "./dsh-mneme/lib/index.js",
   "exports": {
     ".": {
-      "default": "./lib/index.js"
+      "default": "./dsh-mneme/lib/index.js"
     },
     "./client": {
-      "default": "./lib/client.js"
+      "default": "./dsh-mneme/lib/client.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./dsh-mneme/package.json"
   },
-  "files": [
-    "lib",
-    "src",
-    "scripts",
-    "test",
-    "cordis.patch.yml"
-  ],
   "dsh": {
     "client": {
       "inject": [
@@ -40,9 +33,20 @@
       "platform": "web"
     },
     "bundle": {
-      "patch": "./cordis.patch.yml"
+      "patch": "./dsh-mneme/cordis.patch.yml"
+    },
+    "marketplace": {
+      "profiles": [
+        "web"
+      ],
+      "requiresBuildApproval": false,
+      "requiresRestart": true,
+      "manualSteps": false
     }
   },
+  "scripts": {
+    "prepublishOnly": "node -e \"const fs=require('fs');const v=JSON.parse(fs.readFileSync('./dsh-mneme/package.json','utf8')).version;const p=JSON.parse(fs.readFileSync('./package.json','utf8'));p.version=v;fs.writeFileSync('./package.json',JSON.stringify(p,null,2)+'\\n')\""
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
@@ -50,31 +54,5 @@
     "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
     "@deepseek-ai/schemastery": "^3.18.1"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/schemastery": "^3.18.1",
-    "c8": "^12.0.0"
-  },
-  "scripts": {
-    "sync": "node scripts/sync-lib.js",
-    "prepack": "npm run sync",
-    "test": "node --test test/*.test.js",
-    "test:coverage": "c8 node --test test/*.test.js",
-    "e2e": "node scripts/e2e-dsh.js",
-    "stress": "node scripts/stress-dsh.js"
-  },
-  "dependencies": {
-    "@huggingface/transformers": "^4.2.0"
-  },
-  "overrides": {
-    "adm-zip": "0.6.0"
-  },
-  "c8": {
-    "reporter": ["text", "lcov"]
   }
 }

package/v0.7-plan-2026-08-21.md

@@ -0,0 +1,75 @@
+# dsh-mneme v0.7 版本策划书 + 分工安排（2026-08-21）
+
+> 状态：**待桉桉过目** → 通过后**晚上错峰执行**（兼顾火山 coding plan ~1200 次/5 小时额度，分阶段推进，不在同一时段烧光）。
+> 当前版本：v0.6.6（710 全绿）。本策划基于 README 路线图 + Discussion #21 + 社区 heptaspirit 调研（`docs/AGENT_MEMORY_RESEARCH.md`，已归档为 v0.7 参考输入）。
+
+---
+
+## 一、版本定位（调整：v0.7 不着急，先做 v0.6.7）
+
+**近期先做：v0.6.7 —— Issue #20 面板删除按钮**（兑现对社区 lqs50 的承诺，快速小版本）。
+
+**v0.7 主题：自进化记忆（heat 热度 + 兴趣漂移）—— 桉桉 2026-08-21 拍板：不着急，列为远期**，先把 v0.6.x 的欠账收干净再说。
+
+一句话：v0.7 让记忆库不只是"存得准、召得回"，还能**根据访问热度自我衰减、识别兴趣漂移、降级冷记忆**，进化为会"进化"的记忆体。核心来自 #21（简化幂律 + type 差异化半衰期），社区调研补足数据前提与图谱增强。
+
+**复用承接（不引入新依赖/新概念）：** 全部落在现有 `recall_runs` 表 / `TYPE_DECAY` / sleep 批处理 / `entity_attrs` valid_from-until / api.js 的 ego-BFS 上。图数据库（Neo4j/Graphiti）明确不做——SQLite 递归 CTE 实测够用。
+
+---
+
+## 二、范围拆分
+
+### v0.6.7 —— Issue #20 记忆面板删除按钮（近期，优先做）
+| # | 功能 | 说明 | 承接机制 |
+|---|------|------|----------|
+| ⭐1 | **面板删除按钮** | 记忆库界面**直接删除自己不需要的记忆**（社区 lqs50 提，issue #20 仍 OPEN）。后端 storage/`memory_delete` 工具已有 → **补一个面板 HTTP DELETE 端点 + 前端「选中删除」按钮**（永久删除带二次确认；可挂到目录 view / 详情页）| store.deleteMemory + api.js + 面板 |
+- **验收：** 全绿；面板可选中删除记忆（含目录视图入口）；**收掉 issue #20** 并回帖致谢 lqs50。
+- **依赖关系：** 独立小版本，不需要等 v0.7。夜间一个窗口即可完成。
+
+### v0.7.0 —— heat 热度 + 兴趣漂移核心（远期，⏸ 不着急）
+| # | 功能 | 说明 | 承接机制 |
+|---|------|------|----------|
+| 1 | **heat 模型** | 简化幂律衰减 + `TYPE_DECAY`（type 差异化半衰期）；**公式预留信号接口**（新列/metadata，以后加多信号是增量不重构）| #21 已定方向 |
+| 2 | **recall_runs 数据前提** | 记录**默认开、消费默认关**；candidates 打 **`injected` 标记**（区分"被召回"vs"被注入上下文"两个强度）；**90 天滚动清理**防膨胀 | recall_runs / touchRecalled |
+| 3 | **sleep 降级联合判定** | 现状 30/90 天硬阈值不看 importance/type，高价值 preference 也会被降级 → 改为 `heat<阈值 && importance<5 && type 非免疫`，双保护，仍以时间为主 | sleep 批处理 / archived |
+| 4 | **updated_at 不算访问** | 合并/更新刷 updated_at 不应计为访问，防 autoDream 合并动作干扰新鲜度 | 时间戳语义修正 |
+| 5 | **heat 投影实体层** | 实体热 = 关联记忆 heat 聚合；ego-graph 前端节点大小/明暗随热变化，兴趣漂移**在图上可见**（成本≈0，heat 本就 v0.7 改）| entities 表 + 前端 |
+- **验收：** 全绿（目标 710 → 740+）；heat 全部 opt-in（`heatEnabled` 默认保守开启、不破坏现有）。
+- **状态：** ⏸ 桉桉拍板不着急，先做完 v0.6.x 收尾再启动。
+
+### v0.7.1 —— 图谱数据积累 + 检索/关系增强（次轮）
+| # | 功能 | 说明 | 承接机制 |
+|---|------|------|----------|
+| 6 | **实体提取移入 sleep 批量** | 写入路径实时抽实体成本高 → 挪进 sleep 批量，**写入路径零 LLM 成本**；代价是图谱滞后一个 sleep 周期（长期关系网无感）| sleep LLM 阶段模式 |
+| 7 | **sleep 批量实体消歧** | extractor 目前不合并同义词，全称/简称成孤立节点 → 仿 autoDream 的 winner/loser + 审计，或规则兜底（小写/去空格）| findEntityByName |
+| 8 | **1-hop 邻域回流检索** | `entity:X` 顺带召回相邻实体记忆——把图谱从"展示"变成"召回信号"（差异化价值）| api.js ego-BFS |
+| 9 | **关系时效** | `entity_relations` 补 `valid_until` + `superseded` 标记（不删只标，保留历史回溯），换方案后旧关系不一直挂着 | entity_attrs 的 valid_from/until 模式 |
+- **验收：** 全绿；图谱数据能攒起来，前端可见热投影。
+
+### 远期 / 等 DSH（不在本次做）
+- 跨 workspace 记忆共享（README v0.7.0+ 标注，**等 DSH 支持**）；多模态记忆（本地化定位冲突，排除）；参数化记忆 MemoryLLM（模型层路线，基本放弃）；图数据库/PPR/社区子图（CTE 够用，暂缓）。
+
+---
+
+## 三、分工安排（多模型协作，服从派发架构）
+
+| 角色 | 模型 | 负责 | 量级 |
+|------|------|------|------|
+| **协调 + 方案 + 把关** | qwen3.7-max | 拆任务、定义 heat 公式/TYPE_DECAY 表格/schema、每步评审整合 | 中 |
+| **核心代码 + 复杂测试** | kimi-k3 | heat 模型、sleep 降级判定、1-hop 回流、实体消歧、90 天清理等实现 + 全绿测试 | 高 |
+| **轻量校验/快检** | glm-4.5-air | 小步 diff 校验、配置项联动、回归抽查 | 低 |
+| **文档同步** | qwen3.6-plus | CHANGELOG + README 双表（root+子目录、中英），ROADMAP 状态对 | 低 |
+| **集成 + 发布** | 主模型（Ivresse） | 汇总、核验、**报桉桉批准后**发布；一次只发一个 sub-version | — |
+
+> 派发铁律：发布/改动前先征得桉桉许可；复杂编程/测试派 kimi-k3；REANME/CHANGELOG 根+子目录中英都要同步，避免漏改。
+
+## 四、执行节奏（错峰，尊重 ~1200 次/5 小时）
+- **窗口**：每晚 7 点后 / 周末，一次只推一个 sub-step（先 0.7.0，休息/量量再用 0.7.1）。
+- **每步收尾**：跑全绿 → 更新 CHANGELOG/README → 记 activeContext/progress → 停。
+- **不集中突发**：同一窗口不做超长连续生成，做完即停，额度留着。
+
+---
+
+## 五、待桉桉拍板（已定项已在文内标注）
+✅ 已定：**Issue #20 → v0.6.7**（快速兑现）；**v0.7.0 不着急**（远期，先收 v0.6.x 账）。
+> 剩下细节到真正开工前再定即可：heat 默认开/关、v0.7.0 与 v0.7.1 节奏。