@modusensus/dsh-mneme 0.8.13 → 0.8.15

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 (271) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +655 -626
  3. package/assets/icon.svg +3 -3
  4. package/bin/cli.mjs +689 -689
  5. package/bin/dsh-mneme-mcp.mjs +510 -510
  6. package/bin/dsh-mneme-serve.mjs +151 -0
  7. package/cordis.patch.yml +21 -21
  8. package/docs/CONFIGURATION.md +263 -0
  9. package/docs/CONTINUITY.md +124 -0
  10. package/docs/DAEMON.md +46 -0
  11. package/docs/ENTITIES.md +245 -0
  12. package/docs/LOCAL_MODEL.md +222 -0
  13. package/docs/SEMANTIC.md +256 -0
  14. package/docs/SLEEP.md +164 -0
  15. package/docs/STORAGE.md +89 -0
  16. package/lib/api-standalone.js +673 -572
  17. package/lib/api.js +1437 -1433
  18. package/lib/bootstrap.js +211 -211
  19. package/lib/client.js +5444 -5295
  20. package/lib/commands.js +95 -95
  21. package/lib/config.js +880 -836
  22. package/lib/content-hash.js +54 -54
  23. package/lib/continuity.js +220 -220
  24. package/lib/document-index.js +94 -94
  25. package/lib/document.js +303 -303
  26. package/lib/dream/clustering.js +118 -118
  27. package/lib/dream/decisions.js +674 -674
  28. package/lib/dream/narratives.js +44 -44
  29. package/lib/dream/sleep.js +819 -819
  30. package/lib/dream.js +1501 -1501
  31. package/lib/embedding.js +177 -177
  32. package/lib/entities/extractor.js +252 -252
  33. package/lib/graph/anchoring.js +179 -179
  34. package/lib/guide.js +74 -74
  35. package/lib/heat.js +144 -144
  36. package/lib/hot-memory.js +46 -46
  37. package/lib/index.js +535 -671
  38. package/lib/inject.js +464 -450
  39. package/lib/lang.js +248 -229
  40. package/lib/local-embedder.js +358 -358
  41. package/lib/maintenance.js +142 -142
  42. package/lib/mirror.js +330 -330
  43. package/lib/organize.js +450 -450
  44. package/lib/peak-hours.js +117 -117
  45. package/lib/placement.js +13 -0
  46. package/lib/pre-inject-gate.js +340 -0
  47. package/lib/quality-filter.js +126 -126
  48. package/lib/recall-stats.js +175 -175
  49. package/lib/reranker.js +269 -269
  50. package/lib/runtime/adopt.js +176 -176
  51. package/lib/runtime/closure.js +172 -172
  52. package/lib/runtime/download.js +247 -247
  53. package/lib/runtime/layout.js +265 -265
  54. package/lib/runtime/loader.js +252 -252
  55. package/lib/runtime/model-fetch.js +361 -361
  56. package/lib/runtime/provision.js +237 -237
  57. package/lib/runtime/tarball.js +130 -130
  58. package/lib/runtime/verify.js +223 -204
  59. package/lib/scope.js +146 -146
  60. package/lib/search/adaptive.js +60 -60
  61. package/lib/search/bm25.js +96 -96
  62. package/lib/semantic.js +229 -0
  63. package/lib/sensitive-scan.js +209 -209
  64. package/lib/serve.js +215 -0
  65. package/lib/service.js +2663 -2596
  66. package/lib/settings.js +517 -509
  67. package/lib/store.js +3007 -3007
  68. package/lib/summarize.js +891 -856
  69. package/lib/tools.js +743 -737
  70. package/lib/vector-index.js +110 -110
  71. package/lib/version-check.js +122 -122
  72. package/lib/write-admission.js +402 -402
  73. package/locale/en.json +6 -6
  74. package/locale/zh.json +6 -6
  75. package/package.json +8 -4
  76. package/runtime-manifest.json +526 -526
  77. package/scripts/benchmark-embed.js +201 -201
  78. package/scripts/benchmark-recall.js +249 -249
  79. package/scripts/benchmark-rerank.js +166 -166
  80. package/scripts/build-runtime-manifest.mjs +224 -224
  81. package/scripts/changelog-prep.mjs +36 -0
  82. package/scripts/check-sync.js +42 -42
  83. package/scripts/e2e-dsh.js +220 -220
  84. package/scripts/mneme-runtime.mjs +277 -277
  85. package/scripts/stress-dsh.js +255 -255
  86. package/scripts/sync-lib.js +47 -47
  87. package/scripts/sync-test-badge.mjs +69 -69
  88. package/scripts/test-count-sync.mjs +44 -44
  89. package/src/api-standalone.js +673 -572
  90. package/src/api.js +1437 -1433
  91. package/src/bootstrap.js +211 -211
  92. package/src/commands.js +95 -95
  93. package/src/config.js +880 -836
  94. package/src/content-hash.js +54 -54
  95. package/src/continuity.js +220 -220
  96. package/src/document-index.js +94 -94
  97. package/src/document.js +303 -303
  98. package/src/dream/clustering.js +118 -118
  99. package/src/dream/decisions.js +674 -674
  100. package/src/dream/narratives.js +44 -44
  101. package/src/dream/sleep.js +819 -819
  102. package/src/dream.js +1501 -1501
  103. package/src/embedding.js +177 -177
  104. package/src/entities/extractor.js +252 -252
  105. package/src/graph/anchoring.js +179 -179
  106. package/src/guide.js +74 -74
  107. package/src/heat.js +144 -144
  108. package/src/hot-memory.js +46 -46
  109. package/src/index.js +535 -671
  110. package/src/inject.js +464 -450
  111. package/src/lang.js +248 -229
  112. package/src/local-embedder.js +358 -358
  113. package/src/maintenance.js +142 -142
  114. package/src/mirror.js +330 -330
  115. package/src/organize.js +450 -450
  116. package/src/peak-hours.js +117 -117
  117. package/src/placement.js +13 -0
  118. package/src/pre-inject-gate.js +340 -0
  119. package/src/quality-filter.js +126 -126
  120. package/src/recall-stats.js +175 -175
  121. package/src/reranker.js +269 -269
  122. package/src/runtime/adopt.js +176 -176
  123. package/src/runtime/closure.js +172 -172
  124. package/src/runtime/download.js +247 -247
  125. package/src/runtime/layout.js +265 -265
  126. package/src/runtime/loader.js +252 -252
  127. package/src/runtime/model-fetch.js +361 -361
  128. package/src/runtime/provision.js +237 -237
  129. package/src/runtime/tarball.js +130 -130
  130. package/src/runtime/verify.js +223 -204
  131. package/src/scope.js +146 -146
  132. package/src/search/adaptive.js +60 -60
  133. package/src/search/bm25.js +96 -96
  134. package/src/semantic.js +229 -0
  135. package/src/sensitive-scan.js +209 -209
  136. package/src/serve.js +215 -0
  137. package/src/service.js +2663 -2596
  138. package/src/settings.js +517 -509
  139. package/src/store.js +3007 -3007
  140. package/src/summarize.js +891 -856
  141. package/src/tools.js +743 -737
  142. package/src/vector-index.js +110 -110
  143. package/src/version-check.js +122 -122
  144. package/src/write-admission.js +402 -402
  145. package/test/adaptive-inject-budget.test.js +85 -85
  146. package/test/api-routes-gaps.test.js +218 -218
  147. package/test/api.test.js +1702 -1688
  148. package/test/audit.test.js +448 -448
  149. package/test/baseline-persist.test.js +248 -248
  150. package/test/benchmark.test.js +94 -94
  151. package/test/bootstrap.test.js +220 -220
  152. package/test/changelog-prep.test.js +60 -0
  153. package/test/client.test.js +1230 -1169
  154. package/test/clustering.test.js +100 -100
  155. package/test/commands.test.js +106 -106
  156. package/test/config.test.js +66 -66
  157. package/test/conflict-freeze.test.js +300 -300
  158. package/test/content-hash.test.js +204 -204
  159. package/test/continuity.test.js +333 -333
  160. package/test/document-dir.test.js +233 -233
  161. package/test/document.test.js +671 -671
  162. package/test/dream-archive-guardrail.test.js +116 -116
  163. package/test/dream-candidate-hybrid.test.js +281 -281
  164. package/test/dream-coverage-degrade.test.js +86 -86
  165. package/test/dream-failure-backoff.test.js +173 -173
  166. package/test/dream-peak-hours.test.js +194 -194
  167. package/test/dream.test.js +1385 -1383
  168. package/test/embedding-ready.test.js +196 -196
  169. package/test/entities.test.js +627 -547
  170. package/test/entity-recall.test.js +179 -179
  171. package/test/epistemic.test.js +325 -325
  172. package/test/fnew-0112.test.js +311 -311
  173. package/test/fnew-03.test.js +422 -422
  174. package/test/graph-anchoring.test.js +184 -184
  175. package/test/graph-api.test.js +175 -175
  176. package/test/graph-inject-budget.test.js +103 -103
  177. package/test/graph-passive-confirm.test.js +91 -91
  178. package/test/graph-weight-evolution.test.js +104 -104
  179. package/test/heat.test.js +175 -175
  180. package/test/helpers/dream-mock.js +82 -82
  181. package/test/helpers/peer-worker.mjs +25 -25
  182. package/test/helpers/runtime-source.js +60 -60
  183. package/test/helpers/tar-builder.js +80 -80
  184. package/test/helpers/write-admission-samples.js +308 -308
  185. package/test/hot-memory.test.js +145 -145
  186. package/test/inject-content-cap.test.js +91 -91
  187. package/test/inject-first-round-bm25.test.js +89 -89
  188. package/test/inject-heat.test.js +77 -61
  189. package/test/inject-parent-gate.test.js +106 -106
  190. package/test/inject-pools.test.js +194 -194
  191. package/test/inject-recall.test.js +105 -105
  192. package/test/inject-rotation.test.js +161 -161
  193. package/test/inject.test.js +420 -420
  194. package/test/lang.test.js +87 -87
  195. package/test/lastrunat-persist.test.js +101 -101
  196. package/test/lib-smoke.test.js +96 -96
  197. package/test/llm-audit.test.js +598 -598
  198. package/test/llm-message-source.test.js +207 -207
  199. package/test/local-embedder.test.js +292 -292
  200. package/test/maintenance.test.js +391 -391
  201. package/test/mcp-stdio.test.js +385 -385
  202. package/test/mirror-dirty.test.js +424 -424
  203. package/test/mirror-edit-digest.test.js +187 -187
  204. package/test/mirror-generation.test.js +499 -499
  205. package/test/mirror-types.test.js +208 -208
  206. package/test/mirror.test.js +249 -249
  207. package/test/narrative-bars.test.js +162 -162
  208. package/test/organize.test.js +418 -418
  209. package/test/peer-blockers.test.js +193 -193
  210. package/test/placement.test.js +36 -0
  211. package/test/policy-epoch.test.js +259 -259
  212. package/test/pre-inject-gate.test.js +434 -0
  213. package/test/quality-filter.test.js +186 -186
  214. package/test/reasoning-effort.test.js +752 -752
  215. package/test/recall-anti-update.test.js +82 -82
  216. package/test/recall-evals.test.js +253 -253
  217. package/test/recall-layer.test.js +326 -326
  218. package/test/recall-stats.test.js +189 -189
  219. package/test/receipt-chain.test.js +451 -451
  220. package/test/reflection.test.js +226 -226
  221. package/test/reindex-backfill.test.js +62 -62
  222. package/test/reranker-single-logit.test.js +73 -73
  223. package/test/reranker.test.js +197 -197
  224. package/test/resident-status.test.js +83 -83
  225. package/test/runtime-adopt.test.js +206 -206
  226. package/test/runtime-cli.test.js +89 -89
  227. package/test/runtime-closure.test.js +193 -193
  228. package/test/runtime-download.test.js +302 -302
  229. package/test/runtime-layout.test.js +163 -163
  230. package/test/runtime-loader.test.js +255 -255
  231. package/test/runtime-manifest.test.js +159 -159
  232. package/test/runtime-model-fetch.test.js +348 -348
  233. package/test/runtime-provision.test.js +101 -101
  234. package/test/runtime-tarball.test.js +81 -81
  235. package/test/runtime-verify.test.js +319 -279
  236. package/test/scope-candidates.test.js +239 -239
  237. package/test/scope-explicit.test.js +452 -452
  238. package/test/scope-inject-soft.test.js +106 -106
  239. package/test/scope-retrieval.test.js +197 -197
  240. package/test/scope-storage.test.js +255 -255
  241. package/test/scope-strict.test.js +367 -343
  242. package/test/search-fusion.test.js +90 -90
  243. package/test/semantic.test.js +124 -124
  244. package/test/sensitive-scan.test.js +207 -207
  245. package/test/serve-bin.test.js +121 -0
  246. package/test/serve.test.js +196 -0
  247. package/test/service-search.test.js +174 -174
  248. package/test/service.test.js +405 -405
  249. package/test/settings.test.js +261 -261
  250. package/test/skip-invalid-restore.test.js +262 -262
  251. package/test/sleep-action-set.test.js +422 -422
  252. package/test/sleep-heat.test.js +126 -126
  253. package/test/sleep-scheduler-rearm.test.js +89 -89
  254. package/test/sleep.test.js +527 -527
  255. package/test/standalone-api.test.js +751 -544
  256. package/test/store-vector-cache.test.js +98 -98
  257. package/test/store.test.js +396 -396
  258. package/test/stress.test.js +209 -209
  259. package/test/summarize-occurred-at.test.js +127 -0
  260. package/test/summarize-reasoning-effort.test.js +189 -189
  261. package/test/summarize.test.js +1465 -1465
  262. package/test/supersede-state-tracking.test.js +394 -0
  263. package/test/test-count-sync.test.js +60 -60
  264. package/test/tools-dto-schema-matrix.test.js +325 -325
  265. package/test/tools-memory-get-schema.test.js +65 -65
  266. package/test/tools.test.js +428 -374
  267. package/test/updated-at-semantics.test.js +113 -113
  268. package/test/vector-index.test.js +221 -221
  269. package/test/version-check.test.js +152 -152
  270. package/test/webServer-optional.test.js +82 -82
  271. package/test/write-admission.test.js +668 -668
@@ -1,145 +1,145 @@
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 } 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,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
+ });