@modusensus/dsh-mneme 0.8.14 → 0.8.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (279) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +660 -654
  3. package/assets/icon.svg +3 -3
  4. package/bin/cli.mjs +691 -689
  5. package/bin/dsh-mneme-mcp.mjs +510 -510
  6. package/bin/dsh-mneme-serve.mjs +151 -151
  7. package/cordis.patch.yml +21 -21
  8. package/docs/CONFIGURATION.md +275 -0
  9. package/docs/CONTINUITY.md +124 -0
  10. package/docs/DAEMON.md +46 -0
  11. package/docs/DISTILL.md +162 -0
  12. package/docs/ENTITIES.md +245 -0
  13. package/docs/LOCAL_MODEL.md +222 -0
  14. package/docs/SEMANTIC.md +256 -0
  15. package/docs/SLEEP.md +164 -0
  16. package/docs/STORAGE.md +98 -0
  17. package/lib/api-standalone.js +656 -673
  18. package/lib/api.js +1605 -1433
  19. package/lib/bootstrap.js +211 -211
  20. package/lib/client.js +6354 -5296
  21. package/lib/commands.js +95 -95
  22. package/lib/config.js +947 -843
  23. package/lib/content-hash.js +54 -54
  24. package/lib/continuity.js +220 -220
  25. package/lib/document-index.js +94 -94
  26. package/lib/document.js +303 -303
  27. package/lib/dream/clustering.js +118 -118
  28. package/lib/dream/decisions.js +694 -674
  29. package/lib/dream/narratives.js +44 -44
  30. package/lib/dream/sleep.js +819 -819
  31. package/lib/dream.js +1503 -1501
  32. package/lib/embedding.js +177 -177
  33. package/lib/entities/extractor.js +252 -252
  34. package/lib/graph/anchoring.js +179 -179
  35. package/lib/guide.js +74 -74
  36. package/lib/heat.js +144 -144
  37. package/lib/hot-memory.js +108 -46
  38. package/lib/index.js +552 -503
  39. package/lib/inject.js +428 -450
  40. package/lib/lang.js +248 -229
  41. package/lib/local-embedder.js +358 -358
  42. package/lib/maintenance.js +162 -142
  43. package/lib/mirror.js +330 -330
  44. package/lib/organize.js +450 -450
  45. package/lib/peak-hours.js +117 -117
  46. package/lib/placement.js +13 -0
  47. package/lib/pre-inject-gate.js +340 -0
  48. package/lib/quality-filter.js +126 -126
  49. package/lib/recall-stats.js +190 -175
  50. package/lib/reclaim-http.js +150 -0
  51. package/lib/reranker.js +269 -269
  52. package/lib/runtime/adopt.js +176 -176
  53. package/lib/runtime/closure.js +172 -172
  54. package/lib/runtime/download.js +247 -247
  55. package/lib/runtime/layout.js +265 -265
  56. package/lib/runtime/loader.js +252 -252
  57. package/lib/runtime/model-fetch.js +361 -361
  58. package/lib/runtime/provision.js +237 -237
  59. package/lib/runtime/tarball.js +130 -130
  60. package/lib/runtime/verify.js +223 -204
  61. package/lib/safe-slice.js +18 -0
  62. package/lib/scope.js +146 -146
  63. package/lib/search/adaptive.js +60 -60
  64. package/lib/search/bm25.js +96 -96
  65. package/lib/semantic.js +229 -229
  66. package/lib/sensitive-scan.js +209 -209
  67. package/lib/serve.js +215 -215
  68. package/lib/service.js +2688 -2605
  69. package/lib/settings.js +528 -511
  70. package/lib/store.js +3196 -3007
  71. package/lib/summarize.js +1039 -856
  72. package/lib/tools.js +743 -737
  73. package/lib/vector-index.js +110 -110
  74. package/lib/version-check.js +122 -122
  75. package/lib/write-admission.js +402 -402
  76. package/locale/en.json +6 -6
  77. package/locale/zh.json +6 -6
  78. package/package.json +118 -118
  79. package/runtime-manifest.json +526 -526
  80. package/scripts/benchmark-embed.js +201 -201
  81. package/scripts/benchmark-recall.js +249 -249
  82. package/scripts/benchmark-rerank.js +166 -166
  83. package/scripts/build-runtime-manifest.mjs +224 -224
  84. package/scripts/changelog-prep.mjs +36 -36
  85. package/scripts/check-sync.js +42 -42
  86. package/scripts/e2e-dsh.js +220 -220
  87. package/scripts/mneme-runtime.mjs +277 -277
  88. package/scripts/stress-dsh.js +255 -255
  89. package/scripts/sync-lib.js +47 -47
  90. package/scripts/sync-test-badge.mjs +69 -69
  91. package/scripts/test-count-sync.mjs +44 -44
  92. package/src/api-standalone.js +656 -673
  93. package/src/api.js +1605 -1433
  94. package/src/bootstrap.js +211 -211
  95. package/src/commands.js +95 -95
  96. package/src/config.js +947 -843
  97. package/src/content-hash.js +54 -54
  98. package/src/continuity.js +220 -220
  99. package/src/document-index.js +94 -94
  100. package/src/document.js +303 -303
  101. package/src/dream/clustering.js +118 -118
  102. package/src/dream/decisions.js +694 -674
  103. package/src/dream/narratives.js +44 -44
  104. package/src/dream/sleep.js +819 -819
  105. package/src/dream.js +1503 -1501
  106. package/src/embedding.js +177 -177
  107. package/src/entities/extractor.js +252 -252
  108. package/src/graph/anchoring.js +179 -179
  109. package/src/guide.js +74 -74
  110. package/src/heat.js +144 -144
  111. package/src/hot-memory.js +108 -46
  112. package/src/index.js +552 -503
  113. package/src/inject.js +428 -450
  114. package/src/lang.js +248 -229
  115. package/src/local-embedder.js +358 -358
  116. package/src/maintenance.js +162 -142
  117. package/src/mirror.js +330 -330
  118. package/src/organize.js +450 -450
  119. package/src/peak-hours.js +117 -117
  120. package/src/placement.js +13 -0
  121. package/src/pre-inject-gate.js +340 -0
  122. package/src/quality-filter.js +126 -126
  123. package/src/recall-stats.js +190 -175
  124. package/src/reclaim-http.js +150 -0
  125. package/src/reranker.js +269 -269
  126. package/src/runtime/adopt.js +176 -176
  127. package/src/runtime/closure.js +172 -172
  128. package/src/runtime/download.js +247 -247
  129. package/src/runtime/layout.js +265 -265
  130. package/src/runtime/loader.js +252 -252
  131. package/src/runtime/model-fetch.js +361 -361
  132. package/src/runtime/provision.js +237 -237
  133. package/src/runtime/tarball.js +130 -130
  134. package/src/runtime/verify.js +223 -204
  135. package/src/safe-slice.js +18 -0
  136. package/src/scope.js +146 -146
  137. package/src/search/adaptive.js +60 -60
  138. package/src/search/bm25.js +96 -96
  139. package/src/semantic.js +229 -229
  140. package/src/sensitive-scan.js +209 -209
  141. package/src/serve.js +215 -215
  142. package/src/service.js +2688 -2605
  143. package/src/settings.js +528 -511
  144. package/src/store.js +3196 -3007
  145. package/src/summarize.js +1039 -856
  146. package/src/tools.js +743 -737
  147. package/src/vector-index.js +110 -110
  148. package/src/version-check.js +122 -122
  149. package/src/write-admission.js +402 -402
  150. package/test/adaptive-inject-budget.test.js +85 -85
  151. package/test/api-routes-gaps.test.js +899 -218
  152. package/test/api.test.js +1725 -1690
  153. package/test/audit.test.js +448 -448
  154. package/test/baseline-persist.test.js +248 -248
  155. package/test/benchmark.test.js +94 -94
  156. package/test/bootstrap.test.js +220 -220
  157. package/test/changelog-prep.test.js +60 -60
  158. package/test/client.test.js +1582 -1169
  159. package/test/clustering.test.js +100 -100
  160. package/test/commands.test.js +106 -106
  161. package/test/config.test.js +66 -66
  162. package/test/conflict-freeze.test.js +300 -300
  163. package/test/content-hash.test.js +204 -204
  164. package/test/continuity.test.js +333 -333
  165. package/test/contrast.test.js +314 -0
  166. package/test/document-dir.test.js +233 -233
  167. package/test/document.test.js +671 -671
  168. package/test/dream-archive-guardrail.test.js +116 -116
  169. package/test/dream-candidate-hybrid.test.js +281 -281
  170. package/test/dream-coverage-degrade.test.js +86 -86
  171. package/test/dream-failure-backoff.test.js +173 -173
  172. package/test/dream-merge-guardrail.test.js +219 -0
  173. package/test/dream-peak-hours.test.js +194 -194
  174. package/test/dream.test.js +1385 -1383
  175. package/test/embedding-ready.test.js +196 -196
  176. package/test/entities.test.js +627 -547
  177. package/test/entity-recall.test.js +179 -179
  178. package/test/epistemic.test.js +325 -325
  179. package/test/fnew-0112.test.js +311 -311
  180. package/test/fnew-03.test.js +422 -422
  181. package/test/graph-anchoring.test.js +184 -184
  182. package/test/graph-api.test.js +175 -175
  183. package/test/graph-inject-budget.test.js +103 -103
  184. package/test/graph-passive-confirm.test.js +91 -91
  185. package/test/graph-weight-evolution.test.js +104 -104
  186. package/test/heat.test.js +175 -175
  187. package/test/helpers/dream-mock.js +82 -82
  188. package/test/helpers/peer-worker.mjs +25 -25
  189. package/test/helpers/runtime-source.js +60 -60
  190. package/test/helpers/tar-builder.js +80 -80
  191. package/test/helpers/write-admission-samples.js +308 -308
  192. package/test/hot-memory.test.js +211 -145
  193. package/test/inject-content-cap.test.js +91 -91
  194. package/test/inject-first-round-bm25.test.js +89 -89
  195. package/test/inject-heat.test.js +77 -77
  196. package/test/inject-parent-gate.test.js +106 -106
  197. package/test/inject-pools.test.js +194 -194
  198. package/test/inject-recall.test.js +144 -105
  199. package/test/inject-rotation.test.js +161 -161
  200. package/test/inject.test.js +443 -420
  201. package/test/lang.test.js +87 -87
  202. package/test/lastrunat-persist.test.js +101 -101
  203. package/test/lib-smoke.test.js +96 -96
  204. package/test/llm-audit.test.js +696 -598
  205. package/test/llm-message-source.test.js +207 -207
  206. package/test/local-embedder.test.js +292 -292
  207. package/test/maintenance.test.js +501 -391
  208. package/test/mcp-stdio.test.js +385 -385
  209. package/test/mirror-dirty.test.js +424 -424
  210. package/test/mirror-edit-digest.test.js +187 -187
  211. package/test/mirror-generation.test.js +499 -499
  212. package/test/mirror-types.test.js +208 -208
  213. package/test/mirror.test.js +249 -249
  214. package/test/narrative-bars.test.js +162 -162
  215. package/test/organize.test.js +418 -418
  216. package/test/peer-blockers.test.js +193 -193
  217. package/test/placement.test.js +36 -0
  218. package/test/policy-epoch.test.js +259 -259
  219. package/test/pre-inject-gate.test.js +444 -0
  220. package/test/quality-filter.test.js +186 -186
  221. package/test/reasoning-effort.test.js +752 -752
  222. package/test/recall-anti-update.test.js +82 -82
  223. package/test/recall-evals.test.js +253 -253
  224. package/test/recall-layer.test.js +326 -326
  225. package/test/recall-stats.test.js +274 -189
  226. package/test/receipt-chain.test.js +451 -451
  227. package/test/reclaim-http.test.js +209 -0
  228. package/test/reflection.test.js +226 -226
  229. package/test/reindex-backfill.test.js +62 -62
  230. package/test/reranker-single-logit.test.js +73 -73
  231. package/test/reranker.test.js +197 -197
  232. package/test/resident-status.test.js +83 -83
  233. package/test/runtime-adopt.test.js +206 -206
  234. package/test/runtime-cli.test.js +89 -89
  235. package/test/runtime-closure.test.js +193 -193
  236. package/test/runtime-download.test.js +302 -302
  237. package/test/runtime-layout.test.js +163 -163
  238. package/test/runtime-loader.test.js +255 -255
  239. package/test/runtime-manifest.test.js +159 -159
  240. package/test/runtime-model-fetch.test.js +348 -348
  241. package/test/runtime-provision.test.js +101 -101
  242. package/test/runtime-tarball.test.js +81 -81
  243. package/test/runtime-verify.test.js +319 -279
  244. package/test/scope-candidates.test.js +239 -239
  245. package/test/scope-explicit.test.js +452 -452
  246. package/test/scope-inject-soft.test.js +106 -106
  247. package/test/scope-retrieval.test.js +197 -197
  248. package/test/scope-storage.test.js +255 -255
  249. package/test/scope-strict.test.js +367 -367
  250. package/test/search-fusion.test.js +90 -90
  251. package/test/semantic.test.js +124 -124
  252. package/test/sensitive-scan.test.js +207 -207
  253. package/test/serve-bin.test.js +121 -121
  254. package/test/serve.test.js +196 -196
  255. package/test/service-search.test.js +174 -174
  256. package/test/service.test.js +410 -405
  257. package/test/settings.test.js +269 -261
  258. package/test/skip-invalid-restore.test.js +262 -262
  259. package/test/sleep-action-set.test.js +422 -422
  260. package/test/sleep-heat.test.js +126 -126
  261. package/test/sleep-scheduler-rearm.test.js +89 -89
  262. package/test/sleep.test.js +527 -527
  263. package/test/standalone-api.test.js +751 -751
  264. package/test/store-vector-cache.test.js +98 -98
  265. package/test/store.test.js +504 -396
  266. package/test/stress.test.js +209 -209
  267. package/test/summarize-occurred-at.test.js +127 -0
  268. package/test/summarize-reasoning-effort.test.js +189 -189
  269. package/test/summarize.test.js +1639 -1465
  270. package/test/supersede-state-tracking.test.js +394 -0
  271. package/test/test-count-sync.test.js +60 -60
  272. package/test/tools-dto-schema-matrix.test.js +325 -325
  273. package/test/tools-memory-get-schema.test.js +65 -65
  274. package/test/tools.test.js +428 -374
  275. package/test/updated-at-semantics.test.js +113 -113
  276. package/test/vector-index.test.js +221 -221
  277. package/test/version-check.test.js +152 -152
  278. package/test/webServer-optional.test.js +82 -82
  279. package/test/write-admission.test.js +668 -668
@@ -1,145 +1,211 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { createHotMemory, estimateTokens } from "../src/hot-memory.js";
4
- import { createStore } from "../src/store.js";
5
- import { createService } from "../src/service.js";
6
- import { createVectorIndex } from "../src/vector-index.js";
7
-
8
- // --- hot memory buffer ---
9
-
10
- test("hot memory keeps the latest rounds within maxRounds", () => {
11
- const hot = createHotMemory({ maxRounds: 2, maxTokens: 10000 });
12
- hot.add({ query: "第一轮", response: "答一" });
13
- hot.add({ query: "第二轮", response: "答二" });
14
- hot.add({ query: "第三轮", response: "答三" });
15
- assert.equal(hot.rounds().length, 2);
16
- assert.ok(hot.getContext().includes("第三轮"));
17
- assert.ok(!hot.getContext().includes("第一轮"));
18
- });
19
-
20
- test("hot memory enforces the token budget", () => {
21
- const hot = createHotMemory({ maxRounds: 10, maxTokens: 30 });
22
- hot.add({ query: "很长的第一轮问题".repeat(10), response: "很长的回答".repeat(10) });
23
- hot.add({ query: "第二轮", response: "答二" });
24
- // The first round alone blows the budget; the newest round survives and
25
- // the buffer never empties completely.
26
- const rounds = hot.rounds();
27
- assert.ok(rounds.length >= 1);
28
- assert.equal(rounds[rounds.length - 1].query, "第二轮");
29
- });
30
-
31
- test("hot memory getContext uses the Q/A round format", () => {
32
- const hot = createHotMemory({ maxRounds: 5, maxTokens: 10000 });
33
- hot.add({ query: "Q1", response: "A1" });
34
- hot.add({ query: "Q2", response: "A2" });
35
- assert.equal(hot.getContext(), "Q: Q1\nA: A1\n\nQ: Q2\nA: A2");
36
- });
37
-
38
- test("hot memory ignores empty rounds and clears", () => {
39
- const hot = createHotMemory({ maxRounds: 5, maxTokens: 10000 });
40
- hot.add({ query: "", response: "x" });
41
- hot.add(null);
42
- assert.equal(hot.rounds().length, 0);
43
- hot.add({ query: "q" });
44
- hot.clear();
45
- assert.equal(hot.getContext(), "");
46
- });
47
-
48
- test("estimateTokens counts CJK heavier than ASCII", () => {
49
- assert.ok(estimateTokens("中文内容") > estimateTokens("abcd"));
50
- });
51
-
52
- // --- service-level: BM25 fusion + semantic dedup + selective injection ---
53
-
54
- function toyVec(text) {
55
- const v = new Array(64).fill(0);
56
- for (const t of String(text).toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean)) {
57
- let h = 0;
58
- for (const ch of t) h = (h * 31 + ch.codePointAt(0)) >>> 0;
59
- v[h % 64] += 1;
60
- }
61
- const norm = Math.sqrt(v.reduce((s, x) => s + x * x, 0)) || 1;
62
- return v.map((x) => x / norm);
63
- }
64
-
65
- function setup(overrides = {}) {
66
- const store = createStore(":memory:");
67
- const config = {
68
- entitySearchEnabled: false,
69
- bm25SearchEnabled: true,
70
- adaptiveThresholdEnabled: false,
71
- searchSemanticDedup: true,
72
- selectiveInjectEnabled: true,
73
- ...overrides
74
- };
75
- const service = createService({ store, mirror: null, config, logger: null });
76
- service.setVectorIndex(createVectorIndex({ store, logger: null }));
77
- service.setEmbedder({ embedSingle: async (t) => toyVec(t) });
78
- return { store, service };
79
- }
80
-
81
- test("searchMemories fuses BM25: scattered-term queries recall both rows", async () => {
82
- const { store, service } = setup();
83
- const a = store.save({ type: "project", title: "异步并发模式", content: "async runtime 选用 tokio", importance: 3 });
84
- const b = store.save({ type: "decision", title: "语言迁移", content: "编译模块迁移到 Rust", importance: 3 });
85
- store.save({ type: "project", title: "无关", content: "夜间 ETL 脚本", importance: 3 });
86
-
87
- // "rust 异步" is not a substring of either row — LIKE misses both; BM25
88
- // must surface both rows in the merged result.
89
- const results = await service.searchMemories("rust 异步", { mode: "auto", topK: 5 });
90
- const ids = results.map((r) => r.id);
91
- assert.ok(ids.includes(a.id), "async row must be recalled via BM25");
92
- assert.ok(ids.includes(b.id), "rust row must be recalled via BM25");
93
- assert.equal(results.find((r) => r.id === a.id)?.source, "bm25");
94
- });
95
-
96
- test("bm25SearchEnabled=false restores the two-path behavior", async () => {
97
- const { store, service } = setup({ bm25SearchEnabled: false });
98
- const a = store.save({ type: "project", title: "异步并发模式", content: "async runtime 选用 tokio", importance: 3 });
99
- const results = await service.searchMemories("rust 异步", { mode: "auto", topK: 5 });
100
- assert.ok(!results.some((r) => r.id === a.id), "no BM25 → scattered-term miss is back");
101
- });
102
-
103
- test("search-time semantic dedup drops near-identical embeddings", async () => {
104
- const { store, service } = setup();
105
- const a = store.save({ type: "project", title: "偏好 A", content: "用户喜欢深色主题编辑器", importance: 3 });
106
- const b = store.save({ type: "project", title: "偏好 A 备份", content: "用户喜欢深色主题编辑器(备份)", importance: 3 });
107
- store.setEmbedding(a.id, toyVec("用户喜欢深色主题编辑器"));
108
- store.setEmbedding(b.id, toyVec("用户喜欢深色主题编辑器"));
109
-
110
- // auto (not keyword): keyword mode is the documented text-only path and is
111
- // exempt from dedup by design; auto exercises the dedup the way production
112
- // searches run.
113
- const results = await service.searchMemories("深色主题", { mode: "auto", topK: 5 });
114
- const ids = results.map((r) => r.id);
115
- assert.ok(ids.includes(a.id) !== ids.includes(b.id), "one of the near-duplicate pair is dropped");
116
- });
117
-
118
- test("searchSemanticDedup=false keeps duplicate embeddings", async () => {
119
- const { store, service } = setup({ searchSemanticDedup: false });
120
- const a = store.save({ type: "project", title: "偏好 A", content: "用户喜欢深色主题编辑器", importance: 3 });
121
- const b = store.save({ type: "project", title: "偏好 A 备份", content: "用户喜欢深色主题编辑器(备份)", importance: 3 });
122
- store.setEmbedding(a.id, toyVec("用户喜欢深色主题编辑器"));
123
- store.setEmbedding(b.id, toyVec("用户喜欢深色主题编辑器"));
124
- const results = await service.searchMemories("深色主题", { mode: "keyword", topK: 5 });
125
- assert.equal(results.length, 2);
126
- });
127
-
128
- test("selective injection re-orders candidates by query similarity", () => {
129
- const { store, service } = setup();
130
- const thesis = store.save({ type: "project", title: "湿地论文", content: "毕业论文研究城市湿地公园", importance: 5 });
131
- const plugin = store.save({ type: "project", title: "插件项目", content: "dsh-mneme 记忆插件开发", importance: 5 });
132
- store.setEmbedding(thesis.id, toyVec("毕业论文研究城市湿地公园"));
133
- store.setEmbedding(plugin.id, toyVec("dsh-mneme 记忆插件开发"));
134
-
135
- // Rule-based order would put both at equal importance; the query vector is
136
- // about the thesis, so topic ranking must put the thesis memory first.
137
- const picked = service.injectCandidates({
138
- query: "论文写作",
139
- queryVector: toyVec("毕业论文研究城市湿地公园"),
140
- maxItems: 2,
141
- threshold: 3
142
- });
143
- assert.equal(picked[0].id, thesis.id);
144
- assert.ok(picked.some((m) => m.id === plugin.id));
145
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { createHotMemory, estimateTokens, roundsFromEvents } from "../src/hot-memory.js";
4
+ import { createStore } from "../src/store.js";
5
+ import { createService } from "../src/service.js";
6
+ import { createVectorIndex } from "../src/vector-index.js";
7
+
8
+ // --- hot memory buffer ---
9
+
10
+ test("hot memory keeps the latest rounds within maxRounds", () => {
11
+ const hot = createHotMemory({ maxRounds: 2, maxTokens: 10000 });
12
+ hot.add({ query: "第一轮", response: "答一" });
13
+ hot.add({ query: "第二轮", response: "答二" });
14
+ hot.add({ query: "第三轮", response: "答三" });
15
+ assert.equal(hot.rounds().length, 2);
16
+ assert.ok(hot.getContext().includes("第三轮"));
17
+ assert.ok(!hot.getContext().includes("第一轮"));
18
+ });
19
+
20
+ test("hot memory enforces the token budget", () => {
21
+ const hot = createHotMemory({ maxRounds: 10, maxTokens: 30 });
22
+ hot.add({ query: "很长的第一轮问题".repeat(10), response: "很长的回答".repeat(10) });
23
+ hot.add({ query: "第二轮", response: "答二" });
24
+ // The first round alone blows the budget; the newest round survives and
25
+ // the buffer never empties completely.
26
+ const rounds = hot.rounds();
27
+ assert.ok(rounds.length >= 1);
28
+ assert.equal(rounds[rounds.length - 1].query, "第二轮");
29
+ });
30
+
31
+ test("hot memory getContext uses the Q/A round format", () => {
32
+ const hot = createHotMemory({ maxRounds: 5, maxTokens: 10000 });
33
+ hot.add({ query: "Q1", response: "A1" });
34
+ hot.add({ query: "Q2", response: "A2" });
35
+ assert.equal(hot.getContext(), "Q: Q1\nA: A1\n\nQ: Q2\nA: A2");
36
+ });
37
+
38
+ test("hot memory ignores empty rounds and clears", () => {
39
+ const hot = createHotMemory({ maxRounds: 5, maxTokens: 10000 });
40
+ hot.add({ query: "", response: "x" });
41
+ hot.add(null);
42
+ assert.equal(hot.rounds().length, 0);
43
+ hot.add({ query: "q" });
44
+ hot.clear();
45
+ assert.equal(hot.getContext(), "");
46
+ });
47
+
48
+ test("estimateTokens counts CJK heavier than ASCII", () => {
49
+ assert.ok(estimateTokens("中文内容") > estimateTokens("abcd"));
50
+ });
51
+
52
+ // --- service-level: BM25 fusion + semantic dedup + selective injection ---
53
+
54
+ function toyVec(text) {
55
+ const v = new Array(64).fill(0);
56
+ for (const t of String(text).toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean)) {
57
+ let h = 0;
58
+ for (const ch of t) h = (h * 31 + ch.codePointAt(0)) >>> 0;
59
+ v[h % 64] += 1;
60
+ }
61
+ const norm = Math.sqrt(v.reduce((s, x) => s + x * x, 0)) || 1;
62
+ return v.map((x) => x / norm);
63
+ }
64
+
65
+ function setup(overrides = {}) {
66
+ const store = createStore(":memory:");
67
+ const config = {
68
+ entitySearchEnabled: false,
69
+ bm25SearchEnabled: true,
70
+ adaptiveThresholdEnabled: false,
71
+ searchSemanticDedup: true,
72
+ selectiveInjectEnabled: true,
73
+ ...overrides
74
+ };
75
+ const service = createService({ store, mirror: null, config, logger: null });
76
+ service.setVectorIndex(createVectorIndex({ store, logger: null }));
77
+ service.setEmbedder({ embedSingle: async (t) => toyVec(t) });
78
+ return { store, service };
79
+ }
80
+
81
+ test("searchMemories fuses BM25: scattered-term queries recall both rows", async () => {
82
+ const { store, service } = setup();
83
+ const a = store.save({ type: "project", title: "异步并发模式", content: "async runtime 选用 tokio", importance: 3 });
84
+ const b = store.save({ type: "decision", title: "语言迁移", content: "编译模块迁移到 Rust", importance: 3 });
85
+ store.save({ type: "project", title: "无关", content: "夜间 ETL 脚本", importance: 3 });
86
+
87
+ // "rust 异步" is not a substring of either row — LIKE misses both; BM25
88
+ // must surface both rows in the merged result.
89
+ const results = await service.searchMemories("rust 异步", { mode: "auto", topK: 5 });
90
+ const ids = results.map((r) => r.id);
91
+ assert.ok(ids.includes(a.id), "async row must be recalled via BM25");
92
+ assert.ok(ids.includes(b.id), "rust row must be recalled via BM25");
93
+ assert.equal(results.find((r) => r.id === a.id)?.source, "bm25");
94
+ });
95
+
96
+ test("bm25SearchEnabled=false restores the two-path behavior", async () => {
97
+ const { store, service } = setup({ bm25SearchEnabled: false });
98
+ const a = store.save({ type: "project", title: "异步并发模式", content: "async runtime 选用 tokio", importance: 3 });
99
+ const results = await service.searchMemories("rust 异步", { mode: "auto", topK: 5 });
100
+ assert.ok(!results.some((r) => r.id === a.id), "no BM25 → scattered-term miss is back");
101
+ });
102
+
103
+ test("search-time semantic dedup drops near-identical embeddings", async () => {
104
+ const { store, service } = setup();
105
+ const a = store.save({ type: "project", title: "偏好 A", content: "用户喜欢深色主题编辑器", importance: 3 });
106
+ const b = store.save({ type: "project", title: "偏好 A 备份", content: "用户喜欢深色主题编辑器(备份)", importance: 3 });
107
+ store.setEmbedding(a.id, toyVec("用户喜欢深色主题编辑器"));
108
+ store.setEmbedding(b.id, toyVec("用户喜欢深色主题编辑器"));
109
+
110
+ // auto (not keyword): keyword mode is the documented text-only path and is
111
+ // exempt from dedup by design; auto exercises the dedup the way production
112
+ // searches run.
113
+ const results = await service.searchMemories("深色主题", { mode: "auto", topK: 5 });
114
+ const ids = results.map((r) => r.id);
115
+ assert.ok(ids.includes(a.id) !== ids.includes(b.id), "one of the near-duplicate pair is dropped");
116
+ });
117
+
118
+ test("searchSemanticDedup=false keeps duplicate embeddings", async () => {
119
+ const { store, service } = setup({ searchSemanticDedup: false });
120
+ const a = store.save({ type: "project", title: "偏好 A", content: "用户喜欢深色主题编辑器", importance: 3 });
121
+ const b = store.save({ type: "project", title: "偏好 A 备份", content: "用户喜欢深色主题编辑器(备份)", importance: 3 });
122
+ store.setEmbedding(a.id, toyVec("用户喜欢深色主题编辑器"));
123
+ store.setEmbedding(b.id, toyVec("用户喜欢深色主题编辑器"));
124
+ const results = await service.searchMemories("深色主题", { mode: "keyword", topK: 5 });
125
+ assert.equal(results.length, 2);
126
+ });
127
+
128
+ test("selective injection re-orders candidates by query similarity", () => {
129
+ const { store, service } = setup();
130
+ const thesis = store.save({ type: "project", title: "湿地论文", content: "毕业论文研究城市湿地公园", importance: 5 });
131
+ const plugin = store.save({ type: "project", title: "插件项目", content: "dsh-mneme 记忆插件开发", importance: 5 });
132
+ store.setEmbedding(thesis.id, toyVec("毕业论文研究城市湿地公园"));
133
+ store.setEmbedding(plugin.id, toyVec("dsh-mneme 记忆插件开发"));
134
+
135
+ // Rule-based order would put both at equal importance; the query vector is
136
+ // about the thesis, so topic ranking must put the thesis memory first.
137
+ const picked = service.injectCandidates({
138
+ query: "论文写作",
139
+ queryVector: toyVec("毕业论文研究城市湿地公园"),
140
+ maxItems: 2,
141
+ threshold: 3
142
+ });
143
+ assert.equal(picked[0].id, thesis.id);
144
+ assert.ok(picked.some((m) => m.id === plugin.id));
145
+ });
146
+
147
+ // --- roundsFromEvents:surface 投影(rewind 撤回内容不得回流热记忆) ---
148
+
149
+ function userEvent(seq, text, kind) {
150
+ return { seq, type: "user/message", data: { source: kind ? { kind } : undefined, content: [text] } };
151
+ }
152
+ function assistantEvent(seq, text) {
153
+ return { seq, type: "assistant/message", data: { message: { content: [{ type: "text", text }] } } };
154
+ }
155
+
156
+ test("roundsFromEvents pairs user/assistant rounds and keeps the trailing pending query", () => {
157
+ const events = [
158
+ userEvent(1, "第一问"),
159
+ assistantEvent(2, "第一答"),
160
+ userEvent(3, "第二问")
161
+ ];
162
+ const rounds = roundsFromEvents(events, 5);
163
+ assert.equal(rounds.length, 2);
164
+ assert.equal(rounds[0].query, "第一问");
165
+ assert.equal(rounds[0].response, "第一答");
166
+ assert.equal(rounds[1].query, "第二问");
167
+ assert.equal(rounds[1].response, "");
168
+ });
169
+
170
+ test("roundsFromEvents excludes events shadowed off the surface (rewind/compact)", () => {
171
+ // append-only 日志里被撤回的轮次仍在,但 surface 只剩可见 seq——
172
+ // 热记忆必须与模型同源,被遮蔽的轮次不得回流。
173
+ const events = [
174
+ userEvent(1, "已被撤回的问题"),
175
+ assistantEvent(2, "已被撤回的回答"),
176
+ { seq: 3, type: "user/message", data: { source: { kind: "dsh-rewind" }, content: [""] } },
177
+ userEvent(4, "撤回后的新问题"),
178
+ assistantEvent(5, "撤回后的新回答")
179
+ ];
180
+ const visible = new Set([3, 4, 5]);
181
+ const rounds = roundsFromEvents(events, 5, visible);
182
+ assert.equal(rounds.length, 1);
183
+ assert.equal(rounds[0].query, "撤回后的新问题");
184
+ assert.equal(rounds[0].response, "撤回后的新回答");
185
+ assert.ok(!JSON.stringify(rounds).includes("已被撤回"));
186
+ });
187
+
188
+ test("roundsFromEvents with no surface info keeps the legacy full-log behavior", () => {
189
+ const events = [userEvent(1, "旧宿主问题"), assistantEvent(2, "旧宿主回答")];
190
+ const rounds = roundsFromEvents(events, 5, null);
191
+ assert.equal(rounds.length, 1);
192
+ assert.equal(rounds[0].query, "旧宿主问题");
193
+ assert.equal(rounds[0].response, "旧宿主回答");
194
+ });
195
+
196
+ test("roundsFromEvents skips rewind markers as queries even when on the surface", () => {
197
+ const events = [
198
+ { seq: 1, type: "user/message", data: { source: { kind: "dsh-rewind" }, content: [""] } },
199
+ userEvent(2, "标记后的第一问"),
200
+ assistantEvent(3, "标记后的第一答")
201
+ ];
202
+ const visible = new Set([1, 2, 3]);
203
+ const rounds = roundsFromEvents(events, 5, visible);
204
+ assert.equal(rounds.length, 1);
205
+ assert.equal(rounds[0].query, "标记后的第一问");
206
+ });
207
+
208
+ test("roundsFromEvents with an empty surface yields no rounds (model sees nothing)", () => {
209
+ const events = [userEvent(1, "问题"), assistantEvent(2, "回答")];
210
+ assert.equal(roundsFromEvents(events, 5, new Set()).length, 0);
211
+ });
@@ -1,91 +1,91 @@
1
- // Issue #164① 注入截断修复测试。
2
- // 覆盖:截断带尾部提示(上限/原长/memory_get id 指引,不再静默)/ 短正文无
3
- // 提示 / 上限可配(injectContentMaxChars)/ 块预算随上限放大(调大上限不被
4
- // 1500 旧闸卡死)/ _full_content 压缩注入路径不加提示 / 默认 300 与既有行为
5
- // 对齐(ellipsis 仍在、全文不整段进入)。
6
- import test from "node:test";
7
- import assert from "node:assert/strict";
8
- import { createStore } from "../src/store.js";
9
- import { createService } from "../src/service.js";
10
- import { createInjector } from "../src/inject.js";
11
- import { createSettings } from "../src/settings.js";
12
-
13
- function setup(over = {}) {
14
- const store = createStore(":memory:");
15
- const service = createService({ store, mirror: null, config: {} });
16
- const settings = createSettings(store.db);
17
- const contexts = [];
18
- const ctx = {
19
- systemPrompt: {
20
- context(def) {
21
- contexts.push(def);
22
- return () => {};
23
- }
24
- }
25
- };
26
- const config = { maxInjectedItems: 3, importanceThreshold: 3, ...over };
27
- const injector = createInjector(ctx, service, settings, config);
28
- return { store, service, contexts, injector };
29
- }
30
-
31
- test("truncated entry carries a non-silent tail hint with limit/length/memory_get", () => {
32
- const { contexts, service } = setup();
33
- const long = "超长正文内容。".repeat(200); // ~1400 chars
34
- const mem = service.saveWithDedupe({ type: "preference", title: "长记忆", content: long, importance: 5 }).memory;
35
- const text = contexts[0].text({});
36
- assert.ok(text.includes("…"), "ellipsis present");
37
- assert.ok(text.includes(`memory_get "${mem.id}"`), "hint carries memory_get id");
38
- assert.ok(text.includes("上限 300"), "hint carries the limit");
39
- assert.ok(text.includes(`原 ${long.length} 字符`), "hint carries original length");
40
- });
41
-
42
- test("short content gets no hint", () => {
43
- const { contexts, service } = setup();
44
- service.saveWithDedupe({ type: "preference", title: "短记忆", content: "中文交流", importance: 5 });
45
- const text = contexts[0].text({});
46
- assert.ok(!text.includes("已截断"), "no truncation hint on short content");
47
- });
48
-
49
- test("injectContentMaxChars raises the cap and the hint reports the new limit", () => {
50
- const { contexts, service } = setup({ injectContentMaxChars: 800 });
51
- const long = "字".repeat(1000);
52
- service.saveWithDedupe({ type: "preference", title: "长记忆", content: long, importance: 5 });
53
- const text = contexts[0].text({});
54
- assert.ok(text.includes("字".repeat(800)), "content injected up to the new cap");
55
- assert.ok(!text.includes("字".repeat(801)), "content beyond the new cap is cut");
56
- assert.ok(text.includes("上限 800"), "hint reports the configured limit");
57
- });
58
-
59
- test("block budget scales with the cap (raised cap is not defeated by the 1500 gate)", () => {
60
- const { contexts, service } = setup({ injectContentMaxChars: 1000, maxInjectedItems: 2 });
61
- const body = "块".repeat(900);
62
- service.saveWithDedupe({ type: "preference", title: "甲", content: body, importance: 5 });
63
- service.saveWithDedupe({ type: "preference", title: "乙", content: body, importance: 5 });
64
- const text = contexts[0].text({});
65
- assert.ok(text.includes("甲"), "first entry full");
66
- assert.ok(text.includes("块".repeat(900)), "first entry body not collapsed by stale block gate");
67
- assert.ok(text.includes("乙"), "second entry still rendered");
68
- });
69
-
70
- test("_full_content (sleep-compressed) path obeys the cap and says so (#266 评审)", () => {
71
- const { store, contexts, service } = setup();
72
- const mem = service.saveWithDedupe({ type: "preference", title: "压缩记忆", content: "占位", importance: 5 }).memory;
73
- // 模拟 sleep 降级:content=压缩摘要(400 字符 > 默认 300 上限),原文入库 _full_content
74
- const summary = "压缩摘要。".repeat(80);
75
- store.db.prepare("UPDATE memories SET content=?, _full_content=? WHERE id=?")
76
- .run(summary, "原始长文".repeat(100), mem.id);
77
- const text = contexts[0].text({});
78
- // 「降级过」不等于「天然够短」:原先这条早返回的唯一效果就是绕过上限,现在统一截断。
79
- assert.ok(!text.includes(summary), "oversized summary is not injected whole");
80
- assert.ok(text.includes("压缩摘要。".repeat(60)), "the part inside the cap is still there (300 chars)");
81
- assert.ok(text.includes("已截断"), "the cut is reported, never silent");
82
- });
83
-
84
- test("default cap stays 300 (ellipsis regression of Bug6)", () => {
85
- const { contexts, service } = setup();
86
- const long = "x".repeat(2000);
87
- service.saveWithDedupe({ type: "preference", title: "长记忆", content: long, importance: 5 });
88
- const text = contexts[0].text({});
89
- assert.ok(text.includes("x".repeat(300)));
90
- assert.ok(!text.includes("x".repeat(301)));
91
- });
1
+ // Issue #164① 注入截断修复测试。
2
+ // 覆盖:截断带尾部提示(上限/原长/memory_get id 指引,不再静默)/ 短正文无
3
+ // 提示 / 上限可配(injectContentMaxChars)/ 块预算随上限放大(调大上限不被
4
+ // 1500 旧闸卡死)/ _full_content 压缩注入路径不加提示 / 默认 300 与既有行为
5
+ // 对齐(ellipsis 仍在、全文不整段进入)。
6
+ import test from "node:test";
7
+ import assert from "node:assert/strict";
8
+ import { createStore } from "../src/store.js";
9
+ import { createService } from "../src/service.js";
10
+ import { createInjector } from "../src/inject.js";
11
+ import { createSettings } from "../src/settings.js";
12
+
13
+ function setup(over = {}) {
14
+ const store = createStore(":memory:");
15
+ const service = createService({ store, mirror: null, config: {} });
16
+ const settings = createSettings(store.db);
17
+ const contexts = [];
18
+ const ctx = {
19
+ systemPrompt: {
20
+ context(def) {
21
+ contexts.push(def);
22
+ return () => {};
23
+ }
24
+ }
25
+ };
26
+ const config = { maxInjectedItems: 3, importanceThreshold: 3, ...over };
27
+ const injector = createInjector(ctx, service, settings, config);
28
+ return { store, service, contexts, injector };
29
+ }
30
+
31
+ test("truncated entry carries a non-silent tail hint with limit/length/memory_get", () => {
32
+ const { contexts, service } = setup();
33
+ const long = "超长正文内容。".repeat(200); // ~1400 chars
34
+ const mem = service.saveWithDedupe({ type: "preference", title: "长记忆", content: long, importance: 5 }).memory;
35
+ const text = contexts[0].text({});
36
+ assert.ok(text.includes("…"), "ellipsis present");
37
+ assert.ok(text.includes(`memory_get "${mem.id}"`), "hint carries memory_get id");
38
+ assert.ok(text.includes("上限 300"), "hint carries the limit");
39
+ assert.ok(text.includes(`原 ${long.length} 字符`), "hint carries original length");
40
+ });
41
+
42
+ test("short content gets no hint", () => {
43
+ const { contexts, service } = setup();
44
+ service.saveWithDedupe({ type: "preference", title: "短记忆", content: "中文交流", importance: 5 });
45
+ const text = contexts[0].text({});
46
+ assert.ok(!text.includes("已截断"), "no truncation hint on short content");
47
+ });
48
+
49
+ test("injectContentMaxChars raises the cap and the hint reports the new limit", () => {
50
+ const { contexts, service } = setup({ injectContentMaxChars: 800 });
51
+ const long = "字".repeat(1000);
52
+ service.saveWithDedupe({ type: "preference", title: "长记忆", content: long, importance: 5 });
53
+ const text = contexts[0].text({});
54
+ assert.ok(text.includes("字".repeat(800)), "content injected up to the new cap");
55
+ assert.ok(!text.includes("字".repeat(801)), "content beyond the new cap is cut");
56
+ assert.ok(text.includes("上限 800"), "hint reports the configured limit");
57
+ });
58
+
59
+ test("block budget scales with the cap (raised cap is not defeated by the 1500 gate)", () => {
60
+ const { contexts, service } = setup({ injectContentMaxChars: 1000, maxInjectedItems: 2 });
61
+ const body = "块".repeat(900);
62
+ service.saveWithDedupe({ type: "preference", title: "甲", content: body, importance: 5 });
63
+ service.saveWithDedupe({ type: "preference", title: "乙", content: body, importance: 5 });
64
+ const text = contexts[0].text({});
65
+ assert.ok(text.includes("甲"), "first entry full");
66
+ assert.ok(text.includes("块".repeat(900)), "first entry body not collapsed by stale block gate");
67
+ assert.ok(text.includes("乙"), "second entry still rendered");
68
+ });
69
+
70
+ test("_full_content (sleep-compressed) path obeys the cap and says so (#266 评审)", () => {
71
+ const { store, contexts, service } = setup();
72
+ const mem = service.saveWithDedupe({ type: "preference", title: "压缩记忆", content: "占位", importance: 5 }).memory;
73
+ // 模拟 sleep 降级:content=压缩摘要(400 字符 > 默认 300 上限),原文入库 _full_content
74
+ const summary = "压缩摘要。".repeat(80);
75
+ store.db.prepare("UPDATE memories SET content=?, _full_content=? WHERE id=?")
76
+ .run(summary, "原始长文".repeat(100), mem.id);
77
+ const text = contexts[0].text({});
78
+ // 「降级过」不等于「天然够短」:原先这条早返回的唯一效果就是绕过上限,现在统一截断。
79
+ assert.ok(!text.includes(summary), "oversized summary is not injected whole");
80
+ assert.ok(text.includes("压缩摘要。".repeat(60)), "the part inside the cap is still there (300 chars)");
81
+ assert.ok(text.includes("已截断"), "the cut is reported, never silent");
82
+ });
83
+
84
+ test("default cap stays 300 (ellipsis regression of Bug6)", () => {
85
+ const { contexts, service } = setup();
86
+ const long = "x".repeat(2000);
87
+ service.saveWithDedupe({ type: "preference", title: "长记忆", content: long, importance: 5 });
88
+ const text = contexts[0].text({});
89
+ assert.ok(text.includes("x".repeat(300)));
90
+ assert.ok(!text.includes("x".repeat(301)));
91
+ });